@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,305 +0,0 @@
1
- import { Deferred, Effect, Layer, Option, Schema } from "effect";
2
- import { WorkflowEngine } from "effect/workflow";
3
- import { Actor, Intent } from "../../../index.js";
4
- import { engineFixture, Flake, probeBody, ProbeInput, } from "../workflow-engine.js";
5
- export const workflowsFixture = () => ({
6
- runs: new Map(),
7
- blocked: undefined,
8
- engine: engineFixture(),
9
- audits: new Map(),
10
- gates: new Map(),
11
- });
12
- const Paid = Actor.event("Paid", { orderId: Schema.String, amount: Schema.Int });
13
- export class OutOfStock extends Schema.TaggedError()("OutOfStock", {
14
- sku: Schema.String,
15
- }) {
16
- }
17
- export const Ship = Actor.workflow("Ship", {
18
- payload: { orderId: Schema.String, sku: Schema.String },
19
- success: Schema.String,
20
- error: OutOfStock,
21
- key: ({ orderId }) => orderId,
22
- versions: { label: { current: 2, min: 0 } },
23
- });
24
- const Reserve = Ship.step("reserve", {
25
- payload: Schema.String,
26
- success: Schema.String,
27
- error: OutOfStock,
28
- });
29
- const CoolOff = Ship.sleep("cool-off");
30
- const AwaitPaid = Ship.wait("paid", Paid);
31
- const Grace = Ship.sleep("grace");
32
- const FirstSignal = Ship.race("first-signal", { success: Schema.String });
33
- export const Quote = Actor.workflow("Quote", {
34
- payload: { n: Schema.Int },
35
- success: Schema.String,
36
- });
37
- const Pay = Actor.command("Pay", {
38
- payload: { orderId: Schema.String, amount: Schema.Int },
39
- });
40
- const Charge = Actor.command("Charge", { payload: Schema.String, success: Schema.Int });
41
- const Record = Actor.command("Record", { payload: Schema.String });
42
- /** Records the tenant and caller of each call it receives. */
43
- const Audit = Actor.make("Audit", { key: Schema.String, api: { Record } });
44
- /** Sleeps, then calls `Audit` from an activity, so the call runs after a resume. */
45
- export const Attributed = Actor.workflow("Attributed", {
46
- payload: { key: Schema.String },
47
- success: Schema.String,
48
- key: ({ key }) => key,
49
- });
50
- const AttributedNap = Attributed.sleep("nap");
51
- const Report = Attributed.step("report", { payload: Schema.String, success: Schema.String });
52
- /** Owner-event waits and clocks in the shapes the W2 and clock cases need, by `mode`. */
53
- export const Watch = Actor.workflow("Watch", {
54
- payload: { mode: Schema.String, orderId: Schema.String },
55
- success: Schema.String,
56
- key: ({ mode, orderId }) => `${mode}/${orderId}`,
57
- });
58
- const WatchHold = Watch.step("hold", { payload: Schema.String, success: Schema.String });
59
- const WatchSlow = Watch.step("slow", { payload: Schema.String, success: Schema.String });
60
- const WatchFirst = Watch.wait("first", Paid);
61
- const WatchSecond = Watch.wait("second", Paid);
62
- const WatchPick = Watch.race("pick", { success: Schema.String });
63
- const WatchNapA = Watch.sleep("nap-a");
64
- const WatchNapB = Watch.sleep("nap-b");
65
- const WatchMarkA = Watch.step("mark-a", { payload: Schema.String, success: Schema.String });
66
- const WatchMarkB = Watch.step("mark-b", { payload: Schema.String, success: Schema.String });
67
- const WatchLong = Watch.sleep("long");
68
- const WatchEmit = Watch.step("emit", { payload: Schema.String, success: Schema.String });
69
- const Emit = Actor.command("Emit", {
70
- payload: { orderId: Schema.String, amount: Schema.Int },
71
- });
72
- /** Waits for a `Paid` event for order `k`, with no timeout. */
73
- const Held = Actor.workflow("Held", { success: Schema.String });
74
- const HeldPaid = Held.wait("paid", Paid);
75
- /** Prunes events after an hour, so a case can see which ones a pending wait pins. */
76
- export const Keeper = Actor.make("Keeper", {
77
- key: Schema.String,
78
- events: [Paid],
79
- api: { Emit, Held },
80
- policy: { keepEvents: "1 hour" },
81
- });
82
- /** Creates a step constructor inside its body, which the engine must refuse. */
83
- const Loose = Actor.workflow("Loose", { success: Schema.String });
84
- let looseSteps = 0;
85
- export const Ledger = Actor.make("Ledger", {
86
- key: Schema.String,
87
- state: Actor.state({ count: Schema.Int.pipe(Schema.withDecodingDefault(Effect.succeed(0))) }),
88
- api: { Charge },
89
- });
90
- const Begin = Actor.command("Begin", {
91
- payload: { orderId: Schema.String, sku: Schema.String },
92
- success: Schema.String,
93
- });
94
- const Defer = Actor.command("Defer", {
95
- payload: { orderId: Schema.String, sku: Schema.String },
96
- success: Schema.String,
97
- });
98
- export const Shipper = Actor.make("Shipper", {
99
- key: Schema.String,
100
- events: [Paid],
101
- api: { Ship, Quote, Pay, Begin, Attributed, Loose, Watch, Defer },
102
- });
103
- export const Probe = Actor.workflow("Probe", {
104
- payload: ProbeInput,
105
- success: Schema.String,
106
- error: Flake,
107
- key: ({ scenario, key }) => `${scenario}/${key}`,
108
- });
109
- const probeSteps = {
110
- once: Probe.step("once", { success: Schema.String, error: Flake }),
111
- fast: Probe.step("fast", { success: Schema.String, error: Flake }),
112
- hold: Probe.step("hold", { success: Schema.String, error: Flake }),
113
- flaky: Probe.step("flaky", { success: Schema.String, error: Flake }),
114
- };
115
- const Nap = Probe.sleep("nap");
116
- const Pick = Probe.race("pick", { success: Schema.String });
117
- /** Reports whether a body can reach an Effect `WorkflowEngine`, as `DurableDeferred.done` needs. */
118
- const Inspect = Actor.workflow("Inspect", { success: Schema.String });
119
- export const EngineProbe = Actor.make("EngineProbe", {
120
- key: Schema.String,
121
- api: { Probe, Inspect },
122
- });
123
- const probePrimitives = {
124
- activity: (name, execute) => probeSteps[name].run(undefined, () => execute),
125
- sleep: (_, duration) => Nap(duration),
126
- race: (_, effects) => Pick.run(effects),
127
- };
128
- const bump = (fixture, key) => Effect.sync(() => fixture.runs.set(key, (fixture.runs.get(key) ?? 0) + 1));
129
- const LedgerLive = Ledger.toLayer(Effect.succeed({
130
- Charge: Effect.fnUntraced(function* () {
131
- const turn = yield* Ledger.Turn;
132
- yield* turn.state.set({ count: turn.state.count + 1 });
133
- return turn.state.count;
134
- }),
135
- }));
136
- export const workflowsLayer = (fixture) => Layer.mergeAll(LedgerLive, Keeper.toLayer(Effect.succeed({
137
- Emit: Effect.fnUntraced(function* (input) {
138
- yield* (yield* Keeper.Turn).emit(Paid.make(input));
139
- }),
140
- Held: () => HeldPaid({ where: (event) => event.orderId === "k" }).pipe(Effect.map(Option.match({ onNone: () => "unpaid", onSome: (event) => `paid-${event.amount}` }))),
141
- })), Audit.toLayer(Effect.succeed({
142
- Record: Effect.fnUntraced(function* (key) {
143
- const turn = yield* Audit.Turn;
144
- fixture.audits.set(key, { tenant: turn.ref.tenant, caller: turn.caller });
145
- }),
146
- })), EngineProbe.toLayer(Effect.succeed({
147
- Probe: (input) => probeBody({ primitives: probePrimitives, fixture: fixture.engine, input }),
148
- Inspect: () => Effect.serviceOption(WorkflowEngine.WorkflowEngine).pipe(Effect.map((engine) => (Option.isSome(engine) ? "present" : "absent"))),
149
- })), Shipper.toLayer(Effect.succeed({
150
- Begin: Effect.fnUntraced(function* (input) {
151
- const turn = yield* Shipper.Turn;
152
- yield* turn.emit(Paid.make({ orderId: input.orderId, amount: 3 }));
153
- return yield* (yield* Shipper.intents(turn.id)).Ship(input);
154
- }),
155
- Defer: Effect.fnUntraced(function* (input) {
156
- const turn = yield* Shipper.Turn;
157
- return yield* (yield* Shipper.intents(turn.id))
158
- .Ship(input)
159
- .pipe(Intent.after("500 millis"));
160
- }),
161
- Pay: Effect.fnUntraced(function* (input) {
162
- const turn = yield* Shipper.Turn;
163
- yield* turn.emit(Paid.make(input));
164
- }),
165
- Quote: (input) => Effect.succeed(`q-${input.n}`),
166
- Attributed: Effect.fnUntraced(function* (input) {
167
- const wf = yield* Shipper.Workflow;
168
- yield* AttributedNap("10 seconds");
169
- yield* Report.run(input.key, (key) => Effect.gen(function* () {
170
- yield* (yield* Audit.get(key)).Record(key).pipe(Effect.orDie);
171
- return key;
172
- }));
173
- return Option.match(wf.principal, {
174
- onNone: () => "anonymous",
175
- onSome: ({ subject }) => subject,
176
- });
177
- }),
178
- Watch: Effect.fnUntraced(function* (input) {
179
- const { mode, orderId } = input;
180
- const gated = (step, label) => step.run(orderId, (key) => Effect.gen(function* () {
181
- yield* bump(fixture, `${label}:${key}`);
182
- const gate = fixture.gates.get(key);
183
- if (gate !== undefined)
184
- yield* Deferred.await(gate);
185
- return label;
186
- }));
187
- const marked = (step, label) => step.run(orderId, (key) => bump(fixture, `${label}:${key}`).pipe(Effect.as(label)));
188
- const paid = (wait, where) => wait({
189
- where: where ? (event) => event.orderId === orderId : undefined,
190
- timeout: "1 minute",
191
- }).pipe(Effect.map(Option.match({ onNone: () => "unpaid", onSome: (event) => `paid-${event.amount}` })));
192
- switch (mode) {
193
- case "gated":
194
- yield* gated(WatchHold, "hold");
195
- return yield* paid(WatchFirst, true);
196
- case "plain":
197
- return yield* paid(WatchFirst, true);
198
- case "any":
199
- return yield* paid(WatchFirst, false);
200
- case "two":
201
- return `${yield* paid(WatchFirst, true)}|${yield* paid(WatchSecond, true)}`;
202
- case "race":
203
- return yield* WatchPick.run([paid(WatchFirst, true), gated(WatchSlow, "slow")]);
204
- case "clocks":
205
- yield* Effect.all([
206
- WatchNapA("5 seconds").pipe(Effect.andThen(marked(WatchMarkA, "mark-a"))),
207
- WatchNapB("10 seconds").pipe(Effect.andThen(marked(WatchMarkB, "mark-b"))),
208
- ], { concurrency: "unbounded" });
209
- return "clocks";
210
- case "phases":
211
- yield* WatchNapA("5 seconds");
212
- yield* gated(WatchHold, "hold");
213
- yield* WatchNapB("5 seconds");
214
- return "phases";
215
- case "long":
216
- yield* WatchLong("10 seconds");
217
- return yield* marked(WatchMarkA, "slept");
218
- case "sibling": {
219
- const { id } = yield* Shipper.Workflow;
220
- const [waited, emitted] = yield* Effect.all([
221
- paid(WatchFirst, true),
222
- WatchEmit.run(orderId, (key) => Effect.gen(function* () {
223
- yield* bump(fixture, `emit:${key}`);
224
- const gate = fixture.gates.get(key);
225
- if (gate !== undefined)
226
- yield* Deferred.await(gate);
227
- yield* (yield* Shipper.get(id))
228
- .Pay({ orderId: key, amount: 8 })
229
- .pipe(Effect.orDie);
230
- return "emitted";
231
- })),
232
- ], { concurrency: "unbounded" });
233
- return `${waited}|${emitted}`;
234
- }
235
- }
236
- return yield* Effect.die(new Error(`Unknown mode ${mode}`));
237
- }),
238
- Loose: Effect.fnUntraced(function* () {
239
- looseSteps += 1;
240
- const Late = Loose.step(`late-${looseSteps}`, { success: Schema.String });
241
- return yield* Late.run(undefined, () => Effect.succeed("ran"));
242
- }),
243
- Ship: Effect.fnUntraced(function* (input) {
244
- const wf = yield* Shipper.Workflow;
245
- const reservation = yield* Reserve.run(input.sku, (sku) => Effect.gen(function* () {
246
- yield* bump(fixture, `reserve:${input.orderId}`);
247
- if (sku === "none")
248
- return yield* OutOfStock.make({ sku });
249
- if (sku.startsWith("charge")) {
250
- const ledger = yield* Ledger.get(input.orderId);
251
- const first = yield* ledger.Charge(sku).pipe(Effect.orDie);
252
- const gate = fixture.blocked;
253
- if (sku.includes("block") && gate !== undefined) {
254
- fixture.blocked = undefined;
255
- yield* Deferred.await(gate);
256
- }
257
- const again = yield* ledger.Charge(sku).pipe(Effect.orDie);
258
- return `r-${sku}-${first}-${again}`;
259
- }
260
- const gate = fixture.blocked;
261
- if ((sku.startsWith("block") || sku.startsWith("late")) && gate !== undefined) {
262
- fixture.blocked = undefined;
263
- yield* Deferred.await(gate);
264
- }
265
- if (sku.startsWith("late"))
266
- return `r-${sku}-${yield* (yield* Ledger.get(input.orderId)).Charge(sku).pipe(Effect.orDie)}`;
267
- return `r-${sku}`;
268
- }));
269
- const label = yield* wf.version("label");
270
- if (input.sku.startsWith("twice"))
271
- return `${reservation}|${yield* Reserve.run("again", (sku) => Effect.succeed(`r-${sku}`))}`;
272
- if (input.sku.startsWith("outside"))
273
- yield* (yield* Ledger.get(input.orderId)).Charge(input.sku).pipe(Effect.orDie);
274
- if (input.sku.startsWith("sleep"))
275
- yield* CoolOff("10 seconds");
276
- if (input.sku.startsWith("race"))
277
- return `${reservation}:${yield* FirstSignal.run([
278
- AwaitPaid({
279
- where: (event) => event.orderId === input.orderId,
280
- timeout: "1 minute",
281
- }).pipe(Effect.map(Option.match({
282
- onNone: () => "unpaid",
283
- onSome: (event) => `paid-${event.amount}`,
284
- }))),
285
- Grace("10 seconds").pipe(Effect.as("grace")),
286
- ])}`;
287
- if (input.sku.startsWith("wait")) {
288
- const paid = yield* AwaitPaid({
289
- where: (event) => event.orderId === input.orderId,
290
- timeout: "1 minute",
291
- });
292
- return Option.match(paid, {
293
- onNone: () => `${reservation}:unpaid`,
294
- onSome: (event) => `${reservation}:paid-${event.amount}`,
295
- });
296
- }
297
- return `${reservation}:v${label}`;
298
- }),
299
- })));
300
- export const workflowsLive = (fixture) => Layer.mergeAll(workflowsLayer(fixture));
301
- /** Workflow actors. */
302
- export const workflowsSuite = {
303
- fixture: workflowsFixture,
304
- layer: workflowsLive,
305
- };
@@ -1,4 +0,0 @@
1
- import type { ConformanceCase } from "../../conformance.ts";
2
- import { type WorkflowsFixture } from "./actors.ts";
3
- /** Starts, recorded activities, durable sleeps, status, and inspection views of workflows. */
4
- export declare const workflowBasicConformance: ReadonlyArray<ConformanceCase<WorkflowsFixture>>;
@@ -1,144 +0,0 @@
1
- import { Deferred, Effect, Exit, Option } from "effect";
2
- import { SqlClient } from "effect/sql";
3
- import { ActorTest } from "../../actor-test.js";
4
- import { EngineProbe, OutOfStock, Ship, Shipper } from "./actors.js";
5
- import { eventually, reset, suspendedRow } from "./harness.js";
6
- /** Starts, recorded activities, durable sleeps, status, and inspection views of workflows. */
7
- export const workflowBasicConformance = [
8
- {
9
- name: "workflows: a live interrupt finishes well within the recovery interval",
10
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
11
- const engine = fixture.engine;
12
- const key = "live-interrupt";
13
- const gate = yield* Deferred.make();
14
- engine.gates.set(key, gate);
15
- const probe = yield* EngineProbe.get(key);
16
- const run = yield* probe.Probe({ scenario: "compensate-hold", key });
17
- yield* eventually(Effect.sync(() => (engine.runs.get(`hold:${key}`) ?? 0) >= 1), "the activity to start");
18
- yield* run.interrupt;
19
- const exit = yield* run.result.pipe(Effect.exit, Effect.timeoutOrElse({
20
- duration: "10 seconds",
21
- orElse: () => Effect.die(new Error("The live interrupt waited for recovery")),
22
- }));
23
- expect(Exit.isFailure(exit) && Exit.hasInterrupts(exit)).toBe(true);
24
- expect(engine.runs.get(`compensate:${key}`)).toBe(1);
25
- }).pipe(Effect.ensuring(Effect.gen(function* () {
26
- const gate = fixture.engine.gates.get("live-interrupt");
27
- if (gate !== undefined)
28
- yield* Deferred.succeed(gate, undefined);
29
- })))),
30
- },
31
- {
32
- name: "workflows: a start returns a stable execution id, records the activity once, and finishes",
33
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
34
- yield* reset(fixture);
35
- const shipper = yield* Shipper.get("stable");
36
- const run = yield* shipper.Ship({ orderId: "o1", sku: "a" });
37
- expect(run.executionId.startsWith("w1.")).toBe(true);
38
- expect(yield* run.result).toBe("r-a:v2");
39
- const again = yield* shipper.Ship({ orderId: "o1", sku: "a" });
40
- expect(again.executionId).toBe(run.executionId);
41
- expect(yield* again.result).toBe("r-a:v2");
42
- expect(fixture.runs.get("reserve:o1")).toBe(1);
43
- const polled = yield* run.poll;
44
- expect(Option.isSome(polled) && polled.value._tag).toBe("Complete");
45
- const reattached = yield* Shipper.run(Ship, run.executionId);
46
- expect(yield* reattached.result).toBe("r-a:v2");
47
- })),
48
- },
49
- {
50
- name: "workflows: a declared activity failure is recorded and fails the run with its class",
51
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
52
- yield* reset(fixture);
53
- const shipper = yield* Shipper.get("failing");
54
- const run = yield* shipper.Ship({ orderId: "o2", sku: "none" });
55
- const error = yield* run.result.pipe(Effect.flip);
56
- expect(error).toBeInstanceOf(OutOfStock);
57
- expect(error).toEqual(OutOfStock.make({ sku: "none" }));
58
- expect(fixture.runs.get("reserve:o2")).toBe(1);
59
- })),
60
- },
61
- {
62
- name: "workflows: a durable sleep suspends and the relay resumes it when due",
63
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
64
- yield* reset(fixture);
65
- const test = yield* ActorTest;
66
- const shipper = yield* Shipper.get("sleeping");
67
- const run = yield* shipper.Ship({ orderId: "o3", sku: "sleep" });
68
- yield* suspendedRow(run.executionId);
69
- const pending = yield* run.poll;
70
- expect(Option.isSome(pending) && pending.value._tag).toBe("Suspended");
71
- yield* test.advance("11 seconds");
72
- expect(yield* run.result).toBe("r-sleep:v2");
73
- expect(fixture.runs.get("reserve:o3")).toBe(1);
74
- })),
75
- },
76
- {
77
- name: "workflows: status is running while a resumed run executes and suspended only while parked",
78
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
79
- yield* reset(fixture);
80
- const sql = yield* SqlClient.SqlClient;
81
- const test = yield* ActorTest;
82
- const gate = yield* Deferred.make();
83
- fixture.gates.set("phases", gate);
84
- const shipper = yield* Shipper.get("phases");
85
- const run = yield* shipper.Watch({ mode: "phases", orderId: "phases" });
86
- const status = () => sql `SELECT status FROM durable.workflows
87
- WHERE execution_id = ${run.executionId}`.pipe(Effect.map((rows) => rows[0]?.status));
88
- yield* suspendedRow(run.executionId);
89
- expect(yield* status()).toBe("suspended");
90
- yield* test.advance("6 seconds");
91
- yield* eventually(Effect.sync(() => fixture.runs.get("hold:phases") === 1), "the resumed run to reach its activity");
92
- expect(yield* status()).toBe("running");
93
- yield* Deferred.succeed(gate, undefined);
94
- yield* suspendedRow(run.executionId);
95
- expect(yield* status()).toBe("suspended");
96
- yield* test.advance("6 seconds");
97
- expect(yield* run.result).toBe("phases");
98
- expect(yield* status()).toBe("finished");
99
- }).pipe(Effect.ensuring(Effect.sync(() => fixture.gates.delete("phases"))))),
100
- },
101
- {
102
- name: "workflows: durable.workflows and durable.workflow_steps show a suspended then finished execution",
103
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
104
- yield* reset(fixture);
105
- const sql = yield* SqlClient.SqlClient;
106
- const test = yield* ActorTest;
107
- const shipper = yield* Shipper.get("inspected");
108
- const run = yield* shipper.Ship({ orderId: "o-inspect", sku: "sleep" });
109
- const execution = () => sql `SELECT execution_id, tenant_id, workflow, workflow_key, status,
110
- finished_at IS NOT NULL AS finished, result_bytes > 0 AS stored
111
- FROM durable.workflows
112
- WHERE tenant_id = ${test.tenant} AND actor_type = 'Shipper' AND actor_id = 'inspected'`;
113
- const steps = () => sql `
114
- SELECT step, kind, exit IS NOT NULL AS settled,
115
- due_at IS NOT DISTINCT FROM to_timestamp(due_at_ms::float8 / 1000) AS dated
116
- FROM durable.workflow_steps
117
- WHERE tenant_id = ${test.tenant} AND execution_id = ${run.executionId}
118
- AND kind IN ('activity', 'clock')
119
- ORDER BY started_at_ms, step`;
120
- yield* suspendedRow(run.executionId);
121
- expect(yield* execution()).toEqual([
122
- {
123
- execution_id: run.executionId,
124
- tenant_id: test.tenant,
125
- workflow: "Ship",
126
- workflow_key: "o-inspect",
127
- status: "suspended",
128
- finished: false,
129
- stored: null,
130
- },
131
- ]);
132
- expect(yield* steps()).toEqual([
133
- { step: "reserve", kind: "activity", settled: true, dated: true },
134
- { step: "cool-off", kind: "clock", settled: false, dated: true },
135
- ]);
136
- yield* test.advance("11 seconds");
137
- expect(yield* run.result).toBe("r-sleep:v2");
138
- expect(yield* execution()).toMatchObject([
139
- { status: "finished", finished: true, stored: true },
140
- ]);
141
- expect(yield* steps()).toEqual([]);
142
- })),
143
- },
144
- ];
@@ -1,4 +0,0 @@
1
- import type { ConformanceCase } from "../../conformance.ts";
2
- import { type WorkflowsFixture } from "./actors.ts";
3
- /** The shared engine suite on the framework engine, plus its ours-only divergences. */
4
- export declare const engineConformance: ReadonlyArray<ConformanceCase<WorkflowsFixture>>;
@@ -1,80 +0,0 @@
1
- import { DateTime, Duration, Effect } from "effect";
2
- import { SqlClient } from "effect/sql";
3
- import { Actor } from "../../../index.js";
4
- import { ActorTest } from "../../actor-test.js";
5
- import { encodeExecutionId } from "../../../identity/execution.js";
6
- import { engineCases, eventually as eventuallyEngine, } from "../workflow-engine.js";
7
- import { EngineProbe, Probe } from "./actors.js";
8
- /**
9
- * The shared engine suite's driver for the framework engine, on the
10
- * conformance environment's database. Every call pins the first runtime's
11
- * tenant, so an execution stays reachable across `restart`.
12
- */
13
- const frameworkDriver = (environment) => Effect.gen(function* () {
14
- const tenant = yield* Effect.promise(() => environment.run(Effect.map(Effect.service(ActorTest), (test) => test.tenant)));
15
- const inTenant = (effect) => Effect.promise(() => environment.run(effect.pipe(Actor.tenant(tenant))));
16
- const runOf = (scenario, key) => Effect.gen(function* () {
17
- const executionId = yield* encodeExecutionId({
18
- tenant,
19
- actor: "EngineProbe",
20
- id: key,
21
- workflow: "Probe",
22
- key: `${scenario}/${key}`,
23
- }).pipe(Effect.orDie);
24
- const reattach = EngineProbe.run(Probe, executionId).pipe(Effect.orDie);
25
- return {
26
- executionId,
27
- poll: inTenant(Effect.flatMap(reattach, (run) => run.poll).pipe(Effect.orDie)),
28
- interrupt: inTenant(Effect.flatMap(reattach, (run) => run.interrupt).pipe(Effect.orDie)),
29
- };
30
- });
31
- const start = (scenario, key) => inTenant(Effect.flatMap(EngineProbe.get(key), (probe) => probe.Probe({ scenario, key })).pipe(Effect.orDie));
32
- const driver = {
33
- pollWhileRunning: "Suspended",
34
- execute: (scenario, key) => start(scenario, key).pipe(Effect.flatMap((run) => inTenant(Effect.exit(run.result)))),
35
- start: (scenario, key) => Effect.andThen(start(scenario, key), runOf(scenario, key)),
36
- attach: runOf,
37
- awaitSuspended: (run) => eventuallyEngine({
38
- check: inTenant(Effect.gen(function* () {
39
- const sql = yield* SqlClient.SqlClient;
40
- const rows = yield* sql `SELECT status FROM actor_workflow_executions
41
- WHERE execution_id = ${run.executionId}`;
42
- return rows[0]?.status === "suspended";
43
- }).pipe(Effect.orDie)),
44
- what: `${run.executionId} to suspend`,
45
- }),
46
- advance: (duration) => inTenant(ActorTest.use((test) => test.advance(Duration.sum(Duration.fromInputUnsafe(duration), Duration.seconds(1))))),
47
- restart: Effect.gen(function* () {
48
- const now = (test) => test.now.pipe(Effect.map(DateTime.toEpochMillis));
49
- const before = yield* inTenant(Effect.flatMap(Effect.service(ActorTest), now));
50
- yield* environment.restart;
51
- const after = yield* inTenant(Effect.flatMap(Effect.service(ActorTest), now));
52
- if (before > after)
53
- yield* inTenant(ActorTest.use((test) => test.advance(before - after)));
54
- }),
55
- };
56
- return driver;
57
- });
58
- /** The shared engine suite on the framework engine, plus its ours-only divergences. */
59
- export const engineConformance = [
60
- ...engineCases.map((engineCase, index) => ({
61
- name: `workflow engine: ${engineCase.name}`,
62
- timeoutMs: 60_000,
63
- run: ({ expect, environment, fixture }) => Effect.runPromise(Effect.gen(function* () {
64
- const driver = yield* frameworkDriver(environment);
65
- yield* engineCase.run({
66
- driver,
67
- fixture: fixture.engine,
68
- expect,
69
- key: `engine-${index}`,
70
- });
71
- })),
72
- })),
73
- {
74
- name: "workflow engine: a body reaches no Effect WorkflowEngine, so external DurableDeferred completion is unsupported",
75
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
76
- const probe = yield* EngineProbe.get("inspect");
77
- expect(yield* (yield* probe.Inspect({})).result).toBe("absent");
78
- })),
79
- },
80
- ];
@@ -1,4 +0,0 @@
1
- import type { ConformanceCase } from "../../conformance.ts";
2
- import { type WorkflowsFixture } from "./actors.ts";
3
- /** Expiry bounds, fencing, deduplication, and body-shape guards of workflows. */
4
- export declare const workflowGuardConformance: ReadonlyArray<ConformanceCase<WorkflowsFixture>>;