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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (651) hide show
  1. package/README.md +213 -60
  2. package/dist/application/action/action.d.ts +6 -0
  3. package/dist/application/action/authoring.d.ts +1 -1
  4. package/dist/application/action/context.d.ts +89 -33
  5. package/dist/application/action/define.d.ts +3 -3
  6. package/dist/application/action/index.d.ts +1 -1
  7. package/dist/application/define.d.ts +8 -6
  8. package/dist/application/define.js +28 -14
  9. package/dist/application/dependency/index.d.ts +1 -1
  10. package/dist/application/dependency/invoker.d.ts +21 -10
  11. package/dist/application/domain.d.ts +30 -0
  12. package/dist/application/error/error.d.ts +16 -1
  13. package/dist/application/error/error.js +39 -5
  14. package/dist/application/error/index.d.ts +1 -1
  15. package/dist/application/error/index.js +1 -1
  16. package/dist/application/index.d.ts +4 -4
  17. package/dist/application/index.js +1 -1
  18. package/dist/application/integration/define.d.ts +8 -1
  19. package/dist/application/integration/index.d.ts +2 -2
  20. package/dist/application/integration/integration.d.ts +13 -1
  21. package/dist/application/integration/operation.d.ts +16 -3
  22. package/dist/application/mutation/authoring/builder.d.ts +81 -33
  23. package/dist/application/mutation/authoring/builder.js +100 -30
  24. package/dist/application/mutation/authoring/guard.d.ts +37 -0
  25. package/dist/application/mutation/authoring/guard.js +150 -0
  26. package/dist/application/mutation/authoring/index.d.ts +5 -2
  27. package/dist/application/mutation/authoring/index.js +2 -1
  28. package/dist/application/mutation/authoring/names.d.ts +19 -0
  29. package/dist/application/mutation/authoring/names.js +83 -0
  30. package/dist/application/mutation/authoring/properties.d.ts +5 -3
  31. package/dist/application/mutation/authoring/properties.js +35 -2
  32. package/dist/application/mutation/authoring/transition.d.ts +3 -2
  33. package/dist/application/mutation/authoring/transition.js +4 -1
  34. package/dist/application/mutation/define.d.ts +24 -10
  35. package/dist/application/mutation/define.js +49 -53
  36. package/dist/application/mutation/execution/execute.d.ts +2 -2
  37. package/dist/application/mutation/execution/execute.js +78 -7
  38. package/dist/application/mutation/execution/executor.d.ts +4 -1
  39. package/dist/application/mutation/execution/executor.js +6 -1
  40. package/dist/application/mutation/failure.d.ts +17 -1
  41. package/dist/application/mutation/failure.js +40 -19
  42. package/dist/application/mutation/index.d.ts +9 -5
  43. package/dist/application/mutation/index.js +5 -2
  44. package/dist/application/mutation/legacy/v6/builder.d.ts +84 -0
  45. package/dist/application/mutation/legacy/v6/define.d.ts +18 -0
  46. package/dist/application/mutation/legacy/v6/define.js +56 -0
  47. package/dist/application/mutation/legacy/v6/mutation.d.ts +28 -0
  48. package/dist/application/mutation/{authoring → legacy/v6}/precondition.d.ts +4 -0
  49. package/dist/application/mutation/mutation.d.ts +47 -19
  50. package/dist/application/query/answer/answer.d.ts +117 -0
  51. package/dist/application/query/answer/conformance.d.ts +4 -0
  52. package/dist/application/query/answer/conformance.js +27 -0
  53. package/dist/application/query/answer/facts.d.ts +17 -0
  54. package/dist/application/query/answer/facts.js +57 -0
  55. package/dist/application/query/composite/builder.d.ts +1 -1
  56. package/dist/application/query/composite/builder.js +2 -2
  57. package/dist/application/query/composite/plan.d.ts +1 -5
  58. package/dist/application/query/composite/plan.js +1 -3
  59. package/dist/application/query/composite/query.d.ts +1 -2
  60. package/dist/application/query/define.d.ts +3 -34
  61. package/dist/application/query/define.js +5 -131
  62. package/dist/application/query/defined/define.d.ts +45 -0
  63. package/dist/application/query/defined/define.js +96 -0
  64. package/dist/application/query/defined/query.d.ts +139 -0
  65. package/dist/application/query/definition.d.ts +12 -0
  66. package/dist/application/query/definition.js +47 -0
  67. package/dist/application/query/execution/bounds.d.ts +22 -0
  68. package/dist/application/query/execution/bounds.js +88 -0
  69. package/dist/application/query/execution/client.d.ts +21 -0
  70. package/dist/application/query/execution/crossings.d.ts +25 -0
  71. package/dist/application/query/execution/crossings.js +218 -0
  72. package/dist/application/query/execution/error.d.ts +71 -0
  73. package/dist/application/query/execution/error.js +50 -0
  74. package/dist/application/query/execution/execute.d.ts +4 -10
  75. package/dist/application/query/execution/execute.js +3 -45
  76. package/dist/application/query/execution/executor.d.ts +2 -2
  77. package/dist/application/query/execution/refusal.d.ts +37 -0
  78. package/dist/application/query/execution/refusal.js +80 -0
  79. package/dist/application/query/execution/rows.d.ts +42 -0
  80. package/dist/application/query/execution/rows.js +326 -0
  81. package/dist/application/query/execution/run.d.ts +85 -0
  82. package/dist/application/query/execution/run.js +372 -0
  83. package/dist/application/query/execution/split.d.ts +24 -0
  84. package/dist/application/query/execution/split.js +190 -0
  85. package/dist/application/query/failure.d.ts +8 -0
  86. package/dist/application/query/failure.js +8 -0
  87. package/dist/application/query/handles/build.d.ts +10 -0
  88. package/dist/application/query/handles/build.js +53 -0
  89. package/dist/application/query/handles/conditions.d.ts +94 -0
  90. package/dist/application/query/handles/domain.d.ts +157 -0
  91. package/dist/application/query/handles/handles.d.ts +285 -0
  92. package/dist/application/query/handles/handles.js +1 -0
  93. package/dist/application/query/handles/model.d.ts +106 -0
  94. package/dist/application/query/handles/model.js +261 -0
  95. package/dist/application/query/handles/plan.d.ts +100 -0
  96. package/dist/application/query/handles/plan.js +37 -0
  97. package/dist/application/query/handles/reads.d.ts +106 -0
  98. package/dist/application/query/handles/reads.js +978 -0
  99. package/dist/application/query/handles/relations.d.ts +106 -0
  100. package/dist/application/query/handles/relations.js +1 -0
  101. package/dist/application/query/handles/rows.d.ts +94 -0
  102. package/dist/application/query/handles/rows.js +4 -0
  103. package/dist/application/query/handles/terms.d.ts +103 -0
  104. package/dist/application/query/handles/terms.js +282 -0
  105. package/dist/application/query/index.d.ts +14 -8
  106. package/dist/application/query/index.js +10 -5
  107. package/dist/application/query/language/index.d.ts +2 -0
  108. package/dist/application/query/language/index.js +2 -0
  109. package/dist/application/query/language/query.d.ts +323 -0
  110. package/dist/application/query/language/query.js +2 -0
  111. package/dist/application/query/{collection → legacy/v6/collection}/identity.d.ts +2 -2
  112. package/dist/application/query/{collection → legacy/v6/collection}/metadata.d.ts +1 -1
  113. package/dist/application/query/{collection → legacy/v6/collection}/union.d.ts +4 -4
  114. package/dist/application/query/{collection → legacy/v6/collection}/union.js +15 -8
  115. package/dist/application/query/legacy/v6/conformance.d.ts +15 -0
  116. package/dist/application/query/legacy/v6/conformance.js +46 -0
  117. package/dist/application/query/legacy/v6/define.d.ts +37 -0
  118. package/dist/application/query/legacy/v6/define.js +90 -0
  119. package/dist/application/query/legacy/v6/execution/execute.d.ts +18 -0
  120. package/dist/application/query/legacy/v6/execution/execute.js +50 -0
  121. package/dist/application/query/legacy/v6/index.d.ts +7 -0
  122. package/dist/application/query/legacy/v6/index.js +3 -0
  123. package/dist/application/query/legacy/v6/kernel.d.ts +6 -0
  124. package/dist/application/query/legacy/v6/kernel.js +5 -0
  125. package/dist/application/query/{single → legacy/v6/single}/pagination.js +1 -1
  126. package/dist/application/query/{single → legacy/v6/single}/query.d.ts +2 -14
  127. package/dist/application/query/legacy/v6/single/query.js +1 -0
  128. package/dist/application/query/query.d.ts +19 -4
  129. package/dist/application/routes/admission.d.ts +3 -3
  130. package/dist/application/routes/admission.js +3 -3
  131. package/dist/application/routes/index.d.ts +3 -2
  132. package/dist/application/routes/route.d.ts +3 -3
  133. package/dist/application/runtime/actions.js +3 -0
  134. package/dist/application/runtime/declarations.d.ts +6 -6
  135. package/dist/application/runtime/define.d.ts +5 -5
  136. package/dist/application/runtime/workflows.d.ts +3 -1
  137. package/dist/application/runtime/workflows.js +3 -4
  138. package/dist/application/view/define.js +4 -6
  139. package/dist/application/view/frontend.d.ts +2 -2
  140. package/dist/application/view/index.d.ts +1 -1
  141. package/dist/application/view/route.d.ts +0 -14
  142. package/dist/application/view/route.js +1 -64
  143. package/dist/application/workflow/authoring.d.ts +3 -2
  144. package/dist/application/workflow/context.d.ts +8 -2
  145. package/dist/application/workflow/define.d.ts +4 -4
  146. package/dist/application/workflow/define.js +14 -9
  147. package/dist/application/workflow/durable.d.ts +211 -0
  148. package/dist/application/workflow/durable.js +1 -0
  149. package/dist/application/workflow/index.d.ts +3 -2
  150. package/dist/application/workflow/runner/inline.js +3 -4
  151. package/dist/application/workflow/runner/runner.d.ts +2 -2
  152. package/dist/application/workflow/step/output.d.ts +2 -0
  153. package/dist/application/workflow/step/output.js +73 -0
  154. package/dist/application/workflow/workflow.d.ts +5 -3
  155. package/dist/deployment/adapter/adapter.d.ts +55 -13
  156. package/dist/deployment/adapter/bundle/bundle.d.ts +36 -0
  157. package/dist/deployment/adapter/bundle/bundle.js +1 -0
  158. package/dist/deployment/adapter/bundle/file.d.ts +10 -0
  159. package/dist/deployment/adapter/bundle/file.js +1 -0
  160. package/dist/deployment/adapter/bundle/index.d.ts +2 -0
  161. package/dist/deployment/adapter/bundle/index.js +1 -0
  162. package/dist/deployment/adapter/define.d.ts +4 -3
  163. package/dist/deployment/adapter/define.js +107 -23
  164. package/dist/deployment/adapter/index.d.ts +4 -3
  165. package/dist/deployment/adapter/index.js +1 -0
  166. package/dist/deployment/adapter/release/command.d.ts +33 -0
  167. package/dist/deployment/adapter/release/command.js +1 -0
  168. package/dist/deployment/adapter/release/context.d.ts +94 -0
  169. package/dist/deployment/adapter/release/context.js +1 -0
  170. package/dist/deployment/adapter/release/index.d.ts +4 -0
  171. package/dist/deployment/adapter/release/index.js +1 -0
  172. package/dist/deployment/adapter/release/list.d.ts +53 -0
  173. package/dist/deployment/adapter/release/list.js +1 -0
  174. package/dist/deployment/adapter/release/refusal.d.ts +10 -0
  175. package/dist/deployment/adapter/release/refusal.js +14 -0
  176. package/dist/deployment/adapter/release/result.d.ts +56 -0
  177. package/dist/deployment/adapter/release/result.js +1 -0
  178. package/dist/deployment/address/configuration.d.ts +96 -0
  179. package/dist/deployment/address/configuration.js +274 -0
  180. package/dist/deployment/address/fingerprint.d.ts +5 -0
  181. package/dist/deployment/address/fingerprint.js +27 -0
  182. package/dist/deployment/address/index.d.ts +5 -0
  183. package/dist/deployment/address/index.js +4 -0
  184. package/dist/deployment/address/label.d.ts +42 -0
  185. package/dist/deployment/address/label.js +80 -0
  186. package/dist/deployment/address/line.d.ts +29 -0
  187. package/dist/deployment/address/line.js +53 -0
  188. package/dist/deployment/address/record.d.ts +73 -0
  189. package/dist/deployment/address/record.js +138 -0
  190. package/dist/deployment/address/summary.d.ts +30 -0
  191. package/dist/deployment/address/summary.js +1 -0
  192. package/dist/deployment/address/vectors.d.ts +60 -0
  193. package/dist/deployment/address/vectors.js +517 -0
  194. package/dist/deployment/authoring.d.ts +0 -2
  195. package/dist/deployment/authoring.js +0 -1
  196. package/dist/deployment/build/build.d.ts +15 -2
  197. package/dist/deployment/build/compile.d.ts +4 -4
  198. package/dist/deployment/build/compile.js +19 -17
  199. package/dist/deployment/build/frontend/compilation.d.ts +2 -4
  200. package/dist/deployment/build/frontend/compilation.js +0 -5
  201. package/dist/deployment/build/frontend/digest.js +1 -5
  202. package/dist/deployment/build/index.d.ts +1 -0
  203. package/dist/deployment/build/index.js +1 -0
  204. package/dist/deployment/build/manifest.d.ts +59 -0
  205. package/dist/deployment/build/manifest.js +118 -0
  206. package/dist/deployment/build/material.d.ts +2 -2
  207. package/dist/deployment/build/material.js +31 -13
  208. package/dist/deployment/build/schema.d.ts +2 -2
  209. package/dist/deployment/deployment.d.ts +3 -2
  210. package/dist/deployment/environment.d.ts +6 -0
  211. package/dist/deployment/environment.js +6 -0
  212. package/dist/deployment/index.d.ts +4 -6
  213. package/dist/deployment/index.js +1 -2
  214. package/dist/deployment/release/addressing.d.ts +6 -5
  215. package/dist/deployment/release/addressing.js +2 -3
  216. package/dist/deployment/release/assemble.d.ts +6 -3
  217. package/dist/deployment/release/assemble.js +12 -10
  218. package/dist/deployment/release/release.d.ts +16 -5
  219. package/dist/deployment/release/seal.d.ts +14 -0
  220. package/dist/deployment/release/seal.js +22 -0
  221. package/dist/deployment/release/{publication → served}/callables.d.ts +2 -2
  222. package/dist/deployment/release/{publication → served}/callables.js +2 -2
  223. package/dist/deployment/release/served/index.d.ts +11 -0
  224. package/dist/deployment/release/served/index.js +26 -0
  225. package/dist/deployment/release/{publication → served}/views.d.ts +2 -2
  226. package/dist/deployment/release/{publication → served}/views.js +0 -1
  227. package/dist/deployment/runtime/admission.d.ts +2 -2
  228. package/dist/deployment/runtime/admission.js +5 -5
  229. package/dist/deployment/verify/index.d.ts +3 -4
  230. package/dist/deployment/verify/index.js +2 -3
  231. package/dist/deployment/verify/preflight/bundle.d.ts +18 -0
  232. package/dist/deployment/verify/preflight/bundle.js +71 -0
  233. package/dist/deployment/verify/preflight/index.d.ts +1 -12
  234. package/dist/deployment/verify/preflight/index.js +1 -12
  235. package/dist/deployment/verify/readiness/fetch.d.ts +13 -0
  236. package/dist/deployment/verify/readiness/fetch.js +26 -0
  237. package/dist/deployment/verify/readiness/identity.d.ts +3 -6
  238. package/dist/deployment/verify/readiness/identity.js +3 -3
  239. package/dist/deployment/verify/readiness/index.d.ts +15 -8
  240. package/dist/deployment/verify/readiness/index.js +25 -6
  241. package/dist/deployment/verify/readiness/release.d.ts +8 -0
  242. package/dist/deployment/verify/readiness/release.js +22 -0
  243. package/dist/deployment/worker/address.d.ts +26 -0
  244. package/dist/deployment/worker/address.js +43 -0
  245. package/dist/deployment/worker/build.d.ts +60 -0
  246. package/dist/deployment/worker/build.js +172 -0
  247. package/dist/deployment/worker/configuration.d.ts +73 -0
  248. package/dist/deployment/worker/configuration.js +165 -0
  249. package/dist/deployment/worker/content.d.ts +38 -0
  250. package/dist/deployment/worker/content.js +169 -0
  251. package/dist/deployment/worker/index.d.ts +29 -0
  252. package/dist/deployment/worker/index.js +29 -0
  253. package/dist/deployment/worker/limits.d.ts +30 -0
  254. package/dist/deployment/worker/limits.js +30 -0
  255. package/dist/deployment/worker/record.d.ts +29 -0
  256. package/dist/deployment/worker/record.js +69 -0
  257. package/dist/deployment/worker/request.d.ts +118 -0
  258. package/dist/deployment/worker/request.js +280 -0
  259. package/dist/deployment/worker/response.d.ts +101 -0
  260. package/dist/deployment/worker/response.js +207 -0
  261. package/dist/execution/cache/cache.d.ts +17 -0
  262. package/dist/execution/cache/cache.js +11 -0
  263. package/dist/execution/cache/index.d.ts +2 -0
  264. package/dist/execution/cache/index.js +2 -0
  265. package/dist/execution/cache/memory.d.ts +13 -0
  266. package/dist/execution/cache/memory.js +48 -0
  267. package/dist/execution/identity/authentication.d.ts +33 -3
  268. package/dist/execution/identity/authentication.js +90 -36
  269. package/dist/execution/identity/callback.d.ts +20 -20
  270. package/dist/execution/identity/callback.js +34 -26
  271. package/dist/execution/identity/delivery.d.ts +6 -4
  272. package/dist/execution/identity/delivery.js +25 -20
  273. package/dist/execution/identity/identity.d.ts +17 -3
  274. package/dist/execution/identity/identity.js +12 -4
  275. package/dist/execution/identity/jwks.d.ts +5 -0
  276. package/dist/execution/identity/jwks.js +92 -102
  277. package/dist/execution/index.d.ts +6 -4
  278. package/dist/execution/index.js +4 -2
  279. package/dist/execution/invocation/admission/age.d.ts +57 -0
  280. package/dist/execution/invocation/admission/age.js +208 -0
  281. package/dist/execution/invocation/admission/authentication.d.ts +13 -13
  282. package/dist/execution/invocation/admission/authentication.js +52 -44
  283. package/dist/execution/invocation/admission/authority.d.ts +28 -6
  284. package/dist/execution/invocation/admission/authority.js +9 -2
  285. package/dist/execution/invocation/admission/index.d.ts +4 -3
  286. package/dist/execution/invocation/admission/index.js +3 -2
  287. package/dist/execution/invocation/admission/input.d.ts +2 -2
  288. package/dist/execution/invocation/admission/input.js +16 -2
  289. package/dist/execution/invocation/admission/target.d.ts +11 -0
  290. package/dist/execution/invocation/admission/target.js +22 -3
  291. package/dist/execution/invocation/capabilities/bind.d.ts +14 -0
  292. package/dist/execution/invocation/capabilities/bind.js +74 -0
  293. package/dist/execution/invocation/capabilities/index.d.ts +1 -0
  294. package/dist/execution/invocation/capabilities/index.js +1 -0
  295. package/dist/execution/invocation/dependency/bind.d.ts +3 -1
  296. package/dist/execution/invocation/dependency/bind.js +36 -16
  297. package/dist/execution/invocation/dispatch/action.js +4 -2
  298. package/dist/execution/invocation/dispatch/context.d.ts +7 -6
  299. package/dist/execution/invocation/dispatch/context.js +11 -44
  300. package/dist/execution/invocation/dispatch/workflow.js +4 -6
  301. package/dist/execution/invocation/handler.js +8 -2
  302. package/dist/execution/invocation/index.d.ts +2 -2
  303. package/dist/execution/invocation/index.js +1 -1
  304. package/dist/execution/invocation/integration/authentication.d.ts +3 -3
  305. package/dist/execution/invocation/integration/authentication.js +7 -7
  306. package/dist/execution/invocation/integration/call.d.ts +2 -1
  307. package/dist/execution/invocation/integration/call.js +3 -3
  308. package/dist/execution/invocation/integration/clients.d.ts +1 -1
  309. package/dist/execution/invocation/integration/index.d.ts +1 -0
  310. package/dist/execution/invocation/integration/index.js +1 -0
  311. package/dist/execution/invocation/invocation.d.ts +6 -0
  312. package/dist/execution/invocation/invocation.js +129 -21
  313. package/dist/execution/invocation/lifecycle/active.d.ts +8 -2
  314. package/dist/execution/invocation/lifecycle/active.js +3 -3
  315. package/dist/execution/invocation/lifecycle/index.d.ts +1 -1
  316. package/dist/execution/invocation/result/errors.d.ts +0 -10
  317. package/dist/execution/invocation/result/errors.js +4 -16
  318. package/dist/execution/invocation/result/index.d.ts +3 -2
  319. package/dist/execution/invocation/result/index.js +2 -1
  320. package/dist/execution/invocation/result/project.js +41 -1
  321. package/dist/execution/invocation/result/undeclared.d.ts +7 -0
  322. package/dist/execution/invocation/result/undeclared.js +18 -0
  323. package/dist/execution/node/serve.d.ts +2 -2
  324. package/dist/execution/node/serve.js +1 -1
  325. package/dist/execution/runtime/index.d.ts +1 -0
  326. package/dist/execution/runtime/index.js +1 -0
  327. package/dist/execution/runtime/load.d.ts +3 -3
  328. package/dist/execution/runtime/load.js +3 -2
  329. package/dist/execution/runtime/release.d.ts +17 -0
  330. package/dist/execution/runtime/release.js +7 -0
  331. package/dist/execution/serve.d.ts +18 -4
  332. package/dist/execution/serve.js +10 -0
  333. package/dist/execution/service/create.js +43 -7
  334. package/dist/execution/service/initialization.d.ts +4 -4
  335. package/dist/execution/service/initialization.js +23 -14
  336. package/dist/execution/service/release.d.ts +2 -2
  337. package/dist/execution/service/release.js +3 -2
  338. package/dist/execution/service/service.d.ts +20 -5
  339. package/dist/execution/service/serving/delivery.d.ts +5 -0
  340. package/dist/execution/service/{publication → serving}/delivery.js +4 -1
  341. package/dist/execution/service/{publication → serving}/index.d.ts +1 -1
  342. package/dist/execution/service/serving/installation.d.ts +4 -0
  343. package/dist/execution/service/serving/installation.js +9 -0
  344. package/dist/execution/service/serving/source.d.ts +11 -0
  345. package/dist/execution/service/serving/source.js +15 -0
  346. package/dist/execution/workflows/attempts.d.ts +87 -0
  347. package/dist/execution/workflows/attempts.js +205 -0
  348. package/dist/execution/workflows/discovery.d.ts +14 -0
  349. package/dist/execution/workflows/discovery.js +151 -0
  350. package/dist/execution/workflows/engine.d.ts +83 -0
  351. package/dist/execution/workflows/engine.js +1 -0
  352. package/dist/execution/workflows/envelope.d.ts +12 -0
  353. package/dist/execution/workflows/envelope.js +46 -0
  354. package/dist/execution/workflows/failure.d.ts +56 -0
  355. package/dist/execution/workflows/failure.js +204 -0
  356. package/dist/execution/workflows/index.d.ts +4 -0
  357. package/dist/execution/workflows/index.js +3 -0
  358. package/dist/execution/workflows/integrations.d.ts +13 -0
  359. package/dist/execution/workflows/integrations.js +25 -0
  360. package/dist/execution/workflows/options.d.ts +81 -0
  361. package/dist/execution/workflows/options.js +158 -0
  362. package/dist/execution/workflows/receiver.d.ts +24 -0
  363. package/dist/execution/workflows/receiver.js +99 -0
  364. package/dist/execution/workflows/route.d.ts +12 -0
  365. package/dist/execution/workflows/route.js +35 -0
  366. package/dist/execution/workflows/run.d.ts +23 -0
  367. package/dist/execution/workflows/run.js +369 -0
  368. package/dist/execution/workflows/steps.d.ts +48 -0
  369. package/dist/execution/workflows/steps.js +93 -0
  370. package/dist/index.d.ts +4 -4
  371. package/dist/index.js +2 -2
  372. package/dist/platform/graph/alias.d.ts +1 -5
  373. package/dist/platform/graph/alias.js +1 -5
  374. package/dist/platform/graph/document/index.d.ts +1 -1
  375. package/dist/platform/graph/document/index.js +1 -1
  376. package/dist/platform/graph/index.d.ts +1 -1
  377. package/dist/platform/graph/index.js +1 -1
  378. package/dist/platform/release/index.d.ts +2 -0
  379. package/dist/platform/release/index.js +2 -0
  380. package/dist/platform/schema/callable-authoring.d.ts +21 -0
  381. package/dist/platform/schema/callable-authoring.js +27 -0
  382. package/dist/platform/schema/class-authoring.d.ts +56 -12
  383. package/dist/platform/schema/class-authoring.js +37 -4
  384. package/dist/platform/schema/class-icon-svg.d.ts +9 -0
  385. package/dist/platform/schema/class-icon-svg.js +29 -0
  386. package/dist/platform/schema/class-icon.d.ts +3 -8
  387. package/dist/platform/schema/class-icon.js +2 -29
  388. package/dist/platform/schema/index.d.ts +6 -4
  389. package/dist/platform/schema/index.js +2 -1
  390. package/dist/platform/schema/kernel-compiled.d.ts +2 -0
  391. package/dist/platform/schema/kernel-compiled.js +2 -0
  392. package/dist/platform/schema/kernel.d.ts +4 -2
  393. package/dist/platform/schema/property.d.ts +5 -0
  394. package/dist/platform/schema/schema-authoring.d.ts +14 -7
  395. package/dist/platform/schema/schema-authoring.js +5 -1
  396. package/dist/platform/versioning/dependents.d.ts +18 -0
  397. package/dist/platform/versioning/dependents.js +15 -0
  398. package/dist/platform/versioning/index.d.ts +5 -0
  399. package/dist/platform/versioning/index.js +5 -0
  400. package/dist/platform/versioning/name.d.ts +38 -0
  401. package/dist/platform/versioning/name.js +58 -0
  402. package/dist/platform/versioning/reference.d.ts +48 -0
  403. package/dist/platform/versioning/reference.js +95 -0
  404. package/dist/platform/versioning/version.d.ts +72 -0
  405. package/dist/platform/versioning/version.js +98 -0
  406. package/dist/project/admit.js +1 -5
  407. package/dist/project/define.d.ts +4 -4
  408. package/dist/project/define.js +55 -35
  409. package/dist/project/index.d.ts +1 -1
  410. package/dist/project/install-command.d.ts +6 -0
  411. package/dist/project/install-command.js +9 -0
  412. package/dist/project/project.d.ts +10 -8
  413. package/dist/testing/dataset/define.d.ts +1 -1
  414. package/dist/testing/durable/engine.d.ts +128 -0
  415. package/dist/testing/durable/engine.js +619 -0
  416. package/dist/testing/durable/index.d.ts +3 -0
  417. package/dist/testing/durable/index.js +1 -0
  418. package/dist/testing/durable/steps.d.ts +30 -0
  419. package/dist/testing/durable/steps.js +45 -0
  420. package/dist/testing/index.d.ts +8 -1
  421. package/dist/testing/index.js +6 -1
  422. package/dist/testing/load.js +1 -1
  423. package/dist/testing/query.d.ts +22 -0
  424. package/dist/testing/query.js +35 -0
  425. package/dist/tooling/cli/adapter-command.d.ts +35 -0
  426. package/dist/tooling/cli/adapter-command.js +66 -0
  427. package/dist/tooling/cli/arguments.d.ts +17 -6
  428. package/dist/tooling/cli/arguments.js +175 -52
  429. package/dist/tooling/cli/build.d.ts +55 -0
  430. package/dist/tooling/cli/build.js +77 -0
  431. package/dist/tooling/cli/bun.d.ts +0 -1
  432. package/dist/tooling/cli/bun.js +0 -7
  433. package/dist/tooling/cli/commit.d.ts +35 -0
  434. package/dist/tooling/cli/commit.js +235 -0
  435. package/dist/tooling/cli/deploy-mode.d.ts +26 -0
  436. package/dist/tooling/cli/deploy-mode.js +59 -0
  437. package/dist/tooling/cli/deploy-result.d.ts +80 -0
  438. package/dist/tooling/cli/deploy-result.js +64 -0
  439. package/dist/tooling/cli/diff/declared.d.ts +7 -0
  440. package/dist/tooling/cli/diff/declared.js +27 -0
  441. package/dist/tooling/cli/diff/index.d.ts +30 -0
  442. package/dist/tooling/cli/diff/index.js +58 -0
  443. package/dist/tooling/cli/diff/render.d.ts +15 -0
  444. package/dist/tooling/cli/diff/render.js +131 -0
  445. package/dist/tooling/cli/diff/report.d.ts +88 -0
  446. package/dist/tooling/cli/diff/report.js +154 -0
  447. package/dist/tooling/cli/dotenv.d.ts +5 -5
  448. package/dist/tooling/cli/dotenv.js +6 -36
  449. package/dist/tooling/cli/help.js +173 -60
  450. package/dist/tooling/cli/immutable-deployment.d.ts +83 -0
  451. package/dist/tooling/cli/immutable-deployment.js +135 -0
  452. package/dist/tooling/cli/index.d.ts +12 -4
  453. package/dist/tooling/cli/index.js +6 -3
  454. package/dist/tooling/cli/installed-on.d.ts +83 -0
  455. package/dist/tooling/cli/installed-on.js +156 -0
  456. package/dist/tooling/cli/list.d.ts +152 -0
  457. package/dist/tooling/cli/list.js +331 -0
  458. package/dist/tooling/cli/log.d.ts +5 -2
  459. package/dist/tooling/cli/log.js +9 -2
  460. package/dist/tooling/cli/orchestrate.d.ts +0 -6
  461. package/dist/tooling/cli/orchestrate.js +252 -91
  462. package/dist/tooling/cli/project.d.ts +3 -3
  463. package/dist/tooling/cli/publish/index.d.ts +81 -0
  464. package/dist/tooling/cli/publish/index.js +383 -0
  465. package/dist/tooling/cli/publish/report.d.ts +49 -0
  466. package/dist/tooling/cli/publish/report.js +15 -0
  467. package/dist/tooling/cli/registry/client.d.ts +121 -0
  468. package/dist/tooling/cli/registry/client.js +354 -0
  469. package/dist/tooling/cli/registry/error.d.ts +11 -0
  470. package/dist/tooling/cli/registry/error.js +17 -0
  471. package/dist/tooling/cli/registry/executable.d.ts +35 -0
  472. package/dist/tooling/cli/registry/executable.js +96 -0
  473. package/dist/tooling/cli/registry/index.d.ts +9 -0
  474. package/dist/tooling/cli/registry/index.js +8 -0
  475. package/dist/tooling/cli/registry/installations.d.ts +67 -0
  476. package/dist/tooling/cli/registry/installations.js +108 -0
  477. package/dist/tooling/cli/registry/process.d.ts +36 -0
  478. package/dist/tooling/cli/registry/process.js +119 -0
  479. package/dist/tooling/cli/secrets.d.ts +9 -0
  480. package/dist/tooling/cli/secrets.js +19 -0
  481. package/dist/tooling/cli/yank.d.ts +34 -0
  482. package/dist/tooling/cli/yank.js +32 -0
  483. package/dist/tooling/linter/adapters/typescript/definition-calls.d.ts +34 -0
  484. package/dist/tooling/linter/adapters/typescript/definition-calls.js +88 -0
  485. package/dist/tooling/linter/adapters/typescript/imports.d.ts +0 -1
  486. package/dist/tooling/linter/adapters/typescript/imports.js +1 -5
  487. package/dist/tooling/linter/adapters/typescript/index.d.ts +3 -2
  488. package/dist/tooling/linter/adapters/typescript/index.js +3 -2
  489. package/dist/tooling/linter/adapters/typescript/query-observation.js +37 -12
  490. package/dist/tooling/linter/adapters/typescript/syntax.d.ts +3 -3
  491. package/dist/tooling/linter/adapters/typescript/syntax.js +13 -25
  492. package/dist/tooling/linter/adapters/typescript/type-analysis.d.ts +2 -0
  493. package/dist/tooling/linter/adapters/typescript/type-analysis.js +10 -0
  494. package/dist/tooling/linter/implementations/source/callable-requirements.d.ts +1 -2
  495. package/dist/tooling/linter/implementations/source/callable-requirements.js +11 -16
  496. package/dist/tooling/linter/implementations/source/definitions.d.ts +2 -0
  497. package/dist/tooling/linter/implementations/source/definitions.js +425 -0
  498. package/dist/tooling/linter/implementations/source/dependencies.js +13 -72
  499. package/dist/tooling/linter/implementations/source/global.js +18 -11
  500. package/dist/tooling/linter/implementations/source/mutations.js +146 -48
  501. package/dist/tooling/linter/implementations/source/policy-edges.d.ts +2 -0
  502. package/dist/tooling/linter/implementations/source/policy-edges.js +113 -0
  503. package/dist/tooling/linter/implementations/source/providers.js +5 -5
  504. package/dist/tooling/linter/implementations/source/queries.js +1 -17
  505. package/dist/tooling/linter/implementations/source/shared.d.ts +19 -5
  506. package/dist/tooling/linter/implementations/source/shared.js +131 -55
  507. package/dist/tooling/linter/implementations/source/verifiers.js +4 -2
  508. package/dist/tooling/linter/implementations/source/views.js +2 -2
  509. package/dist/tooling/linter/implementations/source/workflows.js +499 -17
  510. package/dist/tooling/linter/policy/generated.js +15 -64
  511. package/dist/tooling/linter/requirements/registry.js +11 -9
  512. package/dist/tooling/packaging/declarations/ownership.js +1 -1
  513. package/dist/tooling/packaging/finalize.d.ts +1 -1
  514. package/dist/tooling/packaging/finalize.js +1 -1
  515. package/docs/admission-age.md +88 -0
  516. package/docs/auth-api-migration.md +55 -0
  517. package/docs/business-errors.md +42 -0
  518. package/docs/domain-definition-migration.md +44 -0
  519. package/docs/domain-schema-migration.md +36 -0
  520. package/docs/durable-workflows.md +473 -0
  521. package/docs/handler-dependencies.md +285 -0
  522. package/docs/legacy/query-v6.md +62 -0
  523. package/docs/queries.md +492 -0
  524. package/docs/release.md +155 -0
  525. package/docs/schema-cost.md +124 -0
  526. package/package.json +53 -21
  527. package/dist/application/application.d.ts +0 -28
  528. package/dist/application/query/execution/projection.d.ts +0 -3
  529. package/dist/application/query/execution/projection.js +0 -3
  530. package/dist/deployment/adapter/deploy/context.d.ts +0 -15
  531. package/dist/deployment/adapter/deploy/index.d.ts +0 -2
  532. package/dist/deployment/adapter/deploy/result.d.ts +0 -50
  533. package/dist/deployment/adapter/prepare/artifact.d.ts +0 -33
  534. package/dist/deployment/adapter/prepare/context.d.ts +0 -23
  535. package/dist/deployment/adapter/prepare/index.d.ts +0 -2
  536. package/dist/deployment/deploy.d.ts +0 -20
  537. package/dist/deployment/deploy.js +0 -31
  538. package/dist/deployment/release/publication/index.d.ts +0 -6
  539. package/dist/deployment/release/publication/index.js +0 -6
  540. package/dist/deployment/release/publication/manifest.d.ts +0 -3
  541. package/dist/deployment/release/publication/manifest.js +0 -5
  542. package/dist/deployment/release/publication/requirements.d.ts +0 -3
  543. package/dist/deployment/release/publication/requirements.js +0 -3
  544. package/dist/deployment/release/publication/seal.d.ts +0 -10
  545. package/dist/deployment/release/publication/seal.js +0 -39
  546. package/dist/deployment/verify/preflight/artifact.d.ts +0 -6
  547. package/dist/deployment/verify/preflight/artifact.js +0 -122
  548. package/dist/deployment/verify/preflight/publication.d.ts +0 -4
  549. package/dist/deployment/verify/preflight/publication.js +0 -14
  550. package/dist/deployment/verify/readiness/deployment.d.ts +0 -3
  551. package/dist/deployment/verify/readiness/deployment.js +0 -151
  552. package/dist/deployment/verify/readiness/publication.d.ts +0 -11
  553. package/dist/deployment/verify/readiness/publication.js +0 -41
  554. package/dist/execution/service/errors.d.ts +0 -3
  555. package/dist/execution/service/errors.js +0 -3
  556. package/dist/execution/service/publication/delivery.d.ts +0 -2
  557. package/dist/execution/service/publication/installation.d.ts +0 -3
  558. package/dist/execution/service/publication/installation.js +0 -8
  559. package/dist/execution/service/publication/source.d.ts +0 -3
  560. package/dist/execution/service/publication/source.js +0 -11
  561. package/dist/platform/publication/index.d.ts +0 -2
  562. package/dist/platform/publication/index.js +0 -2
  563. package/dist/tooling/cli/astrale/authority.d.ts +0 -5
  564. package/dist/tooling/cli/astrale/authority.js +0 -11
  565. package/dist/tooling/cli/astrale/executable.d.ts +0 -2
  566. package/dist/tooling/cli/astrale/executable.js +0 -47
  567. package/dist/tooling/cli/astrale/failure.d.ts +0 -6
  568. package/dist/tooling/cli/astrale/failure.js +0 -48
  569. package/dist/tooling/cli/astrale/instance.d.ts +0 -11
  570. package/dist/tooling/cli/astrale/instance.js +0 -52
  571. package/dist/tooling/cli/astrale/process.d.ts +0 -13
  572. package/dist/tooling/cli/astrale/process.js +0 -94
  573. package/dist/tooling/cli/astrale/version.d.ts +0 -18
  574. package/dist/tooling/cli/astrale/version.js +0 -55
  575. package/dist/tooling/cli/credential.d.ts +0 -2
  576. package/dist/tooling/cli/credential.js +0 -57
  577. package/dist/tooling/cli/deprecations.d.ts +0 -9
  578. package/dist/tooling/cli/deprecations.js +0 -15
  579. package/dist/tooling/cli/development/candidate.d.ts +0 -25
  580. package/dist/tooling/cli/development/candidate.js +0 -176
  581. package/dist/tooling/cli/development/deployment.d.ts +0 -16
  582. package/dist/tooling/cli/development/deployment.js +0 -39
  583. package/dist/tooling/cli/development/develop.d.ts +0 -11
  584. package/dist/tooling/cli/development/develop.js +0 -243
  585. package/dist/tooling/cli/development/lease.d.ts +0 -18
  586. package/dist/tooling/cli/development/lease.js +0 -163
  587. package/dist/tooling/cli/development/lifecycle.d.ts +0 -9
  588. package/dist/tooling/cli/development/lifecycle.js +0 -43
  589. package/dist/tooling/cli/development/project-imports.d.ts +0 -22
  590. package/dist/tooling/cli/development/project-imports.js +0 -39
  591. package/dist/tooling/cli/development/project-lock.d.ts +0 -16
  592. package/dist/tooling/cli/development/project-lock.js +0 -41
  593. package/dist/tooling/cli/development/rebuild.d.ts +0 -13
  594. package/dist/tooling/cli/development/rebuild.js +0 -58
  595. package/dist/tooling/cli/development/release-evidence.d.ts +0 -4
  596. package/dist/tooling/cli/development/release-evidence.js +0 -10
  597. package/dist/tooling/cli/development/report.d.ts +0 -6
  598. package/dist/tooling/cli/development/report.js +0 -14
  599. package/dist/tooling/cli/development/session-file.d.ts +0 -53
  600. package/dist/tooling/cli/development/session-file.js +0 -337
  601. package/dist/tooling/cli/development/source-watch.d.ts +0 -14
  602. package/dist/tooling/cli/development/source-watch.js +0 -140
  603. package/dist/tooling/cli/development/sources.d.ts +0 -7
  604. package/dist/tooling/cli/development/sources.js +0 -48
  605. package/dist/tooling/cli/development/target-lock.d.ts +0 -16
  606. package/dist/tooling/cli/development/target-lock.js +0 -68
  607. package/dist/tooling/cli/development/view.d.ts +0 -28
  608. package/dist/tooling/cli/development/view.js +0 -151
  609. package/dist/tooling/cli/environment-release.d.ts +0 -21
  610. package/dist/tooling/cli/environment-release.js +0 -46
  611. package/dist/tooling/cli/evidence.d.ts +0 -11
  612. package/dist/tooling/cli/evidence.js +0 -53
  613. package/dist/tooling/cli/installation/index.d.ts +0 -2
  614. package/dist/tooling/cli/installation/index.js +0 -1
  615. package/dist/tooling/cli/installation/observation.d.ts +0 -10
  616. package/dist/tooling/cli/installation/observation.js +0 -44
  617. package/dist/tooling/cli/installation/reconcile.d.ts +0 -32
  618. package/dist/tooling/cli/installation/reconcile.js +0 -122
  619. package/dist/tooling/linter/implementations/source/migrations.d.ts +0 -2
  620. package/dist/tooling/linter/implementations/source/migrations.js +0 -113
  621. package/dist/tooling/linter/qualification/index.d.ts +0 -10
  622. package/dist/tooling/linter/qualification/index.js +0 -2
  623. package/dist/tooling/linter/qualification/query-fixtures.d.ts +0 -2
  624. package/dist/tooling/linter/qualification/query-fixtures.js +0 -68
  625. package/dist/tooling/linter/qualification/runner.d.ts +0 -3
  626. package/dist/tooling/linter/qualification/runner.js +0 -6
  627. /package/dist/application/{application.js → domain.js} +0 -0
  628. /package/dist/application/{query/single/query.js → mutation/legacy/v6/builder.js} +0 -0
  629. /package/dist/{deployment/adapter/deploy/context.js → application/mutation/legacy/v6/mutation.js} +0 -0
  630. /package/dist/application/mutation/{authoring → legacy/v6}/precondition.js +0 -0
  631. /package/dist/{deployment/adapter/deploy/index.js → application/query/answer/answer.js} +0 -0
  632. /package/dist/{deployment/adapter/deploy/result.js → application/query/defined/query.js} +0 -0
  633. /package/dist/{deployment/adapter/prepare/artifact.js → application/query/execution/client.js} +0 -0
  634. /package/dist/{deployment/adapter/prepare/context.js → application/query/handles/conditions.js} +0 -0
  635. /package/dist/{deployment/adapter/prepare/index.js → application/query/handles/domain.js} +0 -0
  636. /package/dist/application/query/{collection → legacy/v6/collection}/identity.js +0 -0
  637. /package/dist/application/query/{collection → legacy/v6/collection}/limits.d.ts +0 -0
  638. /package/dist/application/query/{collection → legacy/v6/collection}/limits.js +0 -0
  639. /package/dist/application/query/{collection → legacy/v6/collection}/metadata.js +0 -0
  640. /package/dist/application/query/{execution → legacy/v6/execution}/pages.d.ts +0 -0
  641. /package/dist/application/query/{execution → legacy/v6/execution}/pages.js +0 -0
  642. /package/dist/application/query/{single → legacy/v6/single}/index.d.ts +0 -0
  643. /package/dist/application/query/{single → legacy/v6/single}/index.js +0 -0
  644. /package/dist/application/query/{single → legacy/v6/single}/node.d.ts +0 -0
  645. /package/dist/application/query/{single → legacy/v6/single}/node.js +0 -0
  646. /package/dist/application/query/{single → legacy/v6/single}/pagination.d.ts +0 -0
  647. /package/dist/application/query/{single → legacy/v6/single}/selection.d.ts +0 -0
  648. /package/dist/application/query/{single → legacy/v6/single}/selection.js +0 -0
  649. /package/dist/deployment/release/{publication → served}/routes.d.ts +0 -0
  650. /package/dist/deployment/release/{publication → served}/routes.js +0 -0
  651. /package/dist/execution/service/{publication → serving}/index.js +0 -0
@@ -1,40 +1,54 @@
1
+ import { admitClassIconSvg } from '../platform/schema/class-icon-svg.js';
1
2
  import { isRequirements } from './requirements/index.js';
2
3
  import { isRoutes } from './routes/index.js';
3
4
  import { isRuntime } from './runtime/index.js';
4
5
  import { isFrontend } from './view/index.js';
5
- const admittedApplications = new WeakSet();
6
- /** Capture one inert authored Application without resolving, compiling, loading, or deploying it. */
7
- export function defineApplication(input) {
6
+ const admittedDomainDefinitions = new WeakSet();
7
+ /** Capture one inert authored Domain without resolving, compiling, loading, or deploying it. */
8
+ export function defineDomain(input) {
8
9
  if (input === null || typeof input !== 'object' || Array.isArray(input))
9
10
  invalid();
10
- const allowed = new Set(['schema', 'runtime', 'frontend', 'routes', 'requirements']);
11
+ const allowed = new Set([
12
+ 'schema',
13
+ 'runtime',
14
+ 'frontend',
15
+ 'routes',
16
+ 'requirements',
17
+ 'icon',
18
+ ]);
11
19
  if (Reflect.ownKeys(input).some((key) => !allowed.has(key)))
12
20
  invalid();
21
+ if (typeof input.schema?.name !== 'string') {
22
+ throw new TypeError(`Domain Schema ${String(input.schema?.origin)} must declare its name: defineSchema(origin, { name, ... }).`);
23
+ }
13
24
  if (!isRuntime(input.runtime))
14
- throw new TypeError('Application Runtime is not admitted.');
25
+ throw new TypeError('Domain Runtime is not admitted.');
15
26
  if (input.frontend !== undefined &&
16
27
  (!isFrontend(input.frontend) || input.frontend.schema !== input.schema)) {
17
- throw new TypeError('Application Frontend is not admitted for its exact Schema.');
28
+ throw new TypeError('Domain Frontend is not admitted for its exact Schema.');
18
29
  }
19
30
  if (input.routes !== undefined && !isRoutes(input.routes)) {
20
- throw new TypeError('Application routes are not admitted.');
31
+ throw new TypeError('Domain routes are not admitted.');
21
32
  }
22
33
  if (input.requirements !== undefined && !isRequirements(input.requirements)) {
23
- throw new TypeError('Application requirements are not admitted.');
34
+ throw new TypeError('Domain requirements are not admitted.');
24
35
  }
25
- const application = Object.freeze({
36
+ // The same admission as a Node Class icon: one self-contained inline SVG.
37
+ const icon = input.icon === undefined ? undefined : admitClassIconSvg(input.icon);
38
+ const domain = Object.freeze({
26
39
  schema: input.schema,
27
40
  runtime: input.runtime,
28
41
  ...(input.frontend === undefined ? {} : { frontend: input.frontend }),
29
42
  ...(input.routes === undefined ? {} : { routes: input.routes }),
30
43
  ...(input.requirements === undefined ? {} : { requirements: input.requirements }),
44
+ ...(icon === undefined ? {} : { icon }),
31
45
  });
32
- admittedApplications.add(application);
33
- return application;
46
+ admittedDomainDefinitions.add(domain);
47
+ return domain;
34
48
  }
35
- export function isApplication(input) {
36
- return input !== null && typeof input === 'object' && admittedApplications.has(input);
49
+ export function isDomainDefinition(input) {
50
+ return input !== null && typeof input === 'object' && admittedDomainDefinitions.has(input);
37
51
  }
38
52
  function invalid() {
39
- throw new TypeError('Application definition may contain only schema, runtime, frontend, routes, and requirements.');
53
+ throw new TypeError('Domain definition may contain only schema, runtime, frontend, routes, requirements, and icon.');
40
54
  }
@@ -1 +1 @@
1
- export type { DependencyCallOptions, DependencyInvoker, HandlerDependencies } from './invoker.js';
1
+ export type { DependencyBinaryCallOptions, DependencyCallOptions, DependencyInvoker, HandlerDependencies, } from './invoker.js';
@@ -1,26 +1,37 @@
1
1
  import type { Binary, Input } from '../../platform/client/index.js';
2
- import type { SessionRequestOptions } from '../../platform/client/session/index.js';
2
+ import type { ExecutionRef, SessionRequestOptions, SessionRequestOptionsWithBody } from '../../platform/client/session/index.js';
3
3
  import type { NodeId } from '../../platform/graph/node/index.js';
4
- import type { CallableInputOf, CallableOutputOf, CallableResultOf, Domain, ResolvedMethod, KernelSchema, schema } from '../../platform/schema/index.js';
5
- import type { LocalCallable } from '../action/index.js';
6
- export type DependencyCallOptions = Pick<SessionRequestOptions, 'timeoutMs' | 'idempotencyKey'>;
4
+ import type { CallableInputOf, CallableInputModeOf, CallableOutputOf, CallableResultOf, Domain, ResolvedFunction, ResolvedMethod, KernelSchema, schema } from '../../platform/schema/index.js';
5
+ import type { AuthorityMode, AuthoritySelection, LocalCallable } from '../action/index.js';
6
+ export type DependencyCallOptions = Pick<SessionRequestOptions, 'timeoutMs' | 'idempotencyKey' | 'body'>;
7
+ export type DependencyBinaryCallOptions = Pick<SessionRequestOptionsWithBody, 'timeoutMs' | 'idempotencyKey' | 'body'>;
7
8
  type InstanceMethodOf<D extends Domain> = Extract<LocalCallable<D>, ResolvedMethod<unknown, unknown, false>>;
8
9
  type FunctionOrStaticMethodOf<D extends Domain> = Exclude<LocalCallable<D>, ResolvedMethod<unknown, unknown, false>>;
10
+ type WithInputMode<C, Mode extends 'value' | 'binary'> = C extends unknown ? CallableInputModeOf<C> extends Mode ? C : never : never;
11
+ type ValueFunctionOrStaticMethodOf<D extends Domain> = WithInputMode<FunctionOrStaticMethodOf<D>, 'value'>;
12
+ type BinaryFunctionOf<D extends Domain> = WithInputMode<Extract<LocalCallable<D>, ResolvedFunction>, 'binary'>;
9
13
  type DependencyInputOf<C> = C extends unknown ? unknown extends CallableInputOf<C> ? Input : [CallableInputOf<C>] extends [void] ? undefined : CallableInputOf<C> : never;
10
- type DependencyResultOf<C> = unknown extends CallableOutputOf<C> ? unknown : CallableResultOf<C, Binary>;
14
+ type HandlerResultOf<C> = unknown extends CallableOutputOf<C> ? unknown : CallableResultOf<C, Binary>;
15
+ /** A durable callable answers with its Execution, as the Kernel Client's typed reference does. */
16
+ type DependencyResultOf<C> = C extends {
17
+ readonly execution: {
18
+ readonly durable: true;
19
+ };
20
+ } ? ExecutionRef<HandlerResultOf<C>> : HandlerResultOf<C>;
11
21
  /** One declared dependency, bound to one explicitly selected invocation authority. */
12
22
  export interface DependencyInvoker<D extends Domain> {
13
23
  readonly invoke: {
14
- <const C extends FunctionOrStaticMethodOf<D>>(select: (domain: D) => C, input: NoInfer<DependencyInputOf<C>>, options?: DependencyCallOptions): Promise<DependencyResultOf<C>>;
24
+ <const C extends ValueFunctionOrStaticMethodOf<D>>(select: (domain: D) => C, input: NoInfer<DependencyInputOf<C>>, options?: DependencyCallOptions): Promise<DependencyResultOf<C>>;
15
25
  <const C extends InstanceMethodOf<D>>(select: (domain: D) => C, instance: NodeId, input: NoInfer<DependencyInputOf<C>>, options?: DependencyCallOptions): Promise<DependencyResultOf<C>>;
26
+ <const C extends BinaryFunctionOf<D>>(select: (domain: D) => C, metadata: NoInfer<DependencyInputOf<C>>, options: DependencyBinaryCallOptions): Promise<DependencyResultOf<C>>;
16
27
  };
17
28
  }
18
29
  /**
19
30
  * Direct Schema aliases with explicit authority selection and no default invoke.
20
- * self is the executing Domain; caller forwards the incoming Grant; union combines both.
21
- * The canonical Kernel is exposed through context.kernel.
31
+ * self is the executing Domain; caller forwards the incoming caller Identity, and is absent from a
32
+ * call that carried no credential. The canonical Kernel is exposed through context.kernel.
22
33
  */
23
- export type HandlerDependencies<D extends Domain> = Readonly<{
24
- [Alias in keyof D['dependencies'] as D['dependencies'][Alias] extends schema.DomainOf<KernelSchema> ? never : Alias]: Readonly<Record<'caller' | 'self' | 'union', DependencyInvoker<Extract<D['dependencies'][Alias], Domain>>>>;
34
+ export type HandlerDependencies<D extends Domain, Authority extends AuthorityMode = AuthorityMode> = Readonly<{
35
+ [Alias in keyof D['dependencies'] as D['dependencies'][Alias] extends schema.DomainOf<KernelSchema> ? never : Alias]: AuthoritySelection<DependencyInvoker<Extract<D['dependencies'][Alias], Domain>>, Authority>;
25
36
  }>;
26
37
  export {};
@@ -0,0 +1,30 @@
1
+ import type { ClassIcon, schema } from '../platform/schema/index.js';
2
+ import type { Requirements } from './requirements/index.js';
3
+ import type { Routes } from './routes/index.js';
4
+ import type { Runtime, SchemaOfRuntime as RuntimeSchemaOf } from './runtime/index.js';
5
+ import type { Frontend } from './view/index.js';
6
+ declare const DOMAIN_DEFINITION_IDENTITY: unique symbol;
7
+ declare const DOMAIN_DEFINITION_SCHEMA: unique symbol;
8
+ /** Schema-independent type witness shared by every admitted Domain definition. */
9
+ export interface DomainDefinitionIdentity {
10
+ readonly [DOMAIN_DEFINITION_IDENTITY]: true;
11
+ }
12
+ /** Inert source/build composition of one Domain: its exact Schema and authored Runtime. */
13
+ export interface DomainDefinition<Schema extends schema.DomainSchema = schema.DomainSchema, RuntimeValue extends Runtime<Schema> = Runtime<Schema>, FrontendValue extends Frontend<Schema> | undefined = undefined, RoutesValue extends Routes | undefined = undefined, RequirementsValue extends Requirements | undefined = undefined> extends DomainDefinitionIdentity {
14
+ readonly schema: Schema;
15
+ readonly runtime: RuntimeValue;
16
+ readonly frontend?: FrontendValue;
17
+ readonly routes?: RoutesValue;
18
+ readonly requirements?: RequirementsValue;
19
+ /** The application's icon. */
20
+ readonly icon?: ClassIcon;
21
+ readonly [DOMAIN_DEFINITION_SCHEMA]: (schema: Schema) => Schema;
22
+ }
23
+ export type SchemaOfDomainDefinition<Value> = Value extends {
24
+ readonly schema: infer Schema;
25
+ } ? Extract<Schema, schema.DomainSchema> : never;
26
+ export type RuntimeOfDomainDefinition<Value> = Value extends {
27
+ readonly runtime: infer RuntimeValue;
28
+ } ? Extract<RuntimeValue, Runtime> : never;
29
+ export type SchemaOfRuntime<Value> = RuntimeSchemaOf<Value>;
30
+ export {};
@@ -10,6 +10,8 @@ export interface DeclaredErrorOptions<out Errors extends DeclaredErrors = Declar
10
10
  export type DeclaredErrorFactory<Errors extends DeclaredErrors> = <Code extends Extract<keyof Errors, string>>(code: Code, details: z.input<Errors[Code]['details']>) => Error;
11
11
  interface DeclaredErrorRecord {
12
12
  readonly definition: object;
13
+ /** The declaration as written: the object a Function re-declares a Query or Mutation error with. */
14
+ readonly declaration: object;
13
15
  readonly code: string;
14
16
  readonly family: DeclaredErrorDefinition['family'];
15
17
  readonly message: string;
@@ -17,7 +19,20 @@ interface DeclaredErrorRecord {
17
19
  }
18
20
  /** Retain one implementation-local expected-error contract without publishing it in the Schema. */
19
21
  export declare function rememberDeclaredErrors(definition: object, input: unknown): void;
22
+ /**
23
+ * Retain a Query or Mutation's declared errors, as an implementation's are. A Function that declares one of
24
+ * its codes with the same definition object exposes that error to its own caller.
25
+ */
26
+ export declare function rememberDefinedErrors(defined: object, id: string, input: unknown): void;
20
27
  /** Create a receiver-free factory closed over one admitted Action or Workflow definition. */
21
28
  export declare function declaredErrorFactory<Errors extends DeclaredErrors>(definition: object): DeclaredErrorFactory<Errors>;
22
- /** Return admitted evidence only when the error belongs to the active implementation. */
29
+ /**
30
+ * Return admitted evidence only when the error belongs to the active implementation: raised by it,
31
+ * or by a Query or Mutation whose code it declares with the same definition object.
32
+ */
23
33
  export declare function declaredErrorOf(input: unknown, definition: object): DeclaredErrorRecord | undefined;
34
+ /** The code and the id of a Query or Mutation's declared error, whichever Function it reaches. */
35
+ export declare function definedErrorOf(input: unknown): {
36
+ readonly code: string;
37
+ readonly id: string;
38
+ } | undefined;
@@ -5,6 +5,8 @@ const MAXIMUM_DETAILS_BYTES = 16 * 1024;
5
5
  const CODE_PATTERN = /^[A-Z][A-Z0-9_]{0,127}$/u;
6
6
  const declarations = new WeakMap();
7
7
  const errors = new WeakMap();
8
+ /** The id of each Query or Mutation: their errors cross into a Function that re-declares them. */
9
+ const definedIds = new WeakMap();
8
10
  class BusinessError extends Error {
9
11
  name = 'BusinessError';
10
12
  constructor(code) {
@@ -25,17 +27,29 @@ export function rememberDeclaredErrors(definition, input) {
25
27
  for (const [code, candidate] of entries) {
26
28
  if (!CODE_PATTERN.test(code))
27
29
  throw new TypeError(`Declared error code ${JSON.stringify(code)} is invalid.`);
28
- accepted.set(code, acceptErrorDefinition(candidate, `Declared error ${JSON.stringify(code)}`));
30
+ accepted.set(code, {
31
+ accepted: acceptErrorDefinition(candidate, `Declared error ${JSON.stringify(code)}`),
32
+ declaration: candidate,
33
+ });
29
34
  }
30
35
  declarations.set(definition, accepted);
31
36
  }
37
+ /**
38
+ * Retain a Query or Mutation's declared errors, as an implementation's are. A Function that declares one of
39
+ * its codes with the same definition object exposes that error to its own caller.
40
+ */
41
+ export function rememberDefinedErrors(defined, id, input) {
42
+ rememberDeclaredErrors(defined, { errors: input });
43
+ definedIds.set(defined, id);
44
+ }
32
45
  /** Create a receiver-free factory closed over one admitted Action or Workflow definition. */
33
46
  export function declaredErrorFactory(definition) {
34
47
  return ((code, input) => {
35
- const declaration = declarations.get(definition)?.get(code);
36
- if (declaration === undefined) {
48
+ const declared = declarations.get(definition)?.get(code);
49
+ if (declared === undefined) {
37
50
  throw new TypeError(`Business error ${JSON.stringify(code)} is not declared by this implementation.`);
38
51
  }
52
+ const { accepted: declaration } = declared;
39
53
  const parsed = declaration.details.safeParse(input);
40
54
  if (!parsed.success) {
41
55
  throw new TypeError(`Business error ${code} details are invalid.`, { cause: parsed.error });
@@ -56,6 +70,7 @@ export function declaredErrorFactory(definition) {
56
70
  const error = new BusinessError(code);
57
71
  errors.set(error, Object.freeze({
58
72
  definition,
73
+ declaration: declared.declaration,
59
74
  code,
60
75
  family: declaration.family,
61
76
  message: declaration.message,
@@ -64,12 +79,31 @@ export function declaredErrorFactory(definition) {
64
79
  return error;
65
80
  });
66
81
  }
67
- /** Return admitted evidence only when the error belongs to the active implementation. */
82
+ /**
83
+ * Return admitted evidence only when the error belongs to the active implementation: raised by it,
84
+ * or by a Query or Mutation whose code it declares with the same definition object.
85
+ */
68
86
  export function declaredErrorOf(input, definition) {
69
87
  if (!(input instanceof Error))
70
88
  return undefined;
71
89
  const record = errors.get(input);
72
- return record?.definition === definition ? record : undefined;
90
+ if (record === undefined)
91
+ return undefined;
92
+ if (record.definition === definition)
93
+ return record;
94
+ if (!definedIds.has(record.definition))
95
+ return undefined;
96
+ return declarations.get(definition)?.get(record.code)?.declaration === record.declaration
97
+ ? record
98
+ : undefined;
99
+ }
100
+ /** The code and the id of a Query or Mutation's declared error, whichever Function it reaches. */
101
+ export function definedErrorOf(input) {
102
+ const record = input instanceof Error ? errors.get(input) : undefined;
103
+ if (record === undefined)
104
+ return undefined;
105
+ const id = definedIds.get(record.definition);
106
+ return id === undefined ? undefined : { code: record.code, id };
73
107
  }
74
108
  function isRecord(input) {
75
109
  return input !== null && typeof input === 'object' && !Array.isArray(input);
@@ -1,2 +1,2 @@
1
1
  export type { DeclaredErrorDefinition, DeclaredErrorFactory, DeclaredErrorFamily, DeclaredErrorOptions, DeclaredErrors, NoDeclaredErrors, } from './error.js';
2
- export { declaredErrorFactory, declaredErrorOf, rememberDeclaredErrors } from './error.js';
2
+ export { declaredErrorFactory, declaredErrorOf, definedErrorOf, rememberDeclaredErrors, rememberDefinedErrors, } from './error.js';
@@ -1 +1 @@
1
- export { declaredErrorFactory, declaredErrorOf, rememberDeclaredErrors } from './error.js';
1
+ export { declaredErrorFactory, declaredErrorOf, definedErrorOf, rememberDeclaredErrors, rememberDefinedErrors, } from './error.js';
@@ -1,9 +1,9 @@
1
- export { defineApplication, isApplication } from './define.js';
2
- export type { ApplicationInput } from './define.js';
1
+ export { defineDomain, isDomainDefinition } from './define.js';
2
+ export type { DomainDefinitionInput } from './define.js';
3
3
  export { requirements } from './requirements/index.js';
4
4
  export type { AuthorityRequirements, AuthorityRequirementsInput, ClassOperation, ClassRequirement, ClassRequirementInput, CoreRequirement, CoreRequirementInput, FunctionRequirementTarget, Requirements, RequirementsInput, } from './requirements/index.js';
5
5
  export { route, routes } from './routes/index.js';
6
6
  export type { Route, RouteInput, RouteTarget, Routes } from './routes/index.js';
7
7
  export { defineFrontend, external, vite } from './view/index.js';
8
- export type { Frontend, FrontendInput, FrontendSource, IframeRequirements, ViewHostRequirements, } from './view/index.js';
9
- export type { Application, ApplicationIdentity, RuntimeOfApplication, SchemaOfApplication, SchemaOfRuntime, } from './application.js';
8
+ export type { Frontend, FrontendInput, FrontendSource, ViewHostRequirements } from './view/index.js';
9
+ export type { DomainDefinition, DomainDefinitionIdentity, RuntimeOfDomainDefinition, SchemaOfDomainDefinition, SchemaOfRuntime, } from './domain.js';
@@ -1,4 +1,4 @@
1
- export { defineApplication, isApplication } from './define.js';
1
+ export { defineDomain, isDomainDefinition } from './define.js';
2
2
  export { requirements } from './requirements/index.js';
3
3
  export { route, routes } from './routes/index.js';
4
4
  export { defineFrontend, external, vite } from './view/index.js';
@@ -1,5 +1,5 @@
1
1
  import type { IntegrationDefinition, Integrations } from './integration.js';
2
- import type { IntegrationOperation, IntegrationOperations, IntegrationReplay } from './operation.js';
2
+ import type { IntegrationOperation, IntegrationOperations, IntegrationReplay, ReplayableIntegrationDecision } from './operation.js';
3
3
  import type { Provider, ProviderImplementation } from './provider.js';
4
4
  type RuntimeDefinition = IntegrationDefinition<string, IntegrationOperations>;
5
5
  type ProviderOperations = Readonly<Record<string, (...input: readonly unknown[]) => unknown>>;
@@ -12,6 +12,13 @@ export interface DefineIntegration {
12
12
  readonly id: Id;
13
13
  readonly operations: Operations;
14
14
  }): IntegrationDefinition<Id, Operations>;
15
+ /**
16
+ * One operation and what another attempt of it may do. A decision that is never `unsafe` keeps
17
+ * the operation available to code that may run more than once, such as a durable Step.
18
+ */
19
+ operation<Input = void, Output = void>(input: {
20
+ readonly replay: ReplayableIntegrationDecision | ((input: Input) => ReplayableIntegrationDecision);
21
+ }): IntegrationOperation<Input, Output, ReplayableIntegrationDecision['kind']>;
15
22
  operation<Input = void, Output = void>(input: {
16
23
  readonly replay: IntegrationReplay<Input>;
17
24
  }): IntegrationOperation<Input, Output>;
@@ -2,7 +2,7 @@ export { createIntegrationClients, bindProviders } from './client.js';
2
2
  export type { IntegrationAttempt, IntegrationCallCoordinates, IntegrationClientFactory, IntegrationInvocationOwner, } from './client.js';
3
3
  export { admitIntegrations, defineIntegration, defineProvider, requireIntegration, requireProvider, } from './define.js';
4
4
  export type { DefineIntegration, ProviderBinding } from './define.js';
5
- export type { IntegrationClient, IntegrationClients, IntegrationDefinition, Integrations, } from './integration.js';
6
- export type { IntegrationExecution, IntegrationInput, IntegrationOperation, IntegrationOperations, IntegrationOutput, IntegrationReplay, IntegrationReplayDecision, } from './operation.js';
5
+ export type { IntegrationClient, IntegrationClients, IntegrationDefinition, Integrations, ReplayableIntegrationClient, ReplayableIntegrationClients, } from './integration.js';
6
+ export type { IntegrationExecution, IntegrationInput, IntegrationOperation, IntegrationOperations, IntegrationOutput, IntegrationReplay, IntegrationReplayDecision, IntegrationReplayKind, IntegrationReplayOf, ReplayableIntegrationDecision, } from './operation.js';
7
7
  export type { Provider, ProviderImplementation, Providers } from './provider.js';
8
8
  export type { IntegrationAuthentication, IntegrationMintInput } from './authentication.js';
@@ -1,4 +1,4 @@
1
- import type { IntegrationOperation, IntegrationOperations } from './operation.js';
1
+ import type { IntegrationOperation, IntegrationOperations, IntegrationReplayOf } from './operation.js';
2
2
  declare const INTEGRATION_DEFINITION: unique symbol;
3
3
  export interface IntegrationDefinition<Id extends string = string, Operations extends IntegrationOperations = IntegrationOperations> {
4
4
  readonly kind: 'integration';
@@ -16,4 +16,16 @@ export type IntegrationClient<Definition extends IntegrationDefinition> = Readon
16
16
  export type IntegrationClients<Definitions extends Integrations> = Readonly<{
17
17
  [Name in keyof Definitions]: IntegrationClient<Definitions[Name]>;
18
18
  }>;
19
+ type ReplayableOperationName<Definition extends IntegrationDefinition> = {
20
+ [Name in keyof Definition['operations']]: 'unsafe' extends IntegrationReplayOf<Definition['operations'][Name]> ? never : Name;
21
+ }[keyof Definition['operations']];
22
+ /** The operations of one Integration that may be attempted again: each is `safe` or keyed. */
23
+ export type ReplayableIntegrationClient<Definition extends IntegrationDefinition> = Pick<IntegrationClient<Definition>, ReplayableOperationName<Definition>>;
24
+ /**
25
+ * Integration clients of code that may run more than once, such as a durable Step. An operation
26
+ * whose replay decision may be `unsafe` is absent: another attempt could repeat its effect.
27
+ */
28
+ export type ReplayableIntegrationClients<Definitions extends Integrations> = Readonly<{
29
+ [Name in keyof Definitions]: ReplayableIntegrationClient<Definitions[Name]>;
30
+ }>;
19
31
  export {};
@@ -1,6 +1,7 @@
1
1
  import type { BoundClientSession } from '../../platform/client/session/index.js';
2
2
  import type { IntegrationAuthentication } from './authentication.js';
3
3
  declare const INTEGRATION_OPERATION: unique symbol;
4
+ declare const INTEGRATION_REPLAY: unique symbol;
4
5
  export type IntegrationReplayDecision = {
5
6
  readonly kind: 'safe';
6
7
  } | {
@@ -13,20 +14,28 @@ export type IntegrationReplayDecision = {
13
14
  } | {
14
15
  readonly kind: 'unsafe';
15
16
  };
17
+ /** What another attempt of an operation may do: anything, once per key, or nothing. */
18
+ export type IntegrationReplayKind = IntegrationReplayDecision['kind'];
19
+ /** A decision that allows another attempt of the operation. */
20
+ export type ReplayableIntegrationDecision = Exclude<IntegrationReplayDecision, {
21
+ readonly kind: 'unsafe';
22
+ }>;
16
23
  export type IntegrationReplay<Input> = IntegrationReplayDecision | ((input: Input) => IntegrationReplayDecision);
17
24
  export interface IntegrationExecution {
18
25
  readonly callId: string;
19
26
  readonly signal: AbortSignal;
20
27
  readonly deadline: number;
21
28
  readonly idempotencyKey?: string;
22
- /** Exact caller-bound invocation capability; absent for an anonymous invocation. */
29
+ /** Exact caller-bound invocation capability; absent when the call carried no credential. */
23
30
  readonly invoke?: BoundClientSession['invoke'];
24
- /** Domain-self transport authentication; absent for an anonymous invocation. */
31
+ /** Domain-self transport authentication; absent only outside a Kernel invocation. */
25
32
  readonly auth?: IntegrationAuthentication;
26
33
  }
27
- export interface IntegrationOperation<Input = unknown, Output = unknown> {
34
+ export interface IntegrationOperation<Input = unknown, Output = unknown, Replay extends IntegrationReplayKind = IntegrationReplayKind> {
28
35
  readonly replay: IntegrationReplay<Input>;
29
36
  readonly [INTEGRATION_OPERATION]: (input: Input) => Output;
37
+ /** Every kind its replay decision may take, as its definition proves them. */
38
+ readonly [INTEGRATION_REPLAY]: Replay;
30
39
  }
31
40
  export type IntegrationOperations = Readonly<Record<string, IntegrationOperation<never, unknown>>>;
32
41
  export type IntegrationInput<Operation> = Operation extends {
@@ -35,4 +44,8 @@ export type IntegrationInput<Operation> = Operation extends {
35
44
  export type IntegrationOutput<Operation> = Operation extends {
36
45
  readonly [INTEGRATION_OPERATION]: (input: never) => infer Output;
37
46
  } ? Output : never;
47
+ /** The replay kinds an operation's definition proves; every kind when it proves none. */
48
+ export type IntegrationReplayOf<Operation> = Operation extends {
49
+ readonly [INTEGRATION_REPLAY]: infer Replay;
50
+ } ? Replay : IntegrationReplayKind;
38
51
  export {};
@@ -1,55 +1,103 @@
1
1
  import type { EdgeSlug } from '@astrale-os/kernel-core/graph/edge';
2
2
  import type { MutationBuilder } from '@astrale-os/kernel-core/graph/mutate';
3
- import type { QueryEdgeAST, QueryNodeAST } from '@astrale-os/kernel-core/graph/query';
4
3
  import type { ResolvedClass } from '@astrale-os/kernel-dsl/v1';
4
+ import type { Cls } from '../../query/handles/domain.js';
5
+ import type { EdgeSet, NodeSet } from '../../query/handles/handles.js';
6
+ import type { ClosureMutationBuilder } from '../legacy/v6/builder.js';
5
7
  import type { CreatedNode, ExistingEndpoint, MutationEndpoint } from './endpoint.js';
6
- import type { QueryPrecondition } from './precondition.js';
8
+ import type { CountBounds, GuardIdentity, GuardRange, PreconditionOptions } from './guard.js';
7
9
  import type { RichPropertyConditions, RichPropertyDelta, RichPropertyInput } from './properties.js';
10
+ import { type PreconditionNames } from './names.js';
8
11
  import { type EventOfTopology, type StatePropertyName, type StatePropertyTopology, type StateOfTopology, type StateTransitionInput } from './transition.js';
9
- export interface RichMutationBuilder {
12
+ /**
13
+ * The builder a Mutation's `build` receives: of a defined Mutation over `Schema`
14
+ * (`RichMutationBuilder<Schema>`), or of the deprecated closure form (`RichMutationBuilder`).
15
+ */
16
+ export type RichMutationBuilder<Schema = never> = [Schema] extends [never] ? ClosureMutationBuilder : DefinedMutationBuilder<Schema>;
17
+ /** A write names one Class: the handle of a union, `d.A.union(d.B)`, names none. */
18
+ type OneClass<K, All = K> = K extends unknown ? [All] extends [K] ? unknown : '✗ a write names one Class, not a union' : never;
19
+ /** A Node Class handle, `d.<Class>`, on which no method was called. */
20
+ type NodeClassHandle<S, K extends string> = NodeSet<S, K, {}, 'value', false> & OneClass<K>;
21
+ /** An Edge Class handle, `d.<Edge>`, on which no method was called. */
22
+ type EdgeClassHandle<S, E extends string> = EdgeSet<S, E, 'value', false>;
23
+ type NodeClassOf<S, K extends string> = Extract<Cls<S, K>, ResolvedClass<'node'>>;
24
+ interface HandleEdgeSelector<S, E extends string> {
25
+ readonly source: ExistingEndpoint;
26
+ readonly target: ExistingEndpoint;
27
+ readonly class: EdgeClassHandle<S, E>;
28
+ }
29
+ /**
30
+ * The builder a defined Mutation's `build` receives (D31): each verb names its Class by its handle,
31
+ * `d.<Class>`, and each guard takes a range. Each precondition verb (`expect.*`) takes `{ name }`
32
+ * last: a refusal of the Mutation because that precondition fails carries the name as
33
+ * `failure.precondition`. A name is unique in its Mutation.
34
+ */
35
+ export interface DefinedMutationBuilder<S> {
10
36
  readonly expect: {
11
- node<Class extends ResolvedClass<'node'>>(input: {
37
+ /** The Node exists, of this Class, and its Properties meet `props`. */
38
+ node<K extends string>(input: {
12
39
  readonly node: ExistingEndpoint;
13
- readonly class: Class;
14
- readonly props?: RichPropertyConditions<Class>;
15
- }): RichMutationBuilder;
16
- edge<Class extends ResolvedClass<'edge'>>(input: EdgeSelector<Class> & {
40
+ readonly class: NodeClassHandle<S, K>;
41
+ readonly props?: RichPropertyConditions<Cls<S, K>>;
42
+ }, options?: PreconditionOptions): DefinedMutationBuilder<S>;
43
+ /** The Edge exists, its slug is `slug`, and its Properties meet `props`. */
44
+ edge<E extends string>(input: HandleEdgeSelector<S, E> & {
17
45
  readonly slug?: EdgeSlug | null;
18
- readonly props?: RichPropertyConditions<Class>;
19
- }): RichMutationBuilder;
20
- query<Query extends QueryNodeAST | QueryEdgeAST>(input: QueryPrecondition<Query>): RichMutationBuilder;
46
+ readonly props?: RichPropertyConditions<Cls<S, E>>;
47
+ }, options?: PreconditionOptions): DefinedMutationBuilder<S>;
48
+ /**
49
+ * A guard (Mutation v4): no root of the range matches. A range is a Class handle after
50
+ * `where`, `union` and `orderBy`, `d.<Class>.where(…)`, or a canonical v7 Query.
51
+ */
52
+ none<K extends string>(range: GuardRange<S, K>, options?: PreconditionOptions): DefinedMutationBuilder<S>;
53
+ /** A guard (Mutation v4): a root of the range matches. */
54
+ exists<K extends string>(range: GuardRange<S, K>, options?: PreconditionOptions): DefinedMutationBuilder<S>;
55
+ /**
56
+ * A guard (Mutation v4): the number of the range's roots is `bounds`, or lies within
57
+ * `{ atLeast?, atMost? }`, bounded at least once.
58
+ */
59
+ count<K extends string>(range: GuardRange<S, K>, bounds: CountBounds, options?: PreconditionOptions): DefinedMutationBuilder<S>;
60
+ /**
61
+ * A guard (Mutation v4): the range's roots, in its `orderBy`, are exactly these identities, in
62
+ * the order a read of them returned them: a `NodeId` per Node, an `EdgeKey` per Edge.
63
+ */
64
+ unchanged<K extends string>(range: GuardRange<S, K>, ids: readonly GuardIdentity[], options?: PreconditionOptions): DefinedMutationBuilder<S>;
21
65
  };
22
- createNode<Class extends ResolvedClass<'node'>>(input: {
66
+ createNode<K extends string>(input: {
23
67
  readonly as: string;
24
- readonly class: Class;
25
- readonly props?: RichPropertyInput<Class>;
26
- }): CreatedNode<Class>;
27
- updateNode<Class extends ResolvedClass<'node'>>(input: {
68
+ readonly class: NodeClassHandle<S, K>;
69
+ readonly props?: RichPropertyInput<Cls<S, K>>;
70
+ }): CreatedNode<NodeClassOf<S, K>>;
71
+ updateNode<K extends string>(input: {
28
72
  readonly node: ExistingEndpoint;
29
- readonly class: Class;
30
- readonly props: RichPropertyDelta<Class>;
73
+ readonly class: NodeClassHandle<S, K>;
74
+ readonly props: RichPropertyDelta<Cls<S, K>>;
31
75
  }): this;
32
- transition<Class extends ResolvedClass<'node'>, Property extends StatePropertyName<Class>, From extends StateOfTopology<StatePropertyTopology<Class, Property>>, Event extends EventOfTopology<StatePropertyTopology<Class, Property>, From>>(input: StateTransitionInput<Class, Property, From, Event>): this;
33
- deleteNode<Class extends ResolvedClass<'node'>>(input: {
76
+ transition<K extends string, Property extends StatePropertyName<NodeClassOf<S, K>>, From extends StateOfTopology<StatePropertyTopology<NodeClassOf<S, K>, Property>>, Event extends EventOfTopology<StatePropertyTopology<NodeClassOf<S, K>, Property>, From>>(input: StateTransitionInput<NodeClassOf<S, K>, Property, From, Event, NodeClassHandle<S, K>>): this;
77
+ deleteNode<K extends string>(input: {
34
78
  readonly node: ExistingEndpoint;
35
- readonly class: Class;
79
+ readonly class: NodeClassHandle<S, K>;
36
80
  }): this;
37
- createEdge<Class extends ResolvedClass<'edge'>>(input: {
38
- readonly class: Class;
81
+ createEdge<E extends string>(input: {
82
+ readonly class: EdgeClassHandle<S, E>;
39
83
  readonly source: MutationEndpoint;
40
84
  readonly target: MutationEndpoint;
41
85
  readonly slug?: EdgeSlug;
42
- readonly props?: RichPropertyInput<Class>;
86
+ readonly props?: RichPropertyInput<Cls<S, E>>;
43
87
  }): this;
44
- updateEdge<Class extends ResolvedClass<'edge'>>(input: EdgeSelector<Class> & {
88
+ updateEdge<E extends string>(input: HandleEdgeSelector<S, E> & {
45
89
  readonly slug?: EdgeSlug | null;
46
- readonly props?: RichPropertyDelta<Class>;
90
+ readonly props?: RichPropertyDelta<Cls<S, E>>;
47
91
  }): this;
48
- deleteEdge<Class extends ResolvedClass<'edge'>>(input: EdgeSelector<Class>): this;
49
- }
50
- export interface EdgeSelector<Class extends ResolvedClass<'edge'>> {
51
- readonly source: ExistingEndpoint;
52
- readonly target: ExistingEndpoint;
53
- readonly class: Class;
92
+ deleteEdge<E extends string>(input: HandleEdgeSelector<S, E>): this;
54
93
  }
55
- export declare function richMutationBuilder(core: MutationBuilder): RichMutationBuilder;
94
+ /** The form of the Mutation a builder writes: a defined Mutation's, or the deprecated closure form's. */
95
+ export type BuilderForm = 'defined' | 'closure';
96
+ /**
97
+ * The SDK's builder over the core one, for both forms: a verb's Class is a Class handle
98
+ * (`d.<Class>`) or, in the closure form only, the resolved Class, and only the closure form has a
99
+ * V6 Query precondition (`expect.query`). `names` keeps the names of its preconditions, so that
100
+ * the Mutation's execution can name the one a refusal points at.
101
+ */
102
+ export declare function richMutationBuilder(portable: MutationBuilder, names?: PreconditionNames, form?: BuilderForm): ClosureMutationBuilder;
103
+ export {};