@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,384 +0,0 @@
1
- import { Effect, Layer, Option, Predicate } from "effect";
2
- import { User } from "../../../index.js";
3
- import { InternalActors } from "../../../runtime/actors.js";
4
- import { SUBPROTOCOL } from "../../../protocol/frames.js";
5
- import { ActorTest } from "../../actor-test.js";
6
- import { ActorCluster } from "../../cluster.js";
7
- import { Banned, ForgedResync, Hello, Said, SocketRoom, transportsLayer } from "./actors.js";
8
- import { decodeBanned, encodeForged, endReason, frameOf, headerSocket, opened, say, serveSockets, socket, upgradeStatus, } from "./wire.js";
9
- import { greet, rows, setup } from "./harness.js";
10
- /** WebSocket handshake, framing, limits, reauthentication, parking, and resync. */
11
- export const transportWebSocketConformance = [
12
- {
13
- name: "finishes durable WebSocket close even when its outbound reader ends while deletion waits on a database lock",
14
- requiresIndependentConnections: true,
15
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
16
- const { host, token } = yield* setup(environment);
17
- const room = yield* SocketRoom.get("ws-blocked-close");
18
- const ws = yield* socket(host, "ws-blocked-close");
19
- yield* ws.send({ t: "hello", authorization: token(), params: { name: "alice" } });
20
- yield* opened(yield* ws.next());
21
- yield* ws.next();
22
- expect((yield* rows(room.ref)).connections).toBe(1);
23
- if (environment.connect === undefined)
24
- return yield* Effect.die(new Error("This case needs an independent database connection"));
25
- const blocker = yield* environment.connect;
26
- yield* blocker.query("BEGIN");
27
- yield* blocker.query("SELECT connection_id FROM actor_connections WHERE tenant_id = $1 AND actor_type = $2 AND actor_id = $3 FOR UPDATE", [room.ref.tenant, room.ref.actor, room.ref.id]);
28
- yield* ws.close;
29
- yield* Effect.gen(function* () {
30
- while (true) {
31
- const blocked = yield* blocker.query("SELECT pid FROM pg_stat_activity WHERE datname = current_database() AND wait_event_type = 'Lock' AND query ILIKE '%actor_connections%'");
32
- if (blocked.length > 0)
33
- return;
34
- yield* Effect.sleep("20 millis");
35
- }
36
- }).pipe(Effect.timeout("3 seconds"), Effect.orDie);
37
- yield* blocker.query("COMMIT");
38
- expect((yield* ws.closed).code).toBe(1000);
39
- yield* Effect.gen(function* () {
40
- while ((yield* rows(room.ref)).connections > 0)
41
- yield* Effect.sleep("20 millis");
42
- }).pipe(Effect.timeout("10 seconds"), Effect.orDie);
43
- expect((yield* rows(room.ref)).connections).toBe(0);
44
- })),
45
- },
46
- {
47
- name: "serves a connection over WebSocket: hello, open at its baseline, then member frames both ways with event cursors",
48
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
49
- const { host, token } = yield* setup(environment);
50
- const room = yield* SocketRoom.get("ws-open");
51
- yield* room.Post("before");
52
- const ws = yield* socket(host, "ws-open");
53
- yield* ws.send({ t: "hello", authorization: token(), params: { name: "alice" } });
54
- const open = yield* opened(yield* ws.next());
55
- expect(open.baseline).toBe("1");
56
- expect(open.reauthenticateBy).toBe(undefined);
57
- const greeting = yield* ws.next();
58
- expect(yield* frameOf(greeting)).toEqual(Hello.make({ name: "alice", resumed: false }));
59
- expect(greeting).toMatchObject({ cursor: "1" });
60
- yield* ws.send(yield* say("hi"));
61
- const hi = yield* ws.next();
62
- expect(yield* frameOf(hi)).toEqual(Said.make({ text: "hi" }));
63
- expect(hi).toMatchObject({ cursor: "1" });
64
- expect(Predicate.hasProperty(hi, "event")).toBe(false);
65
- yield* room.Post("live");
66
- const live = yield* ws.next();
67
- expect(yield* frameOf(live)).toEqual(Said.make({ text: "live" }));
68
- expect(live).toMatchObject({ cursor: "2" });
69
- yield* ws.send(yield* say("history"));
70
- const history = [yield* ws.next(), yield* ws.next(), yield* ws.next()];
71
- expect(history.map((message) => (message.t === "frame" ? message.event : undefined))).toEqual(["1", "2", "3"]);
72
- expect((yield* rows(room.ref)).connections).toBe(1);
73
- yield* ws.close;
74
- expect((yield* ws.closed).code).toBe(1000);
75
- yield* Effect.gen(function* () {
76
- while ((yield* rows(room.ref)).connections > 0)
77
- yield* Effect.sleep("20 millis");
78
- }).pipe(Effect.timeout("10 seconds"), Effect.orDie);
79
- })),
80
- },
81
- {
82
- name: "wakes nothing before hello authenticates, and ends with InvalidInput when hello does not arrive in 10 seconds",
83
- timeoutMs: 40_000,
84
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
85
- const { host } = yield* setup(environment);
86
- const ref = (yield* SocketRoom.get("ws-silent")).ref;
87
- const ws = yield* socket(host, "ws-silent");
88
- yield* Effect.sleep("500 millis");
89
- expect(yield* rows(ref)).toEqual({ connections: 0, generations: 0 });
90
- const early = yield* socket(host, "ws-silent");
91
- yield* early.send(yield* say("hi"));
92
- expect(yield* endReason(yield* early.next())).toMatchObject({
93
- tag: "InvalidInput",
94
- code: "decode",
95
- });
96
- expect((yield* early.closed).code).toBe(4400);
97
- expect(yield* endReason((yield* ws.until("end", 15_000)).at(-1))).toMatchObject({
98
- tag: "InvalidInput",
99
- code: "decode",
100
- });
101
- expect((yield* ws.closed).code).toBe(4400);
102
- expect(yield* rows(ref)).toEqual({ connections: 0, generations: 0 });
103
- })),
104
- },
105
- {
106
- name: "refuses upgrades from origins not listed, without the subprotocol, and past 1,000 sockets awaiting hello",
107
- timeoutMs: 60_000,
108
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
109
- const { host } = yield* setup(environment, { origins: ["https://chat.example.com"] });
110
- const protocol = { "Sec-WebSocket-Protocol": SUBPROTOCOL };
111
- expect(yield* upgradeStatus(host, "ws-refused", {
112
- ...protocol,
113
- Origin: "https://evil.example",
114
- })).toBe(403);
115
- expect(yield* upgradeStatus(host, "ws-refused", {
116
- ...protocol,
117
- Origin: "https://chat.example.com",
118
- })).toBe(101);
119
- expect(yield* upgradeStatus(host, "ws-refused", {})).toBe(400);
120
- expect(yield* upgradeStatus(host, "ws-refused", {
121
- "Sec-WebSocket-Protocol": `chat, ${SUBPROTOCOL}`,
122
- })).toBe(400);
123
- expect(yield* upgradeStatus(host, "ws-refused", { ...protocol, Authorization: "Bearer nope" })).toBe(401);
124
- const silent = yield* Effect.forEach(Array.from({ length: 1_000 }, (_, index) => index), () => socket(host, "ws-crowd"), { concurrency: 50 });
125
- expect(silent.length).toBe(1_000);
126
- expect(yield* upgradeStatus(host, "ws-crowd", protocol)).toBe(503);
127
- yield* Effect.forEach(silent, (ws) => ws.close, { discard: true });
128
- yield* Effect.gen(function* () {
129
- while ((yield* upgradeStatus(host, "ws-crowd", protocol)) !== 101)
130
- yield* Effect.sleep("50 millis");
131
- }).pipe(Effect.timeout("10 seconds"), Effect.orDie);
132
- })),
133
- },
134
- {
135
- name: "authenticates hello or the upgrade, and ends a session whose upgrade and hello credentials name different callers",
136
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
137
- const { host, token } = yield* setup(environment);
138
- const missing = yield* socket(host, "ws-auth");
139
- yield* missing.send({ t: "hello", params: { name: "alice" } });
140
- expect(yield* endReason(yield* missing.next())).toMatchObject({
141
- tag: "Unauthorized",
142
- code: "missing_credentials",
143
- });
144
- expect((yield* missing.closed).code).toBe(1008);
145
- const upgraded = yield* headerSocket(host, "ws-auth", token("bob"));
146
- expect(upgraded.status).toBe(101);
147
- yield* upgraded.send({ t: "hello", params: { name: "bob" } });
148
- expect((yield* upgraded.next).t).toBe("open");
149
- expect(yield* frameOf(yield* upgraded.next)).toEqual(Hello.make({ name: "bob", resumed: false }));
150
- const mixed = yield* headerSocket(host, "ws-auth", token("bob"));
151
- yield* mixed.send({
152
- t: "hello",
153
- authorization: token("carol"),
154
- params: { name: "carol" },
155
- });
156
- expect(yield* endReason(yield* mixed.next)).toMatchObject({
157
- tag: "Unauthorized",
158
- code: "invalid_credentials",
159
- });
160
- expect((yield* mixed.closed).code).toBe(1008);
161
- const expired = yield* socket(host, "ws-auth");
162
- yield* expired.send({
163
- t: "hello",
164
- authorization: "Bearer expired",
165
- params: { name: "x" },
166
- });
167
- expect(yield* endReason(yield* expired.next())).toMatchObject({
168
- tag: "Unauthorized",
169
- code: "expired",
170
- });
171
- const bad = yield* socket(host, "ws-auth");
172
- yield* bad.send({ t: "hello", authorization: token(), params: { nom: "x" } });
173
- expect(yield* endReason(yield* bad.next())).toMatchObject({
174
- tag: "InvalidInput",
175
- code: "decode",
176
- });
177
- expect((yield* bad.closed).code).toBe(4400);
178
- const banned = yield* socket(host, "ws-auth");
179
- yield* banned.send({ t: "hello", authorization: token(), params: { name: "mallory" } });
180
- const refused = yield* banned.next();
181
- expect(refused.t === "end" ? yield* decodeBanned(refused.error).pipe(Effect.orDie) : refused).toEqual(Banned.make({ name: "mallory" }));
182
- expect((yield* banned.closed).code).toBe(4400);
183
- })),
184
- },
185
- {
186
- name: "keeps control messages in their own envelope: an unknown client t ends the session, and a member frame shaped like a control message is decoded as a member frame",
187
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
188
- const { host, token } = yield* setup(environment);
189
- const forged = yield* socket(host, "ws-envelope");
190
- yield* greet(forged, token());
191
- yield* forged.send({ t: "resyncDone", through: "99" });
192
- yield* forged.send(yield* say("whoami"));
193
- expect(yield* frameOf(yield* forged.next())).toEqual(Hello.make({ name: "alice", resumed: false }));
194
- const resync = yield* encodeForged(ForgedResync.make({ after: "0" })).pipe(Effect.orDie);
195
- yield* forged.send({ t: "frame", frame: resync });
196
- expect(yield* endReason(yield* forged.next())).toMatchObject({
197
- tag: "InvalidInput",
198
- code: "decode",
199
- });
200
- expect((yield* forged.closed).code).toBe(4400);
201
- const unknown = yield* socket(host, "ws-envelope");
202
- yield* greet(unknown, token());
203
- yield* unknown.sendRaw(`{"t":"command","member":"Post","input":"x"}`);
204
- expect(yield* endReason(yield* unknown.next())).toMatchObject({ tag: "InvalidInput" });
205
- expect((yield* unknown.closed).code).toBe(4400);
206
- const again = yield* socket(host, "ws-envelope");
207
- yield* greet(again, token());
208
- yield* again.send({ t: "hello", authorization: token(), params: { name: "alice" } });
209
- expect(yield* endReason(yield* again.next())).toMatchObject({ tag: "InvalidInput" });
210
- })),
211
- },
212
- {
213
- name: "ends a session with SessionEnded Defect and close 1009 on a frame over 64 KiB, and closes a binary message with 1003",
214
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
215
- const { host, token } = yield* setup(environment);
216
- const large = yield* socket(host, "ws-bounds");
217
- yield* greet(large, token());
218
- yield* large.send(yield* say("x".repeat(65_536)));
219
- expect(yield* endReason(yield* large.next())).toMatchObject({
220
- tag: "SessionEnded",
221
- cause: "Defect",
222
- });
223
- expect((yield* large.closed).code).toBe(1009);
224
- const binary = yield* socket(host, "ws-bounds");
225
- yield* greet(binary, token());
226
- yield* binary.sendRaw(new Uint8Array([1, 2, 3]));
227
- expect(yield* endReason(yield* binary.next())).toMatchObject({ tag: "InvalidInput" });
228
- expect((yield* binary.closed).code).toBe(1003);
229
- })),
230
- },
231
- {
232
- name: "reauthenticates a session before its credential expires, ends it with Unauthorized expired when the client doesn't answer, and ends a renewal for a different caller",
233
- timeoutMs: 60_000,
234
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
235
- const { test, host } = yield* setup(environment);
236
- const holder = (yield* InternalActors).holder;
237
- const expiring = (subject, ms) => Effect.map(holder.now, (now) => `Bearer ${test.tenant}:${subject}:${now + ms}`);
238
- const renewing = yield* socket(host, "ws-renew");
239
- const open = yield* greet(renewing, yield* expiring("alice", 3_000));
240
- expect(open.reauthenticateBy === undefined).toBe(false);
241
- expect((yield* renewing.until("reauthenticate", 5_000)).at(-1)).toMatchObject({
242
- by: open.reauthenticateBy,
243
- });
244
- const fresh = (yield* holder.now) + 120_000;
245
- yield* renewing.send({
246
- t: "reauthenticate",
247
- authorization: `Bearer ${test.tenant}:alice:${fresh}`,
248
- });
249
- expect(yield* renewing.next()).toEqual({ t: "reauthenticated", by: fresh });
250
- yield* Effect.sleep("2 seconds");
251
- yield* renewing.send(yield* say("whoami"));
252
- expect(yield* frameOf(yield* renewing.next())).toEqual(Hello.make({ name: "alice", resumed: false }));
253
- const silent = yield* socket(host, "ws-renew");
254
- yield* greet(silent, yield* expiring("alice", 2_000));
255
- expect(yield* endReason((yield* silent.until("end", 10_000)).at(-1))).toMatchObject({
256
- tag: "Unauthorized",
257
- code: "expired",
258
- });
259
- expect((yield* silent.closed).code).toBe(1008);
260
- const swapped = yield* socket(host, "ws-renew");
261
- yield* greet(swapped, yield* expiring("alice", 60_000));
262
- yield* swapped.send({
263
- t: "reauthenticate",
264
- authorization: `Bearer ${test.tenant}:mallory`,
265
- });
266
- expect(yield* endReason((yield* swapped.until("end")).at(-1))).toMatchObject({
267
- tag: "Unauthorized",
268
- code: "invalid_credentials",
269
- });
270
- })),
271
- },
272
- {
273
- name: "revokes a live and a parked WebSocket session within reauthorizeEvery",
274
- timeoutMs: 40_000,
275
- run: ({ expect, environment, access }) => environment.run(Effect.gen(function* () {
276
- const { test, host, token } = yield* setup(environment);
277
- const room = yield* SocketRoom.get("ws-revoke");
278
- const live = yield* socket(host, "ws-revoke");
279
- yield* greet(live, token());
280
- const parked = yield* socket(host, "ws-revoke");
281
- yield* greet(parked, token("bob"), "bob");
282
- yield* test.hibernate(room.ref);
283
- access.denied.add("Chat");
284
- yield* Effect.gen(function* () {
285
- for (const ws of [live, parked]) {
286
- expect(yield* endReason((yield* ws.until("end", 10_000)).at(-1))).toMatchObject({
287
- tag: "Unauthorized",
288
- code: "access_denied",
289
- });
290
- expect((yield* ws.closed).code).toBe(1008);
291
- }
292
- }).pipe(Effect.ensuring(Effect.sync(() => access.denied.delete("Chat"))));
293
- })),
294
- },
295
- {
296
- name: "keeps a parked connection parked over a real socket, and a frame wakes its actor with the session restored",
297
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
298
- const { test, host, token } = yield* setup(environment);
299
- const room = yield* SocketRoom.get("ws-parked");
300
- const ws = yield* socket(host, "ws-parked");
301
- yield* greet(ws, token());
302
- yield* test.hibernate(room.ref);
303
- expect(yield* ws.poll(500)).toEqual(Option.none());
304
- yield* ws.send(yield* say("whoami"));
305
- expect(yield* frameOf(yield* ws.next())).toEqual(Hello.make({ name: "alice", resumed: true }));
306
- yield* test.hibernate(room.ref);
307
- yield* room.Post("wake");
308
- expect(yield* frameOf(yield* ws.next())).toEqual(Said.make({ text: "wake" }));
309
- })),
310
- },
311
- {
312
- name: "carries event cursors on frames, and omits every cursor under stampCursor: false",
313
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
314
- const { host, token } = yield* setup(environment);
315
- const room = yield* SocketRoom.get("ws-blind");
316
- yield* room.Post("first");
317
- const blind = yield* socket(host, "ws-blind", { member: "Blind" });
318
- yield* blind.send({ t: "hello", authorization: token() });
319
- const open = yield* opened(yield* blind.next());
320
- expect(open.baseline).toBe(undefined);
321
- const chat = yield* socket(host, "ws-blind");
322
- expect((yield* greet(chat, token())).baseline).toBe("1");
323
- yield* room.Post("second");
324
- const stamped = yield* chat.next();
325
- const bare = yield* blind.next();
326
- expect(yield* frameOf(stamped)).toEqual(Said.make({ text: "second" }));
327
- expect(stamped).toMatchObject({ cursor: "1" });
328
- expect(yield* frameOf(bare)).toEqual(Said.make({ text: "second" }));
329
- expect(Object.keys(bare).sort()).toEqual(["frame", "t"]);
330
- })),
331
- },
332
- {
333
- name: "resyncs a WebSocket in place after its owner dies, and holds live frames until resyncDone",
334
- requiresFreshDatabase: true,
335
- requiresIndependentConnections: true,
336
- timeoutMs: 120_000,
337
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
338
- const database = yield* environment.freshDatabase;
339
- const context = yield* Layer.build(ActorTest.cluster({
340
- database,
341
- runners: 2,
342
- shardLockExpiration: "3 seconds",
343
- actors: transportsLayer,
344
- as: User.make({ subject: "alice" }),
345
- authorize: () => Effect.succeed(true),
346
- }));
347
- yield* Effect.gen(function* () {
348
- const cluster = yield* ActorCluster;
349
- yield* cluster.ready;
350
- let target;
351
- for (let index = 0; target === undefined && index < 200; index++) {
352
- const candidate = (yield* cluster.on(0)(SocketRoom.get(`ws-crash-${index}`))).ref;
353
- if ((yield* cluster.owner(candidate)) === 1)
354
- target = candidate;
355
- }
356
- if (target === undefined)
357
- return yield* Effect.die(new Error("Runner 1 owns no probed actor"));
358
- const ref = target;
359
- const post = (text) => cluster.on(0)(SocketRoom.get(ref.id).pipe(Effect.flatMap((room) => room.Post(text))));
360
- const host = yield* cluster.on(0)(serveSockets(environment));
361
- const ws = yield* socket(host, ref.id);
362
- yield* greet(ws, `Bearer ${ref.tenant}:alice`);
363
- yield* post("before");
364
- expect(yield* frameOf(yield* ws.next())).toEqual(Said.make({ text: "before" }));
365
- yield* cluster.kill(1);
366
- expect(yield* ws.next(60_000)).toEqual({
367
- t: "resync",
368
- after: "1",
369
- reason: "OwnerLost",
370
- deadline: 30_000,
371
- });
372
- const replay = yield* ws.until("resyncReplayed", 60_000);
373
- expect(replay.at(-1)).toEqual({ t: "resyncReplayed" });
374
- expect(replay.filter((message) => message.t === "frame")).toEqual([]);
375
- yield* post("during");
376
- expect(yield* ws.poll(1_000)).toEqual(Option.none());
377
- yield* ws.send({ t: "resyncDone", through: "1" });
378
- expect(yield* frameOf(yield* ws.next())).toEqual(Said.make({ text: "during" }));
379
- yield* ws.send(yield* say("whoami"));
380
- expect(yield* frameOf(yield* ws.next())).toEqual(Hello.make({ name: "alice", resumed: true }));
381
- }).pipe(Effect.provideContext(context));
382
- })),
383
- },
384
- ];
@@ -1,141 +0,0 @@
1
- import { Effect, Option, Schema, type Scope } from "effect";
2
- import { HttpClient } from "effect/http";
3
- import { ActorError } from "../../../errors/actor.ts";
4
- import { RetentionGap, UnknownCursor } from "../../../errors/events.ts";
5
- import { InternalActors } from "../../../runtime/actors.ts";
6
- import type { RuntimeControl } from "../../../runtime/drain.ts";
7
- import { ClientWireMessage, ServerWireMessage } from "../../../protocol/frames.ts";
8
- import { type ServeOptions } from "../../../serve/layer.ts";
9
- import type { ConformanceEnvironment } from "../../conformance.ts";
10
- import { Banned, Refused } from "./actors.ts";
11
- /**
12
- * Serves `SocketRoom` and `FeedRoom` from a fresh listening server for the
13
- * rest of the scope; returns its host. A provider may fetch over HTTP.
14
- */
15
- export declare const serveSockets: (environment: ConformanceEnvironment, options?: Partial<ServeOptions<HttpClient.HttpClient>> | undefined) => Effect.Effect<string, never, InternalActors | RuntimeControl | Scope.Scope>;
16
- export declare const encodeClient: (input: {
17
- readonly t: "hello";
18
- readonly authorization?: string | undefined;
19
- readonly params?: Schema.Json | undefined;
20
- } | {
21
- readonly t: "frame";
22
- readonly frame: Schema.Json;
23
- } | {
24
- readonly t: "resyncDone";
25
- readonly through?: string | undefined;
26
- } | {
27
- readonly t: "reauthenticate";
28
- readonly authorization: string;
29
- }, options?: import("effect/SchemaAST").ParseOptions) => Effect.Effect<string, Schema.SchemaError, never>;
30
- export declare const encodeForged: (input: {
31
- readonly _tag: "Resync";
32
- readonly after: string;
33
- }, options?: import("effect/SchemaAST").ParseOptions) => Effect.Effect<Schema.Json, Schema.SchemaError, never>;
34
- export declare const decodeBanned: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => Effect.Effect<Banned, Schema.SchemaError, never>;
35
- export declare const decodeReason: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => Effect.Effect<{
36
- readonly reason: {
37
- readonly _tag: string;
38
- readonly code?: string | undefined;
39
- readonly cause?: string | undefined;
40
- };
41
- }, Schema.SchemaError, never>;
42
- /** What a Promise client call or iteration rejected with, typed; anything else is a test defect. */
43
- export declare const asFailure: (input: unknown, options?: import("effect/SchemaAST").ParseOptions | undefined) => ActorError | Banned | Refused | RetentionGap | UnknownCursor;
44
- /** A client frame saying `text`, as the socket carries it. */
45
- export declare const say: (text: string) => Effect.Effect<{
46
- readonly t: "hello";
47
- readonly authorization?: string | undefined;
48
- readonly params?: Schema.Json | undefined;
49
- } | {
50
- readonly t: "frame";
51
- readonly frame: Schema.Json;
52
- } | {
53
- readonly t: "resyncDone";
54
- readonly through?: string | undefined;
55
- } | {
56
- readonly t: "reauthenticate";
57
- readonly authorization: string;
58
- }, never, never>;
59
- /** The member frame a server message carries, decoded with the member's schema. */
60
- export declare const frameOf: (message: ServerWireMessage | undefined) => Effect.Effect<import("./actors.ts").Hello | {
61
- readonly _tag: "Said";
62
- readonly text: string;
63
- }, never, never>;
64
- /** The reason an `end` message's `ActorError` carries, without its `_tag` key. */
65
- export declare const endReason: (message: ServerWireMessage | undefined) => Effect.Effect<{
66
- tag: string;
67
- code: string | undefined;
68
- cause: string | undefined;
69
- }, never, never>;
70
- export declare const opened: (message: ServerWireMessage | undefined) => Effect.Effect<{
71
- readonly t: "open";
72
- readonly connectionId: string;
73
- readonly baseline?: string | undefined;
74
- readonly reauthenticateBy?: number | undefined;
75
- }, never, never>;
76
- export interface WireSocket {
77
- readonly send: (message: ClientWireMessage) => Effect.Effect<void>;
78
- readonly sendRaw: (data: string | Uint8Array<ArrayBuffer>) => Effect.Effect<void>;
79
- /** The next server message, failing the test if none arrives within `timeout`. */
80
- readonly next: (timeout?: number) => Effect.Effect<ServerWireMessage>;
81
- /** The next server message within `timeout`, if one arrives. */
82
- readonly poll: (timeout: number) => Effect.Effect<Option.Option<ServerWireMessage>>;
83
- /** Messages up to and including the first whose `t` is `t`. */
84
- readonly until: (t: ServerWireMessage["t"], timeout?: number) => Effect.Effect<ReadonlyArray<ServerWireMessage>>;
85
- readonly closed: Effect.Effect<{
86
- readonly code: number;
87
- }>;
88
- readonly close: Effect.Effect<void>;
89
- }
90
- /** A client socket to a connection route, closed with the scope. */
91
- export declare const socket: (host: string, id: string, options?: {
92
- readonly member?: string;
93
- } | undefined) => Effect.Effect<WireSocket, never, Scope.Scope>;
94
- /** The status a raw upgrade request is answered with, for upgrades the server refuses. */
95
- export declare const upgradeStatus: (host: string, id: string, headers: Readonly<Record<string, string>>) => Effect.Effect<number, never, never>;
96
- /**
97
- * A non-browser client that authenticates the upgrade request itself, spoken
98
- * over a raw TCP socket so it can send headers a browser's WebSocket can't.
99
- */
100
- export declare const headerSocket: (host: string, id: string, authorization: string) => Effect.Effect<{
101
- status: number;
102
- send: (message: ClientWireMessage) => Effect.Effect<void, never, never>;
103
- next: Effect.Effect<{
104
- readonly t: "open";
105
- readonly connectionId: string;
106
- readonly baseline?: string | undefined;
107
- readonly reauthenticateBy?: number | undefined;
108
- } | {
109
- readonly t: "frame";
110
- readonly frame: Schema.Json;
111
- readonly cursor?: string | undefined;
112
- readonly event?: string | undefined;
113
- } | {
114
- readonly t: "resync";
115
- readonly after?: string | undefined;
116
- readonly reason: "OwnerLost";
117
- readonly deadline: number;
118
- } | {
119
- readonly t: "resyncReplayed";
120
- readonly through?: string | undefined;
121
- } | {
122
- readonly t: "progress";
123
- readonly job: string;
124
- readonly jobId: string;
125
- readonly attempt: number;
126
- readonly seq: number;
127
- readonly frame: Schema.Json;
128
- } | {
129
- readonly t: "reauthenticate";
130
- readonly by: number;
131
- } | {
132
- readonly t: "reauthenticated";
133
- readonly by?: number | undefined;
134
- } | {
135
- readonly t: "end";
136
- readonly error?: Schema.Json | undefined;
137
- }, never, never>;
138
- closed: Effect.Effect<{
139
- readonly code: number;
140
- }, never, never>;
141
- }, never, Scope.Scope>;