@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,2 @@
1
+ export type { Bundle, BundleContext, BundleSource, Bundler } from './bundle.js';
2
+ export type { ArtifactFile, PreparedArtifactFile } from './file.js';
@@ -0,0 +1 @@
1
+ export {};
@@ -1,7 +1,8 @@
1
1
  import type { Deployment } from '../deployment.js';
2
2
  import type { Adapter, AdapterInput } from './adapter.js';
3
- /** Capture one receiver-bound provider adapter. */
3
+ /** Capture one receiver-bound adapter that deploys immutable DomainRelease v4 deployments. */
4
4
  export declare function defineAdapter<Parameters extends object>(input: AdapterInput<Parameters>): Adapter<Parameters>;
5
- /** Bind one provider adapter to the parameters of one Project Environment. */
6
- export declare function defineDeployment<const Parameters extends object>(adapter: Adapter<Parameters>, parameters: Parameters): Deployment<Parameters>;
5
+ /** Bind one admitted adapter to the parameters of one Project Environment. */
6
+ export declare function defineDeployment<const Parameters extends object>(adapter: Adapter<Parameters>, parameters: Parameters): Deployment<Parameters, Adapter<Parameters>>;
7
+ /** Whether defineAdapter admitted this immutable-deployment adapter. */
7
8
  export declare function isAdapter(input: unknown): input is Adapter;
@@ -1,29 +1,53 @@
1
1
  import { captureDeployment } from '../deployment.js';
2
2
  const admittedAdapters = new WeakSet();
3
- /** Capture one receiver-bound provider adapter. */
3
+ const admittedBundlers = new WeakMap();
4
+ /** Every field an immutable-deployment adapter may declare. */
5
+ const FIELDS = [
6
+ 'name',
7
+ 'version',
8
+ 'bundler',
9
+ 'admit',
10
+ 'configure',
11
+ 'placement',
12
+ 'deployRelease',
13
+ 'list',
14
+ 'retain',
15
+ 'commands',
16
+ 'secretsFile',
17
+ ];
18
+ const RELEASE_OPERATIONS = ['configure', 'placement', 'deployRelease'];
19
+ const OPERATIONS = ['admit', ...RELEASE_OPERATIONS, 'list', 'retain', 'secretsFile'];
20
+ const COMMAND_NAME = /^[a-z][a-z0-9-]{0,31}$/u;
21
+ /** Capture one receiver-bound adapter that deploys immutable DomainRelease v4 deployments. */
4
22
  export function defineAdapter(input) {
5
23
  const value = record(input, 'Adapter definition');
6
- exact(value, ['name', 'version', 'prepare', 'deploy'], ['admit', 'secretsFile']);
24
+ if (Reflect.ownKeys(value).some((key) => !FIELDS.includes(key))) {
25
+ invalidFields();
26
+ }
7
27
  const name = stableName(input.name);
8
28
  const version = stableName(input.version);
29
+ const missing = RELEASE_OPERATIONS.filter((key) => value[key] === undefined);
30
+ if (missing.length > 0) {
31
+ throw new TypeError(`Adapter ${name} must declare ${missing.join(', ')} to deploy immutable releases.`);
32
+ }
33
+ if (value.bundler === undefined)
34
+ missingBundler(name);
35
+ const bundler = admitBundler(input.bundler);
9
36
  const receiver = Object.freeze({ ...input });
10
- const admit = optional(receiver, 'admit');
11
- const prepare = capture(receiver, 'prepare');
12
- const deploy = capture(receiver, 'deploy');
13
- const secretsFile = optional(receiver, 'secretsFile');
37
+ const operations = Object.fromEntries(OPERATIONS.filter((key) => RELEASE_OPERATIONS.includes(key) ||
38
+ value[key] !== undefined).map((key) => [key, capture(receiver, key)]));
14
39
  const adapter = Object.freeze({
15
40
  kind: 'adapter',
16
41
  name,
17
42
  version,
18
- ...(admit === undefined ? {} : { admit }),
19
- prepare,
20
- deploy,
21
- ...(secretsFile === undefined ? {} : { secretsFile }),
43
+ bundler,
44
+ ...operations,
45
+ ...(value.commands === undefined ? {} : { commands: admitCommands(name, value.commands) }),
22
46
  });
23
47
  admittedAdapters.add(adapter);
24
48
  return adapter;
25
49
  }
26
- /** Bind one provider adapter to the parameters of one Project Environment. */
50
+ /** Bind one admitted adapter to the parameters of one Project Environment. */
27
51
  export function defineDeployment(adapter, parameters) {
28
52
  if (!isAdapter(adapter))
29
53
  throw new TypeError('Deployment Adapter is not admitted.');
@@ -32,12 +56,39 @@ export function defineDeployment(adapter, parameters) {
32
56
  }
33
57
  return captureDeployment(adapter, Object.freeze({ ...parameters }));
34
58
  }
59
+ /** Whether defineAdapter admitted this immutable-deployment adapter. */
35
60
  export function isAdapter(input) {
36
61
  return input !== null && typeof input === 'object' && admittedAdapters.has(input);
37
62
  }
38
- function stableName(input) {
63
+ /**
64
+ * Capture one receiver-bound bundler; its id and version name the bytes it produces. Adapters that
65
+ * declare one bundler object receive one admitted Bundler, so `astrale-domain build` bundles once
66
+ * for all of them.
67
+ */
68
+ function admitBundler(input) {
69
+ const value = record(input, 'Bundler');
70
+ if (Reflect.ownKeys(value).some((key) => key !== 'id' && key !== 'version' && key !== 'bundle') ||
71
+ typeof input.bundle !== 'function') {
72
+ throw new TypeError('Bundler must declare exactly id, version and bundle.');
73
+ }
74
+ const admitted = admittedBundlers.get(value);
75
+ if (admitted !== undefined &&
76
+ admitted.declared === input.bundle &&
77
+ admitted.bundler.id === input.id &&
78
+ admitted.bundler.version === input.version) {
79
+ return admitted.bundler;
80
+ }
81
+ const bundler = Object.freeze({
82
+ id: stableName(input.id, 'Bundler id'),
83
+ version: stableName(input.version, 'Bundler version'),
84
+ bundle: input.bundle.bind(input),
85
+ });
86
+ admittedBundlers.set(value, { declared: input.bundle, bundler });
87
+ return bundler;
88
+ }
89
+ function stableName(input, label = 'Adapter name') {
39
90
  if (typeof input !== 'string' || input.length === 0 || input.trim() !== input) {
40
- throw new TypeError('Adapter name must be a non-empty stable string.');
91
+ throw new TypeError(`${label} must be a non-empty stable string.`);
41
92
  }
42
93
  return input;
43
94
  }
@@ -47,20 +98,53 @@ function record(input, label) {
47
98
  }
48
99
  return input;
49
100
  }
50
- function exact(input, required, optional) {
51
- const allowed = new Set([...required, ...optional]);
52
- if (required.some((key) => !Object.hasOwn(input, key)) ||
53
- Reflect.ownKeys(input).some((key) => !allowed.has(key))) {
54
- throw new TypeError('Adapter definition contains missing or unknown fields.');
101
+ /** Every adapter declares the bundler of the bytes it deploys. */
102
+ function missingBundler(name) {
103
+ throw new TypeError(`Adapter ${name} declares no bundler. ` +
104
+ 'Every adapter declares `bundler`: the bundler of the environment-free bytes ' +
105
+ '`astrale-domain build` identifies by their build digest and `astrale-domain deploy` hands ' +
106
+ 'to the adapter as its Bundle (a Cloudflare Worker adapter declares ' +
107
+ '`cloudflareWorkerBundler` from `@astrale-os/adapter-cloudflare/build`).');
108
+ }
109
+ /**
110
+ * Capture the provider commands of one adapter: each a lower-case name, a one-line `summary`,
111
+ * optional `options` (name to one line of help) and a receiver-bound `run`.
112
+ */
113
+ function admitCommands(adapter, input) {
114
+ const commands = record(input, `Adapter ${adapter} commands`);
115
+ const admitted = {};
116
+ for (const name of Reflect.ownKeys(commands)) {
117
+ if (typeof name !== 'string' || !COMMAND_NAME.test(name)) {
118
+ throw new TypeError(`Adapter ${adapter} declares an invalid command name.`);
119
+ }
120
+ const command = record(commands[name], `Adapter ${adapter} command ${name}`);
121
+ const options = command.options === undefined ? {} : record(command.options, 'Command options');
122
+ if (Reflect.ownKeys(command).some((key) => key !== 'summary' && key !== 'options' && key !== 'run') ||
123
+ typeof command.summary !== 'string' ||
124
+ command.summary.length === 0 ||
125
+ typeof command.run !== 'function' ||
126
+ Reflect.ownKeys(options).some((key) => typeof key !== 'string' ||
127
+ !COMMAND_NAME.test(key) ||
128
+ key === 'json' ||
129
+ typeof options[key] !== 'string')) {
130
+ throw new TypeError(`Adapter ${adapter} command ${name} must declare a summary, string options other than ` +
131
+ 'json and run.');
132
+ }
133
+ admitted[name] = Object.freeze({
134
+ summary: command.summary,
135
+ options: Object.freeze({ ...options }),
136
+ run: command.run.bind(command),
137
+ });
55
138
  }
139
+ return Object.freeze(admitted);
140
+ }
141
+ function invalidFields() {
142
+ throw new TypeError('Adapter definition contains missing or unknown fields.');
56
143
  }
57
144
  function capture(receiver, key) {
58
- const method = receiver[key];
145
+ const method = Reflect.get(receiver, key);
59
146
  if (typeof method !== 'function') {
60
- throw new TypeError(`Adapter ${String(key)} operation is invalid.`);
147
+ throw new TypeError(`Adapter ${key} operation is invalid.`);
61
148
  }
62
149
  return method.bind(receiver);
63
150
  }
64
- function optional(receiver, key) {
65
- return receiver[key] === undefined ? undefined : capture(receiver, key);
66
- }
@@ -1,4 +1,5 @@
1
- export type { Adapter, AdapterEnvironmentContext, AdapterInput, InstallationTarget, } from './adapter.js';
1
+ export type { Adapter, AdapterEnvironmentContext, AdapterInput } from './adapter.js';
2
2
  export { defineAdapter, defineDeployment, isAdapter } from './define.js';
3
- export type * from './prepare/index.js';
4
- export type * from './deploy/index.js';
3
+ export { RetainRefusal } from './release/refusal.js';
4
+ export type * from './bundle/index.js';
5
+ export type * from './release/index.js';
@@ -1 +1,2 @@
1
1
  export { defineAdapter, defineDeployment, isAdapter } from './define.js';
2
+ export { RetainRefusal } from './release/refusal.js';
@@ -0,0 +1,33 @@
1
+ /**
2
+ * One command an adapter declares for its provider (`astrale-domain <adapter> <command>
3
+ * <environment>`), such as adapter-cloudflare's `plan` and `init`, which provision the host on the
4
+ * operator's own account. The CLI only routes: it loads the Project, selects the Environment, checks
5
+ * that its adapter is the one named and declares the command, and admits the options the command
6
+ * declares; everything the command does is the adapter's.
7
+ */
8
+ export interface AdapterCommand<Parameters extends object = object> {
9
+ /** One line: what the command does, for help. */
10
+ readonly summary: string;
11
+ /** The options it takes, `--<name> <value>`, each with one line of help. */
12
+ readonly options?: Readonly<Record<string, string>>;
13
+ run(parameters: Parameters, context: AdapterCommandContext): Promise<AdapterCommandResult>;
14
+ }
15
+ /** What an adapter command receives. */
16
+ export interface AdapterCommandContext {
17
+ readonly environment: string;
18
+ /** Parent-owned lifecycle cancellation. */
19
+ readonly signal: AbortSignal;
20
+ /** The options given, each one the command declares. */
21
+ readonly options: Readonly<Record<string, string>>;
22
+ }
23
+ /** What an adapter command answers; a command that cannot run rejects instead. */
24
+ export interface AdapterCommandResult {
25
+ /** 0 done; 1 refused or blocked (the command ran, and says why in `warnings`). */
26
+ readonly exitCode: 0 | 1;
27
+ /** Lines for a person, printed on stdout without `--json`. */
28
+ readonly lines: readonly string[];
29
+ /** Lines for stderr, printed in either case. */
30
+ readonly warnings?: readonly string[];
31
+ /** The JSON-serializable result `--json` prints. */
32
+ readonly result: unknown;
33
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,94 @@
1
+ import type { DeploymentCommitV1, DeploymentConfiguration, LineAddressing } from '../../address/index.js';
2
+ import type { Release } from '../../release/index.js';
3
+ import type { Bundle } from '../bundle/index.js';
4
+ /**
5
+ * What `configure` receives: the Environment whose configuration it freezes, and the names of the
6
+ * secrets its deployment binds. Never a secret value: a rotated value is not another configuration,
7
+ * a name added or removed is.
8
+ */
9
+ export interface ConfigureContext {
10
+ readonly environment: string;
11
+ /**
12
+ * The names of the Environment's current secrets (the adapter's `secretsFile`), sorted and
13
+ * unique: exactly the secrets `deployRelease` receives, which the configuration declares.
14
+ */
15
+ readonly secrets: readonly string[];
16
+ }
17
+ /**
18
+ * Where the host places the deployments of one Environment. `routingDomain` is the DNS name every
19
+ * deployment URL ends with, `https://<label>.<routingDomain>`; `addressing` is how its line reads:
20
+ * `readable` for platform lines, `opaque` (the fingerprint alone) for tenant lines.
21
+ */
22
+ export interface Placement {
23
+ readonly addressing: LineAddressing;
24
+ readonly routingDomain: string;
25
+ }
26
+ /** What `placement` receives. It answers without any effect at the host. */
27
+ export interface PlacementContext {
28
+ readonly environment: string;
29
+ /** Parent-owned lifecycle cancellation. */
30
+ readonly signal: AbortSignal;
31
+ /** Optional command-scoped identity override (`--as`). */
32
+ readonly identity?: string;
33
+ }
34
+ /**
35
+ * Everything `deployRelease` deploys: one sealed release as one immutable deployment at
36
+ * `release.url`, which is `deploymentUrl(label, placement.routingDomain)` and the release's issuer.
37
+ * The SDK computes each value before the call, from the Build, `configure` and `placement`, so the
38
+ * adapter never derives an address or seals anything itself.
39
+ */
40
+ export interface ReleaseDeployContext {
41
+ readonly projectDir: string;
42
+ readonly environment: string;
43
+ /** Optional command-scoped identity override (`--as`). */
44
+ readonly identity?: string;
45
+ /** Optional command-scoped credential; trusted adapters must neither retain nor disclose it. */
46
+ readonly credential?: string;
47
+ /**
48
+ * The Environment's current secrets. A new deployment binds them; a reused deployment has its
49
+ * own declared secrets rewritten in place. A deploy never writes another deployment's secrets.
50
+ */
51
+ readonly secrets: Readonly<Record<string, string>>;
52
+ /** The environment-free bytes of the adapter's `bundler`, identified by `bundle.digest`. */
53
+ readonly bundle: Bundle;
54
+ /** What `configure` froze for this Environment. */
55
+ readonly configuration: DeploymentConfiguration;
56
+ /** Where `placement` said the host places the deployment. */
57
+ readonly placement: Placement;
58
+ /**
59
+ * `<line>-<content>`: the DNS label of the deployment, which is also its provider script. Its
60
+ * content covers `bundle.digest` and `configuration`, so one label serves one release.
61
+ */
62
+ readonly label: string;
63
+ /**
64
+ * The release the SDK sealed for this deployment before the call: its `document` is the
65
+ * `DomainRelease` v4 the deployment serves at `release.json`, its `url` the deployment URL.
66
+ */
67
+ readonly release: Release;
68
+ /**
69
+ * The commit this deploy runs from, which the record of a deployment it creates declares. The
70
+ * label does not cover it: a reused deployment keeps the record, and so the commit, of the deploy
71
+ * that created it, and an adapter never refuses a reuse for another commit.
72
+ */
73
+ readonly commit: DeploymentCommitV1 | null;
74
+ /** Parent-owned lifecycle cancellation shared by every provider effect. */
75
+ readonly signal: AbortSignal;
76
+ }
77
+ /**
78
+ * What `list` receives: the origin and the Environment whose deployments the host lists for the
79
+ * caller. It answers without any effect at the host.
80
+ */
81
+ export interface ListContext {
82
+ readonly origin: string;
83
+ readonly environment: string;
84
+ /** Parent-owned lifecycle cancellation. */
85
+ readonly signal: AbortSignal;
86
+ /** Optional command-scoped identity override (`--as`). */
87
+ readonly identity?: string;
88
+ }
89
+ /** What `retain` receives: the label of the published deployment to keep. */
90
+ export interface RetainContext {
91
+ readonly label: string;
92
+ readonly signal: AbortSignal;
93
+ readonly identity?: string;
94
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,4 @@
1
+ export type { ConfigureContext, ListContext, Placement, PlacementContext, ReleaseDeployContext, RetainContext, } from './context.js';
2
+ export type { AdapterCommand, AdapterCommandContext, AdapterCommandResult } from './command.js';
3
+ export type { DeploymentCallTarget, ListedDeployment } from './list.js';
4
+ export type { DeploymentSecretsState, FailedReleaseDeployResult, MutationKnowledge, ReadyReleaseDeployResult, ReleaseDeploymentPhase, ReleaseDeployResult, } from './result.js';
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,53 @@
1
+ import type { DeploymentSummaryV1 } from '../../address/index.js';
2
+ /**
3
+ * Where one listed deployment is called on its host, so that an operator can act on it:
4
+ *
5
+ * - `services`: a deployment Admin's Services hosts, called on the Admin instance with
6
+ * `astrale call "<node>.method.<method>" --admin` (`--admin=<admin>` when `admin` names the
7
+ * Admin bookmark). `path` is the deployment's node, `@<id>`, qualified by its class,
8
+ * `@<id>::services.astrale.ai:class.CloudflareDeployment`, whose only Method is `retire`.
9
+ * `service` is the node of the Service it is a version of,
10
+ * `@<serviceId>::services.astrale.ai:class.CloudflareService`, whose Methods act on the Service
11
+ * and the deployment it currently serves: `promote` (this deployment's label rolls the Service
12
+ * back or forward to it), `setSecret` and `secrets`, `setSchedule` and `schedules`, `logs`,
13
+ * `transfer` and `delete`.
14
+ * - `namespace`: a deployment of a Cloudflare dispatch namespace (adapter-cloudflare's namespace
15
+ * mode), which has no Services node: the namespace and the script, which the hosting kit
16
+ * (`@astrale-os/adapter-cloudflare/hosting`) retires, points a name at or schedules.
17
+ */
18
+ export type DeploymentCallTarget = {
19
+ readonly kind: 'services';
20
+ readonly path: string;
21
+ readonly service: string;
22
+ /** The Admin bookmark the deployment is reached through; the CLI's own Admin target when absent. */
23
+ readonly admin?: string;
24
+ } | {
25
+ readonly kind: 'namespace';
26
+ readonly namespace: string;
27
+ readonly script: string;
28
+ };
29
+ /**
30
+ * One deployment as an adapter's `list` returns it: what its host knows of it, its record as the
31
+ * host stores it, and where it is called. Admin's Services keeps every deployment until it is
32
+ * retired and counts no call: its deployments are `published` and `withdrawn` once retiring. A
33
+ * Cloudflare dispatch namespace keeps no retention: its rows carry none, and carry their creation
34
+ * instant and key only while their script exists. Deployments have no last-call or expiry clock.
35
+ *
36
+ * The adapter does not admit the record. The listing admits it with `acceptDeploymentRecord`, and a
37
+ * record it refuses (one a host on an older SDK still admits, say) never fails the listing: that
38
+ * deployment is listed from the facts its host owns.
39
+ */
40
+ export interface ListedDeployment extends Omit<DeploymentSummaryV1, 'record'> {
41
+ /**
42
+ * The record as the host stores it, unadmitted, whatever value that is (JSON `null` included).
43
+ * Absent when the host keeps no record of the deployment: a dispatch namespace keeps none for a
44
+ * label it only retired.
45
+ */
46
+ readonly record?: unknown;
47
+ /**
48
+ * Whether the stable URL of the deployment's Service serves it. Present only where the host has
49
+ * Services (Admin's Services); a dispatch namespace has none.
50
+ */
51
+ readonly current?: boolean;
52
+ readonly callTarget: DeploymentCallTarget;
53
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Why the host can no longer keep one published deployment (`Adapter.retain`): it is `absent`
3
+ * (the host holds no deployment of that label, or it was deleted) or `retired` (withdrawn, never
4
+ * served again). No rerun keeps it; a new version publishes a new deployment. Any other rejection
5
+ * of `retain` is transient: once it has passed, a rerun keeps the deployment.
6
+ */
7
+ export declare class RetainRefusal extends Error {
8
+ readonly reason: 'absent' | 'retired';
9
+ constructor(reason: RetainRefusal['reason'], message: string);
10
+ }
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Why the host can no longer keep one published deployment (`Adapter.retain`): it is `absent`
3
+ * (the host holds no deployment of that label, or it was deleted) or `retired` (withdrawn, never
4
+ * served again). No rerun keeps it; a new version publishes a new deployment. Any other rejection
5
+ * of `retain` is transient: once it has passed, a rerun keeps the deployment.
6
+ */
7
+ export class RetainRefusal extends Error {
8
+ reason;
9
+ constructor(reason, message) {
10
+ super(message);
11
+ this.name = 'RetainRefusal';
12
+ this.reason = reason;
13
+ }
14
+ }
@@ -0,0 +1,56 @@
1
+ import type { DeploymentRecordV1 } from '../../address/index.js';
2
+ /** What one operation knows it changed at a provider. */
3
+ export type MutationKnowledge<Evidence = unknown> = {
4
+ readonly kind: 'none';
5
+ } | {
6
+ readonly kind: 'partial';
7
+ readonly evidence?: Evidence;
8
+ } | {
9
+ readonly kind: 'applied';
10
+ readonly evidence: Evidence;
11
+ } | {
12
+ readonly kind: 'unknown';
13
+ };
14
+ /**
15
+ * How a deploy left the Environment's secrets on the deployment it made or reused: `bound` to a
16
+ * new deployment, or `updated` or left `unchanged` in place on the reused one.
17
+ */
18
+ export type DeploymentSecretsState = 'bound' | 'updated' | 'unchanged';
19
+ /**
20
+ * The immutable deployment of one release, ready at its URL.
21
+ *
22
+ * - `created`: a new deployment now serves the release, and the Environment's secrets are `bound`
23
+ * to it.
24
+ * - `reused`: the deployment of this exact release (same label, build and configuration) already
25
+ * existed; its own declared secrets were `updated` or left `unchanged` in place.
26
+ */
27
+ export interface ReadyReleaseDeployResult {
28
+ readonly status: 'ready';
29
+ readonly state: 'created' | 'reused';
30
+ /** The record the deployment declares, as the host stored it. */
31
+ readonly record: DeploymentRecordV1;
32
+ /** The deployment URL, which is also the issuer of the release it serves. */
33
+ readonly url: string;
34
+ readonly secrets: {
35
+ readonly state: DeploymentSecretsState;
36
+ };
37
+ }
38
+ /**
39
+ * Where a deploy of one release stopped:
40
+ * - `prerequisite`: before any effect at the host (a missing tool, credential or hosting answer);
41
+ * - `provider`: at the host, while it created or reused the deployment;
42
+ * - `readiness`: the deployment exists but did not serve its release before the deadline.
43
+ */
44
+ export type ReleaseDeploymentPhase = 'prerequisite' | 'provider' | 'readiness';
45
+ /**
46
+ * A deploy of one release that did not reach a ready deployment. Rerunning the same deploy
47
+ * converges: the deployment's label is its content, so a partial or applied deployment is reused.
48
+ */
49
+ export interface FailedReleaseDeployResult {
50
+ readonly status: 'failed';
51
+ readonly phase: ReleaseDeploymentPhase;
52
+ /** What the host may now hold of the deployment. */
53
+ readonly provider: MutationKnowledge;
54
+ readonly error: Error;
55
+ }
56
+ export type ReleaseDeployResult = ReadyReleaseDeployResult | FailedReleaseDeployResult;
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,96 @@
1
+ import type { Digest } from '@astrale-os/kernel-protocol/artifact';
2
+ import type { WorkerConfigurationV1 } from '../worker/configuration.js';
3
+ export declare const FROZEN_CONFIGURATION_FORMAT = "astrale.deployment.configuration";
4
+ export declare const FROZEN_CONFIGURATION_VERSION = 1;
5
+ /**
6
+ * What a deploy freezes into one deployment beside its build: the author's plain variables and the
7
+ * execution settings, defaults resolved, the durable Workflow options it declares, and the services
8
+ * and dispatch namespaces it binds. It names the secrets a deployment binds, never their values,
9
+ * and leaves out what the host derives (the deployment URL, the build digest, the signing key). A
10
+ * changed variable, setting or binding is another configuration, so another address; a rotated
11
+ * secret is not.
12
+ *
13
+ * Its admission is canonical form only. Whether a Worker can run under it stays with the host that
14
+ * binds it: `encodeWorkerSettings` (`@astrale-os/adapter-cloudflare/worker`) refuses settings past
15
+ * the Worker bounds when the host writes `ASTRALE_SETTINGS`, before anything is uploaded, and the
16
+ * host's binding namespace admits the binding names.
17
+ */
18
+ export interface FrozenConfigurationV1 {
19
+ readonly format: typeof FROZEN_CONFIGURATION_FORMAT;
20
+ readonly version: typeof FROZEN_CONFIGURATION_VERSION;
21
+ /** The author's plain variables, never secrets. */
22
+ readonly vars: Readonly<Record<string, string>>;
23
+ readonly settings: {
24
+ readonly maximumRequestBytes: number;
25
+ readonly invocationTimeoutMs: number;
26
+ readonly tokenExchange: false | {
27
+ readonly maximumLifetimeSeconds: number;
28
+ };
29
+ /** The durable Workflow options the Environment declares; absent when it declares none. */
30
+ readonly durableOptions?: FrozenDurableOptions;
31
+ };
32
+ readonly runtime: {
33
+ readonly compatibilityDate: string;
34
+ /** Sorted, unique. */
35
+ readonly compatibilityFlags: readonly string[];
36
+ };
37
+ readonly bindings: {
38
+ /** Sorted by name, unique; never the `ROUTER` binding, which `router` describes. */
39
+ readonly services: readonly {
40
+ readonly name: string;
41
+ readonly service: string;
42
+ }[];
43
+ /**
44
+ * Dispatch namespaces the deployment binds, sorted by binding name, unique; empty when it binds
45
+ * none. A binding name is a Worker binding name other than `ROUTER`, a namespace a Cloudflare
46
+ * dispatch namespace name. Which namespaces a deployment may bind is the host's to decide.
47
+ */
48
+ readonly dispatchNamespaces: readonly {
49
+ readonly name: string;
50
+ readonly namespace: string;
51
+ }[];
52
+ /** Names of the secrets the deployment binds, sorted, unique. */
53
+ readonly secrets: readonly string[];
54
+ };
55
+ readonly router: false | {
56
+ readonly service: string;
57
+ readonly hostSuffix: string;
58
+ readonly minLabels: number;
59
+ };
60
+ }
61
+ /**
62
+ * The durable Workflow options of one deployment, as declared: every field optional, each a
63
+ * positive integer. The SDK's durable serving bounds and defaults them when the Worker runs.
64
+ */
65
+ export interface FrozenDurableOptions {
66
+ readonly retentionMs?: number;
67
+ readonly retry?: {
68
+ readonly initialIntervalMs?: number;
69
+ readonly maxAttempts?: number;
70
+ readonly maxDurationMs?: number;
71
+ readonly maxIntervalMs?: number;
72
+ };
73
+ readonly stepTimeoutMs?: number;
74
+ }
75
+ /**
76
+ * What one deployment freezes beside its build, as its adapter's `configure` returns it: a
77
+ * `FrozenConfigurationV1`, which a Cloudflare dispatch namespace binds (namespace mode), or a
78
+ * `WorkerConfigurationV1` (`@astrale-os/sdk/deployment/worker`), which a Worker host binds
79
+ * (Admin's Services). Its digest and the build digest make the deployment's label.
80
+ */
81
+ export type DeploymentConfiguration = FrozenConfigurationV1 | WorkerConfigurationV1;
82
+ /** The digest of one frozen configuration of either format, as the deployment's label keeps it. */
83
+ export declare function deploymentConfigurationDigest(configuration: DeploymentConfiguration): Digest;
84
+ /** Whether a configuration is a `FrozenConfigurationV1`, by its format alone (not admitted). */
85
+ export declare function isFrozenConfiguration(configuration: DeploymentConfiguration): configuration is FrozenConfigurationV1;
86
+ /** A configuration before its canonical order: lists in any order, no format header. */
87
+ export type FrozenConfigurationInput = Omit<FrozenConfigurationV1, 'format' | 'version'>;
88
+ /** Freeze one deployment configuration in the one canonical order its digest is taken in. */
89
+ export declare function frozenConfiguration(input: FrozenConfigurationInput): FrozenConfigurationV1;
90
+ /**
91
+ * `sha256` of the canonical JSON (RFC 8785) of one exact, canonical frozen configuration. A
92
+ * deployment record keeps it whole; the deployment address keeps 80 bits of it with the build.
93
+ * It refuses a configuration that is not canonical, and checks nothing past that: a configuration
94
+ * it digests may still be one no Worker runs under (see `FrozenConfigurationV1`).
95
+ */
96
+ export declare function configurationDigest(configuration: FrozenConfigurationV1): Digest;