@speedkit/cli 4.50.5 → 4.51.0-run-control.1

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 (406) hide show
  1. package/README.md +1369 -10
  2. package/dist/base/run-control-command.d.ts +15 -0
  3. package/dist/base/run-control-command.js +20 -0
  4. package/dist/build-info.json +6 -0
  5. package/dist/commands/diff.d.ts +6 -1
  6. package/dist/commands/diff.js +9 -3
  7. package/dist/commands/onboarding/browser/click.d.ts +75 -0
  8. package/dist/commands/onboarding/browser/click.js +19 -0
  9. package/dist/commands/onboarding/browser/emulate.d.ts +93 -0
  10. package/dist/commands/onboarding/browser/emulate.js +23 -0
  11. package/dist/commands/onboarding/browser/navigate.d.ts +67 -0
  12. package/dist/commands/onboarding/browser/navigate.js +18 -0
  13. package/dist/commands/onboarding/browser/panel.d.ts +63 -0
  14. package/dist/commands/onboarding/browser/panel.js +12 -0
  15. package/dist/commands/onboarding/browser/reinstall-sw.d.ts +63 -0
  16. package/dist/commands/onboarding/browser/reinstall-sw.js +14 -0
  17. package/dist/commands/onboarding/browser/reset.d.ts +71 -0
  18. package/dist/commands/onboarding/browser/reset.js +18 -0
  19. package/dist/commands/onboarding/browser/screenshot.d.ts +77 -0
  20. package/dist/commands/onboarding/browser/screenshot.js +19 -0
  21. package/dist/commands/onboarding/browser/state.d.ts +63 -0
  22. package/dist/commands/onboarding/browser/state.js +12 -0
  23. package/dist/commands/onboarding/browser/tabs.d.ts +58 -0
  24. package/dist/commands/onboarding/browser/tabs.js +16 -0
  25. package/dist/commands/onboarding/cache/clear.d.ts +58 -0
  26. package/dist/commands/onboarding/cache/clear.js +12 -0
  27. package/dist/commands/onboarding/cache/errors.d.ts +58 -0
  28. package/dist/commands/onboarding/cache/errors.js +12 -0
  29. package/dist/commands/onboarding/cache/evict.d.ts +62 -0
  30. package/dist/commands/onboarding/cache/evict.js +15 -0
  31. package/dist/commands/onboarding/cache/get.d.ts +85 -0
  32. package/dist/commands/onboarding/cache/get.js +17 -0
  33. package/dist/commands/onboarding/cache/list.d.ts +58 -0
  34. package/dist/commands/onboarding/cache/list.js +15 -0
  35. package/dist/commands/onboarding/cache/prewarm.d.ts +73 -0
  36. package/dist/commands/onboarding/cache/prewarm.js +20 -0
  37. package/dist/commands/onboarding/cache/refresh.d.ts +62 -0
  38. package/dist/commands/onboarding/cache/refresh.js +18 -0
  39. package/dist/commands/onboarding/cdp.d.ts +81 -0
  40. package/dist/commands/onboarding/cdp.js +18 -0
  41. package/dist/commands/onboarding/debug/arm.d.ts +77 -0
  42. package/dist/commands/onboarding/debug/arm.js +18 -0
  43. package/dist/commands/onboarding/debug/await.d.ts +71 -0
  44. package/dist/commands/onboarding/debug/await.js +18 -0
  45. package/dist/commands/onboarding/debug/disarm.d.ts +63 -0
  46. package/dist/commands/onboarding/debug/disarm.js +12 -0
  47. package/dist/commands/onboarding/debug/eval.d.ts +75 -0
  48. package/dist/commands/onboarding/debug/eval.js +16 -0
  49. package/dist/commands/onboarding/debug/release.d.ts +63 -0
  50. package/dist/commands/onboarding/debug/release.js +12 -0
  51. package/dist/commands/onboarding/debug/resume.d.ts +63 -0
  52. package/dist/commands/onboarding/debug/resume.js +12 -0
  53. package/dist/commands/onboarding/debug/status.d.ts +63 -0
  54. package/dist/commands/onboarding/debug/status.js +12 -0
  55. package/dist/commands/onboarding/debug/step.d.ts +67 -0
  56. package/dist/commands/onboarding/debug/step.js +15 -0
  57. package/dist/commands/onboarding/files/list.d.ts +58 -0
  58. package/dist/commands/onboarding/files/list.js +12 -0
  59. package/dist/commands/onboarding/files/read.d.ts +73 -0
  60. package/dist/commands/onboarding/files/read.js +16 -0
  61. package/dist/commands/onboarding/files/rebuild.d.ts +63 -0
  62. package/dist/commands/onboarding/files/rebuild.js +18 -0
  63. package/dist/commands/onboarding/files/validate.d.ts +58 -0
  64. package/dist/commands/onboarding/files/validate.js +12 -0
  65. package/dist/commands/onboarding/fouc.d.ts +77 -0
  66. package/dist/commands/onboarding/fouc.js +16 -0
  67. package/dist/commands/onboarding/inject/add.d.ts +89 -0
  68. package/dist/commands/onboarding/inject/add.js +17 -0
  69. package/dist/commands/onboarding/inject/clear.d.ts +63 -0
  70. package/dist/commands/onboarding/inject/clear.js +12 -0
  71. package/dist/commands/onboarding/inject/list.d.ts +63 -0
  72. package/dist/commands/onboarding/inject/list.js +12 -0
  73. package/dist/commands/onboarding/inject/read.d.ts +75 -0
  74. package/dist/commands/onboarding/inject/read.js +18 -0
  75. package/dist/commands/onboarding/inject/recipes.d.ts +63 -0
  76. package/dist/commands/onboarding/inject/recipes.js +12 -0
  77. package/dist/commands/onboarding/inject/remove.d.ts +67 -0
  78. package/dist/commands/onboarding/inject/remove.js +15 -0
  79. package/dist/commands/onboarding/list.d.ts +13 -0
  80. package/dist/commands/onboarding/list.js +12 -0
  81. package/dist/commands/onboarding/logs.d.ts +41 -0
  82. package/dist/commands/onboarding/logs.js +256 -0
  83. package/dist/commands/onboarding/navwalk.d.ts +95 -0
  84. package/dist/commands/onboarding/navwalk.js +19 -0
  85. package/dist/commands/onboarding/response.d.ts +67 -0
  86. package/dist/commands/onboarding/response.js +18 -0
  87. package/dist/commands/onboarding/rum/beacons.d.ts +75 -0
  88. package/dist/commands/onboarding/rum/beacons.js +16 -0
  89. package/dist/commands/onboarding/rum/get.d.ts +77 -0
  90. package/dist/commands/onboarding/rum/get.js +18 -0
  91. package/dist/commands/onboarding/rum/key.d.ts +67 -0
  92. package/dist/commands/onboarding/rum/key.js +13 -0
  93. package/dist/commands/onboarding/rum/previous.d.ts +63 -0
  94. package/dist/commands/onboarding/rum/previous.js +12 -0
  95. package/dist/commands/onboarding/status.d.ts +13 -0
  96. package/dist/commands/onboarding/status.js +17 -0
  97. package/dist/commands/onboarding/todo.d.ts +58 -0
  98. package/dist/commands/onboarding/todo.js +12 -0
  99. package/dist/commands/onboarding/viewport.d.ts +101 -0
  100. package/dist/commands/onboarding/viewport.js +18 -0
  101. package/dist/commands/onboarding/watch.d.ts +93 -0
  102. package/dist/commands/onboarding/watch.js +16 -0
  103. package/dist/commands/onboarding.d.ts +26 -0
  104. package/dist/commands/onboarding.js +220 -3
  105. package/dist/commands/origin-request.d.ts +4 -0
  106. package/dist/commands/origin-request.js +4 -0
  107. package/dist/commands/spec/onboarding.spec.d.ts +1 -0
  108. package/dist/commands/spec/onboarding.spec.js +127 -0
  109. package/dist/services/cli/build-info.d.ts +33 -0
  110. package/dist/services/cli/build-info.js +63 -0
  111. package/dist/services/cli/cli-environment-factory.d.ts +3 -0
  112. package/dist/services/cli/cli-environment-factory.js +1 -0
  113. package/dist/services/cli/cli-service-build-context.d.ts +3 -0
  114. package/dist/services/cli/cli-service-factory.js +1 -1
  115. package/dist/services/cli/cli-service-model.d.ts +29 -10
  116. package/dist/services/cli/cli-service.d.ts +60 -11
  117. package/dist/services/cli/cli-service.js +196 -32
  118. package/dist/services/cli/index.d.ts +2 -0
  119. package/dist/services/cli/index.js +2 -0
  120. package/dist/services/cli/sink.d.ts +47 -0
  121. package/dist/services/cli/sink.js +31 -0
  122. package/dist/services/cli/spec/build-identity.spec.d.ts +1 -0
  123. package/dist/services/cli/spec/build-identity.spec.js +85 -0
  124. package/dist/services/cli/spec/build-info.spec.d.ts +1 -0
  125. package/dist/services/cli/spec/build-info.spec.js +10 -0
  126. package/dist/services/cli/spec/cli-service-log.spec.d.ts +1 -0
  127. package/dist/services/cli/spec/cli-service-log.spec.js +133 -0
  128. package/dist/services/cli/spec/cli-service.spec.js +113 -50
  129. package/dist/services/cli/spec/memory-cli.d.ts +9 -0
  130. package/dist/services/cli/spec/memory-cli.js +9 -0
  131. package/dist/services/diff/config-at-ref.d.ts +20 -0
  132. package/dist/services/diff/config-at-ref.js +33 -0
  133. package/dist/services/diff/diff-service-build-context.d.ts +8 -0
  134. package/dist/services/diff/diff-service-build-context.js +40 -1
  135. package/dist/services/diff/diff-service-factory.d.ts +2 -0
  136. package/dist/services/diff/diff-service-factory.js +48 -20
  137. package/dist/services/diff/diff-service.d.ts +11 -0
  138. package/dist/services/diff/diff-service.js +37 -11
  139. package/dist/services/diff/page-source.d.ts +12 -0
  140. package/dist/services/diff/page-source.js +16 -11
  141. package/dist/services/diff/sinks/tool-diff-sink.d.ts +3 -2
  142. package/dist/services/diff/sinks/tool-diff-sink.js +3 -2
  143. package/dist/services/diff/spec/config-at-ref.spec.d.ts +1 -0
  144. package/dist/services/diff/spec/config-at-ref.spec.js +46 -0
  145. package/dist/services/diff/spec/diff-service-build-context.spec.js +19 -0
  146. package/dist/services/diff/spec/diff-service.spec.js +95 -0
  147. package/dist/services/git/git-repository.d.ts +2 -0
  148. package/dist/services/git/git-repository.js +6 -0
  149. package/dist/services/integration-api/customer-config-flags.js +1 -0
  150. package/dist/services/onboarding/browser/baqend-response.d.ts +17 -1
  151. package/dist/services/onboarding/browser/baqend-response.js +23 -0
  152. package/dist/services/onboarding/browser/console-log.d.ts +9 -0
  153. package/dist/services/onboarding/browser/console-log.js +27 -0
  154. package/dist/services/onboarding/browser/executable/executable-validator.js +4 -2
  155. package/dist/services/onboarding/browser/extension/extension-bridge.js +5 -3
  156. package/dist/services/onboarding/browser/extension/extension-downloader.js +17 -8
  157. package/dist/services/onboarding/browser/extension/extension-validator.js +9 -4
  158. package/dist/services/onboarding/control/body-inspect.d.ts +24 -0
  159. package/dist/services/onboarding/control/body-inspect.js +106 -0
  160. package/dist/services/onboarding/control/browser-session.d.ts +521 -0
  161. package/dist/services/onboarding/control/browser-session.js +1273 -0
  162. package/dist/services/onboarding/control/config-validation.d.ts +17 -0
  163. package/dist/services/onboarding/control/config-validation.js +46 -0
  164. package/dist/services/onboarding/control/control-protocol.d.ts +1390 -0
  165. package/dist/services/onboarding/control/control-protocol.js +69 -0
  166. package/dist/services/onboarding/control/control-server.d.ts +284 -0
  167. package/dist/services/onboarding/control/control-server.js +1609 -0
  168. package/dist/services/onboarding/control/debug-session.d.ts +190 -0
  169. package/dist/services/onboarding/control/debug-session.js +801 -0
  170. package/dist/services/onboarding/control/fouc.d.ts +23 -0
  171. package/dist/services/onboarding/control/fouc.js +151 -0
  172. package/dist/services/onboarding/control/index.d.ts +4 -0
  173. package/dist/services/onboarding/control/index.js +4 -0
  174. package/dist/services/onboarding/control/navwalk.d.ts +65 -0
  175. package/dist/services/onboarding/control/navwalk.js +248 -0
  176. package/dist/services/onboarding/control/preload-registry.d.ts +150 -0
  177. package/dist/services/onboarding/control/preload-registry.js +829 -0
  178. package/dist/services/onboarding/control/response-explainer.d.ts +24 -0
  179. package/dist/services/onboarding/control/response-explainer.js +257 -0
  180. package/dist/services/onboarding/control/rum.d.ts +8 -0
  181. package/dist/services/onboarding/control/rum.js +220 -0
  182. package/dist/services/onboarding/control/service-worker-tracker.d.ts +68 -0
  183. package/dist/services/onboarding/control/service-worker-tracker.js +119 -0
  184. package/dist/services/onboarding/control/viewport.d.ts +45 -0
  185. package/dist/services/onboarding/control/viewport.js +344 -0
  186. package/dist/services/onboarding/control/watch.d.ts +26 -0
  187. package/dist/services/onboarding/control/watch.js +149 -0
  188. package/dist/services/onboarding/dashboard/diff-against-current-page.js +3 -1
  189. package/dist/services/onboarding/dashboard/index.js +7 -2
  190. package/dist/services/onboarding/fetch-event-handler.d.ts +24 -5
  191. package/dist/services/onboarding/fetch-event-handler.js +94 -32
  192. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +11 -2
  193. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +14 -0
  194. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +30 -0
  195. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +13 -0
  196. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +28 -1
  197. package/dist/services/onboarding/file-events/file-watcher.d.ts +42 -1
  198. package/dist/services/onboarding/file-events/file-watcher.js +117 -12
  199. package/dist/services/onboarding/onboarding-model.d.ts +30 -0
  200. package/dist/services/onboarding/onboarding-model.js +10 -0
  201. package/dist/services/onboarding/onboarding-service-build-context.d.ts +4 -0
  202. package/dist/services/onboarding/onboarding-service-build-context.js +6 -0
  203. package/dist/services/onboarding/onboarding-service-factory.d.ts +17 -1
  204. package/dist/services/onboarding/onboarding-service-factory.js +131 -17
  205. package/dist/services/onboarding/onboarding-service.d.ts +40 -1
  206. package/dist/services/onboarding/onboarding-service.js +135 -22
  207. package/dist/services/onboarding/request-cache/asset-key.d.ts +61 -0
  208. package/dist/services/onboarding/request-cache/asset-key.js +115 -0
  209. package/dist/services/onboarding/request-cache/cache.d.ts +62 -5
  210. package/dist/services/onboarding/request-cache/cache.js +128 -17
  211. package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +1 -0
  212. package/dist/services/onboarding/spec/browser/console-log.spec.js +42 -0
  213. package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +1 -0
  214. package/dist/services/onboarding/spec/control/browser-session.spec.js +526 -0
  215. package/dist/services/onboarding/spec/control/control-server.spec.d.ts +1 -0
  216. package/dist/services/onboarding/spec/control/control-server.spec.js +338 -0
  217. package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +1 -0
  218. package/dist/services/onboarding/spec/control/debug-session.spec.js +693 -0
  219. package/dist/services/onboarding/spec/control/fakes.d.ts +31 -0
  220. package/dist/services/onboarding/spec/control/fakes.js +66 -0
  221. package/dist/services/onboarding/spec/control/fouc.spec.d.ts +1 -0
  222. package/dist/services/onboarding/spec/control/fouc.spec.js +167 -0
  223. package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +1 -0
  224. package/dist/services/onboarding/spec/control/navwalk.spec.js +222 -0
  225. package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +1 -0
  226. package/dist/services/onboarding/spec/control/preload-registry.spec.js +432 -0
  227. package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +1 -0
  228. package/dist/services/onboarding/spec/control/response-explainer.spec.js +324 -0
  229. package/dist/services/onboarding/spec/control/rum.spec.d.ts +1 -0
  230. package/dist/services/onboarding/spec/control/rum.spec.js +222 -0
  231. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +1 -0
  232. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +193 -0
  233. package/dist/services/onboarding/spec/control/viewport.spec.d.ts +1 -0
  234. package/dist/services/onboarding/spec/control/viewport.spec.js +200 -0
  235. package/dist/services/onboarding/spec/control/watch.spec.d.ts +1 -0
  236. package/dist/services/onboarding/spec/control/watch.spec.js +172 -0
  237. package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +1 -0
  238. package/dist/services/onboarding/spec/fetch-event-handler.spec.js +202 -0
  239. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +1 -0
  240. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +41 -0
  241. package/dist/services/onboarding/spec/onboarding-model.spec.js +37 -0
  242. package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +1 -0
  243. package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +1 -0
  244. package/dist/services/onboarding/spec/request-cache/cache.spec.js +107 -0
  245. package/dist/services/onboarding/spec/todo-collector.spec.d.ts +1 -0
  246. package/dist/services/onboarding/spec/todo-collector.spec.js +136 -0
  247. package/dist/services/onboarding/todo-collector.d.ts +7 -2
  248. package/dist/services/onboarding/todo-collector.js +49 -12
  249. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +34 -0
  250. package/dist/services/onboarding/virtual-orestes-app/index.js +82 -27
  251. package/dist/services/origin-request/asset-variations.d.ts +14 -0
  252. package/dist/services/origin-request/asset-variations.js +11 -4
  253. package/dist/services/origin-request/origin-fetcher.d.ts +7 -0
  254. package/dist/services/origin-request/origin-fetcher.js +43 -5
  255. package/dist/services/origin-request/origin-request-service-build-context.d.ts +17 -0
  256. package/dist/services/origin-request/origin-request-service-build-context.js +8 -0
  257. package/dist/services/origin-request/origin-request-service-factory.d.ts +0 -5
  258. package/dist/services/origin-request/origin-request-service-factory.js +2 -30
  259. package/dist/services/origin-request/origin-request-service.d.ts +121 -6
  260. package/dist/services/origin-request/origin-request-service.js +273 -49
  261. package/dist/services/origin-request/runtime-config-source.js +9 -4
  262. package/dist/services/origin-request/spec/asset-variations.spec.js +20 -0
  263. package/dist/services/origin-request/spec/origin-request-service.spec.js +329 -6
  264. package/dist/services/query-builder/rules/rule-match.d.ts +35 -0
  265. package/dist/services/query-builder/rules/rule-match.js +70 -0
  266. package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +1 -0
  267. package/dist/services/query-builder/spec/rules/rule-match.spec.js +121 -0
  268. package/dist/services/run-control/browser/run-browser-contexts.d.ts +541 -0
  269. package/dist/services/run-control/browser/run-browser-contexts.js +78 -0
  270. package/dist/services/run-control/browser/run-browser-service-factory.d.ts +5 -0
  271. package/dist/services/run-control/browser/run-browser-service-factory.js +7 -0
  272. package/dist/services/run-control/browser/run-browser-service.d.ts +64 -0
  273. package/dist/services/run-control/browser/run-browser-service.js +199 -0
  274. package/dist/services/run-control/cache/run-cache-contexts.d.ts +349 -0
  275. package/dist/services/run-control/cache/run-cache-contexts.js +51 -0
  276. package/dist/services/run-control/cache/run-cache-service-factory.d.ts +6 -0
  277. package/dist/services/run-control/cache/run-cache-service-factory.js +12 -0
  278. package/dist/services/run-control/cache/run-cache-service.d.ts +35 -0
  279. package/dist/services/run-control/cache/run-cache-service.js +151 -0
  280. package/dist/services/run-control/control-client.d.ts +36 -0
  281. package/dist/services/run-control/control-client.js +147 -0
  282. package/dist/services/run-control/debug/run-debug-contexts.d.ts +411 -0
  283. package/dist/services/run-control/debug/run-debug-contexts.js +44 -0
  284. package/dist/services/run-control/debug/run-debug-service-factory.d.ts +5 -0
  285. package/dist/services/run-control/debug/run-debug-service-factory.js +7 -0
  286. package/dist/services/run-control/debug/run-debug-service.d.ts +38 -0
  287. package/dist/services/run-control/debug/run-debug-service.js +161 -0
  288. package/dist/services/run-control/files/run-files-contexts.d.ts +238 -0
  289. package/dist/services/run-control/files/run-files-contexts.js +26 -0
  290. package/dist/services/run-control/files/run-files-service-factory.d.ts +5 -0
  291. package/dist/services/run-control/files/run-files-service-factory.js +7 -0
  292. package/dist/services/run-control/files/run-files-service.d.ts +29 -0
  293. package/dist/services/run-control/files/run-files-service.js +120 -0
  294. package/dist/services/run-control/index.d.ts +32 -0
  295. package/dist/services/run-control/index.js +31 -0
  296. package/dist/services/run-control/inject/run-inject-contexts.d.ts +319 -0
  297. package/dist/services/run-control/inject/run-inject-contexts.js +32 -0
  298. package/dist/services/run-control/inject/run-inject-service-factory.d.ts +5 -0
  299. package/dist/services/run-control/inject/run-inject-service-factory.js +7 -0
  300. package/dist/services/run-control/inject/run-inject-service.d.ts +31 -0
  301. package/dist/services/run-control/inject/run-inject-service.js +203 -0
  302. package/dist/services/run-control/live-run.d.ts +37 -0
  303. package/dist/services/run-control/live-run.js +56 -0
  304. package/dist/services/run-control/probe/run-probe-contexts.d.ts +333 -0
  305. package/dist/services/run-control/probe/run-probe-contexts.js +73 -0
  306. package/dist/services/run-control/probe/run-probe-service-factory.d.ts +5 -0
  307. package/dist/services/run-control/probe/run-probe-service-factory.js +7 -0
  308. package/dist/services/run-control/probe/run-probe-service.d.ts +54 -0
  309. package/dist/services/run-control/probe/run-probe-service.js +193 -0
  310. package/dist/services/run-control/rum/run-rum-contexts.d.ts +216 -0
  311. package/dist/services/run-control/rum/run-rum-contexts.js +34 -0
  312. package/dist/services/run-control/rum/run-rum-service-factory.d.ts +5 -0
  313. package/dist/services/run-control/rum/run-rum-service-factory.js +7 -0
  314. package/dist/services/run-control/rum/run-rum-service.d.ts +36 -0
  315. package/dist/services/run-control/rum/run-rum-service.js +122 -0
  316. package/dist/services/run-control/run-answer.d.ts +28 -0
  317. package/dist/services/run-control/run-answer.js +58 -0
  318. package/dist/services/run-control/run-control-context.d.ts +102 -0
  319. package/dist/services/run-control/run-control-context.js +36 -0
  320. package/dist/services/run-control/run-control-flags.d.ts +12 -0
  321. package/dist/services/run-control/run-control-flags.js +22 -0
  322. package/dist/services/run-control/run-control-model.d.ts +9 -0
  323. package/dist/services/run-control/run-control-model.js +1 -0
  324. package/dist/services/run-control/run-control-service-factory.d.ts +14 -0
  325. package/dist/services/run-control/run-control-service-factory.js +26 -0
  326. package/dist/services/run-control/session/run-session-contexts.d.ts +25 -0
  327. package/dist/services/run-control/session/run-session-contexts.js +20 -0
  328. package/dist/services/run-control/session/run-session-service-factory.d.ts +8 -0
  329. package/dist/services/run-control/session/run-session-service-factory.js +18 -0
  330. package/dist/services/run-control/session/run-session-service.d.ts +25 -0
  331. package/dist/services/run-control/session/run-session-service.js +95 -0
  332. package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +1 -0
  333. package/dist/services/run-control/spec/browser/run-browser-service.spec.js +327 -0
  334. package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +1 -0
  335. package/dist/services/run-control/spec/cache/run-cache-service.spec.js +454 -0
  336. package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +1 -0
  337. package/dist/services/run-control/spec/debug/run-debug-service.spec.js +113 -0
  338. package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +1 -0
  339. package/dist/services/run-control/spec/files/run-files-service.spec.js +234 -0
  340. package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +1 -0
  341. package/dist/services/run-control/spec/inject/run-inject-service.spec.js +224 -0
  342. package/dist/services/run-control/spec/live-run-fixture.d.ts +32 -0
  343. package/dist/services/run-control/spec/live-run-fixture.js +109 -0
  344. package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +1 -0
  345. package/dist/services/run-control/spec/probe/run-probe-service.spec.js +108 -0
  346. package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +1 -0
  347. package/dist/services/run-control/spec/rum/run-rum-service.spec.js +47 -0
  348. package/dist/services/run-control/spec/run-answer.spec.d.ts +1 -0
  349. package/dist/services/run-control/spec/run-answer.spec.js +57 -0
  350. package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +1 -0
  351. package/dist/services/run-control/spec/session/run-session-service.spec.js +101 -0
  352. package/dist/services/run-log/crash-mirror.d.ts +31 -0
  353. package/dist/services/run-log/crash-mirror.js +69 -0
  354. package/dist/services/run-log/index.d.ts +11 -0
  355. package/dist/services/run-log/index.js +11 -0
  356. package/dist/services/run-log/jsonl-appender.d.ts +46 -0
  357. package/dist/services/run-log/jsonl-appender.js +91 -0
  358. package/dist/services/run-log/log-event-model.d.ts +104 -0
  359. package/dist/services/run-log/log-event-model.js +56 -0
  360. package/dist/services/run-log/log-query-service-factory.d.ts +11 -0
  361. package/dist/services/run-log/log-query-service-factory.js +14 -0
  362. package/dist/services/run-log/log-query-service.d.ts +59 -0
  363. package/dist/services/run-log/log-query-service.js +111 -0
  364. package/dist/services/run-log/log-reader.d.ts +84 -0
  365. package/dist/services/run-log/log-reader.js +180 -0
  366. package/dist/services/run-log/log-summary.d.ts +72 -0
  367. package/dist/services/run-log/log-summary.js +208 -0
  368. package/dist/services/run-log/redaction.d.ts +34 -0
  369. package/dist/services/run-log/redaction.js +124 -0
  370. package/dist/services/run-log/request-log.d.ts +80 -0
  371. package/dist/services/run-log/request-log.js +69 -0
  372. package/dist/services/run-log/request-summary.d.ts +76 -0
  373. package/dist/services/run-log/request-summary.js +0 -0
  374. package/dist/services/run-log/run-log.d.ts +61 -0
  375. package/dist/services/run-log/run-log.js +102 -0
  376. package/dist/services/run-log/spec/log-query-service.spec.d.ts +1 -0
  377. package/dist/services/run-log/spec/log-query-service.spec.js +197 -0
  378. package/dist/services/run-log/spec/log-reader.spec.d.ts +1 -0
  379. package/dist/services/run-log/spec/log-reader.spec.js +109 -0
  380. package/dist/services/run-log/spec/log-summary.spec.d.ts +1 -0
  381. package/dist/services/run-log/spec/log-summary.spec.js +153 -0
  382. package/dist/services/run-log/spec/redaction.spec.d.ts +1 -0
  383. package/dist/services/run-log/spec/redaction.spec.js +61 -0
  384. package/dist/services/run-log/spec/request-log.spec.d.ts +1 -0
  385. package/dist/services/run-log/spec/request-log.spec.js +101 -0
  386. package/dist/services/run-log/spec/request-summary.spec.d.ts +1 -0
  387. package/dist/services/run-log/spec/request-summary.spec.js +171 -0
  388. package/dist/services/run-log/spec/run-log.spec.d.ts +1 -0
  389. package/dist/services/run-log/spec/run-log.spec.js +122 -0
  390. package/dist/services/run-registry/exit-classification.d.ts +39 -0
  391. package/dist/services/run-registry/exit-classification.js +42 -0
  392. package/dist/services/run-registry/index.d.ts +3 -0
  393. package/dist/services/run-registry/index.js +3 -0
  394. package/dist/services/run-registry/process-identity.d.ts +28 -0
  395. package/dist/services/run-registry/process-identity.js +80 -0
  396. package/dist/services/run-registry/run-registry-model.d.ts +128 -0
  397. package/dist/services/run-registry/run-registry-model.js +16 -0
  398. package/dist/services/run-registry/run-registry.d.ts +150 -0
  399. package/dist/services/run-registry/run-registry.js +409 -0
  400. package/dist/services/run-registry/spec/exit-classification.spec.d.ts +1 -0
  401. package/dist/services/run-registry/spec/exit-classification.spec.js +82 -0
  402. package/dist/services/run-registry/spec/run-registry.spec.d.ts +1 -0
  403. package/dist/services/run-registry/spec/run-registry.spec.js +509 -0
  404. package/dist/services/setup/os/tool-registry.js +2 -2
  405. package/oclif.manifest.json +3293 -272
  406. package/package.json +20 -2
@@ -0,0 +1,411 @@
1
+ export declare const DebugArmBuildContext: {
2
+ new (values: import("../run-control-context.js").RunControlBuildContextValues<{
3
+ [x: string]: any;
4
+ } & {
5
+ bp: number[];
6
+ then: "none" | "reload" | "next-nav";
7
+ tab: string;
8
+ json: boolean | undefined;
9
+ }>): {
10
+ readonly run?: string;
11
+ readonly json: boolean;
12
+ readonly timeout?: number;
13
+ readonly tab?: string;
14
+ readonly input: {
15
+ [x: string]: any;
16
+ } & {
17
+ bp: number[];
18
+ then: "none" | "reload" | "next-nav";
19
+ tab: string;
20
+ json: boolean | undefined;
21
+ };
22
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
23
+ };
24
+ readonly args: {};
25
+ readonly flags: {
26
+ run: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
27
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
28
+ timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
29
+ } & {
30
+ bp: import("@oclif/core/interfaces").OptionFlag<number[], import("@oclif/core/interfaces").CustomOptions>;
31
+ then: import("@oclif/core/interfaces").OptionFlag<"none" | "reload" | "next-nav", import("@oclif/core/interfaces").CustomOptions>;
32
+ } & {
33
+ tab: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
34
+ };
35
+ create(parsedArgs: {
36
+ [x: string]: any;
37
+ }, parsedFlags: {
38
+ run: string;
39
+ json: boolean | undefined;
40
+ timeout: number;
41
+ bp: number[];
42
+ then: "none" | "reload" | "next-nav";
43
+ tab: string;
44
+ }, environment: import("../../cli/cli-environment.js").CliEnvironment): {
45
+ readonly run?: string;
46
+ readonly json: boolean;
47
+ readonly timeout?: number;
48
+ readonly tab?: string;
49
+ readonly input: {
50
+ [x: string]: any;
51
+ } & {
52
+ bp: number[];
53
+ then: "none" | "reload" | "next-nav";
54
+ tab: string;
55
+ json: boolean | undefined;
56
+ };
57
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
58
+ };
59
+ };
60
+ export declare const DebugStatusBuildContext: {
61
+ new (values: import("../run-control-context.js").RunControlBuildContextValues<{
62
+ [x: string]: any;
63
+ } & {
64
+ tab: string;
65
+ json: boolean | undefined;
66
+ }>): {
67
+ readonly run?: string;
68
+ readonly json: boolean;
69
+ readonly timeout?: number;
70
+ readonly tab?: string;
71
+ readonly input: {
72
+ [x: string]: any;
73
+ } & {
74
+ tab: string;
75
+ json: boolean | undefined;
76
+ };
77
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
78
+ };
79
+ readonly args: {};
80
+ readonly flags: {
81
+ run: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
82
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
83
+ timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
84
+ } & {
85
+ tab: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
86
+ };
87
+ create(parsedArgs: {
88
+ [x: string]: any;
89
+ }, parsedFlags: {
90
+ run: string;
91
+ json: boolean | undefined;
92
+ timeout: number;
93
+ tab: string;
94
+ }, environment: import("../../cli/cli-environment.js").CliEnvironment): {
95
+ readonly run?: string;
96
+ readonly json: boolean;
97
+ readonly timeout?: number;
98
+ readonly tab?: string;
99
+ readonly input: {
100
+ [x: string]: any;
101
+ } & {
102
+ tab: string;
103
+ json: boolean | undefined;
104
+ };
105
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
106
+ };
107
+ };
108
+ export declare const DebugAwaitBuildContext: {
109
+ new (values: import("../run-control-context.js").RunControlBuildContextValues<{
110
+ [x: string]: any;
111
+ } & {
112
+ wait: number;
113
+ tab: string;
114
+ json: boolean | undefined;
115
+ }>): {
116
+ readonly run?: string;
117
+ readonly json: boolean;
118
+ readonly timeout?: number;
119
+ readonly tab?: string;
120
+ readonly input: {
121
+ [x: string]: any;
122
+ } & {
123
+ wait: number;
124
+ tab: string;
125
+ json: boolean | undefined;
126
+ };
127
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
128
+ };
129
+ readonly args: {};
130
+ readonly flags: {
131
+ run: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
132
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
133
+ timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
134
+ } & {
135
+ wait: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
136
+ } & {
137
+ tab: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
138
+ };
139
+ create(parsedArgs: {
140
+ [x: string]: any;
141
+ }, parsedFlags: {
142
+ run: string;
143
+ json: boolean | undefined;
144
+ timeout: number;
145
+ wait: number;
146
+ tab: string;
147
+ }, environment: import("../../cli/cli-environment.js").CliEnvironment): {
148
+ readonly run?: string;
149
+ readonly json: boolean;
150
+ readonly timeout?: number;
151
+ readonly tab?: string;
152
+ readonly input: {
153
+ [x: string]: any;
154
+ } & {
155
+ wait: number;
156
+ tab: string;
157
+ json: boolean | undefined;
158
+ };
159
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
160
+ };
161
+ };
162
+ export declare const DebugEvalBuildContext: {
163
+ new (values: import("../run-control-context.js").RunControlBuildContextValues<{
164
+ expression: string;
165
+ } & {
166
+ file: string;
167
+ tab: string;
168
+ json: boolean | undefined;
169
+ }>): {
170
+ readonly run?: string;
171
+ readonly json: boolean;
172
+ readonly timeout?: number;
173
+ readonly tab?: string;
174
+ readonly input: {
175
+ expression: string;
176
+ } & {
177
+ file: string;
178
+ tab: string;
179
+ json: boolean | undefined;
180
+ };
181
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
182
+ };
183
+ readonly args: {
184
+ expression: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
185
+ };
186
+ readonly flags: {
187
+ run: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
188
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
189
+ timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
190
+ } & {
191
+ file: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
192
+ } & {
193
+ tab: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
194
+ };
195
+ create(parsedArgs: {
196
+ expression: string;
197
+ }, parsedFlags: {
198
+ run: string;
199
+ json: boolean | undefined;
200
+ timeout: number;
201
+ file: string;
202
+ tab: string;
203
+ }, environment: import("../../cli/cli-environment.js").CliEnvironment): {
204
+ readonly run?: string;
205
+ readonly json: boolean;
206
+ readonly timeout?: number;
207
+ readonly tab?: string;
208
+ readonly input: {
209
+ expression: string;
210
+ } & {
211
+ file: string;
212
+ tab: string;
213
+ json: boolean | undefined;
214
+ };
215
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
216
+ };
217
+ };
218
+ export declare const DebugResumeBuildContext: {
219
+ new (values: import("../run-control-context.js").RunControlBuildContextValues<{
220
+ [x: string]: any;
221
+ } & {
222
+ tab: string;
223
+ json: boolean | undefined;
224
+ }>): {
225
+ readonly run?: string;
226
+ readonly json: boolean;
227
+ readonly timeout?: number;
228
+ readonly tab?: string;
229
+ readonly input: {
230
+ [x: string]: any;
231
+ } & {
232
+ tab: string;
233
+ json: boolean | undefined;
234
+ };
235
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
236
+ };
237
+ readonly args: {};
238
+ readonly flags: {
239
+ run: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
240
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
241
+ timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
242
+ } & {
243
+ tab: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
244
+ };
245
+ create(parsedArgs: {
246
+ [x: string]: any;
247
+ }, parsedFlags: {
248
+ run: string;
249
+ json: boolean | undefined;
250
+ timeout: number;
251
+ tab: string;
252
+ }, environment: import("../../cli/cli-environment.js").CliEnvironment): {
253
+ readonly run?: string;
254
+ readonly json: boolean;
255
+ readonly timeout?: number;
256
+ readonly tab?: string;
257
+ readonly input: {
258
+ [x: string]: any;
259
+ } & {
260
+ tab: string;
261
+ json: boolean | undefined;
262
+ };
263
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
264
+ };
265
+ };
266
+ export declare const DebugStepBuildContext: {
267
+ new (values: import("../run-control-context.js").RunControlBuildContextValues<{
268
+ kind: string;
269
+ } & {
270
+ tab: string;
271
+ json: boolean | undefined;
272
+ }>): {
273
+ readonly run?: string;
274
+ readonly json: boolean;
275
+ readonly timeout?: number;
276
+ readonly tab?: string;
277
+ readonly input: {
278
+ kind: string;
279
+ } & {
280
+ tab: string;
281
+ json: boolean | undefined;
282
+ };
283
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
284
+ };
285
+ readonly args: {
286
+ kind: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
287
+ };
288
+ readonly flags: {
289
+ run: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
290
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
291
+ timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
292
+ } & {
293
+ tab: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
294
+ };
295
+ create(parsedArgs: {
296
+ kind: string;
297
+ }, parsedFlags: {
298
+ run: string;
299
+ json: boolean | undefined;
300
+ timeout: number;
301
+ tab: string;
302
+ }, environment: import("../../cli/cli-environment.js").CliEnvironment): {
303
+ readonly run?: string;
304
+ readonly json: boolean;
305
+ readonly timeout?: number;
306
+ readonly tab?: string;
307
+ readonly input: {
308
+ kind: string;
309
+ } & {
310
+ tab: string;
311
+ json: boolean | undefined;
312
+ };
313
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
314
+ };
315
+ };
316
+ export declare const DebugDisarmBuildContext: {
317
+ new (values: import("../run-control-context.js").RunControlBuildContextValues<{
318
+ [x: string]: any;
319
+ } & {
320
+ tab: string;
321
+ json: boolean | undefined;
322
+ }>): {
323
+ readonly run?: string;
324
+ readonly json: boolean;
325
+ readonly timeout?: number;
326
+ readonly tab?: string;
327
+ readonly input: {
328
+ [x: string]: any;
329
+ } & {
330
+ tab: string;
331
+ json: boolean | undefined;
332
+ };
333
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
334
+ };
335
+ readonly args: {};
336
+ readonly flags: {
337
+ run: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
338
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
339
+ timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
340
+ } & {
341
+ tab: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
342
+ };
343
+ create(parsedArgs: {
344
+ [x: string]: any;
345
+ }, parsedFlags: {
346
+ run: string;
347
+ json: boolean | undefined;
348
+ timeout: number;
349
+ tab: string;
350
+ }, environment: import("../../cli/cli-environment.js").CliEnvironment): {
351
+ readonly run?: string;
352
+ readonly json: boolean;
353
+ readonly timeout?: number;
354
+ readonly tab?: string;
355
+ readonly input: {
356
+ [x: string]: any;
357
+ } & {
358
+ tab: string;
359
+ json: boolean | undefined;
360
+ };
361
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
362
+ };
363
+ };
364
+ export declare const DebugReleaseBuildContext: {
365
+ new (values: import("../run-control-context.js").RunControlBuildContextValues<{
366
+ [x: string]: any;
367
+ } & {
368
+ tab: string;
369
+ json: boolean | undefined;
370
+ }>): {
371
+ readonly run?: string;
372
+ readonly json: boolean;
373
+ readonly timeout?: number;
374
+ readonly tab?: string;
375
+ readonly input: {
376
+ [x: string]: any;
377
+ } & {
378
+ tab: string;
379
+ json: boolean | undefined;
380
+ };
381
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
382
+ };
383
+ readonly args: {};
384
+ readonly flags: {
385
+ run: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
386
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
387
+ timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
388
+ } & {
389
+ tab: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
390
+ };
391
+ create(parsedArgs: {
392
+ [x: string]: any;
393
+ }, parsedFlags: {
394
+ run: string;
395
+ json: boolean | undefined;
396
+ timeout: number;
397
+ tab: string;
398
+ }, environment: import("../../cli/cli-environment.js").CliEnvironment): {
399
+ readonly run?: string;
400
+ readonly json: boolean;
401
+ readonly timeout?: number;
402
+ readonly tab?: string;
403
+ readonly input: {
404
+ [x: string]: any;
405
+ } & {
406
+ tab: string;
407
+ json: boolean | undefined;
408
+ };
409
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
410
+ };
411
+ };
@@ -0,0 +1,44 @@
1
+ import { Args, Flags } from "@oclif/core";
2
+ import { pageControlContext } from "../run-control-context.js";
3
+ export const DebugArmBuildContext = pageControlContext({}, {
4
+ bp: Flags.integer({
5
+ multiple: true,
6
+ min: 1,
7
+ max: 4,
8
+ description: "Which breakpoint, 1–4; repeat for several. Omitted arms all four",
9
+ }),
10
+ then: Flags.option({
11
+ options: ["reload", "next-nav", "none"],
12
+ default: "reload",
13
+ description: "reload: load the page again, as a navigation (Speed Kit does not serve a reload from cache). next-nav: catch the next navigation. none: only arm",
14
+ })(),
15
+ });
16
+ export const DebugStatusBuildContext = pageControlContext({}, {});
17
+ export const DebugAwaitBuildContext = pageControlContext({}, {
18
+ wait: Flags.integer({
19
+ description: "How long to wait for a pause, in ms. Default 15000",
20
+ }),
21
+ });
22
+ export const DebugEvalBuildContext = pageControlContext({
23
+ expression: Args.string({
24
+ name: "expression",
25
+ required: false,
26
+ description: "JavaScript, evaluated on the paused frame when paused (its locals are in scope), in the page otherwise. Or --file",
27
+ }),
28
+ }, {
29
+ file: Flags.string({
30
+ char: "f",
31
+ description: "Read the JavaScript from this file instead: for anything longer than a line",
32
+ }),
33
+ });
34
+ export const DebugResumeBuildContext = pageControlContext({}, {});
35
+ export const DebugStepBuildContext = pageControlContext({
36
+ kind: Args.string({
37
+ name: "kind",
38
+ required: true,
39
+ options: ["over", "into", "out"],
40
+ description: "Step over, into or out of the current call",
41
+ }),
42
+ }, {});
43
+ export const DebugDisarmBuildContext = pageControlContext({}, {});
44
+ export const DebugReleaseBuildContext = pageControlContext({}, {});
@@ -0,0 +1,5 @@
1
+ import { RunControlServiceFactory } from "../run-control-service-factory.js";
2
+ import { RunDebugService } from "./run-debug-service.js";
3
+ export declare class RunDebugServiceFactory extends RunControlServiceFactory<RunDebugService> {
4
+ buildService(): RunDebugService;
5
+ }
@@ -0,0 +1,7 @@
1
+ import { RunControlServiceFactory } from "../run-control-service-factory.js";
2
+ import { RunDebugService } from "./run-debug-service.js";
3
+ export class RunDebugServiceFactory extends RunControlServiceFactory {
4
+ buildService() {
5
+ return new RunDebugService(this.deps((dead) => `Run ${dead.meta.id} is ${dead.status}. A breakpoint needs a page to stop.`));
6
+ }
7
+ }
@@ -0,0 +1,38 @@
1
+ import { DebugStepKind, DebugThen } from "../../onboarding/control/control-protocol.js";
2
+ import { RunControlServiceDeps } from "../run-control-model.js";
3
+ export interface DebugArmInput {
4
+ bps?: number[];
5
+ then?: DebugThen;
6
+ }
7
+ /**
8
+ * Breakpoints in Speed Kit's own page lifecycle: BP1 before the merge and any
9
+ * page JS, BP2 after the merge, BP3 when the SSR comparison finished, BP4
10
+ * after the SSR containers were removed.
11
+ *
12
+ * The armed state lives in the run, so `arm`, `await`, `eval` and `resume`
13
+ * can be four separate commands.
14
+ */
15
+ export declare class RunDebugService {
16
+ private readonly cli;
17
+ private readonly run;
18
+ private readonly answer;
19
+ constructor(deps: RunControlServiceDeps);
20
+ arm(input: DebugArmInput): Promise<void>;
21
+ status(): Promise<void>;
22
+ /** Block until something pauses, and say what silence means if nothing does. */
23
+ awaitPause(timeoutMs?: number): Promise<void>;
24
+ /** On the paused frame when paused — the only way to see its locals. */
25
+ eval(input: {
26
+ expression?: string;
27
+ file?: string;
28
+ }): Promise<void>;
29
+ resume(): Promise<void>;
30
+ step(kind: DebugStepKind): Promise<void>;
31
+ disarm(): Promise<void>;
32
+ /** Get the page running, whoever paused it. */
33
+ release(): Promise<void>;
34
+ private act;
35
+ /** The expression, or the file's contents — exactly one of them. */
36
+ private source;
37
+ private breakpoints;
38
+ }
@@ -0,0 +1,161 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import { ControlError } from "../control-client.js";
3
+ /** How long `await` waits for a pause unless told otherwise. */
4
+ const DEFAULT_AWAIT_MS = 15_000;
5
+ /** Room for the wait itself: the socket has to outlast the run's own timer. */
6
+ const AWAIT_SLACK_MS = 5_000;
7
+ /**
8
+ * Breakpoints in Speed Kit's own page lifecycle: BP1 before the merge and any
9
+ * page JS, BP2 after the merge, BP3 when the SSR comparison finished, BP4
10
+ * after the SSR containers were removed.
11
+ *
12
+ * The armed state lives in the run, so `arm`, `await`, `eval` and `resume`
13
+ * can be four separate commands.
14
+ */
15
+ export class RunDebugService {
16
+ cli;
17
+ run;
18
+ answer;
19
+ constructor(deps) {
20
+ this.cli = deps.cli;
21
+ this.run = deps.run;
22
+ this.answer = deps.answer;
23
+ }
24
+ async arm(input) {
25
+ const data = await this.run.request({
26
+ op: "debug.arm",
27
+ ...input,
28
+ });
29
+ this.answer.give(summariseStatus(data, input.then), { run: this.run.id, ...data }, () => this.breakpoints(data));
30
+ }
31
+ async status() {
32
+ const data = await this.run.request({
33
+ op: "debug.status",
34
+ });
35
+ this.answer.give(summariseStatus(data), { run: this.run.id, ...data }, () => this.breakpoints(data));
36
+ }
37
+ /** Block until something pauses, and say what silence means if nothing does. */
38
+ async awaitPause(timeoutMs = DEFAULT_AWAIT_MS) {
39
+ const data = await this.run.request({ op: "debug.await", timeoutMs }, timeoutMs + AWAIT_SLACK_MS);
40
+ this.answer.give(summariseAwait(data), { run: this.run.id, ...data }, () => {
41
+ const pause = data.pause;
42
+ if (!pause) {
43
+ return;
44
+ }
45
+ this.cli.comment(`at ${pause.scriptUrl ?? pause.url ?? "?"}${pause.location ? `:${pause.location.lineNumber}` : ""}`);
46
+ this.cli.comment(`html ${pause.state.htmlClass ?? "-"} group ${pause.state.skGroup ?? "-"}`);
47
+ for (const mark of pause.state.marks) {
48
+ this.cli.write(` ${String(mark.t).padStart(7)} ${mark.name}`);
49
+ }
50
+ });
51
+ }
52
+ /** On the paused frame when paused — the only way to see its locals. */
53
+ async eval(input) {
54
+ const data = await this.run.request({
55
+ op: "debug.eval",
56
+ expression: await this.source(input),
57
+ });
58
+ this.answer.give(summariseEval(data), { run: this.run.id, ...data }, () => {
59
+ if (!data.exception) {
60
+ this.cli.write(JSON.stringify(data.value, undefined, 2) ?? "undefined");
61
+ }
62
+ });
63
+ }
64
+ async resume() {
65
+ await this.act({ op: "debug.resume" });
66
+ }
67
+ async step(kind) {
68
+ await this.act({ op: "debug.step", kind });
69
+ }
70
+ async disarm() {
71
+ await this.act({ op: "debug.disarm" });
72
+ }
73
+ /** Get the page running, whoever paused it. */
74
+ async release() {
75
+ const data = await this.run.request({
76
+ op: "debug.release",
77
+ });
78
+ this.answer.give(data.did, { run: this.run.id, ...data });
79
+ }
80
+ async act(command) {
81
+ const data = await this.run.request(command);
82
+ this.answer.give(data.did, { run: this.run.id, ...data });
83
+ }
84
+ /** The expression, or the file's contents — exactly one of them. */
85
+ async source(input) {
86
+ if (Boolean(input.expression) === Boolean(input.file)) {
87
+ throw new ControlError("EXPRESSION_REQUIRED", "Pass an expression or --file, one of the two.");
88
+ }
89
+ if (input.expression) {
90
+ return input.expression;
91
+ }
92
+ try {
93
+ return await readFile(input.file, "utf8");
94
+ }
95
+ catch (error) {
96
+ throw new ControlError("NO_SUCH_FILE", `Could not read ${input.file}: ${error instanceof Error ? error.message : String(error)}`, { file: input.file });
97
+ }
98
+ }
99
+ breakpoints(data) {
100
+ for (const bp of data.breakpoints) {
101
+ this.cli.write(`${bp.armed ? "●" : "○"} BP${bp.bp} ${bp.seen ? "reached" : "not reached"} ${this.cli.style.grey(bp.description)}`);
102
+ }
103
+ }
104
+ }
105
+ /** The panel switches set in the page, as a clause, or "" when there are none. */
106
+ function panelSwitches(data) {
107
+ return data.pageArmed?.length
108
+ ? `, but the devtools panel has ${data.pageArmed.join(", ")} set in the page`
109
+ : "";
110
+ }
111
+ function summariseStatus(data, then) {
112
+ if (data.paused && data.pause) {
113
+ // The reason is worth a word only when it names something: "other" is
114
+ // what CDP reports for a `debugger;` statement, which every pause here is.
115
+ const reason = data.pause.reason === "other" ? "" : ` (${data.pause.reason})`;
116
+ return `paused at ${data.pause.bp}${reason} — \`eval\` sees the frame's locals, \`resume\` continues.`;
117
+ }
118
+ if (data.pausedBy === "elsewhere") {
119
+ return `the page is paused, and not by this run${panelSwitches(data)} — \`release\` gets it running.`;
120
+ }
121
+ if (data.armed.length === 0) {
122
+ // Not attached means not listening, so a pause held by DevTools would not
123
+ // show here; saying "not paused" would be a guess.
124
+ const switches = panelSwitches(data);
125
+ if (switches) {
126
+ return `nothing armed by this run${switches} — the next load pauses with DevTools open. \`release\` clears them.`;
127
+ }
128
+ return data.paused === null
129
+ ? "nothing armed on this run, and not attached — a pause held elsewhere (DevTools) would not show here"
130
+ : "nothing armed on this run";
131
+ }
132
+ const armed = `BP${data.armed.join(", BP")} armed`;
133
+ // Said on the `arm` answer rather than left to memory: a hook only runs at
134
+ // document start, and arming without reloading reads as a broken breakpoint.
135
+ if (then === "reload") {
136
+ return `${armed}, and the page is reloading. \`await\` next.`;
137
+ }
138
+ if (then === "next-nav") {
139
+ return `${armed}, waiting for the next navigation.`;
140
+ }
141
+ return `${armed} — nothing will pause until the page loads again.`;
142
+ }
143
+ /**
144
+ * Leads with the diagnosis, not with the timeout: "armed but silent" has three
145
+ * meanings that call for opposite next moves.
146
+ */
147
+ function summariseAwait(data) {
148
+ if (data.fired && data.pause) {
149
+ const marks = data.pause.state.marks.length;
150
+ return `paused at ${data.pause.bp} after ${data.waitedMs}ms, ${marks} mark${marks === 1 ? "" : "s"} written so far. \`eval\` to inspect, \`resume\` to continue.`;
151
+ }
152
+ return `nothing paused in ${data.waitedMs}ms. ${data.diagnosis ?? ""}`.trim();
153
+ }
154
+ function summariseEval(data) {
155
+ const where = data.onCallFrame
156
+ ? "on the paused frame"
157
+ : "in the page (not paused, so no locals)";
158
+ return data.exception
159
+ ? `threw ${where}: ${data.exception}`
160
+ : `evaluated ${where}`;
161
+ }