@astrale-os/sdk 0.6.0-beta.6 → 0.6.0-beta.60

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 (717) hide show
  1. package/README.md +220 -66
  2. package/dist/application/action/action.d.ts +6 -0
  3. package/dist/application/action/authoring.d.ts +3 -1
  4. package/dist/application/action/authoring.js +1 -0
  5. package/dist/application/action/context.d.ts +95 -34
  6. package/dist/application/action/define.d.ts +3 -3
  7. package/dist/application/action/index.d.ts +3 -1
  8. package/dist/application/action/index.js +1 -0
  9. package/dist/application/define.d.ts +8 -6
  10. package/dist/application/define.js +28 -14
  11. package/dist/application/dependency/index.d.ts +1 -1
  12. package/dist/application/dependency/invoker.d.ts +21 -10
  13. package/dist/application/domain.d.ts +30 -0
  14. package/dist/application/error/error.d.ts +16 -1
  15. package/dist/application/error/error.js +39 -5
  16. package/dist/application/error/index.d.ts +1 -1
  17. package/dist/application/error/index.js +1 -1
  18. package/dist/application/file/binary.d.ts +11 -0
  19. package/dist/application/file/binary.js +45 -0
  20. package/dist/application/file/file.d.ts +77 -0
  21. package/dist/application/file/file.js +111 -0
  22. package/dist/application/file/index.d.ts +4 -0
  23. package/dist/application/file/index.js +2 -0
  24. package/dist/application/file/input.d.ts +13 -0
  25. package/dist/application/file/input.js +57 -0
  26. package/dist/application/index.d.ts +6 -5
  27. package/dist/application/index.js +1 -1
  28. package/dist/application/integration/define.d.ts +8 -1
  29. package/dist/application/integration/index.d.ts +2 -2
  30. package/dist/application/integration/integration.d.ts +13 -1
  31. package/dist/application/integration/operation.d.ts +16 -3
  32. package/dist/application/mutation/authoring/builder.d.ts +81 -33
  33. package/dist/application/mutation/authoring/builder.js +100 -30
  34. package/dist/application/mutation/authoring/guard.d.ts +37 -0
  35. package/dist/application/mutation/authoring/guard.js +150 -0
  36. package/dist/application/mutation/authoring/index.d.ts +5 -2
  37. package/dist/application/mutation/authoring/index.js +2 -1
  38. package/dist/application/mutation/authoring/names.d.ts +19 -0
  39. package/dist/application/mutation/authoring/names.js +83 -0
  40. package/dist/application/mutation/authoring/properties.d.ts +17 -4
  41. package/dist/application/mutation/authoring/properties.js +38 -2
  42. package/dist/application/mutation/authoring/transition.d.ts +3 -2
  43. package/dist/application/mutation/authoring/transition.js +4 -1
  44. package/dist/application/mutation/define.d.ts +24 -10
  45. package/dist/application/mutation/define.js +49 -53
  46. package/dist/application/mutation/execution/execute.d.ts +2 -2
  47. package/dist/application/mutation/execution/execute.js +78 -7
  48. package/dist/application/mutation/execution/executor.d.ts +4 -1
  49. package/dist/application/mutation/execution/executor.js +6 -1
  50. package/dist/application/mutation/failure.d.ts +17 -1
  51. package/dist/application/mutation/failure.js +40 -19
  52. package/dist/application/mutation/index.d.ts +9 -5
  53. package/dist/application/mutation/index.js +5 -2
  54. package/dist/application/mutation/legacy/v6/builder.d.ts +84 -0
  55. package/dist/application/mutation/legacy/v6/define.d.ts +18 -0
  56. package/dist/application/mutation/legacy/v6/define.js +56 -0
  57. package/dist/application/mutation/legacy/v6/mutation.d.ts +28 -0
  58. package/dist/application/mutation/{authoring → legacy/v6}/precondition.d.ts +4 -0
  59. package/dist/application/mutation/mutation.d.ts +47 -19
  60. package/dist/application/query/answer/answer.d.ts +117 -0
  61. package/dist/application/query/answer/conformance.d.ts +4 -0
  62. package/dist/application/query/answer/conformance.js +27 -0
  63. package/dist/application/query/answer/facts.d.ts +17 -0
  64. package/dist/application/query/answer/facts.js +57 -0
  65. package/dist/application/query/composite/builder.d.ts +1 -1
  66. package/dist/application/query/composite/builder.js +2 -2
  67. package/dist/application/query/composite/plan.d.ts +1 -5
  68. package/dist/application/query/composite/plan.js +1 -3
  69. package/dist/application/query/composite/query.d.ts +1 -2
  70. package/dist/application/query/define.d.ts +3 -34
  71. package/dist/application/query/define.js +5 -131
  72. package/dist/application/query/defined/define.d.ts +45 -0
  73. package/dist/application/query/defined/define.js +96 -0
  74. package/dist/application/query/defined/query.d.ts +139 -0
  75. package/dist/application/query/definition.d.ts +12 -0
  76. package/dist/application/query/definition.js +47 -0
  77. package/dist/application/query/execution/bounds.d.ts +22 -0
  78. package/dist/application/query/execution/bounds.js +88 -0
  79. package/dist/application/query/execution/client.d.ts +21 -0
  80. package/dist/application/query/execution/crossings.d.ts +30 -0
  81. package/dist/application/query/execution/crossings.js +232 -0
  82. package/dist/application/query/execution/error.d.ts +71 -0
  83. package/dist/application/query/execution/error.js +50 -0
  84. package/dist/application/query/execution/execute.d.ts +4 -10
  85. package/dist/application/query/execution/execute.js +3 -45
  86. package/dist/application/query/execution/executor.d.ts +2 -2
  87. package/dist/application/query/execution/legacy/declared-classes.d.ts +10 -0
  88. package/dist/application/query/execution/legacy/declared-classes.js +9 -0
  89. package/dist/application/query/execution/refusal.d.ts +37 -0
  90. package/dist/application/query/execution/refusal.js +80 -0
  91. package/dist/application/query/execution/rows.d.ts +42 -0
  92. package/dist/application/query/execution/rows.js +326 -0
  93. package/dist/application/query/execution/run.d.ts +85 -0
  94. package/dist/application/query/execution/run.js +372 -0
  95. package/dist/application/query/execution/split.d.ts +24 -0
  96. package/dist/application/query/execution/split.js +190 -0
  97. package/dist/application/query/failure.d.ts +8 -0
  98. package/dist/application/query/failure.js +8 -0
  99. package/dist/application/query/handles/build.d.ts +10 -0
  100. package/dist/application/query/handles/build.js +53 -0
  101. package/dist/application/query/handles/conditions.d.ts +94 -0
  102. package/dist/application/query/handles/domain.d.ts +157 -0
  103. package/dist/application/query/handles/handles.d.ts +285 -0
  104. package/dist/application/query/handles/handles.js +1 -0
  105. package/dist/application/query/handles/model.d.ts +106 -0
  106. package/dist/application/query/handles/model.js +261 -0
  107. package/dist/application/query/handles/plan.d.ts +100 -0
  108. package/dist/application/query/handles/plan.js +37 -0
  109. package/dist/application/query/handles/reads.d.ts +106 -0
  110. package/dist/application/query/handles/reads.js +978 -0
  111. package/dist/application/query/handles/relations.d.ts +106 -0
  112. package/dist/application/query/handles/relations.js +1 -0
  113. package/dist/application/query/handles/rows.d.ts +94 -0
  114. package/dist/application/query/handles/rows.js +4 -0
  115. package/dist/application/query/handles/terms.d.ts +103 -0
  116. package/dist/application/query/handles/terms.js +282 -0
  117. package/dist/application/query/index.d.ts +14 -8
  118. package/dist/application/query/index.js +10 -5
  119. package/dist/application/query/language/index.d.ts +2 -0
  120. package/dist/application/query/language/index.js +2 -0
  121. package/dist/application/query/language/query.d.ts +323 -0
  122. package/dist/application/query/language/query.js +2 -0
  123. package/dist/application/query/{collection → legacy/v6/collection}/identity.d.ts +2 -2
  124. package/dist/application/query/{collection → legacy/v6/collection}/metadata.d.ts +1 -1
  125. package/dist/application/query/{collection → legacy/v6/collection}/union.d.ts +4 -4
  126. package/dist/application/query/{collection → legacy/v6/collection}/union.js +15 -8
  127. package/dist/application/query/legacy/v6/conformance.d.ts +15 -0
  128. package/dist/application/query/legacy/v6/conformance.js +46 -0
  129. package/dist/application/query/legacy/v6/define.d.ts +37 -0
  130. package/dist/application/query/legacy/v6/define.js +90 -0
  131. package/dist/application/query/legacy/v6/execution/execute.d.ts +18 -0
  132. package/dist/application/query/legacy/v6/execution/execute.js +50 -0
  133. package/dist/application/query/legacy/v6/index.d.ts +7 -0
  134. package/dist/application/query/legacy/v6/index.js +3 -0
  135. package/dist/application/query/legacy/v6/kernel.d.ts +6 -0
  136. package/dist/application/query/legacy/v6/kernel.js +5 -0
  137. package/dist/application/query/{single → legacy/v6/single}/pagination.js +1 -1
  138. package/dist/application/query/{single → legacy/v6/single}/query.d.ts +2 -14
  139. package/dist/application/query/legacy/v6/single/query.js +1 -0
  140. package/dist/application/query/query.d.ts +19 -4
  141. package/dist/application/requirements/canonical.d.ts +7 -0
  142. package/dist/application/requirements/canonical.js +16 -0
  143. package/dist/application/requirements/classes.d.ts +9 -7
  144. package/dist/application/requirements/classes.js +35 -42
  145. package/dist/application/requirements/functions.d.ts +3 -1
  146. package/dist/application/requirements/functions.js +12 -27
  147. package/dist/application/requirements/index.d.ts +34 -16
  148. package/dist/application/requirements/index.js +17 -20
  149. package/dist/application/requirements/legacy/authority.d.ts +21 -0
  150. package/dist/application/requirements/{authority.js → legacy/authority.js} +5 -2
  151. package/dist/application/requirements/legacy/classes.d.ts +22 -0
  152. package/dist/application/requirements/legacy/classes.js +24 -0
  153. package/dist/application/requirements/legacy/core.d.ts +30 -0
  154. package/dist/application/requirements/{core.js → legacy/core.js} +15 -13
  155. package/dist/application/requirements/legacy/functions.d.ts +7 -0
  156. package/dist/application/requirements/legacy/functions.js +15 -0
  157. package/dist/application/requirements/legacy/index.d.ts +43 -0
  158. package/dist/application/requirements/legacy/index.js +1 -0
  159. package/dist/application/requirements/legacy/requirements.d.ts +31 -0
  160. package/dist/application/requirements/legacy/requirements.js +31 -0
  161. package/dist/application/requirements/requirement.d.ts +30 -19
  162. package/dist/application/requirements/roles.d.ts +17 -0
  163. package/dist/application/requirements/roles.js +62 -0
  164. package/dist/application/requirements/scopes.d.ts +16 -0
  165. package/dist/application/requirements/scopes.js +34 -0
  166. package/dist/application/routes/admission.d.ts +3 -3
  167. package/dist/application/routes/admission.js +3 -3
  168. package/dist/application/routes/index.d.ts +3 -2
  169. package/dist/application/routes/route.d.ts +3 -3
  170. package/dist/application/runtime/actions.js +3 -0
  171. package/dist/application/runtime/declarations.d.ts +6 -6
  172. package/dist/application/runtime/define.d.ts +5 -5
  173. package/dist/application/runtime/runtime.js +12 -0
  174. package/dist/application/runtime/workflows.d.ts +3 -1
  175. package/dist/application/runtime/workflows.js +3 -4
  176. package/dist/application/view/define.js +4 -6
  177. package/dist/application/view/frontend.d.ts +2 -2
  178. package/dist/application/view/index.d.ts +1 -1
  179. package/dist/application/view/route.d.ts +0 -14
  180. package/dist/application/view/route.js +1 -64
  181. package/dist/application/workflow/authoring.d.ts +3 -2
  182. package/dist/application/workflow/context.d.ts +8 -2
  183. package/dist/application/workflow/define.d.ts +4 -4
  184. package/dist/application/workflow/define.js +14 -9
  185. package/dist/application/workflow/durable.d.ts +211 -0
  186. package/dist/application/workflow/durable.js +1 -0
  187. package/dist/application/workflow/index.d.ts +3 -2
  188. package/dist/application/workflow/runner/inline.js +1 -0
  189. package/dist/application/workflow/runner/runner.d.ts +2 -2
  190. package/dist/application/workflow/workflow.d.ts +5 -3
  191. package/dist/deployment/adapter/adapter.d.ts +55 -13
  192. package/dist/deployment/adapter/bundle/bundle.d.ts +36 -0
  193. package/dist/deployment/adapter/bundle/bundle.js +1 -0
  194. package/dist/deployment/adapter/bundle/file.d.ts +10 -0
  195. package/dist/deployment/adapter/bundle/file.js +1 -0
  196. package/dist/deployment/adapter/bundle/index.d.ts +2 -0
  197. package/dist/deployment/adapter/bundle/index.js +1 -0
  198. package/dist/deployment/adapter/define.d.ts +4 -3
  199. package/dist/deployment/adapter/define.js +107 -23
  200. package/dist/deployment/adapter/index.d.ts +4 -3
  201. package/dist/deployment/adapter/index.js +1 -0
  202. package/dist/deployment/adapter/release/command.d.ts +33 -0
  203. package/dist/deployment/adapter/release/command.js +1 -0
  204. package/dist/deployment/adapter/release/context.d.ts +94 -0
  205. package/dist/deployment/adapter/release/context.js +1 -0
  206. package/dist/deployment/adapter/release/index.d.ts +4 -0
  207. package/dist/deployment/adapter/release/index.js +1 -0
  208. package/dist/deployment/adapter/release/list.d.ts +53 -0
  209. package/dist/deployment/adapter/release/list.js +1 -0
  210. package/dist/deployment/adapter/release/refusal.d.ts +10 -0
  211. package/dist/deployment/adapter/release/refusal.js +14 -0
  212. package/dist/deployment/adapter/release/result.d.ts +56 -0
  213. package/dist/deployment/adapter/release/result.js +1 -0
  214. package/dist/deployment/address/configuration.d.ts +96 -0
  215. package/dist/deployment/address/configuration.js +274 -0
  216. package/dist/deployment/address/fingerprint.d.ts +5 -0
  217. package/dist/deployment/address/fingerprint.js +27 -0
  218. package/dist/deployment/address/index.d.ts +5 -0
  219. package/dist/deployment/address/index.js +4 -0
  220. package/dist/deployment/address/label.d.ts +42 -0
  221. package/dist/deployment/address/label.js +80 -0
  222. package/dist/deployment/address/line.d.ts +29 -0
  223. package/dist/deployment/address/line.js +53 -0
  224. package/dist/deployment/address/record.d.ts +73 -0
  225. package/dist/deployment/address/record.js +138 -0
  226. package/dist/deployment/address/summary.d.ts +30 -0
  227. package/dist/deployment/address/summary.js +1 -0
  228. package/dist/deployment/address/vectors.d.ts +60 -0
  229. package/dist/deployment/address/vectors.js +517 -0
  230. package/dist/deployment/authoring.d.ts +0 -2
  231. package/dist/deployment/authoring.js +0 -1
  232. package/dist/deployment/build/build.d.ts +13 -2
  233. package/dist/deployment/build/compile.d.ts +4 -4
  234. package/dist/deployment/build/compile.js +31 -81
  235. package/dist/deployment/build/frontend/compilation.d.ts +2 -4
  236. package/dist/deployment/build/frontend/compilation.js +0 -5
  237. package/dist/deployment/build/frontend/digest.js +1 -5
  238. package/dist/deployment/build/index.d.ts +1 -0
  239. package/dist/deployment/build/index.js +1 -0
  240. package/dist/deployment/build/legacy/requirements.d.ts +11 -0
  241. package/dist/deployment/build/legacy/requirements.js +79 -0
  242. package/dist/deployment/build/manifest.d.ts +59 -0
  243. package/dist/deployment/build/manifest.js +118 -0
  244. package/dist/deployment/build/material.d.ts +2 -2
  245. package/dist/deployment/build/material.js +28 -13
  246. package/dist/deployment/build/schema.d.ts +2 -2
  247. package/dist/deployment/deployment.d.ts +3 -2
  248. package/dist/deployment/environment.d.ts +6 -0
  249. package/dist/deployment/environment.js +6 -0
  250. package/dist/deployment/index.d.ts +4 -6
  251. package/dist/deployment/index.js +1 -2
  252. package/dist/deployment/release/addressing.d.ts +6 -5
  253. package/dist/deployment/release/addressing.js +2 -3
  254. package/dist/deployment/release/assemble.d.ts +6 -3
  255. package/dist/deployment/release/assemble.js +12 -10
  256. package/dist/deployment/release/release.d.ts +16 -5
  257. package/dist/deployment/release/seal.d.ts +14 -0
  258. package/dist/deployment/release/seal.js +22 -0
  259. package/dist/deployment/release/{publication → served}/callables.d.ts +2 -2
  260. package/dist/deployment/release/{publication → served}/callables.js +2 -2
  261. package/dist/deployment/release/served/index.d.ts +11 -0
  262. package/dist/deployment/release/served/index.js +26 -0
  263. package/dist/deployment/release/{publication → served}/views.d.ts +2 -2
  264. package/dist/deployment/release/{publication → served}/views.js +0 -1
  265. package/dist/deployment/runtime/admission.d.ts +2 -2
  266. package/dist/deployment/runtime/admission.js +5 -5
  267. package/dist/deployment/verify/index.d.ts +3 -4
  268. package/dist/deployment/verify/index.js +2 -3
  269. package/dist/deployment/verify/preflight/bundle.d.ts +18 -0
  270. package/dist/deployment/verify/preflight/bundle.js +71 -0
  271. package/dist/deployment/verify/preflight/index.d.ts +1 -12
  272. package/dist/deployment/verify/preflight/index.js +1 -12
  273. package/dist/deployment/verify/readiness/fetch.d.ts +13 -0
  274. package/dist/deployment/verify/readiness/fetch.js +26 -0
  275. package/dist/deployment/verify/readiness/identity.d.ts +3 -6
  276. package/dist/deployment/verify/readiness/identity.js +3 -3
  277. package/dist/deployment/verify/readiness/index.d.ts +15 -8
  278. package/dist/deployment/verify/readiness/index.js +25 -6
  279. package/dist/deployment/verify/readiness/release.d.ts +8 -0
  280. package/dist/deployment/verify/readiness/release.js +22 -0
  281. package/dist/deployment/worker/address.d.ts +26 -0
  282. package/dist/deployment/worker/address.js +43 -0
  283. package/dist/deployment/worker/build.d.ts +60 -0
  284. package/dist/deployment/worker/build.js +172 -0
  285. package/dist/deployment/worker/configuration.d.ts +73 -0
  286. package/dist/deployment/worker/configuration.js +165 -0
  287. package/dist/deployment/worker/content.d.ts +38 -0
  288. package/dist/deployment/worker/content.js +169 -0
  289. package/dist/deployment/worker/index.d.ts +29 -0
  290. package/dist/deployment/worker/index.js +29 -0
  291. package/dist/deployment/worker/limits.d.ts +30 -0
  292. package/dist/deployment/worker/limits.js +30 -0
  293. package/dist/deployment/worker/record.d.ts +29 -0
  294. package/dist/deployment/worker/record.js +69 -0
  295. package/dist/deployment/worker/request.d.ts +118 -0
  296. package/dist/deployment/worker/request.js +280 -0
  297. package/dist/deployment/worker/response.d.ts +101 -0
  298. package/dist/deployment/worker/response.js +207 -0
  299. package/dist/execution/cache/cache.d.ts +17 -0
  300. package/dist/execution/cache/cache.js +11 -0
  301. package/dist/execution/cache/index.d.ts +2 -0
  302. package/dist/execution/cache/index.js +2 -0
  303. package/dist/execution/cache/memory.d.ts +13 -0
  304. package/dist/execution/cache/memory.js +48 -0
  305. package/dist/execution/identity/authentication.d.ts +33 -3
  306. package/dist/execution/identity/authentication.js +95 -36
  307. package/dist/execution/identity/callback.d.ts +20 -20
  308. package/dist/execution/identity/callback.js +34 -26
  309. package/dist/execution/identity/delivery.d.ts +6 -4
  310. package/dist/execution/identity/delivery.js +25 -20
  311. package/dist/execution/identity/exchange.js +11 -1
  312. package/dist/execution/identity/identity.d.ts +17 -3
  313. package/dist/execution/identity/identity.js +12 -4
  314. package/dist/execution/identity/jwks.d.ts +5 -0
  315. package/dist/execution/identity/jwks.js +92 -102
  316. package/dist/execution/index.d.ts +6 -4
  317. package/dist/execution/index.js +4 -2
  318. package/dist/execution/invocation/admission/age.d.ts +57 -0
  319. package/dist/execution/invocation/admission/age.js +208 -0
  320. package/dist/execution/invocation/admission/authentication.d.ts +13 -13
  321. package/dist/execution/invocation/admission/authentication.js +52 -44
  322. package/dist/execution/invocation/admission/authority.d.ts +28 -6
  323. package/dist/execution/invocation/admission/authority.js +9 -2
  324. package/dist/execution/invocation/admission/index.d.ts +4 -3
  325. package/dist/execution/invocation/admission/index.js +3 -2
  326. package/dist/execution/invocation/admission/input.d.ts +2 -2
  327. package/dist/execution/invocation/admission/input.js +16 -2
  328. package/dist/execution/invocation/admission/target.d.ts +11 -0
  329. package/dist/execution/invocation/admission/target.js +22 -3
  330. package/dist/execution/invocation/capabilities/bind.d.ts +14 -0
  331. package/dist/execution/invocation/capabilities/bind.js +74 -0
  332. package/dist/execution/invocation/capabilities/index.d.ts +1 -0
  333. package/dist/execution/invocation/capabilities/index.js +1 -0
  334. package/dist/execution/invocation/dependency/bind.d.ts +3 -1
  335. package/dist/execution/invocation/dependency/bind.js +36 -16
  336. package/dist/execution/invocation/dispatch/action.js +4 -2
  337. package/dist/execution/invocation/dispatch/context.d.ts +8 -7
  338. package/dist/execution/invocation/dispatch/context.js +34 -45
  339. package/dist/execution/invocation/dispatch/workflow.js +4 -6
  340. package/dist/execution/invocation/handler.js +8 -2
  341. package/dist/execution/invocation/index.d.ts +2 -2
  342. package/dist/execution/invocation/index.js +1 -1
  343. package/dist/execution/invocation/integration/authentication.d.ts +3 -3
  344. package/dist/execution/invocation/integration/authentication.js +7 -7
  345. package/dist/execution/invocation/integration/call.d.ts +2 -1
  346. package/dist/execution/invocation/integration/call.js +3 -3
  347. package/dist/execution/invocation/integration/clients.d.ts +1 -1
  348. package/dist/execution/invocation/integration/index.d.ts +1 -0
  349. package/dist/execution/invocation/integration/index.js +1 -0
  350. package/dist/execution/invocation/invocation.d.ts +6 -0
  351. package/dist/execution/invocation/invocation.js +130 -22
  352. package/dist/execution/invocation/lifecycle/active.d.ts +8 -2
  353. package/dist/execution/invocation/lifecycle/active.js +3 -3
  354. package/dist/execution/invocation/lifecycle/index.d.ts +1 -1
  355. package/dist/execution/invocation/result/errors.d.ts +0 -10
  356. package/dist/execution/invocation/result/errors.js +12 -16
  357. package/dist/execution/invocation/result/index.d.ts +3 -2
  358. package/dist/execution/invocation/result/index.js +2 -1
  359. package/dist/execution/invocation/result/project.js +41 -1
  360. package/dist/execution/invocation/result/undeclared.d.ts +7 -0
  361. package/dist/execution/invocation/result/undeclared.js +18 -0
  362. package/dist/execution/node/serve.d.ts +2 -2
  363. package/dist/execution/node/serve.js +1 -1
  364. package/dist/execution/runtime/index.d.ts +1 -0
  365. package/dist/execution/runtime/index.js +1 -0
  366. package/dist/execution/runtime/load.d.ts +3 -3
  367. package/dist/execution/runtime/load.js +3 -2
  368. package/dist/execution/runtime/release.d.ts +17 -0
  369. package/dist/execution/runtime/release.js +7 -0
  370. package/dist/execution/serve.d.ts +18 -4
  371. package/dist/execution/serve.js +10 -0
  372. package/dist/execution/service/create.js +43 -7
  373. package/dist/execution/service/initialization.d.ts +4 -4
  374. package/dist/execution/service/initialization.js +23 -14
  375. package/dist/execution/service/release.d.ts +2 -2
  376. package/dist/execution/service/release.js +3 -2
  377. package/dist/execution/service/service.d.ts +20 -5
  378. package/dist/execution/service/serving/delivery.d.ts +5 -0
  379. package/dist/execution/service/{publication → serving}/delivery.js +4 -1
  380. package/dist/execution/service/{publication → serving}/index.d.ts +1 -1
  381. package/dist/execution/service/serving/installation.d.ts +4 -0
  382. package/dist/execution/service/serving/installation.js +9 -0
  383. package/dist/execution/service/serving/source.d.ts +11 -0
  384. package/dist/execution/service/serving/source.js +15 -0
  385. package/dist/execution/workflows/attempts.d.ts +87 -0
  386. package/dist/execution/workflows/attempts.js +205 -0
  387. package/dist/execution/workflows/discovery.d.ts +14 -0
  388. package/dist/execution/workflows/discovery.js +151 -0
  389. package/dist/execution/workflows/engine.d.ts +83 -0
  390. package/dist/execution/workflows/engine.js +1 -0
  391. package/dist/execution/workflows/envelope.d.ts +12 -0
  392. package/dist/execution/workflows/envelope.js +46 -0
  393. package/dist/execution/workflows/failure.d.ts +56 -0
  394. package/dist/execution/workflows/failure.js +204 -0
  395. package/dist/execution/workflows/index.d.ts +4 -0
  396. package/dist/execution/workflows/index.js +3 -0
  397. package/dist/execution/workflows/integrations.d.ts +13 -0
  398. package/dist/execution/workflows/integrations.js +25 -0
  399. package/dist/execution/workflows/options.d.ts +81 -0
  400. package/dist/execution/workflows/options.js +158 -0
  401. package/dist/execution/workflows/receiver.d.ts +24 -0
  402. package/dist/execution/workflows/receiver.js +99 -0
  403. package/dist/execution/workflows/route.d.ts +12 -0
  404. package/dist/execution/workflows/route.js +35 -0
  405. package/dist/execution/workflows/run.d.ts +23 -0
  406. package/dist/execution/workflows/run.js +369 -0
  407. package/dist/execution/workflows/steps.d.ts +48 -0
  408. package/dist/execution/workflows/steps.js +93 -0
  409. package/dist/index.d.ts +5 -5
  410. package/dist/index.js +2 -2
  411. package/dist/platform/graph/alias.d.ts +1 -5
  412. package/dist/platform/graph/alias.js +1 -5
  413. package/dist/platform/graph/document/index.d.ts +1 -1
  414. package/dist/platform/graph/document/index.js +1 -1
  415. package/dist/platform/graph/index.d.ts +1 -1
  416. package/dist/platform/graph/index.js +1 -1
  417. package/dist/platform/release/index.d.ts +2 -0
  418. package/dist/platform/release/index.js +2 -0
  419. package/dist/platform/schema/callable-authoring.d.ts +21 -0
  420. package/dist/platform/schema/callable-authoring.js +27 -0
  421. package/dist/platform/schema/class-authoring.d.ts +58 -12
  422. package/dist/platform/schema/class-authoring.js +38 -4
  423. package/dist/platform/schema/class-icon-svg.d.ts +9 -0
  424. package/dist/platform/schema/class-icon-svg.js +29 -0
  425. package/dist/platform/schema/class-icon.d.ts +3 -8
  426. package/dist/platform/schema/class-icon.js +2 -29
  427. package/dist/platform/schema/index.d.ts +11 -4
  428. package/dist/platform/schema/index.js +2 -1
  429. package/dist/platform/schema/kernel-compiled.d.ts +2 -0
  430. package/dist/platform/schema/kernel-compiled.js +2 -0
  431. package/dist/platform/schema/kernel.d.ts +4 -2
  432. package/dist/platform/schema/property.d.ts +5 -0
  433. package/dist/platform/schema/references/index.d.ts +6 -0
  434. package/dist/platform/schema/references/index.js +1 -0
  435. package/dist/platform/schema/schema-authoring.d.ts +14 -7
  436. package/dist/platform/schema/schema-authoring.js +5 -1
  437. package/dist/platform/versioning/dependents.d.ts +18 -0
  438. package/dist/platform/versioning/dependents.js +15 -0
  439. package/dist/platform/versioning/index.d.ts +5 -0
  440. package/dist/platform/versioning/index.js +5 -0
  441. package/dist/platform/versioning/name.d.ts +38 -0
  442. package/dist/platform/versioning/name.js +58 -0
  443. package/dist/platform/versioning/reference.d.ts +48 -0
  444. package/dist/platform/versioning/reference.js +95 -0
  445. package/dist/platform/versioning/version.d.ts +72 -0
  446. package/dist/platform/versioning/version.js +98 -0
  447. package/dist/project/admit.js +1 -5
  448. package/dist/project/define.d.ts +4 -4
  449. package/dist/project/define.js +55 -35
  450. package/dist/project/index.d.ts +1 -1
  451. package/dist/project/install-command.d.ts +6 -0
  452. package/dist/project/install-command.js +9 -0
  453. package/dist/project/project.d.ts +10 -8
  454. package/dist/testing/dataset/define.d.ts +1 -1
  455. package/dist/testing/durable/engine.d.ts +128 -0
  456. package/dist/testing/durable/engine.js +619 -0
  457. package/dist/testing/durable/index.d.ts +3 -0
  458. package/dist/testing/durable/index.js +1 -0
  459. package/dist/testing/durable/steps.d.ts +30 -0
  460. package/dist/testing/durable/steps.js +45 -0
  461. package/dist/testing/file.d.ts +20 -0
  462. package/dist/testing/file.js +49 -0
  463. package/dist/testing/index.d.ts +10 -1
  464. package/dist/testing/index.js +7 -1
  465. package/dist/testing/load.js +1 -1
  466. package/dist/testing/query.d.ts +22 -0
  467. package/dist/testing/query.js +36 -0
  468. package/dist/tooling/cli/adapter-command.d.ts +35 -0
  469. package/dist/tooling/cli/adapter-command.js +66 -0
  470. package/dist/tooling/cli/arguments.d.ts +17 -6
  471. package/dist/tooling/cli/arguments.js +175 -52
  472. package/dist/tooling/cli/build.d.ts +55 -0
  473. package/dist/tooling/cli/build.js +77 -0
  474. package/dist/tooling/cli/bun.d.ts +0 -1
  475. package/dist/tooling/cli/bun.js +0 -7
  476. package/dist/tooling/cli/commit.d.ts +35 -0
  477. package/dist/tooling/cli/commit.js +235 -0
  478. package/dist/tooling/cli/deploy-mode.d.ts +26 -0
  479. package/dist/tooling/cli/deploy-mode.js +59 -0
  480. package/dist/tooling/cli/deploy-result.d.ts +80 -0
  481. package/dist/tooling/cli/deploy-result.js +64 -0
  482. package/dist/tooling/cli/diff/declared.d.ts +7 -0
  483. package/dist/tooling/cli/diff/declared.js +27 -0
  484. package/dist/tooling/cli/diff/index.d.ts +30 -0
  485. package/dist/tooling/cli/diff/index.js +58 -0
  486. package/dist/tooling/cli/diff/render.d.ts +15 -0
  487. package/dist/tooling/cli/diff/render.js +131 -0
  488. package/dist/tooling/cli/diff/report.d.ts +88 -0
  489. package/dist/tooling/cli/diff/report.js +154 -0
  490. package/dist/tooling/cli/dotenv.d.ts +5 -5
  491. package/dist/tooling/cli/dotenv.js +6 -36
  492. package/dist/tooling/cli/help.js +173 -60
  493. package/dist/tooling/cli/immutable-deployment.d.ts +83 -0
  494. package/dist/tooling/cli/immutable-deployment.js +135 -0
  495. package/dist/tooling/cli/index.d.ts +12 -4
  496. package/dist/tooling/cli/index.js +6 -3
  497. package/dist/tooling/cli/installed-on.d.ts +83 -0
  498. package/dist/tooling/cli/installed-on.js +156 -0
  499. package/dist/tooling/cli/list.d.ts +152 -0
  500. package/dist/tooling/cli/list.js +331 -0
  501. package/dist/tooling/cli/log.d.ts +5 -2
  502. package/dist/tooling/cli/log.js +9 -2
  503. package/dist/tooling/cli/orchestrate.d.ts +0 -6
  504. package/dist/tooling/cli/orchestrate.js +252 -91
  505. package/dist/tooling/cli/project.d.ts +3 -3
  506. package/dist/tooling/cli/publish/index.d.ts +81 -0
  507. package/dist/tooling/cli/publish/index.js +383 -0
  508. package/dist/tooling/cli/publish/report.d.ts +49 -0
  509. package/dist/tooling/cli/publish/report.js +15 -0
  510. package/dist/tooling/cli/registry/client.d.ts +121 -0
  511. package/dist/tooling/cli/registry/client.js +354 -0
  512. package/dist/tooling/cli/registry/error.d.ts +11 -0
  513. package/dist/tooling/cli/registry/error.js +17 -0
  514. package/dist/tooling/cli/registry/executable.d.ts +35 -0
  515. package/dist/tooling/cli/registry/executable.js +96 -0
  516. package/dist/tooling/cli/registry/index.d.ts +9 -0
  517. package/dist/tooling/cli/registry/index.js +8 -0
  518. package/dist/tooling/cli/registry/installations.d.ts +67 -0
  519. package/dist/tooling/cli/registry/installations.js +108 -0
  520. package/dist/tooling/cli/registry/process.d.ts +36 -0
  521. package/dist/tooling/cli/registry/process.js +119 -0
  522. package/dist/tooling/cli/secrets.d.ts +9 -0
  523. package/dist/tooling/cli/secrets.js +19 -0
  524. package/dist/tooling/cli/yank.d.ts +34 -0
  525. package/dist/tooling/cli/yank.js +32 -0
  526. package/dist/tooling/linter/adapters/typescript/definition-calls.d.ts +34 -0
  527. package/dist/tooling/linter/adapters/typescript/definition-calls.js +88 -0
  528. package/dist/tooling/linter/adapters/typescript/discover.js +8 -2
  529. package/dist/tooling/linter/adapters/typescript/imports.d.ts +0 -1
  530. package/dist/tooling/linter/adapters/typescript/imports.js +1 -5
  531. package/dist/tooling/linter/adapters/typescript/index.d.ts +9 -2
  532. package/dist/tooling/linter/adapters/typescript/index.js +4 -2
  533. package/dist/tooling/linter/adapters/typescript/legacy.d.ts +20 -0
  534. package/dist/tooling/linter/adapters/typescript/legacy.js +28 -0
  535. package/dist/tooling/linter/adapters/typescript/query-observation.js +37 -12
  536. package/dist/tooling/linter/adapters/typescript/syntax.d.ts +3 -3
  537. package/dist/tooling/linter/adapters/typescript/syntax.js +13 -25
  538. package/dist/tooling/linter/adapters/typescript/type-analysis.d.ts +2 -0
  539. package/dist/tooling/linter/adapters/typescript/type-analysis.js +10 -0
  540. package/dist/tooling/linter/implementations/source/callable-requirements.d.ts +2 -4
  541. package/dist/tooling/linter/implementations/source/callable-requirements.js +16 -58
  542. package/dist/tooling/linter/implementations/source/const-initializer.d.ts +3 -0
  543. package/dist/tooling/linter/implementations/source/const-initializer.js +31 -0
  544. package/dist/tooling/linter/implementations/source/definitions.d.ts +2 -0
  545. package/dist/tooling/linter/implementations/source/definitions.js +425 -0
  546. package/dist/tooling/linter/implementations/source/dependencies.js +13 -72
  547. package/dist/tooling/linter/implementations/source/domain-requirements.d.ts +8 -0
  548. package/dist/tooling/linter/implementations/source/domain-requirements.js +35 -0
  549. package/dist/tooling/linter/implementations/source/global.js +39 -19
  550. package/dist/tooling/linter/implementations/source/legacy/requirements.d.ts +10 -0
  551. package/dist/tooling/linter/implementations/source/legacy/requirements.js +40 -0
  552. package/dist/tooling/linter/implementations/source/legacy-folders.d.ts +3 -0
  553. package/dist/tooling/linter/implementations/source/legacy-folders.js +126 -0
  554. package/dist/tooling/linter/implementations/source/mutations.js +153 -70
  555. package/dist/tooling/linter/implementations/source/policy-edges.d.ts +2 -0
  556. package/dist/tooling/linter/implementations/source/policy-edges.js +113 -0
  557. package/dist/tooling/linter/implementations/source/providers.js +5 -5
  558. package/dist/tooling/linter/implementations/source/queries.js +1 -17
  559. package/dist/tooling/linter/implementations/source/requirement-entries.d.ts +24 -0
  560. package/dist/tooling/linter/implementations/source/requirement-entries.js +52 -0
  561. package/dist/tooling/linter/implementations/source/runtime-imports.d.ts +2 -0
  562. package/dist/tooling/linter/implementations/source/runtime-imports.js +119 -0
  563. package/dist/tooling/linter/implementations/source/schema.d.ts +3 -0
  564. package/dist/tooling/linter/implementations/source/schema.js +9 -5
  565. package/dist/tooling/linter/implementations/source/shared.d.ts +19 -5
  566. package/dist/tooling/linter/implementations/source/shared.js +131 -55
  567. package/dist/tooling/linter/implementations/source/tests.js +1 -1
  568. package/dist/tooling/linter/implementations/source/verifiers.js +8 -2
  569. package/dist/tooling/linter/implementations/source/views.js +2 -2
  570. package/dist/tooling/linter/implementations/source/workflows.js +499 -17
  571. package/dist/tooling/linter/policy/generated.js +18 -67
  572. package/dist/tooling/linter/requirements/registry.js +14 -9
  573. package/dist/tooling/packaging/declarations/ownership.js +1 -1
  574. package/dist/tooling/packaging/finalize.d.ts +1 -1
  575. package/dist/tooling/packaging/finalize.js +1 -1
  576. package/docs/accounts/scenarios.tsv +12 -0
  577. package/docs/admission-age.md +88 -0
  578. package/docs/auth-api-migration.md +57 -0
  579. package/docs/business-errors.md +42 -0
  580. package/docs/domain-definition-migration.md +44 -0
  581. package/docs/domain-schema-migration.md +36 -0
  582. package/docs/durable-workflows.md +530 -0
  583. package/docs/handler-dependencies.md +381 -0
  584. package/docs/legacy/query-v6.md +62 -0
  585. package/docs/legacy.md +113 -0
  586. package/docs/queries.md +493 -0
  587. package/docs/release.md +155 -0
  588. package/docs/requirements.md +143 -0
  589. package/docs/schema-cost.md +124 -0
  590. package/package.json +62 -26
  591. package/dist/application/application.d.ts +0 -28
  592. package/dist/application/query/execution/projection.d.ts +0 -3
  593. package/dist/application/query/execution/projection.js +0 -3
  594. package/dist/application/requirements/authority.d.ts +0 -7
  595. package/dist/application/requirements/core.d.ts +0 -14
  596. package/dist/deployment/adapter/deploy/context.d.ts +0 -15
  597. package/dist/deployment/adapter/deploy/index.d.ts +0 -2
  598. package/dist/deployment/adapter/deploy/result.d.ts +0 -50
  599. package/dist/deployment/adapter/prepare/artifact.d.ts +0 -33
  600. package/dist/deployment/adapter/prepare/context.d.ts +0 -23
  601. package/dist/deployment/adapter/prepare/index.d.ts +0 -2
  602. package/dist/deployment/deploy.d.ts +0 -20
  603. package/dist/deployment/deploy.js +0 -31
  604. package/dist/deployment/release/publication/index.d.ts +0 -6
  605. package/dist/deployment/release/publication/index.js +0 -6
  606. package/dist/deployment/release/publication/manifest.d.ts +0 -3
  607. package/dist/deployment/release/publication/manifest.js +0 -5
  608. package/dist/deployment/release/publication/requirements.d.ts +0 -3
  609. package/dist/deployment/release/publication/requirements.js +0 -3
  610. package/dist/deployment/release/publication/seal.d.ts +0 -10
  611. package/dist/deployment/release/publication/seal.js +0 -39
  612. package/dist/deployment/verify/preflight/artifact.d.ts +0 -6
  613. package/dist/deployment/verify/preflight/artifact.js +0 -122
  614. package/dist/deployment/verify/preflight/publication.d.ts +0 -4
  615. package/dist/deployment/verify/preflight/publication.js +0 -14
  616. package/dist/deployment/verify/readiness/deployment.d.ts +0 -3
  617. package/dist/deployment/verify/readiness/deployment.js +0 -151
  618. package/dist/deployment/verify/readiness/publication.d.ts +0 -11
  619. package/dist/deployment/verify/readiness/publication.js +0 -41
  620. package/dist/execution/service/errors.d.ts +0 -3
  621. package/dist/execution/service/errors.js +0 -3
  622. package/dist/execution/service/publication/delivery.d.ts +0 -2
  623. package/dist/execution/service/publication/installation.d.ts +0 -3
  624. package/dist/execution/service/publication/installation.js +0 -8
  625. package/dist/execution/service/publication/source.d.ts +0 -3
  626. package/dist/execution/service/publication/source.js +0 -11
  627. package/dist/platform/publication/index.d.ts +0 -2
  628. package/dist/platform/publication/index.js +0 -2
  629. package/dist/tooling/cli/astrale/authority.d.ts +0 -5
  630. package/dist/tooling/cli/astrale/authority.js +0 -11
  631. package/dist/tooling/cli/astrale/executable.d.ts +0 -2
  632. package/dist/tooling/cli/astrale/executable.js +0 -47
  633. package/dist/tooling/cli/astrale/failure.d.ts +0 -6
  634. package/dist/tooling/cli/astrale/failure.js +0 -48
  635. package/dist/tooling/cli/astrale/instance.d.ts +0 -11
  636. package/dist/tooling/cli/astrale/instance.js +0 -52
  637. package/dist/tooling/cli/astrale/process.d.ts +0 -13
  638. package/dist/tooling/cli/astrale/process.js +0 -94
  639. package/dist/tooling/cli/astrale/version.d.ts +0 -18
  640. package/dist/tooling/cli/astrale/version.js +0 -55
  641. package/dist/tooling/cli/credential.d.ts +0 -2
  642. package/dist/tooling/cli/credential.js +0 -57
  643. package/dist/tooling/cli/deprecations.d.ts +0 -9
  644. package/dist/tooling/cli/deprecations.js +0 -15
  645. package/dist/tooling/cli/development/candidate.d.ts +0 -25
  646. package/dist/tooling/cli/development/candidate.js +0 -176
  647. package/dist/tooling/cli/development/deployment.d.ts +0 -16
  648. package/dist/tooling/cli/development/deployment.js +0 -39
  649. package/dist/tooling/cli/development/develop.d.ts +0 -11
  650. package/dist/tooling/cli/development/develop.js +0 -243
  651. package/dist/tooling/cli/development/lease.d.ts +0 -18
  652. package/dist/tooling/cli/development/lease.js +0 -163
  653. package/dist/tooling/cli/development/lifecycle.d.ts +0 -9
  654. package/dist/tooling/cli/development/lifecycle.js +0 -43
  655. package/dist/tooling/cli/development/project-imports.d.ts +0 -22
  656. package/dist/tooling/cli/development/project-imports.js +0 -39
  657. package/dist/tooling/cli/development/project-lock.d.ts +0 -16
  658. package/dist/tooling/cli/development/project-lock.js +0 -41
  659. package/dist/tooling/cli/development/rebuild.d.ts +0 -13
  660. package/dist/tooling/cli/development/rebuild.js +0 -58
  661. package/dist/tooling/cli/development/release-evidence.d.ts +0 -4
  662. package/dist/tooling/cli/development/release-evidence.js +0 -10
  663. package/dist/tooling/cli/development/report.d.ts +0 -6
  664. package/dist/tooling/cli/development/report.js +0 -14
  665. package/dist/tooling/cli/development/session-file.d.ts +0 -53
  666. package/dist/tooling/cli/development/session-file.js +0 -337
  667. package/dist/tooling/cli/development/source-watch.d.ts +0 -14
  668. package/dist/tooling/cli/development/source-watch.js +0 -140
  669. package/dist/tooling/cli/development/sources.d.ts +0 -7
  670. package/dist/tooling/cli/development/sources.js +0 -48
  671. package/dist/tooling/cli/development/target-lock.d.ts +0 -16
  672. package/dist/tooling/cli/development/target-lock.js +0 -68
  673. package/dist/tooling/cli/development/view.d.ts +0 -28
  674. package/dist/tooling/cli/development/view.js +0 -151
  675. package/dist/tooling/cli/environment-release.d.ts +0 -21
  676. package/dist/tooling/cli/environment-release.js +0 -46
  677. package/dist/tooling/cli/evidence.d.ts +0 -11
  678. package/dist/tooling/cli/evidence.js +0 -53
  679. package/dist/tooling/cli/installation/index.d.ts +0 -2
  680. package/dist/tooling/cli/installation/index.js +0 -1
  681. package/dist/tooling/cli/installation/observation.d.ts +0 -10
  682. package/dist/tooling/cli/installation/observation.js +0 -44
  683. package/dist/tooling/cli/installation/reconcile.d.ts +0 -32
  684. package/dist/tooling/cli/installation/reconcile.js +0 -122
  685. package/dist/tooling/linter/implementations/source/migrations.d.ts +0 -2
  686. package/dist/tooling/linter/implementations/source/migrations.js +0 -113
  687. package/dist/tooling/linter/qualification/index.d.ts +0 -10
  688. package/dist/tooling/linter/qualification/index.js +0 -2
  689. package/dist/tooling/linter/qualification/query-fixtures.d.ts +0 -2
  690. package/dist/tooling/linter/qualification/query-fixtures.js +0 -68
  691. package/dist/tooling/linter/qualification/runner.d.ts +0 -3
  692. package/dist/tooling/linter/qualification/runner.js +0 -6
  693. /package/dist/application/{application.js → domain.js} +0 -0
  694. /package/dist/application/{query/single/query.js → mutation/legacy/v6/builder.js} +0 -0
  695. /package/dist/{deployment/adapter/deploy/context.js → application/mutation/legacy/v6/mutation.js} +0 -0
  696. /package/dist/application/mutation/{authoring → legacy/v6}/precondition.js +0 -0
  697. /package/dist/{deployment/adapter/deploy/index.js → application/query/answer/answer.js} +0 -0
  698. /package/dist/{deployment/adapter/deploy/result.js → application/query/defined/query.js} +0 -0
  699. /package/dist/{deployment/adapter/prepare/artifact.js → application/query/execution/client.js} +0 -0
  700. /package/dist/{deployment/adapter/prepare/context.js → application/query/handles/conditions.js} +0 -0
  701. /package/dist/{deployment/adapter/prepare/index.js → application/query/handles/domain.js} +0 -0
  702. /package/dist/application/query/{collection → legacy/v6/collection}/identity.js +0 -0
  703. /package/dist/application/query/{collection → legacy/v6/collection}/limits.d.ts +0 -0
  704. /package/dist/application/query/{collection → legacy/v6/collection}/limits.js +0 -0
  705. /package/dist/application/query/{collection → legacy/v6/collection}/metadata.js +0 -0
  706. /package/dist/application/query/{execution → legacy/v6/execution}/pages.d.ts +0 -0
  707. /package/dist/application/query/{execution → legacy/v6/execution}/pages.js +0 -0
  708. /package/dist/application/query/{single → legacy/v6/single}/index.d.ts +0 -0
  709. /package/dist/application/query/{single → legacy/v6/single}/index.js +0 -0
  710. /package/dist/application/query/{single → legacy/v6/single}/node.d.ts +0 -0
  711. /package/dist/application/query/{single → legacy/v6/single}/node.js +0 -0
  712. /package/dist/application/query/{single → legacy/v6/single}/pagination.d.ts +0 -0
  713. /package/dist/application/query/{single → legacy/v6/single}/selection.d.ts +0 -0
  714. /package/dist/application/query/{single → legacy/v6/single}/selection.js +0 -0
  715. /package/dist/deployment/release/{publication → served}/routes.d.ts +0 -0
  716. /package/dist/deployment/release/{publication → served}/routes.js +0 -0
  717. /package/dist/execution/service/{publication → serving}/index.js +0 -0
@@ -0,0 +1,139 @@
1
+ /**
2
+ * A Query (spec § Queries: the contract): an id, a `build` over the Domain's handles, an optional
3
+ * `output` and the errors it declares. `build` returns one read, a record of facets read together,
4
+ * or, when reads wait for others, `steps(first, (earlier) => next, …)`: two to eight records of
5
+ * facets, each function receiving the merged results of the steps before it.
6
+ */
7
+ import type { z } from 'zod';
8
+ import type { DeclaredErrorDefinition } from '../../../platform/schema/error.js';
9
+ import type { ClassOf, Index, KeyOf, Values } from '../handles/domain.js';
10
+ import type { Handles, PageRead, Read } from '../handles/handles.js';
11
+ import type { Page } from '../handles/rows.js';
12
+ /** One facet: a read, a list of reads (`items.map(…)`), or nothing (a read that is optional). */
13
+ export type Facet = Read<unknown> | readonly Read<unknown>[] | undefined;
14
+ /** Facets read together, by name. */
15
+ export type Facets = {
16
+ readonly [facet: string]: Facet;
17
+ };
18
+ /** What `build` returns without steps, and the first step: one read, or a record of facets. */
19
+ export type Built = Read<unknown> | Facets;
20
+ /** A read gives its answer; a list of reads a list of answers; nothing gives `undefined`. */
21
+ export type FacetResult<F> = F extends Read<infer T> ? T : F extends readonly Read<infer T>[] ? readonly T[] : F extends undefined ? undefined : never;
22
+ /** The results of one step; a page read, a Query's single read, gives its `Page`. */
23
+ export type Results<B> = B extends Read<infer T> ? T : B extends PageRead<infer T> ? Page<T> : {
24
+ readonly [K in keyof B]: FacetResult<B[K]>;
25
+ };
26
+ /**
27
+ * What a page Query's `output` keeps: the page shape. It bounds the output type, not `output`'s
28
+ * return type: inferred from an intersection, a branded value (`NodeId`, `NodePath`) loses its
29
+ * name, and a Domain's exported declaration would spell its brand out, which no package exports.
30
+ */
31
+ type PageShape<B> = B extends PageRead<unknown> ? Page<unknown> : unknown;
32
+ /** One object type: a Domain's exported declarations spell it out, naming no SDK internal. */
33
+ type Flat<T> = T extends unknown ? {
34
+ readonly [K in keyof T]: T[K];
35
+ } : never;
36
+ /**
37
+ * A later step's facets: none takes a name an earlier step read, whose result the merge would
38
+ * replace. An index signature (its `string` and `number` keys) names no facet in particular, so it
39
+ * refuses none.
40
+ */
41
+ type Later<Earlier> = Facets & {
42
+ readonly [K in keyof Earlier as string extends K ? never : number extends K ? never : K]?: '✗ an earlier step read this facet: name it otherwise';
43
+ };
44
+ /** The results of the steps so far, merged. */
45
+ export type Merged<B1, B2, B3 = {}, B4 = {}, B5 = {}, B6 = {}, B7 = {}, B8 = {}> = Flat<Results<B1> & Results<B2> & Results<B3> & Results<B4> & Results<B5> & Results<B6> & Results<B7> & Results<B8>>;
46
+ /** The errors a Query or Mutation declares, by UPPER_SNAKE code: at most 32. */
47
+ export type Errors = {
48
+ readonly [code: string]: DeclaredErrorDefinition;
49
+ };
50
+ /** The key of any Class of the Domain, its dependencies' or the Kernel's. */
51
+ export type ClassKeyOf<S> = KeyOf<Values<Index<S>>>;
52
+ /** A declared error of a Query, for `output` to throw. */
53
+ export interface DeclaredError<out C extends string> extends Error {
54
+ readonly '~code'?: C;
55
+ }
56
+ /** A row narrowed to a Class or any of its subclasses: the union members it may be, and `$class`. */
57
+ export type Narrowed<S, R extends {
58
+ readonly $class: string;
59
+ }, K> = R extends unknown ? [Extract<R['$class'], ClassOf<S, K>>] extends [never] ? never : R & {
60
+ readonly $class: Extract<R['$class'], ClassOf<S, K>>;
61
+ } : never;
62
+ /** What `output` receives besides the results and the input. */
63
+ export interface OutputContext<S, E extends Errors> {
64
+ /** A declared error, for `output` to throw: `throw error('SERVICE_NOT_FOUND', { service })`. */
65
+ error<C extends keyof E & string>(code: C, details: z.input<E[C]['details']>): DeclaredError<C>;
66
+ /** Narrows a row to a Class or any of its subclasses, by Class key. */
67
+ is<R extends {
68
+ readonly $class: string;
69
+ }, K extends ClassKeyOf<S>>(row: R, cls: K): row is Narrowed<S, R, K>;
70
+ }
71
+ /** A Query v7: its id, and the errors it declares, to spread into a Function's errors. */
72
+ export interface DefinedQuery<Id extends string = string, Input = unknown, Output = unknown, E extends Errors = Errors> {
73
+ readonly id: Id;
74
+ readonly errors: E;
75
+ /** A defined Mutation, `kind: 'mutation'`, writes: no read takes one. */
76
+ readonly kind?: never;
77
+ readonly '~input'?: Input;
78
+ readonly '~output'?: Output;
79
+ }
80
+ /**
81
+ * A Query whose single read is a page: the call sets its size and continues it. A `DefinedQuery`
82
+ * with its row type, not an interface of its own: a Domain's exported declaration names only
83
+ * `DefinedQuery`.
84
+ */
85
+ export type PageQuery<Id extends string = string, Input = unknown, Output = unknown, E extends Errors = Errors, Row = unknown> = DefinedQuery<Id, Input, Output, E> & {
86
+ readonly '~page'?: Row;
87
+ };
88
+ /** The input a Query is called with; a Query with no input is called with `undefined`. */
89
+ export type InputOf<R> = R extends DefinedQuery<string, infer I, unknown, Errors> ? I : never;
90
+ /** The output a Query answers. */
91
+ export type OutputOf<R> = R extends DefinedQuery<string, unknown, infer O, Errors> ? O : never;
92
+ type Output<S, Results, I, O, E extends Errors> = (results: Results, input: I, context: OutputContext<S, E>) => O;
93
+ /**
94
+ * Whether a type is portable JSON as far as its type can tell: a function, or an object that
95
+ * carries one (a Promise, a Date, a Map, a class with methods), is not. A value typed `unknown`
96
+ * may be JSON, so it passes, as does anything past eight levels.
97
+ */
98
+ type Portable<T, Depth extends readonly unknown[] = []> = unknown extends T ? true : Depth['length'] extends 8 ? true : T extends string | number | boolean | null | undefined ? true : T extends bigint | symbol | ((...args: never) => unknown) ? false : T extends readonly (infer Item)[] ? Portable<Item, [...Depth, unknown]> : {
99
+ [K in keyof T]-?: Portable<T[K], [...Depth, unknown]>;
100
+ }[keyof T] extends true ? true : false;
101
+ /** `output` returns portable JSON, checked by type (spec § API reference: Queries). */
102
+ type PortableOutput<O> = [Portable<O>] extends [true] ? unknown : '✗ output returns portable JSON: no function, Promise, Date, Map or other object with methods';
103
+ /** What `steps(…)` returns: the merged results of its steps, for `output`. */
104
+ export interface Stepped<out R> {
105
+ readonly '~stepped': R;
106
+ }
107
+ /** The results of what `build` returns: a read's, a page's, a record of facets', or the steps'. */
108
+ export type BuiltResults<B> = B extends Stepped<infer R> ? R : Results<B>;
109
+ /**
110
+ * `build`'s third parameter: reads that wait for others. The first step is a record of facets;
111
+ * each next one a function of the merged results of the steps before it, returning a record of
112
+ * facets none of them read. Two to eight steps, one overload per count, so a call's error is its
113
+ * own count's.
114
+ */
115
+ export interface Steps {
116
+ <B1 extends Facets, B2 extends Later<Results<B1>>>(first: B1, second: (earlier: Results<B1>) => B2): Stepped<Merged<B1, B2>>;
117
+ <B1 extends Facets, B2 extends Later<Results<B1>>, B3 extends Later<Merged<B1, B2>>>(first: B1, second: (earlier: Results<B1>) => B2, third: (earlier: Merged<B1, B2>) => B3): Stepped<Merged<B1, B2, B3>>;
118
+ <B1 extends Facets, B2 extends Later<Results<B1>>, B3 extends Later<Merged<B1, B2>>, B4 extends Later<Merged<B1, B2, B3>>>(first: B1, second: (earlier: Results<B1>) => B2, third: (earlier: Merged<B1, B2>) => B3, fourth: (earlier: Merged<B1, B2, B3>) => B4): Stepped<Merged<B1, B2, B3, B4>>;
119
+ <B1 extends Facets, B2 extends Later<Results<B1>>, B3 extends Later<Merged<B1, B2>>, B4 extends Later<Merged<B1, B2, B3>>, B5 extends Later<Merged<B1, B2, B3, B4>>>(first: B1, second: (earlier: Results<B1>) => B2, third: (earlier: Merged<B1, B2>) => B3, fourth: (earlier: Merged<B1, B2, B3>) => B4, fifth: (earlier: Merged<B1, B2, B3, B4>) => B5): Stepped<Merged<B1, B2, B3, B4, B5>>;
120
+ <B1 extends Facets, B2 extends Later<Results<B1>>, B3 extends Later<Merged<B1, B2>>, B4 extends Later<Merged<B1, B2, B3>>, B5 extends Later<Merged<B1, B2, B3, B4>>, B6 extends Later<Merged<B1, B2, B3, B4, B5>>>(first: B1, second: (earlier: Results<B1>) => B2, third: (earlier: Merged<B1, B2>) => B3, fourth: (earlier: Merged<B1, B2, B3>) => B4, fifth: (earlier: Merged<B1, B2, B3, B4>) => B5, sixth: (earlier: Merged<B1, B2, B3, B4, B5>) => B6): Stepped<Merged<B1, B2, B3, B4, B5, B6>>;
121
+ <B1 extends Facets, B2 extends Later<Results<B1>>, B3 extends Later<Merged<B1, B2>>, B4 extends Later<Merged<B1, B2, B3>>, B5 extends Later<Merged<B1, B2, B3, B4>>, B6 extends Later<Merged<B1, B2, B3, B4, B5>>, B7 extends Later<Merged<B1, B2, B3, B4, B5, B6>>>(first: B1, second: (earlier: Results<B1>) => B2, third: (earlier: Merged<B1, B2>) => B3, fourth: (earlier: Merged<B1, B2, B3>) => B4, fifth: (earlier: Merged<B1, B2, B3, B4>) => B5, sixth: (earlier: Merged<B1, B2, B3, B4, B5>) => B6, seventh: (earlier: Merged<B1, B2, B3, B4, B5, B6>) => B7): Stepped<Merged<B1, B2, B3, B4, B5, B6, B7>>;
122
+ <B1 extends Facets, B2 extends Later<Results<B1>>, B3 extends Later<Merged<B1, B2>>, B4 extends Later<Merged<B1, B2, B3>>, B5 extends Later<Merged<B1, B2, B3, B4>>, B6 extends Later<Merged<B1, B2, B3, B4, B5>>, B7 extends Later<Merged<B1, B2, B3, B4, B5, B6>>, B8 extends Later<Merged<B1, B2, B3, B4, B5, B6, B7>>>(first: B1, second: (earlier: Results<B1>) => B2, third: (earlier: Merged<B1, B2>) => B3, fourth: (earlier: Merged<B1, B2, B3>) => B4, fifth: (earlier: Merged<B1, B2, B3, B4>) => B5, sixth: (earlier: Merged<B1, B2, B3, B4, B5>) => B6, seventh: (earlier: Merged<B1, B2, B3, B4, B5, B6>) => B7, eighth: (earlier: Merged<B1, B2, B3, B4, B5, B6, B7>) => B8): Stepped<Merged<B1, B2, B3, B4, B5, B6, B7, B8>>;
123
+ }
124
+ /** `defineQuery<Schema>()`'s v7 form: a string id first. */
125
+ export interface DefinedQueryFactory<S> {
126
+ /**
127
+ * `build` returns one read, a record of facets, `steps(…)`, or a page as its single read, whose
128
+ * `output` keeps the page shape (the cursor stays the Kernel's). Its type is spelled out, not
129
+ * `PageQuery`: a Domain's exported declarations then name only `DefinedQuery`.
130
+ */
131
+ <const Id extends string, I, B extends Built | PageRead<unknown> | Stepped<unknown>, O extends PageShape<B> = BuiltResults<B> extends PageShape<B> ? BuiltResults<B> : never, E extends Errors = {}>(id: Id, spec: {
132
+ readonly build: (input: I, d: Handles<S>, steps: Steps) => B;
133
+ readonly output?: Output<S, BuiltResults<B>, I, O, E> & PortableOutput<O>;
134
+ readonly errors?: E;
135
+ }): B extends PageRead<infer T> ? DefinedQuery<Id, I, O, E> & {
136
+ readonly '~page'?: T;
137
+ } : DefinedQuery<Id, I, O, E>;
138
+ }
139
+ export {};
@@ -0,0 +1,12 @@
1
+ import type { Domain, schema } from '../../platform/schema/index.js';
2
+ import type { QueryDefinition } from './query.js';
3
+ /** The private projection of one Query definition from its exact loaded Domain. */
4
+ export type QueryProjector = (domain: Domain) => Readonly<Record<string, unknown>>;
5
+ export type ResolvedDomainOf<Schema extends schema.DomainSchema> = Extract<schema.DomainOf<Schema>, Domain>;
6
+ /** One inert Query definition of `kind`; its projector is retained privately. */
7
+ export declare function inertQuery(kind: QueryDefinition['kind'], project: QueryProjector): QueryDefinition;
8
+ /** The projector a Query definition was registered with, if it was. */
9
+ export declare function projectorOf(definition: object): QueryProjector | undefined;
10
+ /** The fields every authored Query definition shares: `id`, its operation, `prepare`, `project`, `reject`. */
11
+ export declare function definitionBase(definition: Readonly<Record<string, unknown>>, operation: 'build' | 'compose'): void;
12
+ export declare function isPromiseLike(input: unknown): input is PromiseLike<unknown>;
@@ -0,0 +1,47 @@
1
+ const projectors = new WeakMap();
2
+ /** One inert Query definition of `kind`; its projector is retained privately. */
3
+ export function inertQuery(kind, project) {
4
+ if (typeof project !== 'function')
5
+ throw new TypeError('Query projection must be a function.');
6
+ const definition = Object.freeze({ kind });
7
+ projectors.set(definition, project);
8
+ return definition;
9
+ }
10
+ /** The projector a Query definition was registered with, if it was. */
11
+ export function projectorOf(definition) {
12
+ return projectors.get(definition);
13
+ }
14
+ /** The fields every authored Query definition shares: `id`, its operation, `prepare`, `project`, `reject`. */
15
+ export function definitionBase(definition, operation) {
16
+ if (definition === null || typeof definition !== 'object' || Array.isArray(definition))
17
+ invalid();
18
+ if (typeof definition.id !== 'string' ||
19
+ definition.id.length === 0 ||
20
+ definition.id.trim() !== definition.id ||
21
+ typeof definition[operation] !== 'function') {
22
+ invalid();
23
+ }
24
+ for (const optional of ['prepare', 'project', 'reject']) {
25
+ if (definition[optional] !== undefined && typeof definition[optional] !== 'function')
26
+ invalid();
27
+ }
28
+ const allowed = new Set([
29
+ 'id',
30
+ operation,
31
+ 'prepare',
32
+ 'project',
33
+ 'reject',
34
+ ...(operation === 'build' ? ['page', 'pagination'] : []),
35
+ ]);
36
+ if (Reflect.ownKeys(definition).some((key) => typeof key !== 'string' || !allowed.has(key))) {
37
+ invalid();
38
+ }
39
+ }
40
+ function invalid() {
41
+ throw new TypeError('Query definition is invalid.');
42
+ }
43
+ export function isPromiseLike(input) {
44
+ return (input !== null &&
45
+ (typeof input === 'object' || typeof input === 'function') &&
46
+ typeof input.then === 'function');
47
+ }
@@ -0,0 +1,22 @@
1
+ /**
2
+ * The bounds a Query keeps before anything is sent (S11, spec § Queries: the contract): its
3
+ * reads, its rows, each verb's bound, and the values of a property's `in`.
4
+ */
5
+ import type { ReadPlan } from '../handles/plan.js';
6
+ import type { QueryDocument } from '../language/query.js';
7
+ /** Each read of each step, and each element of an `items.map`. */
8
+ export declare const MAXIMUM_READS = 32;
9
+ /** Steps of one Query: `steps(first, (earlier) => next, …)` takes two to this many. */
10
+ export declare const MAXIMUM_STEPS = 8;
11
+ /** Across a Query's nested lists. */
12
+ export declare const MAXIMUM_ROWS = 100000;
13
+ /** A verb's bound: its list, plus one for `all` and `first(n, { more })`, fits a Kernel page. */
14
+ export declare const MAXIMUM_BOUND = 83332;
15
+ /** Values of a property's `in`, until it is index-backed. */
16
+ export declare const MAXIMUM_IN = 16;
17
+ /** Whether a list verb of the read, at its root or in a relation, is bound past a Kernel page. */
18
+ export declare function pastPage(plan: ReadPlan): boolean;
19
+ /** The rows a read may answer, counted as the product of its verbs' bounds. */
20
+ export declare function rowsOf(plan: ReadPlan): number;
21
+ /** The first property `in` past its values, as a pointer into the document. */
22
+ export declare function wideIn(document: QueryDocument): string | undefined;
@@ -0,0 +1,88 @@
1
+ /** Each read of each step, and each element of an `items.map`. */
2
+ export const MAXIMUM_READS = 32;
3
+ /** Steps of one Query: `steps(first, (earlier) => next, …)` takes two to this many. */
4
+ export const MAXIMUM_STEPS = 8;
5
+ /** Across a Query's nested lists. */
6
+ export const MAXIMUM_ROWS = 100_000;
7
+ /** A verb's bound: its list, plus one for `all` and `first(n, { more })`, fits a Kernel page. */
8
+ export const MAXIMUM_BOUND = 83_332;
9
+ /** Values of a property's `in`, until it is index-backed. */
10
+ export const MAXIMUM_IN = 16;
11
+ /** The rows one verb reads: `get` and `find` 2, `first(n)` n, `page` and `all` max + 1. */
12
+ function verbRows(verb, bound = 0) {
13
+ switch (verb) {
14
+ case 'get':
15
+ case 'find':
16
+ return 2;
17
+ case 'first':
18
+ return 1;
19
+ case 'firstN':
20
+ return bound;
21
+ case 'firstMore':
22
+ case 'page':
23
+ case 'all':
24
+ return bound + 1;
25
+ default:
26
+ return 0;
27
+ }
28
+ }
29
+ /** The rows of one parent's relations, each row counting itself and what it carries. */
30
+ function carried(branches) {
31
+ return branches.reduce((total, b) => total + (b.empty ? 0 : verbRows(b.verb, b.bound) * (1 + carried(b.branches))), 0);
32
+ }
33
+ /** The rows of a document read from its own limits: a list's `limit`, its Branches'. */
34
+ function documentRows(document) {
35
+ const list = document.list;
36
+ if (list === undefined)
37
+ return 0;
38
+ const rows = (pattern) => {
39
+ const branches = (pattern.with ?? []);
40
+ return branches.reduce((total, b) => total + (b.mode === 'count' ? 0 : (b.limit ?? 0) * (1 + rows(b))), 0);
41
+ };
42
+ return (list.limit ?? 0) * (1 + rows(list));
43
+ }
44
+ const LISTS = new Set(['firstN', 'firstMore', 'page', 'all']);
45
+ const pastBound = (verb, bound = 0) => LISTS.has(verb) && bound > MAXIMUM_BOUND;
46
+ const branchPastBound = (branches) => branches.some((b) => pastBound(b.verb, b.bound) || branchPastBound(b.branches ?? []));
47
+ /** Whether a list verb of the read, at its root or in a relation, is bound past a Kernel page. */
48
+ export function pastPage(plan) {
49
+ const branches = plan.root?.kind === 'nodes' ? plan.root.branches : [];
50
+ return pastBound(plan.verb, plan.bound) || branchPastBound(branches);
51
+ }
52
+ /** The rows a read may answer, counted as the product of its verbs' bounds. */
53
+ export function rowsOf(plan) {
54
+ if (plan.empty)
55
+ return 0;
56
+ if (plan.verb === 'document')
57
+ return documentRows(plan.document);
58
+ const branches = plan.root?.kind === 'nodes' ? plan.root.branches : [];
59
+ return verbRows(plan.verb, plan.bound) * (1 + carried(branches));
60
+ }
61
+ /** The first property `in` past its values, as a pointer into the document. */
62
+ export function wideIn(document) {
63
+ const visit = (value, path) => {
64
+ if (Array.isArray(value)) {
65
+ for (const [index, entry] of value.entries()) {
66
+ const found = visit(entry, `${path}/${index}`);
67
+ if (found !== undefined)
68
+ return found;
69
+ }
70
+ return undefined;
71
+ }
72
+ if (value === null || typeof value !== 'object')
73
+ return undefined;
74
+ const record = value;
75
+ if (record.op === 'in')
76
+ return record.values.length > MAXIMUM_IN ? path : undefined;
77
+ // A value written in a condition is data: it is never read as a condition.
78
+ if (record.op === 'eq' || record.op === 'range' || record.op === 'id')
79
+ return undefined;
80
+ for (const [name, entry] of Object.entries(record)) {
81
+ const found = visit(entry, `${path}/${name.replaceAll('~', '~0').replaceAll('/', '~1')}`);
82
+ if (found !== undefined)
83
+ return found;
84
+ }
85
+ return undefined;
86
+ };
87
+ return visit(document, '');
88
+ }
@@ -0,0 +1,21 @@
1
+ import type { QueryPageRequest, QueryResponse } from '@astrale-os/kernel-client/graph';
2
+ import type { QueryAST, QueryResultFor } from '@astrale-os/kernel-core/graph/query';
3
+ import type { QueryDocument } from '../language/query.js';
4
+ /** What a Query v7 read is sent with: the cursor of the page it continues. */
5
+ export interface QueryRequestOptions {
6
+ readonly paging?: {
7
+ readonly after: string;
8
+ };
9
+ }
10
+ /**
11
+ * The client a Query reads through, as a Kernel Client session serves it: a v7 document per
12
+ * request, or a V6 Query's AST page by page. A client that serves V6 Queries only implements
13
+ * `QueryV6Client`.
14
+ */
15
+ export interface QueryClient {
16
+ query<Query extends QueryDocument>(query: Query, options: QueryRequestOptions): Promise<unknown>;
17
+ /** A V6 Query's read. It stays the last overload, which `Parameters` and `ReturnType` read. */
18
+ query<Ast extends QueryAST>(ast: Ast, options: {
19
+ readonly page: QueryPageRequest;
20
+ }): Promise<QueryResponse<QueryResultFor<Ast>>>;
21
+ }
@@ -0,0 +1,30 @@
1
+ import type { ClassRef, Domain } from '../../../platform/schema/index.js';
2
+ import type { Model } from '../handles/model.js';
3
+ import type { ReadPlan } from '../handles/plan.js';
4
+ /** A Class the Domain holds scopes on, and those scopes. */
5
+ export interface DeclaredClass {
6
+ readonly class: ClassRef;
7
+ readonly operations: readonly string[];
8
+ }
9
+ /**
10
+ * The Classes a Domain's requirements scope, authored or as a build compiled them: each Class
11
+ * scope, which bounds what the Domain reads for a caller. A scope on a callable names no Class.
12
+ */
13
+ export declare function declaredClasses(capabilities: object): readonly DeclaredClass[];
14
+ /**
15
+ * The S12 refusal: a `TypeError`, the same for every input and every attempt, so a durable Step
16
+ * fails at once on it.
17
+ */
18
+ export declare class UndeclaredCrossing extends TypeError {
19
+ #private;
20
+ constructor(query: string, message: string);
21
+ get query(): string;
22
+ }
23
+ /** The S12 check of one Domain: its dependencies, and the operations it declares on their Classes. */
24
+ export declare class Crossings {
25
+ #private;
26
+ readonly model: Model;
27
+ constructor(model: Model, domain: Domain, declared: readonly DeclaredClass[]);
28
+ /** Throw when a relation of the read crosses a foreign Class its Domain does not declare. */
29
+ check(query: string, plan: ReadPlan): void;
30
+ }
@@ -0,0 +1,232 @@
1
+ /**
2
+ * The Classes a read for the caller crosses, checked against what its Domain declares (S12). A
3
+ * read `as: 'caller'` is a delegation: the Kernel answers what both the caller and the Domain's
4
+ * ceiling admit, and leaves out the rest without saying so. S12 raises, at lowering and before
5
+ * anything is sent, each relation that ceiling narrows whatever the graph holds:
6
+ *
7
+ * - a relation that crosses a Class of a direct dependency other than the Kernel, whose read and
8
+ * traverse rules both admit only some callers, needs `read` or `traverse` declared on it: either
9
+ * lets the Domain traverse it (RAC-PER-PARTY-TRAVERSAL);
10
+ * - a relation's condition that tests a value of such a Class, whose read rule admits only some
11
+ * callers, needs `read` declared on it: the Kernel drops what it cannot decide (FORMULA-GATE).
12
+ *
13
+ * A rule that admits every caller (`true`, or none) needs nothing (AUTH-OPEN-LEAF). A requirement
14
+ * covers its own Class only, as the Kernel's grants do. A Class reached stands for each concrete
15
+ * Class under it the Domain can name, itself when concrete. A read `as: 'executor'` is the
16
+ * Domain's own, which no requirement changes: S12 does not check it. It reads the document as
17
+ * written, so an empty list the input gives refuses what any other list does.
18
+ */
19
+ import { Key } from '@astrale-os/kernel-dsl/v1/addressing';
20
+ import { isLegacyCapabilities } from '@astrale-os/kernel-protocol/release';
21
+ import { legacyDeclaredClasses } from './legacy/declared-classes.js';
22
+ /**
23
+ * The Classes a Domain's requirements scope, authored or as a build compiled them: each Class
24
+ * scope, which bounds what the Domain reads for a caller. A scope on a callable names no Class.
25
+ */
26
+ export function declaredClasses(capabilities) {
27
+ // The one seam to the legacy shape: a key only that shape declares selects it.
28
+ if (isLegacyCapabilities(capabilities)) {
29
+ return legacyDeclaredClasses(capabilities);
30
+ }
31
+ const { scopes = [] } = capabilities;
32
+ return Object.freeze(scopes.flatMap(({ on, operations }) => typeof on === 'string' ? [] : [Object.freeze({ class: on, operations })]));
33
+ }
34
+ /**
35
+ * The Kernel's origin. Its Classes need nothing, even when the Domain declares it a dependency, but
36
+ * the dependency Classes under an abstract one (`Identity`, `Node`) each do.
37
+ */
38
+ const KERNEL = 'kernel.astrale.ai';
39
+ /** The Kernel's abstract Edge Class. Every Edge Class is under it, though none names it a parent. */
40
+ const EDGE = `${KERNEL}:class.Edge`;
41
+ /**
42
+ * The S12 refusal: a `TypeError`, the same for every input and every attempt, so a durable Step
43
+ * fails at once on it.
44
+ */
45
+ export class UndeclaredCrossing extends TypeError {
46
+ #query;
47
+ constructor(query, message) {
48
+ super(message);
49
+ this.#query = query;
50
+ }
51
+ get query() {
52
+ return this.#query;
53
+ }
54
+ }
55
+ /** The S12 check of one Domain: its dependencies, and the operations it declares on their Classes. */
56
+ export class Crossings {
57
+ model;
58
+ /** Each direct dependency's origin but the Kernel's, by the alias the Domain gives it. */
59
+ #dependencies = new Map();
60
+ /** The operations declared on each Class, by key. */
61
+ #declared = new Map();
62
+ /** The concrete Classes of the Domain and its dependencies: those a Node or Edge can be of. */
63
+ #concrete;
64
+ constructor(model, domain, declared) {
65
+ this.model = model;
66
+ for (const [alias, dependency] of Object.entries(domain.dependencies))
67
+ if (dependency.origin !== KERNEL)
68
+ this.#dependencies.set(dependency.origin, alias);
69
+ for (const requirement of declared) {
70
+ const key = Key.of(requirement.class);
71
+ const operations = this.#declared.get(key) ?? new Set();
72
+ requirement.operations.forEach((operation) => operations.add(operation));
73
+ this.#declared.set(key, operations);
74
+ }
75
+ this.#concrete = [domain, ...Object.values(domain.dependencies)]
76
+ .flatMap((d) => Object.values(d.classes))
77
+ .filter((c) => !c.abstract);
78
+ }
79
+ /** Throw when a relation of the read crosses a foreign Class its Domain does not declare. */
80
+ check(query, plan) {
81
+ const document = (plan.written ?? plan.document);
82
+ const root = (document?.list ?? document?.exists ?? document?.count);
83
+ if (root === undefined)
84
+ return;
85
+ const branches = plan.root?.kind === 'nodes' ? plan.root.branches : undefined;
86
+ this.#where(query, root.where, undefined);
87
+ this.#branches(query, root.with, branches, undefined);
88
+ }
89
+ #branches(query, value, plans, parent) {
90
+ for (const branch of (value ?? [])) {
91
+ const plan = plans?.find((p) => p.name === branch.name);
92
+ const name = plan?.key ?? branch.name;
93
+ const relation = parent === undefined ? name : `${parent}.${name}`;
94
+ this.#traversal(query, branch, `its relation ${relation}`);
95
+ this.#branches(query, branch.with, plan?.branches, relation);
96
+ }
97
+ }
98
+ /**
99
+ * The traversals a condition holds, at any depth, and the values it tests of the `tested`
100
+ * Classes. An end of an Edge (`source`, `target`) is another subject, whose values go unchecked.
101
+ */
102
+ #where(query, value, at, tested) {
103
+ const where = value;
104
+ switch (where?.op) {
105
+ case 'and':
106
+ case 'or': {
107
+ const within = tested !== undefined && where.op === 'and'
108
+ ? { ...tested, classes: this.#narrowed(tested.classes, where) }
109
+ : tested;
110
+ for (const operand of where.operands)
111
+ this.#where(query, operand, at, within);
112
+ return;
113
+ }
114
+ case 'not':
115
+ return this.#where(query, where.operand, at, tested);
116
+ case 'source':
117
+ case 'target':
118
+ return this.#where(query, where.operand, at);
119
+ case 'exists':
120
+ return this.#traversal(query, where, at === undefined ? 'a condition' : `${at}'s condition`);
121
+ }
122
+ const property = where?.property;
123
+ if (tested === undefined || typeof property !== 'string')
124
+ return;
125
+ for (const c of tested.classes)
126
+ if ([...c.properties].some((p) => p.key === property))
127
+ this.#require(query, tested.relation, c, property);
128
+ }
129
+ /** The Edge Classes of `via`, the Node Classes they reach, then the traversal's own conditions. */
130
+ #traversal(query, traversal, label) {
131
+ const via = traversal.via;
132
+ const direction = traversal.direction;
133
+ const known = via.flatMap((key) => this.#known(key));
134
+ const relation = `${label} (via ${via.join(', ')}, ${direction})`;
135
+ const edges = [...new Set(known.flatMap((c) => this.#concreteOf(c)))];
136
+ const reached = this.model.reached(known, direction).flatMap((c) => this.#concreteOf(c));
137
+ const nodes = this.#narrowed([...new Set(reached)], traversal.node);
138
+ for (const c of [...edges, ...nodes])
139
+ this.#require(query, relation, c);
140
+ this.#where(query, traversal.edge, label, { relation, classes: edges });
141
+ this.#where(query, traversal.node, label, { relation, classes: nodes });
142
+ }
143
+ /**
144
+ * The concrete Classes a condition keeps: an `is` or `isExactly` conjunct, or an `or` of them,
145
+ * keeps those it names; one under a `not` drops them.
146
+ */
147
+ #narrowed(classes, where) {
148
+ let kept = classes;
149
+ for (const condition of conjuncts(where)) {
150
+ const dropped = condition.op === 'not' ? namedClasses(condition.operand) : undefined;
151
+ const named = dropped ?? namedClasses(condition);
152
+ if (named === undefined)
153
+ continue;
154
+ kept = kept.filter((c) => named.some((n) => (n.exact ? c.key === n.key : this.#satisfies(c).has(n.key))) !==
155
+ (dropped !== undefined));
156
+ }
157
+ return kept;
158
+ }
159
+ /**
160
+ * Throw unless a read for the caller may cross `c`, or test its `value`, as the Domain's own read
161
+ * may: `c` is no direct dependency's, or a rule it needs admits every caller, or is declared.
162
+ */
163
+ #require(query, relation, c, value) {
164
+ const alias = this.#dependencies.get(c.ref.origin);
165
+ const needed = value === undefined ? ['read', 'traverse'] : ['read'];
166
+ if (alias === undefined || needed.some((operation) => this.#admits(c, operation)))
167
+ return;
168
+ const [what, why, operation] = value === undefined
169
+ ? [
170
+ `crosses ${c.key}`,
171
+ 'read and traverse rules admit only some callers, and on which the Domain declares ' +
172
+ 'neither read nor traverse, so a read as the caller leaves it out',
173
+ 'traverse',
174
+ ]
175
+ : [
176
+ `tests ${value} of ${c.key}`,
177
+ 'read rule admits only some callers, and on which the Domain declares no read, so a ' +
178
+ 'read as the caller drops what that test cannot decide',
179
+ 'read',
180
+ ];
181
+ throw new UndeclaredCrossing(query, `Query ${query}: ${relation} ${what}, a Class of the dependency ${alias} whose ${why}. ` +
182
+ `Its requirements need the scope { on: ${c.key}, operations: ['${operation}'] }.`);
183
+ }
184
+ /**
185
+ * Whether a read for the caller may `operation` a Class as the Domain's own read may: its rule
186
+ * admits every caller (`true`, or none), or the Domain declares the operation on that Class.
187
+ */
188
+ #admits(c, operation) {
189
+ const rule = c.policies[operation];
190
+ return rule === undefined || rule === true || this.#declared.get(c.key)?.has(operation) === true;
191
+ }
192
+ /**
193
+ * The concrete Classes a Node or Edge of `c` can be of: `c` when concrete, and each concrete Class
194
+ * of the Domain or a dependency under it, as an open Class has.
195
+ */
196
+ #concreteOf(c) {
197
+ const under = this.#concrete.filter((k) => k.key !== c.key && this.#satisfies(k).has(c.key));
198
+ return c.abstract ? under : [c, ...under];
199
+ }
200
+ /** The keys a Class satisfies, the Kernel's `Edge` included for an Edge Class. */
201
+ #satisfies(c) {
202
+ const keys = this.model.satisfies(c);
203
+ return c.kind === 'edge' ? new Set([...keys, EDGE]) : keys;
204
+ }
205
+ /** The Class a key names, when the Domain can name it: the Kernel refuses any other. */
206
+ #known(key) {
207
+ try {
208
+ return [this.model.classOf(key)];
209
+ }
210
+ catch {
211
+ return [];
212
+ }
213
+ }
214
+ }
215
+ /** The Classes an `is` or `isExactly` names, alone or in an `or` of them; else `undefined`. */
216
+ function namedClasses(condition) {
217
+ if (condition.op === 'is' || condition.op === 'isExactly')
218
+ return [{ key: condition.class, exact: condition.op === 'isExactly' }];
219
+ if (condition.op !== 'or')
220
+ return undefined;
221
+ const named = condition.operands.map(namedClasses);
222
+ return named.every((n) => n !== undefined) ? named.flat() : undefined;
223
+ }
224
+ /** The conditions a condition requires all of. */
225
+ function conjuncts(value) {
226
+ const where = value;
227
+ if (where === undefined)
228
+ return [];
229
+ if (where.op === 'and')
230
+ return where.operands.flatMap(conjuncts);
231
+ return [where];
232
+ }