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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (943) hide show
  1. package/CHANGELOG.md +365 -0
  2. package/README.md +163 -31
  3. package/dist/android/build.d.ts +30 -0
  4. package/dist/android/build.d.ts.map +1 -0
  5. package/dist/android/build.js +126 -0
  6. package/dist/android/build.js.map +1 -0
  7. package/dist/android/command.d.ts +21 -0
  8. package/dist/android/command.d.ts.map +1 -0
  9. package/dist/android/command.js +355 -0
  10. package/dist/android/command.js.map +1 -0
  11. package/dist/android/deploy-step.d.ts +85 -0
  12. package/dist/android/deploy-step.d.ts.map +1 -0
  13. package/dist/android/deploy-step.js +268 -0
  14. package/dist/android/deploy-step.js.map +1 -0
  15. package/dist/android/doctor.d.ts +47 -0
  16. package/dist/android/doctor.d.ts.map +1 -0
  17. package/dist/android/doctor.js +219 -0
  18. package/dist/android/doctor.js.map +1 -0
  19. package/dist/android/exec.d.ts +42 -0
  20. package/dist/android/exec.d.ts.map +1 -0
  21. package/dist/android/exec.js +103 -0
  22. package/dist/android/exec.js.map +1 -0
  23. package/dist/android/fix-plan.d.ts +44 -0
  24. package/dist/android/fix-plan.d.ts.map +1 -0
  25. package/dist/android/fix-plan.js +86 -0
  26. package/dist/android/fix-plan.js.map +1 -0
  27. package/dist/android/git-freshness.d.ts +34 -0
  28. package/dist/android/git-freshness.d.ts.map +1 -0
  29. package/dist/android/git-freshness.js +120 -0
  30. package/dist/android/git-freshness.js.map +1 -0
  31. package/dist/android/gradle.d.ts +32 -0
  32. package/dist/android/gradle.d.ts.map +1 -0
  33. package/dist/android/gradle.js +55 -0
  34. package/dist/android/gradle.js.map +1 -0
  35. package/dist/android/identity.d.ts +27 -0
  36. package/dist/android/identity.d.ts.map +1 -0
  37. package/dist/android/identity.js +60 -0
  38. package/dist/android/identity.js.map +1 -0
  39. package/dist/android/index.d.ts +7 -0
  40. package/dist/android/index.d.ts.map +1 -0
  41. package/dist/android/index.js +8 -0
  42. package/dist/android/index.js.map +1 -0
  43. package/dist/android/installer.d.ts +28 -0
  44. package/dist/android/installer.d.ts.map +1 -0
  45. package/dist/android/installer.js +96 -0
  46. package/dist/android/installer.js.map +1 -0
  47. package/dist/android/java.d.ts +26 -0
  48. package/dist/android/java.d.ts.map +1 -0
  49. package/dist/android/java.js +65 -0
  50. package/dist/android/java.js.map +1 -0
  51. package/dist/android/keystore.d.ts +54 -0
  52. package/dist/android/keystore.d.ts.map +1 -0
  53. package/dist/android/keystore.js +159 -0
  54. package/dist/android/keystore.js.map +1 -0
  55. package/dist/android/metadata.d.ts +39 -0
  56. package/dist/android/metadata.d.ts.map +1 -0
  57. package/dist/android/metadata.js +61 -0
  58. package/dist/android/metadata.js.map +1 -0
  59. package/dist/android/operations.d.ts +42 -0
  60. package/dist/android/operations.d.ts.map +1 -0
  61. package/dist/android/operations.js +59 -0
  62. package/dist/android/operations.js.map +1 -0
  63. package/dist/android/paths.d.ts +29 -0
  64. package/dist/android/paths.d.ts.map +1 -0
  65. package/dist/android/paths.js +97 -0
  66. package/dist/android/paths.js.map +1 -0
  67. package/dist/android/publish.d.ts +37 -0
  68. package/dist/android/publish.d.ts.map +1 -0
  69. package/dist/android/publish.js +119 -0
  70. package/dist/android/publish.js.map +1 -0
  71. package/dist/android/registrations.d.ts +92 -0
  72. package/dist/android/registrations.d.ts.map +1 -0
  73. package/dist/android/registrations.js +112 -0
  74. package/dist/android/registrations.js.map +1 -0
  75. package/dist/android/release-status.d.ts +73 -0
  76. package/dist/android/release-status.d.ts.map +1 -0
  77. package/dist/android/release-status.js +161 -0
  78. package/dist/android/release-status.js.map +1 -0
  79. package/dist/android/release.d.ts +33 -0
  80. package/dist/android/release.d.ts.map +1 -0
  81. package/dist/android/release.js +59 -0
  82. package/dist/android/release.js.map +1 -0
  83. package/dist/android/screen-layout.d.ts +26 -0
  84. package/dist/android/screen-layout.d.ts.map +1 -0
  85. package/dist/android/screen-layout.js +24 -0
  86. package/dist/android/screen-layout.js.map +1 -0
  87. package/dist/android/screen-model.d.ts +56 -0
  88. package/dist/android/screen-model.d.ts.map +1 -0
  89. package/dist/android/screen-model.js +207 -0
  90. package/dist/android/screen-model.js.map +1 -0
  91. package/dist/android/screen.d.ts +8 -0
  92. package/dist/android/screen.d.ts.map +1 -0
  93. package/dist/android/screen.js +395 -0
  94. package/dist/android/screen.js.map +1 -0
  95. package/dist/android/sdk.d.ts +48 -0
  96. package/dist/android/sdk.d.ts.map +1 -0
  97. package/dist/android/sdk.js +82 -0
  98. package/dist/android/sdk.js.map +1 -0
  99. package/dist/android/server-url.d.ts +19 -0
  100. package/dist/android/server-url.d.ts.map +1 -0
  101. package/dist/android/server-url.js +36 -0
  102. package/dist/android/server-url.js.map +1 -0
  103. package/dist/android/upload-progress.d.ts +3 -0
  104. package/dist/android/upload-progress.d.ts.map +1 -0
  105. package/dist/android/upload-progress.js +47 -0
  106. package/dist/android/upload-progress.js.map +1 -0
  107. package/dist/android/version.d.ts +47 -0
  108. package/dist/android/version.d.ts.map +1 -0
  109. package/dist/android/version.js +136 -0
  110. package/dist/android/version.js.map +1 -0
  111. package/dist/api-client/index.d.ts +3 -0
  112. package/dist/api-client/index.d.ts.map +1 -0
  113. package/dist/api-client/index.js +5 -0
  114. package/dist/api-client/index.js.map +1 -0
  115. package/dist/commands/index.d.ts +52 -0
  116. package/dist/commands/index.d.ts.map +1 -0
  117. package/dist/commands/index.js +63 -0
  118. package/dist/commands/index.js.map +1 -0
  119. package/dist/core/cli-registry.d.ts +41 -0
  120. package/dist/core/cli-registry.d.ts.map +1 -0
  121. package/dist/core/cli-registry.js +49 -0
  122. package/dist/core/cli-registry.js.map +1 -0
  123. package/dist/core/command-registry.d.ts +10 -0
  124. package/dist/core/command-registry.d.ts.map +1 -1
  125. package/dist/core/command-registry.js +17 -0
  126. package/dist/core/command-registry.js.map +1 -1
  127. package/dist/core/env-annotation-registry.d.ts +58 -0
  128. package/dist/core/env-annotation-registry.d.ts.map +1 -0
  129. package/dist/core/env-annotation-registry.js +80 -0
  130. package/dist/core/env-annotation-registry.js.map +1 -0
  131. package/dist/core/env-generator-registry.d.ts +59 -0
  132. package/dist/core/env-generator-registry.d.ts.map +1 -0
  133. package/dist/core/env-generator-registry.js +102 -0
  134. package/dist/core/env-generator-registry.js.map +1 -0
  135. package/dist/core/env-group-registry.d.ts +65 -0
  136. package/dist/core/env-group-registry.d.ts.map +1 -0
  137. package/dist/core/env-group-registry.js +77 -0
  138. package/dist/core/env-group-registry.js.map +1 -0
  139. package/dist/core/env-spec-registry.d.ts +16 -2
  140. package/dist/core/env-spec-registry.d.ts.map +1 -1
  141. package/dist/core/env-spec-registry.js +15 -0
  142. package/dist/core/env-spec-registry.js.map +1 -1
  143. package/dist/core/env-values.d.ts +3 -2
  144. package/dist/core/env-values.d.ts.map +1 -1
  145. package/dist/core/env-values.js +5 -3
  146. package/dist/core/env-values.js.map +1 -1
  147. package/dist/core/index.d.ts +10 -2
  148. package/dist/core/index.d.ts.map +1 -1
  149. package/dist/core/index.js +6 -2
  150. package/dist/core/index.js.map +1 -1
  151. package/dist/deploy/index.d.ts +3 -0
  152. package/dist/deploy/index.d.ts.map +1 -0
  153. package/dist/deploy/index.js +5 -0
  154. package/dist/deploy/index.js.map +1 -0
  155. package/dist/engine/api-client.d.ts +211 -0
  156. package/dist/engine/api-client.d.ts.map +1 -0
  157. package/dist/engine/api-client.js +350 -0
  158. package/dist/engine/api-client.js.map +1 -0
  159. package/dist/engine/browser.d.ts +18 -0
  160. package/dist/engine/browser.d.ts.map +1 -0
  161. package/dist/engine/browser.js +115 -0
  162. package/dist/engine/browser.js.map +1 -0
  163. package/dist/engine/builtin-registrations.d.ts +20 -0
  164. package/dist/engine/builtin-registrations.d.ts.map +1 -0
  165. package/dist/engine/builtin-registrations.js +86 -0
  166. package/dist/engine/builtin-registrations.js.map +1 -0
  167. package/dist/engine/commands/api.d.ts +88 -0
  168. package/dist/engine/commands/api.d.ts.map +1 -0
  169. package/dist/engine/commands/api.js +398 -0
  170. package/dist/engine/commands/api.js.map +1 -0
  171. package/dist/engine/commands/config.d.ts +5 -0
  172. package/dist/engine/commands/config.d.ts.map +1 -0
  173. package/dist/engine/commands/config.js +83 -0
  174. package/dist/engine/commands/config.js.map +1 -0
  175. package/dist/engine/commands/deploy.d.ts +250 -0
  176. package/dist/engine/commands/deploy.d.ts.map +1 -0
  177. package/dist/engine/commands/deploy.js +1186 -0
  178. package/dist/engine/commands/deploy.js.map +1 -0
  179. package/dist/engine/commands/init.d.ts +18 -0
  180. package/dist/engine/commands/init.d.ts.map +1 -0
  181. package/dist/engine/commands/init.js +50 -0
  182. package/dist/engine/commands/init.js.map +1 -0
  183. package/dist/engine/commands/login.d.ts +4 -0
  184. package/dist/engine/commands/login.d.ts.map +1 -0
  185. package/dist/engine/commands/login.js +205 -0
  186. package/dist/engine/commands/login.js.map +1 -0
  187. package/dist/engine/commands/node.d.ts +21 -0
  188. package/dist/engine/commands/node.d.ts.map +1 -0
  189. package/dist/engine/commands/node.js +503 -0
  190. package/dist/engine/commands/node.js.map +1 -0
  191. package/dist/engine/config.d.ts +284 -0
  192. package/dist/engine/config.d.ts.map +1 -0
  193. package/dist/engine/config.js +469 -0
  194. package/dist/engine/config.js.map +1 -0
  195. package/dist/engine/conformance.d.ts +193 -0
  196. package/dist/engine/conformance.d.ts.map +1 -0
  197. package/dist/engine/conformance.js +243 -0
  198. package/dist/engine/conformance.js.map +1 -0
  199. package/dist/engine/create-cli.d.ts +181 -0
  200. package/dist/engine/create-cli.d.ts.map +1 -0
  201. package/dist/engine/create-cli.js +91 -0
  202. package/dist/engine/create-cli.js.map +1 -0
  203. package/dist/engine/deploy/about.d.ts +12 -0
  204. package/dist/engine/deploy/about.d.ts.map +1 -0
  205. package/dist/engine/deploy/about.js +110 -0
  206. package/dist/engine/deploy/about.js.map +1 -0
  207. package/dist/engine/deploy/adopt.d.ts +21 -0
  208. package/dist/engine/deploy/adopt.d.ts.map +1 -0
  209. package/dist/engine/deploy/adopt.js +78 -0
  210. package/dist/engine/deploy/adopt.js.map +1 -0
  211. package/dist/engine/deploy/answers-file.d.ts +7 -0
  212. package/dist/engine/deploy/answers-file.d.ts.map +1 -0
  213. package/dist/engine/deploy/answers-file.js +49 -0
  214. package/dist/engine/deploy/answers-file.js.map +1 -0
  215. package/dist/engine/deploy/app-role.d.ts +278 -0
  216. package/dist/engine/deploy/app-role.d.ts.map +1 -0
  217. package/dist/engine/deploy/app-role.js +826 -0
  218. package/dist/engine/deploy/app-role.js.map +1 -0
  219. package/dist/engine/deploy/app-version.d.ts +103 -0
  220. package/dist/engine/deploy/app-version.d.ts.map +1 -0
  221. package/dist/engine/deploy/app-version.js +344 -0
  222. package/dist/engine/deploy/app-version.js.map +1 -0
  223. package/dist/engine/deploy/checks/compose.d.ts +16 -0
  224. package/dist/engine/deploy/checks/compose.d.ts.map +1 -0
  225. package/dist/engine/deploy/checks/compose.js +149 -0
  226. package/dist/engine/deploy/checks/compose.js.map +1 -0
  227. package/dist/engine/deploy/checks/database.d.ts +83 -0
  228. package/dist/engine/deploy/checks/database.d.ts.map +1 -0
  229. package/dist/engine/deploy/checks/database.js +455 -0
  230. package/dist/engine/deploy/checks/database.js.map +1 -0
  231. package/dist/engine/deploy/checks/dns.d.ts +3 -0
  232. package/dist/engine/deploy/checks/dns.d.ts.map +1 -0
  233. package/dist/engine/deploy/checks/dns.js +85 -0
  234. package/dist/engine/deploy/checks/dns.js.map +1 -0
  235. package/dist/engine/deploy/checks/host.d.ts +19 -0
  236. package/dist/engine/deploy/checks/host.d.ts.map +1 -0
  237. package/dist/engine/deploy/checks/host.js +543 -0
  238. package/dist/engine/deploy/checks/host.js.map +1 -0
  239. package/dist/engine/deploy/checks/index.d.ts +35 -0
  240. package/dist/engine/deploy/checks/index.d.ts.map +1 -0
  241. package/dist/engine/deploy/checks/index.js +75 -0
  242. package/dist/engine/deploy/checks/index.js.map +1 -0
  243. package/dist/engine/deploy/checks/registry.d.ts +110 -0
  244. package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
  245. package/dist/engine/deploy/checks/registry.js +104 -0
  246. package/dist/engine/deploy/checks/registry.js.map +1 -0
  247. package/dist/engine/deploy/checks/source.d.ts +45 -0
  248. package/dist/engine/deploy/checks/source.d.ts.map +1 -0
  249. package/dist/engine/deploy/checks/source.js +175 -0
  250. package/dist/engine/deploy/checks/source.js.map +1 -0
  251. package/dist/engine/deploy/checks/stack-ports.d.ts +4 -0
  252. package/dist/engine/deploy/checks/stack-ports.d.ts.map +1 -0
  253. package/dist/engine/deploy/checks/stack-ports.js +261 -0
  254. package/dist/engine/deploy/checks/stack-ports.js.map +1 -0
  255. package/dist/engine/deploy/checks/tls.d.ts +87 -0
  256. package/dist/engine/deploy/checks/tls.d.ts.map +1 -0
  257. package/dist/engine/deploy/checks/tls.js +552 -0
  258. package/dist/engine/deploy/checks/tls.js.map +1 -0
  259. package/dist/engine/deploy/checks/types.d.ts +202 -0
  260. package/dist/engine/deploy/checks/types.d.ts.map +1 -0
  261. package/dist/engine/deploy/checks/types.js +199 -0
  262. package/dist/engine/deploy/checks/types.js.map +1 -0
  263. package/dist/engine/deploy/compose-command.d.ts +16 -0
  264. package/dist/engine/deploy/compose-command.d.ts.map +1 -0
  265. package/dist/engine/deploy/compose-command.js +40 -0
  266. package/dist/engine/deploy/compose-command.js.map +1 -0
  267. package/dist/engine/deploy/compose-containers.d.ts +101 -0
  268. package/dist/engine/deploy/compose-containers.d.ts.map +1 -0
  269. package/dist/engine/deploy/compose-containers.js +191 -0
  270. package/dist/engine/deploy/compose-containers.js.map +1 -0
  271. package/dist/engine/deploy/compose-files.d.ts +29 -0
  272. package/dist/engine/deploy/compose-files.d.ts.map +1 -0
  273. package/dist/engine/deploy/compose-files.js +118 -0
  274. package/dist/engine/deploy/compose-files.js.map +1 -0
  275. package/dist/engine/deploy/compose-hints.d.ts +11 -0
  276. package/dist/engine/deploy/compose-hints.d.ts.map +1 -0
  277. package/dist/engine/deploy/compose-hints.js +70 -0
  278. package/dist/engine/deploy/compose-hints.js.map +1 -0
  279. package/dist/engine/deploy/compose-port-variables.d.ts +58 -0
  280. package/dist/engine/deploy/compose-port-variables.d.ts.map +1 -0
  281. package/dist/engine/deploy/compose-port-variables.js +184 -0
  282. package/dist/engine/deploy/compose-port-variables.js.map +1 -0
  283. package/dist/engine/deploy/compose-ports.d.ts +98 -0
  284. package/dist/engine/deploy/compose-ports.d.ts.map +1 -0
  285. package/dist/engine/deploy/compose-ports.js +204 -0
  286. package/dist/engine/deploy/compose-ports.js.map +1 -0
  287. package/dist/engine/deploy/compose-project.d.ts +113 -0
  288. package/dist/engine/deploy/compose-project.d.ts.map +1 -0
  289. package/dist/engine/deploy/compose-project.js +177 -0
  290. package/dist/engine/deploy/compose-project.js.map +1 -0
  291. package/dist/engine/deploy/consent.d.ts +29 -0
  292. package/dist/engine/deploy/consent.d.ts.map +1 -0
  293. package/dist/engine/deploy/consent.js +35 -0
  294. package/dist/engine/deploy/consent.js.map +1 -0
  295. package/dist/engine/deploy/database-drop.d.ts +22 -0
  296. package/dist/engine/deploy/database-drop.d.ts.map +1 -0
  297. package/dist/engine/deploy/database-drop.js +135 -0
  298. package/dist/engine/deploy/database-drop.js.map +1 -0
  299. package/dist/engine/deploy/database.d.ts +116 -0
  300. package/dist/engine/deploy/database.d.ts.map +1 -0
  301. package/dist/engine/deploy/database.js +252 -0
  302. package/dist/engine/deploy/database.js.map +1 -0
  303. package/dist/engine/deploy/deploy-info.d.ts +48 -0
  304. package/dist/engine/deploy/deploy-info.d.ts.map +1 -0
  305. package/dist/engine/deploy/deploy-info.js +163 -0
  306. package/dist/engine/deploy/deploy-info.js.map +1 -0
  307. package/dist/engine/deploy/deployment-evidence.d.ts +38 -0
  308. package/dist/engine/deploy/deployment-evidence.d.ts.map +1 -0
  309. package/dist/engine/deploy/deployment-evidence.js +92 -0
  310. package/dist/engine/deploy/deployment-evidence.js.map +1 -0
  311. package/dist/engine/deploy/edge-config.d.ts +103 -0
  312. package/dist/engine/deploy/edge-config.d.ts.map +1 -0
  313. package/dist/engine/deploy/edge-config.js +170 -0
  314. package/dist/engine/deploy/edge-config.js.map +1 -0
  315. package/dist/engine/deploy/env-absence.d.ts +61 -0
  316. package/dist/engine/deploy/env-absence.d.ts.map +1 -0
  317. package/dist/engine/deploy/env-absence.js +33 -0
  318. package/dist/engine/deploy/env-absence.js.map +1 -0
  319. package/dist/engine/deploy/env-file.d.ts +14 -0
  320. package/dist/engine/deploy/env-file.d.ts.map +1 -0
  321. package/dist/engine/deploy/env-file.js +58 -0
  322. package/dist/engine/deploy/env-file.js.map +1 -0
  323. package/dist/engine/deploy/env-fragments.d.ts +29 -0
  324. package/dist/engine/deploy/env-fragments.d.ts.map +1 -0
  325. package/dist/engine/deploy/env-fragments.js +73 -0
  326. package/dist/engine/deploy/env-fragments.js.map +1 -0
  327. package/dist/engine/deploy/env-metadata.d.ts +73 -0
  328. package/dist/engine/deploy/env-metadata.d.ts.map +1 -0
  329. package/dist/engine/deploy/env-metadata.js +227 -0
  330. package/dist/engine/deploy/env-metadata.js.map +1 -0
  331. package/dist/engine/deploy/env-spec.d.ts +75 -0
  332. package/dist/engine/deploy/env-spec.d.ts.map +1 -0
  333. package/dist/engine/deploy/env-spec.js +239 -0
  334. package/dist/engine/deploy/env-spec.js.map +1 -0
  335. package/dist/engine/deploy/env-wizard.d.ts +56 -0
  336. package/dist/engine/deploy/env-wizard.d.ts.map +1 -0
  337. package/dist/engine/deploy/env-wizard.js +235 -0
  338. package/dist/engine/deploy/env-wizard.js.map +1 -0
  339. package/dist/engine/deploy/executor.d.ts +81 -0
  340. package/dist/engine/deploy/executor.d.ts.map +1 -0
  341. package/dist/engine/deploy/executor.js +247 -0
  342. package/dist/engine/deploy/executor.js.map +1 -0
  343. package/dist/engine/deploy/free-ports.d.ts +145 -0
  344. package/dist/engine/deploy/free-ports.d.ts.map +1 -0
  345. package/dist/engine/deploy/free-ports.js +235 -0
  346. package/dist/engine/deploy/free-ports.js.map +1 -0
  347. package/dist/engine/deploy/health.d.ts +153 -0
  348. package/dist/engine/deploy/health.d.ts.map +1 -0
  349. package/dist/engine/deploy/health.js +335 -0
  350. package/dist/engine/deploy/health.js.map +1 -0
  351. package/dist/engine/deploy/hooks.d.ts +66 -0
  352. package/dist/engine/deploy/hooks.d.ts.map +1 -0
  353. package/dist/engine/deploy/hooks.js +19 -0
  354. package/dist/engine/deploy/hooks.js.map +1 -0
  355. package/dist/engine/deploy/host-facts.d.ts +23 -0
  356. package/dist/engine/deploy/host-facts.d.ts.map +1 -0
  357. package/dist/engine/deploy/host-facts.js +67 -0
  358. package/dist/engine/deploy/host-facts.js.map +1 -0
  359. package/dist/engine/deploy/install.d.ts +239 -0
  360. package/dist/engine/deploy/install.d.ts.map +1 -0
  361. package/dist/engine/deploy/install.js +1474 -0
  362. package/dist/engine/deploy/install.js.map +1 -0
  363. package/dist/engine/deploy/inventory.d.ts +30 -0
  364. package/dist/engine/deploy/inventory.d.ts.map +1 -0
  365. package/dist/engine/deploy/inventory.js +122 -0
  366. package/dist/engine/deploy/inventory.js.map +1 -0
  367. package/dist/engine/deploy/journal.d.ts +77 -0
  368. package/dist/engine/deploy/journal.d.ts.map +1 -0
  369. package/dist/engine/deploy/journal.js +221 -0
  370. package/dist/engine/deploy/journal.js.map +1 -0
  371. package/dist/engine/deploy/layout.d.ts +77 -0
  372. package/dist/engine/deploy/layout.d.ts.map +1 -0
  373. package/dist/engine/deploy/layout.js +191 -0
  374. package/dist/engine/deploy/layout.js.map +1 -0
  375. package/dist/engine/deploy/oauth-check.d.ts +58 -0
  376. package/dist/engine/deploy/oauth-check.d.ts.map +1 -0
  377. package/dist/engine/deploy/oauth-check.js +213 -0
  378. package/dist/engine/deploy/oauth-check.js.map +1 -0
  379. package/dist/engine/deploy/proxy-bootstrap.d.ts +149 -0
  380. package/dist/engine/deploy/proxy-bootstrap.d.ts.map +1 -0
  381. package/dist/engine/deploy/proxy-bootstrap.js +416 -0
  382. package/dist/engine/deploy/proxy-bootstrap.js.map +1 -0
  383. package/dist/engine/deploy/proxy-streams.d.ts +110 -0
  384. package/dist/engine/deploy/proxy-streams.d.ts.map +1 -0
  385. package/dist/engine/deploy/proxy-streams.js +208 -0
  386. package/dist/engine/deploy/proxy-streams.js.map +1 -0
  387. package/dist/engine/deploy/proxy.d.ts +375 -0
  388. package/dist/engine/deploy/proxy.d.ts.map +1 -0
  389. package/dist/engine/deploy/proxy.js +758 -0
  390. package/dist/engine/deploy/proxy.js.map +1 -0
  391. package/dist/engine/deploy/renewal.d.ts +54 -0
  392. package/dist/engine/deploy/renewal.d.ts.map +1 -0
  393. package/dist/engine/deploy/renewal.js +169 -0
  394. package/dist/engine/deploy/renewal.js.map +1 -0
  395. package/dist/engine/deploy/repo.d.ts +119 -0
  396. package/dist/engine/deploy/repo.d.ts.map +1 -0
  397. package/dist/engine/deploy/repo.js +282 -0
  398. package/dist/engine/deploy/repo.js.map +1 -0
  399. package/dist/engine/deploy/run-record.d.ts +28 -0
  400. package/dist/engine/deploy/run-record.d.ts.map +1 -0
  401. package/dist/engine/deploy/run-record.js +44 -0
  402. package/dist/engine/deploy/run-record.js.map +1 -0
  403. package/dist/engine/deploy/stack-ports-gate.d.ts +19 -0
  404. package/dist/engine/deploy/stack-ports-gate.d.ts.map +1 -0
  405. package/dist/engine/deploy/stack-ports-gate.js +54 -0
  406. package/dist/engine/deploy/stack-ports-gate.js.map +1 -0
  407. package/dist/engine/deploy/state.d.ts +289 -0
  408. package/dist/engine/deploy/state.d.ts.map +1 -0
  409. package/dist/engine/deploy/state.js +163 -0
  410. package/dist/engine/deploy/state.js.map +1 -0
  411. package/dist/engine/deploy/steps/app-step-context.d.ts +24 -0
  412. package/dist/engine/deploy/steps/app-step-context.d.ts.map +1 -0
  413. package/dist/engine/deploy/steps/app-step-context.js +45 -0
  414. package/dist/engine/deploy/steps/app-step-context.js.map +1 -0
  415. package/dist/engine/deploy/steps/pipeline.d.ts +46 -0
  416. package/dist/engine/deploy/steps/pipeline.d.ts.map +1 -0
  417. package/dist/engine/deploy/steps/pipeline.js +73 -0
  418. package/dist/engine/deploy/steps/pipeline.js.map +1 -0
  419. package/dist/engine/deploy/steps/plan.d.ts +28 -0
  420. package/dist/engine/deploy/steps/plan.d.ts.map +1 -0
  421. package/dist/engine/deploy/steps/plan.js +32 -0
  422. package/dist/engine/deploy/steps/plan.js.map +1 -0
  423. package/dist/engine/deploy/steps/registry.d.ts +182 -0
  424. package/dist/engine/deploy/steps/registry.d.ts.map +1 -0
  425. package/dist/engine/deploy/steps/registry.js +214 -0
  426. package/dist/engine/deploy/steps/registry.js.map +1 -0
  427. package/dist/engine/deploy/steps/step-values.d.ts +28 -0
  428. package/dist/engine/deploy/steps/step-values.d.ts.map +1 -0
  429. package/dist/engine/deploy/steps/step-values.js +33 -0
  430. package/dist/engine/deploy/steps/step-values.js.map +1 -0
  431. package/dist/engine/deploy/testing/fake-containers.d.ts +29 -0
  432. package/dist/engine/deploy/testing/fake-containers.d.ts.map +1 -0
  433. package/dist/engine/deploy/testing/fake-containers.js +32 -0
  434. package/dist/engine/deploy/testing/fake-containers.js.map +1 -0
  435. package/dist/engine/deploy/testing/fake-postgres.d.ts +88 -0
  436. package/dist/engine/deploy/testing/fake-postgres.d.ts.map +1 -0
  437. package/dist/engine/deploy/testing/fake-postgres.js +236 -0
  438. package/dist/engine/deploy/testing/fake-postgres.js.map +1 -0
  439. package/dist/engine/deploy/testing/fake-vps.d.ts +147 -0
  440. package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -0
  441. package/dist/engine/deploy/testing/fake-vps.js +371 -0
  442. package/dist/engine/deploy/testing/fake-vps.js.map +1 -0
  443. package/dist/engine/deploy/uninstall.d.ts +87 -0
  444. package/dist/engine/deploy/uninstall.d.ts.map +1 -0
  445. package/dist/engine/deploy/uninstall.js +321 -0
  446. package/dist/engine/deploy/uninstall.js.map +1 -0
  447. package/dist/engine/deploy/update.d.ts +114 -0
  448. package/dist/engine/deploy/update.d.ts.map +1 -0
  449. package/dist/engine/deploy/update.js +1385 -0
  450. package/dist/engine/deploy/update.js.map +1 -0
  451. package/dist/engine/deploy/version-step.d.ts +74 -0
  452. package/dist/engine/deploy/version-step.d.ts.map +1 -0
  453. package/dist/engine/deploy/version-step.js +177 -0
  454. package/dist/engine/deploy/version-step.js.map +1 -0
  455. package/dist/engine/device-auth.d.ts +240 -0
  456. package/dist/engine/device-auth.d.ts.map +1 -0
  457. package/dist/engine/device-auth.js +442 -0
  458. package/dist/engine/device-auth.js.map +1 -0
  459. package/dist/engine/device-login.d.ts +126 -0
  460. package/dist/engine/device-login.d.ts.map +1 -0
  461. package/dist/engine/device-login.js +164 -0
  462. package/dist/engine/device-login.js.map +1 -0
  463. package/dist/engine/errors.d.ts +314 -0
  464. package/dist/engine/errors.d.ts.map +1 -0
  465. package/dist/engine/errors.js +561 -0
  466. package/dist/engine/errors.js.map +1 -0
  467. package/dist/engine/github-raw-manifest.d.ts +59 -0
  468. package/dist/engine/github-raw-manifest.d.ts.map +1 -0
  469. package/dist/engine/github-raw-manifest.js +197 -0
  470. package/dist/engine/github-raw-manifest.js.map +1 -0
  471. package/dist/engine/identity.d.ts +169 -0
  472. package/dist/engine/identity.d.ts.map +1 -0
  473. package/dist/engine/identity.js +227 -0
  474. package/dist/engine/identity.js.map +1 -0
  475. package/dist/engine/index.d.ts +141 -0
  476. package/dist/engine/index.d.ts.map +1 -0
  477. package/dist/engine/index.js +147 -0
  478. package/dist/engine/index.js.map +1 -0
  479. package/dist/engine/init/local-profile.d.ts +93 -0
  480. package/dist/engine/init/local-profile.d.ts.map +1 -0
  481. package/dist/engine/init/local-profile.js +295 -0
  482. package/dist/engine/init/local-profile.js.map +1 -0
  483. package/dist/engine/init/run-init.d.ts +41 -0
  484. package/dist/engine/init/run-init.d.ts.map +1 -0
  485. package/dist/engine/init/run-init.js +297 -0
  486. package/dist/engine/init/run-init.js.map +1 -0
  487. package/dist/engine/node/capabilities.d.ts +433 -0
  488. package/dist/engine/node/capabilities.d.ts.map +1 -0
  489. package/dist/engine/node/capabilities.js +597 -0
  490. package/dist/engine/node/capabilities.js.map +1 -0
  491. package/dist/engine/node/daemon-channels.d.ts +66 -0
  492. package/dist/engine/node/daemon-channels.d.ts.map +1 -0
  493. package/dist/engine/node/daemon-channels.js +65 -0
  494. package/dist/engine/node/daemon-channels.js.map +1 -0
  495. package/dist/engine/node/daemon.d.ts +63 -0
  496. package/dist/engine/node/daemon.d.ts.map +1 -0
  497. package/dist/engine/node/daemon.js +279 -0
  498. package/dist/engine/node/daemon.js.map +1 -0
  499. package/dist/engine/node/doctor.d.ts +60 -0
  500. package/dist/engine/node/doctor.d.ts.map +1 -0
  501. package/dist/engine/node/doctor.js +447 -0
  502. package/dist/engine/node/doctor.js.map +1 -0
  503. package/dist/engine/node/enrollment.d.ts +98 -0
  504. package/dist/engine/node/enrollment.d.ts.map +1 -0
  505. package/dist/engine/node/enrollment.js +189 -0
  506. package/dist/engine/node/enrollment.js.map +1 -0
  507. package/dist/engine/node/env-flags.d.ts +5 -0
  508. package/dist/engine/node/env-flags.d.ts.map +1 -0
  509. package/dist/engine/node/env-flags.js +22 -0
  510. package/dist/engine/node/env-flags.js.map +1 -0
  511. package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
  512. package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
  513. package/dist/engine/node/executors/credential-hygiene.js +210 -0
  514. package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
  515. package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
  516. package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
  517. package/dist/engine/node/executors/db-backup-run.js +362 -0
  518. package/dist/engine/node/executors/db-backup-run.js.map +1 -0
  519. package/dist/engine/node/executors/example-checksum.d.ts +30 -0
  520. package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
  521. package/dist/engine/node/executors/example-checksum.js +56 -0
  522. package/dist/engine/node/executors/example-checksum.js.map +1 -0
  523. package/dist/engine/node/executors/index.d.ts +213 -0
  524. package/dist/engine/node/executors/index.d.ts.map +1 -0
  525. package/dist/engine/node/executors/index.js +58 -0
  526. package/dist/engine/node/executors/index.js.map +1 -0
  527. package/dist/engine/node/executors/registry.d.ts +38 -0
  528. package/dist/engine/node/executors/registry.d.ts.map +1 -0
  529. package/dist/engine/node/executors/registry.js +103 -0
  530. package/dist/engine/node/executors/registry.js.map +1 -0
  531. package/dist/engine/node/heap-snapshot.d.ts +37 -0
  532. package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
  533. package/dist/engine/node/heap-snapshot.js +160 -0
  534. package/dist/engine/node/heap-snapshot.js.map +1 -0
  535. package/dist/engine/node/host-telemetry.d.ts +38 -0
  536. package/dist/engine/node/host-telemetry.d.ts.map +1 -0
  537. package/dist/engine/node/host-telemetry.js +39 -0
  538. package/dist/engine/node/host-telemetry.js.map +1 -0
  539. package/dist/engine/node/host-vitals.d.ts +51 -0
  540. package/dist/engine/node/host-vitals.d.ts.map +1 -0
  541. package/dist/engine/node/host-vitals.js +117 -0
  542. package/dist/engine/node/host-vitals.js.map +1 -0
  543. package/dist/engine/node/install-deps.d.ts +231 -0
  544. package/dist/engine/node/install-deps.d.ts.map +1 -0
  545. package/dist/engine/node/install-deps.js +392 -0
  546. package/dist/engine/node/install-deps.js.map +1 -0
  547. package/dist/engine/node/ipc-protocol.d.ts +114 -0
  548. package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
  549. package/dist/engine/node/ipc-protocol.js +122 -0
  550. package/dist/engine/node/ipc-protocol.js.map +1 -0
  551. package/dist/engine/node/lifecycle.d.ts +103 -0
  552. package/dist/engine/node/lifecycle.d.ts.map +1 -0
  553. package/dist/engine/node/lifecycle.js +260 -0
  554. package/dist/engine/node/lifecycle.js.map +1 -0
  555. package/dist/engine/node/logger.d.ts +95 -0
  556. package/dist/engine/node/logger.d.ts.map +1 -0
  557. package/dist/engine/node/logger.js +241 -0
  558. package/dist/engine/node/logger.js.map +1 -0
  559. package/dist/engine/node/memory-watchdog.d.ts +89 -0
  560. package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
  561. package/dist/engine/node/memory-watchdog.js +248 -0
  562. package/dist/engine/node/memory-watchdog.js.map +1 -0
  563. package/dist/engine/node/models.d.ts +195 -0
  564. package/dist/engine/node/models.d.ts.map +1 -0
  565. package/dist/engine/node/models.js +379 -0
  566. package/dist/engine/node/models.js.map +1 -0
  567. package/dist/engine/node/node-api.d.ts +439 -0
  568. package/dist/engine/node/node-api.d.ts.map +1 -0
  569. package/dist/engine/node/node-api.js +125 -0
  570. package/dist/engine/node/node-api.js.map +1 -0
  571. package/dist/engine/node/node-config.d.ts +128 -0
  572. package/dist/engine/node/node-config.d.ts.map +1 -0
  573. package/dist/engine/node/node-config.js +237 -0
  574. package/dist/engine/node/node-config.js.map +1 -0
  575. package/dist/engine/node/node-dashboard-source.d.ts +83 -0
  576. package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
  577. package/dist/engine/node/node-dashboard-source.js +181 -0
  578. package/dist/engine/node/node-dashboard-source.js.map +1 -0
  579. package/dist/engine/node/node-engine.d.ts +282 -0
  580. package/dist/engine/node/node-engine.d.ts.map +1 -0
  581. package/dist/engine/node/node-engine.js +925 -0
  582. package/dist/engine/node/node-engine.js.map +1 -0
  583. package/dist/engine/node/node-errors.d.ts +54 -0
  584. package/dist/engine/node/node-errors.d.ts.map +1 -0
  585. package/dist/engine/node/node-errors.js +71 -0
  586. package/dist/engine/node/node-errors.js.map +1 -0
  587. package/dist/engine/node/node-events-queue.d.ts +27 -0
  588. package/dist/engine/node/node-events-queue.d.ts.map +1 -0
  589. package/dist/engine/node/node-events-queue.js +46 -0
  590. package/dist/engine/node/node-events-queue.js.map +1 -0
  591. package/dist/engine/node/node-events.d.ts +132 -0
  592. package/dist/engine/node/node-events.d.ts.map +1 -0
  593. package/dist/engine/node/node-events.js +2 -0
  594. package/dist/engine/node/node-events.js.map +1 -0
  595. package/dist/engine/node/node-vitals.d.ts +123 -0
  596. package/dist/engine/node/node-vitals.d.ts.map +1 -0
  597. package/dist/engine/node/node-vitals.js +266 -0
  598. package/dist/engine/node/node-vitals.js.map +1 -0
  599. package/dist/engine/node/paths.d.ts +39 -0
  600. package/dist/engine/node/paths.d.ts.map +1 -0
  601. package/dist/engine/node/paths.js +60 -0
  602. package/dist/engine/node/paths.js.map +1 -0
  603. package/dist/engine/node/pg-dump.d.ts +126 -0
  604. package/dist/engine/node/pg-dump.d.ts.map +1 -0
  605. package/dist/engine/node/pg-dump.js +223 -0
  606. package/dist/engine/node/pg-dump.js.map +1 -0
  607. package/dist/engine/node/pidfile.d.ts +38 -0
  608. package/dist/engine/node/pidfile.d.ts.map +1 -0
  609. package/dist/engine/node/pidfile.js +156 -0
  610. package/dist/engine/node/pidfile.js.map +1 -0
  611. package/dist/engine/node/power-probe.d.ts +59 -0
  612. package/dist/engine/node/power-probe.d.ts.map +1 -0
  613. package/dist/engine/node/power-probe.js +240 -0
  614. package/dist/engine/node/power-probe.js.map +1 -0
  615. package/dist/engine/node/power-watcher.d.ts +30 -0
  616. package/dist/engine/node/power-watcher.d.ts.map +1 -0
  617. package/dist/engine/node/power-watcher.js +116 -0
  618. package/dist/engine/node/power-watcher.js.map +1 -0
  619. package/dist/engine/node/runtime-state.d.ts +24 -0
  620. package/dist/engine/node/runtime-state.d.ts.map +1 -0
  621. package/dist/engine/node/runtime-state.js +19 -0
  622. package/dist/engine/node/runtime-state.js.map +1 -0
  623. package/dist/engine/node/runtime-tuning.d.ts +174 -0
  624. package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
  625. package/dist/engine/node/runtime-tuning.js +327 -0
  626. package/dist/engine/node/runtime-tuning.js.map +1 -0
  627. package/dist/engine/node/service.d.ts +39 -0
  628. package/dist/engine/node/service.d.ts.map +1 -0
  629. package/dist/engine/node/service.js +215 -0
  630. package/dist/engine/node/service.js.map +1 -0
  631. package/dist/engine/node/start.d.ts +69 -0
  632. package/dist/engine/node/start.d.ts.map +1 -0
  633. package/dist/engine/node/start.js +325 -0
  634. package/dist/engine/node/start.js.map +1 -0
  635. package/dist/engine/node/worker-env-aliases.d.ts +39 -0
  636. package/dist/engine/node/worker-env-aliases.d.ts.map +1 -0
  637. package/dist/engine/node/worker-env-aliases.js +126 -0
  638. package/dist/engine/node/worker-env-aliases.js.map +1 -0
  639. package/dist/engine/node/worker-env-table.d.ts +15 -0
  640. package/dist/engine/node/worker-env-table.d.ts.map +1 -0
  641. package/dist/engine/node/worker-env-table.js +100 -0
  642. package/dist/engine/node/worker-env-table.js.map +1 -0
  643. package/dist/engine/node/worker-env.d.ts +67 -0
  644. package/dist/engine/node/worker-env.d.ts.map +1 -0
  645. package/dist/engine/node/worker-env.js +114 -0
  646. package/dist/engine/node/worker-env.js.map +1 -0
  647. package/dist/engine/output.d.ts +97 -0
  648. package/dist/engine/output.d.ts.map +1 -0
  649. package/dist/engine/output.js +274 -0
  650. package/dist/engine/output.js.map +1 -0
  651. package/dist/engine/package-info.d.ts +7 -0
  652. package/dist/engine/package-info.d.ts.map +1 -0
  653. package/dist/engine/package-info.js +38 -0
  654. package/dist/engine/package-info.js.map +1 -0
  655. package/dist/engine/program.d.ts +53 -0
  656. package/dist/engine/program.d.ts.map +1 -0
  657. package/dist/engine/program.js +213 -0
  658. package/dist/engine/program.js.map +1 -0
  659. package/dist/engine/prompt.d.ts +69 -0
  660. package/dist/engine/prompt.d.ts.map +1 -0
  661. package/dist/engine/prompt.js +205 -0
  662. package/dist/engine/prompt.js.map +1 -0
  663. package/dist/engine/registries.d.ts +5 -0
  664. package/dist/engine/registries.d.ts.map +1 -0
  665. package/dist/engine/registries.js +68 -0
  666. package/dist/engine/registries.js.map +1 -0
  667. package/dist/engine/request-body.d.ts +31 -0
  668. package/dist/engine/request-body.d.ts.map +1 -0
  669. package/dist/engine/request-body.js +156 -0
  670. package/dist/engine/request-body.js.map +1 -0
  671. package/dist/engine/semver.d.ts +31 -0
  672. package/dist/engine/semver.d.ts.map +1 -0
  673. package/dist/engine/semver.js +100 -0
  674. package/dist/engine/semver.js.map +1 -0
  675. package/dist/engine/test-support.d.ts +50 -0
  676. package/dist/engine/test-support.d.ts.map +1 -0
  677. package/dist/engine/test-support.js +86 -0
  678. package/dist/engine/test-support.js.map +1 -0
  679. package/dist/engine/tui/app-registry.d.ts +103 -0
  680. package/dist/engine/tui/app-registry.d.ts.map +1 -0
  681. package/dist/engine/tui/app-registry.js +103 -0
  682. package/dist/engine/tui/app-registry.js.map +1 -0
  683. package/dist/engine/tui/app.d.ts +11 -0
  684. package/dist/engine/tui/app.d.ts.map +1 -0
  685. package/dist/engine/tui/app.js +134 -0
  686. package/dist/engine/tui/app.js.map +1 -0
  687. package/dist/engine/tui/builtin-screens.d.ts +11 -0
  688. package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
  689. package/dist/engine/tui/builtin-screens.js +69 -0
  690. package/dist/engine/tui/builtin-screens.js.map +1 -0
  691. package/dist/engine/tui/conformance.d.ts +149 -0
  692. package/dist/engine/tui/conformance.d.ts.map +1 -0
  693. package/dist/engine/tui/conformance.js +428 -0
  694. package/dist/engine/tui/conformance.js.map +1 -0
  695. package/dist/engine/tui/context.d.ts +220 -0
  696. package/dist/engine/tui/context.d.ts.map +1 -0
  697. package/dist/engine/tui/context.js +258 -0
  698. package/dist/engine/tui/context.js.map +1 -0
  699. package/dist/engine/tui/dashboard/index.d.ts +8 -0
  700. package/dist/engine/tui/dashboard/index.d.ts.map +1 -0
  701. package/dist/engine/tui/dashboard/index.js +5 -0
  702. package/dist/engine/tui/dashboard/index.js.map +1 -0
  703. package/dist/engine/tui/dashboard/jobs-insights.d.ts +145 -0
  704. package/dist/engine/tui/dashboard/jobs-insights.d.ts.map +1 -0
  705. package/dist/engine/tui/dashboard/jobs-insights.js +63 -0
  706. package/dist/engine/tui/dashboard/jobs-insights.js.map +1 -0
  707. package/dist/engine/tui/dashboard/node-embedded.d.ts +33 -0
  708. package/dist/engine/tui/dashboard/node-embedded.d.ts.map +1 -0
  709. package/dist/engine/tui/dashboard/node-embedded.js +81 -0
  710. package/dist/engine/tui/dashboard/node-embedded.js.map +1 -0
  711. package/dist/engine/tui/dashboard/source.d.ts +294 -0
  712. package/dist/engine/tui/dashboard/source.d.ts.map +1 -0
  713. package/dist/engine/tui/dashboard/source.js +397 -0
  714. package/dist/engine/tui/dashboard/source.js.map +1 -0
  715. package/dist/engine/tui/dashboard/use-dashboard.d.ts +23 -0
  716. package/dist/engine/tui/dashboard/use-dashboard.d.ts.map +1 -0
  717. package/dist/engine/tui/dashboard/use-dashboard.js +32 -0
  718. package/dist/engine/tui/dashboard/use-dashboard.js.map +1 -0
  719. package/dist/engine/tui/index.d.ts +25 -0
  720. package/dist/engine/tui/index.d.ts.map +1 -0
  721. package/dist/engine/tui/index.js +89 -0
  722. package/dist/engine/tui/index.js.map +1 -0
  723. package/dist/engine/tui/layout.d.ts +152 -0
  724. package/dist/engine/tui/layout.d.ts.map +1 -0
  725. package/dist/engine/tui/layout.js +214 -0
  726. package/dist/engine/tui/layout.js.map +1 -0
  727. package/dist/engine/tui/menu-registry.d.ts +201 -0
  728. package/dist/engine/tui/menu-registry.d.ts.map +1 -0
  729. package/dist/engine/tui/menu-registry.js +205 -0
  730. package/dist/engine/tui/menu-registry.js.map +1 -0
  731. package/dist/engine/tui/menu-tree.d.ts +198 -0
  732. package/dist/engine/tui/menu-tree.d.ts.map +1 -0
  733. package/dist/engine/tui/menu-tree.js +276 -0
  734. package/dist/engine/tui/menu-tree.js.map +1 -0
  735. package/dist/engine/tui/raw-mode.d.ts +54 -0
  736. package/dist/engine/tui/raw-mode.d.ts.map +1 -0
  737. package/dist/engine/tui/raw-mode.js +106 -0
  738. package/dist/engine/tui/raw-mode.js.map +1 -0
  739. package/dist/engine/tui/routes.d.ts +5 -0
  740. package/dist/engine/tui/routes.d.ts.map +1 -0
  741. package/dist/engine/tui/routes.js +16 -0
  742. package/dist/engine/tui/routes.js.map +1 -0
  743. package/dist/engine/tui/screen-registry.d.ts +170 -0
  744. package/dist/engine/tui/screen-registry.d.ts.map +1 -0
  745. package/dist/engine/tui/screen-registry.js +180 -0
  746. package/dist/engine/tui/screen-registry.js.map +1 -0
  747. package/dist/engine/tui/screen-sections.d.ts +9 -0
  748. package/dist/engine/tui/screen-sections.d.ts.map +1 -0
  749. package/dist/engine/tui/screen-sections.js +45 -0
  750. package/dist/engine/tui/screen-sections.js.map +1 -0
  751. package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
  752. package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
  753. package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
  754. package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
  755. package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
  756. package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
  757. package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
  758. package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
  759. package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
  760. package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
  761. package/dist/engine/tui/screens/deploy/doctor.js +163 -0
  762. package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
  763. package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
  764. package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
  765. package/dist/engine/tui/screens/deploy/fields.js +202 -0
  766. package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
  767. package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
  768. package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
  769. package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
  770. package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
  771. package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
  772. package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
  773. package/dist/engine/tui/screens/deploy/index.js +83 -0
  774. package/dist/engine/tui/screens/deploy/index.js.map +1 -0
  775. package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
  776. package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
  777. package/dist/engine/tui/screens/deploy/install-model.js +319 -0
  778. package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
  779. package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
  780. package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
  781. package/dist/engine/tui/screens/deploy/install.js +365 -0
  782. package/dist/engine/tui/screens/deploy/install.js.map +1 -0
  783. package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
  784. package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
  785. package/dist/engine/tui/screens/deploy/model.js +59 -0
  786. package/dist/engine/tui/screens/deploy/model.js.map +1 -0
  787. package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
  788. package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
  789. package/dist/engine/tui/screens/deploy/run-model.js +117 -0
  790. package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
  791. package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
  792. package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
  793. package/dist/engine/tui/screens/deploy/run.js +201 -0
  794. package/dist/engine/tui/screens/deploy/run.js.map +1 -0
  795. package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
  796. package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
  797. package/dist/engine/tui/screens/deploy/status.js +107 -0
  798. package/dist/engine/tui/screens/deploy/status.js.map +1 -0
  799. package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
  800. package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
  801. package/dist/engine/tui/screens/deploy/update.js +175 -0
  802. package/dist/engine/tui/screens/deploy/update.js.map +1 -0
  803. package/dist/engine/tui/screens/deploy.d.ts +12 -0
  804. package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
  805. package/dist/engine/tui/screens/deploy.js +23 -0
  806. package/dist/engine/tui/screens/deploy.js.map +1 -0
  807. package/dist/engine/tui/screens/invoke.d.ts +6 -0
  808. package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
  809. package/dist/engine/tui/screens/invoke.js +196 -0
  810. package/dist/engine/tui/screens/invoke.js.map +1 -0
  811. package/dist/engine/tui/screens/jobs.d.ts +12 -0
  812. package/dist/engine/tui/screens/jobs.d.ts.map +1 -0
  813. package/dist/engine/tui/screens/jobs.js +72 -0
  814. package/dist/engine/tui/screens/jobs.js.map +1 -0
  815. package/dist/engine/tui/screens/login.d.ts +6 -0
  816. package/dist/engine/tui/screens/login.d.ts.map +1 -0
  817. package/dist/engine/tui/screens/login.js +263 -0
  818. package/dist/engine/tui/screens/login.js.map +1 -0
  819. package/dist/engine/tui/screens/logout.d.ts +6 -0
  820. package/dist/engine/tui/screens/logout.d.ts.map +1 -0
  821. package/dist/engine/tui/screens/logout.js +149 -0
  822. package/dist/engine/tui/screens/logout.js.map +1 -0
  823. package/dist/engine/tui/screens/menu.d.ts +25 -0
  824. package/dist/engine/tui/screens/menu.d.ts.map +1 -0
  825. package/dist/engine/tui/screens/menu.js +124 -0
  826. package/dist/engine/tui/screens/menu.js.map +1 -0
  827. package/dist/engine/tui/screens/node.d.ts +6 -0
  828. package/dist/engine/tui/screens/node.d.ts.map +1 -0
  829. package/dist/engine/tui/screens/node.js +277 -0
  830. package/dist/engine/tui/screens/node.js.map +1 -0
  831. package/dist/engine/tui/screens/not-logged-in.d.ts +12 -0
  832. package/dist/engine/tui/screens/not-logged-in.d.ts.map +1 -0
  833. package/dist/engine/tui/screens/not-logged-in.js +14 -0
  834. package/dist/engine/tui/screens/not-logged-in.js.map +1 -0
  835. package/dist/engine/tui/screens/status.d.ts +6 -0
  836. package/dist/engine/tui/screens/status.d.ts.map +1 -0
  837. package/dist/engine/tui/screens/status.js +138 -0
  838. package/dist/engine/tui/screens/status.js.map +1 -0
  839. package/dist/engine/tui/scroll-box.d.ts +42 -0
  840. package/dist/engine/tui/scroll-box.d.ts.map +1 -0
  841. package/dist/engine/tui/scroll-box.js +62 -0
  842. package/dist/engine/tui/scroll-box.js.map +1 -0
  843. package/dist/engine/tui/section-registry.d.ts +65 -0
  844. package/dist/engine/tui/section-registry.d.ts.map +1 -0
  845. package/dist/engine/tui/section-registry.js +90 -0
  846. package/dist/engine/tui/section-registry.js.map +1 -0
  847. package/dist/engine/tui/terminal.d.ts +31 -0
  848. package/dist/engine/tui/terminal.d.ts.map +1 -0
  849. package/dist/engine/tui/terminal.js +142 -0
  850. package/dist/engine/tui/terminal.js.map +1 -0
  851. package/dist/engine/tui/testing/feeds.d.ts +58 -0
  852. package/dist/engine/tui/testing/feeds.d.ts.map +1 -0
  853. package/dist/engine/tui/testing/feeds.js +67 -0
  854. package/dist/engine/tui/testing/feeds.js.map +1 -0
  855. package/dist/engine/tui/testing/harness.d.ts +243 -0
  856. package/dist/engine/tui/testing/harness.d.ts.map +1 -0
  857. package/dist/engine/tui/testing/harness.js +332 -0
  858. package/dist/engine/tui/testing/harness.js.map +1 -0
  859. package/dist/engine/tui/theme.d.ts +179 -0
  860. package/dist/engine/tui/theme.d.ts.map +1 -0
  861. package/dist/engine/tui/theme.js +111 -0
  862. package/dist/engine/tui/theme.js.map +1 -0
  863. package/dist/engine/tui/tty.d.ts +56 -0
  864. package/dist/engine/tui/tty.d.ts.map +1 -0
  865. package/dist/engine/tui/tty.js +146 -0
  866. package/dist/engine/tui/tty.js.map +1 -0
  867. package/dist/engine/tui/ui/active-items.d.ts +40 -0
  868. package/dist/engine/tui/ui/active-items.d.ts.map +1 -0
  869. package/dist/engine/tui/ui/active-items.js +38 -0
  870. package/dist/engine/tui/ui/active-items.js.map +1 -0
  871. package/dist/engine/tui/ui/event-log.d.ts +58 -0
  872. package/dist/engine/tui/ui/event-log.d.ts.map +1 -0
  873. package/dist/engine/tui/ui/event-log.js +32 -0
  874. package/dist/engine/tui/ui/event-log.js.map +1 -0
  875. package/dist/engine/tui/ui/index.d.ts +20 -0
  876. package/dist/engine/tui/ui/index.d.ts.map +1 -0
  877. package/dist/engine/tui/ui/index.js +14 -0
  878. package/dist/engine/tui/ui/index.js.map +1 -0
  879. package/dist/engine/tui/ui/meter-legend.d.ts +26 -0
  880. package/dist/engine/tui/ui/meter-legend.d.ts.map +1 -0
  881. package/dist/engine/tui/ui/meter-legend.js +25 -0
  882. package/dist/engine/tui/ui/meter-legend.js.map +1 -0
  883. package/dist/engine/tui/ui/run-summary.d.ts +58 -0
  884. package/dist/engine/tui/ui/run-summary.d.ts.map +1 -0
  885. package/dist/engine/tui/ui/run-summary.js +29 -0
  886. package/dist/engine/tui/ui/run-summary.js.map +1 -0
  887. package/dist/engine/tui/ui/segment-meter.d.ts +72 -0
  888. package/dist/engine/tui/ui/segment-meter.d.ts.map +1 -0
  889. package/dist/engine/tui/ui/segment-meter.js +128 -0
  890. package/dist/engine/tui/ui/segment-meter.js.map +1 -0
  891. package/dist/engine/tui/ui/status-line.d.ts +42 -0
  892. package/dist/engine/tui/ui/status-line.d.ts.map +1 -0
  893. package/dist/engine/tui/ui/status-line.js +35 -0
  894. package/dist/engine/tui/ui/status-line.js.map +1 -0
  895. package/dist/engine/tui/ui/tone.d.ts +46 -0
  896. package/dist/engine/tui/ui/tone.d.ts.map +1 -0
  897. package/dist/engine/tui/ui/tone.js +48 -0
  898. package/dist/engine/tui/ui/tone.js.map +1 -0
  899. package/dist/engine/update-notice-options.d.ts +70 -0
  900. package/dist/engine/update-notice-options.d.ts.map +1 -0
  901. package/dist/engine/update-notice-options.js +79 -0
  902. package/dist/engine/update-notice-options.js.map +1 -0
  903. package/dist/engine/update-notice.d.ts +69 -0
  904. package/dist/engine/update-notice.d.ts.map +1 -0
  905. package/dist/engine/update-notice.js +204 -0
  906. package/dist/engine/update-notice.js.map +1 -0
  907. package/dist/index.d.ts +4 -5
  908. package/dist/index.d.ts.map +1 -1
  909. package/dist/index.js +5 -5
  910. package/dist/index.js.map +1 -1
  911. package/dist/node/index.d.ts +3 -0
  912. package/dist/node/index.d.ts.map +1 -0
  913. package/dist/node/index.js +5 -0
  914. package/dist/node/index.js.map +1 -0
  915. package/dist/telemetry/index.d.ts +2 -1
  916. package/dist/telemetry/index.d.ts.map +1 -1
  917. package/dist/telemetry/index.js +1 -0
  918. package/dist/telemetry/index.js.map +1 -1
  919. package/dist/telemetry/node-span-relay.d.ts +1 -1
  920. package/dist/telemetry/node-span-relay.d.ts.map +1 -1
  921. package/dist/telemetry/node-span-relay.js +39 -6
  922. package/dist/telemetry/node-span-relay.js.map +1 -1
  923. package/dist/telemetry/node-span.d.ts +39 -7
  924. package/dist/telemetry/node-span.d.ts.map +1 -1
  925. package/dist/telemetry/node-span.js +19 -1
  926. package/dist/telemetry/node-span.js.map +1 -1
  927. package/dist/testing/index.d.ts +3 -0
  928. package/dist/testing/index.d.ts.map +1 -0
  929. package/dist/testing/index.js +4 -0
  930. package/dist/testing/index.js.map +1 -0
  931. package/dist/tui/index.d.ts +3 -0
  932. package/dist/tui/index.d.ts.map +1 -0
  933. package/dist/tui/index.js +7 -0
  934. package/dist/tui/index.js.map +1 -0
  935. package/dist/tui/testing/index.d.ts +5 -0
  936. package/dist/tui/testing/index.d.ts.map +1 -0
  937. package/dist/tui/testing/index.js +12 -0
  938. package/dist/tui/testing/index.js.map +1 -0
  939. package/dist/tui/ui/index.d.ts +2 -0
  940. package/dist/tui/ui/index.d.ts.map +1 -0
  941. package/dist/tui/ui/index.js +10 -0
  942. package/dist/tui/ui/index.js.map +1 -0
  943. package/package.json +56 -5
package/README.md CHANGED
@@ -1,88 +1,220 @@
1
1
  # @marinoscar/platform-cli
2
2
 
3
- Command and TUI building blocks for an app's own command-line client: Commander commands and ink components an app registers in its CLI. ESM with `sideEffects: false`; runs on Node 20 or later.
3
+ The platform's command-line client, as a package an app composes rather than forks: the `init`, `login`, `api`, `config`, `node` and `deploy` commands, the ink TUI, the VPS deploy pipeline and the worker-node engine, built by one `createCli({ identity, version, ... })` call that the app's `src/cli.ts` makes. CLI layer; ESM with `sideEffects: false`; runs on Node 20 or later. Consumed by every app's own CLI binary (the reference app's is `appctl`, in `apps/cli`).
4
4
 
5
5
  ## Purpose and scope
6
6
 
7
- Commander commands and ink components of the platform's CLI slices. It does not own the app's binary name, its program definition or its configuration file location.
7
+ `createCli` builds an app's CLI from its identity and the registries. The identity (executable name, display name, repository) is configuration: the config directory (`~/.<name>`), the env prefix (`<NAME>_`), the systemd unit (`<name>-node.service`) and every help text follow it, read at call time. Two strings never follow it, because live servers already have them: the deploy state file `.appctl-deploy.json` and the proxy sentinel `# Managed by appctl deploy`.
8
8
 
9
- Status: version `0.0.0`, unpublished. Slices are subpath exports (`@marinoscar/platform-cli/<slice>`), each with its own README: `core` (the CLI's command and env-spec fragment registries) and `telemetry` (the node span relay and the telemetry env-spec fragment). The root export is still only the package name (`PLATFORM_PACKAGE`).
9
+ An app extends the CLI through registries instead of editing it: commands, env-spec fragments, env groups, generators and annotations ([`/core`](src/core/README.md)), TUI screens and their sections ([`/tui`](src/tui/README.md)), deploy steps, checks, proxy stream paths and edge-config files ([`/deploy`](src/deploy/README.md)), node executors ([`/node`](src/node/README.md)) and conformance suites ([`/testing`](src/testing/README.md)).
10
+
11
+ The package does not own the app's binary name (npm reads the `bin` key before any code runs, so the app's `package.json` carries it), its product identity (`@app/shared` stays in the app; the identity arrives through `createCli`), or app-specific commands.
12
+
13
+ Subpath exports, each with its own README:
14
+
15
+ | Subpath | Contents | README |
16
+ |---|---|---|
17
+ | `@marinoscar/platform-cli` | `createCli`, `run`, the identity accessors, `EXIT` and `formatError` | this file |
18
+ | `/core` | `registerCliCommand`, `registerEnvSpecFragment`, `registerEnvGroup`, `registerEnvGenerator`, `annotateEnvKey` and the env-key metadata helpers | [core](src/core/README.md) |
19
+ | `/commands` | The six built-in command registrars and the error model | [commands](src/commands/README.md) |
20
+ | `/tui` | `registerTuiScreen`, `registerTuiScreenSection`, `registerTuiMenuNode`, the shared app context (`useTuiApp`, `registerTuiSelection`, `registerTuiStateLoader`, the theme), dashboards (`DashboardSource`) and the built-in screen order; `/tui/ui` the component kit; `/tui/testing` the screen-test harness | [tui](src/tui/README.md) |
21
+ | `/deploy` | `registerDeployStep`, `registerDeployCheck`, `registerProxyStreamPath`, `registerEdgeConfigFile`, `detectComposeProject`, `isPathUnder`, the built-in step ids, `planDeploySteps`, `DeployHooks`, the env template helpers | [deploy](src/deploy/README.md) |
22
+ | `/node` | `JobExecutor`, `ExecutorRegistry`, `registerNodeExecutor` | [node](src/node/README.md) |
23
+ | `/api-client` | `ApiClient`, `resolveApiBaseUrl` and the API errors | [api-client](src/api-client/README.md) |
24
+ | `/telemetry` | The worker's span relay and the telemetry env-spec fragment | [telemetry](src/telemetry/README.md) |
25
+ | `/tui/testing` | `renderTuiScreen`, `renderTuiRoute`, `renderTuiMenu`, `fakeDaemonFeed`, `fakeEmitterFeed` (for tests only; needs the optional peer `ink-testing-library`) | [tui](src/tui/README.md#testing) |
26
+ | `/testing` | Identity and registry reset, `testDeployStepContext`, the credential-hygiene check, `runPlatformConformance`, `registerCliConformanceSuite` | [testing](src/testing/README.md) |
27
+
28
+ The implementation lives in one internal slice (`src/engine/`), which is not a subpath export: the entry points above re-export the parts they publish, and nothing may import a file inside it.
10
29
 
11
30
  ## Install and peer dependencies
12
31
 
13
32
  ```bash
14
- npm install @marinoscar/platform-cli
33
+ npm install @marinoscar/platform-cli react
15
34
  ```
16
35
 
17
- Install these in the app; the package never bundles its own copy (a second copy breaks dependency injection, hooks or theme context).
36
+ `commander`, `ink`, `ink-select-input`, `ink-spinner`, `ink-text-input` and `@marinoscar/platform-infra` are regular dependencies. The single-instance library the app must install itself (React 19 keeps one hooks dispatcher per copy, and ink renders through it):
18
37
 
19
38
  | Package | Range |
20
39
  |---|---|
21
- | `commander` | `^14.0.2` |
22
- | `ink` | `^7.1.1` |
23
- | `react` | `^19.2.8` |
40
+ | `react` | `^19.2.8` (optional peer in the manifest, needed by the `engine` slice and so by every entry that renders or runs it; `ink` brings it in anyway) |
41
+
42
+ An app that writes its own TUI screen also depends on `ink` (`^7.1.1`), at the same version the package resolves. Testing screens with `@marinoscar/platform-cli/tui/testing` also needs `ink-testing-library` (`^4.0.0`), an optional peer.
24
43
 
25
44
  ## Quick start
26
45
 
27
- Pick the slice you need and follow its README:
28
-
29
- | Subpath | Contents | README |
30
- |---|---|---|
31
- | `@marinoscar/platform-cli/core` | `registerCliCommand`, `registerEnvSpecFragment` and the env-key metadata helpers | [core](src/core/README.md) |
32
- | `@marinoscar/platform-cli/telemetry` | The worker node's span relay and `telemetryEnvSpecFragment` | [telemetry](src/telemetry/README.md) |
46
+ The reference app's whole entry point ([`apps/cli/src/cli.ts`](../../apps/cli/src/cli.ts)), with its options in [`apps/cli/src/app.ts`](../../apps/cli/src/app.ts):
33
47
 
34
48
  ```ts
35
- import { registerCliCommand } from '@marinoscar/platform-cli/core';
36
-
37
- registerCliCommand((program) => program.command('hello').action(() => console.log('hello')));
49
+ #!/usr/bin/env node
50
+ import { createCli, EXIT, exitCodeFor, formatError } from '@marinoscar/platform-cli';
51
+
52
+ import { APP_CLI_OPTIONS } from './app.js'; // { identity: CLI_IDENTITY, version: CLI_VERSION, extraCommands: [] }
53
+
54
+ async function main(): Promise<void> {
55
+ let cli: ReturnType<typeof createCli>;
56
+ try {
57
+ cli = createCli(APP_CLI_OPTIONS);
58
+ } catch (error) {
59
+ process.stderr.write(`${formatError(error)}\n`);
60
+ process.exitCode = exitCodeFor(error);
61
+ return;
62
+ }
63
+ // Set exitCode and return; never process.exit(), which truncates piped output.
64
+ process.exitCode = await cli.run(process.argv.slice(2));
65
+ }
66
+ process.on('unhandledRejection', (reason) => {
67
+ process.stderr.write(`${formatError(reason)}\n`);
68
+ process.exitCode = EXIT.FAILURE;
69
+ });
70
+ void main();
38
71
  ```
39
72
 
73
+ `run` keeps the CLI's semantics: no arguments opens the TUI in a real terminal and is a usage error (help on stderr, `EXIT.USAGE`) anywhere else; `--help` and `--version` exit 0; `--version` prints `<app version> (platform <this package's version>)`.
74
+
40
75
  ## Configuration
41
76
 
42
- None at package level. The registries take no options; `NodeSpanRelayOptions` is in the [telemetry README](src/telemetry/README.md#configuration).
77
+ `createCli(options)`:
78
+
79
+ | Option | Type | Default | Meaning |
80
+ |---|---|---|---|
81
+ | `identity` | `CliIdentity` | required | `name` (lowercase `[a-z0-9-]`, e.g. `appctl`), `displayName` (`Kappa CLI`), `repoSlug` (`owner/repo`); optional `productName` (the systemd unit's Description; defaults to `displayName`), `configDirName` (defaults to `.<name>`), `envPrefix` (defaults to `toEnvPrefix(name)`, `APPCTL_`). Set once per process; a different second identity throws. |
82
+ | `version` | `string` | required | The app's own version (its `package.json`). |
83
+ | `extraCommands` | `CliCommandRegistration[]` | `[]` | Commands after the built-ins, in order. Same as `registerCliCommand`. |
84
+ | `tuiScreens` | `TuiScreenRegistration[]` | `[]` | Screens in the TUI menu. Same as `registerTuiScreen`. |
85
+ | `tuiTheme` | `TuiThemeOverrides` | none | Colour tokens, brand hues and glyphs of the TUI; colour stays off under `NO_COLOR`. |
86
+ | `tuiSelections` | `TuiSelectionRegistration[]` | `[]` | Selections shown as a header chip. Same as `registerTuiSelection`. |
87
+ | `tuiStateLoaders` | `TuiStateLoaderRegistration[]` | `[]` | Data loaded once for every TUI screen. Same as `registerTuiStateLoader`. |
88
+ | `deploySteps` | `DeployStepRegistration[]` | `[]` | Steps inserted into `deploy install` / `update`. Same as `registerDeployStep`. |
89
+ | `nodeExecutors` | `JobExecutor[]` | `[]` | Executors for the app's node-eligible job types. Same as `registerNodeExecutor`. |
90
+ | `envSpecFragments` | `EnvSpecFragment[]` | `[]` | Metadata for the app's `.env.example` keys. Same as `registerEnvSpecFragment`. |
91
+ | `deploy.versionedManifests` | `string[]` | the four of the reference layout | The manifests the deploy `version` step reads and writes: repository-relative POSIX paths ending in `package.json` (`apps/api/package.json`). **The first is the version source.** Only these manifests and their `package-lock.json` workspace entries change; an app whose CLI keeps its own version leaves `apps/cli/package.json` out. Validated at `createCli`: at least one, no `..`, no duplicates, no root manifest. |
92
+ | `updateNotice` | `{ latestVersion, upgradeHint, intervalMs?, timeoutMs? }` | unset (no check) | The [start-up update notice](#the-start-up-update-notice): `latestVersion(signal?)` returns the newest version or `undefined` (use `githubRawManifest({ repo, ref?, path })` to read a `package.json` on GitHub), `upgradeHint` is the text after `Update:` (one line, non-empty), `intervalMs` is the least time between network checks (default 24 hours), `timeoutMs` the longest the end of a command waits for the answer (default 1500). Validated at `createCli`. |
93
+
94
+ The options and the `register*` functions feed the same registries: string ids, a duplicate-id error, a deterministic order (built-ins first, then registration order), and frozen when `createCli` returns, so a late registration throws instead of going missing. A broken composition (a taken command name, TUI route, deploy step id, check id, env group or generator kind or executor type; a step anchored on an unknown step; an env key with two owners; an invalid stream path or edge-config path) throws at `createCli`. The newer options are `envGroups`, `envGenerators`, `envAnnotations`, `deployChecks`, `edgeConfigFiles`, `tuiSections`, `proxy: { streamPaths }`, `deploy: { versionedManifests }` and `updateNotice`. A bad `deploy.versionedManifests` (empty, a duplicate, `..`, an entry that does not end in `package.json`) or a bad `updateNotice` (no `latestVersion`, an empty or multi-line `upgradeHint`, a negative `intervalMs`, a non-positive `timeoutMs`) throws at `createCli` too.
95
+
96
+ ### The start-up update notice
97
+
98
+ Operators run an old app CLI on a server without knowing a newer one exists. With `createCli({ updateNotice })` the CLI checks when it starts and, if the newest version is semver-greater than the running one, writes one line to stderr after the command's output:
99
+
100
+ ```
101
+ appctl 1.11.0 is available (you have 1.10.7). Update: git pull && npm ci && npm run build
102
+ ```
103
+
104
+ ```ts
105
+ import { createCli, githubRawManifest } from '@marinoscar/platform-cli';
106
+
107
+ createCli({
108
+ ...APP_CLI_OPTIONS,
109
+ updateNotice: {
110
+ latestVersion: githubRawManifest({ repo: 'owner/name', ref: 'main', path: 'apps/cli/package.json' }),
111
+ upgradeHint: 'git pull && npm ci && npm run build',
112
+ },
113
+ });
114
+ ```
115
+
116
+ - **Unset means off.** An app that does not pass `updateNotice` makes no request, reads no file and prints nothing.
117
+ - **At most one network check per `intervalMs` (24 hours).** The answer is cached in `~/.<name>/update-check.json` (`{ "checkedAt": "<ISO time>", "latest": "<version>" }`, written atomically with mode 0600; a missing or corrupt file just means a new check). A failed check is recorded too, keeping the last known version, so an offline server does not retry on every command. Within the interval the notice comes from the cache, with no network.
118
+ - **Never in the command's way.** The check starts before the command and runs beside it. After the command, the CLI waits for what remains of `timeoutMs` (counted from the start, so a command longer than that waits for nothing), then stores the answer. Failure, timeout, a throwing or hanging `latestVersion` and a version that is not valid semver are silent. The exit code and stdout never change, and only the one stderr line is written. The interactive menu shows the line when it exits, after the terminal is restored.
119
+ - **Never shown** when `CI` (or `CONTINUOUS_INTEGRATION`) is set; when stderr is not a terminal; for `--json`, `--version`/`-v`, `--help`/`-h` and `help`; for the worker daemon `node start` (every form: `--headless`, `--daemon`, the systemd unit); or when the operator sets `<PREFIX>_NO_UPDATE_CHECK=1` (`APPCTL_NO_UPDATE_CHECK`; the prefix is the CLI identity's `envPrefix`). The other `node` commands and `deploy` check normally.
120
+ - **`githubRawManifest({ repo, ref = 'main', path, timeoutMs = 1500 })`** reads `https://raw.githubusercontent.com/<repo>/<ref>/<path>`: HTTPS only, no credentials (a private repository answers 404 and stays silent), no redirects, a body capped at 256 KiB, and only a valid semver `version` accepted. It never throws at run time; `repo` must be `owner/name` and `ref`/`path` plain relative paths, or it throws a `UsageError` when it is built. Any other source is a function returning the version.
121
+ - **The latest version is proven before it is printed**: the network value and the cache file are both parsed as strict semver 2.0.0 (prereleases order correctly: `1.2.3` is newer than `1.2.3-rc.1`, not the reverse).
43
122
 
44
123
  ## Extension-point catalog
45
124
 
46
- None. The root entry point exports only `PLATFORM_PACKAGE`; the extension points are catalogued per slice, in the [core README](src/core/README.md#extension-point-catalog).
125
+ The extension ladder and a recipe per extension: [docs/EXTENDING.md](../../docs/EXTENDING.md).
126
+
127
+ | Name | Kind | Signature | When to use | Stability | Example |
128
+ |---|---|---|---|---|---|
129
+ | `CreateCliOptions` | option | `createCli(options: CreateCliOptions): CliInstance` | Build the app's CLI: its identity and version, plus its commands, TUI screens, deploy steps, node executors and env-spec fragments | experimental | [example](../../apps/cli/src/app.ts) |
130
+ | `CreateCliDeployOptions` | option | `createCli({ deploy: { versionedManifests?: readonly string[] } })` | Choose the workspace manifests the deploy `version` step writes (default `apps/api`, `apps/web`, `apps/cli`, `packages/shared`); an app whose CLI keeps its own version leaves `apps/cli` out. The first entry is the version source | experimental | [example](../../apps/cli/src/examples/coach.versioned-manifests.ts) |
131
+ | `UpdateNoticeOptions` | option | `createCli({ updateNotice?: { latestVersion: (signal?: AbortSignal) => Promise<string \| undefined>; upgradeHint: string; intervalMs?: number; timeoutMs?: number } })` | Tell the operator, with one stderr line after the command, that a newer version of the CLI exists (cached for 24 hours, silent on any failure, never in CI or for `--json` / `--version` / the worker daemon). Read the version from a GitHub manifest with `githubRawManifest` | experimental | [example](../../apps/cli/src/examples/coach.update-notice.ts) |
132
+
133
+ The registries are catalogued by the entry point that exports them, each with a compiled, tested example in the reference app:
134
+
135
+ | Registry | Entry point | Example |
136
+ |---|---|---|
137
+ | `registerCliCommand` | [`/core`](src/core/README.md#extension-point-catalog) | [`hello.command.ts`](../../apps/cli/src/examples/hello.command.ts) |
138
+ | `registerEnvSpecFragment` | [`/core`](src/core/README.md#extension-point-catalog) | the platform's `telemetry` fragment |
139
+ | `registerEnvGroup` | [`/core`](src/core/README.md#extension-point-catalog) | [`coach.env-group.ts`](../../apps/cli/src/examples/coach.env-group.ts) |
140
+ | `registerEnvGenerator` | [`/core`](src/core/README.md#extension-point-catalog) | [`coach.env-generator.ts`](../../apps/cli/src/examples/coach.env-generator.ts) |
141
+ | `annotateEnvKey` | [`/core`](src/core/README.md#extension-point-catalog) | [`coach.env-annotation.ts`](../../apps/cli/src/examples/coach.env-annotation.ts) |
142
+ | `registerTuiScreen` | [`/tui`](src/tui/README.md#extension-point-catalog) | [`about.tui.ts`](../../apps/cli/src/examples/about.tui.ts) |
143
+ | `registerTuiSelection` | [`/tui`](src/tui/README.md#extension-point-catalog) | [`workspace.tui-selection.ts`](../../apps/cli/src/examples/workspace.tui-selection.ts) |
144
+ | `registerTuiStateLoader` | [`/tui`](src/tui/README.md#extension-point-catalog) | [`build-info.tui-state.ts`](../../apps/cli/src/examples/build-info.tui-state.ts) |
145
+ | `registerTuiScreenSection` | [`/tui`](src/tui/README.md#extension-point-catalog) | [`fleet-note.tui-section.tsx`](../../apps/cli/src/examples/fleet-note.tui-section.tsx) |
146
+ | `registerDeployStep` | [`/deploy`](src/deploy/README.md#extension-point-catalog) | [`announce.deploy-step.ts`](../../apps/cli/src/examples/announce.deploy-step.ts) |
147
+ | `registerDeployCheck` | [`/deploy`](src/deploy/README.md#extension-point-catalog) | [`coach.deploy-check.ts`](../../apps/cli/src/examples/coach.deploy-check.ts) |
148
+ | `registerProxyStreamPath` | [`/deploy`](src/deploy/README.md#extension-point-catalog) | [`coach.proxy-stream.ts`](../../apps/cli/src/examples/coach.proxy-stream.ts) |
149
+ | `registerEdgeConfigFile` | [`/deploy`](src/deploy/README.md#extension-point-catalog) | [`coach.edge-config.ts`](../../apps/cli/src/examples/coach.edge-config.ts) |
150
+ | `registerNodeExecutor` | [`/node`](src/node/README.md#extension-point-catalog) | [`echo.executor.ts`](../../apps/cli/src/examples/echo.executor.ts) |
151
+ | `runPlatformConformance` | [`/testing`](src/testing/README.md#extension-point-catalog) | [`conformance.test.ts`](../../apps/cli/src/conformance.test.ts) |
152
+ | `registerCliConformanceSuite` | [`/testing`](src/testing/README.md#extension-point-catalog) | [`coach.conformance-suite.ts`](../../apps/cli/src/examples/coach.conformance-suite.ts) |
153
+
154
+ The built-in deploy step ids, the env-spec fragment contract and the `/testing` helpers are listed in the [deploy](src/deploy/README.md#extension-point-catalog), [core](src/core/README.md#purpose-and-scope) and [testing](src/testing/README.md#extension-point-catalog) READMEs.
47
155
 
48
156
  ## Data
49
157
 
50
- None. The CLI holds no data model; it calls the API.
158
+ None. The CLI holds no data model; it calls the API. On the user's machine it writes `~/.<name>/config.json` (server URL and token) and, for a worker, its state directory; on a server, the deploy state file and journals under the deployment root.
51
159
 
52
160
  ## Permissions and settings
53
161
 
54
- None yet. Commands document the API permissions they need as they are extracted.
162
+ None of its own. Every command acts with the permissions of the token `login` stored; the API enforces them.
55
163
 
56
164
  ## UI
57
165
 
58
- None. Terminal output only; the ink components are listed in each slice's README.
166
+ None in the web app. In a terminal: the ink TUI (`menu`, `login`, `invoke`, `status`, `node`, `deploy`, `logout`, plus the app's registered screens), opened only by a bare invocation in a real terminal (`<NAME>_NO_TUI` disables it). `<NAME>_NO_UPDATE_CHECK=1` turns the [update notice](#the-start-up-update-notice) off.
59
167
 
60
168
  ## Infra
61
169
 
62
- None. The package ships no deployment configuration and reads no environment variable; `telemetryEnvSpecFragment` annotates keys of the app's `.env.example` (see the [telemetry README](src/telemetry/README.md#infra)).
170
+ The deploy wizard and `init` read `infra/compose/.env.example`, which `platform-infra sync` composes from the env template fragments in this order: the platform base (`@marinoscar/platform-infra/env/base.env.example`), each enabled slice's, then the app's own `infra/compose/app.env.example`. Env-spec fragments (`/core`) annotate those keys and never add one. ⚠ A commented `# KEY=value` line in any fragment is read as a declared variable; the conformance suite fails on one. The worker image is the app's (`apps/cli/Dockerfile`), built from the app CLI with this package in its `deps` stage; its `<NAME>_*` variables are `workerEnv()`.
63
171
 
64
172
  ## Observability
65
173
 
66
- The telemetry slice's node span relay is a worker's only span source; see the [telemetry README](src/telemetry/README.md#observability).
174
+ A worker relays each job's phase spans to the API through the [telemetry](src/telemetry/README.md#observability) slice. The node writes a JSON log (`node logs`), and every deploy run writes a redacted human journal and a JSONL journal under `<deployRoot>/logs/`. Nothing goes to an OpenTelemetry exporter from the CLI itself.
67
175
 
68
176
  ## Security notes
69
177
 
70
- Nothing is exported yet. Commands never print or persist a credential beyond the app's own configuration file.
178
+ - **Token storage.** `login` stores the token in `~/.<name>/config.json`, created with mode `0600` in a `0700` directory; `config` prints only a masked hint. The env variables `<NAME>_SERVER_URL` and `<NAME>_TOKEN` override the file per field.
179
+ - **The node credential rule (CLAUDE.md queue rule 3).** A job-scoped credential comes from `api.jobSecret(...)`, lives in memory for the job, and is never written to the config file or the state directory, never logged and never put in argv. `checkExecutorCredentialHygiene` (`/testing`) is the check, and the `cli` conformance suite runs it over every executor the worker would run, the app's included.
180
+ - **Fixed live-server literals.** `.appctl-deploy.json` and `# Managed by appctl deploy` are not derived from the identity: a renamed CLI must still read the state file and recognise the vhosts an earlier deploy wrote. Do not change them.
181
+ - Deploy steps report through `DeployHooks` only; an app step's command output reaches the hooks redacted by the run's journal.
71
182
 
72
183
  ## Conformance suite
73
184
 
74
- None yet. The package ships no conformance suite; `runPlatformConformance()` and the suites arrive with the platform's conformance harness.
185
+ `runPlatformConformance({ suites: { cli, deployRegistrations, tui } })` from [`/testing`](src/testing/README.md#conformance-suite). A suite is run with its options or skipped with `{ skip: 'reason' }`; `false` or an empty reason throws. `tui` (RETRO-G1.5): the menu tree is sound (entries open registered screens, sections reachable, no cycles, depth at most 4), app screens and sections load lazily, importing `/tui` loads no `ink`, labels are non-empty logged in and out, dashboard reducers are pure, screens render at narrow widths and without colour, and the login gate holds ([checks](src/tui/README.md#conformance-suite)). `deployRegistrations` checks that every env key names a registered group and generator, both deploy plans resolve, no edge-config file is listed twice and the vhost renders with the app's stream paths. `cli`: every env template fragment declares no commented `# KEY=value` line (beyond `PLATFORM_DOCUMENTED_OPTIONAL_KEYS` in the platform base), and every executor the worker would run passes the credential-hygiene check on a fake job holding a credential. The reference app runs it in [`apps/cli/src/conformance.test.ts`](../../apps/cli/src/conformance.test.ts).
75
186
 
76
187
  ## Upgrade notes
77
188
 
78
- None. No version has been published yet, so there is nothing to migrate from.
189
+ 0.x: the CLI moved here from `apps/cli/src` (#715) with no change to any command's flags, output, exit codes or file formats (the `--help` of every command is pinned by `apps/cli/src/help-snapshot.test.ts`). What changes for an app that forked the CLI:
190
+
191
+ | Before (forked `apps/cli/src`) | After |
192
+ |---|---|
193
+ | `CLI_NAME`, `ENV_PREFIX`, `envVar`, `CONFIG_DIR_NAME` module constants | `createCli({ identity })`, then `cliName()`, `envPrefix()`, `envVar()`, `configDirName()` |
194
+ | `buildProgram()` with a fixed command list | `extraCommands` / `registerCliCommand` |
195
+ | `type Route` and `menu.tsx` edits | `tuiScreens` / `registerTuiScreen` |
196
+ | A step added to `install.ts` | `deploySteps` / `registerDeployStep` after a built-in step id |
197
+ | An executor added to `defaultExecutors()` | `nodeExecutors` / `registerNodeExecutor` |
198
+ | `CLI_VERSION` (the CLI package's) | `createCli({ version })`; `--version` also prints the platform's |
79
199
 
80
200
  ## Troubleshooting
81
201
 
82
- None yet. Build and import problems common to every platform package are in [DEVELOPMENT.md § Platform packages](../../docs/DEVELOPMENT.md#platform-packages).
202
+ | Symptom | Cause | Fix |
203
+ |---|---|---|
204
+ | `No CLI identity is set` | A module ran before `createCli` | Build the CLI first; in tests use `useTestCliIdentity` or `createCli` after `resetCliForTests()` |
205
+ | `The CLI identity is already set` | `createCli` (or `setCliIdentity`) ran twice with different identities | One identity per process; tests reset with `resetCliForTests()` |
206
+ | `... was registered after createCli built the CLI` | A `register*` call after `createCli` | Register before `createCli`, or pass the entry in its options |
207
+ | `Deploy step "x" after "y", which is not a step of the install pipeline` | The anchor (`after`, `before` or `replaces`) names no built-in or earlier app step, or one already replaced | Use an id from `INSTALL_STEP_IDS` / `UPDATE_STEP_IDS` |
208
+ | `Proxy path "..." contains a character that is not allowed in a vhost location` | A stream path has `;`, a quote, a brace, `$`, `#`, whitespace or a control character | Use letters, digits and `. _ ~ / : @ + , = -` after a leading `/` |
209
+ | `Env key "K" is in group "g", which this CLI does not know` | A fragment names an unregistered group | `registerEnvGroup` (before `createCli`) or fix the fragment |
210
+ | `suite "cli" is skipped without a reason` / `switched off with false` | An opt-out of a conformance suite with no reason | `cli: { skip: 'why this app does not run it' }` |
211
+ | `Node executor "t" duplicates a built-in executor` | The app registers `db.backup.run` or `example.checksum` | A job type has one executor; choose an app type |
83
212
 
84
213
  ## Links
85
214
 
86
- - [Platform packages spec](../../docs/specs/platform-packages.md): the extension contract and the package documentation standard
87
- - [Package documentation standard and checks](../../docs/PACKAGES.md): how this README, the TSDoc and the catalog are checked
88
- - [DEVELOPMENT.md § Platform packages](../../docs/DEVELOPMENT.md#platform-packages): build, test and lint commands
215
+ - [Platform packages spec: worked examples, CLI](../../docs/specs/platform-packages.md#cli)
216
+ - [Package documentation standard and checks](../../docs/PACKAGES.md)
217
+ - [Reference CLI README: Extending the CLI from an app](../../apps/cli/README.md#extending-the-cli-from-an-app)
218
+ - [VPS deploy spec](../../docs/specs/vps-deploy.md) and [worker nodes spec](../../docs/specs/worker-nodes.md)
219
+ - TypeDoc API reference: `npm run docs:packages`, then `packages/platform-cli/docs-api/index.html`
220
+ - Slice READMEs: [core](src/core/README.md), [commands](src/commands/README.md), [tui](src/tui/README.md), [deploy](src/deploy/README.md), [node](src/node/README.md), [api-client](src/api-client/README.md), [telemetry](src/telemetry/README.md), [testing](src/testing/README.md)
@@ -0,0 +1,30 @@
1
+ import { type ExecFn } from './exec.js';
2
+ import { type ApkMetadata } from './metadata.js';
3
+ import { type BuildServerUrl } from './server-url.js';
4
+ export interface BuildOptions {
5
+ /** The server the app is tied to; defaults to the stored login's server (#318). */
6
+ serverUrl?: string | undefined;
7
+ debug?: boolean | undefined;
8
+ /** Refuse to build from a checkout behind its remote (#315); by default that is a warning. */
9
+ requireUpToDate?: boolean | undefined;
10
+ }
11
+ export interface BuildContext {
12
+ exec?: ExecFn | undefined;
13
+ env?: NodeJS.ProcessEnv | undefined;
14
+ home?: string | undefined;
15
+ cwd?: string | undefined;
16
+ platform?: NodeJS.Platform | undefined;
17
+ log: (line: string) => void;
18
+ }
19
+ export interface BuildResult {
20
+ apkPath: string;
21
+ metadataPath: string;
22
+ metadata: ApkMetadata;
23
+ verified: boolean;
24
+ /** The server URL the APK was built for, and where it came from (#318). */
25
+ server: BuildServerUrl;
26
+ }
27
+ /** `Signer #1 certificate SHA-256 digest: <hex>` from `apksigner verify --print-certs`. */
28
+ export declare function parseApksignerSha256(output: string): string | undefined;
29
+ export declare function runBuild(options: BuildOptions, ctx: BuildContext): Promise<BuildResult>;
30
+ //# sourceMappingURL=build.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/android/build.ts"],"names":[],"mappings":"AAKA,OAAO,EAAoC,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAI1E,OAAO,EAA0E,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAGzH,OAAO,EAA8D,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAOlH,MAAM,WAAW,YAAY;IAC3B,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,8FAA8F;IAC9F,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,SAAS,CAAC;IACvC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGvE;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA0H7F"}
@@ -0,0 +1,126 @@
1
+ import { copyFileSync, existsSync, mkdirSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { cliName } from '../engine/index.js';
4
+ import { PreconditionError } from '../engine/index.js';
5
+ import { exec as defaultExec, execChecked } from './exec.js';
6
+ import { behindWarning, checkGitFreshness, describeFreshness } from './git-freshness.js';
7
+ import { builtApkPath, gradleArgs, gradlewPath, readApplicationId } from './gradle.js';
8
+ import { fingerprintToHex, readCertificateSha256, readSigningConfig, signingEnv } from './keystore.js';
9
+ import { apkFileName, buildMetadata, metadataPathFor, readGitSha, writeMetadata } from './metadata.js';
10
+ import { androidProjectDir, distDir, extraGradleArgs, requireRepoRoot, versionPropertiesPath } from './paths.js';
11
+ import { resolveSdk, sdkLayout } from './sdk.js';
12
+ import { builtForLine, NO_SERVER_URL_WARNING, resolveBuildServerUrl } from './server-url.js';
13
+ import { readVersion } from './version.js';
14
+ /** `Signer #1 certificate SHA-256 digest: <hex>` from `apksigner verify --print-certs`. */
15
+ export function parseApksignerSha256(output) {
16
+ const match = /Signer #1 certificate SHA-256 digest:\s*([0-9a-f]{64})/i.exec(output);
17
+ return match?.[1]?.toLowerCase();
18
+ }
19
+ export async function runBuild(options, ctx) {
20
+ const exec = ctx.exec ?? defaultExec;
21
+ const env = ctx.env ?? process.env;
22
+ const platform = ctx.platform ?? process.platform;
23
+ const paths = { env, ...(ctx.home !== undefined ? { home: ctx.home } : {}), ...(ctx.cwd !== undefined ? { cwd: ctx.cwd } : {}) };
24
+ const debug = options.debug === true;
25
+ const repoRoot = requireRepoRoot(paths);
26
+ const projectDir = androidProjectDir(repoRoot);
27
+ const version = readVersion(versionPropertiesPath(repoRoot));
28
+ if (!version.exists) {
29
+ ctx.log(`version.properties not found; building ${version.versionName} (${version.versionCode}).`);
30
+ }
31
+ const sdk = resolveSdk({ env, platform, ...(ctx.home !== undefined ? { home: ctx.home } : {}) });
32
+ if (!sdk.exists) {
33
+ throw new PreconditionError(`No Android SDK found. Run \`${cliName()} android doctor --fix\`.`);
34
+ }
35
+ const signing = readSigningConfig(paths);
36
+ if (!debug && signing === undefined) {
37
+ throw new PreconditionError(`No release keystore is configured. Run \`${cliName()} android keystore init\` (or \`keystore import <file>\`), or build with --debug.`);
38
+ }
39
+ const wrapper = gradlewPath(projectDir, platform);
40
+ if (!existsSync(wrapper))
41
+ throw new PreconditionError(`${wrapper} is missing.`);
42
+ // ⚠ Before Gradle, not after: a checkout behind its remote builds an APK
43
+ // without the commits it is missing (#315). A warning by default, an error
44
+ // with --require-up-to-date; never a pull.
45
+ const freshness = await checkGitFreshness(repoRoot, { exec, env });
46
+ const behind = behindWarning(freshness);
47
+ if (behind !== undefined) {
48
+ if (options.requireUpToDate === true) {
49
+ throw new PreconditionError(`${behind.replace(/^⚠ /, '')} (refusing to build: --require-up-to-date)`);
50
+ }
51
+ ctx.log(behind);
52
+ }
53
+ else if (freshness.state !== 'up_to_date' || freshness.fetchError !== undefined) {
54
+ ctx.log(`Note: ${describeFreshness(freshness)}.`);
55
+ }
56
+ // ⚠ The server decides which host the app claims links for, and so whether
57
+ // Chrome delegates Web Push to it (#318). Warned before Gradle, never fatal.
58
+ const server = resolveBuildServerUrl(options.serverUrl, { env, ...(ctx.home !== undefined ? { home: ctx.home } : {}) });
59
+ if (server.serverUrl === undefined)
60
+ ctx.log(NO_SERVER_URL_WARNING());
61
+ const childEnv = {
62
+ ...env,
63
+ ANDROID_HOME: sdk.root,
64
+ ANDROID_SDK_ROOT: sdk.root,
65
+ ...(debug || signing === undefined ? {} : signingEnv(signing)),
66
+ };
67
+ const args = gradleArgs({
68
+ debug,
69
+ versionName: version.versionName,
70
+ versionCode: version.versionCode,
71
+ serverUrl: server.serverUrl,
72
+ extra: extraGradleArgs(env),
73
+ });
74
+ ctx.log(`Building ${debug ? 'debug' : 'release'} ${version.versionName} (${version.versionCode}) with Gradle…`);
75
+ await execChecked(exec, wrapper, args, {
76
+ cwd: projectDir,
77
+ env: childEnv,
78
+ platform,
79
+ missingHint: 'Restore apps/android/gradlew from git (and make it executable).',
80
+ onLine: (line) => ctx.log(` ${line}`),
81
+ });
82
+ const output = builtApkPath(projectDir, debug);
83
+ if (!existsSync(output)) {
84
+ throw new PreconditionError(`Gradle finished but ${output} does not exist.`);
85
+ }
86
+ // The certificate the APK must carry: the configured keystore's, for release.
87
+ const expected = !debug && signing !== undefined
88
+ ? fingerprintToHex(signing.certSha256 ?? (await readCertificateSha256(signing, { exec, env, platform })))
89
+ : undefined;
90
+ let actual;
91
+ const apksigner = sdkLayout(sdk.root, platform).apksigner;
92
+ if (existsSync(apksigner)) {
93
+ const verify = await execChecked(exec, apksigner, ['verify', '--print-certs', output], { env: childEnv, platform });
94
+ actual = parseApksignerSha256(verify.stdout);
95
+ if (expected !== undefined && actual !== undefined && actual !== expected) {
96
+ throw new PreconditionError(`The APK is signed by ${actual}, not by the configured keystore (${expected}). Was the release built unsigned or with another key?`);
97
+ }
98
+ ctx.log(`apksigner: signature verified${actual !== undefined ? ` (${actual})` : ''}.`);
99
+ }
100
+ else {
101
+ ctx.log(`apksigner not found at ${apksigner}; skipping signature verification.`);
102
+ }
103
+ const signingSha256 = actual ?? expected;
104
+ if (signingSha256 === undefined) {
105
+ throw new PreconditionError('Could not determine the signing certificate. Install build-tools (`android doctor --fix`).');
106
+ }
107
+ const dist = distDir(repoRoot);
108
+ mkdirSync(dist, { recursive: true });
109
+ const name = apkFileName(version.versionName).replace(/\.apk$/, debug ? '-debug.apk' : '.apk');
110
+ const apkPath = join(dist, name);
111
+ copyFileSync(output, apkPath);
112
+ const metadata = await buildMetadata({
113
+ apkPath,
114
+ packageName: readApplicationId(projectDir),
115
+ versionName: version.versionName,
116
+ versionCode: version.versionCode,
117
+ signingSha256,
118
+ gitSha: await readGitSha(exec, repoRoot),
119
+ serverUrl: server.serverUrl ?? null,
120
+ });
121
+ const metadataPath = metadataPathFor(apkPath);
122
+ writeMetadata(metadataPath, metadata);
123
+ ctx.log(builtForLine(server));
124
+ return { apkPath, metadataPath, metadata, verified: actual !== undefined, server };
125
+ }
126
+ //# sourceMappingURL=build.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/android/build.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import type { Command } from 'commander';
2
+ import { type ExecFn } from './exec.js';
3
+ export interface AndroidCommandContext {
4
+ stdout?: {
5
+ write(chunk: string): unknown;
6
+ } | undefined;
7
+ stderr?: {
8
+ write(chunk: string): unknown;
9
+ isTTY?: boolean;
10
+ } | undefined;
11
+ env?: NodeJS.ProcessEnv | undefined;
12
+ home?: string | undefined;
13
+ cwd?: string | undefined;
14
+ fetch?: typeof globalThis.fetch | undefined;
15
+ exec?: ExecFn | undefined;
16
+ }
17
+ /** Env names the keystore passwords are read from (the same names Gradle and CI use). */
18
+ export declare const STORE_PASSWORD_ENV = "ANDROID_KEYSTORE_PASSWORD";
19
+ export declare const KEY_PASSWORD_ENV = "ANDROID_KEY_PASSWORD";
20
+ export declare function registerAndroidCommand(program: Command, ctx?: AndroidCommandContext): Command;
21
+ //# sourceMappingURL=command.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/android/command.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AA4C7D,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IACvD,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;IAC5C,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,yFAAyF;AACzF,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAC9D,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,qBAAqB,GAAG,OAAO,CA0T7F"}