@astrale-os/sdk 0.6.0-beta.5 → 0.6.0-beta.50

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 (651) hide show
  1. package/README.md +213 -60
  2. package/dist/application/action/action.d.ts +6 -0
  3. package/dist/application/action/authoring.d.ts +1 -1
  4. package/dist/application/action/context.d.ts +81 -33
  5. package/dist/application/action/define.d.ts +3 -3
  6. package/dist/application/action/index.d.ts +1 -1
  7. package/dist/application/define.d.ts +8 -6
  8. package/dist/application/define.js +28 -14
  9. package/dist/application/dependency/index.d.ts +1 -1
  10. package/dist/application/dependency/invoker.d.ts +21 -10
  11. package/dist/application/domain.d.ts +30 -0
  12. package/dist/application/error/error.d.ts +16 -1
  13. package/dist/application/error/error.js +39 -5
  14. package/dist/application/error/index.d.ts +1 -1
  15. package/dist/application/error/index.js +1 -1
  16. package/dist/application/index.d.ts +4 -4
  17. package/dist/application/index.js +1 -1
  18. package/dist/application/integration/define.d.ts +8 -1
  19. package/dist/application/integration/index.d.ts +2 -2
  20. package/dist/application/integration/integration.d.ts +13 -1
  21. package/dist/application/integration/operation.d.ts +16 -3
  22. package/dist/application/mutation/authoring/builder.d.ts +81 -33
  23. package/dist/application/mutation/authoring/builder.js +100 -30
  24. package/dist/application/mutation/authoring/guard.d.ts +37 -0
  25. package/dist/application/mutation/authoring/guard.js +150 -0
  26. package/dist/application/mutation/authoring/index.d.ts +5 -2
  27. package/dist/application/mutation/authoring/index.js +2 -1
  28. package/dist/application/mutation/authoring/names.d.ts +19 -0
  29. package/dist/application/mutation/authoring/names.js +83 -0
  30. package/dist/application/mutation/authoring/properties.d.ts +5 -3
  31. package/dist/application/mutation/authoring/properties.js +35 -2
  32. package/dist/application/mutation/authoring/transition.d.ts +3 -2
  33. package/dist/application/mutation/authoring/transition.js +4 -1
  34. package/dist/application/mutation/define.d.ts +24 -10
  35. package/dist/application/mutation/define.js +49 -53
  36. package/dist/application/mutation/execution/execute.d.ts +2 -2
  37. package/dist/application/mutation/execution/execute.js +78 -7
  38. package/dist/application/mutation/execution/executor.d.ts +4 -1
  39. package/dist/application/mutation/execution/executor.js +6 -1
  40. package/dist/application/mutation/failure.d.ts +17 -1
  41. package/dist/application/mutation/failure.js +40 -19
  42. package/dist/application/mutation/index.d.ts +9 -5
  43. package/dist/application/mutation/index.js +5 -2
  44. package/dist/application/mutation/legacy/v6/builder.d.ts +84 -0
  45. package/dist/application/mutation/legacy/v6/define.d.ts +18 -0
  46. package/dist/application/mutation/legacy/v6/define.js +56 -0
  47. package/dist/application/mutation/legacy/v6/mutation.d.ts +28 -0
  48. package/dist/application/mutation/{authoring → legacy/v6}/precondition.d.ts +4 -0
  49. package/dist/application/mutation/mutation.d.ts +47 -19
  50. package/dist/application/query/answer/answer.d.ts +117 -0
  51. package/dist/application/query/answer/conformance.d.ts +4 -0
  52. package/dist/application/query/answer/conformance.js +27 -0
  53. package/dist/application/query/answer/facts.d.ts +17 -0
  54. package/dist/application/query/answer/facts.js +57 -0
  55. package/dist/application/query/composite/builder.d.ts +1 -1
  56. package/dist/application/query/composite/builder.js +2 -2
  57. package/dist/application/query/composite/plan.d.ts +1 -5
  58. package/dist/application/query/composite/plan.js +1 -3
  59. package/dist/application/query/composite/query.d.ts +1 -2
  60. package/dist/application/query/define.d.ts +3 -34
  61. package/dist/application/query/define.js +5 -131
  62. package/dist/application/query/defined/define.d.ts +45 -0
  63. package/dist/application/query/defined/define.js +96 -0
  64. package/dist/application/query/defined/query.d.ts +139 -0
  65. package/dist/application/query/definition.d.ts +12 -0
  66. package/dist/application/query/definition.js +47 -0
  67. package/dist/application/query/execution/bounds.d.ts +22 -0
  68. package/dist/application/query/execution/bounds.js +88 -0
  69. package/dist/application/query/execution/client.d.ts +21 -0
  70. package/dist/application/query/execution/crossings.d.ts +25 -0
  71. package/dist/application/query/execution/crossings.js +192 -0
  72. package/dist/application/query/execution/error.d.ts +71 -0
  73. package/dist/application/query/execution/error.js +50 -0
  74. package/dist/application/query/execution/execute.d.ts +4 -10
  75. package/dist/application/query/execution/execute.js +3 -45
  76. package/dist/application/query/execution/executor.d.ts +2 -2
  77. package/dist/application/query/execution/refusal.d.ts +37 -0
  78. package/dist/application/query/execution/refusal.js +80 -0
  79. package/dist/application/query/execution/rows.d.ts +42 -0
  80. package/dist/application/query/execution/rows.js +320 -0
  81. package/dist/application/query/execution/run.d.ts +75 -0
  82. package/dist/application/query/execution/run.js +328 -0
  83. package/dist/application/query/execution/split.d.ts +24 -0
  84. package/dist/application/query/execution/split.js +190 -0
  85. package/dist/application/query/failure.d.ts +8 -0
  86. package/dist/application/query/failure.js +8 -0
  87. package/dist/application/query/handles/build.d.ts +10 -0
  88. package/dist/application/query/handles/build.js +53 -0
  89. package/dist/application/query/handles/conditions.d.ts +94 -0
  90. package/dist/application/query/handles/domain.d.ts +157 -0
  91. package/dist/application/query/handles/handles.d.ts +271 -0
  92. package/dist/application/query/handles/handles.js +1 -0
  93. package/dist/application/query/handles/model.d.ts +106 -0
  94. package/dist/application/query/handles/model.js +261 -0
  95. package/dist/application/query/handles/plan.d.ts +100 -0
  96. package/dist/application/query/handles/plan.js +37 -0
  97. package/dist/application/query/handles/reads.d.ts +106 -0
  98. package/dist/application/query/handles/reads.js +971 -0
  99. package/dist/application/query/handles/relations.d.ts +106 -0
  100. package/dist/application/query/handles/relations.js +1 -0
  101. package/dist/application/query/handles/rows.d.ts +94 -0
  102. package/dist/application/query/handles/rows.js +4 -0
  103. package/dist/application/query/handles/terms.d.ts +103 -0
  104. package/dist/application/query/handles/terms.js +282 -0
  105. package/dist/application/query/index.d.ts +14 -8
  106. package/dist/application/query/index.js +10 -5
  107. package/dist/application/query/language/index.d.ts +2 -0
  108. package/dist/application/query/language/index.js +2 -0
  109. package/dist/application/query/language/query.d.ts +323 -0
  110. package/dist/application/query/language/query.js +2 -0
  111. package/dist/application/query/{collection → legacy/v6/collection}/identity.d.ts +2 -2
  112. package/dist/application/query/{collection → legacy/v6/collection}/metadata.d.ts +1 -1
  113. package/dist/application/query/{collection → legacy/v6/collection}/union.d.ts +4 -4
  114. package/dist/application/query/{collection → legacy/v6/collection}/union.js +15 -8
  115. package/dist/application/query/legacy/v6/conformance.d.ts +15 -0
  116. package/dist/application/query/legacy/v6/conformance.js +46 -0
  117. package/dist/application/query/legacy/v6/define.d.ts +37 -0
  118. package/dist/application/query/legacy/v6/define.js +90 -0
  119. package/dist/application/query/legacy/v6/execution/execute.d.ts +18 -0
  120. package/dist/application/query/legacy/v6/execution/execute.js +50 -0
  121. package/dist/application/query/legacy/v6/index.d.ts +7 -0
  122. package/dist/application/query/legacy/v6/index.js +3 -0
  123. package/dist/application/query/legacy/v6/kernel.d.ts +6 -0
  124. package/dist/application/query/legacy/v6/kernel.js +5 -0
  125. package/dist/application/query/{single → legacy/v6/single}/pagination.js +1 -1
  126. package/dist/application/query/{single → legacy/v6/single}/query.d.ts +2 -14
  127. package/dist/application/query/legacy/v6/single/query.js +1 -0
  128. package/dist/application/query/query.d.ts +19 -4
  129. package/dist/application/routes/admission.d.ts +3 -3
  130. package/dist/application/routes/admission.js +3 -3
  131. package/dist/application/routes/index.d.ts +3 -2
  132. package/dist/application/routes/route.d.ts +3 -3
  133. package/dist/application/runtime/actions.js +3 -0
  134. package/dist/application/runtime/declarations.d.ts +6 -6
  135. package/dist/application/runtime/define.d.ts +5 -5
  136. package/dist/application/runtime/workflows.d.ts +3 -1
  137. package/dist/application/runtime/workflows.js +3 -4
  138. package/dist/application/view/define.js +4 -6
  139. package/dist/application/view/frontend.d.ts +2 -2
  140. package/dist/application/view/index.d.ts +1 -1
  141. package/dist/application/view/route.d.ts +0 -14
  142. package/dist/application/view/route.js +1 -64
  143. package/dist/application/workflow/authoring.d.ts +3 -2
  144. package/dist/application/workflow/context.d.ts +8 -2
  145. package/dist/application/workflow/define.d.ts +4 -4
  146. package/dist/application/workflow/define.js +14 -9
  147. package/dist/application/workflow/durable.d.ts +211 -0
  148. package/dist/application/workflow/durable.js +1 -0
  149. package/dist/application/workflow/index.d.ts +3 -2
  150. package/dist/application/workflow/runner/inline.js +3 -4
  151. package/dist/application/workflow/runner/runner.d.ts +2 -2
  152. package/dist/application/workflow/step/output.d.ts +2 -0
  153. package/dist/application/workflow/step/output.js +73 -0
  154. package/dist/application/workflow/workflow.d.ts +5 -3
  155. package/dist/deployment/adapter/adapter.d.ts +55 -13
  156. package/dist/deployment/adapter/bundle/bundle.d.ts +36 -0
  157. package/dist/deployment/adapter/bundle/bundle.js +1 -0
  158. package/dist/deployment/adapter/bundle/file.d.ts +10 -0
  159. package/dist/deployment/adapter/bundle/file.js +1 -0
  160. package/dist/deployment/adapter/bundle/index.d.ts +2 -0
  161. package/dist/deployment/adapter/bundle/index.js +1 -0
  162. package/dist/deployment/adapter/define.d.ts +4 -3
  163. package/dist/deployment/adapter/define.js +107 -23
  164. package/dist/deployment/adapter/index.d.ts +4 -3
  165. package/dist/deployment/adapter/index.js +1 -0
  166. package/dist/deployment/adapter/release/command.d.ts +33 -0
  167. package/dist/deployment/adapter/release/command.js +1 -0
  168. package/dist/deployment/adapter/release/context.d.ts +94 -0
  169. package/dist/deployment/adapter/release/context.js +1 -0
  170. package/dist/deployment/adapter/release/index.d.ts +4 -0
  171. package/dist/deployment/adapter/release/index.js +1 -0
  172. package/dist/deployment/adapter/release/list.d.ts +53 -0
  173. package/dist/deployment/adapter/release/list.js +1 -0
  174. package/dist/deployment/adapter/release/refusal.d.ts +10 -0
  175. package/dist/deployment/adapter/release/refusal.js +14 -0
  176. package/dist/deployment/adapter/release/result.d.ts +56 -0
  177. package/dist/deployment/adapter/release/result.js +1 -0
  178. package/dist/deployment/address/configuration.d.ts +96 -0
  179. package/dist/deployment/address/configuration.js +274 -0
  180. package/dist/deployment/address/fingerprint.d.ts +5 -0
  181. package/dist/deployment/address/fingerprint.js +27 -0
  182. package/dist/deployment/address/index.d.ts +5 -0
  183. package/dist/deployment/address/index.js +4 -0
  184. package/dist/deployment/address/label.d.ts +42 -0
  185. package/dist/deployment/address/label.js +80 -0
  186. package/dist/deployment/address/line.d.ts +29 -0
  187. package/dist/deployment/address/line.js +53 -0
  188. package/dist/deployment/address/record.d.ts +73 -0
  189. package/dist/deployment/address/record.js +138 -0
  190. package/dist/deployment/address/summary.d.ts +30 -0
  191. package/dist/deployment/address/summary.js +1 -0
  192. package/dist/deployment/address/vectors.d.ts +60 -0
  193. package/dist/deployment/address/vectors.js +517 -0
  194. package/dist/deployment/authoring.d.ts +0 -2
  195. package/dist/deployment/authoring.js +0 -1
  196. package/dist/deployment/build/build.d.ts +15 -2
  197. package/dist/deployment/build/compile.d.ts +4 -4
  198. package/dist/deployment/build/compile.js +19 -17
  199. package/dist/deployment/build/frontend/compilation.d.ts +2 -4
  200. package/dist/deployment/build/frontend/compilation.js +0 -5
  201. package/dist/deployment/build/frontend/digest.js +1 -5
  202. package/dist/deployment/build/index.d.ts +1 -0
  203. package/dist/deployment/build/index.js +1 -0
  204. package/dist/deployment/build/manifest.d.ts +59 -0
  205. package/dist/deployment/build/manifest.js +118 -0
  206. package/dist/deployment/build/material.d.ts +2 -2
  207. package/dist/deployment/build/material.js +31 -13
  208. package/dist/deployment/build/schema.d.ts +2 -2
  209. package/dist/deployment/deployment.d.ts +3 -2
  210. package/dist/deployment/environment.d.ts +6 -0
  211. package/dist/deployment/environment.js +6 -0
  212. package/dist/deployment/index.d.ts +4 -6
  213. package/dist/deployment/index.js +1 -2
  214. package/dist/deployment/release/addressing.d.ts +6 -5
  215. package/dist/deployment/release/addressing.js +2 -3
  216. package/dist/deployment/release/assemble.d.ts +6 -3
  217. package/dist/deployment/release/assemble.js +12 -10
  218. package/dist/deployment/release/release.d.ts +16 -5
  219. package/dist/deployment/release/seal.d.ts +14 -0
  220. package/dist/deployment/release/seal.js +22 -0
  221. package/dist/deployment/release/{publication → served}/callables.d.ts +2 -2
  222. package/dist/deployment/release/{publication → served}/callables.js +2 -2
  223. package/dist/deployment/release/served/index.d.ts +11 -0
  224. package/dist/deployment/release/served/index.js +26 -0
  225. package/dist/deployment/release/{publication → served}/views.d.ts +2 -2
  226. package/dist/deployment/release/{publication → served}/views.js +0 -1
  227. package/dist/deployment/runtime/admission.d.ts +2 -2
  228. package/dist/deployment/runtime/admission.js +5 -5
  229. package/dist/deployment/verify/index.d.ts +3 -4
  230. package/dist/deployment/verify/index.js +2 -3
  231. package/dist/deployment/verify/preflight/bundle.d.ts +18 -0
  232. package/dist/deployment/verify/preflight/bundle.js +71 -0
  233. package/dist/deployment/verify/preflight/index.d.ts +1 -12
  234. package/dist/deployment/verify/preflight/index.js +1 -12
  235. package/dist/deployment/verify/readiness/fetch.d.ts +13 -0
  236. package/dist/deployment/verify/readiness/fetch.js +26 -0
  237. package/dist/deployment/verify/readiness/identity.d.ts +3 -6
  238. package/dist/deployment/verify/readiness/identity.js +3 -3
  239. package/dist/deployment/verify/readiness/index.d.ts +15 -8
  240. package/dist/deployment/verify/readiness/index.js +25 -6
  241. package/dist/deployment/verify/readiness/release.d.ts +8 -0
  242. package/dist/deployment/verify/readiness/release.js +22 -0
  243. package/dist/deployment/worker/address.d.ts +26 -0
  244. package/dist/deployment/worker/address.js +43 -0
  245. package/dist/deployment/worker/build.d.ts +60 -0
  246. package/dist/deployment/worker/build.js +172 -0
  247. package/dist/deployment/worker/configuration.d.ts +73 -0
  248. package/dist/deployment/worker/configuration.js +165 -0
  249. package/dist/deployment/worker/content.d.ts +38 -0
  250. package/dist/deployment/worker/content.js +169 -0
  251. package/dist/deployment/worker/index.d.ts +29 -0
  252. package/dist/deployment/worker/index.js +29 -0
  253. package/dist/deployment/worker/limits.d.ts +30 -0
  254. package/dist/deployment/worker/limits.js +30 -0
  255. package/dist/deployment/worker/record.d.ts +29 -0
  256. package/dist/deployment/worker/record.js +69 -0
  257. package/dist/deployment/worker/request.d.ts +118 -0
  258. package/dist/deployment/worker/request.js +280 -0
  259. package/dist/deployment/worker/response.d.ts +101 -0
  260. package/dist/deployment/worker/response.js +207 -0
  261. package/dist/execution/cache/cache.d.ts +17 -0
  262. package/dist/execution/cache/cache.js +11 -0
  263. package/dist/execution/cache/index.d.ts +2 -0
  264. package/dist/execution/cache/index.js +2 -0
  265. package/dist/execution/cache/memory.d.ts +13 -0
  266. package/dist/execution/cache/memory.js +48 -0
  267. package/dist/execution/identity/authentication.d.ts +33 -3
  268. package/dist/execution/identity/authentication.js +90 -36
  269. package/dist/execution/identity/callback.d.ts +20 -20
  270. package/dist/execution/identity/callback.js +34 -26
  271. package/dist/execution/identity/delivery.d.ts +6 -4
  272. package/dist/execution/identity/delivery.js +25 -20
  273. package/dist/execution/identity/identity.d.ts +17 -3
  274. package/dist/execution/identity/identity.js +12 -4
  275. package/dist/execution/identity/jwks.d.ts +5 -0
  276. package/dist/execution/identity/jwks.js +92 -102
  277. package/dist/execution/index.d.ts +6 -4
  278. package/dist/execution/index.js +4 -2
  279. package/dist/execution/invocation/admission/age.d.ts +57 -0
  280. package/dist/execution/invocation/admission/age.js +208 -0
  281. package/dist/execution/invocation/admission/authentication.d.ts +13 -13
  282. package/dist/execution/invocation/admission/authentication.js +52 -44
  283. package/dist/execution/invocation/admission/authority.d.ts +28 -6
  284. package/dist/execution/invocation/admission/authority.js +9 -2
  285. package/dist/execution/invocation/admission/index.d.ts +4 -3
  286. package/dist/execution/invocation/admission/index.js +3 -2
  287. package/dist/execution/invocation/admission/input.d.ts +2 -2
  288. package/dist/execution/invocation/admission/input.js +16 -2
  289. package/dist/execution/invocation/admission/target.d.ts +11 -0
  290. package/dist/execution/invocation/admission/target.js +22 -3
  291. package/dist/execution/invocation/capabilities/bind.d.ts +13 -0
  292. package/dist/execution/invocation/capabilities/bind.js +61 -0
  293. package/dist/execution/invocation/capabilities/index.d.ts +1 -0
  294. package/dist/execution/invocation/capabilities/index.js +1 -0
  295. package/dist/execution/invocation/dependency/bind.d.ts +3 -1
  296. package/dist/execution/invocation/dependency/bind.js +36 -16
  297. package/dist/execution/invocation/dispatch/action.js +4 -2
  298. package/dist/execution/invocation/dispatch/context.d.ts +7 -6
  299. package/dist/execution/invocation/dispatch/context.js +11 -44
  300. package/dist/execution/invocation/dispatch/workflow.js +4 -6
  301. package/dist/execution/invocation/handler.js +8 -2
  302. package/dist/execution/invocation/index.d.ts +2 -2
  303. package/dist/execution/invocation/index.js +1 -1
  304. package/dist/execution/invocation/integration/authentication.d.ts +3 -3
  305. package/dist/execution/invocation/integration/authentication.js +7 -7
  306. package/dist/execution/invocation/integration/call.d.ts +2 -1
  307. package/dist/execution/invocation/integration/call.js +3 -3
  308. package/dist/execution/invocation/integration/clients.d.ts +1 -1
  309. package/dist/execution/invocation/integration/index.d.ts +1 -0
  310. package/dist/execution/invocation/integration/index.js +1 -0
  311. package/dist/execution/invocation/invocation.d.ts +6 -0
  312. package/dist/execution/invocation/invocation.js +129 -21
  313. package/dist/execution/invocation/lifecycle/active.d.ts +8 -2
  314. package/dist/execution/invocation/lifecycle/active.js +3 -3
  315. package/dist/execution/invocation/lifecycle/index.d.ts +1 -1
  316. package/dist/execution/invocation/result/errors.d.ts +0 -10
  317. package/dist/execution/invocation/result/errors.js +4 -16
  318. package/dist/execution/invocation/result/index.d.ts +3 -2
  319. package/dist/execution/invocation/result/index.js +2 -1
  320. package/dist/execution/invocation/result/project.js +41 -1
  321. package/dist/execution/invocation/result/undeclared.d.ts +7 -0
  322. package/dist/execution/invocation/result/undeclared.js +18 -0
  323. package/dist/execution/node/serve.d.ts +2 -2
  324. package/dist/execution/node/serve.js +1 -1
  325. package/dist/execution/runtime/index.d.ts +1 -0
  326. package/dist/execution/runtime/index.js +1 -0
  327. package/dist/execution/runtime/load.d.ts +3 -3
  328. package/dist/execution/runtime/load.js +3 -2
  329. package/dist/execution/runtime/release.d.ts +17 -0
  330. package/dist/execution/runtime/release.js +7 -0
  331. package/dist/execution/serve.d.ts +18 -4
  332. package/dist/execution/serve.js +10 -0
  333. package/dist/execution/service/create.js +44 -7
  334. package/dist/execution/service/initialization.d.ts +4 -4
  335. package/dist/execution/service/initialization.js +23 -14
  336. package/dist/execution/service/release.d.ts +2 -2
  337. package/dist/execution/service/release.js +3 -2
  338. package/dist/execution/service/service.d.ts +20 -5
  339. package/dist/execution/service/serving/delivery.d.ts +5 -0
  340. package/dist/execution/service/{publication → serving}/delivery.js +4 -1
  341. package/dist/execution/service/{publication → serving}/index.d.ts +1 -1
  342. package/dist/execution/service/serving/installation.d.ts +4 -0
  343. package/dist/execution/service/serving/installation.js +9 -0
  344. package/dist/execution/service/serving/source.d.ts +11 -0
  345. package/dist/execution/service/serving/source.js +15 -0
  346. package/dist/execution/workflows/attempts.d.ts +87 -0
  347. package/dist/execution/workflows/attempts.js +205 -0
  348. package/dist/execution/workflows/discovery.d.ts +14 -0
  349. package/dist/execution/workflows/discovery.js +151 -0
  350. package/dist/execution/workflows/engine.d.ts +83 -0
  351. package/dist/execution/workflows/engine.js +1 -0
  352. package/dist/execution/workflows/envelope.d.ts +12 -0
  353. package/dist/execution/workflows/envelope.js +46 -0
  354. package/dist/execution/workflows/failure.d.ts +56 -0
  355. package/dist/execution/workflows/failure.js +204 -0
  356. package/dist/execution/workflows/index.d.ts +4 -0
  357. package/dist/execution/workflows/index.js +3 -0
  358. package/dist/execution/workflows/integrations.d.ts +13 -0
  359. package/dist/execution/workflows/integrations.js +25 -0
  360. package/dist/execution/workflows/options.d.ts +81 -0
  361. package/dist/execution/workflows/options.js +158 -0
  362. package/dist/execution/workflows/receiver.d.ts +27 -0
  363. package/dist/execution/workflows/receiver.js +100 -0
  364. package/dist/execution/workflows/route.d.ts +12 -0
  365. package/dist/execution/workflows/route.js +35 -0
  366. package/dist/execution/workflows/run.d.ts +23 -0
  367. package/dist/execution/workflows/run.js +369 -0
  368. package/dist/execution/workflows/steps.d.ts +51 -0
  369. package/dist/execution/workflows/steps.js +93 -0
  370. package/dist/index.d.ts +4 -4
  371. package/dist/index.js +2 -2
  372. package/dist/platform/graph/alias.d.ts +1 -5
  373. package/dist/platform/graph/alias.js +1 -5
  374. package/dist/platform/graph/document/index.d.ts +1 -1
  375. package/dist/platform/graph/document/index.js +1 -1
  376. package/dist/platform/graph/index.d.ts +1 -1
  377. package/dist/platform/graph/index.js +1 -1
  378. package/dist/platform/release/index.d.ts +2 -0
  379. package/dist/platform/release/index.js +2 -0
  380. package/dist/platform/schema/callable-authoring.d.ts +21 -0
  381. package/dist/platform/schema/callable-authoring.js +27 -0
  382. package/dist/platform/schema/class-authoring.d.ts +56 -12
  383. package/dist/platform/schema/class-authoring.js +37 -4
  384. package/dist/platform/schema/class-icon-svg.d.ts +9 -0
  385. package/dist/platform/schema/class-icon-svg.js +29 -0
  386. package/dist/platform/schema/class-icon.d.ts +3 -8
  387. package/dist/platform/schema/class-icon.js +2 -29
  388. package/dist/platform/schema/index.d.ts +6 -4
  389. package/dist/platform/schema/index.js +2 -1
  390. package/dist/platform/schema/kernel-compiled.d.ts +2 -0
  391. package/dist/platform/schema/kernel-compiled.js +2 -0
  392. package/dist/platform/schema/kernel.d.ts +4 -2
  393. package/dist/platform/schema/property.d.ts +5 -0
  394. package/dist/platform/schema/schema-authoring.d.ts +14 -7
  395. package/dist/platform/schema/schema-authoring.js +5 -1
  396. package/dist/platform/versioning/dependents.d.ts +18 -0
  397. package/dist/platform/versioning/dependents.js +15 -0
  398. package/dist/platform/versioning/index.d.ts +5 -0
  399. package/dist/platform/versioning/index.js +5 -0
  400. package/dist/platform/versioning/name.d.ts +38 -0
  401. package/dist/platform/versioning/name.js +58 -0
  402. package/dist/platform/versioning/reference.d.ts +48 -0
  403. package/dist/platform/versioning/reference.js +95 -0
  404. package/dist/platform/versioning/version.d.ts +72 -0
  405. package/dist/platform/versioning/version.js +98 -0
  406. package/dist/project/admit.js +1 -5
  407. package/dist/project/define.d.ts +4 -4
  408. package/dist/project/define.js +55 -35
  409. package/dist/project/index.d.ts +1 -1
  410. package/dist/project/install-command.d.ts +6 -0
  411. package/dist/project/install-command.js +9 -0
  412. package/dist/project/project.d.ts +10 -8
  413. package/dist/testing/dataset/define.d.ts +1 -1
  414. package/dist/testing/durable/engine.d.ts +128 -0
  415. package/dist/testing/durable/engine.js +619 -0
  416. package/dist/testing/durable/index.d.ts +3 -0
  417. package/dist/testing/durable/index.js +1 -0
  418. package/dist/testing/durable/steps.d.ts +30 -0
  419. package/dist/testing/durable/steps.js +45 -0
  420. package/dist/testing/index.d.ts +8 -1
  421. package/dist/testing/index.js +6 -1
  422. package/dist/testing/load.js +1 -1
  423. package/dist/testing/query.d.ts +17 -0
  424. package/dist/testing/query.js +34 -0
  425. package/dist/tooling/cli/adapter-command.d.ts +35 -0
  426. package/dist/tooling/cli/adapter-command.js +66 -0
  427. package/dist/tooling/cli/arguments.d.ts +17 -6
  428. package/dist/tooling/cli/arguments.js +175 -52
  429. package/dist/tooling/cli/build.d.ts +55 -0
  430. package/dist/tooling/cli/build.js +77 -0
  431. package/dist/tooling/cli/bun.d.ts +0 -1
  432. package/dist/tooling/cli/bun.js +0 -7
  433. package/dist/tooling/cli/commit.d.ts +35 -0
  434. package/dist/tooling/cli/commit.js +235 -0
  435. package/dist/tooling/cli/deploy-mode.d.ts +26 -0
  436. package/dist/tooling/cli/deploy-mode.js +59 -0
  437. package/dist/tooling/cli/deploy-result.d.ts +80 -0
  438. package/dist/tooling/cli/deploy-result.js +64 -0
  439. package/dist/tooling/cli/diff/declared.d.ts +7 -0
  440. package/dist/tooling/cli/diff/declared.js +27 -0
  441. package/dist/tooling/cli/diff/index.d.ts +30 -0
  442. package/dist/tooling/cli/diff/index.js +58 -0
  443. package/dist/tooling/cli/diff/render.d.ts +15 -0
  444. package/dist/tooling/cli/diff/render.js +131 -0
  445. package/dist/tooling/cli/diff/report.d.ts +88 -0
  446. package/dist/tooling/cli/diff/report.js +154 -0
  447. package/dist/tooling/cli/dotenv.d.ts +5 -5
  448. package/dist/tooling/cli/dotenv.js +6 -36
  449. package/dist/tooling/cli/help.js +173 -60
  450. package/dist/tooling/cli/immutable-deployment.d.ts +83 -0
  451. package/dist/tooling/cli/immutable-deployment.js +135 -0
  452. package/dist/tooling/cli/index.d.ts +12 -4
  453. package/dist/tooling/cli/index.js +6 -3
  454. package/dist/tooling/cli/installed-on.d.ts +83 -0
  455. package/dist/tooling/cli/installed-on.js +156 -0
  456. package/dist/tooling/cli/list.d.ts +152 -0
  457. package/dist/tooling/cli/list.js +331 -0
  458. package/dist/tooling/cli/log.d.ts +5 -2
  459. package/dist/tooling/cli/log.js +9 -2
  460. package/dist/tooling/cli/orchestrate.d.ts +0 -6
  461. package/dist/tooling/cli/orchestrate.js +252 -91
  462. package/dist/tooling/cli/project.d.ts +3 -3
  463. package/dist/tooling/cli/publish/index.d.ts +81 -0
  464. package/dist/tooling/cli/publish/index.js +383 -0
  465. package/dist/tooling/cli/publish/report.d.ts +49 -0
  466. package/dist/tooling/cli/publish/report.js +15 -0
  467. package/dist/tooling/cli/registry/client.d.ts +121 -0
  468. package/dist/tooling/cli/registry/client.js +354 -0
  469. package/dist/tooling/cli/registry/error.d.ts +11 -0
  470. package/dist/tooling/cli/registry/error.js +17 -0
  471. package/dist/tooling/cli/registry/executable.d.ts +35 -0
  472. package/dist/tooling/cli/registry/executable.js +96 -0
  473. package/dist/tooling/cli/registry/index.d.ts +9 -0
  474. package/dist/tooling/cli/registry/index.js +8 -0
  475. package/dist/tooling/cli/registry/installations.d.ts +67 -0
  476. package/dist/tooling/cli/registry/installations.js +108 -0
  477. package/dist/tooling/cli/registry/process.d.ts +36 -0
  478. package/dist/tooling/cli/registry/process.js +119 -0
  479. package/dist/tooling/cli/secrets.d.ts +9 -0
  480. package/dist/tooling/cli/secrets.js +19 -0
  481. package/dist/tooling/cli/yank.d.ts +34 -0
  482. package/dist/tooling/cli/yank.js +32 -0
  483. package/dist/tooling/linter/adapters/typescript/definition-calls.d.ts +34 -0
  484. package/dist/tooling/linter/adapters/typescript/definition-calls.js +88 -0
  485. package/dist/tooling/linter/adapters/typescript/imports.d.ts +0 -1
  486. package/dist/tooling/linter/adapters/typescript/imports.js +1 -5
  487. package/dist/tooling/linter/adapters/typescript/index.d.ts +3 -2
  488. package/dist/tooling/linter/adapters/typescript/index.js +3 -2
  489. package/dist/tooling/linter/adapters/typescript/query-observation.js +37 -12
  490. package/dist/tooling/linter/adapters/typescript/syntax.d.ts +3 -3
  491. package/dist/tooling/linter/adapters/typescript/syntax.js +13 -25
  492. package/dist/tooling/linter/adapters/typescript/type-analysis.d.ts +2 -0
  493. package/dist/tooling/linter/adapters/typescript/type-analysis.js +10 -0
  494. package/dist/tooling/linter/implementations/source/callable-requirements.d.ts +1 -2
  495. package/dist/tooling/linter/implementations/source/callable-requirements.js +11 -16
  496. package/dist/tooling/linter/implementations/source/definitions.d.ts +2 -0
  497. package/dist/tooling/linter/implementations/source/definitions.js +425 -0
  498. package/dist/tooling/linter/implementations/source/dependencies.js +13 -72
  499. package/dist/tooling/linter/implementations/source/global.js +18 -11
  500. package/dist/tooling/linter/implementations/source/mutations.js +146 -48
  501. package/dist/tooling/linter/implementations/source/policy-edges.d.ts +2 -0
  502. package/dist/tooling/linter/implementations/source/policy-edges.js +113 -0
  503. package/dist/tooling/linter/implementations/source/providers.js +5 -5
  504. package/dist/tooling/linter/implementations/source/queries.js +1 -17
  505. package/dist/tooling/linter/implementations/source/shared.d.ts +19 -5
  506. package/dist/tooling/linter/implementations/source/shared.js +131 -55
  507. package/dist/tooling/linter/implementations/source/verifiers.js +4 -2
  508. package/dist/tooling/linter/implementations/source/views.js +2 -2
  509. package/dist/tooling/linter/implementations/source/workflows.js +499 -17
  510. package/dist/tooling/linter/policy/generated.js +15 -64
  511. package/dist/tooling/linter/requirements/registry.js +11 -9
  512. package/dist/tooling/packaging/declarations/ownership.js +1 -1
  513. package/dist/tooling/packaging/finalize.d.ts +1 -1
  514. package/dist/tooling/packaging/finalize.js +1 -1
  515. package/docs/admission-age.md +88 -0
  516. package/docs/auth-api-migration.md +55 -0
  517. package/docs/business-errors.md +42 -0
  518. package/docs/domain-definition-migration.md +44 -0
  519. package/docs/domain-schema-migration.md +36 -0
  520. package/docs/durable-workflows.md +473 -0
  521. package/docs/handler-dependencies.md +285 -0
  522. package/docs/legacy/query-v6.md +62 -0
  523. package/docs/queries.md +475 -0
  524. package/docs/release.md +155 -0
  525. package/docs/schema-cost.md +124 -0
  526. package/package.json +49 -17
  527. package/dist/application/application.d.ts +0 -28
  528. package/dist/application/query/execution/projection.d.ts +0 -3
  529. package/dist/application/query/execution/projection.js +0 -3
  530. package/dist/deployment/adapter/deploy/context.d.ts +0 -15
  531. package/dist/deployment/adapter/deploy/index.d.ts +0 -2
  532. package/dist/deployment/adapter/deploy/result.d.ts +0 -50
  533. package/dist/deployment/adapter/prepare/artifact.d.ts +0 -33
  534. package/dist/deployment/adapter/prepare/context.d.ts +0 -23
  535. package/dist/deployment/adapter/prepare/index.d.ts +0 -2
  536. package/dist/deployment/deploy.d.ts +0 -20
  537. package/dist/deployment/deploy.js +0 -31
  538. package/dist/deployment/release/publication/index.d.ts +0 -6
  539. package/dist/deployment/release/publication/index.js +0 -6
  540. package/dist/deployment/release/publication/manifest.d.ts +0 -3
  541. package/dist/deployment/release/publication/manifest.js +0 -5
  542. package/dist/deployment/release/publication/requirements.d.ts +0 -3
  543. package/dist/deployment/release/publication/requirements.js +0 -3
  544. package/dist/deployment/release/publication/seal.d.ts +0 -10
  545. package/dist/deployment/release/publication/seal.js +0 -39
  546. package/dist/deployment/verify/preflight/artifact.d.ts +0 -6
  547. package/dist/deployment/verify/preflight/artifact.js +0 -122
  548. package/dist/deployment/verify/preflight/publication.d.ts +0 -4
  549. package/dist/deployment/verify/preflight/publication.js +0 -14
  550. package/dist/deployment/verify/readiness/deployment.d.ts +0 -3
  551. package/dist/deployment/verify/readiness/deployment.js +0 -151
  552. package/dist/deployment/verify/readiness/publication.d.ts +0 -11
  553. package/dist/deployment/verify/readiness/publication.js +0 -41
  554. package/dist/execution/service/errors.d.ts +0 -3
  555. package/dist/execution/service/errors.js +0 -3
  556. package/dist/execution/service/publication/delivery.d.ts +0 -2
  557. package/dist/execution/service/publication/installation.d.ts +0 -3
  558. package/dist/execution/service/publication/installation.js +0 -8
  559. package/dist/execution/service/publication/source.d.ts +0 -3
  560. package/dist/execution/service/publication/source.js +0 -11
  561. package/dist/platform/publication/index.d.ts +0 -2
  562. package/dist/platform/publication/index.js +0 -2
  563. package/dist/tooling/cli/astrale/authority.d.ts +0 -5
  564. package/dist/tooling/cli/astrale/authority.js +0 -11
  565. package/dist/tooling/cli/astrale/executable.d.ts +0 -2
  566. package/dist/tooling/cli/astrale/executable.js +0 -47
  567. package/dist/tooling/cli/astrale/failure.d.ts +0 -6
  568. package/dist/tooling/cli/astrale/failure.js +0 -48
  569. package/dist/tooling/cli/astrale/instance.d.ts +0 -11
  570. package/dist/tooling/cli/astrale/instance.js +0 -52
  571. package/dist/tooling/cli/astrale/process.d.ts +0 -13
  572. package/dist/tooling/cli/astrale/process.js +0 -94
  573. package/dist/tooling/cli/astrale/version.d.ts +0 -18
  574. package/dist/tooling/cli/astrale/version.js +0 -55
  575. package/dist/tooling/cli/credential.d.ts +0 -2
  576. package/dist/tooling/cli/credential.js +0 -57
  577. package/dist/tooling/cli/deprecations.d.ts +0 -9
  578. package/dist/tooling/cli/deprecations.js +0 -15
  579. package/dist/tooling/cli/development/candidate.d.ts +0 -25
  580. package/dist/tooling/cli/development/candidate.js +0 -176
  581. package/dist/tooling/cli/development/deployment.d.ts +0 -16
  582. package/dist/tooling/cli/development/deployment.js +0 -39
  583. package/dist/tooling/cli/development/develop.d.ts +0 -11
  584. package/dist/tooling/cli/development/develop.js +0 -243
  585. package/dist/tooling/cli/development/lease.d.ts +0 -18
  586. package/dist/tooling/cli/development/lease.js +0 -163
  587. package/dist/tooling/cli/development/lifecycle.d.ts +0 -9
  588. package/dist/tooling/cli/development/lifecycle.js +0 -43
  589. package/dist/tooling/cli/development/project-imports.d.ts +0 -22
  590. package/dist/tooling/cli/development/project-imports.js +0 -39
  591. package/dist/tooling/cli/development/project-lock.d.ts +0 -16
  592. package/dist/tooling/cli/development/project-lock.js +0 -41
  593. package/dist/tooling/cli/development/rebuild.d.ts +0 -13
  594. package/dist/tooling/cli/development/rebuild.js +0 -58
  595. package/dist/tooling/cli/development/release-evidence.d.ts +0 -4
  596. package/dist/tooling/cli/development/release-evidence.js +0 -10
  597. package/dist/tooling/cli/development/report.d.ts +0 -6
  598. package/dist/tooling/cli/development/report.js +0 -14
  599. package/dist/tooling/cli/development/session-file.d.ts +0 -53
  600. package/dist/tooling/cli/development/session-file.js +0 -337
  601. package/dist/tooling/cli/development/source-watch.d.ts +0 -14
  602. package/dist/tooling/cli/development/source-watch.js +0 -140
  603. package/dist/tooling/cli/development/sources.d.ts +0 -7
  604. package/dist/tooling/cli/development/sources.js +0 -48
  605. package/dist/tooling/cli/development/target-lock.d.ts +0 -16
  606. package/dist/tooling/cli/development/target-lock.js +0 -68
  607. package/dist/tooling/cli/development/view.d.ts +0 -28
  608. package/dist/tooling/cli/development/view.js +0 -151
  609. package/dist/tooling/cli/environment-release.d.ts +0 -21
  610. package/dist/tooling/cli/environment-release.js +0 -46
  611. package/dist/tooling/cli/evidence.d.ts +0 -11
  612. package/dist/tooling/cli/evidence.js +0 -53
  613. package/dist/tooling/cli/installation/index.d.ts +0 -2
  614. package/dist/tooling/cli/installation/index.js +0 -1
  615. package/dist/tooling/cli/installation/observation.d.ts +0 -10
  616. package/dist/tooling/cli/installation/observation.js +0 -44
  617. package/dist/tooling/cli/installation/reconcile.d.ts +0 -32
  618. package/dist/tooling/cli/installation/reconcile.js +0 -122
  619. package/dist/tooling/linter/implementations/source/migrations.d.ts +0 -2
  620. package/dist/tooling/linter/implementations/source/migrations.js +0 -113
  621. package/dist/tooling/linter/qualification/index.d.ts +0 -10
  622. package/dist/tooling/linter/qualification/index.js +0 -2
  623. package/dist/tooling/linter/qualification/query-fixtures.d.ts +0 -2
  624. package/dist/tooling/linter/qualification/query-fixtures.js +0 -68
  625. package/dist/tooling/linter/qualification/runner.d.ts +0 -3
  626. package/dist/tooling/linter/qualification/runner.js +0 -6
  627. /package/dist/application/{application.js → domain.js} +0 -0
  628. /package/dist/application/{query/single/query.js → mutation/legacy/v6/builder.js} +0 -0
  629. /package/dist/{deployment/adapter/deploy/context.js → application/mutation/legacy/v6/mutation.js} +0 -0
  630. /package/dist/application/mutation/{authoring → legacy/v6}/precondition.js +0 -0
  631. /package/dist/{deployment/adapter/deploy/index.js → application/query/answer/answer.js} +0 -0
  632. /package/dist/{deployment/adapter/deploy/result.js → application/query/defined/query.js} +0 -0
  633. /package/dist/{deployment/adapter/prepare/artifact.js → application/query/execution/client.js} +0 -0
  634. /package/dist/{deployment/adapter/prepare/context.js → application/query/handles/conditions.js} +0 -0
  635. /package/dist/{deployment/adapter/prepare/index.js → application/query/handles/domain.js} +0 -0
  636. /package/dist/application/query/{collection → legacy/v6/collection}/identity.js +0 -0
  637. /package/dist/application/query/{collection → legacy/v6/collection}/limits.d.ts +0 -0
  638. /package/dist/application/query/{collection → legacy/v6/collection}/limits.js +0 -0
  639. /package/dist/application/query/{collection → legacy/v6/collection}/metadata.js +0 -0
  640. /package/dist/application/query/{execution → legacy/v6/execution}/pages.d.ts +0 -0
  641. /package/dist/application/query/{execution → legacy/v6/execution}/pages.js +0 -0
  642. /package/dist/application/query/{single → legacy/v6/single}/index.d.ts +0 -0
  643. /package/dist/application/query/{single → legacy/v6/single}/index.js +0 -0
  644. /package/dist/application/query/{single → legacy/v6/single}/node.d.ts +0 -0
  645. /package/dist/application/query/{single → legacy/v6/single}/node.js +0 -0
  646. /package/dist/application/query/{single → legacy/v6/single}/pagination.d.ts +0 -0
  647. /package/dist/application/query/{single → legacy/v6/single}/selection.d.ts +0 -0
  648. /package/dist/application/query/{single → legacy/v6/single}/selection.js +0 -0
  649. /package/dist/deployment/release/{publication → served}/routes.d.ts +0 -0
  650. /package/dist/deployment/release/{publication → served}/routes.js +0 -0
  651. /package/dist/execution/service/{publication → serving}/index.js +0 -0
@@ -0,0 +1,619 @@
1
+ import { bindProviders } from '../../application/integration/index.js';
2
+ import { runtimeCallables } from '../../application/runtime/callables.js';
3
+ import { admitWorkflows } from '../../application/runtime/workflows.js';
4
+ import { durableServing } from '../../execution/workflows/options.js';
5
+ import { durableHandlers } from '../../execution/workflows/run.js';
6
+ import { issuer } from '../../platform/auth/index.js';
7
+ import { NodeId as nodeId } from '../../platform/graph/node/index.js';
8
+ import { testSteps } from './steps.js';
9
+ /** Kernel every test Execution names; Steps never reach it. */
10
+ const TEST_KERNEL = issuer.accept('https://kernel.test.astrale.invalid');
11
+ /** Microtask turns without progress after which a blocked attempt counts as suspended. */
12
+ const QUIET_TURNS = 64;
13
+ /** Metadata the Kernel reads a declared failure from. */
14
+ const FAILURE = 'astrale.failure';
15
+ /** Metadata a failed Step attempt's journal entry records it under. */
16
+ const ATTEMPT = 'astrale.attempt';
17
+ /** Name prefix of the wait a Step's code failure prescribes before its next attempt. */
18
+ const BACKOFF = 'retry:';
19
+ class TerminalError extends Error {
20
+ code;
21
+ metadata;
22
+ constructor(message, options) {
23
+ super(message);
24
+ this.name = 'TerminalError';
25
+ this.code = options?.errorCode ?? 500;
26
+ if (options?.metadata !== undefined)
27
+ this.metadata = Object.freeze({ ...options.metadata });
28
+ }
29
+ }
30
+ class CancelledError extends TerminalError {
31
+ constructor() {
32
+ super('Cancelled', { errorCode: 409 });
33
+ this.name = 'CancelledError';
34
+ }
35
+ }
36
+ class TimeoutError extends TerminalError {
37
+ constructor() {
38
+ super('Timeout occurred', { errorCode: 408 });
39
+ this.name = 'TimeoutError';
40
+ }
41
+ }
42
+ class RetryableError extends Error {
43
+ retryAfter;
44
+ constructor(message, options) {
45
+ super(message, options?.cause === undefined ? undefined : { cause: options.cause });
46
+ this.name = 'RetryableError';
47
+ if (options?.retryAfter !== undefined)
48
+ this.retryAfter = options.retryAfter;
49
+ }
50
+ }
51
+ /** The attempt lost its Step result on purpose; the engine retries it. */
52
+ class Interruption extends Error {
53
+ constructor(step) {
54
+ super(`Test interruption after Step ${step}, before the journal recorded it.`);
55
+ this.name = 'Interruption';
56
+ }
57
+ }
58
+ /** The Workflow did not do what its journal recorded at this position. */
59
+ class JournalMismatch extends Error {
60
+ constructor(index, recorded, requested) {
61
+ super(`Journal entry ${index} recorded ${recorded}, but the Workflow requested ${requested}: ` +
62
+ 'code between Steps must be deterministic.');
63
+ this.name = 'JournalMismatch';
64
+ }
65
+ }
66
+ /** The promises the test workflow engine's `run` returned: the only ones its combinator accepts. */
67
+ const RUNS = new WeakSet();
68
+ const ENGINE = Object.freeze({
69
+ createEndpointHandler: () => () => Promise.reject(new Error('A test workflow engine serves no HTTP.')),
70
+ workflow: (definition) => definition,
71
+ TerminalError,
72
+ CancelledError,
73
+ RetryableError,
74
+ TimeoutError,
75
+ RestatePromise: Object.freeze({
76
+ allSettled(values) {
77
+ // As the engine refuses a promise it did not create: only its own runs combine.
78
+ values.forEach((value, index) => {
79
+ if (!RUNS.has(value)) {
80
+ throw new TypeError(`Promise index ${index} used inside the combinator is not a run.`);
81
+ }
82
+ });
83
+ return Promise.allSettled(values);
84
+ },
85
+ }),
86
+ });
87
+ /** Create an in-memory workflow engine for tests. */
88
+ export function createTestWorkflowEngine(options = {}) {
89
+ const serving = durableServing({
90
+ engine: ENGINE,
91
+ ...(options.retry === undefined ? {} : { retry: options.retry }),
92
+ });
93
+ const maxAttempts = serving.retryPolicy.maxAttempts;
94
+ let now = options.now ?? Date.now();
95
+ if (!Number.isFinite(now))
96
+ throw new TypeError('Test workflow engine now must be finite.');
97
+ let sequence = 0;
98
+ const runs = new Set();
99
+ const clock = { now: () => now };
100
+ return Object.freeze({
101
+ get now() {
102
+ return now;
103
+ },
104
+ async start(workflow, input) {
105
+ sequence += 1;
106
+ const run = new TestRun(workflow, input, clock, serving, maxAttempts, sequence);
107
+ runs.add(run);
108
+ await run.settle();
109
+ return run.execution;
110
+ },
111
+ async advance(durationMs) {
112
+ if (!Number.isSafeInteger(durationMs) || durationMs < 0) {
113
+ throw new TypeError('Test workflow engine advance takes a non-negative integer of milliseconds.');
114
+ }
115
+ now += durationMs;
116
+ for (const run of runs)
117
+ if (run.state === 'waiting')
118
+ await run.settle();
119
+ },
120
+ });
121
+ }
122
+ class TestRun {
123
+ clock;
124
+ maxAttempts;
125
+ state = 'running';
126
+ outcome;
127
+ failure;
128
+ attempts = 0;
129
+ journal = [];
130
+ signals = new Map();
131
+ interruptions = new Set();
132
+ cancellation = 'none';
133
+ /** The waits after a Step's own failures the run did not wait out, which its Steps still spent. */
134
+ skipped = 0;
135
+ failures = 0;
136
+ handlers;
137
+ envelope;
138
+ execution;
139
+ constructor(workflow, input, clock, serving, maxAttempts, sequence) {
140
+ this.clock = clock;
141
+ this.maxAttempts = maxAttempts;
142
+ const domain = input.schema;
143
+ const [admitted] = admitWorkflows(runtimeCallables(domain), [workflow]);
144
+ if (admitted === undefined || !admitted.durable) {
145
+ throw new TypeError(`Workflow ${workflow.address} is not durable: its callable must declare execution: { durable: true }.`);
146
+ }
147
+ const providers = (input.providers ?? {});
148
+ const integrations = Object.fromEntries(Object.entries(providers).map(([name, provider]) => [name, provider.integration]));
149
+ this.handlers = durableHandlers({
150
+ kernel: TEST_KERNEL,
151
+ workflow: admitted,
152
+ domain,
153
+ serving,
154
+ now: () => this.clock.now() + this.skipped,
155
+ steps: testSteps({
156
+ domain,
157
+ capabilities: (input.capabilities ?? {}),
158
+ integrations: bindProviders(integrations, providers),
159
+ }),
160
+ });
161
+ const id = input.id ?? nodeId(`execution-test-${String(sequence).padStart(6, '0')}`);
162
+ this.envelope = Object.freeze({
163
+ execution: id,
164
+ function: { id: `function-test-${admitted.address}`, version: `sha256:${'0'.repeat(64)}` },
165
+ kernel: TEST_KERNEL,
166
+ initiator: input.initiator ?? { principal: 'principal-test', caller: 'caller-test' },
167
+ input: input.input,
168
+ ...(input.self === undefined ? {} : { receiver: input.self }),
169
+ });
170
+ for (const step of (input.interruptAfter ?? [])) {
171
+ this.interruptions.add(`step:${step}`);
172
+ }
173
+ this.execution = this.view(id);
174
+ }
175
+ /** Attempt the run until it ends, waits, or pauses. */
176
+ async settle() {
177
+ if (this.ended || this.state === 'paused')
178
+ return;
179
+ this.state = 'running';
180
+ for (;;) {
181
+ const attempted = await this.attempt('run');
182
+ if (attempted.kind === 'suspended') {
183
+ this.state = 'waiting';
184
+ return;
185
+ }
186
+ if (attempted.kind === 'completed') {
187
+ this.end({ kind: 'completed', value: attempted.value });
188
+ return;
189
+ }
190
+ if (attempted.kind === 'retried') {
191
+ this.failure = attempted.error;
192
+ continue;
193
+ }
194
+ const { error } = attempted;
195
+ if (error instanceof TerminalError) {
196
+ this.end(outcomeOf(error));
197
+ return;
198
+ }
199
+ this.failure = error;
200
+ this.failures += 1;
201
+ if (this.failures >= this.maxAttempts) {
202
+ this.state = 'paused';
203
+ return;
204
+ }
205
+ }
206
+ }
207
+ get ended() {
208
+ return this.state === 'completed' || this.state === 'failed' || this.state === 'cancelled';
209
+ }
210
+ end(outcome) {
211
+ this.outcome = Object.freeze(outcome);
212
+ this.state = outcome.kind;
213
+ }
214
+ /** One attempt of the run: replay the journal, then run on until it ends or blocks. */
215
+ attempt(mode) {
216
+ this.attempts += 1;
217
+ const attempt = new Attempt(this, mode);
218
+ const running = Promise.resolve()
219
+ .then(() => this.handlers.run(attempt.context, this.envelope))
220
+ .then((value) => ({ kind: 'completed', value }), (error) => ({ kind: 'failed', error }))
221
+ .finally(() => attempt.finish());
222
+ return Promise.race([running, attempt.suspended(), attempt.ended]).finally(() => attempt.finish());
223
+ }
224
+ async signal(name, value) {
225
+ if (this.ended)
226
+ throw new Error(`Execution ${String(this.envelope.execution)} has ended.`);
227
+ const shared = {
228
+ promise: (promise) => ({
229
+ resolve: async (resolved) => {
230
+ if (this.signals.has(promise))
231
+ throw new TerminalError('Promise already resolved.');
232
+ this.signals.set(promise, resolved);
233
+ },
234
+ }),
235
+ };
236
+ const { accepted } = (await this.handlers.signal(shared, { name, value }));
237
+ if (this.state === 'waiting')
238
+ await this.settle();
239
+ return accepted;
240
+ }
241
+ async cancel() {
242
+ if (this.ended)
243
+ return;
244
+ if (this.cancellation === 'none')
245
+ this.cancellation = 'requested';
246
+ if (this.state === 'paused') {
247
+ this.failures = 0;
248
+ this.state = 'running';
249
+ }
250
+ await this.settle();
251
+ }
252
+ async resume() {
253
+ if (this.state !== 'paused') {
254
+ throw new Error(`Execution ${String(this.envelope.execution)} is not paused.`);
255
+ }
256
+ this.failures = 0;
257
+ this.state = 'running';
258
+ await this.settle();
259
+ }
260
+ async replay() {
261
+ if (this.state === 'paused' || this.state === 'running') {
262
+ throw new Error('Replay an Execution that ended or waits; resume a paused one first.');
263
+ }
264
+ const attempted = await this.attempt('replay');
265
+ if (this.state === 'waiting') {
266
+ if (attempted.kind !== 'suspended')
267
+ throw divergence('ended instead of waiting', attempted);
268
+ return;
269
+ }
270
+ const outcome = attempted.kind === 'completed'
271
+ ? { kind: 'completed', value: attempted.value }
272
+ : attempted.kind === 'failed' && attempted.error instanceof TerminalError
273
+ ? outcomeOf(attempted.error)
274
+ : undefined;
275
+ if (outcome === undefined || JSON.stringify(outcome) !== JSON.stringify(this.outcome)) {
276
+ throw divergence(`did not reach ${JSON.stringify(this.outcome)}`, attempted);
277
+ }
278
+ }
279
+ view(id) {
280
+ const live = (read) => ({ enumerable: true, get: read });
281
+ return Object.freeze(Object.defineProperties({
282
+ id,
283
+ signal: (name, value) => this.signal(name, value),
284
+ cancel: () => this.cancel(),
285
+ resume: () => this.resume(),
286
+ replay: () => this.replay(),
287
+ interruptAfter: (step) => {
288
+ this.interruptions.add(`step:${step}`);
289
+ },
290
+ }, {
291
+ state: live(() => this.state),
292
+ outcome: live(() => this.outcome),
293
+ failure: live(() => this.failure),
294
+ attempts: live(() => this.attempts),
295
+ journal: live(() => Object.freeze(this.journal.map(snapshot))),
296
+ }));
297
+ }
298
+ }
299
+ /**
300
+ * The engine context of one attempt. Every operation takes the next journal position: a settled
301
+ * entry answers as it did, a pending one waits, and a new one runs. A replay records nothing new.
302
+ */
303
+ class Attempt {
304
+ run;
305
+ mode;
306
+ cursor = 0;
307
+ active = 0;
308
+ blocked = 0;
309
+ progress = 0;
310
+ done = false;
311
+ controller = new AbortController();
312
+ end;
313
+ /** Settles when a Step ends the attempt without reaching the Workflow, as a retry or a crash. */
314
+ ended = new Promise((resolve) => {
315
+ this.end = resolve;
316
+ });
317
+ context;
318
+ constructor(run, mode) {
319
+ this.run = run;
320
+ this.mode = mode;
321
+ this.context = Object.freeze({
322
+ run: (name, action) => {
323
+ const run = this.journalRun(name, action);
324
+ RUNS.add(run);
325
+ return run;
326
+ },
327
+ sleep: (durationMs, name) => this.sleep(durationMs, name ?? ''),
328
+ promise: (name) => ({ get: () => this.promise(name) }),
329
+ request: () => ({ attemptCompletedSignal: this.controller.signal }),
330
+ });
331
+ }
332
+ finish() {
333
+ if (this.done)
334
+ return;
335
+ this.done = true;
336
+ this.controller.abort();
337
+ }
338
+ /** Resolves once the attempt waits on a pending entry and nothing else can move it. */
339
+ async suspended() {
340
+ for (;;) {
341
+ if (this.done)
342
+ return new Promise(() => { });
343
+ if (this.active > 0) {
344
+ await macrotask();
345
+ continue;
346
+ }
347
+ const before = this.progress;
348
+ for (let turn = 0; turn < QUIET_TURNS && this.progress === before; turn++) {
349
+ await Promise.resolve();
350
+ }
351
+ if (this.done)
352
+ return new Promise(() => { });
353
+ if (this.progress !== before)
354
+ continue;
355
+ if (this.blocked > 0)
356
+ return { kind: 'suspended' };
357
+ await macrotask();
358
+ }
359
+ }
360
+ take(kind, name) {
361
+ this.progress += 1;
362
+ const index = this.cursor++;
363
+ const recorded = this.run.journal[index];
364
+ if (recorded !== undefined) {
365
+ if (recorded.kind !== kind || recorded.name !== name) {
366
+ throw new JournalMismatch(index, describe(recorded), describe({ kind, name }));
367
+ }
368
+ return recorded;
369
+ }
370
+ if (this.mode === 'replay') {
371
+ throw new JournalMismatch(index, 'nothing', describe({ kind, name }));
372
+ }
373
+ const entry = { kind, name, settled: false };
374
+ this.run.journal.push(entry);
375
+ return entry;
376
+ }
377
+ /** Deliver a requested cancellation to the first entry that is not settled yet. */
378
+ cancelled(entry) {
379
+ if (this.mode === 'replay' || this.run.cancellation !== 'requested')
380
+ return false;
381
+ this.run.cancellation = 'delivered';
382
+ entry.settled = true;
383
+ entry.error = new CancelledError();
384
+ if (entry.kind === 'race')
385
+ entry.outcome = 'cancelled';
386
+ return true;
387
+ }
388
+ answer(entry) {
389
+ return entry.error === undefined
390
+ ? Promise.resolve(entry.value)
391
+ : Promise.reject(entry.error);
392
+ }
393
+ block() {
394
+ this.blocked += 1;
395
+ this.progress += 1;
396
+ return new Promise(() => { });
397
+ }
398
+ /**
399
+ * One journaled `run`. A `TerminalError` settles the entry; any other failure reaches the
400
+ * Workflow unjournaled, so the `run` runs again on the next attempt.
401
+ */
402
+ journalRun(name, action) {
403
+ let entry;
404
+ try {
405
+ entry = this.take('run', name);
406
+ }
407
+ catch (cause) {
408
+ return Promise.reject(cause);
409
+ }
410
+ if (entry.settled)
411
+ return this.answer(entry);
412
+ if (this.cancelled(entry))
413
+ return this.answer(entry);
414
+ if (this.mode === 'replay') {
415
+ return Promise.reject(new JournalMismatch(this.cursor - 1, 'a pending entry', `${name} to run again`));
416
+ }
417
+ this.active += 1;
418
+ entry.attempts = (entry.attempts ?? 0) + 1;
419
+ return (async () => {
420
+ try {
421
+ const value = await action();
422
+ // A Step that completes once its attempt ended, as a parallel sibling may, is lost with it.
423
+ if (this.done)
424
+ return this.block();
425
+ if (this.run.interruptions.delete(name)) {
426
+ // A crash after the effect: the run is attempted again, and the Step with it.
427
+ this.end({ kind: 'failed', error: new Interruption(name.replace(/^step:/u, '')) });
428
+ return this.block();
429
+ }
430
+ entry.settled = true;
431
+ entry.value = value;
432
+ return value;
433
+ }
434
+ catch (cause) {
435
+ if (this.done)
436
+ return this.block();
437
+ if (cause instanceof TerminalError) {
438
+ entry.settled = true;
439
+ entry.error = cause;
440
+ // A failed Step attempt keeps what it threw on the live error, which tests inspect.
441
+ if (cause.metadata?.[ATTEMPT] !== undefined) {
442
+ this.run.failure = cause.cause ?? cause;
443
+ }
444
+ throw cause;
445
+ }
446
+ this.run.failure = cause;
447
+ throw cause;
448
+ }
449
+ finally {
450
+ this.active -= 1;
451
+ this.progress += 1;
452
+ }
453
+ })();
454
+ }
455
+ /**
456
+ * A durable timer on the virtual clock. The wait after a Step's own failure is not waited out: it
457
+ * settles at once and ends the attempt, as a timer that suspends the run does, and the time it
458
+ * skipped counts toward the Step's `maxDurationMs`.
459
+ */
460
+ sleep(durationMs, name) {
461
+ let entry;
462
+ try {
463
+ entry = this.take('sleep', name);
464
+ }
465
+ catch (cause) {
466
+ return Promise.reject(cause);
467
+ }
468
+ entry.until ??= this.run.clock.now() + durationMs;
469
+ if (entry.settled)
470
+ return this.answer(entry);
471
+ if (this.mode === 'run' && name.startsWith(BACKOFF)) {
472
+ entry.settled = true;
473
+ // An attempt takes time too: a zero delay still spends a duration budget, by a millisecond.
474
+ this.run.skipped += Math.max(1, durationMs);
475
+ this.end({ kind: 'retried', error: this.run.failure });
476
+ return this.block();
477
+ }
478
+ if (this.run.clock.now() >= entry.until) {
479
+ if (this.mode === 'run')
480
+ entry.settled = true;
481
+ return Promise.resolve();
482
+ }
483
+ if (this.cancelled(entry))
484
+ return this.answer(entry);
485
+ return this.block();
486
+ }
487
+ /**
488
+ * The engine promise of signal `name`. Awaited, it waits for the signal; `orTimeout` races it
489
+ * against a timer instead, so only one of the two takes a journal position.
490
+ */
491
+ promise(name) {
492
+ let raced = false;
493
+ const awaited = Promise.resolve().then(() => (raced ? new Promise(() => { }) : this.wait(name)));
494
+ return Object.assign(awaited, {
495
+ orTimeout: (millis) => {
496
+ raced = true;
497
+ return this.race(name, millis);
498
+ },
499
+ });
500
+ }
501
+ wait(name) {
502
+ let entry;
503
+ try {
504
+ entry = this.take('signal', name);
505
+ }
506
+ catch (cause) {
507
+ return Promise.reject(cause);
508
+ }
509
+ if (entry.settled)
510
+ return this.answer(entry);
511
+ if (this.run.signals.has(name))
512
+ return this.settle(entry, this.run.signals.get(name));
513
+ if (this.cancelled(entry))
514
+ return this.answer(entry);
515
+ return this.block();
516
+ }
517
+ race(name, millis) {
518
+ let entry;
519
+ try {
520
+ entry = this.take('race', name);
521
+ }
522
+ catch (cause) {
523
+ return Promise.reject(cause);
524
+ }
525
+ entry.until ??= this.run.clock.now() + millis;
526
+ if (entry.settled)
527
+ return this.answer(entry);
528
+ if (this.run.signals.has(name)) {
529
+ if (this.mode === 'run')
530
+ entry.outcome = 'signal';
531
+ return this.settle(entry, this.run.signals.get(name));
532
+ }
533
+ if (this.run.clock.now() >= entry.until) {
534
+ if (this.mode === 'run') {
535
+ entry.settled = true;
536
+ entry.outcome = 'timeout';
537
+ entry.error = new TimeoutError();
538
+ }
539
+ return Promise.reject(new TimeoutError());
540
+ }
541
+ if (this.cancelled(entry))
542
+ return this.answer(entry);
543
+ return this.block();
544
+ }
545
+ settle(entry, value) {
546
+ if (this.mode === 'run') {
547
+ entry.settled = true;
548
+ entry.value = value;
549
+ }
550
+ return Promise.resolve(value);
551
+ }
552
+ }
553
+ function outcomeOf(error) {
554
+ const declared = error.metadata?.[FAILURE];
555
+ if (declared !== undefined) {
556
+ const failure = JSON.parse(declared);
557
+ return {
558
+ kind: 'failed',
559
+ error: Object.freeze({
560
+ ...(failure.family === undefined ? {} : { family: failure.family }),
561
+ code: failure.code,
562
+ message: failure.message,
563
+ ...(failure.details === undefined ? {} : { details: failure.details }),
564
+ }),
565
+ };
566
+ }
567
+ // As the Kernel decodes it: a bare 409 is the engine's cancellation.
568
+ if (error.code === 409)
569
+ return { kind: 'cancelled' };
570
+ return {
571
+ kind: 'failed',
572
+ error: Object.freeze({ code: String(error.code), message: error.message }),
573
+ };
574
+ }
575
+ function snapshot(entry) {
576
+ switch (entry.kind) {
577
+ case 'run':
578
+ return Object.freeze({
579
+ kind: 'run',
580
+ name: entry.name,
581
+ settled: entry.settled,
582
+ attempts: entry.attempts ?? 0,
583
+ ...(entry.settled && entry.error === undefined ? { value: entry.value } : {}),
584
+ ...(entry.error === undefined ? {} : { error: entry.error }),
585
+ });
586
+ case 'sleep':
587
+ return Object.freeze({
588
+ kind: 'sleep',
589
+ ...(entry.name === '' ? {} : { name: entry.name }),
590
+ until: entry.until,
591
+ settled: entry.settled,
592
+ });
593
+ case 'signal':
594
+ return Object.freeze({
595
+ kind: 'signal',
596
+ name: entry.name,
597
+ settled: entry.settled,
598
+ ...(entry.settled && entry.error === undefined ? { value: entry.value } : {}),
599
+ });
600
+ case 'race':
601
+ return Object.freeze({
602
+ kind: 'race',
603
+ name: entry.name,
604
+ until: entry.until,
605
+ settled: entry.settled,
606
+ ...(entry.outcome === undefined ? {} : { outcome: entry.outcome }),
607
+ });
608
+ }
609
+ }
610
+ function describe(entry) {
611
+ return entry.name === '' ? entry.kind : `${entry.kind} ${entry.name}`;
612
+ }
613
+ function divergence(reason, attempted) {
614
+ const cause = attempted.kind === 'failed' ? attempted.error : undefined;
615
+ return new Error(`Replay diverged: the Workflow ${reason}.`, { cause });
616
+ }
617
+ function macrotask() {
618
+ return new Promise((resolve) => setTimeout(resolve, 0));
619
+ }
@@ -0,0 +1,3 @@
1
+ export { createTestWorkflowEngine } from './engine.js';
2
+ export type { TestExecution, TestJournalEntry, TestStartOptions, TestWorkflowEngine, TestWorkflowEngineOptions, } from './engine.js';
3
+ export type { TestStepCapabilities } from './steps.js';
@@ -0,0 +1 @@
1
+ export { createTestWorkflowEngine } from './engine.js';
@@ -0,0 +1,30 @@
1
+ import type { IntegrationClientFactory, Integrations } from '../../application/integration/index.js';
2
+ import type { StepAuthorities } from '../../execution/workflows/steps.js';
3
+ import type { BoundClientSession } from '../../platform/client/session/index.js';
4
+ import type { Domain } from '../../platform/schema/index.js';
5
+ /**
6
+ * What the Steps of a test Execution reach instead of a Kernel. Each answers the calls a Step makes
7
+ * through its capabilities; an absent one fails the call that needs it.
8
+ */
9
+ export interface TestStepCapabilities {
10
+ /** Answers each Query a Step runs, through `query`, `graph.query` or `step.query`. */
11
+ readonly query?: (query: object, input: unknown) => unknown;
12
+ /**
13
+ * Answers each Mutation a Step runs, through `mutate`, `graph.mutate` or `step.mutate`. `call`
14
+ * carries the key the Host engine sends, so a retried Step presents the same one.
15
+ */
16
+ readonly mutate?: (mutation: object, input: unknown, call: {
17
+ readonly idempotencyKey: string;
18
+ }) => unknown;
19
+ /**
20
+ * The Kernel Session of a Step. `kernel.invoke` and every `dependencies` call reach its `invoke`,
21
+ * with the Step's next key in `options.idempotencyKey` when the callee is durable.
22
+ */
23
+ readonly kernel?: Partial<BoundClientSession>;
24
+ }
25
+ /** Bind each Step attempt of a test Execution to the test's capabilities, keyed as on a Host. */
26
+ export declare function testSteps(input: {
27
+ readonly domain: Domain;
28
+ readonly capabilities: TestStepCapabilities;
29
+ readonly integrations: IntegrationClientFactory<Integrations>;
30
+ }): StepAuthorities;