@speedkit/cli 4.51.1 → 4.52.0

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 (439) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.md +1426 -14
  3. package/dist/base/run-control-command.d.ts +15 -0
  4. package/dist/base/run-control-command.js +20 -0
  5. package/dist/build-info.json +6 -0
  6. package/dist/commands/diff.d.ts +7 -1
  7. package/dist/commands/diff.js +9 -3
  8. package/dist/commands/login.d.ts +3 -0
  9. package/dist/commands/login.js +14 -3
  10. package/dist/commands/onboarding/browser/click.d.ts +75 -0
  11. package/dist/commands/onboarding/browser/click.js +19 -0
  12. package/dist/commands/onboarding/browser/emulate.d.ts +105 -0
  13. package/dist/commands/onboarding/browser/emulate.js +26 -0
  14. package/dist/commands/onboarding/browser/navigate.d.ts +75 -0
  15. package/dist/commands/onboarding/browser/navigate.js +19 -0
  16. package/dist/commands/onboarding/browser/panel.d.ts +63 -0
  17. package/dist/commands/onboarding/browser/panel.js +12 -0
  18. package/dist/commands/onboarding/browser/reinstall-sw.d.ts +63 -0
  19. package/dist/commands/onboarding/browser/reinstall-sw.js +14 -0
  20. package/dist/commands/onboarding/browser/reset.d.ts +71 -0
  21. package/dist/commands/onboarding/browser/reset.js +18 -0
  22. package/dist/commands/onboarding/browser/screenshot.d.ts +77 -0
  23. package/dist/commands/onboarding/browser/screenshot.js +19 -0
  24. package/dist/commands/onboarding/browser/state.d.ts +63 -0
  25. package/dist/commands/onboarding/browser/state.js +12 -0
  26. package/dist/commands/onboarding/browser/tabs.d.ts +58 -0
  27. package/dist/commands/onboarding/browser/tabs.js +16 -0
  28. package/dist/commands/onboarding/cache/clear.d.ts +58 -0
  29. package/dist/commands/onboarding/cache/clear.js +12 -0
  30. package/dist/commands/onboarding/cache/errors.d.ts +58 -0
  31. package/dist/commands/onboarding/cache/errors.js +12 -0
  32. package/dist/commands/onboarding/cache/evict.d.ts +62 -0
  33. package/dist/commands/onboarding/cache/evict.js +15 -0
  34. package/dist/commands/onboarding/cache/get.d.ts +85 -0
  35. package/dist/commands/onboarding/cache/get.js +17 -0
  36. package/dist/commands/onboarding/cache/list.d.ts +58 -0
  37. package/dist/commands/onboarding/cache/list.js +15 -0
  38. package/dist/commands/onboarding/cache/prewarm.d.ts +73 -0
  39. package/dist/commands/onboarding/cache/prewarm.js +20 -0
  40. package/dist/commands/onboarding/cache/refresh.d.ts +62 -0
  41. package/dist/commands/onboarding/cache/refresh.js +18 -0
  42. package/dist/commands/onboarding/cdp.d.ts +81 -0
  43. package/dist/commands/onboarding/cdp.js +18 -0
  44. package/dist/commands/onboarding/debug/arm.d.ts +83 -0
  45. package/dist/commands/onboarding/debug/arm.js +19 -0
  46. package/dist/commands/onboarding/debug/await.d.ts +71 -0
  47. package/dist/commands/onboarding/debug/await.js +18 -0
  48. package/dist/commands/onboarding/debug/disarm.d.ts +63 -0
  49. package/dist/commands/onboarding/debug/disarm.js +12 -0
  50. package/dist/commands/onboarding/debug/eval.d.ts +75 -0
  51. package/dist/commands/onboarding/debug/eval.js +16 -0
  52. package/dist/commands/onboarding/debug/release.d.ts +63 -0
  53. package/dist/commands/onboarding/debug/release.js +12 -0
  54. package/dist/commands/onboarding/debug/resume.d.ts +63 -0
  55. package/dist/commands/onboarding/debug/resume.js +12 -0
  56. package/dist/commands/onboarding/debug/status.d.ts +63 -0
  57. package/dist/commands/onboarding/debug/status.js +12 -0
  58. package/dist/commands/onboarding/debug/step.d.ts +67 -0
  59. package/dist/commands/onboarding/debug/step.js +15 -0
  60. package/dist/commands/onboarding/files/list.d.ts +58 -0
  61. package/dist/commands/onboarding/files/list.js +12 -0
  62. package/dist/commands/onboarding/files/read.d.ts +73 -0
  63. package/dist/commands/onboarding/files/read.js +16 -0
  64. package/dist/commands/onboarding/files/rebuild.d.ts +63 -0
  65. package/dist/commands/onboarding/files/rebuild.js +18 -0
  66. package/dist/commands/onboarding/files/validate.d.ts +58 -0
  67. package/dist/commands/onboarding/files/validate.js +12 -0
  68. package/dist/commands/onboarding/fouc.d.ts +77 -0
  69. package/dist/commands/onboarding/fouc.js +16 -0
  70. package/dist/commands/onboarding/inject/add.d.ts +89 -0
  71. package/dist/commands/onboarding/inject/add.js +17 -0
  72. package/dist/commands/onboarding/inject/clear.d.ts +63 -0
  73. package/dist/commands/onboarding/inject/clear.js +12 -0
  74. package/dist/commands/onboarding/inject/list.d.ts +63 -0
  75. package/dist/commands/onboarding/inject/list.js +12 -0
  76. package/dist/commands/onboarding/inject/read.d.ts +75 -0
  77. package/dist/commands/onboarding/inject/read.js +18 -0
  78. package/dist/commands/onboarding/inject/recipes.d.ts +63 -0
  79. package/dist/commands/onboarding/inject/recipes.js +12 -0
  80. package/dist/commands/onboarding/inject/remove.d.ts +67 -0
  81. package/dist/commands/onboarding/inject/remove.js +15 -0
  82. package/dist/commands/onboarding/list.d.ts +13 -0
  83. package/dist/commands/onboarding/list.js +12 -0
  84. package/dist/commands/onboarding/logs.d.ts +41 -0
  85. package/dist/commands/onboarding/logs.js +257 -0
  86. package/dist/commands/onboarding/navwalk.d.ts +95 -0
  87. package/dist/commands/onboarding/navwalk.js +19 -0
  88. package/dist/commands/onboarding/response.d.ts +67 -0
  89. package/dist/commands/onboarding/response.js +18 -0
  90. package/dist/commands/onboarding/rum/beacons.d.ts +75 -0
  91. package/dist/commands/onboarding/rum/beacons.js +16 -0
  92. package/dist/commands/onboarding/rum/get.d.ts +77 -0
  93. package/dist/commands/onboarding/rum/get.js +18 -0
  94. package/dist/commands/onboarding/rum/key.d.ts +67 -0
  95. package/dist/commands/onboarding/rum/key.js +13 -0
  96. package/dist/commands/onboarding/rum/previous.d.ts +63 -0
  97. package/dist/commands/onboarding/rum/previous.js +12 -0
  98. package/dist/commands/onboarding/status.d.ts +13 -0
  99. package/dist/commands/onboarding/status.js +17 -0
  100. package/dist/commands/onboarding/stop.d.ts +13 -0
  101. package/dist/commands/onboarding/stop.js +17 -0
  102. package/dist/commands/onboarding/todo.d.ts +58 -0
  103. package/dist/commands/onboarding/todo.js +12 -0
  104. package/dist/commands/onboarding/viewport.d.ts +101 -0
  105. package/dist/commands/onboarding/viewport.js +18 -0
  106. package/dist/commands/onboarding/watch.d.ts +93 -0
  107. package/dist/commands/onboarding/watch.js +16 -0
  108. package/dist/commands/onboarding.d.ts +26 -0
  109. package/dist/commands/onboarding.js +221 -4
  110. package/dist/commands/origin-request.d.ts +4 -0
  111. package/dist/commands/origin-request.js +4 -0
  112. package/dist/commands/spec/onboarding.spec.d.ts +1 -0
  113. package/dist/commands/spec/onboarding.spec.js +127 -0
  114. package/dist/services/browser-fetch/device-emulation.d.ts +11 -0
  115. package/dist/services/browser-fetch/device-emulation.js +14 -0
  116. package/dist/services/cli/build-info.d.ts +33 -0
  117. package/dist/services/cli/build-info.js +63 -0
  118. package/dist/services/cli/cli-environment-factory.d.ts +3 -0
  119. package/dist/services/cli/cli-environment-factory.js +1 -0
  120. package/dist/services/cli/cli-service-build-context.d.ts +3 -0
  121. package/dist/services/cli/cli-service-factory.js +1 -1
  122. package/dist/services/cli/cli-service-model.d.ts +29 -10
  123. package/dist/services/cli/cli-service.d.ts +60 -11
  124. package/dist/services/cli/cli-service.js +196 -32
  125. package/dist/services/cli/index.d.ts +2 -0
  126. package/dist/services/cli/index.js +2 -0
  127. package/dist/services/cli/sink.d.ts +47 -0
  128. package/dist/services/cli/sink.js +31 -0
  129. package/dist/services/cli/spec/build-identity.spec.d.ts +1 -0
  130. package/dist/services/cli/spec/build-identity.spec.js +85 -0
  131. package/dist/services/cli/spec/build-info.spec.d.ts +1 -0
  132. package/dist/services/cli/spec/build-info.spec.js +10 -0
  133. package/dist/services/cli/spec/cli-service-log.spec.d.ts +1 -0
  134. package/dist/services/cli/spec/cli-service-log.spec.js +133 -0
  135. package/dist/services/cli/spec/cli-service.spec.js +113 -50
  136. package/dist/services/cli/spec/memory-cli.d.ts +9 -0
  137. package/dist/services/cli/spec/memory-cli.js +9 -0
  138. package/dist/services/diff/config-at-ref.d.ts +20 -0
  139. package/dist/services/diff/config-at-ref.js +33 -0
  140. package/dist/services/diff/diff-service-build-context.d.ts +12 -0
  141. package/dist/services/diff/diff-service-build-context.js +45 -1
  142. package/dist/services/diff/diff-service-factory.d.ts +2 -0
  143. package/dist/services/diff/diff-service-factory.js +65 -25
  144. package/dist/services/diff/diff-service.d.ts +11 -0
  145. package/dist/services/diff/diff-service.js +37 -11
  146. package/dist/services/diff/page-source.d.ts +12 -0
  147. package/dist/services/diff/page-source.js +16 -11
  148. package/dist/services/diff/run-runtime-config.d.ts +33 -0
  149. package/dist/services/diff/run-runtime-config.js +74 -0
  150. package/dist/services/diff/sinks/tool-diff-sink.d.ts +3 -2
  151. package/dist/services/diff/sinks/tool-diff-sink.js +3 -2
  152. package/dist/services/diff/spec/config-at-ref.spec.d.ts +1 -0
  153. package/dist/services/diff/spec/config-at-ref.spec.js +46 -0
  154. package/dist/services/diff/spec/diff-service-build-context.spec.js +19 -0
  155. package/dist/services/diff/spec/diff-service.spec.js +95 -0
  156. package/dist/services/diff/spec/run-runtime-config.spec.d.ts +1 -0
  157. package/dist/services/diff/spec/run-runtime-config.spec.js +87 -0
  158. package/dist/services/git/git-repository.d.ts +2 -0
  159. package/dist/services/git/git-repository.js +6 -0
  160. package/dist/services/integration-api/customer-config-flags.js +1 -0
  161. package/dist/services/onboarding/browse/browse-service.d.ts +13 -1
  162. package/dist/services/onboarding/browse/browse-service.js +43 -7
  163. package/dist/services/onboarding/browser/answer-dialogs.d.ts +12 -0
  164. package/dist/services/onboarding/browser/answer-dialogs.js +25 -0
  165. package/dist/services/onboarding/browser/baqend-response.d.ts +17 -1
  166. package/dist/services/onboarding/browser/baqend-response.js +23 -0
  167. package/dist/services/onboarding/browser/console-log.d.ts +9 -0
  168. package/dist/services/onboarding/browser/console-log.js +27 -0
  169. package/dist/services/onboarding/browser/emulate-device.d.ts +12 -1
  170. package/dist/services/onboarding/browser/emulate-device.js +68 -13
  171. package/dist/services/onboarding/browser/executable/executable-validator.js +4 -2
  172. package/dist/services/onboarding/browser/extension/extension-bridge.js +5 -3
  173. package/dist/services/onboarding/browser/extension/extension-downloader.js +17 -8
  174. package/dist/services/onboarding/browser/extension/extension-validator.js +9 -4
  175. package/dist/services/onboarding/browser/launch-browser.d.ts +2 -1
  176. package/dist/services/onboarding/browser/launch-browser.js +6 -1
  177. package/dist/services/onboarding/browser/resume-restarted-workers.d.ts +14 -0
  178. package/dist/services/onboarding/browser/resume-restarted-workers.js +26 -0
  179. package/dist/services/onboarding/control/body-inspect.d.ts +24 -0
  180. package/dist/services/onboarding/control/body-inspect.js +106 -0
  181. package/dist/services/onboarding/control/browser-session.d.ts +547 -0
  182. package/dist/services/onboarding/control/browser-session.js +1337 -0
  183. package/dist/services/onboarding/control/config-validation.d.ts +17 -0
  184. package/dist/services/onboarding/control/config-validation.js +46 -0
  185. package/dist/services/onboarding/control/control-protocol.d.ts +1430 -0
  186. package/dist/services/onboarding/control/control-protocol.js +58 -0
  187. package/dist/services/onboarding/control/control-server.d.ts +292 -0
  188. package/dist/services/onboarding/control/control-server.js +1629 -0
  189. package/dist/services/onboarding/control/debug-session.d.ts +219 -0
  190. package/dist/services/onboarding/control/debug-session.js +897 -0
  191. package/dist/services/onboarding/control/fouc.d.ts +23 -0
  192. package/dist/services/onboarding/control/fouc.js +151 -0
  193. package/dist/services/onboarding/control/index.d.ts +4 -0
  194. package/dist/services/onboarding/control/index.js +4 -0
  195. package/dist/services/onboarding/control/navigate-wait.d.ts +33 -0
  196. package/dist/services/onboarding/control/navigate-wait.js +56 -0
  197. package/dist/services/onboarding/control/navwalk.d.ts +65 -0
  198. package/dist/services/onboarding/control/navwalk.js +248 -0
  199. package/dist/services/onboarding/control/preload-registry.d.ts +150 -0
  200. package/dist/services/onboarding/control/preload-registry.js +829 -0
  201. package/dist/services/onboarding/control/response-explainer.d.ts +24 -0
  202. package/dist/services/onboarding/control/response-explainer.js +257 -0
  203. package/dist/services/onboarding/control/rum.d.ts +8 -0
  204. package/dist/services/onboarding/control/rum.js +220 -0
  205. package/dist/services/onboarding/control/service-worker-tracker.d.ts +68 -0
  206. package/dist/services/onboarding/control/service-worker-tracker.js +120 -0
  207. package/dist/services/onboarding/control/viewport.d.ts +45 -0
  208. package/dist/services/onboarding/control/viewport.js +344 -0
  209. package/dist/services/onboarding/control/watch.d.ts +26 -0
  210. package/dist/services/onboarding/control/watch.js +157 -0
  211. package/dist/services/onboarding/dashboard/diff-against-current-page.js +3 -1
  212. package/dist/services/onboarding/dashboard/index.js +7 -2
  213. package/dist/services/onboarding/fetch-event-handler.d.ts +24 -5
  214. package/dist/services/onboarding/fetch-event-handler.js +103 -32
  215. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +11 -2
  216. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +14 -0
  217. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +30 -0
  218. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +13 -0
  219. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +28 -1
  220. package/dist/services/onboarding/file-events/file-watcher.d.ts +42 -1
  221. package/dist/services/onboarding/file-events/file-watcher.js +117 -12
  222. package/dist/services/onboarding/inject/inject-service.js +1 -1
  223. package/dist/services/onboarding/onboarding-model.d.ts +40 -7
  224. package/dist/services/onboarding/onboarding-model.js +20 -9
  225. package/dist/services/onboarding/onboarding-service-build-context.d.ts +4 -0
  226. package/dist/services/onboarding/onboarding-service-build-context.js +7 -1
  227. package/dist/services/onboarding/onboarding-service-factory.d.ts +17 -1
  228. package/dist/services/onboarding/onboarding-service-factory.js +150 -23
  229. package/dist/services/onboarding/onboarding-service.d.ts +40 -1
  230. package/dist/services/onboarding/onboarding-service.js +139 -23
  231. package/dist/services/onboarding/request-cache/asset-key.d.ts +61 -0
  232. package/dist/services/onboarding/request-cache/asset-key.js +115 -0
  233. package/dist/services/onboarding/request-cache/cache.d.ts +62 -5
  234. package/dist/services/onboarding/request-cache/cache.js +128 -17
  235. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.d.ts +1 -0
  236. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.js +66 -0
  237. package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +1 -0
  238. package/dist/services/onboarding/spec/browser/console-log.spec.js +42 -0
  239. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.d.ts +1 -0
  240. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.js +45 -0
  241. package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +1 -0
  242. package/dist/services/onboarding/spec/control/browser-session.spec.js +753 -0
  243. package/dist/services/onboarding/spec/control/control-server.spec.d.ts +1 -0
  244. package/dist/services/onboarding/spec/control/control-server.spec.js +371 -0
  245. package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +1 -0
  246. package/dist/services/onboarding/spec/control/debug-session.spec.js +751 -0
  247. package/dist/services/onboarding/spec/control/fakes.d.ts +31 -0
  248. package/dist/services/onboarding/spec/control/fakes.js +67 -0
  249. package/dist/services/onboarding/spec/control/fouc.spec.d.ts +1 -0
  250. package/dist/services/onboarding/spec/control/fouc.spec.js +167 -0
  251. package/dist/services/onboarding/spec/control/navigate-wait.spec.d.ts +1 -0
  252. package/dist/services/onboarding/spec/control/navigate-wait.spec.js +47 -0
  253. package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +1 -0
  254. package/dist/services/onboarding/spec/control/navwalk.spec.js +222 -0
  255. package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +1 -0
  256. package/dist/services/onboarding/spec/control/preload-registry.spec.js +432 -0
  257. package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +1 -0
  258. package/dist/services/onboarding/spec/control/response-explainer.spec.js +324 -0
  259. package/dist/services/onboarding/spec/control/rum.spec.d.ts +1 -0
  260. package/dist/services/onboarding/spec/control/rum.spec.js +222 -0
  261. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +1 -0
  262. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +193 -0
  263. package/dist/services/onboarding/spec/control/viewport.spec.d.ts +1 -0
  264. package/dist/services/onboarding/spec/control/viewport.spec.js +200 -0
  265. package/dist/services/onboarding/spec/control/watch.spec.d.ts +1 -0
  266. package/dist/services/onboarding/spec/control/watch.spec.js +187 -0
  267. package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +1 -0
  268. package/dist/services/onboarding/spec/fetch-event-handler.spec.js +219 -0
  269. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +1 -0
  270. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +41 -0
  271. package/dist/services/onboarding/spec/onboarding-model.spec.js +39 -3
  272. package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +25 -1
  273. package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +1 -0
  274. package/dist/services/onboarding/spec/request-cache/cache.spec.js +107 -0
  275. package/dist/services/onboarding/spec/todo-collector.spec.d.ts +1 -0
  276. package/dist/services/onboarding/spec/todo-collector.spec.js +136 -0
  277. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.d.ts +1 -0
  278. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.js +65 -0
  279. package/dist/services/onboarding/todo-collector.d.ts +7 -2
  280. package/dist/services/onboarding/todo-collector.js +49 -12
  281. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +38 -0
  282. package/dist/services/onboarding/virtual-orestes-app/index.js +113 -27
  283. package/dist/services/origin-request/asset-variations.d.ts +14 -0
  284. package/dist/services/origin-request/asset-variations.js +11 -4
  285. package/dist/services/origin-request/origin-fetcher.d.ts +7 -0
  286. package/dist/services/origin-request/origin-fetcher.js +43 -5
  287. package/dist/services/origin-request/origin-request-service-build-context.d.ts +17 -0
  288. package/dist/services/origin-request/origin-request-service-build-context.js +8 -0
  289. package/dist/services/origin-request/origin-request-service-factory.d.ts +0 -5
  290. package/dist/services/origin-request/origin-request-service-factory.js +2 -30
  291. package/dist/services/origin-request/origin-request-service.d.ts +121 -6
  292. package/dist/services/origin-request/origin-request-service.js +273 -49
  293. package/dist/services/origin-request/runtime-config-source.d.ts +6 -0
  294. package/dist/services/origin-request/runtime-config-source.js +15 -4
  295. package/dist/services/origin-request/spec/asset-variations.spec.js +20 -0
  296. package/dist/services/origin-request/spec/origin-request-service.spec.js +329 -6
  297. package/dist/services/query-builder/rules/rule-match.d.ts +35 -0
  298. package/dist/services/query-builder/rules/rule-match.js +70 -0
  299. package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +1 -0
  300. package/dist/services/query-builder/spec/rules/rule-match.spec.js +121 -0
  301. package/dist/services/run-control/browser/run-browser-contexts.d.ts +557 -0
  302. package/dist/services/run-control/browser/run-browser-contexts.js +91 -0
  303. package/dist/services/run-control/browser/run-browser-service-factory.d.ts +5 -0
  304. package/dist/services/run-control/browser/run-browser-service-factory.js +7 -0
  305. package/dist/services/run-control/browser/run-browser-service.d.ts +68 -0
  306. package/dist/services/run-control/browser/run-browser-service.js +206 -0
  307. package/dist/services/run-control/cache/run-cache-contexts.d.ts +349 -0
  308. package/dist/services/run-control/cache/run-cache-contexts.js +51 -0
  309. package/dist/services/run-control/cache/run-cache-service-factory.d.ts +6 -0
  310. package/dist/services/run-control/cache/run-cache-service-factory.js +12 -0
  311. package/dist/services/run-control/cache/run-cache-service.d.ts +35 -0
  312. package/dist/services/run-control/cache/run-cache-service.js +151 -0
  313. package/dist/services/run-control/control-client.d.ts +36 -0
  314. package/dist/services/run-control/control-client.js +147 -0
  315. package/dist/services/run-control/debug/run-debug-contexts.d.ts +416 -0
  316. package/dist/services/run-control/debug/run-debug-contexts.js +47 -0
  317. package/dist/services/run-control/debug/run-debug-service-factory.d.ts +5 -0
  318. package/dist/services/run-control/debug/run-debug-service-factory.js +7 -0
  319. package/dist/services/run-control/debug/run-debug-service.d.ts +39 -0
  320. package/dist/services/run-control/debug/run-debug-service.js +164 -0
  321. package/dist/services/run-control/files/run-files-contexts.d.ts +238 -0
  322. package/dist/services/run-control/files/run-files-contexts.js +26 -0
  323. package/dist/services/run-control/files/run-files-service-factory.d.ts +5 -0
  324. package/dist/services/run-control/files/run-files-service-factory.js +7 -0
  325. package/dist/services/run-control/files/run-files-service.d.ts +29 -0
  326. package/dist/services/run-control/files/run-files-service.js +120 -0
  327. package/dist/services/run-control/index.d.ts +32 -0
  328. package/dist/services/run-control/index.js +31 -0
  329. package/dist/services/run-control/inject/run-inject-contexts.d.ts +319 -0
  330. package/dist/services/run-control/inject/run-inject-contexts.js +38 -0
  331. package/dist/services/run-control/inject/run-inject-service-factory.d.ts +5 -0
  332. package/dist/services/run-control/inject/run-inject-service-factory.js +7 -0
  333. package/dist/services/run-control/inject/run-inject-service.d.ts +31 -0
  334. package/dist/services/run-control/inject/run-inject-service.js +227 -0
  335. package/dist/services/run-control/live-run.d.ts +37 -0
  336. package/dist/services/run-control/live-run.js +56 -0
  337. package/dist/services/run-control/probe/run-probe-contexts.d.ts +333 -0
  338. package/dist/services/run-control/probe/run-probe-contexts.js +73 -0
  339. package/dist/services/run-control/probe/run-probe-service-factory.d.ts +5 -0
  340. package/dist/services/run-control/probe/run-probe-service-factory.js +7 -0
  341. package/dist/services/run-control/probe/run-probe-service.d.ts +54 -0
  342. package/dist/services/run-control/probe/run-probe-service.js +194 -0
  343. package/dist/services/run-control/rum/run-rum-contexts.d.ts +216 -0
  344. package/dist/services/run-control/rum/run-rum-contexts.js +34 -0
  345. package/dist/services/run-control/rum/run-rum-service-factory.d.ts +5 -0
  346. package/dist/services/run-control/rum/run-rum-service-factory.js +7 -0
  347. package/dist/services/run-control/rum/run-rum-service.d.ts +36 -0
  348. package/dist/services/run-control/rum/run-rum-service.js +122 -0
  349. package/dist/services/run-control/run-answer.d.ts +28 -0
  350. package/dist/services/run-control/run-answer.js +58 -0
  351. package/dist/services/run-control/run-control-context.d.ts +102 -0
  352. package/dist/services/run-control/run-control-context.js +36 -0
  353. package/dist/services/run-control/run-control-flags.d.ts +12 -0
  354. package/dist/services/run-control/run-control-flags.js +22 -0
  355. package/dist/services/run-control/run-control-model.d.ts +9 -0
  356. package/dist/services/run-control/run-control-model.js +1 -0
  357. package/dist/services/run-control/run-control-service-factory.d.ts +14 -0
  358. package/dist/services/run-control/run-control-service-factory.js +26 -0
  359. package/dist/services/run-control/session/run-session-contexts.d.ts +25 -0
  360. package/dist/services/run-control/session/run-session-contexts.js +20 -0
  361. package/dist/services/run-control/session/run-session-service-factory.d.ts +8 -0
  362. package/dist/services/run-control/session/run-session-service-factory.js +18 -0
  363. package/dist/services/run-control/session/run-session-service.d.ts +32 -0
  364. package/dist/services/run-control/session/run-session-service.js +151 -0
  365. package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +1 -0
  366. package/dist/services/run-control/spec/browser/run-browser-service.spec.js +328 -0
  367. package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +1 -0
  368. package/dist/services/run-control/spec/cache/run-cache-service.spec.js +454 -0
  369. package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +1 -0
  370. package/dist/services/run-control/spec/debug/run-debug-service.spec.js +113 -0
  371. package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +1 -0
  372. package/dist/services/run-control/spec/files/run-files-service.spec.js +234 -0
  373. package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +1 -0
  374. package/dist/services/run-control/spec/inject/run-inject-service.spec.js +251 -0
  375. package/dist/services/run-control/spec/live-run-fixture.d.ts +32 -0
  376. package/dist/services/run-control/spec/live-run-fixture.js +109 -0
  377. package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +1 -0
  378. package/dist/services/run-control/spec/probe/run-probe-service.spec.js +108 -0
  379. package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +1 -0
  380. package/dist/services/run-control/spec/rum/run-rum-service.spec.js +47 -0
  381. package/dist/services/run-control/spec/run-answer.spec.d.ts +1 -0
  382. package/dist/services/run-control/spec/run-answer.spec.js +57 -0
  383. package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +1 -0
  384. package/dist/services/run-control/spec/session/run-session-service.spec.js +150 -0
  385. package/dist/services/run-log/crash-mirror.d.ts +31 -0
  386. package/dist/services/run-log/crash-mirror.js +69 -0
  387. package/dist/services/run-log/index.d.ts +11 -0
  388. package/dist/services/run-log/index.js +11 -0
  389. package/dist/services/run-log/jsonl-appender.d.ts +46 -0
  390. package/dist/services/run-log/jsonl-appender.js +91 -0
  391. package/dist/services/run-log/log-event-model.d.ts +104 -0
  392. package/dist/services/run-log/log-event-model.js +56 -0
  393. package/dist/services/run-log/log-query-service-factory.d.ts +11 -0
  394. package/dist/services/run-log/log-query-service-factory.js +14 -0
  395. package/dist/services/run-log/log-query-service.d.ts +59 -0
  396. package/dist/services/run-log/log-query-service.js +111 -0
  397. package/dist/services/run-log/log-reader.d.ts +84 -0
  398. package/dist/services/run-log/log-reader.js +180 -0
  399. package/dist/services/run-log/log-summary.d.ts +72 -0
  400. package/dist/services/run-log/log-summary.js +208 -0
  401. package/dist/services/run-log/redaction.d.ts +34 -0
  402. package/dist/services/run-log/redaction.js +124 -0
  403. package/dist/services/run-log/request-log.d.ts +82 -0
  404. package/dist/services/run-log/request-log.js +69 -0
  405. package/dist/services/run-log/request-summary.d.ts +76 -0
  406. package/dist/services/run-log/request-summary.js +0 -0
  407. package/dist/services/run-log/run-log.d.ts +61 -0
  408. package/dist/services/run-log/run-log.js +102 -0
  409. package/dist/services/run-log/spec/log-query-service.spec.d.ts +1 -0
  410. package/dist/services/run-log/spec/log-query-service.spec.js +197 -0
  411. package/dist/services/run-log/spec/log-reader.spec.d.ts +1 -0
  412. package/dist/services/run-log/spec/log-reader.spec.js +109 -0
  413. package/dist/services/run-log/spec/log-summary.spec.d.ts +1 -0
  414. package/dist/services/run-log/spec/log-summary.spec.js +153 -0
  415. package/dist/services/run-log/spec/redaction.spec.d.ts +1 -0
  416. package/dist/services/run-log/spec/redaction.spec.js +61 -0
  417. package/dist/services/run-log/spec/request-log.spec.d.ts +1 -0
  418. package/dist/services/run-log/spec/request-log.spec.js +101 -0
  419. package/dist/services/run-log/spec/request-summary.spec.d.ts +1 -0
  420. package/dist/services/run-log/spec/request-summary.spec.js +171 -0
  421. package/dist/services/run-log/spec/run-log.spec.d.ts +1 -0
  422. package/dist/services/run-log/spec/run-log.spec.js +122 -0
  423. package/dist/services/run-registry/exit-classification.d.ts +39 -0
  424. package/dist/services/run-registry/exit-classification.js +42 -0
  425. package/dist/services/run-registry/index.d.ts +3 -0
  426. package/dist/services/run-registry/index.js +3 -0
  427. package/dist/services/run-registry/process-identity.d.ts +28 -0
  428. package/dist/services/run-registry/process-identity.js +80 -0
  429. package/dist/services/run-registry/run-registry-model.d.ts +128 -0
  430. package/dist/services/run-registry/run-registry-model.js +16 -0
  431. package/dist/services/run-registry/run-registry.d.ts +155 -0
  432. package/dist/services/run-registry/run-registry.js +430 -0
  433. package/dist/services/run-registry/spec/exit-classification.spec.d.ts +1 -0
  434. package/dist/services/run-registry/spec/exit-classification.spec.js +82 -0
  435. package/dist/services/run-registry/spec/run-registry.spec.d.ts +1 -0
  436. package/dist/services/run-registry/spec/run-registry.spec.js +526 -0
  437. package/dist/services/setup/os/tool-registry.js +2 -2
  438. package/oclif.manifest.json +3493 -372
  439. package/package.json +20 -2
@@ -0,0 +1,12 @@
1
+ import { RunControlServiceFactory } from "../run-control-service-factory.js";
2
+ import { RunCacheService } from "./run-cache-service.js";
3
+ /** Finds the live run a cache op means, and builds the service that asks it. */
4
+ export class RunCacheServiceFactory extends RunControlServiceFactory {
5
+ buildService() {
6
+ return new RunCacheService(
7
+ // The bodies outlive the process; the index that maps urls to them does
8
+ // not. Saying so is the difference between "look on disk" and "there is
9
+ // nothing".
10
+ this.deps((dead) => `Run ${dead.meta.id} is ${dead.status}. Its cached bodies are still on disk under ${dead.dir}/dh-cache, but the index that maps urls to them lived in the process, so nothing can look them up.`));
11
+ }
12
+ }
@@ -0,0 +1,35 @@
1
+ import { RunControlServiceDeps } from "../run-control-model.js";
2
+ export interface CacheGetInput {
3
+ key: string;
4
+ variation?: string;
5
+ select?: string;
6
+ grep?: string;
7
+ maxMatches?: number;
8
+ }
9
+ export interface CachePrewarmInput {
10
+ url: string;
11
+ variations?: string[];
12
+ all?: boolean;
13
+ }
14
+ /**
15
+ * The local documentHandler cache of a live run: the in-memory cache the
16
+ * documentHandler fills — not the CDN, and not what the browser rendered.
17
+ */
18
+ export declare class RunCacheService {
19
+ private readonly cli;
20
+ private readonly run;
21
+ private readonly answer;
22
+ constructor(deps: RunControlServiceDeps);
23
+ list(): Promise<void>;
24
+ /** One entry; the body goes to a file, never to the terminal. */
25
+ get(input: CacheGetInput): Promise<void>;
26
+ /** Build entries for a url nothing has requested, one per variation. */
27
+ prewarm(input: CachePrewarmInput): Promise<void>;
28
+ /** Rebuild what is cached and say whether the origin's bytes moved. */
29
+ refresh(key?: string): Promise<void>;
30
+ /** Drop every entry whose key contains `key`. */
31
+ evict(key: string): Promise<void>;
32
+ clear(): Promise<void>;
33
+ /** What the documentHandler is failing to build right now. */
34
+ errors(): Promise<void>;
35
+ }
@@ -0,0 +1,151 @@
1
+ /** One origin fetch and one transform per variation, so not a question's 5s. */
2
+ const BUILD_BUDGET_MS = 120_000;
3
+ /**
4
+ * The local documentHandler cache of a live run: the in-memory cache the
5
+ * documentHandler fills — not the CDN, and not what the browser rendered.
6
+ */
7
+ export class RunCacheService {
8
+ cli;
9
+ run;
10
+ answer;
11
+ constructor(deps) {
12
+ this.cli = deps.cli;
13
+ this.run = deps.run;
14
+ this.answer = deps.answer;
15
+ }
16
+ async list() {
17
+ const { entries } = await this.run.request({
18
+ op: "cache.list",
19
+ });
20
+ this.answer.give(`${entries.length} cached entr${entries.length === 1 ? "y" : "ies"} in ${this.run.id}`, { run: this.run.id, entries }, () => {
21
+ if (entries.length === 0) {
22
+ return;
23
+ }
24
+ // Lines, not a table: a table sized to the terminal wraps the url,
25
+ // which is the column people read.
26
+ const width = Math.max(...entries.map((entry) => (entry.variation ?? "default").length));
27
+ for (const entry of entries) {
28
+ this.cli.write(`${(entry.variation ?? "default").padEnd(width)} ${entry.status} ${this.cli.style.grey(String(entry.bytes).padStart(8))} ${entry.originUrl}`);
29
+ }
30
+ });
31
+ }
32
+ /** One entry; the body goes to a file, never to the terminal. */
33
+ async get(input) {
34
+ const entry = await this.run.request({
35
+ op: "cache.get",
36
+ ...input,
37
+ });
38
+ this.answer.give(summariseEntry(entry), { run: this.run.id, entry }, () => {
39
+ this.cli.comment(`key ${entry.key}`);
40
+ this.cli.comment(`body ${entry.bodyPath}`);
41
+ for (const match of entry.select?.matches ?? []) {
42
+ this.cli.write(` ${match}`);
43
+ }
44
+ for (const match of entry.grep?.matches ?? []) {
45
+ this.cli.write(` ${this.cli.style.grey(`${match.line}:`)} ${match.text}`);
46
+ }
47
+ if (entry.select?.truncated || entry.grep?.truncated) {
48
+ this.cli.comment("More matched; raise --max-matches to see them.");
49
+ }
50
+ });
51
+ }
52
+ /** Build entries for a url nothing has requested, one per variation. */
53
+ async prewarm(input) {
54
+ const data = await this.run.request({ op: "cache.prewarm", ...input }, BUILD_BUDGET_MS);
55
+ this.answer.give(summarisePrewarm(data), { run: this.run.id, ...data }, () => {
56
+ for (const entry of data.entries) {
57
+ this.cli.write(` ${entry.variation ?? "default"} ${entry.built ? "built" : "cached"} ${entry.bodyPath}`);
58
+ }
59
+ for (const failure of data.failed) {
60
+ this.cli.writeError(` ${failure.variation} ${failure.error}`);
61
+ }
62
+ });
63
+ }
64
+ /** Rebuild what is cached and say whether the origin's bytes moved. */
65
+ async refresh(key) {
66
+ const data = await this.run.request({ op: "cache.refresh", key }, BUILD_BUDGET_MS);
67
+ this.answer.give(summariseRefresh(data), { run: this.run.id, ...data }, () => {
68
+ for (const entry of data.entries.filter((one) => one.changed)) {
69
+ this.cli.write(` changed ${describe(entry)} ${entry.bodyPath}`);
70
+ }
71
+ for (const failure of data.failed) {
72
+ this.cli.writeError(` ${failure.variation} ${failure.error}`);
73
+ }
74
+ });
75
+ }
76
+ /** Drop every entry whose key contains `key`. */
77
+ async evict(key) {
78
+ const data = await this.run.request({
79
+ op: "cache.evict",
80
+ key,
81
+ });
82
+ this.answer.give(`removed ${data.removed.length} entr${data.removed.length === 1 ? "y" : "ies"} matching "${data.key}", ${data.remaining} left`, { run: this.run.id, ...data }, () => {
83
+ for (const removed of data.removed) {
84
+ this.cli.write(` ${removed}`);
85
+ }
86
+ });
87
+ }
88
+ async clear() {
89
+ const data = await this.run.request({ op: "cache.clear" });
90
+ this.answer.give(`cleared ${data.cleared} entr${data.cleared === 1 ? "y" : "ies"} — the next request for any of them goes to origin`, { run: this.run.id, ...data });
91
+ }
92
+ /** What the documentHandler is failing to build right now. */
93
+ async errors() {
94
+ const data = await this.run.request({
95
+ op: "cache.errors",
96
+ });
97
+ this.answer.give(data.errors.length === 0
98
+ ? "nothing is currently failing to build"
99
+ : `${data.errors.length} url${data.errors.length === 1 ? "" : "s"} the documentHandler could not build`, { run: this.run.id, ...data }, () => {
100
+ for (const error of data.errors) {
101
+ this.cli.writeError(` ${error.url} (${error.variation})`);
102
+ this.cli.comment(` ${error.error}`);
103
+ }
104
+ });
105
+ }
106
+ }
107
+ function describe(entry) {
108
+ return `${entry.originUrl}${entry.variation ? ` (${entry.variation})` : ""}`;
109
+ }
110
+ /** Leads with whatever was asked about, because that is the answer. */
111
+ function summariseEntry(entry) {
112
+ const parts = [`${entry.bytes} bytes, ${entry.status}`];
113
+ if (entry.select) {
114
+ parts.unshift(entry.select.error
115
+ ? `selector rejected: ${entry.select.error}`
116
+ : `${entry.select.count} × ${entry.select.selector}`);
117
+ }
118
+ if (entry.grep) {
119
+ parts.unshift(entry.grep.error
120
+ ? `pattern rejected: ${entry.grep.error}`
121
+ : `${entry.grep.count} line${entry.grep.count === 1 ? "" : "s"} match /${entry.grep.pattern}/`);
122
+ }
123
+ return `${describe(entry)} — ${parts.join(", ")}`;
124
+ }
125
+ /** Leads with what is now comparable, because that is what it was asked for. */
126
+ function summarisePrewarm(data) {
127
+ const built = data.entries.filter((entry) => entry.built).length;
128
+ const parts = [
129
+ `${data.entries.length} entr${data.entries.length === 1 ? "y" : "ies"} for ${data.url}`,
130
+ `${built} built, ${data.entries.length - built} already cached`,
131
+ ];
132
+ if (data.failed.length) {
133
+ parts.push(`${data.failed.length} failed: ${data.failed.map((one) => one.variation).join(", ")}`);
134
+ }
135
+ return parts.join(" — ");
136
+ }
137
+ /**
138
+ * Leads with what changed, because that is the question `refresh` answers:
139
+ * not "rebuilt 4 entries", but "the origin moved under one of them".
140
+ */
141
+ function summariseRefresh(data) {
142
+ const parts = [
143
+ data.changed === 0
144
+ ? `${data.entries.length} rebuilt, none changed — the origin is serving the same bytes`
145
+ : `${data.changed} of ${data.entries.length} changed at origin`,
146
+ ];
147
+ if (data.failed.length) {
148
+ parts.push(`${data.failed.length} failed: ${data.failed.map((one) => one.variation).join(", ")}`);
149
+ }
150
+ return parts.join(" — ");
151
+ }
@@ -0,0 +1,36 @@
1
+ import { Run } from "../run-registry/index.js";
2
+ import { ControlCommand, HelloData } from "../onboarding/control/control-protocol.js";
3
+ export declare class ControlError extends Error {
4
+ readonly code: string;
5
+ readonly detail: Record<string, unknown>;
6
+ constructor(code: string, message: string, detail?: Record<string, unknown>);
7
+ /**
8
+ * The failures of finding a run, in the one shape a command reports.
9
+ *
10
+ * Anything else is not a failure to reach the run but a bug, and stays what
11
+ * it was.
12
+ */
13
+ static from(error: unknown): ControlError | undefined;
14
+ }
15
+ /**
16
+ * Talks to one live onboarding run over its control socket.
17
+ *
18
+ * Short-lived by design: connect, ask, close. Nothing is cached between calls,
19
+ * because the generation counter exists precisely because state moves
20
+ * underneath.
21
+ */
22
+ export declare class ControlClient {
23
+ private readonly socket;
24
+ readonly hello: HelloData;
25
+ private constructor();
26
+ /**
27
+ * Connect to a run and complete the handshake.
28
+ *
29
+ * Refuses when the pid behind the socket is not the pid the run recorded. A
30
+ * socket that answers is not proof of liveness — socket files outlive their
31
+ * process, and the next thing to bind that path is not necessarily this run.
32
+ */
33
+ static connectTo(run: Run, timeoutMs?: number): Promise<ControlClient>;
34
+ request<T>(op: ControlCommand, timeoutMs?: number): Promise<T>;
35
+ close(): void;
36
+ }
@@ -0,0 +1,147 @@
1
+ import { connect } from "node:net";
2
+ import { existsSync } from "node:fs";
3
+ import { join } from "node:path";
4
+ import { AmbiguousRunError, NoSuchRunError, } from "../run-registry/index.js";
5
+ import { CONTROL_PROTOCOL_VERSION, CONTROL_SOCKET, } from "../onboarding/control/control-protocol.js";
6
+ /** Long enough for a slow handler, short enough that a stall is reported. */
7
+ const DEFAULT_TIMEOUT_MS = 5000;
8
+ export class ControlError extends Error {
9
+ code;
10
+ detail;
11
+ constructor(code, message, detail = {}) {
12
+ super(message);
13
+ this.code = code;
14
+ this.detail = detail;
15
+ }
16
+ /**
17
+ * The failures of finding a run, in the one shape a command reports.
18
+ *
19
+ * Anything else is not a failure to reach the run but a bug, and stays what
20
+ * it was.
21
+ */
22
+ static from(error) {
23
+ if (error instanceof ControlError) {
24
+ return error;
25
+ }
26
+ if (error instanceof AmbiguousRunError) {
27
+ return new ControlError("AMBIGUOUS_RUN", error.message, {
28
+ candidates: error.candidates.map((run) => run.meta.id),
29
+ next: "Name one with --run.",
30
+ });
31
+ }
32
+ if (error instanceof NoSuchRunError) {
33
+ return new ControlError("NO_SUCH_RUN", error.message, {
34
+ next: "`sk onboarding list` shows the recorded runs.",
35
+ });
36
+ }
37
+ return undefined;
38
+ }
39
+ }
40
+ /**
41
+ * Talks to one live onboarding run over its control socket.
42
+ *
43
+ * Short-lived by design: connect, ask, close. Nothing is cached between calls,
44
+ * because the generation counter exists precisely because state moves
45
+ * underneath.
46
+ */
47
+ export class ControlClient {
48
+ socket;
49
+ hello;
50
+ constructor(socket, hello) {
51
+ this.socket = socket;
52
+ this.hello = hello;
53
+ }
54
+ /**
55
+ * Connect to a run and complete the handshake.
56
+ *
57
+ * Refuses when the pid behind the socket is not the pid the run recorded. A
58
+ * socket that answers is not proof of liveness — socket files outlive their
59
+ * process, and the next thing to bind that path is not necessarily this run.
60
+ */
61
+ static async connectTo(run, timeoutMs = DEFAULT_TIMEOUT_MS) {
62
+ const path = join(run.dir, CONTROL_SOCKET);
63
+ if (!existsSync(path)) {
64
+ throw new ControlError("NO_CONTROL_SOCKET", `Run ${run.meta.id} has no control socket. It may predate this feature, or have exited.`, { run: run.meta.id, status: run.status });
65
+ }
66
+ const socket = await openSocket(path, timeoutMs);
67
+ const client = new ControlClient(socket, {
68
+ pid: 0,
69
+ runId: "",
70
+ version: 0,
71
+ });
72
+ const hello = await client.request({ op: "hello", version: CONTROL_PROTOCOL_VERSION }, timeoutMs);
73
+ if (hello.pid !== run.meta.pid) {
74
+ socket.destroy();
75
+ throw new ControlError("RUN_IDENTITY_MISMATCH", `The socket for ${run.meta.id} answers from pid ${hello.pid}, but the run recorded ${run.meta.pid}.`, { expected: run.meta.pid, actual: hello.pid });
76
+ }
77
+ return new ControlClient(socket, hello);
78
+ }
79
+ async request(op, timeoutMs = DEFAULT_TIMEOUT_MS) {
80
+ const id = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
81
+ const frame = `${JSON.stringify({ id, ...op })}\n`;
82
+ return new Promise((resolve, reject) => {
83
+ let buffer = "";
84
+ const timer = setTimeout(() => {
85
+ cleanup();
86
+ reject(new ControlError("CONTROL_TIMEOUT", `The run did not answer \`${op.op}\` within ${timeoutMs}ms. It may still be working on it.`, { op: op.op, timeoutMs }));
87
+ }, timeoutMs);
88
+ const onData = (chunk) => {
89
+ buffer += chunk.toString();
90
+ let newline = buffer.indexOf("\n");
91
+ while (newline !== -1) {
92
+ const line = buffer.slice(0, newline);
93
+ buffer = buffer.slice(newline + 1);
94
+ newline = buffer.indexOf("\n");
95
+ if (!line.trim()) {
96
+ continue;
97
+ }
98
+ const response = JSON.parse(line);
99
+ // Responses for other requests are not ours to consume.
100
+ if (response.id !== id) {
101
+ continue;
102
+ }
103
+ cleanup();
104
+ if (response.status === "ok") {
105
+ resolve(response.data);
106
+ }
107
+ else {
108
+ reject(new ControlError(response.error.code, response.error.message, response.error));
109
+ }
110
+ return;
111
+ }
112
+ };
113
+ const onClose = () => {
114
+ cleanup();
115
+ reject(new ControlError("CONTROL_CLOSED", "The run closed the connection before answering.", { op: op.op }));
116
+ };
117
+ const cleanup = () => {
118
+ clearTimeout(timer);
119
+ this.socket.off("data", onData);
120
+ this.socket.off("close", onClose);
121
+ };
122
+ this.socket.on("data", onData);
123
+ this.socket.once("close", onClose);
124
+ this.socket.write(frame);
125
+ });
126
+ }
127
+ close() {
128
+ this.socket.destroy();
129
+ }
130
+ }
131
+ function openSocket(path, timeoutMs) {
132
+ return new Promise((resolve, reject) => {
133
+ const socket = connect(path);
134
+ const timer = setTimeout(() => {
135
+ socket.destroy();
136
+ reject(new ControlError("CONTROL_TIMEOUT", `Could not reach the run's control socket within ${timeoutMs}ms.`, { path }));
137
+ }, timeoutMs);
138
+ socket.once("connect", () => {
139
+ clearTimeout(timer);
140
+ resolve(socket);
141
+ });
142
+ socket.once("error", (error) => {
143
+ clearTimeout(timer);
144
+ reject(new ControlError("CONTROL_UNREACHABLE", error.message, { path }));
145
+ });
146
+ });
147
+ }