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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (743) hide show
  1. package/CHANGELOG.md +80 -0
  2. package/README.md +126 -31
  3. package/dist/android/build.d.ts +30 -0
  4. package/dist/android/build.d.ts.map +1 -0
  5. package/dist/android/build.js +126 -0
  6. package/dist/android/build.js.map +1 -0
  7. package/dist/android/command.d.ts +21 -0
  8. package/dist/android/command.d.ts.map +1 -0
  9. package/dist/android/command.js +355 -0
  10. package/dist/android/command.js.map +1 -0
  11. package/dist/android/deploy-step.d.ts +85 -0
  12. package/dist/android/deploy-step.d.ts.map +1 -0
  13. package/dist/android/deploy-step.js +268 -0
  14. package/dist/android/deploy-step.js.map +1 -0
  15. package/dist/android/doctor.d.ts +47 -0
  16. package/dist/android/doctor.d.ts.map +1 -0
  17. package/dist/android/doctor.js +219 -0
  18. package/dist/android/doctor.js.map +1 -0
  19. package/dist/android/exec.d.ts +42 -0
  20. package/dist/android/exec.d.ts.map +1 -0
  21. package/dist/android/exec.js +103 -0
  22. package/dist/android/exec.js.map +1 -0
  23. package/dist/android/fix-plan.d.ts +44 -0
  24. package/dist/android/fix-plan.d.ts.map +1 -0
  25. package/dist/android/fix-plan.js +86 -0
  26. package/dist/android/fix-plan.js.map +1 -0
  27. package/dist/android/git-freshness.d.ts +34 -0
  28. package/dist/android/git-freshness.d.ts.map +1 -0
  29. package/dist/android/git-freshness.js +120 -0
  30. package/dist/android/git-freshness.js.map +1 -0
  31. package/dist/android/gradle.d.ts +32 -0
  32. package/dist/android/gradle.d.ts.map +1 -0
  33. package/dist/android/gradle.js +55 -0
  34. package/dist/android/gradle.js.map +1 -0
  35. package/dist/android/identity.d.ts +27 -0
  36. package/dist/android/identity.d.ts.map +1 -0
  37. package/dist/android/identity.js +60 -0
  38. package/dist/android/identity.js.map +1 -0
  39. package/dist/android/index.d.ts +7 -0
  40. package/dist/android/index.d.ts.map +1 -0
  41. package/dist/android/index.js +8 -0
  42. package/dist/android/index.js.map +1 -0
  43. package/dist/android/installer.d.ts +28 -0
  44. package/dist/android/installer.d.ts.map +1 -0
  45. package/dist/android/installer.js +96 -0
  46. package/dist/android/installer.js.map +1 -0
  47. package/dist/android/java.d.ts +26 -0
  48. package/dist/android/java.d.ts.map +1 -0
  49. package/dist/android/java.js +65 -0
  50. package/dist/android/java.js.map +1 -0
  51. package/dist/android/keystore.d.ts +54 -0
  52. package/dist/android/keystore.d.ts.map +1 -0
  53. package/dist/android/keystore.js +159 -0
  54. package/dist/android/keystore.js.map +1 -0
  55. package/dist/android/metadata.d.ts +39 -0
  56. package/dist/android/metadata.d.ts.map +1 -0
  57. package/dist/android/metadata.js +61 -0
  58. package/dist/android/metadata.js.map +1 -0
  59. package/dist/android/operations.d.ts +42 -0
  60. package/dist/android/operations.d.ts.map +1 -0
  61. package/dist/android/operations.js +59 -0
  62. package/dist/android/operations.js.map +1 -0
  63. package/dist/android/paths.d.ts +29 -0
  64. package/dist/android/paths.d.ts.map +1 -0
  65. package/dist/android/paths.js +97 -0
  66. package/dist/android/paths.js.map +1 -0
  67. package/dist/android/publish.d.ts +37 -0
  68. package/dist/android/publish.d.ts.map +1 -0
  69. package/dist/android/publish.js +119 -0
  70. package/dist/android/publish.js.map +1 -0
  71. package/dist/android/registrations.d.ts +92 -0
  72. package/dist/android/registrations.d.ts.map +1 -0
  73. package/dist/android/registrations.js +112 -0
  74. package/dist/android/registrations.js.map +1 -0
  75. package/dist/android/release-status.d.ts +73 -0
  76. package/dist/android/release-status.d.ts.map +1 -0
  77. package/dist/android/release-status.js +161 -0
  78. package/dist/android/release-status.js.map +1 -0
  79. package/dist/android/release.d.ts +33 -0
  80. package/dist/android/release.d.ts.map +1 -0
  81. package/dist/android/release.js +59 -0
  82. package/dist/android/release.js.map +1 -0
  83. package/dist/android/screen-layout.d.ts +26 -0
  84. package/dist/android/screen-layout.d.ts.map +1 -0
  85. package/dist/android/screen-layout.js +24 -0
  86. package/dist/android/screen-layout.js.map +1 -0
  87. package/dist/android/screen-model.d.ts +56 -0
  88. package/dist/android/screen-model.d.ts.map +1 -0
  89. package/dist/android/screen-model.js +207 -0
  90. package/dist/android/screen-model.js.map +1 -0
  91. package/dist/android/screen.d.ts +8 -0
  92. package/dist/android/screen.d.ts.map +1 -0
  93. package/dist/android/screen.js +395 -0
  94. package/dist/android/screen.js.map +1 -0
  95. package/dist/android/sdk.d.ts +48 -0
  96. package/dist/android/sdk.d.ts.map +1 -0
  97. package/dist/android/sdk.js +82 -0
  98. package/dist/android/sdk.js.map +1 -0
  99. package/dist/android/server-url.d.ts +19 -0
  100. package/dist/android/server-url.d.ts.map +1 -0
  101. package/dist/android/server-url.js +36 -0
  102. package/dist/android/server-url.js.map +1 -0
  103. package/dist/android/upload-progress.d.ts +3 -0
  104. package/dist/android/upload-progress.d.ts.map +1 -0
  105. package/dist/android/upload-progress.js +47 -0
  106. package/dist/android/upload-progress.js.map +1 -0
  107. package/dist/android/version.d.ts +47 -0
  108. package/dist/android/version.d.ts.map +1 -0
  109. package/dist/android/version.js +136 -0
  110. package/dist/android/version.js.map +1 -0
  111. package/dist/api-client/index.d.ts +3 -0
  112. package/dist/api-client/index.d.ts.map +1 -0
  113. package/dist/api-client/index.js +5 -0
  114. package/dist/api-client/index.js.map +1 -0
  115. package/dist/commands/index.d.ts +52 -0
  116. package/dist/commands/index.d.ts.map +1 -0
  117. package/dist/commands/index.js +63 -0
  118. package/dist/commands/index.js.map +1 -0
  119. package/dist/core/cli-registry.d.ts +41 -0
  120. package/dist/core/cli-registry.d.ts.map +1 -0
  121. package/dist/core/cli-registry.js +49 -0
  122. package/dist/core/cli-registry.js.map +1 -0
  123. package/dist/core/command-registry.d.ts +10 -0
  124. package/dist/core/command-registry.d.ts.map +1 -1
  125. package/dist/core/command-registry.js +17 -0
  126. package/dist/core/command-registry.js.map +1 -1
  127. package/dist/core/env-annotation-registry.d.ts +58 -0
  128. package/dist/core/env-annotation-registry.d.ts.map +1 -0
  129. package/dist/core/env-annotation-registry.js +80 -0
  130. package/dist/core/env-annotation-registry.js.map +1 -0
  131. package/dist/core/env-generator-registry.d.ts +59 -0
  132. package/dist/core/env-generator-registry.d.ts.map +1 -0
  133. package/dist/core/env-generator-registry.js +102 -0
  134. package/dist/core/env-generator-registry.js.map +1 -0
  135. package/dist/core/env-group-registry.d.ts +65 -0
  136. package/dist/core/env-group-registry.d.ts.map +1 -0
  137. package/dist/core/env-group-registry.js +77 -0
  138. package/dist/core/env-group-registry.js.map +1 -0
  139. package/dist/core/env-spec-registry.d.ts +16 -2
  140. package/dist/core/env-spec-registry.d.ts.map +1 -1
  141. package/dist/core/env-spec-registry.js +15 -0
  142. package/dist/core/env-spec-registry.js.map +1 -1
  143. package/dist/core/env-values.d.ts +3 -2
  144. package/dist/core/env-values.d.ts.map +1 -1
  145. package/dist/core/env-values.js +5 -3
  146. package/dist/core/env-values.js.map +1 -1
  147. package/dist/core/index.d.ts +10 -2
  148. package/dist/core/index.d.ts.map +1 -1
  149. package/dist/core/index.js +6 -2
  150. package/dist/core/index.js.map +1 -1
  151. package/dist/deploy/index.d.ts +3 -0
  152. package/dist/deploy/index.d.ts.map +1 -0
  153. package/dist/deploy/index.js +5 -0
  154. package/dist/deploy/index.js.map +1 -0
  155. package/dist/engine/api-client.d.ts +211 -0
  156. package/dist/engine/api-client.d.ts.map +1 -0
  157. package/dist/engine/api-client.js +350 -0
  158. package/dist/engine/api-client.js.map +1 -0
  159. package/dist/engine/browser.d.ts +18 -0
  160. package/dist/engine/browser.d.ts.map +1 -0
  161. package/dist/engine/browser.js +115 -0
  162. package/dist/engine/browser.js.map +1 -0
  163. package/dist/engine/builtin-registrations.d.ts +20 -0
  164. package/dist/engine/builtin-registrations.d.ts.map +1 -0
  165. package/dist/engine/builtin-registrations.js +86 -0
  166. package/dist/engine/builtin-registrations.js.map +1 -0
  167. package/dist/engine/commands/api.d.ts +88 -0
  168. package/dist/engine/commands/api.d.ts.map +1 -0
  169. package/dist/engine/commands/api.js +398 -0
  170. package/dist/engine/commands/api.js.map +1 -0
  171. package/dist/engine/commands/config.d.ts +5 -0
  172. package/dist/engine/commands/config.d.ts.map +1 -0
  173. package/dist/engine/commands/config.js +83 -0
  174. package/dist/engine/commands/config.js.map +1 -0
  175. package/dist/engine/commands/deploy.d.ts +243 -0
  176. package/dist/engine/commands/deploy.d.ts.map +1 -0
  177. package/dist/engine/commands/deploy.js +1159 -0
  178. package/dist/engine/commands/deploy.js.map +1 -0
  179. package/dist/engine/commands/init.d.ts +18 -0
  180. package/dist/engine/commands/init.d.ts.map +1 -0
  181. package/dist/engine/commands/init.js +50 -0
  182. package/dist/engine/commands/init.js.map +1 -0
  183. package/dist/engine/commands/login.d.ts +4 -0
  184. package/dist/engine/commands/login.d.ts.map +1 -0
  185. package/dist/engine/commands/login.js +205 -0
  186. package/dist/engine/commands/login.js.map +1 -0
  187. package/dist/engine/commands/node.d.ts +21 -0
  188. package/dist/engine/commands/node.d.ts.map +1 -0
  189. package/dist/engine/commands/node.js +436 -0
  190. package/dist/engine/commands/node.js.map +1 -0
  191. package/dist/engine/config.d.ts +246 -0
  192. package/dist/engine/config.d.ts.map +1 -0
  193. package/dist/engine/config.js +414 -0
  194. package/dist/engine/config.js.map +1 -0
  195. package/dist/engine/conformance.d.ts +187 -0
  196. package/dist/engine/conformance.d.ts.map +1 -0
  197. package/dist/engine/conformance.js +227 -0
  198. package/dist/engine/conformance.js.map +1 -0
  199. package/dist/engine/create-cli.d.ts +94 -0
  200. package/dist/engine/create-cli.d.ts.map +1 -0
  201. package/dist/engine/create-cli.js +60 -0
  202. package/dist/engine/create-cli.js.map +1 -0
  203. package/dist/engine/deploy/about.d.ts +12 -0
  204. package/dist/engine/deploy/about.d.ts.map +1 -0
  205. package/dist/engine/deploy/about.js +110 -0
  206. package/dist/engine/deploy/about.js.map +1 -0
  207. package/dist/engine/deploy/adopt.d.ts +21 -0
  208. package/dist/engine/deploy/adopt.d.ts.map +1 -0
  209. package/dist/engine/deploy/adopt.js +78 -0
  210. package/dist/engine/deploy/adopt.js.map +1 -0
  211. package/dist/engine/deploy/answers-file.d.ts +7 -0
  212. package/dist/engine/deploy/answers-file.d.ts.map +1 -0
  213. package/dist/engine/deploy/answers-file.js +49 -0
  214. package/dist/engine/deploy/answers-file.js.map +1 -0
  215. package/dist/engine/deploy/app-role.d.ts +278 -0
  216. package/dist/engine/deploy/app-role.d.ts.map +1 -0
  217. package/dist/engine/deploy/app-role.js +826 -0
  218. package/dist/engine/deploy/app-role.js.map +1 -0
  219. package/dist/engine/deploy/app-version.d.ts +47 -0
  220. package/dist/engine/deploy/app-version.d.ts.map +1 -0
  221. package/dist/engine/deploy/app-version.js +232 -0
  222. package/dist/engine/deploy/app-version.js.map +1 -0
  223. package/dist/engine/deploy/checks/database.d.ts +83 -0
  224. package/dist/engine/deploy/checks/database.d.ts.map +1 -0
  225. package/dist/engine/deploy/checks/database.js +455 -0
  226. package/dist/engine/deploy/checks/database.js.map +1 -0
  227. package/dist/engine/deploy/checks/dns.d.ts +3 -0
  228. package/dist/engine/deploy/checks/dns.d.ts.map +1 -0
  229. package/dist/engine/deploy/checks/dns.js +85 -0
  230. package/dist/engine/deploy/checks/dns.js.map +1 -0
  231. package/dist/engine/deploy/checks/host.d.ts +19 -0
  232. package/dist/engine/deploy/checks/host.d.ts.map +1 -0
  233. package/dist/engine/deploy/checks/host.js +530 -0
  234. package/dist/engine/deploy/checks/host.js.map +1 -0
  235. package/dist/engine/deploy/checks/index.d.ts +33 -0
  236. package/dist/engine/deploy/checks/index.d.ts.map +1 -0
  237. package/dist/engine/deploy/checks/index.js +67 -0
  238. package/dist/engine/deploy/checks/index.js.map +1 -0
  239. package/dist/engine/deploy/checks/registry.d.ts +102 -0
  240. package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
  241. package/dist/engine/deploy/checks/registry.js +103 -0
  242. package/dist/engine/deploy/checks/registry.js.map +1 -0
  243. package/dist/engine/deploy/checks/source.d.ts +45 -0
  244. package/dist/engine/deploy/checks/source.d.ts.map +1 -0
  245. package/dist/engine/deploy/checks/source.js +175 -0
  246. package/dist/engine/deploy/checks/source.js.map +1 -0
  247. package/dist/engine/deploy/checks/tls.d.ts +87 -0
  248. package/dist/engine/deploy/checks/tls.d.ts.map +1 -0
  249. package/dist/engine/deploy/checks/tls.js +552 -0
  250. package/dist/engine/deploy/checks/tls.js.map +1 -0
  251. package/dist/engine/deploy/checks/types.d.ts +178 -0
  252. package/dist/engine/deploy/checks/types.d.ts.map +1 -0
  253. package/dist/engine/deploy/checks/types.js +199 -0
  254. package/dist/engine/deploy/checks/types.js.map +1 -0
  255. package/dist/engine/deploy/compose-files.d.ts +29 -0
  256. package/dist/engine/deploy/compose-files.d.ts.map +1 -0
  257. package/dist/engine/deploy/compose-files.js +118 -0
  258. package/dist/engine/deploy/compose-files.js.map +1 -0
  259. package/dist/engine/deploy/consent.d.ts +29 -0
  260. package/dist/engine/deploy/consent.d.ts.map +1 -0
  261. package/dist/engine/deploy/consent.js +35 -0
  262. package/dist/engine/deploy/consent.js.map +1 -0
  263. package/dist/engine/deploy/database-drop.d.ts +22 -0
  264. package/dist/engine/deploy/database-drop.d.ts.map +1 -0
  265. package/dist/engine/deploy/database-drop.js +135 -0
  266. package/dist/engine/deploy/database-drop.js.map +1 -0
  267. package/dist/engine/deploy/database.d.ts +116 -0
  268. package/dist/engine/deploy/database.d.ts.map +1 -0
  269. package/dist/engine/deploy/database.js +252 -0
  270. package/dist/engine/deploy/database.js.map +1 -0
  271. package/dist/engine/deploy/deploy-info.d.ts +48 -0
  272. package/dist/engine/deploy/deploy-info.d.ts.map +1 -0
  273. package/dist/engine/deploy/deploy-info.js +163 -0
  274. package/dist/engine/deploy/deploy-info.js.map +1 -0
  275. package/dist/engine/deploy/deployment-evidence.d.ts +38 -0
  276. package/dist/engine/deploy/deployment-evidence.d.ts.map +1 -0
  277. package/dist/engine/deploy/deployment-evidence.js +92 -0
  278. package/dist/engine/deploy/deployment-evidence.js.map +1 -0
  279. package/dist/engine/deploy/edge-config.d.ts +103 -0
  280. package/dist/engine/deploy/edge-config.d.ts.map +1 -0
  281. package/dist/engine/deploy/edge-config.js +170 -0
  282. package/dist/engine/deploy/edge-config.js.map +1 -0
  283. package/dist/engine/deploy/env-absence.d.ts +61 -0
  284. package/dist/engine/deploy/env-absence.d.ts.map +1 -0
  285. package/dist/engine/deploy/env-absence.js +33 -0
  286. package/dist/engine/deploy/env-absence.js.map +1 -0
  287. package/dist/engine/deploy/env-file.d.ts +14 -0
  288. package/dist/engine/deploy/env-file.d.ts.map +1 -0
  289. package/dist/engine/deploy/env-file.js +58 -0
  290. package/dist/engine/deploy/env-file.js.map +1 -0
  291. package/dist/engine/deploy/env-fragments.d.ts +29 -0
  292. package/dist/engine/deploy/env-fragments.d.ts.map +1 -0
  293. package/dist/engine/deploy/env-fragments.js +73 -0
  294. package/dist/engine/deploy/env-fragments.js.map +1 -0
  295. package/dist/engine/deploy/env-metadata.d.ts +73 -0
  296. package/dist/engine/deploy/env-metadata.d.ts.map +1 -0
  297. package/dist/engine/deploy/env-metadata.js +227 -0
  298. package/dist/engine/deploy/env-metadata.js.map +1 -0
  299. package/dist/engine/deploy/env-spec.d.ts +75 -0
  300. package/dist/engine/deploy/env-spec.d.ts.map +1 -0
  301. package/dist/engine/deploy/env-spec.js +239 -0
  302. package/dist/engine/deploy/env-spec.js.map +1 -0
  303. package/dist/engine/deploy/env-wizard.d.ts +56 -0
  304. package/dist/engine/deploy/env-wizard.d.ts.map +1 -0
  305. package/dist/engine/deploy/env-wizard.js +235 -0
  306. package/dist/engine/deploy/env-wizard.js.map +1 -0
  307. package/dist/engine/deploy/executor.d.ts +81 -0
  308. package/dist/engine/deploy/executor.d.ts.map +1 -0
  309. package/dist/engine/deploy/executor.js +247 -0
  310. package/dist/engine/deploy/executor.js.map +1 -0
  311. package/dist/engine/deploy/health.d.ts +146 -0
  312. package/dist/engine/deploy/health.d.ts.map +1 -0
  313. package/dist/engine/deploy/health.js +323 -0
  314. package/dist/engine/deploy/health.js.map +1 -0
  315. package/dist/engine/deploy/hooks.d.ts +66 -0
  316. package/dist/engine/deploy/hooks.d.ts.map +1 -0
  317. package/dist/engine/deploy/hooks.js +19 -0
  318. package/dist/engine/deploy/hooks.js.map +1 -0
  319. package/dist/engine/deploy/host-facts.d.ts +23 -0
  320. package/dist/engine/deploy/host-facts.d.ts.map +1 -0
  321. package/dist/engine/deploy/host-facts.js +67 -0
  322. package/dist/engine/deploy/host-facts.js.map +1 -0
  323. package/dist/engine/deploy/install.d.ts +233 -0
  324. package/dist/engine/deploy/install.d.ts.map +1 -0
  325. package/dist/engine/deploy/install.js +1304 -0
  326. package/dist/engine/deploy/install.js.map +1 -0
  327. package/dist/engine/deploy/inventory.d.ts +30 -0
  328. package/dist/engine/deploy/inventory.d.ts.map +1 -0
  329. package/dist/engine/deploy/inventory.js +122 -0
  330. package/dist/engine/deploy/inventory.js.map +1 -0
  331. package/dist/engine/deploy/journal.d.ts +77 -0
  332. package/dist/engine/deploy/journal.d.ts.map +1 -0
  333. package/dist/engine/deploy/journal.js +221 -0
  334. package/dist/engine/deploy/journal.js.map +1 -0
  335. package/dist/engine/deploy/layout.d.ts +77 -0
  336. package/dist/engine/deploy/layout.d.ts.map +1 -0
  337. package/dist/engine/deploy/layout.js +191 -0
  338. package/dist/engine/deploy/layout.js.map +1 -0
  339. package/dist/engine/deploy/oauth-check.d.ts +58 -0
  340. package/dist/engine/deploy/oauth-check.d.ts.map +1 -0
  341. package/dist/engine/deploy/oauth-check.js +213 -0
  342. package/dist/engine/deploy/oauth-check.js.map +1 -0
  343. package/dist/engine/deploy/proxy-bootstrap.d.ts +149 -0
  344. package/dist/engine/deploy/proxy-bootstrap.d.ts.map +1 -0
  345. package/dist/engine/deploy/proxy-bootstrap.js +416 -0
  346. package/dist/engine/deploy/proxy-bootstrap.js.map +1 -0
  347. package/dist/engine/deploy/proxy-streams.d.ts +110 -0
  348. package/dist/engine/deploy/proxy-streams.d.ts.map +1 -0
  349. package/dist/engine/deploy/proxy-streams.js +208 -0
  350. package/dist/engine/deploy/proxy-streams.js.map +1 -0
  351. package/dist/engine/deploy/proxy.d.ts +375 -0
  352. package/dist/engine/deploy/proxy.d.ts.map +1 -0
  353. package/dist/engine/deploy/proxy.js +758 -0
  354. package/dist/engine/deploy/proxy.js.map +1 -0
  355. package/dist/engine/deploy/renewal.d.ts +54 -0
  356. package/dist/engine/deploy/renewal.d.ts.map +1 -0
  357. package/dist/engine/deploy/renewal.js +169 -0
  358. package/dist/engine/deploy/renewal.js.map +1 -0
  359. package/dist/engine/deploy/repo.d.ts +101 -0
  360. package/dist/engine/deploy/repo.d.ts.map +1 -0
  361. package/dist/engine/deploy/repo.js +250 -0
  362. package/dist/engine/deploy/repo.js.map +1 -0
  363. package/dist/engine/deploy/run-record.d.ts +28 -0
  364. package/dist/engine/deploy/run-record.d.ts.map +1 -0
  365. package/dist/engine/deploy/run-record.js +44 -0
  366. package/dist/engine/deploy/run-record.js.map +1 -0
  367. package/dist/engine/deploy/state.d.ts +262 -0
  368. package/dist/engine/deploy/state.d.ts.map +1 -0
  369. package/dist/engine/deploy/state.js +163 -0
  370. package/dist/engine/deploy/state.js.map +1 -0
  371. package/dist/engine/deploy/steps/app-step-context.d.ts +24 -0
  372. package/dist/engine/deploy/steps/app-step-context.d.ts.map +1 -0
  373. package/dist/engine/deploy/steps/app-step-context.js +45 -0
  374. package/dist/engine/deploy/steps/app-step-context.js.map +1 -0
  375. package/dist/engine/deploy/steps/pipeline.d.ts +46 -0
  376. package/dist/engine/deploy/steps/pipeline.d.ts.map +1 -0
  377. package/dist/engine/deploy/steps/pipeline.js +73 -0
  378. package/dist/engine/deploy/steps/pipeline.js.map +1 -0
  379. package/dist/engine/deploy/steps/plan.d.ts +28 -0
  380. package/dist/engine/deploy/steps/plan.d.ts.map +1 -0
  381. package/dist/engine/deploy/steps/plan.js +32 -0
  382. package/dist/engine/deploy/steps/plan.js.map +1 -0
  383. package/dist/engine/deploy/steps/registry.d.ts +182 -0
  384. package/dist/engine/deploy/steps/registry.d.ts.map +1 -0
  385. package/dist/engine/deploy/steps/registry.js +212 -0
  386. package/dist/engine/deploy/steps/registry.js.map +1 -0
  387. package/dist/engine/deploy/steps/step-values.d.ts +28 -0
  388. package/dist/engine/deploy/steps/step-values.d.ts.map +1 -0
  389. package/dist/engine/deploy/steps/step-values.js +33 -0
  390. package/dist/engine/deploy/steps/step-values.js.map +1 -0
  391. package/dist/engine/deploy/testing/fake-postgres.d.ts +88 -0
  392. package/dist/engine/deploy/testing/fake-postgres.d.ts.map +1 -0
  393. package/dist/engine/deploy/testing/fake-postgres.js +236 -0
  394. package/dist/engine/deploy/testing/fake-postgres.js.map +1 -0
  395. package/dist/engine/deploy/testing/fake-vps.d.ts +147 -0
  396. package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -0
  397. package/dist/engine/deploy/testing/fake-vps.js +365 -0
  398. package/dist/engine/deploy/testing/fake-vps.js.map +1 -0
  399. package/dist/engine/deploy/uninstall.d.ts +87 -0
  400. package/dist/engine/deploy/uninstall.d.ts.map +1 -0
  401. package/dist/engine/deploy/uninstall.js +320 -0
  402. package/dist/engine/deploy/uninstall.js.map +1 -0
  403. package/dist/engine/deploy/update.d.ts +111 -0
  404. package/dist/engine/deploy/update.d.ts.map +1 -0
  405. package/dist/engine/deploy/update.js +1228 -0
  406. package/dist/engine/deploy/update.js.map +1 -0
  407. package/dist/engine/deploy/version-step.d.ts +65 -0
  408. package/dist/engine/deploy/version-step.d.ts.map +1 -0
  409. package/dist/engine/deploy/version-step.js +176 -0
  410. package/dist/engine/deploy/version-step.js.map +1 -0
  411. package/dist/engine/device-auth.d.ts +240 -0
  412. package/dist/engine/device-auth.d.ts.map +1 -0
  413. package/dist/engine/device-auth.js +442 -0
  414. package/dist/engine/device-auth.js.map +1 -0
  415. package/dist/engine/device-login.d.ts +126 -0
  416. package/dist/engine/device-login.d.ts.map +1 -0
  417. package/dist/engine/device-login.js +164 -0
  418. package/dist/engine/device-login.js.map +1 -0
  419. package/dist/engine/errors.d.ts +314 -0
  420. package/dist/engine/errors.d.ts.map +1 -0
  421. package/dist/engine/errors.js +561 -0
  422. package/dist/engine/errors.js.map +1 -0
  423. package/dist/engine/identity.d.ts +169 -0
  424. package/dist/engine/identity.d.ts.map +1 -0
  425. package/dist/engine/identity.js +227 -0
  426. package/dist/engine/identity.js.map +1 -0
  427. package/dist/engine/index.d.ts +104 -0
  428. package/dist/engine/index.d.ts.map +1 -0
  429. package/dist/engine/index.js +126 -0
  430. package/dist/engine/index.js.map +1 -0
  431. package/dist/engine/init/local-profile.d.ts +93 -0
  432. package/dist/engine/init/local-profile.d.ts.map +1 -0
  433. package/dist/engine/init/local-profile.js +295 -0
  434. package/dist/engine/init/local-profile.js.map +1 -0
  435. package/dist/engine/init/run-init.d.ts +41 -0
  436. package/dist/engine/init/run-init.d.ts.map +1 -0
  437. package/dist/engine/init/run-init.js +297 -0
  438. package/dist/engine/init/run-init.js.map +1 -0
  439. package/dist/engine/node/capabilities.d.ts +238 -0
  440. package/dist/engine/node/capabilities.d.ts.map +1 -0
  441. package/dist/engine/node/capabilities.js +316 -0
  442. package/dist/engine/node/capabilities.js.map +1 -0
  443. package/dist/engine/node/daemon.d.ts +63 -0
  444. package/dist/engine/node/daemon.d.ts.map +1 -0
  445. package/dist/engine/node/daemon.js +227 -0
  446. package/dist/engine/node/daemon.js.map +1 -0
  447. package/dist/engine/node/doctor.d.ts +58 -0
  448. package/dist/engine/node/doctor.d.ts.map +1 -0
  449. package/dist/engine/node/doctor.js +394 -0
  450. package/dist/engine/node/doctor.js.map +1 -0
  451. package/dist/engine/node/enrollment.d.ts +98 -0
  452. package/dist/engine/node/enrollment.d.ts.map +1 -0
  453. package/dist/engine/node/enrollment.js +189 -0
  454. package/dist/engine/node/enrollment.js.map +1 -0
  455. package/dist/engine/node/env-flags.d.ts +5 -0
  456. package/dist/engine/node/env-flags.d.ts.map +1 -0
  457. package/dist/engine/node/env-flags.js +22 -0
  458. package/dist/engine/node/env-flags.js.map +1 -0
  459. package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
  460. package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
  461. package/dist/engine/node/executors/credential-hygiene.js +189 -0
  462. package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
  463. package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
  464. package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
  465. package/dist/engine/node/executors/db-backup-run.js +362 -0
  466. package/dist/engine/node/executors/db-backup-run.js.map +1 -0
  467. package/dist/engine/node/executors/example-checksum.d.ts +30 -0
  468. package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
  469. package/dist/engine/node/executors/example-checksum.js +56 -0
  470. package/dist/engine/node/executors/example-checksum.js.map +1 -0
  471. package/dist/engine/node/executors/index.d.ts +168 -0
  472. package/dist/engine/node/executors/index.d.ts.map +1 -0
  473. package/dist/engine/node/executors/index.js +44 -0
  474. package/dist/engine/node/executors/index.js.map +1 -0
  475. package/dist/engine/node/executors/registry.d.ts +38 -0
  476. package/dist/engine/node/executors/registry.d.ts.map +1 -0
  477. package/dist/engine/node/executors/registry.js +92 -0
  478. package/dist/engine/node/executors/registry.js.map +1 -0
  479. package/dist/engine/node/heap-snapshot.d.ts +37 -0
  480. package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
  481. package/dist/engine/node/heap-snapshot.js +160 -0
  482. package/dist/engine/node/heap-snapshot.js.map +1 -0
  483. package/dist/engine/node/install-deps.d.ts +73 -0
  484. package/dist/engine/node/install-deps.d.ts.map +1 -0
  485. package/dist/engine/node/install-deps.js +150 -0
  486. package/dist/engine/node/install-deps.js.map +1 -0
  487. package/dist/engine/node/ipc-protocol.d.ts +67 -0
  488. package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
  489. package/dist/engine/node/ipc-protocol.js +83 -0
  490. package/dist/engine/node/ipc-protocol.js.map +1 -0
  491. package/dist/engine/node/lifecycle.d.ts +103 -0
  492. package/dist/engine/node/lifecycle.d.ts.map +1 -0
  493. package/dist/engine/node/lifecycle.js +259 -0
  494. package/dist/engine/node/lifecycle.js.map +1 -0
  495. package/dist/engine/node/logger.d.ts +82 -0
  496. package/dist/engine/node/logger.d.ts.map +1 -0
  497. package/dist/engine/node/logger.js +241 -0
  498. package/dist/engine/node/logger.js.map +1 -0
  499. package/dist/engine/node/memory-watchdog.d.ts +78 -0
  500. package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
  501. package/dist/engine/node/memory-watchdog.js +224 -0
  502. package/dist/engine/node/memory-watchdog.js.map +1 -0
  503. package/dist/engine/node/node-api.d.ts +391 -0
  504. package/dist/engine/node/node-api.d.ts.map +1 -0
  505. package/dist/engine/node/node-api.js +123 -0
  506. package/dist/engine/node/node-api.js.map +1 -0
  507. package/dist/engine/node/node-config.d.ts +128 -0
  508. package/dist/engine/node/node-config.d.ts.map +1 -0
  509. package/dist/engine/node/node-config.js +237 -0
  510. package/dist/engine/node/node-config.js.map +1 -0
  511. package/dist/engine/node/node-dashboard-source.d.ts +56 -0
  512. package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
  513. package/dist/engine/node/node-dashboard-source.js +213 -0
  514. package/dist/engine/node/node-dashboard-source.js.map +1 -0
  515. package/dist/engine/node/node-engine.d.ts +229 -0
  516. package/dist/engine/node/node-engine.d.ts.map +1 -0
  517. package/dist/engine/node/node-engine.js +723 -0
  518. package/dist/engine/node/node-engine.js.map +1 -0
  519. package/dist/engine/node/node-errors.d.ts +54 -0
  520. package/dist/engine/node/node-errors.d.ts.map +1 -0
  521. package/dist/engine/node/node-errors.js +71 -0
  522. package/dist/engine/node/node-errors.js.map +1 -0
  523. package/dist/engine/node/node-events.d.ts +132 -0
  524. package/dist/engine/node/node-events.d.ts.map +1 -0
  525. package/dist/engine/node/node-events.js +2 -0
  526. package/dist/engine/node/node-events.js.map +1 -0
  527. package/dist/engine/node/node-vitals.d.ts +123 -0
  528. package/dist/engine/node/node-vitals.d.ts.map +1 -0
  529. package/dist/engine/node/node-vitals.js +266 -0
  530. package/dist/engine/node/node-vitals.js.map +1 -0
  531. package/dist/engine/node/paths.d.ts +39 -0
  532. package/dist/engine/node/paths.d.ts.map +1 -0
  533. package/dist/engine/node/paths.js +60 -0
  534. package/dist/engine/node/paths.js.map +1 -0
  535. package/dist/engine/node/pg-dump.d.ts +126 -0
  536. package/dist/engine/node/pg-dump.d.ts.map +1 -0
  537. package/dist/engine/node/pg-dump.js +223 -0
  538. package/dist/engine/node/pg-dump.js.map +1 -0
  539. package/dist/engine/node/pidfile.d.ts +38 -0
  540. package/dist/engine/node/pidfile.d.ts.map +1 -0
  541. package/dist/engine/node/pidfile.js +156 -0
  542. package/dist/engine/node/pidfile.js.map +1 -0
  543. package/dist/engine/node/runtime-tuning.d.ts +65 -0
  544. package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
  545. package/dist/engine/node/runtime-tuning.js +198 -0
  546. package/dist/engine/node/runtime-tuning.js.map +1 -0
  547. package/dist/engine/node/service.d.ts +39 -0
  548. package/dist/engine/node/service.d.ts.map +1 -0
  549. package/dist/engine/node/service.js +211 -0
  550. package/dist/engine/node/service.js.map +1 -0
  551. package/dist/engine/node/start.d.ts +62 -0
  552. package/dist/engine/node/start.d.ts.map +1 -0
  553. package/dist/engine/node/start.js +245 -0
  554. package/dist/engine/node/start.js.map +1 -0
  555. package/dist/engine/node/worker-env-table.d.ts +15 -0
  556. package/dist/engine/node/worker-env-table.d.ts.map +1 -0
  557. package/dist/engine/node/worker-env-table.js +97 -0
  558. package/dist/engine/node/worker-env-table.js.map +1 -0
  559. package/dist/engine/node/worker-env.d.ts +50 -0
  560. package/dist/engine/node/worker-env.d.ts.map +1 -0
  561. package/dist/engine/node/worker-env.js +101 -0
  562. package/dist/engine/node/worker-env.js.map +1 -0
  563. package/dist/engine/output.d.ts +97 -0
  564. package/dist/engine/output.d.ts.map +1 -0
  565. package/dist/engine/output.js +274 -0
  566. package/dist/engine/output.js.map +1 -0
  567. package/dist/engine/package-info.d.ts +7 -0
  568. package/dist/engine/package-info.d.ts.map +1 -0
  569. package/dist/engine/package-info.js +38 -0
  570. package/dist/engine/package-info.js.map +1 -0
  571. package/dist/engine/program.d.ts +50 -0
  572. package/dist/engine/program.d.ts.map +1 -0
  573. package/dist/engine/program.js +197 -0
  574. package/dist/engine/program.js.map +1 -0
  575. package/dist/engine/prompt.d.ts +69 -0
  576. package/dist/engine/prompt.d.ts.map +1 -0
  577. package/dist/engine/prompt.js +205 -0
  578. package/dist/engine/prompt.js.map +1 -0
  579. package/dist/engine/registries.d.ts +5 -0
  580. package/dist/engine/registries.d.ts.map +1 -0
  581. package/dist/engine/registries.js +52 -0
  582. package/dist/engine/registries.js.map +1 -0
  583. package/dist/engine/request-body.d.ts +31 -0
  584. package/dist/engine/request-body.d.ts.map +1 -0
  585. package/dist/engine/request-body.js +156 -0
  586. package/dist/engine/request-body.js.map +1 -0
  587. package/dist/engine/test-support.d.ts +50 -0
  588. package/dist/engine/test-support.d.ts.map +1 -0
  589. package/dist/engine/test-support.js +86 -0
  590. package/dist/engine/test-support.js.map +1 -0
  591. package/dist/engine/tui/app.d.ts +3 -0
  592. package/dist/engine/tui/app.d.ts.map +1 -0
  593. package/dist/engine/tui/app.js +100 -0
  594. package/dist/engine/tui/app.js.map +1 -0
  595. package/dist/engine/tui/builtin-screens.d.ts +6 -0
  596. package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
  597. package/dist/engine/tui/builtin-screens.js +54 -0
  598. package/dist/engine/tui/builtin-screens.js.map +1 -0
  599. package/dist/engine/tui/index.d.ts +23 -0
  600. package/dist/engine/tui/index.d.ts.map +1 -0
  601. package/dist/engine/tui/index.js +71 -0
  602. package/dist/engine/tui/index.js.map +1 -0
  603. package/dist/engine/tui/layout.d.ts +132 -0
  604. package/dist/engine/tui/layout.d.ts.map +1 -0
  605. package/dist/engine/tui/layout.js +200 -0
  606. package/dist/engine/tui/layout.js.map +1 -0
  607. package/dist/engine/tui/routes.d.ts +5 -0
  608. package/dist/engine/tui/routes.d.ts.map +1 -0
  609. package/dist/engine/tui/routes.js +16 -0
  610. package/dist/engine/tui/routes.js.map +1 -0
  611. package/dist/engine/tui/screen-registry.d.ts +100 -0
  612. package/dist/engine/tui/screen-registry.d.ts.map +1 -0
  613. package/dist/engine/tui/screen-registry.js +96 -0
  614. package/dist/engine/tui/screen-registry.js.map +1 -0
  615. package/dist/engine/tui/screen-sections.d.ts +9 -0
  616. package/dist/engine/tui/screen-sections.d.ts.map +1 -0
  617. package/dist/engine/tui/screen-sections.js +45 -0
  618. package/dist/engine/tui/screen-sections.js.map +1 -0
  619. package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
  620. package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
  621. package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
  622. package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
  623. package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
  624. package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
  625. package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
  626. package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
  627. package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
  628. package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
  629. package/dist/engine/tui/screens/deploy/doctor.js +153 -0
  630. package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
  631. package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
  632. package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
  633. package/dist/engine/tui/screens/deploy/fields.js +202 -0
  634. package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
  635. package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
  636. package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
  637. package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
  638. package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
  639. package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
  640. package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
  641. package/dist/engine/tui/screens/deploy/index.js +83 -0
  642. package/dist/engine/tui/screens/deploy/index.js.map +1 -0
  643. package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
  644. package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
  645. package/dist/engine/tui/screens/deploy/install-model.js +319 -0
  646. package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
  647. package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
  648. package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
  649. package/dist/engine/tui/screens/deploy/install.js +361 -0
  650. package/dist/engine/tui/screens/deploy/install.js.map +1 -0
  651. package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
  652. package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
  653. package/dist/engine/tui/screens/deploy/model.js +59 -0
  654. package/dist/engine/tui/screens/deploy/model.js.map +1 -0
  655. package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
  656. package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
  657. package/dist/engine/tui/screens/deploy/run-model.js +117 -0
  658. package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
  659. package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
  660. package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
  661. package/dist/engine/tui/screens/deploy/run.js +201 -0
  662. package/dist/engine/tui/screens/deploy/run.js.map +1 -0
  663. package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
  664. package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
  665. package/dist/engine/tui/screens/deploy/status.js +107 -0
  666. package/dist/engine/tui/screens/deploy/status.js.map +1 -0
  667. package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
  668. package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
  669. package/dist/engine/tui/screens/deploy/update.js +175 -0
  670. package/dist/engine/tui/screens/deploy/update.js.map +1 -0
  671. package/dist/engine/tui/screens/deploy.d.ts +12 -0
  672. package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
  673. package/dist/engine/tui/screens/deploy.js +23 -0
  674. package/dist/engine/tui/screens/deploy.js.map +1 -0
  675. package/dist/engine/tui/screens/invoke.d.ts +6 -0
  676. package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
  677. package/dist/engine/tui/screens/invoke.js +193 -0
  678. package/dist/engine/tui/screens/invoke.js.map +1 -0
  679. package/dist/engine/tui/screens/login.d.ts +6 -0
  680. package/dist/engine/tui/screens/login.d.ts.map +1 -0
  681. package/dist/engine/tui/screens/login.js +255 -0
  682. package/dist/engine/tui/screens/login.js.map +1 -0
  683. package/dist/engine/tui/screens/logout.d.ts +6 -0
  684. package/dist/engine/tui/screens/logout.d.ts.map +1 -0
  685. package/dist/engine/tui/screens/logout.js +142 -0
  686. package/dist/engine/tui/screens/logout.js.map +1 -0
  687. package/dist/engine/tui/screens/menu.d.ts +22 -0
  688. package/dist/engine/tui/screens/menu.d.ts.map +1 -0
  689. package/dist/engine/tui/screens/menu.js +84 -0
  690. package/dist/engine/tui/screens/menu.js.map +1 -0
  691. package/dist/engine/tui/screens/node.d.ts +6 -0
  692. package/dist/engine/tui/screens/node.d.ts.map +1 -0
  693. package/dist/engine/tui/screens/node.js +228 -0
  694. package/dist/engine/tui/screens/node.js.map +1 -0
  695. package/dist/engine/tui/screens/status.d.ts +6 -0
  696. package/dist/engine/tui/screens/status.d.ts.map +1 -0
  697. package/dist/engine/tui/screens/status.js +134 -0
  698. package/dist/engine/tui/screens/status.js.map +1 -0
  699. package/dist/engine/tui/scroll-box.d.ts +27 -0
  700. package/dist/engine/tui/scroll-box.d.ts.map +1 -0
  701. package/dist/engine/tui/scroll-box.js +52 -0
  702. package/dist/engine/tui/scroll-box.js.map +1 -0
  703. package/dist/engine/tui/section-registry.d.ts +65 -0
  704. package/dist/engine/tui/section-registry.d.ts.map +1 -0
  705. package/dist/engine/tui/section-registry.js +90 -0
  706. package/dist/engine/tui/section-registry.js.map +1 -0
  707. package/dist/engine/tui/terminal.d.ts +31 -0
  708. package/dist/engine/tui/terminal.d.ts.map +1 -0
  709. package/dist/engine/tui/terminal.js +142 -0
  710. package/dist/engine/tui/terminal.js.map +1 -0
  711. package/dist/engine/tui/tty.d.ts +49 -0
  712. package/dist/engine/tui/tty.d.ts.map +1 -0
  713. package/dist/engine/tui/tty.js +139 -0
  714. package/dist/engine/tui/tty.js.map +1 -0
  715. package/dist/index.d.ts +4 -5
  716. package/dist/index.d.ts.map +1 -1
  717. package/dist/index.js +5 -5
  718. package/dist/index.js.map +1 -1
  719. package/dist/node/index.d.ts +3 -0
  720. package/dist/node/index.d.ts.map +1 -0
  721. package/dist/node/index.js +5 -0
  722. package/dist/node/index.js.map +1 -0
  723. package/dist/telemetry/index.d.ts +2 -1
  724. package/dist/telemetry/index.d.ts.map +1 -1
  725. package/dist/telemetry/index.js +1 -0
  726. package/dist/telemetry/index.js.map +1 -1
  727. package/dist/telemetry/node-span-relay.d.ts +1 -1
  728. package/dist/telemetry/node-span-relay.d.ts.map +1 -1
  729. package/dist/telemetry/node-span-relay.js +39 -6
  730. package/dist/telemetry/node-span-relay.js.map +1 -1
  731. package/dist/telemetry/node-span.d.ts +39 -7
  732. package/dist/telemetry/node-span.d.ts.map +1 -1
  733. package/dist/telemetry/node-span.js +19 -1
  734. package/dist/telemetry/node-span.js.map +1 -1
  735. package/dist/testing/index.d.ts +3 -0
  736. package/dist/testing/index.d.ts.map +1 -0
  737. package/dist/testing/index.js +4 -0
  738. package/dist/testing/index.js.map +1 -0
  739. package/dist/tui/index.d.ts +3 -0
  740. package/dist/tui/index.d.ts.map +1 -0
  741. package/dist/tui/index.js +5 -0
  742. package/dist/tui/index.js.map +1 -0
  743. package/package.json +43 -5
@@ -0,0 +1,189 @@
1
+ import { hostname, platform, release, userInfo } from 'node:os';
2
+ import { ApiError, CliError, EXIT } from '../errors.js';
3
+ import { cliName, cliVersion } from '../identity.js';
4
+ import { runDeviceLogin } from '../device-login.js';
5
+ import { HttpNodeApi } from './node-api.js';
6
+ import { assertConcurrency, assertKnownTypes, defaultNodeName, saveNodeConfig, saveNodeCredentials, } from './node-config.js';
7
+ // =============================================================================
8
+ // `node register` and `node enroll` (issue #273, epic #254)
9
+ // =============================================================================
10
+ //
11
+ // Getting a worker onto a machine used to be six steps and a copy-paste of a
12
+ // secret: log in, find the settings page, create a credential, copy it, put it
13
+ // in a config file, register. The copy-paste is the step people do badly — it
14
+ // ends up in shell history, in a paste buffer, in a chat message.
15
+ //
16
+ // `enroll` collapses all six. It runs THE EXISTING device-authorization flow
17
+ // (the same one `appctl login` uses — not a second implementation), then uses
18
+ // that short-lived session to mint a `nod_` credential and stores it directly.
19
+ // The operator never sees the secret unless they ask for it with
20
+ // `--show-token`, which stays available for the genuine case of provisioning a
21
+ // second machine.
22
+ //
23
+ // -----------------------------------------------------------------------------
24
+ // WHY `register` STAYS A SEPARATE COMMAND
25
+ // -----------------------------------------------------------------------------
26
+ //
27
+ // A container that already HAS a token must register without a browser, and
28
+ // headless start depends on that path existing. Folding registration into
29
+ // enroll would make a browser a prerequisite for a fleet.
30
+ //
31
+ // -----------------------------------------------------------------------------
32
+ // WHY NOT JUST REUSE THE PAT
33
+ // -----------------------------------------------------------------------------
34
+ //
35
+ // A PAT carries the owner's FULL authority. Handing that to an unattended
36
+ // process that runs for months on a machine in someone's rack is exactly what
37
+ // `nod_` exists to avoid: a node credential is refused on every route outside
38
+ // `/api/nodes/*`, including the route that mints credentials, so a compromised
39
+ // worker cannot escalate or mint a second identity (#267).
40
+ //
41
+ // EVERYTHING HERE IS UI-FREE AND DEPENDENCY-INJECTED — the login function, the
42
+ // API factory and the config writer are all parameters. That is what makes
43
+ // both flows unit-testable with no network, no browser and no real home
44
+ // directory, and it is what lets #279's TUI call the same functions the
45
+ // commands call rather than reimplementing them.
46
+ // =============================================================================
47
+ /**
48
+ * The server predates node credentials.
49
+ *
50
+ * A typed error rather than a bare 404, because the remedy is specific and a
51
+ * stack trace about a missing route does not suggest it: the operator can
52
+ * create a PAT by hand and set the token variable, and their fleet works today
53
+ * while the server is upgraded.
54
+ */
55
+ export class NodeCredentialsUnsupportedError extends CliError {
56
+ exitCode = EXIT.PRECONDITION;
57
+ constructor(serverUrl) {
58
+ super(`${serverUrl} does not support node credentials (POST /api/node-credentials returned 404). ` +
59
+ `Upgrade the server, or fall back to a personal access token: create one in the web UI, ` +
60
+ `run \`${cliName()} login --token <pat>\`, then \`${cliName()} node register\`. ` +
61
+ `A PAT works, but it carries your full account authority — a node credential does not.`);
62
+ }
63
+ }
64
+ /** Read once, here, so `register` and `doctor` cannot report different platforms. */
65
+ export function readMachineInfo() {
66
+ let host;
67
+ try {
68
+ host = hostname();
69
+ }
70
+ catch {
71
+ host = 'unknown-host';
72
+ }
73
+ return {
74
+ hostname: host,
75
+ platform: `${platform()} ${release()}`,
76
+ cliVersion: cliVersion(),
77
+ };
78
+ }
79
+ /** A credential name an operator can match to a machine in the web UI. */
80
+ export function defaultCredentialName() {
81
+ let user;
82
+ try {
83
+ user = userInfo().username;
84
+ }
85
+ catch {
86
+ // Containers running as an arbitrary uid have no passwd entry. Degrade
87
+ // rather than fail enrollment over a label.
88
+ user = 'node';
89
+ }
90
+ let host;
91
+ try {
92
+ host = hostname();
93
+ }
94
+ catch {
95
+ host = 'unknown-host';
96
+ }
97
+ return `${cliName()} node: ${user}@${host}`;
98
+ }
99
+ /**
100
+ * Register (or re-attach) this machine as a worker node.
101
+ *
102
+ * IDEMPOTENT BY CONSTRUCTION: the server keys on `(owner, name)` and reattaches
103
+ * rather than creating a second row. This function reports WHICH happened
104
+ * instead of flattening the two — an operator who expected a new node and got a
105
+ * reattach has a name collision to resolve, and would never discover it from a
106
+ * uniform "ok".
107
+ */
108
+ export async function registerNode(options) {
109
+ const machine = options.machine ?? readMachineInfo();
110
+ assertConcurrency(options.node.concurrency);
111
+ if (options.validateTypes !== false && options.node.eligibleTypes.length > 0) {
112
+ const advertised = await options.api.jobTypes();
113
+ assertKnownTypes(options.node.eligibleTypes, advertised.map((entry) => entry.type));
114
+ }
115
+ const result = await options.api.register({
116
+ name: options.node.name,
117
+ hostname: machine.hostname,
118
+ platform: machine.platform,
119
+ cliVersion: machine.cliVersion,
120
+ eligibleTypes: options.node.eligibleTypes,
121
+ concurrency: options.node.concurrency,
122
+ ...(options.capabilities !== undefined ? { capabilities: options.capabilities } : {}),
123
+ });
124
+ if (options.save !== undefined) {
125
+ options.save(result.node.id, options.node);
126
+ return result;
127
+ }
128
+ const configPath = saveNodeConfig({ nodeId: result.node.id, node: options.node },
129
+ // A container with a read-only home must still be able to register: the
130
+ // node id it could not persist is available through the environment.
131
+ { ...(options.configContext ?? {}), degradeOnFailure: true });
132
+ return { ...result, ...(configPath !== undefined ? { configPath } : {}) };
133
+ }
134
+ /**
135
+ * One command from "nothing installed" to "this machine holds a node credential".
136
+ *
137
+ * Note what is NOT here: any registration. Enroll establishes the machine's
138
+ * IDENTITY; `register` establishes its node ROW, and they are separable because
139
+ * a container image bakes in neither and is handed the credential at run time.
140
+ */
141
+ export async function enrollNode(options) {
142
+ const login = options.login ?? runDeviceLogin;
143
+ const session = await login({
144
+ serverUrl: options.serverUrl,
145
+ ...(options.hooks !== undefined ? { hooks: options.hooks } : {}),
146
+ ...(options.openBrowser !== undefined ? { openBrowser: options.openBrowser } : {}),
147
+ ...(options.signal !== undefined ? { signal: options.signal } : {}),
148
+ });
149
+ const credentialApi = options.createCredentialApi?.(options.serverUrl, session.credential.accessToken) ??
150
+ HttpNodeApi.create(options.serverUrl, session.credential.accessToken);
151
+ const name = options.credentialName ?? defaultCredentialName();
152
+ let credential;
153
+ try {
154
+ credential = await credentialApi.createCredential({
155
+ name,
156
+ ...(options.expiresInDays !== undefined ? { expiresInDays: options.expiresInDays } : {}),
157
+ });
158
+ }
159
+ catch (error) {
160
+ // 404 is the ONE status with a different meaning here. Everything else —
161
+ // 403 (the account lacks `nodes:write`), 400, a network failure — already
162
+ // carries a message that names the real problem.
163
+ if (error instanceof ApiError && error.status === 404) {
164
+ throw new NodeCredentialsUnsupportedError(options.serverUrl);
165
+ }
166
+ throw error;
167
+ }
168
+ const configPath = options.save?.(credential.token, credential) ??
169
+ saveNodeCredentials({
170
+ serverUrl: options.serverUrl,
171
+ token: credential.token,
172
+ // Explicitly forwarded, INCLUDING when it is null — that is what
173
+ // clears a previous PAT's expiry. See `saveNodeCredentials`.
174
+ expiresAt: credential.expiresAt,
175
+ tokenId: credential.id,
176
+ tokenName: credential.name,
177
+ }, options.configContext);
178
+ return {
179
+ credentialId: credential.id,
180
+ credentialName: credential.name,
181
+ tokenPrefix: credential.tokenPrefix,
182
+ expiresAt: credential.expiresAt,
183
+ token: credential.token,
184
+ configPath,
185
+ };
186
+ }
187
+ /** The default node name, re-exported so commands need one import. */
188
+ export { defaultNodeName };
189
+ //# sourceMappingURL=enrollment.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"enrollment.js","sourceRoot":"","sources":["../../../src/engine/node/enrollment.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ /** True only for an explicit affirmative. The parser for DEFAULT-OFF settings. */
2
+ export declare function envFlagOn(raw: string | undefined): boolean;
3
+ /** True only for an explicit negative. The parser for DEFAULT-ON settings. */
4
+ export declare function envFlagOff(raw: string | undefined): boolean;
5
+ //# sourceMappingURL=env-flags.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env-flags.d.ts","sourceRoot":"","sources":["../../../src/engine/node/env-flags.ts"],"names":[],"mappings":"AAYA,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAG1D;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAG3D"}
@@ -0,0 +1,22 @@
1
+ // =============================================================================
2
+ // Reading boolean environment variables (issue #277, epic #254)
3
+ // =============================================================================
4
+ //
5
+ // Two helpers rather than one, because DEFAULT-ON and DEFAULT-OFF variables
6
+ // must not share a parser. `envFlagOn('')` and `envFlagOff('')` have to give
7
+ // opposite answers, and folding that into a single function with a default
8
+ // argument is how a variable ends up meaning the opposite of what its name
9
+ // says when it is set to the empty string — which is what a compose file with
10
+ // `APPCTL_MEMORY_WATCHDOG=` produces.
11
+ // =============================================================================
12
+ /** True only for an explicit affirmative. The parser for DEFAULT-OFF settings. */
13
+ export function envFlagOn(raw) {
14
+ const value = raw?.trim().toLowerCase();
15
+ return value === 'true' || value === '1' || value === 'yes' || value === 'on';
16
+ }
17
+ /** True only for an explicit negative. The parser for DEFAULT-ON settings. */
18
+ export function envFlagOff(raw) {
19
+ const value = raw?.trim().toLowerCase();
20
+ return value === 'false' || value === '0' || value === 'no' || value === 'off';
21
+ }
22
+ //# sourceMappingURL=env-flags.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env-flags.js","sourceRoot":"","sources":["../../../src/engine/node/env-flags.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,iEAAiE;AACjE,gFAAgF;AAChF,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,2EAA2E;AAC3E,2EAA2E;AAC3E,8EAA8E;AAC9E,sCAAsC;AACtC,gFAAgF;AAEhF,kFAAkF;AAClF,MAAM,UAAU,SAAS,CAAC,GAAuB;IAC/C,MAAM,KAAK,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxC,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,IAAI,CAAC;AAChF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,GAAuB;IAChD,MAAM,KAAK,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxC,OAAO,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,KAAK,CAAC;AACjF,CAAC"}
@@ -0,0 +1,63 @@
1
+ import type { JobExecutor } from './index.js';
2
+ /**
3
+ * Options of {@link checkExecutorCredentialHygiene}.
4
+ *
5
+ * @stability experimental
6
+ */
7
+ export interface CredentialHygieneOptions {
8
+ /** The job's `params`. Defaults to `{}`. */
9
+ params?: Record<string, unknown> | undefined;
10
+ /**
11
+ * The credential the fake broker issues, before the marker is added to it
12
+ * (as `password` and `token`). Defaults to a Postgres-shaped one aimed at
13
+ * an unreachable local port, so a database client fails fast.
14
+ */
15
+ material?: Record<string, unknown> | undefined;
16
+ /** The broker's `kind`. Defaults to `postgres.readonly`. */
17
+ kind?: string | undefined;
18
+ /** Answers the executor's `fetch`. Defaults to draining the body and answering 200. */
19
+ fetchImpl?: typeof globalThis.fetch | undefined;
20
+ /** How long the executor may run. Defaults to 15 seconds. */
21
+ timeoutMs?: number | undefined;
22
+ }
23
+ /**
24
+ * What {@link checkExecutorCredentialHygiene} found.
25
+ *
26
+ * @stability experimental
27
+ */
28
+ export interface CredentialHygieneReport {
29
+ /** The executor's job type. */
30
+ type: string;
31
+ /** The marker the credential carried (never a real secret). */
32
+ marker: string;
33
+ /** Whether the executor asked the broker for the credential. */
34
+ secretRequested: boolean;
35
+ /** `ok` when `execute` returned, `failed` when it threw or timed out. */
36
+ outcome: 'ok' | 'failed';
37
+ /** The error message, when it failed. */
38
+ error?: string | undefined;
39
+ /** Where the credential was found. Empty is a pass. */
40
+ findings: string[];
41
+ }
42
+ /**
43
+ * Runs an executor once against a fake job holding a job-scoped credential
44
+ * and reports every place the credential ended up that it must never reach:
45
+ * the node log, the state directory, HOME, the result or the error.
46
+ *
47
+ * Needs the CLI identity (the state directory's variable is prefixed with
48
+ * it), so build the CLI with `createCli` first. Not safe to run concurrently
49
+ * with other tests in the same process: it swaps `process.env.HOME`, the
50
+ * state-directory variable and `globalThis.fetch` while the executor runs.
51
+ *
52
+ * @param executor - The executor under test.
53
+ * @param options - The job's params, the credential's shape, the fetch answer.
54
+ * @returns The report; `findings` is empty when the executor is clean.
55
+ * @stability experimental
56
+ * @example
57
+ * ```ts
58
+ * const report = await checkExecutorCredentialHygiene(new EchoExecutor());
59
+ * expect(report.findings).toEqual([]);
60
+ * ```
61
+ */
62
+ export declare function checkExecutorCredentialHygiene(executor: JobExecutor, options?: CredentialHygieneOptions): Promise<CredentialHygieneReport>;
63
+ //# sourceMappingURL=credential-hygiene.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"credential-hygiene.d.ts","sourceRoot":"","sources":["../../../../src/engine/node/executors/credential-hygiene.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAuB,WAAW,EAAE,MAAM,YAAY,CAAC;AAuBnE;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/C,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,uFAAuF;IACvF,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;IAChD,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,eAAe,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,OAAO,EAAE,IAAI,GAAG,QAAQ,CAAC;IACzB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAuBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,uBAAuB,CAAC,CAkIlC"}
@@ -0,0 +1,189 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
3
+ import { tmpdir } from 'node:os';
4
+ import { join } from 'node:path';
5
+ import { NodeLogger } from '../logger.js';
6
+ import { workerEnv } from '../worker-env.js';
7
+ function filesUnder(dir) {
8
+ const out = [];
9
+ for (const entry of readdirSync(dir, { recursive: true })) {
10
+ const path = join(dir, entry);
11
+ try {
12
+ if (statSync(path).isFile())
13
+ out.push(path);
14
+ }
15
+ catch {
16
+ // Removed while scanning; nothing left to leak.
17
+ }
18
+ }
19
+ return out;
20
+ }
21
+ async function drainingFetch(_url, init) {
22
+ const body = init?.body;
23
+ if (body !== undefined && body !== null && typeof body[Symbol.asyncIterator] === 'function') {
24
+ for await (const chunk of body)
25
+ void chunk;
26
+ }
27
+ return new Response(null, { status: 200 });
28
+ }
29
+ /**
30
+ * Runs an executor once against a fake job holding a job-scoped credential
31
+ * and reports every place the credential ended up that it must never reach:
32
+ * the node log, the state directory, HOME, the result or the error.
33
+ *
34
+ * Needs the CLI identity (the state directory's variable is prefixed with
35
+ * it), so build the CLI with `createCli` first. Not safe to run concurrently
36
+ * with other tests in the same process: it swaps `process.env.HOME`, the
37
+ * state-directory variable and `globalThis.fetch` while the executor runs.
38
+ *
39
+ * @param executor - The executor under test.
40
+ * @param options - The job's params, the credential's shape, the fetch answer.
41
+ * @returns The report; `findings` is empty when the executor is clean.
42
+ * @stability experimental
43
+ * @example
44
+ * ```ts
45
+ * const report = await checkExecutorCredentialHygiene(new EchoExecutor());
46
+ * expect(report.findings).toEqual([]);
47
+ * ```
48
+ */
49
+ export async function checkExecutorCredentialHygiene(executor, options = {}) {
50
+ const marker = `conformance-credential-${randomUUID()}`;
51
+ const signature = `X-Amz-Signature=conformance-${randomUUID()}`;
52
+ const root = mkdtempSync(join(tmpdir(), 'platform-cli-credential-'));
53
+ const stateDir = join(root, 'state');
54
+ const home = join(root, 'home');
55
+ mkdirSync(stateDir, { recursive: true });
56
+ mkdirSync(home, { recursive: true });
57
+ const logPath = join(stateDir, 'node.log');
58
+ const logger = new NodeLogger({ path: logPath });
59
+ let secretRequested = false;
60
+ const secret = () => {
61
+ secretRequested = true;
62
+ return {
63
+ kind: options.kind ?? 'postgres.readonly',
64
+ expiresAt: new Date(Date.now() + 60_000).toISOString(),
65
+ material: {
66
+ driver: 'postgresql',
67
+ host: '127.0.0.1',
68
+ port: 9,
69
+ database: 'conformance',
70
+ user: 'conformance_reader',
71
+ sslMode: 'disable',
72
+ ...options.material,
73
+ password: marker,
74
+ token: marker,
75
+ },
76
+ };
77
+ };
78
+ const upload = {
79
+ url: `https://bucket.invalid/conformance/object?${signature}`,
80
+ key: 'conformance/object',
81
+ expiresIn: 60,
82
+ expiresAt: new Date(Date.now() + 60_000).toISOString(),
83
+ };
84
+ // Every other API call is refused: the check is about the credential, and
85
+ // an executor that needs more of the API fails here rather than calling out.
86
+ const api = new Proxy({}, {
87
+ get: (_target, property) => {
88
+ if (property === 'jobSecret')
89
+ return async () => secret();
90
+ if (property === 'uploadUrl')
91
+ return async () => upload;
92
+ if (property === 'then')
93
+ return undefined;
94
+ return async () => {
95
+ throw new Error(`NodeApi.${String(property)} is not available in the credential hygiene check`);
96
+ };
97
+ },
98
+ });
99
+ let inputPath;
100
+ if (executor.requiresInput) {
101
+ inputPath = join(root, 'input.bin');
102
+ writeFileSync(inputPath, 'conformance input\n');
103
+ }
104
+ const controller = new AbortController();
105
+ const context = {
106
+ job: {
107
+ id: `conformance-${randomUUID()}`,
108
+ type: executor.type,
109
+ subjectType: null,
110
+ subjectId: null,
111
+ priority: 0,
112
+ attempts: 1,
113
+ startedAt: new Date().toISOString(),
114
+ leaseExpiresAt: new Date(Date.now() + 60_000).toISOString(),
115
+ },
116
+ params: options.params ?? {},
117
+ inputPath,
118
+ input: inputPath === undefined ? undefined : { objectId: 'conformance-input', size: '18', mimeType: 'application/octet-stream' },
119
+ api,
120
+ nodeId: 'conformance-node',
121
+ claimToken: randomUUID(),
122
+ signal: controller.signal,
123
+ log: (message, fields) => logger.info(message, fields),
124
+ };
125
+ const stateKey = workerEnv().stateDir;
126
+ const saved = { state: process.env[stateKey], home: process.env.HOME, fetch: globalThis.fetch };
127
+ process.env[stateKey] = stateDir;
128
+ process.env.HOME = home;
129
+ globalThis.fetch = options.fetchImpl ?? drainingFetch;
130
+ let outcome = 'ok';
131
+ let error;
132
+ let result;
133
+ let timer;
134
+ try {
135
+ const timeout = new Promise((_resolve, reject) => {
136
+ timer = setTimeout(() => {
137
+ controller.abort();
138
+ reject(new Error(`timed out after ${options.timeoutMs ?? 15_000} ms`));
139
+ }, options.timeoutMs ?? 15_000);
140
+ });
141
+ result = await Promise.race([executor.execute(context), timeout]);
142
+ }
143
+ catch (caught) {
144
+ outcome = 'failed';
145
+ error = caught instanceof Error ? caught.message : String(caught);
146
+ }
147
+ finally {
148
+ if (timer !== undefined)
149
+ clearTimeout(timer);
150
+ if (saved.state === undefined)
151
+ delete process.env[stateKey];
152
+ else
153
+ process.env[stateKey] = saved.state;
154
+ if (saved.home === undefined)
155
+ delete process.env.HOME;
156
+ else
157
+ process.env.HOME = saved.home;
158
+ globalThis.fetch = saved.fetch;
159
+ }
160
+ const findings = [];
161
+ try {
162
+ for (const dir of [stateDir, home]) {
163
+ for (const file of filesUnder(dir)) {
164
+ const text = readFileSync(file, 'utf8');
165
+ const where = file === logPath ? 'the node log' : `${file.startsWith(home) ? 'HOME' : 'the state directory'}: ${file.slice(root.length + 1)}`;
166
+ if (text.includes(marker))
167
+ findings.push(`the credential was written to ${where}`);
168
+ if (text.includes(signature))
169
+ findings.push(`the signed upload URL was written to ${where}`);
170
+ }
171
+ }
172
+ let serialised = '';
173
+ try {
174
+ serialised = JSON.stringify(result) ?? '';
175
+ }
176
+ catch {
177
+ serialised = String(result);
178
+ }
179
+ if (serialised.includes(marker))
180
+ findings.push('the credential is in the result the node reports to the server');
181
+ if (error?.includes(marker) === true)
182
+ findings.push('the credential is in the error message the node reports and logs');
183
+ }
184
+ finally {
185
+ rmSync(root, { recursive: true, force: true });
186
+ }
187
+ return { type: executor.type, marker, secretRequested, outcome, ...(error === undefined ? {} : { error }), findings };
188
+ }
189
+ //# sourceMappingURL=credential-hygiene.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"credential-hygiene.js","sourceRoot":"","sources":["../../../../src/engine/node/executors/credential-hygiene.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,73 @@
1
+ import { type PgConnection, type PgSpawnFn } from '../pg-dump.js';
2
+ import type { JobExecutionContext, JobExecutor } from './index.js';
3
+ /** Mirrors `dbBackupRunResultSchema` in `apps/api/src/jobs/contracts/`. */
4
+ export interface DbBackupRunResult {
5
+ storageKey: string;
6
+ /** A DECIMAL STRING: the column is 64-bit and a JSON number is not exact past 2^53. */
7
+ bytes: string;
8
+ sha256: string;
9
+ pgDumpVersion: string | null;
10
+ dbVersion: string | null;
11
+ migrationName: string | null;
12
+ startedAt: string;
13
+ finishedAt: string;
14
+ }
15
+ /** How long a provenance probe may take before it is abandoned as `null`. */
16
+ export declare const PROVENANCE_TIMEOUT_MS = 10000;
17
+ /** What the archive is uploaded as. Matches the server's `BACKUP_CONTENT_TYPE`. */
18
+ export declare const BACKUP_CONTENT_TYPE = "application/octet-stream";
19
+ export interface DatabaseBackupExecutorOptions {
20
+ /** The `pg_dump` spawn seam, so the tests need no PostgreSQL binaries. */
21
+ spawnFn?: PgSpawnFn | undefined;
22
+ /** The upload seam. Defaults to the global `fetch`. */
23
+ fetchImpl?: typeof globalThis.fetch | undefined;
24
+ /** Runs a provenance probe. Defaults to `psql`. */
25
+ probe?: ((args: string[], connection: PgConnection) => Promise<string | null>) | undefined;
26
+ /** Reads `pg_dump --version`. Defaults to running it. */
27
+ readClientVersion?: (() => Promise<string | null>) | undefined;
28
+ pgDumpCommand?: string | undefined;
29
+ psqlCommand?: string | undefined;
30
+ }
31
+ export declare class DatabaseBackupRunExecutor implements JobExecutor {
32
+ private readonly options;
33
+ readonly type = "db.backup.run";
34
+ /**
35
+ * ⚠ FALSE, AND THE ONE THING NOT TO "FIX". Every other node-eligible type so
36
+ * far reads an input object the server resolves for it; this one's input is
37
+ * the DATABASE, reached through a credential it fetches itself. Setting this
38
+ * true would make the engine ask for a download URL for a job that has no
39
+ * input object, and the request would fail with a 422 before `pg_dump` ever
40
+ * ran.
41
+ */
42
+ readonly requiresInput = false;
43
+ constructor(options?: DatabaseBackupExecutorOptions);
44
+ execute(context: JobExecutionContext): Promise<DbBackupRunResult>;
45
+ /** `pg_dump --version`, or `null`. Never throws — see the file header. */
46
+ private readClientVersion;
47
+ /**
48
+ * One `psql` scalar, or `null`.
49
+ *
50
+ * ⚠ THE QUERIES ARE CONSTANTS, NOT BUILT FROM ANYTHING. Nothing
51
+ * caller-supplied reaches SQL here: the connection travels as flags and the
52
+ * password as an environment variable, so there is no interpolation to get
53
+ * wrong. `-X` skips `~/.psqlrc` (a worker node is a machine somebody has
54
+ * used by hand), `-A -t` give a bare value with no alignment or header.
55
+ */
56
+ private probeValue;
57
+ }
58
+ /**
59
+ * Narrows the broker's opaque `material` into a connection, or throws.
60
+ *
61
+ * ⚠ VALIDATED RATHER THAN CAST, and the failure is a NAMED error. `material`
62
+ * is `Record<string, unknown>` by contract — the API passes it through without
63
+ * interpreting it — so a broker change, a version skew, or a fork's own
64
+ * `postgres`-kind broker returning a DSN would otherwise surface as
65
+ * `undefined` inside an argv and a `pg_dump` that connects to the wrong place
66
+ * (or to localhost) with an unhelpful error.
67
+ *
68
+ * ⚠ THE ERROR MESSAGE NAMES THE MISSING FIELDS AND NOTHING ELSE. It must never
69
+ * include the material itself: this string becomes `Job.lastError` on the
70
+ * server and a line in this node's log.
71
+ */
72
+ export declare function readPgMaterial(material: Record<string, unknown>): PgConnection;
73
+ //# sourceMappingURL=db-backup-run.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"db-backup-run.d.ts","sourceRoot":"","sources":["../../../../src/engine/node/executors/db-backup-run.ts"],"names":[],"mappings":"AAKA,OAAO,EAA8C,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAC9G,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4EnE,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAE9D,MAAM,WAAW,6BAA6B;IAC5C,0EAA0E;IAC1E,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;IAChD,mDAAmD;IACnD,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IAC3F,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IAC/D,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,qBAAa,yBAA0B,YAAW,WAAW;IAa/C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZpC,QAAQ,CAAC,IAAI,mBAAmB;IAEhC;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,SAAS;gBAEF,OAAO,GAAE,6BAAkC;IAElE,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0KvE,0EAA0E;YAC5D,iBAAiB;IAgB/B;;;;;;;;OAQG;YACW,UAAU;CAqCzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAqC9E"}