@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,381 @@
1
+ # Handler authority and dependency calls
2
+
3
+ Actions and Workflows receive `kernel`, `graph`, `query`, `mutate`, and `dependencies`.
4
+ Local capabilities default to the executing Domain's self authority. Direct dependency calls
5
+ select `caller` or `self` explicitly.
6
+
7
+ | Surface | Default authority | Explicit selection |
8
+ | --- | --- | --- |
9
+ | `kernel` | Executing Domain | `.caller`, `.self` |
10
+ | `graph` | Executing Domain | `.caller`, `.self` |
11
+ | `query`, `mutate` | None for a Query v7 or a defined Mutation; executing Domain for a V6 Query, and for a Mutation without `as` | `{ as: 'executor' }`, `{ as: 'caller' }`; a V6 Query through `graph` |
12
+ | `dependencies.alias` | Explicit selection required | `.caller.invoke`, `.self.invoke` |
13
+
14
+ `self` executes as the Domain. `caller` executes with the Domain as principal on behalf of the one
15
+ incoming caller Identity. These defaults belong to the API surface. A foreign target does not
16
+ silently change the authority selected by `kernel.invoke`.
17
+
18
+ ## The caller
19
+
20
+ An authenticated handler receives `caller.identity` and `caller.principal`. `identity` is the one
21
+ Identity whose authority the invocation exercises: use it for ownership, attribution, and
22
+ per-user lookups. `principal` is the Identity whose credential authenticated the call, never
23
+ the user once a Domain acts for them: after token exchange it is the Domain that exchanged the
24
+ token (with the Session `exchange` option, this Domain), and after a `caller` dependency call it is
25
+ the calling Domain. A caller is always exactly one Identity.
26
+
27
+ ## Public callables
28
+
29
+ A callable declared `auth: 'anonymous'` admits a call that carries no credential. Such a call has
30
+ no caller, so its handler acts as the installed Domain alone:
31
+
32
+ ```ts
33
+ export const submitLead = defineAction<typeof schema>()('submitLead', ({ input, mutate }) =>
34
+ mutate(createLead, input, { as: 'executor' }),
35
+ )
36
+ ```
37
+
38
+ - `caller` is `{ kind: 'anonymous' }`: there is no Identity to attribute the call to.
39
+ - `kernel`, `graph`, `query`, `mutate`, and `dependencies.alias.self` are the same Domain self
40
+ authority an authenticated handler receives. Installation requirements and ownership bound it;
41
+ nothing is granted to whoever sent the call.
42
+ - `kernel.caller`, `graph.caller`, `dependencies.alias.caller`, and a Provider's `execution.invoke`
43
+ are absent, and typed as possibly absent in an `anonymous` callable. Reach them through the
44
+ selection itself: `graph.caller?.query(...)`, or test `graph.caller !== undefined` first. A check
45
+ on `caller.kind` does not narrow them.
46
+ - The same callable called with a credential is authenticated as usual and receives its caller. An
47
+ invalid credential is refused; it never falls back to an anonymous call.
48
+
49
+ The Kernel admits a public call without asking who sent it, and the handler then runs with the
50
+ Domain's authority. The callable's input contract and its handler are therefore the only gate:
51
+ admit only what the public may submit, and return only what the public may read.
52
+
53
+ ## Declaring and invoking a dependency
54
+
55
+ Declare the exact remote Schema and each consumed callable requirement in Domain composition:
56
+
57
+ ```ts
58
+ import { DirectorySchema } from '@example/directory-domain'
59
+ import { defineDomain, requirements } from '@astrale-os/sdk/domain'
60
+ import { defineSchema, schema as language } from '@astrale-os/sdk/schema'
61
+
62
+ const schema = defineSchema('consumer.example', {
63
+ name: 'Consumer',
64
+ dependencies: { directory: DirectorySchema },
65
+ // Compose local callable declarations here.
66
+ })
67
+ const directory = language.resolve(DirectorySchema)
68
+ export const domain = defineDomain({
69
+ schema,
70
+ runtime,
71
+ requirements: requirements({
72
+ scopes: [{ on: directory.functions.lookup, operations: ['call'] }],
73
+ }),
74
+ })
75
+ ```
76
+
77
+ The handler uses the declared alias without importing the remote Domain:
78
+
79
+ ```ts
80
+ export const lookup = defineAction<typeof schema>()('lookup', ({ dependencies, input }) =>
81
+ dependencies.directory.caller.invoke(d => d.functions.lookup, input),
82
+ )
83
+ ```
84
+
85
+ Other callable shapes use the same invoker and require their own exact `call` scope:
86
+
87
+ ```ts
88
+ await dependencies.directory.caller.invoke(d => d.classes.Employee.static.methods.create, input)
89
+ await dependencies.directory.self.invoke(d => d.classes.Employee.methods.rename, instance, input)
90
+ ```
91
+
92
+ `instance` is a canonical `NodeId`. Input is always explicit, including `null` for a null-input
93
+ contract. The selector runs once against the loaded dependency and must return its exact owned,
94
+ concrete callable object. Copied, stale, foreign, abstract, or asynchronous selections fail before
95
+ transport. Current published Class resolution may expose an inherited alias to the same owning
96
+ Method object; invocation still uses that exact owner. It never invents a new inherited target.
97
+
98
+ The invoker preserves Function and Method input/output inference, including value streams and binary
99
+ responses. A durable callable answers with the Execution it starts, so its call types as
100
+ `ExecutionRef<Output>`. For value input, its optional third argument (fourth for instance Methods) accepts only
101
+ `timeoutMs` and `idempotencyKey`, using the canonical Client session types. The Kernel accepts an
102
+ `idempotencyKey` only for a durable callable, where it names the Execution the call starts, and
103
+ refuses it for any other. Cancellation and the parent deadline are inherited. A timeout can shorten
104
+ the deadline; a child does not inherit the parent's idempotency key. Detached
105
+ `const { invoke } = dependencies.directory.caller` keeps its types and authority binding.
106
+
107
+ ## Receiving a file
108
+
109
+ A file never travels inside a call. The client uploads its bytes to the Kernel first, and the call
110
+ carries the receipt the upload returned: a signed string that names the user who uploaded the
111
+ file, valid for one hour, and that serves whoever presents it to the Kernel until then. A callable
112
+ declares where it takes a file with a `file()` input field; the Kernel checks the receipt and the
113
+ field's `maxBytes` and `mediaTypes` when it admits the call. Its handler receives a file object
114
+ there, reads the file if it needs to, and attaches it to a blob Property of the Domain as the
115
+ Domain itself.
116
+
117
+ ```ts
118
+ import { defineAction, type ReceivedFile } from '@astrale-os/sdk/action'
119
+ import { defineMutation } from '@astrale-os/sdk/mutation'
120
+ import { classIcon, defineSchema, file, func, nodeClass, property, schema } from '@astrale-os/sdk/schema'
121
+ import { z } from 'zod'
122
+
123
+ const source = property(schema.values.blob({ maxBytes: 20_000_000, mediaTypes: ['text/csv'] }))
124
+ const TrialBalance = nodeClass({
125
+ icon: classIcon.neutral,
126
+ properties: { fiscalYear: z.string(), source },
127
+ policies: { read: true },
128
+ })
129
+ const Schema = defineSchema('ledger.example', {
130
+ name: 'Ledger',
131
+ classes: { TrialBalance },
132
+ functions: {
133
+ importBalance: func({
134
+ auth: 'authenticated',
135
+ input: z.strictObject({
136
+ fiscalYear: z.string(),
137
+ balance: file(source), // the field states the Property's constraints
138
+ attachments: z.array(file({ maxBytes: 5_000_000 })).max(10),
139
+ }),
140
+ output: z.string(),
141
+ }),
142
+ },
143
+ })
144
+
145
+ const recordBalance = defineMutation<typeof Schema>()('trialBalance.record', {
146
+ build(input: { fiscalYear: string; balance: ReceivedFile }, { TrialBalance }, mutation) {
147
+ mutation.createNode({
148
+ as: 'balance',
149
+ class: TrialBalance,
150
+ props: { fiscalYear: input.fiscalYear, source: input.balance }, // attached as it is
151
+ })
152
+ },
153
+ })
154
+
155
+ export const importBalance = defineAction<typeof Schema>()(
156
+ 'importBalance',
157
+ async ({ input, mutate }) => {
158
+ const csv = await input.balance.text() // whole file, in memory: 10 MiB at most
159
+ if (!csv.startsWith('account,')) throw new Error('Not a trial balance.')
160
+ await mutate(recordBalance, input, { as: 'executor' }) // the Domain writes its own record
161
+ return csv.split('\n').length.toString()
162
+ },
163
+ )
164
+ ```
165
+
166
+ `ReceivedFile` is exported by `@astrale-os/sdk/action`. A client sends the file in two steps,
167
+ upload then call, or lets the typed `invoke` of a Client Session upload a `Blob` or `File` found at
168
+ a `file()` field before it calls:
169
+
170
+ ```ts
171
+ const { receipt } = await session.content.upload(csv, { mediaType: 'text/csv' })
172
+ await session.invoke(reference(ledger, ledger.functions.importBalance), {
173
+ fiscalYear: '2026',
174
+ balance: receipt,
175
+ attachments: [],
176
+ })
177
+ ```
178
+
179
+ ### Reading the file
180
+
181
+ | Member | Returns |
182
+ | --- | --- |
183
+ | `receipt` | The receipt the caller sent. |
184
+ | `stream()` | A `ReadableStream<Uint8Array>` of the file, for a file of any size. |
185
+ | `text()` | The whole file decoded as UTF-8. |
186
+ | `bytes()` | The whole file as a `Uint8Array`. |
187
+
188
+ - **As the caller.** Each read downloads the file again with `kernel.caller.content.download({
189
+ receipt })`. The receipt serves whoever presents it until it expires, this Domain's own authority
190
+ included; past its hour the Kernel refuses it with `BLOB_RECEIPT_INVALID`. Nothing is kept between
191
+ reads; a file read twice is downloaded twice.
192
+ - **In memory up to `FILE_MEMORY_LIMIT`.** `text()` and `bytes()` hold the whole file, so they
193
+ refuse a file larger than `FILE_MEMORY_LIMIT` (10 MiB, exported by `@astrale-os/sdk/action`) with
194
+ `FileReadError` `FILE_MEMORY_LIMIT`, before reading it when its size is known. Read a larger file
195
+ with `stream()`.
196
+ - **Complete or failed.** `text()` and `bytes()` resolve only once the whole file arrived with the
197
+ size the Kernel declared and passed its integrity check. `stream()` hands chunks over as they
198
+ arrive and fails at its end if the file does not: write nothing derived from it anywhere lasting
199
+ before the stream ends. Cancelling the stream cancels the download.
200
+ - **The field's constraints.** The SDK checks a field's `maxBytes` and `mediaTypes` on each read
201
+ and refuses a file outside them with `FileReadError` (`FILE_TOO_LARGE`, `FILE_MEDIA_TYPE`). The
202
+ Kernel never checks them against a receipt; clients check them before they upload. A file
203
+ attached without being read is checked by the Kernel against the Property's own constraints only,
204
+ so a field that feeds a Property should state them: `file(source)` copies them, and
205
+ `file(source, { maxBytes })` may narrow them.
206
+ - **Refusals reach the caller.** A `FileReadError` the handler does not catch reaches the caller as
207
+ `LIMIT_EXCEEDED` (size) or `VALIDATION_ERROR` (media type) with its code as the reason, and the
208
+ Kernel's refusal of a receipt reaches it as the Kernel sent it.
209
+
210
+ ### Attaching the file
211
+
212
+ A blob Property value takes the file object as it is in every Mutation the SDK authors (`mutate`,
213
+ `graph.mutate`, a defined Mutation's `build`, `createNode`, `updateNode`) and writes its receipt.
214
+ Attach the file to the Domain's own records as the Domain, `mutate(definition, input, { as:
215
+ 'executor' })`: the Domain decides the write, and the Kernel applies the Property's constraints to
216
+ the file. A write `{ as: 'caller' }` also takes the receipt, under the caller's permissions. The raw
217
+ Kernel builder of `kernel.mutate((m) => ...)` takes `file.receipt`. Attaching never reads the file.
218
+
219
+ - **Within the hour.** A receipt expires one hour after its upload. Read and attach the file in
220
+ the invocation that received it; keep the attached Node, never the receipt.
221
+ - **Authenticated callables only.** A received file is read as the caller, and a call to an
222
+ `anonymous` callable may carry no caller. The runtime refuses a `file()` field in the input of an
223
+ `anonymous` callable when it is built or served.
224
+ - **Passing it on.** To hand the file to a dependency that takes it in a `file()` field, send its
225
+ receipt, as the caller or as the Domain: `dependencies.files.caller.invoke(d => d.functions.scan, { file:
226
+ input.balance.receipt })`.
227
+ - **Durable Workflows.** A durable Workflow's input holds the receipt itself at each `file()`
228
+ field, not a file object. Its Steps use it as the Domain (`kernel.content.download({ receipt })`,
229
+ a blob Property value) only until it expires, one hour after the upload: attach the file to a
230
+ Node in the run's first Steps. See
231
+ [Files in a durable Workflow](durable-workflows.md#files-in-a-durable-workflow).
232
+
233
+ ### Testing a handler
234
+
235
+ `testing.file(content, { type })` from `@astrale-os/sdk/testing` makes a file object over bytes
236
+ held in memory: a handler unit test passes it in its input without a Kernel. It reads the same bytes
237
+ on every read, under the same limits, and a Mutation attaches it as its `receipt`.
238
+
239
+ ```ts
240
+ import * as testing from '@astrale-os/sdk/testing'
241
+
242
+ const balance = testing.file('account,amount\n512,10', { type: 'text/csv' })
243
+ await expect(balance.text()).resolves.toBe('account,amount\n512,10')
244
+ ```
245
+
246
+ ## Binary Function input
247
+
248
+ A binary input carries a stream the Function processes as it arrives and does not store, such as a
249
+ payload it forwards, transforms, or measures. To receive a file the Domain stores, use a `file()`
250
+ field (see [Receiving a file](#receiving-a-file)).
251
+
252
+ A Function can declare `input.binary(metadataSchema, { maximumBytes })`. The handler receives
253
+ validated JSON metadata in `ctx.input` and a single-consumer `ReadableStream<Uint8Array>` plus its
254
+ declared byte `length` in `ctx.body`. Consume the stream through EOF before returning a successful
255
+ result. The bytes stay outside `Call.input` and are sent as the HTTP request body.
256
+
257
+ ```ts
258
+ const digest = await dependencies.hasher.caller.invoke(
259
+ d => d.functions.digest,
260
+ { mediaType: file.type },
261
+ { body: file },
262
+ )
263
+ await kernel.invoke(digestReference, { mediaType: file.type }, { body: file })
264
+ await kernel.call({ target: digestReference.target, input: { mediaType: file.type } }, { body: file })
265
+ ```
266
+
267
+ The typed `invoke` overload requires `body` for a binary Function and forbids it for a value-input
268
+ Function. Raw `call` and `dispatch` also accept `{ body }`; the Server checks the resolved Function
269
+ contract. A binary input cannot use `idempotencyKey`.
270
+
271
+ - **One reader.** `ctx.body` is the Kernel's own binary request body, `{ body:
272
+ ReadableStream<Uint8Array>, length }`. It is read once: do not `tee()` it or read it from a
273
+ durable Workflow, whose Steps are retried. `kernel.content.upload` still accepts it unread, and
274
+ streams it to the Kernel as it arrives in one attempt that is never retried, but a file the Domain
275
+ stores belongs in a `file()` field.
276
+ - **The declared length is exact.** The Server admits the body against the length its caller
277
+ declared; a body that ends early or runs over fails.
278
+ - **Declare `maximumBytes` on each binary Function.** It bounds what that Function accepts, and is
279
+ checked against the declared length before the handler runs.
280
+ - **The deployment follows the Domain.** The Server also caps every streamed request, before any
281
+ Function is chosen, with its `maximumBinaryRequestBytes`. A Worker built by the Cloudflare
282
+ adapter sets it to the largest `maximumBytes` among its Domain's binary Functions, so its
283
+ `maximumRequestBytes` (1 MiB by default, 16 MiB at most) bounds only the bodies it buffers. A
284
+ larger body is refused with `413` and `LIMIT_EXCEEDED` before the handler runs. A binary request
285
+ lives up to 30 minutes, or the deployment's `invocationTimeoutMs` when that is longer, and is
286
+ cancelled after 60 seconds without a new chunk while the handler reads it. A Domain without a
287
+ binary Function keeps the Server defaults. A host that composes `serve()` itself states these in
288
+ its `server.limits` (`maximumBinaryRequestBytes`, `binaryRequestTimeoutMs`,
289
+ `binaryRequestIdleTimeoutMs`). Cloudflare refuses a request body past its plan's limit before the
290
+ Worker runs: 100 MB on Free and Pro, 200 MB on Business, more on Enterprise.
291
+ - **Methods cannot take a binary input.** Declare a Function that names its target Node in the
292
+ metadata.
293
+
294
+ `domain.dependencies` remains immutable loaded Schema metadata. `dependencies` is a separate frozen
295
+ map containing only direct non-Kernel aliases. Each alias exposes exactly `.caller` and `.self`,
296
+ each with its own `invoke`. Selectors do not nest, and there is no default `invoke` on the alias.
297
+
298
+ ## Explicit authority
299
+
300
+ ```ts
301
+ import { reference } from '@astrale-os/sdk/client/session'
302
+ import { Path } from '@astrale-os/sdk/graph/path'
303
+
304
+ const directory = domain.dependencies.directory
305
+ const lookup = reference(directory, directory.functions.lookup)
306
+ await kernel.invoke(lookup, input) // executing Domain
307
+ await kernel.caller.invoke(lookup, input) // incoming caller Identity
308
+ await kernel.self.invoke(lookup, input) // executing Domain
309
+
310
+ const rename = reference(directory, directory.classes.Employee.methods.rename)(Path.id(instance))
311
+ await kernel.self.invoke(rename, input)
312
+ ```
313
+
314
+ `graph.query` and `graph.mutate` execute named SDK definitions. `kernel.graph` is the canonical raw
315
+ Kernel graph capability. Explicit named graph operations use `graph.caller.query` or
316
+ `graph.self.mutate`. Bare `query` and `mutate` are ordinary functions.
317
+
318
+ For U → A → B, a `caller` dependency call carries the incoming caller U and identifies A as the
319
+ outbound principal. Inside B, local defaults use B's self authority; B's next `caller` dependency
320
+ call forwards the same caller U with principal B. A caller is always one Identity. Existing
321
+ Kernel authentication, delegation, callable capability, and Policy gates still apply. This wrapper
322
+ neither grants permission nor retries denials under stronger authority.
323
+
324
+ ## Workflow and lifecycle
325
+
326
+ A direct dependency invocation is one semantic effect. Workflows place it in one named step:
327
+
328
+ ```ts
329
+ const employee = await step.run('lookup-employee', () =>
330
+ dependencies.directory.caller.invoke(d => d.functions.lookup, input),
331
+ )
332
+ await step.mutate('record-employee', recordEmployee, employee, { as: 'executor' })
333
+ ```
334
+
335
+ In a durable Workflow, the Step callback receives `dependencies` with the rest of its capabilities,
336
+ acting as the Domain alone: only `self` exists. A call to a durable callable carries the Step's
337
+ derived key, so a retried Step reaches the same child Execution; see
338
+ [Durable Workflows](durable-workflows.md).
339
+
340
+ ```ts
341
+ const shipment = await step.run('ship', ({ dependencies }) =>
342
+ dependencies.shipping.self.invoke(d => d.functions.ship, { parcel }),
343
+ )
344
+ ```
345
+
346
+ Inline Steps do not imply a distributed transaction, durable replay, or remote deduplication. Stream,
347
+ binary, and received file objects cannot become portable step results; a native streaming response belongs in an
348
+ Action. Invocation sessions remain open until a returned stream or binary body settles.
349
+
350
+ Integrations remain useful for consumer-owned substitution, replay metadata, or failure translation.
351
+ They are optional for direct declared Domain calls. Provider `execution.invoke` remains caller-bound,
352
+ and Provider auth minting retains its existing self binding.
353
+
354
+ ## Migration
355
+
356
+ The handler `client` alias is removed. Replace former `client` use with `kernel.caller` to preserve
357
+ caller authority, or choose the new self default deliberately. Custom `InvocationAuthority`
358
+ implementations now return `{ caller, graph, close }` with
359
+ `caller: { kind, principal, identity, authentication }` and `graph: { caller, self }`; remove the
360
+ redundant `client` member and the former `caller.authority` Grant. Replace `caller.authority` reads
361
+ with `caller.identity`. The standalone ClientSession remains the canonical invocation surface,
362
+ including the binary-input `invoke`, `dispatch`, and `call` overloads described above.
363
+
364
+ The `union` authority mode is removed from `kernel`, `graph`, and `dependencies`. Replace
365
+ `kernel.union`, `graph.union`, and `dependencies.alias.union` with `self` to act as the executing
366
+ Domain, or with `caller` when the call must be authorized as the incoming caller. Admission rejects
367
+ an `InvocationAuthority` whose `graph` still carries a `union` session.
368
+
369
+ A call to an `anonymous` callable that carries no credential acts as the executing Domain: it
370
+ receives `kernel`, `graph`, `query`, `mutate`, and `dependencies.alias.self`, and no `caller`
371
+ selection (see [Public callables](#public-callables)). Before, `kernel`, `graph`, and `dependencies`
372
+ were `null` there, `query` and `mutate` were absent, and a Provider's `execution.auth` was absent.
373
+ A handler or Provider that used that absence to refuse calls without a credential still compiles and
374
+ no longer refuses them. Replace such a test (`kernel === null`, `graph === null`,
375
+ `dependencies === null`, `query === undefined`) with `caller.kind === 'anonymous'`, and a Provider's
376
+ `execution.auth === undefined` with `execution.invoke === undefined`. Custom `InvocationAuthority`
377
+ implementations add `self({ via, domain, context })`, which resolves to `{ graph: { self }, close }`.
378
+
379
+ The linter accepts direct declared dependencies and canonical Kernel references. It checks exact
380
+ `call` scopes, rejects foreign handler imports, and reports opaque selectors as
381
+ indeterminate. Requirement analysis never executes selectors during compilation.
@@ -0,0 +1,62 @@
1
+ # Query V6 (legacy)
2
+
3
+ Query V6 is the Query form that builds a `QueryAST` with `Query.from(…)` inside a definition
4
+ projected from the Domain. Its definitions keep their names, types and behaviour, and are
5
+ deprecated in favour of [Query v7](../queries.md). Two places read with V6 only:
6
+
7
+ - a maintenance or repair session, where Query v7 is not served, so a migration reads with V6;
8
+ - a Host whose Kernel does not serve Query v7 and the Class of each row; [the Query
9
+ guide](../queries.md) says what a Query v7 raises there.
10
+
11
+ ## What V6 looks like
12
+
13
+ ```ts
14
+ import { defineQuery, Property, Query } from '@astrale-os/sdk/query'
15
+
16
+ export const openTasks = defineQuery<TasksSchema>()((domain) => ({
17
+ id: 'tasks.open',
18
+ page: { size: 50 },
19
+ build: () =>
20
+ Query.from({ nodes: [domain.classes.Task], binding: 'task' })
21
+ .filter({ predicate: Property(domain.classes.Task.properties.status.key).equals('open') })
22
+ .select({ kind: 'nodes', projection: { kind: 'value' } }),
23
+ project: (result) => result,
24
+ }))
25
+
26
+ const tasks = await query(openTasks)
27
+ ```
28
+
29
+ - `defineQuery<Schema>()` applied to one projector from the Domain makes a V6 definition. Applied
30
+ to an id and a spec, it makes a Query v7.
31
+ - `query(definition, input?)` reads as the installed Domain; a V6 call takes no `as`.
32
+ - `page.size` is 256 when omitted. `pagination: { maximumPages }` follows every page and runs
33
+ `project` over the completed chain.
34
+ - `defineCompositeQuery` combines several definitions in one `QueryPlan`.
35
+ `defineCollectionQuery` and `query.union` compile complete-Class reads into one `QueryAST`.
36
+ - `queryResult` reads a V6 result.
37
+ - `mutation.expect.query({ query, equals })` is a V6 precondition (Mutation v3). A Mutation holds
38
+ V6 preconditions or v7 guards, never both.
39
+
40
+ ## From V6 to v7
41
+
42
+ | V6 | v7 |
43
+ | --- | --- |
44
+ | `defineQuery<S>()((domain) => ({ id, build, project }))` | `defineQuery<S>()(id, { build: (input, d) => …, output })` |
45
+ | `Query.from({ nodes: [domain.classes.Task] })` | `d.Task` |
46
+ | `Query.from({ nodes: [taskId] })` | `d.Task.get(taskId)` |
47
+ | `Query.from({ edges: [assigned_to] })` | `d.assigned_to` |
48
+ | `.filter({ predicate: Property(key).equals(v) })` | `.where((t) => t.status.eq(v))` |
49
+ | `.expand({ via, direction })` | `.via(edge, { direction })`, or a named to-one relation: `t.assignee` |
50
+ | `.select({ kind: 'nodes', projection: { kind: 'reference' } })` | `.pick()` |
51
+ | `page: { size }` | `.page({ max })`, called with `{ size, after }` |
52
+ | `pagination: { maximumPages }` | `.all({ max })` |
53
+ | `project(result)` | `output(results, input, { error, is })` |
54
+ | `defineCompositeQuery` and dependent leaves | A record of facets, or `steps(first, (earlier) => next, …)` |
55
+ | `defineCollectionQuery`, `query.union` | `.all({ max })`, `d.A.union(d.B)` |
56
+ | `query(definition, input)` | `query(query, input, { as: 'executor' \| 'caller' })` |
57
+ | `step.query(step, definition, input)` | `step.query(step, query, input, { as: 'executor' })` |
58
+ | `expect.query({ query, equals })` | `expect.none`, `expect.exists`, `expect.count`, `expect.unchanged` |
59
+
60
+ A V6 read that v7 cannot express is bridged inside the Query v7; see
61
+ [Beyond v7](../queries.md#beyond-v7). A V6 definition moves to v7 once every Host it runs against
62
+ serves Query v7 and the Class of each row.
package/docs/legacy.md ADDED
@@ -0,0 +1,113 @@
1
+ # Legacy: keeping old behaviour without letting it spread
2
+
3
+ A change of design rarely lands everywhere at once: releases already installed, callers on older
4
+ versions and stored data keep the previous shape. This method keeps that previous behaviour
5
+ working, in one place, named, tested and ready to delete, while every other file reads as the new
6
+ design. It is shared by the Astrale repositories; this page is the reference they mirror.
7
+
8
+ The aim is that removing the old behaviour later is a deletion: delete each `legacy/` folder, its
9
+ seam's one call and its ledger row, replace each named relaxation by its target value, and nothing
10
+ else changes.
11
+
12
+ ## The rules
13
+
14
+ 1. **Target code is the only code outside `legacy/`.** Every file outside a `legacy/` folder reads
15
+ as the target design. Old names, old shapes, migration helpers and bridges live in a `legacy/`
16
+ folder next to the owner they serve (`src/application/requirements/legacy/`,
17
+ `domain/schema/modules/user/legacy/`), never in a repository-wide dumping ground. A file in it is
18
+ named for what it keeps (`legacy/member-of-group.ts`), never `compat.ts`.
19
+ 2. **Legacy is named.** Every exported legacy symbol starts with `legacy` (`legacyRequirements`,
20
+ `LEGACY_USER_INHERITANCE`) or, for a type or class, `Legacy` (`LegacyRequirementsInput`). The one
21
+ exception is a public name a release already exported, kept as a deprecated alias so no import
22
+ breaks; the ledger row lists it.
23
+ 3. **Legacy is tagged.** Every legacy export carries
24
+ `@deprecated <what it keeps> (<ledger id>). Replaced by <target symbol>. Removal: <condition>.`
25
+ 4. **One seam per owner.** Target code reaches legacy code through one explicit, named call per
26
+ owner, and the seam is target code:
27
+
28
+ ```ts
29
+ // The one seam to the legacy shape: a key only that shape declares selects it.
30
+ if (isLegacyCapabilities(input)) return legacyRequirements(input)
31
+ ```
32
+
33
+ When the test that selects legacy belongs to legacy, the legacy function makes it and answers
34
+ `undefined` otherwise, so the seam stays one call:
35
+ `const legacy = legacyRequirementEntries(definition); if (legacy !== undefined) return legacy`.
36
+ No `if (legacy)` is scattered through target modules.
37
+ 5. **Relaxations are named constants.** When the target must be relaxed for existing data (a
38
+ property that will become required, a Class that will become final), the target declaration
39
+ imports a named relaxation instead of writing the relaxed value inline:
40
+ `inheritance: LEGACY_USER_INHERITANCE` (`'open'`, target `'final'`). Removal replaces each
41
+ import by its target value.
42
+ 6. **Ledger.** Each repository keeps `legacy/LEDGER.md` at its package root (one per package when
43
+ packages are published separately) with one row per item:
44
+
45
+ `| id | legacy item (file) | replaced by | seam | removal condition | evidence (test) |`
46
+
47
+ Ids are `L-<REPO>-<n>` (`L-SDK-1`, `L-SHELL-3`) and are never reused. A repository with several
48
+ ledgers gives each package's ledger a one-letter prefix (`L-SHELL-C1` for the client SDK,
49
+ `L-SHELL-U2` for the screens) so ids stay unique across them. The seam column names the
50
+ seam's file in backticks: the boundary test reads it.
51
+ 7. **Evidence.** Each item has a test under `legacy/__tests__/` proving the old input or behaviour
52
+ still works (byte for byte where the old output is persisted or signed), and the target path has
53
+ its own tests that never import `legacy/`. A boundary test (`legacy-boundary.test.*`) fails when
54
+ a file outside a `legacy/` folder imports one without being a seam the ledger lists, when a
55
+ `legacy/` folder has no row, or when a legacy export is not named and tagged.
56
+ 8. **No new legacy consumers.** Docs, examples and scaffolds show only the target API. Legacy
57
+ documentation, when kept, moves to `docs/legacy/`. Remaining consumers that cannot move yet are
58
+ listed under the ledger table, with the reason.
59
+
60
+ ## In a Domain project
61
+
62
+ `astrale-domain lint` applies the method to Domain source:
63
+
64
+ - **Where.** A `legacy/` folder sits beside one owner: the Domain root (`legacy/`), a semantic
65
+ submodule (`functions/user/legacy/`), the Schema root (`schema/legacy/`), a Schema module
66
+ (`schema/modules/user/legacy/`) or a declaration-kind directory (`schema/policies/legacy/`).
67
+ `legacy` is therefore a reserved directory name, and folders do not nest.
68
+ - **Transparent.** Every rule reads a file in the folder as its owner's, with `legacy/` removed:
69
+ `schema/policies/legacy/is-self.ts` is a Policy leaf and declares one Policy,
70
+ `schema/modules/user/legacy/policies/owns-user.ts` is a Policy leaf of the module,
71
+ `schema/legacy/schema.ts` is a Schema facade, and `functions/user/legacy/__tests__/` is the
72
+ owner's focused evidence.
73
+ - **Keeper files.** Where the owner admits only its facade (the Domain root, the Schema root, a
74
+ Schema module), the folder may also hold flat files named for what they keep, such as
75
+ `relaxations.ts`; they construct no Schema declaration, which goes in its kind directory under
76
+ the folder.
77
+ - **Seam.** The folder exposes an `index.ts` facade (`#functions/user/legacy`,
78
+ `../legacy/index.js`). Only files of its owner (its seam) and other legacy code import it; no
79
+ file outside the folder imports past it. A layer that composes an owner's legacy, such as
80
+ `runtime.ts` registering legacy Actions, reaches it through the owner's own facade.
81
+ - **Tags.** Every declaration a legacy folder exports is named `legacy…`, `Legacy…` or `LEGACY_…`
82
+ and carries the `@deprecated … (L-<REPO>-<n>). Replaced by … Removal: …` tag.
83
+
84
+ `MOD-LEGACY` checks the placement, keepers and seams, and `QLT-LEGACY-TAG` the names and tags;
85
+ both are errors.
86
+
87
+ ## Adding a legacy item
88
+
89
+ 1. Write the target code first, with its own tests, as if the old shape never existed.
90
+ 2. Move what keeps the old behaviour into `legacy/` next to its owner; rename its exports with the
91
+ `legacy`/`Legacy` prefix and tag each one.
92
+ 3. Add the seam: one call from the owner's target entry point. If the old behaviour must be
93
+ recognized, prefer the guard the upstream owner already publishes (here the Kernel's
94
+ `isLegacyCapabilities`) over a new heuristic.
95
+ 4. Move or write the evidence under `legacy/__tests__/`. Where old output is persisted, signed or
96
+ hashed, record its exact bytes before the move and assert them after.
97
+ 5. Add the ledger row. Run the boundary test.
98
+
99
+ ## Removing a legacy item
100
+
101
+ When its removal condition holds, in a release that may break: delete the `legacy/` folder, the
102
+ seam's call (the target branch stays), the row and the consumers listed under the table; replace
103
+ named relaxations by their target values. If anything else has to change, the item was not fully
104
+ isolated: record that in the ledger before the next one.
105
+
106
+ ## In this repository
107
+
108
+ [`legacy/LEDGER.md`](../legacy/LEDGER.md) lists the items. The pre-Roles capability shape
109
+ (`functions`, `classes`, `authority`, `core`) is kept through four seams, one per owner it touches:
110
+ authoring (`requirements()`, L-SDK-1), Build compilation (L-SDK-2), the Query crossing check
111
+ (L-SDK-3) and the source rules of `astrale-domain lint` (L-SDK-4). Query V6 and the Mutation closure
112
+ form predate this method; their rows list their several importers until they are removed.
113
+ `__tests__/unit/legacy-boundary.test.ts` enforces the rules above.