@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,372 +0,0 @@
1
- import { Effect, Layer, Match, Option, Predicate, Schema } from "effect";
2
- import { Actor } from "../../../index.js";
3
- import { Request } from "../../../runtime/request.js";
4
- export const subscriptionsFixture = () => ({
5
- runs: [],
6
- callers: new Map(),
7
- behave: () => "apply",
8
- during: Effect.void,
9
- hook: () => Effect.void,
10
- });
11
- export const reset = (fixture) => Effect.sync(() => {
12
- fixture.runs.length = 0;
13
- fixture.callers.clear();
14
- fixture.behave = () => "apply";
15
- fixture.during = Effect.void;
16
- fixture.hook = () => Effect.void;
17
- });
18
- export class Refused extends Schema.TaggedError()("SubscriptionRefused", {}) {
19
- }
20
- export const OrderPlaced = Actor.event("OrderPlaced", {
21
- customerId: Schema.String,
22
- amount: Schema.Finite,
23
- });
24
- const OrderCancelled = Actor.event("OrderCancelled", {
25
- customerId: Schema.String,
26
- });
27
- const OrderNoted = Actor.event("OrderNoted", { note: Schema.String });
28
- const Place = Actor.command("Place", {
29
- payload: Schema.Struct({ customerId: Schema.String, amount: Schema.Finite }),
30
- });
31
- const PlaceMany = Actor.command("PlaceMany", {
32
- payload: Schema.Struct({ customerId: Schema.String, count: Schema.Int }),
33
- });
34
- const CancelOrder = Actor.command("CancelOrder", { payload: Schema.String });
35
- const Note = Actor.command("Note", { payload: Schema.String });
36
- const PlaceThenRefuse = Actor.command("PlaceThenRefuse", {
37
- payload: Schema.String,
38
- error: Refused,
39
- });
40
- const PlaceThenDie = Actor.command("PlaceThenDie", { payload: Schema.String });
41
- export const SubOrder = Actor.make("SubOrder", {
42
- key: Schema.String,
43
- events: [OrderPlaced, OrderCancelled, OrderNoted],
44
- api: { Place, PlaceMany, CancelOrder, Note, PlaceThenRefuse, PlaceThenDie },
45
- policy: {
46
- allowedSubscriberTypes: [
47
- "SubSummary",
48
- "SubFollower",
49
- "SubDashboard",
50
- "SubAuditor",
51
- "SubShipment",
52
- ],
53
- },
54
- });
55
- const Record = Actor.command("Record", {
56
- payload: Schema.Struct({ customerId: Schema.String, count: Schema.Int }),
57
- });
58
- /** A source whose events are pruned after an hour, and held for subscribers one hour more. */
59
- export const SubJournal = Actor.make("SubJournal", {
60
- key: Schema.String,
61
- events: [OrderPlaced],
62
- api: { Record },
63
- policy: {
64
- keepEvents: "1 hour",
65
- holdEventsForSubscribers: "1 hour",
66
- allowedSubscriberTypes: ["SubSummary", "SubFollower", "SubDashboard"],
67
- },
68
- });
69
- const Log = Actor.state({
70
- log: Schema.Array(Schema.String).pipe(Schema.withDecodingDefault(Effect.succeed([]))),
71
- });
72
- export const OrderDelivery = Actor.Delivery({
73
- source: SubOrder,
74
- events: [OrderPlaced, OrderCancelled],
75
- });
76
- /** Placements only, from the order source. */
77
- export const PlacedDelivery = Actor.Delivery({ source: SubOrder, events: [OrderPlaced] });
78
- /** Placements from the journal source. */
79
- export const JournalDelivery = Actor.Delivery({ source: SubJournal, events: [OrderPlaced] });
80
- const RecordOrder = Actor.command("RecordOrder", { payload: OrderDelivery, error: Refused });
81
- /** A customer id whose `CustomerOrders` route throws instead of returning an id. */
82
- export const THROWING_ROUTE = "route-throws";
83
- const CustomerOrders = Actor.subscription("CustomerOrders", {
84
- delivery: OrderDelivery,
85
- handler: RecordOrder,
86
- route: (event) => {
87
- if (event.customerId === THROWING_ROUTE)
88
- throw new Error("route threw");
89
- return event.customerId;
90
- },
91
- });
92
- const CustomerJournals = Actor.subscription("CustomerJournals", {
93
- delivery: JournalDelivery,
94
- handler: RecordOrder,
95
- route: (event) => event.customerId,
96
- });
97
- const Touch = Actor.command("Touch");
98
- /** Each delivery's entry, broadcast after its turn commits. */
99
- export const Live = Actor.connection("SummaryLive", {
100
- server: Schema.String,
101
- client: Schema.String,
102
- });
103
- /** A routed projection: every order event reaches the customer it names.
104
- *
105
- * @internal
106
- */
107
- export const SubSummary = Actor.make("SubSummary", {
108
- key: Schema.String,
109
- state: Log,
110
- api: { Touch, SummaryLive: Live },
111
- internal: { RecordOrder },
112
- subscriptions: [CustomerOrders, CustomerJournals],
113
- });
114
- const AuditOrder = Actor.command("AuditOrder", { payload: OrderDelivery });
115
- const AuditedOrders = Actor.subscription("AuditedOrders", {
116
- delivery: OrderDelivery,
117
- handler: AuditOrder,
118
- route: (event) => event.customerId,
119
- });
120
- /** A second routed subscription of the same source, which never fails. */
121
- const SubAuditor = Actor.make("SubAuditor", {
122
- key: Schema.String,
123
- state: Log,
124
- api: { Touch },
125
- internal: { AuditOrder },
126
- subscriptions: [AuditedOrders],
127
- });
128
- const OnOrder = Actor.command("OnOrder", { payload: OrderDelivery, error: Refused });
129
- const FollowedOrders = Actor.subscription("FollowedOrders", {
130
- delivery: OrderDelivery,
131
- handler: OnOrder,
132
- });
133
- const Follow = Actor.command("Follow", {
134
- payload: Schema.Struct({ source: Schema.String, from: Schema.optional(Schema.String) }),
135
- });
136
- const FollowThenRefuse = Actor.command("FollowThenRefuse", {
137
- payload: Schema.String,
138
- error: Refused,
139
- });
140
- const Unfollow = Actor.command("Unfollow", { payload: Schema.String });
141
- const IntentKeys = Actor.command("IntentKeys", { success: Schema.Array(Schema.String) });
142
- const FollowedJournals = Actor.subscription("FollowedJournals", {
143
- delivery: JournalDelivery,
144
- handler: OnOrder,
145
- });
146
- const FollowJournal = Actor.command("FollowJournal", {
147
- payload: Schema.Struct({ source: Schema.String, from: Schema.optional(Schema.String) }),
148
- });
149
- /** A dynamic subscriber: it follows only the orders its turns subscribe to.
150
- *
151
- * @internal
152
- */
153
- export const SubFollower = Actor.make("SubFollower", {
154
- key: Schema.String,
155
- state: Log,
156
- api: { Follow, FollowThenRefuse, Unfollow, IntentKeys, Touch, FollowJournal },
157
- internal: { OnOrder },
158
- subscriptions: [FollowedOrders, FollowedJournals],
159
- });
160
- const CountOrder = Actor.command("CountOrder", {
161
- payload: PlacedDelivery,
162
- });
163
- const AllOrders = Actor.subscription("AllOrders", {
164
- delivery: PlacedDelivery,
165
- handler: CountOrder,
166
- route: Actor.singleton,
167
- });
168
- const AllJournals = Actor.subscription("AllJournals", {
169
- delivery: JournalDelivery,
170
- handler: CountOrder,
171
- route: Actor.singleton,
172
- });
173
- /** Fan-in: every order placed in the tenant reaches the tenant's one dashboard. */
174
- const SubDashboard = Actor.make("SubDashboard", {
175
- key: Actor.singleton,
176
- state: Log,
177
- api: { Touch },
178
- internal: { CountOrder },
179
- subscriptions: [AllOrders, AllJournals],
180
- });
181
- const PaymentSeen = Actor.event("PaymentSeen", {
182
- orderId: Schema.String,
183
- });
184
- export const ShipOrder = Actor.workflow("ShipOrder", {
185
- payload: { orderId: Schema.String },
186
- success: Schema.String,
187
- key: ({ orderId }) => orderId,
188
- });
189
- const AwaitPayment = ShipOrder.wait("payment-seen", PaymentSeen);
190
- const PlaceOrder = Actor.command("PlaceOrder", {
191
- payload: Schema.String,
192
- success: Schema.String,
193
- });
194
- const OnPayment = Actor.command("OnPayment", {
195
- payload: PlacedDelivery,
196
- });
197
- const PaymentUpdates = Actor.subscription("PaymentUpdates", {
198
- delivery: PlacedDelivery,
199
- handler: OnPayment,
200
- });
201
- /**
202
- * A workflow waits only for its owner's events, so the owner follows the
203
- * order and re-emits what the workflow waits for.
204
- *
205
- * @internal
206
- */
207
- export const SubShipment = Actor.make("SubShipment", {
208
- key: Schema.String,
209
- events: [PaymentSeen],
210
- api: { ShipOrder, PlaceOrder },
211
- internal: { OnPayment },
212
- subscriptions: [PaymentUpdates],
213
- });
214
- /** A source whose only subscriber is `SubGated`, so its routed skips touch no other case. */
215
- export const SubGateOrder = Actor.make("SubGateOrder", {
216
- key: Schema.String,
217
- events: [OrderPlaced],
218
- api: { Place },
219
- policy: { allowedSubscriberTypes: ["SubGated"] },
220
- });
221
- /** Placements from the gated source. */
222
- export const GatedDelivery = Actor.Delivery({ source: SubGateOrder, events: [OrderPlaced] });
223
- const OnGated = Actor.command("OnGated", { payload: GatedDelivery });
224
- const GatedOrders = Actor.subscription("GatedOrders", {
225
- delivery: GatedDelivery,
226
- handler: OnGated,
227
- route: (event) => event.customerId,
228
- });
229
- const OpenGated = Actor.command("OpenGated");
230
- /**
231
- * A routed subscriber that exists only once `OpenGated` creates it, so
232
- * earlier deliveries skip as `NotCreated`.
233
- *
234
- * @internal
235
- */
236
- export const SubGated = Actor.make("SubGated", {
237
- key: Schema.String,
238
- state: Log,
239
- api: { OpenGated },
240
- internal: { OnGated },
241
- subscriptions: [GatedOrders],
242
- createdBy: OpenGated,
243
- });
244
- /** One delivery as a handler logs it: `source#cursor:event`, `source~gap:after-resume`, or `source!rejected:cursor`. */
245
- const entryOf = (delivery) => Match.value(delivery).pipe(Match.tagsExhaustive({
246
- Event: (event) => `${event.source.id}#${event.cursor}:${event.event._tag}`,
247
- RetentionGap: (gap) => `${gap.source.id}~gap:${gap.after}-${gap.resumeAfter}`,
248
- Rejected: (rejected) => `${rejected.source.id}!rejected:${rejected.cursor}`,
249
- }));
250
- const record = (fixture, subscriber, turn, delivery) => Effect.gen(function* () {
251
- const entry = entryOf(delivery);
252
- fixture.runs.push(`${subscriber}/${turn.id}/${entry}`);
253
- fixture.callers.set(entry, turn.caller);
254
- yield* fixture.during;
255
- const behaviour = fixture.behave(`${subscriber}/${turn.id}/${entry}`);
256
- if (behaviour === "defect")
257
- return yield* Effect.die(new Error(`Handler defect on ${entry}`));
258
- yield* turn.state.set({ log: [...turn.state.log, entry] });
259
- if (behaviour === "refuse")
260
- return yield* Refused.make({});
261
- });
262
- /** The source alone, as a runner that serves orders but none of their subscribers would. */
263
- export const subOrderLayer = SubOrder.toLayer(Effect.succeed({
264
- Place: Effect.fnUntraced(function* ({ customerId, amount }) {
265
- yield* (yield* SubOrder.Turn).emit(OrderPlaced.make({ customerId, amount }));
266
- }),
267
- PlaceMany: Effect.fnUntraced(function* ({ customerId, count }) {
268
- const turn = yield* SubOrder.Turn;
269
- for (let index = 0; index < count; index++)
270
- yield* turn.emit(OrderPlaced.make({ customerId, amount: index }));
271
- }),
272
- CancelOrder: Effect.fnUntraced(function* (customerId) {
273
- yield* (yield* SubOrder.Turn).emit(OrderCancelled.make({ customerId }));
274
- }),
275
- Note: Effect.fnUntraced(function* (note) {
276
- yield* (yield* SubOrder.Turn).emit(OrderNoted.make({ note }));
277
- }),
278
- PlaceThenRefuse: Effect.fnUntraced(function* (customerId) {
279
- yield* (yield* SubOrder.Turn).emit(OrderPlaced.make({ customerId, amount: 1 }));
280
- return yield* Refused.make({});
281
- }),
282
- PlaceThenDie: Effect.fnUntraced(function* (customerId) {
283
- yield* (yield* SubOrder.Turn).emit(OrderPlaced.make({ customerId, amount: 1 }));
284
- return yield* Effect.die(new Error("Publisher defect after emitting"));
285
- }),
286
- }));
287
- export const subscriptionsLayer = (fixture) => Layer.mergeAll(subOrderLayer, SubJournal.toLayer(Effect.succeed({
288
- Record: Effect.fnUntraced(function* ({ customerId, count }) {
289
- const turn = yield* SubJournal.Turn;
290
- for (let index = 0; index < count; index++)
291
- yield* turn.emit(OrderPlaced.make({ customerId, amount: index }));
292
- }),
293
- })), SubSummary.toLayer(Effect.succeed({
294
- Touch: () => Effect.void,
295
- RecordOrder: Effect.fnUntraced(function* (delivery) {
296
- const turn = yield* SubSummary.Turn;
297
- yield* turn.broadcast(Live, entryOf(delivery));
298
- yield* record(fixture, "SubSummary", turn, delivery);
299
- }),
300
- SummaryLive: { open: () => Effect.void, frame: () => Effect.void },
301
- })), SubShipment.toLayer(Effect.succeed({
302
- PlaceOrder: Effect.fnUntraced(function* (orderId) {
303
- const turn = yield* SubShipment.Turn;
304
- yield* turn.subscribe(PaymentUpdates, orderId, { from: "start" });
305
- return yield* (yield* SubShipment.intents(turn.id)).ShipOrder({ orderId });
306
- }),
307
- OnPayment: Effect.fnUntraced(function* (delivery) {
308
- const turn = yield* SubShipment.Turn;
309
- if (!Predicate.isTagged(delivery, "Event"))
310
- return;
311
- yield* turn.emit(PaymentSeen.make({ orderId: delivery.source.id }));
312
- yield* turn.unsubscribe(PaymentUpdates, delivery.source.id);
313
- }),
314
- ShipOrder: Effect.fnUntraced(function* ({ orderId }) {
315
- const paid = yield* AwaitPayment({
316
- where: (event) => event.orderId === orderId,
317
- timeout: "1 minute",
318
- });
319
- return Option.match(paid, { onNone: () => "unpaid", onSome: () => "paid" });
320
- }),
321
- })), SubAuditor.toLayer(Effect.succeed({
322
- Touch: () => Effect.void,
323
- AuditOrder: Effect.fnUntraced(function* (delivery) {
324
- const turn = yield* SubAuditor.Turn;
325
- fixture.runs.push(`SubAuditor/${turn.id}/${entryOf(delivery)}`);
326
- yield* turn.state.set({ log: [...turn.state.log, entryOf(delivery)] });
327
- }),
328
- })), SubFollower.toLayer(Effect.succeed({
329
- Follow: Effect.fnUntraced(function* ({ source, from }) {
330
- yield* (yield* SubFollower.Turn).subscribe(FollowedOrders, source, from === undefined ? undefined : { from });
331
- }),
332
- FollowJournal: Effect.fnUntraced(function* ({ source, from }) {
333
- yield* (yield* SubFollower.Turn).subscribe(FollowedJournals, source, from === undefined ? undefined : { from });
334
- }),
335
- FollowThenRefuse: Effect.fnUntraced(function* (source) {
336
- yield* (yield* SubFollower.Turn).subscribe(FollowedOrders, source);
337
- return yield* Refused.make({});
338
- }),
339
- Unfollow: Effect.fnUntraced(function* (source) {
340
- yield* (yield* SubFollower.Turn).unsubscribe(FollowedOrders, source);
341
- }),
342
- IntentKeys: Effect.fnUntraced(function* () {
343
- const intents = yield* SubFollower.intents((yield* SubFollower.Turn).id);
344
- return Object.keys(intents)
345
- .filter((key) => key !== "ref")
346
- .sort();
347
- }),
348
- Touch: () => Effect.void,
349
- OnOrder: Effect.fnUntraced(function* (delivery) {
350
- yield* record(fixture, "SubFollower", yield* SubFollower.Turn, delivery);
351
- }),
352
- })), SubGateOrder.toLayer(Effect.succeed({
353
- Place: Effect.fnUntraced(function* ({ customerId, amount }) {
354
- yield* (yield* SubGateOrder.Turn).emit(OrderPlaced.make({ customerId, amount }));
355
- }),
356
- })), SubGated.toLayer(Effect.succeed({
357
- OpenGated: () => Effect.void,
358
- OnGated: Effect.fnUntraced(function* (delivery) {
359
- yield* record(fixture, "SubGated", yield* SubGated.Turn, delivery).pipe(Effect.orDie);
360
- }),
361
- })), SubDashboard.toLayer(Effect.succeed({
362
- Touch: () => Effect.void,
363
- CountOrder: Effect.fnUntraced(function* (delivery) {
364
- yield* record(fixture, "SubDashboard", yield* SubDashboard.Turn, delivery).pipe(Effect.orDie);
365
- }),
366
- })));
367
- /** Subscription actors; cases replace the fixture hook to fault one turn. */
368
- export const subscriptionsSuite = {
369
- fixture: subscriptionsFixture,
370
- layer: subscriptionsLayer,
371
- turn: (fixture) => (point, request) => Effect.suspend(() => fixture.hook(point, request)),
372
- };
@@ -1,4 +0,0 @@
1
- import type { ConformanceCase } from "../../conformance.ts";
2
- import { type SubscriptionsFixture } from "./actors.ts";
3
- /** Multi-runner subscription cases: subscribers wake across runners and one source's events apply in cursor order under redelivery. */
4
- export declare const subscriptionsClusterConformance: ReadonlyArray<ConformanceCase<SubscriptionsFixture>>;
@@ -1,89 +0,0 @@
1
- import { Effect, Layer, Stream } from "effect";
2
- import { ActorTest } from "../../actor-test.js";
3
- import { ActorCluster } from "../../cluster.js";
4
- import { Live, SubFollower, SubOrder, SubSummary, reset, subscriptionsLayer, } from "./actors.js";
5
- import { followerLog, logOf, sourceRows, tagMismatches } from "./harness.js";
6
- /** Builds a fresh database and `runners` runners on it for one case. */
7
- const withCluster = (environment, fixture, runners, body, holdersOnly) => environment.run(Effect.gen(function* () {
8
- yield* reset(fixture);
9
- const database = yield* environment.freshDatabase;
10
- const context = yield* Layer.build(ActorTest.cluster({
11
- database,
12
- runners,
13
- holdersOnly,
14
- shardLockExpiration: "3 seconds",
15
- actors: subscriptionsLayer(fixture),
16
- relay: { claimLease: "3 seconds", poll: "200 millis" },
17
- }));
18
- return yield* body.pipe(Effect.provideContext(context));
19
- }));
20
- const on = (runner, effect) => ActorCluster.use((cluster) => cluster.on(runner)(effect));
21
- /** Multi-runner subscription cases: subscribers wake across runners and one source's events apply in cursor order under redelivery. */
22
- export const subscriptionsClusterConformance = [
23
- {
24
- name: "wakes a subscriber parked on another runner and flushes the delivery's broadcast to its holder",
25
- requiresFreshDatabase: true,
26
- requiresIndependentConnections: true,
27
- timeoutMs: 120_000,
28
- run: ({ expect, environment, fixture }) => withCluster(environment, fixture, 3, Effect.gen(function* () {
29
- const cluster = yield* ActorCluster;
30
- yield* cluster.ready;
31
- const holder = cluster.on(0);
32
- const tenant = yield* holder(ActorTest.use((test) => Effect.succeed(test.tenant)));
33
- const ref = { tenant, actor: "SubSummary", id: "cross-c" };
34
- yield* holder(SubSummary.get("cross-c").pipe(Effect.flatMap((summary) => summary.Touch())));
35
- const connection = yield* holder(ActorTest.use((test) => test.connect(ref, Live, undefined)));
36
- const generation = holder(ActorTest.use((test) => test.inspect(ref)).pipe(Effect.map(({ generation }) => BigInt(generation))));
37
- const owner = yield* cluster.owner(ref);
38
- expect(owner === undefined || owner === 0).toBe(false);
39
- yield* cluster.on(owner)(ActorTest.use((test) => test.hibernate(ref)));
40
- const parked = yield* generation;
41
- yield* holder(SubOrder.get("cross-o").pipe(Effect.flatMap((order) => order.Place({ customerId: "cross-c", amount: 1 }))));
42
- const frames = yield* connection.frames.pipe(Stream.take(1), Stream.runCollect, Effect.timeout("30 seconds"));
43
- expect(Array.from(frames)).toEqual(["cross-o#1:OrderPlaced"]);
44
- expect((yield* generation) > parked).toBe(true);
45
- expect(yield* holder(logOf("SubSummary", "cross-c"))).toEqual(["cross-o#1:OrderPlaced"]);
46
- yield* connection.close;
47
- }), [0]),
48
- },
49
- {
50
- name: "applies one source's events in cursor order under redelivery and two runners",
51
- requiresFreshDatabase: true,
52
- requiresIndependentConnections: true,
53
- timeoutMs: 120_000,
54
- run: ({ expect, environment, fixture }) => withCluster(environment, fixture, 2, Effect.gen(function* () {
55
- const followers = Array.from({ length: 8 }, (_, index) => `cluster-f${index}`);
56
- for (const [index, id] of followers.entries())
57
- yield* on(index % 2, Effect.flatMap(SubFollower.get(id), (f) => f.Follow({ source: "cluster-order" })));
58
- for (;;) {
59
- const registered = yield* on(0, sourceRows("cluster-order"));
60
- if (registered.filter((row) => row.active).length === followers.length)
61
- break;
62
- yield* Effect.sleep("50 millis");
63
- }
64
- const defected = new Set();
65
- fixture.behave = (entry) => {
66
- if (entry.includes("#2:") && !defected.has(entry)) {
67
- defected.add(entry);
68
- return "defect";
69
- }
70
- return "apply";
71
- };
72
- for (let round = 0; round < 3; round++)
73
- yield* on(round % 2, Effect.flatMap(SubOrder.get("cluster-order"), (o) => o.Place({ customerId: "cluster-c", amount: round })));
74
- const expected = ["1", "2", "3"].map((cursor) => `cluster-order#${cursor}:OrderPlaced`);
75
- for (;;) {
76
- const logs = yield* on(0, Effect.forEach(followers, followerLog));
77
- if (logs.every((log) => log.length >= 3)) {
78
- for (const log of logs)
79
- expect(log).toEqual(expected);
80
- break;
81
- }
82
- yield* Effect.sleep("100 millis");
83
- }
84
- for (const id of followers)
85
- expect(yield* on(0, ActorTest.use((test) => test.receiptsFor({ tenant: test.tenant, actor: "SubFollower", id }, "OnOrder")))).toBe(3);
86
- expect(yield* on(0, tagMismatches)).toEqual([]);
87
- }).pipe(Effect.timeout("100 seconds"), Effect.orDie)),
88
- },
89
- ];
@@ -1,4 +0,0 @@
1
- import type { ConformanceCase } from "../../conformance.ts";
2
- import { type SubscriptionsFixture } from "./actors.ts";
3
- /** Exactly-once delivery, receipts, and derived command ids of event subscriptions. */
4
- export declare const subscriptionDeliveryConformance: ReadonlyArray<ConformanceCase<SubscriptionsFixture>>;