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

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 +89 -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 +218 -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 +326 -0
  81. package/dist/application/query/execution/run.d.ts +85 -0
  82. package/dist/application/query/execution/run.js +372 -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 +285 -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 +978 -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 +14 -0
  292. package/dist/execution/invocation/capabilities/bind.js +74 -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 +43 -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 +24 -0
  363. package/dist/execution/workflows/receiver.js +99 -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 +48 -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 +22 -0
  424. package/dist/testing/query.js +35 -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 +492 -0
  524. package/docs/release.md +155 -0
  525. package/docs/schema-cost.md +124 -0
  526. package/package.json +53 -21
  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,326 @@
1
+ import { factKey, factsOf } from '../answer/facts.js';
2
+ import { QueryValueMismatchError } from '../failure.js';
3
+ import { ROW_KEYS } from '../handles/model.js';
4
+ import { QueryError } from './error.js';
5
+ const NO_TAKEN = new Set();
6
+ const freeze = (value) => Object.freeze(value);
7
+ /** What renders one answer: the Query it errs for, the Domain's Classes, the answer's facts. */
8
+ export class Renderer {
9
+ query;
10
+ model;
11
+ #facts;
12
+ constructor(query, model, answer) {
13
+ this.query = query;
14
+ this.model = model;
15
+ this.#facts = factsOf(answer);
16
+ }
17
+ #fact(fact) {
18
+ return this.#facts.get(factKey(fact));
19
+ }
20
+ /** Until per-property read rights exist, a fact that withholds a key is one the reader may not read. */
21
+ #withheld(fact) {
22
+ return (this.#fact(fact)?.withheld.length ?? 0) > 0;
23
+ }
24
+ #class(item) {
25
+ if (item.class === undefined)
26
+ throw new QueryError('UNSUPPORTED', this.query, { feature: 'classes' });
27
+ return item.class;
28
+ }
29
+ /**
30
+ * The Class an item renders as: of the plan's, the most derived its own Class satisfies, or the
31
+ * first in the plan's order when none derives from all the others (`Record.union(Owned)` for an
32
+ * Issue that is both).
33
+ */
34
+ #layoutClass(key, classes) {
35
+ let own;
36
+ try {
37
+ own = this.model.classOf(key);
38
+ }
39
+ catch {
40
+ // A Class this Domain cannot name (a newer Schema): one plan Class is the only reading.
41
+ return classes.length === 1 ? this.model.classOf(classes[0]) : undefined;
42
+ }
43
+ if (classes.length === 0)
44
+ return own;
45
+ const satisfied = this.model.satisfies(own);
46
+ const candidates = classes.filter((k) => satisfied.has(k)).map((k) => this.model.classOf(k));
47
+ return (candidates.find((c) => candidates.every((o) => this.model.satisfies(c).has(o.key))) ??
48
+ candidates[0]);
49
+ }
50
+ /**
51
+ * The values of a fact by the layout of a Class: flat names, then groups (F6). The row types a
52
+ * required value as present, so a fact without one breaks the Domain as a value that does not
53
+ * match its Property does.
54
+ */
55
+ #values(fact, c, taken) {
56
+ if (c === undefined)
57
+ return {};
58
+ const values = (this.#fact(fact)?.values ?? {});
59
+ for (const property of c.properties) {
60
+ if (property.definition.required && values[property.key] === undefined)
61
+ throw new QueryValueMismatchError(`${factKey(fact)} has no value for ${property.key}, which its Property requires in this Domain`);
62
+ }
63
+ const { flat, groups } = this.model.layout(c, taken);
64
+ const row = {};
65
+ for (const [name, key] of flat)
66
+ if (values[key] !== undefined)
67
+ row[name] = values[key];
68
+ for (const [group, members] of groups) {
69
+ const grouped = {};
70
+ for (const [name, key] of members)
71
+ if (values[key] !== undefined)
72
+ grouped[name] = values[key];
73
+ row[group] = freeze(grouped);
74
+ }
75
+ return row;
76
+ }
77
+ #names(c) {
78
+ return freeze(c === undefined ? [] : [...this.model.propertyNames(c)]);
79
+ }
80
+ /** A Node row, or `undefined` when the reader may not read it and the read does not keep it. */
81
+ node(item, pattern) {
82
+ const cls = this.#class(item);
83
+ const id = item.fact;
84
+ const layout = this.#layoutClass(cls, pattern.classes);
85
+ if (this.#withheld(id)) {
86
+ if (!pattern.withheld)
87
+ return undefined;
88
+ return freeze({ id, $class: cls, $withheld: this.#names(layout) });
89
+ }
90
+ const row = { id, $class: cls };
91
+ if (pattern.select === 'value')
92
+ Object.assign(row, this.#values(id, layout, ROW_KEYS));
93
+ for (const branch of pattern.branches)
94
+ row[branch.key] = this.#relation(item, branch);
95
+ const edge = pattern.edge;
96
+ if (edge !== undefined && item.edge !== undefined)
97
+ row.$edge = this.#edgeValues(item.edge, edge);
98
+ return freeze(row);
99
+ }
100
+ /** What `.withEdge()` adds: the Edge's Class, and its values or the names it withholds. */
101
+ #edgeValues(edge, select) {
102
+ if (select === 'reference')
103
+ return freeze({ $class: edge.class });
104
+ const c = this.#known(edge.class);
105
+ if (this.#withheld(edge))
106
+ return freeze({ $class: edge.class, $withheld: this.#names(c) });
107
+ return freeze({ $class: edge.class, ...this.#values(edge, c, NO_TAKEN) });
108
+ }
109
+ #known(key) {
110
+ try {
111
+ return this.model.classOf(key);
112
+ }
113
+ catch {
114
+ return undefined;
115
+ }
116
+ }
117
+ /** An Edge root row: its identity, its values and both ends by role. */
118
+ edge(item, plan) {
119
+ const key = item.fact;
120
+ const identity = { $class: key.class, $source: key.source, $target: key.target };
121
+ const c = this.#known(key.class);
122
+ if (this.#withheld(key)) {
123
+ if (!plan.withheld)
124
+ return undefined;
125
+ return freeze({ ...identity, $withheld: this.#names(c) });
126
+ }
127
+ const roles = new Set([plan.source.role, plan.target.role]);
128
+ const row = { ...identity };
129
+ if (plan.select === 'value')
130
+ Object.assign(row, this.#values(key, c, roles));
131
+ const end = (rendered, { classes, select }) => {
132
+ if (rendered === undefined)
133
+ return undefined;
134
+ return this.node(rendered, { classes, select, withheld: true, branches: [] });
135
+ };
136
+ row[plan.source.role] = end(item.source, plan.source);
137
+ row[plan.target.role] = end(item.target, plan.target);
138
+ return freeze(row);
139
+ }
140
+ /** A relation's answer for one parent, by its verb. */
141
+ #relation(parent, plan) {
142
+ if (plan.empty)
143
+ return this.#emptyRelation(parent, plan);
144
+ const answer = parent.branches[plan.name];
145
+ if (plan.verb === 'count' || plan.verb === 'exists') {
146
+ const { count, more } = answer;
147
+ return plan.verb === 'exists' ? count > 0 : freeze({ count, more });
148
+ }
149
+ const { items } = answer;
150
+ const relation = { relation: plan.relation, parent: parent.fact };
151
+ switch (plan.verb) {
152
+ case 'get':
153
+ case 'find': {
154
+ if (items.length > 1)
155
+ throw this.#integrity(relation, 2);
156
+ const [item] = items;
157
+ if (item === undefined) {
158
+ if (plan.verb === 'get')
159
+ throw this.#integrity(relation, 0);
160
+ return undefined;
161
+ }
162
+ return this.#one(item, plan);
163
+ }
164
+ case 'first':
165
+ return items[0] === undefined ? undefined : this.node(items[0], plan);
166
+ case 'firstMore': {
167
+ const n = plan.bound;
168
+ return freeze({ rows: this.#rows(items.slice(0, n), plan), more: items.length > n });
169
+ }
170
+ case 'all':
171
+ if (items.length > plan.bound)
172
+ throw new QueryError('TOO_MANY', this.query, { limit: 'max', bound: plan.bound });
173
+ return this.#rows(items, plan);
174
+ default:
175
+ return this.#rows(items, plan);
176
+ }
177
+ }
178
+ #emptyRelation(parent, plan) {
179
+ switch (plan.verb) {
180
+ case 'get':
181
+ throw this.#integrity({ relation: plan.relation, parent: parent.fact }, 0);
182
+ case 'exists':
183
+ return false;
184
+ case 'count':
185
+ return freeze({ count: 0, more: false });
186
+ case 'firstN':
187
+ case 'all':
188
+ return freeze([]);
189
+ case 'firstMore':
190
+ return freeze({ rows: freeze([]), more: false });
191
+ default:
192
+ return undefined;
193
+ }
194
+ }
195
+ #integrity(at, found) {
196
+ return new QueryError('INTEGRITY', this.query, { ...at, found });
197
+ }
198
+ /** The one row `get` or `find` gives: one the reader may not read is an error, since it exists. */
199
+ #one(item, pattern) {
200
+ if (this.#withheld(item.fact))
201
+ throw new QueryError('NOT_READABLE', this.query, { class: this.#class(item), id: item.fact });
202
+ return this.node(item, pattern);
203
+ }
204
+ #rows(items, pattern) {
205
+ return freeze(items.flatMap((item) => this.node(item, pattern) ?? []));
206
+ }
207
+ /** The rows of a root list, Node or Edge, leaving out what the reader may not read. */
208
+ rootRows(items, root) {
209
+ return freeze(items.flatMap((item) => (root.kind === 'nodes' ? this.node(item, root) : this.edge(item, root)) ?? []));
210
+ }
211
+ /** The one root row `get` or `find` gives. */
212
+ rootOne(item, root) {
213
+ if (this.#withheld(item.fact)) {
214
+ const fact = item.fact;
215
+ throw new QueryError('NOT_READABLE', this.query, {
216
+ class: typeof fact === 'string' ? this.#class(item) : fact.class,
217
+ id: fact,
218
+ });
219
+ }
220
+ return (root.kind === 'nodes' ? this.node(item, root) : this.edge(item, root));
221
+ }
222
+ }
223
+ /** The root Classes a root error names. */
224
+ function classLabel(plan) {
225
+ return plan.root?.classes.join(' | ') ?? '';
226
+ }
227
+ /** The answer of a root read with nothing to read: its verb's empty answer. */
228
+ export function emptyResult(query, plan) {
229
+ switch (plan.verb) {
230
+ case 'get':
231
+ throw new QueryError('NOT_FOUND', query, {
232
+ class: classLabel(plan),
233
+ ...(plan.target === undefined ? {} : { target: plan.target }),
234
+ });
235
+ case 'firstN':
236
+ case 'all':
237
+ return freeze([]);
238
+ case 'firstMore':
239
+ return freeze({ rows: freeze([]), more: false });
240
+ case 'page':
241
+ return freeze({ rows: freeze([]) });
242
+ case 'exists':
243
+ return false;
244
+ case 'count':
245
+ return freeze({ count: 0, more: false });
246
+ default:
247
+ return undefined;
248
+ }
249
+ }
250
+ /** A root read's result from its answer, by its verb. */
251
+ export function rootResult(query, model, plan, answer) {
252
+ const json = answer;
253
+ if ('exists' in json)
254
+ return json.exists === true;
255
+ if ('count' in json)
256
+ return freeze({ count: json.count, more: json.more === true });
257
+ const listAnswer = answer;
258
+ const renderer = new Renderer(query, model, listAnswer);
259
+ const { items, complete, cursor } = listAnswer.list;
260
+ const root = plan.root ?? documentRoot(plan);
261
+ switch (plan.verb) {
262
+ case 'get':
263
+ case 'find': {
264
+ if (items.length > 1)
265
+ throw new QueryError('INTEGRITY', query, { relation: classLabel(plan), found: 2 });
266
+ const [item] = items;
267
+ if (item === undefined)
268
+ return emptyResult(query, plan);
269
+ return renderer.rootOne(item, root);
270
+ }
271
+ case 'first':
272
+ return items[0] === undefined ? undefined : renderer.rootRows(items.slice(0, 1), root)[0];
273
+ case 'firstMore': {
274
+ const n = plan.bound;
275
+ return freeze({ rows: renderer.rootRows(items.slice(0, n), root), more: items.length > n });
276
+ }
277
+ case 'page':
278
+ return freeze({
279
+ rows: renderer.rootRows(items, root),
280
+ ...(complete || cursor === undefined ? {} : { next: cursor }),
281
+ });
282
+ case 'all':
283
+ if (items.length > plan.bound)
284
+ throw new QueryError('TOO_MANY', query, { limit: 'max', bound: plan.bound });
285
+ return renderer.rootRows(items, root);
286
+ default:
287
+ return renderer.rootRows(items, root);
288
+ }
289
+ }
290
+ /**
291
+ * The plan of a document read (D23): its rows rendered like any read, each by its own Class, its
292
+ * Branches by name, a list as rows and a count as a count.
293
+ */
294
+ function documentRoot(plan) {
295
+ const list = plan.document.list;
296
+ const branches = (pattern) => (pattern.with ?? []).map((b) => ({
297
+ key: b.name,
298
+ name: b.name,
299
+ relation: b.name,
300
+ verb: b.mode === 'count' ? 'count' : 'firstN',
301
+ empty: false,
302
+ edge: b.selectEdge,
303
+ classes: [],
304
+ select: b.select === 'value' ? 'value' : 'reference',
305
+ withheld: false,
306
+ branches: branches(b),
307
+ }));
308
+ if ('nodes' in list)
309
+ return {
310
+ kind: 'nodes',
311
+ classes: [],
312
+ select: list.select === 'value' ? 'value' : 'reference',
313
+ withheld: false,
314
+ branches: branches(list),
315
+ };
316
+ const select = (list.select ?? {});
317
+ const rendering = (side) => (select[side] === 'value' ? 'value' : 'reference');
318
+ return {
319
+ kind: 'edges',
320
+ classes: [],
321
+ select: rendering('edge'),
322
+ withheld: false,
323
+ source: { role: 'source', classes: [], select: rendering('source') },
324
+ target: { role: 'target', classes: [], select: rendering('target') },
325
+ };
326
+ }
@@ -0,0 +1,85 @@
1
+ /**
2
+ * Run a Query v7 (WP-S3): its steps in order, each one's reads together, at most 8 in flight,
3
+ * each read at its own snapshot (the stand-in); then `output`. A step's bounds (S11) are checked
4
+ * before it sends anything, and every Kernel refusal of a read is a `QueryError`.
5
+ */
6
+ import type { Domain } from '../../../platform/schema/index.js';
7
+ import type { Errors, InputOf, OutputContext, OutputOf, DefinedQuery } from '../defined/query.js';
8
+ import type { ReadPlan } from '../handles/plan.js';
9
+ import type { QueryClient } from './client.js';
10
+ import { type Model } from '../handles/model.js';
11
+ import { type DeclaredClass } from './crossings.js';
12
+ /** A page Query's call: its size, from 1 to its `max` (by default), and the cursor it continues. */
13
+ export interface QueryPageOptions {
14
+ readonly size?: number;
15
+ readonly after?: string;
16
+ }
17
+ /** A Query call's options: the authority it reads under, and a page Query's size and cursor. */
18
+ export type QueryOptions<R, As extends string> = {
19
+ readonly as: As;
20
+ } & ('~page' extends keyof R ? QueryPageOptions : {});
21
+ type Step = (...parameters: readonly unknown[]) => unknown;
22
+ /**
23
+ * One Query call: its reads so far, against S11, and, read for the caller, the Classes they cross,
24
+ * against S12.
25
+ */
26
+ export declare class Run {
27
+ #private;
28
+ readonly client: QueryClient;
29
+ readonly domain: Domain;
30
+ readonly query: string;
31
+ readonly model: Model;
32
+ constructor(client: QueryClient, domain: Domain, query: string, declared?: readonly DeclaredClass[]);
33
+ /**
34
+ * S11, before a step sends: its reads, its verbs' bounds, its rows and each property `in` its
35
+ * documents write. Then S12, given the Domain's requirements: each foreign Class its relations
36
+ * cross.
37
+ */
38
+ admit(plans: readonly ReadPlan[]): void;
39
+ /** One read's result: its verb's empty answer, or its documents' answers merged and rendered. */
40
+ read(plan: ReadPlan, paging?: QueryPageOptions): Promise<unknown>;
41
+ }
42
+ /** What `steps(…)` returned: its first record of facets, and the functions of the next ones. */
43
+ interface StepsOf {
44
+ readonly first: unknown;
45
+ readonly next: readonly Step[];
46
+ }
47
+ /**
48
+ * The `steps` a Query's `build` receives: two to eight steps, the first a record of facets and
49
+ * each next one a function of the merged results before it. It reads nothing: what it returns is
50
+ * read when `build` returns it.
51
+ */
52
+ export declare function stepsFor(query: string): (...steps: readonly unknown[]) => object;
53
+ /** The steps `build` returned, or `undefined` for one read or one record of facets. */
54
+ export declare function stepsOf(built: unknown): StepsOf | undefined;
55
+ /** Where each facet's results go: one read's index, a list of them, or nothing. */
56
+ type Shape = readonly (readonly [string, number | readonly number[] | undefined])[];
57
+ /**
58
+ * The reads of one step, admitted (S11, S12): a single read, or each facet's in order and the
59
+ * shape that puts their results back. A facet takes a name no `earlier` step read: the merged
60
+ * results keep one value per name.
61
+ */
62
+ export declare function planStep(run: Run, built: unknown, single: boolean, earlier?: Readonly<Record<string, unknown>>): {
63
+ readonly plans: readonly ReadPlan[];
64
+ readonly shape?: Shape;
65
+ };
66
+ /**
67
+ * Run a Query for `input` against `domain`, the resolved Domain it was written for: what `build`
68
+ * returns, each of its steps in order, then its `output`. A page Query takes its call's `size`
69
+ * and `after`. A read the Kernel refuses raises a `QueryError`; `output` raises the Query's
70
+ * declared errors. Read for the caller, with the Class requirements the Domain's build `declared`,
71
+ * each step's relations are checked against them first (S12).
72
+ */
73
+ export declare function runQuery<R extends DefinedQuery>(client: QueryClient, domain: Domain, query: R, input: InputOf<R>, call?: QueryPageOptions, declared?: readonly DeclaredClass[]): Promise<OutputOf<R>>;
74
+ /**
75
+ * Every row of a page Query for `input`, page after page: past `max` rows, `TOO_MANY`, as
76
+ * `all({ max })`. Each page is a call of its own, with its own bounds (S11) and its own snapshot,
77
+ * and asks for at most the rows `max` leaves, plus one: the pages read at most `max + 1` rows.
78
+ */
79
+ export declare function runEveryPage<R extends DefinedQuery>(client: QueryClient, domain: Domain, query: R, input: InputOf<R>, max: number, declared?: readonly DeclaredClass[]): Promise<readonly unknown[]>;
80
+ /**
81
+ * The context a Query's `output`, or a defined Mutation's `reject`, receives: its declared errors,
82
+ * and `is`, which narrows a row by Class.
83
+ */
84
+ export declare function outputContext(query: object, model: Model): OutputContext<unknown, Errors>;
85
+ export {};