@marinoscar/platform-cli 0.0.0-stage → 0.1.0-next.11

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 (752) hide show
  1. package/CHANGELOG.md +157 -0
  2. package/LICENSE +21 -0
  3. package/README.md +182 -2
  4. package/dist/android/build.d.ts +30 -0
  5. package/dist/android/build.d.ts.map +1 -0
  6. package/dist/android/build.js +126 -0
  7. package/dist/android/build.js.map +1 -0
  8. package/dist/android/command.d.ts +21 -0
  9. package/dist/android/command.d.ts.map +1 -0
  10. package/dist/android/command.js +355 -0
  11. package/dist/android/command.js.map +1 -0
  12. package/dist/android/deploy-step.d.ts +85 -0
  13. package/dist/android/deploy-step.d.ts.map +1 -0
  14. package/dist/android/deploy-step.js +268 -0
  15. package/dist/android/deploy-step.js.map +1 -0
  16. package/dist/android/doctor.d.ts +47 -0
  17. package/dist/android/doctor.d.ts.map +1 -0
  18. package/dist/android/doctor.js +219 -0
  19. package/dist/android/doctor.js.map +1 -0
  20. package/dist/android/exec.d.ts +42 -0
  21. package/dist/android/exec.d.ts.map +1 -0
  22. package/dist/android/exec.js +103 -0
  23. package/dist/android/exec.js.map +1 -0
  24. package/dist/android/fix-plan.d.ts +44 -0
  25. package/dist/android/fix-plan.d.ts.map +1 -0
  26. package/dist/android/fix-plan.js +86 -0
  27. package/dist/android/fix-plan.js.map +1 -0
  28. package/dist/android/git-freshness.d.ts +34 -0
  29. package/dist/android/git-freshness.d.ts.map +1 -0
  30. package/dist/android/git-freshness.js +120 -0
  31. package/dist/android/git-freshness.js.map +1 -0
  32. package/dist/android/gradle.d.ts +32 -0
  33. package/dist/android/gradle.d.ts.map +1 -0
  34. package/dist/android/gradle.js +55 -0
  35. package/dist/android/gradle.js.map +1 -0
  36. package/dist/android/identity.d.ts +27 -0
  37. package/dist/android/identity.d.ts.map +1 -0
  38. package/dist/android/identity.js +60 -0
  39. package/dist/android/identity.js.map +1 -0
  40. package/dist/android/index.d.ts +7 -0
  41. package/dist/android/index.d.ts.map +1 -0
  42. package/dist/android/index.js +8 -0
  43. package/dist/android/index.js.map +1 -0
  44. package/dist/android/installer.d.ts +28 -0
  45. package/dist/android/installer.d.ts.map +1 -0
  46. package/dist/android/installer.js +96 -0
  47. package/dist/android/installer.js.map +1 -0
  48. package/dist/android/java.d.ts +26 -0
  49. package/dist/android/java.d.ts.map +1 -0
  50. package/dist/android/java.js +65 -0
  51. package/dist/android/java.js.map +1 -0
  52. package/dist/android/keystore.d.ts +54 -0
  53. package/dist/android/keystore.d.ts.map +1 -0
  54. package/dist/android/keystore.js +159 -0
  55. package/dist/android/keystore.js.map +1 -0
  56. package/dist/android/metadata.d.ts +39 -0
  57. package/dist/android/metadata.d.ts.map +1 -0
  58. package/dist/android/metadata.js +61 -0
  59. package/dist/android/metadata.js.map +1 -0
  60. package/dist/android/operations.d.ts +42 -0
  61. package/dist/android/operations.d.ts.map +1 -0
  62. package/dist/android/operations.js +59 -0
  63. package/dist/android/operations.js.map +1 -0
  64. package/dist/android/paths.d.ts +29 -0
  65. package/dist/android/paths.d.ts.map +1 -0
  66. package/dist/android/paths.js +97 -0
  67. package/dist/android/paths.js.map +1 -0
  68. package/dist/android/publish.d.ts +37 -0
  69. package/dist/android/publish.d.ts.map +1 -0
  70. package/dist/android/publish.js +119 -0
  71. package/dist/android/publish.js.map +1 -0
  72. package/dist/android/registrations.d.ts +92 -0
  73. package/dist/android/registrations.d.ts.map +1 -0
  74. package/dist/android/registrations.js +112 -0
  75. package/dist/android/registrations.js.map +1 -0
  76. package/dist/android/release-status.d.ts +73 -0
  77. package/dist/android/release-status.d.ts.map +1 -0
  78. package/dist/android/release-status.js +161 -0
  79. package/dist/android/release-status.js.map +1 -0
  80. package/dist/android/release.d.ts +33 -0
  81. package/dist/android/release.d.ts.map +1 -0
  82. package/dist/android/release.js +59 -0
  83. package/dist/android/release.js.map +1 -0
  84. package/dist/android/screen-layout.d.ts +26 -0
  85. package/dist/android/screen-layout.d.ts.map +1 -0
  86. package/dist/android/screen-layout.js +24 -0
  87. package/dist/android/screen-layout.js.map +1 -0
  88. package/dist/android/screen-model.d.ts +56 -0
  89. package/dist/android/screen-model.d.ts.map +1 -0
  90. package/dist/android/screen-model.js +207 -0
  91. package/dist/android/screen-model.js.map +1 -0
  92. package/dist/android/screen.d.ts +8 -0
  93. package/dist/android/screen.d.ts.map +1 -0
  94. package/dist/android/screen.js +395 -0
  95. package/dist/android/screen.js.map +1 -0
  96. package/dist/android/sdk.d.ts +48 -0
  97. package/dist/android/sdk.d.ts.map +1 -0
  98. package/dist/android/sdk.js +82 -0
  99. package/dist/android/sdk.js.map +1 -0
  100. package/dist/android/server-url.d.ts +19 -0
  101. package/dist/android/server-url.d.ts.map +1 -0
  102. package/dist/android/server-url.js +36 -0
  103. package/dist/android/server-url.js.map +1 -0
  104. package/dist/android/upload-progress.d.ts +3 -0
  105. package/dist/android/upload-progress.d.ts.map +1 -0
  106. package/dist/android/upload-progress.js +47 -0
  107. package/dist/android/upload-progress.js.map +1 -0
  108. package/dist/android/version.d.ts +47 -0
  109. package/dist/android/version.d.ts.map +1 -0
  110. package/dist/android/version.js +136 -0
  111. package/dist/android/version.js.map +1 -0
  112. package/dist/api-client/index.d.ts +3 -0
  113. package/dist/api-client/index.d.ts.map +1 -0
  114. package/dist/api-client/index.js +5 -0
  115. package/dist/api-client/index.js.map +1 -0
  116. package/dist/commands/index.d.ts +52 -0
  117. package/dist/commands/index.d.ts.map +1 -0
  118. package/dist/commands/index.js +63 -0
  119. package/dist/commands/index.js.map +1 -0
  120. package/dist/core/cli-registry.d.ts +41 -0
  121. package/dist/core/cli-registry.d.ts.map +1 -0
  122. package/dist/core/cli-registry.js +49 -0
  123. package/dist/core/cli-registry.js.map +1 -0
  124. package/dist/core/command-registry.d.ts +60 -0
  125. package/dist/core/command-registry.d.ts.map +1 -0
  126. package/dist/core/command-registry.js +114 -0
  127. package/dist/core/command-registry.js.map +1 -0
  128. package/dist/core/env-annotation-registry.d.ts +58 -0
  129. package/dist/core/env-annotation-registry.d.ts.map +1 -0
  130. package/dist/core/env-annotation-registry.js +80 -0
  131. package/dist/core/env-annotation-registry.js.map +1 -0
  132. package/dist/core/env-generator-registry.d.ts +59 -0
  133. package/dist/core/env-generator-registry.d.ts.map +1 -0
  134. package/dist/core/env-generator-registry.js +102 -0
  135. package/dist/core/env-generator-registry.js.map +1 -0
  136. package/dist/core/env-group-registry.d.ts +65 -0
  137. package/dist/core/env-group-registry.d.ts.map +1 -0
  138. package/dist/core/env-group-registry.js +77 -0
  139. package/dist/core/env-group-registry.js.map +1 -0
  140. package/dist/core/env-spec-registry.d.ts +133 -0
  141. package/dist/core/env-spec-registry.d.ts.map +1 -0
  142. package/dist/core/env-spec-registry.js +103 -0
  143. package/dist/core/env-spec-registry.js.map +1 -0
  144. package/dist/core/env-values.d.ts +76 -0
  145. package/dist/core/env-values.d.ts.map +1 -0
  146. package/dist/core/env-values.js +125 -0
  147. package/dist/core/env-values.js.map +1 -0
  148. package/dist/core/index.d.ts +14 -0
  149. package/dist/core/index.d.ts.map +1 -0
  150. package/dist/core/index.js +10 -0
  151. package/dist/core/index.js.map +1 -0
  152. package/dist/deploy/index.d.ts +3 -0
  153. package/dist/deploy/index.d.ts.map +1 -0
  154. package/dist/deploy/index.js +5 -0
  155. package/dist/deploy/index.js.map +1 -0
  156. package/dist/engine/api-client.d.ts +211 -0
  157. package/dist/engine/api-client.d.ts.map +1 -0
  158. package/dist/engine/api-client.js +350 -0
  159. package/dist/engine/api-client.js.map +1 -0
  160. package/dist/engine/browser.d.ts +18 -0
  161. package/dist/engine/browser.d.ts.map +1 -0
  162. package/dist/engine/browser.js +115 -0
  163. package/dist/engine/browser.js.map +1 -0
  164. package/dist/engine/builtin-registrations.d.ts +20 -0
  165. package/dist/engine/builtin-registrations.d.ts.map +1 -0
  166. package/dist/engine/builtin-registrations.js +86 -0
  167. package/dist/engine/builtin-registrations.js.map +1 -0
  168. package/dist/engine/commands/api.d.ts +88 -0
  169. package/dist/engine/commands/api.d.ts.map +1 -0
  170. package/dist/engine/commands/api.js +398 -0
  171. package/dist/engine/commands/api.js.map +1 -0
  172. package/dist/engine/commands/config.d.ts +5 -0
  173. package/dist/engine/commands/config.d.ts.map +1 -0
  174. package/dist/engine/commands/config.js +83 -0
  175. package/dist/engine/commands/config.js.map +1 -0
  176. package/dist/engine/commands/deploy.d.ts +243 -0
  177. package/dist/engine/commands/deploy.d.ts.map +1 -0
  178. package/dist/engine/commands/deploy.js +1166 -0
  179. package/dist/engine/commands/deploy.js.map +1 -0
  180. package/dist/engine/commands/init.d.ts +18 -0
  181. package/dist/engine/commands/init.d.ts.map +1 -0
  182. package/dist/engine/commands/init.js +50 -0
  183. package/dist/engine/commands/init.js.map +1 -0
  184. package/dist/engine/commands/login.d.ts +4 -0
  185. package/dist/engine/commands/login.d.ts.map +1 -0
  186. package/dist/engine/commands/login.js +205 -0
  187. package/dist/engine/commands/login.js.map +1 -0
  188. package/dist/engine/commands/node.d.ts +21 -0
  189. package/dist/engine/commands/node.d.ts.map +1 -0
  190. package/dist/engine/commands/node.js +436 -0
  191. package/dist/engine/commands/node.js.map +1 -0
  192. package/dist/engine/config.d.ts +246 -0
  193. package/dist/engine/config.d.ts.map +1 -0
  194. package/dist/engine/config.js +414 -0
  195. package/dist/engine/config.js.map +1 -0
  196. package/dist/engine/conformance.d.ts +187 -0
  197. package/dist/engine/conformance.d.ts.map +1 -0
  198. package/dist/engine/conformance.js +227 -0
  199. package/dist/engine/conformance.js.map +1 -0
  200. package/dist/engine/create-cli.d.ts +94 -0
  201. package/dist/engine/create-cli.d.ts.map +1 -0
  202. package/dist/engine/create-cli.js +60 -0
  203. package/dist/engine/create-cli.js.map +1 -0
  204. package/dist/engine/deploy/about.d.ts +12 -0
  205. package/dist/engine/deploy/about.d.ts.map +1 -0
  206. package/dist/engine/deploy/about.js +110 -0
  207. package/dist/engine/deploy/about.js.map +1 -0
  208. package/dist/engine/deploy/adopt.d.ts +21 -0
  209. package/dist/engine/deploy/adopt.d.ts.map +1 -0
  210. package/dist/engine/deploy/adopt.js +78 -0
  211. package/dist/engine/deploy/adopt.js.map +1 -0
  212. package/dist/engine/deploy/answers-file.d.ts +7 -0
  213. package/dist/engine/deploy/answers-file.d.ts.map +1 -0
  214. package/dist/engine/deploy/answers-file.js +49 -0
  215. package/dist/engine/deploy/answers-file.js.map +1 -0
  216. package/dist/engine/deploy/app-role.d.ts +278 -0
  217. package/dist/engine/deploy/app-role.d.ts.map +1 -0
  218. package/dist/engine/deploy/app-role.js +826 -0
  219. package/dist/engine/deploy/app-role.js.map +1 -0
  220. package/dist/engine/deploy/app-version.d.ts +47 -0
  221. package/dist/engine/deploy/app-version.d.ts.map +1 -0
  222. package/dist/engine/deploy/app-version.js +232 -0
  223. package/dist/engine/deploy/app-version.js.map +1 -0
  224. package/dist/engine/deploy/checks/database.d.ts +83 -0
  225. package/dist/engine/deploy/checks/database.d.ts.map +1 -0
  226. package/dist/engine/deploy/checks/database.js +455 -0
  227. package/dist/engine/deploy/checks/database.js.map +1 -0
  228. package/dist/engine/deploy/checks/dns.d.ts +3 -0
  229. package/dist/engine/deploy/checks/dns.d.ts.map +1 -0
  230. package/dist/engine/deploy/checks/dns.js +85 -0
  231. package/dist/engine/deploy/checks/dns.js.map +1 -0
  232. package/dist/engine/deploy/checks/host.d.ts +19 -0
  233. package/dist/engine/deploy/checks/host.d.ts.map +1 -0
  234. package/dist/engine/deploy/checks/host.js +543 -0
  235. package/dist/engine/deploy/checks/host.js.map +1 -0
  236. package/dist/engine/deploy/checks/index.d.ts +33 -0
  237. package/dist/engine/deploy/checks/index.d.ts.map +1 -0
  238. package/dist/engine/deploy/checks/index.js +67 -0
  239. package/dist/engine/deploy/checks/index.js.map +1 -0
  240. package/dist/engine/deploy/checks/registry.d.ts +110 -0
  241. package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
  242. package/dist/engine/deploy/checks/registry.js +104 -0
  243. package/dist/engine/deploy/checks/registry.js.map +1 -0
  244. package/dist/engine/deploy/checks/source.d.ts +45 -0
  245. package/dist/engine/deploy/checks/source.d.ts.map +1 -0
  246. package/dist/engine/deploy/checks/source.js +175 -0
  247. package/dist/engine/deploy/checks/source.js.map +1 -0
  248. package/dist/engine/deploy/checks/tls.d.ts +87 -0
  249. package/dist/engine/deploy/checks/tls.d.ts.map +1 -0
  250. package/dist/engine/deploy/checks/tls.js +552 -0
  251. package/dist/engine/deploy/checks/tls.js.map +1 -0
  252. package/dist/engine/deploy/checks/types.d.ts +186 -0
  253. package/dist/engine/deploy/checks/types.d.ts.map +1 -0
  254. package/dist/engine/deploy/checks/types.js +199 -0
  255. package/dist/engine/deploy/checks/types.js.map +1 -0
  256. package/dist/engine/deploy/compose-files.d.ts +29 -0
  257. package/dist/engine/deploy/compose-files.d.ts.map +1 -0
  258. package/dist/engine/deploy/compose-files.js +118 -0
  259. package/dist/engine/deploy/compose-files.js.map +1 -0
  260. package/dist/engine/deploy/compose-hints.d.ts +11 -0
  261. package/dist/engine/deploy/compose-hints.d.ts.map +1 -0
  262. package/dist/engine/deploy/compose-hints.js +70 -0
  263. package/dist/engine/deploy/compose-hints.js.map +1 -0
  264. package/dist/engine/deploy/consent.d.ts +29 -0
  265. package/dist/engine/deploy/consent.d.ts.map +1 -0
  266. package/dist/engine/deploy/consent.js +35 -0
  267. package/dist/engine/deploy/consent.js.map +1 -0
  268. package/dist/engine/deploy/database-drop.d.ts +22 -0
  269. package/dist/engine/deploy/database-drop.d.ts.map +1 -0
  270. package/dist/engine/deploy/database-drop.js +135 -0
  271. package/dist/engine/deploy/database-drop.js.map +1 -0
  272. package/dist/engine/deploy/database.d.ts +116 -0
  273. package/dist/engine/deploy/database.d.ts.map +1 -0
  274. package/dist/engine/deploy/database.js +252 -0
  275. package/dist/engine/deploy/database.js.map +1 -0
  276. package/dist/engine/deploy/deploy-info.d.ts +48 -0
  277. package/dist/engine/deploy/deploy-info.d.ts.map +1 -0
  278. package/dist/engine/deploy/deploy-info.js +163 -0
  279. package/dist/engine/deploy/deploy-info.js.map +1 -0
  280. package/dist/engine/deploy/deployment-evidence.d.ts +38 -0
  281. package/dist/engine/deploy/deployment-evidence.d.ts.map +1 -0
  282. package/dist/engine/deploy/deployment-evidence.js +92 -0
  283. package/dist/engine/deploy/deployment-evidence.js.map +1 -0
  284. package/dist/engine/deploy/edge-config.d.ts +103 -0
  285. package/dist/engine/deploy/edge-config.d.ts.map +1 -0
  286. package/dist/engine/deploy/edge-config.js +170 -0
  287. package/dist/engine/deploy/edge-config.js.map +1 -0
  288. package/dist/engine/deploy/env-absence.d.ts +61 -0
  289. package/dist/engine/deploy/env-absence.d.ts.map +1 -0
  290. package/dist/engine/deploy/env-absence.js +33 -0
  291. package/dist/engine/deploy/env-absence.js.map +1 -0
  292. package/dist/engine/deploy/env-file.d.ts +14 -0
  293. package/dist/engine/deploy/env-file.d.ts.map +1 -0
  294. package/dist/engine/deploy/env-file.js +58 -0
  295. package/dist/engine/deploy/env-file.js.map +1 -0
  296. package/dist/engine/deploy/env-fragments.d.ts +29 -0
  297. package/dist/engine/deploy/env-fragments.d.ts.map +1 -0
  298. package/dist/engine/deploy/env-fragments.js +73 -0
  299. package/dist/engine/deploy/env-fragments.js.map +1 -0
  300. package/dist/engine/deploy/env-metadata.d.ts +73 -0
  301. package/dist/engine/deploy/env-metadata.d.ts.map +1 -0
  302. package/dist/engine/deploy/env-metadata.js +227 -0
  303. package/dist/engine/deploy/env-metadata.js.map +1 -0
  304. package/dist/engine/deploy/env-spec.d.ts +75 -0
  305. package/dist/engine/deploy/env-spec.d.ts.map +1 -0
  306. package/dist/engine/deploy/env-spec.js +239 -0
  307. package/dist/engine/deploy/env-spec.js.map +1 -0
  308. package/dist/engine/deploy/env-wizard.d.ts +56 -0
  309. package/dist/engine/deploy/env-wizard.d.ts.map +1 -0
  310. package/dist/engine/deploy/env-wizard.js +235 -0
  311. package/dist/engine/deploy/env-wizard.js.map +1 -0
  312. package/dist/engine/deploy/executor.d.ts +81 -0
  313. package/dist/engine/deploy/executor.d.ts.map +1 -0
  314. package/dist/engine/deploy/executor.js +247 -0
  315. package/dist/engine/deploy/executor.js.map +1 -0
  316. package/dist/engine/deploy/health.d.ts +153 -0
  317. package/dist/engine/deploy/health.d.ts.map +1 -0
  318. package/dist/engine/deploy/health.js +335 -0
  319. package/dist/engine/deploy/health.js.map +1 -0
  320. package/dist/engine/deploy/hooks.d.ts +66 -0
  321. package/dist/engine/deploy/hooks.d.ts.map +1 -0
  322. package/dist/engine/deploy/hooks.js +19 -0
  323. package/dist/engine/deploy/hooks.js.map +1 -0
  324. package/dist/engine/deploy/host-facts.d.ts +23 -0
  325. package/dist/engine/deploy/host-facts.d.ts.map +1 -0
  326. package/dist/engine/deploy/host-facts.js +67 -0
  327. package/dist/engine/deploy/host-facts.js.map +1 -0
  328. package/dist/engine/deploy/install.d.ts +233 -0
  329. package/dist/engine/deploy/install.d.ts.map +1 -0
  330. package/dist/engine/deploy/install.js +1318 -0
  331. package/dist/engine/deploy/install.js.map +1 -0
  332. package/dist/engine/deploy/inventory.d.ts +30 -0
  333. package/dist/engine/deploy/inventory.d.ts.map +1 -0
  334. package/dist/engine/deploy/inventory.js +122 -0
  335. package/dist/engine/deploy/inventory.js.map +1 -0
  336. package/dist/engine/deploy/journal.d.ts +77 -0
  337. package/dist/engine/deploy/journal.d.ts.map +1 -0
  338. package/dist/engine/deploy/journal.js +221 -0
  339. package/dist/engine/deploy/journal.js.map +1 -0
  340. package/dist/engine/deploy/layout.d.ts +77 -0
  341. package/dist/engine/deploy/layout.d.ts.map +1 -0
  342. package/dist/engine/deploy/layout.js +191 -0
  343. package/dist/engine/deploy/layout.js.map +1 -0
  344. package/dist/engine/deploy/oauth-check.d.ts +58 -0
  345. package/dist/engine/deploy/oauth-check.d.ts.map +1 -0
  346. package/dist/engine/deploy/oauth-check.js +213 -0
  347. package/dist/engine/deploy/oauth-check.js.map +1 -0
  348. package/dist/engine/deploy/proxy-bootstrap.d.ts +149 -0
  349. package/dist/engine/deploy/proxy-bootstrap.d.ts.map +1 -0
  350. package/dist/engine/deploy/proxy-bootstrap.js +416 -0
  351. package/dist/engine/deploy/proxy-bootstrap.js.map +1 -0
  352. package/dist/engine/deploy/proxy-streams.d.ts +110 -0
  353. package/dist/engine/deploy/proxy-streams.d.ts.map +1 -0
  354. package/dist/engine/deploy/proxy-streams.js +208 -0
  355. package/dist/engine/deploy/proxy-streams.js.map +1 -0
  356. package/dist/engine/deploy/proxy.d.ts +375 -0
  357. package/dist/engine/deploy/proxy.d.ts.map +1 -0
  358. package/dist/engine/deploy/proxy.js +758 -0
  359. package/dist/engine/deploy/proxy.js.map +1 -0
  360. package/dist/engine/deploy/renewal.d.ts +54 -0
  361. package/dist/engine/deploy/renewal.d.ts.map +1 -0
  362. package/dist/engine/deploy/renewal.js +169 -0
  363. package/dist/engine/deploy/renewal.js.map +1 -0
  364. package/dist/engine/deploy/repo.d.ts +119 -0
  365. package/dist/engine/deploy/repo.d.ts.map +1 -0
  366. package/dist/engine/deploy/repo.js +277 -0
  367. package/dist/engine/deploy/repo.js.map +1 -0
  368. package/dist/engine/deploy/run-record.d.ts +28 -0
  369. package/dist/engine/deploy/run-record.d.ts.map +1 -0
  370. package/dist/engine/deploy/run-record.js +44 -0
  371. package/dist/engine/deploy/run-record.js.map +1 -0
  372. package/dist/engine/deploy/state.d.ts +289 -0
  373. package/dist/engine/deploy/state.d.ts.map +1 -0
  374. package/dist/engine/deploy/state.js +163 -0
  375. package/dist/engine/deploy/state.js.map +1 -0
  376. package/dist/engine/deploy/steps/app-step-context.d.ts +24 -0
  377. package/dist/engine/deploy/steps/app-step-context.d.ts.map +1 -0
  378. package/dist/engine/deploy/steps/app-step-context.js +45 -0
  379. package/dist/engine/deploy/steps/app-step-context.js.map +1 -0
  380. package/dist/engine/deploy/steps/pipeline.d.ts +46 -0
  381. package/dist/engine/deploy/steps/pipeline.d.ts.map +1 -0
  382. package/dist/engine/deploy/steps/pipeline.js +73 -0
  383. package/dist/engine/deploy/steps/pipeline.js.map +1 -0
  384. package/dist/engine/deploy/steps/plan.d.ts +28 -0
  385. package/dist/engine/deploy/steps/plan.d.ts.map +1 -0
  386. package/dist/engine/deploy/steps/plan.js +32 -0
  387. package/dist/engine/deploy/steps/plan.js.map +1 -0
  388. package/dist/engine/deploy/steps/registry.d.ts +182 -0
  389. package/dist/engine/deploy/steps/registry.d.ts.map +1 -0
  390. package/dist/engine/deploy/steps/registry.js +212 -0
  391. package/dist/engine/deploy/steps/registry.js.map +1 -0
  392. package/dist/engine/deploy/steps/step-values.d.ts +28 -0
  393. package/dist/engine/deploy/steps/step-values.d.ts.map +1 -0
  394. package/dist/engine/deploy/steps/step-values.js +33 -0
  395. package/dist/engine/deploy/steps/step-values.js.map +1 -0
  396. package/dist/engine/deploy/testing/fake-postgres.d.ts +88 -0
  397. package/dist/engine/deploy/testing/fake-postgres.d.ts.map +1 -0
  398. package/dist/engine/deploy/testing/fake-postgres.js +236 -0
  399. package/dist/engine/deploy/testing/fake-postgres.js.map +1 -0
  400. package/dist/engine/deploy/testing/fake-vps.d.ts +147 -0
  401. package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -0
  402. package/dist/engine/deploy/testing/fake-vps.js +365 -0
  403. package/dist/engine/deploy/testing/fake-vps.js.map +1 -0
  404. package/dist/engine/deploy/uninstall.d.ts +87 -0
  405. package/dist/engine/deploy/uninstall.d.ts.map +1 -0
  406. package/dist/engine/deploy/uninstall.js +321 -0
  407. package/dist/engine/deploy/uninstall.js.map +1 -0
  408. package/dist/engine/deploy/update.d.ts +112 -0
  409. package/dist/engine/deploy/update.d.ts.map +1 -0
  410. package/dist/engine/deploy/update.js +1280 -0
  411. package/dist/engine/deploy/update.js.map +1 -0
  412. package/dist/engine/deploy/version-step.d.ts +65 -0
  413. package/dist/engine/deploy/version-step.d.ts.map +1 -0
  414. package/dist/engine/deploy/version-step.js +176 -0
  415. package/dist/engine/deploy/version-step.js.map +1 -0
  416. package/dist/engine/device-auth.d.ts +240 -0
  417. package/dist/engine/device-auth.d.ts.map +1 -0
  418. package/dist/engine/device-auth.js +442 -0
  419. package/dist/engine/device-auth.js.map +1 -0
  420. package/dist/engine/device-login.d.ts +126 -0
  421. package/dist/engine/device-login.d.ts.map +1 -0
  422. package/dist/engine/device-login.js +164 -0
  423. package/dist/engine/device-login.js.map +1 -0
  424. package/dist/engine/errors.d.ts +314 -0
  425. package/dist/engine/errors.d.ts.map +1 -0
  426. package/dist/engine/errors.js +561 -0
  427. package/dist/engine/errors.js.map +1 -0
  428. package/dist/engine/identity.d.ts +169 -0
  429. package/dist/engine/identity.d.ts.map +1 -0
  430. package/dist/engine/identity.js +227 -0
  431. package/dist/engine/identity.js.map +1 -0
  432. package/dist/engine/index.d.ts +104 -0
  433. package/dist/engine/index.d.ts.map +1 -0
  434. package/dist/engine/index.js +126 -0
  435. package/dist/engine/index.js.map +1 -0
  436. package/dist/engine/init/local-profile.d.ts +93 -0
  437. package/dist/engine/init/local-profile.d.ts.map +1 -0
  438. package/dist/engine/init/local-profile.js +295 -0
  439. package/dist/engine/init/local-profile.js.map +1 -0
  440. package/dist/engine/init/run-init.d.ts +41 -0
  441. package/dist/engine/init/run-init.d.ts.map +1 -0
  442. package/dist/engine/init/run-init.js +297 -0
  443. package/dist/engine/init/run-init.js.map +1 -0
  444. package/dist/engine/node/capabilities.d.ts +238 -0
  445. package/dist/engine/node/capabilities.d.ts.map +1 -0
  446. package/dist/engine/node/capabilities.js +316 -0
  447. package/dist/engine/node/capabilities.js.map +1 -0
  448. package/dist/engine/node/daemon.d.ts +63 -0
  449. package/dist/engine/node/daemon.d.ts.map +1 -0
  450. package/dist/engine/node/daemon.js +227 -0
  451. package/dist/engine/node/daemon.js.map +1 -0
  452. package/dist/engine/node/doctor.d.ts +58 -0
  453. package/dist/engine/node/doctor.d.ts.map +1 -0
  454. package/dist/engine/node/doctor.js +394 -0
  455. package/dist/engine/node/doctor.js.map +1 -0
  456. package/dist/engine/node/enrollment.d.ts +98 -0
  457. package/dist/engine/node/enrollment.d.ts.map +1 -0
  458. package/dist/engine/node/enrollment.js +189 -0
  459. package/dist/engine/node/enrollment.js.map +1 -0
  460. package/dist/engine/node/env-flags.d.ts +5 -0
  461. package/dist/engine/node/env-flags.d.ts.map +1 -0
  462. package/dist/engine/node/env-flags.js +22 -0
  463. package/dist/engine/node/env-flags.js.map +1 -0
  464. package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
  465. package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
  466. package/dist/engine/node/executors/credential-hygiene.js +189 -0
  467. package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
  468. package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
  469. package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
  470. package/dist/engine/node/executors/db-backup-run.js +362 -0
  471. package/dist/engine/node/executors/db-backup-run.js.map +1 -0
  472. package/dist/engine/node/executors/example-checksum.d.ts +30 -0
  473. package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
  474. package/dist/engine/node/executors/example-checksum.js +56 -0
  475. package/dist/engine/node/executors/example-checksum.js.map +1 -0
  476. package/dist/engine/node/executors/index.d.ts +168 -0
  477. package/dist/engine/node/executors/index.d.ts.map +1 -0
  478. package/dist/engine/node/executors/index.js +44 -0
  479. package/dist/engine/node/executors/index.js.map +1 -0
  480. package/dist/engine/node/executors/registry.d.ts +38 -0
  481. package/dist/engine/node/executors/registry.d.ts.map +1 -0
  482. package/dist/engine/node/executors/registry.js +92 -0
  483. package/dist/engine/node/executors/registry.js.map +1 -0
  484. package/dist/engine/node/heap-snapshot.d.ts +37 -0
  485. package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
  486. package/dist/engine/node/heap-snapshot.js +160 -0
  487. package/dist/engine/node/heap-snapshot.js.map +1 -0
  488. package/dist/engine/node/install-deps.d.ts +73 -0
  489. package/dist/engine/node/install-deps.d.ts.map +1 -0
  490. package/dist/engine/node/install-deps.js +150 -0
  491. package/dist/engine/node/install-deps.js.map +1 -0
  492. package/dist/engine/node/ipc-protocol.d.ts +67 -0
  493. package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
  494. package/dist/engine/node/ipc-protocol.js +83 -0
  495. package/dist/engine/node/ipc-protocol.js.map +1 -0
  496. package/dist/engine/node/lifecycle.d.ts +103 -0
  497. package/dist/engine/node/lifecycle.d.ts.map +1 -0
  498. package/dist/engine/node/lifecycle.js +259 -0
  499. package/dist/engine/node/lifecycle.js.map +1 -0
  500. package/dist/engine/node/logger.d.ts +82 -0
  501. package/dist/engine/node/logger.d.ts.map +1 -0
  502. package/dist/engine/node/logger.js +241 -0
  503. package/dist/engine/node/logger.js.map +1 -0
  504. package/dist/engine/node/memory-watchdog.d.ts +78 -0
  505. package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
  506. package/dist/engine/node/memory-watchdog.js +224 -0
  507. package/dist/engine/node/memory-watchdog.js.map +1 -0
  508. package/dist/engine/node/node-api.d.ts +391 -0
  509. package/dist/engine/node/node-api.d.ts.map +1 -0
  510. package/dist/engine/node/node-api.js +123 -0
  511. package/dist/engine/node/node-api.js.map +1 -0
  512. package/dist/engine/node/node-config.d.ts +128 -0
  513. package/dist/engine/node/node-config.d.ts.map +1 -0
  514. package/dist/engine/node/node-config.js +237 -0
  515. package/dist/engine/node/node-config.js.map +1 -0
  516. package/dist/engine/node/node-dashboard-source.d.ts +56 -0
  517. package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
  518. package/dist/engine/node/node-dashboard-source.js +213 -0
  519. package/dist/engine/node/node-dashboard-source.js.map +1 -0
  520. package/dist/engine/node/node-engine.d.ts +229 -0
  521. package/dist/engine/node/node-engine.d.ts.map +1 -0
  522. package/dist/engine/node/node-engine.js +723 -0
  523. package/dist/engine/node/node-engine.js.map +1 -0
  524. package/dist/engine/node/node-errors.d.ts +54 -0
  525. package/dist/engine/node/node-errors.d.ts.map +1 -0
  526. package/dist/engine/node/node-errors.js +71 -0
  527. package/dist/engine/node/node-errors.js.map +1 -0
  528. package/dist/engine/node/node-events.d.ts +132 -0
  529. package/dist/engine/node/node-events.d.ts.map +1 -0
  530. package/dist/engine/node/node-events.js +2 -0
  531. package/dist/engine/node/node-events.js.map +1 -0
  532. package/dist/engine/node/node-vitals.d.ts +123 -0
  533. package/dist/engine/node/node-vitals.d.ts.map +1 -0
  534. package/dist/engine/node/node-vitals.js +266 -0
  535. package/dist/engine/node/node-vitals.js.map +1 -0
  536. package/dist/engine/node/paths.d.ts +39 -0
  537. package/dist/engine/node/paths.d.ts.map +1 -0
  538. package/dist/engine/node/paths.js +60 -0
  539. package/dist/engine/node/paths.js.map +1 -0
  540. package/dist/engine/node/pg-dump.d.ts +126 -0
  541. package/dist/engine/node/pg-dump.d.ts.map +1 -0
  542. package/dist/engine/node/pg-dump.js +223 -0
  543. package/dist/engine/node/pg-dump.js.map +1 -0
  544. package/dist/engine/node/pidfile.d.ts +38 -0
  545. package/dist/engine/node/pidfile.d.ts.map +1 -0
  546. package/dist/engine/node/pidfile.js +156 -0
  547. package/dist/engine/node/pidfile.js.map +1 -0
  548. package/dist/engine/node/runtime-tuning.d.ts +65 -0
  549. package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
  550. package/dist/engine/node/runtime-tuning.js +198 -0
  551. package/dist/engine/node/runtime-tuning.js.map +1 -0
  552. package/dist/engine/node/service.d.ts +39 -0
  553. package/dist/engine/node/service.d.ts.map +1 -0
  554. package/dist/engine/node/service.js +211 -0
  555. package/dist/engine/node/service.js.map +1 -0
  556. package/dist/engine/node/start.d.ts +62 -0
  557. package/dist/engine/node/start.d.ts.map +1 -0
  558. package/dist/engine/node/start.js +245 -0
  559. package/dist/engine/node/start.js.map +1 -0
  560. package/dist/engine/node/worker-env-table.d.ts +15 -0
  561. package/dist/engine/node/worker-env-table.d.ts.map +1 -0
  562. package/dist/engine/node/worker-env-table.js +97 -0
  563. package/dist/engine/node/worker-env-table.js.map +1 -0
  564. package/dist/engine/node/worker-env.d.ts +50 -0
  565. package/dist/engine/node/worker-env.d.ts.map +1 -0
  566. package/dist/engine/node/worker-env.js +101 -0
  567. package/dist/engine/node/worker-env.js.map +1 -0
  568. package/dist/engine/output.d.ts +97 -0
  569. package/dist/engine/output.d.ts.map +1 -0
  570. package/dist/engine/output.js +274 -0
  571. package/dist/engine/output.js.map +1 -0
  572. package/dist/engine/package-info.d.ts +7 -0
  573. package/dist/engine/package-info.d.ts.map +1 -0
  574. package/dist/engine/package-info.js +38 -0
  575. package/dist/engine/package-info.js.map +1 -0
  576. package/dist/engine/program.d.ts +50 -0
  577. package/dist/engine/program.d.ts.map +1 -0
  578. package/dist/engine/program.js +197 -0
  579. package/dist/engine/program.js.map +1 -0
  580. package/dist/engine/prompt.d.ts +69 -0
  581. package/dist/engine/prompt.d.ts.map +1 -0
  582. package/dist/engine/prompt.js +205 -0
  583. package/dist/engine/prompt.js.map +1 -0
  584. package/dist/engine/registries.d.ts +5 -0
  585. package/dist/engine/registries.d.ts.map +1 -0
  586. package/dist/engine/registries.js +52 -0
  587. package/dist/engine/registries.js.map +1 -0
  588. package/dist/engine/request-body.d.ts +31 -0
  589. package/dist/engine/request-body.d.ts.map +1 -0
  590. package/dist/engine/request-body.js +156 -0
  591. package/dist/engine/request-body.js.map +1 -0
  592. package/dist/engine/test-support.d.ts +50 -0
  593. package/dist/engine/test-support.d.ts.map +1 -0
  594. package/dist/engine/test-support.js +86 -0
  595. package/dist/engine/test-support.js.map +1 -0
  596. package/dist/engine/tui/app.d.ts +3 -0
  597. package/dist/engine/tui/app.d.ts.map +1 -0
  598. package/dist/engine/tui/app.js +100 -0
  599. package/dist/engine/tui/app.js.map +1 -0
  600. package/dist/engine/tui/builtin-screens.d.ts +6 -0
  601. package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
  602. package/dist/engine/tui/builtin-screens.js +54 -0
  603. package/dist/engine/tui/builtin-screens.js.map +1 -0
  604. package/dist/engine/tui/index.d.ts +23 -0
  605. package/dist/engine/tui/index.d.ts.map +1 -0
  606. package/dist/engine/tui/index.js +71 -0
  607. package/dist/engine/tui/index.js.map +1 -0
  608. package/dist/engine/tui/layout.d.ts +132 -0
  609. package/dist/engine/tui/layout.d.ts.map +1 -0
  610. package/dist/engine/tui/layout.js +200 -0
  611. package/dist/engine/tui/layout.js.map +1 -0
  612. package/dist/engine/tui/routes.d.ts +5 -0
  613. package/dist/engine/tui/routes.d.ts.map +1 -0
  614. package/dist/engine/tui/routes.js +16 -0
  615. package/dist/engine/tui/routes.js.map +1 -0
  616. package/dist/engine/tui/screen-registry.d.ts +100 -0
  617. package/dist/engine/tui/screen-registry.d.ts.map +1 -0
  618. package/dist/engine/tui/screen-registry.js +96 -0
  619. package/dist/engine/tui/screen-registry.js.map +1 -0
  620. package/dist/engine/tui/screen-sections.d.ts +9 -0
  621. package/dist/engine/tui/screen-sections.d.ts.map +1 -0
  622. package/dist/engine/tui/screen-sections.js +45 -0
  623. package/dist/engine/tui/screen-sections.js.map +1 -0
  624. package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
  625. package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
  626. package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
  627. package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
  628. package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
  629. package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
  630. package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
  631. package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
  632. package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
  633. package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
  634. package/dist/engine/tui/screens/deploy/doctor.js +155 -0
  635. package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
  636. package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
  637. package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
  638. package/dist/engine/tui/screens/deploy/fields.js +202 -0
  639. package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
  640. package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
  641. package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
  642. package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
  643. package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
  644. package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
  645. package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
  646. package/dist/engine/tui/screens/deploy/index.js +83 -0
  647. package/dist/engine/tui/screens/deploy/index.js.map +1 -0
  648. package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
  649. package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
  650. package/dist/engine/tui/screens/deploy/install-model.js +319 -0
  651. package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
  652. package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
  653. package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
  654. package/dist/engine/tui/screens/deploy/install.js +361 -0
  655. package/dist/engine/tui/screens/deploy/install.js.map +1 -0
  656. package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
  657. package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
  658. package/dist/engine/tui/screens/deploy/model.js +59 -0
  659. package/dist/engine/tui/screens/deploy/model.js.map +1 -0
  660. package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
  661. package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
  662. package/dist/engine/tui/screens/deploy/run-model.js +117 -0
  663. package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
  664. package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
  665. package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
  666. package/dist/engine/tui/screens/deploy/run.js +201 -0
  667. package/dist/engine/tui/screens/deploy/run.js.map +1 -0
  668. package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
  669. package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
  670. package/dist/engine/tui/screens/deploy/status.js +107 -0
  671. package/dist/engine/tui/screens/deploy/status.js.map +1 -0
  672. package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
  673. package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
  674. package/dist/engine/tui/screens/deploy/update.js +175 -0
  675. package/dist/engine/tui/screens/deploy/update.js.map +1 -0
  676. package/dist/engine/tui/screens/deploy.d.ts +12 -0
  677. package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
  678. package/dist/engine/tui/screens/deploy.js +23 -0
  679. package/dist/engine/tui/screens/deploy.js.map +1 -0
  680. package/dist/engine/tui/screens/invoke.d.ts +6 -0
  681. package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
  682. package/dist/engine/tui/screens/invoke.js +193 -0
  683. package/dist/engine/tui/screens/invoke.js.map +1 -0
  684. package/dist/engine/tui/screens/login.d.ts +6 -0
  685. package/dist/engine/tui/screens/login.d.ts.map +1 -0
  686. package/dist/engine/tui/screens/login.js +255 -0
  687. package/dist/engine/tui/screens/login.js.map +1 -0
  688. package/dist/engine/tui/screens/logout.d.ts +6 -0
  689. package/dist/engine/tui/screens/logout.d.ts.map +1 -0
  690. package/dist/engine/tui/screens/logout.js +142 -0
  691. package/dist/engine/tui/screens/logout.js.map +1 -0
  692. package/dist/engine/tui/screens/menu.d.ts +22 -0
  693. package/dist/engine/tui/screens/menu.d.ts.map +1 -0
  694. package/dist/engine/tui/screens/menu.js +84 -0
  695. package/dist/engine/tui/screens/menu.js.map +1 -0
  696. package/dist/engine/tui/screens/node.d.ts +6 -0
  697. package/dist/engine/tui/screens/node.d.ts.map +1 -0
  698. package/dist/engine/tui/screens/node.js +228 -0
  699. package/dist/engine/tui/screens/node.js.map +1 -0
  700. package/dist/engine/tui/screens/status.d.ts +6 -0
  701. package/dist/engine/tui/screens/status.d.ts.map +1 -0
  702. package/dist/engine/tui/screens/status.js +134 -0
  703. package/dist/engine/tui/screens/status.js.map +1 -0
  704. package/dist/engine/tui/scroll-box.d.ts +27 -0
  705. package/dist/engine/tui/scroll-box.d.ts.map +1 -0
  706. package/dist/engine/tui/scroll-box.js +52 -0
  707. package/dist/engine/tui/scroll-box.js.map +1 -0
  708. package/dist/engine/tui/section-registry.d.ts +65 -0
  709. package/dist/engine/tui/section-registry.d.ts.map +1 -0
  710. package/dist/engine/tui/section-registry.js +90 -0
  711. package/dist/engine/tui/section-registry.js.map +1 -0
  712. package/dist/engine/tui/terminal.d.ts +31 -0
  713. package/dist/engine/tui/terminal.d.ts.map +1 -0
  714. package/dist/engine/tui/terminal.js +142 -0
  715. package/dist/engine/tui/terminal.js.map +1 -0
  716. package/dist/engine/tui/tty.d.ts +49 -0
  717. package/dist/engine/tui/tty.d.ts.map +1 -0
  718. package/dist/engine/tui/tty.js +139 -0
  719. package/dist/engine/tui/tty.js.map +1 -0
  720. package/dist/index.d.ts +10 -0
  721. package/dist/index.d.ts.map +1 -0
  722. package/dist/index.js +11 -0
  723. package/dist/index.js.map +1 -0
  724. package/dist/node/index.d.ts +3 -0
  725. package/dist/node/index.d.ts.map +1 -0
  726. package/dist/node/index.js +5 -0
  727. package/dist/node/index.js.map +1 -0
  728. package/dist/telemetry/env-fragment.d.ts +47 -0
  729. package/dist/telemetry/env-fragment.d.ts.map +1 -0
  730. package/dist/telemetry/env-fragment.js +73 -0
  731. package/dist/telemetry/env-fragment.js.map +1 -0
  732. package/dist/telemetry/index.d.ts +7 -0
  733. package/dist/telemetry/index.d.ts.map +1 -0
  734. package/dist/telemetry/index.js +7 -0
  735. package/dist/telemetry/index.js.map +1 -0
  736. package/dist/telemetry/node-span-relay.d.ts +107 -0
  737. package/dist/telemetry/node-span-relay.d.ts.map +1 -0
  738. package/dist/telemetry/node-span-relay.js +314 -0
  739. package/dist/telemetry/node-span-relay.js.map +1 -0
  740. package/dist/telemetry/node-span.d.ts +92 -0
  741. package/dist/telemetry/node-span.d.ts.map +1 -0
  742. package/dist/telemetry/node-span.js +28 -0
  743. package/dist/telemetry/node-span.js.map +1 -0
  744. package/dist/testing/index.d.ts +3 -0
  745. package/dist/testing/index.d.ts.map +1 -0
  746. package/dist/testing/index.js +4 -0
  747. package/dist/testing/index.js.map +1 -0
  748. package/dist/tui/index.d.ts +3 -0
  749. package/dist/tui/index.d.ts.map +1 -0
  750. package/dist/tui/index.js +5 -0
  751. package/dist/tui/index.js.map +1 -0
  752. package/package.json +102 -4
@@ -0,0 +1,73 @@
1
+ /**
2
+ * The env-spec fragment for the telemetry stack: the PostgreSQL monitor login,
3
+ * the OpenTelemetry exporter settings and the GreptimeDB store.
4
+ *
5
+ * Register it once with `registerEnvSpecFragment(telemetryEnvSpecFragment)`.
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * registerEnvSpecFragment(telemetryEnvSpecFragment); // the reference CLI: platform-host/register.ts
10
+ * ```
11
+ *
12
+ * @extensionPoint option
13
+ * @stability experimental
14
+ */
15
+ export const telemetryEnvSpecFragment = {
16
+ id: 'telemetry',
17
+ metadata: {
18
+ // The telemetry collector's PostgreSQL login (issue #598), a pg_monitor role
19
+ // that must already exist on the server - so never generated, only asked.
20
+ // Asked as a PAIR (both `essential`) because a password asked on its own
21
+ // would be paired with POSTGRES_USER, which it does not belong to. Blank is
22
+ // a real answer for both: telemetry.compose.yml then falls back to the
23
+ // API's own POSTGRES_USER / POSTGRES_PASSWORD, which works on any server
24
+ // without a new role. `allowBlank` is what keeps that blank from failing an
25
+ // unattended install, and from failing `deploy update` on a deployment
26
+ // written before these keys existed.
27
+ POSTGRES_MONITOR_USER: { group: 'observability', essential: true, allowBlank: true },
28
+ POSTGRES_MONITOR_PASSWORD: {
29
+ group: 'observability',
30
+ essential: true,
31
+ secret: true,
32
+ allowBlank: true,
33
+ },
34
+ OTEL_ENABLED: { group: 'observability' },
35
+ OTEL_EXPORTER_OTLP_ENDPOINT: { group: 'observability' },
36
+ OTEL_SERVICE_NAME: { group: 'observability' },
37
+ // GreptimeDB telemetry store (telemetry.compose.yml). Three accounts with
38
+ // three privileges: the collector writes, the explorer / AI assistant / BI
39
+ // tools read, and only the retention (TTL) setting uses the admin account.
40
+ //
41
+ // The passwords are generated, never asked (#567), and as hex: they are
42
+ // embedded in GreptimeDB's `user=password,...` provider string, so `,`, `=`
43
+ // and `:` must never appear in them.
44
+ GREPTIME_HOST: { group: 'observability' },
45
+ GREPTIME_HTTP_PORT: { group: 'observability' },
46
+ GREPTIME_PG_PORT: { group: 'observability' },
47
+ // Loopback host port vps.telemetry.compose.yml publishes the PG protocol on.
48
+ GREPTIME_BIND_PG_PORT: { group: 'observability' },
49
+ GREPTIME_DB: { group: 'observability' },
50
+ GREPTIME_WRITER_USER: { group: 'observability' },
51
+ GREPTIME_WRITER_PASSWORD: {
52
+ group: 'observability',
53
+ secret: true,
54
+ generate: 'hex-32',
55
+ autoGenerate: true,
56
+ },
57
+ GREPTIME_READER_USER: { group: 'observability' },
58
+ GREPTIME_READER_PASSWORD: {
59
+ group: 'observability',
60
+ secret: true,
61
+ generate: 'hex-32',
62
+ autoGenerate: true,
63
+ },
64
+ GREPTIME_ADMIN_USER: { group: 'observability' },
65
+ GREPTIME_ADMIN_PASSWORD: {
66
+ group: 'observability',
67
+ secret: true,
68
+ generate: 'hex-32',
69
+ autoGenerate: true,
70
+ },
71
+ },
72
+ };
73
+ //# sourceMappingURL=env-fragment.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env-fragment.js","sourceRoot":"","sources":["../../src/telemetry/env-fragment.ts"],"names":[],"mappings":"AA6CA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA6B;IAChE,EAAE,EAAE,WAAW;IACf,QAAQ,EAAE;QACR,6EAA6E;QAC7E,0EAA0E;QAC1E,yEAAyE;QACzE,4EAA4E;QAC5E,uEAAuE;QACvE,yEAAyE;QACzE,4EAA4E;QAC5E,uEAAuE;QACvE,qCAAqC;QACrC,qBAAqB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;QACpF,yBAAyB,EAAE;YACzB,KAAK,EAAE,eAAe;YACtB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,IAAI;SACjB;QAED,YAAY,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QACxC,2BAA2B,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QACvD,iBAAiB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QAE7C,0EAA0E;QAC1E,2EAA2E;QAC3E,2EAA2E;QAC3E,EAAE;QACF,wEAAwE;QACxE,4EAA4E;QAC5E,qCAAqC;QACrC,aAAa,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QACzC,kBAAkB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QAC9C,gBAAgB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QAC5C,6EAA6E;QAC7E,qBAAqB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QACjD,WAAW,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QACvC,oBAAoB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QAChD,wBAAwB,EAAE;YACxB,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,QAAQ;YAClB,YAAY,EAAE,IAAI;SACnB;QACD,oBAAoB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QAChD,wBAAwB,EAAE;YACxB,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,QAAQ;YAClB,YAAY,EAAE,IAAI;SACnB;QACD,mBAAmB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QAC/C,uBAAuB,EAAE;YACvB,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,QAAQ;YAClB,YAAY,EAAE,IAAI;SACnB;KACF;CACF,CAAC"}
@@ -0,0 +1,7 @@
1
+ export { DEFAULT_MAX_QUEUED_SPANS, JobSpanRecorder, MAX_SPANS_PER_BATCH, NodeSpanRelay, errorTypeOf, } from './node-span-relay.js';
2
+ export type { NodeSpanRelayOptions } from './node-span-relay.js';
3
+ export { NODE_APP_SPAN_NAME_PATTERN, isNodeSpanName } from './node-span.js';
4
+ export type { BuiltinNodeSpanName, NodeSpan, NodeSpanAttributes, NodeSpanName, NodeSpanSink } from './node-span.js';
5
+ export { telemetryEnvSpecFragment } from './env-fragment.js';
6
+ export type { TelemetryEnvGroup, TelemetryEnvSpecFragment, TelemetryEnvVarMetadata } from './env-fragment.js';
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpH,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}
@@ -0,0 +1,7 @@
1
+ // `@marinoscar/platform-cli/telemetry`: the worker node's job-phase span relay
2
+ // and the telemetry stack's env-key metadata (PP-4.5, #706). #707 completes
3
+ // the slice.
4
+ export { DEFAULT_MAX_QUEUED_SPANS, JobSpanRecorder, MAX_SPANS_PER_BATCH, NodeSpanRelay, errorTypeOf, } from './node-span-relay.js';
5
+ export { NODE_APP_SPAN_NAME_PATTERN, isNodeSpanName } from './node-span.js';
6
+ export { telemetryEnvSpecFragment } from './env-fragment.js';
7
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4EAA4E;AAC5E,aAAa;AAEb,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC"}
@@ -0,0 +1,107 @@
1
+ import { type NodeSpan, type NodeSpanAttributes, type NodeSpanName, type NodeSpanSink } from './node-span.js';
2
+ /**
3
+ * Spans the server accepts per request. Mirrors `MAX_NODE_SPANS_PER_REQUEST`.
4
+ *
5
+ * @stability experimental
6
+ */
7
+ export declare const MAX_SPANS_PER_BATCH = 50;
8
+ /**
9
+ * Spans held while waiting to send. Past this the OLDEST are dropped.
10
+ *
11
+ * @stability experimental
12
+ */
13
+ export declare const DEFAULT_MAX_QUEUED_SPANS = 500;
14
+ /**
15
+ * An identifier-shaped error type for `error`: its class name, plus an HTTP
16
+ * status (`ApiError.409`) or a string `code` (`Error.ECONNRESET`). Never its
17
+ * message. Characters outside `[A-Za-z0-9_.-]` are replaced, and the result
18
+ * is capped at 64. Never throws.
19
+ *
20
+ * An error with a numeric `status` is an HTTP failure: the status wins over
21
+ * any `code` it also carries (the reference CLI's `ApiError` has both, and its
22
+ * `code` is the server's, not a system errno).
23
+ *
24
+ * @param error - Anything thrown.
25
+ * @returns An identifier such as `ApiError.409` or `Error.ECONNREFUSED`.
26
+ * @stability experimental
27
+ */
28
+ export declare function errorTypeOf(error: unknown): string;
29
+ /**
30
+ * The spans of ONE job, recorded as it runs. Every method is synchronous and
31
+ * swallows its own faults: recording must never be the reason a job failed.
32
+ *
33
+ * @stability experimental
34
+ */
35
+ export declare class JobSpanRecorder {
36
+ readonly jobId: string;
37
+ private readonly now;
38
+ private readonly spans;
39
+ /**
40
+ * @param jobId - The job every recorded span belongs to.
41
+ * @param now - The clock, Unix epoch milliseconds. Defaults to `Date.now`.
42
+ */
43
+ constructor(jobId: string, now?: () => number);
44
+ /**
45
+ * Times `work` as phase `name`, recording `ok` or `error`, and returns (or
46
+ * rethrows) exactly what `work` did. `attributes` may be a function of the
47
+ * result, for a phase whose byte count is only known at the end.
48
+ */
49
+ phase<T>(name: NodeSpanName, work: () => Promise<T>, attributes?: NodeSpanAttributes | ((result: T) => NodeSpanAttributes | undefined)): Promise<T>;
50
+ /** Records a phase that has already happened. Never throws. */
51
+ record(name: NodeSpanName, startTimeUnixMs: number, status: 'ok' | 'error', errorType?: string, attributes?: NodeSpanAttributes): void;
52
+ /** Everything recorded so far, in order. */
53
+ drain(): NodeSpan[];
54
+ }
55
+ /**
56
+ * Options for {@link NodeSpanRelay}.
57
+ *
58
+ * @stability experimental
59
+ */
60
+ export interface NodeSpanRelayOptions {
61
+ /** The app's API client, or anything with its optional `telemetry` method. */
62
+ api: NodeSpanSink;
63
+ /** The node the spans are relayed for. */
64
+ nodeId: string;
65
+ /** Spans held while waiting to send. Defaults to `DEFAULT_MAX_QUEUED_SPANS`. */
66
+ maxQueuedSpans?: number | undefined;
67
+ /** Called ONCE, when a 404 disables the relay for this process. */
68
+ onDisabled?: ((reason: string) => void) | undefined;
69
+ }
70
+ /**
71
+ * The bounded, best-effort sender. One send in flight at a time; batches of at
72
+ * most `MAX_SPANS_PER_BATCH`; the oldest spans dropped when the queue is full.
73
+ *
74
+ * @example
75
+ * ```ts
76
+ * const relay = new NodeSpanRelay({ api: client, nodeId });
77
+ * const spans = new JobSpanRecorder(job.id);
78
+ * await spans.phase('job.execute', () => run(job));
79
+ * relay.enqueue(spans.drain()); // after the job settled; never awaited on its path
80
+ * ```
81
+ *
82
+ * @extensionPoint hook
83
+ * @stability experimental
84
+ */
85
+ export declare class NodeSpanRelay {
86
+ private readonly api;
87
+ private readonly nodeId;
88
+ private readonly maxQueuedSpans;
89
+ private readonly onDisabled;
90
+ private readonly queue;
91
+ private pumping;
92
+ private disabled;
93
+ /** Spans discarded because the queue was full. For tests and diagnostics. */
94
+ droppedForCapacity: number;
95
+ /** @param options - The client, the node id and the queue bound. */
96
+ constructor(options: NodeSpanRelayOptions);
97
+ /** False once the relay is off: no `telemetry` method, or a 404 seen. */
98
+ get enabled(): boolean;
99
+ /** Spans waiting to be sent. */
100
+ get queued(): number;
101
+ /** Queues `spans` and starts sending if idle. Never throws, never awaits. */
102
+ enqueue(spans: NodeSpan[]): void;
103
+ /** Resolves once the queue is empty (or the relay disabled). Never rejects. */
104
+ flush(): Promise<void>;
105
+ private pump;
106
+ }
107
+ //# sourceMappingURL=node-span-relay.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-span-relay.d.ts","sourceRoot":"","sources":["../../src/telemetry/node-span-relay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA+C9H;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAsB5C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAwBlD;AAmCD;;;;;GAKG;AACH,qBAAa,eAAe;IAQxB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IARtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IAExC;;;OAGG;gBAEQ,KAAK,EAAE,MAAM,EACL,GAAG,GAAE,MAAM,MAAiB;IAG/C;;;;OAIG;IACG,KAAK,CAAC,CAAC,EACX,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,UAAU,CAAC,EAAE,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,kBAAkB,GAAG,SAAS,CAAC,GAChF,OAAO,CAAC,CAAC,CAAC;IAmBb,+DAA+D;IAC/D,MAAM,CACJ,IAAI,EAAE,YAAY,EAClB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,IAAI,GAAG,OAAO,EACtB,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,kBAAkB,GAC9B,IAAI;IAoBP,4CAA4C;IAC5C,KAAK,IAAI,QAAQ,EAAE;CAGpB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,GAAG,EAAE,YAAY,CAAC;IAClB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,mEAAmE;IACnE,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACrD;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyC;IACpE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,QAAQ,CAAU;IAE1B,6EAA6E;IAC7E,kBAAkB,SAAK;IAEvB,oEAAoE;gBACxD,OAAO,EAAE,oBAAoB;IAUzC,yEAAyE;IACzE,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,gCAAgC;IAChC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,6EAA6E;IAC7E,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAehC,+EAA+E;IACzE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAMd,IAAI;CAsBnB"}
@@ -0,0 +1,314 @@
1
+ import { isNodeSpanName } from './node-span.js';
2
+ // =============================================================================
3
+ // Job phase spans, recorded here and relayed to the server (issue #608)
4
+ // =============================================================================
5
+ // Moved from the reference CLI's `node/node-span-relay.ts` by PP-4.5 (#706).
6
+ // It reads an HTTP status STRUCTURALLY (a numeric `status` on the error), so it
7
+ // needs no app error class: the app's `ApiError` classifies exactly as before.
8
+ //
9
+ // A worker records WHEN each phase of a job ran (download, execute, upload,
10
+ // submit, secret) and hands those timings to `POST /api/nodes/:id/telemetry`.
11
+ // The server re-emits them as OpenTelemetry spans under the job's enqueuing
12
+ // trace. The node never talks to a collector, holds no exporter endpoint, and
13
+ // takes no new dependency: a span here is five numbers and a name.
14
+ //
15
+ // ⚠ TELEMETRY NEVER DELAYS OR FAILS A JOB. Recording is synchronous
16
+ // arithmetic that cannot throw into the job; SENDING happens after the job has
17
+ // settled, off the job's promise, through a bounded queue. Every failure of
18
+ // the relay is swallowed:
19
+ //
20
+ // - 404: the server predates the relay (or forgot this node). Span sending
21
+ // is DISABLED for the rest of the process and announced once — retrying a
22
+ // route that does not exist on every job would be a steady trickle of
23
+ // pointless requests.
24
+ // - 400 / 403 / 429 / anything else: this batch is dropped, silently. A 400
25
+ // is a contract mismatch no retry fixes; a 429 is the server asking for
26
+ // less, and resending is the opposite.
27
+ //
28
+ // ⚠ NO MESSAGE EVER LEAVES AS A SPAN. An errored phase carries `errorType` —
29
+ // the error's class name, plus an HTTP status or an errno-style code when
30
+ // there is one — sanitised to the server's identifier-only shape. Messages
31
+ // carry paths, hosts and signed URLs; the server would refuse them anyway,
32
+ // and this side does not offer.
33
+ //
34
+ // ⚠ BOUNDED, ALLOWLISTED ATTRIBUTES. `bytes`, `attempt`, `exitCode` and
35
+ // `httpStatus`, each range-checked, plus an executor's own attributes: a
36
+ // non-negative integer or a short TOKEN-SHAPED string under a key of the
37
+ // server's key shape, at most 16 in all (`cleanAttributes`). Anything else, and
38
+ // any value the server would refuse, is dropped before it is queued. A string
39
+ // cannot hold a space, slash, colon or quote, so no URL, path, message or
40
+ // credential rides along in one.
41
+ //
42
+ // ⚠ AN EXECUTOR'S SPAN NAME is `job.app.<name>` or it is dropped here
43
+ // (`isNodeSpanName`): a malformed name is never queued, so it cannot cost the
44
+ // rest of a batch even on an older server that refuses the whole body.
45
+ // =============================================================================
46
+ /**
47
+ * Spans the server accepts per request. Mirrors `MAX_NODE_SPANS_PER_REQUEST`.
48
+ *
49
+ * @stability experimental
50
+ */
51
+ export const MAX_SPANS_PER_BATCH = 50;
52
+ /**
53
+ * Spans held while waiting to send. Past this the OLDEST are dropped.
54
+ *
55
+ * @stability experimental
56
+ */
57
+ export const DEFAULT_MAX_QUEUED_SPANS = 500;
58
+ /** Mirrors the server's `NODE_SPAN_ERROR_TYPE_PATTERN` and length cap. */
59
+ const ERROR_TYPE_MAX_LENGTH = 64;
60
+ /** The server's `durationMs` ceiling (one day). */
61
+ const MAX_DURATION_MS = 24 * 60 * 60 * 1000;
62
+ /**
63
+ * The HTTP status an error carries, read structurally: a numeric `status`
64
+ * property, as the reference CLI's `ApiError` has. `undefined` otherwise.
65
+ */
66
+ function httpStatusOf(error) {
67
+ if (typeof error !== 'object' || error === null)
68
+ return undefined;
69
+ const status = error.status;
70
+ return typeof status === 'number' ? status : undefined;
71
+ }
72
+ function errorClassName(error) {
73
+ return error.name && error.name !== 'Error' ? error.name : error.constructor?.name || 'Error';
74
+ }
75
+ /**
76
+ * An identifier-shaped error type for `error`: its class name, plus an HTTP
77
+ * status (`ApiError.409`) or a string `code` (`Error.ECONNRESET`). Never its
78
+ * message. Characters outside `[A-Za-z0-9_.-]` are replaced, and the result
79
+ * is capped at 64. Never throws.
80
+ *
81
+ * An error with a numeric `status` is an HTTP failure: the status wins over
82
+ * any `code` it also carries (the reference CLI's `ApiError` has both, and its
83
+ * `code` is the server's, not a system errno).
84
+ *
85
+ * @param error - Anything thrown.
86
+ * @returns An identifier such as `ApiError.409` or `Error.ECONNREFUSED`.
87
+ * @stability experimental
88
+ */
89
+ export function errorTypeOf(error) {
90
+ try {
91
+ let name = 'Error';
92
+ let suffix;
93
+ if (error instanceof Error) {
94
+ name = errorClassName(error);
95
+ const status = httpStatusOf(error);
96
+ if (status !== undefined) {
97
+ suffix = String(status);
98
+ }
99
+ else {
100
+ const code = error.code;
101
+ if (typeof code === 'string' || typeof code === 'number')
102
+ suffix = String(code);
103
+ }
104
+ }
105
+ else {
106
+ name = typeof error;
107
+ }
108
+ const raw = suffix === undefined ? name : `${name}.${suffix}`;
109
+ const clean = raw.replace(/[^A-Za-z0-9_.-]/g, '_').slice(0, ERROR_TYPE_MAX_LENGTH);
110
+ return clean.length > 0 ? clean : 'Error';
111
+ }
112
+ catch {
113
+ return 'Error';
114
+ }
115
+ }
116
+ /** Mirrors the server's `NODE_SPAN_ATTRIBUTE_KEY_PATTERN`. */
117
+ const APP_ATTRIBUTE_KEY_PATTERN = /^[a-z][A-Za-z0-9]{1,31}$/;
118
+ /** Mirrors the server's `NODE_SPAN_ATTRIBUTE_STRING_PATTERN` and its 128-character ceiling. */
119
+ const APP_ATTRIBUTE_STRING_PATTERN = /^[A-Za-z0-9_.+-]{1,128}$/;
120
+ /** Mirrors the server's `MAX_NODE_SPAN_ATTRIBUTES`. */
121
+ const MAX_ATTRIBUTES = 16;
122
+ const BUILTIN_ATTRIBUTE_KEYS = ['bytes', 'attempt', 'exitCode', 'httpStatus'];
123
+ /**
124
+ * Keeps only what the server will take: the four built-in integers in range,
125
+ * and app attributes under a valid key as a non-negative safe integer or a
126
+ * token-shaped string, at most 16 in all. Never throws.
127
+ */
128
+ function cleanAttributes(attributes) {
129
+ if (attributes === undefined || attributes === null || typeof attributes !== 'object')
130
+ return undefined;
131
+ const out = {};
132
+ const { bytes, attempt, exitCode, httpStatus } = attributes;
133
+ if (Number.isSafeInteger(bytes) && bytes >= 0)
134
+ out.bytes = bytes;
135
+ if (Number.isSafeInteger(attempt) && attempt >= 0 && attempt <= 10_000)
136
+ out.attempt = attempt;
137
+ if (Number.isSafeInteger(exitCode) && Math.abs(exitCode) <= 1024)
138
+ out.exitCode = exitCode;
139
+ if (Number.isSafeInteger(httpStatus) && httpStatus >= 100 && httpStatus <= 599)
140
+ out.httpStatus = httpStatus;
141
+ for (const key of Object.keys(attributes)) {
142
+ if (Object.keys(out).length >= MAX_ATTRIBUTES)
143
+ break;
144
+ if (BUILTIN_ATTRIBUTE_KEYS.includes(key) || !APP_ATTRIBUTE_KEY_PATTERN.test(key))
145
+ continue;
146
+ const value = attributes[key];
147
+ if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0)
148
+ out[key] = value;
149
+ else if (typeof value === 'string' && APP_ATTRIBUTE_STRING_PATTERN.test(value))
150
+ out[key] = value;
151
+ }
152
+ return Object.keys(out).length > 0 ? out : undefined;
153
+ }
154
+ /**
155
+ * The spans of ONE job, recorded as it runs. Every method is synchronous and
156
+ * swallows its own faults: recording must never be the reason a job failed.
157
+ *
158
+ * @stability experimental
159
+ */
160
+ export class JobSpanRecorder {
161
+ jobId;
162
+ now;
163
+ spans = [];
164
+ /**
165
+ * @param jobId - The job every recorded span belongs to.
166
+ * @param now - The clock, Unix epoch milliseconds. Defaults to `Date.now`.
167
+ */
168
+ constructor(jobId, now = Date.now) {
169
+ this.jobId = jobId;
170
+ this.now = now;
171
+ }
172
+ /**
173
+ * Times `work` as phase `name`, recording `ok` or `error`, and returns (or
174
+ * rethrows) exactly what `work` did. `attributes` may be a function of the
175
+ * result, for a phase whose byte count is only known at the end.
176
+ */
177
+ async phase(name, work, attributes) {
178
+ const start = this.now();
179
+ let result;
180
+ try {
181
+ result = await work();
182
+ }
183
+ catch (error) {
184
+ this.record(name, start, 'error', errorTypeOf(error), typeof attributes === 'function' ? undefined : attributes);
185
+ throw error;
186
+ }
187
+ let resolved;
188
+ try {
189
+ resolved = typeof attributes === 'function' ? attributes(result) : attributes;
190
+ }
191
+ catch {
192
+ resolved = undefined;
193
+ }
194
+ this.record(name, start, 'ok', undefined, resolved);
195
+ return result;
196
+ }
197
+ /** Records a phase that has already happened. Never throws. */
198
+ record(name, startTimeUnixMs, status, errorType, attributes) {
199
+ try {
200
+ // A name the server would not take is never queued (see the header).
201
+ if (!isNodeSpanName(name))
202
+ return;
203
+ const durationMs = Math.min(MAX_DURATION_MS, Math.max(0, Math.round(this.now() - startTimeUnixMs)));
204
+ const clean = cleanAttributes(attributes);
205
+ this.spans.push({
206
+ jobId: this.jobId,
207
+ name,
208
+ startTimeUnixMs: Math.round(startTimeUnixMs),
209
+ durationMs,
210
+ status,
211
+ ...(status === 'error' && errorType !== undefined ? { errorType } : {}),
212
+ ...(clean !== undefined ? { attributes: clean } : {}),
213
+ });
214
+ }
215
+ catch {
216
+ // Best-effort; see the header.
217
+ }
218
+ }
219
+ /** Everything recorded so far, in order. */
220
+ drain() {
221
+ return this.spans.splice(0, this.spans.length);
222
+ }
223
+ }
224
+ /**
225
+ * The bounded, best-effort sender. One send in flight at a time; batches of at
226
+ * most `MAX_SPANS_PER_BATCH`; the oldest spans dropped when the queue is full.
227
+ *
228
+ * @example
229
+ * ```ts
230
+ * const relay = new NodeSpanRelay({ api: client, nodeId });
231
+ * const spans = new JobSpanRecorder(job.id);
232
+ * await spans.phase('job.execute', () => run(job));
233
+ * relay.enqueue(spans.drain()); // after the job settled; never awaited on its path
234
+ * ```
235
+ *
236
+ * @extensionPoint hook
237
+ * @stability experimental
238
+ */
239
+ export class NodeSpanRelay {
240
+ api;
241
+ nodeId;
242
+ maxQueuedSpans;
243
+ onDisabled;
244
+ queue = [];
245
+ pumping;
246
+ disabled;
247
+ /** Spans discarded because the queue was full. For tests and diagnostics. */
248
+ droppedForCapacity = 0;
249
+ /** @param options - The client, the node id and the queue bound. */
250
+ constructor(options) {
251
+ this.api = options.api;
252
+ this.nodeId = options.nodeId;
253
+ this.maxQueuedSpans = Math.max(1, options.maxQueuedSpans ?? DEFAULT_MAX_QUEUED_SPANS);
254
+ this.onDisabled = options.onDisabled;
255
+ // A client without the method (a test fake, an embedding that opted
256
+ // out) is simply a relay that is off.
257
+ this.disabled = typeof this.api.telemetry !== 'function';
258
+ }
259
+ /** False once the relay is off: no `telemetry` method, or a 404 seen. */
260
+ get enabled() {
261
+ return !this.disabled;
262
+ }
263
+ /** Spans waiting to be sent. */
264
+ get queued() {
265
+ return this.queue.length;
266
+ }
267
+ /** Queues `spans` and starts sending if idle. Never throws, never awaits. */
268
+ enqueue(spans) {
269
+ if (this.disabled || spans.length === 0)
270
+ return;
271
+ this.queue.push(...spans);
272
+ const overflow = this.queue.length - this.maxQueuedSpans;
273
+ if (overflow > 0) {
274
+ this.queue.splice(0, overflow);
275
+ this.droppedForCapacity += overflow;
276
+ }
277
+ if (this.pumping === undefined) {
278
+ this.pumping = this.pump().finally(() => {
279
+ this.pumping = undefined;
280
+ });
281
+ }
282
+ }
283
+ /** Resolves once the queue is empty (or the relay disabled). Never rejects. */
284
+ async flush() {
285
+ while (this.pumping !== undefined) {
286
+ await this.pumping;
287
+ }
288
+ }
289
+ async pump() {
290
+ while (!this.disabled && this.queue.length > 0) {
291
+ const batch = this.queue.splice(0, MAX_SPANS_PER_BATCH);
292
+ try {
293
+ await this.api.telemetry(this.nodeId, { spans: batch });
294
+ }
295
+ catch (error) {
296
+ const status = httpStatusOf(error);
297
+ if (status === 404) {
298
+ this.disabled = true;
299
+ this.queue.length = 0;
300
+ const serverMessage = error.serverMessage;
301
+ try {
302
+ this.onDisabled?.(`${status}: ${typeof serverMessage === 'string' ? serverMessage : 'Not Found'}`);
303
+ }
304
+ catch {
305
+ // An observer must not break the relay.
306
+ }
307
+ return;
308
+ }
309
+ // Any other failure: this batch is gone. See the header.
310
+ }
311
+ }
312
+ }
313
+ }
314
+ //# sourceMappingURL=node-span-relay.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-span-relay.js","sourceRoot":"","sources":["../../src/telemetry/node-span-relay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAgF,MAAM,gBAAgB,CAAC;AAE9H,gFAAgF;AAChF,yEAAyE;AACzE,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,+EAA+E;AAC/E,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,mEAAmE;AACnE,EAAE;AACF,oEAAoE;AACpE,+EAA+E;AAC/E,4EAA4E;AAC5E,0BAA0B;AAC1B,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,0EAA0E;AAC1E,0BAA0B;AAC1B,8EAA8E;AAC9E,4EAA4E;AAC5E,2CAA2C;AAC3C,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,2EAA2E;AAC3E,2EAA2E;AAC3E,gCAAgC;AAChC,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,yEAAyE;AACzE,gFAAgF;AAChF,8EAA8E;AAC9E,0EAA0E;AAC1E,iCAAiC;AACjC,EAAE;AACF,sEAAsE;AACtE,8EAA8E;AAC9E,uEAAuE;AACvE,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,0EAA0E;AAC1E,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC,mDAAmD;AACnD,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE5C;;;GAGG;AACH,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,MAAM,GAAI,KAA8B,CAAC,MAAM,CAAC;IACtD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,SAAS,cAAc,CAAC,KAAY;IAClC,OAAO,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,IAAI,OAAO,CAAC;AAChG,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,CAAC;QACH,IAAI,IAAI,GAAG,OAAO,CAAC;QACnB,IAAI,MAA0B,CAAC;QAE/B,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YAC7B,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;gBAChD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ;oBAAE,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,OAAO,KAAK,CAAC;QACtB,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;QACnF,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,MAAM,yBAAyB,GAAG,0BAA0B,CAAC;AAC7D,+FAA+F;AAC/F,MAAM,4BAA4B,GAAG,0BAA0B,CAAC;AAChE,uDAAuD;AACvD,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;AAE9E;;;;GAIG;AACH,SAAS,eAAe,CAAC,UAA0C;IACjE,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACxG,MAAM,GAAG,GAAuB,EAAE,CAAC;IACnC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC;IAC5D,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAK,KAAgB,IAAI,CAAC;QAAE,GAAG,CAAC,KAAK,GAAG,KAAe,CAAC;IACvF,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAK,OAAkB,IAAI,CAAC,IAAK,OAAkB,IAAI,MAAM;QAAE,GAAG,CAAC,OAAO,GAAG,OAAiB,CAAC;IAChI,IAAI,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAkB,CAAC,IAAI,IAAI;QAAE,GAAG,CAAC,QAAQ,GAAG,QAAkB,CAAC;IAC9G,IAAI,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,IAAK,UAAqB,IAAI,GAAG,IAAK,UAAqB,IAAI,GAAG;QAAE,GAAG,CAAC,UAAU,GAAG,UAAoB,CAAC;IAE9I,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,cAAc;YAAE,MAAM;QACrD,IAAI,sBAAsB,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QAC3F,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;aACxF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnG,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAQf;IACQ;IARF,KAAK,GAAe,EAAE,CAAC;IAExC;;;OAGG;IACH,YACW,KAAa,EACL,MAAoB,IAAI,CAAC,GAAG;QADpC,UAAK,GAAL,KAAK,CAAQ;QACL,QAAG,GAAH,GAAG,CAAyB;IAC5C,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,KAAK,CACT,IAAkB,EAClB,IAAsB,EACtB,UAAiF;QAEjF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,MAAS,CAAC;QACd,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YACjH,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,QAAwC,CAAC;QAC7C,IAAI,CAAC;YACH,QAAQ,GAAG,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QAChF,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,SAAS,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,+DAA+D;IAC/D,MAAM,CACJ,IAAkB,EAClB,eAAuB,EACvB,MAAsB,EACtB,SAAkB,EAClB,UAA+B;QAE/B,IAAI,CAAC;YACH,qEAAqE;YACrE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;gBAAE,OAAO;YAClC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;YACpG,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBACd,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,IAAI;gBACJ,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;gBAC5C,UAAU;gBACV,MAAM;gBACN,GAAG,CAAC,MAAM,KAAK,OAAO,IAAI,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtD,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,KAAK;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;CACF;AAkBD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,aAAa;IACP,GAAG,CAAe;IAClB,MAAM,CAAS;IACf,cAAc,CAAS;IACvB,UAAU,CAAyC;IACnD,KAAK,GAAe,EAAE,CAAC;IAChC,OAAO,CAA4B;IACnC,QAAQ,CAAU;IAE1B,6EAA6E;IAC7E,kBAAkB,GAAG,CAAC,CAAC;IAEvB,oEAAoE;IACpE,YAAY,OAA6B;QACvC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC,CAAC;QACtF,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,oEAAoE;QACpE,sCAAsC;QACtC,IAAI,CAAC,QAAQ,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,KAAK,UAAU,CAAC;IAC3D,CAAC;IAED,yEAAyE;IACzE,IAAI,OAAO;QACT,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;IACxB,CAAC;IAED,gCAAgC;IAChC,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,6EAA6E;IAC7E,OAAO,CAAC,KAAiB;QACvB,IAAI,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC;QACzD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC/B,IAAI,CAAC,kBAAkB,IAAI,QAAQ,CAAC;QACtC,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;gBACtC,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YAC3B,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,IAAI,CAAC,OAAO,CAAC;QACrB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;YACxD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,GAAG,CAAC,SAAU,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;gBACnC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;oBACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;oBACrB,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;oBACtB,MAAM,aAAa,GAAI,KAAqC,CAAC,aAAa,CAAC;oBAC3E,IAAI,CAAC;wBACH,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,MAAM,KAAK,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;oBACrG,CAAC;oBAAC,MAAM,CAAC;wBACP,wCAAwC;oBAC1C,CAAC;oBACD,OAAO;gBACT,CAAC;gBACD,yDAAyD;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;CACF"}
@@ -0,0 +1,92 @@
1
+ /**
2
+ * The five phases a node always relays. Mirrors the server's
3
+ * `BUILTIN_NODE_SPAN_NAMES`.
4
+ *
5
+ * @stability experimental
6
+ */
7
+ export type BuiltinNodeSpanName = 'job.download' | 'job.execute' | 'job.upload' | 'job.submit' | 'job.secret';
8
+ /**
9
+ * A span name a node may relay: one of the five phases, or an executor's own
10
+ * span under the fixed prefix `job.app.` (`job.app.transcode`). Mirrors the
11
+ * server's `nodeSpanNameSchema`: a name outside both shapes is dropped on this
12
+ * side (`isNodeSpanName`) before it is queued, and would be dropped (alone, not
13
+ * with its batch) on the server's.
14
+ *
15
+ * @stability experimental
16
+ */
17
+ export type NodeSpanName = BuiltinNodeSpanName | `job.app.${string}`;
18
+ /**
19
+ * Mirrors the server's `NODE_APP_SPAN_NAME_PATTERN`: `job.app.` and then a
20
+ * lower-case name of 2 to 48 characters.
21
+ *
22
+ * @stability experimental
23
+ */
24
+ export declare const NODE_APP_SPAN_NAME_PATTERN: RegExp;
25
+ /**
26
+ * Whether `name` is a span name the server takes: a built-in phase or
27
+ * `job.app.<name>`.
28
+ *
29
+ * @param name - a candidate span name.
30
+ * @returns true when it is relayable.
31
+ * @stability experimental
32
+ */
33
+ export declare function isNodeSpanName(name: unknown): name is NodeSpanName;
34
+ /**
35
+ * Allowlisted span attributes. Mirrors the server's `nodeSpanAttributesSchema`:
36
+ * the four built-in integers, plus APP attributes under keys shaped
37
+ * `^[a-z][A-Za-z0-9]{1,31}$`, each a non-negative integer or a short
38
+ * TOKEN-SHAPED string (letters, digits and `_ . + -`, at most 128: no space,
39
+ * slash, colon or quote, so no URL, path or credential rides along). At most 16
40
+ * keys. The server emits only the app attributes its deployment registered
41
+ * (`registerNodeSpanAttribute`) and drops the rest, so sending one it does not
42
+ * know costs nothing but the bytes.
43
+ *
44
+ * @stability experimental
45
+ */
46
+ export interface NodeSpanAttributes {
47
+ /** Bytes moved by the phase. Non-negative. */
48
+ bytes?: number | undefined;
49
+ /** The job's attempt number. 0 to 10,000. */
50
+ attempt?: number | undefined;
51
+ /** A child process's exit code. -1024 to 1024. */
52
+ exitCode?: number | undefined;
53
+ /** The HTTP status of the phase's request. 100 to 599. */
54
+ httpStatus?: number | undefined;
55
+ /** An app attribute: a non-negative integer or a token-shaped string. */
56
+ [appKey: string]: number | string | undefined;
57
+ }
58
+ /**
59
+ * One phase of one job, as `POST /nodes/:id/telemetry` takes it.
60
+ *
61
+ * @stability experimental
62
+ */
63
+ export interface NodeSpan {
64
+ /** The job the phase belongs to. */
65
+ jobId: string;
66
+ /** Which phase. */
67
+ name: NodeSpanName;
68
+ /** When the phase started, Unix epoch milliseconds. */
69
+ startTimeUnixMs: number;
70
+ /** How long it ran, milliseconds, capped at one day. */
71
+ durationMs: number;
72
+ /** Whether the phase succeeded. */
73
+ status: 'ok' | 'error';
74
+ /** An error CLASS or CODE (`MissingJobInputError`, `ApiError.409`), never a message. */
75
+ errorType?: string | undefined;
76
+ /** Integer-only attributes; see {@link NodeSpanAttributes}. */
77
+ attributes?: NodeSpanAttributes | undefined;
78
+ }
79
+ /**
80
+ * What the relay needs from the app's API client: one optional method. An app
81
+ * client whose `telemetry` posts to `/nodes/:id/telemetry` satisfies it
82
+ * structurally. A client without the method is a relay that is off.
83
+ *
84
+ * @stability experimental
85
+ */
86
+ export interface NodeSpanSink {
87
+ /** Sends one batch of at most `MAX_SPANS_PER_BATCH` spans for `nodeId`. */
88
+ telemetry?(nodeId: string, body: {
89
+ spans: NodeSpan[];
90
+ }): Promise<unknown>;
91
+ }
92
+ //# sourceMappingURL=node-span.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-span.d.ts","sourceRoot":"","sources":["../../src/telemetry/node-span.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,aAAa,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;AAE9G;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,WAAW,MAAM,EAAE,CAAC;AAErE;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAAuC,CAAC;AAI/E;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,YAAY,CAElE;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,yEAAyE;IACzE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,SAAS,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3E"}