@marinoscar/platform-cli 0.0.0-stage → 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 (748) hide show
  1. package/CHANGELOG.md +100 -0
  2. package/LICENSE +21 -0
  3. package/README.md +182 -2
  4. package/dist/android/build.d.ts +30 -0
  5. package/dist/android/build.d.ts.map +1 -0
  6. package/dist/android/build.js +126 -0
  7. package/dist/android/build.js.map +1 -0
  8. package/dist/android/command.d.ts +21 -0
  9. package/dist/android/command.d.ts.map +1 -0
  10. package/dist/android/command.js +355 -0
  11. package/dist/android/command.js.map +1 -0
  12. package/dist/android/deploy-step.d.ts +85 -0
  13. package/dist/android/deploy-step.d.ts.map +1 -0
  14. package/dist/android/deploy-step.js +268 -0
  15. package/dist/android/deploy-step.js.map +1 -0
  16. package/dist/android/doctor.d.ts +47 -0
  17. package/dist/android/doctor.d.ts.map +1 -0
  18. package/dist/android/doctor.js +219 -0
  19. package/dist/android/doctor.js.map +1 -0
  20. package/dist/android/exec.d.ts +42 -0
  21. package/dist/android/exec.d.ts.map +1 -0
  22. package/dist/android/exec.js +103 -0
  23. package/dist/android/exec.js.map +1 -0
  24. package/dist/android/fix-plan.d.ts +44 -0
  25. package/dist/android/fix-plan.d.ts.map +1 -0
  26. package/dist/android/fix-plan.js +86 -0
  27. package/dist/android/fix-plan.js.map +1 -0
  28. package/dist/android/git-freshness.d.ts +34 -0
  29. package/dist/android/git-freshness.d.ts.map +1 -0
  30. package/dist/android/git-freshness.js +120 -0
  31. package/dist/android/git-freshness.js.map +1 -0
  32. package/dist/android/gradle.d.ts +32 -0
  33. package/dist/android/gradle.d.ts.map +1 -0
  34. package/dist/android/gradle.js +55 -0
  35. package/dist/android/gradle.js.map +1 -0
  36. package/dist/android/identity.d.ts +27 -0
  37. package/dist/android/identity.d.ts.map +1 -0
  38. package/dist/android/identity.js +60 -0
  39. package/dist/android/identity.js.map +1 -0
  40. package/dist/android/index.d.ts +7 -0
  41. package/dist/android/index.d.ts.map +1 -0
  42. package/dist/android/index.js +8 -0
  43. package/dist/android/index.js.map +1 -0
  44. package/dist/android/installer.d.ts +28 -0
  45. package/dist/android/installer.d.ts.map +1 -0
  46. package/dist/android/installer.js +96 -0
  47. package/dist/android/installer.js.map +1 -0
  48. package/dist/android/java.d.ts +26 -0
  49. package/dist/android/java.d.ts.map +1 -0
  50. package/dist/android/java.js +65 -0
  51. package/dist/android/java.js.map +1 -0
  52. package/dist/android/keystore.d.ts +54 -0
  53. package/dist/android/keystore.d.ts.map +1 -0
  54. package/dist/android/keystore.js +159 -0
  55. package/dist/android/keystore.js.map +1 -0
  56. package/dist/android/metadata.d.ts +39 -0
  57. package/dist/android/metadata.d.ts.map +1 -0
  58. package/dist/android/metadata.js +61 -0
  59. package/dist/android/metadata.js.map +1 -0
  60. package/dist/android/operations.d.ts +42 -0
  61. package/dist/android/operations.d.ts.map +1 -0
  62. package/dist/android/operations.js +59 -0
  63. package/dist/android/operations.js.map +1 -0
  64. package/dist/android/paths.d.ts +29 -0
  65. package/dist/android/paths.d.ts.map +1 -0
  66. package/dist/android/paths.js +97 -0
  67. package/dist/android/paths.js.map +1 -0
  68. package/dist/android/publish.d.ts +37 -0
  69. package/dist/android/publish.d.ts.map +1 -0
  70. package/dist/android/publish.js +119 -0
  71. package/dist/android/publish.js.map +1 -0
  72. package/dist/android/registrations.d.ts +92 -0
  73. package/dist/android/registrations.d.ts.map +1 -0
  74. package/dist/android/registrations.js +112 -0
  75. package/dist/android/registrations.js.map +1 -0
  76. package/dist/android/release-status.d.ts +73 -0
  77. package/dist/android/release-status.d.ts.map +1 -0
  78. package/dist/android/release-status.js +161 -0
  79. package/dist/android/release-status.js.map +1 -0
  80. package/dist/android/release.d.ts +33 -0
  81. package/dist/android/release.d.ts.map +1 -0
  82. package/dist/android/release.js +59 -0
  83. package/dist/android/release.js.map +1 -0
  84. package/dist/android/screen-layout.d.ts +26 -0
  85. package/dist/android/screen-layout.d.ts.map +1 -0
  86. package/dist/android/screen-layout.js +24 -0
  87. package/dist/android/screen-layout.js.map +1 -0
  88. package/dist/android/screen-model.d.ts +56 -0
  89. package/dist/android/screen-model.d.ts.map +1 -0
  90. package/dist/android/screen-model.js +207 -0
  91. package/dist/android/screen-model.js.map +1 -0
  92. package/dist/android/screen.d.ts +8 -0
  93. package/dist/android/screen.d.ts.map +1 -0
  94. package/dist/android/screen.js +395 -0
  95. package/dist/android/screen.js.map +1 -0
  96. package/dist/android/sdk.d.ts +48 -0
  97. package/dist/android/sdk.d.ts.map +1 -0
  98. package/dist/android/sdk.js +82 -0
  99. package/dist/android/sdk.js.map +1 -0
  100. package/dist/android/server-url.d.ts +19 -0
  101. package/dist/android/server-url.d.ts.map +1 -0
  102. package/dist/android/server-url.js +36 -0
  103. package/dist/android/server-url.js.map +1 -0
  104. package/dist/android/upload-progress.d.ts +3 -0
  105. package/dist/android/upload-progress.d.ts.map +1 -0
  106. package/dist/android/upload-progress.js +47 -0
  107. package/dist/android/upload-progress.js.map +1 -0
  108. package/dist/android/version.d.ts +47 -0
  109. package/dist/android/version.d.ts.map +1 -0
  110. package/dist/android/version.js +136 -0
  111. package/dist/android/version.js.map +1 -0
  112. package/dist/api-client/index.d.ts +3 -0
  113. package/dist/api-client/index.d.ts.map +1 -0
  114. package/dist/api-client/index.js +5 -0
  115. package/dist/api-client/index.js.map +1 -0
  116. package/dist/commands/index.d.ts +52 -0
  117. package/dist/commands/index.d.ts.map +1 -0
  118. package/dist/commands/index.js +63 -0
  119. package/dist/commands/index.js.map +1 -0
  120. package/dist/core/cli-registry.d.ts +41 -0
  121. package/dist/core/cli-registry.d.ts.map +1 -0
  122. package/dist/core/cli-registry.js +49 -0
  123. package/dist/core/cli-registry.js.map +1 -0
  124. package/dist/core/command-registry.d.ts +60 -0
  125. package/dist/core/command-registry.d.ts.map +1 -0
  126. package/dist/core/command-registry.js +114 -0
  127. package/dist/core/command-registry.js.map +1 -0
  128. package/dist/core/env-annotation-registry.d.ts +58 -0
  129. package/dist/core/env-annotation-registry.d.ts.map +1 -0
  130. package/dist/core/env-annotation-registry.js +80 -0
  131. package/dist/core/env-annotation-registry.js.map +1 -0
  132. package/dist/core/env-generator-registry.d.ts +59 -0
  133. package/dist/core/env-generator-registry.d.ts.map +1 -0
  134. package/dist/core/env-generator-registry.js +102 -0
  135. package/dist/core/env-generator-registry.js.map +1 -0
  136. package/dist/core/env-group-registry.d.ts +65 -0
  137. package/dist/core/env-group-registry.d.ts.map +1 -0
  138. package/dist/core/env-group-registry.js +77 -0
  139. package/dist/core/env-group-registry.js.map +1 -0
  140. package/dist/core/env-spec-registry.d.ts +133 -0
  141. package/dist/core/env-spec-registry.d.ts.map +1 -0
  142. package/dist/core/env-spec-registry.js +103 -0
  143. package/dist/core/env-spec-registry.js.map +1 -0
  144. package/dist/core/env-values.d.ts +76 -0
  145. package/dist/core/env-values.d.ts.map +1 -0
  146. package/dist/core/env-values.js +125 -0
  147. package/dist/core/env-values.js.map +1 -0
  148. package/dist/core/index.d.ts +14 -0
  149. package/dist/core/index.d.ts.map +1 -0
  150. package/dist/core/index.js +10 -0
  151. package/dist/core/index.js.map +1 -0
  152. package/dist/deploy/index.d.ts +3 -0
  153. package/dist/deploy/index.d.ts.map +1 -0
  154. package/dist/deploy/index.js +5 -0
  155. package/dist/deploy/index.js.map +1 -0
  156. package/dist/engine/api-client.d.ts +211 -0
  157. package/dist/engine/api-client.d.ts.map +1 -0
  158. package/dist/engine/api-client.js +350 -0
  159. package/dist/engine/api-client.js.map +1 -0
  160. package/dist/engine/browser.d.ts +18 -0
  161. package/dist/engine/browser.d.ts.map +1 -0
  162. package/dist/engine/browser.js +115 -0
  163. package/dist/engine/browser.js.map +1 -0
  164. package/dist/engine/builtin-registrations.d.ts +20 -0
  165. package/dist/engine/builtin-registrations.d.ts.map +1 -0
  166. package/dist/engine/builtin-registrations.js +86 -0
  167. package/dist/engine/builtin-registrations.js.map +1 -0
  168. package/dist/engine/commands/api.d.ts +88 -0
  169. package/dist/engine/commands/api.d.ts.map +1 -0
  170. package/dist/engine/commands/api.js +398 -0
  171. package/dist/engine/commands/api.js.map +1 -0
  172. package/dist/engine/commands/config.d.ts +5 -0
  173. package/dist/engine/commands/config.d.ts.map +1 -0
  174. package/dist/engine/commands/config.js +83 -0
  175. package/dist/engine/commands/config.js.map +1 -0
  176. package/dist/engine/commands/deploy.d.ts +243 -0
  177. package/dist/engine/commands/deploy.d.ts.map +1 -0
  178. package/dist/engine/commands/deploy.js +1159 -0
  179. package/dist/engine/commands/deploy.js.map +1 -0
  180. package/dist/engine/commands/init.d.ts +18 -0
  181. package/dist/engine/commands/init.d.ts.map +1 -0
  182. package/dist/engine/commands/init.js +50 -0
  183. package/dist/engine/commands/init.js.map +1 -0
  184. package/dist/engine/commands/login.d.ts +4 -0
  185. package/dist/engine/commands/login.d.ts.map +1 -0
  186. package/dist/engine/commands/login.js +205 -0
  187. package/dist/engine/commands/login.js.map +1 -0
  188. package/dist/engine/commands/node.d.ts +21 -0
  189. package/dist/engine/commands/node.d.ts.map +1 -0
  190. package/dist/engine/commands/node.js +436 -0
  191. package/dist/engine/commands/node.js.map +1 -0
  192. package/dist/engine/config.d.ts +246 -0
  193. package/dist/engine/config.d.ts.map +1 -0
  194. package/dist/engine/config.js +414 -0
  195. package/dist/engine/config.js.map +1 -0
  196. package/dist/engine/conformance.d.ts +187 -0
  197. package/dist/engine/conformance.d.ts.map +1 -0
  198. package/dist/engine/conformance.js +227 -0
  199. package/dist/engine/conformance.js.map +1 -0
  200. package/dist/engine/create-cli.d.ts +94 -0
  201. package/dist/engine/create-cli.d.ts.map +1 -0
  202. package/dist/engine/create-cli.js +60 -0
  203. package/dist/engine/create-cli.js.map +1 -0
  204. package/dist/engine/deploy/about.d.ts +12 -0
  205. package/dist/engine/deploy/about.d.ts.map +1 -0
  206. package/dist/engine/deploy/about.js +110 -0
  207. package/dist/engine/deploy/about.js.map +1 -0
  208. package/dist/engine/deploy/adopt.d.ts +21 -0
  209. package/dist/engine/deploy/adopt.d.ts.map +1 -0
  210. package/dist/engine/deploy/adopt.js +78 -0
  211. package/dist/engine/deploy/adopt.js.map +1 -0
  212. package/dist/engine/deploy/answers-file.d.ts +7 -0
  213. package/dist/engine/deploy/answers-file.d.ts.map +1 -0
  214. package/dist/engine/deploy/answers-file.js +49 -0
  215. package/dist/engine/deploy/answers-file.js.map +1 -0
  216. package/dist/engine/deploy/app-role.d.ts +278 -0
  217. package/dist/engine/deploy/app-role.d.ts.map +1 -0
  218. package/dist/engine/deploy/app-role.js +826 -0
  219. package/dist/engine/deploy/app-role.js.map +1 -0
  220. package/dist/engine/deploy/app-version.d.ts +47 -0
  221. package/dist/engine/deploy/app-version.d.ts.map +1 -0
  222. package/dist/engine/deploy/app-version.js +232 -0
  223. package/dist/engine/deploy/app-version.js.map +1 -0
  224. package/dist/engine/deploy/checks/database.d.ts +83 -0
  225. package/dist/engine/deploy/checks/database.d.ts.map +1 -0
  226. package/dist/engine/deploy/checks/database.js +455 -0
  227. package/dist/engine/deploy/checks/database.js.map +1 -0
  228. package/dist/engine/deploy/checks/dns.d.ts +3 -0
  229. package/dist/engine/deploy/checks/dns.d.ts.map +1 -0
  230. package/dist/engine/deploy/checks/dns.js +85 -0
  231. package/dist/engine/deploy/checks/dns.js.map +1 -0
  232. package/dist/engine/deploy/checks/host.d.ts +19 -0
  233. package/dist/engine/deploy/checks/host.d.ts.map +1 -0
  234. package/dist/engine/deploy/checks/host.js +530 -0
  235. package/dist/engine/deploy/checks/host.js.map +1 -0
  236. package/dist/engine/deploy/checks/index.d.ts +33 -0
  237. package/dist/engine/deploy/checks/index.d.ts.map +1 -0
  238. package/dist/engine/deploy/checks/index.js +67 -0
  239. package/dist/engine/deploy/checks/index.js.map +1 -0
  240. package/dist/engine/deploy/checks/registry.d.ts +102 -0
  241. package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
  242. package/dist/engine/deploy/checks/registry.js +103 -0
  243. package/dist/engine/deploy/checks/registry.js.map +1 -0
  244. package/dist/engine/deploy/checks/source.d.ts +45 -0
  245. package/dist/engine/deploy/checks/source.d.ts.map +1 -0
  246. package/dist/engine/deploy/checks/source.js +175 -0
  247. package/dist/engine/deploy/checks/source.js.map +1 -0
  248. package/dist/engine/deploy/checks/tls.d.ts +87 -0
  249. package/dist/engine/deploy/checks/tls.d.ts.map +1 -0
  250. package/dist/engine/deploy/checks/tls.js +552 -0
  251. package/dist/engine/deploy/checks/tls.js.map +1 -0
  252. package/dist/engine/deploy/checks/types.d.ts +178 -0
  253. package/dist/engine/deploy/checks/types.d.ts.map +1 -0
  254. package/dist/engine/deploy/checks/types.js +199 -0
  255. package/dist/engine/deploy/checks/types.js.map +1 -0
  256. package/dist/engine/deploy/compose-files.d.ts +29 -0
  257. package/dist/engine/deploy/compose-files.d.ts.map +1 -0
  258. package/dist/engine/deploy/compose-files.js +118 -0
  259. package/dist/engine/deploy/compose-files.js.map +1 -0
  260. package/dist/engine/deploy/consent.d.ts +29 -0
  261. package/dist/engine/deploy/consent.d.ts.map +1 -0
  262. package/dist/engine/deploy/consent.js +35 -0
  263. package/dist/engine/deploy/consent.js.map +1 -0
  264. package/dist/engine/deploy/database-drop.d.ts +22 -0
  265. package/dist/engine/deploy/database-drop.d.ts.map +1 -0
  266. package/dist/engine/deploy/database-drop.js +135 -0
  267. package/dist/engine/deploy/database-drop.js.map +1 -0
  268. package/dist/engine/deploy/database.d.ts +116 -0
  269. package/dist/engine/deploy/database.d.ts.map +1 -0
  270. package/dist/engine/deploy/database.js +252 -0
  271. package/dist/engine/deploy/database.js.map +1 -0
  272. package/dist/engine/deploy/deploy-info.d.ts +48 -0
  273. package/dist/engine/deploy/deploy-info.d.ts.map +1 -0
  274. package/dist/engine/deploy/deploy-info.js +163 -0
  275. package/dist/engine/deploy/deploy-info.js.map +1 -0
  276. package/dist/engine/deploy/deployment-evidence.d.ts +38 -0
  277. package/dist/engine/deploy/deployment-evidence.d.ts.map +1 -0
  278. package/dist/engine/deploy/deployment-evidence.js +92 -0
  279. package/dist/engine/deploy/deployment-evidence.js.map +1 -0
  280. package/dist/engine/deploy/edge-config.d.ts +103 -0
  281. package/dist/engine/deploy/edge-config.d.ts.map +1 -0
  282. package/dist/engine/deploy/edge-config.js +170 -0
  283. package/dist/engine/deploy/edge-config.js.map +1 -0
  284. package/dist/engine/deploy/env-absence.d.ts +61 -0
  285. package/dist/engine/deploy/env-absence.d.ts.map +1 -0
  286. package/dist/engine/deploy/env-absence.js +33 -0
  287. package/dist/engine/deploy/env-absence.js.map +1 -0
  288. package/dist/engine/deploy/env-file.d.ts +14 -0
  289. package/dist/engine/deploy/env-file.d.ts.map +1 -0
  290. package/dist/engine/deploy/env-file.js +58 -0
  291. package/dist/engine/deploy/env-file.js.map +1 -0
  292. package/dist/engine/deploy/env-fragments.d.ts +29 -0
  293. package/dist/engine/deploy/env-fragments.d.ts.map +1 -0
  294. package/dist/engine/deploy/env-fragments.js +73 -0
  295. package/dist/engine/deploy/env-fragments.js.map +1 -0
  296. package/dist/engine/deploy/env-metadata.d.ts +73 -0
  297. package/dist/engine/deploy/env-metadata.d.ts.map +1 -0
  298. package/dist/engine/deploy/env-metadata.js +227 -0
  299. package/dist/engine/deploy/env-metadata.js.map +1 -0
  300. package/dist/engine/deploy/env-spec.d.ts +75 -0
  301. package/dist/engine/deploy/env-spec.d.ts.map +1 -0
  302. package/dist/engine/deploy/env-spec.js +239 -0
  303. package/dist/engine/deploy/env-spec.js.map +1 -0
  304. package/dist/engine/deploy/env-wizard.d.ts +56 -0
  305. package/dist/engine/deploy/env-wizard.d.ts.map +1 -0
  306. package/dist/engine/deploy/env-wizard.js +235 -0
  307. package/dist/engine/deploy/env-wizard.js.map +1 -0
  308. package/dist/engine/deploy/executor.d.ts +81 -0
  309. package/dist/engine/deploy/executor.d.ts.map +1 -0
  310. package/dist/engine/deploy/executor.js +247 -0
  311. package/dist/engine/deploy/executor.js.map +1 -0
  312. package/dist/engine/deploy/health.d.ts +146 -0
  313. package/dist/engine/deploy/health.d.ts.map +1 -0
  314. package/dist/engine/deploy/health.js +323 -0
  315. package/dist/engine/deploy/health.js.map +1 -0
  316. package/dist/engine/deploy/hooks.d.ts +66 -0
  317. package/dist/engine/deploy/hooks.d.ts.map +1 -0
  318. package/dist/engine/deploy/hooks.js +19 -0
  319. package/dist/engine/deploy/hooks.js.map +1 -0
  320. package/dist/engine/deploy/host-facts.d.ts +23 -0
  321. package/dist/engine/deploy/host-facts.d.ts.map +1 -0
  322. package/dist/engine/deploy/host-facts.js +67 -0
  323. package/dist/engine/deploy/host-facts.js.map +1 -0
  324. package/dist/engine/deploy/install.d.ts +233 -0
  325. package/dist/engine/deploy/install.d.ts.map +1 -0
  326. package/dist/engine/deploy/install.js +1304 -0
  327. package/dist/engine/deploy/install.js.map +1 -0
  328. package/dist/engine/deploy/inventory.d.ts +30 -0
  329. package/dist/engine/deploy/inventory.d.ts.map +1 -0
  330. package/dist/engine/deploy/inventory.js +122 -0
  331. package/dist/engine/deploy/inventory.js.map +1 -0
  332. package/dist/engine/deploy/journal.d.ts +77 -0
  333. package/dist/engine/deploy/journal.d.ts.map +1 -0
  334. package/dist/engine/deploy/journal.js +221 -0
  335. package/dist/engine/deploy/journal.js.map +1 -0
  336. package/dist/engine/deploy/layout.d.ts +77 -0
  337. package/dist/engine/deploy/layout.d.ts.map +1 -0
  338. package/dist/engine/deploy/layout.js +191 -0
  339. package/dist/engine/deploy/layout.js.map +1 -0
  340. package/dist/engine/deploy/oauth-check.d.ts +58 -0
  341. package/dist/engine/deploy/oauth-check.d.ts.map +1 -0
  342. package/dist/engine/deploy/oauth-check.js +213 -0
  343. package/dist/engine/deploy/oauth-check.js.map +1 -0
  344. package/dist/engine/deploy/proxy-bootstrap.d.ts +149 -0
  345. package/dist/engine/deploy/proxy-bootstrap.d.ts.map +1 -0
  346. package/dist/engine/deploy/proxy-bootstrap.js +416 -0
  347. package/dist/engine/deploy/proxy-bootstrap.js.map +1 -0
  348. package/dist/engine/deploy/proxy-streams.d.ts +110 -0
  349. package/dist/engine/deploy/proxy-streams.d.ts.map +1 -0
  350. package/dist/engine/deploy/proxy-streams.js +208 -0
  351. package/dist/engine/deploy/proxy-streams.js.map +1 -0
  352. package/dist/engine/deploy/proxy.d.ts +375 -0
  353. package/dist/engine/deploy/proxy.d.ts.map +1 -0
  354. package/dist/engine/deploy/proxy.js +758 -0
  355. package/dist/engine/deploy/proxy.js.map +1 -0
  356. package/dist/engine/deploy/renewal.d.ts +54 -0
  357. package/dist/engine/deploy/renewal.d.ts.map +1 -0
  358. package/dist/engine/deploy/renewal.js +169 -0
  359. package/dist/engine/deploy/renewal.js.map +1 -0
  360. package/dist/engine/deploy/repo.d.ts +101 -0
  361. package/dist/engine/deploy/repo.d.ts.map +1 -0
  362. package/dist/engine/deploy/repo.js +250 -0
  363. package/dist/engine/deploy/repo.js.map +1 -0
  364. package/dist/engine/deploy/run-record.d.ts +28 -0
  365. package/dist/engine/deploy/run-record.d.ts.map +1 -0
  366. package/dist/engine/deploy/run-record.js +44 -0
  367. package/dist/engine/deploy/run-record.js.map +1 -0
  368. package/dist/engine/deploy/state.d.ts +262 -0
  369. package/dist/engine/deploy/state.d.ts.map +1 -0
  370. package/dist/engine/deploy/state.js +163 -0
  371. package/dist/engine/deploy/state.js.map +1 -0
  372. package/dist/engine/deploy/steps/app-step-context.d.ts +24 -0
  373. package/dist/engine/deploy/steps/app-step-context.d.ts.map +1 -0
  374. package/dist/engine/deploy/steps/app-step-context.js +45 -0
  375. package/dist/engine/deploy/steps/app-step-context.js.map +1 -0
  376. package/dist/engine/deploy/steps/pipeline.d.ts +46 -0
  377. package/dist/engine/deploy/steps/pipeline.d.ts.map +1 -0
  378. package/dist/engine/deploy/steps/pipeline.js +73 -0
  379. package/dist/engine/deploy/steps/pipeline.js.map +1 -0
  380. package/dist/engine/deploy/steps/plan.d.ts +28 -0
  381. package/dist/engine/deploy/steps/plan.d.ts.map +1 -0
  382. package/dist/engine/deploy/steps/plan.js +32 -0
  383. package/dist/engine/deploy/steps/plan.js.map +1 -0
  384. package/dist/engine/deploy/steps/registry.d.ts +182 -0
  385. package/dist/engine/deploy/steps/registry.d.ts.map +1 -0
  386. package/dist/engine/deploy/steps/registry.js +212 -0
  387. package/dist/engine/deploy/steps/registry.js.map +1 -0
  388. package/dist/engine/deploy/steps/step-values.d.ts +28 -0
  389. package/dist/engine/deploy/steps/step-values.d.ts.map +1 -0
  390. package/dist/engine/deploy/steps/step-values.js +33 -0
  391. package/dist/engine/deploy/steps/step-values.js.map +1 -0
  392. package/dist/engine/deploy/testing/fake-postgres.d.ts +88 -0
  393. package/dist/engine/deploy/testing/fake-postgres.d.ts.map +1 -0
  394. package/dist/engine/deploy/testing/fake-postgres.js +236 -0
  395. package/dist/engine/deploy/testing/fake-postgres.js.map +1 -0
  396. package/dist/engine/deploy/testing/fake-vps.d.ts +147 -0
  397. package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -0
  398. package/dist/engine/deploy/testing/fake-vps.js +365 -0
  399. package/dist/engine/deploy/testing/fake-vps.js.map +1 -0
  400. package/dist/engine/deploy/uninstall.d.ts +87 -0
  401. package/dist/engine/deploy/uninstall.d.ts.map +1 -0
  402. package/dist/engine/deploy/uninstall.js +320 -0
  403. package/dist/engine/deploy/uninstall.js.map +1 -0
  404. package/dist/engine/deploy/update.d.ts +111 -0
  405. package/dist/engine/deploy/update.d.ts.map +1 -0
  406. package/dist/engine/deploy/update.js +1228 -0
  407. package/dist/engine/deploy/update.js.map +1 -0
  408. package/dist/engine/deploy/version-step.d.ts +65 -0
  409. package/dist/engine/deploy/version-step.d.ts.map +1 -0
  410. package/dist/engine/deploy/version-step.js +176 -0
  411. package/dist/engine/deploy/version-step.js.map +1 -0
  412. package/dist/engine/device-auth.d.ts +240 -0
  413. package/dist/engine/device-auth.d.ts.map +1 -0
  414. package/dist/engine/device-auth.js +442 -0
  415. package/dist/engine/device-auth.js.map +1 -0
  416. package/dist/engine/device-login.d.ts +126 -0
  417. package/dist/engine/device-login.d.ts.map +1 -0
  418. package/dist/engine/device-login.js +164 -0
  419. package/dist/engine/device-login.js.map +1 -0
  420. package/dist/engine/errors.d.ts +314 -0
  421. package/dist/engine/errors.d.ts.map +1 -0
  422. package/dist/engine/errors.js +561 -0
  423. package/dist/engine/errors.js.map +1 -0
  424. package/dist/engine/identity.d.ts +169 -0
  425. package/dist/engine/identity.d.ts.map +1 -0
  426. package/dist/engine/identity.js +227 -0
  427. package/dist/engine/identity.js.map +1 -0
  428. package/dist/engine/index.d.ts +104 -0
  429. package/dist/engine/index.d.ts.map +1 -0
  430. package/dist/engine/index.js +126 -0
  431. package/dist/engine/index.js.map +1 -0
  432. package/dist/engine/init/local-profile.d.ts +93 -0
  433. package/dist/engine/init/local-profile.d.ts.map +1 -0
  434. package/dist/engine/init/local-profile.js +295 -0
  435. package/dist/engine/init/local-profile.js.map +1 -0
  436. package/dist/engine/init/run-init.d.ts +41 -0
  437. package/dist/engine/init/run-init.d.ts.map +1 -0
  438. package/dist/engine/init/run-init.js +297 -0
  439. package/dist/engine/init/run-init.js.map +1 -0
  440. package/dist/engine/node/capabilities.d.ts +238 -0
  441. package/dist/engine/node/capabilities.d.ts.map +1 -0
  442. package/dist/engine/node/capabilities.js +316 -0
  443. package/dist/engine/node/capabilities.js.map +1 -0
  444. package/dist/engine/node/daemon.d.ts +63 -0
  445. package/dist/engine/node/daemon.d.ts.map +1 -0
  446. package/dist/engine/node/daemon.js +227 -0
  447. package/dist/engine/node/daemon.js.map +1 -0
  448. package/dist/engine/node/doctor.d.ts +58 -0
  449. package/dist/engine/node/doctor.d.ts.map +1 -0
  450. package/dist/engine/node/doctor.js +394 -0
  451. package/dist/engine/node/doctor.js.map +1 -0
  452. package/dist/engine/node/enrollment.d.ts +98 -0
  453. package/dist/engine/node/enrollment.d.ts.map +1 -0
  454. package/dist/engine/node/enrollment.js +189 -0
  455. package/dist/engine/node/enrollment.js.map +1 -0
  456. package/dist/engine/node/env-flags.d.ts +5 -0
  457. package/dist/engine/node/env-flags.d.ts.map +1 -0
  458. package/dist/engine/node/env-flags.js +22 -0
  459. package/dist/engine/node/env-flags.js.map +1 -0
  460. package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
  461. package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
  462. package/dist/engine/node/executors/credential-hygiene.js +189 -0
  463. package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
  464. package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
  465. package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
  466. package/dist/engine/node/executors/db-backup-run.js +362 -0
  467. package/dist/engine/node/executors/db-backup-run.js.map +1 -0
  468. package/dist/engine/node/executors/example-checksum.d.ts +30 -0
  469. package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
  470. package/dist/engine/node/executors/example-checksum.js +56 -0
  471. package/dist/engine/node/executors/example-checksum.js.map +1 -0
  472. package/dist/engine/node/executors/index.d.ts +168 -0
  473. package/dist/engine/node/executors/index.d.ts.map +1 -0
  474. package/dist/engine/node/executors/index.js +44 -0
  475. package/dist/engine/node/executors/index.js.map +1 -0
  476. package/dist/engine/node/executors/registry.d.ts +38 -0
  477. package/dist/engine/node/executors/registry.d.ts.map +1 -0
  478. package/dist/engine/node/executors/registry.js +92 -0
  479. package/dist/engine/node/executors/registry.js.map +1 -0
  480. package/dist/engine/node/heap-snapshot.d.ts +37 -0
  481. package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
  482. package/dist/engine/node/heap-snapshot.js +160 -0
  483. package/dist/engine/node/heap-snapshot.js.map +1 -0
  484. package/dist/engine/node/install-deps.d.ts +73 -0
  485. package/dist/engine/node/install-deps.d.ts.map +1 -0
  486. package/dist/engine/node/install-deps.js +150 -0
  487. package/dist/engine/node/install-deps.js.map +1 -0
  488. package/dist/engine/node/ipc-protocol.d.ts +67 -0
  489. package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
  490. package/dist/engine/node/ipc-protocol.js +83 -0
  491. package/dist/engine/node/ipc-protocol.js.map +1 -0
  492. package/dist/engine/node/lifecycle.d.ts +103 -0
  493. package/dist/engine/node/lifecycle.d.ts.map +1 -0
  494. package/dist/engine/node/lifecycle.js +259 -0
  495. package/dist/engine/node/lifecycle.js.map +1 -0
  496. package/dist/engine/node/logger.d.ts +82 -0
  497. package/dist/engine/node/logger.d.ts.map +1 -0
  498. package/dist/engine/node/logger.js +241 -0
  499. package/dist/engine/node/logger.js.map +1 -0
  500. package/dist/engine/node/memory-watchdog.d.ts +78 -0
  501. package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
  502. package/dist/engine/node/memory-watchdog.js +224 -0
  503. package/dist/engine/node/memory-watchdog.js.map +1 -0
  504. package/dist/engine/node/node-api.d.ts +391 -0
  505. package/dist/engine/node/node-api.d.ts.map +1 -0
  506. package/dist/engine/node/node-api.js +123 -0
  507. package/dist/engine/node/node-api.js.map +1 -0
  508. package/dist/engine/node/node-config.d.ts +128 -0
  509. package/dist/engine/node/node-config.d.ts.map +1 -0
  510. package/dist/engine/node/node-config.js +237 -0
  511. package/dist/engine/node/node-config.js.map +1 -0
  512. package/dist/engine/node/node-dashboard-source.d.ts +56 -0
  513. package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
  514. package/dist/engine/node/node-dashboard-source.js +213 -0
  515. package/dist/engine/node/node-dashboard-source.js.map +1 -0
  516. package/dist/engine/node/node-engine.d.ts +229 -0
  517. package/dist/engine/node/node-engine.d.ts.map +1 -0
  518. package/dist/engine/node/node-engine.js +723 -0
  519. package/dist/engine/node/node-engine.js.map +1 -0
  520. package/dist/engine/node/node-errors.d.ts +54 -0
  521. package/dist/engine/node/node-errors.d.ts.map +1 -0
  522. package/dist/engine/node/node-errors.js +71 -0
  523. package/dist/engine/node/node-errors.js.map +1 -0
  524. package/dist/engine/node/node-events.d.ts +132 -0
  525. package/dist/engine/node/node-events.d.ts.map +1 -0
  526. package/dist/engine/node/node-events.js +2 -0
  527. package/dist/engine/node/node-events.js.map +1 -0
  528. package/dist/engine/node/node-vitals.d.ts +123 -0
  529. package/dist/engine/node/node-vitals.d.ts.map +1 -0
  530. package/dist/engine/node/node-vitals.js +266 -0
  531. package/dist/engine/node/node-vitals.js.map +1 -0
  532. package/dist/engine/node/paths.d.ts +39 -0
  533. package/dist/engine/node/paths.d.ts.map +1 -0
  534. package/dist/engine/node/paths.js +60 -0
  535. package/dist/engine/node/paths.js.map +1 -0
  536. package/dist/engine/node/pg-dump.d.ts +126 -0
  537. package/dist/engine/node/pg-dump.d.ts.map +1 -0
  538. package/dist/engine/node/pg-dump.js +223 -0
  539. package/dist/engine/node/pg-dump.js.map +1 -0
  540. package/dist/engine/node/pidfile.d.ts +38 -0
  541. package/dist/engine/node/pidfile.d.ts.map +1 -0
  542. package/dist/engine/node/pidfile.js +156 -0
  543. package/dist/engine/node/pidfile.js.map +1 -0
  544. package/dist/engine/node/runtime-tuning.d.ts +65 -0
  545. package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
  546. package/dist/engine/node/runtime-tuning.js +198 -0
  547. package/dist/engine/node/runtime-tuning.js.map +1 -0
  548. package/dist/engine/node/service.d.ts +39 -0
  549. package/dist/engine/node/service.d.ts.map +1 -0
  550. package/dist/engine/node/service.js +211 -0
  551. package/dist/engine/node/service.js.map +1 -0
  552. package/dist/engine/node/start.d.ts +62 -0
  553. package/dist/engine/node/start.d.ts.map +1 -0
  554. package/dist/engine/node/start.js +245 -0
  555. package/dist/engine/node/start.js.map +1 -0
  556. package/dist/engine/node/worker-env-table.d.ts +15 -0
  557. package/dist/engine/node/worker-env-table.d.ts.map +1 -0
  558. package/dist/engine/node/worker-env-table.js +97 -0
  559. package/dist/engine/node/worker-env-table.js.map +1 -0
  560. package/dist/engine/node/worker-env.d.ts +50 -0
  561. package/dist/engine/node/worker-env.d.ts.map +1 -0
  562. package/dist/engine/node/worker-env.js +101 -0
  563. package/dist/engine/node/worker-env.js.map +1 -0
  564. package/dist/engine/output.d.ts +97 -0
  565. package/dist/engine/output.d.ts.map +1 -0
  566. package/dist/engine/output.js +274 -0
  567. package/dist/engine/output.js.map +1 -0
  568. package/dist/engine/package-info.d.ts +7 -0
  569. package/dist/engine/package-info.d.ts.map +1 -0
  570. package/dist/engine/package-info.js +38 -0
  571. package/dist/engine/package-info.js.map +1 -0
  572. package/dist/engine/program.d.ts +50 -0
  573. package/dist/engine/program.d.ts.map +1 -0
  574. package/dist/engine/program.js +197 -0
  575. package/dist/engine/program.js.map +1 -0
  576. package/dist/engine/prompt.d.ts +69 -0
  577. package/dist/engine/prompt.d.ts.map +1 -0
  578. package/dist/engine/prompt.js +205 -0
  579. package/dist/engine/prompt.js.map +1 -0
  580. package/dist/engine/registries.d.ts +5 -0
  581. package/dist/engine/registries.d.ts.map +1 -0
  582. package/dist/engine/registries.js +52 -0
  583. package/dist/engine/registries.js.map +1 -0
  584. package/dist/engine/request-body.d.ts +31 -0
  585. package/dist/engine/request-body.d.ts.map +1 -0
  586. package/dist/engine/request-body.js +156 -0
  587. package/dist/engine/request-body.js.map +1 -0
  588. package/dist/engine/test-support.d.ts +50 -0
  589. package/dist/engine/test-support.d.ts.map +1 -0
  590. package/dist/engine/test-support.js +86 -0
  591. package/dist/engine/test-support.js.map +1 -0
  592. package/dist/engine/tui/app.d.ts +3 -0
  593. package/dist/engine/tui/app.d.ts.map +1 -0
  594. package/dist/engine/tui/app.js +100 -0
  595. package/dist/engine/tui/app.js.map +1 -0
  596. package/dist/engine/tui/builtin-screens.d.ts +6 -0
  597. package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
  598. package/dist/engine/tui/builtin-screens.js +54 -0
  599. package/dist/engine/tui/builtin-screens.js.map +1 -0
  600. package/dist/engine/tui/index.d.ts +23 -0
  601. package/dist/engine/tui/index.d.ts.map +1 -0
  602. package/dist/engine/tui/index.js +71 -0
  603. package/dist/engine/tui/index.js.map +1 -0
  604. package/dist/engine/tui/layout.d.ts +132 -0
  605. package/dist/engine/tui/layout.d.ts.map +1 -0
  606. package/dist/engine/tui/layout.js +200 -0
  607. package/dist/engine/tui/layout.js.map +1 -0
  608. package/dist/engine/tui/routes.d.ts +5 -0
  609. package/dist/engine/tui/routes.d.ts.map +1 -0
  610. package/dist/engine/tui/routes.js +16 -0
  611. package/dist/engine/tui/routes.js.map +1 -0
  612. package/dist/engine/tui/screen-registry.d.ts +100 -0
  613. package/dist/engine/tui/screen-registry.d.ts.map +1 -0
  614. package/dist/engine/tui/screen-registry.js +96 -0
  615. package/dist/engine/tui/screen-registry.js.map +1 -0
  616. package/dist/engine/tui/screen-sections.d.ts +9 -0
  617. package/dist/engine/tui/screen-sections.d.ts.map +1 -0
  618. package/dist/engine/tui/screen-sections.js +45 -0
  619. package/dist/engine/tui/screen-sections.js.map +1 -0
  620. package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
  621. package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
  622. package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
  623. package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
  624. package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
  625. package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
  626. package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
  627. package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
  628. package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
  629. package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
  630. package/dist/engine/tui/screens/deploy/doctor.js +153 -0
  631. package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
  632. package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
  633. package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
  634. package/dist/engine/tui/screens/deploy/fields.js +202 -0
  635. package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
  636. package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
  637. package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
  638. package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
  639. package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
  640. package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
  641. package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
  642. package/dist/engine/tui/screens/deploy/index.js +83 -0
  643. package/dist/engine/tui/screens/deploy/index.js.map +1 -0
  644. package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
  645. package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
  646. package/dist/engine/tui/screens/deploy/install-model.js +319 -0
  647. package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
  648. package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
  649. package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
  650. package/dist/engine/tui/screens/deploy/install.js +361 -0
  651. package/dist/engine/tui/screens/deploy/install.js.map +1 -0
  652. package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
  653. package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
  654. package/dist/engine/tui/screens/deploy/model.js +59 -0
  655. package/dist/engine/tui/screens/deploy/model.js.map +1 -0
  656. package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
  657. package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
  658. package/dist/engine/tui/screens/deploy/run-model.js +117 -0
  659. package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
  660. package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
  661. package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
  662. package/dist/engine/tui/screens/deploy/run.js +201 -0
  663. package/dist/engine/tui/screens/deploy/run.js.map +1 -0
  664. package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
  665. package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
  666. package/dist/engine/tui/screens/deploy/status.js +107 -0
  667. package/dist/engine/tui/screens/deploy/status.js.map +1 -0
  668. package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
  669. package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
  670. package/dist/engine/tui/screens/deploy/update.js +175 -0
  671. package/dist/engine/tui/screens/deploy/update.js.map +1 -0
  672. package/dist/engine/tui/screens/deploy.d.ts +12 -0
  673. package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
  674. package/dist/engine/tui/screens/deploy.js +23 -0
  675. package/dist/engine/tui/screens/deploy.js.map +1 -0
  676. package/dist/engine/tui/screens/invoke.d.ts +6 -0
  677. package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
  678. package/dist/engine/tui/screens/invoke.js +193 -0
  679. package/dist/engine/tui/screens/invoke.js.map +1 -0
  680. package/dist/engine/tui/screens/login.d.ts +6 -0
  681. package/dist/engine/tui/screens/login.d.ts.map +1 -0
  682. package/dist/engine/tui/screens/login.js +255 -0
  683. package/dist/engine/tui/screens/login.js.map +1 -0
  684. package/dist/engine/tui/screens/logout.d.ts +6 -0
  685. package/dist/engine/tui/screens/logout.d.ts.map +1 -0
  686. package/dist/engine/tui/screens/logout.js +142 -0
  687. package/dist/engine/tui/screens/logout.js.map +1 -0
  688. package/dist/engine/tui/screens/menu.d.ts +22 -0
  689. package/dist/engine/tui/screens/menu.d.ts.map +1 -0
  690. package/dist/engine/tui/screens/menu.js +84 -0
  691. package/dist/engine/tui/screens/menu.js.map +1 -0
  692. package/dist/engine/tui/screens/node.d.ts +6 -0
  693. package/dist/engine/tui/screens/node.d.ts.map +1 -0
  694. package/dist/engine/tui/screens/node.js +228 -0
  695. package/dist/engine/tui/screens/node.js.map +1 -0
  696. package/dist/engine/tui/screens/status.d.ts +6 -0
  697. package/dist/engine/tui/screens/status.d.ts.map +1 -0
  698. package/dist/engine/tui/screens/status.js +134 -0
  699. package/dist/engine/tui/screens/status.js.map +1 -0
  700. package/dist/engine/tui/scroll-box.d.ts +27 -0
  701. package/dist/engine/tui/scroll-box.d.ts.map +1 -0
  702. package/dist/engine/tui/scroll-box.js +52 -0
  703. package/dist/engine/tui/scroll-box.js.map +1 -0
  704. package/dist/engine/tui/section-registry.d.ts +65 -0
  705. package/dist/engine/tui/section-registry.d.ts.map +1 -0
  706. package/dist/engine/tui/section-registry.js +90 -0
  707. package/dist/engine/tui/section-registry.js.map +1 -0
  708. package/dist/engine/tui/terminal.d.ts +31 -0
  709. package/dist/engine/tui/terminal.d.ts.map +1 -0
  710. package/dist/engine/tui/terminal.js +142 -0
  711. package/dist/engine/tui/terminal.js.map +1 -0
  712. package/dist/engine/tui/tty.d.ts +49 -0
  713. package/dist/engine/tui/tty.d.ts.map +1 -0
  714. package/dist/engine/tui/tty.js +139 -0
  715. package/dist/engine/tui/tty.js.map +1 -0
  716. package/dist/index.d.ts +10 -0
  717. package/dist/index.d.ts.map +1 -0
  718. package/dist/index.js +11 -0
  719. package/dist/index.js.map +1 -0
  720. package/dist/node/index.d.ts +3 -0
  721. package/dist/node/index.d.ts.map +1 -0
  722. package/dist/node/index.js +5 -0
  723. package/dist/node/index.js.map +1 -0
  724. package/dist/telemetry/env-fragment.d.ts +47 -0
  725. package/dist/telemetry/env-fragment.d.ts.map +1 -0
  726. package/dist/telemetry/env-fragment.js +73 -0
  727. package/dist/telemetry/env-fragment.js.map +1 -0
  728. package/dist/telemetry/index.d.ts +7 -0
  729. package/dist/telemetry/index.d.ts.map +1 -0
  730. package/dist/telemetry/index.js +7 -0
  731. package/dist/telemetry/index.js.map +1 -0
  732. package/dist/telemetry/node-span-relay.d.ts +107 -0
  733. package/dist/telemetry/node-span-relay.d.ts.map +1 -0
  734. package/dist/telemetry/node-span-relay.js +314 -0
  735. package/dist/telemetry/node-span-relay.js.map +1 -0
  736. package/dist/telemetry/node-span.d.ts +92 -0
  737. package/dist/telemetry/node-span.d.ts.map +1 -0
  738. package/dist/telemetry/node-span.js +28 -0
  739. package/dist/telemetry/node-span.js.map +1 -0
  740. package/dist/testing/index.d.ts +3 -0
  741. package/dist/testing/index.d.ts.map +1 -0
  742. package/dist/testing/index.js +4 -0
  743. package/dist/testing/index.js.map +1 -0
  744. package/dist/tui/index.d.ts +3 -0
  745. package/dist/tui/index.d.ts.map +1 -0
  746. package/dist/tui/index.js +5 -0
  747. package/dist/tui/index.js.map +1 -0
  748. package/package.json +102 -4
@@ -0,0 +1,362 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { execFile } from 'node:child_process';
3
+ import { Transform } from 'node:stream';
4
+ import { promisify } from 'node:util';
5
+ import { PG_DUMP_COMMAND, PSQL_COMMAND, spawnPgDump } from '../pg-dump.js';
6
+ // =============================================================================
7
+ // `db.backup.run` — taking the database dump on a worker node (issue #352)
8
+ // =============================================================================
9
+ //
10
+ // The node counterpart of `DatabaseBackupRunHandler`, and the first executor in
11
+ // this repository that holds a CREDENTIAL. Everything unusual about it follows
12
+ // from that one fact, so the rules are worth stating before the code:
13
+ //
14
+ // -----------------------------------------------------------------------------
15
+ // ⚠ THE SECRET LIVES IN ONE LOCAL CONSTANT, FOR THE LIFE OF ONE FUNCTION CALL
16
+ // -----------------------------------------------------------------------------
17
+ //
18
+ // It is fetched inside `execute`, held in a `const`, handed to ONE child
19
+ // process through its environment, and dropped when the call returns. It must
20
+ // never reach:
21
+ //
22
+ // * `node-config.ts` or anything that writes it — the config file is a
23
+ // durable, world-readable-if-you-are-root artifact on a machine this
24
+ // deployment may not own, and epic #345's founding rule is that A NODE
25
+ // NEVER PERSISTS CREDENTIALS. `db-backup-run.test.ts` asserts that no
26
+ // config writer is ever called from this path; that assertion is the
27
+ // acceptance test for the rule, not a nicety.
28
+ // * the state directory (`paths.ts`) — same argument, plus it survives
29
+ // restarts.
30
+ // * a log line. `logger.ts` redacts `PGPASSWORD` and the broker's material
31
+ // shape, and this file additionally never puts the material in a message.
32
+ // Two independent mechanisms, because "nothing logs it" is a property of
33
+ // the whole pipeline and not of any one call site.
34
+ // * a child process that outlives the job. `pg_dump` is awaited; `psql` (the
35
+ // provenance probes) is awaited with a short timeout.
36
+ //
37
+ // The credential expires with the job's LEASE, so even a leak is bounded — but
38
+ // "bounded" is not the design, it is the backstop.
39
+ //
40
+ // -----------------------------------------------------------------------------
41
+ // THE ARCHIVE NEVER TOUCHES THIS MACHINE'S DISK OR HEAP
42
+ // -----------------------------------------------------------------------------
43
+ //
44
+ // `pg_dump` writes to stdout, which is piped through a hashing/metering
45
+ // `Transform` straight into a SINGLE-SHOT `PUT` at the presigned URL. Nothing
46
+ // buffers, nothing spools to a temp file: a 200 GB dump costs a hash context
47
+ // and a socket. That is the same streaming contract
48
+ // `db-backup-runner.service.ts` states at length for the server path, and it
49
+ // is what makes moving this work to a node worth doing at all — the bytes go
50
+ // from the database to object storage without transiting the API.
51
+ //
52
+ // ⚠ `fetch` WITH A `Readable` BODY REQUIRES `duplex: 'half'`. Without it
53
+ // undici refuses the request outright ("RequestInit: duplex option is required
54
+ // when sending a body"), and the failure is at call time rather than in the
55
+ // transfer, which makes it look like a bad URL.
56
+ //
57
+ // ⚠ BOTH HALVES ARE AWAITED, and neither one alone is evidence. A dump that
58
+ // dies mid-archive simply ENDS its stdout, so the upload reports a perfectly
59
+ // successful transfer of a TRUNCATED file; only `pg_dump`'s exit code tells
60
+ // the two apart. Equally, a dump that exits 0 says nothing about whether the
61
+ // PUT was accepted. The server then verifies what actually landed in the
62
+ // bucket — see `persistNodeResult` — because neither of these two checks is
63
+ // performed by a party the server has any reason to trust.
64
+ //
65
+ // -----------------------------------------------------------------------------
66
+ // PROVENANCE IS BEST-EFFORT AND NEVER FAILS THE BACKUP
67
+ // -----------------------------------------------------------------------------
68
+ //
69
+ // `pgDumpVersion`, `dbVersion` and `migrationName` are read with `--version`
70
+ // and two `psql` queries, each with a short timeout, each returning `null` on
71
+ // any failure at all. `psql` is a DEGRADABLE capability in
72
+ // `capabilities.ts` for exactly this reason: without it the node still takes a
73
+ // perfectly good backup and reports two nulls. An unreadable version string
74
+ // must never be the reason a database is not backed up — the same rule
75
+ // `pg-version.util.ts` states on the server.
76
+ // =============================================================================
77
+ const execFileAsync = promisify(execFile);
78
+ /** How long a provenance probe may take before it is abandoned as `null`. */
79
+ export const PROVENANCE_TIMEOUT_MS = 10_000;
80
+ /** What the archive is uploaded as. Matches the server's `BACKUP_CONTENT_TYPE`. */
81
+ export const BACKUP_CONTENT_TYPE = 'application/octet-stream';
82
+ export class DatabaseBackupRunExecutor {
83
+ options;
84
+ type = 'db.backup.run';
85
+ /**
86
+ * ⚠ FALSE, AND THE ONE THING NOT TO "FIX". Every other node-eligible type so
87
+ * far reads an input object the server resolves for it; this one's input is
88
+ * the DATABASE, reached through a credential it fetches itself. Setting this
89
+ * true would make the engine ask for a download URL for a job that has no
90
+ * input object, and the request would fail with a 422 before `pg_dump` ever
91
+ * ran.
92
+ */
93
+ requiresInput = false;
94
+ constructor(options = {}) {
95
+ this.options = options;
96
+ }
97
+ async execute(context) {
98
+ const { job, nodeId, api, claimToken } = context;
99
+ // -------------------------------------------------------------------------
100
+ // 1. The credential. ONE LOCAL CONST — see the file header.
101
+ // -------------------------------------------------------------------------
102
+ // `claimToken` on both held-job calls below (#364): a credential and a
103
+ // signed PUT are the two most consequential things a stale slot could ask
104
+ // for, and quoting the claim is what makes the server refuse them once
105
+ // this slot's claim has been superseded.
106
+ const secret = await api.jobSecret(nodeId, job.id, claimToken);
107
+ const connection = readPgMaterial(secret.material);
108
+ // -------------------------------------------------------------------------
109
+ // 2. Where to write. THE SERVER CHOOSES THE KEY, always: this asks for it
110
+ // and reports it back verbatim in the result, and the server refuses a
111
+ // result naming anything else.
112
+ // -------------------------------------------------------------------------
113
+ const target = await api.uploadUrl(nodeId, job.id, BACKUP_CONTENT_TYPE, claimToken);
114
+ if (typeof target.url !== 'string' || target.url.length === 0) {
115
+ throw new Error(`The server returned no upload URL for job ${job.id}; nothing was dumped.`);
116
+ }
117
+ const startedAt = new Date().toISOString();
118
+ // Read BEFORE the dump, deliberately: the credential is alive now, the
119
+ // probes are cheap, and doing them afterwards would run them against a
120
+ // role that may have just been revoked by the job settling.
121
+ const pgDumpVersion = await this.readClientVersion();
122
+ const dbVersion = await this.probeValue(['-c', 'SELECT version()'], connection);
123
+ const migrationName = await this.probeValue([
124
+ '-c',
125
+ 'SELECT migration_name FROM _prisma_migrations ' +
126
+ 'WHERE finished_at IS NOT NULL ORDER BY finished_at DESC LIMIT 1',
127
+ ], connection);
128
+ // -------------------------------------------------------------------------
129
+ // 3. Dump → hash/meter → PUT, as one stream.
130
+ // -------------------------------------------------------------------------
131
+ const dump = spawnPgDump({
132
+ connection,
133
+ ...(this.options.spawnFn !== undefined ? { spawnFn: this.options.spawnFn } : {}),
134
+ ...(this.options.pgDumpCommand !== undefined ? { command: this.options.pgDumpCommand } : {}),
135
+ });
136
+ const hash = createHash('sha256');
137
+ let bytes = 0n;
138
+ const meter = new Transform({
139
+ transform(chunk, _encoding, callback) {
140
+ hash.update(chunk);
141
+ bytes += BigInt(chunk.length);
142
+ // Forwarded UNCHANGED and NOT retained: a tap, not a buffer.
143
+ callback(null, chunk);
144
+ },
145
+ });
146
+ // ⚠ NO-OP `error` LISTENERS, AND THEY ARE NOT DECORATION. A Node stream
147
+ // that emits `error` with nothing listening throws it as an UNCAUGHT
148
+ // EXCEPTION and takes the worker down — taking every other job on this
149
+ // node with it. Both of these are destroyed on purpose below (a dead dump,
150
+ // an aborted job), at a moment when the upload may already have stopped
151
+ // reading. The error is not lost: it travels to the caller through the
152
+ // `Promise.all`.
153
+ meter.on('error', () => undefined);
154
+ dump.stdout.on('error', () => undefined);
155
+ // Cooperative cancellation: a drain or a lost lease must stop a
156
+ // multi-hour dump rather than finish work nobody will accept. The abort
157
+ // tears down the child AND the pipe, so the upload fails too.
158
+ const onAbort = () => {
159
+ dump.kill();
160
+ meter.destroy(new Error(`Backup of job ${job.id} was aborted`));
161
+ };
162
+ context.signal.addEventListener('abort', onAbort, { once: true });
163
+ // ⚠ AND THE FLAG IS RE-READ, because a listener added AFTER the event has
164
+ // already fired is never called. The engine aborts on drain and on lease
165
+ // loss, and both can land while the credential fetch and the two
166
+ // provenance probes above are in flight — a window of seconds, on the one
167
+ // job type that then reads an entire database for nobody. Same defence
168
+ // `db-backup-runner.service.ts` states for a cancel that arrives during
169
+ // its version check.
170
+ if (context.signal.aborted)
171
+ onAbort();
172
+ // A DEAD DUMP MUST TEAR THE UPLOAD DOWN, or the PUT sits waiting on a
173
+ // stream that will never end. `.catch()` returns a NEW promise, so
174
+ // `dump.done` still rejects into the `Promise.all` below.
175
+ dump.done.catch((error) => {
176
+ meter.destroy(error instanceof Error ? error : new Error(String(error)));
177
+ });
178
+ dump.stdout.pipe(meter);
179
+ const fetchImpl = this.options.fetchImpl ?? globalThis.fetch;
180
+ const putArchive = async () => {
181
+ const response = await fetchImpl(target.url, {
182
+ method: 'PUT',
183
+ headers: { 'content-type': BACKUP_CONTENT_TYPE },
184
+ // Cast: `RequestInit.body` does not name Node's `Readable`, which
185
+ // undici accepts natively. `duplex` is likewise not in the DOM lib and
186
+ // is REQUIRED for a streaming body.
187
+ body: meter,
188
+ duplex: 'half',
189
+ });
190
+ if (!response.ok) {
191
+ throw new Error(`Uploading the backup for job ${job.id} failed with HTTP ${response.status}.`);
192
+ }
193
+ };
194
+ // Timed as the relayed `job.upload` phase (#608) when the engine offers
195
+ // it. The byte count is read when the PUT completes, by which point the
196
+ // meter has seen the whole archive; past 2^53 it is omitted rather than
197
+ // rounded.
198
+ const upload = context.phase !== undefined
199
+ ? context.phase('job.upload', putArchive, () => bytes <= BigInt(Number.MAX_SAFE_INTEGER) ? { bytes: Number(bytes) } : undefined)
200
+ : putArchive();
201
+ // ...AND A DEAD UPLOAD MUST TEAR THE DUMP DOWN, or `pg_dump` reads a whole
202
+ // database to produce an archive nobody is storing.
203
+ upload.catch(() => {
204
+ dump.kill();
205
+ });
206
+ try {
207
+ // BOTH HALVES. See the file header for why neither alone is evidence.
208
+ await Promise.all([upload, dump.done]);
209
+ }
210
+ finally {
211
+ context.signal.removeEventListener('abort', onAbort);
212
+ }
213
+ const result = {
214
+ // Reported back, never chosen: the server refuses a key it did not hand
215
+ // out, which is what stops a node pointing a restore at other bytes.
216
+ storageKey: target.key,
217
+ // ⚠ A DECIMAL STRING. A dump past 2 GiB is ordinary and a JSON number
218
+ // stops being exact above 2^53, so the corruption would land on exactly
219
+ // the largest backups. See the contract's header.
220
+ bytes: bytes.toString(),
221
+ sha256: hash.digest('hex'),
222
+ pgDumpVersion,
223
+ dbVersion,
224
+ migrationName,
225
+ startedAt,
226
+ finishedAt: new Date().toISOString(),
227
+ };
228
+ // ⚠ THE LOG LINE NAMES NOTHING FROM `secret`. Size, digest and key are the
229
+ // useful facts; the credential is not one of them.
230
+ context.log('database backup uploaded', {
231
+ jobId: job.id,
232
+ bytes: result.bytes,
233
+ sha256: result.sha256,
234
+ key: result.storageKey,
235
+ });
236
+ return result;
237
+ }
238
+ /** `pg_dump --version`, or `null`. Never throws — see the file header. */
239
+ async readClientVersion() {
240
+ if (this.options.readClientVersion !== undefined) {
241
+ return this.options.readClientVersion();
242
+ }
243
+ try {
244
+ const { stdout } = await execFileAsync(this.options.pgDumpCommand ?? PG_DUMP_COMMAND, ['--version'], {
245
+ timeout: PROVENANCE_TIMEOUT_MS,
246
+ });
247
+ return firstLine(stdout);
248
+ }
249
+ catch {
250
+ return null;
251
+ }
252
+ }
253
+ /**
254
+ * One `psql` scalar, or `null`.
255
+ *
256
+ * ⚠ THE QUERIES ARE CONSTANTS, NOT BUILT FROM ANYTHING. Nothing
257
+ * caller-supplied reaches SQL here: the connection travels as flags and the
258
+ * password as an environment variable, so there is no interpolation to get
259
+ * wrong. `-X` skips `~/.psqlrc` (a worker node is a machine somebody has
260
+ * used by hand), `-A -t` give a bare value with no alignment or header.
261
+ */
262
+ async probeValue(args, connection) {
263
+ if (this.options.probe !== undefined) {
264
+ return this.options.probe(args, connection);
265
+ }
266
+ try {
267
+ const { stdout } = await execFileAsync(this.options.psqlCommand ?? PSQL_COMMAND, [
268
+ '--host',
269
+ connection.host,
270
+ '--port',
271
+ connection.port,
272
+ '--username',
273
+ connection.user,
274
+ '--dbname',
275
+ connection.database,
276
+ '--no-password',
277
+ '-X',
278
+ '-A',
279
+ '-t',
280
+ ...args,
281
+ ], {
282
+ timeout: PROVENANCE_TIMEOUT_MS,
283
+ env: pgProbeEnv(connection),
284
+ });
285
+ return firstLine(stdout);
286
+ }
287
+ catch {
288
+ // A missing `psql`, a permission denied on `_prisma_migrations`, a
289
+ // timeout: all of them mean "this fact was not readable", which is a
290
+ // `null` column and never a failed backup.
291
+ return null;
292
+ }
293
+ }
294
+ }
295
+ /**
296
+ * Narrows the broker's opaque `material` into a connection, or throws.
297
+ *
298
+ * ⚠ VALIDATED RATHER THAN CAST, and the failure is a NAMED error. `material`
299
+ * is `Record<string, unknown>` by contract — the API passes it through without
300
+ * interpreting it — so a broker change, a version skew, or a fork's own
301
+ * `postgres`-kind broker returning a DSN would otherwise surface as
302
+ * `undefined` inside an argv and a `pg_dump` that connects to the wrong place
303
+ * (or to localhost) with an unhelpful error.
304
+ *
305
+ * ⚠ THE ERROR MESSAGE NAMES THE MISSING FIELDS AND NOTHING ELSE. It must never
306
+ * include the material itself: this string becomes `Job.lastError` on the
307
+ * server and a line in this node's log.
308
+ */
309
+ export function readPgMaterial(material) {
310
+ const read = (key) => {
311
+ const value = material[key];
312
+ if (typeof value === 'string' && value.length > 0)
313
+ return value;
314
+ if (typeof value === 'number' && Number.isFinite(value))
315
+ return String(value);
316
+ return undefined;
317
+ };
318
+ const host = read('host');
319
+ const port = read('port');
320
+ const user = read('user');
321
+ const password = read('password');
322
+ const database = read('database');
323
+ const missing = Object.entries({ host, port, user, password, database })
324
+ .filter(([, value]) => value === undefined)
325
+ .map(([key]) => key);
326
+ if (missing.length > 0) {
327
+ throw new Error(`The credential this server issued is missing: ${missing.join(', ')}. This node cannot ` +
328
+ 'build a PostgreSQL connection from it; nothing was dumped.');
329
+ }
330
+ const sslMode = read('sslMode');
331
+ return {
332
+ host: host,
333
+ port: port,
334
+ user: user,
335
+ password: password,
336
+ database: database,
337
+ sslMode: sslMode ?? null,
338
+ };
339
+ }
340
+ /**
341
+ * The provenance probe's environment.
342
+ *
343
+ * The same rule as the dump's — see `pgClientEnv` in `pg-dump.ts` — and it is
344
+ * built here rather than imported wholesale because `execFile`'s `env` also
345
+ * replaces the child's environment entirely.
346
+ */
347
+ function pgProbeEnv(connection) {
348
+ const env = { ...process.env };
349
+ delete env.PGSERVICE;
350
+ delete env.PGSERVICEFILE;
351
+ delete env.PGPASSFILE;
352
+ env.PGPASSWORD = connection.password;
353
+ if (connection.sslMode !== null)
354
+ env.PGSSLMODE = connection.sslMode;
355
+ return env;
356
+ }
357
+ /** First non-empty line, trimmed and bounded — the columns are 128/255 wide. */
358
+ function firstLine(value) {
359
+ const line = value.split('\n').map((entry) => entry.trim()).find((entry) => entry.length > 0);
360
+ return line === undefined ? null : line.slice(0, 128);
361
+ }
362
+ //# sourceMappingURL=db-backup-run.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"db-backup-run.js","sourceRoot":"","sources":["../../../../src/engine/node/executors/db-backup-run.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ import type { JobExecutionContext, JobExecutor } from './index.js';
2
+ /** Mirrors `ExampleChecksumResult` in `apps/api/src/jobs/contracts/`. */
3
+ export interface ExampleChecksumResult {
4
+ sha256: string;
5
+ bytes: number;
6
+ computedAt: string;
7
+ computedBy: 'node';
8
+ }
9
+ export declare class ExampleChecksumExecutor implements JobExecutor {
10
+ readonly type = "example.checksum";
11
+ /** The input IS the work. Without it there is nothing to hash. */
12
+ readonly requiresInput = true;
13
+ execute(context: JobExecutionContext): Promise<ExampleChecksumResult>;
14
+ }
15
+ /**
16
+ * Every executor this template ships. A fork appends to this list.
17
+ *
18
+ * ⚠ REGISTERED IS NOT THE SAME AS RUN. `db.backup.run` (#352) is here because
19
+ * this CLI knows HOW to take a database dump; whether it ever gets one is
20
+ * decided entirely by the server — the type is offered to a node only when the
21
+ * deployment has enabled both `nodes.jobSecretBrokerEnabled` and
22
+ * `databaseBackup.nodeOffloadEnabled` AND the credential broker reports itself
23
+ * usable. A node also declares the type only if `evaluateCapabilities` finds
24
+ * `pg_dump` on this machine. Listing the executor unconditionally is what lets
25
+ * all three of those decisions live where they belong.
26
+ *
27
+ * @stability experimental
28
+ */
29
+ export declare function defaultExecutors(): JobExecutor[];
30
+ //# sourceMappingURL=example-checksum.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example-checksum.d.ts","sourceRoot":"","sources":["../../../../src/engine/node/executors/example-checksum.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkBnE,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,uBAAwB,YAAW,WAAW;IACzD,QAAQ,CAAC,IAAI,sBAAsB;IAEnC,kEAAkE;IAClE,QAAQ,CAAC,aAAa,QAAQ;IAExB,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAiC5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAEhD"}
@@ -0,0 +1,56 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { createReadStream } from 'node:fs';
3
+ import { MissingJobInputError } from '../node-errors.js';
4
+ import { DatabaseBackupRunExecutor } from './db-backup-run.js';
5
+ export class ExampleChecksumExecutor {
6
+ type = 'example.checksum';
7
+ /** The input IS the work. Without it there is nothing to hash. */
8
+ requiresInput = true;
9
+ async execute(context) {
10
+ // Belt and braces: the engine already refuses a `requiresInput` job with
11
+ // no download URL. Asserting it here too means the executor is safe to
12
+ // call directly — which #279's TUI and a fork's own tests will do.
13
+ if (context.inputPath === undefined || context.inputPath.length === 0) {
14
+ throw new MissingJobInputError(context.job.id, this.type);
15
+ }
16
+ const hash = createHash('sha256');
17
+ let bytes = 0;
18
+ const stream = createReadStream(context.inputPath);
19
+ for await (const chunk of stream) {
20
+ const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
21
+ hash.update(buffer);
22
+ bytes += buffer.length;
23
+ // Cooperative cancellation: a drain or a lost lease should stop a
24
+ // multi-gigabyte hash rather than finishing work nobody will accept.
25
+ if (context.signal.aborted) {
26
+ stream.destroy();
27
+ throw new Error(`Checksum of job ${context.job.id} was aborted after ${bytes} bytes`);
28
+ }
29
+ }
30
+ context.log('checksum computed', { jobId: context.job.id, bytes });
31
+ return {
32
+ sha256: hash.digest('hex'),
33
+ bytes,
34
+ computedAt: new Date().toISOString(),
35
+ computedBy: 'node',
36
+ };
37
+ }
38
+ }
39
+ /**
40
+ * Every executor this template ships. A fork appends to this list.
41
+ *
42
+ * ⚠ REGISTERED IS NOT THE SAME AS RUN. `db.backup.run` (#352) is here because
43
+ * this CLI knows HOW to take a database dump; whether it ever gets one is
44
+ * decided entirely by the server — the type is offered to a node only when the
45
+ * deployment has enabled both `nodes.jobSecretBrokerEnabled` and
46
+ * `databaseBackup.nodeOffloadEnabled` AND the credential broker reports itself
47
+ * usable. A node also declares the type only if `evaluateCapabilities` finds
48
+ * `pg_dump` on this machine. Listing the executor unconditionally is what lets
49
+ * all three of those decisions live where they belong.
50
+ *
51
+ * @stability experimental
52
+ */
53
+ export function defaultExecutors() {
54
+ return [new ExampleChecksumExecutor(), new DatabaseBackupRunExecutor()];
55
+ }
56
+ //# sourceMappingURL=example-checksum.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example-checksum.js","sourceRoot":"","sources":["../../../../src/engine/node/executors/example-checksum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AA2B/D,MAAM,OAAO,uBAAuB;IACzB,IAAI,GAAG,kBAAkB,CAAC;IAEnC,kEAAkE;IACzD,aAAa,GAAG,IAAI,CAAC;IAE9B,KAAK,CAAC,OAAO,CAAC,OAA4B;QACxC,yEAAyE;QACzE,uEAAuE;QACvE,mEAAmE;QACnE,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;YAC7E,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpB,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC;YACvB,kEAAkE;YAClE,qEAAqE;YACrE,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC3B,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,CAAC,GAAG,CAAC,EAAE,sBAAsB,KAAK,QAAQ,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAEnE,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAC1B,KAAK;YACL,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,IAAI,uBAAuB,EAAE,EAAE,IAAI,yBAAyB,EAAE,CAAC,CAAC;AAC1E,CAAC"}
@@ -0,0 +1,168 @@
1
+ import type { ClaimToken, DownloadUrlResult, JobSecret, NodeJob, NodeSpanAttributes, NodeSpanName, UploadUrlResult } from '../node-api.js';
2
+ /**
3
+ * The part of the node API an executor may call, all of it for the job it
4
+ * holds. The engine passes its whole `NodeApi`; an executor is typed against
5
+ * this so it cannot settle, renew or claim behind the engine's back.
6
+ *
7
+ * @stability experimental
8
+ */
9
+ export interface ExecutorNodeApi {
10
+ /**
11
+ * Mints this job's credential: job-scoped, bounded by the lease, held in
12
+ * memory for the job and never written or logged (CLAUDE.md queue rule 3).
13
+ *
14
+ * @param nodeId - `context.nodeId`.
15
+ * @param jobId - `context.job.id`.
16
+ * @param claimToken - `context.claimToken`, passed through unchanged.
17
+ */
18
+ jobSecret(nodeId: string, jobId: string, claimToken?: ClaimToken): Promise<JobSecret>;
19
+ /**
20
+ * A presigned PUT for the job's output; the SERVER chooses the key.
21
+ *
22
+ * @param nodeId - `context.nodeId`.
23
+ * @param jobId - `context.job.id`.
24
+ * @param contentType - The upload's MIME type.
25
+ * @param claimToken - `context.claimToken`, passed through unchanged.
26
+ */
27
+ uploadUrl(nodeId: string, jobId: string, contentType?: string, claimToken?: ClaimToken): Promise<UploadUrlResult>;
28
+ /**
29
+ * A presigned GET for the job's input object (the engine already streams it
30
+ * to `inputPath` when `requiresInput` is true).
31
+ *
32
+ * @param nodeId - `context.nodeId`.
33
+ * @param jobId - `context.job.id`.
34
+ * @param claimToken - `context.claimToken`, passed through unchanged.
35
+ */
36
+ downloadUrl(nodeId: string, jobId: string, claimToken?: ClaimToken): Promise<DownloadUrlResult>;
37
+ }
38
+ /**
39
+ * Everything an executor is given. Nothing is reachable except through this.
40
+ *
41
+ * @stability experimental
42
+ */
43
+ export interface JobExecutionContext {
44
+ /** The job row as the server leased it. */
45
+ job: NodeJob;
46
+ /** The handler's own parameters, straight from `Job.payload`. */
47
+ params: Record<string, unknown>;
48
+ /**
49
+ * Where the input object was streamed to, when `requiresInput` is true.
50
+ * Guaranteed non-empty for such a type: the engine refuses the job with a
51
+ * NAMED error rather than passing an empty path through.
52
+ */
53
+ inputPath: string | undefined;
54
+ /** The input object's metadata, when there was one. */
55
+ input: {
56
+ /** The input object's id. */
57
+ objectId: string;
58
+ /** Its size in bytes, as a decimal string. */
59
+ size: string;
60
+ /** Its MIME type. */
61
+ mimeType: string;
62
+ } | undefined;
63
+ /** For a type that needs its credential or must upload its output. */
64
+ api: ExecutorNodeApi;
65
+ /** This node's id, for every `api` call. */
66
+ nodeId: string;
67
+ /**
68
+ * Which claim of this job the engine is executing (#364).
69
+ *
70
+ * Pass it to EVERY `api` call made against `job.id` — an upload target, a
71
+ * job credential — exactly as the engine passes it to the renewal ticker,
72
+ * the result and the failure. `nodeId` says which machine is calling;
73
+ * without this, a slot that stalled and was re-claimed is indistinguishable
74
+ * from the slot now running the job, and can mint a signed PUT or a database
75
+ * credential against a lease it no longer holds.
76
+ *
77
+ * `undefined` is ordinary, not a fault: an older control plane sends no
78
+ * token, and a row claimed before the column existed sends `null`. Pass the
79
+ * value through unchanged either way — `claimTokenBody` is what decides that
80
+ * the key is omitted rather than sent as `null`, and it is the only place
81
+ * that decision should be made.
82
+ */
83
+ claimToken: ClaimToken;
84
+ /** Aborted on drain and on lease loss. Long work should honour it. */
85
+ signal: AbortSignal;
86
+ /** Structured logging that goes through the daemon's redaction (#275). */
87
+ log(message: string, fields?: Record<string, unknown>): void;
88
+ /**
89
+ * Times `work` as a relayed phase span (#608) — for a phase only the
90
+ * executor can see, such as an upload streamed from inside `execute`.
91
+ * Returns (or rethrows) exactly what `work` does; recording never fails the
92
+ * job. Optional so a hand-built test context need not supply it.
93
+ */
94
+ phase?<T>(name: NodeSpanName, work: () => Promise<T>, attributes?: NodeSpanAttributes | ((result: T) => NodeSpanAttributes | undefined)): Promise<T>;
95
+ }
96
+ /**
97
+ * One job type this machine can run.
98
+ *
99
+ * @stability experimental
100
+ *
101
+ * `execute` RETURNS the result and THROWS to fail — the same contract the
102
+ * server's handlers use, for the same reason: every provider error, missing
103
+ * file and truncated stream becomes a reported failure with the real message,
104
+ * and nobody has to remember to check a return code.
105
+ *
106
+ * Throw `ProviderRateLimitError` to route a throttle through the server's
107
+ * deferral path instead of burning an attempt.
108
+ */
109
+ export interface JobExecutor {
110
+ /** The job type, as the server's handler declares it (permanent once jobs exist). */
111
+ readonly type: string;
112
+ /**
113
+ * Whether the engine should fetch a download URL and stream the input to a
114
+ * temp file before calling `execute`.
115
+ *
116
+ * Declared rather than inferred, so a type that needs an input and did not
117
+ * get one fails with a named error at the top of the job instead of an
118
+ * opaque filesystem error somewhere inside it.
119
+ */
120
+ readonly requiresInput: boolean;
121
+ /**
122
+ * Runs the job: returns the result the server's `nodeResultSchema` expects,
123
+ * throws to fail it.
124
+ *
125
+ * @param context - The job, its params and the node API.
126
+ */
127
+ execute(context: JobExecutionContext): Promise<unknown>;
128
+ /**
129
+ * App-defined numeric vitals this executor reports on every heartbeat, merged
130
+ * with the other executors' into the heartbeat's `vitals.extra` (the fleet
131
+ * page labels a key through `registerNodeVital`). Optional; read at heartbeat
132
+ * time, so it MUST be cheap, synchronous and must not spawn a process. At
133
+ * most 16 keys fleet-wide, each `^[a-z][a-z0-9_.]{1,47}$`, each a finite
134
+ * number: `sanitizeExtraVitals` drops the rest, and a throw here is swallowed.
135
+ *
136
+ * @returns a record of key to number, or `undefined` for none.
137
+ */
138
+ vitals?(): Record<string, number> | undefined;
139
+ }
140
+ /**
141
+ * A mutable registry. One instance per engine, so tests never share state.
142
+ *
143
+ * @stability experimental
144
+ */
145
+ export declare class ExecutorRegistry {
146
+ private readonly executors;
147
+ /**
148
+ * Adds (or replaces) the executor for its type.
149
+ *
150
+ * @param executor - The executor.
151
+ * @returns This registry, for chaining.
152
+ */
153
+ register(executor: JobExecutor): this;
154
+ /** Every registered executor, in type order. */
155
+ list(): JobExecutor[];
156
+ /** Every type this node can run. What `register`/`claim` advertise. */
157
+ types(): string[];
158
+ /**
159
+ * Whether this node can run `type`.
160
+ *
161
+ * @param type - A job type.
162
+ * @returns `true` when an executor is registered for it.
163
+ */
164
+ has(type: string): boolean;
165
+ /** Throws `UnknownJobTypeError`, naming what this node CAN run. */
166
+ require(type: string): JobExecutor;
167
+ }
168
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engine/node/executors/index.ts"],"names":[],"mappings":"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"}