@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,287 +0,0 @@
1
- import { Deferred, Effect, Fiber, Predicate, Schedule, Schema } from "effect";
2
- import { SqlClient } from "effect/sql";
3
- import { SessionEnded } from "../../../errors/actor.js";
4
- import { ActorTest } from "../../actor-test.js";
5
- import { ActorCluster } from "../../cluster.js";
6
- import { Hello, Live, Room, Said, Say, holdNext } from "./actors.js";
7
- import { connect, eventually, frameOf, isFrame, next, posts, quiet, resyncFrom, rows, throughReplayed, untilEnd, withCluster, } from "./harness.js";
8
- /** Ownership takeover, cross-runner wakes, and owner loss of held connections. */
9
- export const connectionTakeoverConformance = [
10
- {
11
- name: "a failed generation acquisition caches nothing, so the retried frame acquires once and resumes the session",
12
- run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
13
- const sql = yield* SqlClient.SqlClient;
14
- const { test, room, connection } = yield* connect("connections-unacquired");
15
- yield* next(connection);
16
- yield* test.hibernate(room.ref);
17
- const parked = BigInt((yield* test.inspect(room.ref)).generation);
18
- yield* sql `CREATE FUNCTION connections_refuse_generation() RETURNS trigger LANGUAGE plpgsql
19
- AS $$ BEGIN RAISE EXCEPTION 'generation refused'; END $$`.pipe(Effect.orDie);
20
- yield* sql `CREATE TRIGGER connections_refuse_generation BEFORE UPDATE ON actor_generations
21
- FOR EACH ROW WHEN (OLD.actor_id = 'connections-unacquired')
22
- EXECUTE FUNCTION connections_refuse_generation()`.pipe(Effect.orDie);
23
- const dropped = Effect.all([
24
- sql `DROP TRIGGER IF EXISTS connections_refuse_generation ON actor_generations`,
25
- sql `DROP FUNCTION IF EXISTS connections_refuse_generation()`,
26
- ]).pipe(Effect.orDie);
27
- yield* Effect.gen(function* () {
28
- yield* connection.send(Say.make({ text: "whoami" }));
29
- yield* Effect.sleep("300 millis");
30
- yield* dropped;
31
- const [woken] = yield* next(connection);
32
- expect(frameOf(woken)).toEqual(Hello.make({ name: "alice", resumed: true, frames: 1 }));
33
- }).pipe(Effect.ensuring(dropped));
34
- expect(BigInt((yield* test.inspect(room.ref)).generation)).toBe(parked + 1n);
35
- })),
36
- },
37
- {
38
- name: "a session write that races a takeover waits for it, writes nothing, and the redelivered frame applies once",
39
- requiresIndependentConnections: true,
40
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
41
- const sql = yield* SqlClient.SqlClient;
42
- const { room, connection } = yield* connect("connections-takeover");
43
- yield* next(connection);
44
- const hold = yield* holdNext(fixture);
45
- yield* connection.send(Say.make({ text: "hold" }));
46
- yield* hold.reached;
47
- const takeover = yield* environment.connect;
48
- yield* takeover.query("BEGIN");
49
- const bumped = (yield* takeover.query(`UPDATE actor_generations SET generation = generation + 1
50
- WHERE tenant_id = $1 AND actor_type = $2 AND actor_id = $3
51
- RETURNING generation::text AS generation`, [room.ref.tenant, room.ref.actor, room.ref.id]));
52
- yield* hold.release;
53
- yield* eventually(Effect.map(sql `SELECT count(*)::int AS waiting FROM pg_locks
54
- JOIN pg_stat_activity USING (pid)
55
- WHERE NOT granted AND datname = current_database()`, ([row]) => row.waiting > 0).pipe(Effect.orDie), "the session write to wait on the takeover");
56
- yield* takeover.query("COMMIT");
57
- const replay = yield* throughReplayed(connection);
58
- expect(replay.map((message) => message._tag)).toEqual(["Resync", "ResyncReplayed"]);
59
- expect(replay[0]).toMatchObject({
60
- after: connection.cursor === "0" ? undefined : connection.cursor,
61
- });
62
- yield* connection.resyncDone;
63
- const [answer] = yield* next(connection);
64
- const hello = frameOf(answer);
65
- expect(Predicate.isTagged(hello, "Hello") ? { name: hello.name, frames: hello.frames } : hello).toEqual({ name: "alice", frames: 1 });
66
- expect(yield* quiet(connection)).toBe(true);
67
- const [row] = yield* rows(room.ref);
68
- expect(row?.frame_seq).toBe("1");
69
- const test = yield* ActorTest;
70
- expect(BigInt((yield* test.inspect(room.ref)).generation)).toBe(BigInt(bumped[0].generation) + 1n);
71
- })),
72
- },
73
- {
74
- name: "an open that races a takeover waits for it, writes no session under the stale generation, and the reopened session handles the next frame once",
75
- requiresIndependentConnections: true,
76
- timeoutMs: 60_000,
77
- run: ({ expect, environment, fixture }) => environment.run(Effect.gen(function* () {
78
- const sql = yield* SqlClient.SqlClient;
79
- const test = yield* ActorTest;
80
- const room = yield* Room.get("connections-open-takeover");
81
- const hold = yield* holdNext(fixture);
82
- const opening = yield* test
83
- .connect(room.ref, Live, { name: "held" })
84
- .pipe(Effect.forkChild({ startImmediately: true }));
85
- yield* Effect.gen(function* () {
86
- yield* hold.reached;
87
- const takeover = yield* environment.connect;
88
- yield* takeover.query("BEGIN");
89
- const bumped = (yield* takeover.query(`UPDATE actor_generations SET generation = generation + 1
90
- WHERE tenant_id = $1 AND actor_type = $2 AND actor_id = $3
91
- RETURNING generation::text AS generation`, [room.ref.tenant, room.ref.actor, room.ref.id]));
92
- expect(bumped.length).toBe(1);
93
- expect(yield* rows(room.ref)).toEqual([]);
94
- yield* hold.release;
95
- yield* eventually(Effect.map(sql `SELECT count(*)::int AS waiting FROM pg_locks
96
- JOIN pg_stat_activity USING (pid)
97
- WHERE NOT granted AND datname = current_database()`, ([row]) => row.waiting > 0).pipe(Effect.orDie), "the open's session write to wait on the takeover");
98
- expect(yield* rows(room.ref)).toEqual([]);
99
- yield* takeover.query("COMMIT");
100
- const connection = yield* Fiber.join(opening);
101
- const [hello] = yield* next(connection);
102
- const opened = frameOf(hello);
103
- expect(Predicate.isTagged(opened, "Hello")
104
- ? { name: opened.name, frames: opened.frames }
105
- : opened).toEqual({ name: "held", frames: 0 });
106
- expect((yield* rows(room.ref)).map(({ frame_seq }) => frame_seq)).toEqual(["0"]);
107
- yield* connection.send(Say.make({ text: "whoami" }));
108
- const [answer] = yield* next(connection);
109
- const whoami = frameOf(answer);
110
- expect(Predicate.isTagged(whoami, "Hello")
111
- ? { name: whoami.name, frames: whoami.frames }
112
- : whoami).toEqual({ name: "held", frames: 1 });
113
- expect(yield* quiet(connection)).toBe(true);
114
- expect((yield* rows(room.ref)).map(({ frame_seq }) => frame_seq)).toEqual(["1"]);
115
- expect(BigInt((yield* test.inspect(room.ref)).generation)).toBe(BigInt(bumped[0].generation) + 1n);
116
- }).pipe(Effect.scoped, Effect.ensuring(hold.release));
117
- })),
118
- },
119
- {
120
- name: "an owner deletes a dead holder's connection rows at its next delivery, and its turns still commit",
121
- requiresFreshDatabase: true,
122
- requiresIndependentConnections: true,
123
- timeoutMs: 120_000,
124
- run: ({ expect, environment, fixture }) => withCluster(environment, fixture, { runners: 2, holdersOnly: [0] }, Effect.gen(function* () {
125
- const cluster = yield* ActorCluster;
126
- yield* cluster.ready;
127
- const id = "connections-dead-holder";
128
- const ref = (yield* cluster.on(0)(Room.get(id))).ref;
129
- const connection = yield* cluster.on(0)(ActorTest.use((test) => test.connect(ref, Live, { name: "alice" })));
130
- yield* next(connection);
131
- const rows = Effect.gen(function* () {
132
- const sql = yield* SqlClient.SqlClient;
133
- return (yield* sql `SELECT count(*)::int AS count
134
- FROM actor_connections WHERE tenant_id = ${ref.tenant} AND actor_id = ${ref.id}`)[0]
135
- .count;
136
- }).pipe(Effect.orDie);
137
- expect(yield* cluster.on(1)(rows)).toBe(1);
138
- yield* cluster.kill(0);
139
- yield* cluster.on(1)(Room.get(id).pipe(Effect.flatMap((room) => room.Post("after"))));
140
- yield* cluster
141
- .on(1)(rows)
142
- .pipe(Effect.repeat({
143
- schedule: Schedule.spaced("50 millis"),
144
- until: (count) => count === 0,
145
- }), Effect.timeoutOrElse({
146
- duration: "30 seconds",
147
- orElse: () => Effect.die(new Error("The dead holder's row was never deleted")),
148
- }));
149
- expect(yield* cluster.on(1)(posts(ref))).toBe(1);
150
- })),
151
- },
152
- {
153
- name: "an intent, a timer, and an effect route each wake a parked actor on another runner, and its broadcast reaches the held connection",
154
- requiresFreshDatabase: true,
155
- requiresIndependentConnections: true,
156
- timeoutMs: 120_000,
157
- run: ({ expect, environment, fixture }) => withCluster(environment, fixture, { runners: 3, holdersOnly: [0] }, Effect.gen(function* () {
158
- const cluster = yield* ActorCluster;
159
- yield* cluster.ready;
160
- const holder = cluster.on(0);
161
- const id = "connections-woken";
162
- const ref = (yield* holder(Room.get(id))).ref;
163
- const connection = yield* holder(ActorTest.use((test) => test.connect(ref, Live, { name: "alice" })));
164
- yield* next(connection);
165
- const generation = holder(ActorTest.use((test) => test.inspect(ref)));
166
- const park = Effect.gen(function* () {
167
- const owner = yield* cluster.owner(ref);
168
- expect(owner === undefined || owner === 0).toBe(false);
169
- yield* cluster.on(owner)(ActorTest.use((test) => test.hibernate(ref)));
170
- return BigInt((yield* generation).generation);
171
- });
172
- const woken = Effect.fnUntraced(function* (text, parked) {
173
- const [broadcast] = yield* next(connection);
174
- expect(frameOf(broadcast)).toEqual(Said.make({ text }));
175
- expect(BigInt((yield* generation).generation) > parked).toBe(true);
176
- });
177
- let parked = yield* park;
178
- yield* holder(Room.get("connections-dispatcher").pipe(Effect.flatMap((dispatcher) => dispatcher.Forward({ to: id, text: "by intent" }))));
179
- yield* woken("by intent", parked);
180
- yield* holder(Room.get(id).pipe(Effect.flatMap((room) => room.Forward({ text: "by timer", afterMs: 30_000 }))));
181
- parked = yield* park;
182
- expect(yield* quiet(connection)).toBe(true);
183
- yield* holder(ActorTest.use((test) => test.advance("31 seconds")));
184
- yield* woken("by timer", parked);
185
- const executed = yield* Deferred.make();
186
- fixture.echo = Deferred.await(executed);
187
- yield* holder(Room.get(id).pipe(Effect.flatMap((room) => room.Shout("by effect route"))));
188
- parked = yield* park;
189
- yield* Deferred.succeed(executed, undefined);
190
- yield* woken("by effect route", parked).pipe(Effect.ensuring(Effect.sync(() => (fixture.echo = Effect.void))));
191
- })),
192
- },
193
- {
194
- name: "an owner killed between a turn's commit and its broadcast flush resyncs from the open's cursor, and the resync handler delivers the lost event",
195
- requiresFreshDatabase: true,
196
- requiresIndependentConnections: true,
197
- timeoutMs: 120_000,
198
- run: ({ expect, environment, fixture }) => withCluster(environment, fixture, { runners: 3, holdersOnly: [0] }, Effect.gen(function* () {
199
- const cluster = yield* ActorCluster;
200
- yield* cluster.ready;
201
- const holder = cluster.on(0);
202
- const id = "connections-unflushed";
203
- const post = (text) => holder(Room.get(id).pipe(Effect.flatMap((room) => room.Post(text))));
204
- yield* post("earlier");
205
- const ref = (yield* holder(Room.get(id))).ref;
206
- const connection = yield* holder(ActorTest.use((test) => test.connect(ref, Live, { name: "alice" })));
207
- yield* next(connection);
208
- expect(BigInt(connection.cursor) > 0n).toBe(true);
209
- const owner = (yield* cluster.owner(ref));
210
- const paused = yield* cluster.on(owner)(ActorTest.use((test) => test.pauseNext("beforeFlush")));
211
- yield* post("lost").pipe(Effect.ignore, Effect.forkChild({ startImmediately: true }));
212
- yield* paused.reached;
213
- yield* cluster.kill(owner);
214
- const [resync] = yield* next(connection);
215
- expect(resync).toMatchObject(resyncFrom(connection.cursor));
216
- yield* connection.resyncDone;
217
- const replay = yield* throughReplayed(connection);
218
- const replayed = replay.filter(isFrame);
219
- expect(replayed.map(frameOf)).toEqual([Said.make({ text: "lost" })]);
220
- expect(BigInt(replayed[0].event) > BigInt(connection.cursor)).toBe(true);
221
- yield* holder(ActorTest.use((test) => test.advance("27 seconds")));
222
- expect(yield* quiet(connection)).toBe(true);
223
- yield* holder(ActorTest.use((test) => test.advance("4 seconds")));
224
- const { ended } = yield* untilEnd(connection);
225
- expect(Schema.is(SessionEnded)(ended)).toBe(true);
226
- expect(ended).toMatchObject({ cause: "OwnerLost", resync: true });
227
- })),
228
- },
229
- {
230
- name: "a third owner loss within five minutes closes with OwnerLost and a retry hint, and a loss during a replay from the beginning keeps that cursor",
231
- requiresFreshDatabase: true,
232
- requiresIndependentConnections: true,
233
- timeoutMs: 180_000,
234
- run: ({ expect, environment, fixture }) => withCluster(environment, fixture, { runners: 4, holdersOnly: [0] }, Effect.gen(function* () {
235
- const cluster = yield* ActorCluster;
236
- yield* cluster.ready;
237
- const holder = cluster.on(0);
238
- const id = "connections-crashloop";
239
- const ref = (yield* holder(Room.get(id))).ref;
240
- const connection = yield* holder(ActorTest.use((test) => test.connect(ref, Live, { name: "alice" })));
241
- yield* next(connection);
242
- expect(connection.cursor).toBe("0");
243
- const killOwner = Effect.gen(function* () {
244
- const owner = yield* cluster.owner(ref);
245
- expect(owner === undefined || owner === 0).toBe(false);
246
- yield* cluster.kill(owner);
247
- yield* cluster.ready;
248
- });
249
- yield* killOwner;
250
- const first = yield* throughReplayed(connection);
251
- expect(first[0]).toMatchObject(resyncFrom(undefined));
252
- expect(first.filter(isFrame)).toEqual([]);
253
- yield* holder(Room.get(id).pipe(Effect.flatMap((room) => room.Post("between"))));
254
- yield* killOwner;
255
- const second = yield* throughReplayed(connection);
256
- expect(second[0]).toMatchObject(resyncFrom(undefined));
257
- expect(second.filter(isFrame).map(frameOf)).toEqual([Said.make({ text: "between" })]);
258
- yield* killOwner;
259
- const { seen, ended } = yield* untilEnd(connection);
260
- expect(seen.filter((message) => Predicate.isTagged(message, "Resync"))).toEqual([]);
261
- expect(Schema.is(SessionEnded)(ended)).toBe(true);
262
- expect(ended).toMatchObject({ cause: "OwnerLost", resync: true });
263
- const retryAfterMs = ended.retryAfterMs ?? 0;
264
- expect(retryAfterMs >= 1_000 && retryAfterMs <= 5_000).toBe(true);
265
- })),
266
- },
267
- {
268
- name: "an owner does not run a frame that reaches it past the session's authorization bound",
269
- requiresFreshDatabase: true,
270
- requiresIndependentConnections: true,
271
- timeoutMs: 90_000,
272
- run: ({ expect, environment, fixture }) => withCluster(environment, fixture, { runners: 2, holdersOnly: [0] }, Effect.gen(function* () {
273
- const cluster = yield* ActorCluster;
274
- yield* cluster.ready;
275
- const holder = cluster.on(0);
276
- const ref = (yield* holder(Room.get("connections-owner-clock"))).ref;
277
- const connection = yield* holder(ActorTest.use((test) => test.connect(ref, Live, { name: "alice" })));
278
- yield* next(connection);
279
- yield* cluster.on(1)(ActorTest.use((test) => test.advance("61 seconds")));
280
- yield* connection.send(Say.make({ text: "stale" }));
281
- const { seen, ended } = yield* untilEnd(connection);
282
- expect(seen).toEqual([]);
283
- expect(ended).toMatchObject({ cause: "ServerClosed", resync: false });
284
- expect(yield* holder(posts(ref))).toBe(0);
285
- })),
286
- },
287
- ];
@@ -1,4 +0,0 @@
1
- import type { ConformanceCase } from "../conformance.ts";
2
- import type { ConnectionsFixture } from "./connections/actors.ts";
3
- /** Connection cases: open, ordered frames, session storage, broadcasts, and cleanup on close. */
4
- export declare const connectionsConformance: ReadonlyArray<ConformanceCase<ConnectionsFixture>>;
@@ -1,15 +0,0 @@
1
- import { connectionHolderConformance } from "./connections/holders.js";
2
- import { connectionLifecycleConformance } from "./connections/lifecycle.js";
3
- import { connectionLimitConformance } from "./connections/limits.js";
4
- import { connectionReauthorizationConformance } from "./connections/reauthorization.js";
5
- import { connectionResyncConformance } from "./connections/resync.js";
6
- import { connectionTakeoverConformance } from "./connections/takeover.js";
7
- /** Connection cases: open, ordered frames, session storage, broadcasts, and cleanup on close. */
8
- export const connectionsConformance = [
9
- ...connectionLifecycleConformance,
10
- ...connectionReauthorizationConformance,
11
- ...connectionResyncConformance,
12
- ...connectionLimitConformance,
13
- ...connectionHolderConformance,
14
- ...connectionTakeoverConformance,
15
- ];
@@ -1,16 +0,0 @@
1
- import { Effect, Layer } from "effect";
2
- import { InternalActors } from "../../runtime/actors.ts";
3
- import type { ContentPoint } from "../../runtime/turn/hooks.ts";
4
- import type { ConformanceCase, ConformanceSuite } from "../conformance.ts";
5
- export interface ContentFixture {
6
- /** Called at every content hook point; cases replace it to pause one operation. */
7
- hook: (point: ContentPoint) => Effect.Effect<void>;
8
- /** `AttachHeld` waits on this after attaching. */
9
- held: Effect.Effect<void>;
10
- }
11
- export declare const contentFixture: () => ContentFixture;
12
- export declare const contentLayer: (fixture: ContentFixture) => Layer.Layer<never, never, InternalActors>;
13
- /** Content-blob cases: grants, per-tenant deduplication, chunked storage up to 64 MiB, and refusal of unauthorized attaches. */
14
- export declare const contentConformance: ReadonlyArray<ConformanceCase<ContentFixture>>;
15
- /** Content-blob actors; cases replace the fixture hook to pause one content operation. */
16
- export declare const contentSuite: ConformanceSuite<ContentFixture>;