@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,23 +0,0 @@
1
- import { Effect, Layer } from "effect";
2
- import type { ExecutorContext } from "../../contexts/job.ts";
3
- import type { ConformanceCase, ConformanceSuite } from "../conformance.ts";
4
- /** What the fake provider does on one call; calls past the plan succeed. */
5
- type ProviderStep = "ok" | "fail" | "die";
6
- export interface EffectsFixture {
7
- /** Provider calls keyed by idempotency key, the effect id. */
8
- readonly calls: Map<string, number>;
9
- readonly attempts: Array<ExecutorContext>;
10
- plan: Array<ProviderStep>;
11
- /** Whether any executor attempt could reach a SQL client. */
12
- sawDatabase: boolean;
13
- escaped: Effect.Effect<void>;
14
- }
15
- /** Creates the state effect cases observe; each case starts from a fresh one. */
16
- export declare const effectsFixture: () => EffectsFixture;
17
- /** Handlers for the effect actors; `fixture` supplies the fake provider and the counters cases assert on. */
18
- export declare const effectsLayer: (fixture: EffectsFixture) => Layer.Layer<never, never, import("../index.ts").InternalActors>;
19
- /** Effect cases: executors run only after the turn commits, results route to `onSuccess` once under the effect id, and declared failures, defects, and rolled-back commits discard performed effects. */
20
- export declare const effectsConformance: ReadonlyArray<ConformanceCase<EffectsFixture>>;
21
- /** The effect actors and their executors. */
22
- export declare const effectsSuite: ConformanceSuite<EffectsFixture>;
23
- export {};
@@ -1,432 +0,0 @@
1
- import { PgClient } from "@effect/sql-pg";
2
- import { PgliteClient } from "@effect/sql-pglite";
3
- import { Cause, Effect, Exit, Fiber, Layer, Option, Schema } from "effect";
4
- import { SqlClient } from "effect/sql";
5
- import { Actor, Caller, System } from "../../index.js";
6
- import { CommandId } from "../../identity/command.js";
7
- import { ActorTest } from "../actor-test.js";
8
- /** Creates the state effect cases observe; each case starts from a fresh one. */
9
- export const effectsFixture = () => ({
10
- calls: new Map(),
11
- attempts: [],
12
- plan: [],
13
- sawDatabase: false,
14
- escaped: Effect.void,
15
- });
16
- class ProviderDown extends Schema.TaggedError()("ProviderDown", {}) {
17
- }
18
- class Refused extends Schema.TaggedError()("Refused", {}) {
19
- }
20
- const Verdict = Schema.Struct({ id: Schema.String, flagged: Schema.Boolean });
21
- const Moderate = Actor.job("Moderate", {
22
- payload: { id: Schema.String, body: Schema.String },
23
- success: Verdict,
24
- });
25
- const Measure = Actor.job("Measure", {
26
- payload: { value: Schema.Finite },
27
- success: Schema.Finite,
28
- });
29
- const Notify = Actor.job("Notify", { payload: { body: Schema.String } });
30
- const Routed = Schema.Struct({
31
- id: Schema.String,
32
- flagged: Schema.Boolean,
33
- commandId: Schema.String,
34
- caller: Caller,
35
- });
36
- const Dead = Schema.Struct({
37
- effectId: Schema.String,
38
- id: Schema.String,
39
- attempts: Schema.Int,
40
- cause: Schema.String,
41
- ambiguous: Schema.Boolean,
42
- commandId: Schema.String,
43
- });
44
- const Post = Actor.command("Post", { payload: Schema.String });
45
- const PostThenRefuse = Actor.command("PostThenRefuse", { payload: Schema.String, error: Refused });
46
- const PostThenDie = Actor.command("PostThenDie", { payload: Schema.String });
47
- const Ping = Actor.command("Ping", { payload: Schema.String });
48
- const Escape = Actor.command("Escape");
49
- const Gauge = Actor.command("Gauge", { payload: Schema.Finite });
50
- const Measured = Actor.command("Measured", { payload: Schema.Int });
51
- const Steal = Actor.command("Steal");
52
- const Moderated = Actor.command("Moderated", { payload: Verdict });
53
- const ModerationFailed = Actor.command("ModerationFailed", { payload: Actor.DeadLetter(Moderate) });
54
- const Author = Actor.make("Author", {
55
- key: Schema.String,
56
- state: Actor.state({
57
- routed: Schema.Array(Routed).pipe(Schema.withDecodingDefault(Effect.succeed([]))),
58
- dead: Schema.Array(Dead).pipe(Schema.withDecodingDefault(Effect.succeed([]))),
59
- }),
60
- jobs: {
61
- Moderate: {
62
- job: Moderate,
63
- retry: { times: 1 },
64
- onSuccess: Moderated,
65
- onDeadLetter: ModerationFailed,
66
- },
67
- Notify: { job: Notify, retry: { times: 0 } },
68
- Measure: { job: Measure, retry: { times: 2 }, onSuccess: Measured },
69
- },
70
- api: { Post, PostThenRefuse, PostThenDie, Ping, Escape, Steal, Gauge },
71
- internal: { Moderated, ModerationFailed, Measured },
72
- });
73
- const AuthorState = Schema.Struct({
74
- routed: Schema.optional(Schema.Array(Routed)),
75
- dead: Schema.optional(Schema.Array(Dead)),
76
- });
77
- /** Handlers for the effect actors; `fixture` supplies the fake provider and the counters cases assert on. */
78
- export const effectsLayer = (fixture) => Layer.mergeAll(Author.toLayer(Effect.succeed({
79
- Post: Effect.fnUntraced(function* (body) {
80
- const turn = yield* Author.Turn;
81
- yield* turn.enqueue(Moderate.make({ id: turn.commandId, body }));
82
- }),
83
- PostThenRefuse: Effect.fnUntraced(function* (body) {
84
- const turn = yield* Author.Turn;
85
- yield* turn.enqueue(Moderate.make({ id: turn.commandId, body }));
86
- return yield* Refused.make({});
87
- }),
88
- PostThenDie: Effect.fnUntraced(function* (body) {
89
- const turn = yield* Author.Turn;
90
- yield* turn.enqueue(Moderate.make({ id: turn.commandId, body }));
91
- return yield* Effect.die(new Error("Author defect after performing"));
92
- }),
93
- Ping: Effect.fnUntraced(function* (body) {
94
- yield* (yield* Author.Turn).enqueue(Notify.make({ body }));
95
- }),
96
- Escape: Effect.fnUntraced(function* () {
97
- const turn = yield* Author.Turn;
98
- fixture.escaped = turn.enqueue(Notify.make({ body: "escaped" }));
99
- }),
100
- Steal: () => Effect.suspend(() => fixture.escaped),
101
- Gauge: Effect.fnUntraced(function* (value) {
102
- yield* (yield* Author.Turn).enqueue(Measure.make({ value }));
103
- }),
104
- Measured: () => Effect.void,
105
- Moderated: Effect.fnUntraced(function* (verdict) {
106
- const turn = yield* Author.Turn;
107
- yield* turn.state.set({
108
- routed: [
109
- ...turn.state.routed,
110
- { ...verdict, commandId: turn.commandId, caller: turn.caller },
111
- ],
112
- });
113
- }),
114
- ModerationFailed: Effect.fnUntraced(function* (letter) {
115
- const turn = yield* Author.Turn;
116
- yield* turn.state.set({
117
- dead: [
118
- ...turn.state.dead,
119
- {
120
- effectId: letter.jobId,
121
- id: letter.job.id,
122
- attempts: letter.attempts,
123
- cause: letter.cause,
124
- ambiguous: letter.ambiguous,
125
- commandId: turn.commandId,
126
- },
127
- ],
128
- });
129
- }),
130
- })), Author.toJobLayer(Effect.succeed({
131
- Moderate: Effect.fnUntraced(function* ({ id, body }) {
132
- const exec = yield* Author.Executor;
133
- fixture.attempts.push(exec);
134
- fixture.sawDatabase ||=
135
- Option.isSome(yield* Effect.serviceOption(SqlClient.SqlClient)) ||
136
- Option.isSome(yield* Effect.serviceOption(PgClient.PgClient)) ||
137
- Option.isSome(yield* Effect.serviceOption(PgliteClient.PgliteClient));
138
- const step = fixture.plan.shift() ?? "ok";
139
- if (step === "fail")
140
- return yield* ProviderDown.make({});
141
- fixture.calls.set(exec.jobId, (fixture.calls.get(exec.jobId) ?? 0) + 1);
142
- if (step === "die")
143
- return yield* Effect.die(new Error("Provider reply lost"));
144
- return { id, flagged: body.includes("spam") };
145
- }),
146
- Measure: Effect.fnUntraced(function* ({ value }) {
147
- const exec = yield* Author.Executor;
148
- fixture.attempts.push(exec);
149
- fixture.calls.set(exec.jobId, (fixture.calls.get(exec.jobId) ?? 0) + 1);
150
- return value;
151
- }),
152
- Notify: Effect.fnUntraced(function* () {
153
- const exec = yield* Author.Executor;
154
- fixture.attempts.push(exec);
155
- fixture.calls.set(exec.jobId, (fixture.calls.get(exec.jobId) ?? 0) + 1);
156
- if (fixture.plan.shift() === "die")
157
- return yield* Effect.die(new Error("Provider reply lost"));
158
- }),
159
- })));
160
- const authorState = Effect.fnUntraced(function* (id) {
161
- const author = yield* Author.get(id);
162
- const { state } = yield* (yield* ActorTest).inspect(author.ref);
163
- const decoded = yield* Schema.decodeUnknownEffect(AuthorState)(state).pipe(Effect.orDie);
164
- return { routed: decoded.routed ?? [], dead: decoded.dead ?? [] };
165
- });
166
- const deadLetters = Effect.fnUntraced(function* (actorId) {
167
- const sql = yield* SqlClient.SqlClient;
168
- const test = yield* ActorTest;
169
- return yield* sql `SELECT job, attempts, ambiguous FROM actor_dead_letters
170
- WHERE tenant_id = ${test.tenant} AND actor_type = 'Author' AND actor_id = ${actorId}
171
- ORDER BY job`;
172
- });
173
- const attemptsOf = (fixture, id) => fixture.attempts.filter((attempt) => attempt.ref.id === id);
174
- /** Effect cases: executors run only after the turn commits, results route to `onSuccess` once under the effect id, and declared failures, defects, and rolled-back commits discard performed effects. */
175
- export const effectsConformance = [
176
- {
177
- name: "routes an executor's result to onSuccess once with the effect id as its command id",
178
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
179
- const test = yield* ActorTest;
180
- const author = yield* Author.get("route");
181
- yield* author.Post("hello spam");
182
- yield* test.advance(0);
183
- const [attempt] = attemptsOf(fixture, "route");
184
- const { routed } = yield* authorState("route");
185
- expect(attemptsOf(fixture, "route").length).toBe(1);
186
- expect(Schema.is(CommandId)(attempt?.jobId)).toBe(true);
187
- expect(attempt).toMatchObject({ attempt: 1, ref: author.ref });
188
- expect(attempt && Option.getOrUndefined(attempt.principal)).toEqual({ subject: "alice" });
189
- expect(fixture.sawDatabase).toBe(false);
190
- expect(routed).toMatchObject([
191
- {
192
- flagged: true,
193
- commandId: attempt?.jobId,
194
- caller: System.make({
195
- source: "job",
196
- ref: author.ref,
197
- onBehalfOf: { subject: "alice" },
198
- }),
199
- },
200
- ]);
201
- expect(yield* test.receiptsFor(author.ref, "Moderated")).toBe(1);
202
- expect(yield* test.inspect(author.ref)).toMatchObject({
203
- receipts: 2,
204
- outbox: 0,
205
- jobs: 0,
206
- });
207
- yield* test.advance("1 hour");
208
- expect((yield* authorState("route")).routed.length).toBe(1);
209
- })),
210
- },
211
- {
212
- name: "never runs an executor before its turn commits",
213
- requiresIndependentConnections: true,
214
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
215
- const test = yield* ActorTest;
216
- const author = yield* Author.get("visibility");
217
- const pause = yield* test.pauseNext("beforeCommit");
218
- const waiter = yield* author.Post("later").pipe(Effect.forkChild);
219
- yield* pause.reached;
220
- yield* test.advance(0);
221
- expect(attemptsOf(fixture, "visibility")).toEqual([]);
222
- expect(yield* test.inspect(author.ref)).toMatchObject({ receipts: 0, jobs: 0 });
223
- yield* pause.release;
224
- yield* Fiber.join(waiter);
225
- yield* test.advance(0);
226
- expect(attemptsOf(fixture, "visibility").length).toBe(1);
227
- expect((yield* authorState("visibility")).routed.length).toBe(1);
228
- })),
229
- },
230
- {
231
- name: "discards performed effects on a declared failure, a defect, and a rolled-back commit",
232
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
233
- const test = yield* ActorTest;
234
- const author = yield* Author.get("rollback");
235
- expect(yield* author.PostThenRefuse("refused").pipe(Effect.flip)).toBeInstanceOf(Refused);
236
- const died = yield* author.PostThenDie("died").pipe(Effect.exit);
237
- expect(Exit.isFailure(died) && Cause.pretty(died.cause)).toContain("Author defect");
238
- expect(yield* test.inspect(author.ref)).toMatchObject({
239
- receipts: 1,
240
- jobs: 0,
241
- outbox: 0,
242
- });
243
- yield* test.crashNext("beforeCommit");
244
- yield* author.Post("retried");
245
- yield* test.advance(0);
246
- expect(attemptsOf(fixture, "rollback").length).toBe(1);
247
- expect((yield* authorState("rollback")).routed.length).toBe(1);
248
- expect(yield* test.inspect(author.ref)).toMatchObject({
249
- receipts: 3,
250
- jobs: 0,
251
- outbox: 0,
252
- });
253
- })),
254
- },
255
- {
256
- name: "routes a moderation result once, even if the executor succeeds twice",
257
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
258
- const test = yield* ActorTest;
259
- const author = yield* Author.get("twice");
260
- yield* test.crashNext("afterExecute");
261
- yield* author.Post("twice");
262
- yield* test.advance(0);
263
- expect(yield* test.inspect(author.ref)).toMatchObject({ jobs: 1, outbox: 0 });
264
- expect((yield* authorState("twice")).routed).toEqual([]);
265
- yield* test.advance("1 minute");
266
- const attempts = attemptsOf(fixture, "twice");
267
- const effectId = attempts[0].jobId;
268
- expect(attempts.map(({ attempt, jobId }) => [attempt, jobId])).toEqual([
269
- [1, effectId],
270
- [2, effectId],
271
- ]);
272
- expect(fixture.calls.get(effectId)).toBe(2);
273
- expect((yield* authorState("twice")).routed.map(({ commandId }) => commandId)).toEqual([
274
- effectId,
275
- ]);
276
- expect(yield* test.receiptsFor(author.ref, "Moderated")).toBe(1);
277
- expect(yield* test.inspect(author.ref)).toMatchObject({ jobs: 0, outbox: 0 });
278
- })),
279
- },
280
- {
281
- name: "delivers onSuccess once across route crashes after the executor's result is recorded",
282
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
283
- const test = yield* ActorTest;
284
- const author = yield* Author.get("route-crash");
285
- const pause = yield* test.pauseNext("beforeExecute");
286
- yield* author.Post("once");
287
- const draining = yield* test.advance(0).pipe(Effect.forkChild);
288
- yield* pause.reached;
289
- yield* test.crashNext("afterCommit");
290
- yield* test.crashNext("beforeOutboxDelete");
291
- yield* pause.release;
292
- yield* Fiber.join(draining);
293
- yield* test.advance("1 minute");
294
- expect(attemptsOf(fixture, "route-crash").length).toBe(1);
295
- expect((yield* authorState("route-crash")).routed.length).toBe(1);
296
- expect(yield* test.receiptsFor(author.ref, "Moderated")).toBe(1);
297
- expect(yield* test.inspect(author.ref)).toMatchObject({ jobs: 0, outbox: 0 });
298
- })),
299
- },
300
- {
301
- name: "retries after a crash before the executor runs and routes the result once",
302
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
303
- const test = yield* ActorTest;
304
- const author = yield* Author.get("before-execute");
305
- yield* test.crashNext("beforeExecute");
306
- yield* author.Post("claimed");
307
- yield* test.advance(0);
308
- expect(attemptsOf(fixture, "before-execute")).toEqual([]);
309
- expect(yield* test.inspect(author.ref)).toMatchObject({ jobs: 1 });
310
- yield* test.advance("1 minute");
311
- expect(attemptsOf(fixture, "before-execute").map(({ attempt }) => attempt)).toEqual([2]);
312
- expect((yield* authorState("before-execute")).routed.length).toBe(1);
313
- expect(yield* test.inspect(author.ref)).toMatchObject({ jobs: 0, outbox: 0 });
314
- })),
315
- },
316
- {
317
- name: "delivers onDeadLetter once in a new turn after retries run out",
318
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
319
- const test = yield* ActorTest;
320
- const author = yield* Author.get("exhausted");
321
- fixture.plan = ["fail", "fail"];
322
- yield* author.Post("doomed");
323
- yield* test.advance(0);
324
- yield* test.advance("1 second");
325
- const [first] = attemptsOf(fixture, "exhausted");
326
- const { routed, dead } = yield* authorState("exhausted");
327
- expect(attemptsOf(fixture, "exhausted").length).toBe(2);
328
- expect(routed).toEqual([]);
329
- expect(dead).toMatchObject([
330
- {
331
- effectId: first?.jobId,
332
- attempts: 2,
333
- ambiguous: false,
334
- commandId: first?.jobId,
335
- },
336
- ]);
337
- expect(dead[0]?.cause).toContain("ProviderDown");
338
- expect(yield* test.receiptsFor(author.ref, "ModerationFailed")).toBe(1);
339
- expect(yield* deadLetters("exhausted")).toEqual([
340
- { job: "Moderate", attempts: 2, ambiguous: false },
341
- ]);
342
- yield* test.advance("1 hour");
343
- expect((yield* authorState("exhausted")).dead.length).toBe(1);
344
- expect(yield* test.inspect(author.ref)).toMatchObject({ jobs: 0, outbox: 0 });
345
- })),
346
- },
347
- {
348
- name: "keeps a lost provider acknowledgment distinguishable from failure",
349
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
350
- const test = yield* ActorTest;
351
- const author = yield* Author.get("ambiguous");
352
- fixture.plan = ["fail"];
353
- yield* test.crashNext("afterExecute");
354
- yield* author.Post("unknown");
355
- yield* test.advance(0);
356
- yield* test.advance("1 second");
357
- expect((yield* authorState("ambiguous")).dead).toEqual([]);
358
- yield* test.advance("1 minute");
359
- const attempts = attemptsOf(fixture, "ambiguous");
360
- const { dead } = yield* authorState("ambiguous");
361
- expect(fixture.calls.get(attempts[0].jobId)).toBe(1);
362
- expect(dead).toMatchObject([{ attempts: 2, ambiguous: true }]);
363
- expect(dead[0]?.cause).toContain("without reporting an outcome");
364
- fixture.plan = ["die"];
365
- yield* author.Ping("notify");
366
- yield* test.advance(0);
367
- expect(yield* deadLetters("ambiguous")).toEqual([
368
- { job: "Moderate", attempts: 2, ambiguous: true },
369
- { job: "Notify", attempts: 1, ambiguous: true },
370
- ]);
371
- expect(yield* test.inspect(author.ref)).toMatchObject({ jobs: 0, outbox: 0 });
372
- })),
373
- },
374
- {
375
- name: "dead-letters a result its route cannot accept without calling the provider again",
376
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
377
- const test = yield* ActorTest;
378
- const author = yield* Author.get("unroutable");
379
- yield* author.Gauge(1.5);
380
- yield* test.advance("1 hour");
381
- const attempts = attemptsOf(fixture, "unroutable");
382
- expect(attempts.length).toBe(1);
383
- expect(fixture.calls.get(attempts[0].jobId)).toBe(1);
384
- expect(yield* test.receiptsFor(author.ref, "Measured")).toBe(0);
385
- expect(yield* deadLetters("unroutable")).toEqual([
386
- { job: "Measure", attempts: 1, ambiguous: true },
387
- ]);
388
- expect(yield* test.inspect(author.ref)).toMatchObject({ jobs: 0, outbox: 0 });
389
- })),
390
- },
391
- {
392
- name: "retries only the dead letter of a rejected result whose dead-letter commit fails",
393
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
394
- const test = yield* ActorTest;
395
- const author = yield* Author.get("unroutable-retry");
396
- yield* test.crashNext("beforeDeadLetterCommit");
397
- yield* author.Gauge(1.5);
398
- yield* test.advance(0);
399
- expect(yield* deadLetters("unroutable-retry")).toEqual([]);
400
- expect(yield* (yield* SqlClient.SqlClient) `
401
- SELECT attempts, final_failure FROM actor_outbox
402
- WHERE tenant_id = ${test.tenant} AND actor_id = 'unroutable-retry' AND kind = 'job'`).toEqual([{ attempts: 1, final_failure: true }]);
403
- yield* test.advance("1 hour");
404
- const attempts = attemptsOf(fixture, "unroutable-retry");
405
- expect(attempts.map(({ attempt }) => attempt)).toEqual([1]);
406
- expect(fixture.calls.get(attempts[0].jobId)).toBe(1);
407
- expect(yield* test.receiptsFor(author.ref, "Measured")).toBe(0);
408
- expect(yield* deadLetters("unroutable-retry")).toEqual([
409
- { job: "Measure", attempts: 1, ambiguous: true },
410
- ]);
411
- expect(yield* test.inspect(author.ref)).toMatchObject({ jobs: 0, outbox: 0 });
412
- })),
413
- },
414
- {
415
- name: "rejects an escaped perform capability without recording an effect",
416
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
417
- const test = yield* ActorTest;
418
- const author = yield* Author.get("escape");
419
- yield* author.Escape();
420
- const stolen = yield* author.Steal().pipe(Effect.exit);
421
- expect(Exit.isFailure(stolen) && Cause.pretty(stolen.cause)).toContain("Job capability escaped its turn");
422
- yield* test.advance(0);
423
- expect(attemptsOf(fixture, "escape")).toEqual([]);
424
- expect(yield* test.inspect(author.ref)).toMatchObject({ receipts: 1, jobs: 0 });
425
- })),
426
- },
427
- ];
428
- /** The effect actors and their executors. */
429
- export const effectsSuite = {
430
- fixture: effectsFixture,
431
- layer: effectsLayer,
432
- };
@@ -1,28 +0,0 @@
1
- import { Effect, Schema, Layer } from "effect";
2
- import { SqlClient } from "effect/sql";
3
- import { ActorTest } from "../actor-test.ts";
4
- import type { ConformanceCase, ConformanceSuite } from "../conformance.ts";
5
- export interface EventsFixture {
6
- escaped: Effect.Effect<void>;
7
- duringQuery: Effect.Effect<void>;
8
- }
9
- export declare const eventsFixture: () => EventsFixture;
10
- declare const Entry: Schema.Struct<{
11
- readonly cursor: Schema.String;
12
- readonly event: Schema.Union<readonly [import("../../index.ts").EventOf<"Posted", {
13
- readonly body: Schema.String;
14
- }>, import("../../index.ts").EventOf<"Archived", {}>]>;
15
- readonly commandId: Schema.String;
16
- readonly timestamp: Schema.DateTimeUtc;
17
- }>;
18
- export declare const eventsLayer: (fixture: EventsFixture) => Layer.Layer<never, never, import("../index.ts").InternalActors>;
19
- export declare const eventsQueryLayer: (fixture: EventsFixture) => Layer.Layer<never, never, import("../index.ts").InternalActors>;
20
- export declare const bodies: (entries: ReadonlyArray<typeof Entry.Type>) => string[];
21
- export declare const cursors: (entries: ReadonlyArray<typeof Entry.Type>) => string[];
22
- /** Deletes the oldest events up to `through`, as retention will. */
23
- export declare const prune: (id: string, through: number) => Effect.Effect<void, never, ActorTest | SqlClient.SqlClient>;
24
- /** Event cases: events append only on commit, replay in order after an exclusive cursor, and are discarded on declared failures and defects. */
25
- export declare const eventsConformance: ReadonlyArray<ConformanceCase<EventsFixture>>;
26
- /** The event feed actor and its queries. */
27
- export declare const eventsSuite: ConformanceSuite<EventsFixture>;
28
- export {};