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

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 +40 -6
  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,117 @@
1
+ /**
2
+ * What a v7 Query answers (page "Fondations Query v7", § Résultats), typed by its Query: the
3
+ * Kernel's answer as it arrives, never reshaped. A list answers a tree of references (its Page,
4
+ * each item's Branches) and one table of the facts it renders as values; an `exists` a boolean;
5
+ * a `count` a bounded number.
6
+ *
7
+ * The types read the Query's own JSON type: the Branch names, their modes and their nesting give
8
+ * the shape of every item; the Domain gives the type of every value by its Property key. A fact
9
+ * carries no Class, so a value is typed by its key alone; a Node item carries its Class (K-C),
10
+ * which a Kernel before K-C leaves out.
11
+ */
12
+ import type { EdgeKey } from '../../../platform/graph/edge/index.js';
13
+ import type { NodeId } from '../../../platform/graph/node/index.js';
14
+ import type { QueryPropertyKey, QueryPropertyValues, QueryRendering } from '../language/query.js';
15
+ /** On request (W8): the roots the caller's view cannot decide, up to the fold's bound. */
16
+ export interface QueryUndecided {
17
+ readonly count: number;
18
+ readonly more: boolean;
19
+ }
20
+ /** One Page of a list: the exact prefix of its order, and the cursor that continues it (W3). */
21
+ export type QueryPageOf<Item> = {
22
+ readonly items: readonly Item[];
23
+ readonly undecided?: QueryUndecided;
24
+ } & ({
25
+ readonly complete: true;
26
+ } | {
27
+ readonly complete: false;
28
+ readonly cursor: string;
29
+ });
30
+ /** Bounded so a Query typed only by its constraint still resolves: 8 nested lists. */
31
+ type Depth = readonly unknown[];
32
+ type Deeper<D extends Depth> = readonly [...D, 0];
33
+ type Branches<W> = W extends readonly unknown[] ? W[number] : never;
34
+ /** The answer of one Branch: a `count`, or the Page of its list. */
35
+ export type QueryBranchAnswer<B, D extends Depth = []> = B extends {
36
+ readonly mode: 'count';
37
+ } ? {
38
+ readonly count: number;
39
+ readonly more: boolean;
40
+ readonly undecided?: QueryUndecided;
41
+ } : QueryPageOf<QueryBranchItem<B, D>>;
42
+ /** The Branches of an item, by name. */
43
+ export type QueryBranchesOf<W, D extends Depth = []> = D['length'] extends 8 ? {} : {
44
+ readonly [B in Branches<W> as B extends {
45
+ readonly name: infer N extends string;
46
+ } ? N : never]: QueryBranchAnswer<B, Deeper<D>>;
47
+ };
48
+ /** One item of a Branch list: the Node it reached, the Edge when the Branch selects it. */
49
+ export type QueryBranchItem<B, D extends Depth = []> = {
50
+ readonly fact: NodeId;
51
+ readonly class?: string;
52
+ readonly branches: QueryBranchesOf<B extends {
53
+ readonly with?: infer W;
54
+ } ? W : never, D>;
55
+ } & (B extends {
56
+ readonly selectEdge: QueryRendering;
57
+ } ? {
58
+ readonly edge: EdgeKey;
59
+ } : {
60
+ readonly edge?: never;
61
+ });
62
+ /** One item of the root list: a Node with its Branches, or an Edge with its rendered ends. */
63
+ export type QueryRootItem<R> = R extends {
64
+ readonly nodes: unknown;
65
+ } ? {
66
+ readonly fact: NodeId;
67
+ readonly class?: string;
68
+ readonly branches: QueryBranchesOf<R extends {
69
+ readonly with?: infer W;
70
+ } ? W : never>;
71
+ } : {
72
+ readonly fact: EdgeKey;
73
+ readonly source?: {
74
+ readonly fact: NodeId;
75
+ readonly class?: string;
76
+ readonly branches: {};
77
+ };
78
+ readonly target?: {
79
+ readonly fact: NodeId;
80
+ readonly class?: string;
81
+ readonly branches: {};
82
+ };
83
+ readonly branches: {};
84
+ };
85
+ /** One fact a list renders as values: its readable values and the keys it withholds (R9). */
86
+ export interface QueryFact<Source> {
87
+ readonly fact: NodeId | EdgeKey;
88
+ /** By Property key; a key the Domain does not define may appear (a newer Schema). */
89
+ readonly values: QueryPropertyValues<Source>;
90
+ readonly withheld: readonly QueryPropertyKey<Source>[];
91
+ }
92
+ /** The answer of a `list`: its Page, the facts it renders, the revision it read (W6). */
93
+ export interface QueryListAnswer<Source, Q> {
94
+ readonly list: QueryPageOf<QueryRootItem<Q extends {
95
+ readonly list: infer R;
96
+ } ? R : never>>;
97
+ readonly facts: readonly QueryFact<Source>[];
98
+ readonly revision: string;
99
+ /** A continuation crossed a revision: its Page reads a later snapshot than its first. */
100
+ readonly revised?: true;
101
+ }
102
+ export interface QueryExistsAnswer {
103
+ readonly exists: boolean;
104
+ readonly undecided?: boolean;
105
+ }
106
+ export interface QueryCountAnswer {
107
+ readonly count: number;
108
+ readonly more: boolean;
109
+ readonly undecided?: QueryUndecided;
110
+ }
111
+ /** What a Query answers, by its family (the name of its root fold). */
112
+ export type QueryAnswerOf<Source, Q> = Q extends {
113
+ readonly list: unknown;
114
+ } ? QueryListAnswer<Source, Q> : Q extends {
115
+ readonly exists: unknown;
116
+ } ? QueryExistsAnswer : QueryCountAnswer;
117
+ export {};
@@ -0,0 +1,4 @@
1
+ import type { Domain } from '../../../platform/schema/index.js';
2
+ import type { QueryListAnswer } from './answer.js';
3
+ /** Throw `QueryValueMismatchError` for the first value that does not match its Property. */
4
+ export declare function requireAnswerConformance(domain: Domain, answer: QueryListAnswer<unknown, unknown>): void;
@@ -0,0 +1,27 @@
1
+ import { definedClass } from '@astrale-os/kernel-client/graph';
2
+ import { QueryValueMismatchError } from '../failure.js';
3
+ import { factKey } from './facts.js';
4
+ const PROPERTY = '.property.';
5
+ /** The Property a key names in `domain`, or `undefined` when `domain` does not define it. */
6
+ function propertyOf(domain, key) {
7
+ const at = key.lastIndexOf(PROPERTY);
8
+ if (at <= 0)
9
+ return undefined;
10
+ const owner = definedClass(domain, key.slice(0, at));
11
+ return owner?.properties.get(key);
12
+ }
13
+ /** Throw `QueryValueMismatchError` for the first value that does not match its Property. */
14
+ export function requireAnswerConformance(domain, answer) {
15
+ for (const fact of answer.facts) {
16
+ const values = fact.values;
17
+ for (const key of Object.keys(values)) {
18
+ const property = propertyOf(domain, key);
19
+ if (property === undefined)
20
+ continue;
21
+ const [diagnostic] = property.validate(values[key]);
22
+ if (diagnostic !== undefined) {
23
+ throw new QueryValueMismatchError(`The value of ${key} on ${factKey(fact.fact)} does not match its Property in this Domain: ${diagnostic.message}`);
24
+ }
25
+ }
26
+ }
27
+ }
@@ -0,0 +1,17 @@
1
+ /**
2
+ * The facts table of a list answer, by identity: one index per answer, and the Pages of a root
3
+ * list joined into one complete answer.
4
+ */
5
+ import type { QueryFact, QueryListAnswer } from './answer.js';
6
+ type FactId = QueryFact<unknown>['fact'];
7
+ /** The text that names a fact: a NodeId as itself, an EdgeKey by its fields in key order. */
8
+ export declare function factKey(fact: FactId): string;
9
+ /** The facts of a list answer by identity, indexed once per answer. */
10
+ export declare function factsOf(answer: QueryListAnswer<unknown, unknown>): ReadonlyMap<string, QueryFact<unknown>>;
11
+ /**
12
+ * The Pages of one root list, joined: their items in order, their facts by identity (a later
13
+ * Page's row wins: it was read at a later revision), the last Page's revision, `revised` when a
14
+ * continuation crossed a revision. The last Page is complete; Branch lists stay as cut.
15
+ */
16
+ export declare function joinPages<A extends QueryListAnswer<unknown, unknown>>(pages: readonly [A, ...A[]]): A;
17
+ export {};
@@ -0,0 +1,57 @@
1
+ /** The text that names a fact: a NodeId as itself, an EdgeKey by its fields in key order. */
2
+ export function factKey(fact) {
3
+ if (typeof fact === 'string')
4
+ return fact;
5
+ const fields = fact;
6
+ return JSON.stringify(Object.keys(fields)
7
+ .sort()
8
+ .map((name) => [name, fields[name]]));
9
+ }
10
+ const indexes = new WeakMap();
11
+ /** The facts of a list answer by identity, indexed once per answer. */
12
+ export function factsOf(answer) {
13
+ const known = indexes.get(answer);
14
+ if (known !== undefined)
15
+ return known;
16
+ const index = new Map();
17
+ for (const fact of answer.facts)
18
+ index.set(factKey(fact.fact), fact);
19
+ indexes.set(answer, index);
20
+ return index;
21
+ }
22
+ function undecidedOf(pages) {
23
+ const reported = pages.flatMap((page) => page.list.undecided === undefined ? [] : [page.list.undecided]);
24
+ if (reported.length === 0)
25
+ return undefined;
26
+ return Object.freeze({
27
+ count: reported.reduce((total, undecided) => total + undecided.count, 0),
28
+ more: reported.some((undecided) => undecided.more),
29
+ });
30
+ }
31
+ /**
32
+ * The Pages of one root list, joined: their items in order, their facts by identity (a later
33
+ * Page's row wins: it was read at a later revision), the last Page's revision, `revised` when a
34
+ * continuation crossed a revision. The last Page is complete; Branch lists stay as cut.
35
+ */
36
+ export function joinPages(pages) {
37
+ if (pages.length === 1)
38
+ return pages[0];
39
+ const last = pages[pages.length - 1];
40
+ const facts = new Map();
41
+ for (const page of pages)
42
+ for (const fact of page.facts)
43
+ facts.set(factKey(fact.fact), fact);
44
+ const undecided = undecidedOf(pages);
45
+ const revised = pages.some((page) => page.revised === true) ||
46
+ pages.some((page) => page.revision !== pages[0].revision);
47
+ return Object.freeze({
48
+ list: Object.freeze({
49
+ items: Object.freeze(pages.flatMap((page) => page.list.items)),
50
+ complete: true,
51
+ ...(undecided === undefined ? {} : { undecided }),
52
+ }),
53
+ facts: Object.freeze([...facts.values()]),
54
+ revision: last.revision,
55
+ ...(revised ? { revised: true } : {}),
56
+ });
57
+ }
@@ -1,5 +1,5 @@
1
1
  import type { Domain } from '../../../platform/schema/index.js';
2
- import type { CollectionDefinitionRecord } from '../collection/union.js';
2
+ import type { CollectionDefinitionRecord } from '../legacy/v6/collection/union.js';
3
3
  import type { SingleQueryDefinition } from '../query.js';
4
4
  import type { QueryComposition, QueryPlan } from './query.js';
5
5
  declare const PLAN: unique symbol;
@@ -1,4 +1,4 @@
1
- import { admitCollectionDefinitions } from '../collection/union.js';
1
+ import { admitCollectionDefinitions } from '../legacy/v6/collection/union.js';
2
2
  import { QueryCompositionError } from './errors.js';
3
3
  const PLAN = Symbol('astrale.sdk.query.plan');
4
4
  const REFERENCE = Symbol('astrale.sdk.query.reference');
@@ -12,7 +12,7 @@ export function createQueryComposition() {
12
12
  requireOpen(open);
13
13
  requireLocalId(id, ids);
14
14
  if (definition?.kind !== 'query')
15
- invalid('Composite leaves must be single Query recipes.');
15
+ invalid('Composite leaves must be single Queries.');
16
16
  requireLocalReferences(input, token);
17
17
  return createPlan(token, Object.freeze({
18
18
  kind: 'leaf',
@@ -1,5 +1,5 @@
1
1
  import type { Domain } from '../../../platform/schema/index.js';
2
- import type { CollectionDefinitionRecord } from '../collection/union.js';
2
+ import type { CollectionDefinitionRecord } from '../legacy/v6/collection/union.js';
3
3
  import type { SingleQueryDefinition } from '../query.js';
4
4
  import type { InternalPlan } from './builder.js';
5
5
  export declare const QUERY_COMPOSITION_LIMITS: Readonly<{
@@ -7,10 +7,6 @@ export declare const QUERY_COMPOSITION_LIMITS: Readonly<{
7
7
  maximumDependencyDepth: 8;
8
8
  }>;
9
9
  export interface QueryPlanAnalysis {
10
- /** @deprecated Use physicalQueries. */
11
- readonly queries: number;
12
- /** @deprecated Use dependencyDepth. */
13
- readonly depth: number;
14
10
  readonly logicalQueries: number;
15
11
  readonly physicalQueries: number;
16
12
  readonly dependencyDepth: number;
@@ -1,4 +1,4 @@
1
- import { COLLECTION_QUERY_LIMITS } from '../collection/limits.js';
1
+ import { COLLECTION_QUERY_LIMITS } from '../legacy/v6/collection/limits.js';
2
2
  import { inspectPlan, referencesIn, resolveInput } from './builder.js';
3
3
  import { QueryCompositionError } from './errors.js';
4
4
  export const QUERY_COMPOSITION_LIMITS = Object.freeze({
@@ -53,8 +53,6 @@ export function analyzeQueryPlan(plan) {
53
53
  throw new QueryCompositionError('QUERY_COMPOSITION_LIMIT', `Composite Query exceeds ${QUERY_COMPOSITION_LIMITS.maximumPhysicalQueries} physical Queries or dependency depth ${QUERY_COMPOSITION_LIMITS.maximumDependencyDepth}.`);
54
54
  }
55
55
  return Object.freeze({
56
- queries: physicalKeys.size,
57
- depth: maximumDepth,
58
56
  logicalQueries,
59
57
  physicalQueries: physicalKeys.size,
60
58
  dependencyDepth: maximumDepth,
@@ -1,7 +1,6 @@
1
1
  import type { ResolvedClass } from '@astrale-os/kernel-dsl/v1';
2
2
  import type { Domain } from '../../../platform/schema/index.js';
3
- import type { CollectionQueryDefinition, QueryOutputOf, SingleQueryDefinition } from '../query.js';
4
- import type { QueryLifecycle } from '../single/index.js';
3
+ import type { CollectionQueryDefinition, QueryLifecycle, QueryOutputOf, SingleQueryDefinition } from '../query.js';
5
4
  declare const QUERY_PLAN_OUTPUT: unique symbol;
6
5
  declare const QUERY_PLAN_VALUE: unique symbol;
7
6
  export type QueryPlanValue<Value> = Readonly<{
@@ -1,34 +1,7 @@
1
- import type { QueryAST } from '@astrale-os/kernel-core/graph/query';
2
- import type { AnyResolvedClass } from '@astrale-os/kernel-dsl/v1';
3
1
  import type { Domain, schema } from '../../platform/schema/index.js';
4
2
  import type { ProjectedCompositeQuery, QueryComposition, QueryPlan, QueryPlanOutput, RawCompositeQuery } from './composite/index.js';
5
- import type { CompositeQueryDefinition, CollectionQueryDefinition, QueryDefinition, RealizedQuery, SingleQueryDefinition } from './query.js';
6
- import type { PaginatedQuery, ProjectedQuery, RawQuery, SingleQuery } from './single/index.js';
7
- import { type CollectionQuerySpec } from './collection/metadata.js';
8
- type AuthoredRaw<Input, Ast extends QueryAST> = Omit<RawQuery<Input, Ast>, 'kind' | 'page'> & {
9
- readonly page?: {
10
- readonly size: number;
11
- };
12
- };
13
- type AuthoredProjected<Input, Output, Ast extends QueryAST> = Omit<ProjectedQuery<Input, Output, Ast>, 'kind' | 'page'> & {
14
- readonly page?: {
15
- readonly size: number;
16
- };
17
- };
18
- type AuthoredPaginated<Input, Output, Ast extends QueryAST> = Omit<PaginatedQuery<Input, Output, Ast>, 'kind' | 'page'> & {
19
- readonly page?: {
20
- readonly size: number;
21
- };
22
- };
23
- type ResolvedDomainOf<Schema extends schema.DomainSchema> = Extract<schema.DomainOf<Schema>, Domain>;
24
- interface SingleQueryProjector<Schema extends schema.DomainSchema> {
25
- <Input, Ast extends QueryAST>(project: (domain: ResolvedDomainOf<Schema>) => AuthoredRaw<Input, Ast>): SingleQueryDefinition<ResolvedDomainOf<Schema>, Input, RawQuery<Input, Ast> extends SingleQuery<Input, infer Output> ? Output : never>;
26
- <Input, Output, Ast extends QueryAST>(project: (domain: ResolvedDomainOf<Schema>) => AuthoredProjected<Input, Output, Ast>): SingleQueryDefinition<ResolvedDomainOf<Schema>, Input, Output>;
27
- <Input, Output, Ast extends QueryAST>(project: (domain: ResolvedDomainOf<Schema>) => AuthoredPaginated<Input, Output, Ast>): SingleQueryDefinition<ResolvedDomainOf<Schema>, Input, Output>;
28
- }
29
- interface CollectionQueryProjector<Schema extends schema.DomainSchema> {
30
- <Class extends AnyResolvedClass>(project: (domain: ResolvedDomainOf<Schema>) => CollectionQuerySpec<Class>): CollectionQueryDefinition<ResolvedDomainOf<Schema>, Class>;
31
- }
3
+ import type { ResolvedDomainOf } from './definition.js';
4
+ import type { CompositeQueryDefinition, QueryDefinition, RealizedQuery } from './query.js';
32
5
  type AuthoredInferredComposite<Input, Composed, Plan extends QueryPlan<unknown>, Output, DomainValue extends Domain> = Omit<ProjectedCompositeQuery<Input, Composed, Output, DomainValue>, 'kind' | 'compose' | 'project'> & {
33
6
  compose(builder: QueryComposition<DomainValue>, input: Input): Plan;
34
7
  project(value: QueryPlanOutput<Plan>, input: Input): Output;
@@ -38,11 +11,7 @@ interface CompositeQueryProjector<Schema extends schema.DomainSchema> {
38
11
  <Input, Output>(project: (domain: ResolvedDomainOf<Schema>) => Omit<RawCompositeQuery<Input, Output, ResolvedDomainOf<Schema>>, 'kind'>): CompositeQueryDefinition<ResolvedDomainOf<Schema>, Input, Output>;
39
12
  <Input, Composed, Output, Plan extends QueryPlan<Composed> = QueryPlan<Composed>>(project: (domain: ResolvedDomainOf<Schema>) => AuthoredInferredComposite<Input, Composed, Plan, Output, ResolvedDomainOf<Schema>>): CompositeQueryDefinition<ResolvedDomainOf<Schema>, Input, Output>;
40
13
  }
41
- /** Define one inert single Query recipe projected from its exact loaded Domain. */
42
- export declare function defineQuery<Schema extends schema.DomainSchema>(): SingleQueryProjector<Schema>;
43
- /** Define one reusable complete polymorphic Class-extent Query. */
44
- export declare function defineCollectionQuery<Schema extends schema.DomainSchema>(): CollectionQueryProjector<Schema>;
45
- /** Define one inert composite Query recipe projected from its exact loaded Domain. */
14
+ /** Define one inert composite Query projected from its exact loaded Domain. */
46
15
  export declare function defineCompositeQuery<Schema extends schema.DomainSchema>(): CompositeQueryProjector<Schema>;
47
16
  export declare function realizeQuery<DomainValue extends Domain, Input, Output>(query: QueryDefinition<DomainValue, Input, Output>, domain: DomainValue): RealizedQuery<Input, Output>;
48
17
  export {};
@@ -1,61 +1,13 @@
1
- import { Query } from '@astrale-os/kernel-core/graph/query';
2
1
  import { isDomain } from '@astrale-os/kernel-dsl/v1/domain';
3
- import { requireUniqueCollectionValues } from './collection/identity.js';
4
- import { COLLECTION_QUERY_LIMITS } from './collection/limits.js';
5
- import { realizeCollectionQuery, registerCollectionQuery, } from './collection/metadata.js';
6
- import { queryResult } from './single/index.js';
7
- const DEFAULT_PAGE_SIZE = 256;
8
- const MAXIMUM_PAGES = 1_024;
9
- const projectors = new WeakMap();
2
+ import { definitionBase, isPromiseLike, projectorOf, inertQuery } from './definition.js';
3
+ import { admitSingle } from './legacy/v6/define.js';
10
4
  const realized = new WeakMap();
11
- /** Define one inert single Query recipe projected from its exact loaded Domain. */
12
- export function defineQuery() {
13
- return ((project) => recipe('query', project));
14
- }
15
- /** Define one reusable complete polymorphic Class-extent Query. */
16
- export function defineCollectionQuery() {
17
- return ((project) => {
18
- const definition = defineQuery()((domain) => {
19
- const specification = realizeCollectionQuery(definition, domain);
20
- const selected = specification.class;
21
- if (selected.kind === 'node') {
22
- return {
23
- id: specification.id,
24
- page: { size: COLLECTION_QUERY_LIMITS.pageSize },
25
- pagination: { maximumPages: COLLECTION_QUERY_LIMITS.maximumPages },
26
- build: () => Query.from({ nodes: [selected] }).select({
27
- kind: 'nodes',
28
- projection: { kind: 'value' },
29
- }),
30
- project: (pages) => requireUniqueCollectionValues(queryResult.completeNodeValues(pages, specification.id), `Collection Query ${specification.id}`),
31
- };
32
- }
33
- return {
34
- id: specification.id,
35
- page: { size: COLLECTION_QUERY_LIMITS.pageSize },
36
- pagination: { maximumPages: COLLECTION_QUERY_LIMITS.maximumPages },
37
- build: () => Query.from({ edges: [selected] }).select({
38
- kind: 'edges',
39
- projection: { edge: 'value', source: 'reference', target: 'reference' },
40
- }),
41
- project: (pages) => requireUniqueCollectionValues(Object.freeze(pages.flatMap((page) => queryResult.edgeItems(page, specification.id).map((item) => {
42
- if (item.edge.kind !== 'value') {
43
- throw new TypeError(`Collection Query ${specification.id} must project Edge values.`);
44
- }
45
- return item.edge.value;
46
- }))), `Collection Query ${specification.id}`),
47
- };
48
- });
49
- registerCollectionQuery(definition, project);
50
- return definition;
51
- });
52
- }
53
- /** Define one inert composite Query recipe projected from its exact loaded Domain. */
5
+ /** Define one inert composite Query projected from its exact loaded Domain. */
54
6
  export function defineCompositeQuery() {
55
- return ((project) => recipe('composite-query', project));
7
+ return ((project) => inertQuery('composite-query', project));
56
8
  }
57
9
  export function realizeQuery(query, domain) {
58
- const project = projectors.get(query);
10
+ const project = projectorOf(query);
59
11
  if (project === undefined)
60
12
  throw new TypeError('Query must be produced by defineQuery.');
61
13
  if (!isDomain(domain))
@@ -75,37 +27,6 @@ export function realizeQuery(query, domain) {
75
27
  byDomain.set(domain, admitted);
76
28
  return admitted;
77
29
  }
78
- function recipe(kind, project) {
79
- if (typeof project !== 'function')
80
- throw new TypeError('Query projection must be a function.');
81
- const definition = Object.freeze({ kind });
82
- projectors.set(definition, project);
83
- return definition;
84
- }
85
- function admitSingle(definition) {
86
- definitionBase(definition, 'build');
87
- const page = pageOf(definition.page);
88
- const pagination = definition.pagination;
89
- if (pagination !== undefined) {
90
- if (typeof definition.project !== 'function') {
91
- throw new TypeError('Paginated Query requires a project function.');
92
- }
93
- if (pagination === null ||
94
- typeof pagination !== 'object' ||
95
- Array.isArray(pagination) ||
96
- Reflect.ownKeys(pagination).length !== 1 ||
97
- !Object.hasOwn(pagination, 'maximumPages')) {
98
- throw new TypeError('Query pagination is invalid.');
99
- }
100
- const maximumPages = Reflect.get(pagination, 'maximumPages');
101
- if (!Number.isSafeInteger(maximumPages) ||
102
- maximumPages < 1 ||
103
- maximumPages > MAXIMUM_PAGES) {
104
- throw new TypeError(`Query pagination must be bounded from 1 through ${MAXIMUM_PAGES}.`);
105
- }
106
- }
107
- return Object.freeze({ ...definition, page, kind: 'single' });
108
- }
109
30
  function admitComposite(definition) {
110
31
  definitionBase(definition, 'compose');
111
32
  if (Object.hasOwn(definition, 'page') || Object.hasOwn(definition, 'pagination')) {
@@ -113,50 +34,3 @@ function admitComposite(definition) {
113
34
  }
114
35
  return Object.freeze({ ...definition, kind: 'composite' });
115
36
  }
116
- function definitionBase(definition, operation) {
117
- if (definition === null || typeof definition !== 'object' || Array.isArray(definition))
118
- invalid();
119
- if (typeof definition.id !== 'string' ||
120
- definition.id.length === 0 ||
121
- definition.id.trim() !== definition.id ||
122
- typeof definition[operation] !== 'function') {
123
- invalid();
124
- }
125
- for (const optional of ['prepare', 'project', 'reject']) {
126
- if (definition[optional] !== undefined && typeof definition[optional] !== 'function')
127
- invalid();
128
- }
129
- const allowed = new Set([
130
- 'id',
131
- operation,
132
- 'prepare',
133
- 'project',
134
- 'reject',
135
- ...(operation === 'build' ? ['page', 'pagination'] : []),
136
- ]);
137
- if (Reflect.ownKeys(definition).some((key) => typeof key !== 'string' || !allowed.has(key))) {
138
- invalid();
139
- }
140
- }
141
- function pageOf(input) {
142
- if (input === undefined)
143
- return Object.freeze({ size: DEFAULT_PAGE_SIZE });
144
- if (input === null ||
145
- typeof input !== 'object' ||
146
- Array.isArray(input) ||
147
- Reflect.ownKeys(input).length !== 1 ||
148
- !Object.hasOwn(input, 'size') ||
149
- !Number.isSafeInteger(Reflect.get(input, 'size')) ||
150
- Reflect.get(input, 'size') < 1) {
151
- throw new TypeError('Query page size must be a positive safe integer.');
152
- }
153
- return Object.freeze({ size: Reflect.get(input, 'size') });
154
- }
155
- function invalid() {
156
- throw new TypeError('Query definition is invalid.');
157
- }
158
- function isPromiseLike(input) {
159
- return (input !== null &&
160
- (typeof input === 'object' || typeof input === 'function') &&
161
- typeof input.then === 'function');
162
- }
@@ -0,0 +1,45 @@
1
+ /**
2
+ * `defineQuery<Schema>()`: one name for both forms. A string id first defines a Query v7; a
3
+ * function first defines a V6 Query, which stays in `legacy/v6`. A Query v7 is inert: its id and
4
+ * the errors it declares are public, and what it reads is kept for the runtime (WP-S3).
5
+ */
6
+ import type { schema } from '../../../platform/schema/index.js';
7
+ import type { SingleQueryProjector } from '../legacy/v6/define.js';
8
+ import type { DefinedQuery, DefinedQueryFactory } from './query.js';
9
+ /** A Query or Mutation id: lowercase segments of letters, digits and hyphens, joined by dots. */
10
+ export declare const DEFINITION_ID: RegExp;
11
+ export declare const MAXIMUM_DEFINITION_ID = 128;
12
+ type Callback = (...parameters: never[]) => unknown;
13
+ /** What a Query reads and answers: its `build`, of `(input, d, steps)`, and its `output`. */
14
+ export interface QuerySpec {
15
+ readonly build: Callback;
16
+ readonly output?: Callback;
17
+ }
18
+ /** The build and the output of a Query v7; `undefined` for anything else. */
19
+ export declare function querySpecOf(query: unknown): QuerySpec | undefined;
20
+ /** A definition of the Domain's namespace, a Query's or a Mutation's: its id, and its errors. */
21
+ export type NamedDefinition = Pick<DefinedQuery, 'id' | 'errors'>;
22
+ /**
23
+ * Keep the errors a definition declares, a Query's or a Mutation's, and collect it into the
24
+ * collections open: a defined Mutation shares its Domain's Query ids and error definitions.
25
+ */
26
+ export declare function collectDefinition(query: NamedDefinition): void;
27
+ /**
28
+ * Collect into `queries` each Query or Mutation defined while `load` runs: a build collects the
29
+ * definitions that loading its Domain defines, and checks them with `admitDefinitions`. A module an
30
+ * earlier load of the same process evaluated defines nothing again, so its definitions were checked
31
+ * with that load.
32
+ */
33
+ export declare function collectDefinitions<T>(queries: NamedDefinition[], load: () => Promise<T>): Promise<T>;
34
+ /**
35
+ * Refuse two definitions of one Domain under one id: a refusal and a call name a Query or Mutation
36
+ * by its id. Refuse two that declare one code with different definitions: a Function that spreads
37
+ * both errors keeps one of them, and would redact the other definition's error.
38
+ */
39
+ export declare function admitDefinitions(queries: readonly NamedDefinition[]): void;
40
+ /**
41
+ * Define a Query: `defineQuery<Schema>()('services.service.owner', { build, output?, errors? })`.
42
+ * The V6 form, `defineQuery<Schema>()((domain) => ({ id, build, project? }))`, stays.
43
+ */
44
+ export declare function defineQuery<Schema extends schema.DomainSchema>(): SingleQueryProjector<Schema> & DefinedQueryFactory<Schema>;
45
+ export {};
@@ -0,0 +1,96 @@
1
+ import { rememberDefinedErrors } from '../../error/error.js';
2
+ import { describe } from '../handles/terms.js';
3
+ import { defineQuery as defineV6Query } from '../legacy/v6/define.js';
4
+ /** A Query or Mutation id: lowercase segments of letters, digits and hyphens, joined by dots. */
5
+ export const DEFINITION_ID = /^[a-z0-9-]+(?:\.[a-z0-9-]+)*$/u;
6
+ export const MAXIMUM_DEFINITION_ID = 128;
7
+ const FIELDS = new Set(['build', 'output', 'errors']);
8
+ const specs = new WeakMap();
9
+ /** The collections open while a build loads a Domain; no definition is kept outside one. */
10
+ const collections = new Set();
11
+ /** The build and the output of a Query v7; `undefined` for anything else. */
12
+ export function querySpecOf(query) {
13
+ return typeof query === 'object' && query !== null ? specs.get(query) : undefined;
14
+ }
15
+ function defineV7Query(id, spec) {
16
+ if (typeof id !== 'string' || id.length > MAXIMUM_DEFINITION_ID || !DEFINITION_ID.test(id))
17
+ throw new TypeError(`A Query id is lowercase segments of letters, digits and hyphens joined by dots, at most ${MAXIMUM_DEFINITION_ID} characters ('services.service.owner'); got ${describe(id)}.`);
18
+ if (typeof spec !== 'object' || spec === null || Array.isArray(spec))
19
+ throw new TypeError(`Query ${id} takes { build, output?, errors? }; got ${describe(spec)}.`);
20
+ const fields = spec;
21
+ const unknown = Reflect.ownKeys(fields).filter((key) => typeof key !== 'string' || !FIELDS.has(key));
22
+ if (unknown.length > 0)
23
+ throw new TypeError(`Query ${id} takes build, output and errors only; got ${unknown.map(String).join(', ')}: do that work in build or output.`);
24
+ const { build, output } = fields;
25
+ if (typeof build !== 'function')
26
+ throw new TypeError(`Query ${id}'s build is a function of (input, d, steps) that returns a read, a record of facets, or steps(first, (earlier) => next, …); got ${describe(build)}.`);
27
+ if (output !== undefined && typeof output !== 'function')
28
+ throw new TypeError(`Query ${id}'s output is a function of (results, input, context); got ${describe(output)}.`);
29
+ const errors = fields.errors ?? {};
30
+ if (typeof errors !== 'object' || errors === null || Array.isArray(errors))
31
+ throw new TypeError(`Query ${id}'s errors is a record of declared errors by UPPER_SNAKE code; got ${describe(errors)}.`);
32
+ const query = Object.freeze({ id, errors: Object.freeze({ ...errors }) });
33
+ collectDefinition(query);
34
+ specs.set(query, Object.freeze({
35
+ build: build,
36
+ ...(output !== undefined ? { output: output } : {}),
37
+ }));
38
+ return query;
39
+ }
40
+ /**
41
+ * Keep the errors a definition declares, a Query's or a Mutation's, and collect it into the
42
+ * collections open: a defined Mutation shares its Domain's Query ids and error definitions.
43
+ */
44
+ export function collectDefinition(query) {
45
+ rememberDefinedErrors(query, query.id, query.errors);
46
+ for (const collection of collections)
47
+ collection.push(query);
48
+ }
49
+ /**
50
+ * Collect into `queries` each Query or Mutation defined while `load` runs: a build collects the
51
+ * definitions that loading its Domain defines, and checks them with `admitDefinitions`. A module an
52
+ * earlier load of the same process evaluated defines nothing again, so its definitions were checked
53
+ * with that load.
54
+ */
55
+ export async function collectDefinitions(queries, load) {
56
+ collections.add(queries);
57
+ try {
58
+ return await load();
59
+ }
60
+ finally {
61
+ collections.delete(queries);
62
+ }
63
+ }
64
+ /**
65
+ * Refuse two definitions of one Domain under one id: a refusal and a call name a Query or Mutation
66
+ * by its id. Refuse two that declare one code with different definitions: a Function that spreads
67
+ * both errors keeps one of them, and would redact the other definition's error.
68
+ */
69
+ export function admitDefinitions(queries) {
70
+ const ids = new Set();
71
+ for (const { id } of queries) {
72
+ if (ids.has(id))
73
+ throw new TypeError(`Two Queries or Mutations of the Domain are named ${id}: an id is unique in its Domain.`);
74
+ ids.add(id);
75
+ }
76
+ const first = new Map();
77
+ for (const query of queries) {
78
+ for (const [code, declaration] of Object.entries(query.errors)) {
79
+ const seen = first.get(code);
80
+ if (seen === undefined)
81
+ first.set(code, { query: query.id, declaration });
82
+ else if (seen.declaration !== declaration)
83
+ throw new TypeError(`${seen.query} and ${query.id} declare ${code} with different definitions: declare it once and share that object, so a Function that re-declares both keeps each.`);
84
+ }
85
+ }
86
+ }
87
+ /**
88
+ * Define a Query: `defineQuery<Schema>()('services.service.owner', { build, output?, errors? })`.
89
+ * The V6 form, `defineQuery<Schema>()((domain) => ({ id, build, project? }))`, stays.
90
+ */
91
+ export function defineQuery() {
92
+ const v6 = defineV6Query();
93
+ return ((first, spec) => typeof first === 'string'
94
+ ? defineV7Query(first, spec)
95
+ : v6(first));
96
+ }