@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,368 +0,0 @@
1
- import { Cause, Context, Crypto, Duration, Effect, Exit, FileSystem, Layer, Schema, } from "effect";
2
- import { SqlClient } from "effect/sql";
3
- import { Actor, Intent, User } from "../../index.js";
4
- import { Seed } from "../../runtime/operators/seed.js";
5
- import { ActorTest } from "../actor-test.js";
6
- import { operatorHarness } from "./operator-harness.js";
7
- const LedgerV0 = { total: Schema.Int };
8
- const LedgerV1 = {
9
- balance: Schema.Int.pipe(Schema.withDecodingDefault(Effect.succeed(0))),
10
- memo: Schema.String.pipe(Schema.withDecodingDefault(Effect.succeed(""))),
11
- };
12
- const Announce = Actor.job("ExpAnnounce", {
13
- payload: { text: Schema.String },
14
- });
15
- const Deposit = Actor.command("Deposit", { payload: Schema.Int });
16
- const Audit = Actor.command("Audit");
17
- const Ledger = Actor.make("ExpLedger", {
18
- key: Schema.String,
19
- jobs: { ExpAnnounce: { job: Announce } },
20
- state: Actor.state(LedgerV1, {
21
- migrations: [
22
- Actor.migration(LedgerV0, LedgerV1, ({ total }) => ({ balance: total, memo: "" })),
23
- ],
24
- }),
25
- api: { Deposit },
26
- internal: { Audit },
27
- });
28
- /** What the ledger's timer and executor observed, and reset before each case. */
29
- const fixture = {
30
- audits: [],
31
- announced: [],
32
- };
33
- const live = Layer.mergeAll(Ledger.toLayer(Effect.succeed({
34
- Deposit: Effect.fnUntraced(function* (amount) {
35
- const turn = yield* Ledger.Turn;
36
- yield* turn.state.set({
37
- balance: turn.state.balance + amount,
38
- memo: `deposited ${amount}`,
39
- });
40
- yield* (yield* Ledger.intents(turn.id))
41
- .Audit()
42
- .pipe(Intent.after("1 minute"), Intent.key("audit"));
43
- yield* turn.enqueue(Announce.make({ text: `deposited ${amount}` }), {
44
- key: "announce",
45
- after: Duration.hours(1),
46
- });
47
- }),
48
- Audit: Effect.fnUntraced(function* () {
49
- fixture.audits.push((yield* Ledger.Turn).caller);
50
- }),
51
- })), Ledger.toJobLayer(Effect.succeed({
52
- ExpAnnounce: ({ text }) => Effect.sync(() => {
53
- fixture.announced.push(text);
54
- }),
55
- })));
56
- const withOperators = (environment, tokens, body) => operatorHarness({
57
- environment,
58
- live,
59
- reset: () => {
60
- Object.assign(fixture, { audits: [], announced: [] });
61
- },
62
- tokens,
63
- body,
64
- });
65
- /** A second runtime on its own database, and so its own tenant, running as `as`. */
66
- const replayRuntime = (environment, as) => Effect.gen(function* () {
67
- const crypto = yield* Crypto.Crypto;
68
- const database = yield* environment.freshDatabase;
69
- return yield* Layer.buildWithMemoMap(live.pipe(Layer.provideMerge(ActorTest.layer({
70
- database,
71
- as,
72
- authorize: () => Effect.succeed(true),
73
- retryWindowMs: 60_000,
74
- })), Layer.provide(Layer.succeed(Crypto.Crypto, crypto)), Layer.orDie), yield* Layer.makeMemoMap, yield* Effect.scope);
75
- });
76
- /** A file system holding these seed files, each given as the value its JSON is written from. */
77
- const seedFiles = Effect.fnUntraced(function* (files) {
78
- const texts = new Map();
79
- for (const [path, value] of files)
80
- texts.set(path, yield* encodeJson(value).pipe(Effect.orDie));
81
- return FileSystem.makeNoop({ readFileString: (path) => Effect.succeed(texts.get(path) ?? "") });
82
- });
83
- const paths = (tenant, id = "l1") => ({
84
- inspect: `/operator/actors/ExpLedger/${id}?tenant=${tenant}`,
85
- export: `/operator/actors/ExpLedger/${id}/export?tenant=${tenant}`,
86
- });
87
- const encodeJson = Schema.encodeEffect(Schema.fromJsonString(Schema.Unknown));
88
- const exporter = {
89
- "export-token": [{ action: "export", tenant: "*", actorType: "ExpLedger" }],
90
- };
91
- /** Deposits into `l1` from an old-shape state, so it holds state at version 1, a timer, and an effect. */
92
- const fundedLedger = Effect.gen(function* () {
93
- const test = yield* ActorTest;
94
- const ledger = yield* Ledger.get("l1");
95
- yield* test.seed(ledger.ref, { total: 2 }, 0);
96
- yield* ledger.Deposit(3);
97
- return ledger;
98
- });
99
- /** Every row count and content digest of the runtime's tables, so a read that wrote would show. */
100
- const rows = Effect.gen(function* () {
101
- const sql = yield* SqlClient.SqlClient;
102
- const [snapshot] = yield* sql `SELECT
103
- (SELECT count(*) || ':' || max(generation) || ':' || max(event_sequence) FROM actor_generations) AS generations,
104
- (SELECT count(*) || ':' || coalesce(md5(string_agg(key || encode(value, 'hex'), ',' ORDER BY key)), '') FROM actor_state) AS state,
105
- (SELECT count(*) || ':' || coalesce(md5(string_agg(intent_id || attempts::text, ',' ORDER BY intent_id)), '') FROM actor_outbox) AS outbox,
106
- (SELECT count(*) FROM actor_receipts)::text AS receipts,
107
- (SELECT count(*) FROM actor_events)::text AS events,
108
- (SELECT count(*) FROM actor_dead_letters)::text AS dead_letters`;
109
- return snapshot;
110
- }).pipe(Effect.orDie);
111
- const literalSeed = {
112
- format: 1,
113
- actor: { type: "ExpLedger", id: "l1" },
114
- created: false,
115
- stateVersion: 1,
116
- state: { balance: 5, memo: "literal" },
117
- intents: [],
118
- jobs: [],
119
- omitted: { receipts: 0, events: 0, workflows: 0, deadLetters: 0, tableRows: 0, blobs: 0 },
120
- };
121
- const died = (exit, message) => Exit.isFailure(exit) && Cause.hasDies(exit.cause) && Cause.pretty(exit.cause).includes(message);
122
- export const exportConformance = [
123
- {
124
- name: "exports an actor's state and pending work as a seed with no tenant or caller, and audits the read",
125
- run: ({ expect, environment }) => withOperators(environment, exporter, ({ tenant, send, audit }) => Effect.gen(function* () {
126
- yield* fundedLedger;
127
- const answer = yield* send("GET", paths(tenant).export, "export-token");
128
- const seed = yield* Schema.decodeUnknownEffect(Seed)(answer.body).pipe(Effect.orDie);
129
- expect(answer.status).toBe(200);
130
- expect(seed).toMatchObject({
131
- format: 1,
132
- actor: { type: "ExpLedger", id: "l1" },
133
- created: false,
134
- stateVersion: 1,
135
- state: { balance: 5, memo: "deposited 3" },
136
- intents: [{ target: { actor: "ExpLedger", id: "l1" }, command: "Audit", key: "audit" }],
137
- jobs: [
138
- {
139
- job: "ExpAnnounce",
140
- payload: { text: "deposited 3" },
141
- payloadVersion: 0,
142
- key: "announce",
143
- },
144
- ],
145
- omitted: {
146
- receipts: 1,
147
- events: 0,
148
- workflows: 0,
149
- deadLetters: 0,
150
- tableRows: 0,
151
- blobs: 0,
152
- },
153
- });
154
- const [intent] = seed.intents;
155
- const [job] = seed.jobs;
156
- expect(intent.dueInMs > 30_000 && intent.dueInMs <= 60_000).toBe(true);
157
- expect(job.dueInMs > 3_500_000 && job.dueInMs <= 3_600_000).toBe(true);
158
- const text = yield* encodeJson(answer.body).pipe(Effect.orDie);
159
- expect(text.includes(tenant)).toBe(false);
160
- expect(text.includes("alice")).toBe(false);
161
- expect(yield* audit).toMatchObject([
162
- {
163
- operator: "op-export-token",
164
- action: "export",
165
- actor_id: "l1",
166
- capability: '{"action":"export","tenant":"*","actorType":"ExpLedger"}',
167
- outcome: '"read"',
168
- },
169
- ]);
170
- })),
171
- },
172
- {
173
- name: "reads the actor without writing any table",
174
- run: ({ expect, environment }) => withOperators(environment, exporter, ({ tenant, send }) => Effect.gen(function* () {
175
- yield* fundedLedger;
176
- const before = yield* rows;
177
- for (let index = 0; index < 2; index++)
178
- expect((yield* send("GET", paths(tenant).export, "export-token")).status).toBe(200);
179
- expect(yield* rows).toEqual(before);
180
- })),
181
- },
182
- {
183
- name: "refuses an export outside the export grant, audits the denial, and returns no state",
184
- run: ({ expect, environment }) => withOperators(environment, {
185
- "look-token": [
186
- { action: "inspect", tenant: "*" },
187
- { action: "receipts.read", tenant: "*" },
188
- ],
189
- "narrow-token": [
190
- { action: "export", tenant: "*", actorType: "ExpLedger", actorId: "l2" },
191
- { action: "export", tenant: "another-tenant", actorType: "ExpLedger" },
192
- { action: "export", tenant: "*", actorType: "ExpOther" },
193
- ],
194
- }, ({ tenant, send, audit }) => Effect.gen(function* () {
195
- yield* fundedLedger;
196
- for (const token of ["look-token", "narrow-token"]) {
197
- const answer = yield* send("GET", paths(tenant).export, token);
198
- expect(answer.status).toBe(403);
199
- expect((yield* encodeJson(answer.body).pipe(Effect.orDie)).includes('"state"')).toBe(false);
200
- }
201
- for (const token of ["app-token", undefined])
202
- expect((yield* send("GET", paths(tenant).export, token)).status).toBe(401);
203
- expect((yield* audit).map(({ operator, action, capability, outcome }) => [
204
- operator,
205
- action,
206
- capability,
207
- outcome,
208
- ])).toEqual([
209
- ["op-look-token", "export", null, '"denied"'],
210
- ["op-narrow-token", "export", null, '"denied"'],
211
- ]);
212
- })),
213
- },
214
- {
215
- name: "answers no seed when the audit row cannot be written",
216
- run: ({ expect, environment }) => withOperators(environment, exporter, ({ tenant, send, audit }) => Effect.gen(function* () {
217
- const sql = yield* SqlClient.SqlClient;
218
- yield* fundedLedger;
219
- yield* sql `CREATE FUNCTION exp_audit_refuse() RETURNS trigger LANGUAGE plpgsql AS $$
220
- BEGIN RAISE EXCEPTION 'audit unavailable'; END $$`.pipe(Effect.orDie);
221
- yield* sql `CREATE TRIGGER exp_audit_refuse BEFORE INSERT ON actor_operator_audit
222
- FOR EACH ROW EXECUTE FUNCTION exp_audit_refuse()`.pipe(Effect.orDie);
223
- const failed = yield* send("GET", paths(tenant).export, "export-token");
224
- expect(failed.status).toBe(500);
225
- expect((yield* encodeJson(failed.body).pipe(Effect.orDie)).includes("balance")).toBe(false);
226
- expect(yield* audit).toEqual([]);
227
- })),
228
- },
229
- {
230
- name: "answers not found for an actor of another tenant, however broad the grant",
231
- run: ({ expect, environment }) => withOperators(environment, exporter, ({ send }) => Effect.gen(function* () {
232
- yield* fundedLedger;
233
- expect((yield* send("GET", paths("another-tenant").export, "export-token")).status).toBe(404);
234
- expect((yield* send("GET", paths("another-tenant", "l9").export, "export-token")).status).toBe(404);
235
- })),
236
- },
237
- {
238
- name: "refuses an actor whose stored state does not decode, naming the key and never its value",
239
- run: ({ expect, environment }) => withOperators(environment, exporter, ({ tenant, send, audit }) => Effect.gen(function* () {
240
- const sql = yield* SqlClient.SqlClient;
241
- yield* fundedLedger;
242
- yield* sql `UPDATE actor_state SET value = ${new TextEncoder().encode("secret-not-zstd")} WHERE key = 'balance'`;
243
- const answer = yield* send("GET", paths(tenant).export, "export-token");
244
- expect(answer.status).toBe(409);
245
- expect(answer.body).toMatchObject({ reason: "undecodable", detail: "state balance" });
246
- expect((yield* encodeJson(answer.body).pipe(Effect.orDie)).includes("secret")).toBe(false);
247
- expect((yield* audit).map(({ action }) => action)).toEqual(["export"]);
248
- })),
249
- },
250
- {
251
- name: "refuses an actor holding more pending work than one export carries",
252
- run: ({ expect, environment }) => withOperators(environment, exporter, ({ tenant, send }) => Effect.gen(function* () {
253
- const sql = yield* SqlClient.SqlClient;
254
- yield* fundedLedger;
255
- yield* sql `INSERT INTO actor_outbox (routing_key, intent_id, kind, bucket, due_at_ms,
256
- scheduled_at_ms, tenant_id, actor_type, actor_id, target_type, target_id, command, payload, caller)
257
- SELECT g.routing_key, 'bulk-' || n, 'intent', (g.routing_key >> 56)::int, 4102444800000,
258
- 4102444800000, g.tenant_id, g.actor_type, g.actor_id, g.actor_type, g.actor_id, 'Audit', 'null', '{}'
259
- FROM actor_generations g, generate_series(1, 10001) n WHERE g.actor_id = 'l1'`;
260
- const answer = yield* send("GET", paths(tenant).export, "export-token");
261
- expect(answer.status).toBe(409);
262
- expect(answer.body).toMatchObject({ reason: "too_large", detail: "pending intents" });
263
- })),
264
- },
265
- {
266
- name: "starts an actor in another tenant from an exported seed, running its pending work as the test's caller",
267
- run: ({ expect, environment }) => withOperators(environment, exporter, ({ tenant, send }) => Effect.gen(function* () {
268
- yield* fundedLedger;
269
- const exported = yield* send("GET", paths(tenant).export, "export-token");
270
- const files = yield* seedFiles([["l1.seed", exported.body]]);
271
- const replay = yield* replayRuntime(environment, User.make({ subject: "bob" }));
272
- yield* Effect.gen(function* () {
273
- const test = yield* ActorTest;
274
- const seeded = yield* test.actor(Ledger, "l1", { seed: "l1.seed" });
275
- expect(Context.get(replay, ActorTest).tenant === tenant).toBe(false);
276
- expect(yield* seeded.inspect).toEqual({
277
- generation: "0",
278
- state: { balance: 5, memo: "deposited 3" },
279
- receipts: 0,
280
- events: 0,
281
- outbox: 1,
282
- jobs: 1,
283
- });
284
- yield* test.advance(Duration.minutes(2));
285
- expect(fixture.audits.length).toBe(1);
286
- const delivered = yield* encodeJson(fixture.audits[0]).pipe(Effect.orDie);
287
- expect(delivered.includes("bob")).toBe(true);
288
- expect(delivered.includes("alice")).toBe(false);
289
- expect(fixture.announced).toEqual([]);
290
- yield* test.advance(Duration.hours(1));
291
- expect(fixture.announced).toEqual(["deposited 3"]);
292
- const ledger = yield* Ledger.get("l1");
293
- yield* ledger.Deposit(1);
294
- expect((yield* test.inspect(ledger.ref)).state).toEqual({
295
- balance: 6,
296
- memo: "deposited 1",
297
- });
298
- }).pipe(Effect.provideService(FileSystem.FileSystem, files), Effect.provideContext(replay));
299
- })),
300
- },
301
- {
302
- name: "refuses a seed that is malformed, of another actor type, names an unregistered effect, marks created an actor without createdBy, or targets an existing actor, writing nothing",
303
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
304
- const replay = yield* replayRuntime(environment, User.make({ subject: "bob" }));
305
- const files = yield* seedFiles([
306
- ["wrong-format.seed", { ...literalSeed, format: 2 }],
307
- ["wrong-type.seed", { ...literalSeed, actor: { type: "ExpOther", id: "l1" } }],
308
- [
309
- "unregistered.seed",
310
- {
311
- ...literalSeed,
312
- jobs: [{ job: "ExpMissing", payload: null, payloadVersion: 0, dueInMs: 0 }],
313
- },
314
- ],
315
- ["created.seed", { ...literalSeed, created: true }],
316
- ["literal.seed", literalSeed],
317
- ["changed.seed", { ...literalSeed, state: { balance: 99, memo: "new" } }],
318
- ]);
319
- yield* Effect.gen(function* () {
320
- const test = yield* ActorTest;
321
- const attempt = (id, seed) => Effect.exit(test.actor(Ledger, id, { seed }));
322
- const inspectOf = (id) => Ledger.get(id).pipe(Effect.flatMap((ledger) => test.inspect(ledger.ref)));
323
- expect(died(yield* attempt("m1", "wrong-format.seed"), "Expected")).toBe(true);
324
- expect(died(yield* attempt("m2", "wrong-type.seed"), "not ExpLedger")).toBe(true);
325
- expect(died(yield* attempt("m3", "unregistered.seed"), "does not register")).toBe(true);
326
- expect(died(yield* attempt("m4", "created.seed"), "createdBy")).toBe(true);
327
- for (const id of ["m1", "m2", "m3", "m4"])
328
- expect((yield* inspectOf(id)).generation).toBe(undefined);
329
- expect(Exit.isSuccess(yield* attempt("l1", "literal.seed"))).toBe(true);
330
- expect(died(yield* attempt("l1", "changed.seed"), "already exists")).toBe(true);
331
- expect((yield* inspectOf("l1")).state).toEqual({ balance: 5, memo: "literal" });
332
- }).pipe(Effect.provideService(FileSystem.FileSystem, files), Effect.provideContext(replay));
333
- })),
334
- },
335
- {
336
- name: "seeds nothing when one row of the seed cannot be written",
337
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
338
- const replay = yield* replayRuntime(environment, User.make({ subject: "bob" }));
339
- const intent = {
340
- target: { actor: "ExpLedger", id: "l1" },
341
- command: "Audit",
342
- payload: null,
343
- key: "audit",
344
- dueInMs: 0,
345
- };
346
- const files = yield* seedFiles([
347
- ["clash.seed", { ...literalSeed, intents: [intent, intent] }],
348
- ]);
349
- yield* Effect.gen(function* () {
350
- const test = yield* ActorTest;
351
- const exit = yield* Effect.exit(test.actor(Ledger, "l1", { seed: "clash.seed" }));
352
- const ledger = yield* Ledger.get("l1");
353
- const sql = yield* SqlClient.SqlClient;
354
- expect(Exit.isFailure(exit)).toBe(true);
355
- expect(yield* test.inspect(ledger.ref)).toEqual({
356
- generation: undefined,
357
- state: {},
358
- receipts: 0,
359
- events: 0,
360
- outbox: 0,
361
- jobs: 0,
362
- });
363
- expect((yield* sql `SELECT count(*)::int AS count FROM actor_state`)[0]
364
- .count).toBe(0);
365
- }).pipe(Effect.provideService(FileSystem.FileSystem, files), Effect.provideContext(replay));
366
- })),
367
- },
368
- ];