@marinoscar/platform-cli 0.0.0-stage → 0.1.0-next.11

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 (752) hide show
  1. package/CHANGELOG.md +157 -0
  2. package/LICENSE +21 -0
  3. package/README.md +182 -2
  4. package/dist/android/build.d.ts +30 -0
  5. package/dist/android/build.d.ts.map +1 -0
  6. package/dist/android/build.js +126 -0
  7. package/dist/android/build.js.map +1 -0
  8. package/dist/android/command.d.ts +21 -0
  9. package/dist/android/command.d.ts.map +1 -0
  10. package/dist/android/command.js +355 -0
  11. package/dist/android/command.js.map +1 -0
  12. package/dist/android/deploy-step.d.ts +85 -0
  13. package/dist/android/deploy-step.d.ts.map +1 -0
  14. package/dist/android/deploy-step.js +268 -0
  15. package/dist/android/deploy-step.js.map +1 -0
  16. package/dist/android/doctor.d.ts +47 -0
  17. package/dist/android/doctor.d.ts.map +1 -0
  18. package/dist/android/doctor.js +219 -0
  19. package/dist/android/doctor.js.map +1 -0
  20. package/dist/android/exec.d.ts +42 -0
  21. package/dist/android/exec.d.ts.map +1 -0
  22. package/dist/android/exec.js +103 -0
  23. package/dist/android/exec.js.map +1 -0
  24. package/dist/android/fix-plan.d.ts +44 -0
  25. package/dist/android/fix-plan.d.ts.map +1 -0
  26. package/dist/android/fix-plan.js +86 -0
  27. package/dist/android/fix-plan.js.map +1 -0
  28. package/dist/android/git-freshness.d.ts +34 -0
  29. package/dist/android/git-freshness.d.ts.map +1 -0
  30. package/dist/android/git-freshness.js +120 -0
  31. package/dist/android/git-freshness.js.map +1 -0
  32. package/dist/android/gradle.d.ts +32 -0
  33. package/dist/android/gradle.d.ts.map +1 -0
  34. package/dist/android/gradle.js +55 -0
  35. package/dist/android/gradle.js.map +1 -0
  36. package/dist/android/identity.d.ts +27 -0
  37. package/dist/android/identity.d.ts.map +1 -0
  38. package/dist/android/identity.js +60 -0
  39. package/dist/android/identity.js.map +1 -0
  40. package/dist/android/index.d.ts +7 -0
  41. package/dist/android/index.d.ts.map +1 -0
  42. package/dist/android/index.js +8 -0
  43. package/dist/android/index.js.map +1 -0
  44. package/dist/android/installer.d.ts +28 -0
  45. package/dist/android/installer.d.ts.map +1 -0
  46. package/dist/android/installer.js +96 -0
  47. package/dist/android/installer.js.map +1 -0
  48. package/dist/android/java.d.ts +26 -0
  49. package/dist/android/java.d.ts.map +1 -0
  50. package/dist/android/java.js +65 -0
  51. package/dist/android/java.js.map +1 -0
  52. package/dist/android/keystore.d.ts +54 -0
  53. package/dist/android/keystore.d.ts.map +1 -0
  54. package/dist/android/keystore.js +159 -0
  55. package/dist/android/keystore.js.map +1 -0
  56. package/dist/android/metadata.d.ts +39 -0
  57. package/dist/android/metadata.d.ts.map +1 -0
  58. package/dist/android/metadata.js +61 -0
  59. package/dist/android/metadata.js.map +1 -0
  60. package/dist/android/operations.d.ts +42 -0
  61. package/dist/android/operations.d.ts.map +1 -0
  62. package/dist/android/operations.js +59 -0
  63. package/dist/android/operations.js.map +1 -0
  64. package/dist/android/paths.d.ts +29 -0
  65. package/dist/android/paths.d.ts.map +1 -0
  66. package/dist/android/paths.js +97 -0
  67. package/dist/android/paths.js.map +1 -0
  68. package/dist/android/publish.d.ts +37 -0
  69. package/dist/android/publish.d.ts.map +1 -0
  70. package/dist/android/publish.js +119 -0
  71. package/dist/android/publish.js.map +1 -0
  72. package/dist/android/registrations.d.ts +92 -0
  73. package/dist/android/registrations.d.ts.map +1 -0
  74. package/dist/android/registrations.js +112 -0
  75. package/dist/android/registrations.js.map +1 -0
  76. package/dist/android/release-status.d.ts +73 -0
  77. package/dist/android/release-status.d.ts.map +1 -0
  78. package/dist/android/release-status.js +161 -0
  79. package/dist/android/release-status.js.map +1 -0
  80. package/dist/android/release.d.ts +33 -0
  81. package/dist/android/release.d.ts.map +1 -0
  82. package/dist/android/release.js +59 -0
  83. package/dist/android/release.js.map +1 -0
  84. package/dist/android/screen-layout.d.ts +26 -0
  85. package/dist/android/screen-layout.d.ts.map +1 -0
  86. package/dist/android/screen-layout.js +24 -0
  87. package/dist/android/screen-layout.js.map +1 -0
  88. package/dist/android/screen-model.d.ts +56 -0
  89. package/dist/android/screen-model.d.ts.map +1 -0
  90. package/dist/android/screen-model.js +207 -0
  91. package/dist/android/screen-model.js.map +1 -0
  92. package/dist/android/screen.d.ts +8 -0
  93. package/dist/android/screen.d.ts.map +1 -0
  94. package/dist/android/screen.js +395 -0
  95. package/dist/android/screen.js.map +1 -0
  96. package/dist/android/sdk.d.ts +48 -0
  97. package/dist/android/sdk.d.ts.map +1 -0
  98. package/dist/android/sdk.js +82 -0
  99. package/dist/android/sdk.js.map +1 -0
  100. package/dist/android/server-url.d.ts +19 -0
  101. package/dist/android/server-url.d.ts.map +1 -0
  102. package/dist/android/server-url.js +36 -0
  103. package/dist/android/server-url.js.map +1 -0
  104. package/dist/android/upload-progress.d.ts +3 -0
  105. package/dist/android/upload-progress.d.ts.map +1 -0
  106. package/dist/android/upload-progress.js +47 -0
  107. package/dist/android/upload-progress.js.map +1 -0
  108. package/dist/android/version.d.ts +47 -0
  109. package/dist/android/version.d.ts.map +1 -0
  110. package/dist/android/version.js +136 -0
  111. package/dist/android/version.js.map +1 -0
  112. package/dist/api-client/index.d.ts +3 -0
  113. package/dist/api-client/index.d.ts.map +1 -0
  114. package/dist/api-client/index.js +5 -0
  115. package/dist/api-client/index.js.map +1 -0
  116. package/dist/commands/index.d.ts +52 -0
  117. package/dist/commands/index.d.ts.map +1 -0
  118. package/dist/commands/index.js +63 -0
  119. package/dist/commands/index.js.map +1 -0
  120. package/dist/core/cli-registry.d.ts +41 -0
  121. package/dist/core/cli-registry.d.ts.map +1 -0
  122. package/dist/core/cli-registry.js +49 -0
  123. package/dist/core/cli-registry.js.map +1 -0
  124. package/dist/core/command-registry.d.ts +60 -0
  125. package/dist/core/command-registry.d.ts.map +1 -0
  126. package/dist/core/command-registry.js +114 -0
  127. package/dist/core/command-registry.js.map +1 -0
  128. package/dist/core/env-annotation-registry.d.ts +58 -0
  129. package/dist/core/env-annotation-registry.d.ts.map +1 -0
  130. package/dist/core/env-annotation-registry.js +80 -0
  131. package/dist/core/env-annotation-registry.js.map +1 -0
  132. package/dist/core/env-generator-registry.d.ts +59 -0
  133. package/dist/core/env-generator-registry.d.ts.map +1 -0
  134. package/dist/core/env-generator-registry.js +102 -0
  135. package/dist/core/env-generator-registry.js.map +1 -0
  136. package/dist/core/env-group-registry.d.ts +65 -0
  137. package/dist/core/env-group-registry.d.ts.map +1 -0
  138. package/dist/core/env-group-registry.js +77 -0
  139. package/dist/core/env-group-registry.js.map +1 -0
  140. package/dist/core/env-spec-registry.d.ts +133 -0
  141. package/dist/core/env-spec-registry.d.ts.map +1 -0
  142. package/dist/core/env-spec-registry.js +103 -0
  143. package/dist/core/env-spec-registry.js.map +1 -0
  144. package/dist/core/env-values.d.ts +76 -0
  145. package/dist/core/env-values.d.ts.map +1 -0
  146. package/dist/core/env-values.js +125 -0
  147. package/dist/core/env-values.js.map +1 -0
  148. package/dist/core/index.d.ts +14 -0
  149. package/dist/core/index.d.ts.map +1 -0
  150. package/dist/core/index.js +10 -0
  151. package/dist/core/index.js.map +1 -0
  152. package/dist/deploy/index.d.ts +3 -0
  153. package/dist/deploy/index.d.ts.map +1 -0
  154. package/dist/deploy/index.js +5 -0
  155. package/dist/deploy/index.js.map +1 -0
  156. package/dist/engine/api-client.d.ts +211 -0
  157. package/dist/engine/api-client.d.ts.map +1 -0
  158. package/dist/engine/api-client.js +350 -0
  159. package/dist/engine/api-client.js.map +1 -0
  160. package/dist/engine/browser.d.ts +18 -0
  161. package/dist/engine/browser.d.ts.map +1 -0
  162. package/dist/engine/browser.js +115 -0
  163. package/dist/engine/browser.js.map +1 -0
  164. package/dist/engine/builtin-registrations.d.ts +20 -0
  165. package/dist/engine/builtin-registrations.d.ts.map +1 -0
  166. package/dist/engine/builtin-registrations.js +86 -0
  167. package/dist/engine/builtin-registrations.js.map +1 -0
  168. package/dist/engine/commands/api.d.ts +88 -0
  169. package/dist/engine/commands/api.d.ts.map +1 -0
  170. package/dist/engine/commands/api.js +398 -0
  171. package/dist/engine/commands/api.js.map +1 -0
  172. package/dist/engine/commands/config.d.ts +5 -0
  173. package/dist/engine/commands/config.d.ts.map +1 -0
  174. package/dist/engine/commands/config.js +83 -0
  175. package/dist/engine/commands/config.js.map +1 -0
  176. package/dist/engine/commands/deploy.d.ts +243 -0
  177. package/dist/engine/commands/deploy.d.ts.map +1 -0
  178. package/dist/engine/commands/deploy.js +1166 -0
  179. package/dist/engine/commands/deploy.js.map +1 -0
  180. package/dist/engine/commands/init.d.ts +18 -0
  181. package/dist/engine/commands/init.d.ts.map +1 -0
  182. package/dist/engine/commands/init.js +50 -0
  183. package/dist/engine/commands/init.js.map +1 -0
  184. package/dist/engine/commands/login.d.ts +4 -0
  185. package/dist/engine/commands/login.d.ts.map +1 -0
  186. package/dist/engine/commands/login.js +205 -0
  187. package/dist/engine/commands/login.js.map +1 -0
  188. package/dist/engine/commands/node.d.ts +21 -0
  189. package/dist/engine/commands/node.d.ts.map +1 -0
  190. package/dist/engine/commands/node.js +436 -0
  191. package/dist/engine/commands/node.js.map +1 -0
  192. package/dist/engine/config.d.ts +246 -0
  193. package/dist/engine/config.d.ts.map +1 -0
  194. package/dist/engine/config.js +414 -0
  195. package/dist/engine/config.js.map +1 -0
  196. package/dist/engine/conformance.d.ts +187 -0
  197. package/dist/engine/conformance.d.ts.map +1 -0
  198. package/dist/engine/conformance.js +227 -0
  199. package/dist/engine/conformance.js.map +1 -0
  200. package/dist/engine/create-cli.d.ts +94 -0
  201. package/dist/engine/create-cli.d.ts.map +1 -0
  202. package/dist/engine/create-cli.js +60 -0
  203. package/dist/engine/create-cli.js.map +1 -0
  204. package/dist/engine/deploy/about.d.ts +12 -0
  205. package/dist/engine/deploy/about.d.ts.map +1 -0
  206. package/dist/engine/deploy/about.js +110 -0
  207. package/dist/engine/deploy/about.js.map +1 -0
  208. package/dist/engine/deploy/adopt.d.ts +21 -0
  209. package/dist/engine/deploy/adopt.d.ts.map +1 -0
  210. package/dist/engine/deploy/adopt.js +78 -0
  211. package/dist/engine/deploy/adopt.js.map +1 -0
  212. package/dist/engine/deploy/answers-file.d.ts +7 -0
  213. package/dist/engine/deploy/answers-file.d.ts.map +1 -0
  214. package/dist/engine/deploy/answers-file.js +49 -0
  215. package/dist/engine/deploy/answers-file.js.map +1 -0
  216. package/dist/engine/deploy/app-role.d.ts +278 -0
  217. package/dist/engine/deploy/app-role.d.ts.map +1 -0
  218. package/dist/engine/deploy/app-role.js +826 -0
  219. package/dist/engine/deploy/app-role.js.map +1 -0
  220. package/dist/engine/deploy/app-version.d.ts +47 -0
  221. package/dist/engine/deploy/app-version.d.ts.map +1 -0
  222. package/dist/engine/deploy/app-version.js +232 -0
  223. package/dist/engine/deploy/app-version.js.map +1 -0
  224. package/dist/engine/deploy/checks/database.d.ts +83 -0
  225. package/dist/engine/deploy/checks/database.d.ts.map +1 -0
  226. package/dist/engine/deploy/checks/database.js +455 -0
  227. package/dist/engine/deploy/checks/database.js.map +1 -0
  228. package/dist/engine/deploy/checks/dns.d.ts +3 -0
  229. package/dist/engine/deploy/checks/dns.d.ts.map +1 -0
  230. package/dist/engine/deploy/checks/dns.js +85 -0
  231. package/dist/engine/deploy/checks/dns.js.map +1 -0
  232. package/dist/engine/deploy/checks/host.d.ts +19 -0
  233. package/dist/engine/deploy/checks/host.d.ts.map +1 -0
  234. package/dist/engine/deploy/checks/host.js +543 -0
  235. package/dist/engine/deploy/checks/host.js.map +1 -0
  236. package/dist/engine/deploy/checks/index.d.ts +33 -0
  237. package/dist/engine/deploy/checks/index.d.ts.map +1 -0
  238. package/dist/engine/deploy/checks/index.js +67 -0
  239. package/dist/engine/deploy/checks/index.js.map +1 -0
  240. package/dist/engine/deploy/checks/registry.d.ts +110 -0
  241. package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
  242. package/dist/engine/deploy/checks/registry.js +104 -0
  243. package/dist/engine/deploy/checks/registry.js.map +1 -0
  244. package/dist/engine/deploy/checks/source.d.ts +45 -0
  245. package/dist/engine/deploy/checks/source.d.ts.map +1 -0
  246. package/dist/engine/deploy/checks/source.js +175 -0
  247. package/dist/engine/deploy/checks/source.js.map +1 -0
  248. package/dist/engine/deploy/checks/tls.d.ts +87 -0
  249. package/dist/engine/deploy/checks/tls.d.ts.map +1 -0
  250. package/dist/engine/deploy/checks/tls.js +552 -0
  251. package/dist/engine/deploy/checks/tls.js.map +1 -0
  252. package/dist/engine/deploy/checks/types.d.ts +186 -0
  253. package/dist/engine/deploy/checks/types.d.ts.map +1 -0
  254. package/dist/engine/deploy/checks/types.js +199 -0
  255. package/dist/engine/deploy/checks/types.js.map +1 -0
  256. package/dist/engine/deploy/compose-files.d.ts +29 -0
  257. package/dist/engine/deploy/compose-files.d.ts.map +1 -0
  258. package/dist/engine/deploy/compose-files.js +118 -0
  259. package/dist/engine/deploy/compose-files.js.map +1 -0
  260. package/dist/engine/deploy/compose-hints.d.ts +11 -0
  261. package/dist/engine/deploy/compose-hints.d.ts.map +1 -0
  262. package/dist/engine/deploy/compose-hints.js +70 -0
  263. package/dist/engine/deploy/compose-hints.js.map +1 -0
  264. package/dist/engine/deploy/consent.d.ts +29 -0
  265. package/dist/engine/deploy/consent.d.ts.map +1 -0
  266. package/dist/engine/deploy/consent.js +35 -0
  267. package/dist/engine/deploy/consent.js.map +1 -0
  268. package/dist/engine/deploy/database-drop.d.ts +22 -0
  269. package/dist/engine/deploy/database-drop.d.ts.map +1 -0
  270. package/dist/engine/deploy/database-drop.js +135 -0
  271. package/dist/engine/deploy/database-drop.js.map +1 -0
  272. package/dist/engine/deploy/database.d.ts +116 -0
  273. package/dist/engine/deploy/database.d.ts.map +1 -0
  274. package/dist/engine/deploy/database.js +252 -0
  275. package/dist/engine/deploy/database.js.map +1 -0
  276. package/dist/engine/deploy/deploy-info.d.ts +48 -0
  277. package/dist/engine/deploy/deploy-info.d.ts.map +1 -0
  278. package/dist/engine/deploy/deploy-info.js +163 -0
  279. package/dist/engine/deploy/deploy-info.js.map +1 -0
  280. package/dist/engine/deploy/deployment-evidence.d.ts +38 -0
  281. package/dist/engine/deploy/deployment-evidence.d.ts.map +1 -0
  282. package/dist/engine/deploy/deployment-evidence.js +92 -0
  283. package/dist/engine/deploy/deployment-evidence.js.map +1 -0
  284. package/dist/engine/deploy/edge-config.d.ts +103 -0
  285. package/dist/engine/deploy/edge-config.d.ts.map +1 -0
  286. package/dist/engine/deploy/edge-config.js +170 -0
  287. package/dist/engine/deploy/edge-config.js.map +1 -0
  288. package/dist/engine/deploy/env-absence.d.ts +61 -0
  289. package/dist/engine/deploy/env-absence.d.ts.map +1 -0
  290. package/dist/engine/deploy/env-absence.js +33 -0
  291. package/dist/engine/deploy/env-absence.js.map +1 -0
  292. package/dist/engine/deploy/env-file.d.ts +14 -0
  293. package/dist/engine/deploy/env-file.d.ts.map +1 -0
  294. package/dist/engine/deploy/env-file.js +58 -0
  295. package/dist/engine/deploy/env-file.js.map +1 -0
  296. package/dist/engine/deploy/env-fragments.d.ts +29 -0
  297. package/dist/engine/deploy/env-fragments.d.ts.map +1 -0
  298. package/dist/engine/deploy/env-fragments.js +73 -0
  299. package/dist/engine/deploy/env-fragments.js.map +1 -0
  300. package/dist/engine/deploy/env-metadata.d.ts +73 -0
  301. package/dist/engine/deploy/env-metadata.d.ts.map +1 -0
  302. package/dist/engine/deploy/env-metadata.js +227 -0
  303. package/dist/engine/deploy/env-metadata.js.map +1 -0
  304. package/dist/engine/deploy/env-spec.d.ts +75 -0
  305. package/dist/engine/deploy/env-spec.d.ts.map +1 -0
  306. package/dist/engine/deploy/env-spec.js +239 -0
  307. package/dist/engine/deploy/env-spec.js.map +1 -0
  308. package/dist/engine/deploy/env-wizard.d.ts +56 -0
  309. package/dist/engine/deploy/env-wizard.d.ts.map +1 -0
  310. package/dist/engine/deploy/env-wizard.js +235 -0
  311. package/dist/engine/deploy/env-wizard.js.map +1 -0
  312. package/dist/engine/deploy/executor.d.ts +81 -0
  313. package/dist/engine/deploy/executor.d.ts.map +1 -0
  314. package/dist/engine/deploy/executor.js +247 -0
  315. package/dist/engine/deploy/executor.js.map +1 -0
  316. package/dist/engine/deploy/health.d.ts +153 -0
  317. package/dist/engine/deploy/health.d.ts.map +1 -0
  318. package/dist/engine/deploy/health.js +335 -0
  319. package/dist/engine/deploy/health.js.map +1 -0
  320. package/dist/engine/deploy/hooks.d.ts +66 -0
  321. package/dist/engine/deploy/hooks.d.ts.map +1 -0
  322. package/dist/engine/deploy/hooks.js +19 -0
  323. package/dist/engine/deploy/hooks.js.map +1 -0
  324. package/dist/engine/deploy/host-facts.d.ts +23 -0
  325. package/dist/engine/deploy/host-facts.d.ts.map +1 -0
  326. package/dist/engine/deploy/host-facts.js +67 -0
  327. package/dist/engine/deploy/host-facts.js.map +1 -0
  328. package/dist/engine/deploy/install.d.ts +233 -0
  329. package/dist/engine/deploy/install.d.ts.map +1 -0
  330. package/dist/engine/deploy/install.js +1318 -0
  331. package/dist/engine/deploy/install.js.map +1 -0
  332. package/dist/engine/deploy/inventory.d.ts +30 -0
  333. package/dist/engine/deploy/inventory.d.ts.map +1 -0
  334. package/dist/engine/deploy/inventory.js +122 -0
  335. package/dist/engine/deploy/inventory.js.map +1 -0
  336. package/dist/engine/deploy/journal.d.ts +77 -0
  337. package/dist/engine/deploy/journal.d.ts.map +1 -0
  338. package/dist/engine/deploy/journal.js +221 -0
  339. package/dist/engine/deploy/journal.js.map +1 -0
  340. package/dist/engine/deploy/layout.d.ts +77 -0
  341. package/dist/engine/deploy/layout.d.ts.map +1 -0
  342. package/dist/engine/deploy/layout.js +191 -0
  343. package/dist/engine/deploy/layout.js.map +1 -0
  344. package/dist/engine/deploy/oauth-check.d.ts +58 -0
  345. package/dist/engine/deploy/oauth-check.d.ts.map +1 -0
  346. package/dist/engine/deploy/oauth-check.js +213 -0
  347. package/dist/engine/deploy/oauth-check.js.map +1 -0
  348. package/dist/engine/deploy/proxy-bootstrap.d.ts +149 -0
  349. package/dist/engine/deploy/proxy-bootstrap.d.ts.map +1 -0
  350. package/dist/engine/deploy/proxy-bootstrap.js +416 -0
  351. package/dist/engine/deploy/proxy-bootstrap.js.map +1 -0
  352. package/dist/engine/deploy/proxy-streams.d.ts +110 -0
  353. package/dist/engine/deploy/proxy-streams.d.ts.map +1 -0
  354. package/dist/engine/deploy/proxy-streams.js +208 -0
  355. package/dist/engine/deploy/proxy-streams.js.map +1 -0
  356. package/dist/engine/deploy/proxy.d.ts +375 -0
  357. package/dist/engine/deploy/proxy.d.ts.map +1 -0
  358. package/dist/engine/deploy/proxy.js +758 -0
  359. package/dist/engine/deploy/proxy.js.map +1 -0
  360. package/dist/engine/deploy/renewal.d.ts +54 -0
  361. package/dist/engine/deploy/renewal.d.ts.map +1 -0
  362. package/dist/engine/deploy/renewal.js +169 -0
  363. package/dist/engine/deploy/renewal.js.map +1 -0
  364. package/dist/engine/deploy/repo.d.ts +119 -0
  365. package/dist/engine/deploy/repo.d.ts.map +1 -0
  366. package/dist/engine/deploy/repo.js +277 -0
  367. package/dist/engine/deploy/repo.js.map +1 -0
  368. package/dist/engine/deploy/run-record.d.ts +28 -0
  369. package/dist/engine/deploy/run-record.d.ts.map +1 -0
  370. package/dist/engine/deploy/run-record.js +44 -0
  371. package/dist/engine/deploy/run-record.js.map +1 -0
  372. package/dist/engine/deploy/state.d.ts +289 -0
  373. package/dist/engine/deploy/state.d.ts.map +1 -0
  374. package/dist/engine/deploy/state.js +163 -0
  375. package/dist/engine/deploy/state.js.map +1 -0
  376. package/dist/engine/deploy/steps/app-step-context.d.ts +24 -0
  377. package/dist/engine/deploy/steps/app-step-context.d.ts.map +1 -0
  378. package/dist/engine/deploy/steps/app-step-context.js +45 -0
  379. package/dist/engine/deploy/steps/app-step-context.js.map +1 -0
  380. package/dist/engine/deploy/steps/pipeline.d.ts +46 -0
  381. package/dist/engine/deploy/steps/pipeline.d.ts.map +1 -0
  382. package/dist/engine/deploy/steps/pipeline.js +73 -0
  383. package/dist/engine/deploy/steps/pipeline.js.map +1 -0
  384. package/dist/engine/deploy/steps/plan.d.ts +28 -0
  385. package/dist/engine/deploy/steps/plan.d.ts.map +1 -0
  386. package/dist/engine/deploy/steps/plan.js +32 -0
  387. package/dist/engine/deploy/steps/plan.js.map +1 -0
  388. package/dist/engine/deploy/steps/registry.d.ts +182 -0
  389. package/dist/engine/deploy/steps/registry.d.ts.map +1 -0
  390. package/dist/engine/deploy/steps/registry.js +212 -0
  391. package/dist/engine/deploy/steps/registry.js.map +1 -0
  392. package/dist/engine/deploy/steps/step-values.d.ts +28 -0
  393. package/dist/engine/deploy/steps/step-values.d.ts.map +1 -0
  394. package/dist/engine/deploy/steps/step-values.js +33 -0
  395. package/dist/engine/deploy/steps/step-values.js.map +1 -0
  396. package/dist/engine/deploy/testing/fake-postgres.d.ts +88 -0
  397. package/dist/engine/deploy/testing/fake-postgres.d.ts.map +1 -0
  398. package/dist/engine/deploy/testing/fake-postgres.js +236 -0
  399. package/dist/engine/deploy/testing/fake-postgres.js.map +1 -0
  400. package/dist/engine/deploy/testing/fake-vps.d.ts +147 -0
  401. package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -0
  402. package/dist/engine/deploy/testing/fake-vps.js +365 -0
  403. package/dist/engine/deploy/testing/fake-vps.js.map +1 -0
  404. package/dist/engine/deploy/uninstall.d.ts +87 -0
  405. package/dist/engine/deploy/uninstall.d.ts.map +1 -0
  406. package/dist/engine/deploy/uninstall.js +321 -0
  407. package/dist/engine/deploy/uninstall.js.map +1 -0
  408. package/dist/engine/deploy/update.d.ts +112 -0
  409. package/dist/engine/deploy/update.d.ts.map +1 -0
  410. package/dist/engine/deploy/update.js +1280 -0
  411. package/dist/engine/deploy/update.js.map +1 -0
  412. package/dist/engine/deploy/version-step.d.ts +65 -0
  413. package/dist/engine/deploy/version-step.d.ts.map +1 -0
  414. package/dist/engine/deploy/version-step.js +176 -0
  415. package/dist/engine/deploy/version-step.js.map +1 -0
  416. package/dist/engine/device-auth.d.ts +240 -0
  417. package/dist/engine/device-auth.d.ts.map +1 -0
  418. package/dist/engine/device-auth.js +442 -0
  419. package/dist/engine/device-auth.js.map +1 -0
  420. package/dist/engine/device-login.d.ts +126 -0
  421. package/dist/engine/device-login.d.ts.map +1 -0
  422. package/dist/engine/device-login.js +164 -0
  423. package/dist/engine/device-login.js.map +1 -0
  424. package/dist/engine/errors.d.ts +314 -0
  425. package/dist/engine/errors.d.ts.map +1 -0
  426. package/dist/engine/errors.js +561 -0
  427. package/dist/engine/errors.js.map +1 -0
  428. package/dist/engine/identity.d.ts +169 -0
  429. package/dist/engine/identity.d.ts.map +1 -0
  430. package/dist/engine/identity.js +227 -0
  431. package/dist/engine/identity.js.map +1 -0
  432. package/dist/engine/index.d.ts +104 -0
  433. package/dist/engine/index.d.ts.map +1 -0
  434. package/dist/engine/index.js +126 -0
  435. package/dist/engine/index.js.map +1 -0
  436. package/dist/engine/init/local-profile.d.ts +93 -0
  437. package/dist/engine/init/local-profile.d.ts.map +1 -0
  438. package/dist/engine/init/local-profile.js +295 -0
  439. package/dist/engine/init/local-profile.js.map +1 -0
  440. package/dist/engine/init/run-init.d.ts +41 -0
  441. package/dist/engine/init/run-init.d.ts.map +1 -0
  442. package/dist/engine/init/run-init.js +297 -0
  443. package/dist/engine/init/run-init.js.map +1 -0
  444. package/dist/engine/node/capabilities.d.ts +238 -0
  445. package/dist/engine/node/capabilities.d.ts.map +1 -0
  446. package/dist/engine/node/capabilities.js +316 -0
  447. package/dist/engine/node/capabilities.js.map +1 -0
  448. package/dist/engine/node/daemon.d.ts +63 -0
  449. package/dist/engine/node/daemon.d.ts.map +1 -0
  450. package/dist/engine/node/daemon.js +227 -0
  451. package/dist/engine/node/daemon.js.map +1 -0
  452. package/dist/engine/node/doctor.d.ts +58 -0
  453. package/dist/engine/node/doctor.d.ts.map +1 -0
  454. package/dist/engine/node/doctor.js +394 -0
  455. package/dist/engine/node/doctor.js.map +1 -0
  456. package/dist/engine/node/enrollment.d.ts +98 -0
  457. package/dist/engine/node/enrollment.d.ts.map +1 -0
  458. package/dist/engine/node/enrollment.js +189 -0
  459. package/dist/engine/node/enrollment.js.map +1 -0
  460. package/dist/engine/node/env-flags.d.ts +5 -0
  461. package/dist/engine/node/env-flags.d.ts.map +1 -0
  462. package/dist/engine/node/env-flags.js +22 -0
  463. package/dist/engine/node/env-flags.js.map +1 -0
  464. package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
  465. package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
  466. package/dist/engine/node/executors/credential-hygiene.js +189 -0
  467. package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
  468. package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
  469. package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
  470. package/dist/engine/node/executors/db-backup-run.js +362 -0
  471. package/dist/engine/node/executors/db-backup-run.js.map +1 -0
  472. package/dist/engine/node/executors/example-checksum.d.ts +30 -0
  473. package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
  474. package/dist/engine/node/executors/example-checksum.js +56 -0
  475. package/dist/engine/node/executors/example-checksum.js.map +1 -0
  476. package/dist/engine/node/executors/index.d.ts +168 -0
  477. package/dist/engine/node/executors/index.d.ts.map +1 -0
  478. package/dist/engine/node/executors/index.js +44 -0
  479. package/dist/engine/node/executors/index.js.map +1 -0
  480. package/dist/engine/node/executors/registry.d.ts +38 -0
  481. package/dist/engine/node/executors/registry.d.ts.map +1 -0
  482. package/dist/engine/node/executors/registry.js +92 -0
  483. package/dist/engine/node/executors/registry.js.map +1 -0
  484. package/dist/engine/node/heap-snapshot.d.ts +37 -0
  485. package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
  486. package/dist/engine/node/heap-snapshot.js +160 -0
  487. package/dist/engine/node/heap-snapshot.js.map +1 -0
  488. package/dist/engine/node/install-deps.d.ts +73 -0
  489. package/dist/engine/node/install-deps.d.ts.map +1 -0
  490. package/dist/engine/node/install-deps.js +150 -0
  491. package/dist/engine/node/install-deps.js.map +1 -0
  492. package/dist/engine/node/ipc-protocol.d.ts +67 -0
  493. package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
  494. package/dist/engine/node/ipc-protocol.js +83 -0
  495. package/dist/engine/node/ipc-protocol.js.map +1 -0
  496. package/dist/engine/node/lifecycle.d.ts +103 -0
  497. package/dist/engine/node/lifecycle.d.ts.map +1 -0
  498. package/dist/engine/node/lifecycle.js +259 -0
  499. package/dist/engine/node/lifecycle.js.map +1 -0
  500. package/dist/engine/node/logger.d.ts +82 -0
  501. package/dist/engine/node/logger.d.ts.map +1 -0
  502. package/dist/engine/node/logger.js +241 -0
  503. package/dist/engine/node/logger.js.map +1 -0
  504. package/dist/engine/node/memory-watchdog.d.ts +78 -0
  505. package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
  506. package/dist/engine/node/memory-watchdog.js +224 -0
  507. package/dist/engine/node/memory-watchdog.js.map +1 -0
  508. package/dist/engine/node/node-api.d.ts +391 -0
  509. package/dist/engine/node/node-api.d.ts.map +1 -0
  510. package/dist/engine/node/node-api.js +123 -0
  511. package/dist/engine/node/node-api.js.map +1 -0
  512. package/dist/engine/node/node-config.d.ts +128 -0
  513. package/dist/engine/node/node-config.d.ts.map +1 -0
  514. package/dist/engine/node/node-config.js +237 -0
  515. package/dist/engine/node/node-config.js.map +1 -0
  516. package/dist/engine/node/node-dashboard-source.d.ts +56 -0
  517. package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
  518. package/dist/engine/node/node-dashboard-source.js +213 -0
  519. package/dist/engine/node/node-dashboard-source.js.map +1 -0
  520. package/dist/engine/node/node-engine.d.ts +229 -0
  521. package/dist/engine/node/node-engine.d.ts.map +1 -0
  522. package/dist/engine/node/node-engine.js +723 -0
  523. package/dist/engine/node/node-engine.js.map +1 -0
  524. package/dist/engine/node/node-errors.d.ts +54 -0
  525. package/dist/engine/node/node-errors.d.ts.map +1 -0
  526. package/dist/engine/node/node-errors.js +71 -0
  527. package/dist/engine/node/node-errors.js.map +1 -0
  528. package/dist/engine/node/node-events.d.ts +132 -0
  529. package/dist/engine/node/node-events.d.ts.map +1 -0
  530. package/dist/engine/node/node-events.js +2 -0
  531. package/dist/engine/node/node-events.js.map +1 -0
  532. package/dist/engine/node/node-vitals.d.ts +123 -0
  533. package/dist/engine/node/node-vitals.d.ts.map +1 -0
  534. package/dist/engine/node/node-vitals.js +266 -0
  535. package/dist/engine/node/node-vitals.js.map +1 -0
  536. package/dist/engine/node/paths.d.ts +39 -0
  537. package/dist/engine/node/paths.d.ts.map +1 -0
  538. package/dist/engine/node/paths.js +60 -0
  539. package/dist/engine/node/paths.js.map +1 -0
  540. package/dist/engine/node/pg-dump.d.ts +126 -0
  541. package/dist/engine/node/pg-dump.d.ts.map +1 -0
  542. package/dist/engine/node/pg-dump.js +223 -0
  543. package/dist/engine/node/pg-dump.js.map +1 -0
  544. package/dist/engine/node/pidfile.d.ts +38 -0
  545. package/dist/engine/node/pidfile.d.ts.map +1 -0
  546. package/dist/engine/node/pidfile.js +156 -0
  547. package/dist/engine/node/pidfile.js.map +1 -0
  548. package/dist/engine/node/runtime-tuning.d.ts +65 -0
  549. package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
  550. package/dist/engine/node/runtime-tuning.js +198 -0
  551. package/dist/engine/node/runtime-tuning.js.map +1 -0
  552. package/dist/engine/node/service.d.ts +39 -0
  553. package/dist/engine/node/service.d.ts.map +1 -0
  554. package/dist/engine/node/service.js +211 -0
  555. package/dist/engine/node/service.js.map +1 -0
  556. package/dist/engine/node/start.d.ts +62 -0
  557. package/dist/engine/node/start.d.ts.map +1 -0
  558. package/dist/engine/node/start.js +245 -0
  559. package/dist/engine/node/start.js.map +1 -0
  560. package/dist/engine/node/worker-env-table.d.ts +15 -0
  561. package/dist/engine/node/worker-env-table.d.ts.map +1 -0
  562. package/dist/engine/node/worker-env-table.js +97 -0
  563. package/dist/engine/node/worker-env-table.js.map +1 -0
  564. package/dist/engine/node/worker-env.d.ts +50 -0
  565. package/dist/engine/node/worker-env.d.ts.map +1 -0
  566. package/dist/engine/node/worker-env.js +101 -0
  567. package/dist/engine/node/worker-env.js.map +1 -0
  568. package/dist/engine/output.d.ts +97 -0
  569. package/dist/engine/output.d.ts.map +1 -0
  570. package/dist/engine/output.js +274 -0
  571. package/dist/engine/output.js.map +1 -0
  572. package/dist/engine/package-info.d.ts +7 -0
  573. package/dist/engine/package-info.d.ts.map +1 -0
  574. package/dist/engine/package-info.js +38 -0
  575. package/dist/engine/package-info.js.map +1 -0
  576. package/dist/engine/program.d.ts +50 -0
  577. package/dist/engine/program.d.ts.map +1 -0
  578. package/dist/engine/program.js +197 -0
  579. package/dist/engine/program.js.map +1 -0
  580. package/dist/engine/prompt.d.ts +69 -0
  581. package/dist/engine/prompt.d.ts.map +1 -0
  582. package/dist/engine/prompt.js +205 -0
  583. package/dist/engine/prompt.js.map +1 -0
  584. package/dist/engine/registries.d.ts +5 -0
  585. package/dist/engine/registries.d.ts.map +1 -0
  586. package/dist/engine/registries.js +52 -0
  587. package/dist/engine/registries.js.map +1 -0
  588. package/dist/engine/request-body.d.ts +31 -0
  589. package/dist/engine/request-body.d.ts.map +1 -0
  590. package/dist/engine/request-body.js +156 -0
  591. package/dist/engine/request-body.js.map +1 -0
  592. package/dist/engine/test-support.d.ts +50 -0
  593. package/dist/engine/test-support.d.ts.map +1 -0
  594. package/dist/engine/test-support.js +86 -0
  595. package/dist/engine/test-support.js.map +1 -0
  596. package/dist/engine/tui/app.d.ts +3 -0
  597. package/dist/engine/tui/app.d.ts.map +1 -0
  598. package/dist/engine/tui/app.js +100 -0
  599. package/dist/engine/tui/app.js.map +1 -0
  600. package/dist/engine/tui/builtin-screens.d.ts +6 -0
  601. package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
  602. package/dist/engine/tui/builtin-screens.js +54 -0
  603. package/dist/engine/tui/builtin-screens.js.map +1 -0
  604. package/dist/engine/tui/index.d.ts +23 -0
  605. package/dist/engine/tui/index.d.ts.map +1 -0
  606. package/dist/engine/tui/index.js +71 -0
  607. package/dist/engine/tui/index.js.map +1 -0
  608. package/dist/engine/tui/layout.d.ts +132 -0
  609. package/dist/engine/tui/layout.d.ts.map +1 -0
  610. package/dist/engine/tui/layout.js +200 -0
  611. package/dist/engine/tui/layout.js.map +1 -0
  612. package/dist/engine/tui/routes.d.ts +5 -0
  613. package/dist/engine/tui/routes.d.ts.map +1 -0
  614. package/dist/engine/tui/routes.js +16 -0
  615. package/dist/engine/tui/routes.js.map +1 -0
  616. package/dist/engine/tui/screen-registry.d.ts +100 -0
  617. package/dist/engine/tui/screen-registry.d.ts.map +1 -0
  618. package/dist/engine/tui/screen-registry.js +96 -0
  619. package/dist/engine/tui/screen-registry.js.map +1 -0
  620. package/dist/engine/tui/screen-sections.d.ts +9 -0
  621. package/dist/engine/tui/screen-sections.d.ts.map +1 -0
  622. package/dist/engine/tui/screen-sections.js +45 -0
  623. package/dist/engine/tui/screen-sections.js.map +1 -0
  624. package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
  625. package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
  626. package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
  627. package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
  628. package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
  629. package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
  630. package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
  631. package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
  632. package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
  633. package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
  634. package/dist/engine/tui/screens/deploy/doctor.js +155 -0
  635. package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
  636. package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
  637. package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
  638. package/dist/engine/tui/screens/deploy/fields.js +202 -0
  639. package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
  640. package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
  641. package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
  642. package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
  643. package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
  644. package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
  645. package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
  646. package/dist/engine/tui/screens/deploy/index.js +83 -0
  647. package/dist/engine/tui/screens/deploy/index.js.map +1 -0
  648. package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
  649. package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
  650. package/dist/engine/tui/screens/deploy/install-model.js +319 -0
  651. package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
  652. package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
  653. package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
  654. package/dist/engine/tui/screens/deploy/install.js +361 -0
  655. package/dist/engine/tui/screens/deploy/install.js.map +1 -0
  656. package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
  657. package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
  658. package/dist/engine/tui/screens/deploy/model.js +59 -0
  659. package/dist/engine/tui/screens/deploy/model.js.map +1 -0
  660. package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
  661. package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
  662. package/dist/engine/tui/screens/deploy/run-model.js +117 -0
  663. package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
  664. package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
  665. package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
  666. package/dist/engine/tui/screens/deploy/run.js +201 -0
  667. package/dist/engine/tui/screens/deploy/run.js.map +1 -0
  668. package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
  669. package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
  670. package/dist/engine/tui/screens/deploy/status.js +107 -0
  671. package/dist/engine/tui/screens/deploy/status.js.map +1 -0
  672. package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
  673. package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
  674. package/dist/engine/tui/screens/deploy/update.js +175 -0
  675. package/dist/engine/tui/screens/deploy/update.js.map +1 -0
  676. package/dist/engine/tui/screens/deploy.d.ts +12 -0
  677. package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
  678. package/dist/engine/tui/screens/deploy.js +23 -0
  679. package/dist/engine/tui/screens/deploy.js.map +1 -0
  680. package/dist/engine/tui/screens/invoke.d.ts +6 -0
  681. package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
  682. package/dist/engine/tui/screens/invoke.js +193 -0
  683. package/dist/engine/tui/screens/invoke.js.map +1 -0
  684. package/dist/engine/tui/screens/login.d.ts +6 -0
  685. package/dist/engine/tui/screens/login.d.ts.map +1 -0
  686. package/dist/engine/tui/screens/login.js +255 -0
  687. package/dist/engine/tui/screens/login.js.map +1 -0
  688. package/dist/engine/tui/screens/logout.d.ts +6 -0
  689. package/dist/engine/tui/screens/logout.d.ts.map +1 -0
  690. package/dist/engine/tui/screens/logout.js +142 -0
  691. package/dist/engine/tui/screens/logout.js.map +1 -0
  692. package/dist/engine/tui/screens/menu.d.ts +22 -0
  693. package/dist/engine/tui/screens/menu.d.ts.map +1 -0
  694. package/dist/engine/tui/screens/menu.js +84 -0
  695. package/dist/engine/tui/screens/menu.js.map +1 -0
  696. package/dist/engine/tui/screens/node.d.ts +6 -0
  697. package/dist/engine/tui/screens/node.d.ts.map +1 -0
  698. package/dist/engine/tui/screens/node.js +228 -0
  699. package/dist/engine/tui/screens/node.js.map +1 -0
  700. package/dist/engine/tui/screens/status.d.ts +6 -0
  701. package/dist/engine/tui/screens/status.d.ts.map +1 -0
  702. package/dist/engine/tui/screens/status.js +134 -0
  703. package/dist/engine/tui/screens/status.js.map +1 -0
  704. package/dist/engine/tui/scroll-box.d.ts +27 -0
  705. package/dist/engine/tui/scroll-box.d.ts.map +1 -0
  706. package/dist/engine/tui/scroll-box.js +52 -0
  707. package/dist/engine/tui/scroll-box.js.map +1 -0
  708. package/dist/engine/tui/section-registry.d.ts +65 -0
  709. package/dist/engine/tui/section-registry.d.ts.map +1 -0
  710. package/dist/engine/tui/section-registry.js +90 -0
  711. package/dist/engine/tui/section-registry.js.map +1 -0
  712. package/dist/engine/tui/terminal.d.ts +31 -0
  713. package/dist/engine/tui/terminal.d.ts.map +1 -0
  714. package/dist/engine/tui/terminal.js +142 -0
  715. package/dist/engine/tui/terminal.js.map +1 -0
  716. package/dist/engine/tui/tty.d.ts +49 -0
  717. package/dist/engine/tui/tty.d.ts.map +1 -0
  718. package/dist/engine/tui/tty.js +139 -0
  719. package/dist/engine/tui/tty.js.map +1 -0
  720. package/dist/index.d.ts +10 -0
  721. package/dist/index.d.ts.map +1 -0
  722. package/dist/index.js +11 -0
  723. package/dist/index.js.map +1 -0
  724. package/dist/node/index.d.ts +3 -0
  725. package/dist/node/index.d.ts.map +1 -0
  726. package/dist/node/index.js +5 -0
  727. package/dist/node/index.js.map +1 -0
  728. package/dist/telemetry/env-fragment.d.ts +47 -0
  729. package/dist/telemetry/env-fragment.d.ts.map +1 -0
  730. package/dist/telemetry/env-fragment.js +73 -0
  731. package/dist/telemetry/env-fragment.js.map +1 -0
  732. package/dist/telemetry/index.d.ts +7 -0
  733. package/dist/telemetry/index.d.ts.map +1 -0
  734. package/dist/telemetry/index.js +7 -0
  735. package/dist/telemetry/index.js.map +1 -0
  736. package/dist/telemetry/node-span-relay.d.ts +107 -0
  737. package/dist/telemetry/node-span-relay.d.ts.map +1 -0
  738. package/dist/telemetry/node-span-relay.js +314 -0
  739. package/dist/telemetry/node-span-relay.js.map +1 -0
  740. package/dist/telemetry/node-span.d.ts +92 -0
  741. package/dist/telemetry/node-span.d.ts.map +1 -0
  742. package/dist/telemetry/node-span.js +28 -0
  743. package/dist/telemetry/node-span.js.map +1 -0
  744. package/dist/testing/index.d.ts +3 -0
  745. package/dist/testing/index.d.ts.map +1 -0
  746. package/dist/testing/index.js +4 -0
  747. package/dist/testing/index.js.map +1 -0
  748. package/dist/tui/index.d.ts +3 -0
  749. package/dist/tui/index.d.ts.map +1 -0
  750. package/dist/tui/index.js +5 -0
  751. package/dist/tui/index.js.map +1 -0
  752. package/package.json +102 -4
@@ -0,0 +1,186 @@
1
+ import type { runCommand } from '../executor.js';
2
+ import type { ProxyRuntime } from '../proxy.js';
3
+ export type CheckStatus = 'pass' | 'warn' | 'fail' | 'skip';
4
+ export interface CheckResult {
5
+ status: CheckStatus;
6
+ /** One line: what was found. "Docker 27.3.1", or "not installed". */
7
+ detail: string;
8
+ /** Shown on warn/fail. A command or a path, never a category. */
9
+ remedy?: string | undefined;
10
+ }
11
+ /** Filesystem probes, injectable so checks are testable without a real server. */
12
+ export interface CheckFs {
13
+ exists(path: string): boolean;
14
+ isDirectory(path: string): boolean;
15
+ isWritable(path: string): boolean;
16
+ /** UTF-8 contents, or undefined when absent or unreadable. Never throws. */
17
+ readFile(path: string): string | undefined;
18
+ /** Entry names, or [] when absent or unreadable. Never throws. */
19
+ readdir(path: string): string[];
20
+ }
21
+ export declare const realFs: CheckFs;
22
+ /** What the certificate ON THE WIRE says, as opposed to the one on disk. */
23
+ export interface ServedCertificate {
24
+ /** The peer certificate's `valid_to`. */
25
+ notAfter: Date;
26
+ }
27
+ /**
28
+ * Reads the certificate a TLS server presents for `domain`.
29
+ *
30
+ * `rejectUnauthorized: false` because the question is WHICH certificate is
31
+ * served, not whether it is trusted -- an expired or staging certificate is
32
+ * exactly the one this has to be able to read. Nothing is sent after the
33
+ * handshake. Rejects on any failure; the caller decides what that means.
34
+ */
35
+ export declare function fetchServedCertificate(domain: string, options?: {
36
+ port?: number;
37
+ timeoutMs?: number;
38
+ }): Promise<ServedCertificate>;
39
+ /**
40
+ * True when nothing is listening on the loopback address for `port`.
41
+ *
42
+ * Binding is used rather than parsing `ss` output: it needs no external tool,
43
+ * it cannot be confused by a different output format, and it answers the
44
+ * question that actually matters - can this deployment take the port.
45
+ */
46
+ export declare function isLoopbackPortFree(port: number): Promise<boolean>;
47
+ /** True when something answers on `port` of any interface. */
48
+ export declare function isPortListening(port: number): Promise<boolean>;
49
+ export interface CheckContext {
50
+ runCommand: typeof runCommand;
51
+ /** Where the deployment lives, or will. */
52
+ deployRoot: string;
53
+ /** Loopback port the shared proxy forwards to. */
54
+ bindPort: number;
55
+ /**
56
+ * The deployment's compose project (`composeProjectFor(state)`): the value
57
+ * of the `com.docker.compose.project` label on its containers. Use it, not
58
+ * `basename(deployRoot)`, to recognise the deployment's own containers: a
59
+ * deployment installed before the project was recorded runs under
60
+ * `compose`. Absent when a check runs before any state exists.
61
+ */
62
+ composeProject?: string | undefined;
63
+ /** The shared reverse proxy's directory. */
64
+ proxyRoot: string;
65
+ /** Public hostname, when one is known. DNS and TLS checks need it. */
66
+ domain?: string | undefined;
67
+ /** The resolved environment, when one exists. Database checks need it. */
68
+ env?: ReadonlyMap<string, string> | undefined;
69
+ fs?: CheckFs | undefined;
70
+ totalMemoryBytes?: (() => number) | undefined;
71
+ portFree?: ((port: number) => Promise<boolean>) | undefined;
72
+ portListening?: ((port: number) => Promise<boolean>) | undefined;
73
+ /** Resolves DNS; injected so the DNS checks (#177) are testable. */
74
+ resolveHost?: ((hostname: string) => Promise<string[]>) | undefined;
75
+ /** This host's own public addresses, when they can be determined. */
76
+ ownAddresses?: (() => Promise<string[]>) | undefined;
77
+ /**
78
+ * How the shared proxy runs, resolved once by the command building this
79
+ * context (see `resolveProxyRuntime`). Absent means unknown, and the checks
80
+ * that care fall back to their historical host-mode behaviour.
81
+ */
82
+ proxyRuntime?: ProxyRuntime | undefined;
83
+ /** Reads the certificate served on the wire; injected so no test opens a socket. */
84
+ servedCertificate?: ((domain: string) => Promise<ServedCertificate>) | undefined;
85
+ /**
86
+ * The repository this deployment clones or fetches, when it is known (a
87
+ * flag, the deployment record, or the checkout's `origin`). Display-safe:
88
+ * normalised, so it carries no embedded credential.
89
+ */
90
+ repoUrl?: string | undefined;
91
+ /**
92
+ * Whether git can ALREADY read `repoUrl` without a prompt -- a public
93
+ * repository, a credential helper, a stored token. Computed ONCE by the
94
+ * command building this context (see `gitCredentialStateFor`), because
95
+ * `severityFor` must stay synchronous and cheap. Absent means "not probed":
96
+ * nothing is promoted on an unknown.
97
+ */
98
+ gitCredentialed?: boolean | undefined;
99
+ /**
100
+ * True when this run will NOT publish through the shared proxy (install or
101
+ * update with --skip-proxy). The proxy prerequisites are then advice, not
102
+ * blockers. Doctor leaves it unset: it asks about a deployment in general.
103
+ */
104
+ skipProxy?: boolean | undefined;
105
+ /**
106
+ * True when this run is authorised to BOOTSTRAP the shared proxy if it is
107
+ * absent (#391: `--bootstrap-proxy`, or a yes at install's prompt). A proxy
108
+ * container that does not exist, in a proxy root with no compose file, is
109
+ * then not a blocker -- install is about to create it. An existing but
110
+ * stopped proxy, or a root with a compose file, still fails: those belong to
111
+ * somebody else and are never touched.
112
+ */
113
+ proxyBootstrap?: boolean | undefined;
114
+ /**
115
+ * True when the operator chose to run the API as a superuser or BYPASSRLS
116
+ * role anyway (`--allow-superuser`, recorded in the deployment state, #980).
117
+ * `database-role-ordinary` then reports a warning that names the consequence
118
+ * instead of failing.
119
+ */
120
+ allowSuperuser?: boolean | undefined;
121
+ }
122
+ export type Severity = 'required' | 'recommended';
123
+ export interface Check {
124
+ /** Stable, kebab-case. Used by --json and by tests. */
125
+ id: string;
126
+ title: string;
127
+ /**
128
+ * The static severity: what the check is when nothing about the context
129
+ * says otherwise. Read it through `severityOf`, never directly, once a
130
+ * context exists.
131
+ */
132
+ severity: Severity;
133
+ /**
134
+ * The severity for THIS context, when it depends on one -- `certbot-installed`
135
+ * is required only when the proxy runs on the host. Must be read-only and
136
+ * cheap; a throw falls back to `severity`.
137
+ */
138
+ severityFor?: ((context: CheckContext) => Severity) | undefined;
139
+ /** Ids that must pass first; otherwise this reports `skip`. */
140
+ requires?: readonly string[] | undefined;
141
+ run(context: CheckContext): Promise<CheckResult>;
142
+ }
143
+ /**
144
+ * A check's EFFECTIVE severity in a context.
145
+ *
146
+ * ⚠ Everything that decides an exit code -- `requiredChecks`, `checksPassed`
147
+ * via `CompletedCheck.severity`, the doctor and preflight renderers -- goes
148
+ * through this, so a check promoted or demoted by its context is promoted or
149
+ * demoted everywhere at once rather than in whichever caller remembered.
150
+ */
151
+ export declare function severityOf(check: Check, context: CheckContext): Severity;
152
+ export interface CompletedCheck extends CheckResult {
153
+ id: string;
154
+ title: string;
155
+ /** The EFFECTIVE severity this run evaluated it under -- see `severityOf`. */
156
+ severity: Severity;
157
+ durationMs: number;
158
+ }
159
+ export declare function contextFs(context: CheckContext): CheckFs;
160
+ export declare function contextMemory(context: CheckContext): number;
161
+ export declare function contextPortFree(context: CheckContext): (port: number) => Promise<boolean>;
162
+ export declare function contextServedCertificate(context: CheckContext): (domain: string) => Promise<ServedCertificate>;
163
+ export declare function contextPortListening(context: CheckContext): (port: number) => Promise<boolean>;
164
+ /**
165
+ * Runs the registry in order, honouring `requires`.
166
+ *
167
+ * A check that throws is reported as a failure and the run continues - rule 1.
168
+ * `onResult` fires as each completes so a command can stream a checklist
169
+ * rather than appearing to hang through a dozen subprocess calls.
170
+ */
171
+ export declare function runChecks(checks: readonly Check[], context: CheckContext, onResult?: (result: CompletedCheck) => void): Promise<CompletedCheck[]>;
172
+ /**
173
+ * True when every required check passed. Warnings do not fail a run.
174
+ *
175
+ * Reads `CompletedCheck.severity`, which `runChecks` already set to the
176
+ * EFFECTIVE severity, so a context-promoted check fails the run here too.
177
+ */
178
+ export declare function checksPassed(results: readonly CompletedCheck[]): boolean;
179
+ export interface CheckSummary {
180
+ passed: number;
181
+ warned: number;
182
+ failed: number;
183
+ skipped: number;
184
+ }
185
+ export declare function summarise(results: readonly CompletedCheck[]): CheckSummary;
186
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/engine/deploy/checks/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,199 @@
1
+ import { accessSync, constants, readFileSync, readdirSync, statSync } from 'node:fs';
2
+ import { createServer } from 'node:net';
3
+ import { totalmem } from 'node:os';
4
+ import { connect as tlsConnect } from 'node:tls';
5
+ export const realFs = {
6
+ exists(path) {
7
+ try {
8
+ statSync(path);
9
+ return true;
10
+ }
11
+ catch {
12
+ return false;
13
+ }
14
+ },
15
+ isDirectory(path) {
16
+ try {
17
+ return statSync(path).isDirectory();
18
+ }
19
+ catch {
20
+ return false;
21
+ }
22
+ },
23
+ isWritable(path) {
24
+ try {
25
+ accessSync(path, constants.W_OK);
26
+ return true;
27
+ }
28
+ catch {
29
+ return false;
30
+ }
31
+ },
32
+ readFile(path) {
33
+ try {
34
+ return readFileSync(path, 'utf8');
35
+ }
36
+ catch {
37
+ return undefined;
38
+ }
39
+ },
40
+ readdir(path) {
41
+ try {
42
+ return readdirSync(path);
43
+ }
44
+ catch {
45
+ return [];
46
+ }
47
+ },
48
+ };
49
+ /**
50
+ * Reads the certificate a TLS server presents for `domain`.
51
+ *
52
+ * `rejectUnauthorized: false` because the question is WHICH certificate is
53
+ * served, not whether it is trusted -- an expired or staging certificate is
54
+ * exactly the one this has to be able to read. Nothing is sent after the
55
+ * handshake. Rejects on any failure; the caller decides what that means.
56
+ */
57
+ export async function fetchServedCertificate(domain, options = {}) {
58
+ return await new Promise((resolve, reject) => {
59
+ const socket = tlsConnect({
60
+ host: domain,
61
+ port: options.port ?? 443,
62
+ servername: domain,
63
+ rejectUnauthorized: false,
64
+ });
65
+ socket.setTimeout(options.timeoutMs ?? 10_000, () => {
66
+ socket.destroy(new Error(`timed out reading the certificate served for ${domain}`));
67
+ });
68
+ socket.once('error', reject);
69
+ socket.once('secureConnect', () => {
70
+ const certificate = socket.getPeerCertificate();
71
+ socket.end();
72
+ const notAfter = new Date(certificate.valid_to ?? '');
73
+ if (Number.isNaN(notAfter.getTime())) {
74
+ reject(new Error(`unrecognised served expiry: ${String(certificate.valid_to)}`));
75
+ return;
76
+ }
77
+ resolve({ notAfter });
78
+ });
79
+ });
80
+ }
81
+ /**
82
+ * True when nothing is listening on the loopback address for `port`.
83
+ *
84
+ * Binding is used rather than parsing `ss` output: it needs no external tool,
85
+ * it cannot be confused by a different output format, and it answers the
86
+ * question that actually matters - can this deployment take the port.
87
+ */
88
+ export async function isLoopbackPortFree(port) {
89
+ return await new Promise((resolve) => {
90
+ const server = createServer();
91
+ server.once('error', () => resolve(false));
92
+ server.once('listening', () => {
93
+ server.close(() => resolve(true));
94
+ });
95
+ server.listen(port, '127.0.0.1');
96
+ });
97
+ }
98
+ /** True when something answers on `port` of any interface. */
99
+ export async function isPortListening(port) {
100
+ return !(await new Promise((resolve) => {
101
+ const server = createServer();
102
+ server.once('error', () => resolve(false));
103
+ server.once('listening', () => {
104
+ server.close(() => resolve(true));
105
+ });
106
+ server.listen(port, '0.0.0.0');
107
+ }));
108
+ }
109
+ /**
110
+ * A check's EFFECTIVE severity in a context.
111
+ *
112
+ * ⚠ Everything that decides an exit code -- `requiredChecks`, `checksPassed`
113
+ * via `CompletedCheck.severity`, the doctor and preflight renderers -- goes
114
+ * through this, so a check promoted or demoted by its context is promoted or
115
+ * demoted everywhere at once rather than in whichever caller remembered.
116
+ */
117
+ export function severityOf(check, context) {
118
+ if (check.severityFor === undefined)
119
+ return check.severity;
120
+ try {
121
+ return check.severityFor(context);
122
+ }
123
+ catch {
124
+ // Rule 1 extends to this: a broken severity function must not abort the
125
+ // run. The static severity is the documented fallback.
126
+ return check.severity;
127
+ }
128
+ }
129
+ export function contextFs(context) {
130
+ return context.fs ?? realFs;
131
+ }
132
+ export function contextMemory(context) {
133
+ return (context.totalMemoryBytes ?? totalmem)();
134
+ }
135
+ export function contextPortFree(context) {
136
+ return context.portFree ?? isLoopbackPortFree;
137
+ }
138
+ export function contextServedCertificate(context) {
139
+ return context.servedCertificate ?? ((domain) => fetchServedCertificate(domain));
140
+ }
141
+ export function contextPortListening(context) {
142
+ return context.portListening ?? isPortListening;
143
+ }
144
+ /**
145
+ * Runs the registry in order, honouring `requires`.
146
+ *
147
+ * A check that throws is reported as a failure and the run continues - rule 1.
148
+ * `onResult` fires as each completes so a command can stream a checklist
149
+ * rather than appearing to hang through a dozen subprocess calls.
150
+ */
151
+ export async function runChecks(checks, context, onResult) {
152
+ const results = [];
153
+ const byId = new Map();
154
+ for (const check of checks) {
155
+ const startedAt = Date.now();
156
+ const unmet = (check.requires ?? []).filter((id) => byId.get(id)?.status !== 'pass');
157
+ const result = unmet.length > 0
158
+ ? {
159
+ status: 'skip',
160
+ // Named, so a wall of skips explains itself rather than looking
161
+ // like the checks silently did nothing.
162
+ detail: `skipped: ${unmet.join(', ')} did not pass`,
163
+ }
164
+ : await check.run(context).catch((error) => ({
165
+ status: 'fail',
166
+ detail: error instanceof Error ? error.message : String(error),
167
+ remedy: 'This check itself failed; the problem may be with appctl.',
168
+ }));
169
+ const completed = {
170
+ ...result,
171
+ id: check.id,
172
+ title: check.title,
173
+ severity: severityOf(check, context),
174
+ durationMs: Date.now() - startedAt,
175
+ };
176
+ results.push(completed);
177
+ byId.set(check.id, completed);
178
+ onResult?.(completed);
179
+ }
180
+ return results;
181
+ }
182
+ /**
183
+ * True when every required check passed. Warnings do not fail a run.
184
+ *
185
+ * Reads `CompletedCheck.severity`, which `runChecks` already set to the
186
+ * EFFECTIVE severity, so a context-promoted check fails the run here too.
187
+ */
188
+ export function checksPassed(results) {
189
+ return !results.some((result) => result.severity === 'required' && result.status === 'fail');
190
+ }
191
+ export function summarise(results) {
192
+ return {
193
+ passed: results.filter((result) => result.status === 'pass').length,
194
+ warned: results.filter((result) => result.status === 'warn').length,
195
+ failed: results.filter((result) => result.status === 'fail').length,
196
+ skipped: results.filter((result) => result.status === 'skip').length,
197
+ };
198
+ }
199
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/engine/deploy/checks/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ import type { EnvGroup } from './env-metadata.js';
2
+ /** The group whose presence adds the telemetry stack. Always on; see above. */
3
+ export declare const TELEMETRY_GROUP: "observability";
4
+ /** Groups every VPS deployment has, whatever was passed or recorded. */
5
+ export declare const ALWAYS_ON_GROUPS: readonly EnvGroup[];
6
+ /**
7
+ * The groups a deployment actually runs with: the requested or recorded ones,
8
+ * plus every always-on group. Order is kept and duplicates dropped.
9
+ *
10
+ * THE ONE PLACE this is decided. Install, update, uninstall, health, the
11
+ * compose file list, the environment wizard and the update's drift check all
12
+ * route through it, so an existing deployment whose `state.groups` predates
13
+ * #567 gets the telemetry stack -- files and keys -- on its next update.
14
+ *
15
+ * @param groups - The requested or recorded groups.
16
+ * @returns Those groups plus every always-on and default-enabled one.
17
+ * @stability experimental
18
+ */
19
+ export declare function effectiveGroups(groups?: readonly string[] | undefined): EnvGroup[];
20
+ /**
21
+ * The compose files for a deployment with these groups, in the order compose
22
+ * must apply them. File names only; callers join the directory. The telemetry
23
+ * files are always included (`effectiveGroups`). With `composeDir` (the
24
+ * checkout's infra/compose), the app's overlays found there come last.
25
+ */
26
+ export declare function composeFilesFor(groups?: readonly string[] | undefined, composeDir?: string): string[];
27
+ /** `-f <file>` for each file, in order. */
28
+ export declare function composeFileArgs(groups?: readonly string[] | undefined, composeDir?: string): string[];
29
+ //# sourceMappingURL=compose-files.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compose-files.d.ts","sourceRoot":"","sources":["../../../src/engine/deploy/compose-files.ts"],"names":[],"mappings":"AA6DA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,+EAA+E;AAC/E,eAAO,MAAM,eAAe,iBAAqD,CAAC;AAiBlF,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,EAAE,SAAS,QAAQ,EAAsB,CAAC;AAEvE;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,QAAQ,EAAE,CAWlF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAGrG;AAED,2CAA2C;AAC3C,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAErG"}
@@ -0,0 +1,118 @@
1
+ // =============================================================================
2
+ // Which compose files make up this deployment (issue #531, epic #528)
3
+ // =============================================================================
4
+ //
5
+ // ONE list, read by every compose invocation: install, update, uninstall and
6
+ // the health gate. It used to be two hard-coded copies (install.ts and
7
+ // health.ts), which is how a stack ends up started with one set of files and
8
+ // inspected -- or torn down -- with another.
9
+ //
10
+ // The list depends on the deployment's groups, and those come from the flag
11
+ // on this run or from `state.groups` -- NEVER from reading the `.env`, for the
12
+ // reason `DeployState.groups` gives -- always widened by `effectiveGroups`.
13
+ //
14
+ // TELEMETRY IS ALWAYS ON for a VPS deployment (issue #567). `observability`
15
+ // used to be opt-in, and a deployment installed without it had no
16
+ // `greptimedb` container, so the admin telemetry page failed with "host
17
+ // greptimedb could not be resolved" and could only be fixed from a shell.
18
+ // Everything telemetry-related must be doable from the admin UI, so the stack
19
+ // ships with every deployment. Deploying it does not force export on:
20
+ // collection stays gated at runtime by the admin UI's telemetry toggle.
21
+ // `--group observability` is still accepted, as a harmless no-op.
22
+ //
23
+ // ORDER IS LOAD-BEARING:
24
+ //
25
+ // base, prod, [telemetry], vps, [vps.telemetry]
26
+ //
27
+ // - The VPS files come LAST. Their `ports: !override` only replaces what the
28
+ // files BEFORE them published; applied earlier, a later file's ports would
29
+ // merge back in and the service would be reachable on 0.0.0.0.
30
+ // - telemetry.compose.yml adds services, so it sits before the VPS files and
31
+ // inherits their hardening.
32
+ // - vps.telemetry.compose.yml is separate from vps.compose.yml because a
33
+ // service block for `greptimedb` in vps.compose.yml would be a service
34
+ // with no image on every deployment WITHOUT telemetry, and compose rejects
35
+ // the whole project for it.
36
+ //
37
+ // THE ORDER COMES FROM THE PACKAGE (issues #705, #714). Every file above is
38
+ // generated into infra/compose/ by @marinoscar/platform-infra (`npm run
39
+ // platform:infra:sync`), and the package's `composeFilesForMode('vps')` owns
40
+ // the order, so the deploy and every other consumer apply the same list.
41
+ //
42
+ // APP OVERLAYS COME LAST (#714). An app changes the stack with
43
+ // `infra/compose/app.*.compose.yml` files, never by editing a generated one.
44
+ // Given the checkout's compose directory, the list ends with the overlays
45
+ // that apply to a VPS deployment (`app.<name>`, `app.prod.<name>`,
46
+ // `app.vps.<name>`), sorted by file name, so they win:
47
+ //
48
+ // base, prod, [telemetry], vps, [vps.telemetry], app.*.compose.yml
49
+ //
50
+ // A name ending in `.example.compose.yml` is documentation and never applied.
51
+ // Without a directory (or when it cannot be read) the list has no overlays.
52
+ // =============================================================================
53
+ import { readdirSync } from 'node:fs';
54
+ import { composeFilesForMode } from '@marinoscar/platform-infra';
55
+ import { telemetryInfraFragment } from '@marinoscar/platform-infra/telemetry';
56
+ import { listEnvGroups } from '../../core/index.js';
57
+ import { ensurePlatformRegistrations } from '../builtin-registrations.js';
58
+ /** The group whose presence adds the telemetry stack. Always on; see above. */
59
+ export const TELEMETRY_GROUP = telemetryInfraFragment.envGroup;
60
+ /**
61
+ * The file names in the checkout's compose directory, where the app's
62
+ * overlays live. Empty when no directory is given or it cannot be read: a
63
+ * missing checkout must not turn into a thrown error here, the compose call
64
+ * that follows reports it with the right context.
65
+ */
66
+ function composeDirListing(composeDir) {
67
+ if (composeDir === undefined)
68
+ return [];
69
+ try {
70
+ return readdirSync(composeDir);
71
+ }
72
+ catch {
73
+ return [];
74
+ }
75
+ }
76
+ /** Groups every VPS deployment has, whatever was passed or recorded. */
77
+ export const ALWAYS_ON_GROUPS = [TELEMETRY_GROUP];
78
+ /**
79
+ * The groups a deployment actually runs with: the requested or recorded ones,
80
+ * plus every always-on group. Order is kept and duplicates dropped.
81
+ *
82
+ * THE ONE PLACE this is decided. Install, update, uninstall, health, the
83
+ * compose file list, the environment wizard and the update's drift check all
84
+ * route through it, so an existing deployment whose `state.groups` predates
85
+ * #567 gets the telemetry stack -- files and keys -- on its next update.
86
+ *
87
+ * @param groups - The requested or recorded groups.
88
+ * @returns Those groups plus every always-on and default-enabled one.
89
+ * @stability experimental
90
+ */
91
+ export function effectiveGroups(groups) {
92
+ ensurePlatformRegistrations();
93
+ // Always-on first, then every other registered group that is on by default
94
+ // (an app's `defaultEnabled` group): the platform's own default is the
95
+ // telemetry group alone, so a deployment without app groups is unchanged.
96
+ const defaults = listEnvGroups().filter((group) => group.defaultEnabled).map((group) => group.id);
97
+ const result = [];
98
+ for (const group of [...(groups ?? []), ...ALWAYS_ON_GROUPS, ...defaults]) {
99
+ if (!result.includes(group))
100
+ result.push(group);
101
+ }
102
+ return result;
103
+ }
104
+ /**
105
+ * The compose files for a deployment with these groups, in the order compose
106
+ * must apply them. File names only; callers join the directory. The telemetry
107
+ * files are always included (`effectiveGroups`). With `composeDir` (the
108
+ * checkout's infra/compose), the app's overlays found there come last.
109
+ */
110
+ export function composeFilesFor(groups, composeDir) {
111
+ const telemetry = effectiveGroups(groups).includes(TELEMETRY_GROUP);
112
+ return composeFilesForMode('vps', { telemetry, overlays: composeDirListing(composeDir) });
113
+ }
114
+ /** `-f <file>` for each file, in order. */
115
+ export function composeFileArgs(groups, composeDir) {
116
+ return composeFilesFor(groups, composeDir).flatMap((file) => ['-f', file]);
117
+ }
118
+ //# sourceMappingURL=compose-files.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compose-files.js","sourceRoot":"","sources":["../../../src/engine/deploy/compose-files.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ /** Variables a compose failure text reports as required and empty, in order, once each. */
2
+ export declare function missingComposeVariables(text: string): string[];
3
+ /** The plain-language explanation for the given variables. */
4
+ export declare function composeMissingVariableHint(variables: readonly string[], envPath: string): string;
5
+ /**
6
+ * The same error with the hint appended when it is a compose "required variable"
7
+ * refusal; anything else comes back untouched. The original message (the compose
8
+ * output) is kept in full, and a `CommandFailedError` stays one, with its result.
9
+ */
10
+ export declare function explainComposeFailure(error: unknown, envPath: string): unknown;
11
+ //# sourceMappingURL=compose-hints.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compose-hints.d.ts","sourceRoot":"","sources":["../../../src/engine/deploy/compose-hints.ts"],"names":[],"mappings":"AA6BA,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAM9D;AAED,8DAA8D;AAC9D,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAehG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAc9E"}
@@ -0,0 +1,70 @@
1
+ import { cliName, cliVersion } from '../identity.js';
2
+ import { CommandFailedError } from './executor.js';
3
+ // =============================================================================
4
+ // A compose "required variable" refusal, explained (#1009)
5
+ // =============================================================================
6
+ //
7
+ // A compose file can refuse to start without a value (`${VAR:?message}`). The
8
+ // message names the variable and, at best, the file; it cannot say WHY the file
9
+ // has no value. On a real server it is almost always one of two things, and
10
+ // neither is visible from the compose output:
11
+ //
12
+ // 1. This CLI is older than the revision it is deploying. The CLI generates a
13
+ // new required secret (`autoGenerate`, e.g. STACK_AGENT_TOKEN) during
14
+ // `update`; a CLI built before the revision introduced it does not know
15
+ // the key exists, so the build fails at the first compose call. The CLI is
16
+ // updated separately from the application, which is what makes this easy
17
+ // to hit.
18
+ // 2. The key is missing or empty in the `.env` (deleted, never generated).
19
+ //
20
+ // So every place that runs compose against the deployment appends this hint,
21
+ // keeping the original output intact above it.
22
+ // =============================================================================
23
+ const REQUIRED_VARIABLE = /required variable ([A-Za-z_][A-Za-z0-9_]*) is missing a value/g;
24
+ /** Marker that keeps a re-thrown error from collecting the hint twice. */
25
+ const HINT_MARKER = 'Hint: docker compose refused to run';
26
+ /** Variables a compose failure text reports as required and empty, in order, once each. */
27
+ export function missingComposeVariables(text) {
28
+ const found = new Set();
29
+ for (const match of text.matchAll(REQUIRED_VARIABLE)) {
30
+ if (match[1] !== undefined)
31
+ found.add(match[1]);
32
+ }
33
+ return [...found];
34
+ }
35
+ /** The plain-language explanation for the given variables. */
36
+ export function composeMissingVariableHint(variables, envPath) {
37
+ const cli = cliName();
38
+ const names = variables.join(', ');
39
+ const noun = variables.length === 1 ? `${names} has` : `${names} have`;
40
+ return [
41
+ `${HINT_MARKER} because ${noun} no value in ${envPath}.`,
42
+ 'There are two usual causes:',
43
+ ` 1. This ${cli} (v${cliVersion()}) is older than the revision being deployed. The revision requires ${names}, ` +
44
+ `and only a newer ${cli} generates it during \`deploy update\`. The CLI is updated separately from the application: ` +
45
+ `update the CLI first (re-run its installer, or your bootstrap script's --update), then run ` +
46
+ `\`${cli} deploy update\` again. A plain retry is enough; --force is not needed.`,
47
+ ` 2. The key is missing or empty in ${envPath}. Add ${variables.map((v) => `${v}=<value>`).join(' and ')} ` +
48
+ `there (for a token, \`openssl rand -hex 32\` makes a good one), then run \`${cli} deploy update\` again.`,
49
+ ].join('\n');
50
+ }
51
+ /**
52
+ * The same error with the hint appended when it is a compose "required variable"
53
+ * refusal; anything else comes back untouched. The original message (the compose
54
+ * output) is kept in full, and a `CommandFailedError` stays one, with its result.
55
+ */
56
+ export function explainComposeFailure(error, envPath) {
57
+ if (!(error instanceof Error))
58
+ return error;
59
+ if (error.message.includes(HINT_MARKER))
60
+ return error;
61
+ const result = error instanceof CommandFailedError ? error.result : undefined;
62
+ const variables = missingComposeVariables([error.message, result?.stderr ?? '', result?.stdout ?? ''].join('\n'));
63
+ if (variables.length === 0)
64
+ return error;
65
+ const message = `${error.message}\n\n${composeMissingVariableHint(variables, envPath)}`;
66
+ return result === undefined
67
+ ? new Error(message, { cause: error })
68
+ : new CommandFailedError(message, result);
69
+ }
70
+ //# sourceMappingURL=compose-hints.js.map