@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,405 +0,0 @@
1
- import { Cause, Effect, Exit, Fiber, Layer, Option, Schema } from "effect";
2
- import { Actor } from "../../index.js";
3
- import { MAX_ENTRY_BYTES } from "../../runtime/turn/blobs.js";
4
- import { ActorTest } from "../actor-test.js";
5
- /** Blob names shared by two actor types, so only the scope keeps their entries apart. */
6
- export const files = Actor.blob("files");
7
- const undeclared = Actor.blob("undeclared");
8
- export const blobsFixture = () => ({ escaped: Effect.void });
9
- class DrawerRejected extends Schema.TaggedError()("DrawerRejected", {}) {
10
- }
11
- const Entry = Schema.Struct({ name: Schema.String, text: Schema.String });
12
- const Misuse = Schema.Literals([
13
- "undeclared",
14
- "emptyName",
15
- "loneSurrogate",
16
- "nul",
17
- "longName",
18
- "oversized",
19
- "notBytes",
20
- ]);
21
- const Store = Actor.command("Store", { payload: Entry });
22
- /** Appends a chunk and returns the entry as the turn itself reads it. */
23
- const Append = Actor.command("Append", { payload: Entry, success: Schema.String });
24
- /** Appends, compacts, and returns the entry as the turn reads it after compaction. */
25
- const AppendCompact = Actor.command("AppendCompact", { payload: Entry, success: Schema.String });
26
- const WriteThenReject = Actor.command("WriteThenReject", {
27
- payload: Schema.String,
28
- error: DrawerRejected,
29
- });
30
- const WriteThenMisuse = Actor.command("WriteThenMisuse", { payload: Misuse });
31
- /** Sets, appends, and sets again in one turn; the last set wins. */
32
- const Rewrite = Actor.command("Rewrite", { payload: Entry, success: Schema.String });
33
- const WriteForked = Actor.command("WriteForked");
34
- /** A timeout runs its effect on a child fiber, so it is a forked use too. */
35
- const WriteTimed = Actor.command("WriteTimed");
36
- /** Races a write against a sleep, so the guard's defect would be swallowed by the race. */
37
- const WriteRaced = Actor.command("WriteRaced");
38
- /** Appends `size` bytes to one growing entry. */
39
- const Grow = Actor.command("Grow", { payload: Schema.Int });
40
- const Large = Actor.command("Large", { payload: Schema.Int });
41
- const Capture = Actor.command("Capture");
42
- const Replay = Actor.command("Replay");
43
- const CaptureUnbound = Actor.command("CaptureUnbound");
44
- const Get = Actor.query("Get", { payload: Schema.String, success: Schema.Option(Schema.String) });
45
- const Size = Actor.query("Size", { payload: Schema.String, success: Schema.Int });
46
- const QueryWrite = Actor.query("QueryWrite");
47
- const CaptureRead = Actor.query("CaptureRead");
48
- const Drawer = Actor.make("Drawer", {
49
- key: Schema.String,
50
- state: Actor.state({
51
- notes: Schema.Int.pipe(Schema.withDecodingDefault(Effect.succeed(0))),
52
- }),
53
- blobs: [files],
54
- api: {
55
- Store,
56
- Append,
57
- AppendCompact,
58
- WriteThenReject,
59
- WriteThenMisuse,
60
- Rewrite,
61
- WriteForked,
62
- WriteTimed,
63
- WriteRaced,
64
- Grow,
65
- Large,
66
- Capture,
67
- Replay,
68
- CaptureUnbound,
69
- Get,
70
- Size,
71
- QueryWrite,
72
- CaptureRead,
73
- },
74
- policy: { maxStateBytes: 1_024 },
75
- });
76
- const Put = Actor.command("Put", { payload: Entry });
77
- const Peek = Actor.query("Peek", { payload: Schema.String, success: Schema.Option(Schema.String) });
78
- /** A second actor type declaring an equally named blob. */
79
- const Cabinet = Actor.make("Cabinet", { key: Schema.String, blobs: [files], api: { Put, Peek } });
80
- const encoder = new TextEncoder();
81
- const decoder = new TextDecoder();
82
- const bytes = (text) => encoder.encode(text);
83
- const text = (found) => Option.map(found, (value) => decoder.decode(value));
84
- const misuse = (loose, kind) => {
85
- switch (kind) {
86
- case "undeclared":
87
- return loose(undeclared).set("x", bytes("x"));
88
- case "emptyName":
89
- return loose(files).set("", bytes("x"));
90
- case "loneSurrogate":
91
- return loose(files).set("\uD800", bytes("x"));
92
- case "nul":
93
- return loose(files).set("a\u0000b", bytes("x"));
94
- case "longName":
95
- return loose(files).set("界".repeat(171), bytes("x"));
96
- case "oversized":
97
- return loose(files).set("x", new Uint8Array(MAX_ENTRY_BYTES + 1));
98
- case "notBytes":
99
- return loose(files).set("x", "not bytes");
100
- }
101
- };
102
- const DrawerLive = (fixture) => Drawer.toLayer(Effect.succeed({
103
- Store: Effect.fnUntraced(function* ({ name, text }) {
104
- yield* (yield* Drawer.Turn).blob(files).set(name, bytes(text));
105
- }),
106
- Append: Effect.fnUntraced(function* ({ name, text: chunk }) {
107
- const blob = (yield* Drawer.Turn).blob(files);
108
- yield* blob.append(name, bytes(chunk));
109
- return Option.getOrThrow(text(yield* blob.get(name)));
110
- }),
111
- AppendCompact: Effect.fnUntraced(function* ({ name, text: chunk }) {
112
- const blob = (yield* Drawer.Turn).blob(files);
113
- yield* blob.append(name, bytes(chunk));
114
- yield* blob.compact(name);
115
- return Option.getOrThrow(text(yield* blob.get(name)));
116
- }),
117
- WriteThenReject: Effect.fnUntraced(function* (name) {
118
- const turn = yield* Drawer.Turn;
119
- const blob = turn.blob(files);
120
- yield* blob.set("kept", bytes("overwritten"));
121
- yield* blob.append("kept", bytes("-appended"));
122
- yield* blob.compact("kept");
123
- yield* blob.delete("kept");
124
- yield* blob.set(name, bytes(name));
125
- yield* blob.append(name, bytes(name));
126
- yield* turn.state.set({ notes: turn.state.notes + 1 });
127
- return yield* DrawerRejected.make({});
128
- }),
129
- WriteThenMisuse: Effect.fnUntraced(function* (kind) {
130
- const turn = yield* Drawer.Turn;
131
- yield* turn.blob(files).set("before-misuse", bytes("before-misuse"));
132
- yield* misuse(turn.blob, kind);
133
- }),
134
- Rewrite: Effect.fnUntraced(function* ({ name, text: last }) {
135
- const blob = (yield* Drawer.Turn).blob(files);
136
- yield* blob.set(name, bytes("first"));
137
- yield* blob.append(name, bytes("-appended"));
138
- yield* blob.set(name, bytes(last));
139
- return Option.getOrThrow(text(yield* blob.get(name)));
140
- }),
141
- WriteForked: Effect.fnUntraced(function* () {
142
- const blob = (yield* Drawer.Turn).blob(files);
143
- yield* blob.set("owned", bytes("owned"));
144
- yield* Effect.forkChild(blob.set("forked", bytes("forked"))).pipe(Effect.flatMap(Fiber.join));
145
- }),
146
- WriteTimed: Effect.fnUntraced(function* () {
147
- yield* (yield* Drawer.Turn)
148
- .blob(files)
149
- .set("timed", bytes("timed"))
150
- .pipe(Effect.timeout("5 seconds"), Effect.orDie);
151
- }),
152
- WriteRaced: Effect.fnUntraced(function* () {
153
- const blob = (yield* Drawer.Turn).blob(files);
154
- yield* Effect.race(blob.set("raced", bytes("raced")), Effect.sleep("200 millis"));
155
- }),
156
- Grow: Effect.fnUntraced(function* (size) {
157
- yield* (yield* Drawer.Turn).blob(files).append("grow", new Uint8Array(size).fill(1));
158
- }),
159
- Large: Effect.fnUntraced(function* (size) {
160
- yield* (yield* Drawer.Turn).blob(files).set("large", new Uint8Array(size).fill(7));
161
- }),
162
- Capture: Effect.fnUntraced(function* () {
163
- const blob = (yield* Drawer.Turn).blob(files);
164
- fixture.escaped = blob.set("escaped", bytes("escaped"));
165
- yield* blob.set("captured", bytes("captured"));
166
- }),
167
- Replay: () => Effect.suspend(() => fixture.escaped).pipe(Effect.asVoid),
168
- CaptureUnbound: Effect.fnUntraced(function* () {
169
- const turn = yield* Drawer.Turn;
170
- fixture.escaped = Effect.suspend(() => turn.blob(files).set("unbound", bytes("unbound")));
171
- }),
172
- }));
173
- const DrawerReads = (fixture) => Drawer.toQueryLayer(Effect.succeed({
174
- Get: Effect.fnUntraced(function* (name) {
175
- return text(yield* (yield* Drawer.Read).blob(files).get(name));
176
- }),
177
- Size: Effect.fnUntraced(function* (name) {
178
- const found = yield* (yield* Drawer.Read).blob(files).get(name);
179
- return Option.match(found, { onNone: () => -1, onSome: (value) => value.byteLength });
180
- }),
181
- QueryWrite: Effect.fnUntraced(function* () {
182
- const blob = (yield* Drawer.Read).blob(files);
183
- const attempted = blob.set("from-query", bytes("from-query"));
184
- yield* attempted;
185
- }),
186
- CaptureRead: Effect.fnUntraced(function* () {
187
- fixture.escaped = (yield* Drawer.Read).blob(files).get("captured");
188
- }),
189
- }));
190
- const CabinetLive = Cabinet.toLayer(Effect.succeed({
191
- Put: Effect.fnUntraced(function* ({ name, text }) {
192
- yield* (yield* Cabinet.Turn).blob(files).set(name, bytes(text));
193
- }),
194
- }));
195
- const CabinetReads = Cabinet.toQueryLayer(Effect.succeed({
196
- Peek: Effect.fnUntraced(function* (name) {
197
- return text(yield* (yield* Cabinet.Read).blob(files).get(name));
198
- }),
199
- }));
200
- /** Handlers for the blob actors; `fixture` records handler runs so cases can tell a rerun from a replay. */
201
- export const blobsLayer = (fixture) => Layer.mergeAll(DrawerLive(fixture), DrawerReads(fixture), CabinetLive, CabinetReads);
202
- const defect = (exit) => Exit.isFailure(exit) ? Cause.pretty(exit.cause) : "succeeded";
203
- const blobsOf = (count) => ({ blobs: { files: count } });
204
- /** Actor blob cases: tenant and actor scoping, append/compact/set round trips, and rollback with a declared failure. */
205
- export const blobsConformance = [
206
- {
207
- name: "scopes blob entries by tenant, actor type, and actor for equal names",
208
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
209
- const test = yield* ActorTest;
210
- const home = yield* Drawer.get("shared-id");
211
- const neighbor = yield* Drawer.get("neighbor");
212
- const abroad = yield* Drawer.get("shared-id").pipe(Actor.tenant(`${test.tenant}-b`));
213
- const cabinet = yield* Cabinet.get("shared-id");
214
- const drawers = [home, neighbor, abroad];
215
- for (const [index, drawer] of drawers.entries())
216
- yield* drawer.Store({ name: "a", text: `a${index}` });
217
- yield* cabinet.Put({ name: "a", text: "cabinet" });
218
- for (const [index, drawer] of drawers.entries())
219
- expect(yield* drawer.Append({ name: "a", text: `+${index}` })).toBe(`a${index}+${index}`);
220
- yield* neighbor.Store({ name: "b", text: "b" });
221
- expect(yield* home.Get("a")).toEqual(Option.some("a0+0"));
222
- expect(yield* neighbor.Get("a")).toEqual(Option.some("a1+1"));
223
- expect(yield* abroad.Get("a")).toEqual(Option.some("a2+2"));
224
- expect(yield* cabinet.Peek("a")).toEqual(Option.some("cabinet"));
225
- expect(yield* home.Get("b")).toEqual(Option.none());
226
- expect(yield* test.inspect(home.ref)).toMatchObject(blobsOf(1));
227
- expect(yield* test.inspect(neighbor.ref)).toMatchObject(blobsOf(2));
228
- expect(yield* test.inspect(abroad.ref)).toMatchObject(blobsOf(1));
229
- expect(yield* test.inspect(cabinet.ref)).toMatchObject(blobsOf(1));
230
- })),
231
- },
232
- {
233
- name: "round-trips appended chunks through compact and replaces them with set",
234
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
235
- const test = yield* ActorTest;
236
- const drawer = yield* Drawer.get("chunks");
237
- for (const chunk of ["one", "-two", "-three"])
238
- yield* drawer.Append({ name: "log", text: chunk });
239
- expect(yield* drawer.Get("log")).toEqual(Option.some("one-two-three"));
240
- expect(yield* drawer.AppendCompact({ name: "log", text: "-four" })).toBe("one-two-three-four");
241
- expect(yield* drawer.Get("log")).toEqual(Option.some("one-two-three-four"));
242
- expect(yield* drawer.Append({ name: "log", text: "-five" })).toBe("one-two-three-four-five");
243
- yield* drawer.Store({ name: "log", text: "reset" });
244
- expect(yield* drawer.Get("log")).toEqual(Option.some("reset"));
245
- expect(yield* drawer.Append({ name: "log", text: "!" })).toBe("reset!");
246
- yield* drawer.Store({ name: "empty", text: "" });
247
- expect(yield* drawer.Get("empty")).toEqual(Option.some(""));
248
- expect(yield* drawer.Rewrite({ name: "twice", text: "second" })).toBe("second");
249
- expect(yield* drawer.Get("twice")).toEqual(Option.some("second"));
250
- expect(yield* test.inspect(drawer.ref)).toMatchObject({ ...blobsOf(3), receipts: 9 });
251
- })),
252
- },
253
- {
254
- name: "rolls back every blob write with a declared failure and keeps its receipt",
255
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
256
- const test = yield* ActorTest;
257
- const drawer = yield* Drawer.get("rejected");
258
- yield* drawer.Store({ name: "kept", text: "kept" });
259
- const rejected = drawer.WriteThenReject("dropped");
260
- expect(yield* rejected.pipe(Effect.flip)).toEqual(DrawerRejected.make({}));
261
- expect(yield* rejected.pipe(Effect.flip)).toEqual(DrawerRejected.make({}));
262
- expect(yield* drawer.Get("kept")).toEqual(Option.some("kept"));
263
- expect(yield* drawer.Get("dropped")).toEqual(Option.none());
264
- expect(yield* test.inspect(drawer.ref)).toMatchObject({
265
- ...blobsOf(1),
266
- state: {},
267
- receipts: 2,
268
- });
269
- })),
270
- },
271
- {
272
- name: "discards blob writes of a declared failure across a crash before and after its commit",
273
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
274
- const test = yield* ActorTest;
275
- for (const point of ["beforeCommit", "afterCommit"]) {
276
- const drawer = yield* Drawer.get(`rejected-${point}`);
277
- yield* drawer.Store({ name: "kept", text: "kept" });
278
- yield* test.crashNext(point);
279
- const rejected = drawer.WriteThenReject("dropped");
280
- expect(yield* rejected.pipe(Effect.flip)).toEqual(DrawerRejected.make({}));
281
- expect(yield* rejected.pipe(Effect.flip)).toEqual(DrawerRejected.make({}));
282
- expect(yield* drawer.Get("kept")).toEqual(Option.some("kept"));
283
- expect(yield* drawer.Get("dropped")).toEqual(Option.none());
284
- expect(yield* test.inspect(drawer.ref)).toMatchObject({
285
- ...blobsOf(1),
286
- state: {},
287
- receipts: 2,
288
- });
289
- }
290
- })),
291
- },
292
- {
293
- name: "retries a blob append that crashes before commit to exactly one chunk",
294
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
295
- const test = yield* ActorTest;
296
- const drawer = yield* Drawer.get("crash-before");
297
- yield* drawer.Store({ name: "log", text: "head" });
298
- yield* test.crashNext("beforeCommit");
299
- expect(yield* drawer.Append({ name: "log", text: "+once" })).toBe("head+once");
300
- expect(yield* drawer.Get("log")).toEqual(Option.some("head+once"));
301
- expect(yield* test.inspect(drawer.ref)).toMatchObject({ ...blobsOf(1), receipts: 2 });
302
- })),
303
- },
304
- {
305
- name: "replays a blob append committed before a crash without appending again",
306
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
307
- const test = yield* ActorTest;
308
- const drawer = yield* Drawer.get("crash-after");
309
- yield* drawer.Store({ name: "log", text: "head" });
310
- yield* test.crashNext("afterCommit");
311
- expect(yield* drawer.Append({ name: "log", text: "+once" })).toBe("head+once");
312
- expect(yield* drawer.Get("log")).toEqual(Option.some("head+once"));
313
- expect(yield* test.inspect(drawer.ref)).toMatchObject({ ...blobsOf(1), receipts: 2 });
314
- })),
315
- },
316
- {
317
- name: "exempts blob bytes from maxStateBytes",
318
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
319
- const test = yield* ActorTest;
320
- const drawer = yield* Drawer.get("large");
321
- yield* drawer.Large(256 * 1_024);
322
- expect(yield* drawer.Size("large")).toBe(256 * 1_024);
323
- expect(yield* test.inspect(drawer.ref)).toMatchObject({ ...blobsOf(1), receipts: 1 });
324
- })),
325
- },
326
- {
327
- name: "caps an entry at MAX_ENTRY_BYTES across appends as a defect without a receipt",
328
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
329
- const test = yield* ActorTest;
330
- const drawer = yield* Drawer.get("capped");
331
- const half = MAX_ENTRY_BYTES / 2;
332
- yield* drawer.Grow(half);
333
- yield* drawer.Grow(half);
334
- expect(defect(yield* drawer.Grow(1).pipe(Effect.exit))).toContain(`A blob entry holds at most ${MAX_ENTRY_BYTES} bytes`);
335
- expect(yield* drawer.Size("grow")).toBe(MAX_ENTRY_BYTES);
336
- expect(yield* test.inspect(drawer.ref)).toMatchObject({ ...blobsOf(1), receipts: 2 });
337
- })),
338
- },
339
- {
340
- name: "rejects undeclared blobs and malformed entries as defects without a receipt",
341
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
342
- const test = yield* ActorTest;
343
- const drawer = yield* Drawer.get("misuse");
344
- for (const [kind, message] of [
345
- ["undeclared", "undeclared is not a declared blob of Drawer"],
346
- ["emptyName", "Blob entry names"],
347
- ["loneSurrogate", "Blob entry names"],
348
- ["nul", "Blob entry names"],
349
- ["longName", "Blob entry names"],
350
- ["oversized", `A blob entry holds at most ${MAX_ENTRY_BYTES} bytes`],
351
- ["notBytes", "Blob bytes are a Uint8Array"],
352
- ])
353
- expect(defect(yield* drawer.WriteThenMisuse(kind).pipe(Effect.exit))).toContain(message);
354
- expect(yield* test.inspect(drawer.ref)).toMatchObject({ ...blobsOf(0), receipts: 0 });
355
- })),
356
- },
357
- {
358
- name: "gives queries read-only blobs and rejects escaped blob capabilities",
359
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
360
- const test = yield* ActorTest;
361
- const drawer = yield* Drawer.get("escape");
362
- expect(defect(yield* drawer.QueryWrite().pipe(Effect.exit))).toContain("set");
363
- yield* drawer.Capture();
364
- expect(defect(yield* fixture.escaped.pipe(Effect.exit))).toContain("Blob capability escaped its turn");
365
- expect(defect(yield* drawer.Replay().pipe(Effect.exit))).toContain("Blob capability escaped its turn");
366
- yield* drawer.CaptureUnbound();
367
- expect(defect(yield* fixture.escaped.pipe(Effect.exit))).toContain("Blob capability escaped its turn");
368
- expect(defect(yield* drawer.Replay().pipe(Effect.exit))).toContain("Blob capability escaped its turn");
369
- expect(yield* drawer.Get("unbound")).toEqual(Option.none());
370
- expect(yield* drawer.Get("captured")).toEqual(Option.some("captured"));
371
- expect(yield* drawer.Get("escaped")).toEqual(Option.none());
372
- expect(yield* drawer.Get("from-query")).toEqual(Option.none());
373
- yield* drawer.CaptureRead();
374
- expect(defect(yield* fixture.escaped.pipe(Effect.exit))).toContain("Blob capability escaped its query");
375
- for (const forked of [drawer.WriteForked(), drawer.WriteTimed(), drawer.WriteRaced()])
376
- expect(defect(yield* forked.pipe(Effect.exit))).toContain("Blob capability used from a fiber other than its turn's");
377
- expect(yield* drawer.Get("owned")).toEqual(Option.none());
378
- expect(yield* drawer.Get("forked")).toEqual(Option.none());
379
- expect(yield* drawer.Get("timed")).toEqual(Option.none());
380
- expect(yield* drawer.Get("raced")).toEqual(Option.none());
381
- expect(yield* test.inspect(drawer.ref)).toMatchObject({ ...blobsOf(1), receipts: 2 });
382
- })),
383
- },
384
- {
385
- name: "keeps uncommitted blob writes invisible to a query",
386
- requiresIndependentConnections: true,
387
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
388
- const test = yield* ActorTest;
389
- const drawer = yield* Drawer.get("invisible");
390
- yield* drawer.Store({ name: "log", text: "head" });
391
- const pause = yield* test.pauseNext("beforeCommit");
392
- const writer = yield* drawer.Append({ name: "log", text: "+tail" }).pipe(Effect.forkChild);
393
- yield* pause.reached;
394
- expect(yield* drawer.Get("log")).toEqual(Option.some("head"));
395
- yield* pause.release;
396
- expect(yield* Fiber.join(writer)).toBe("head+tail");
397
- expect(yield* drawer.Get("log")).toEqual(Option.some("head+tail"));
398
- })),
399
- },
400
- ];
401
- /** The actor blob actors. */
402
- export const blobsSuite = {
403
- fixture: blobsFixture,
404
- layer: blobsLayer,
405
- };
@@ -1,8 +0,0 @@
1
- import type { ConformanceCase } from "../conformance.ts";
2
- /**
3
- * Capacity cases: a caller over capacity gets `RunnerAtCapacity` after
4
- * `deliveryTimeout`, a resident bounded actor with a full mailbox reports
5
- * `MailboxFull`, and a full runner or default-bounded activation refuses at
6
- * once with `ActorUnavailable`.
7
- */
8
- export declare const capacityConformance: ReadonlyArray<ConformanceCase>;