@marinoscar/platform-cli 0.1.0-next.3 → 0.1.0-next.30

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 (943) hide show
  1. package/CHANGELOG.md +358 -0
  2. package/README.md +163 -31
  3. package/dist/android/build.d.ts +30 -0
  4. package/dist/android/build.d.ts.map +1 -0
  5. package/dist/android/build.js +126 -0
  6. package/dist/android/build.js.map +1 -0
  7. package/dist/android/command.d.ts +21 -0
  8. package/dist/android/command.d.ts.map +1 -0
  9. package/dist/android/command.js +355 -0
  10. package/dist/android/command.js.map +1 -0
  11. package/dist/android/deploy-step.d.ts +85 -0
  12. package/dist/android/deploy-step.d.ts.map +1 -0
  13. package/dist/android/deploy-step.js +268 -0
  14. package/dist/android/deploy-step.js.map +1 -0
  15. package/dist/android/doctor.d.ts +47 -0
  16. package/dist/android/doctor.d.ts.map +1 -0
  17. package/dist/android/doctor.js +219 -0
  18. package/dist/android/doctor.js.map +1 -0
  19. package/dist/android/exec.d.ts +42 -0
  20. package/dist/android/exec.d.ts.map +1 -0
  21. package/dist/android/exec.js +103 -0
  22. package/dist/android/exec.js.map +1 -0
  23. package/dist/android/fix-plan.d.ts +44 -0
  24. package/dist/android/fix-plan.d.ts.map +1 -0
  25. package/dist/android/fix-plan.js +86 -0
  26. package/dist/android/fix-plan.js.map +1 -0
  27. package/dist/android/git-freshness.d.ts +34 -0
  28. package/dist/android/git-freshness.d.ts.map +1 -0
  29. package/dist/android/git-freshness.js +120 -0
  30. package/dist/android/git-freshness.js.map +1 -0
  31. package/dist/android/gradle.d.ts +32 -0
  32. package/dist/android/gradle.d.ts.map +1 -0
  33. package/dist/android/gradle.js +55 -0
  34. package/dist/android/gradle.js.map +1 -0
  35. package/dist/android/identity.d.ts +27 -0
  36. package/dist/android/identity.d.ts.map +1 -0
  37. package/dist/android/identity.js +60 -0
  38. package/dist/android/identity.js.map +1 -0
  39. package/dist/android/index.d.ts +7 -0
  40. package/dist/android/index.d.ts.map +1 -0
  41. package/dist/android/index.js +8 -0
  42. package/dist/android/index.js.map +1 -0
  43. package/dist/android/installer.d.ts +28 -0
  44. package/dist/android/installer.d.ts.map +1 -0
  45. package/dist/android/installer.js +96 -0
  46. package/dist/android/installer.js.map +1 -0
  47. package/dist/android/java.d.ts +26 -0
  48. package/dist/android/java.d.ts.map +1 -0
  49. package/dist/android/java.js +65 -0
  50. package/dist/android/java.js.map +1 -0
  51. package/dist/android/keystore.d.ts +54 -0
  52. package/dist/android/keystore.d.ts.map +1 -0
  53. package/dist/android/keystore.js +159 -0
  54. package/dist/android/keystore.js.map +1 -0
  55. package/dist/android/metadata.d.ts +39 -0
  56. package/dist/android/metadata.d.ts.map +1 -0
  57. package/dist/android/metadata.js +61 -0
  58. package/dist/android/metadata.js.map +1 -0
  59. package/dist/android/operations.d.ts +42 -0
  60. package/dist/android/operations.d.ts.map +1 -0
  61. package/dist/android/operations.js +59 -0
  62. package/dist/android/operations.js.map +1 -0
  63. package/dist/android/paths.d.ts +29 -0
  64. package/dist/android/paths.d.ts.map +1 -0
  65. package/dist/android/paths.js +97 -0
  66. package/dist/android/paths.js.map +1 -0
  67. package/dist/android/publish.d.ts +37 -0
  68. package/dist/android/publish.d.ts.map +1 -0
  69. package/dist/android/publish.js +119 -0
  70. package/dist/android/publish.js.map +1 -0
  71. package/dist/android/registrations.d.ts +92 -0
  72. package/dist/android/registrations.d.ts.map +1 -0
  73. package/dist/android/registrations.js +112 -0
  74. package/dist/android/registrations.js.map +1 -0
  75. package/dist/android/release-status.d.ts +73 -0
  76. package/dist/android/release-status.d.ts.map +1 -0
  77. package/dist/android/release-status.js +161 -0
  78. package/dist/android/release-status.js.map +1 -0
  79. package/dist/android/release.d.ts +33 -0
  80. package/dist/android/release.d.ts.map +1 -0
  81. package/dist/android/release.js +59 -0
  82. package/dist/android/release.js.map +1 -0
  83. package/dist/android/screen-layout.d.ts +26 -0
  84. package/dist/android/screen-layout.d.ts.map +1 -0
  85. package/dist/android/screen-layout.js +24 -0
  86. package/dist/android/screen-layout.js.map +1 -0
  87. package/dist/android/screen-model.d.ts +56 -0
  88. package/dist/android/screen-model.d.ts.map +1 -0
  89. package/dist/android/screen-model.js +207 -0
  90. package/dist/android/screen-model.js.map +1 -0
  91. package/dist/android/screen.d.ts +8 -0
  92. package/dist/android/screen.d.ts.map +1 -0
  93. package/dist/android/screen.js +395 -0
  94. package/dist/android/screen.js.map +1 -0
  95. package/dist/android/sdk.d.ts +48 -0
  96. package/dist/android/sdk.d.ts.map +1 -0
  97. package/dist/android/sdk.js +82 -0
  98. package/dist/android/sdk.js.map +1 -0
  99. package/dist/android/server-url.d.ts +19 -0
  100. package/dist/android/server-url.d.ts.map +1 -0
  101. package/dist/android/server-url.js +36 -0
  102. package/dist/android/server-url.js.map +1 -0
  103. package/dist/android/upload-progress.d.ts +3 -0
  104. package/dist/android/upload-progress.d.ts.map +1 -0
  105. package/dist/android/upload-progress.js +47 -0
  106. package/dist/android/upload-progress.js.map +1 -0
  107. package/dist/android/version.d.ts +47 -0
  108. package/dist/android/version.d.ts.map +1 -0
  109. package/dist/android/version.js +136 -0
  110. package/dist/android/version.js.map +1 -0
  111. package/dist/api-client/index.d.ts +3 -0
  112. package/dist/api-client/index.d.ts.map +1 -0
  113. package/dist/api-client/index.js +5 -0
  114. package/dist/api-client/index.js.map +1 -0
  115. package/dist/commands/index.d.ts +52 -0
  116. package/dist/commands/index.d.ts.map +1 -0
  117. package/dist/commands/index.js +63 -0
  118. package/dist/commands/index.js.map +1 -0
  119. package/dist/core/cli-registry.d.ts +41 -0
  120. package/dist/core/cli-registry.d.ts.map +1 -0
  121. package/dist/core/cli-registry.js +49 -0
  122. package/dist/core/cli-registry.js.map +1 -0
  123. package/dist/core/command-registry.d.ts +10 -0
  124. package/dist/core/command-registry.d.ts.map +1 -1
  125. package/dist/core/command-registry.js +17 -0
  126. package/dist/core/command-registry.js.map +1 -1
  127. package/dist/core/env-annotation-registry.d.ts +58 -0
  128. package/dist/core/env-annotation-registry.d.ts.map +1 -0
  129. package/dist/core/env-annotation-registry.js +80 -0
  130. package/dist/core/env-annotation-registry.js.map +1 -0
  131. package/dist/core/env-generator-registry.d.ts +59 -0
  132. package/dist/core/env-generator-registry.d.ts.map +1 -0
  133. package/dist/core/env-generator-registry.js +102 -0
  134. package/dist/core/env-generator-registry.js.map +1 -0
  135. package/dist/core/env-group-registry.d.ts +65 -0
  136. package/dist/core/env-group-registry.d.ts.map +1 -0
  137. package/dist/core/env-group-registry.js +77 -0
  138. package/dist/core/env-group-registry.js.map +1 -0
  139. package/dist/core/env-spec-registry.d.ts +16 -2
  140. package/dist/core/env-spec-registry.d.ts.map +1 -1
  141. package/dist/core/env-spec-registry.js +15 -0
  142. package/dist/core/env-spec-registry.js.map +1 -1
  143. package/dist/core/env-values.d.ts +3 -2
  144. package/dist/core/env-values.d.ts.map +1 -1
  145. package/dist/core/env-values.js +5 -3
  146. package/dist/core/env-values.js.map +1 -1
  147. package/dist/core/index.d.ts +10 -2
  148. package/dist/core/index.d.ts.map +1 -1
  149. package/dist/core/index.js +6 -2
  150. package/dist/core/index.js.map +1 -1
  151. package/dist/deploy/index.d.ts +3 -0
  152. package/dist/deploy/index.d.ts.map +1 -0
  153. package/dist/deploy/index.js +5 -0
  154. package/dist/deploy/index.js.map +1 -0
  155. package/dist/engine/api-client.d.ts +211 -0
  156. package/dist/engine/api-client.d.ts.map +1 -0
  157. package/dist/engine/api-client.js +350 -0
  158. package/dist/engine/api-client.js.map +1 -0
  159. package/dist/engine/browser.d.ts +18 -0
  160. package/dist/engine/browser.d.ts.map +1 -0
  161. package/dist/engine/browser.js +115 -0
  162. package/dist/engine/browser.js.map +1 -0
  163. package/dist/engine/builtin-registrations.d.ts +20 -0
  164. package/dist/engine/builtin-registrations.d.ts.map +1 -0
  165. package/dist/engine/builtin-registrations.js +86 -0
  166. package/dist/engine/builtin-registrations.js.map +1 -0
  167. package/dist/engine/commands/api.d.ts +88 -0
  168. package/dist/engine/commands/api.d.ts.map +1 -0
  169. package/dist/engine/commands/api.js +398 -0
  170. package/dist/engine/commands/api.js.map +1 -0
  171. package/dist/engine/commands/config.d.ts +5 -0
  172. package/dist/engine/commands/config.d.ts.map +1 -0
  173. package/dist/engine/commands/config.js +83 -0
  174. package/dist/engine/commands/config.js.map +1 -0
  175. package/dist/engine/commands/deploy.d.ts +250 -0
  176. package/dist/engine/commands/deploy.d.ts.map +1 -0
  177. package/dist/engine/commands/deploy.js +1186 -0
  178. package/dist/engine/commands/deploy.js.map +1 -0
  179. package/dist/engine/commands/init.d.ts +18 -0
  180. package/dist/engine/commands/init.d.ts.map +1 -0
  181. package/dist/engine/commands/init.js +50 -0
  182. package/dist/engine/commands/init.js.map +1 -0
  183. package/dist/engine/commands/login.d.ts +4 -0
  184. package/dist/engine/commands/login.d.ts.map +1 -0
  185. package/dist/engine/commands/login.js +205 -0
  186. package/dist/engine/commands/login.js.map +1 -0
  187. package/dist/engine/commands/node.d.ts +21 -0
  188. package/dist/engine/commands/node.d.ts.map +1 -0
  189. package/dist/engine/commands/node.js +503 -0
  190. package/dist/engine/commands/node.js.map +1 -0
  191. package/dist/engine/config.d.ts +284 -0
  192. package/dist/engine/config.d.ts.map +1 -0
  193. package/dist/engine/config.js +469 -0
  194. package/dist/engine/config.js.map +1 -0
  195. package/dist/engine/conformance.d.ts +193 -0
  196. package/dist/engine/conformance.d.ts.map +1 -0
  197. package/dist/engine/conformance.js +243 -0
  198. package/dist/engine/conformance.js.map +1 -0
  199. package/dist/engine/create-cli.d.ts +181 -0
  200. package/dist/engine/create-cli.d.ts.map +1 -0
  201. package/dist/engine/create-cli.js +91 -0
  202. package/dist/engine/create-cli.js.map +1 -0
  203. package/dist/engine/deploy/about.d.ts +12 -0
  204. package/dist/engine/deploy/about.d.ts.map +1 -0
  205. package/dist/engine/deploy/about.js +110 -0
  206. package/dist/engine/deploy/about.js.map +1 -0
  207. package/dist/engine/deploy/adopt.d.ts +21 -0
  208. package/dist/engine/deploy/adopt.d.ts.map +1 -0
  209. package/dist/engine/deploy/adopt.js +78 -0
  210. package/dist/engine/deploy/adopt.js.map +1 -0
  211. package/dist/engine/deploy/answers-file.d.ts +7 -0
  212. package/dist/engine/deploy/answers-file.d.ts.map +1 -0
  213. package/dist/engine/deploy/answers-file.js +49 -0
  214. package/dist/engine/deploy/answers-file.js.map +1 -0
  215. package/dist/engine/deploy/app-role.d.ts +278 -0
  216. package/dist/engine/deploy/app-role.d.ts.map +1 -0
  217. package/dist/engine/deploy/app-role.js +826 -0
  218. package/dist/engine/deploy/app-role.js.map +1 -0
  219. package/dist/engine/deploy/app-version.d.ts +103 -0
  220. package/dist/engine/deploy/app-version.d.ts.map +1 -0
  221. package/dist/engine/deploy/app-version.js +344 -0
  222. package/dist/engine/deploy/app-version.js.map +1 -0
  223. package/dist/engine/deploy/checks/compose.d.ts +16 -0
  224. package/dist/engine/deploy/checks/compose.d.ts.map +1 -0
  225. package/dist/engine/deploy/checks/compose.js +149 -0
  226. package/dist/engine/deploy/checks/compose.js.map +1 -0
  227. package/dist/engine/deploy/checks/database.d.ts +83 -0
  228. package/dist/engine/deploy/checks/database.d.ts.map +1 -0
  229. package/dist/engine/deploy/checks/database.js +455 -0
  230. package/dist/engine/deploy/checks/database.js.map +1 -0
  231. package/dist/engine/deploy/checks/dns.d.ts +3 -0
  232. package/dist/engine/deploy/checks/dns.d.ts.map +1 -0
  233. package/dist/engine/deploy/checks/dns.js +85 -0
  234. package/dist/engine/deploy/checks/dns.js.map +1 -0
  235. package/dist/engine/deploy/checks/host.d.ts +19 -0
  236. package/dist/engine/deploy/checks/host.d.ts.map +1 -0
  237. package/dist/engine/deploy/checks/host.js +543 -0
  238. package/dist/engine/deploy/checks/host.js.map +1 -0
  239. package/dist/engine/deploy/checks/index.d.ts +35 -0
  240. package/dist/engine/deploy/checks/index.d.ts.map +1 -0
  241. package/dist/engine/deploy/checks/index.js +75 -0
  242. package/dist/engine/deploy/checks/index.js.map +1 -0
  243. package/dist/engine/deploy/checks/registry.d.ts +110 -0
  244. package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
  245. package/dist/engine/deploy/checks/registry.js +104 -0
  246. package/dist/engine/deploy/checks/registry.js.map +1 -0
  247. package/dist/engine/deploy/checks/source.d.ts +45 -0
  248. package/dist/engine/deploy/checks/source.d.ts.map +1 -0
  249. package/dist/engine/deploy/checks/source.js +175 -0
  250. package/dist/engine/deploy/checks/source.js.map +1 -0
  251. package/dist/engine/deploy/checks/stack-ports.d.ts +4 -0
  252. package/dist/engine/deploy/checks/stack-ports.d.ts.map +1 -0
  253. package/dist/engine/deploy/checks/stack-ports.js +261 -0
  254. package/dist/engine/deploy/checks/stack-ports.js.map +1 -0
  255. package/dist/engine/deploy/checks/tls.d.ts +87 -0
  256. package/dist/engine/deploy/checks/tls.d.ts.map +1 -0
  257. package/dist/engine/deploy/checks/tls.js +552 -0
  258. package/dist/engine/deploy/checks/tls.js.map +1 -0
  259. package/dist/engine/deploy/checks/types.d.ts +202 -0
  260. package/dist/engine/deploy/checks/types.d.ts.map +1 -0
  261. package/dist/engine/deploy/checks/types.js +199 -0
  262. package/dist/engine/deploy/checks/types.js.map +1 -0
  263. package/dist/engine/deploy/compose-command.d.ts +16 -0
  264. package/dist/engine/deploy/compose-command.d.ts.map +1 -0
  265. package/dist/engine/deploy/compose-command.js +40 -0
  266. package/dist/engine/deploy/compose-command.js.map +1 -0
  267. package/dist/engine/deploy/compose-containers.d.ts +101 -0
  268. package/dist/engine/deploy/compose-containers.d.ts.map +1 -0
  269. package/dist/engine/deploy/compose-containers.js +191 -0
  270. package/dist/engine/deploy/compose-containers.js.map +1 -0
  271. package/dist/engine/deploy/compose-files.d.ts +29 -0
  272. package/dist/engine/deploy/compose-files.d.ts.map +1 -0
  273. package/dist/engine/deploy/compose-files.js +118 -0
  274. package/dist/engine/deploy/compose-files.js.map +1 -0
  275. package/dist/engine/deploy/compose-hints.d.ts +11 -0
  276. package/dist/engine/deploy/compose-hints.d.ts.map +1 -0
  277. package/dist/engine/deploy/compose-hints.js +70 -0
  278. package/dist/engine/deploy/compose-hints.js.map +1 -0
  279. package/dist/engine/deploy/compose-port-variables.d.ts +58 -0
  280. package/dist/engine/deploy/compose-port-variables.d.ts.map +1 -0
  281. package/dist/engine/deploy/compose-port-variables.js +184 -0
  282. package/dist/engine/deploy/compose-port-variables.js.map +1 -0
  283. package/dist/engine/deploy/compose-ports.d.ts +98 -0
  284. package/dist/engine/deploy/compose-ports.d.ts.map +1 -0
  285. package/dist/engine/deploy/compose-ports.js +204 -0
  286. package/dist/engine/deploy/compose-ports.js.map +1 -0
  287. package/dist/engine/deploy/compose-project.d.ts +113 -0
  288. package/dist/engine/deploy/compose-project.d.ts.map +1 -0
  289. package/dist/engine/deploy/compose-project.js +177 -0
  290. package/dist/engine/deploy/compose-project.js.map +1 -0
  291. package/dist/engine/deploy/consent.d.ts +29 -0
  292. package/dist/engine/deploy/consent.d.ts.map +1 -0
  293. package/dist/engine/deploy/consent.js +35 -0
  294. package/dist/engine/deploy/consent.js.map +1 -0
  295. package/dist/engine/deploy/database-drop.d.ts +22 -0
  296. package/dist/engine/deploy/database-drop.d.ts.map +1 -0
  297. package/dist/engine/deploy/database-drop.js +135 -0
  298. package/dist/engine/deploy/database-drop.js.map +1 -0
  299. package/dist/engine/deploy/database.d.ts +116 -0
  300. package/dist/engine/deploy/database.d.ts.map +1 -0
  301. package/dist/engine/deploy/database.js +252 -0
  302. package/dist/engine/deploy/database.js.map +1 -0
  303. package/dist/engine/deploy/deploy-info.d.ts +48 -0
  304. package/dist/engine/deploy/deploy-info.d.ts.map +1 -0
  305. package/dist/engine/deploy/deploy-info.js +163 -0
  306. package/dist/engine/deploy/deploy-info.js.map +1 -0
  307. package/dist/engine/deploy/deployment-evidence.d.ts +38 -0
  308. package/dist/engine/deploy/deployment-evidence.d.ts.map +1 -0
  309. package/dist/engine/deploy/deployment-evidence.js +92 -0
  310. package/dist/engine/deploy/deployment-evidence.js.map +1 -0
  311. package/dist/engine/deploy/edge-config.d.ts +103 -0
  312. package/dist/engine/deploy/edge-config.d.ts.map +1 -0
  313. package/dist/engine/deploy/edge-config.js +170 -0
  314. package/dist/engine/deploy/edge-config.js.map +1 -0
  315. package/dist/engine/deploy/env-absence.d.ts +61 -0
  316. package/dist/engine/deploy/env-absence.d.ts.map +1 -0
  317. package/dist/engine/deploy/env-absence.js +33 -0
  318. package/dist/engine/deploy/env-absence.js.map +1 -0
  319. package/dist/engine/deploy/env-file.d.ts +14 -0
  320. package/dist/engine/deploy/env-file.d.ts.map +1 -0
  321. package/dist/engine/deploy/env-file.js +58 -0
  322. package/dist/engine/deploy/env-file.js.map +1 -0
  323. package/dist/engine/deploy/env-fragments.d.ts +29 -0
  324. package/dist/engine/deploy/env-fragments.d.ts.map +1 -0
  325. package/dist/engine/deploy/env-fragments.js +73 -0
  326. package/dist/engine/deploy/env-fragments.js.map +1 -0
  327. package/dist/engine/deploy/env-metadata.d.ts +73 -0
  328. package/dist/engine/deploy/env-metadata.d.ts.map +1 -0
  329. package/dist/engine/deploy/env-metadata.js +227 -0
  330. package/dist/engine/deploy/env-metadata.js.map +1 -0
  331. package/dist/engine/deploy/env-spec.d.ts +75 -0
  332. package/dist/engine/deploy/env-spec.d.ts.map +1 -0
  333. package/dist/engine/deploy/env-spec.js +239 -0
  334. package/dist/engine/deploy/env-spec.js.map +1 -0
  335. package/dist/engine/deploy/env-wizard.d.ts +56 -0
  336. package/dist/engine/deploy/env-wizard.d.ts.map +1 -0
  337. package/dist/engine/deploy/env-wizard.js +235 -0
  338. package/dist/engine/deploy/env-wizard.js.map +1 -0
  339. package/dist/engine/deploy/executor.d.ts +81 -0
  340. package/dist/engine/deploy/executor.d.ts.map +1 -0
  341. package/dist/engine/deploy/executor.js +247 -0
  342. package/dist/engine/deploy/executor.js.map +1 -0
  343. package/dist/engine/deploy/free-ports.d.ts +145 -0
  344. package/dist/engine/deploy/free-ports.d.ts.map +1 -0
  345. package/dist/engine/deploy/free-ports.js +235 -0
  346. package/dist/engine/deploy/free-ports.js.map +1 -0
  347. package/dist/engine/deploy/health.d.ts +153 -0
  348. package/dist/engine/deploy/health.d.ts.map +1 -0
  349. package/dist/engine/deploy/health.js +335 -0
  350. package/dist/engine/deploy/health.js.map +1 -0
  351. package/dist/engine/deploy/hooks.d.ts +66 -0
  352. package/dist/engine/deploy/hooks.d.ts.map +1 -0
  353. package/dist/engine/deploy/hooks.js +19 -0
  354. package/dist/engine/deploy/hooks.js.map +1 -0
  355. package/dist/engine/deploy/host-facts.d.ts +23 -0
  356. package/dist/engine/deploy/host-facts.d.ts.map +1 -0
  357. package/dist/engine/deploy/host-facts.js +67 -0
  358. package/dist/engine/deploy/host-facts.js.map +1 -0
  359. package/dist/engine/deploy/install.d.ts +239 -0
  360. package/dist/engine/deploy/install.d.ts.map +1 -0
  361. package/dist/engine/deploy/install.js +1474 -0
  362. package/dist/engine/deploy/install.js.map +1 -0
  363. package/dist/engine/deploy/inventory.d.ts +30 -0
  364. package/dist/engine/deploy/inventory.d.ts.map +1 -0
  365. package/dist/engine/deploy/inventory.js +122 -0
  366. package/dist/engine/deploy/inventory.js.map +1 -0
  367. package/dist/engine/deploy/journal.d.ts +77 -0
  368. package/dist/engine/deploy/journal.d.ts.map +1 -0
  369. package/dist/engine/deploy/journal.js +221 -0
  370. package/dist/engine/deploy/journal.js.map +1 -0
  371. package/dist/engine/deploy/layout.d.ts +77 -0
  372. package/dist/engine/deploy/layout.d.ts.map +1 -0
  373. package/dist/engine/deploy/layout.js +191 -0
  374. package/dist/engine/deploy/layout.js.map +1 -0
  375. package/dist/engine/deploy/oauth-check.d.ts +58 -0
  376. package/dist/engine/deploy/oauth-check.d.ts.map +1 -0
  377. package/dist/engine/deploy/oauth-check.js +213 -0
  378. package/dist/engine/deploy/oauth-check.js.map +1 -0
  379. package/dist/engine/deploy/proxy-bootstrap.d.ts +149 -0
  380. package/dist/engine/deploy/proxy-bootstrap.d.ts.map +1 -0
  381. package/dist/engine/deploy/proxy-bootstrap.js +416 -0
  382. package/dist/engine/deploy/proxy-bootstrap.js.map +1 -0
  383. package/dist/engine/deploy/proxy-streams.d.ts +110 -0
  384. package/dist/engine/deploy/proxy-streams.d.ts.map +1 -0
  385. package/dist/engine/deploy/proxy-streams.js +208 -0
  386. package/dist/engine/deploy/proxy-streams.js.map +1 -0
  387. package/dist/engine/deploy/proxy.d.ts +375 -0
  388. package/dist/engine/deploy/proxy.d.ts.map +1 -0
  389. package/dist/engine/deploy/proxy.js +758 -0
  390. package/dist/engine/deploy/proxy.js.map +1 -0
  391. package/dist/engine/deploy/renewal.d.ts +54 -0
  392. package/dist/engine/deploy/renewal.d.ts.map +1 -0
  393. package/dist/engine/deploy/renewal.js +169 -0
  394. package/dist/engine/deploy/renewal.js.map +1 -0
  395. package/dist/engine/deploy/repo.d.ts +119 -0
  396. package/dist/engine/deploy/repo.d.ts.map +1 -0
  397. package/dist/engine/deploy/repo.js +282 -0
  398. package/dist/engine/deploy/repo.js.map +1 -0
  399. package/dist/engine/deploy/run-record.d.ts +28 -0
  400. package/dist/engine/deploy/run-record.d.ts.map +1 -0
  401. package/dist/engine/deploy/run-record.js +44 -0
  402. package/dist/engine/deploy/run-record.js.map +1 -0
  403. package/dist/engine/deploy/stack-ports-gate.d.ts +19 -0
  404. package/dist/engine/deploy/stack-ports-gate.d.ts.map +1 -0
  405. package/dist/engine/deploy/stack-ports-gate.js +54 -0
  406. package/dist/engine/deploy/stack-ports-gate.js.map +1 -0
  407. package/dist/engine/deploy/state.d.ts +289 -0
  408. package/dist/engine/deploy/state.d.ts.map +1 -0
  409. package/dist/engine/deploy/state.js +163 -0
  410. package/dist/engine/deploy/state.js.map +1 -0
  411. package/dist/engine/deploy/steps/app-step-context.d.ts +24 -0
  412. package/dist/engine/deploy/steps/app-step-context.d.ts.map +1 -0
  413. package/dist/engine/deploy/steps/app-step-context.js +45 -0
  414. package/dist/engine/deploy/steps/app-step-context.js.map +1 -0
  415. package/dist/engine/deploy/steps/pipeline.d.ts +46 -0
  416. package/dist/engine/deploy/steps/pipeline.d.ts.map +1 -0
  417. package/dist/engine/deploy/steps/pipeline.js +73 -0
  418. package/dist/engine/deploy/steps/pipeline.js.map +1 -0
  419. package/dist/engine/deploy/steps/plan.d.ts +28 -0
  420. package/dist/engine/deploy/steps/plan.d.ts.map +1 -0
  421. package/dist/engine/deploy/steps/plan.js +32 -0
  422. package/dist/engine/deploy/steps/plan.js.map +1 -0
  423. package/dist/engine/deploy/steps/registry.d.ts +182 -0
  424. package/dist/engine/deploy/steps/registry.d.ts.map +1 -0
  425. package/dist/engine/deploy/steps/registry.js +214 -0
  426. package/dist/engine/deploy/steps/registry.js.map +1 -0
  427. package/dist/engine/deploy/steps/step-values.d.ts +28 -0
  428. package/dist/engine/deploy/steps/step-values.d.ts.map +1 -0
  429. package/dist/engine/deploy/steps/step-values.js +33 -0
  430. package/dist/engine/deploy/steps/step-values.js.map +1 -0
  431. package/dist/engine/deploy/testing/fake-containers.d.ts +29 -0
  432. package/dist/engine/deploy/testing/fake-containers.d.ts.map +1 -0
  433. package/dist/engine/deploy/testing/fake-containers.js +32 -0
  434. package/dist/engine/deploy/testing/fake-containers.js.map +1 -0
  435. package/dist/engine/deploy/testing/fake-postgres.d.ts +88 -0
  436. package/dist/engine/deploy/testing/fake-postgres.d.ts.map +1 -0
  437. package/dist/engine/deploy/testing/fake-postgres.js +236 -0
  438. package/dist/engine/deploy/testing/fake-postgres.js.map +1 -0
  439. package/dist/engine/deploy/testing/fake-vps.d.ts +147 -0
  440. package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -0
  441. package/dist/engine/deploy/testing/fake-vps.js +371 -0
  442. package/dist/engine/deploy/testing/fake-vps.js.map +1 -0
  443. package/dist/engine/deploy/uninstall.d.ts +87 -0
  444. package/dist/engine/deploy/uninstall.d.ts.map +1 -0
  445. package/dist/engine/deploy/uninstall.js +321 -0
  446. package/dist/engine/deploy/uninstall.js.map +1 -0
  447. package/dist/engine/deploy/update.d.ts +114 -0
  448. package/dist/engine/deploy/update.d.ts.map +1 -0
  449. package/dist/engine/deploy/update.js +1385 -0
  450. package/dist/engine/deploy/update.js.map +1 -0
  451. package/dist/engine/deploy/version-step.d.ts +74 -0
  452. package/dist/engine/deploy/version-step.d.ts.map +1 -0
  453. package/dist/engine/deploy/version-step.js +177 -0
  454. package/dist/engine/deploy/version-step.js.map +1 -0
  455. package/dist/engine/device-auth.d.ts +240 -0
  456. package/dist/engine/device-auth.d.ts.map +1 -0
  457. package/dist/engine/device-auth.js +442 -0
  458. package/dist/engine/device-auth.js.map +1 -0
  459. package/dist/engine/device-login.d.ts +126 -0
  460. package/dist/engine/device-login.d.ts.map +1 -0
  461. package/dist/engine/device-login.js +164 -0
  462. package/dist/engine/device-login.js.map +1 -0
  463. package/dist/engine/errors.d.ts +314 -0
  464. package/dist/engine/errors.d.ts.map +1 -0
  465. package/dist/engine/errors.js +561 -0
  466. package/dist/engine/errors.js.map +1 -0
  467. package/dist/engine/github-raw-manifest.d.ts +59 -0
  468. package/dist/engine/github-raw-manifest.d.ts.map +1 -0
  469. package/dist/engine/github-raw-manifest.js +197 -0
  470. package/dist/engine/github-raw-manifest.js.map +1 -0
  471. package/dist/engine/identity.d.ts +169 -0
  472. package/dist/engine/identity.d.ts.map +1 -0
  473. package/dist/engine/identity.js +227 -0
  474. package/dist/engine/identity.js.map +1 -0
  475. package/dist/engine/index.d.ts +141 -0
  476. package/dist/engine/index.d.ts.map +1 -0
  477. package/dist/engine/index.js +147 -0
  478. package/dist/engine/index.js.map +1 -0
  479. package/dist/engine/init/local-profile.d.ts +93 -0
  480. package/dist/engine/init/local-profile.d.ts.map +1 -0
  481. package/dist/engine/init/local-profile.js +295 -0
  482. package/dist/engine/init/local-profile.js.map +1 -0
  483. package/dist/engine/init/run-init.d.ts +41 -0
  484. package/dist/engine/init/run-init.d.ts.map +1 -0
  485. package/dist/engine/init/run-init.js +297 -0
  486. package/dist/engine/init/run-init.js.map +1 -0
  487. package/dist/engine/node/capabilities.d.ts +433 -0
  488. package/dist/engine/node/capabilities.d.ts.map +1 -0
  489. package/dist/engine/node/capabilities.js +597 -0
  490. package/dist/engine/node/capabilities.js.map +1 -0
  491. package/dist/engine/node/daemon-channels.d.ts +66 -0
  492. package/dist/engine/node/daemon-channels.d.ts.map +1 -0
  493. package/dist/engine/node/daemon-channels.js +65 -0
  494. package/dist/engine/node/daemon-channels.js.map +1 -0
  495. package/dist/engine/node/daemon.d.ts +63 -0
  496. package/dist/engine/node/daemon.d.ts.map +1 -0
  497. package/dist/engine/node/daemon.js +279 -0
  498. package/dist/engine/node/daemon.js.map +1 -0
  499. package/dist/engine/node/doctor.d.ts +60 -0
  500. package/dist/engine/node/doctor.d.ts.map +1 -0
  501. package/dist/engine/node/doctor.js +447 -0
  502. package/dist/engine/node/doctor.js.map +1 -0
  503. package/dist/engine/node/enrollment.d.ts +98 -0
  504. package/dist/engine/node/enrollment.d.ts.map +1 -0
  505. package/dist/engine/node/enrollment.js +189 -0
  506. package/dist/engine/node/enrollment.js.map +1 -0
  507. package/dist/engine/node/env-flags.d.ts +5 -0
  508. package/dist/engine/node/env-flags.d.ts.map +1 -0
  509. package/dist/engine/node/env-flags.js +22 -0
  510. package/dist/engine/node/env-flags.js.map +1 -0
  511. package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
  512. package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
  513. package/dist/engine/node/executors/credential-hygiene.js +210 -0
  514. package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
  515. package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
  516. package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
  517. package/dist/engine/node/executors/db-backup-run.js +362 -0
  518. package/dist/engine/node/executors/db-backup-run.js.map +1 -0
  519. package/dist/engine/node/executors/example-checksum.d.ts +30 -0
  520. package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
  521. package/dist/engine/node/executors/example-checksum.js +56 -0
  522. package/dist/engine/node/executors/example-checksum.js.map +1 -0
  523. package/dist/engine/node/executors/index.d.ts +213 -0
  524. package/dist/engine/node/executors/index.d.ts.map +1 -0
  525. package/dist/engine/node/executors/index.js +58 -0
  526. package/dist/engine/node/executors/index.js.map +1 -0
  527. package/dist/engine/node/executors/registry.d.ts +38 -0
  528. package/dist/engine/node/executors/registry.d.ts.map +1 -0
  529. package/dist/engine/node/executors/registry.js +103 -0
  530. package/dist/engine/node/executors/registry.js.map +1 -0
  531. package/dist/engine/node/heap-snapshot.d.ts +37 -0
  532. package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
  533. package/dist/engine/node/heap-snapshot.js +160 -0
  534. package/dist/engine/node/heap-snapshot.js.map +1 -0
  535. package/dist/engine/node/host-telemetry.d.ts +38 -0
  536. package/dist/engine/node/host-telemetry.d.ts.map +1 -0
  537. package/dist/engine/node/host-telemetry.js +39 -0
  538. package/dist/engine/node/host-telemetry.js.map +1 -0
  539. package/dist/engine/node/host-vitals.d.ts +51 -0
  540. package/dist/engine/node/host-vitals.d.ts.map +1 -0
  541. package/dist/engine/node/host-vitals.js +117 -0
  542. package/dist/engine/node/host-vitals.js.map +1 -0
  543. package/dist/engine/node/install-deps.d.ts +231 -0
  544. package/dist/engine/node/install-deps.d.ts.map +1 -0
  545. package/dist/engine/node/install-deps.js +392 -0
  546. package/dist/engine/node/install-deps.js.map +1 -0
  547. package/dist/engine/node/ipc-protocol.d.ts +114 -0
  548. package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
  549. package/dist/engine/node/ipc-protocol.js +122 -0
  550. package/dist/engine/node/ipc-protocol.js.map +1 -0
  551. package/dist/engine/node/lifecycle.d.ts +103 -0
  552. package/dist/engine/node/lifecycle.d.ts.map +1 -0
  553. package/dist/engine/node/lifecycle.js +260 -0
  554. package/dist/engine/node/lifecycle.js.map +1 -0
  555. package/dist/engine/node/logger.d.ts +95 -0
  556. package/dist/engine/node/logger.d.ts.map +1 -0
  557. package/dist/engine/node/logger.js +241 -0
  558. package/dist/engine/node/logger.js.map +1 -0
  559. package/dist/engine/node/memory-watchdog.d.ts +89 -0
  560. package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
  561. package/dist/engine/node/memory-watchdog.js +248 -0
  562. package/dist/engine/node/memory-watchdog.js.map +1 -0
  563. package/dist/engine/node/models.d.ts +195 -0
  564. package/dist/engine/node/models.d.ts.map +1 -0
  565. package/dist/engine/node/models.js +379 -0
  566. package/dist/engine/node/models.js.map +1 -0
  567. package/dist/engine/node/node-api.d.ts +439 -0
  568. package/dist/engine/node/node-api.d.ts.map +1 -0
  569. package/dist/engine/node/node-api.js +125 -0
  570. package/dist/engine/node/node-api.js.map +1 -0
  571. package/dist/engine/node/node-config.d.ts +128 -0
  572. package/dist/engine/node/node-config.d.ts.map +1 -0
  573. package/dist/engine/node/node-config.js +237 -0
  574. package/dist/engine/node/node-config.js.map +1 -0
  575. package/dist/engine/node/node-dashboard-source.d.ts +83 -0
  576. package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
  577. package/dist/engine/node/node-dashboard-source.js +181 -0
  578. package/dist/engine/node/node-dashboard-source.js.map +1 -0
  579. package/dist/engine/node/node-engine.d.ts +282 -0
  580. package/dist/engine/node/node-engine.d.ts.map +1 -0
  581. package/dist/engine/node/node-engine.js +925 -0
  582. package/dist/engine/node/node-engine.js.map +1 -0
  583. package/dist/engine/node/node-errors.d.ts +54 -0
  584. package/dist/engine/node/node-errors.d.ts.map +1 -0
  585. package/dist/engine/node/node-errors.js +71 -0
  586. package/dist/engine/node/node-errors.js.map +1 -0
  587. package/dist/engine/node/node-events-queue.d.ts +27 -0
  588. package/dist/engine/node/node-events-queue.d.ts.map +1 -0
  589. package/dist/engine/node/node-events-queue.js +46 -0
  590. package/dist/engine/node/node-events-queue.js.map +1 -0
  591. package/dist/engine/node/node-events.d.ts +132 -0
  592. package/dist/engine/node/node-events.d.ts.map +1 -0
  593. package/dist/engine/node/node-events.js +2 -0
  594. package/dist/engine/node/node-events.js.map +1 -0
  595. package/dist/engine/node/node-vitals.d.ts +123 -0
  596. package/dist/engine/node/node-vitals.d.ts.map +1 -0
  597. package/dist/engine/node/node-vitals.js +266 -0
  598. package/dist/engine/node/node-vitals.js.map +1 -0
  599. package/dist/engine/node/paths.d.ts +39 -0
  600. package/dist/engine/node/paths.d.ts.map +1 -0
  601. package/dist/engine/node/paths.js +60 -0
  602. package/dist/engine/node/paths.js.map +1 -0
  603. package/dist/engine/node/pg-dump.d.ts +126 -0
  604. package/dist/engine/node/pg-dump.d.ts.map +1 -0
  605. package/dist/engine/node/pg-dump.js +223 -0
  606. package/dist/engine/node/pg-dump.js.map +1 -0
  607. package/dist/engine/node/pidfile.d.ts +38 -0
  608. package/dist/engine/node/pidfile.d.ts.map +1 -0
  609. package/dist/engine/node/pidfile.js +156 -0
  610. package/dist/engine/node/pidfile.js.map +1 -0
  611. package/dist/engine/node/power-probe.d.ts +59 -0
  612. package/dist/engine/node/power-probe.d.ts.map +1 -0
  613. package/dist/engine/node/power-probe.js +240 -0
  614. package/dist/engine/node/power-probe.js.map +1 -0
  615. package/dist/engine/node/power-watcher.d.ts +30 -0
  616. package/dist/engine/node/power-watcher.d.ts.map +1 -0
  617. package/dist/engine/node/power-watcher.js +116 -0
  618. package/dist/engine/node/power-watcher.js.map +1 -0
  619. package/dist/engine/node/runtime-state.d.ts +24 -0
  620. package/dist/engine/node/runtime-state.d.ts.map +1 -0
  621. package/dist/engine/node/runtime-state.js +19 -0
  622. package/dist/engine/node/runtime-state.js.map +1 -0
  623. package/dist/engine/node/runtime-tuning.d.ts +174 -0
  624. package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
  625. package/dist/engine/node/runtime-tuning.js +327 -0
  626. package/dist/engine/node/runtime-tuning.js.map +1 -0
  627. package/dist/engine/node/service.d.ts +39 -0
  628. package/dist/engine/node/service.d.ts.map +1 -0
  629. package/dist/engine/node/service.js +215 -0
  630. package/dist/engine/node/service.js.map +1 -0
  631. package/dist/engine/node/start.d.ts +69 -0
  632. package/dist/engine/node/start.d.ts.map +1 -0
  633. package/dist/engine/node/start.js +325 -0
  634. package/dist/engine/node/start.js.map +1 -0
  635. package/dist/engine/node/worker-env-aliases.d.ts +39 -0
  636. package/dist/engine/node/worker-env-aliases.d.ts.map +1 -0
  637. package/dist/engine/node/worker-env-aliases.js +126 -0
  638. package/dist/engine/node/worker-env-aliases.js.map +1 -0
  639. package/dist/engine/node/worker-env-table.d.ts +15 -0
  640. package/dist/engine/node/worker-env-table.d.ts.map +1 -0
  641. package/dist/engine/node/worker-env-table.js +100 -0
  642. package/dist/engine/node/worker-env-table.js.map +1 -0
  643. package/dist/engine/node/worker-env.d.ts +67 -0
  644. package/dist/engine/node/worker-env.d.ts.map +1 -0
  645. package/dist/engine/node/worker-env.js +114 -0
  646. package/dist/engine/node/worker-env.js.map +1 -0
  647. package/dist/engine/output.d.ts +97 -0
  648. package/dist/engine/output.d.ts.map +1 -0
  649. package/dist/engine/output.js +274 -0
  650. package/dist/engine/output.js.map +1 -0
  651. package/dist/engine/package-info.d.ts +7 -0
  652. package/dist/engine/package-info.d.ts.map +1 -0
  653. package/dist/engine/package-info.js +38 -0
  654. package/dist/engine/package-info.js.map +1 -0
  655. package/dist/engine/program.d.ts +53 -0
  656. package/dist/engine/program.d.ts.map +1 -0
  657. package/dist/engine/program.js +213 -0
  658. package/dist/engine/program.js.map +1 -0
  659. package/dist/engine/prompt.d.ts +69 -0
  660. package/dist/engine/prompt.d.ts.map +1 -0
  661. package/dist/engine/prompt.js +205 -0
  662. package/dist/engine/prompt.js.map +1 -0
  663. package/dist/engine/registries.d.ts +5 -0
  664. package/dist/engine/registries.d.ts.map +1 -0
  665. package/dist/engine/registries.js +68 -0
  666. package/dist/engine/registries.js.map +1 -0
  667. package/dist/engine/request-body.d.ts +31 -0
  668. package/dist/engine/request-body.d.ts.map +1 -0
  669. package/dist/engine/request-body.js +156 -0
  670. package/dist/engine/request-body.js.map +1 -0
  671. package/dist/engine/semver.d.ts +31 -0
  672. package/dist/engine/semver.d.ts.map +1 -0
  673. package/dist/engine/semver.js +100 -0
  674. package/dist/engine/semver.js.map +1 -0
  675. package/dist/engine/test-support.d.ts +50 -0
  676. package/dist/engine/test-support.d.ts.map +1 -0
  677. package/dist/engine/test-support.js +86 -0
  678. package/dist/engine/test-support.js.map +1 -0
  679. package/dist/engine/tui/app-registry.d.ts +103 -0
  680. package/dist/engine/tui/app-registry.d.ts.map +1 -0
  681. package/dist/engine/tui/app-registry.js +103 -0
  682. package/dist/engine/tui/app-registry.js.map +1 -0
  683. package/dist/engine/tui/app.d.ts +11 -0
  684. package/dist/engine/tui/app.d.ts.map +1 -0
  685. package/dist/engine/tui/app.js +134 -0
  686. package/dist/engine/tui/app.js.map +1 -0
  687. package/dist/engine/tui/builtin-screens.d.ts +11 -0
  688. package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
  689. package/dist/engine/tui/builtin-screens.js +69 -0
  690. package/dist/engine/tui/builtin-screens.js.map +1 -0
  691. package/dist/engine/tui/conformance.d.ts +149 -0
  692. package/dist/engine/tui/conformance.d.ts.map +1 -0
  693. package/dist/engine/tui/conformance.js +428 -0
  694. package/dist/engine/tui/conformance.js.map +1 -0
  695. package/dist/engine/tui/context.d.ts +220 -0
  696. package/dist/engine/tui/context.d.ts.map +1 -0
  697. package/dist/engine/tui/context.js +258 -0
  698. package/dist/engine/tui/context.js.map +1 -0
  699. package/dist/engine/tui/dashboard/index.d.ts +8 -0
  700. package/dist/engine/tui/dashboard/index.d.ts.map +1 -0
  701. package/dist/engine/tui/dashboard/index.js +5 -0
  702. package/dist/engine/tui/dashboard/index.js.map +1 -0
  703. package/dist/engine/tui/dashboard/jobs-insights.d.ts +145 -0
  704. package/dist/engine/tui/dashboard/jobs-insights.d.ts.map +1 -0
  705. package/dist/engine/tui/dashboard/jobs-insights.js +63 -0
  706. package/dist/engine/tui/dashboard/jobs-insights.js.map +1 -0
  707. package/dist/engine/tui/dashboard/node-embedded.d.ts +33 -0
  708. package/dist/engine/tui/dashboard/node-embedded.d.ts.map +1 -0
  709. package/dist/engine/tui/dashboard/node-embedded.js +81 -0
  710. package/dist/engine/tui/dashboard/node-embedded.js.map +1 -0
  711. package/dist/engine/tui/dashboard/source.d.ts +294 -0
  712. package/dist/engine/tui/dashboard/source.d.ts.map +1 -0
  713. package/dist/engine/tui/dashboard/source.js +397 -0
  714. package/dist/engine/tui/dashboard/source.js.map +1 -0
  715. package/dist/engine/tui/dashboard/use-dashboard.d.ts +23 -0
  716. package/dist/engine/tui/dashboard/use-dashboard.d.ts.map +1 -0
  717. package/dist/engine/tui/dashboard/use-dashboard.js +32 -0
  718. package/dist/engine/tui/dashboard/use-dashboard.js.map +1 -0
  719. package/dist/engine/tui/index.d.ts +25 -0
  720. package/dist/engine/tui/index.d.ts.map +1 -0
  721. package/dist/engine/tui/index.js +89 -0
  722. package/dist/engine/tui/index.js.map +1 -0
  723. package/dist/engine/tui/layout.d.ts +152 -0
  724. package/dist/engine/tui/layout.d.ts.map +1 -0
  725. package/dist/engine/tui/layout.js +214 -0
  726. package/dist/engine/tui/layout.js.map +1 -0
  727. package/dist/engine/tui/menu-registry.d.ts +201 -0
  728. package/dist/engine/tui/menu-registry.d.ts.map +1 -0
  729. package/dist/engine/tui/menu-registry.js +205 -0
  730. package/dist/engine/tui/menu-registry.js.map +1 -0
  731. package/dist/engine/tui/menu-tree.d.ts +198 -0
  732. package/dist/engine/tui/menu-tree.d.ts.map +1 -0
  733. package/dist/engine/tui/menu-tree.js +276 -0
  734. package/dist/engine/tui/menu-tree.js.map +1 -0
  735. package/dist/engine/tui/raw-mode.d.ts +54 -0
  736. package/dist/engine/tui/raw-mode.d.ts.map +1 -0
  737. package/dist/engine/tui/raw-mode.js +106 -0
  738. package/dist/engine/tui/raw-mode.js.map +1 -0
  739. package/dist/engine/tui/routes.d.ts +5 -0
  740. package/dist/engine/tui/routes.d.ts.map +1 -0
  741. package/dist/engine/tui/routes.js +16 -0
  742. package/dist/engine/tui/routes.js.map +1 -0
  743. package/dist/engine/tui/screen-registry.d.ts +170 -0
  744. package/dist/engine/tui/screen-registry.d.ts.map +1 -0
  745. package/dist/engine/tui/screen-registry.js +180 -0
  746. package/dist/engine/tui/screen-registry.js.map +1 -0
  747. package/dist/engine/tui/screen-sections.d.ts +9 -0
  748. package/dist/engine/tui/screen-sections.d.ts.map +1 -0
  749. package/dist/engine/tui/screen-sections.js +45 -0
  750. package/dist/engine/tui/screen-sections.js.map +1 -0
  751. package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
  752. package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
  753. package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
  754. package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
  755. package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
  756. package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
  757. package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
  758. package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
  759. package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
  760. package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
  761. package/dist/engine/tui/screens/deploy/doctor.js +163 -0
  762. package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
  763. package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
  764. package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
  765. package/dist/engine/tui/screens/deploy/fields.js +202 -0
  766. package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
  767. package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
  768. package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
  769. package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
  770. package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
  771. package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
  772. package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
  773. package/dist/engine/tui/screens/deploy/index.js +83 -0
  774. package/dist/engine/tui/screens/deploy/index.js.map +1 -0
  775. package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
  776. package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
  777. package/dist/engine/tui/screens/deploy/install-model.js +319 -0
  778. package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
  779. package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
  780. package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
  781. package/dist/engine/tui/screens/deploy/install.js +365 -0
  782. package/dist/engine/tui/screens/deploy/install.js.map +1 -0
  783. package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
  784. package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
  785. package/dist/engine/tui/screens/deploy/model.js +59 -0
  786. package/dist/engine/tui/screens/deploy/model.js.map +1 -0
  787. package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
  788. package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
  789. package/dist/engine/tui/screens/deploy/run-model.js +117 -0
  790. package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
  791. package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
  792. package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
  793. package/dist/engine/tui/screens/deploy/run.js +201 -0
  794. package/dist/engine/tui/screens/deploy/run.js.map +1 -0
  795. package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
  796. package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
  797. package/dist/engine/tui/screens/deploy/status.js +107 -0
  798. package/dist/engine/tui/screens/deploy/status.js.map +1 -0
  799. package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
  800. package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
  801. package/dist/engine/tui/screens/deploy/update.js +175 -0
  802. package/dist/engine/tui/screens/deploy/update.js.map +1 -0
  803. package/dist/engine/tui/screens/deploy.d.ts +12 -0
  804. package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
  805. package/dist/engine/tui/screens/deploy.js +23 -0
  806. package/dist/engine/tui/screens/deploy.js.map +1 -0
  807. package/dist/engine/tui/screens/invoke.d.ts +6 -0
  808. package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
  809. package/dist/engine/tui/screens/invoke.js +196 -0
  810. package/dist/engine/tui/screens/invoke.js.map +1 -0
  811. package/dist/engine/tui/screens/jobs.d.ts +12 -0
  812. package/dist/engine/tui/screens/jobs.d.ts.map +1 -0
  813. package/dist/engine/tui/screens/jobs.js +72 -0
  814. package/dist/engine/tui/screens/jobs.js.map +1 -0
  815. package/dist/engine/tui/screens/login.d.ts +6 -0
  816. package/dist/engine/tui/screens/login.d.ts.map +1 -0
  817. package/dist/engine/tui/screens/login.js +263 -0
  818. package/dist/engine/tui/screens/login.js.map +1 -0
  819. package/dist/engine/tui/screens/logout.d.ts +6 -0
  820. package/dist/engine/tui/screens/logout.d.ts.map +1 -0
  821. package/dist/engine/tui/screens/logout.js +149 -0
  822. package/dist/engine/tui/screens/logout.js.map +1 -0
  823. package/dist/engine/tui/screens/menu.d.ts +25 -0
  824. package/dist/engine/tui/screens/menu.d.ts.map +1 -0
  825. package/dist/engine/tui/screens/menu.js +124 -0
  826. package/dist/engine/tui/screens/menu.js.map +1 -0
  827. package/dist/engine/tui/screens/node.d.ts +6 -0
  828. package/dist/engine/tui/screens/node.d.ts.map +1 -0
  829. package/dist/engine/tui/screens/node.js +277 -0
  830. package/dist/engine/tui/screens/node.js.map +1 -0
  831. package/dist/engine/tui/screens/not-logged-in.d.ts +12 -0
  832. package/dist/engine/tui/screens/not-logged-in.d.ts.map +1 -0
  833. package/dist/engine/tui/screens/not-logged-in.js +14 -0
  834. package/dist/engine/tui/screens/not-logged-in.js.map +1 -0
  835. package/dist/engine/tui/screens/status.d.ts +6 -0
  836. package/dist/engine/tui/screens/status.d.ts.map +1 -0
  837. package/dist/engine/tui/screens/status.js +138 -0
  838. package/dist/engine/tui/screens/status.js.map +1 -0
  839. package/dist/engine/tui/scroll-box.d.ts +42 -0
  840. package/dist/engine/tui/scroll-box.d.ts.map +1 -0
  841. package/dist/engine/tui/scroll-box.js +62 -0
  842. package/dist/engine/tui/scroll-box.js.map +1 -0
  843. package/dist/engine/tui/section-registry.d.ts +65 -0
  844. package/dist/engine/tui/section-registry.d.ts.map +1 -0
  845. package/dist/engine/tui/section-registry.js +90 -0
  846. package/dist/engine/tui/section-registry.js.map +1 -0
  847. package/dist/engine/tui/terminal.d.ts +31 -0
  848. package/dist/engine/tui/terminal.d.ts.map +1 -0
  849. package/dist/engine/tui/terminal.js +142 -0
  850. package/dist/engine/tui/terminal.js.map +1 -0
  851. package/dist/engine/tui/testing/feeds.d.ts +58 -0
  852. package/dist/engine/tui/testing/feeds.d.ts.map +1 -0
  853. package/dist/engine/tui/testing/feeds.js +67 -0
  854. package/dist/engine/tui/testing/feeds.js.map +1 -0
  855. package/dist/engine/tui/testing/harness.d.ts +243 -0
  856. package/dist/engine/tui/testing/harness.d.ts.map +1 -0
  857. package/dist/engine/tui/testing/harness.js +332 -0
  858. package/dist/engine/tui/testing/harness.js.map +1 -0
  859. package/dist/engine/tui/theme.d.ts +179 -0
  860. package/dist/engine/tui/theme.d.ts.map +1 -0
  861. package/dist/engine/tui/theme.js +111 -0
  862. package/dist/engine/tui/theme.js.map +1 -0
  863. package/dist/engine/tui/tty.d.ts +56 -0
  864. package/dist/engine/tui/tty.d.ts.map +1 -0
  865. package/dist/engine/tui/tty.js +146 -0
  866. package/dist/engine/tui/tty.js.map +1 -0
  867. package/dist/engine/tui/ui/active-items.d.ts +40 -0
  868. package/dist/engine/tui/ui/active-items.d.ts.map +1 -0
  869. package/dist/engine/tui/ui/active-items.js +38 -0
  870. package/dist/engine/tui/ui/active-items.js.map +1 -0
  871. package/dist/engine/tui/ui/event-log.d.ts +58 -0
  872. package/dist/engine/tui/ui/event-log.d.ts.map +1 -0
  873. package/dist/engine/tui/ui/event-log.js +32 -0
  874. package/dist/engine/tui/ui/event-log.js.map +1 -0
  875. package/dist/engine/tui/ui/index.d.ts +20 -0
  876. package/dist/engine/tui/ui/index.d.ts.map +1 -0
  877. package/dist/engine/tui/ui/index.js +14 -0
  878. package/dist/engine/tui/ui/index.js.map +1 -0
  879. package/dist/engine/tui/ui/meter-legend.d.ts +26 -0
  880. package/dist/engine/tui/ui/meter-legend.d.ts.map +1 -0
  881. package/dist/engine/tui/ui/meter-legend.js +25 -0
  882. package/dist/engine/tui/ui/meter-legend.js.map +1 -0
  883. package/dist/engine/tui/ui/run-summary.d.ts +58 -0
  884. package/dist/engine/tui/ui/run-summary.d.ts.map +1 -0
  885. package/dist/engine/tui/ui/run-summary.js +29 -0
  886. package/dist/engine/tui/ui/run-summary.js.map +1 -0
  887. package/dist/engine/tui/ui/segment-meter.d.ts +72 -0
  888. package/dist/engine/tui/ui/segment-meter.d.ts.map +1 -0
  889. package/dist/engine/tui/ui/segment-meter.js +128 -0
  890. package/dist/engine/tui/ui/segment-meter.js.map +1 -0
  891. package/dist/engine/tui/ui/status-line.d.ts +42 -0
  892. package/dist/engine/tui/ui/status-line.d.ts.map +1 -0
  893. package/dist/engine/tui/ui/status-line.js +35 -0
  894. package/dist/engine/tui/ui/status-line.js.map +1 -0
  895. package/dist/engine/tui/ui/tone.d.ts +46 -0
  896. package/dist/engine/tui/ui/tone.d.ts.map +1 -0
  897. package/dist/engine/tui/ui/tone.js +48 -0
  898. package/dist/engine/tui/ui/tone.js.map +1 -0
  899. package/dist/engine/update-notice-options.d.ts +70 -0
  900. package/dist/engine/update-notice-options.d.ts.map +1 -0
  901. package/dist/engine/update-notice-options.js +79 -0
  902. package/dist/engine/update-notice-options.js.map +1 -0
  903. package/dist/engine/update-notice.d.ts +69 -0
  904. package/dist/engine/update-notice.d.ts.map +1 -0
  905. package/dist/engine/update-notice.js +204 -0
  906. package/dist/engine/update-notice.js.map +1 -0
  907. package/dist/index.d.ts +4 -5
  908. package/dist/index.d.ts.map +1 -1
  909. package/dist/index.js +5 -5
  910. package/dist/index.js.map +1 -1
  911. package/dist/node/index.d.ts +3 -0
  912. package/dist/node/index.d.ts.map +1 -0
  913. package/dist/node/index.js +5 -0
  914. package/dist/node/index.js.map +1 -0
  915. package/dist/telemetry/index.d.ts +2 -1
  916. package/dist/telemetry/index.d.ts.map +1 -1
  917. package/dist/telemetry/index.js +1 -0
  918. package/dist/telemetry/index.js.map +1 -1
  919. package/dist/telemetry/node-span-relay.d.ts +1 -1
  920. package/dist/telemetry/node-span-relay.d.ts.map +1 -1
  921. package/dist/telemetry/node-span-relay.js +39 -6
  922. package/dist/telemetry/node-span-relay.js.map +1 -1
  923. package/dist/telemetry/node-span.d.ts +39 -7
  924. package/dist/telemetry/node-span.d.ts.map +1 -1
  925. package/dist/telemetry/node-span.js +19 -1
  926. package/dist/telemetry/node-span.js.map +1 -1
  927. package/dist/testing/index.d.ts +3 -0
  928. package/dist/testing/index.d.ts.map +1 -0
  929. package/dist/testing/index.js +4 -0
  930. package/dist/testing/index.js.map +1 -0
  931. package/dist/tui/index.d.ts +3 -0
  932. package/dist/tui/index.d.ts.map +1 -0
  933. package/dist/tui/index.js +7 -0
  934. package/dist/tui/index.js.map +1 -0
  935. package/dist/tui/testing/index.d.ts +5 -0
  936. package/dist/tui/testing/index.d.ts.map +1 -0
  937. package/dist/tui/testing/index.js +12 -0
  938. package/dist/tui/testing/index.js.map +1 -0
  939. package/dist/tui/ui/index.d.ts +2 -0
  940. package/dist/tui/ui/index.d.ts.map +1 -0
  941. package/dist/tui/ui/index.js +10 -0
  942. package/dist/tui/ui/index.js.map +1 -0
  943. package/package.json +56 -5
@@ -0,0 +1,145 @@
1
+ import { type ComposeContainer } from './compose-containers.js';
2
+ /** How far above the default a search walks before giving up. */
3
+ export declare const DEFAULT_PORT_SEARCH_LIMIT = 200;
4
+ /** Where a port is published: the address and protocol a clash is judged on. */
5
+ export interface PortClaim {
6
+ /** The host address; `''` (and `0.0.0.0`, `::`) is every interface. */
7
+ hostIp: string;
8
+ /** `tcp`, `udp` or `sctp`. */
9
+ protocol: string;
10
+ }
11
+ /** Why a candidate port was passed over. */
12
+ export interface SkippedPort {
13
+ port: number;
14
+ /** `listener`: a process listens on it; `container`: a container is configured to publish it; `taken`: another variable of this run has it. */
15
+ reason: 'listener' | 'container' | 'taken';
16
+ /** The container that holds it, for `container`. A running one is preferred over a stopped one. */
17
+ holder?: string | undefined;
18
+ }
19
+ /** The port found, and the ones passed over on the way. */
20
+ export interface PortPick {
21
+ port: number;
22
+ skipped: SkippedPort[];
23
+ }
24
+ /**
25
+ * Whether `value` is an integer port number (1 to 65535).
26
+ *
27
+ * @param value - Any number.
28
+ * @returns true for a usable port.
29
+ */
30
+ export declare function isPort(value: number): boolean;
31
+ /**
32
+ * The first free host port at or above `preferred`.
33
+ *
34
+ * `options` carries:
35
+ *
36
+ * - `preferred`: where the search starts (the template default).
37
+ * - `hostIp` and `protocol`: where the port will be published.
38
+ * - `also`: more places the SAME port number is published (a variable that
39
+ * feeds a TCP and a UDP mapping); all of them must be free.
40
+ * - `taken`: ports already chosen for other variables of this run. Not
41
+ * changed; the caller adds the result.
42
+ * - `containers`: every container Docker knows, in any state. A container claims
43
+ * a port when it is configured to publish it on an address that overlaps (a
44
+ * wildcard clashes with every address) and the same protocol.
45
+ * - `probe`: says whether nothing listens on the port (true = free).
46
+ * - `limit`: how many ports to try (default 200); the search never goes above
47
+ * 65535.
48
+ * - `label`: names the variable in the error.
49
+ *
50
+ * @param options - The search, as above.
51
+ * @returns the port and the candidates passed over.
52
+ * @throws PreconditionError when `preferred` is not a port, or none is free.
53
+ */
54
+ export declare function pickFreePort(options: {
55
+ preferred: number;
56
+ hostIp: string;
57
+ protocol: string;
58
+ also?: readonly PortClaim[] | undefined;
59
+ taken?: ReadonlySet<number> | undefined;
60
+ containers: readonly ComposeContainer[];
61
+ probe: (port: number) => Promise<boolean>;
62
+ limit?: number | undefined;
63
+ label?: string | undefined;
64
+ }): Promise<PortPick>;
65
+ /**
66
+ * The sentence for a pick that did not land on the default:
67
+ * `GREPTIME_BIND_PG_PORT=14013 (14003 is held by evopath-greptimedb-1)`.
68
+ *
69
+ * @param variable - The variable the port is for.
70
+ * @param pick - What `pickFreePort` returned.
71
+ * @param preferred - The default the search started from.
72
+ * @returns the text, or `undefined` when the default was free (nothing to say).
73
+ */
74
+ export declare function describePick(variable: string, pick: PortPick, preferred: number): string | undefined;
75
+ /** A port variable decided by `planPortValues`. */
76
+ export interface PortDecision {
77
+ variable: string;
78
+ port: number;
79
+ /** The default the search started from. */
80
+ preferred: number;
81
+ /** What `describePick` says, or `undefined` when the default was free. */
82
+ message: string | undefined;
83
+ }
84
+ /**
85
+ * Decides a value for every published-port variable that needs one.
86
+ *
87
+ * The variables come from the compose files (`publishedPortVariables`), so an
88
+ * app overlay that publishes a new port is covered without a list to keep. A
89
+ * variable is decided only when it is in `eligible`, has no non-blank value in
90
+ * `given`, is not in `exclude`, and a starting point is known (the template
91
+ * default, else the compose file's). Everything else is left exactly as it is.
92
+ * Variables are decided in the order the files publish them; each choice is
93
+ * `taken` for the next, and so are the ports the `given` values already use.
94
+ *
95
+ * `options` carries:
96
+ *
97
+ * - `files`: the compose files' text, in merge order.
98
+ * - `eligible`: the keys this run may decide (the template's, or for an update
99
+ * the keys it is adding).
100
+ * - `given`: values that stay as they are, the `.env` on disk and the
101
+ * operator's answers. A key with a value here is never moved.
102
+ * - `defaults`: the template default of each key, where the search starts.
103
+ * - `exclude`: keys decided elsewhere (`APP_BIND_PORT`).
104
+ * - `taken`: ports already in use by this run.
105
+ * - `containers`: every container Docker knows, or `undefined` when Docker
106
+ * cannot be asked (probe-only).
107
+ * - `probe`: says whether nothing listens on a port (default: the loopback bind
108
+ * probe).
109
+ * - `limit`: the search bound per variable.
110
+ *
111
+ * @param options - The decision inputs, as above.
112
+ * @returns one decision per variable decided, in file order.
113
+ * @throws PreconditionError when a variable has no free port within the bound.
114
+ */
115
+ export declare function planPortValues(options: {
116
+ files: readonly string[];
117
+ eligible: ReadonlySet<string>;
118
+ given: ReadonlyMap<string, string>;
119
+ defaults: ReadonlyMap<string, string>;
120
+ exclude?: ReadonlySet<string> | undefined;
121
+ taken?: Iterable<number> | undefined;
122
+ containers: readonly ComposeContainer[] | undefined;
123
+ probe?: ((port: number) => Promise<boolean>) | undefined;
124
+ limit?: number | undefined;
125
+ }): Promise<PortDecision[]>;
126
+ /**
127
+ * The containers a pick must avoid: every one except those of the run's own
128
+ * compose project, which `up -d` recreates (the rule `stack-ports-free` applies).
129
+ *
130
+ * @param containers - What `listComposeContainers` returned, or `undefined`.
131
+ * @param project - The deployment's compose project.
132
+ * @returns the other projects' containers, or `undefined` when Docker could not be asked.
133
+ */
134
+ export declare function foreignContainers(containers: readonly ComposeContainer[] | undefined, project: string): ComposeContainer[] | undefined;
135
+ /**
136
+ * The text of the deployment's compose files, in the order compose merges them
137
+ * (the same list `up -d` uses, app overlays last). A file that cannot be read
138
+ * is an empty string: a missing checkout is the compose call's error to report.
139
+ *
140
+ * @param deployRoot - The deployment folder.
141
+ * @param groups - The deployment's groups.
142
+ * @returns one text per compose file.
143
+ */
144
+ export declare function readComposeFileTexts(deployRoot: string, groups?: readonly string[] | undefined): string[];
145
+ //# sourceMappingURL=free-ports.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"free-ports.d.ts","sourceRoot":"","sources":["../../../src/engine/deploy/free-ports.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,235 @@
1
+ import { readFileSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { PreconditionError } from '../errors.js';
4
+ import { isLoopbackPortFree } from './checks/types.js';
5
+ import { composeCwd } from './compose-command.js';
6
+ import { publishesPort } from './compose-containers.js';
7
+ import { composeFilesFor } from './compose-files.js';
8
+ import { publishedPortVariables } from './compose-port-variables.js';
9
+ // =============================================================================
10
+ // Free host ports for the variables the CLI writes (#1027)
11
+ // =============================================================================
12
+ //
13
+ // Every app the platform deploys publishes the same default host ports
14
+ // (`APP_BIND_PORT=3535`, `GREPTIME_BIND_PG_PORT=14003`), so the SECOND app on a
15
+ // server collided with the first on its telemetry port and `stack-ports-free`
16
+ // (#1024) stopped it, leaving the operator to hand-edit `.env`. When the CLI is
17
+ // about to WRITE a value for a published-port variable it now picks one that is
18
+ // actually free:
19
+ //
20
+ // - FREE means no container in ANY state is configured to publish it on an
21
+ // address that can clash (the source `stack-ports-free` uses), nothing
22
+ // listens on it (the same loopback bind probe as `bind-port-free`), and it
23
+ // is not already chosen for another variable of the same run.
24
+ // - THE SEARCH STARTS AT THE DEFAULT AND WALKS UP, bounded, so a lone app
25
+ // keeps the familiar numbers and says nothing extra.
26
+ // - AN EXISTING VALUE IS NEVER MOVED. Only a variable with no value yet gets a
27
+ // pick: an SSH tunnel or a BI tool may depend on the number, and
28
+ // `stack-ports-free` still reports a clash with the fix.
29
+ // - DOCKER UNREACHABLE (`containers` undefined) is probe-only: still picks.
30
+ //
31
+ // `stack-ports-free` stays the final guard; this module only chooses what the
32
+ // guard is then asked about. It reads Docker and probes sockets and writes
33
+ // nothing: the callers decide where a value goes.
34
+ // =============================================================================
35
+ /** How far above the default a search walks before giving up. */
36
+ export const DEFAULT_PORT_SEARCH_LIMIT = 200;
37
+ /** The highest port number. */
38
+ const MAX_PORT = 65535;
39
+ /**
40
+ * Whether `value` is an integer port number (1 to 65535).
41
+ *
42
+ * @param value - Any number.
43
+ * @returns true for a usable port.
44
+ */
45
+ export function isPort(value) {
46
+ return Number.isInteger(value) && value >= 1 && value <= MAX_PORT;
47
+ }
48
+ /** Whether the listener probe says something about this claim: it binds TCP on the loopback. */
49
+ function probeable(claim) {
50
+ return claim.protocol === 'tcp' && ['', '0.0.0.0', '::', '[::]', '127.0.0.1'].includes(claim.hostIp);
51
+ }
52
+ /**
53
+ * The first free host port at or above `preferred`.
54
+ *
55
+ * `options` carries:
56
+ *
57
+ * - `preferred`: where the search starts (the template default).
58
+ * - `hostIp` and `protocol`: where the port will be published.
59
+ * - `also`: more places the SAME port number is published (a variable that
60
+ * feeds a TCP and a UDP mapping); all of them must be free.
61
+ * - `taken`: ports already chosen for other variables of this run. Not
62
+ * changed; the caller adds the result.
63
+ * - `containers`: every container Docker knows, in any state. A container claims
64
+ * a port when it is configured to publish it on an address that overlaps (a
65
+ * wildcard clashes with every address) and the same protocol.
66
+ * - `probe`: says whether nothing listens on the port (true = free).
67
+ * - `limit`: how many ports to try (default 200); the search never goes above
68
+ * 65535.
69
+ * - `label`: names the variable in the error.
70
+ *
71
+ * @param options - The search, as above.
72
+ * @returns the port and the candidates passed over.
73
+ * @throws PreconditionError when `preferred` is not a port, or none is free.
74
+ */
75
+ export async function pickFreePort(options) {
76
+ const { preferred, taken = new Set(), containers, probe, limit = DEFAULT_PORT_SEARCH_LIMIT } = options;
77
+ const label = options.label ?? 'a host port';
78
+ const claims = [{ hostIp: options.hostIp, protocol: options.protocol }, ...(options.also ?? [])];
79
+ if (!isPort(preferred)) {
80
+ throw new PreconditionError(`Cannot pick a free port for ${label}: ${String(preferred)} is not a port number.`);
81
+ }
82
+ const last = Math.min(MAX_PORT, preferred + Math.max(1, limit) - 1);
83
+ const skipped = [];
84
+ for (let port = preferred; port <= last; port += 1) {
85
+ if (taken.has(port)) {
86
+ skipped.push({ port, reason: 'taken' });
87
+ continue;
88
+ }
89
+ const claimants = containers.filter((container) => claims.some((claim) => publishesPort(container, port, claim)));
90
+ if (claimants.length > 0) {
91
+ const holder = claimants.find((container) => container.running) ?? claimants[0];
92
+ skipped.push({ port, reason: 'container', holder: holder?.name });
93
+ continue;
94
+ }
95
+ // Probed once per port, and only where the probe is honest: it binds TCP on
96
+ // the loopback, which sees a listener on 127.0.0.1 or on every interface.
97
+ if (claims.some(probeable) && !(await probe(port))) {
98
+ skipped.push({ port, reason: 'listener' });
99
+ continue;
100
+ }
101
+ return { port, skipped };
102
+ }
103
+ throw new PreconditionError(`No free host port for ${label} from ${preferred} to ${last} (${skipped.length} tried). ` +
104
+ `Free one of them, or set ${options.label ?? 'the variable'} to a free port in the environment file by hand.`);
105
+ }
106
+ /** How many skipped candidates a message spells out. */
107
+ const MAX_PHRASES = 3;
108
+ /**
109
+ * The sentence for a pick that did not land on the default:
110
+ * `GREPTIME_BIND_PG_PORT=14013 (14003 is held by evopath-greptimedb-1)`.
111
+ *
112
+ * @param variable - The variable the port is for.
113
+ * @param pick - What `pickFreePort` returned.
114
+ * @param preferred - The default the search started from.
115
+ * @returns the text, or `undefined` when the default was free (nothing to say).
116
+ */
117
+ export function describePick(variable, pick, preferred) {
118
+ if (pick.port === preferred && pick.skipped.length === 0)
119
+ return undefined;
120
+ const phrase = (entry) => entry.reason === 'container'
121
+ ? `${entry.port} is held by ${entry.holder ?? 'another container'}`
122
+ : entry.reason === 'listener'
123
+ ? `${entry.port} has a listener`
124
+ : `${entry.port} is used by another variable of this run`;
125
+ const shown = pick.skipped.slice(0, MAX_PHRASES).map(phrase);
126
+ if (pick.skipped.length > MAX_PHRASES)
127
+ shown.push(`${pick.skipped.length - MAX_PHRASES} more in use`);
128
+ return `${variable}=${pick.port} (${shown.join(', ')})`;
129
+ }
130
+ /**
131
+ * Decides a value for every published-port variable that needs one.
132
+ *
133
+ * The variables come from the compose files (`publishedPortVariables`), so an
134
+ * app overlay that publishes a new port is covered without a list to keep. A
135
+ * variable is decided only when it is in `eligible`, has no non-blank value in
136
+ * `given`, is not in `exclude`, and a starting point is known (the template
137
+ * default, else the compose file's). Everything else is left exactly as it is.
138
+ * Variables are decided in the order the files publish them; each choice is
139
+ * `taken` for the next, and so are the ports the `given` values already use.
140
+ *
141
+ * `options` carries:
142
+ *
143
+ * - `files`: the compose files' text, in merge order.
144
+ * - `eligible`: the keys this run may decide (the template's, or for an update
145
+ * the keys it is adding).
146
+ * - `given`: values that stay as they are, the `.env` on disk and the
147
+ * operator's answers. A key with a value here is never moved.
148
+ * - `defaults`: the template default of each key, where the search starts.
149
+ * - `exclude`: keys decided elsewhere (`APP_BIND_PORT`).
150
+ * - `taken`: ports already in use by this run.
151
+ * - `containers`: every container Docker knows, or `undefined` when Docker
152
+ * cannot be asked (probe-only).
153
+ * - `probe`: says whether nothing listens on a port (default: the loopback bind
154
+ * probe).
155
+ * - `limit`: the search bound per variable.
156
+ *
157
+ * @param options - The decision inputs, as above.
158
+ * @returns one decision per variable decided, in file order.
159
+ * @throws PreconditionError when a variable has no free port within the bound.
160
+ */
161
+ export async function planPortValues(options) {
162
+ const { given, defaults, eligible, exclude = new Set() } = options;
163
+ const probe = options.probe ?? isLoopbackPortFree;
164
+ const containers = options.containers ?? [];
165
+ const variables = publishedPortVariables({ files: options.files, env: new Map([...defaults, ...given]) });
166
+ // What the run already uses: the ports it was told about, and every value
167
+ // another published-port variable keeps.
168
+ const taken = new Set(options.taken ?? []);
169
+ for (const { variable } of variables) {
170
+ const value = Number(given.get(variable));
171
+ if (given.get(variable) !== undefined && isPort(value))
172
+ taken.add(value);
173
+ }
174
+ const decisions = [];
175
+ for (const candidate of variables) {
176
+ const { variable } = candidate;
177
+ if (!eligible.has(variable) || exclude.has(variable))
178
+ continue;
179
+ if ((given.get(variable) ?? '') !== '')
180
+ continue;
181
+ const fromTemplate = Number(defaults.get(variable));
182
+ const preferred = isPort(fromTemplate) ? fromTemplate : candidate.defaultPort;
183
+ if (preferred === undefined)
184
+ continue;
185
+ const [first, ...rest] = candidate.claims;
186
+ if (first === undefined)
187
+ continue;
188
+ const pick = await pickFreePort({
189
+ preferred,
190
+ hostIp: first.hostIp,
191
+ protocol: first.protocol,
192
+ also: rest,
193
+ taken,
194
+ containers,
195
+ probe,
196
+ limit: options.limit,
197
+ label: variable,
198
+ });
199
+ taken.add(pick.port);
200
+ decisions.push({ variable, port: pick.port, preferred, message: describePick(variable, pick, preferred) });
201
+ }
202
+ return decisions;
203
+ }
204
+ /**
205
+ * The containers a pick must avoid: every one except those of the run's own
206
+ * compose project, which `up -d` recreates (the rule `stack-ports-free` applies).
207
+ *
208
+ * @param containers - What `listComposeContainers` returned, or `undefined`.
209
+ * @param project - The deployment's compose project.
210
+ * @returns the other projects' containers, or `undefined` when Docker could not be asked.
211
+ */
212
+ export function foreignContainers(containers, project) {
213
+ return containers?.filter((container) => container.project !== project);
214
+ }
215
+ /**
216
+ * The text of the deployment's compose files, in the order compose merges them
217
+ * (the same list `up -d` uses, app overlays last). A file that cannot be read
218
+ * is an empty string: a missing checkout is the compose call's error to report.
219
+ *
220
+ * @param deployRoot - The deployment folder.
221
+ * @param groups - The deployment's groups.
222
+ * @returns one text per compose file.
223
+ */
224
+ export function readComposeFileTexts(deployRoot, groups) {
225
+ const composeDir = composeCwd(deployRoot);
226
+ return composeFilesFor(groups, composeDir).map((file) => {
227
+ try {
228
+ return readFileSync(join(composeDir, file), 'utf8');
229
+ }
230
+ catch {
231
+ return '';
232
+ }
233
+ });
234
+ }
235
+ //# sourceMappingURL=free-ports.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"free-ports.js","sourceRoot":"","sources":["../../../src/engine/deploy/free-ports.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,153 @@
1
+ import type { runCommand } from './executor.js';
2
+ import type { DeployHooks } from './hooks.js';
3
+ import type { DeployState } from './state.js';
4
+ export interface ProbeResult {
5
+ ok: boolean;
6
+ status?: number | undefined;
7
+ durationMs: number;
8
+ /** Why it failed, when it did. */
9
+ error?: string | undefined;
10
+ }
11
+ export interface ContainerState {
12
+ name: string;
13
+ service: string;
14
+ state: string;
15
+ health?: string | undefined;
16
+ image: string;
17
+ }
18
+ export interface MigrationState {
19
+ applied?: number | undefined;
20
+ pending: string[];
21
+ /** Undefined when the state could not be determined at all. */
22
+ known: boolean;
23
+ }
24
+ export interface HealthReport {
25
+ containers: ContainerState[];
26
+ local: {
27
+ live: ProbeResult;
28
+ ready: ProbeResult;
29
+ frontend: ProbeResult;
30
+ };
31
+ external?: {
32
+ url: string;
33
+ probe: ProbeResult;
34
+ } | undefined;
35
+ migrations: MigrationState;
36
+ /**
37
+ * The OAuth wiring, end to end (#391). Present only when the caller asked
38
+ * for it with `oauth`; deliberately NOT part of `isHealthy`, so `status`'s
39
+ * exit code keeps meaning "is it serving" -- the verify step decides what a
40
+ * failed smoke means for a deploy.
41
+ */
42
+ oauth?: OAuthSmoke | undefined;
43
+ /**
44
+ * Why `docker compose` could not even list the containers, when it refused
45
+ * over a required variable with no value (the explanation from
46
+ * compose-hints.ts). Absent otherwise: every other compose failure still
47
+ * reads as "none reported", as before.
48
+ */
49
+ composeProblem?: string | undefined;
50
+ deployed?: Pick<DeployState, 'commitSha' | 'ref' | 'lastDeployedAt' | 'lastCommand'> | undefined;
51
+ }
52
+ export type FetchLike = typeof globalThis.fetch;
53
+ export interface HealthOptions {
54
+ runCommand: typeof runCommand;
55
+ deployRoot: string;
56
+ bindPort: number;
57
+ domain?: string | undefined;
58
+ state?: DeployState | undefined;
59
+ fetch?: FetchLike | undefined;
60
+ hooks?: DeployHooks | undefined;
61
+ timeoutMs?: number | undefined;
62
+ /**
63
+ * The Docker Compose project these containers live under.
64
+ *
65
+ * ⚠ WITHOUT THIS THE HEALTH GATE INSPECTS THE WRONG PROJECT. `install` and
66
+ * `update` pass `-p <name>` on every compose invocation, so a deployment
67
+ * installed since that landed runs under its own project -- while this
68
+ * module built its own argv and passed no `-p` at all, so `compose ps` and
69
+ * `prisma migrate status` were answered by the DIRECTORY-DERIVED default
70
+ * (`compose`). The gate then reported no containers and an unknown schema
71
+ * for a stack that was up and migrated, on exactly the deployments the
72
+ * project naming exists to keep apart.
73
+ *
74
+ * Absent means the directory-derived default, which is correct for every
75
+ * deployment installed before the naming existed -- the same rule
76
+ * `composeProjectFor` states for the state file.
77
+ */
78
+ composeProject?: string | undefined;
79
+ /**
80
+ * The Google OAuth client this deployment is configured with. When given,
81
+ * `collectHealth` also runs the OAuth smoke (`oauthSmoke`).
82
+ */
83
+ oauth?: {
84
+ clientId: string;
85
+ callbackUrl: string;
86
+ } | undefined;
87
+ /**
88
+ * The deployment's groups: they decide which compose files the stack
89
+ * was started with (compose-files.ts), and this module must name the SAME
90
+ * files, so `compose ps` and the migration probe's `compose run` describe
91
+ * the stack that is actually running rather than a base-only model of it.
92
+ * The always-on telemetry files are included whatever is passed (#567).
93
+ */
94
+ groups?: readonly string[] | undefined;
95
+ }
96
+ /** One HTTP probe, with its own timeout and a readable failure. */
97
+ export declare function probe(url: string, options: {
98
+ fetch?: FetchLike | undefined;
99
+ timeoutMs?: number | undefined;
100
+ }): Promise<ProbeResult>;
101
+ export declare function describeFetchFailure(error: unknown): string;
102
+ /** Reads `docker compose ps` as JSON. */
103
+ export declare function containerStates(options: HealthOptions): Promise<ContainerState[]>;
104
+ /**
105
+ * Asks Prisma what the schema state is.
106
+ *
107
+ * This is the check that distinguishes a genuinely ready deployment from one
108
+ * that merely answers SELECT 1.
109
+ */
110
+ export declare function migrationState(options: HealthOptions): Promise<MigrationState>;
111
+ export declare function collectHealth(options: HealthOptions): Promise<HealthReport>;
112
+ /**
113
+ * True when the deployment is serving and its schema is current.
114
+ *
115
+ * ⚠ A CONTAINER'S OWN HEALTHCHECK IS CHECKED TOO, NOT ONLY ITS `state`
116
+ * (issue #591). `greptimedb` runs a real Docker healthcheck (`curl .../health`
117
+ * with retries) precisely because a process can be `running` while its
118
+ * healthcheck fails -- crash-looping internally, wedged, or up but not yet
119
+ * answering -- and `docker compose ps`'s `State` stays "running" throughout.
120
+ * Before this, an install whose telemetry container never became healthy
121
+ * still reported success: `deploy install`'s `verify` step, `deploy status`
122
+ * and `deploy update` all read this same function. A container with no
123
+ * healthcheck at all reports no `health` field and is judged by `state`
124
+ * alone, exactly as before -- this adds a check, it never invents one.
125
+ */
126
+ export declare function isHealthy(report: HealthReport): boolean;
127
+ export interface WaitOptions extends HealthOptions {
128
+ /** Total time to wait. Matches the shell scripts this replaces. */
129
+ waitMs?: number | undefined;
130
+ intervalMs?: number | undefined;
131
+ sleep?: ((ms: number) => Promise<void>) | undefined;
132
+ }
133
+ /**
134
+ * Polls readiness until it answers or the deadline passes.
135
+ *
136
+ * Shared by install and update rather than reimplemented in each. On timeout
137
+ * it reports the LAST failure, not a bare "timed out" - the useful information
138
+ * is why it never became ready.
139
+ */
140
+ export declare function waitForHealthy(options: WaitOptions): Promise<ProbeResult>;
141
+ export interface OAuthSmoke {
142
+ status: 'pass' | 'warn' | 'fail';
143
+ detail: string;
144
+ remedy?: string | undefined;
145
+ }
146
+ export declare function oauthSmoke(options: {
147
+ base: string;
148
+ clientId: string;
149
+ callbackUrl: string;
150
+ fetch?: FetchLike | undefined;
151
+ timeoutMs?: number | undefined;
152
+ }): Promise<OAuthSmoke>;
153
+ //# sourceMappingURL=health.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/engine/deploy/health.ts"],"names":[],"mappings":"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"}