@rikalabs/akter 0.1.0-alpha.0

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 (603) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/LICENSE +202 -0
  3. package/NOTICE +8 -0
  4. package/README.md +116 -0
  5. package/dist/actor/codecs.d.ts +77 -0
  6. package/dist/actor/codecs.js +87 -0
  7. package/dist/actor/connections.d.ts +34 -0
  8. package/dist/actor/connections.js +145 -0
  9. package/dist/actor/definition.d.ts +893 -0
  10. package/dist/actor/definition.js +147 -0
  11. package/dist/actor/descriptor.d.ts +172 -0
  12. package/dist/actor/descriptor.js +367 -0
  13. package/dist/actor/handles.d.ts +77 -0
  14. package/dist/actor/handles.js +265 -0
  15. package/dist/actor/jobs.d.ts +10 -0
  16. package/dist/actor/jobs.js +137 -0
  17. package/dist/actor/layers.d.ts +41 -0
  18. package/dist/actor/layers.js +177 -0
  19. package/dist/actor/reads.d.ts +47 -0
  20. package/dist/actor/reads.js +224 -0
  21. package/dist/actor/served.d.ts +120 -0
  22. package/dist/actor/served.js +72 -0
  23. package/dist/actor/turns.d.ts +13 -0
  24. package/dist/actor/turns.js +332 -0
  25. package/dist/actor/workflows.d.ts +16 -0
  26. package/dist/actor/workflows.js +37 -0
  27. package/dist/client/calls.d.ts +47 -0
  28. package/dist/client/calls.js +425 -0
  29. package/dist/client/clock.d.ts +56 -0
  30. package/dist/client/clock.js +119 -0
  31. package/dist/client/fleet-page.d.ts +15 -0
  32. package/dist/client/fleet-page.js +13 -0
  33. package/dist/client/fleet.d.ts +29 -0
  34. package/dist/client/fleet.js +51 -0
  35. package/dist/client/index.d.ts +17 -0
  36. package/dist/client/index.js +6 -0
  37. package/dist/client/make.d.ts +157 -0
  38. package/dist/client/make.js +221 -0
  39. package/dist/client/offline/queue.d.ts +118 -0
  40. package/dist/client/offline/queue.js +292 -0
  41. package/dist/client/offline/store.d.ts +74 -0
  42. package/dist/client/offline/store.js +78 -0
  43. package/dist/client/optimistic.d.ts +57 -0
  44. package/dist/client/optimistic.js +136 -0
  45. package/dist/client/report.d.ts +2 -0
  46. package/dist/client/report.js +8 -0
  47. package/dist/client/sessions/connection.d.ts +118 -0
  48. package/dist/client/sessions/connection.js +162 -0
  49. package/dist/client/sessions/feed.d.ts +42 -0
  50. package/dist/client/sessions/feed.js +43 -0
  51. package/dist/client/sessions/sse.d.ts +47 -0
  52. package/dist/client/sessions/sse.js +112 -0
  53. package/dist/client/sessions/stream.d.ts +28 -0
  54. package/dist/client/sessions/stream.js +35 -0
  55. package/dist/client/sessions/watch.d.ts +34 -0
  56. package/dist/client/sessions/watch.js +40 -0
  57. package/dist/client/transport.d.ts +37 -0
  58. package/dist/client/transport.js +66 -0
  59. package/dist/contexts/command.d.ts +132 -0
  60. package/dist/contexts/command.js +20 -0
  61. package/dist/contexts/connection.d.ts +68 -0
  62. package/dist/contexts/connection.js +0 -0
  63. package/dist/contexts/job.d.ts +49 -0
  64. package/dist/contexts/job.js +0 -0
  65. package/dist/contexts/workflow.d.ts +147 -0
  66. package/dist/contexts/workflow.js +22 -0
  67. package/dist/errors/actor.d.ts +200 -0
  68. package/dist/errors/actor.js +271 -0
  69. package/dist/errors/content.d.ts +19 -0
  70. package/dist/errors/content.js +14 -0
  71. package/dist/errors/database.d.ts +22 -0
  72. package/dist/errors/database.js +23 -0
  73. package/dist/errors/events.d.ts +17 -0
  74. package/dist/errors/events.js +14 -0
  75. package/dist/errors/subscription.d.ts +12 -0
  76. package/dist/errors/subscription.js +8 -0
  77. package/dist/errors/workflow.d.ts +28 -0
  78. package/dist/errors/workflow.js +17 -0
  79. package/dist/handles/actors.d.ts +17 -0
  80. package/dist/handles/actors.js +7 -0
  81. package/dist/handles/content.d.ts +59 -0
  82. package/dist/handles/content.js +36 -0
  83. package/dist/handles/intents.d.ts +164 -0
  84. package/dist/handles/intents.js +214 -0
  85. package/dist/handles/run.d.ts +31 -0
  86. package/dist/handles/run.js +21 -0
  87. package/dist/handles/workflow.d.ts +27 -0
  88. package/dist/handles/workflow.js +23 -0
  89. package/dist/identity/caller.d.ts +105 -0
  90. package/dist/identity/caller.js +68 -0
  91. package/dist/identity/child.d.ts +18 -0
  92. package/dist/identity/child.js +39 -0
  93. package/dist/identity/command.d.ts +19 -0
  94. package/dist/identity/command.js +21 -0
  95. package/dist/identity/connection.d.ts +24 -0
  96. package/dist/identity/connection.js +29 -0
  97. package/dist/identity/content.d.ts +18 -0
  98. package/dist/identity/content.js +12 -0
  99. package/dist/identity/digest.d.ts +4 -0
  100. package/dist/identity/digest.js +5 -0
  101. package/dist/identity/execution.d.ts +32 -0
  102. package/dist/identity/execution.js +63 -0
  103. package/dist/identity/mint.d.ts +51 -0
  104. package/dist/identity/mint.js +76 -0
  105. package/dist/identity/version.d.ts +2 -0
  106. package/dist/identity/version.js +3 -0
  107. package/dist/index.d.ts +159 -0
  108. package/dist/index.js +97 -0
  109. package/dist/members/blob.d.ts +43 -0
  110. package/dist/members/blob.js +29 -0
  111. package/dist/members/command.d.ts +109 -0
  112. package/dist/members/command.js +61 -0
  113. package/dist/members/connection.d.ts +55 -0
  114. package/dist/members/connection.js +49 -0
  115. package/dist/members/event.d.ts +36 -0
  116. package/dist/members/event.js +24 -0
  117. package/dist/members/job.d.ts +157 -0
  118. package/dist/members/job.js +67 -0
  119. package/dist/members/payload.d.ts +93 -0
  120. package/dist/members/payload.js +145 -0
  121. package/dist/members/reducer.d.ts +64 -0
  122. package/dist/members/reducer.js +27 -0
  123. package/dist/members/stream.d.ts +36 -0
  124. package/dist/members/stream.js +14 -0
  125. package/dist/members/subscription.d.ts +182 -0
  126. package/dist/members/subscription.js +91 -0
  127. package/dist/members/workflow.d.ts +99 -0
  128. package/dist/members/workflow.js +2 -0
  129. package/dist/policies/access.d.ts +35 -0
  130. package/dist/policies/access.js +6 -0
  131. package/dist/policies/command.d.ts +127 -0
  132. package/dist/policies/command.js +45 -0
  133. package/dist/policies/job.d.ts +28 -0
  134. package/dist/policies/job.js +60 -0
  135. package/dist/policies/schedules.d.ts +33 -0
  136. package/dist/policies/schedules.js +131 -0
  137. package/dist/protocol/frames.d.ts +66 -0
  138. package/dist/protocol/frames.js +55 -0
  139. package/dist/protocol/inspection.d.ts +807 -0
  140. package/dist/protocol/inspection.js +243 -0
  141. package/dist/protocol/wire.d.ts +184 -0
  142. package/dist/protocol/wire.js +150 -0
  143. package/dist/runtime/actors.d.ts +155 -0
  144. package/dist/runtime/actors.js +4 -0
  145. package/dist/runtime/admission.d.ts +34 -0
  146. package/dist/runtime/admission.js +72 -0
  147. package/dist/runtime/adoption/backfill.d.ts +27 -0
  148. package/dist/runtime/adoption/backfill.js +144 -0
  149. package/dist/runtime/adoption/enforce.d.ts +55 -0
  150. package/dist/runtime/adoption/enforce.js +241 -0
  151. package/dist/runtime/adoption/observe.d.ts +43 -0
  152. package/dist/runtime/adoption/observe.js +139 -0
  153. package/dist/runtime/adoption/plan.d.ts +45 -0
  154. package/dist/runtime/adoption/plan.js +192 -0
  155. package/dist/runtime/adoption/startup.d.ts +32 -0
  156. package/dist/runtime/adoption/startup.js +76 -0
  157. package/dist/runtime/adoption/status.d.ts +23 -0
  158. package/dist/runtime/adoption/status.js +47 -0
  159. package/dist/runtime/adoption/target.d.ts +33 -0
  160. package/dist/runtime/adoption/target.js +49 -0
  161. package/dist/runtime/connections/holder.d.ts +221 -0
  162. package/dist/runtime/connections/holder.js +816 -0
  163. package/dist/runtime/connections/owner.d.ts +263 -0
  164. package/dist/runtime/connections/owner.js +896 -0
  165. package/dist/runtime/connections/protocol.d.ts +441 -0
  166. package/dist/runtime/connections/protocol.js +222 -0
  167. package/dist/runtime/connections/reads.d.ts +24 -0
  168. package/dist/runtime/connections/reads.js +19 -0
  169. package/dist/runtime/connections/streams.d.ts +62 -0
  170. package/dist/runtime/connections/streams.js +128 -0
  171. package/dist/runtime/connections/transport.d.ts +40 -0
  172. package/dist/runtime/connections/transport.js +68 -0
  173. package/dist/runtime/connections/watch.d.ts +52 -0
  174. package/dist/runtime/connections/watch.js +159 -0
  175. package/dist/runtime/content/grant.d.ts +34 -0
  176. package/dist/runtime/content/grant.js +58 -0
  177. package/dist/runtime/content/store.d.ts +63 -0
  178. package/dist/runtime/content/store.js +294 -0
  179. package/dist/runtime/cron/key.d.ts +2 -0
  180. package/dist/runtime/cron/key.js +2 -0
  181. package/dist/runtime/cron/schedule.d.ts +69 -0
  182. package/dist/runtime/cron/schedule.js +144 -0
  183. package/dist/runtime/database/bounded.d.ts +43 -0
  184. package/dist/runtime/database/bounded.js +108 -0
  185. package/dist/runtime/database/connection.d.ts +8 -0
  186. package/dist/runtime/database/connection.js +18 -0
  187. package/dist/runtime/database/coordination.d.ts +19 -0
  188. package/dist/runtime/database/coordination.js +72 -0
  189. package/dist/runtime/database/flock.d.ts +10 -0
  190. package/dist/runtime/database/flock.js +60 -0
  191. package/dist/runtime/database/gate.d.ts +26 -0
  192. package/dist/runtime/database/gate.js +54 -0
  193. package/dist/runtime/database/keepalive.d.ts +11 -0
  194. package/dist/runtime/database/keepalive.js +22 -0
  195. package/dist/runtime/database/migrations.d.ts +177 -0
  196. package/dist/runtime/database/migrations.js +1018 -0
  197. package/dist/runtime/database/neki/migrations.d.ts +31 -0
  198. package/dist/runtime/database/neki/migrations.js +276 -0
  199. package/dist/runtime/database/neki/session.d.ts +23 -0
  200. package/dist/runtime/database/neki/session.js +31 -0
  201. package/dist/runtime/database/pglite.d.ts +21 -0
  202. package/dist/runtime/database/pglite.js +74 -0
  203. package/dist/runtime/database/replica.d.ts +41 -0
  204. package/dist/runtime/database/replica.js +51 -0
  205. package/dist/runtime/database/shards.d.ts +21 -0
  206. package/dist/runtime/database/shards.js +37 -0
  207. package/dist/runtime/database/snapshot.d.ts +7 -0
  208. package/dist/runtime/database/snapshot.js +7 -0
  209. package/dist/runtime/database/tenancy.d.ts +69 -0
  210. package/dist/runtime/database/tenancy.js +145 -0
  211. package/dist/runtime/database/transient.d.ts +10 -0
  212. package/dist/runtime/database/transient.js +25 -0
  213. package/dist/runtime/drain.d.ts +132 -0
  214. package/dist/runtime/drain.js +109 -0
  215. package/dist/runtime/entity/mailbox.d.ts +86 -0
  216. package/dist/runtime/entity/mailbox.js +121 -0
  217. package/dist/runtime/entity/register.d.ts +424 -0
  218. package/dist/runtime/entity/register.js +669 -0
  219. package/dist/runtime/events/append.d.ts +192 -0
  220. package/dist/runtime/events/append.js +128 -0
  221. package/dist/runtime/events/cursor.d.ts +2 -0
  222. package/dist/runtime/events/cursor.js +5 -0
  223. package/dist/runtime/events/replay.d.ts +20 -0
  224. package/dist/runtime/events/replay.js +45 -0
  225. package/dist/runtime/feeds.d.ts +26 -0
  226. package/dist/runtime/feeds.js +100 -0
  227. package/dist/runtime/fleet/checks.d.ts +17 -0
  228. package/dist/runtime/fleet/checks.js +106 -0
  229. package/dist/runtime/fleet/maintainer.d.ts +38 -0
  230. package/dist/runtime/fleet/maintainer.js +383 -0
  231. package/dist/runtime/fleet/pgoutput.d.ts +41 -0
  232. package/dist/runtime/fleet/pgoutput.js +102 -0
  233. package/dist/runtime/fleet/setup.d.ts +36 -0
  234. package/dist/runtime/fleet/setup.js +58 -0
  235. package/dist/runtime/fleet/subscribe.d.ts +42 -0
  236. package/dist/runtime/fleet/subscribe.js +147 -0
  237. package/dist/runtime/index.d.ts +66 -0
  238. package/dist/runtime/index.js +37 -0
  239. package/dist/runtime/inspector/http.d.ts +19 -0
  240. package/dist/runtime/inspector/http.js +36 -0
  241. package/dist/runtime/inspector/layer.d.ts +46 -0
  242. package/dist/runtime/inspector/layer.js +180 -0
  243. package/dist/runtime/inspector/queries.d.ts +711 -0
  244. package/dist/runtime/inspector/queries.js +494 -0
  245. package/dist/runtime/jobs/attempt.d.ts +254 -0
  246. package/dist/runtime/jobs/attempt.js +413 -0
  247. package/dist/runtime/jobs/isolation.d.ts +20 -0
  248. package/dist/runtime/jobs/isolation.js +10 -0
  249. package/dist/runtime/jobs/progress.d.ts +95 -0
  250. package/dist/runtime/jobs/progress.js +144 -0
  251. package/dist/runtime/layer.d.ts +260 -0
  252. package/dist/runtime/layer.js +876 -0
  253. package/dist/runtime/members.d.ts +381 -0
  254. package/dist/runtime/members.js +8 -0
  255. package/dist/runtime/operators/audit.d.ts +64 -0
  256. package/dist/runtime/operators/audit.js +56 -0
  257. package/dist/runtime/operators/auth.d.ts +29 -0
  258. package/dist/runtime/operators/auth.js +42 -0
  259. package/dist/runtime/operators/export.d.ts +68 -0
  260. package/dist/runtime/operators/export.js +137 -0
  261. package/dist/runtime/operators/grants.d.ts +45 -0
  262. package/dist/runtime/operators/grants.js +40 -0
  263. package/dist/runtime/operators/repair.d.ts +206 -0
  264. package/dist/runtime/operators/repair.js +226 -0
  265. package/dist/runtime/operators/routes.d.ts +35 -0
  266. package/dist/runtime/operators/routes.js +190 -0
  267. package/dist/runtime/operators/seed.d.ts +123 -0
  268. package/dist/runtime/operators/seed.js +123 -0
  269. package/dist/runtime/payloads/versions.d.ts +65 -0
  270. package/dist/runtime/payloads/versions.js +240 -0
  271. package/dist/runtime/peering/authority.d.ts +42 -0
  272. package/dist/runtime/peering/authority.js +132 -0
  273. package/dist/runtime/peering/credentials.d.ts +21 -0
  274. package/dist/runtime/peering/credentials.js +13 -0
  275. package/dist/runtime/peering/transport.d.ts +51 -0
  276. package/dist/runtime/peering/transport.js +175 -0
  277. package/dist/runtime/queries.d.ts +18 -0
  278. package/dist/runtime/queries.js +169 -0
  279. package/dist/runtime/readiness.d.ts +36 -0
  280. package/dist/runtime/readiness.js +44 -0
  281. package/dist/runtime/registration.d.ts +58 -0
  282. package/dist/runtime/registration.js +186 -0
  283. package/dist/runtime/request.d.ts +158 -0
  284. package/dist/runtime/request.js +102 -0
  285. package/dist/runtime/retry.d.ts +8 -0
  286. package/dist/runtime/retry.js +11 -0
  287. package/dist/runtime/runner.d.ts +93 -0
  288. package/dist/runtime/runner.js +122 -0
  289. package/dist/runtime/storage/codec.d.ts +39 -0
  290. package/dist/runtime/storage/codec.js +41 -0
  291. package/dist/runtime/storage/generation.d.ts +69 -0
  292. package/dist/runtime/storage/generation.js +49 -0
  293. package/dist/runtime/storage/placements.d.ts +15 -0
  294. package/dist/runtime/storage/placements.js +38 -0
  295. package/dist/runtime/storage/platform.d.ts +6 -0
  296. package/dist/runtime/storage/platform.js +9 -0
  297. package/dist/runtime/storage/retention.d.ts +73 -0
  298. package/dist/runtime/storage/retention.js +158 -0
  299. package/dist/runtime/subscriptions/identity.d.ts +31 -0
  300. package/dist/runtime/subscriptions/identity.js +45 -0
  301. package/dist/runtime/subscriptions/relay.d.ts +175 -0
  302. package/dist/runtime/subscriptions/relay.js +763 -0
  303. package/dist/runtime/subscriptions/storage.d.ts +40 -0
  304. package/dist/runtime/subscriptions/storage.js +98 -0
  305. package/dist/runtime/sweeps.d.ts +39 -0
  306. package/dist/runtime/sweeps.js +54 -0
  307. package/dist/runtime/telemetry/defects.d.ts +57 -0
  308. package/dist/runtime/telemetry/defects.js +43 -0
  309. package/dist/runtime/telemetry/metrics.d.ts +52 -0
  310. package/dist/runtime/telemetry/metrics.js +138 -0
  311. package/dist/runtime/telemetry/routes.d.ts +19 -0
  312. package/dist/runtime/telemetry/routes.js +18 -0
  313. package/dist/runtime/telemetry/sampler.d.ts +26 -0
  314. package/dist/runtime/telemetry/sampler.js +101 -0
  315. package/dist/runtime/telemetry/spans.d.ts +38 -0
  316. package/dist/runtime/telemetry/spans.js +44 -0
  317. package/dist/runtime/telemetry/usage.d.ts +52 -0
  318. package/dist/runtime/telemetry/usage.js +30 -0
  319. package/dist/runtime/topology/admission.d.ts +13 -0
  320. package/dist/runtime/topology/admission.js +36 -0
  321. package/dist/runtime/topology/locks.d.ts +56 -0
  322. package/dist/runtime/topology/locks.js +81 -0
  323. package/dist/runtime/topology/messages.d.ts +15 -0
  324. package/dist/runtime/topology/messages.js +32 -0
  325. package/dist/runtime/turn/admission.d.ts +22 -0
  326. package/dist/runtime/turn/admission.js +41 -0
  327. package/dist/runtime/turn/blobs.d.ts +38 -0
  328. package/dist/runtime/turn/blobs.js +215 -0
  329. package/dist/runtime/turn/execute.d.ts +208 -0
  330. package/dist/runtime/turn/execute.js +972 -0
  331. package/dist/runtime/turn/group.d.ts +165 -0
  332. package/dist/runtime/turn/group.js +326 -0
  333. package/dist/runtime/turn/hooks.d.ts +44 -0
  334. package/dist/runtime/turn/hooks.js +28 -0
  335. package/dist/runtime/turn/outbox.d.ts +159 -0
  336. package/dist/runtime/turn/outbox.js +269 -0
  337. package/dist/runtime/turn/pipeline.d.ts +68 -0
  338. package/dist/runtime/turn/pipeline.js +83 -0
  339. package/dist/runtime/turn/receipt.d.ts +81 -0
  340. package/dist/runtime/turn/receipt.js +32 -0
  341. package/dist/runtime/turn/relay.d.ts +179 -0
  342. package/dist/runtime/turn/relay.js +685 -0
  343. package/dist/runtime/turn/rows.d.ts +43 -0
  344. package/dist/runtime/turn/rows.js +592 -0
  345. package/dist/runtime/workflows/compatibility.d.ts +125 -0
  346. package/dist/runtime/workflows/compatibility.js +285 -0
  347. package/dist/runtime/workflows/engine.d.ts +107 -0
  348. package/dist/runtime/workflows/engine.js +826 -0
  349. package/dist/runtime/workflows/manifest.d.ts +34 -0
  350. package/dist/runtime/workflows/manifest.js +39 -0
  351. package/dist/runtime/workflows/steps.d.ts +33 -0
  352. package/dist/runtime/workflows/steps.js +152 -0
  353. package/dist/serve/api.d.ts +99 -0
  354. package/dist/serve/api.js +403 -0
  355. package/dist/serve/assertion/binding.d.ts +41 -0
  356. package/dist/serve/assertion/binding.js +92 -0
  357. package/dist/serve/assertion/verify.d.ts +93 -0
  358. package/dist/serve/assertion/verify.js +189 -0
  359. package/dist/serve/auth.d.ts +200 -0
  360. package/dist/serve/auth.js +92 -0
  361. package/dist/serve/clock.d.ts +10 -0
  362. package/dist/serve/clock.js +25 -0
  363. package/dist/serve/jwt.d.ts +65 -0
  364. package/dist/serve/jwt.js +202 -0
  365. package/dist/serve/layer.d.ts +98 -0
  366. package/dist/serve/layer.js +809 -0
  367. package/dist/serve/mcp/endpoint.d.ts +39 -0
  368. package/dist/serve/mcp/endpoint.js +187 -0
  369. package/dist/serve/mcp/tools.d.ts +37 -0
  370. package/dist/serve/mcp/tools.js +125 -0
  371. package/dist/serve/origin.d.ts +6 -0
  372. package/dist/serve/origin.js +21 -0
  373. package/dist/serve/sessions/feed.d.ts +79 -0
  374. package/dist/serve/sessions/feed.js +115 -0
  375. package/dist/serve/sessions/socket.d.ts +56 -0
  376. package/dist/serve/sessions/socket.js +212 -0
  377. package/dist/serve/sessions/sse.d.ts +27 -0
  378. package/dist/serve/sessions/sse.js +26 -0
  379. package/dist/serve/sessions/stream.d.ts +9 -0
  380. package/dist/serve/sessions/stream.js +9 -0
  381. package/dist/serve/sessions/watch.d.ts +12 -0
  382. package/dist/serve/sessions/watch.js +11 -0
  383. package/dist/serve/wire.d.ts +16 -0
  384. package/dist/serve/wire.js +50 -0
  385. package/dist/state/blob.d.ts +71 -0
  386. package/dist/state/blob.js +0 -0
  387. package/dist/state/migration.d.ts +53 -0
  388. package/dist/state/migration.js +29 -0
  389. package/dist/tables/fleet.d.ts +170 -0
  390. package/dist/tables/fleet.js +214 -0
  391. package/dist/tables/owned.d.ts +250 -0
  392. package/dist/tables/owned.js +233 -0
  393. package/dist/testing/actor-test.d.ts +360 -0
  394. package/dist/testing/actor-test.js +337 -0
  395. package/dist/testing/cluster.d.ts +93 -0
  396. package/dist/testing/cluster.js +296 -0
  397. package/dist/testing/conformance/access.d.ts +5 -0
  398. package/dist/testing/conformance/access.js +531 -0
  399. package/dist/testing/conformance/admission.d.ts +11 -0
  400. package/dist/testing/conformance/admission.js +182 -0
  401. package/dist/testing/conformance/adoption.d.ts +2 -0
  402. package/dist/testing/conformance/adoption.js +1019 -0
  403. package/dist/testing/conformance/assertions.d.ts +202 -0
  404. package/dist/testing/conformance/assertions.js +849 -0
  405. package/dist/testing/conformance/batches.d.ts +41 -0
  406. package/dist/testing/conformance/batches.js +388 -0
  407. package/dist/testing/conformance/blobs.d.ts +14 -0
  408. package/dist/testing/conformance/blobs.js +405 -0
  409. package/dist/testing/conformance/capacity.d.ts +8 -0
  410. package/dist/testing/conformance/capacity.js +433 -0
  411. package/dist/testing/conformance/client.d.ts +5 -0
  412. package/dist/testing/conformance/client.js +719 -0
  413. package/dist/testing/conformance/cold-serve.d.ts +16 -0
  414. package/dist/testing/conformance/cold-serve.js +254 -0
  415. package/dist/testing/conformance/connections/actors.d.ts +1143 -0
  416. package/dist/testing/conformance/connections/actors.js +180 -0
  417. package/dist/testing/conformance/connections/harness.d.ts +1754 -0
  418. package/dist/testing/conformance/connections/harness.js +142 -0
  419. package/dist/testing/conformance/connections/holders.d.ts +4 -0
  420. package/dist/testing/conformance/connections/holders.js +165 -0
  421. package/dist/testing/conformance/connections/lifecycle.d.ts +4 -0
  422. package/dist/testing/conformance/connections/lifecycle.js +113 -0
  423. package/dist/testing/conformance/connections/limits.d.ts +4 -0
  424. package/dist/testing/conformance/connections/limits.js +127 -0
  425. package/dist/testing/conformance/connections/reauthorization.d.ts +4 -0
  426. package/dist/testing/conformance/connections/reauthorization.js +170 -0
  427. package/dist/testing/conformance/connections/resync.d.ts +4 -0
  428. package/dist/testing/conformance/connections/resync.js +360 -0
  429. package/dist/testing/conformance/connections/takeover.d.ts +4 -0
  430. package/dist/testing/conformance/connections/takeover.js +287 -0
  431. package/dist/testing/conformance/connections.d.ts +4 -0
  432. package/dist/testing/conformance/connections.js +15 -0
  433. package/dist/testing/conformance/content-blobs.d.ts +16 -0
  434. package/dist/testing/conformance/content-blobs.js +534 -0
  435. package/dist/testing/conformance/counter.d.ts +16 -0
  436. package/dist/testing/conformance/counter.js +813 -0
  437. package/dist/testing/conformance/cron.d.ts +5 -0
  438. package/dist/testing/conformance/cron.js +665 -0
  439. package/dist/testing/conformance/drain.d.ts +26 -0
  440. package/dist/testing/conformance/drain.js +540 -0
  441. package/dist/testing/conformance/effect-control.d.ts +38 -0
  442. package/dist/testing/conformance/effect-control.js +1059 -0
  443. package/dist/testing/conformance/effects.d.ts +23 -0
  444. package/dist/testing/conformance/effects.js +432 -0
  445. package/dist/testing/conformance/events.d.ts +28 -0
  446. package/dist/testing/conformance/events.js +335 -0
  447. package/dist/testing/conformance/export.d.ts +2 -0
  448. package/dist/testing/conformance/export.js +368 -0
  449. package/dist/testing/conformance/fleet.d.ts +444 -0
  450. package/dist/testing/conformance/fleet.js +1009 -0
  451. package/dist/testing/conformance/groups.d.ts +7 -0
  452. package/dist/testing/conformance/groups.js +353 -0
  453. package/dist/testing/conformance/heap.d.ts +3 -0
  454. package/dist/testing/conformance/heap.js +149 -0
  455. package/dist/testing/conformance/http.d.ts +2809 -0
  456. package/dist/testing/conformance/http.js +1234 -0
  457. package/dist/testing/conformance/inspection-views.d.ts +8 -0
  458. package/dist/testing/conformance/inspection-views.js +272 -0
  459. package/dist/testing/conformance/inspector.d.ts +7 -0
  460. package/dist/testing/conformance/inspector.js +650 -0
  461. package/dist/testing/conformance/mint.d.ts +58 -0
  462. package/dist/testing/conformance/mint.js +692 -0
  463. package/dist/testing/conformance/multi-runner.d.ts +8 -0
  464. package/dist/testing/conformance/multi-runner.js +403 -0
  465. package/dist/testing/conformance/neki/plan.d.ts +19 -0
  466. package/dist/testing/conformance/neki/plan.js +30 -0
  467. package/dist/testing/conformance/observability.d.ts +3 -0
  468. package/dist/testing/conformance/observability.js +343 -0
  469. package/dist/testing/conformance/offline.d.ts +4 -0
  470. package/dist/testing/conformance/offline.js +474 -0
  471. package/dist/testing/conformance/operator-harness.d.ts +57 -0
  472. package/dist/testing/conformance/operator-harness.js +78 -0
  473. package/dist/testing/conformance/operator.d.ts +3 -0
  474. package/dist/testing/conformance/operator.js +379 -0
  475. package/dist/testing/conformance/outbox-cross-shard.d.ts +14 -0
  476. package/dist/testing/conformance/outbox-cross-shard.js +160 -0
  477. package/dist/testing/conformance/outbox.d.ts +36 -0
  478. package/dist/testing/conformance/outbox.js +437 -0
  479. package/dist/testing/conformance/payload-migrations.d.ts +3 -0
  480. package/dist/testing/conformance/payload-migrations.js +612 -0
  481. package/dist/testing/conformance/pipeline.d.ts +3 -0
  482. package/dist/testing/conformance/pipeline.js +1040 -0
  483. package/dist/testing/conformance/placement.d.ts +22 -0
  484. package/dist/testing/conformance/placement.js +539 -0
  485. package/dist/testing/conformance/platform.d.ts +40 -0
  486. package/dist/testing/conformance/platform.js +101 -0
  487. package/dist/testing/conformance/progress.d.ts +39 -0
  488. package/dist/testing/conformance/progress.js +666 -0
  489. package/dist/testing/conformance/properties.d.ts +6 -0
  490. package/dist/testing/conformance/properties.js +295 -0
  491. package/dist/testing/conformance/protocols.d.ts +4 -0
  492. package/dist/testing/conformance/protocols.js +618 -0
  493. package/dist/testing/conformance/provider/advertise.d.ts +21 -0
  494. package/dist/testing/conformance/provider/advertise.js +44 -0
  495. package/dist/testing/conformance/read-your-writes.d.ts +20 -0
  496. package/dist/testing/conformance/read-your-writes.js +192 -0
  497. package/dist/testing/conformance/reducers.d.ts +8 -0
  498. package/dist/testing/conformance/reducers.js +258 -0
  499. package/dist/testing/conformance/relay.d.ts +42 -0
  500. package/dist/testing/conformance/relay.js +1115 -0
  501. package/dist/testing/conformance/restore.d.ts +43 -0
  502. package/dist/testing/conformance/restore.js +341 -0
  503. package/dist/testing/conformance/retention.d.ts +14 -0
  504. package/dist/testing/conformance/retention.js +463 -0
  505. package/dist/testing/conformance/rls.d.ts +24 -0
  506. package/dist/testing/conformance/rls.js +576 -0
  507. package/dist/testing/conformance/simulation.d.ts +31 -0
  508. package/dist/testing/conformance/simulation.js +167 -0
  509. package/dist/testing/conformance/single-shard.d.ts +2 -0
  510. package/dist/testing/conformance/single-shard.js +125 -0
  511. package/dist/testing/conformance/singleton.d.ts +3 -0
  512. package/dist/testing/conformance/singleton.js +293 -0
  513. package/dist/testing/conformance/statements.d.ts +60 -0
  514. package/dist/testing/conformance/statements.js +108 -0
  515. package/dist/testing/conformance/streams.d.ts +7 -0
  516. package/dist/testing/conformance/streams.js +280 -0
  517. package/dist/testing/conformance/subscriptions/access.d.ts +4 -0
  518. package/dist/testing/conformance/subscriptions/access.js +98 -0
  519. package/dist/testing/conformance/subscriptions/actors.d.ts +4910 -0
  520. package/dist/testing/conformance/subscriptions/actors.js +372 -0
  521. package/dist/testing/conformance/subscriptions/cluster.d.ts +4 -0
  522. package/dist/testing/conformance/subscriptions/cluster.js +89 -0
  523. package/dist/testing/conformance/subscriptions/delivery.d.ts +4 -0
  524. package/dist/testing/conformance/subscriptions/delivery.js +253 -0
  525. package/dist/testing/conformance/subscriptions/deploys.d.ts +4 -0
  526. package/dist/testing/conformance/subscriptions/deploys.js +162 -0
  527. package/dist/testing/conformance/subscriptions/epochs.d.ts +4 -0
  528. package/dist/testing/conformance/subscriptions/epochs.js +169 -0
  529. package/dist/testing/conformance/subscriptions/failures.d.ts +4 -0
  530. package/dist/testing/conformance/subscriptions/failures.js +108 -0
  531. package/dist/testing/conformance/subscriptions/feeds.d.ts +4 -0
  532. package/dist/testing/conformance/subscriptions/feeds.js +218 -0
  533. package/dist/testing/conformance/subscriptions/harness.d.ts +124 -0
  534. package/dist/testing/conformance/subscriptions/harness.js +143 -0
  535. package/dist/testing/conformance/subscriptions/operator.d.ts +4 -0
  536. package/dist/testing/conformance/subscriptions/operator.js +128 -0
  537. package/dist/testing/conformance/subscriptions/retention.d.ts +4 -0
  538. package/dist/testing/conformance/subscriptions/retention.js +288 -0
  539. package/dist/testing/conformance/subscriptions/routing.d.ts +4 -0
  540. package/dist/testing/conformance/subscriptions/routing.js +179 -0
  541. package/dist/testing/conformance/subscriptions.d.ts +4 -0
  542. package/dist/testing/conformance/subscriptions.js +19 -0
  543. package/dist/testing/conformance/tables.d.ts +125 -0
  544. package/dist/testing/conformance/tables.js +664 -0
  545. package/dist/testing/conformance/transports/actors.d.ts +1907 -0
  546. package/dist/testing/conformance/transports/actors.js +163 -0
  547. package/dist/testing/conformance/transports/client.d.ts +3 -0
  548. package/dist/testing/conformance/transports/client.js +237 -0
  549. package/dist/testing/conformance/transports/feeds.d.ts +3 -0
  550. package/dist/testing/conformance/transports/feeds.js +232 -0
  551. package/dist/testing/conformance/transports/harness.d.ts +93 -0
  552. package/dist/testing/conformance/transports/harness.js +84 -0
  553. package/dist/testing/conformance/transports/streams.d.ts +3 -0
  554. package/dist/testing/conformance/transports/streams.js +96 -0
  555. package/dist/testing/conformance/transports/websocket.d.ts +3 -0
  556. package/dist/testing/conformance/transports/websocket.js +384 -0
  557. package/dist/testing/conformance/transports/wire.d.ts +141 -0
  558. package/dist/testing/conformance/transports/wire.js +204 -0
  559. package/dist/testing/conformance/transports.d.ts +3 -0
  560. package/dist/testing/conformance/transports.js +11 -0
  561. package/dist/testing/conformance/watch.d.ts +59 -0
  562. package/dist/testing/conformance/watch.js +879 -0
  563. package/dist/testing/conformance/workflow-engine.d.ts +97 -0
  564. package/dist/testing/conformance/workflow-engine.js +253 -0
  565. package/dist/testing/conformance/workflow-versions.d.ts +3 -0
  566. package/dist/testing/conformance/workflow-versions.js +545 -0
  567. package/dist/testing/conformance/workflows/access.d.ts +4 -0
  568. package/dist/testing/conformance/workflows/access.js +147 -0
  569. package/dist/testing/conformance/workflows/actors.d.ts +2317 -0
  570. package/dist/testing/conformance/workflows/actors.js +305 -0
  571. package/dist/testing/conformance/workflows/basics.d.ts +4 -0
  572. package/dist/testing/conformance/workflows/basics.js +144 -0
  573. package/dist/testing/conformance/workflows/engine.d.ts +4 -0
  574. package/dist/testing/conformance/workflows/engine.js +80 -0
  575. package/dist/testing/conformance/workflows/guards.d.ts +4 -0
  576. package/dist/testing/conformance/workflows/guards.js +172 -0
  577. package/dist/testing/conformance/workflows/harness.d.ts +14 -0
  578. package/dist/testing/conformance/workflows/harness.js +44 -0
  579. package/dist/testing/conformance/workflows/recovery.d.ts +4 -0
  580. package/dist/testing/conformance/workflows/recovery.js +181 -0
  581. package/dist/testing/conformance/workflows/starts.d.ts +4 -0
  582. package/dist/testing/conformance/workflows/starts.js +57 -0
  583. package/dist/testing/conformance/workflows/suspension.d.ts +4 -0
  584. package/dist/testing/conformance/workflows/suspension.js +106 -0
  585. package/dist/testing/conformance/workflows/waits.d.ts +4 -0
  586. package/dist/testing/conformance/workflows/waits.js +284 -0
  587. package/dist/testing/conformance/workflows.d.ts +4 -0
  588. package/dist/testing/conformance/workflows.js +19 -0
  589. package/dist/testing/conformance.d.ts +330 -0
  590. package/dist/testing/conformance.js +364 -0
  591. package/dist/testing/database.d.ts +31 -0
  592. package/dist/testing/database.js +70 -0
  593. package/dist/testing/foundation.d.ts +41 -0
  594. package/dist/testing/foundation.js +517 -0
  595. package/dist/testing/index.d.ts +20 -0
  596. package/dist/testing/index.js +12 -0
  597. package/dist/testing/property.d.ts +40 -0
  598. package/dist/testing/property.js +95 -0
  599. package/dist/testing/simulate-cluster.d.ts +112 -0
  600. package/dist/testing/simulate-cluster.js +257 -0
  601. package/dist/testing/simulate.d.ts +90 -0
  602. package/dist/testing/simulate.js +127 -0
  603. package/package.json +1 -0
@@ -0,0 +1,108 @@
1
+ /**
2
+ * Tables that hold one row per deployment, per actor type, or per runner
3
+ * rather than per actor, so no `routing_key` names them. Cluster's own
4
+ * `cluster_*` tables are the same: they stay together in one shard group.
5
+ */
6
+ export const REGISTRY_TABLES = new Set([
7
+ "actor_deployment",
8
+ "actor_placements",
9
+ "actor_migrations",
10
+ "actor_payload_versions",
11
+ "actor_payload_writers",
12
+ "actor_routed_subscriptions",
13
+ "actor_content_types",
14
+ "actor_tables",
15
+ ]);
16
+ const collapse = (sql) => sql.replace(/\s+/g, " ").trim();
17
+ /**
18
+ * The tables a statement names: `INTO t (columns)` and `UPDATE t SET` name a
19
+ * table, while `FROM f(...)` names a function.
20
+ */
21
+ const tablesOf = (sql) => {
22
+ const defined = new Set(Array.from(sql.matchAll(/(?:\bwith\b|,)\s*([a-z_]\w*)\s*(?:\([^)]*\))?\s+as\s*\(/gi), (match) => match[1].toLowerCase()));
23
+ const named = [
24
+ ...sql.matchAll(/\b(?:into|update)\s+"?([a-z_]\w*)"?(?![\w"])/gi),
25
+ ...sql.matchAll(/\b(?:from|join)\s+"?([a-z_]\w*)"?(?![\w"]|\s*\()/gi),
26
+ ];
27
+ return new Set(named.flatMap((match) => {
28
+ const name = match[1].toLowerCase();
29
+ return defined.has(name) || name === "only" ? [] : [name];
30
+ }));
31
+ };
32
+ export const scopeOf = (sql) => {
33
+ const tables = tablesOf(sql);
34
+ if (tables.size === 0)
35
+ return "table-free";
36
+ if (/\bbucket"?\s*(?:=|<|>|between\b|in\b)/i.test(sql))
37
+ return "scan";
38
+ if (/\brouting_key"?\s*(?:=|<|>|in\b|between\b|any\b)/i.test(sql))
39
+ return "keyed";
40
+ if (/\(\s*"?routing_key"?\s*,/i.test(sql))
41
+ return "keyed";
42
+ if (Array.from(tables).every((table) => REGISTRY_TABLES.has(table) || table.startsWith("cluster_")))
43
+ return "registry";
44
+ return "unkeyed";
45
+ };
46
+ export const statementLog = () => {
47
+ const log = {
48
+ recording: false,
49
+ seen: new Map(),
50
+ observe: (statement) => {
51
+ if (!log.recording)
52
+ return;
53
+ const [text, params] = statement.compile();
54
+ const sql = collapse(text);
55
+ if (!log.seen.has(sql))
56
+ log.seen.set(sql, { sql, params });
57
+ },
58
+ };
59
+ return log;
60
+ };
61
+ const SSL_REQUEST = 80877103;
62
+ const GSS_REQUEST = 80877104;
63
+ const SYNC = 0x53;
64
+ const QUERY = 0x51;
65
+ /**
66
+ * Counts the statements a client sends on one Postgres connection from its
67
+ * protocol messages, for a relay that sees every byte the client writes:
68
+ * every extended-protocol statement ends its cycle with one Sync, and a
69
+ * simple query is one Query message. The startup and encryption requests
70
+ * that open a connection carry no type byte and are skipped.
71
+ */
72
+ export const wireStatements = () => {
73
+ let started = false;
74
+ let pending = Buffer.alloc(0);
75
+ return (chunk) => {
76
+ let statements = 0;
77
+ pending = pending.length === 0 ? chunk : Buffer.concat([pending, chunk]);
78
+ while (true) {
79
+ if (!started) {
80
+ if (pending.length < 8 || pending.length < pending.readInt32BE(0))
81
+ return statements;
82
+ const code = pending.readInt32BE(4);
83
+ started = code !== SSL_REQUEST && code !== GSS_REQUEST;
84
+ pending = pending.subarray(pending.readInt32BE(0));
85
+ continue;
86
+ }
87
+ if (pending.length < 5 || pending.length < 1 + pending.readInt32BE(1))
88
+ return statements;
89
+ if (pending[0] === SYNC || pending[0] === QUERY)
90
+ statements += 1;
91
+ pending = pending.subarray(1 + pending.readInt32BE(1));
92
+ }
93
+ };
94
+ };
95
+ /**
96
+ * What one external command to a warm activation costs across every pool,
97
+ * derived from the turn's two groups rather than measured. The admission
98
+ * flight sends `BEGIN`, the timeout `set_config`, and the fenced read that
99
+ * resolves the receipt. A command that runs its handler and dirties one key
100
+ * then sends the state upsert, the receipt insert, `COMMIT`, and the read of
101
+ * the commit version and the clock its expiry recheck uses: 2 flights and 7
102
+ * statements. A replay sends `ROLLBACK` and that same read instead: 2 flights
103
+ * and 5 statements. Nothing is read before delivery or after the turn.
104
+ */
105
+ export const SERVED_COMMAND = {
106
+ warm: { flights: 2, statements: 7 },
107
+ replay: { flights: 2, statements: 5 },
108
+ };
@@ -0,0 +1,7 @@
1
+ import { Layer } from "effect";
2
+ import type { ConformanceCase, ConformanceSuite } from "../conformance.ts";
3
+ export declare const streamsLayer: Layer.Layer<never, never, import("../index.ts").InternalActors>;
4
+ /** Stream cases: follows from a cursor have no gap or repeat, refuse unknown cursors, and complete when the handler's stream ends. */
5
+ export declare const streamsConformance: ReadonlyArray<ConformanceCase>;
6
+ /** The stream actor. */
7
+ export declare const streamsSuite: ConformanceSuite;
@@ -0,0 +1,280 @@
1
+ import { Cause, Effect, Exit, Fiber, Layer, Option, Schema, Scope, Stream } from "effect";
2
+ import { Actor } from "../../index.js";
3
+ import { ActorError, RunnerAtCapacity, SessionEnded, Unauthorized } from "../../errors/actor.js";
4
+ import { RetentionGap, UnknownCursor } from "../../errors/events.js";
5
+ import { ActorTest } from "../actor-test.js";
6
+ import { ActorCluster } from "../cluster.js";
7
+ const Noted = Actor.event("Noted", { text: Schema.String });
8
+ class Entry extends Schema.TaggedClass()("Entry", {
9
+ cursor: Schema.String,
10
+ text: Schema.String,
11
+ }) {
12
+ }
13
+ const Note = Actor.command("Note", { payload: Schema.String });
14
+ /** Committed notes after `after`, then each new one as it commits. */
15
+ const Notes = Actor.stream("Notes", {
16
+ payload: Schema.Struct({ after: Schema.optional(Schema.String) }),
17
+ success: Entry,
18
+ error: Schema.Union([UnknownCursor, RetentionGap]),
19
+ });
20
+ /** Emits `count` elements, then ends by itself. */
21
+ const Count = Actor.stream("Count", { payload: Schema.Finite, success: Schema.Finite });
22
+ /** Emits forever, as fast as the subscriber takes it. */
23
+ const Flood = Actor.stream("Flood", { success: Schema.Finite });
24
+ const Journal = Actor.make("StreamJournal", {
25
+ key: Schema.String,
26
+ events: [Noted],
27
+ api: { Note, Notes, Count, Flood },
28
+ policy: { hibernateAfter: "1 second" },
29
+ });
30
+ export const streamsLayer = Journal.toLayer(Effect.succeed({
31
+ Note: Effect.fnUntraced(function* (text) {
32
+ const turn = yield* Journal.Turn;
33
+ yield* turn.emit(Noted.make({ text }));
34
+ }),
35
+ Notes: ({ after }) => Stream.unwrap(Effect.gen(function* () {
36
+ const read = yield* Journal.Read;
37
+ return read
38
+ .follow(Noted, { after })
39
+ .pipe(Stream.map((entry) => Entry.make({ cursor: entry.cursor, text: entry.event.text })));
40
+ })),
41
+ Count: (count) => Stream.range(1, count),
42
+ Flood: () => Stream.iterate(0, (index) => index + 1),
43
+ }));
44
+ const WAIT = "20 seconds";
45
+ const take = (stream, count) => stream.pipe(Stream.take(count), Stream.runCollect, Effect.map((chunk) => [...chunk]), Effect.timeoutOrElse({
46
+ duration: WAIT,
47
+ orElse: () => Effect.die(new Error("No stream element arrived")),
48
+ }));
49
+ /** The error a subscription ended with, after draining it. */
50
+ const endOf = (stream) => stream.pipe(Stream.runDrain, Effect.exit, Effect.timeoutOrElse({
51
+ duration: WAIT,
52
+ orElse: () => Effect.die(new Error("The stream did not end")),
53
+ }), Effect.map((exit) => Exit.isFailure(exit) ? Option.getOrUndefined(Cause.findErrorOption(exit.cause)) : undefined));
54
+ const reasonOf = (error) => Schema.is(ActorError)(error) ? error.reason : undefined;
55
+ /** A running subscription whose elements arrive in order on `next`. */
56
+ const open = (stream) => Effect.gen(function* () {
57
+ const pull = yield* Stream.toPull(stream);
58
+ return {
59
+ next: pull.pipe(Effect.map((chunk) => [...chunk]), Effect.timeoutOrElse({
60
+ duration: WAIT,
61
+ orElse: () => Effect.die(new Error("No stream element arrived")),
62
+ })),
63
+ };
64
+ });
65
+ /** Reads `count` elements from a pull, however they are chunked. */
66
+ const read = (pull, count) => Effect.gen(function* () {
67
+ const read = [];
68
+ while (read.length < count)
69
+ read.push(...(yield* pull.next));
70
+ return read;
71
+ });
72
+ const texts = (entries) => entries.map((entry) => entry.text);
73
+ const EXPIRATION_SECONDS = 3;
74
+ const withCluster = (environment, runners, body) => environment.run(Effect.gen(function* () {
75
+ const database = yield* environment.freshDatabase;
76
+ const context = yield* Layer.build(ActorTest.cluster({
77
+ database,
78
+ runners,
79
+ shardLockExpiration: `${EXPIRATION_SECONDS} seconds`,
80
+ actors: streamsLayer,
81
+ }));
82
+ return yield* body.pipe(Effect.scoped, Effect.provideContext(context));
83
+ }));
84
+ /** An actor id that `runner` owns, probed through runner 0. */
85
+ const ownedBy = (runner, prefix) => Effect.gen(function* () {
86
+ const cluster = yield* ActorCluster;
87
+ for (let index = 0; index < 200; index++) {
88
+ const candidate = (yield* cluster.on(0)(Journal.get(`${prefix}-${index}`))).ref;
89
+ if ((yield* cluster.owner(candidate)) === runner)
90
+ return candidate;
91
+ }
92
+ return yield* Effect.die(new Error(`Runner ${runner} owns no probed actor`));
93
+ });
94
+ /** Stream cases: follows from a cursor have no gap or repeat, refuse unknown cursors, and complete when the handler's stream ends. */
95
+ export const streamsConformance = [
96
+ {
97
+ name: "follows events from a cursor with no gap or repeat between replay and live",
98
+ run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
99
+ const journal = yield* Journal.get("streams-follow");
100
+ yield* journal.Note("one");
101
+ yield* journal.Note("two");
102
+ yield* journal.Note("three");
103
+ const [first] = yield* take(journal.Notes({}), 1);
104
+ expect(first?.text).toBe("one");
105
+ const pull = yield* open(journal.Notes({ after: first.cursor }));
106
+ const replayed = yield* read(pull, 2);
107
+ const writer = yield* Effect.forEach(["four", "five", "six"], journal.Note, {
108
+ discard: true,
109
+ }).pipe(Effect.forkChild);
110
+ const live = yield* read(pull, 3);
111
+ yield* Fiber.join(writer);
112
+ const entries = [...replayed, ...live];
113
+ expect(texts(entries)).toEqual(["two", "three", "four", "five", "six"]);
114
+ const cursors = entries.map((entry) => BigInt(entry.cursor));
115
+ expect(cursors.every((cursor, index) => index === 0 || cursor > cursors[index - 1])).toBe(true);
116
+ })),
117
+ },
118
+ {
119
+ name: "fails a follow from a cursor the actor never issued with its declared UnknownCursor",
120
+ run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
121
+ const journal = yield* Journal.get("streams-unknown");
122
+ yield* journal.Note("one");
123
+ expect(yield* endOf(journal.Notes({ after: "99" }))).toMatchObject(UnknownCursor.make({ cursor: "99" }));
124
+ })),
125
+ },
126
+ {
127
+ name: "completes a subscription whose handler's stream ends by itself",
128
+ run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
129
+ const journal = yield* Journal.get("streams-count");
130
+ const counted = yield* journal.Count(3).pipe(Stream.runCollect, Effect.timeout(WAIT));
131
+ expect([...counted]).toEqual([1, 2, 3]);
132
+ })),
133
+ },
134
+ {
135
+ name: "ends a stream with ActivationEnded when its activation stops, and keeps the activation resident while subscribed",
136
+ run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
137
+ const test = yield* ActorTest;
138
+ const journal = yield* Journal.get("streams-resident");
139
+ yield* journal.Note("one");
140
+ const seen = [];
141
+ const ending = yield* journal.Notes({}).pipe(Stream.tap((entry) => Effect.sync(() => seen.push(entry))), endOf, Effect.forkChild);
142
+ yield* Effect.sleep("100 millis").pipe(Effect.repeat({ until: () => seen.length === 1 }), Effect.timeout(WAIT));
143
+ const generation = (yield* test.inspect(journal.ref)).generation;
144
+ yield* Effect.sleep("3500 millis");
145
+ yield* journal.Note("two");
146
+ yield* Effect.sleep("100 millis").pipe(Effect.repeat({ until: () => seen.length === 2 }), Effect.timeout(WAIT));
147
+ expect((yield* test.inspect(journal.ref)).generation).toBe(generation);
148
+ yield* test.hibernate(journal.ref);
149
+ const reason = reasonOf(yield* Fiber.join(ending));
150
+ expect(Schema.is(SessionEnded)(reason)).toBe(true);
151
+ expect(reason).toMatchObject({ cause: "ActivationEnded", resync: false });
152
+ expect(Schema.is(SessionEnded)(reason) && reason.isRetryable).toBe(true);
153
+ yield* journal.Note("three");
154
+ const [resumed] = yield* take(journal.Notes({ after: seen.at(-1).cursor }), 1);
155
+ expect(resumed?.text).toBe("three");
156
+ })),
157
+ },
158
+ {
159
+ name: "rejects a subscription its caller may not open, and ends one whose reauthorization is denied",
160
+ run: ({ expect, environment, access }) => environment.run(Effect.gen(function* () {
161
+ const test = yield* ActorTest;
162
+ const journal = yield* Journal.get("streams-revoked");
163
+ access.allowed = false;
164
+ const refused = yield* endOf(journal.Count(1)).pipe(Effect.ensuring(Effect.sync(() => (access.allowed = true))));
165
+ expect(reasonOf(refused)).toMatchObject(Unauthorized.make({ code: "access_denied" }));
166
+ const pull = yield* open(journal.Flood());
167
+ yield* read(pull, 1);
168
+ access.allowed = false;
169
+ yield* test.advance("55 seconds");
170
+ const revoked = yield* Effect.gen(function* () {
171
+ for (;;)
172
+ yield* pull.next;
173
+ }).pipe(Effect.flip, Effect.timeout(WAIT), Effect.ensuring(Effect.sync(() => (access.allowed = true))));
174
+ expect(revoked).toMatchObject({ reason: Unauthorized.make({ code: "access_denied" }) });
175
+ })),
176
+ },
177
+ {
178
+ name: "ends a subscription with reauthorization_unavailable at its bound",
179
+ run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
180
+ const test = yield* ActorTest;
181
+ const journal = yield* Journal.get("streams-bound");
182
+ const pull = yield* open(journal.Notes({}));
183
+ yield* journal.Note("one");
184
+ yield* read(pull, 1);
185
+ yield* test.advance("61 seconds");
186
+ const lapsed = yield* Effect.gen(function* () {
187
+ for (;;)
188
+ yield* pull.next;
189
+ }).pipe(Effect.flip, Effect.timeout(WAIT));
190
+ expect(lapsed).toMatchObject({
191
+ reason: Unauthorized.make({ code: "reauthorization_unavailable" }),
192
+ });
193
+ })),
194
+ },
195
+ {
196
+ name: "ends a stream with SlowConsumer after its window stays full for 30 seconds",
197
+ run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
198
+ const test = yield* ActorTest;
199
+ const journal = yield* Journal.get("streams-slow");
200
+ const pull = yield* open(journal.Flood());
201
+ yield* read(pull, 1);
202
+ yield* Effect.sleep("1 second");
203
+ yield* test.advance("31 seconds");
204
+ yield* Effect.sleep("500 millis");
205
+ const slow = yield* Effect.gen(function* () {
206
+ for (;;)
207
+ yield* pull.next;
208
+ }).pipe(Effect.flip, Effect.timeout(WAIT));
209
+ expect(reasonOf(slow)).toMatchObject({ cause: "SlowConsumer", resync: true });
210
+ })),
211
+ },
212
+ {
213
+ name: "refuses a subscription past 256 open on one actor with RunnerAtCapacity",
214
+ timeoutMs: 60_000,
215
+ run: ({ expect, environment }) => environment.run(Effect.gen(function* () {
216
+ const journal = yield* Journal.get("streams-limit");
217
+ const opened = yield* Effect.forEach(Array.from({ length: 260 }), () => Effect.flatMap(open(journal.Flood()), (pull) => read(pull, 1)).pipe(Effect.exit), { concurrency: "unbounded" });
218
+ const refused = opened.filter(Exit.isFailure);
219
+ expect(opened.filter(Exit.isSuccess).length).toBe(256);
220
+ expect(refused.length).toBe(4);
221
+ expect(refused.map((exit) => reasonOf(Option.getOrUndefined(Cause.findErrorOption(exit.cause))))).toEqual(Array.from({ length: 4 }, () => RunnerAtCapacity.make({})));
222
+ expect(reasonOf(yield* endOf(journal.Count(1)))).toMatchObject(RunnerAtCapacity.make({}));
223
+ })),
224
+ },
225
+ {
226
+ name: "delivers a stream from an owner on another runner and ends it with ActivationEnded when that runner is killed",
227
+ requiresFreshDatabase: true,
228
+ requiresIndependentConnections: true,
229
+ timeoutMs: 90_000,
230
+ run: ({ expect, environment }) => withCluster(environment, 2, Effect.gen(function* () {
231
+ const cluster = yield* ActorCluster;
232
+ yield* cluster.ready;
233
+ const ref = yield* ownedBy(1, "streams-kill");
234
+ const journal = yield* cluster.on(0)(Journal.get(ref.id));
235
+ const pull = yield* journal.Notes({}).pipe(open, cluster.on(0));
236
+ yield* cluster.on(0)(journal.Note("before"));
237
+ const [before] = yield* read(pull, 1);
238
+ expect(before?.text).toBe("before");
239
+ yield* cluster.kill(1);
240
+ const lost = yield* Effect.gen(function* () {
241
+ for (;;)
242
+ yield* pull.next;
243
+ }).pipe(Effect.flip, Effect.timeout(WAIT));
244
+ expect(reasonOf(lost)).toMatchObject({ cause: "ActivationEnded" });
245
+ yield* cluster.on(0)(journal.Note("after"));
246
+ const [after] = yield* cluster.on(0)(take(journal.Notes({ after: before.cursor }), 1));
247
+ expect(after?.text).toBe("after");
248
+ expect(yield* cluster.owner(ref)).toBe(0);
249
+ })),
250
+ },
251
+ {
252
+ name: "keeps cursor order in a followed stream written through turns on different runners over time",
253
+ requiresFreshDatabase: true,
254
+ requiresIndependentConnections: true,
255
+ timeoutMs: 120_000,
256
+ run: ({ expect, environment }) => withCluster(environment, 3, Effect.gen(function* () {
257
+ const cluster = yield* ActorCluster;
258
+ yield* cluster.ready;
259
+ const ref = yield* ownedBy(1, "streams-order");
260
+ const written = [];
261
+ const note = (via) => (text) => Effect.andThen(cluster.on(via)(Journal.get(ref.id).pipe(Effect.flatMap((j) => j.Note(text)))), Effect.sync(() => written.push(text)));
262
+ yield* Effect.forEach(["a1", "a2", "a3"], note(0), { discard: true });
263
+ yield* cluster.kill(1);
264
+ yield* Effect.forEach(["b1", "b2", "b3"], note(0), { discard: true });
265
+ const second = (yield* cluster.owner(ref));
266
+ const survivor = second === 0 ? 2 : 0;
267
+ yield* cluster.kill(second);
268
+ yield* Effect.forEach(["c1", "c2", "c3"], note(survivor), { discard: true });
269
+ expect(yield* cluster.owner(ref)).toBe(survivor);
270
+ const followed = yield* cluster.on(survivor)(Journal.get(ref.id).pipe(Effect.flatMap((j) => take(j.Notes({}), written.length))));
271
+ expect(texts(followed)).toEqual(written);
272
+ const cursors = followed.map((entry) => BigInt(entry.cursor));
273
+ expect(cursors).toEqual(cursors.map((_, index) => BigInt(index + 1)));
274
+ })),
275
+ },
276
+ ];
277
+ /** The stream actor. */
278
+ export const streamsSuite = {
279
+ layer: () => streamsLayer,
280
+ };
@@ -0,0 +1,4 @@
1
+ import type { ConformanceCase } from "../../conformance.ts";
2
+ import { type SubscriptionsFixture } from "./actors.ts";
3
+ /** Tenant isolation, System attribution, and handler access of event subscriptions. */
4
+ export declare const subscriptionAccessConformance: ReadonlyArray<ConformanceCase<SubscriptionsFixture>>;
@@ -0,0 +1,98 @@
1
+ import { Cause, Effect, Exit } from "effect";
2
+ import { Tenant } from "../../../index.js";
3
+ import { System } from "../../../identity/caller.js";
4
+ import { ActorTest } from "../../actor-test.js";
5
+ import { OrderDelivery, SubFollower, SubOrder, THROWING_ROUTE, } from "./actors.js";
6
+ import { drain, followerLog, handlerRuns, logOf, run, sourceRows } from "./harness.js";
7
+ import { CLAIM_LEASE } from "../outbox.js";
8
+ /** Tenant isolation, System attribution, and handler access of event subscriptions. */
9
+ export const subscriptionAccessConformance = [
10
+ {
11
+ name: "backs a routed row off with last_error when route throws, and holds its later events",
12
+ run: ({ expect, environment, fixture }) => run(environment, fixture, Effect.gen(function* () {
13
+ const test = yield* ActorTest;
14
+ const order = yield* SubOrder.get("throwroute-order");
15
+ yield* order.Place({ customerId: THROWING_ROUTE, amount: 1 });
16
+ yield* order.Place({ customerId: "throwroute-ok", amount: 1 });
17
+ yield* drain;
18
+ const [summary] = yield* sourceRows("throwroute-order", "SubSummary");
19
+ expect(summary.delivered).toBe("0");
20
+ expect(summary.last_error).toContain("Route failed");
21
+ expect(summary.last_error).toContain("route threw");
22
+ expect(yield* logOf("SubSummary", "throwroute-ok")).toEqual([]);
23
+ yield* test.advance(CLAIM_LEASE);
24
+ expect(yield* logOf("SubSummary", "throwroute-ok")).toEqual([]);
25
+ expect(yield* logOf("SubAuditor", "throwroute-ok")).toEqual([
26
+ "throwroute-order#2:OrderPlaced",
27
+ ]);
28
+ })),
29
+ },
30
+ {
31
+ name: "keeps equal source ids in two tenants apart",
32
+ run: ({ expect, environment, fixture }) => run(environment, fixture, Effect.gen(function* () {
33
+ const test = yield* ActorTest;
34
+ yield* (yield* SubFollower.get("tenant-follower")).Follow({ source: "tenant-order" });
35
+ yield* drain;
36
+ const other = `${test.tenant}-other`;
37
+ yield* Effect.gen(function* () {
38
+ yield* (yield* SubOrder.get("tenant-order")).Place({
39
+ customerId: "tenant-c",
40
+ amount: 1,
41
+ });
42
+ }).pipe(Effect.provideService(Tenant, other));
43
+ yield* drain;
44
+ expect(yield* followerLog("tenant-follower")).toEqual([]);
45
+ const { state } = yield* test.inspect({
46
+ tenant: other,
47
+ actor: "SubSummary",
48
+ id: "tenant-c",
49
+ });
50
+ expect(state).toEqual({ log: ["tenant-order#1:OrderPlaced"] });
51
+ yield* (yield* SubOrder.get("tenant-order")).Place({ customerId: "tenant-c", amount: 2 });
52
+ yield* drain;
53
+ expect(yield* followerLog("tenant-follower")).toEqual(["tenant-order#1:OrderPlaced"]);
54
+ })),
55
+ },
56
+ {
57
+ name: "dies when a non-subscription System caller reaches a handler, and hides handlers from X.intents",
58
+ run: ({ expect, environment, fixture }) => run(environment, fixture, Effect.gen(function* () {
59
+ const test = yield* ActorTest;
60
+ const { system } = yield* test.actor(SubFollower, "forged-follower");
61
+ const forged = yield* system
62
+ .OnOrder(OrderDelivery.members[2].make({
63
+ subscription: "FollowedOrders",
64
+ source: { tenant: test.tenant, actor: "SubOrder", id: "forged" },
65
+ reason: "UnknownCursor",
66
+ cursor: "1",
67
+ }))
68
+ .pipe(Effect.exit);
69
+ expect(Exit.isFailure(forged) &&
70
+ Cause.pretty(forged.cause).includes("Subscription handlers accept only subscription deliveries")).toBe(true);
71
+ expect(handlerRuns(fixture, "SubFollower/forged-follower")).toBe(0);
72
+ expect(yield* (yield* SubFollower.get("forged-follower")).IntentKeys()).toEqual([
73
+ "Follow",
74
+ "FollowJournal",
75
+ "FollowThenRefuse",
76
+ "IntentKeys",
77
+ "Touch",
78
+ "Unfollow",
79
+ ]);
80
+ })),
81
+ },
82
+ {
83
+ name: "records System subscription attribution on the delivery, and continues after the subscribing caller's access is revoked",
84
+ run: ({ expect, environment, fixture, access }) => run(environment, fixture, Effect.gen(function* () {
85
+ const test = yield* ActorTest;
86
+ yield* (yield* SubFollower.get("revoked-follower")).Follow({ source: "revoked-order" });
87
+ yield* drain;
88
+ yield* (yield* SubOrder.get("revoked-order")).Place({ customerId: "v", amount: 1 });
89
+ access.allowed = false;
90
+ yield* drain.pipe(Effect.ensuring(Effect.sync(() => (access.allowed = true))));
91
+ expect(yield* followerLog("revoked-follower")).toEqual(["revoked-order#1:OrderPlaced"]);
92
+ expect(fixture.callers.get("revoked-order#1:OrderPlaced")).toEqual(System.make({
93
+ source: "subscription",
94
+ ref: { tenant: test.tenant, actor: "SubOrder", id: "revoked-order" },
95
+ }));
96
+ })),
97
+ },
98
+ ];