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

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 (743) hide show
  1. package/CHANGELOG.md +80 -0
  2. package/README.md +126 -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 +243 -0
  176. package/dist/engine/commands/deploy.d.ts.map +1 -0
  177. package/dist/engine/commands/deploy.js +1159 -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 +436 -0
  190. package/dist/engine/commands/node.js.map +1 -0
  191. package/dist/engine/config.d.ts +246 -0
  192. package/dist/engine/config.d.ts.map +1 -0
  193. package/dist/engine/config.js +414 -0
  194. package/dist/engine/config.js.map +1 -0
  195. package/dist/engine/conformance.d.ts +187 -0
  196. package/dist/engine/conformance.d.ts.map +1 -0
  197. package/dist/engine/conformance.js +227 -0
  198. package/dist/engine/conformance.js.map +1 -0
  199. package/dist/engine/create-cli.d.ts +94 -0
  200. package/dist/engine/create-cli.d.ts.map +1 -0
  201. package/dist/engine/create-cli.js +60 -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 +47 -0
  220. package/dist/engine/deploy/app-version.d.ts.map +1 -0
  221. package/dist/engine/deploy/app-version.js +232 -0
  222. package/dist/engine/deploy/app-version.js.map +1 -0
  223. package/dist/engine/deploy/checks/database.d.ts +83 -0
  224. package/dist/engine/deploy/checks/database.d.ts.map +1 -0
  225. package/dist/engine/deploy/checks/database.js +455 -0
  226. package/dist/engine/deploy/checks/database.js.map +1 -0
  227. package/dist/engine/deploy/checks/dns.d.ts +3 -0
  228. package/dist/engine/deploy/checks/dns.d.ts.map +1 -0
  229. package/dist/engine/deploy/checks/dns.js +85 -0
  230. package/dist/engine/deploy/checks/dns.js.map +1 -0
  231. package/dist/engine/deploy/checks/host.d.ts +19 -0
  232. package/dist/engine/deploy/checks/host.d.ts.map +1 -0
  233. package/dist/engine/deploy/checks/host.js +530 -0
  234. package/dist/engine/deploy/checks/host.js.map +1 -0
  235. package/dist/engine/deploy/checks/index.d.ts +33 -0
  236. package/dist/engine/deploy/checks/index.d.ts.map +1 -0
  237. package/dist/engine/deploy/checks/index.js +67 -0
  238. package/dist/engine/deploy/checks/index.js.map +1 -0
  239. package/dist/engine/deploy/checks/registry.d.ts +102 -0
  240. package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
  241. package/dist/engine/deploy/checks/registry.js +103 -0
  242. package/dist/engine/deploy/checks/registry.js.map +1 -0
  243. package/dist/engine/deploy/checks/source.d.ts +45 -0
  244. package/dist/engine/deploy/checks/source.d.ts.map +1 -0
  245. package/dist/engine/deploy/checks/source.js +175 -0
  246. package/dist/engine/deploy/checks/source.js.map +1 -0
  247. package/dist/engine/deploy/checks/tls.d.ts +87 -0
  248. package/dist/engine/deploy/checks/tls.d.ts.map +1 -0
  249. package/dist/engine/deploy/checks/tls.js +552 -0
  250. package/dist/engine/deploy/checks/tls.js.map +1 -0
  251. package/dist/engine/deploy/checks/types.d.ts +178 -0
  252. package/dist/engine/deploy/checks/types.d.ts.map +1 -0
  253. package/dist/engine/deploy/checks/types.js +199 -0
  254. package/dist/engine/deploy/checks/types.js.map +1 -0
  255. package/dist/engine/deploy/compose-files.d.ts +29 -0
  256. package/dist/engine/deploy/compose-files.d.ts.map +1 -0
  257. package/dist/engine/deploy/compose-files.js +118 -0
  258. package/dist/engine/deploy/compose-files.js.map +1 -0
  259. package/dist/engine/deploy/consent.d.ts +29 -0
  260. package/dist/engine/deploy/consent.d.ts.map +1 -0
  261. package/dist/engine/deploy/consent.js +35 -0
  262. package/dist/engine/deploy/consent.js.map +1 -0
  263. package/dist/engine/deploy/database-drop.d.ts +22 -0
  264. package/dist/engine/deploy/database-drop.d.ts.map +1 -0
  265. package/dist/engine/deploy/database-drop.js +135 -0
  266. package/dist/engine/deploy/database-drop.js.map +1 -0
  267. package/dist/engine/deploy/database.d.ts +116 -0
  268. package/dist/engine/deploy/database.d.ts.map +1 -0
  269. package/dist/engine/deploy/database.js +252 -0
  270. package/dist/engine/deploy/database.js.map +1 -0
  271. package/dist/engine/deploy/deploy-info.d.ts +48 -0
  272. package/dist/engine/deploy/deploy-info.d.ts.map +1 -0
  273. package/dist/engine/deploy/deploy-info.js +163 -0
  274. package/dist/engine/deploy/deploy-info.js.map +1 -0
  275. package/dist/engine/deploy/deployment-evidence.d.ts +38 -0
  276. package/dist/engine/deploy/deployment-evidence.d.ts.map +1 -0
  277. package/dist/engine/deploy/deployment-evidence.js +92 -0
  278. package/dist/engine/deploy/deployment-evidence.js.map +1 -0
  279. package/dist/engine/deploy/edge-config.d.ts +103 -0
  280. package/dist/engine/deploy/edge-config.d.ts.map +1 -0
  281. package/dist/engine/deploy/edge-config.js +170 -0
  282. package/dist/engine/deploy/edge-config.js.map +1 -0
  283. package/dist/engine/deploy/env-absence.d.ts +61 -0
  284. package/dist/engine/deploy/env-absence.d.ts.map +1 -0
  285. package/dist/engine/deploy/env-absence.js +33 -0
  286. package/dist/engine/deploy/env-absence.js.map +1 -0
  287. package/dist/engine/deploy/env-file.d.ts +14 -0
  288. package/dist/engine/deploy/env-file.d.ts.map +1 -0
  289. package/dist/engine/deploy/env-file.js +58 -0
  290. package/dist/engine/deploy/env-file.js.map +1 -0
  291. package/dist/engine/deploy/env-fragments.d.ts +29 -0
  292. package/dist/engine/deploy/env-fragments.d.ts.map +1 -0
  293. package/dist/engine/deploy/env-fragments.js +73 -0
  294. package/dist/engine/deploy/env-fragments.js.map +1 -0
  295. package/dist/engine/deploy/env-metadata.d.ts +73 -0
  296. package/dist/engine/deploy/env-metadata.d.ts.map +1 -0
  297. package/dist/engine/deploy/env-metadata.js +227 -0
  298. package/dist/engine/deploy/env-metadata.js.map +1 -0
  299. package/dist/engine/deploy/env-spec.d.ts +75 -0
  300. package/dist/engine/deploy/env-spec.d.ts.map +1 -0
  301. package/dist/engine/deploy/env-spec.js +239 -0
  302. package/dist/engine/deploy/env-spec.js.map +1 -0
  303. package/dist/engine/deploy/env-wizard.d.ts +56 -0
  304. package/dist/engine/deploy/env-wizard.d.ts.map +1 -0
  305. package/dist/engine/deploy/env-wizard.js +235 -0
  306. package/dist/engine/deploy/env-wizard.js.map +1 -0
  307. package/dist/engine/deploy/executor.d.ts +81 -0
  308. package/dist/engine/deploy/executor.d.ts.map +1 -0
  309. package/dist/engine/deploy/executor.js +247 -0
  310. package/dist/engine/deploy/executor.js.map +1 -0
  311. package/dist/engine/deploy/health.d.ts +146 -0
  312. package/dist/engine/deploy/health.d.ts.map +1 -0
  313. package/dist/engine/deploy/health.js +323 -0
  314. package/dist/engine/deploy/health.js.map +1 -0
  315. package/dist/engine/deploy/hooks.d.ts +66 -0
  316. package/dist/engine/deploy/hooks.d.ts.map +1 -0
  317. package/dist/engine/deploy/hooks.js +19 -0
  318. package/dist/engine/deploy/hooks.js.map +1 -0
  319. package/dist/engine/deploy/host-facts.d.ts +23 -0
  320. package/dist/engine/deploy/host-facts.d.ts.map +1 -0
  321. package/dist/engine/deploy/host-facts.js +67 -0
  322. package/dist/engine/deploy/host-facts.js.map +1 -0
  323. package/dist/engine/deploy/install.d.ts +233 -0
  324. package/dist/engine/deploy/install.d.ts.map +1 -0
  325. package/dist/engine/deploy/install.js +1304 -0
  326. package/dist/engine/deploy/install.js.map +1 -0
  327. package/dist/engine/deploy/inventory.d.ts +30 -0
  328. package/dist/engine/deploy/inventory.d.ts.map +1 -0
  329. package/dist/engine/deploy/inventory.js +122 -0
  330. package/dist/engine/deploy/inventory.js.map +1 -0
  331. package/dist/engine/deploy/journal.d.ts +77 -0
  332. package/dist/engine/deploy/journal.d.ts.map +1 -0
  333. package/dist/engine/deploy/journal.js +221 -0
  334. package/dist/engine/deploy/journal.js.map +1 -0
  335. package/dist/engine/deploy/layout.d.ts +77 -0
  336. package/dist/engine/deploy/layout.d.ts.map +1 -0
  337. package/dist/engine/deploy/layout.js +191 -0
  338. package/dist/engine/deploy/layout.js.map +1 -0
  339. package/dist/engine/deploy/oauth-check.d.ts +58 -0
  340. package/dist/engine/deploy/oauth-check.d.ts.map +1 -0
  341. package/dist/engine/deploy/oauth-check.js +213 -0
  342. package/dist/engine/deploy/oauth-check.js.map +1 -0
  343. package/dist/engine/deploy/proxy-bootstrap.d.ts +149 -0
  344. package/dist/engine/deploy/proxy-bootstrap.d.ts.map +1 -0
  345. package/dist/engine/deploy/proxy-bootstrap.js +416 -0
  346. package/dist/engine/deploy/proxy-bootstrap.js.map +1 -0
  347. package/dist/engine/deploy/proxy-streams.d.ts +110 -0
  348. package/dist/engine/deploy/proxy-streams.d.ts.map +1 -0
  349. package/dist/engine/deploy/proxy-streams.js +208 -0
  350. package/dist/engine/deploy/proxy-streams.js.map +1 -0
  351. package/dist/engine/deploy/proxy.d.ts +375 -0
  352. package/dist/engine/deploy/proxy.d.ts.map +1 -0
  353. package/dist/engine/deploy/proxy.js +758 -0
  354. package/dist/engine/deploy/proxy.js.map +1 -0
  355. package/dist/engine/deploy/renewal.d.ts +54 -0
  356. package/dist/engine/deploy/renewal.d.ts.map +1 -0
  357. package/dist/engine/deploy/renewal.js +169 -0
  358. package/dist/engine/deploy/renewal.js.map +1 -0
  359. package/dist/engine/deploy/repo.d.ts +101 -0
  360. package/dist/engine/deploy/repo.d.ts.map +1 -0
  361. package/dist/engine/deploy/repo.js +250 -0
  362. package/dist/engine/deploy/repo.js.map +1 -0
  363. package/dist/engine/deploy/run-record.d.ts +28 -0
  364. package/dist/engine/deploy/run-record.d.ts.map +1 -0
  365. package/dist/engine/deploy/run-record.js +44 -0
  366. package/dist/engine/deploy/run-record.js.map +1 -0
  367. package/dist/engine/deploy/state.d.ts +262 -0
  368. package/dist/engine/deploy/state.d.ts.map +1 -0
  369. package/dist/engine/deploy/state.js +163 -0
  370. package/dist/engine/deploy/state.js.map +1 -0
  371. package/dist/engine/deploy/steps/app-step-context.d.ts +24 -0
  372. package/dist/engine/deploy/steps/app-step-context.d.ts.map +1 -0
  373. package/dist/engine/deploy/steps/app-step-context.js +45 -0
  374. package/dist/engine/deploy/steps/app-step-context.js.map +1 -0
  375. package/dist/engine/deploy/steps/pipeline.d.ts +46 -0
  376. package/dist/engine/deploy/steps/pipeline.d.ts.map +1 -0
  377. package/dist/engine/deploy/steps/pipeline.js +73 -0
  378. package/dist/engine/deploy/steps/pipeline.js.map +1 -0
  379. package/dist/engine/deploy/steps/plan.d.ts +28 -0
  380. package/dist/engine/deploy/steps/plan.d.ts.map +1 -0
  381. package/dist/engine/deploy/steps/plan.js +32 -0
  382. package/dist/engine/deploy/steps/plan.js.map +1 -0
  383. package/dist/engine/deploy/steps/registry.d.ts +182 -0
  384. package/dist/engine/deploy/steps/registry.d.ts.map +1 -0
  385. package/dist/engine/deploy/steps/registry.js +212 -0
  386. package/dist/engine/deploy/steps/registry.js.map +1 -0
  387. package/dist/engine/deploy/steps/step-values.d.ts +28 -0
  388. package/dist/engine/deploy/steps/step-values.d.ts.map +1 -0
  389. package/dist/engine/deploy/steps/step-values.js +33 -0
  390. package/dist/engine/deploy/steps/step-values.js.map +1 -0
  391. package/dist/engine/deploy/testing/fake-postgres.d.ts +88 -0
  392. package/dist/engine/deploy/testing/fake-postgres.d.ts.map +1 -0
  393. package/dist/engine/deploy/testing/fake-postgres.js +236 -0
  394. package/dist/engine/deploy/testing/fake-postgres.js.map +1 -0
  395. package/dist/engine/deploy/testing/fake-vps.d.ts +147 -0
  396. package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -0
  397. package/dist/engine/deploy/testing/fake-vps.js +365 -0
  398. package/dist/engine/deploy/testing/fake-vps.js.map +1 -0
  399. package/dist/engine/deploy/uninstall.d.ts +87 -0
  400. package/dist/engine/deploy/uninstall.d.ts.map +1 -0
  401. package/dist/engine/deploy/uninstall.js +320 -0
  402. package/dist/engine/deploy/uninstall.js.map +1 -0
  403. package/dist/engine/deploy/update.d.ts +111 -0
  404. package/dist/engine/deploy/update.d.ts.map +1 -0
  405. package/dist/engine/deploy/update.js +1228 -0
  406. package/dist/engine/deploy/update.js.map +1 -0
  407. package/dist/engine/deploy/version-step.d.ts +65 -0
  408. package/dist/engine/deploy/version-step.d.ts.map +1 -0
  409. package/dist/engine/deploy/version-step.js +176 -0
  410. package/dist/engine/deploy/version-step.js.map +1 -0
  411. package/dist/engine/device-auth.d.ts +240 -0
  412. package/dist/engine/device-auth.d.ts.map +1 -0
  413. package/dist/engine/device-auth.js +442 -0
  414. package/dist/engine/device-auth.js.map +1 -0
  415. package/dist/engine/device-login.d.ts +126 -0
  416. package/dist/engine/device-login.d.ts.map +1 -0
  417. package/dist/engine/device-login.js +164 -0
  418. package/dist/engine/device-login.js.map +1 -0
  419. package/dist/engine/errors.d.ts +314 -0
  420. package/dist/engine/errors.d.ts.map +1 -0
  421. package/dist/engine/errors.js +561 -0
  422. package/dist/engine/errors.js.map +1 -0
  423. package/dist/engine/identity.d.ts +169 -0
  424. package/dist/engine/identity.d.ts.map +1 -0
  425. package/dist/engine/identity.js +227 -0
  426. package/dist/engine/identity.js.map +1 -0
  427. package/dist/engine/index.d.ts +104 -0
  428. package/dist/engine/index.d.ts.map +1 -0
  429. package/dist/engine/index.js +126 -0
  430. package/dist/engine/index.js.map +1 -0
  431. package/dist/engine/init/local-profile.d.ts +93 -0
  432. package/dist/engine/init/local-profile.d.ts.map +1 -0
  433. package/dist/engine/init/local-profile.js +295 -0
  434. package/dist/engine/init/local-profile.js.map +1 -0
  435. package/dist/engine/init/run-init.d.ts +41 -0
  436. package/dist/engine/init/run-init.d.ts.map +1 -0
  437. package/dist/engine/init/run-init.js +297 -0
  438. package/dist/engine/init/run-init.js.map +1 -0
  439. package/dist/engine/node/capabilities.d.ts +238 -0
  440. package/dist/engine/node/capabilities.d.ts.map +1 -0
  441. package/dist/engine/node/capabilities.js +316 -0
  442. package/dist/engine/node/capabilities.js.map +1 -0
  443. package/dist/engine/node/daemon.d.ts +63 -0
  444. package/dist/engine/node/daemon.d.ts.map +1 -0
  445. package/dist/engine/node/daemon.js +227 -0
  446. package/dist/engine/node/daemon.js.map +1 -0
  447. package/dist/engine/node/doctor.d.ts +58 -0
  448. package/dist/engine/node/doctor.d.ts.map +1 -0
  449. package/dist/engine/node/doctor.js +394 -0
  450. package/dist/engine/node/doctor.js.map +1 -0
  451. package/dist/engine/node/enrollment.d.ts +98 -0
  452. package/dist/engine/node/enrollment.d.ts.map +1 -0
  453. package/dist/engine/node/enrollment.js +189 -0
  454. package/dist/engine/node/enrollment.js.map +1 -0
  455. package/dist/engine/node/env-flags.d.ts +5 -0
  456. package/dist/engine/node/env-flags.d.ts.map +1 -0
  457. package/dist/engine/node/env-flags.js +22 -0
  458. package/dist/engine/node/env-flags.js.map +1 -0
  459. package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
  460. package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
  461. package/dist/engine/node/executors/credential-hygiene.js +189 -0
  462. package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
  463. package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
  464. package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
  465. package/dist/engine/node/executors/db-backup-run.js +362 -0
  466. package/dist/engine/node/executors/db-backup-run.js.map +1 -0
  467. package/dist/engine/node/executors/example-checksum.d.ts +30 -0
  468. package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
  469. package/dist/engine/node/executors/example-checksum.js +56 -0
  470. package/dist/engine/node/executors/example-checksum.js.map +1 -0
  471. package/dist/engine/node/executors/index.d.ts +168 -0
  472. package/dist/engine/node/executors/index.d.ts.map +1 -0
  473. package/dist/engine/node/executors/index.js +44 -0
  474. package/dist/engine/node/executors/index.js.map +1 -0
  475. package/dist/engine/node/executors/registry.d.ts +38 -0
  476. package/dist/engine/node/executors/registry.d.ts.map +1 -0
  477. package/dist/engine/node/executors/registry.js +92 -0
  478. package/dist/engine/node/executors/registry.js.map +1 -0
  479. package/dist/engine/node/heap-snapshot.d.ts +37 -0
  480. package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
  481. package/dist/engine/node/heap-snapshot.js +160 -0
  482. package/dist/engine/node/heap-snapshot.js.map +1 -0
  483. package/dist/engine/node/install-deps.d.ts +73 -0
  484. package/dist/engine/node/install-deps.d.ts.map +1 -0
  485. package/dist/engine/node/install-deps.js +150 -0
  486. package/dist/engine/node/install-deps.js.map +1 -0
  487. package/dist/engine/node/ipc-protocol.d.ts +67 -0
  488. package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
  489. package/dist/engine/node/ipc-protocol.js +83 -0
  490. package/dist/engine/node/ipc-protocol.js.map +1 -0
  491. package/dist/engine/node/lifecycle.d.ts +103 -0
  492. package/dist/engine/node/lifecycle.d.ts.map +1 -0
  493. package/dist/engine/node/lifecycle.js +259 -0
  494. package/dist/engine/node/lifecycle.js.map +1 -0
  495. package/dist/engine/node/logger.d.ts +82 -0
  496. package/dist/engine/node/logger.d.ts.map +1 -0
  497. package/dist/engine/node/logger.js +241 -0
  498. package/dist/engine/node/logger.js.map +1 -0
  499. package/dist/engine/node/memory-watchdog.d.ts +78 -0
  500. package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
  501. package/dist/engine/node/memory-watchdog.js +224 -0
  502. package/dist/engine/node/memory-watchdog.js.map +1 -0
  503. package/dist/engine/node/node-api.d.ts +391 -0
  504. package/dist/engine/node/node-api.d.ts.map +1 -0
  505. package/dist/engine/node/node-api.js +123 -0
  506. package/dist/engine/node/node-api.js.map +1 -0
  507. package/dist/engine/node/node-config.d.ts +128 -0
  508. package/dist/engine/node/node-config.d.ts.map +1 -0
  509. package/dist/engine/node/node-config.js +237 -0
  510. package/dist/engine/node/node-config.js.map +1 -0
  511. package/dist/engine/node/node-dashboard-source.d.ts +56 -0
  512. package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
  513. package/dist/engine/node/node-dashboard-source.js +213 -0
  514. package/dist/engine/node/node-dashboard-source.js.map +1 -0
  515. package/dist/engine/node/node-engine.d.ts +229 -0
  516. package/dist/engine/node/node-engine.d.ts.map +1 -0
  517. package/dist/engine/node/node-engine.js +723 -0
  518. package/dist/engine/node/node-engine.js.map +1 -0
  519. package/dist/engine/node/node-errors.d.ts +54 -0
  520. package/dist/engine/node/node-errors.d.ts.map +1 -0
  521. package/dist/engine/node/node-errors.js +71 -0
  522. package/dist/engine/node/node-errors.js.map +1 -0
  523. package/dist/engine/node/node-events.d.ts +132 -0
  524. package/dist/engine/node/node-events.d.ts.map +1 -0
  525. package/dist/engine/node/node-events.js +2 -0
  526. package/dist/engine/node/node-events.js.map +1 -0
  527. package/dist/engine/node/node-vitals.d.ts +123 -0
  528. package/dist/engine/node/node-vitals.d.ts.map +1 -0
  529. package/dist/engine/node/node-vitals.js +266 -0
  530. package/dist/engine/node/node-vitals.js.map +1 -0
  531. package/dist/engine/node/paths.d.ts +39 -0
  532. package/dist/engine/node/paths.d.ts.map +1 -0
  533. package/dist/engine/node/paths.js +60 -0
  534. package/dist/engine/node/paths.js.map +1 -0
  535. package/dist/engine/node/pg-dump.d.ts +126 -0
  536. package/dist/engine/node/pg-dump.d.ts.map +1 -0
  537. package/dist/engine/node/pg-dump.js +223 -0
  538. package/dist/engine/node/pg-dump.js.map +1 -0
  539. package/dist/engine/node/pidfile.d.ts +38 -0
  540. package/dist/engine/node/pidfile.d.ts.map +1 -0
  541. package/dist/engine/node/pidfile.js +156 -0
  542. package/dist/engine/node/pidfile.js.map +1 -0
  543. package/dist/engine/node/runtime-tuning.d.ts +65 -0
  544. package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
  545. package/dist/engine/node/runtime-tuning.js +198 -0
  546. package/dist/engine/node/runtime-tuning.js.map +1 -0
  547. package/dist/engine/node/service.d.ts +39 -0
  548. package/dist/engine/node/service.d.ts.map +1 -0
  549. package/dist/engine/node/service.js +211 -0
  550. package/dist/engine/node/service.js.map +1 -0
  551. package/dist/engine/node/start.d.ts +62 -0
  552. package/dist/engine/node/start.d.ts.map +1 -0
  553. package/dist/engine/node/start.js +245 -0
  554. package/dist/engine/node/start.js.map +1 -0
  555. package/dist/engine/node/worker-env-table.d.ts +15 -0
  556. package/dist/engine/node/worker-env-table.d.ts.map +1 -0
  557. package/dist/engine/node/worker-env-table.js +97 -0
  558. package/dist/engine/node/worker-env-table.js.map +1 -0
  559. package/dist/engine/node/worker-env.d.ts +50 -0
  560. package/dist/engine/node/worker-env.d.ts.map +1 -0
  561. package/dist/engine/node/worker-env.js +101 -0
  562. package/dist/engine/node/worker-env.js.map +1 -0
  563. package/dist/engine/output.d.ts +97 -0
  564. package/dist/engine/output.d.ts.map +1 -0
  565. package/dist/engine/output.js +274 -0
  566. package/dist/engine/output.js.map +1 -0
  567. package/dist/engine/package-info.d.ts +7 -0
  568. package/dist/engine/package-info.d.ts.map +1 -0
  569. package/dist/engine/package-info.js +38 -0
  570. package/dist/engine/package-info.js.map +1 -0
  571. package/dist/engine/program.d.ts +50 -0
  572. package/dist/engine/program.d.ts.map +1 -0
  573. package/dist/engine/program.js +197 -0
  574. package/dist/engine/program.js.map +1 -0
  575. package/dist/engine/prompt.d.ts +69 -0
  576. package/dist/engine/prompt.d.ts.map +1 -0
  577. package/dist/engine/prompt.js +205 -0
  578. package/dist/engine/prompt.js.map +1 -0
  579. package/dist/engine/registries.d.ts +5 -0
  580. package/dist/engine/registries.d.ts.map +1 -0
  581. package/dist/engine/registries.js +52 -0
  582. package/dist/engine/registries.js.map +1 -0
  583. package/dist/engine/request-body.d.ts +31 -0
  584. package/dist/engine/request-body.d.ts.map +1 -0
  585. package/dist/engine/request-body.js +156 -0
  586. package/dist/engine/request-body.js.map +1 -0
  587. package/dist/engine/test-support.d.ts +50 -0
  588. package/dist/engine/test-support.d.ts.map +1 -0
  589. package/dist/engine/test-support.js +86 -0
  590. package/dist/engine/test-support.js.map +1 -0
  591. package/dist/engine/tui/app.d.ts +3 -0
  592. package/dist/engine/tui/app.d.ts.map +1 -0
  593. package/dist/engine/tui/app.js +100 -0
  594. package/dist/engine/tui/app.js.map +1 -0
  595. package/dist/engine/tui/builtin-screens.d.ts +6 -0
  596. package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
  597. package/dist/engine/tui/builtin-screens.js +54 -0
  598. package/dist/engine/tui/builtin-screens.js.map +1 -0
  599. package/dist/engine/tui/index.d.ts +23 -0
  600. package/dist/engine/tui/index.d.ts.map +1 -0
  601. package/dist/engine/tui/index.js +71 -0
  602. package/dist/engine/tui/index.js.map +1 -0
  603. package/dist/engine/tui/layout.d.ts +132 -0
  604. package/dist/engine/tui/layout.d.ts.map +1 -0
  605. package/dist/engine/tui/layout.js +200 -0
  606. package/dist/engine/tui/layout.js.map +1 -0
  607. package/dist/engine/tui/routes.d.ts +5 -0
  608. package/dist/engine/tui/routes.d.ts.map +1 -0
  609. package/dist/engine/tui/routes.js +16 -0
  610. package/dist/engine/tui/routes.js.map +1 -0
  611. package/dist/engine/tui/screen-registry.d.ts +100 -0
  612. package/dist/engine/tui/screen-registry.d.ts.map +1 -0
  613. package/dist/engine/tui/screen-registry.js +96 -0
  614. package/dist/engine/tui/screen-registry.js.map +1 -0
  615. package/dist/engine/tui/screen-sections.d.ts +9 -0
  616. package/dist/engine/tui/screen-sections.d.ts.map +1 -0
  617. package/dist/engine/tui/screen-sections.js +45 -0
  618. package/dist/engine/tui/screen-sections.js.map +1 -0
  619. package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
  620. package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
  621. package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
  622. package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
  623. package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
  624. package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
  625. package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
  626. package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
  627. package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
  628. package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
  629. package/dist/engine/tui/screens/deploy/doctor.js +153 -0
  630. package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
  631. package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
  632. package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
  633. package/dist/engine/tui/screens/deploy/fields.js +202 -0
  634. package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
  635. package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
  636. package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
  637. package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
  638. package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
  639. package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
  640. package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
  641. package/dist/engine/tui/screens/deploy/index.js +83 -0
  642. package/dist/engine/tui/screens/deploy/index.js.map +1 -0
  643. package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
  644. package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
  645. package/dist/engine/tui/screens/deploy/install-model.js +319 -0
  646. package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
  647. package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
  648. package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
  649. package/dist/engine/tui/screens/deploy/install.js +361 -0
  650. package/dist/engine/tui/screens/deploy/install.js.map +1 -0
  651. package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
  652. package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
  653. package/dist/engine/tui/screens/deploy/model.js +59 -0
  654. package/dist/engine/tui/screens/deploy/model.js.map +1 -0
  655. package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
  656. package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
  657. package/dist/engine/tui/screens/deploy/run-model.js +117 -0
  658. package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
  659. package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
  660. package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
  661. package/dist/engine/tui/screens/deploy/run.js +201 -0
  662. package/dist/engine/tui/screens/deploy/run.js.map +1 -0
  663. package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
  664. package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
  665. package/dist/engine/tui/screens/deploy/status.js +107 -0
  666. package/dist/engine/tui/screens/deploy/status.js.map +1 -0
  667. package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
  668. package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
  669. package/dist/engine/tui/screens/deploy/update.js +175 -0
  670. package/dist/engine/tui/screens/deploy/update.js.map +1 -0
  671. package/dist/engine/tui/screens/deploy.d.ts +12 -0
  672. package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
  673. package/dist/engine/tui/screens/deploy.js +23 -0
  674. package/dist/engine/tui/screens/deploy.js.map +1 -0
  675. package/dist/engine/tui/screens/invoke.d.ts +6 -0
  676. package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
  677. package/dist/engine/tui/screens/invoke.js +193 -0
  678. package/dist/engine/tui/screens/invoke.js.map +1 -0
  679. package/dist/engine/tui/screens/login.d.ts +6 -0
  680. package/dist/engine/tui/screens/login.d.ts.map +1 -0
  681. package/dist/engine/tui/screens/login.js +255 -0
  682. package/dist/engine/tui/screens/login.js.map +1 -0
  683. package/dist/engine/tui/screens/logout.d.ts +6 -0
  684. package/dist/engine/tui/screens/logout.d.ts.map +1 -0
  685. package/dist/engine/tui/screens/logout.js +142 -0
  686. package/dist/engine/tui/screens/logout.js.map +1 -0
  687. package/dist/engine/tui/screens/menu.d.ts +22 -0
  688. package/dist/engine/tui/screens/menu.d.ts.map +1 -0
  689. package/dist/engine/tui/screens/menu.js +84 -0
  690. package/dist/engine/tui/screens/menu.js.map +1 -0
  691. package/dist/engine/tui/screens/node.d.ts +6 -0
  692. package/dist/engine/tui/screens/node.d.ts.map +1 -0
  693. package/dist/engine/tui/screens/node.js +228 -0
  694. package/dist/engine/tui/screens/node.js.map +1 -0
  695. package/dist/engine/tui/screens/status.d.ts +6 -0
  696. package/dist/engine/tui/screens/status.d.ts.map +1 -0
  697. package/dist/engine/tui/screens/status.js +134 -0
  698. package/dist/engine/tui/screens/status.js.map +1 -0
  699. package/dist/engine/tui/scroll-box.d.ts +27 -0
  700. package/dist/engine/tui/scroll-box.d.ts.map +1 -0
  701. package/dist/engine/tui/scroll-box.js +52 -0
  702. package/dist/engine/tui/scroll-box.js.map +1 -0
  703. package/dist/engine/tui/section-registry.d.ts +65 -0
  704. package/dist/engine/tui/section-registry.d.ts.map +1 -0
  705. package/dist/engine/tui/section-registry.js +90 -0
  706. package/dist/engine/tui/section-registry.js.map +1 -0
  707. package/dist/engine/tui/terminal.d.ts +31 -0
  708. package/dist/engine/tui/terminal.d.ts.map +1 -0
  709. package/dist/engine/tui/terminal.js +142 -0
  710. package/dist/engine/tui/terminal.js.map +1 -0
  711. package/dist/engine/tui/tty.d.ts +49 -0
  712. package/dist/engine/tui/tty.d.ts.map +1 -0
  713. package/dist/engine/tui/tty.js +139 -0
  714. package/dist/engine/tui/tty.js.map +1 -0
  715. package/dist/index.d.ts +4 -5
  716. package/dist/index.d.ts.map +1 -1
  717. package/dist/index.js +5 -5
  718. package/dist/index.js.map +1 -1
  719. package/dist/node/index.d.ts +3 -0
  720. package/dist/node/index.d.ts.map +1 -0
  721. package/dist/node/index.js +5 -0
  722. package/dist/node/index.js.map +1 -0
  723. package/dist/telemetry/index.d.ts +2 -1
  724. package/dist/telemetry/index.d.ts.map +1 -1
  725. package/dist/telemetry/index.js +1 -0
  726. package/dist/telemetry/index.js.map +1 -1
  727. package/dist/telemetry/node-span-relay.d.ts +1 -1
  728. package/dist/telemetry/node-span-relay.d.ts.map +1 -1
  729. package/dist/telemetry/node-span-relay.js +39 -6
  730. package/dist/telemetry/node-span-relay.js.map +1 -1
  731. package/dist/telemetry/node-span.d.ts +39 -7
  732. package/dist/telemetry/node-span.d.ts.map +1 -1
  733. package/dist/telemetry/node-span.js +19 -1
  734. package/dist/telemetry/node-span.js.map +1 -1
  735. package/dist/testing/index.d.ts +3 -0
  736. package/dist/testing/index.d.ts.map +1 -0
  737. package/dist/testing/index.js +4 -0
  738. package/dist/testing/index.js.map +1 -0
  739. package/dist/tui/index.d.ts +3 -0
  740. package/dist/tui/index.d.ts.map +1 -0
  741. package/dist/tui/index.js +5 -0
  742. package/dist/tui/index.js.map +1 -0
  743. package/package.json +43 -5
@@ -0,0 +1 @@
1
+ {"version":3,"file":"database-drop.d.ts","sourceRoot":"","sources":["../../../src/engine/deploy/database-drop.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEhE,iFAAiF;AACjF,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,iBAAiB,GAAG,SAAS,CAAC;IAClD,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAiFD,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAgD7B"}
@@ -0,0 +1,135 @@
1
+ /**
2
+ * Dropping the application's database — the opt-in half of uninstall.
3
+ *
4
+ * ⚠ `DROP DATABASE WITH (FORCE)` WAS REJECTED, and it is the obvious choice.
5
+ * Two reasons: it is a syntax error on PostgreSQL 13, which is still in the
6
+ * field; and it terminates backends without saying which or how many, so an
7
+ * operator cannot tell "nothing was connected" from "I just killed a session
8
+ * somebody was using". This does it in two explicit steps and reports the
9
+ * count.
10
+ *
11
+ * ⚠ BACKENDS ARE TERMINATED ONLY ON ERROR 55006 (`object_in_use`), and only
12
+ * for THAT database. Terminating pre-emptively would kill sessions on a
13
+ * database that was about to drop cleanly anyway; terminating unscoped would
14
+ * kill every session on the server, including other applications'.
15
+ *
16
+ * The connection is made to the `postgres` maintenance database, because a
17
+ * database cannot be dropped from a session connected to it.
18
+ */
19
+ import { UsageError } from '../errors.js';
20
+ import { runCommand as defaultRunCommand } from './executor.js';
21
+ /** PostgreSQL's `object_in_use`: "database is being accessed by other users". */
22
+ export const OBJECT_IN_USE = '55006';
23
+ const DEFAULT_IMAGE = 'postgres:16-alpine';
24
+ /**
25
+ * Runs one SQL statement through a throwaway psql container.
26
+ *
27
+ * `PGPASSWORD` is passed BY NAME, never in an argv: an argv is visible in
28
+ * `ps` to every user on the host, and this one carries the database
29
+ * superuser's password. The same discipline `checks/database.ts` already uses.
30
+ *
31
+ * `PGCONNECT_TIMEOUT` and, when `POSTGRES_SSL=true`, `PGSSLMODE=require` go the
32
+ * same way: named in the argv, valued in the environment. Without the SSL mode
33
+ * a managed PostgreSQL that requires TLS refuses the drop outright; without
34
+ * the timeout an unreachable host holds the uninstall for the full minute.
35
+ */
36
+ async function psql(options, sql) {
37
+ const run = options.runCommand ?? defaultRunCommand;
38
+ const env = options.env;
39
+ const host = env.get('POSTGRES_HOST');
40
+ const user = env.get('POSTGRES_USER');
41
+ const password = env.get('POSTGRES_PASSWORD');
42
+ if (host === undefined || user === undefined || password === undefined) {
43
+ throw new UsageError('The deployment environment does not carry POSTGRES_HOST, POSTGRES_USER and POSTGRES_PASSWORD, so the database cannot be reached.');
44
+ }
45
+ const ssl = env.get('POSTGRES_SSL') === 'true';
46
+ const result = await run([
47
+ 'docker',
48
+ 'run',
49
+ '--rm',
50
+ '--network',
51
+ 'host',
52
+ // Each by NAME. The values follow in the env map below, never here.
53
+ '--env',
54
+ 'PGPASSWORD',
55
+ '--env',
56
+ 'PGCONNECT_TIMEOUT',
57
+ ...(ssl ? ['--env', 'PGSSLMODE'] : []),
58
+ options.image ?? DEFAULT_IMAGE,
59
+ 'psql',
60
+ '--host',
61
+ host,
62
+ '--port',
63
+ env.get('POSTGRES_PORT') ?? '5432',
64
+ '--username',
65
+ user,
66
+ // The maintenance database: a database cannot be dropped from a session
67
+ // connected to it.
68
+ '--dbname',
69
+ 'postgres',
70
+ '--no-password',
71
+ '--tuples-only',
72
+ '--command',
73
+ sql,
74
+ ], {
75
+ cwd: process.cwd(),
76
+ timeoutMs: 60_000,
77
+ allowExitCodes: [0, 1, 2, 3],
78
+ env: {
79
+ ...process.env,
80
+ PGPASSWORD: password,
81
+ PGCONNECT_TIMEOUT: '5',
82
+ ...(ssl ? { PGSSLMODE: 'require' } : {}),
83
+ },
84
+ });
85
+ return { stdout: result.stdout, stderr: result.stderr, exitCode: result.exitCode };
86
+ }
87
+ /** Double-quoted, with embedded quotes doubled. Never interpolated raw. */
88
+ export function quoteIdentifier(name) {
89
+ return `"${name.replace(/"/g, '""')}"`;
90
+ }
91
+ export async function dropDatabase(options) {
92
+ const quoted = quoteIdentifier(options.database);
93
+ // Plain DROP first. Most of the time nothing is connected -- the stack came
94
+ // down a moment ago -- and terminating backends nobody asked about is a
95
+ // side effect this does not need to have.
96
+ const first = await psql(options, `DROP DATABASE ${quoted};`);
97
+ if (first.exitCode === 0) {
98
+ return { dropped: true, terminated: 0, detail: 'dropped; no sessions were connected' };
99
+ }
100
+ const blocked = first.stderr.includes(OBJECT_IN_USE) ||
101
+ /is being accessed by other users/i.test(first.stderr);
102
+ if (!blocked) {
103
+ return {
104
+ dropped: false,
105
+ terminated: 0,
106
+ detail: first.stderr.trim() || 'the drop failed for an unknown reason',
107
+ };
108
+ }
109
+ // SCOPED to this database. `pg_terminate_backend` over every backend would
110
+ // take down other applications sharing this PostgreSQL, which is exactly the
111
+ // deployment model this CLI assumes.
112
+ const terminate = await psql(options, `SELECT count(pg_terminate_backend(pid)) FROM pg_stat_activity WHERE datname = ${literal(options.database)} AND pid <> pg_backend_pid();`);
113
+ const terminated = Number.parseInt(terminate.stdout.trim(), 10);
114
+ const second = await psql(options, `DROP DATABASE ${quoted};`);
115
+ if (second.exitCode !== 0) {
116
+ return {
117
+ dropped: false,
118
+ terminated: Number.isNaN(terminated) ? 0 : terminated,
119
+ detail: second.stderr.trim() || 'the drop failed after terminating sessions',
120
+ };
121
+ }
122
+ const count = Number.isNaN(terminated) ? 0 : terminated;
123
+ return {
124
+ dropped: true,
125
+ terminated: count,
126
+ // Always reported. An operator who was not told a session was killed
127
+ // cannot know to go and ask whose it was.
128
+ detail: `dropped after terminating ${String(count)} session(s)`,
129
+ };
130
+ }
131
+ /** A single-quoted SQL string literal, with embedded quotes doubled. */
132
+ function literal(value) {
133
+ return `'${value.replace(/'/g, "''")}'`;
134
+ }
135
+ //# sourceMappingURL=database-drop.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"database-drop.js","sourceRoot":"","sources":["../../../src/engine/deploy/database-drop.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,116 @@
1
+ import { type Check, type CheckContext, type CompletedCheck } from './checks/index.js';
2
+ import { type ConsentOptions } from './consent.js';
3
+ import type { runCommand } from './executor.js';
4
+ /**
5
+ * The identifiers this will create. Deliberately narrower than PostgreSQL's
6
+ * own grammar: no quotes, no spaces, nothing that needs thinking about. A name
7
+ * outside it is refused rather than escaped -- create it by hand if you must.
8
+ */
9
+ export declare const CREATABLE_DATABASE_NAME: RegExp;
10
+ /** Throws a UsageError unless `name` is safe to create. */
11
+ export declare function assertCreatableDatabaseName(name: string): void;
12
+ /** The one statement ever issued. Validates, then quotes. */
13
+ export declare function createDatabaseStatement(name: string): string;
14
+ /** True when `database-exists` failed because the database is absent (3D000). */
15
+ export declare function isMissingDatabase(result: Pick<CompletedCheck, 'id' | 'status' | 'detail'>): boolean;
16
+ /**
17
+ * True when the ONLY required failure among database checks is a missing
18
+ * database. That is the single case `ensure-database` may act on -- see rule 1.
19
+ */
20
+ export declare function onlyDatabaseMissing(results: readonly CompletedCheck[]): boolean;
21
+ /** The existence subset of the registry: reachable, credentials, exists. */
22
+ export declare const DATABASE_EXISTENCE_CHECKS: readonly Check[];
23
+ /**
24
+ * Whether a re-verify result means the database just created is not usable.
25
+ *
26
+ * Every REQUIRED failure, and one more: `database-privileges` DEFINITELY
27
+ * answering "cannot create in schema public" (#396). That check is only
28
+ * `recommended` for doctor, because on an existing database an administrator
29
+ * may have arranged privileges some other way -- but on a database this run
30
+ * has just created, "cannot create tables" means the migration fails next, so
31
+ * it stops here, with the GRANT as the remedy. "Could not determine" does not
32
+ * stop anything; only a definite no does.
33
+ */
34
+ export declare function blocksNewDatabase(result: CompletedCheck): boolean;
35
+ export interface EnsureDatabaseOptions extends Omit<ConsentOptions, 'flag'> {
36
+ env: ReadonlyMap<string, string>;
37
+ runCommand: typeof runCommand;
38
+ /** `--create-database`: consent given in advance. */
39
+ createDatabase?: boolean | undefined;
40
+ /** Where to report, one line at a time. */
41
+ onLine?: ((line: string) => void) | undefined;
42
+ /**
43
+ * `--allow-superuser` (#980): the re-verify's `database-role-ordinary`
44
+ * reports a warning instead of a failure.
45
+ */
46
+ allowSuperuser?: boolean | undefined;
47
+ /**
48
+ * The environment file POSTGRES_DB was read from, named in every refusal
49
+ * (#396): "does not exist yet" and "a typo" look identical from here, so the
50
+ * operator is told exactly which line to correct. Absent: "the environment
51
+ * file".
52
+ */
53
+ envPath?: string | undefined;
54
+ /**
55
+ * The existence checks, replaceable in tests. Defaults to the real
56
+ * reachable/credentials/exists subset of the registry.
57
+ */
58
+ check?: ((context: CheckContext) => Promise<CompletedCheck[]>) | undefined;
59
+ /**
60
+ * The re-verify after a CREATE (#396), replaceable in tests. Defaults to the
61
+ * WHOLE database check set, `database-privileges` included.
62
+ */
63
+ verify?: ((context: CheckContext) => Promise<CompletedCheck[]>) | undefined;
64
+ }
65
+ export interface EnsureDatabaseResult {
66
+ outcome: 'exists' | 'created';
67
+ database: string;
68
+ detail: string;
69
+ /**
70
+ * What was checked, for a caller that renders it (a fork's wizard): the
71
+ * existence checks when the database was already there, the full re-verify
72
+ * when it was just created.
73
+ */
74
+ checks: CompletedCheck[];
75
+ }
76
+ /**
77
+ * Makes sure the configured database exists: when it is the ONLY thing
78
+ * missing, offers to create it (a prompt, or `--create-database`), creates it,
79
+ * and re-verifies it with the full database check set. Never drops or alters
80
+ * anything.
81
+ *
82
+ * ⚠ THIS IS THE ONE IMPLEMENTATION (#396). install's and update's
83
+ * `ensure-database` steps both call it, and a fork's own setup wizard MUST
84
+ * call it too rather than reimplementing any part of "offer, create,
85
+ * re-verify" -- the checks it runs, the consent rules and the refusal
86
+ * messages are all here so that no two callers can disagree about them.
87
+ * `result.checks` is what was verified, for a wizard to render.
88
+ */
89
+ export declare function ensureDatabase(options: EnsureDatabaseOptions): Promise<EnsureDatabaseResult>;
90
+ export interface UnattendedRefusalOptions {
91
+ env: ReadonlyMap<string, string>;
92
+ runCommand: typeof runCommand;
93
+ envPath?: string | undefined;
94
+ onLine?: ((line: string) => void) | undefined;
95
+ /** The existence checks, replaceable in tests. */
96
+ check?: ((context: CheckContext) => Promise<CompletedCheck[]>) | undefined;
97
+ }
98
+ /**
99
+ * The refusal `ensureDatabase` WILL give later, found before anything is
100
+ * cloned (#396) -- or undefined when there is none to give.
101
+ *
102
+ * For a run that cannot obtain consent (`--non-interactive` without
103
+ * `--create-database`): the database settings are already known, the
104
+ * database is missing, and nobody can be asked -- so the install is going to
105
+ * stop at `ensure-database` no matter what, and stopping at preflight instead
106
+ * spares the clone. Found by calling `ensureDatabase` itself with consent
107
+ * forced UNAVAILABLE, so the message is the same one and the CREATE is
108
+ * unreachable: no flag, no `ask`, `nonInteractive` -- it can only refuse.
109
+ *
110
+ * Any OTHER database problem (unreachable, bad password) answers undefined:
111
+ * `validate-environment` owns those, with the settings the run actually
112
+ * writes. This only ever pre-empts the one refusal that no later step could
113
+ * turn into a success.
114
+ */
115
+ export declare function unattendedDatabaseRefusal(options: UnattendedRefusalOptions): Promise<Error | undefined>;
116
+ //# sourceMappingURL=database.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/engine/deploy/database.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,cAAc,EAEpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AA4ChD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAA8B,CAAC;AAKnE,2DAA2D;AAC3D,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ9D;AAED,6DAA6D;AAC7D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,QAAQ,GAAG,QAAQ,CAAC,GAAG,OAAO,CAMnG;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAG/E;AAKD,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,EAAE,SAAS,KAAK,EAErD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAGjE;AAED,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC;IACzE,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,qDAAqD;IACrD,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC9C;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;IAC3E;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;CAC7E;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AA4BD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA6GlG;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC9C,kDAAkD;IAClD,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;CAC5E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAoB7G"}
@@ -0,0 +1,252 @@
1
+ import { PreconditionError, UsageError } from '../errors.js';
2
+ import { DATABASE_CHECKS, MAINTENANCE_DATABASE, canCreateDatabase, databaseSettings, runChecks, runPsql, } from './checks/index.js';
3
+ import { consented, obtainConsent } from './consent.js';
4
+ // =============================================================================
5
+ // Creating the application database when it does not exist (issue #391)
6
+ // =============================================================================
7
+ //
8
+ // `database-exists` used to end an install with a `createdb` remedy, on a
9
+ // server that was reachable, whose credentials worked, and whose role often
10
+ // held CREATEDB -- so the install stopped to have a human type one command.
11
+ //
12
+ // THREE RULES, each pinned by a test:
13
+ //
14
+ // 1. ONLY THE ONE FAILURE. The database is created only when the server is
15
+ // reachable, the credentials authenticate, and the ONLY problem is that
16
+ // the named database does not exist (3D000). Anything else -- refused,
17
+ // bad password, pg_hba -- is reported exactly as before; creating a
18
+ // database is not a remedy for any of those.
19
+ // 2. NEVER SILENTLY. A typo in POSTGRES_DB is indistinguishable, from here,
20
+ // from a database that simply does not exist yet; creating it silently
21
+ // would migrate into a second, empty database and the operator's first
22
+ // evidence would be an application with no data. So: a prompt, or
23
+ // `--create-database` for a non-interactive run.
24
+ // 3. CREATE, NEVER DROP OR ALTER. The only statement this ever issues is
25
+ // `CREATE DATABASE "<name>"`, against the `postgres` maintenance
26
+ // database, with the password passed through PGPASSWORD (by name in the
27
+ // argv, by value in the environment -- `runPsql`). The identifier is
28
+ // validated against a conservative grammar and then double-quoted, so no
29
+ // value from the `.env` can extend the statement.
30
+ //
31
+ // AND, SINCE #396, TWO MORE:
32
+ //
33
+ // 4. RE-VERIFIED, NOT ASSUMED. After the CREATE, the WHOLE database check
34
+ // set runs again against the new database -- `database-privileges`
35
+ // included -- so the operator sees a real answer where they used to see
36
+ // `skipped: database-exists did not pass`, and a role that can create a
37
+ // database but not a table stops HERE, with the GRANT, rather than in the
38
+ // migration four minutes later.
39
+ // 5. ONE FUNCTION. `ensureDatabase` is THE "offer, create, re-verify"
40
+ // behaviour. install's and update's `ensure-database` steps call it, and a
41
+ // fork's own wizard must call it too, rather than stitching the pieces
42
+ // back together -- the same argument `detectRenewalOwner` makes for
43
+ // renewal: two copies of a gate are two gates, and they drift.
44
+ // =============================================================================
45
+ /**
46
+ * The identifiers this will create. Deliberately narrower than PostgreSQL's
47
+ * own grammar: no quotes, no spaces, nothing that needs thinking about. A name
48
+ * outside it is refused rather than escaped -- create it by hand if you must.
49
+ */
50
+ export const CREATABLE_DATABASE_NAME = /^[A-Za-z_][A-Za-z0-9_$]*$/;
51
+ /** PostgreSQL truncates identifiers longer than this, silently. */
52
+ const MAX_IDENTIFIER_BYTES = 63;
53
+ /** Throws a UsageError unless `name` is safe to create. */
54
+ export function assertCreatableDatabaseName(name) {
55
+ if (!CREATABLE_DATABASE_NAME.test(name) || Buffer.byteLength(name) > MAX_IDENTIFIER_BYTES) {
56
+ throw new UsageError(`POSTGRES_DB "${name}" is not a name this will create: it must match ` +
57
+ `${CREATABLE_DATABASE_NAME.source} and be at most ${MAX_IDENTIFIER_BYTES} bytes. ` +
58
+ 'Create the database by hand, or choose a plainer name.');
59
+ }
60
+ }
61
+ /** The one statement ever issued. Validates, then quotes. */
62
+ export function createDatabaseStatement(name) {
63
+ assertCreatableDatabaseName(name);
64
+ return `CREATE DATABASE "${name}"`;
65
+ }
66
+ /** True when `database-exists` failed because the database is absent (3D000). */
67
+ export function isMissingDatabase(result) {
68
+ return (result.id === 'database-exists' &&
69
+ result.status === 'fail' &&
70
+ /does not exist/i.test(result.detail));
71
+ }
72
+ /**
73
+ * True when the ONLY required failure among database checks is a missing
74
+ * database. That is the single case `ensure-database` may act on -- see rule 1.
75
+ */
76
+ export function onlyDatabaseMissing(results) {
77
+ const failed = results.filter((result) => result.status === 'fail' && result.severity === 'required');
78
+ return failed.length === 1 && isMissingDatabase(failed[0]);
79
+ }
80
+ /** The checks that decide whether the database is usable, and nothing else. */
81
+ const EXISTENCE_CHECK_IDS = new Set(['database-reachable', 'database-credentials', 'database-exists']);
82
+ /** The existence subset of the registry: reachable, credentials, exists. */
83
+ export const DATABASE_EXISTENCE_CHECKS = DATABASE_CHECKS.filter((candidate) => EXISTENCE_CHECK_IDS.has(candidate.id));
84
+ /**
85
+ * Whether a re-verify result means the database just created is not usable.
86
+ *
87
+ * Every REQUIRED failure, and one more: `database-privileges` DEFINITELY
88
+ * answering "cannot create in schema public" (#396). That check is only
89
+ * `recommended` for doctor, because on an existing database an administrator
90
+ * may have arranged privileges some other way -- but on a database this run
91
+ * has just created, "cannot create tables" means the migration fails next, so
92
+ * it stops here, with the GRANT as the remedy. "Could not determine" does not
93
+ * stop anything; only a definite no does.
94
+ */
95
+ export function blocksNewDatabase(result) {
96
+ if (result.status === 'fail' && result.severity === 'required')
97
+ return true;
98
+ return result.id === 'database-privileges' && result.status === 'warn' && /cannot create in schema/i.test(result.detail);
99
+ }
100
+ function checkContextFor(options) {
101
+ return {
102
+ runCommand: options.runCommand,
103
+ deployRoot: '',
104
+ bindPort: 0,
105
+ proxyRoot: '',
106
+ env: options.env,
107
+ ...(options.allowSuperuser === true ? { allowSuperuser: true } : {}),
108
+ };
109
+ }
110
+ /** "correct POSTGRES_DB in <file>" -- named, because a typo looks like absence. */
111
+ function correctionFor(settings, envPath) {
112
+ return `If "${settings.database}" is not the name you meant, correct POSTGRES_DB in ${envPath ?? 'the environment file'}.`;
113
+ }
114
+ function remedyFor(settings, envPath) {
115
+ const name = settings.database;
116
+ return (`Create it by hand: CREATE DATABASE "${name}"; (or: createdb -h ${settings.host} -p ${settings.port} -U ${settings.user} ${name})\n` +
117
+ ` ${correctionFor(settings, envPath)}`);
118
+ }
119
+ /**
120
+ * Makes sure the configured database exists: when it is the ONLY thing
121
+ * missing, offers to create it (a prompt, or `--create-database`), creates it,
122
+ * and re-verifies it with the full database check set. Never drops or alters
123
+ * anything.
124
+ *
125
+ * ⚠ THIS IS THE ONE IMPLEMENTATION (#396). install's and update's
126
+ * `ensure-database` steps both call it, and a fork's own setup wizard MUST
127
+ * call it too rather than reimplementing any part of "offer, create,
128
+ * re-verify" -- the checks it runs, the consent rules and the refusal
129
+ * messages are all here so that no two callers can disagree about them.
130
+ * `result.checks` is what was verified, for a wizard to render.
131
+ */
132
+ export async function ensureDatabase(options) {
133
+ const settings = databaseSettings(options.env);
134
+ if (settings === undefined) {
135
+ throw new UsageError('No environment to read the database settings from.');
136
+ }
137
+ const check = options.check ?? (async (context) => await runChecks(DATABASE_EXISTENCE_CHECKS, context));
138
+ const results = await check(checkContextFor(options));
139
+ for (const result of results)
140
+ options.onLine?.(`${result.status} ${result.id}: ${result.detail}`);
141
+ const failed = results.filter((result) => result.status === 'fail');
142
+ if (failed.length === 0) {
143
+ return {
144
+ outcome: 'exists',
145
+ database: settings.database,
146
+ detail: `database "${settings.database}" exists`,
147
+ checks: results,
148
+ };
149
+ }
150
+ // Rule 1: anything but "absent" is reported, not acted on.
151
+ if (!onlyDatabaseMissing(results)) {
152
+ throw new PreconditionError('The database is not usable with these settings:\n' +
153
+ failed.map((result) => ` - ${result.detail}\n ${result.remedy ?? ''}`).join('\n'));
154
+ }
155
+ // Refused before anything else is asked: a name we would not create is not
156
+ // worth a question.
157
+ assertCreatableDatabaseName(settings.database);
158
+ const capability = await canCreateDatabase(settings, options.runCommand);
159
+ if (capability.canCreate === false) {
160
+ throw new PreconditionError(`Database "${settings.database}" does not exist, and ${settings.user} is not allowed to create databases.\n` +
161
+ ` Either have an administrator grant it: ALTER ROLE "${settings.user}" CREATEDB;\n` +
162
+ ` or create it as a role that can: CREATE DATABASE "${settings.database}" OWNER "${settings.user}";`);
163
+ }
164
+ if (capability.canCreate === undefined) {
165
+ // Not a refusal: the CREATE below answers the question for certain.
166
+ options.onLine?.(`could not tell whether ${settings.user} may create databases (${capability.error ?? 'unknown'}); will try`);
167
+ }
168
+ const where = `${settings.host}:${settings.port}`;
169
+ const consent = await obtainConsent(`Database "${settings.database}" does not exist on ${where}. Create it now as ${settings.user}?`, {
170
+ flag: options.createDatabase,
171
+ nonInteractive: options.nonInteractive,
172
+ promptContext: options.promptContext,
173
+ ask: options.ask,
174
+ });
175
+ if (!consented(consent)) {
176
+ throw new PreconditionError((consent === 'declined'
177
+ ? `Database "${settings.database}" (POSTGRES_DB) does not exist on ${where}, and creating it was declined.\n`
178
+ : `Database "${settings.database}" (POSTGRES_DB) does not exist on ${where}. ` +
179
+ 'Nothing could be asked in this mode, so it was not created. Re-run with --create-database to create it.\n') +
180
+ ` ${remedyFor(settings, options.envPath)}`);
181
+ }
182
+ options.onLine?.(`Creating database "${settings.database}" on ${where}`);
183
+ const created = await runPsql(options.runCommand, settings, MAINTENANCE_DATABASE, createDatabaseStatement(settings.database));
184
+ // 42P04 duplicate_database: something else created it between the check and
185
+ // now. The goal -- it exists -- is met, so that is not a failure.
186
+ if (!created.ok && !/42P04|already exists/i.test(created.stderr)) {
187
+ throw new PreconditionError(`Could not create database "${settings.database}": ${firstLine(created.stderr)}\n ${remedyFor(settings, options.envPath)}`);
188
+ }
189
+ // Rule 4 (#396): re-verified, not assumed. The FULL set, so the checks that
190
+ // were skipped behind `database-exists` -- privileges above all -- give a
191
+ // real answer now, and a CREATE that "succeeded" against the wrong server is
192
+ // caught here rather than by the migration.
193
+ const verify = options.verify ?? (async (context) => await runChecks(DATABASE_CHECKS, context));
194
+ const verified = await verify(checkContextFor(options));
195
+ for (const result of verified)
196
+ options.onLine?.(`${result.status} ${result.id}: ${result.detail}`);
197
+ const blocking = verified.filter(blocksNewDatabase);
198
+ if (blocking.length > 0) {
199
+ throw new PreconditionError(`Created database "${settings.database}" on ${where}, but it is not usable yet:\n` +
200
+ blocking.map((result) => ` - ${result.id}: ${result.detail}\n ${result.remedy ?? ''}`).join('\n') +
201
+ '\nNothing was dropped; fix the above, then re-run with --resume.');
202
+ }
203
+ return {
204
+ outcome: 'created',
205
+ database: settings.database,
206
+ detail: `created database "${settings.database}" on ${where}`,
207
+ checks: verified,
208
+ };
209
+ }
210
+ /**
211
+ * The refusal `ensureDatabase` WILL give later, found before anything is
212
+ * cloned (#396) -- or undefined when there is none to give.
213
+ *
214
+ * For a run that cannot obtain consent (`--non-interactive` without
215
+ * `--create-database`): the database settings are already known, the
216
+ * database is missing, and nobody can be asked -- so the install is going to
217
+ * stop at `ensure-database` no matter what, and stopping at preflight instead
218
+ * spares the clone. Found by calling `ensureDatabase` itself with consent
219
+ * forced UNAVAILABLE, so the message is the same one and the CREATE is
220
+ * unreachable: no flag, no `ask`, `nonInteractive` -- it can only refuse.
221
+ *
222
+ * Any OTHER database problem (unreachable, bad password) answers undefined:
223
+ * `validate-environment` owns those, with the settings the run actually
224
+ * writes. This only ever pre-empts the one refusal that no later step could
225
+ * turn into a success.
226
+ */
227
+ export async function unattendedDatabaseRefusal(options) {
228
+ const check = options.check ?? (async (context) => await runChecks(DATABASE_EXISTENCE_CHECKS, context));
229
+ const results = await check(checkContextFor(options));
230
+ for (const result of results)
231
+ options.onLine?.(`${result.status} ${result.id}: ${result.detail}`);
232
+ if (!onlyDatabaseMissing(results))
233
+ return undefined;
234
+ try {
235
+ await ensureDatabase({
236
+ env: options.env,
237
+ runCommand: options.runCommand,
238
+ envPath: options.envPath,
239
+ createDatabase: false,
240
+ nonInteractive: true,
241
+ check: async () => results,
242
+ });
243
+ }
244
+ catch (error) {
245
+ return error instanceof Error ? error : new PreconditionError(String(error));
246
+ }
247
+ return undefined;
248
+ }
249
+ function firstLine(text) {
250
+ return text.split('\n').find((line) => line.trim() !== '') ?? 'failed';
251
+ }
252
+ //# sourceMappingURL=database.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"database.js","sourceRoot":"","sources":["../../../src/engine/deploy/database.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,48 @@
1
+ import type { DeploymentHistoryEntry, HostFacts } from './state.js';
2
+ /** The one value `schema` may hold. See rule 1 above. */
3
+ export declare const DEPLOY_INFO_SCHEMA_VERSION = 1;
4
+ export declare const DEPLOY_INFO_DIRNAME = "deploy-info";
5
+ export declare const DEPLOY_INFO_FILENAME = "info.json";
6
+ export interface DeployInfoInput {
7
+ name: string;
8
+ version?: string | undefined;
9
+ commitSha?: string | undefined;
10
+ ref?: string | undefined;
11
+ installedAt?: string | undefined;
12
+ updatedAt?: string | undefined;
13
+ cliVersion?: string | undefined;
14
+ domain?: string | undefined;
15
+ /** Step ids that completed, in order. */
16
+ completed?: readonly string[] | undefined;
17
+ failedStep?: string | undefined;
18
+ outcome?: 'success' | 'failure' | undefined;
19
+ /** Which command wrote this document (issue #392). */
20
+ lastCommand?: 'install' | 'update' | undefined;
21
+ /** Loopback port the proxy forwards to. */
22
+ bindPort?: number | undefined;
23
+ /** How the shared proxy publishes this deployment; absent means not known. */
24
+ proxy?: {
25
+ mode?: 'container' | 'host' | null | undefined;
26
+ container?: string | null | undefined;
27
+ certificateExpiresAt?: string | null | undefined;
28
+ } | undefined;
29
+ /** The host, as `collectHostFacts` observed it; absent means not known. */
30
+ host?: HostFacts | undefined;
31
+ /** The deployment state's own history -- the SAME entries, newest first. */
32
+ history?: readonly DeploymentHistoryEntry[] | undefined;
33
+ }
34
+ export declare function buildDeployInfo(input: DeployInfoInput): Record<string, unknown>;
35
+ export declare function deployInfoPath(deployRoot: string): string;
36
+ /**
37
+ * Writes the document atomically into the bind-mounted directory.
38
+ *
39
+ * ⚠ NEVER THROWS. This is BOOKKEEPING ABOUT a deployment, not the deployment:
40
+ * it runs after the API is answering, so a failure here must not fail a run
41
+ * that has already succeeded. The caller journals what came back.
42
+ */
43
+ export declare function writeDeployInfo(deployRoot: string, input: DeployInfoInput): {
44
+ written: boolean;
45
+ path: string;
46
+ error?: string | undefined;
47
+ };
48
+ //# sourceMappingURL=deploy-info.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deploy-info.d.ts","sourceRoot":"","sources":["../../../src/engine/deploy/deploy-info.ts"],"names":[],"mappings":"AA4DA,OAAO,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEpE,yDAAyD;AACzD,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AACjD,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yCAAyC;IACzC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,sDAAsD;IACtD,WAAW,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC/C,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,8EAA8E;IAC9E,KAAK,CAAC,EACF;QACE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QAC/C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QACtC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;KAClD,GACD,SAAS,CAAC;IACd,2EAA2E;IAC3E,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,4EAA4E;IAC5E,OAAO,CAAC,EAAE,SAAS,sBAAsB,EAAE,GAAG,SAAS,CAAC;CACzD;AAOD,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqE/E;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,eAAe,GACrB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAgBhE"}