@akterjs/effect 0.0.0-stage → 0.1.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 (798) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +43 -2
  3. package/dist/contract/actor/actor-already-exists.errors.d.mts +8 -0
  4. package/dist/contract/actor/actor-already-exists.errors.mjs +4 -0
  5. package/dist/contract/actor/actor-definition.pure.d.mts +21 -0
  6. package/dist/contract/actor/actor-definition.pure.mjs +106 -0
  7. package/dist/contract/actor/actor-erased.errors.d.mts +8 -0
  8. package/dist/contract/actor/actor-erased.errors.mjs +4 -0
  9. package/dist/contract/actor/actor-names.pure.d.mts +11 -0
  10. package/dist/contract/actor/actor-names.pure.mjs +51 -0
  11. package/dist/contract/actor/actor-not-created.errors.d.mts +8 -0
  12. package/dist/contract/actor/actor-not-created.errors.mjs +4 -0
  13. package/dist/contract/actor/actor-not-registered.errors.d.mts +8 -0
  14. package/dist/contract/actor/actor-not-registered.errors.mjs +4 -0
  15. package/dist/contract/actor/actor-registry.service.d.mts +16 -0
  16. package/dist/contract/actor/actor-registry.service.mjs +21 -0
  17. package/dist/contract/actor/actor.contract.d.mts +238 -0
  18. package/dist/contract/actor/actor.contract.mjs +1 -0
  19. package/dist/contract/actor/host-interface.pure.d.mts +23 -0
  20. package/dist/contract/actor/host-interface.pure.mjs +39 -0
  21. package/dist/contract/actor/reserved-member.errors.d.mts +9 -0
  22. package/dist/contract/actor/reserved-member.errors.mjs +7 -0
  23. package/dist/contract/akter.service.d.mts +75 -0
  24. package/dist/contract/akter.service.mjs +134 -0
  25. package/dist/contract/caller/authentication.api.d.mts +6 -0
  26. package/dist/contract/caller/authentication.api.mjs +5 -0
  27. package/dist/contract/caller/caller-admission.pure.d.mts +27 -0
  28. package/dist/contract/caller/caller-admission.pure.mjs +59 -0
  29. package/dist/contract/caller/caller-not-allowed.errors.d.mts +16 -0
  30. package/dist/contract/caller/caller-not-allowed.errors.mjs +18 -0
  31. package/dist/contract/caller/caller.schema.d.mts +7 -0
  32. package/dist/contract/caller/caller.schema.mjs +8 -0
  33. package/dist/contract/caller/current-caller.service.d.mts +7 -0
  34. package/dist/contract/caller/current-caller.service.mjs +4 -0
  35. package/dist/contract/caller/principal.schema.d.mts +13 -0
  36. package/dist/contract/caller/principal.schema.mjs +10 -0
  37. package/dist/contract/caller/unauthenticated.errors.d.mts +8 -0
  38. package/dist/contract/caller/unauthenticated.errors.mjs +4 -0
  39. package/dist/contract/client/actor-client.adapter.d.mts +42 -0
  40. package/dist/contract/client/actor-client.adapter.mjs +90 -0
  41. package/dist/contract/client/actor-client.contract.d.mts +30 -0
  42. package/dist/contract/client/actor-client.contract.mjs +1 -0
  43. package/dist/contract/client/actor-rpc.contract.d.mts +33 -0
  44. package/dist/contract/client/actor-rpc.contract.mjs +16 -0
  45. package/dist/contract/client/actor-unavailable.errors.d.mts +9 -0
  46. package/dist/contract/client/actor-unavailable.errors.mjs +7 -0
  47. package/dist/contract/client/client-failure.contract.d.mts +28 -0
  48. package/dist/contract/client/client-failure.contract.mjs +28 -0
  49. package/dist/contract/client/invalid-request.errors.d.mts +9 -0
  50. package/dist/contract/client/invalid-request.errors.mjs +7 -0
  51. package/dist/contract/client/storage-limit.errors.d.mts +16 -0
  52. package/dist/contract/client/storage-limit.errors.mjs +14 -0
  53. package/dist/contract/command/command-id-expired.errors.d.mts +11 -0
  54. package/dist/contract/command/command-id-expired.errors.mjs +9 -0
  55. package/dist/contract/command/command-id.schema.d.mts +3 -0
  56. package/dist/contract/command/command-id.schema.mjs +4 -0
  57. package/dist/contract/command/command.contract.d.mts +117 -0
  58. package/dist/contract/command/command.contract.mjs +111 -0
  59. package/dist/contract/command/outbox-id.pure.d.mts +9 -0
  60. package/dist/contract/command/outbox-id.pure.mjs +14 -0
  61. package/dist/contract/command/outbox.schema.d.mts +9 -0
  62. package/dist/contract/command/outbox.schema.mjs +10 -0
  63. package/dist/contract/command/timer.schema.d.mts +20 -0
  64. package/dist/contract/command/timer.schema.mjs +14 -0
  65. package/dist/contract/computer/checkpoint-expired.errors.d.mts +12 -0
  66. package/dist/contract/computer/checkpoint-expired.errors.mjs +8 -0
  67. package/dist/contract/computer/computer-client-failure.contract.d.mts +16 -0
  68. package/dist/contract/computer/computer-client-failure.contract.mjs +1 -0
  69. package/dist/contract/computer/computer-client.adapter.d.mts +21 -0
  70. package/dist/contract/computer/computer-client.adapter.mjs +70 -0
  71. package/dist/contract/computer/computer-client.contract.d.mts +56 -0
  72. package/dist/contract/computer/computer-client.contract.mjs +1 -0
  73. package/dist/contract/computer/computer-held.errors.d.mts +13 -0
  74. package/dist/contract/computer/computer-held.errors.mjs +11 -0
  75. package/dist/contract/computer/computer-limit.errors.d.mts +15 -0
  76. package/dist/contract/computer/computer-limit.errors.mjs +13 -0
  77. package/dist/contract/computer/computer-lost.errors.d.mts +12 -0
  78. package/dist/contract/computer/computer-lost.errors.mjs +8 -0
  79. package/dist/contract/computer/computer-not-found.errors.d.mts +9 -0
  80. package/dist/contract/computer/computer-not-found.errors.mjs +5 -0
  81. package/dist/contract/computer/computer.schema.d.mts +122 -0
  82. package/dist/contract/computer/computer.schema.mjs +117 -0
  83. package/dist/contract/computer/computers-unavailable.errors.d.mts +9 -0
  84. package/dist/contract/computer/computers-unavailable.errors.mjs +5 -0
  85. package/dist/contract/computer/files/computer-files.schema.d.mts +28 -0
  86. package/dist/contract/computer/files/computer-files.schema.mjs +24 -0
  87. package/dist/contract/computer/rpc/computer-rpc.contract.d.mts +108 -0
  88. package/dist/contract/computer/rpc/computer-rpc.contract.mjs +117 -0
  89. package/dist/contract/computer/step/computer-step.contract.d.mts +21 -0
  90. package/dist/contract/computer/step/computer-step.contract.mjs +89 -0
  91. package/dist/contract/computer/step/computer-step.schema.d.mts +69 -0
  92. package/dist/contract/computer/step/computer-step.schema.mjs +71 -0
  93. package/dist/contract/computer/step/step-failure.schema.d.mts +13 -0
  94. package/dist/contract/computer/step/step-failure.schema.mjs +24 -0
  95. package/dist/contract/computer/step/step-not-found.errors.d.mts +9 -0
  96. package/dist/contract/computer/step/step-not-found.errors.mjs +5 -0
  97. package/dist/contract/description/published-contract.pure.d.mts +51 -0
  98. package/dist/contract/description/published-contract.pure.mjs +75 -0
  99. package/dist/contract/file/access/file-access-denied.errors.d.mts +11 -0
  100. package/dist/contract/file/access/file-access-denied.errors.mjs +9 -0
  101. package/dist/contract/file/access/file-access.contract.d.mts +35 -0
  102. package/dist/contract/file/access/file-access.contract.mjs +32 -0
  103. package/dist/contract/file/actor-files.contract.d.mts +50 -0
  104. package/dist/contract/file/actor-files.contract.mjs +1 -0
  105. package/dist/contract/file/blob-transfer.errors.d.mts +9 -0
  106. package/dist/contract/file/blob-transfer.errors.mjs +7 -0
  107. package/dist/contract/file/file-client-failure.contract.d.mts +24 -0
  108. package/dist/contract/file/file-client-failure.contract.mjs +1 -0
  109. package/dist/contract/file/file-client.adapter.d.mts +17 -0
  110. package/dist/contract/file/file-client.adapter.mjs +21 -0
  111. package/dist/contract/file/file-client.contract.d.mts +14 -0
  112. package/dist/contract/file/file-client.contract.mjs +1 -0
  113. package/dist/contract/file/file-listing.pure.d.mts +6 -0
  114. package/dist/contract/file/file-listing.pure.mjs +18 -0
  115. package/dist/contract/file/file-not-found.errors.d.mts +8 -0
  116. package/dist/contract/file/file-not-found.errors.mjs +4 -0
  117. package/dist/contract/file/file-path.pure.d.mts +4 -0
  118. package/dist/contract/file/file-path.pure.mjs +38 -0
  119. package/dist/contract/file/files-unavailable.errors.d.mts +8 -0
  120. package/dist/contract/file/files-unavailable.errors.mjs +4 -0
  121. package/dist/contract/file/invalid-file-request.errors.d.mts +9 -0
  122. package/dist/contract/file/invalid-file-request.errors.mjs +7 -0
  123. package/dist/contract/file/rpc/file-rpc.contract.d.mts +88 -0
  124. package/dist/contract/file/rpc/file-rpc.contract.mjs +117 -0
  125. package/dist/contract/file/rpc/file-too-large.errors.d.mts +13 -0
  126. package/dist/contract/file/rpc/file-too-large.errors.mjs +11 -0
  127. package/dist/contract/file/rpc/rpc-file-clients.layer.d.mts +10 -0
  128. package/dist/contract/file/rpc/rpc-file-clients.layer.mjs +95 -0
  129. package/dist/contract/fork/fork-rpc.contract.d.mts +40 -0
  130. package/dist/contract/fork/fork-rpc.contract.mjs +26 -0
  131. package/dist/contract/history/actor-journal.service.d.mts +58 -0
  132. package/dist/contract/history/actor-journal.service.mjs +67 -0
  133. package/dist/contract/history/history-entry.pure.d.mts +79 -0
  134. package/dist/contract/history/history-entry.pure.mjs +95 -0
  135. package/dist/contract/hosted/handler-failed.errors.d.mts +16 -0
  136. package/dist/contract/hosted/handler-failed.errors.mjs +14 -0
  137. package/dist/contract/hosted/handler-failure.pure.d.mts +21 -0
  138. package/dist/contract/hosted/handler-failure.pure.mjs +86 -0
  139. package/dist/contract/hosted/hosted-actor.service.d.mts +23 -0
  140. package/dist/contract/hosted/hosted-actor.service.mjs +64 -0
  141. package/dist/contract/hosted/hosted-command.service.d.mts +20 -0
  142. package/dist/contract/hosted/hosted-command.service.mjs +88 -0
  143. package/dist/contract/hosted/hosted-create.service.d.mts +17 -0
  144. package/dist/contract/hosted/hosted-create.service.mjs +67 -0
  145. package/dist/contract/hosted/hosted-error.contract.d.mts +11 -0
  146. package/dist/contract/hosted/hosted-error.contract.mjs +1 -0
  147. package/dist/contract/hosted/hosted-failure.schema.d.mts +18 -0
  148. package/dist/contract/hosted/hosted-failure.schema.mjs +31 -0
  149. package/dist/contract/hosted/hosted-outcome.contract.d.mts +18 -0
  150. package/dist/contract/hosted/hosted-outcome.contract.mjs +1 -0
  151. package/dist/contract/hosted/hosted-query.service.d.mts +16 -0
  152. package/dist/contract/hosted/hosted-query.service.mjs +42 -0
  153. package/dist/contract/hosted/hosted-request.pure.d.mts +61 -0
  154. package/dist/contract/hosted/hosted-request.pure.mjs +91 -0
  155. package/dist/contract/job/job-id.pure.d.mts +11 -0
  156. package/dist/contract/job/job-id.pure.mjs +20 -0
  157. package/dist/contract/job/job-patches.contract.d.mts +32 -0
  158. package/dist/contract/job/job-patches.contract.mjs +45 -0
  159. package/dist/contract/job/job-signal.schema.d.mts +13 -0
  160. package/dist/contract/job/job-signal.schema.mjs +16 -0
  161. package/dist/contract/job/reserved-payload-field.errors.d.mts +10 -0
  162. package/dist/contract/job/reserved-payload-field.errors.mjs +8 -0
  163. package/dist/contract/job/started-job.schema.d.mts +7 -0
  164. package/dist/contract/job/started-job.schema.mjs +8 -0
  165. package/dist/contract/json-codec.pure.d.mts +7 -0
  166. package/dist/contract/json-codec.pure.mjs +14 -0
  167. package/dist/contract/room.contract.d.mts +75 -0
  168. package/dist/contract/room.contract.mjs +36 -0
  169. package/dist/contract/secret/actor-secrets.adapter.d.mts +33 -0
  170. package/dist/contract/secret/actor-secrets.adapter.mjs +38 -0
  171. package/dist/contract/secret/invalid-secret-name.errors.d.mts +10 -0
  172. package/dist/contract/secret/invalid-secret-name.errors.mjs +8 -0
  173. package/dist/contract/secret/secret-unavailable.errors.d.mts +11 -0
  174. package/dist/contract/secret/secret-unavailable.errors.mjs +10 -0
  175. package/dist/contract/secret/secret.schema.d.mts +25 -0
  176. package/dist/contract/secret/secret.schema.mjs +34 -0
  177. package/dist/contract/spend/billing-unavailable.errors.d.mts +12 -0
  178. package/dist/contract/spend/billing-unavailable.errors.mjs +8 -0
  179. package/dist/contract/spend/spend-cap-reached.errors.d.mts +17 -0
  180. package/dist/contract/spend/spend-cap-reached.errors.mjs +15 -0
  181. package/dist/contract/state/actor-state.pure.d.mts +38 -0
  182. package/dist/contract/state/actor-state.pure.mjs +153 -0
  183. package/dist/contract/state/actor-state.service.d.mts +45 -0
  184. package/dist/contract/state/actor-state.service.mjs +18 -0
  185. package/dist/contract/state/state-migration.pure.d.mts +11 -0
  186. package/dist/contract/state/state-migration.pure.mjs +23 -0
  187. package/dist/contract/state/state-read.pure.d.mts +12 -0
  188. package/dist/contract/state/state-read.pure.mjs +22 -0
  189. package/dist/contract/state/state-unreadable.errors.d.mts +9 -0
  190. package/dist/contract/state/state-unreadable.errors.mjs +7 -0
  191. package/dist/host/actor/actor-database.service.d.mts +46 -0
  192. package/dist/host/actor/actor-database.service.mjs +112 -0
  193. package/dist/host/actor/actor-exclusive.pure.d.mts +7 -0
  194. package/dist/host/actor/actor-exclusive.pure.mjs +16 -0
  195. package/dist/host/actor/actor-records.sql.d.mts +29 -0
  196. package/dist/host/actor/actor-records.sql.mjs +26 -0
  197. package/dist/host/actor/reserved-name.errors.d.mts +10 -0
  198. package/dist/host/actor/reserved-name.errors.mjs +8 -0
  199. package/dist/host/actor/reserved-names.pure.d.mts +15 -0
  200. package/dist/host/actor/reserved-names.pure.mjs +20 -0
  201. package/dist/host/actor/room.actor.d.mts +4 -0
  202. package/dist/host/actor/room.actor.mjs +36 -0
  203. package/dist/host/blob/blob-frames.pure.d.mts +7 -0
  204. package/dist/host/blob/blob-frames.pure.mjs +28 -0
  205. package/dist/host/blob/blob-grant.schema.d.mts +14 -0
  206. package/dist/host/blob/blob-grant.schema.mjs +15 -0
  207. package/dist/host/blob/blob-grants.service.d.mts +28 -0
  208. package/dist/host/blob/blob-grants.service.mjs +129 -0
  209. package/dist/host/blob/blob-keyring.service.d.mts +18 -0
  210. package/dist/host/blob/blob-keyring.service.mjs +4 -0
  211. package/dist/host/blob/blob-range.pure.d.mts +13 -0
  212. package/dist/host/blob/blob-range.pure.mjs +23 -0
  213. package/dist/host/blob/blob-sealing.contract.d.mts +37 -0
  214. package/dist/host/blob/blob-sealing.contract.mjs +1 -0
  215. package/dist/host/blob/blob-sealing.service.d.mts +11 -0
  216. package/dist/host/blob/blob-sealing.service.mjs +16 -0
  217. package/dist/host/blob/export/blob-archive.sql.d.mts +21 -0
  218. package/dist/host/blob/export/blob-archive.sql.mjs +75 -0
  219. package/dist/host/blob/export/blob-export-holds.sql.d.mts +49 -0
  220. package/dist/host/blob/export/blob-export-holds.sql.mjs +25 -0
  221. package/dist/host/blob/plain-blob-sealing.pure.d.mts +5 -0
  222. package/dist/host/blob/plain-blob-sealing.pure.mjs +55 -0
  223. package/dist/host/blob/reference/blob-catalog.sql.d.mts +40 -0
  224. package/dist/host/blob/reference/blob-catalog.sql.mjs +145 -0
  225. package/dist/host/blob/reference/blob-coordinator.pure.d.mts +10 -0
  226. package/dist/host/blob/reference/blob-coordinator.pure.mjs +153 -0
  227. package/dist/host/blob/reference/blob-file-page.sql.d.mts +13 -0
  228. package/dist/host/blob/reference/blob-file-page.sql.mjs +21 -0
  229. package/dist/host/blob/reference/blob-forks.sql.d.mts +21 -0
  230. package/dist/host/blob/reference/blob-forks.sql.mjs +40 -0
  231. package/dist/host/blob/reference/blob-lineage.sql.d.mts +14 -0
  232. package/dist/host/blob/reference/blob-lineage.sql.mjs +24 -0
  233. package/dist/host/blob/reference/blob-reads.pure.d.mts +15 -0
  234. package/dist/host/blob/reference/blob-reads.pure.mjs +97 -0
  235. package/dist/host/blob/reference/blob-receipts.sql.d.mts +71 -0
  236. package/dist/host/blob/reference/blob-receipts.sql.mjs +176 -0
  237. package/dist/host/blob/reference/blob-transfer-adopt.pure.d.mts +21 -0
  238. package/dist/host/blob/reference/blob-transfer-adopt.pure.mjs +68 -0
  239. package/dist/host/blob/reference/blob-transfer-fork.pure.d.mts +15 -0
  240. package/dist/host/blob/reference/blob-transfer-fork.pure.mjs +125 -0
  241. package/dist/host/blob/reference/blob-transfer-upkeep.pure.d.mts +18 -0
  242. package/dist/host/blob/reference/blob-transfer-upkeep.pure.mjs +54 -0
  243. package/dist/host/blob/reference/blob-transfer.pure.d.mts +85 -0
  244. package/dist/host/blob/reference/blob-transfer.pure.mjs +1 -0
  245. package/dist/host/blob/sealed-blob-sealing.pure.d.mts +10 -0
  246. package/dist/host/blob/sealed-blob-sealing.pure.mjs +130 -0
  247. package/dist/host/blob/stream/blob-directory.pure.d.mts +18 -0
  248. package/dist/host/blob/stream/blob-directory.pure.mjs +84 -0
  249. package/dist/host/blob/stream/blob-length.pure.d.mts +9 -0
  250. package/dist/host/blob/stream/blob-length.pure.mjs +19 -0
  251. package/dist/host/blob/stream/blob-writing.pure.d.mts +8 -0
  252. package/dist/host/blob/stream/blob-writing.pure.mjs +15 -0
  253. package/dist/host/command/batch/command-batch.sql.d.mts +61 -0
  254. package/dist/host/command/batch/command-batch.sql.mjs +100 -0
  255. package/dist/host/command/command-context.adapter.d.mts +47 -0
  256. package/dist/host/command/command-context.adapter.mjs +90 -0
  257. package/dist/host/command/command-id-age.pure.d.mts +13 -0
  258. package/dist/host/command/command-id-age.pure.mjs +31 -0
  259. package/dist/host/command/command-id-reuse.pure.d.mts +28 -0
  260. package/dist/host/command/command-id-reuse.pure.mjs +38 -0
  261. package/dist/host/command/command-id-reused.errors.d.mts +13 -0
  262. package/dist/host/command/command-id-reused.errors.mjs +11 -0
  263. package/dist/host/command/command-journal.sql.d.mts +84 -0
  264. package/dist/host/command/command-journal.sql.mjs +74 -0
  265. package/dist/host/command/command-rejected.errors.d.mts +8 -0
  266. package/dist/host/command/command-rejected.errors.mjs +4 -0
  267. package/dist/host/command/command-replay.service.d.mts +62 -0
  268. package/dist/host/command/command-replay.service.mjs +140 -0
  269. package/dist/host/command/command-reply.pure.d.mts +8 -0
  270. package/dist/host/command/command-reply.pure.mjs +12 -0
  271. package/dist/host/command/command-runner.service.d.mts +68 -0
  272. package/dist/host/command/command-runner.service.mjs +215 -0
  273. package/dist/host/command/files/command-file-inputs.sql.d.mts +51 -0
  274. package/dist/host/command/files/command-file-inputs.sql.mjs +59 -0
  275. package/dist/host/command/history-pruned.errors.d.mts +10 -0
  276. package/dist/host/command/history-pruned.errors.mjs +8 -0
  277. package/dist/host/command/replay/replay-cursor-stalled.errors.d.mts +9 -0
  278. package/dist/host/command/replay/replay-cursor-stalled.errors.mjs +7 -0
  279. package/dist/host/command/replay/replay-cursor.pure.d.mts +7 -0
  280. package/dist/host/command/replay/replay-cursor.pure.mjs +12 -0
  281. package/dist/host/computer/computer-steps.sql.d.mts +14 -0
  282. package/dist/host/computer/computer-steps.sql.mjs +76 -0
  283. package/dist/host/computer/job-computers.service.d.mts +20 -0
  284. package/dist/host/computer/job-computers.service.mjs +59 -0
  285. package/dist/host/computer/local-computer-files.layer.d.mts +11 -0
  286. package/dist/host/computer/local-computer-files.layer.mjs +69 -0
  287. package/dist/host/computer/local-computer-log.layer.d.mts +23 -0
  288. package/dist/host/computer/local-computer-log.layer.mjs +64 -0
  289. package/dist/host/computer/local-computer-records.layer.d.mts +190 -0
  290. package/dist/host/computer/local-computer-records.layer.mjs +99 -0
  291. package/dist/host/computer/local-computer.schema.d.mts +69 -0
  292. package/dist/host/computer/local-computer.schema.mjs +29 -0
  293. package/dist/host/computer/local-computers.adapter.d.mts +18 -0
  294. package/dist/host/computer/local-computers.adapter.mjs +248 -0
  295. package/dist/host/computer/local-step.layer.d.mts +30 -0
  296. package/dist/host/computer/local-step.layer.mjs +119 -0
  297. package/dist/host/file/actor-file-storage.sql.d.mts +15 -0
  298. package/dist/host/file/actor-file-storage.sql.mjs +82 -0
  299. package/dist/host/file/actor-files.sql.d.mts +9 -0
  300. package/dist/host/file/actor-files.sql.mjs +3 -0
  301. package/dist/host/file/blob-home-lock.pure.d.mts +8 -0
  302. package/dist/host/file/blob-home-lock.pure.mjs +10 -0
  303. package/dist/host/file/blob-home.sql.d.mts +19 -0
  304. package/dist/host/file/blob-home.sql.mjs +30 -0
  305. package/dist/host/file/local-blob-home.service.d.mts +16 -0
  306. package/dist/host/file/local-blob-home.service.mjs +43 -0
  307. package/dist/host/file/local-blob-owner.sql.d.mts +30 -0
  308. package/dist/host/file/local-blob-owner.sql.mjs +68 -0
  309. package/dist/host/file/local-file-upkeep.pure.d.mts +12 -0
  310. package/dist/host/file/local-file-upkeep.pure.mjs +41 -0
  311. package/dist/host/file/replay-file-storage.sql.d.mts +7 -0
  312. package/dist/host/file/replay-file-storage.sql.mjs +26 -0
  313. package/dist/host/fork/actor-fork.sql.d.mts +52 -0
  314. package/dist/host/fork/actor-fork.sql.mjs +42 -0
  315. package/dist/host/fork/fork-computers.adapter.d.mts +43 -0
  316. package/dist/host/fork/fork-computers.adapter.mjs +193 -0
  317. package/dist/host/hash/blob-hashing.service.d.mts +10 -0
  318. package/dist/host/hash/blob-hashing.service.mjs +4 -0
  319. package/dist/host/job/job-durables.sql.d.mts +44 -0
  320. package/dist/host/job/job-durables.sql.mjs +136 -0
  321. package/dist/host/job/job-engine.adapter.d.mts +33 -0
  322. package/dist/host/job/job-engine.adapter.mjs +258 -0
  323. package/dist/host/job/job-journal.sql.d.mts +85 -0
  324. package/dist/host/job/job-journal.sql.mjs +109 -0
  325. package/dist/host/job/job-results.service.d.mts +37 -0
  326. package/dist/host/job/job-results.service.mjs +63 -0
  327. package/dist/host/job/job-runs.pure.d.mts +103 -0
  328. package/dist/host/job/job-runs.pure.mjs +193 -0
  329. package/dist/host/job/undelivered-result.pure.d.mts +49 -0
  330. package/dist/host/job/undelivered-result.pure.mjs +147 -0
  331. package/dist/host/layout/actor-layout.sql.d.mts +8 -0
  332. package/dist/host/layout/actor-layout.sql.mjs +33 -0
  333. package/dist/host/layout/layout-version.errors.d.mts +10 -0
  334. package/dist/host/layout/layout-version.errors.mjs +8 -0
  335. package/dist/host/layout/layout-version.pure.d.mts +10 -0
  336. package/dist/host/layout/layout-version.pure.mjs +14 -0
  337. package/dist/host/migration/actor-migrations.service.d.mts +46 -0
  338. package/dist/host/migration/actor-migrations.service.mjs +143 -0
  339. package/dist/host/migration/migration-edited.errors.d.mts +9 -0
  340. package/dist/host/migration/migration-edited.errors.mjs +7 -0
  341. package/dist/host/migration/migration-failed.errors.d.mts +12 -0
  342. package/dist/host/migration/migration-failed.errors.mjs +10 -0
  343. package/dist/host/migration/migration-failure.pure.d.mts +9 -0
  344. package/dist/host/migration/migration-failure.pure.mjs +19 -0
  345. package/dist/host/migration/migration-hasher.adapter.d.mts +15 -0
  346. package/dist/host/migration/migration-hasher.adapter.mjs +40 -0
  347. package/dist/host/migration/migration-missing.errors.d.mts +9 -0
  348. package/dist/host/migration/migration-missing.errors.mjs +7 -0
  349. package/dist/host/migration/migration-plan.pure.d.mts +20 -0
  350. package/dist/host/migration/migration-plan.pure.mjs +32 -0
  351. package/dist/host/outbox/actor-outbox.sql.d.mts +33 -0
  352. package/dist/host/outbox/actor-outbox.sql.mjs +28 -0
  353. package/dist/host/outbox/outbox-acknowledgements.sql.d.mts +12 -0
  354. package/dist/host/outbox/outbox-acknowledgements.sql.mjs +47 -0
  355. package/dist/host/outbox/outbox-runner.service.d.mts +37 -0
  356. package/dist/host/outbox/outbox-runner.service.mjs +155 -0
  357. package/dist/host/query/query-policy.pure.d.mts +15 -0
  358. package/dist/host/query/query-policy.pure.mjs +12 -0
  359. package/dist/host/query/query-runner.service.d.mts +42 -0
  360. package/dist/host/query/query-runner.service.mjs +72 -0
  361. package/dist/host/sqlite/actor-connections.pure.d.mts +26 -0
  362. package/dist/host/sqlite/actor-connections.pure.mjs +4 -0
  363. package/dist/host/sqlite/sqlite-connection.adapter.d.mts +22 -0
  364. package/dist/host/sqlite/sqlite-connection.adapter.mjs +151 -0
  365. package/dist/host/sqlite/sqlite-driver.service.d.mts +33 -0
  366. package/dist/host/sqlite/sqlite-driver.service.mjs +88 -0
  367. package/dist/host/sqlite/sqlite-parameters.pure.d.mts +5 -0
  368. package/dist/host/sqlite/sqlite-parameters.pure.mjs +21 -0
  369. package/dist/host/sqlite/sqlite-reason.pure.d.mts +8 -0
  370. package/dist/host/sqlite/sqlite-reason.pure.mjs +13 -0
  371. package/dist/host/timer/actor-timers.sql.d.mts +32 -0
  372. package/dist/host/timer/actor-timers.sql.mjs +8 -0
  373. package/dist/host/timer/timer-runner.service.d.mts +26 -0
  374. package/dist/host/timer/timer-runner.service.mjs +68 -0
  375. package/dist/host/upkeep/actor-due.sql.d.mts +26 -0
  376. package/dist/host/upkeep/actor-due.sql.mjs +43 -0
  377. package/dist/host/upkeep/actor-upkeep.service.d.mts +55 -0
  378. package/dist/host/upkeep/actor-upkeep.service.mjs +218 -0
  379. package/dist/host/upkeep/execution-authority.pure.d.mts +19 -0
  380. package/dist/host/upkeep/execution-authority.pure.mjs +10 -0
  381. package/dist/runtime/akter-local.layer.d.mts +28 -0
  382. package/dist/runtime/akter-local.layer.mjs +24 -0
  383. package/dist/runtime/akter.layer.d.mts +91 -0
  384. package/dist/runtime/akter.layer.mjs +99 -0
  385. package/dist/runtime/blob-hashing.layer.d.mts +4 -0
  386. package/dist/runtime/blob-hashing.layer.mjs +15 -0
  387. package/dist/runtime/hosted-environment.layer.d.mts +34 -0
  388. package/dist/runtime/hosted-environment.layer.mjs +40 -0
  389. package/dist/runtime/http-server.layer.d.mts +9 -0
  390. package/dist/runtime/http-server.layer.mjs +15 -0
  391. package/dist/runtime/local-actor-engine.layer.d.mts +10 -0
  392. package/dist/runtime/local-actor-engine.layer.mjs +14 -0
  393. package/dist/runtime/local-engine.layer.d.mts +15 -0
  394. package/dist/runtime/local-engine.layer.mjs +14 -0
  395. package/dist/runtime/local-environments.layer.d.mts +24 -0
  396. package/dist/runtime/local-environments.layer.mjs +159 -0
  397. package/dist/runtime/local-file-clients.layer.d.mts +13 -0
  398. package/dist/runtime/local-file-clients.layer.mjs +78 -0
  399. package/dist/runtime/local-job-runtime.layer.d.mts +19 -0
  400. package/dist/runtime/local-job-runtime.layer.mjs +21 -0
  401. package/dist/serve/archive/archived-actors.layer.d.mts +17 -0
  402. package/dist/serve/archive/archived-actors.layer.mjs +84 -0
  403. package/dist/serve/archive/archived-store.layer.d.mts +12 -0
  404. package/dist/serve/archive/archived-store.layer.mjs +40 -0
  405. package/dist/serve/engine/actor-engine.layer.d.mts +8 -0
  406. package/dist/serve/engine/actor-engine.layer.mjs +30 -0
  407. package/dist/serve/engine/actor-fork.service.d.mts +63 -0
  408. package/dist/serve/engine/actor-fork.service.mjs +277 -0
  409. package/dist/serve/engine/actor-holding.pure.d.mts +7 -0
  410. package/dist/serve/engine/actor-holding.pure.mjs +9 -0
  411. package/dist/serve/engine/actor-host.service.d.mts +66 -0
  412. package/dist/serve/engine/actor-host.service.mjs +209 -0
  413. package/dist/serve/engine/actor-location.service.d.mts +38 -0
  414. package/dist/serve/engine/actor-location.service.mjs +109 -0
  415. package/dist/serve/engine/actor-residents.pure.d.mts +92 -0
  416. package/dist/serve/engine/actor-residents.pure.mjs +201 -0
  417. package/dist/serve/engine/actor-shard.pure.d.mts +4 -0
  418. package/dist/serve/engine/actor-shard.pure.mjs +8 -0
  419. package/dist/serve/engine/actor-state.pure.d.mts +17 -0
  420. package/dist/serve/engine/actor-state.pure.mjs +20 -0
  421. package/dist/serve/engine/actors-not-hosted.errors.d.mts +9 -0
  422. package/dist/serve/engine/actors-not-hosted.errors.mjs +7 -0
  423. package/dist/serve/engine/job-runtime.layer.d.mts +6 -0
  424. package/dist/serve/engine/job-runtime.layer.mjs +5 -0
  425. package/dist/serve/environment/environment-already-exists.errors.d.mts +10 -0
  426. package/dist/serve/environment/environment-already-exists.errors.mjs +9 -0
  427. package/dist/serve/environment/environment-in-use.errors.d.mts +10 -0
  428. package/dist/serve/environment/environment-in-use.errors.mjs +14 -0
  429. package/dist/serve/environment/environment-not-found.errors.d.mts +10 -0
  430. package/dist/serve/environment/environment-not-found.errors.mjs +9 -0
  431. package/dist/serve/environment/environment-records.sql.d.mts +92 -0
  432. package/dist/serve/environment/environment-records.sql.mjs +59 -0
  433. package/dist/serve/environment/environment-store.sql.d.mts +38 -0
  434. package/dist/serve/environment/environment-store.sql.mjs +78 -0
  435. package/dist/serve/environment/local-environment.schema.d.mts +38 -0
  436. package/dist/serve/environment/local-environment.schema.mjs +43 -0
  437. package/dist/serve/environment/local-environments.service.d.mts +44 -0
  438. package/dist/serve/environment/local-environments.service.mjs +196 -0
  439. package/dist/serve/environment/promotion-notice.pure.d.mts +22 -0
  440. package/dist/serve/environment/promotion-notice.pure.mjs +30 -0
  441. package/dist/serve/environment/snapshot-operations.sql.d.mts +32 -0
  442. package/dist/serve/environment/snapshot-operations.sql.mjs +131 -0
  443. package/dist/serve/environment/store-snapshot.sql.d.mts +32 -0
  444. package/dist/serve/environment/store-snapshot.sql.mjs +74 -0
  445. package/dist/serve/erasure/local-actor-erasure.service.d.mts +26 -0
  446. package/dist/serve/erasure/local-actor-erasure.service.mjs +102 -0
  447. package/dist/serve/history/actor-host-runners.service.d.mts +23 -0
  448. package/dist/serve/history/actor-host-runners.service.mjs +35 -0
  449. package/dist/serve/hosted/hosted-app-build.errors.d.mts +13 -0
  450. package/dist/serve/hosted/hosted-app-build.errors.mjs +9 -0
  451. package/dist/serve/hosted/hosted-app-checks.layer.d.mts +15 -0
  452. package/dist/serve/hosted/hosted-app-checks.layer.mjs +32 -0
  453. package/dist/serve/hosted/hosted-file-forward.layer.d.mts +22 -0
  454. package/dist/serve/hosted/hosted-file-forward.layer.mjs +42 -0
  455. package/dist/serve/hosted/hosted-file-rpcs.layer.d.mts +25 -0
  456. package/dist/serve/hosted/hosted-file-rpcs.layer.mjs +82 -0
  457. package/dist/serve/hosted/hosted-file-server.layer.d.mts +18 -0
  458. package/dist/serve/hosted/hosted-file-server.layer.mjs +33 -0
  459. package/dist/serve/hosted/hosted-files.layer.d.mts +32 -0
  460. package/dist/serve/hosted/hosted-files.layer.mjs +55 -0
  461. package/dist/serve/hosted/hosted-runtime.layer.d.mts +42 -0
  462. package/dist/serve/hosted/hosted-runtime.layer.mjs +48 -0
  463. package/dist/serve/hosted/hosted-runtime.service.d.mts +77 -0
  464. package/dist/serve/hosted/hosted-runtime.service.mjs +74 -0
  465. package/dist/serve/hosted/hosted-secrets.layer.d.mts +10 -0
  466. package/dist/serve/hosted/hosted-secrets.layer.mjs +28 -0
  467. package/dist/serve/http/loopback-host.pure.d.mts +11 -0
  468. package/dist/serve/http/loopback-host.pure.mjs +29 -0
  469. package/dist/serve/inspect/actor-inspection.schema.d.mts +119 -0
  470. package/dist/serve/inspect/actor-inspection.schema.mjs +75 -0
  471. package/dist/serve/inspect/actor-inspection.sql.d.mts +12 -0
  472. package/dist/serve/inspect/actor-inspection.sql.mjs +43 -0
  473. package/dist/serve/inspect/inspect.service.d.mts +24 -0
  474. package/dist/serve/inspect/inspect.service.mjs +92 -0
  475. package/dist/serve/inspect/inspector-page.pure.d.mts +2 -0
  476. package/dist/serve/inspect/inspector-page.pure.mjs +155 -0
  477. package/dist/serve/inspect/inspector-wal.pure.d.mts +3 -0
  478. package/dist/serve/inspect/inspector-wal.pure.mjs +19 -0
  479. package/dist/serve/inspect/inspector.handlers.d.mts +5 -0
  480. package/dist/serve/inspect/inspector.handlers.mjs +50 -0
  481. package/dist/serve/inspect/inspector.layer.d.mts +9 -0
  482. package/dist/serve/inspect/inspector.layer.mjs +14 -0
  483. package/dist/serve/live/live-reads.service.d.mts +44 -0
  484. package/dist/serve/live/live-reads.service.mjs +152 -0
  485. package/dist/serve/live/live-tables.sql.d.mts +35 -0
  486. package/dist/serve/live/live-tables.sql.mjs +66 -0
  487. package/dist/serve/live/state-reads.pure.d.mts +11 -0
  488. package/dist/serve/live/state-reads.pure.mjs +7 -0
  489. package/dist/serve/rpc/actor-rpc.handlers.d.mts +24 -0
  490. package/dist/serve/rpc/actor-rpc.handlers.mjs +142 -0
  491. package/dist/serve/rpc/akter-server.layer.d.mts +18 -0
  492. package/dist/serve/rpc/akter-server.layer.mjs +61 -0
  493. package/dist/serve/rpc/computer/computer-copy.layer.d.mts +22 -0
  494. package/dist/serve/rpc/computer/computer-copy.layer.mjs +70 -0
  495. package/dist/serve/rpc/computer/computer-rpc-access.pure.d.mts +29 -0
  496. package/dist/serve/rpc/computer/computer-rpc-access.pure.mjs +46 -0
  497. package/dist/serve/rpc/computer/computer-rpc.layer.d.mts +39 -0
  498. package/dist/serve/rpc/computer/computer-rpc.layer.mjs +84 -0
  499. package/dist/serve/rpc/computer/step-rpc.handlers.d.mts +23 -0
  500. package/dist/serve/rpc/computer/step-rpc.handlers.mjs +43 -0
  501. package/dist/serve/rpc/development-authentication.handlers.d.mts +7 -0
  502. package/dist/serve/rpc/development-authentication.handlers.mjs +19 -0
  503. package/dist/serve/rpc/development-guard.pure.d.mts +10 -0
  504. package/dist/serve/rpc/development-guard.pure.mjs +16 -0
  505. package/dist/serve/rpc/file/file-rpc-access.pure.d.mts +55 -0
  506. package/dist/serve/rpc/file/file-rpc-access.pure.mjs +67 -0
  507. package/dist/serve/rpc/file/file-rpc.layer.d.mts +53 -0
  508. package/dist/serve/rpc/file/file-rpc.layer.mjs +143 -0
  509. package/dist/serve/rpc/file/upload-sessions.pure.d.mts +45 -0
  510. package/dist/serve/rpc/file/upload-sessions.pure.mjs +187 -0
  511. package/dist/serve/rpc/in-process-client.layer.d.mts +13 -0
  512. package/dist/serve/rpc/in-process-client.layer.mjs +34 -0
  513. package/dist/serve/rpc/listener-not-loopback.errors.d.mts +9 -0
  514. package/dist/serve/rpc/listener-not-loopback.errors.mjs +7 -0
  515. package/dist/serve/rpc/ndjson-only.pure.d.mts +5 -0
  516. package/dist/serve/rpc/ndjson-only.pure.mjs +14 -0
  517. package/dist/serve/rpc/served-rpc.layer.d.mts +6 -0
  518. package/dist/serve/rpc/served-rpc.layer.mjs +19 -0
  519. package/dist/serve/store/actor-not-migrated.errors.d.mts +10 -0
  520. package/dist/serve/store/actor-not-migrated.errors.mjs +8 -0
  521. package/dist/serve/store/store-migrations.layer.d.mts +5 -0
  522. package/dist/serve/store/store-migrations.layer.mjs +18 -0
  523. package/dist/serve/store/store-migrations.service.d.mts +26 -0
  524. package/dist/serve/store/store-migrations.service.mjs +47 -0
  525. package/dist/serve/store/store-unreadable.errors.d.mts +9 -0
  526. package/dist/serve/store/store-unreadable.errors.mjs +7 -0
  527. package/dist/serve/verify/verify.layer.d.mts +16 -0
  528. package/dist/serve/verify/verify.layer.mjs +36 -0
  529. package/dist/testing/story-driver.service.d.mts +29 -0
  530. package/dist/testing/story-driver.service.mjs +126 -0
  531. package/dist/testing/story.layer.d.mts +21 -0
  532. package/dist/testing/story.layer.mjs +42 -0
  533. package/package.json +106 -3
  534. package/src/contract/actor/actor-already-exists.errors.ts +8 -0
  535. package/src/contract/actor/actor-definition.pure.ts +157 -0
  536. package/src/contract/actor/actor-erased.errors.ts +8 -0
  537. package/src/contract/actor/actor-names.pure.ts +64 -0
  538. package/src/contract/actor/actor-not-created.errors.ts +8 -0
  539. package/src/contract/actor/actor-not-registered.errors.ts +8 -0
  540. package/src/contract/actor/actor-registry.service.ts +35 -0
  541. package/src/contract/actor/actor.contract.ts +409 -0
  542. package/src/contract/actor/host-interface.pure.ts +60 -0
  543. package/src/contract/actor/reserved-member.errors.ts +9 -0
  544. package/src/contract/akter.service.ts +233 -0
  545. package/src/contract/caller/authentication.api.ts +9 -0
  546. package/src/contract/caller/caller-admission.pure.ts +90 -0
  547. package/src/contract/caller/caller-not-allowed.errors.ts +26 -0
  548. package/src/contract/caller/caller.schema.ts +7 -0
  549. package/src/contract/caller/current-caller.service.ts +7 -0
  550. package/src/contract/caller/principal.schema.ts +13 -0
  551. package/src/contract/caller/unauthenticated.errors.ts +8 -0
  552. package/src/contract/client/actor-client.adapter.ts +217 -0
  553. package/src/contract/client/actor-client.contract.ts +53 -0
  554. package/src/contract/client/actor-rpc.contract.ts +91 -0
  555. package/src/contract/client/actor-unavailable.errors.ts +9 -0
  556. package/src/contract/client/client-failure.contract.ts +53 -0
  557. package/src/contract/client/invalid-request.errors.ts +9 -0
  558. package/src/contract/client/storage-limit.errors.ts +16 -0
  559. package/src/contract/command/command-id-expired.errors.ts +11 -0
  560. package/src/contract/command/command-id.schema.ts +5 -0
  561. package/src/contract/command/command.contract.ts +334 -0
  562. package/src/contract/command/outbox-id.pure.ts +25 -0
  563. package/src/contract/command/outbox.schema.ts +11 -0
  564. package/src/contract/command/timer.schema.ts +21 -0
  565. package/src/contract/computer/checkpoint-expired.errors.ts +12 -0
  566. package/src/contract/computer/computer-client-failure.contract.ts +27 -0
  567. package/src/contract/computer/computer-client.adapter.ts +110 -0
  568. package/src/contract/computer/computer-client.contract.ts +75 -0
  569. package/src/contract/computer/computer-held.errors.ts +10 -0
  570. package/src/contract/computer/computer-limit.errors.ts +11 -0
  571. package/src/contract/computer/computer-lost.errors.ts +10 -0
  572. package/src/contract/computer/computer-not-found.errors.ts +9 -0
  573. package/src/contract/computer/computer.schema.ts +159 -0
  574. package/src/contract/computer/computers-unavailable.errors.ts +9 -0
  575. package/src/contract/computer/files/computer-files.schema.ts +31 -0
  576. package/src/contract/computer/rpc/computer-rpc.contract.ts +140 -0
  577. package/src/contract/computer/step/computer-step.contract.ts +126 -0
  578. package/src/contract/computer/step/computer-step.schema.ts +80 -0
  579. package/src/contract/computer/step/step-failure.schema.ts +26 -0
  580. package/src/contract/computer/step/step-not-found.errors.ts +7 -0
  581. package/src/contract/description/published-contract.pure.ts +187 -0
  582. package/src/contract/file/access/file-access-denied.errors.ts +11 -0
  583. package/src/contract/file/access/file-access.contract.ts +56 -0
  584. package/src/contract/file/actor-files.contract.ts +78 -0
  585. package/src/contract/file/blob-transfer.errors.ts +6 -0
  586. package/src/contract/file/file-client-failure.contract.ts +43 -0
  587. package/src/contract/file/file-client.adapter.ts +45 -0
  588. package/src/contract/file/file-client.contract.ts +24 -0
  589. package/src/contract/file/file-listing.pure.ts +30 -0
  590. package/src/contract/file/file-not-found.errors.ts +6 -0
  591. package/src/contract/file/file-path.pure.ts +37 -0
  592. package/src/contract/file/files-unavailable.errors.ts +8 -0
  593. package/src/contract/file/invalid-file-request.errors.ts +9 -0
  594. package/src/contract/file/rpc/file-rpc.contract.ts +148 -0
  595. package/src/contract/file/rpc/file-too-large.errors.ts +10 -0
  596. package/src/contract/file/rpc/rpc-file-clients.layer.ts +184 -0
  597. package/src/contract/fork/fork-rpc.contract.ts +44 -0
  598. package/src/contract/history/actor-journal.service.ts +195 -0
  599. package/src/contract/history/history-entry.pure.ts +282 -0
  600. package/src/contract/hosted/handler-failed.errors.ts +16 -0
  601. package/src/contract/hosted/handler-failure.pure.ts +161 -0
  602. package/src/contract/hosted/hosted-actor.service.ts +97 -0
  603. package/src/contract/hosted/hosted-command.service.ts +114 -0
  604. package/src/contract/hosted/hosted-create.service.ts +95 -0
  605. package/src/contract/hosted/hosted-error.contract.ts +22 -0
  606. package/src/contract/hosted/hosted-failure.schema.ts +32 -0
  607. package/src/contract/hosted/hosted-outcome.contract.ts +21 -0
  608. package/src/contract/hosted/hosted-query.service.ts +50 -0
  609. package/src/contract/hosted/hosted-request.pure.ts +185 -0
  610. package/src/contract/job/job-id.pure.ts +37 -0
  611. package/src/contract/job/job-patches.contract.ts +86 -0
  612. package/src/contract/job/job-signal.schema.ts +23 -0
  613. package/src/contract/job/reserved-payload-field.errors.ts +10 -0
  614. package/src/contract/job/started-job.schema.ts +9 -0
  615. package/src/contract/json-codec.pure.ts +27 -0
  616. package/src/contract/room.contract.ts +31 -0
  617. package/src/contract/secret/actor-secrets.adapter.ts +87 -0
  618. package/src/contract/secret/invalid-secret-name.errors.ts +10 -0
  619. package/src/contract/secret/secret-unavailable.errors.ts +13 -0
  620. package/src/contract/secret/secret.schema.ts +43 -0
  621. package/src/contract/spend/billing-unavailable.errors.ts +12 -0
  622. package/src/contract/spend/spend-cap-reached.errors.ts +17 -0
  623. package/src/contract/state/actor-state.pure.ts +192 -0
  624. package/src/contract/state/actor-state.service.ts +69 -0
  625. package/src/contract/state/state-migration.pure.ts +57 -0
  626. package/src/contract/state/state-read.pure.ts +40 -0
  627. package/src/contract/state/state-unreadable.errors.ts +9 -0
  628. package/src/host/actor/actor-database.service.ts +145 -0
  629. package/src/host/actor/actor-exclusive.pure.ts +32 -0
  630. package/src/host/actor/actor-records.sql.ts +78 -0
  631. package/src/host/actor/reserved-name.errors.ts +10 -0
  632. package/src/host/actor/reserved-names.pure.ts +40 -0
  633. package/src/host/actor/room.actor.ts +57 -0
  634. package/src/host/blob/blob-frames.pure.ts +52 -0
  635. package/src/host/blob/blob-grant.schema.ts +22 -0
  636. package/src/host/blob/blob-grants.service.ts +197 -0
  637. package/src/host/blob/blob-keyring.service.ts +25 -0
  638. package/src/host/blob/blob-range.pure.ts +33 -0
  639. package/src/host/blob/blob-sealing.contract.ts +46 -0
  640. package/src/host/blob/blob-sealing.service.ts +25 -0
  641. package/src/host/blob/export/blob-archive.sql.ts +153 -0
  642. package/src/host/blob/export/blob-export-holds.sql.ts +91 -0
  643. package/src/host/blob/plain-blob-sealing.pure.ts +70 -0
  644. package/src/host/blob/reference/blob-catalog.sql.ts +339 -0
  645. package/src/host/blob/reference/blob-coordinator.pure.ts +217 -0
  646. package/src/host/blob/reference/blob-file-page.sql.ts +48 -0
  647. package/src/host/blob/reference/blob-forks.sql.ts +125 -0
  648. package/src/host/blob/reference/blob-lineage.sql.ts +63 -0
  649. package/src/host/blob/reference/blob-reads.pure.ts +172 -0
  650. package/src/host/blob/reference/blob-receipts.sql.ts +375 -0
  651. package/src/host/blob/reference/blob-transfer-adopt.pure.ts +127 -0
  652. package/src/host/blob/reference/blob-transfer-fork.pure.ts +174 -0
  653. package/src/host/blob/reference/blob-transfer-upkeep.pure.ts +132 -0
  654. package/src/host/blob/reference/blob-transfer.pure.ts +127 -0
  655. package/src/host/blob/sealed-blob-sealing.pure.ts +163 -0
  656. package/src/host/blob/stream/blob-directory.pure.ts +177 -0
  657. package/src/host/blob/stream/blob-length.pure.ts +40 -0
  658. package/src/host/blob/stream/blob-writing.pure.ts +49 -0
  659. package/src/host/command/batch/command-batch.sql.ts +207 -0
  660. package/src/host/command/command-context.adapter.ts +134 -0
  661. package/src/host/command/command-id-age.pure.ts +54 -0
  662. package/src/host/command/command-id-reuse.pure.ts +90 -0
  663. package/src/host/command/command-id-reused.errors.ts +13 -0
  664. package/src/host/command/command-journal.sql.ts +232 -0
  665. package/src/host/command/command-rejected.errors.ts +8 -0
  666. package/src/host/command/command-replay.service.ts +223 -0
  667. package/src/host/command/command-reply.pure.ts +21 -0
  668. package/src/host/command/command-runner.service.ts +320 -0
  669. package/src/host/command/files/command-file-inputs.sql.ts +114 -0
  670. package/src/host/command/history-pruned.errors.ts +10 -0
  671. package/src/host/command/replay/replay-cursor-stalled.errors.ts +9 -0
  672. package/src/host/command/replay/replay-cursor.pure.ts +19 -0
  673. package/src/host/computer/computer-steps.sql.ts +120 -0
  674. package/src/host/computer/job-computers.service.ts +84 -0
  675. package/src/host/computer/local-computer-files.layer.ts +103 -0
  676. package/src/host/computer/local-computer-log.layer.ts +115 -0
  677. package/src/host/computer/local-computer-records.layer.ts +205 -0
  678. package/src/host/computer/local-computer.schema.ts +36 -0
  679. package/src/host/computer/local-computers.adapter.ts +379 -0
  680. package/src/host/computer/local-step.layer.ts +174 -0
  681. package/src/host/file/actor-file-storage.sql.ts +79 -0
  682. package/src/host/file/actor-files.sql.ts +15 -0
  683. package/src/host/file/blob-home-lock.pure.ts +23 -0
  684. package/src/host/file/blob-home.sql.ts +55 -0
  685. package/src/host/file/local-blob-home.service.ts +71 -0
  686. package/src/host/file/local-blob-owner.sql.ts +89 -0
  687. package/src/host/file/local-file-upkeep.pure.ts +77 -0
  688. package/src/host/file/replay-file-storage.sql.ts +43 -0
  689. package/src/host/fork/actor-fork.sql.ts +110 -0
  690. package/src/host/fork/fork-computers.adapter.ts +366 -0
  691. package/src/host/hash/blob-hashing.service.ts +14 -0
  692. package/src/host/job/job-durables.sql.ts +214 -0
  693. package/src/host/job/job-engine.adapter.ts +420 -0
  694. package/src/host/job/job-journal.sql.ts +257 -0
  695. package/src/host/job/job-results.service.ts +111 -0
  696. package/src/host/job/job-runs.pure.ts +445 -0
  697. package/src/host/job/undelivered-result.pure.ts +265 -0
  698. package/src/host/layout/actor-layout.sql.ts +45 -0
  699. package/src/host/layout/layout-version.errors.ts +10 -0
  700. package/src/host/layout/layout-version.pure.ts +22 -0
  701. package/src/host/migration/actor-migrations.service.ts +159 -0
  702. package/src/host/migration/migration-edited.errors.ts +9 -0
  703. package/src/host/migration/migration-failed.errors.ts +12 -0
  704. package/src/host/migration/migration-failure.pure.ts +28 -0
  705. package/src/host/migration/migration-hasher.adapter.ts +70 -0
  706. package/src/host/migration/migration-missing.errors.ts +9 -0
  707. package/src/host/migration/migration-plan.pure.ts +66 -0
  708. package/src/host/outbox/actor-outbox.sql.ts +98 -0
  709. package/src/host/outbox/outbox-acknowledgements.sql.ts +93 -0
  710. package/src/host/outbox/outbox-runner.service.ts +253 -0
  711. package/src/host/query/query-policy.pure.ts +31 -0
  712. package/src/host/query/query-runner.service.ts +132 -0
  713. package/src/host/sqlite/actor-connections.pure.ts +44 -0
  714. package/src/host/sqlite/sqlite-connection.adapter.ts +260 -0
  715. package/src/host/sqlite/sqlite-driver.service.ts +151 -0
  716. package/src/host/sqlite/sqlite-parameters.pure.ts +28 -0
  717. package/src/host/sqlite/sqlite-reason.pure.ts +19 -0
  718. package/src/host/timer/actor-timers.sql.ts +67 -0
  719. package/src/host/timer/timer-runner.service.ts +117 -0
  720. package/src/host/upkeep/actor-due.sql.ts +71 -0
  721. package/src/host/upkeep/actor-upkeep.service.ts +404 -0
  722. package/src/host/upkeep/execution-authority.pure.ts +37 -0
  723. package/src/runtime/akter-local.layer.ts +49 -0
  724. package/src/runtime/akter.layer.ts +208 -0
  725. package/src/runtime/blob-hashing.layer.ts +21 -0
  726. package/src/runtime/hosted-environment.layer.ts +85 -0
  727. package/src/runtime/http-server.layer.ts +29 -0
  728. package/src/runtime/local-actor-engine.layer.ts +33 -0
  729. package/src/runtime/local-engine.layer.ts +37 -0
  730. package/src/runtime/local-environments.layer.ts +214 -0
  731. package/src/runtime/local-file-clients.layer.ts +112 -0
  732. package/src/runtime/local-job-runtime.layer.ts +38 -0
  733. package/src/serve/archive/archived-actors.layer.ts +97 -0
  734. package/src/serve/archive/archived-store.layer.ts +46 -0
  735. package/src/serve/engine/actor-engine.layer.ts +46 -0
  736. package/src/serve/engine/actor-fork.service.ts +403 -0
  737. package/src/serve/engine/actor-holding.pure.ts +28 -0
  738. package/src/serve/engine/actor-host.service.ts +454 -0
  739. package/src/serve/engine/actor-location.service.ts +219 -0
  740. package/src/serve/engine/actor-residents.pure.ts +500 -0
  741. package/src/serve/engine/actor-shard.pure.ts +13 -0
  742. package/src/serve/engine/actor-state.pure.ts +45 -0
  743. package/src/serve/engine/actors-not-hosted.errors.ts +9 -0
  744. package/src/serve/engine/job-runtime.layer.ts +13 -0
  745. package/src/serve/environment/environment-already-exists.errors.ts +9 -0
  746. package/src/serve/environment/environment-in-use.errors.ts +17 -0
  747. package/src/serve/environment/environment-not-found.errors.ts +9 -0
  748. package/src/serve/environment/environment-records.sql.ts +208 -0
  749. package/src/serve/environment/environment-store.sql.ts +116 -0
  750. package/src/serve/environment/local-environment.schema.ts +79 -0
  751. package/src/serve/environment/local-environments.service.ts +268 -0
  752. package/src/serve/environment/promotion-notice.pure.ts +63 -0
  753. package/src/serve/environment/snapshot-operations.sql.ts +210 -0
  754. package/src/serve/environment/store-snapshot.sql.ts +128 -0
  755. package/src/serve/erasure/local-actor-erasure.service.ts +170 -0
  756. package/src/serve/history/actor-host-runners.service.ts +85 -0
  757. package/src/serve/hosted/hosted-app-build.errors.ts +11 -0
  758. package/src/serve/hosted/hosted-app-checks.layer.ts +74 -0
  759. package/src/serve/hosted/hosted-file-forward.layer.ts +63 -0
  760. package/src/serve/hosted/hosted-file-rpcs.layer.ts +149 -0
  761. package/src/serve/hosted/hosted-file-server.layer.ts +75 -0
  762. package/src/serve/hosted/hosted-files.layer.ts +76 -0
  763. package/src/serve/hosted/hosted-runtime.layer.ts +145 -0
  764. package/src/serve/hosted/hosted-runtime.service.ts +128 -0
  765. package/src/serve/hosted/hosted-secrets.layer.ts +38 -0
  766. package/src/serve/http/loopback-host.pure.ts +67 -0
  767. package/src/serve/inspect/actor-inspection.schema.ts +94 -0
  768. package/src/serve/inspect/actor-inspection.sql.ts +112 -0
  769. package/src/serve/inspect/inspect.service.ts +173 -0
  770. package/src/serve/inspect/inspector-page.pure.ts +159 -0
  771. package/src/serve/inspect/inspector-wal.pure.ts +40 -0
  772. package/src/serve/inspect/inspector.handlers.ts +103 -0
  773. package/src/serve/inspect/inspector.layer.ts +26 -0
  774. package/src/serve/live/live-reads.service.ts +285 -0
  775. package/src/serve/live/live-tables.sql.ts +148 -0
  776. package/src/serve/live/state-reads.pure.ts +22 -0
  777. package/src/serve/rpc/actor-rpc.handlers.ts +242 -0
  778. package/src/serve/rpc/akter-server.layer.ts +119 -0
  779. package/src/serve/rpc/computer/computer-copy.layer.ts +95 -0
  780. package/src/serve/rpc/computer/computer-rpc-access.pure.ts +75 -0
  781. package/src/serve/rpc/computer/computer-rpc.layer.ts +143 -0
  782. package/src/serve/rpc/computer/step-rpc.handlers.ts +84 -0
  783. package/src/serve/rpc/development-authentication.handlers.ts +28 -0
  784. package/src/serve/rpc/development-guard.pure.ts +39 -0
  785. package/src/serve/rpc/file/file-rpc-access.pure.ts +119 -0
  786. package/src/serve/rpc/file/file-rpc.layer.ts +209 -0
  787. package/src/serve/rpc/file/upload-sessions.pure.ts +363 -0
  788. package/src/serve/rpc/in-process-client.layer.ts +62 -0
  789. package/src/serve/rpc/listener-not-loopback.errors.ts +9 -0
  790. package/src/serve/rpc/ndjson-only.pure.ts +33 -0
  791. package/src/serve/rpc/served-rpc.layer.ts +34 -0
  792. package/src/serve/store/actor-not-migrated.errors.ts +10 -0
  793. package/src/serve/store/store-migrations.layer.ts +35 -0
  794. package/src/serve/store/store-migrations.service.ts +76 -0
  795. package/src/serve/store/store-unreadable.errors.ts +9 -0
  796. package/src/serve/verify/verify.layer.ts +77 -0
  797. package/src/testing/story-driver.service.ts +266 -0
  798. package/src/testing/story.layer.ts +99 -0
package/src/serve/inspect/inspector-page.pure.ts ADDED
@@ -0,0 +1,159 @@
1
+ import { Array as Arr } from "effect";
2
+
3
+ const inspectorPage = Arr.join(
4
+ [
5
+ "<!doctype html>",
6
+ '<html lang="en">',
7
+ "<head>",
8
+ '<meta charset="utf-8">',
9
+ '<meta name="viewport" content="width=device-width, initial-scale=1">',
10
+ "<title>Akter inspector</title>",
11
+ "<style>",
12
+ ":root {",
13
+ " color-scheme: light dark;",
14
+ " --font-sans: Inter, ui-sans-serif, system-ui, sans-serif;",
15
+ ' --font-mono: "Geist Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;',
16
+ " --bg: light-dark(#eeeeed, #0a0a09);",
17
+ " --panel: light-dark(#fbfbfa, #121311);",
18
+ " --card: light-dark(#ffffff, #171816);",
19
+ " --card-hover: light-dark(#fbfbfa, #1c1e1b);",
20
+ " --secondary: light-dark(rgb(0 0 0 / 0.05), rgb(255 255 255 / 0.08));",
21
+ " --text: light-dark(#0b0d0b, #ecebe7);",
22
+ " --muted-text: light-dark(rgb(11 13 11 / 0.62), rgb(236 235 231 / 0.6));",
23
+ " --border-1: light-dark(rgb(0 0 0 / 0.08), rgb(255 255 255 / 0.08));",
24
+ " --border-2: light-dark(rgb(0 0 0 / 0.11), rgb(255 255 255 / 0.12));",
25
+ " --primary: #ffc300;",
26
+ " --ring: light-dark(color-mix(in oklch, var(--primary) 50%, black), var(--primary));",
27
+ " --success: #00a20b;",
28
+ " --destructive: #c7332f;",
29
+ " --sh-card: 0 0 0 0.5px rgb(0 0 0 / 0.11);",
30
+ "}",
31
+ "* { box-sizing: border-box; margin: 0; padding: 0; }",
32
+ "body { background: var(--bg); color: var(--text); font: 14px/1.5 var(--font-sans); min-height: 100dvh; }",
33
+ ".shell { display: grid; grid-template-columns: 260px 1fr; min-height: 100dvh; }",
34
+ "nav { background: var(--panel); border-right: 1px solid var(--border-1); padding: 16px 12px; overflow-y: auto; }",
35
+ "nav h1 { font-size: 15px; font-weight: 600; padding: 0 8px 12px; }",
36
+ "nav h2 { font-size: 12px; font-weight: 500; color: var(--muted-text); padding: 12px 8px 4px; }",
37
+ "nav ul { list-style: none; }",
38
+ "nav button { display: block; width: 100%; text-align: left; font: inherit; color: inherit; background: none; border: 0; border-radius: 6px; padding: 4px 8px; cursor: pointer; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }",
39
+ "nav button:hover { background: var(--secondary); }",
40
+ 'nav button[aria-current="true"] { background: var(--card); box-shadow: var(--sh-card); }',
41
+ "button:focus-visible { outline: 2px solid var(--ring); outline-offset: 1px; }",
42
+ "main { padding: 24px; overflow-x: auto; }",
43
+ "header { display: flex; align-items: baseline; gap: 12px; margin-bottom: 20px; }",
44
+ "header h2 { font-size: 20px; font-weight: 600; text-wrap: balance; }",
45
+ ".live { font-size: 12px; color: var(--muted-text); }",
46
+ '.live[data-on="true"]::before { content: ""; display: inline-block; width: 6px; height: 6px; border-radius: 50%; background: var(--success); margin-right: 6px; vertical-align: middle; }',
47
+ "section { background: var(--card); box-shadow: var(--sh-card); border-radius: 10px; padding: 16px; margin-bottom: 16px; }",
48
+ "section h3 { font-size: 14px; font-weight: 600; margin-bottom: 8px; }",
49
+ "section h4 { font-size: 13px; font-weight: 500; margin: 12px 0 6px; font-family: var(--font-mono); }",
50
+ ".note { color: var(--muted-text); font-size: 13px; text-wrap: pretty; }",
51
+ "pre, td { font-family: var(--font-mono); font-size: 12.5px; }",
52
+ "pre { white-space: pre-wrap; word-break: break-word; }",
53
+ "table { width: 100%; border-collapse: collapse; font-variant-numeric: tabular-nums; }",
54
+ ".scroll { overflow-x: auto; }",
55
+ "th { text-align: left; font-weight: 500; font-size: 12px; color: var(--muted-text); padding: 4px 8px; border-bottom: 1px solid var(--border-2); }",
56
+ "td { padding: 4px 8px; border-bottom: 1px solid var(--border-1); vertical-align: top; max-width: 280px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }",
57
+ "td.failed { color: var(--destructive); }",
58
+ ".empty { display: grid; place-items: center; align-content: center; min-height: 60dvh; text-align: center; gap: 8px; }",
59
+ "@media (max-width: 720px) { .shell { grid-template-columns: 1fr; } nav { border-right: 0; border-bottom: 1px solid var(--border-1); max-height: 40dvh; } }",
60
+ "</style>",
61
+ "</head>",
62
+ "<body>",
63
+ '<div class="shell">',
64
+ '<nav aria-label="Actors"></nav>',
65
+ '<main aria-live="off"></main>',
66
+ "</div>",
67
+ '<script type="module">',
68
+ "const $ = (tag, props = {}, children = []) => {",
69
+ " const node = Object.assign(document.createElement(tag), props);",
70
+ " node.append(...children);",
71
+ " return node;",
72
+ "};",
73
+ "const text = (tag, value, props = {}) => $(tag, { ...props, textContent: String(value) });",
74
+ "const time = (millis) => new Date(millis).toLocaleString();",
75
+ 'const nav = document.querySelector("nav");',
76
+ 'const main = document.querySelector("main");',
77
+ "let open = null;",
78
+ "let source = null;",
79
+ 'let listed = "";',
80
+ 'const message = (title, body) => main.replaceChildren($("div", { className: "empty" }, [text("h2", title), text("p", body, { className: "note" })]));',
81
+ "const table = (columns, rows) =>",
82
+ ' $("div", { className: "scroll" }, [$("table", {}, [',
83
+ ' $("thead", {}, [$("tr", {}, columns.map((column) => text("th", column, { scope: "col" })))]),',
84
+ ' $("tbody", {}, rows.map((cells) => $("tr", {}, cells.map((cell) => (cell instanceof Node ? cell : text("td", cell ?? "null", { title: String(cell ?? "null") })))))),',
85
+ " ])]);",
86
+ "const section = (title, count, body, empty) =>",
87
+ ' $("section", {}, [text("h3", count === undefined ? title : title + " (" + count + ")"), count === 0 ? text("p", empty, { className: "note" }) : body]);',
88
+ 'const exitCell = (exit) => text("td", exit.includes(\'"Failure"\') ? "failed" : "ok", { className: exit.includes(\'"Failure"\') ? "failed" : "", title: exit });',
89
+ "const render = (inspection) => {",
90
+ " const { actor, key } = inspection;",
91
+ ' const live = text("span", source ? "live" : "", { className: "live", role: "status" });',
92
+ " live.dataset.on = String(Boolean(source));",
93
+ " main.replaceChildren(",
94
+ ' $("header", {}, [text("h2", actor + "/" + key), live]),',
95
+ ' section("State", undefined, text("pre", inspection.state === null ? "null" : JSON.stringify(JSON.parse(inspection.state), null, 2)), ""),',
96
+ ' section("Developer tables", inspection.tables.length, $("div", {}, inspection.tables.map((shown) => $("div", {}, [',
97
+ ' text("h4", shown.name + " · " + shown.rows.length + " of " + shown.total + " rows"),',
98
+ " table(shown.columns, shown.rows),",
99
+ ' ]))), "This actor has no tables of its own. Add one in a migration."),',
100
+ ' section("Command journal", inspection.commands.length, table(["seq", "at", "command", "principal", "payload", "exit"],',
101
+ " inspection.commands.map((entry) => [entry.seq, time(entry.at), entry.command, entry.principal, entry.payload, exitCell(entry.exit)])),",
102
+ ' "No commands yet. Send one through /rpc and it shows up here."),',
103
+ ' section("Pending timers", inspection.timers.length, table(["due", "command", "payload", "id"],',
104
+ " inspection.timers.map((timer) => [time(timer.dueAt), timer.command, timer.payload, timer.id])),",
105
+ ' "No timers are pending. A handler schedules one with Akter.schedule."),',
106
+ ' section("Outbox", inspection.outbox.length, table(["seq", "to", "command", "payload"],',
107
+ ' inspection.outbox.map((entry) => [entry.seq, entry.actor + "/" + entry.key, entry.member, entry.payload])),',
108
+ ' "The outbox is empty: every message this actor sent has been delivered."),',
109
+ ' section("Failed deliveries", inspection.failedDeliveries.length, table(["at", "to", "command", "error"],',
110
+ ' inspection.failedDeliveries.map((entry) => [time(entry.at), entry.actor + "/" + entry.key, entry.member, entry.error])),',
111
+ ' "No message from this actor was refused."),',
112
+ ' section("Jobs", inspection.jobs.length, table(["execution", "entry", "value"],',
113
+ " inspection.jobs.flatMap((run) => run.entries.map((entry) => [run.executionId, entry.entry, entry.value]))),",
114
+ ' "No jobs have run. A handler starts one with Akter.start."),',
115
+ ' section("Files", inspection.files.length, table(["name", "bytes"], inspection.files.map((file) => [file.name, file.bytes])),',
116
+ ' "No files in this actor\'s files folder."),',
117
+ " );",
118
+ "};",
119
+ "const select = (actor, key) => {",
120
+ " open = { actor, key };",
121
+ " source?.close();",
122
+ ' main.setAttribute("aria-busy", "true");',
123
+ ' message("Opening " + actor + "/" + key, "Reading its database through a read-only connection.");',
124
+ ' const actorPath = "/api/actors/" + encodeURIComponent(actor) + "/" + (key === "" ? "_" : encodeURIComponent(key));',
125
+ ' source = new EventSource(actorPath + "/live" + (key === "" ? "?key=" : ""));',
126
+ ' source.onmessage = (event) => { main.removeAttribute("aria-busy"); render(JSON.parse(event.data)); };',
127
+ ' source.addEventListener("unavailable", () => { source?.close(); source = null; main.removeAttribute("aria-busy"); message(actor + "/" + key + " can\'t be read", "Its database couldn\'t be opened. Pick the actor again to retry."); });',
128
+ ' source.onerror = () => { source?.close(); source = null; main.removeAttribute("aria-busy"); };',
129
+ ' for (const button of nav.querySelectorAll("button")) button.setAttribute("aria-current", String(button.dataset.actor === actor && button.dataset.key === key));',
130
+ "};",
131
+ "const list = (types) => {",
132
+ " const shown = JSON.stringify(types);",
133
+ " if (shown === listed) return;",
134
+ " listed = shown;",
135
+ " const focused = document.activeElement?.dataset ?? {};",
136
+ ' nav.replaceChildren(text("h1", "Akter inspector"), ...types.flatMap((type) => [',
137
+ ' text("h2", type.actor),',
138
+ ' $("ul", {}, type.keys.map((key) => {',
139
+ ' const button = text("button", key === "" ? "(empty key)" : key, { type: "button", title: key, onclick: () => select(type.actor, key) });',
140
+ " Object.assign(button.dataset, { actor: type.actor, key });",
141
+ ' button.setAttribute("aria-current", String(open?.actor === type.actor && open?.key === key));',
142
+ ' return $("li", {}, [button]);',
143
+ " })),",
144
+ " ]));",
145
+ ' for (const button of nav.querySelectorAll("button")) if (button.dataset.actor === focused.actor && button.dataset.key === focused.key) button.focus();',
146
+ ' if (types.length === 0) message("No actors yet", "Send a command through /rpc and its actor shows up here.");',
147
+ ' else if (open === null) message("Pick an actor", "Choose one on the left to see its state, tables, Command journal, Timers, Outbox and jobs.");',
148
+ "};",
149
+ 'const refresh = () => fetch("/api/actors").then((answer) => answer.json()).then(list, () => undefined);',
150
+ "refresh();",
151
+ "setInterval(refresh, 2000);",
152
+ "</script>",
153
+ "</body>",
154
+ "</html>",
155
+ ],
156
+ "\n",
157
+ );
158
+
159
+ export { inspectorPage };
package/src/serve/inspect/inspector-wal.pure.ts ADDED
@@ -0,0 +1,40 @@
1
+ import { Effect, Option } from "effect";
2
+ import type { FileSystem } from "effect";
3
+
4
+ const sqliteHeader = "SQLite format 3\0";
5
+ const headerBytes = 20;
6
+ const readVersionOffset = 19;
7
+ const writeVersionOffset = 18;
8
+ const walVersion = 2;
9
+ const headerStart = 0;
10
+ const privateFileMode = 0o600;
11
+
12
+ const usesWal = (header: Uint8Array): boolean =>
13
+ header[readVersionOffset] === walVersion &&
14
+ header[writeVersionOffset] === walVersion &&
15
+ new globalThis.TextDecoder().decode(header.subarray(headerStart, sqliteHeader.length)) === sqliteHeader;
16
+
17
+ const prepareInspectionWal = Effect.fn("Inspect.prepareInspectionWal")(function* prepareInspectionWal(
18
+ fileSystem: FileSystem.FileSystem,
19
+ database: string,
20
+ ) {
21
+ const header = yield* Effect.scoped(
22
+ Effect.flatMap(fileSystem.open(database, { flag: "r" }), (file) => file.readAlloc(headerBytes)),
23
+ );
24
+
25
+ if (!Option.exists(header, usesWal)) {
26
+ return;
27
+ }
28
+
29
+ yield* Effect.forEach(
30
+ ["-wal", "-shm"],
31
+ (suffix) =>
32
+ Effect.scoped(fileSystem.open(`${database}${suffix}`, { flag: "wx", mode: privateFileMode })).pipe(
33
+ Effect.asVoid,
34
+ Effect.catchReason("PlatformError", "AlreadyExists", () => Effect.void),
35
+ ),
36
+ { discard: true },
37
+ );
38
+ });
39
+
40
+ export { prepareInspectionWal };
package/src/serve/inspect/inspector.handlers.ts ADDED
@@ -0,0 +1,103 @@
1
+ import { Duration, Effect, Option, Predicate, Schema, Stream } from "effect";
2
+ import type { Layer } from "effect";
3
+ import { HttpRouter, HttpServerRequest, HttpServerResponse } from "effect/http";
4
+
5
+ import type { ActorAddress } from "#src/serve/engine/actor-location.service";
6
+
7
+ import { ActorInspection } from "./actor-inspection.schema.js";
8
+ import { inspectorPage } from "./inspector-page.pure.js";
9
+ import { Inspect } from "./inspect.service.js";
10
+ import type { Inspecting, InspectFailure } from "./inspect.service.js";
11
+
12
+ type Response = HttpServerResponse.HttpServerResponse;
13
+
14
+ type InspectorRoute = HttpRouter.Route<never, Inspect>;
15
+
16
+ const notFound = 404;
17
+
18
+ const unavailable = 503;
19
+
20
+ const liveEveryMillis = 500;
21
+
22
+ const live = Duration.millis(liveEveryMillis);
23
+
24
+ const encodeInspection = Schema.encodeEffect(Schema.fromJsonString(ActorInspection));
25
+
26
+ const statusOf = (failure: InspectFailure): number => {
27
+ if (Predicate.isTagged(failure, "ActorNotCreatedError")) {
28
+ return notFound;
29
+ }
30
+
31
+ return unavailable;
32
+ };
33
+
34
+ const failed = (failure: InspectFailure): Response =>
35
+ HttpServerResponse.jsonUnsafe({ error: failure.message }, { status: statusOf(failure) });
36
+
37
+ const queryKey = Schema.decodeUnknownOption(Schema.String);
38
+
39
+ const addressOf: Effect.Effect<ActorAddress, never, HttpRouter.RouteContext | HttpServerRequest.ParsedSearchParams> =
40
+ Effect.map(Effect.all([HttpRouter.params, HttpServerRequest.ParsedSearchParams]), ([params, search]) => ({
41
+ actor: params.actor ?? "",
42
+ key: Option.getOrElse(queryKey(search.key), () => params.key ?? ""),
43
+ }));
44
+
45
+ const eventOf = (inspection: ActorInspection): Effect.Effect<string> =>
46
+ Effect.map(Effect.orDie(encodeInspection(inspection)), (text) => `data: ${text}\n\n`);
47
+
48
+ const page = HttpServerResponse.text(inspectorPage, { contentType: "text/html; charset=utf-8" });
49
+
50
+ const listed = (directory: string): Effect.Effect<Response, never, Inspect> =>
51
+ Effect.match(
52
+ Inspect.use((inspect) => inspect.actors(directory)),
53
+ {
54
+ onFailure: failed,
55
+ onSuccess: (types) => HttpServerResponse.jsonUnsafe(types),
56
+ },
57
+ );
58
+
59
+ const opened = (directory: string, address: ActorAddress): Effect.Effect<Response, never, Inspect> =>
60
+ Effect.match(
61
+ Inspect.use((inspect) => inspect.actor({ ...address, directory })),
62
+ {
63
+ onFailure: failed,
64
+ onSuccess: (inspection) => HttpServerResponse.jsonUnsafe(inspection),
65
+ },
66
+ );
67
+
68
+ const events = (inspect: Inspect["Service"], directory: string, address: ActorAddress): Stream.Stream<Uint8Array> =>
69
+ inspect.watch({ ...address, directory, every: live }).pipe(
70
+ Stream.mapEffect(eventOf),
71
+ Stream.catchCause(() => Stream.make("event: unavailable\ndata: {}\n\n")),
72
+ Stream.encodeText,
73
+ );
74
+
75
+ const watched = (directory: string, address: ActorAddress): Effect.Effect<Response, never, Inspect> =>
76
+ Inspect.use((inspect) =>
77
+ Effect.succeed(
78
+ HttpServerResponse.stream(events(inspect, directory, address), {
79
+ contentType: "text/event-stream",
80
+ headers: { "cache-control": "no-cache" },
81
+ }),
82
+ ),
83
+ );
84
+
85
+ const routesFor = (directory: string): readonly InspectorRoute[] => [
86
+ HttpRouter.route("GET", "/", page),
87
+ HttpRouter.route("GET", "/api/actors", listed(directory)),
88
+ HttpRouter.route(
89
+ "GET",
90
+ "/api/actors/:actor/:key",
91
+ Effect.flatMap(addressOf, (address) => opened(directory, address)),
92
+ ),
93
+ HttpRouter.route(
94
+ "GET",
95
+ "/api/actors/:actor/:key/live",
96
+ Effect.flatMap(addressOf, (address) => watched(directory, address)),
97
+ ),
98
+ ];
99
+
100
+ const inspectorRoutes = (directory: string): Layer.Layer<never, never, HttpRouter.HttpRouter | Inspecting> =>
101
+ HttpRouter.addAll(routesFor(directory)).pipe(HttpRouter.provideRequest(Inspect.layer));
102
+
103
+ export { inspectorRoutes };
package/src/serve/inspect/inspector.layer.ts ADDED
@@ -0,0 +1,26 @@
1
+ import { layer as nodeServices } from "@effect/platform-node/NodeServices";
2
+ import { Layer } from "effect";
3
+ import { HttpRouter } from "effect/http";
4
+ import type { HttpServer } from "effect/http";
5
+
6
+ import { SqliteDriver } from "#src/host/sqlite/sqlite-driver.service";
7
+ import { allowedHostsOnly } from "#src/serve/http/loopback-host.pure";
8
+ import type { AllowedHosts } from "#src/serve/http/loopback-host.pure";
9
+
10
+ import { inspectorRoutes } from "./inspector.handlers.js";
11
+
12
+ const inspecting = Layer.mergeAll(SqliteDriver.layerNode, nodeServices);
13
+
14
+ interface Inspected {
15
+ readonly allowedHosts: AllowedHosts;
16
+ readonly directory: string;
17
+ }
18
+
19
+ const serveInspector = ({ allowedHosts, directory }: Inspected): Layer.Layer<never, never, HttpServer.HttpServer> =>
20
+ HttpRouter.serve(inspectorRoutes(directory), {
21
+ disableListenLog: true,
22
+ disableLogger: true,
23
+ middleware: allowedHostsOnly(allowedHosts),
24
+ }).pipe(Layer.provide(inspecting));
25
+
26
+ export { serveInspector };
package/src/serve/live/live-reads.service.ts ADDED
@@ -0,0 +1,285 @@
1
+ import { Array as Arr, Context, Effect, Equal, Layer, Option, Queue, Ref, Stream } from "effect";
2
+ import type { Cause } from "effect";
3
+ import { Statement } from "effect/sql";
4
+ import type { SqlError } from "effect/sql";
5
+
6
+ import type { LiveUpdate } from "#src/contract/client/actor-rpc.contract";
7
+ import { ActorUnavailableError } from "#src/contract/client/actor-unavailable.errors";
8
+ import type { OpenedActor } from "#src/host/actor/actor-database.service";
9
+ import { currentState } from "#src/host/command/command-journal.sql";
10
+ import { QueryRunner } from "#src/host/query/query-runner.service";
11
+ import type { QueryRequest } from "#src/host/query/query-runner.service";
12
+ import { stateReads } from "./state-reads.pure.js";
13
+ import { ExecutionAuthority } from "#src/host/upkeep/execution-authority.pure";
14
+ import type { ExecutionGuard } from "#src/host/upkeep/execution-authority.pure";
15
+
16
+ import {
17
+ commandCommittedAt,
18
+ commandVersion,
19
+ committedRead,
20
+ committedVersion,
21
+ stateTable,
22
+ tablesRead,
23
+ touchedTables,
24
+ trackChanges,
25
+ } from "./live-tables.sql.js";
26
+ import type { Compiled } from "./live-tables.sql.js";
27
+
28
+ interface Reading<Value> {
29
+ readonly tables: readonly string[];
30
+ readonly value: Value;
31
+ readonly version: number;
32
+ }
33
+
34
+ type HostFailure = ActorUnavailableError | Effect.Error<ReturnType<OpenedActor["actor"]["runQuery"]>>;
35
+
36
+ interface Watcher {
37
+ readonly fail: (failure: HostFailure) => Effect.Effect<void>;
38
+ readonly refresh: (touched: readonly string[]) => Effect.Effect<void>;
39
+ }
40
+
41
+ interface Watching<Value> {
42
+ readonly last: Ref.Ref<Reading<Value>>;
43
+ readonly queue: Queue.Queue<LiveUpdate<Value>, HostFailure | Cause.Done>;
44
+ readonly read: Effect.Effect<Reading<Value>, HostFailure>;
45
+ }
46
+
47
+ interface LiveOpening {
48
+ readonly exclusive: <Success, Failure, Needs>(
49
+ effect: Effect.Effect<Success, Failure, Needs>,
50
+ ) => Effect.Effect<Success, Failure, Needs>;
51
+ readonly opened: OpenedActor;
52
+ }
53
+
54
+ interface CommittedCommand {
55
+ readonly commandId: string;
56
+ readonly opened: OpenedActor;
57
+ }
58
+
59
+ interface LiveReading {
60
+ readonly state: Effect.Effect<LiveUpdate<Option.Option<string>>, HostFailure>;
61
+ readonly subscribe: (request: QueryRequest) => Effect.Effect<LiveUpdate<string>, HostFailure>;
62
+ }
63
+
64
+ interface LiveActor {
65
+ readonly refresh: Effect.Effect<void>;
66
+ readonly state: Stream.Stream<LiveUpdate<Option.Option<string>>, HostFailure>;
67
+ readonly stateFor: (principal: string) => Stream.Stream<LiveUpdate<string>, HostFailure>;
68
+ readonly subscribe: (request: QueryRequest) => Stream.Stream<LiveUpdate<string>, HostFailure>;
69
+ }
70
+
71
+ const unavailable =
72
+ (actor: string) =>
73
+ (failure: { readonly message: string }): ActorUnavailableError =>
74
+ ActorUnavailableError.make({ actor, message: failure.message });
75
+
76
+ const available = <Value>(
77
+ opened: OpenedActor,
78
+ effect: Effect.Effect<Value, HostFailure | SqlError.SqlError>,
79
+ ): Effect.Effect<Value, HostFailure> =>
80
+ Effect.catchTag(effect, "SqlError", (failure) => Effect.fail(unavailable(opened.actor.name)(failure)));
81
+
82
+ const recordInto =
83
+ (statements: Ref.Ref<readonly Compiled[]>): Statement.Transformer =>
84
+ (statement) => {
85
+ const [sql, params] = statement.compile();
86
+
87
+ return Effect.as(Ref.update(statements, Arr.append({ params, sql })), statement);
88
+ };
89
+
90
+ const updateOf = <Value>({ value, version }: Reading<Value>): LiveUpdate<Value> => ({ value, version });
91
+
92
+ const publish = <Value>(
93
+ watching: Watching<Value>,
94
+ previous: Reading<Value>,
95
+ reading: Reading<Value>,
96
+ ): Effect.Effect<void> =>
97
+ Effect.gen(function* publishing() {
98
+ yield* Ref.set(watching.last, reading);
99
+
100
+ if (!Equal.equals(previous.value, reading.value)) {
101
+ yield* Queue.offer(watching.queue, updateOf(reading));
102
+ }
103
+ });
104
+
105
+ const refreshed = <Value>(watching: Watching<Value>, touched: readonly string[]): Effect.Effect<void> =>
106
+ Effect.gen(function* refreshing() {
107
+ const previous = yield* Ref.get(watching.last);
108
+
109
+ if (!Arr.some(previous.tables, (table) => Arr.contains(touched, table))) {
110
+ return;
111
+ }
112
+
113
+ yield* Effect.matchEffect(watching.read, {
114
+ onFailure: (failure) => Effect.asVoid(Queue.fail(watching.queue, failure)),
115
+ onSuccess: (reading) => publish(watching, previous, reading),
116
+ });
117
+ });
118
+
119
+ const stateOf = (opened: OpenedActor): Effect.Effect<Reading<Option.Option<string>>, HostFailure> =>
120
+ available(
121
+ opened,
122
+ Effect.gen(function* readState() {
123
+ const value = yield* currentState(opened.reader);
124
+ const version = yield* committedVersion(opened.reader);
125
+
126
+ return { tables: [stateTable], value, version };
127
+ }),
128
+ );
129
+
130
+ /** Each open actor's planned tables, by schema version and SQL text. */
131
+ type Plans = WeakMap<OpenedActor, Map<string, readonly string[]>>;
132
+
133
+ interface Planning {
134
+ readonly opened: OpenedActor;
135
+ readonly recorded: readonly Compiled[];
136
+ readonly schema: number;
137
+ }
138
+
139
+ // An actor runs its app's queries, so it holds a few plans; one building SQL text by hand starts over past this many.
140
+ const plansPerActor = 256;
141
+
142
+ const keySeparator = "\u0000";
143
+
144
+ /**
145
+ * The tables a query reads depend only on its SQL text and the schema, so an open actor plans each text once per
146
+ * schema version instead of sending an EXPLAIN and a schema read with every query.
147
+ */
148
+ const plannedTables =
149
+ (plans: Plans) =>
150
+ ({ opened, recorded, schema }: Planning): Effect.Effect<readonly string[], SqlError.SqlError> => {
151
+ const held = plans.get(opened) ?? new Map<string, readonly string[]>();
152
+ const key = Arr.join([String(schema), ...Arr.map(recorded, (statement) => statement.sql)], keySeparator);
153
+ const known = Option.fromNullishOr(held.get(key));
154
+
155
+ if (Option.isSome(known)) {
156
+ return Effect.succeed(known.value);
157
+ }
158
+
159
+ return Effect.tap(tablesRead({ reader: opened.reader, statements: recorded }), (tables) =>
160
+ Effect.sync(() => {
161
+ if (held.size >= plansPerActor) {
162
+ held.clear();
163
+ }
164
+
165
+ plans.set(opened, held.set(key, tables));
166
+ }),
167
+ );
168
+ };
169
+
170
+ const queryOf =
171
+ (query: QueryRunner["Service"]["run"], opened: OpenedActor, plans: Plans) =>
172
+ (request: QueryRequest): Effect.Effect<Reading<string>, HostFailure> =>
173
+ available(
174
+ opened,
175
+ Effect.gen(function* readQuery() {
176
+ const statements = yield* Ref.make<readonly Compiled[]>([]);
177
+
178
+ const value = yield* Effect.provideService(
179
+ query({ opened, request }),
180
+ Statement.CurrentTransformer,
181
+ recordInto(statements),
182
+ );
183
+
184
+ const recorded = yield* Ref.get(statements);
185
+ const { schema, version } = yield* committedRead(opened.reader);
186
+ const tables = yield* plannedTables(plans)({ opened, recorded, schema });
187
+
188
+ return { tables, value, version };
189
+ }),
190
+ );
191
+
192
+ const watchWith = (
193
+ watchers: Ref.Ref<readonly Watcher[]>,
194
+ exclusive: LiveOpening["exclusive"],
195
+ authority: ExecutionGuard,
196
+ ) => {
197
+ const unregister = (watcher: Watcher): Effect.Effect<void> =>
198
+ Ref.update(
199
+ watchers,
200
+ Arr.filter((each) => each !== watcher),
201
+ );
202
+
203
+ return <Value>(read: Effect.Effect<Reading<Value>, HostFailure>): Stream.Stream<LiveUpdate<Value>, HostFailure> =>
204
+ Stream.callback<LiveUpdate<Value>, HostFailure>((queue) => {
205
+ const register = Effect.gen(function* register() {
206
+ const first = yield* read;
207
+ const last = yield* Ref.make(first);
208
+
209
+ const watcher: Watcher = {
210
+ fail: (failure) => Effect.asVoid(Queue.fail(queue, failure)),
211
+ refresh: (touched) => authority(refreshed({ last, queue, read }, touched)),
212
+ };
213
+
214
+ yield* Queue.offer(queue, updateOf(first));
215
+ yield* Ref.update(watchers, Arr.append(watcher));
216
+
217
+ return watcher;
218
+ });
219
+
220
+ return authority(exclusive(Effect.acquireRelease(register, unregister)));
221
+ }).pipe(Stream.mapEffect((value) => authority(Effect.succeed(value))));
222
+ };
223
+
224
+ const committedAtOf = ({
225
+ commandId,
226
+ opened,
227
+ }: CommittedCommand): Effect.Effect<Option.Option<number>, SqlError.SqlError> =>
228
+ commandCommittedAt({ commandId, reader: opened.reader });
229
+
230
+ const versionOf = ({ commandId, opened }: CommittedCommand): Effect.Effect<Option.Option<number>, SqlError.SqlError> =>
231
+ commandVersion({ commandId, reader: opened.reader });
232
+
233
+ export class LiveReads extends Context.Service<
234
+ LiveReads,
235
+ {
236
+ readonly current: (opened: OpenedActor) => LiveReading;
237
+ readonly open: (opening: LiveOpening) => Effect.Effect<LiveActor, ActorUnavailableError>;
238
+ /** When the command ran, from its journal record; none for one the journal doesn't hold yet. */
239
+ readonly committedAt: (command: CommittedCommand) => Effect.Effect<Option.Option<number>, SqlError.SqlError>;
240
+ readonly version: (command: CommittedCommand) => Effect.Effect<Option.Option<number>, SqlError.SqlError>;
241
+ }
242
+ >()("@akterjs/effect/serve/live/live-reads.service/LiveReads", {
243
+ make: Effect.gen(function* makeLiveReads() {
244
+ const queries = yield* QueryRunner;
245
+ const plans: Plans = new WeakMap();
246
+
247
+ const open = Effect.fnUntraced(function* open({ exclusive, opened }: LiveOpening) {
248
+ const authority = yield* ExecutionAuthority;
249
+ yield* Effect.mapError(trackChanges(opened.sql), unavailable(opened.actor.name));
250
+
251
+ const watchers = yield* Ref.make<readonly Watcher[]>([]);
252
+ const watch = watchWith(watchers, exclusive, authority);
253
+ const state = watch(stateOf(opened));
254
+
255
+ const refresh = Effect.gen(function* refreshing() {
256
+ const current = yield* Ref.get(watchers);
257
+
258
+ yield* Effect.matchEffect(Effect.mapError(touchedTables(opened.sql), unavailable(opened.actor.name)), {
259
+ onFailure: (failure) => Effect.forEach(current, (watcher) => watcher.fail(failure), { discard: true }),
260
+ onSuccess: (touched) => Effect.forEach(current, (watcher) => watcher.refresh(touched), { discard: true }),
261
+ });
262
+ });
263
+
264
+ return {
265
+ refresh: authority(refresh),
266
+ state,
267
+ stateFor: (principal: string): Stream.Stream<LiveUpdate<string>, HostFailure> =>
268
+ stateReads({ actor: opened.actor, principal, updates: state }),
269
+ subscribe: (request: QueryRequest): Stream.Stream<LiveUpdate<string>, HostFailure> =>
270
+ watch(queryOf(queries.runLocked, opened, plans)(request)),
271
+ } satisfies LiveActor;
272
+ });
273
+
274
+ const current = (opened: OpenedActor): LiveReading => ({
275
+ state: Effect.map(stateOf(opened), updateOf),
276
+ subscribe: (request) => Effect.map(queryOf(queries.run, opened, plans)(request), updateOf),
277
+ });
278
+
279
+ return { committedAt: committedAtOf, current, open, version: versionOf } as const;
280
+ }),
281
+ }) {
282
+ public static readonly layer = Layer.effect(this, this.make).pipe(Layer.provide(QueryRunner.layer));
283
+ }
284
+
285
+ export type { CommittedCommand, HostFailure, LiveActor, LiveReading };