@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.
Files changed (308) hide show
  1. package/CHANGELOG.md +46 -3
  2. package/README.md +2 -2
  3. package/dist/actor/definition.d.ts +13 -9
  4. package/dist/actor/descriptor.d.ts +2 -2
  5. package/dist/actor/descriptor.js +4 -4
  6. package/dist/client/calls.js +1 -1
  7. package/dist/client/index.d.ts +1 -1
  8. package/dist/client/index.js +1 -1
  9. package/dist/errors/actor.d.ts +12 -42
  10. package/dist/errors/actor.js +13 -42
  11. package/dist/index.d.ts +1 -1
  12. package/dist/index.js +1 -1
  13. package/dist/members/payload.d.ts +1 -1
  14. package/dist/protocol/inspection.d.ts +221 -1
  15. package/dist/protocol/inspection.js +151 -2
  16. package/dist/protocol/wire.d.ts +6 -49
  17. package/dist/protocol/wire.js +1 -10
  18. package/dist/runtime/actors.d.ts +3 -0
  19. package/dist/runtime/adoption/backfill.js +1 -1
  20. package/dist/runtime/adoption/enforce.js +2 -2
  21. package/dist/runtime/adoption/observe.js +1 -1
  22. package/dist/runtime/adoption/plan.d.ts +1 -1
  23. package/dist/runtime/adoption/startup.js +1 -1
  24. package/dist/runtime/adoption/status.d.ts +1 -1
  25. package/dist/runtime/app.d.ts +65 -0
  26. package/dist/runtime/app.js +38 -0
  27. package/dist/runtime/connections/holder.d.ts +11 -1
  28. package/dist/runtime/connections/holder.js +8 -4
  29. package/dist/runtime/connections/streams.d.ts +4 -4
  30. package/dist/runtime/content/store.js +15 -11
  31. package/dist/runtime/database/bounded.d.ts +4 -18
  32. package/dist/runtime/database/bounded.js +36 -22
  33. package/dist/runtime/database/coordination.d.ts +12 -3
  34. package/dist/runtime/database/coordination.js +29 -36
  35. package/dist/runtime/database/migrations.d.ts +61 -29
  36. package/dist/runtime/database/migrations.js +375 -139
  37. package/dist/runtime/database/replica.d.ts +4 -1
  38. package/dist/runtime/database/replica.js +4 -1
  39. package/dist/runtime/database/schema.d.ts +13 -0
  40. package/dist/runtime/database/schema.js +13 -0
  41. package/dist/runtime/database/shards.d.ts +31 -13
  42. package/dist/runtime/database/shards.js +38 -26
  43. package/dist/runtime/entity/register.d.ts +8 -1
  44. package/dist/runtime/entity/register.js +58 -7
  45. package/dist/runtime/fleet/checks.js +4 -4
  46. package/dist/runtime/fleet/maintainer.d.ts +1 -1
  47. package/dist/runtime/fleet/maintainer.js +1 -1
  48. package/dist/runtime/index.d.ts +2 -0
  49. package/dist/runtime/index.js +1 -0
  50. package/dist/runtime/inspector/layer.d.ts +20 -0
  51. package/dist/runtime/inspector/layer.js +224 -5
  52. package/dist/runtime/inspector/queries.d.ts +54 -8
  53. package/dist/runtime/inspector/queries.js +84 -15
  54. package/dist/runtime/layer.d.ts +48 -39
  55. package/dist/runtime/layer.js +124 -56
  56. package/dist/runtime/operators/audit.d.ts +3 -0
  57. package/dist/runtime/operators/audit.js +6 -2
  58. package/dist/runtime/operators/repair.js +30 -10
  59. package/dist/runtime/operators/seed.js +4 -2
  60. package/dist/runtime/payloads/versions.d.ts +4 -4
  61. package/dist/runtime/payloads/versions.js +24 -15
  62. package/dist/runtime/queries.js +4 -2
  63. package/dist/runtime/registration.d.ts +5 -2
  64. package/dist/runtime/registration.js +3 -3
  65. package/dist/runtime/runner.d.ts +12 -0
  66. package/dist/runtime/runner.js +12 -0
  67. package/dist/runtime/storage/codec.d.ts +19 -7
  68. package/dist/runtime/storage/codec.js +23 -7
  69. package/dist/runtime/storage/placements.d.ts +6 -1
  70. package/dist/runtime/storage/placements.js +98 -6
  71. package/dist/runtime/storage/retention.d.ts +6 -0
  72. package/dist/runtime/storage/retention.js +25 -13
  73. package/dist/runtime/subscriptions/relay.js +47 -44
  74. package/dist/runtime/subscriptions/storage.d.ts +3 -2
  75. package/dist/runtime/subscriptions/storage.js +9 -6
  76. package/dist/runtime/telemetry/live.d.ts +255 -0
  77. package/dist/runtime/telemetry/live.js +540 -0
  78. package/dist/runtime/telemetry/metrics.d.ts +2 -0
  79. package/dist/runtime/telemetry/metrics.js +4 -1
  80. package/dist/runtime/telemetry/sampler.js +33 -13
  81. package/dist/runtime/telemetry/spans.d.ts +1 -1
  82. package/dist/runtime/telemetry/spans.js +1 -1
  83. package/dist/runtime/topology/locks.d.ts +6 -3
  84. package/dist/runtime/topology/locks.js +27 -4
  85. package/dist/runtime/turn/execute.d.ts +2 -0
  86. package/dist/runtime/turn/execute.js +5 -2
  87. package/dist/runtime/turn/pipeline.d.ts +5 -12
  88. package/dist/runtime/turn/pipeline.js +11 -11
  89. package/dist/runtime/turn/relay.d.ts +13 -3
  90. package/dist/runtime/turn/relay.js +27 -14
  91. package/dist/runtime/turn/rows.js +4 -4
  92. package/dist/runtime/workflows/compatibility.d.ts +1 -1
  93. package/dist/runtime/workflows/compatibility.js +85 -31
  94. package/dist/runtime/workflows/engine.js +20 -17
  95. package/dist/serve/layer.js +3 -2
  96. package/dist/tables/owned.d.ts +1 -1
  97. package/dist/tables/owned.js +1 -1
  98. package/dist/testing/actor-test.d.ts +2 -24
  99. package/dist/testing/actor-test.js +1 -27
  100. package/dist/testing/index.d.ts +0 -12
  101. package/dist/testing/index.js +0 -6
  102. package/package.json +1 -1
  103. package/dist/runtime/database/neki/migrations.d.ts +0 -31
  104. package/dist/runtime/database/neki/migrations.js +0 -276
  105. package/dist/runtime/database/neki/session.d.ts +0 -23
  106. package/dist/runtime/database/neki/session.js +0 -31
  107. package/dist/testing/cluster.d.ts +0 -93
  108. package/dist/testing/cluster.js +0 -296
  109. package/dist/testing/conformance/access.d.ts +0 -5
  110. package/dist/testing/conformance/access.js +0 -531
  111. package/dist/testing/conformance/admission.d.ts +0 -11
  112. package/dist/testing/conformance/admission.js +0 -182
  113. package/dist/testing/conformance/adoption.d.ts +0 -2
  114. package/dist/testing/conformance/adoption.js +0 -1019
  115. package/dist/testing/conformance/assertions.d.ts +0 -202
  116. package/dist/testing/conformance/assertions.js +0 -849
  117. package/dist/testing/conformance/batches.d.ts +0 -41
  118. package/dist/testing/conformance/batches.js +0 -388
  119. package/dist/testing/conformance/blobs.d.ts +0 -14
  120. package/dist/testing/conformance/blobs.js +0 -405
  121. package/dist/testing/conformance/capacity.d.ts +0 -8
  122. package/dist/testing/conformance/capacity.js +0 -433
  123. package/dist/testing/conformance/client.d.ts +0 -5
  124. package/dist/testing/conformance/client.js +0 -719
  125. package/dist/testing/conformance/cold-serve.d.ts +0 -16
  126. package/dist/testing/conformance/cold-serve.js +0 -254
  127. package/dist/testing/conformance/connections/actors.d.ts +0 -1143
  128. package/dist/testing/conformance/connections/actors.js +0 -180
  129. package/dist/testing/conformance/connections/harness.d.ts +0 -1754
  130. package/dist/testing/conformance/connections/harness.js +0 -142
  131. package/dist/testing/conformance/connections/holders.d.ts +0 -4
  132. package/dist/testing/conformance/connections/holders.js +0 -165
  133. package/dist/testing/conformance/connections/lifecycle.d.ts +0 -4
  134. package/dist/testing/conformance/connections/lifecycle.js +0 -113
  135. package/dist/testing/conformance/connections/limits.d.ts +0 -4
  136. package/dist/testing/conformance/connections/limits.js +0 -127
  137. package/dist/testing/conformance/connections/reauthorization.d.ts +0 -4
  138. package/dist/testing/conformance/connections/reauthorization.js +0 -170
  139. package/dist/testing/conformance/connections/resync.d.ts +0 -4
  140. package/dist/testing/conformance/connections/resync.js +0 -360
  141. package/dist/testing/conformance/connections/takeover.d.ts +0 -4
  142. package/dist/testing/conformance/connections/takeover.js +0 -287
  143. package/dist/testing/conformance/connections.d.ts +0 -4
  144. package/dist/testing/conformance/connections.js +0 -15
  145. package/dist/testing/conformance/content-blobs.d.ts +0 -16
  146. package/dist/testing/conformance/content-blobs.js +0 -534
  147. package/dist/testing/conformance/counter.d.ts +0 -16
  148. package/dist/testing/conformance/counter.js +0 -813
  149. package/dist/testing/conformance/cron.d.ts +0 -5
  150. package/dist/testing/conformance/cron.js +0 -665
  151. package/dist/testing/conformance/drain.d.ts +0 -26
  152. package/dist/testing/conformance/drain.js +0 -540
  153. package/dist/testing/conformance/effect-control.d.ts +0 -38
  154. package/dist/testing/conformance/effect-control.js +0 -1059
  155. package/dist/testing/conformance/effects.d.ts +0 -23
  156. package/dist/testing/conformance/effects.js +0 -432
  157. package/dist/testing/conformance/events.d.ts +0 -28
  158. package/dist/testing/conformance/events.js +0 -335
  159. package/dist/testing/conformance/export.d.ts +0 -2
  160. package/dist/testing/conformance/export.js +0 -368
  161. package/dist/testing/conformance/fleet.d.ts +0 -444
  162. package/dist/testing/conformance/fleet.js +0 -1009
  163. package/dist/testing/conformance/groups.d.ts +0 -7
  164. package/dist/testing/conformance/groups.js +0 -353
  165. package/dist/testing/conformance/heap.d.ts +0 -3
  166. package/dist/testing/conformance/heap.js +0 -149
  167. package/dist/testing/conformance/http.d.ts +0 -2809
  168. package/dist/testing/conformance/http.js +0 -1234
  169. package/dist/testing/conformance/inspection-views.d.ts +0 -8
  170. package/dist/testing/conformance/inspection-views.js +0 -272
  171. package/dist/testing/conformance/inspector.d.ts +0 -7
  172. package/dist/testing/conformance/inspector.js +0 -650
  173. package/dist/testing/conformance/mint.d.ts +0 -58
  174. package/dist/testing/conformance/mint.js +0 -692
  175. package/dist/testing/conformance/multi-runner.d.ts +0 -8
  176. package/dist/testing/conformance/multi-runner.js +0 -403
  177. package/dist/testing/conformance/neki/plan.d.ts +0 -19
  178. package/dist/testing/conformance/neki/plan.js +0 -30
  179. package/dist/testing/conformance/observability.d.ts +0 -3
  180. package/dist/testing/conformance/observability.js +0 -343
  181. package/dist/testing/conformance/offline.d.ts +0 -4
  182. package/dist/testing/conformance/offline.js +0 -474
  183. package/dist/testing/conformance/operator-harness.d.ts +0 -57
  184. package/dist/testing/conformance/operator-harness.js +0 -78
  185. package/dist/testing/conformance/operator.d.ts +0 -3
  186. package/dist/testing/conformance/operator.js +0 -379
  187. package/dist/testing/conformance/outbox-cross-shard.d.ts +0 -14
  188. package/dist/testing/conformance/outbox-cross-shard.js +0 -160
  189. package/dist/testing/conformance/outbox.d.ts +0 -36
  190. package/dist/testing/conformance/outbox.js +0 -437
  191. package/dist/testing/conformance/payload-migrations.d.ts +0 -3
  192. package/dist/testing/conformance/payload-migrations.js +0 -612
  193. package/dist/testing/conformance/pipeline.d.ts +0 -3
  194. package/dist/testing/conformance/pipeline.js +0 -1040
  195. package/dist/testing/conformance/placement.d.ts +0 -22
  196. package/dist/testing/conformance/placement.js +0 -539
  197. package/dist/testing/conformance/platform.d.ts +0 -40
  198. package/dist/testing/conformance/platform.js +0 -101
  199. package/dist/testing/conformance/progress.d.ts +0 -39
  200. package/dist/testing/conformance/progress.js +0 -666
  201. package/dist/testing/conformance/properties.d.ts +0 -6
  202. package/dist/testing/conformance/properties.js +0 -295
  203. package/dist/testing/conformance/protocols.d.ts +0 -4
  204. package/dist/testing/conformance/protocols.js +0 -618
  205. package/dist/testing/conformance/provider/advertise.d.ts +0 -21
  206. package/dist/testing/conformance/provider/advertise.js +0 -44
  207. package/dist/testing/conformance/read-your-writes.d.ts +0 -20
  208. package/dist/testing/conformance/read-your-writes.js +0 -192
  209. package/dist/testing/conformance/reducers.d.ts +0 -8
  210. package/dist/testing/conformance/reducers.js +0 -258
  211. package/dist/testing/conformance/relay.d.ts +0 -42
  212. package/dist/testing/conformance/relay.js +0 -1115
  213. package/dist/testing/conformance/restore.d.ts +0 -43
  214. package/dist/testing/conformance/restore.js +0 -341
  215. package/dist/testing/conformance/retention.d.ts +0 -14
  216. package/dist/testing/conformance/retention.js +0 -463
  217. package/dist/testing/conformance/rls.d.ts +0 -24
  218. package/dist/testing/conformance/rls.js +0 -576
  219. package/dist/testing/conformance/simulation.d.ts +0 -31
  220. package/dist/testing/conformance/simulation.js +0 -167
  221. package/dist/testing/conformance/single-shard.d.ts +0 -2
  222. package/dist/testing/conformance/single-shard.js +0 -125
  223. package/dist/testing/conformance/singleton.d.ts +0 -3
  224. package/dist/testing/conformance/singleton.js +0 -293
  225. package/dist/testing/conformance/statements.d.ts +0 -60
  226. package/dist/testing/conformance/statements.js +0 -108
  227. package/dist/testing/conformance/streams.d.ts +0 -7
  228. package/dist/testing/conformance/streams.js +0 -280
  229. package/dist/testing/conformance/subscriptions/access.d.ts +0 -4
  230. package/dist/testing/conformance/subscriptions/access.js +0 -98
  231. package/dist/testing/conformance/subscriptions/actors.d.ts +0 -4910
  232. package/dist/testing/conformance/subscriptions/actors.js +0 -372
  233. package/dist/testing/conformance/subscriptions/cluster.d.ts +0 -4
  234. package/dist/testing/conformance/subscriptions/cluster.js +0 -89
  235. package/dist/testing/conformance/subscriptions/delivery.d.ts +0 -4
  236. package/dist/testing/conformance/subscriptions/delivery.js +0 -253
  237. package/dist/testing/conformance/subscriptions/deploys.d.ts +0 -4
  238. package/dist/testing/conformance/subscriptions/deploys.js +0 -162
  239. package/dist/testing/conformance/subscriptions/epochs.d.ts +0 -4
  240. package/dist/testing/conformance/subscriptions/epochs.js +0 -169
  241. package/dist/testing/conformance/subscriptions/failures.d.ts +0 -4
  242. package/dist/testing/conformance/subscriptions/failures.js +0 -108
  243. package/dist/testing/conformance/subscriptions/feeds.d.ts +0 -4
  244. package/dist/testing/conformance/subscriptions/feeds.js +0 -218
  245. package/dist/testing/conformance/subscriptions/harness.d.ts +0 -124
  246. package/dist/testing/conformance/subscriptions/harness.js +0 -143
  247. package/dist/testing/conformance/subscriptions/operator.d.ts +0 -4
  248. package/dist/testing/conformance/subscriptions/operator.js +0 -128
  249. package/dist/testing/conformance/subscriptions/retention.d.ts +0 -4
  250. package/dist/testing/conformance/subscriptions/retention.js +0 -288
  251. package/dist/testing/conformance/subscriptions/routing.d.ts +0 -4
  252. package/dist/testing/conformance/subscriptions/routing.js +0 -179
  253. package/dist/testing/conformance/subscriptions.d.ts +0 -4
  254. package/dist/testing/conformance/subscriptions.js +0 -19
  255. package/dist/testing/conformance/tables.d.ts +0 -125
  256. package/dist/testing/conformance/tables.js +0 -664
  257. package/dist/testing/conformance/transports/actors.d.ts +0 -1907
  258. package/dist/testing/conformance/transports/actors.js +0 -163
  259. package/dist/testing/conformance/transports/client.d.ts +0 -3
  260. package/dist/testing/conformance/transports/client.js +0 -237
  261. package/dist/testing/conformance/transports/feeds.d.ts +0 -3
  262. package/dist/testing/conformance/transports/feeds.js +0 -232
  263. package/dist/testing/conformance/transports/harness.d.ts +0 -93
  264. package/dist/testing/conformance/transports/harness.js +0 -84
  265. package/dist/testing/conformance/transports/streams.d.ts +0 -3
  266. package/dist/testing/conformance/transports/streams.js +0 -96
  267. package/dist/testing/conformance/transports/websocket.d.ts +0 -3
  268. package/dist/testing/conformance/transports/websocket.js +0 -384
  269. package/dist/testing/conformance/transports/wire.d.ts +0 -141
  270. package/dist/testing/conformance/transports/wire.js +0 -204
  271. package/dist/testing/conformance/transports.d.ts +0 -3
  272. package/dist/testing/conformance/transports.js +0 -11
  273. package/dist/testing/conformance/watch.d.ts +0 -59
  274. package/dist/testing/conformance/watch.js +0 -879
  275. package/dist/testing/conformance/workflow-engine.d.ts +0 -97
  276. package/dist/testing/conformance/workflow-engine.js +0 -253
  277. package/dist/testing/conformance/workflow-versions.d.ts +0 -3
  278. package/dist/testing/conformance/workflow-versions.js +0 -545
  279. package/dist/testing/conformance/workflows/access.d.ts +0 -4
  280. package/dist/testing/conformance/workflows/access.js +0 -147
  281. package/dist/testing/conformance/workflows/actors.d.ts +0 -2317
  282. package/dist/testing/conformance/workflows/actors.js +0 -305
  283. package/dist/testing/conformance/workflows/basics.d.ts +0 -4
  284. package/dist/testing/conformance/workflows/basics.js +0 -144
  285. package/dist/testing/conformance/workflows/engine.d.ts +0 -4
  286. package/dist/testing/conformance/workflows/engine.js +0 -80
  287. package/dist/testing/conformance/workflows/guards.d.ts +0 -4
  288. package/dist/testing/conformance/workflows/guards.js +0 -172
  289. package/dist/testing/conformance/workflows/harness.d.ts +0 -14
  290. package/dist/testing/conformance/workflows/harness.js +0 -44
  291. package/dist/testing/conformance/workflows/recovery.d.ts +0 -4
  292. package/dist/testing/conformance/workflows/recovery.js +0 -181
  293. package/dist/testing/conformance/workflows/starts.d.ts +0 -4
  294. package/dist/testing/conformance/workflows/starts.js +0 -57
  295. package/dist/testing/conformance/workflows/suspension.d.ts +0 -4
  296. package/dist/testing/conformance/workflows/suspension.js +0 -106
  297. package/dist/testing/conformance/workflows/waits.d.ts +0 -4
  298. package/dist/testing/conformance/workflows/waits.js +0 -284
  299. package/dist/testing/conformance/workflows.d.ts +0 -4
  300. package/dist/testing/conformance/workflows.js +0 -19
  301. package/dist/testing/conformance.d.ts +0 -330
  302. package/dist/testing/conformance.js +0 -364
  303. package/dist/testing/foundation.d.ts +0 -41
  304. package/dist/testing/foundation.js +0 -517
  305. package/dist/testing/simulate-cluster.d.ts +0 -112
  306. package/dist/testing/simulate-cluster.js +0 -257
  307. package/dist/testing/simulate.d.ts +0 -90
  308. 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
- ];
@@ -1,4 +0,0 @@
1
- import type { ConformanceCase, ConformanceSuite } from "../conformance.ts";
2
- export declare const offlineConformance: ReadonlyArray<ConformanceCase>;
3
- /** Offline cases call the served HTTP actors. */
4
- export declare const offlineSuite: ConformanceSuite;