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

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 +365 -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,826 @@
1
+ import { createHash, createHmac, pbkdf2Sync, randomBytes } from 'node:crypto';
2
+ import { cliIdentity, cliName, envVar, hasCliIdentity } from '../identity.js';
3
+ import { PreconditionError, UsageError } from '../errors.js';
4
+ import { MAINTENANCE_DATABASE, databaseSettings, readRoleAttributes, runPsql, runPsqlScript, } from './checks/index.js';
5
+ import { canPrompt, promptSecret } from '../prompt.js';
6
+ import { consented, obtainConsent } from './consent.js';
7
+ import { metadataFor } from './env-metadata.js';
8
+ import { CREATABLE_DATABASE_NAME } from './database.js';
9
+ // =============================================================================
10
+ // The dedicated application database role (issue #980; builds on #725 PP-6.5)
11
+ // =============================================================================
12
+ //
13
+ // `deploy install` used to write whatever login the operator typed into `.env`
14
+ // as POSTGRES_USER / POSTGRES_PASSWORD. Operators naturally typed an
15
+ // ADMINISTRATIVE login (`postgres`, an RDS master user), the API then ran as a
16
+ // superuser, and row-level security -- which a superuser and a BYPASSRLS role
17
+ // skip entirely -- was inert: every organization could read every other's rows.
18
+ // The Doctor said so only after the deployment was live.
19
+ //
20
+ // So the install provisions the role the API runs as. RULES, each pinned by a
21
+ // test:
22
+ //
23
+ // 1. THE ADMINISTRATIVE LOGIN IS USED ONCE AND NEVER KEPT. It is held in
24
+ // memory for the run: never in `.env`, the journal, the state file or an
25
+ // error. What `.env` receives is the application role.
26
+ // 2. THE PASSWORD IS GENERATED, NEVER PROMPTED. 32 random bytes, base64url.
27
+ // It reaches the server as a SCRAM-SHA-256 VERIFIER on psql's stdin -- not
28
+ // argv (`ps`, the journal's argv record), and not as plaintext in the
29
+ // server's statement log. It is shown only on request (`--show-credentials`).
30
+ // 3. IDEMPOTENT, ROTATED ONLY ON REQUEST. A role that exists and whose
31
+ // recorded credentials still authenticate is reused untouched. A new
32
+ // password is set only for `--rotate-app-password`, or when the role exists
33
+ // and nothing on record opens it (a crashed first run).
34
+ // 4. OWNERSHIP IS TRANSFERRED OBJECT BY OBJECT (`ALTER ... OWNER TO`), NEVER
35
+ // `REASSIGN OWNED BY`, which also moves objects in other databases and
36
+ // cluster-level objects. Changing the owner of an existing, non-empty
37
+ // database needs consent.
38
+ // 5. NEVER SILENTLY WEAKER. Where the administrator cannot grant CREATEROLE or
39
+ // `createrole_self_grant` (managed providers), that is said, with what
40
+ // stops working, and proceeding needs consent.
41
+ // 6. ONE FUNCTION. `ensureApplicationRole` is THE detect-offer-provision
42
+ // behaviour. install's `environment` step and update's `database-role` step
43
+ // both call it, and a fork's own wizard must too -- the argument
44
+ // `ensureDatabase` makes (database.ts): two copies of a gate drift.
45
+ // =============================================================================
46
+ /** The role names this will create: the same conservative grammar as database names. */
47
+ export const CREATABLE_ROLE_NAME = CREATABLE_DATABASE_NAME;
48
+ const MAX_IDENTIFIER_BYTES = 63;
49
+ /** The `rolname` of the PostgreSQL default superuser; never a name to create. */
50
+ const RESERVED_ROLE = /^(pg_|postgres$|public$)/i;
51
+ /** Throws a UsageError unless `name` is a role this will create. */
52
+ export function assertCreatableRoleName(name) {
53
+ if (!CREATABLE_ROLE_NAME.test(name) ||
54
+ Buffer.byteLength(name) > MAX_IDENTIFIER_BYTES ||
55
+ RESERVED_ROLE.test(name)) {
56
+ throw new UsageError(`"${name}" is not a role name this will create: it must match ${CREATABLE_ROLE_NAME.source}, ` +
57
+ `be at most ${MAX_IDENTIFIER_BYTES} bytes, and not be "postgres", "public" or start with "pg_". ` +
58
+ 'Pass another --app-db-user, or create the role by hand and pass --skip-role-provisioning.');
59
+ }
60
+ }
61
+ /** Validates, then double-quotes. The only way an identifier reaches a statement. */
62
+ export function quoteRole(name) {
63
+ assertCreatableRoleName(name);
64
+ return `"${name}"`;
65
+ }
66
+ /** Quotes an administrative login for GRANT, which may be any name the server holds. */
67
+ function quoteAny(name) {
68
+ return `"${name.replace(/"/g, '""')}"`;
69
+ }
70
+ function literal(value) {
71
+ return `'${value.replace(/'/g, "''")}'`;
72
+ }
73
+ /**
74
+ * `<app>_app`, from the product identity the CLI was configured with (the
75
+ * repository name), so two applications on one cluster do not share a role.
76
+ */
77
+ export function defaultAppRoleName() {
78
+ const repo = hasCliIdentity() ? (cliIdentity().repoSlug.split('/')[1] ?? '') : '';
79
+ const slug = repo
80
+ .toLowerCase()
81
+ .replace(/[^a-z0-9]+/g, '_')
82
+ .replace(/^_+|_+$/g, '');
83
+ const start = slug === '' ? 'app' : /^[a-z]/.test(slug) && !slug.startsWith('pg_') ? slug : `app_${slug}`;
84
+ const base = start.slice(0, MAX_IDENTIFIER_BYTES - '_app'.length);
85
+ return base.endsWith('_app') ? base : `${base}_app`;
86
+ }
87
+ /** 32 random bytes, URL-safe. Never prompted, never printed unless asked. */
88
+ export function generateAppPassword() {
89
+ return randomBytes(32).toString('base64url');
90
+ }
91
+ /**
92
+ * The SCRAM-SHA-256 verifier PostgreSQL stores for a password (RFC 5802 as
93
+ * PostgreSQL writes it). Sent instead of the password, so the plaintext is
94
+ * never in a statement the server may log.
95
+ */
96
+ export function scramSha256Verifier(password, salt = randomBytes(16)) {
97
+ const iterations = 4096;
98
+ const salted = pbkdf2Sync(password, salt, iterations, 32, 'sha256');
99
+ const clientKey = createHmac('sha256', salted).update('Client Key').digest();
100
+ const storedKey = createHash('sha256').update(clientKey).digest();
101
+ const serverKey = createHmac('sha256', salted).update('Server Key').digest();
102
+ return `SCRAM-SHA-256$${iterations}:${salt.toString('base64')}$${storedKey.toString('base64')}:${serverKey.toString('base64')}`;
103
+ }
104
+ // -- statements ---------------------------------------------------------------
105
+ //
106
+ // Built from validated, quoted identifiers; the one value (the verifier) is
107
+ // base64 and `$`/`:`, so quoting it as a literal cannot be broken out of.
108
+ /**
109
+ * The attributes the role is created with; CREATEROLE follows separately (see
110
+ * grants). NO PASSWORD: it is set last (`setPasswordStatement`), after `.env`
111
+ * holds it, so a failure part-way never leaves a password nobody has.
112
+ */
113
+ export function createRoleStatement(role) {
114
+ return `CREATE ROLE ${quoteRole(role)} LOGIN NOSUPERUSER NOBYPASSRLS CREATEDB`;
115
+ }
116
+ export function setPasswordStatement(role, verifier) {
117
+ return `ALTER ROLE ${quoteRole(role)} PASSWORD ${literal(verifier)}`;
118
+ }
119
+ /** A role that exists but cannot log in (NOLOGIN) is enabled, not left to fail at pg_hba. */
120
+ export function enableLoginStatement(role) {
121
+ return `ALTER ROLE ${quoteRole(role)} LOGIN`;
122
+ }
123
+ /** So the node-offload broker can mint per-job roles, as 10-application-role.sh does. */
124
+ export function grantCreateRoleStatement(role) {
125
+ return `ALTER ROLE ${quoteRole(role)} CREATEROLE`;
126
+ }
127
+ /**
128
+ * PostgreSQL 16: a non-superuser CREATEROLE role is given ADMIN but neither
129
+ * INHERIT nor SET on a role it creates, so it could create a job role and then
130
+ * not DROP OWNED BY it. Restore and worker-node dumps depend on this.
131
+ */
132
+ export function selfGrantStatement(role) {
133
+ return `ALTER ROLE ${quoteRole(role)} SET createrole_self_grant = 'inherit, set'`;
134
+ }
135
+ export function grantMembershipStatement(role, admin) {
136
+ return `GRANT ${quoteRole(role)} TO ${quoteAny(admin)}`;
137
+ }
138
+ export function revokeMembershipStatement(role, admin) {
139
+ return `REVOKE ${quoteRole(role)} FROM ${quoteAny(admin)}`;
140
+ }
141
+ /** The relation kinds that carry an owner we move: tables, partitioned, views, materialized, foreign, sequences, composite types. */
142
+ const OWNED_RELATIONS = `('r','p','v','m','f','S','c')`;
143
+ /** A sequence a column owns (serial/identity): it follows its table and cannot be re-owned alone. */
144
+ const LINKED_SEQUENCE = (alias) => `(${alias}.relkind = 'S' and exists (select 1 from pg_depend l where l.classid = 'pg_class'::regclass and l.objid = ${alias}.oid and l.refclassid = 'pg_class'::regclass and l.deptype in ('a','i')))`;
145
+ function ownerInfoStatement(role) {
146
+ assertCreatableRoleName(role);
147
+ const owner = literal(role);
148
+ const extension = (catalog, alias) => `not exists (select 1 from pg_depend e where e.classid = '${catalog}'::regclass and e.objid = ${alias}.oid and e.deptype = 'e')`;
149
+ const objects = `c.relnamespace = s.oid and c.relkind in ${OWNED_RELATIONS} and ${extension('pg_class', 'c')}`;
150
+ return (`select pg_get_userbyid(d.datdba) || '|' || pg_get_userbyid(s.nspowner) || '|' || ` +
151
+ // What would MOVE: extension members are never re-owned, a column-linked sequence follows its table.
152
+ `((select count(*) from pg_class c where ${objects} and not ${LINKED_SEQUENCE('c')} and pg_get_userbyid(c.relowner) <> ${owner}) + ` +
153
+ `(select count(*) from pg_type t where t.typnamespace = s.oid and t.typtype in ('e','d','r') and pg_get_userbyid(t.typowner) <> ${owner} and ${extension('pg_type', 't')}) + ` +
154
+ `(select count(*) from pg_proc p where p.pronamespace = s.oid and p.prokind in ('f','p') and pg_get_userbyid(p.proowner) <> ${owner} and ${extension('pg_proc', 'p')})) || '|' || ` +
155
+ // What is THERE (for "does this database hold data").
156
+ `(select count(*) from pg_class c where ${objects}) ` +
157
+ `from pg_database d, pg_namespace s where d.datname = current_database() and s.nspname = 'public'`);
158
+ }
159
+ /**
160
+ * Moves the database, schema `public` and every object in it to `role`, in ONE
161
+ * transaction. Object by object with `ALTER ... OWNER TO`; there is no
162
+ * `REASSIGN OWNED BY` here and a test keeps it that way (it also rewrites
163
+ * ownership in OTHER databases and of cluster objects the role never owned).
164
+ *
165
+ * Extension-owned objects are skipped (they cannot be re-owned). A sequence a
166
+ * column owns follows its table; one that is still owned by someone else when
167
+ * its table is the role's is granted to the role instead, so the role can use
168
+ * it. The database name is quoted, not validated: this only ever alters a
169
+ * database that already exists, whatever it is called.
170
+ */
171
+ export function ownershipScript(role, database) {
172
+ const target = literal(role);
173
+ const notExtension = (catalog) => `NOT EXISTS (SELECT 1 FROM pg_depend e WHERE e.classid = '${catalog}'::regclass AND e.objid = o.oid AND e.deptype = 'e')`;
174
+ return [
175
+ 'BEGIN;',
176
+ `ALTER DATABASE ${quoteAny(database)} OWNER TO ${quoteRole(role)};`,
177
+ 'DO $ownership$',
178
+ 'DECLARE',
179
+ ` target constant text := ${target};`,
180
+ ' item record;',
181
+ 'BEGIN',
182
+ // PostgreSQL 15+: `public` belongs to pg_database_owner, which is the new database owner already.
183
+ " IF (SELECT pg_get_userbyid(nspowner) FROM pg_namespace WHERE nspname = 'public') NOT IN (target, 'pg_database_owner') THEN",
184
+ " EXECUTE format('ALTER SCHEMA public OWNER TO %I', target);",
185
+ ' END IF;',
186
+ ' FOR item IN',
187
+ " SELECT o.relname AS name, CASE o.relkind WHEN 'v' THEN 'VIEW' WHEN 'm' THEN 'MATERIALIZED VIEW' WHEN 'f' THEN 'FOREIGN TABLE' WHEN 'c' THEN 'TYPE' ELSE 'TABLE' END AS kind",
188
+ ' FROM pg_class o JOIN pg_namespace n ON n.oid = o.relnamespace',
189
+ ` WHERE n.nspname = 'public' AND o.relkind IN ('r','p','v','m','f','c') AND pg_get_userbyid(o.relowner) <> target AND ${notExtension('pg_class')}`,
190
+ ' ORDER BY o.oid',
191
+ ' LOOP',
192
+ " EXECUTE format('ALTER %s public.%I OWNER TO %I', item.kind, item.name, target);",
193
+ ' END LOOP;',
194
+ ' FOR item IN',
195
+ ' SELECT o.relname AS name, EXISTS (SELECT 1 FROM pg_depend l WHERE l.classid = \'pg_class\'::regclass AND l.objid = o.oid AND l.refclassid = \'pg_class\'::regclass AND l.deptype IN (\'a\',\'i\')) AS linked',
196
+ ' FROM pg_class o JOIN pg_namespace n ON n.oid = o.relnamespace',
197
+ ` WHERE n.nspname = 'public' AND o.relkind = 'S' AND pg_get_userbyid(o.relowner) <> target AND ${notExtension('pg_class')}`,
198
+ ' ORDER BY o.oid',
199
+ ' LOOP',
200
+ ' IF item.linked THEN',
201
+ " EXECUTE format('GRANT ALL ON SEQUENCE public.%I TO %I', item.name, target);",
202
+ ' ELSE',
203
+ " EXECUTE format('ALTER SEQUENCE public.%I OWNER TO %I', item.name, target);",
204
+ ' END IF;',
205
+ ' END LOOP;',
206
+ ' FOR item IN',
207
+ " SELECT o.typname AS name, CASE o.typtype WHEN 'd' THEN 'DOMAIN' ELSE 'TYPE' END AS kind",
208
+ ' FROM pg_type o JOIN pg_namespace n ON n.oid = o.typnamespace',
209
+ ` WHERE n.nspname = 'public' AND o.typtype IN ('e','d','r') AND pg_get_userbyid(o.typowner) <> target AND ${notExtension('pg_type')}`,
210
+ ' ORDER BY o.oid',
211
+ ' LOOP',
212
+ " EXECUTE format('ALTER %s public.%I OWNER TO %I', item.kind, item.name, target);",
213
+ ' END LOOP;',
214
+ ' FOR item IN',
215
+ " SELECT o.oid::regprocedure::text AS name, CASE o.prokind WHEN 'p' THEN 'PROCEDURE' ELSE 'FUNCTION' END AS kind",
216
+ ' FROM pg_proc o JOIN pg_namespace n ON n.oid = o.pronamespace',
217
+ ` WHERE n.nspname = 'public' AND o.prokind IN ('f','p') AND pg_get_userbyid(o.proowner) <> target AND ${notExtension('pg_proc')}`,
218
+ ' ORDER BY o.oid',
219
+ ' LOOP',
220
+ " EXECUTE format('ALTER %s %s OWNER TO %I', item.kind, item.name, target);",
221
+ ' END LOOP;',
222
+ 'END',
223
+ '$ownership$;',
224
+ 'COMMIT;',
225
+ '',
226
+ ].join('\n');
227
+ }
228
+ /**
229
+ * The role a run provisions: the flag; else the application login a previous
230
+ * run recorded (so a re-run finds ITS role instead of making a second); else
231
+ * `<app>_app`. A recorded name that is the administrative login, or one this
232
+ * would not create (`postgres`), is no application role and is passed over.
233
+ */
234
+ export function plannedRoleName(input) {
235
+ if (input.flag !== undefined)
236
+ return input.flag;
237
+ const recorded = input.recordedUser;
238
+ if (recorded !== undefined &&
239
+ recorded !== input.adminUser &&
240
+ CREATABLE_ROLE_NAME.test(recorded) &&
241
+ Buffer.byteLength(recorded) <= MAX_IDENTIFIER_BYTES &&
242
+ !RESERVED_ROLE.test(recorded)) {
243
+ return recorded;
244
+ }
245
+ return defaultAppRoleName();
246
+ }
247
+ /** The answers-file keys that feed `AppRoleOptions`; none of them ever reaches `.env`. */
248
+ export const APP_ROLE_ANSWER_KEYS = ['DB_ADMIN_USER', 'DB_ADMIN_PASSWORD', 'APP_DB_USER'];
249
+ /**
250
+ * Splits the role keys out of an answers map. They are INPUT to provisioning,
251
+ * not environment: left in the map they would be written to `.env` as unknown
252
+ * keys -- the administrative password included, which must never be on disk.
253
+ */
254
+ export function extractRoleAnswers(answers) {
255
+ if (answers === undefined)
256
+ return { answers: undefined, role: {} };
257
+ const rest = new Map(answers);
258
+ const take = (key) => {
259
+ const value = rest.get(key);
260
+ rest.delete(key);
261
+ return value === undefined || value === '' ? undefined : value;
262
+ };
263
+ const adminUser = take('DB_ADMIN_USER');
264
+ const adminPassword = take('DB_ADMIN_PASSWORD');
265
+ const appDbUser = take('APP_DB_USER');
266
+ return {
267
+ answers: rest.size === 0 ? undefined : rest,
268
+ role: {
269
+ ...(adminUser === undefined ? {} : { adminUser }),
270
+ ...(adminPassword === undefined ? {} : { adminPassword }),
271
+ ...(appDbUser === undefined ? {} : { appDbUser }),
272
+ },
273
+ };
274
+ }
275
+ /**
276
+ * The explicit administrative login, or undefined when none was named. The
277
+ * password comes from the options (an answers file), then the environment
278
+ * (`<PREFIX>DB_ADMIN_PASSWORD`, so it is in neither argv nor shell history),
279
+ * then -- on a terminal -- a masked prompt. It is held in memory only.
280
+ */
281
+ export async function resolveAdminLogin(options, prompt) {
282
+ if (options.adminUser === undefined)
283
+ return undefined;
284
+ const fromEnvironment = process.env[envVar('DB_ADMIN_PASSWORD')];
285
+ const supplied = options.adminPassword ?? (fromEnvironment === '' ? undefined : fromEnvironment);
286
+ if (supplied !== undefined)
287
+ return { user: options.adminUser, password: supplied };
288
+ if (prompt.nonInteractive !== true && canPrompt(prompt.promptContext)) {
289
+ const typed = await promptSecret(` Password for the administrative login "${options.adminUser}" (used once, not saved): `, prompt.promptContext);
290
+ if (typed !== '')
291
+ return { user: options.adminUser, password: typed };
292
+ }
293
+ throw new UsageError(`--admin-user ${options.adminUser} needs its password. It is never a flag: set ${envVar('DB_ADMIN_PASSWORD')} in the environment, ` +
294
+ 'or put DB_ADMIN_PASSWORD in the answers file (neither is written to .env).');
295
+ }
296
+ /**
297
+ * The wizard's view of POSTGRES_USER / POSTGRES_PASSWORD when an explicit
298
+ * administrative login is in use: they are decided by provisioning, so they are
299
+ * not asked. Both are overwritten with the real values before anything is written.
300
+ */
301
+ export function provisioningMetadata(role) {
302
+ return (key) => {
303
+ const base = metadataFor(key);
304
+ if (key === 'POSTGRES_USER')
305
+ return { ...base, essential: false, fixed: role };
306
+ if (key === 'POSTGRES_PASSWORD')
307
+ return { ...base, essential: false, fixed: '(set by role provisioning)' };
308
+ return base;
309
+ };
310
+ }
311
+ /**
312
+ * The wizard's view of POSTGRES_USER when the operator is simply asked for a
313
+ * login: the prompt says an administrative one is fine, because it is used once
314
+ * and replaced. (`metadataFor` itself stays as it was: it is pinned by
315
+ * env-metadata-equivalence.test.ts, and this help belongs to install.)
316
+ */
317
+ export function loginHelpMetadata(key) {
318
+ const base = metadataFor(key);
319
+ if (key !== 'POSTGRES_USER')
320
+ return base;
321
+ return {
322
+ ...base,
323
+ help: 'The database login. An administrative login is fine: it is used once to create a dedicated\n' +
324
+ 'ordinary role for the application (row-level security does not apply to a superuser), and the\n' +
325
+ "role's generated credentials, not these, are saved to .env.",
326
+ };
327
+ }
328
+ /** The options `ensureApplicationRole` takes from the shared flags. */
329
+ export function roleOptionsFrom(options, admin) {
330
+ return {
331
+ admin,
332
+ roleName: options.appDbUser,
333
+ skip: options.skipRoleProvisioning,
334
+ allowSuperuser: options.allowSuperuser,
335
+ rotate: options.rotateAppPassword,
336
+ provisionConsent: options.provisionAppRole,
337
+ transferOwnership: options.transferOwnership,
338
+ allowReducedRole: options.allowReducedRole,
339
+ nonInteractive: options.nonInteractive,
340
+ promptContext: options.promptContext,
341
+ ask: options.ask,
342
+ };
343
+ }
344
+ function unchanged(outcome, detail) {
345
+ return { outcome, detail, created: false, ownershipTransferred: false, degraded: [] };
346
+ }
347
+ function firstLine(text) {
348
+ return text.split('\n').find((line) => line.trim() !== '') ?? 'failed';
349
+ }
350
+ function parseRoleRow(stdout) {
351
+ const fields = stdout.trim().split('|');
352
+ if (fields.length !== 5 || fields.some((field) => field !== 't' && field !== 'f'))
353
+ return undefined;
354
+ return {
355
+ superuser: fields[0] === 't',
356
+ bypassRls: fields[1] === 't',
357
+ createRole: fields[2] === 't',
358
+ createDb: fields[3] === 't',
359
+ canLogin: fields[4] === 't',
360
+ };
361
+ }
362
+ function parseOwnerInfo(stdout) {
363
+ const fields = stdout.trim().split('|');
364
+ if (fields.length !== 4)
365
+ return undefined;
366
+ const toMove = Number(fields[2]);
367
+ const total = Number(fields[3]);
368
+ if (!Number.isInteger(toMove) || !Number.isInteger(total))
369
+ return undefined;
370
+ return { databaseOwner: fields[0], schemaOwner: fields[1], toMove, total };
371
+ }
372
+ /** A failure that means "the administrator is not allowed to", on a managed provider above all. */
373
+ const NOT_PERMITTED = /permission denied|must have createrole|must be superuser|not permitted|insufficient_privilege|42501/i;
374
+ /** The sentence that says what a missing attribute costs. */
375
+ const CONSEQUENCE = {
376
+ CREATEROLE: 'worker-node offload cannot mint per-job roles for database dumps (a node-eligible job that needs one fails)',
377
+ createrole_self_grant: "database restore and worker-node dumps cannot use or drop the roles the application creates (PostgreSQL 16 gives a CREATEROLE role ADMIN but neither INHERIT nor SET on a role it creates)",
378
+ CREATEDB: 'database restore cannot create, rename or drop databases',
379
+ };
380
+ /**
381
+ * Makes sure the deployment runs as a dedicated, ordinary role: detects a
382
+ * privileged login, offers to provision a role, provisions it, and moves
383
+ * ownership of the application database to it.
384
+ *
385
+ * ⚠ THIS IS THE ONE IMPLEMENTATION (#980). install's `environment` step and
386
+ * update's `database-role` step call it, and a fork's own wizard MUST call it
387
+ * rather than reimplement any part of "detect, offer, provision, transfer":
388
+ * the consent rules, the statements and the refusals are all here so that no
389
+ * two callers can disagree about them.
390
+ *
391
+ * ORDER OF EFFECTS, because a password lost between the server and `.env` locks
392
+ * the application out of its own database:
393
+ *
394
+ * 1. everything is read and every consent obtained before the server is
395
+ * touched, so a "no", a refusal or an unreadable answer changes nothing;
396
+ * 2. then the role, its attributes and the ownership (none of which carry a
397
+ * secret);
398
+ * 3. the PASSWORD LAST: the new login is written to `.env` first
399
+ * (`options.store`, atomic, 0600), then `ALTER ROLE ... PASSWORD`, then the
400
+ * role logs in once as proof. A failure at the `ALTER` puts the old `.env`
401
+ * back; a failure after it keeps the password the server now has.
402
+ */
403
+ export async function ensureApplicationRole(options) {
404
+ const progress = { mutated: false };
405
+ try {
406
+ return await provision(options, progress);
407
+ }
408
+ catch (error) {
409
+ // update must not start failing on a deployment that predates this: anything
410
+ // that goes wrong BEFORE the server was changed is a warning there, not a failure.
411
+ if (!progress.mutated &&
412
+ options.whenNotConsented === 'warn' &&
413
+ (error instanceof PreconditionError || error instanceof UsageError)) {
414
+ options.onLine?.(error.message);
415
+ return unchanged('declined', error.message);
416
+ }
417
+ throw error;
418
+ }
419
+ }
420
+ /**
421
+ * Whether `user` opens `database` with `password`. Only a rejected PASSWORD is
422
+ * `rejected`: a pg_hba.conf refusal, a revoked CONNECT, a timeout or anything
423
+ * else is `unknown`, because resetting a password fixes none of them.
424
+ */
425
+ async function probeLogin(run, settings, database) {
426
+ const answer = await runPsql(run, settings, database, 'select 1');
427
+ if (answer.ok)
428
+ return { result: 'ok', detail: '' };
429
+ if (/28P01|password authentication failed/i.test(answer.stderr)) {
430
+ return { result: 'rejected', detail: firstLine(answer.stderr) };
431
+ }
432
+ return { result: 'unknown', detail: firstLine(answer.stderr) };
433
+ }
434
+ async function provision(options, progress) {
435
+ const line = (text) => options.onLine?.(text);
436
+ const entered = databaseSettings(options.env);
437
+ if (entered === undefined)
438
+ throw new UsageError('No environment to read the database settings from.');
439
+ if (options.skip === true) {
440
+ line('--skip-role-provisioning: no role is created; database-role-ordinary verifies the one supplied');
441
+ return unchanged('skipped', 'role provisioning skipped');
442
+ }
443
+ const explicit = options.admin !== undefined;
444
+ const connection = explicit
445
+ ? { ...entered, user: options.admin.user, password: options.admin.password }
446
+ : entered;
447
+ const adminName = connection.user;
448
+ // 1. Who is this login?
449
+ const probe = await readRoleAttributes(options.runCommand, connection);
450
+ if (probe.attributes === undefined) {
451
+ if (explicit) {
452
+ throw new PreconditionError(`Could not connect to ${connection.host}:${connection.port} as the administrative login "${adminName}": ${probe.error ?? 'unknown error'}\n` +
453
+ ' Check --admin-user and the administrative password.');
454
+ }
455
+ line(`could not tell whether ${adminName} is an ordinary role (${probe.error ?? 'unknown'}); the database checks report it`);
456
+ return unchanged('unknown', 'the database could not be queried');
457
+ }
458
+ const attributes = probe.attributes;
459
+ const privileged = attributes.superuser || attributes.bypassRls;
460
+ if (!explicit && !privileged) {
461
+ if (options.rotate === true)
462
+ return await rotateOwnPassword(options, entered, progress);
463
+ line(`${adminName} is an ordinary role: nothing to provision`);
464
+ return unchanged('ordinary', `${adminName} is an ordinary role`);
465
+ }
466
+ if (!explicit && options.allowSuperuser === true) {
467
+ line(`--allow-superuser: running as ${adminName}, ${privilegeWords(attributes)}. Row-level security is INERT: every organization can read every other organization's rows.`);
468
+ return unchanged('superuser-allowed', `${adminName} kept (tenant isolation OFF)`);
469
+ }
470
+ // 2. The role this will provision.
471
+ const recorded = options.recordedEnv;
472
+ const roleName = plannedRoleName({
473
+ flag: options.roleName,
474
+ recordedUser: recorded?.get('POSTGRES_USER'),
475
+ adminUser: adminName,
476
+ });
477
+ assertCreatableRoleName(roleName);
478
+ if (roleName === adminName) {
479
+ throw new UsageError(`The application role cannot be the administrative login "${adminName}". Pass a different --app-db-user.`);
480
+ }
481
+ const existingPassword = recorded?.get('POSTGRES_USER') === roleName ? recorded.get('POSTGRES_PASSWORD') : undefined;
482
+ const notConsented = (reason) => {
483
+ if (options.whenNotConsented === 'warn') {
484
+ line(reason);
485
+ return unchanged('declined', reason);
486
+ }
487
+ throw new PreconditionError(reason);
488
+ };
489
+ // 3. Consent to provision at all. An explicit administrative login IS that
490
+ // consent: the operator supplied it for this purpose.
491
+ if (!explicit) {
492
+ const consent = await obtainConsent(`"${adminName}" is ${privilegeWords(attributes)}, so row-level security would be inert and every organization could read every other's data. ` +
493
+ `Create a dedicated ordinary role "${roleName}" now, using "${adminName}" once (its password is held in memory and not saved)?`, {
494
+ flag: options.provisionConsent,
495
+ nonInteractive: options.nonInteractive,
496
+ promptContext: options.promptContext,
497
+ ask: options.ask,
498
+ });
499
+ if (!consented(consent)) {
500
+ return notConsented((consent === 'declined'
501
+ ? `Provisioning a dedicated database role was declined, and "${adminName}" is ${privilegeWords(attributes)}.`
502
+ : `"${adminName}" is ${privilegeWords(attributes)}, and nothing could be asked in this mode.`) +
503
+ ` Row-level security would be inert. Re-run with --provision-app-role to create "${roleName}" and move the deployment onto it, ` +
504
+ 'pass --skip-role-provisioning with an ordinary POSTGRES_USER, or --allow-superuser to run as this login knowingly.');
505
+ }
506
+ }
507
+ const maintenance = { ...connection, database: MAINTENANCE_DATABASE };
508
+ // 4. What is there already: the role, the database, who owns what.
509
+ const roleProbe = await runPsql(options.runCommand, maintenance, MAINTENANCE_DATABASE, `select rolsuper, rolbypassrls, rolcreaterole, rolcreatedb, rolcanlogin from pg_roles where rolname = ${literal(roleName)}`);
510
+ if (!roleProbe.ok)
511
+ throw new PreconditionError(`Could not look up role "${roleName}": ${firstLine(roleProbe.stderr)}`);
512
+ const existing = roleProbe.stdout.trim() === '' ? undefined : parseRoleRow(roleProbe.stdout);
513
+ if (roleProbe.stdout.trim() !== '' && existing === undefined) {
514
+ throw new PreconditionError(`Could not read the attributes of role "${roleName}" (unexpected answer).`);
515
+ }
516
+ if (existing !== undefined && (existing.superuser || existing.bypassRls)) {
517
+ throw new PreconditionError(`Role "${roleName}" already exists and is ${privilegeWords(existing)}. It is not altered or used. ` +
518
+ 'Choose another name with --app-db-user, or fix the role yourself: ' +
519
+ `ALTER ROLE ${quoteRole(roleName)} NOSUPERUSER NOBYPASSRLS;`);
520
+ }
521
+ const databaseProbe = await runPsql(options.runCommand, maintenance, MAINTENANCE_DATABASE, `select 1 from pg_database where datname = ${literal(entered.database)}`);
522
+ const databaseExists = databaseProbe.ok && databaseProbe.stdout.trim() === '1';
523
+ // The role is proven, and its recorded password probed, against the database
524
+ // it will actually use once that exists: the maintenance database says nothing
525
+ // about CONNECT on the application database or a pg_hba.conf line for it.
526
+ const probeDatabase = databaseExists ? entered.database : MAINTENANCE_DATABASE;
527
+ let owners;
528
+ if (databaseExists) {
529
+ const info = await runPsql(options.runCommand, connection, entered.database, ownerInfoStatement(roleName));
530
+ if (!info.ok) {
531
+ throw new PreconditionError(`Could not read who owns database "${entered.database}": ${firstLine(info.stderr)}`);
532
+ }
533
+ owners = parseOwnerInfo(info.stdout);
534
+ if (owners === undefined)
535
+ line(`could not read the ownership of "${entered.database}"; ownership is left as it is`);
536
+ }
537
+ const needsTransfer = owners !== undefined &&
538
+ (owners.databaseOwner !== roleName ||
539
+ (owners.schemaOwner !== roleName && owners.schemaOwner !== 'pg_database_owner') ||
540
+ owners.toMove > 0);
541
+ // 5. Consent to change the owner of an existing, non-empty database.
542
+ if (needsTransfer && owners !== undefined && owners.total > 0) {
543
+ line(`Database "${entered.database}" already holds ${owners.total} object(s); the database is owned by ${owners.databaseOwner}. ` +
544
+ `They will be re-owned to "${roleName}" with ALTER ... OWNER TO (never REASSIGN OWNED BY). Take a backup first: pg_dump, or your provider's snapshot.`);
545
+ const consent = await obtainConsent(`Change the owner of "${entered.database}" and its ${owners.total} existing object(s) to "${roleName}"? A backup is recommended and this is hard to undo.`, {
546
+ flag: options.transferOwnership,
547
+ nonInteractive: options.nonInteractive,
548
+ promptContext: options.promptContext,
549
+ ask: options.ask,
550
+ });
551
+ if (!consented(consent)) {
552
+ return notConsented((consent === 'declined'
553
+ ? `Changing the owner of database "${entered.database}" was declined.`
554
+ : `Database "${entered.database}" already holds data and changing its owner needs consent; nothing could be asked in this mode.`) +
555
+ ' Nothing was changed. Back up the database, then re-run with --transfer-ownership.');
556
+ }
557
+ }
558
+ // 6. The password: reuse what authenticates. A role that ALREADY EXISTS is
559
+ // somebody's -- staging and production of one fork on one cluster default to
560
+ // the same `<repo>_app` -- so its password is never reset because the
561
+ // credentials on record merely fail: that needs --rotate-app-password, or a
562
+ // yes that names the role.
563
+ let reuse = false;
564
+ if (existing !== undefined && options.rotate !== true) {
565
+ if (existingPassword !== undefined && existingPassword !== '') {
566
+ const login = await probeLogin(options.runCommand, { ...maintenance, user: roleName, password: existingPassword }, probeDatabase);
567
+ if (login.result === 'ok') {
568
+ reuse = true;
569
+ }
570
+ else if (login.result === 'unknown') {
571
+ throw new PreconditionError(`Could not check the credentials on record for role "${roleName}" (${login.detail}). ` +
572
+ 'That is not a wrong password (a pg_hba.conf line, a revoked CONNECT or the network), so its password was left as it is. ' +
573
+ 'Fix the connection and re-run; --rotate-app-password sets a new password regardless.');
574
+ }
575
+ }
576
+ if (!reuse) {
577
+ const why = existingPassword === undefined || existingPassword === ''
578
+ ? 'nothing on record opens it'
579
+ : 'the password on record is rejected';
580
+ const consent = await obtainConsent(`Role "${roleName}" already exists and ${why}. It may belong to another deployment on this cluster, or to an earlier install that died. ` +
581
+ `Set a NEW password for "${roleName}"? Whatever uses its current password is locked out.`, {
582
+ flag: undefined,
583
+ nonInteractive: options.nonInteractive,
584
+ promptContext: options.promptContext,
585
+ ask: options.ask,
586
+ });
587
+ if (!consented(consent)) {
588
+ throw new PreconditionError(`Role "${roleName}" already exists and ${why}, so its password was not changed. ` +
589
+ `If it belongs to another deployment on this cluster, choose a different role with --app-db-user. ` +
590
+ `If it is this deployment's (an earlier install died), re-run with --rotate-app-password to set a new password.`);
591
+ }
592
+ }
593
+ }
594
+ const generate = options.generatePassword ?? generateAppPassword;
595
+ const password = reuse ? existingPassword : generate();
596
+ const verifier = reuse ? '' : scramSha256Verifier(password);
597
+ // Before any statement carries them.
598
+ if (!reuse) {
599
+ options.onSecrets?.([
600
+ { key: 'POSTGRES_PASSWORD', value: password },
601
+ { key: 'POSTGRES_PASSWORD_VERIFIER', value: verifier },
602
+ ]);
603
+ }
604
+ const secrets = [password, verifier, connection.password].filter((secret) => secret !== '');
605
+ const script = async (database, sql) => {
606
+ const result = await runPsqlScript(options.runCommand, connection, database, sql, { secrets });
607
+ return { ok: result.ok, stderr: result.stderr };
608
+ };
609
+ // 7. The role. From here the server changes.
610
+ progress.mutated = true;
611
+ let created = false;
612
+ const degraded = [];
613
+ if (existing === undefined) {
614
+ const result = await script(MAINTENANCE_DATABASE, `${createRoleStatement(roleName)};\n`);
615
+ if (!result.ok) {
616
+ throw new PreconditionError(NOT_PERMITTED.test(result.stderr)
617
+ ? `"${adminName}" is not allowed to create roles on ${entered.host}:${entered.port} (${firstLine(result.stderr)}).\n` +
618
+ ` Grant it (ALTER ROLE ${quoteAny(adminName)} CREATEROLE;) or use the provider's master login, or create the role by hand:\n` +
619
+ ` CREATE ROLE ${quoteRole(roleName)} LOGIN NOSUPERUSER NOBYPASSRLS CREATEDB CREATEROLE PASSWORD '<password>';\n` +
620
+ ' then re-run with --skip-role-provisioning and that POSTGRES_USER / POSTGRES_PASSWORD.'
621
+ : `Could not create role "${roleName}": ${firstLine(result.stderr)}`);
622
+ }
623
+ created = true;
624
+ line(`Created role "${roleName}" (LOGIN NOSUPERUSER NOBYPASSRLS CREATEDB)`);
625
+ }
626
+ else {
627
+ line(reuse
628
+ ? `Role "${roleName}" exists and its recorded credentials work: reused, not rotated`
629
+ : options.rotate === true
630
+ ? `Role "${roleName}" exists: its password will be rotated`
631
+ : `Role "${roleName}" exists: its password will be reset, as agreed`);
632
+ if (!existing.canLogin) {
633
+ const login = await script(MAINTENANCE_DATABASE, `${enableLoginStatement(roleName)};\n`);
634
+ if (!login.ok) {
635
+ throw new PreconditionError(`Role "${roleName}" exists but cannot log in (NOLOGIN), and enabling it failed: ${firstLine(login.stderr)}\n` +
636
+ ` Run ALTER ROLE ${quoteRole(roleName)} LOGIN; as an administrator, or choose another role with --app-db-user.`);
637
+ }
638
+ line(`Enabled LOGIN on role "${roleName}"`);
639
+ }
640
+ }
641
+ const afterCreate = `The role "${roleName}" exists; re-run with --rotate-app-password once the cause is fixed.`;
642
+ if (existing !== undefined && !existing.createDb) {
643
+ const result = await script(MAINTENANCE_DATABASE, `ALTER ROLE ${quoteRole(roleName)} CREATEDB;\n`);
644
+ if (!result.ok)
645
+ degraded.push(`CREATEDB: ${firstLine(result.stderr)}`);
646
+ }
647
+ if (existing === undefined || !existing.createRole) {
648
+ const grant = await script(MAINTENANCE_DATABASE, `${grantCreateRoleStatement(roleName)};\n`);
649
+ if (!grant.ok) {
650
+ degraded.push(`CREATEROLE: ${firstLine(grant.stderr)}`);
651
+ }
652
+ else {
653
+ const self = await script(MAINTENANCE_DATABASE, `${selfGrantStatement(roleName)};\n`);
654
+ if (!self.ok) {
655
+ if (/unrecognized configuration parameter/i.test(self.stderr)) {
656
+ line('createrole_self_grant is not a setting on this server (PostgreSQL before 16): not needed');
657
+ }
658
+ else {
659
+ degraded.push(`createrole_self_grant: ${firstLine(self.stderr)}`);
660
+ }
661
+ }
662
+ }
663
+ }
664
+ if (degraded.length > 0) {
665
+ const costs = degraded.map((item) => {
666
+ const name = item.split(':')[0];
667
+ return ` - ${item}\n Without it: ${CONSEQUENCE[name] ?? 'a platform feature is limited'}.`;
668
+ });
669
+ line(`The administrative login could not grant everything:\n${costs.join('\n')}`);
670
+ const consent = await obtainConsent(`"${adminName}" could not give role "${roleName}" ${degraded.map((item) => item.split(':')[0]).join(', ')} (a managed provider often withholds them). Continue with a reduced role?`, {
671
+ flag: options.allowReducedRole,
672
+ nonInteractive: options.nonInteractive,
673
+ promptContext: options.promptContext,
674
+ ask: options.ask,
675
+ });
676
+ if (!consented(consent)) {
677
+ // The password was not set, so nothing but the (password-less) role was left behind.
678
+ return notConsented(`Role "${roleName}" exists but lacks what the platform expects:\n${costs.join('\n')}\n` +
679
+ ' The deployment was not moved onto it and no password was set. Ask the provider for a login that can grant them, or re-run with --allow-reduced-role to accept the limits.');
680
+ }
681
+ }
682
+ // 8. Ownership. A non-superuser administrator must be able to SET ROLE to the
683
+ // new owner to give it things; that membership is revoked again afterwards if
684
+ // this run is what created it.
685
+ let ownershipTransferred = false;
686
+ if (needsTransfer) {
687
+ let granted = false;
688
+ if (!attributes.superuser) {
689
+ let canSet = await runPsql(options.runCommand, maintenance, MAINTENANCE_DATABASE, `select pg_has_role(${literal(adminName)}, ${literal(roleName)}, 'SET')`);
690
+ // `SET` is a PostgreSQL 16 privilege type; before it, membership is the question.
691
+ if (!canSet.ok) {
692
+ canSet = await runPsql(options.runCommand, maintenance, MAINTENANCE_DATABASE, `select pg_has_role(${literal(adminName)}, ${literal(roleName)}, 'MEMBER')`);
693
+ }
694
+ if (!(canSet.ok && canSet.stdout.trim().startsWith('t'))) {
695
+ const grant = await script(MAINTENANCE_DATABASE, `${grantMembershipStatement(roleName, adminName)};\n`);
696
+ if (!grant.ok) {
697
+ throw new PreconditionError(`"${adminName}" cannot act as "${roleName}" to give it the database: ${firstLine(grant.stderr)}\n ${afterCreate}`);
698
+ }
699
+ granted = true;
700
+ }
701
+ }
702
+ const result = await script(entered.database, ownershipScript(roleName, entered.database));
703
+ if (granted) {
704
+ const revoke = await script(MAINTENANCE_DATABASE, `${revokeMembershipStatement(roleName, adminName)};\n`);
705
+ if (!revoke.ok)
706
+ line(`warning: could not revoke the temporary membership of "${adminName}" in "${roleName}": ${firstLine(revoke.stderr)}`);
707
+ }
708
+ if (!result.ok) {
709
+ throw new PreconditionError(`Could not transfer ownership of "${entered.database}" to "${roleName}": ${firstLine(result.stderr)}\n` +
710
+ ` Nothing was partially changed (one transaction), and no password was set. ${afterCreate}`);
711
+ }
712
+ ownershipTransferred = true;
713
+ line(`Transferred ownership of "${entered.database}" and its objects to "${roleName}"`);
714
+ }
715
+ // 9. The PASSWORD, last. `.env` first: if it cannot be written the server is
716
+ // untouched; if the ALTER fails `.env` is put back; once the ALTER has
717
+ // succeeded `.env` holds what the server holds.
718
+ const credentials = { user: roleName, password };
719
+ await options.store?.write(credentials);
720
+ if (!reuse) {
721
+ const set = await script(MAINTENANCE_DATABASE, `${setPasswordStatement(roleName, verifier)};\n`);
722
+ if (!set.ok) {
723
+ await options.store?.restore();
724
+ throw new PreconditionError(`Could not set the password of role "${roleName}": ${firstLine(set.stderr)}\n .env was left as it was. ${afterCreate}`);
725
+ }
726
+ if (created)
727
+ line(`Set the password of the new role "${roleName}"`);
728
+ }
729
+ // Prove the role opens, against the database it will use, before the
730
+ // deployment is pointed at it.
731
+ const proof = await probeLogin(options.runCommand, { ...maintenance, user: roleName, password }, probeDatabase);
732
+ if (proof.result !== 'ok') {
733
+ // When the old .env was this very role, its old password is dead now and the
734
+ // new one is what the server has, so that is what .env keeps.
735
+ const keepNew = !reuse && recorded?.get('POSTGRES_USER') === roleName;
736
+ if (!keepNew)
737
+ await options.store?.restore();
738
+ throw new PreconditionError(`Role "${roleName}" was provisioned but cannot log in from this host: ${proof.detail}\n` +
739
+ (/no pg_hba\.conf entry/i.test(proof.detail)
740
+ ? ` pg_hba.conf has no entry for "${roleName}" from here: add one (the administrative login is not the only one that needs access).\n`
741
+ : '') +
742
+ (keepNew
743
+ ? ` The server now has the NEW password for "${roleName}" and .env holds it.`
744
+ : options.store === undefined
745
+ ? ' The deployment was not moved onto it.'
746
+ : ` The deployment was not moved onto it: .env is back to its previous login. ${afterCreate}`));
747
+ }
748
+ return {
749
+ outcome: 'provisioned',
750
+ detail: created ? `created role "${roleName}"` : `using role "${roleName}"`,
751
+ roleName,
752
+ credentials,
753
+ created,
754
+ ownershipTransferred,
755
+ degraded,
756
+ };
757
+ }
758
+ /** `--rotate-app-password` with only the application role's own login: it may change its own password. */
759
+ async function rotateOwnPassword(options, login, progress) {
760
+ const password = (options.generatePassword ?? generateAppPassword)();
761
+ const verifier = scramSha256Verifier(password);
762
+ options.onSecrets?.([
763
+ { key: 'POSTGRES_PASSWORD', value: password },
764
+ { key: 'POSTGRES_PASSWORD_VERIFIER', value: verifier },
765
+ ]);
766
+ const credentials = { user: login.user, password };
767
+ // `.env` first: if it cannot be written the server is untouched.
768
+ await options.store?.write(credentials);
769
+ progress.mutated = true;
770
+ const result = await runPsqlScript(options.runCommand, login, MAINTENANCE_DATABASE, `${setPasswordStatement(login.user, verifier)};\n`, { secrets: [password, verifier, login.password] });
771
+ if (!result.ok) {
772
+ await options.store?.restore();
773
+ throw new PreconditionError(`Could not rotate the password of "${login.user}": ${firstLine(result.stderr)}\n .env was left as it was.`);
774
+ }
775
+ options.onLine?.(`Rotated the password of role "${login.user}"`);
776
+ const proof = await probeLogin(options.runCommand, { ...login, password }, login.database);
777
+ if (proof.result !== 'ok') {
778
+ // The server has the new password: .env keeps it.
779
+ throw new PreconditionError(`The password of "${login.user}" was rotated but the new one did not open ${login.database}: ${proof.detail}\n` +
780
+ ' The server has the NEW password and .env holds it.');
781
+ }
782
+ return {
783
+ outcome: 'rotated',
784
+ detail: `rotated the password of "${login.user}"`,
785
+ roleName: login.user,
786
+ credentials,
787
+ created: false,
788
+ ownershipTransferred: false,
789
+ degraded: [],
790
+ };
791
+ }
792
+ function privilegeWords(attributes) {
793
+ const parts = [
794
+ ...(attributes.superuser ? ['a superuser'] : []),
795
+ ...(attributes.bypassRls ? ['BYPASSRLS'] : []),
796
+ ];
797
+ return parts.join(' and ');
798
+ }
799
+ /** What an operator who runs on a privileged login knowingly should be told, every time. */
800
+ export function superuserConsequence(user) {
801
+ return (`${user} bypasses row-level security: tenant isolation is OFF and every organization can read every other organization's rows. ` +
802
+ `${cliName()} deploy update --provision-app-role moves the deployment onto a dedicated role.`);
803
+ }
804
+ /**
805
+ * Whether `--allow-superuser` was chosen for THIS login. The record is the
806
+ * state's (`allowSuperuser` + `allowSuperuserLogin`); a flag with no matching
807
+ * login is stale and permits nothing.
808
+ */
809
+ export function superuserAllowedFor(state, user) {
810
+ return state?.allowSuperuser === true && user !== undefined && state.allowSuperuserLogin === user;
811
+ }
812
+ /**
813
+ * What the state records about `--allow-superuser` after a run: the login kept
814
+ * in this run, else the previous record while `.env` still holds that login,
815
+ * else nothing.
816
+ */
817
+ export function superuserRecord(kept, previous, currentUser) {
818
+ if (kept !== undefined)
819
+ return { allowSuperuser: true, allowSuperuserLogin: kept };
820
+ if (superuserAllowedFor(previous, currentUser)) {
821
+ return { allowSuperuser: true, allowSuperuserLogin: currentUser };
822
+ }
823
+ // Explicit undefined, so spreading it over an earlier record CLEARS the choice.
824
+ return { allowSuperuser: undefined, allowSuperuserLogin: undefined };
825
+ }
826
+ //# sourceMappingURL=app-role.js.map