@speedkit/cli 4.51.0 → 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 (441) hide show
  1. package/CHANGELOG.md +14 -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/spec/speed-kit-install-js.spec.d.ts +1 -0
  216. package/dist/services/onboarding/fetch-events/spec/speed-kit-install-js.spec.js +59 -0
  217. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +16 -5
  218. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +14 -0
  219. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +30 -0
  220. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +13 -0
  221. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +28 -1
  222. package/dist/services/onboarding/file-events/file-watcher.d.ts +42 -1
  223. package/dist/services/onboarding/file-events/file-watcher.js +117 -12
  224. package/dist/services/onboarding/inject/inject-service.js +1 -1
  225. package/dist/services/onboarding/onboarding-model.d.ts +40 -7
  226. package/dist/services/onboarding/onboarding-model.js +20 -9
  227. package/dist/services/onboarding/onboarding-service-build-context.d.ts +4 -0
  228. package/dist/services/onboarding/onboarding-service-build-context.js +7 -1
  229. package/dist/services/onboarding/onboarding-service-factory.d.ts +17 -1
  230. package/dist/services/onboarding/onboarding-service-factory.js +150 -23
  231. package/dist/services/onboarding/onboarding-service.d.ts +40 -1
  232. package/dist/services/onboarding/onboarding-service.js +139 -23
  233. package/dist/services/onboarding/request-cache/asset-key.d.ts +61 -0
  234. package/dist/services/onboarding/request-cache/asset-key.js +115 -0
  235. package/dist/services/onboarding/request-cache/cache.d.ts +62 -5
  236. package/dist/services/onboarding/request-cache/cache.js +128 -17
  237. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.d.ts +1 -0
  238. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.js +66 -0
  239. package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +1 -0
  240. package/dist/services/onboarding/spec/browser/console-log.spec.js +42 -0
  241. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.d.ts +1 -0
  242. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.js +45 -0
  243. package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +1 -0
  244. package/dist/services/onboarding/spec/control/browser-session.spec.js +753 -0
  245. package/dist/services/onboarding/spec/control/control-server.spec.d.ts +1 -0
  246. package/dist/services/onboarding/spec/control/control-server.spec.js +371 -0
  247. package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +1 -0
  248. package/dist/services/onboarding/spec/control/debug-session.spec.js +751 -0
  249. package/dist/services/onboarding/spec/control/fakes.d.ts +31 -0
  250. package/dist/services/onboarding/spec/control/fakes.js +67 -0
  251. package/dist/services/onboarding/spec/control/fouc.spec.d.ts +1 -0
  252. package/dist/services/onboarding/spec/control/fouc.spec.js +167 -0
  253. package/dist/services/onboarding/spec/control/navigate-wait.spec.d.ts +1 -0
  254. package/dist/services/onboarding/spec/control/navigate-wait.spec.js +47 -0
  255. package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +1 -0
  256. package/dist/services/onboarding/spec/control/navwalk.spec.js +222 -0
  257. package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +1 -0
  258. package/dist/services/onboarding/spec/control/preload-registry.spec.js +432 -0
  259. package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +1 -0
  260. package/dist/services/onboarding/spec/control/response-explainer.spec.js +324 -0
  261. package/dist/services/onboarding/spec/control/rum.spec.d.ts +1 -0
  262. package/dist/services/onboarding/spec/control/rum.spec.js +222 -0
  263. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +1 -0
  264. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +193 -0
  265. package/dist/services/onboarding/spec/control/viewport.spec.d.ts +1 -0
  266. package/dist/services/onboarding/spec/control/viewport.spec.js +200 -0
  267. package/dist/services/onboarding/spec/control/watch.spec.d.ts +1 -0
  268. package/dist/services/onboarding/spec/control/watch.spec.js +187 -0
  269. package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +1 -0
  270. package/dist/services/onboarding/spec/fetch-event-handler.spec.js +219 -0
  271. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +1 -0
  272. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +41 -0
  273. package/dist/services/onboarding/spec/onboarding-model.spec.js +39 -3
  274. package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +25 -1
  275. package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +1 -0
  276. package/dist/services/onboarding/spec/request-cache/cache.spec.js +107 -0
  277. package/dist/services/onboarding/spec/todo-collector.spec.d.ts +1 -0
  278. package/dist/services/onboarding/spec/todo-collector.spec.js +136 -0
  279. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.d.ts +1 -0
  280. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.js +65 -0
  281. package/dist/services/onboarding/todo-collector.d.ts +7 -2
  282. package/dist/services/onboarding/todo-collector.js +49 -12
  283. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +38 -0
  284. package/dist/services/onboarding/virtual-orestes-app/index.js +113 -27
  285. package/dist/services/origin-request/asset-variations.d.ts +14 -0
  286. package/dist/services/origin-request/asset-variations.js +11 -4
  287. package/dist/services/origin-request/origin-fetcher.d.ts +7 -0
  288. package/dist/services/origin-request/origin-fetcher.js +43 -5
  289. package/dist/services/origin-request/origin-request-service-build-context.d.ts +17 -0
  290. package/dist/services/origin-request/origin-request-service-build-context.js +8 -0
  291. package/dist/services/origin-request/origin-request-service-factory.d.ts +0 -5
  292. package/dist/services/origin-request/origin-request-service-factory.js +2 -30
  293. package/dist/services/origin-request/origin-request-service.d.ts +121 -6
  294. package/dist/services/origin-request/origin-request-service.js +273 -49
  295. package/dist/services/origin-request/runtime-config-source.d.ts +6 -0
  296. package/dist/services/origin-request/runtime-config-source.js +15 -4
  297. package/dist/services/origin-request/spec/asset-variations.spec.js +20 -0
  298. package/dist/services/origin-request/spec/origin-request-service.spec.js +329 -6
  299. package/dist/services/query-builder/rules/rule-match.d.ts +35 -0
  300. package/dist/services/query-builder/rules/rule-match.js +70 -0
  301. package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +1 -0
  302. package/dist/services/query-builder/spec/rules/rule-match.spec.js +121 -0
  303. package/dist/services/run-control/browser/run-browser-contexts.d.ts +557 -0
  304. package/dist/services/run-control/browser/run-browser-contexts.js +91 -0
  305. package/dist/services/run-control/browser/run-browser-service-factory.d.ts +5 -0
  306. package/dist/services/run-control/browser/run-browser-service-factory.js +7 -0
  307. package/dist/services/run-control/browser/run-browser-service.d.ts +68 -0
  308. package/dist/services/run-control/browser/run-browser-service.js +206 -0
  309. package/dist/services/run-control/cache/run-cache-contexts.d.ts +349 -0
  310. package/dist/services/run-control/cache/run-cache-contexts.js +51 -0
  311. package/dist/services/run-control/cache/run-cache-service-factory.d.ts +6 -0
  312. package/dist/services/run-control/cache/run-cache-service-factory.js +12 -0
  313. package/dist/services/run-control/cache/run-cache-service.d.ts +35 -0
  314. package/dist/services/run-control/cache/run-cache-service.js +151 -0
  315. package/dist/services/run-control/control-client.d.ts +36 -0
  316. package/dist/services/run-control/control-client.js +147 -0
  317. package/dist/services/run-control/debug/run-debug-contexts.d.ts +416 -0
  318. package/dist/services/run-control/debug/run-debug-contexts.js +47 -0
  319. package/dist/services/run-control/debug/run-debug-service-factory.d.ts +5 -0
  320. package/dist/services/run-control/debug/run-debug-service-factory.js +7 -0
  321. package/dist/services/run-control/debug/run-debug-service.d.ts +39 -0
  322. package/dist/services/run-control/debug/run-debug-service.js +164 -0
  323. package/dist/services/run-control/files/run-files-contexts.d.ts +238 -0
  324. package/dist/services/run-control/files/run-files-contexts.js +26 -0
  325. package/dist/services/run-control/files/run-files-service-factory.d.ts +5 -0
  326. package/dist/services/run-control/files/run-files-service-factory.js +7 -0
  327. package/dist/services/run-control/files/run-files-service.d.ts +29 -0
  328. package/dist/services/run-control/files/run-files-service.js +120 -0
  329. package/dist/services/run-control/index.d.ts +32 -0
  330. package/dist/services/run-control/index.js +31 -0
  331. package/dist/services/run-control/inject/run-inject-contexts.d.ts +319 -0
  332. package/dist/services/run-control/inject/run-inject-contexts.js +38 -0
  333. package/dist/services/run-control/inject/run-inject-service-factory.d.ts +5 -0
  334. package/dist/services/run-control/inject/run-inject-service-factory.js +7 -0
  335. package/dist/services/run-control/inject/run-inject-service.d.ts +31 -0
  336. package/dist/services/run-control/inject/run-inject-service.js +227 -0
  337. package/dist/services/run-control/live-run.d.ts +37 -0
  338. package/dist/services/run-control/live-run.js +56 -0
  339. package/dist/services/run-control/probe/run-probe-contexts.d.ts +333 -0
  340. package/dist/services/run-control/probe/run-probe-contexts.js +73 -0
  341. package/dist/services/run-control/probe/run-probe-service-factory.d.ts +5 -0
  342. package/dist/services/run-control/probe/run-probe-service-factory.js +7 -0
  343. package/dist/services/run-control/probe/run-probe-service.d.ts +54 -0
  344. package/dist/services/run-control/probe/run-probe-service.js +194 -0
  345. package/dist/services/run-control/rum/run-rum-contexts.d.ts +216 -0
  346. package/dist/services/run-control/rum/run-rum-contexts.js +34 -0
  347. package/dist/services/run-control/rum/run-rum-service-factory.d.ts +5 -0
  348. package/dist/services/run-control/rum/run-rum-service-factory.js +7 -0
  349. package/dist/services/run-control/rum/run-rum-service.d.ts +36 -0
  350. package/dist/services/run-control/rum/run-rum-service.js +122 -0
  351. package/dist/services/run-control/run-answer.d.ts +28 -0
  352. package/dist/services/run-control/run-answer.js +58 -0
  353. package/dist/services/run-control/run-control-context.d.ts +102 -0
  354. package/dist/services/run-control/run-control-context.js +36 -0
  355. package/dist/services/run-control/run-control-flags.d.ts +12 -0
  356. package/dist/services/run-control/run-control-flags.js +22 -0
  357. package/dist/services/run-control/run-control-model.d.ts +9 -0
  358. package/dist/services/run-control/run-control-model.js +1 -0
  359. package/dist/services/run-control/run-control-service-factory.d.ts +14 -0
  360. package/dist/services/run-control/run-control-service-factory.js +26 -0
  361. package/dist/services/run-control/session/run-session-contexts.d.ts +25 -0
  362. package/dist/services/run-control/session/run-session-contexts.js +20 -0
  363. package/dist/services/run-control/session/run-session-service-factory.d.ts +8 -0
  364. package/dist/services/run-control/session/run-session-service-factory.js +18 -0
  365. package/dist/services/run-control/session/run-session-service.d.ts +32 -0
  366. package/dist/services/run-control/session/run-session-service.js +151 -0
  367. package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +1 -0
  368. package/dist/services/run-control/spec/browser/run-browser-service.spec.js +328 -0
  369. package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +1 -0
  370. package/dist/services/run-control/spec/cache/run-cache-service.spec.js +454 -0
  371. package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +1 -0
  372. package/dist/services/run-control/spec/debug/run-debug-service.spec.js +113 -0
  373. package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +1 -0
  374. package/dist/services/run-control/spec/files/run-files-service.spec.js +234 -0
  375. package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +1 -0
  376. package/dist/services/run-control/spec/inject/run-inject-service.spec.js +251 -0
  377. package/dist/services/run-control/spec/live-run-fixture.d.ts +32 -0
  378. package/dist/services/run-control/spec/live-run-fixture.js +109 -0
  379. package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +1 -0
  380. package/dist/services/run-control/spec/probe/run-probe-service.spec.js +108 -0
  381. package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +1 -0
  382. package/dist/services/run-control/spec/rum/run-rum-service.spec.js +47 -0
  383. package/dist/services/run-control/spec/run-answer.spec.d.ts +1 -0
  384. package/dist/services/run-control/spec/run-answer.spec.js +57 -0
  385. package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +1 -0
  386. package/dist/services/run-control/spec/session/run-session-service.spec.js +150 -0
  387. package/dist/services/run-log/crash-mirror.d.ts +31 -0
  388. package/dist/services/run-log/crash-mirror.js +69 -0
  389. package/dist/services/run-log/index.d.ts +11 -0
  390. package/dist/services/run-log/index.js +11 -0
  391. package/dist/services/run-log/jsonl-appender.d.ts +46 -0
  392. package/dist/services/run-log/jsonl-appender.js +91 -0
  393. package/dist/services/run-log/log-event-model.d.ts +104 -0
  394. package/dist/services/run-log/log-event-model.js +56 -0
  395. package/dist/services/run-log/log-query-service-factory.d.ts +11 -0
  396. package/dist/services/run-log/log-query-service-factory.js +14 -0
  397. package/dist/services/run-log/log-query-service.d.ts +59 -0
  398. package/dist/services/run-log/log-query-service.js +111 -0
  399. package/dist/services/run-log/log-reader.d.ts +84 -0
  400. package/dist/services/run-log/log-reader.js +180 -0
  401. package/dist/services/run-log/log-summary.d.ts +72 -0
  402. package/dist/services/run-log/log-summary.js +208 -0
  403. package/dist/services/run-log/redaction.d.ts +34 -0
  404. package/dist/services/run-log/redaction.js +124 -0
  405. package/dist/services/run-log/request-log.d.ts +82 -0
  406. package/dist/services/run-log/request-log.js +69 -0
  407. package/dist/services/run-log/request-summary.d.ts +76 -0
  408. package/dist/services/run-log/request-summary.js +0 -0
  409. package/dist/services/run-log/run-log.d.ts +61 -0
  410. package/dist/services/run-log/run-log.js +102 -0
  411. package/dist/services/run-log/spec/log-query-service.spec.d.ts +1 -0
  412. package/dist/services/run-log/spec/log-query-service.spec.js +197 -0
  413. package/dist/services/run-log/spec/log-reader.spec.d.ts +1 -0
  414. package/dist/services/run-log/spec/log-reader.spec.js +109 -0
  415. package/dist/services/run-log/spec/log-summary.spec.d.ts +1 -0
  416. package/dist/services/run-log/spec/log-summary.spec.js +153 -0
  417. package/dist/services/run-log/spec/redaction.spec.d.ts +1 -0
  418. package/dist/services/run-log/spec/redaction.spec.js +61 -0
  419. package/dist/services/run-log/spec/request-log.spec.d.ts +1 -0
  420. package/dist/services/run-log/spec/request-log.spec.js +101 -0
  421. package/dist/services/run-log/spec/request-summary.spec.d.ts +1 -0
  422. package/dist/services/run-log/spec/request-summary.spec.js +171 -0
  423. package/dist/services/run-log/spec/run-log.spec.d.ts +1 -0
  424. package/dist/services/run-log/spec/run-log.spec.js +122 -0
  425. package/dist/services/run-registry/exit-classification.d.ts +39 -0
  426. package/dist/services/run-registry/exit-classification.js +42 -0
  427. package/dist/services/run-registry/index.d.ts +3 -0
  428. package/dist/services/run-registry/index.js +3 -0
  429. package/dist/services/run-registry/process-identity.d.ts +28 -0
  430. package/dist/services/run-registry/process-identity.js +80 -0
  431. package/dist/services/run-registry/run-registry-model.d.ts +128 -0
  432. package/dist/services/run-registry/run-registry-model.js +16 -0
  433. package/dist/services/run-registry/run-registry.d.ts +155 -0
  434. package/dist/services/run-registry/run-registry.js +430 -0
  435. package/dist/services/run-registry/spec/exit-classification.spec.d.ts +1 -0
  436. package/dist/services/run-registry/spec/exit-classification.spec.js +82 -0
  437. package/dist/services/run-registry/spec/run-registry.spec.d.ts +1 -0
  438. package/dist/services/run-registry/spec/run-registry.spec.js +526 -0
  439. package/dist/services/setup/os/tool-registry.js +2 -2
  440. package/oclif.manifest.json +3479 -358
  441. package/package.json +20 -2
@@ -0,0 +1,157 @@
1
+ const DEFAULT_INTERVAL_MS = 200;
2
+ /** The shortest tick the sampler takes; a shorter one is raised to it. */
3
+ const MIN_INTERVAL_MS = 20;
4
+ const DEFAULT_DURATION_MS = 15_000;
5
+ /** Long enough for a slow load to finish, short enough to be a tool call. */
6
+ const MAX_DURATION_MS = 120_000;
7
+ /** Samples returned, after collapsing. The rest stay in the count. */
8
+ const MAX_RETURNED = 200;
9
+ /**
10
+ * Sample an expression across a navigation and report what it did.
11
+ *
12
+ * `tools/sk-watch.mjs` promoted. It exists because an intermittent or
13
+ * good-then-broken symptom cannot be caught by a single evaluation — by the
14
+ * time anyone can ask, the page is in whichever state it ended up in. A preload
15
+ * samples from t=0 of the next load and survives the navigation, so the
16
+ * question becomes "what did this value do" rather than "what is it now".
17
+ *
18
+ * Console messages and page exceptions are collected from inside the page
19
+ * rather than over CDP. That keeps the whole capture in one buffer with one
20
+ * clock, and it needs no subscription that would outlive the call. The cost is
21
+ * real and worth stating: messages the *browser* emits rather than the page —
22
+ * a CSP violation, a failed request — are not console calls and do not appear
23
+ * here.
24
+ */
25
+ export async function runWatch(preloads, reload, options) {
26
+ const intervalMs = Math.max(MIN_INTERVAL_MS, options.intervalMs ?? DEFAULT_INTERVAL_MS);
27
+ const notes = options.intervalMs !== undefined && options.intervalMs < intervalMs
28
+ ? [
29
+ `interval ${options.intervalMs}ms raised to ${intervalMs}ms, the shortest the sampler takes`,
30
+ ]
31
+ : [];
32
+ const durationMs = Math.min(MAX_DURATION_MS, Math.max(intervalMs, options.durationMs ?? DEFAULT_DURATION_MS));
33
+ await preloads.reserve("watch", watchScript(options.expression, intervalMs));
34
+ try {
35
+ if (options.reload) {
36
+ await reload();
37
+ }
38
+ await delay(durationMs);
39
+ const read = await preloads.read("watch", Number.MAX_SAFE_INTEGER);
40
+ const records = (read.records ?? []).map((record) => record);
41
+ const samples = [];
42
+ const console = [];
43
+ const exceptions = [];
44
+ for (const { t, v } of records) {
45
+ if (v?.k === "console") {
46
+ console.push({ t, level: v.level ?? "log", text: v.text ?? "" });
47
+ }
48
+ else if (v?.k === "exception") {
49
+ exceptions.push({ t, level: "error", text: v.text ?? "" });
50
+ }
51
+ else if (v?.k === "sample") {
52
+ samples.push(v.error === undefined ? { t, v: v.v } : { t, error: v.error });
53
+ }
54
+ }
55
+ const shown = options.full ? samples : transitions(samples);
56
+ return {
57
+ expression: options.expression,
58
+ intervalMs,
59
+ durationMs,
60
+ reloaded: Boolean(options.reload),
61
+ mode: options.full ? "full" : "transitions",
62
+ samples: shown.slice(0, MAX_RETURNED),
63
+ totalSamples: samples.length,
64
+ dropped: read.dropped,
65
+ console: console.slice(0, MAX_RETURNED),
66
+ exceptions: exceptions.slice(0, MAX_RETURNED),
67
+ truncated: shown.length > MAX_RETURNED,
68
+ notes,
69
+ };
70
+ }
71
+ finally {
72
+ // Whatever happened, the sampler does not outlive the call. A watch left
73
+ // running is a timer firing every 200ms in the customer's page for as long
74
+ // as the run lives.
75
+ await preloads.release("watch").catch(() => undefined);
76
+ }
77
+ }
78
+ /**
79
+ * Keep only the ticks where the value changed.
80
+ *
81
+ * A 15-second watch at 200ms is 75 samples of which two usually matter. The
82
+ * first sample is always kept, because "what it started as" is half of what a
83
+ * transition means.
84
+ */
85
+ function transitions(samples) {
86
+ const kept = [];
87
+ let previous;
88
+ for (const sample of samples) {
89
+ const key = JSON.stringify(sample.error ?? sample.v ?? null);
90
+ if (key !== previous) {
91
+ kept.push(sample);
92
+ previous = key;
93
+ }
94
+ }
95
+ return kept;
96
+ }
97
+ function delay(ms) {
98
+ return new Promise((resolve) => {
99
+ const timer = setTimeout(resolve, ms);
100
+ timer.unref();
101
+ });
102
+ }
103
+ /**
104
+ * The sampler, the console wrapper and the error listeners, in one script.
105
+ *
106
+ * All three write through the same `record`, so everything shares one clock and
107
+ * one buffer — which is what makes "the value flipped, and here is the
108
+ * exception thrown half a tick earlier" readable at all.
109
+ */
110
+ function watchScript(expression, intervalMs) {
111
+ return `
112
+ var take = guard(function () {
113
+ try {
114
+ record({ k: "sample", v: (${expression}) });
115
+ } catch (error) {
116
+ record({ k: "sample", error: String((error && error.message) || error) });
117
+ }
118
+ });
119
+ take();
120
+ var timer = setInterval(function () {
121
+ if (slot.disabled) { clearInterval(timer); return; }
122
+ take();
123
+ }, ${intervalMs});
124
+
125
+ // Guarded per document rather than per slot: a second watch in the same
126
+ // page must re-install its sampler but must not wrap console twice, which
127
+ // would record every message as many times as watches have run.
128
+ if (!window.__SK_WATCH_TAPPED) {
129
+ window.__SK_WATCH_TAPPED = true;
130
+ ["log", "info", "warn", "error", "debug"].forEach(function (level) {
131
+ var original = console[level];
132
+ if (typeof original !== "function") return;
133
+ console[level] = function () {
134
+ try {
135
+ record({
136
+ k: "console",
137
+ level: level,
138
+ text: Array.prototype.slice.call(arguments).map(function (one) {
139
+ return typeof one === "string" ? one : JSON.stringify(summarise(one));
140
+ }).join(" ")
141
+ });
142
+ } catch (ignored) {
143
+ // Recording is best effort; passing the call through is not.
144
+ }
145
+ return original.apply(this, arguments);
146
+ };
147
+ });
148
+
149
+ window.addEventListener("error", function (event) {
150
+ record({ k: "exception", text: String((event && event.message) || "error") });
151
+ });
152
+ window.addEventListener("unhandledrejection", function (event) {
153
+ var reason = event && event.reason;
154
+ record({ k: "exception", text: String((reason && reason.message) || reason) });
155
+ });
156
+ }`;
157
+ }
@@ -20,7 +20,9 @@ export class DiffAgainstCurrentPage {
20
20
  * between the two is ignored; the current page has one response only.
21
21
  */
22
22
  async postDiff({ currentHtml, currentUrl, variant = "default", transform = false, baseline = false, }) {
23
- this.cli.writeWarning(`received diff for url: ${currentUrl}`);
23
+ this.cli.writeWarning(`received diff for url: ${currentUrl}`, false, {
24
+ data: { url: currentUrl, variant, transform },
25
+ });
24
26
  const raw = !transform;
25
27
  const remote = await this.pages.fetch(currentUrl, variant, `remote-${variant}.html`, { raw, baseline });
26
28
  const current = await this.pages.fromHtml(currentHtml, currentUrl, variant, {
@@ -128,9 +128,14 @@ export class Dashboard {
128
128
  return this.createBaqendResponse(requestOrigin, JSON.stringify({ success: false, error: diffResult.error }), "application/json; charset=UTF-8", [], 500);
129
129
  }
130
130
  if (url.pathname.startsWith("/cache/get")) {
131
+ // Reads every body back off disk, which is what this endpoint has always
132
+ // effectively done — it serialises them all into one payload.
131
133
  const response = [];
132
- for (const [url, baqendResponse] of this.cache.getAll()) {
133
- response.push({ url, response: baqendResponse });
134
+ for (const [url] of this.cache.getAll()) {
135
+ const baqendResponse = this.cache.getEntry(url);
136
+ if (baqendResponse) {
137
+ response.push({ url, response: baqendResponse });
138
+ }
134
139
  }
135
140
  return this.createBaqendResponse(requestOrigin, JSON.stringify(response), "application/json; charset=UTF-8");
136
141
  }
@@ -4,14 +4,33 @@ import { CDPSession, Target } from "puppeteer";
4
4
  import { CliServiceInterface } from "../cli/index.js";
5
5
  import { CustomerConfig } from "../integration-api/index.js";
6
6
  import { ConfigApiService } from "../config-api/index.js";
7
+ import { RequestLogInterface } from "../run-log/index.js";
8
+ /** What a {@link FetchEventHandler} works with. */
9
+ export interface FetchEventHandlerDeps {
10
+ /** The handlers an intercepted request is offered to, in order. */
11
+ browserFetchEvents: FetchRequestPausedEventHandler[];
12
+ customerConfig: CustomerConfig;
13
+ cli: CliServiceInterface;
14
+ /** Answers an auth challenge with the app's credentials; absent in tests. */
15
+ client?: ConfigApiService;
16
+ /**
17
+ * Where every intercepted request is recorded.
18
+ *
19
+ * Absent when the run is not writing to disk, and in the test harness.
20
+ * This is the only place that sees the whole stream — which handler
21
+ * matched, what it answered with, and how long it took — and none of it
22
+ * reaches the terminal, because a navigation produces hundreds of these
23
+ * and a human reading along wants none of them.
24
+ */
25
+ requestLog?: RequestLogInterface;
26
+ }
7
27
  export declare class FetchEventHandler {
8
- private browserFetchEvents;
9
- private customerConfig;
10
- private cli;
11
- private client?;
12
- constructor(browserFetchEvents: FetchRequestPausedEventHandler[], customerConfig: CustomerConfig, cli: CliServiceInterface, client?: ConfigApiService);
28
+ private readonly deps;
29
+ constructor(deps: FetchEventHandlerDeps);
13
30
  handleRequestFetchEvents(target: Target): Promise<void>;
14
31
  private canHandlePattern;
32
+ /** The fields of a record that are known before anything has decided. */
33
+ private describe;
15
34
  private onFetchRequestPaused;
16
35
  getAuthPattern(): Protocol.Fetch.RequestPattern[];
17
36
  private onFetchAuthRequired;
@@ -4,15 +4,9 @@ import { AbortResponse } from "./browser/abort-response.js";
4
4
  import { safe } from "../../helpers/safe.js";
5
5
  import { LoginError } from "../config-api/error/login-error.js";
6
6
  export class FetchEventHandler {
7
- browserFetchEvents;
8
- customerConfig;
9
- cli;
10
- client;
11
- constructor(browserFetchEvents, customerConfig, cli, client) {
12
- this.browserFetchEvents = browserFetchEvents;
13
- this.customerConfig = customerConfig;
14
- this.cli = cli;
15
- this.client = client;
7
+ deps;
8
+ constructor(deps) {
9
+ this.deps = deps;
16
10
  }
17
11
  async handleRequestFetchEvents(target) {
18
12
  const cdpSession = await target.createCDPSession();
@@ -20,7 +14,7 @@ export class FetchEventHandler {
20
14
  handleAuthRequests: true,
21
15
  //see: https://chromedevtools.github.io/devtools-protocol/tot/Fetch#type-RequestPattern
22
16
  patterns: [
23
- ...this.browserFetchEvents.flatMap((handler) => {
17
+ ...this.deps.browserFetchEvents.flatMap((handler) => {
24
18
  return handler.patterns;
25
19
  }),
26
20
  ...this.getAuthPattern(),
@@ -31,20 +25,47 @@ export class FetchEventHandler {
31
25
  if (response.success === true) {
32
26
  return response.data;
33
27
  }
34
- this.cli.writeError(response.error);
28
+ this.deps.cli.writeError(response.error);
35
29
  });
36
30
  cdpSession.on(BROWSER_EVENTS.FETCH_REQUEST_PAUSED, async (event) => {
37
31
  const response = await safe(this.onFetchRequestPaused(event, cdpSession));
38
32
  if (response.success === true) {
39
33
  return;
40
34
  }
35
+ const failure = response.errorObj
36
+ ? response.errorObj.message
37
+ : JSON.stringify(response.errorObj);
38
+ // The page dropped the request while a handler worked on it, e.g. a
39
+ // navigation away. Logged as an error, it read as a proxy failure.
40
+ if (/Invalid InterceptionId/.test(failure)) {
41
+ this.deps.requestLog?.record({
42
+ ...this.describe(event),
43
+ outcome: "cancelled",
44
+ });
45
+ return;
46
+ }
47
+ this.deps.requestLog?.record({
48
+ ...this.describe(event),
49
+ outcome: "error",
50
+ error: failure,
51
+ });
41
52
  if (response.errorObj) {
42
- this.cli.writeError(`error on ${event.request.url}`);
43
- this.cli.writeError(`${response.errorObj.message}`);
53
+ this.deps.cli.writeError(`error on ${event.request.url}`, false, {
54
+ scope: "fetch",
55
+ data: { url: event.request.url, resourceType: event.resourceType },
56
+ });
57
+ this.deps.cli.writeError(`${response.errorObj.message}`, false, {
58
+ scope: "fetch",
59
+ });
44
60
  }
45
61
  else {
46
- this.cli.writeError(`error on ${target.url()}`);
47
- this.cli.writeError(JSON.stringify(response.errorObj));
62
+ this.deps.cli.writeError(`error on ${target.url()}`, false, {
63
+ scope: "fetch",
64
+ data: { url: target.url() },
65
+ });
66
+ this.deps.cli.writeError(JSON.stringify(response.errorObj), false, {
67
+ scope: "fetch",
68
+ });
48
69
  }
49
70
  // A request left in paused state hangs until the browser times out.
50
71
  // Fail it explicitly so the page sees a network error instead.
@@ -65,28 +86,67 @@ export class FetchEventHandler {
65
86
  return !pattern.resourceType || pattern.resourceType === resourceType;
66
87
  });
67
88
  }
89
+ /** The fields of a record that are known before anything has decided. */
90
+ describe(event) {
91
+ return {
92
+ url: event.request.url,
93
+ method: event.request.method,
94
+ resourceType: String(event.resourceType),
95
+ // Chrome pauses at the response stage only when a pattern asked it to,
96
+ // and the presence of response headers is what distinguishes the two.
97
+ stage: (event.responseHeaders ? "Response" : "Request"),
98
+ };
99
+ }
68
100
  async onFetchRequestPaused(event, cdpSession) {
69
101
  const requestId = event.requestId;
70
- for (const fetchEvent of this.browserFetchEvents) {
102
+ for (const fetchEvent of this.deps.browserFetchEvents) {
71
103
  // check if current request could be handled
72
104
  if (!this.canHandlePattern(fetchEvent, event.request.url, event.resourceType, event.responseHeaders ? "Response" : "Request")) {
73
105
  continue;
74
106
  }
107
+ const startedAt = Date.now();
75
108
  const response = await fetchEvent.handle(event, cdpSession);
76
109
  if (!response) {
77
110
  continue;
78
111
  }
112
+ // The handler is named by its class, which is what a reader needs to go
113
+ // and look at the rule that matched. Timing covers the handler only, not
114
+ // the CDP round trip back into Chrome, because that is the part a config
115
+ // change can move.
116
+ const handler = fetchEvent.constructor.name;
117
+ const durationMs = Date.now() - startedAt;
79
118
  if (response instanceof AbortResponse) {
119
+ this.deps.requestLog?.record({
120
+ ...this.describe(event),
121
+ outcome: "failed",
122
+ handler,
123
+ durationMs,
124
+ });
80
125
  return cdpSession.send("Fetch.failRequest", {
81
126
  requestId: requestId,
82
127
  errorReason: response.errorReason,
83
128
  });
84
129
  }
130
+ const fulfillment = response;
131
+ this.deps.requestLog?.record({
132
+ ...this.describe(event),
133
+ outcome: "fulfilled",
134
+ handler,
135
+ status: fulfillment.responseCode,
136
+ durationMs,
137
+ });
85
138
  return cdpSession.send("Fetch.fulfillRequest", {
86
- ...response,
139
+ ...fulfillment,
87
140
  requestId,
88
141
  });
89
142
  }
143
+ // Nothing matched, so Chrome gets it back untouched. Recorded because
144
+ // "what did the CLI *not* take" is the question a `disabledScopes` or
145
+ // `blacklist` change is asking, and it has no other trace anywhere.
146
+ this.deps.requestLog?.record({
147
+ ...this.describe(event),
148
+ outcome: "continued",
149
+ });
90
150
  //see: https://chromedevtools.github.io/devtools-protocol/tot/Fetch#method-continueRequest
91
151
  return cdpSession.send("Fetch.continueRequest", {
92
152
  requestId: requestId,
@@ -94,7 +154,7 @@ export class FetchEventHandler {
94
154
  }
95
155
  getAuthPattern() {
96
156
  const result = [];
97
- for (const origin of this.customerConfig.origins) {
157
+ for (const origin of this.deps.customerConfig.origins) {
98
158
  const pattern = [
99
159
  {
100
160
  urlPattern: `${origin}*`,
@@ -106,16 +166,16 @@ export class FetchEventHandler {
106
166
  return result;
107
167
  }
108
168
  async onFetchAuthRequired(event, browserClient) {
109
- this.cli.writeWarning(`auth requested for ${event.request.url}`);
110
- if (!this.customerConfig.origins.some((origin) => {
169
+ this.deps.cli.writeWarning(`auth requested for ${event.request.url}`);
170
+ if (!this.deps.customerConfig.origins.some((origin) => {
111
171
  return event.request.url.includes(origin);
112
172
  }) ||
113
- !this.client) {
114
- this.cli.writeWarning(`incorrect origin for auth request: -> ${this.customerConfig.origins.join("|")}`);
173
+ !this.deps.client) {
174
+ this.deps.cli.writeWarning(`incorrect origin for auth request: -> ${this.deps.customerConfig.origins.join("|")}`);
115
175
  return { response: "Default" };
116
176
  }
117
- this.cli.startAction("BROWSER:AUTHENTICATE", "wait for credentials from server-config");
118
- const serverConfigResponse = await safe(this.client.getServerConfig());
177
+ this.deps.cli.startAction("BROWSER:AUTHENTICATE", "wait for credentials from server-config");
178
+ const serverConfigResponse = await safe(this.deps.client.getServerConfig());
119
179
  if (serverConfigResponse.success === true) {
120
180
  const config = JSON.parse(serverConfigResponse.data);
121
181
  const authUrlOrigin = new URL(event.request.url).origin;
@@ -130,27 +190,38 @@ export class FetchEventHandler {
130
190
  password: auth.password,
131
191
  },
132
192
  });
133
- this.cli.successAction("BROWSER:AUTHENTICATE");
134
- this.cli.writeSuccess(`auth provided for ${event.request.url}`);
135
- await this.sendDefaultAuthBehaviour(browserClient, event.requestId);
193
+ this.deps.cli.successAction("BROWSER:AUTHENTICATE");
194
+ this.deps.cli.writeSuccess(`auth provided for ${event.request.url}`);
195
+ // No `sendDefaultAuthBehaviour` here. The challenge has just been
196
+ // answered with the credentials, and a challenge can only be answered
197
+ // once — a second `Fetch.continueWithAuth` for the same requestId
198
+ // always threw `Invalid state for continueInterceptedRequest`, one
199
+ // millisecond after the success line, every time credentials were
200
+ // supplied. Login still worked, because the credentials went first,
201
+ // but the throw was logged at `error` level and headed the run's
202
+ // problems list, reading as though authentication had failed.
136
203
  return;
137
204
  }
138
205
  }
139
- this.cli.failAction("BROWSER:AUTHENTICATE", `error providing auth: no credentials found in runtimeConfig of app ${this.customerConfig.app}`);
206
+ this.deps.cli.failAction("BROWSER:AUTHENTICATE", `error providing auth: no credentials found in runtimeConfig of app ${this.deps.customerConfig.app}`);
140
207
  await this.sendDefaultAuthBehaviour(browserClient, event.requestId);
141
208
  return;
142
209
  }
143
- this.cli.failAction("BROWSER:AUTHENTICATE");
210
+ this.deps.cli.failAction("BROWSER:AUTHENTICATE");
144
211
  if (serverConfigResponse.errorObj instanceof ProtocolError) {
145
- // unknown raceCondition where the authResponse is sent to fast
212
+ // The challenge was already answered — by a competing handler, or by the
213
+ // browser giving up on it — so there is nothing left to respond to and
214
+ // `sendDefaultAuthBehaviour` would throw in its turn. Bailing out is
215
+ // right. (This is *not* the double-answer that used to fire on the
216
+ // success path above; that one was unconditional, not a race.)
146
217
  return;
147
218
  }
148
219
  if (serverConfigResponse.errorObj instanceof LoginError) {
149
- this.cli.writeError(`could not login to app ${this.customerConfig.app} to gather credentials. Try run sk login`);
220
+ this.deps.cli.writeError(`could not login to app ${this.deps.customerConfig.app} to gather credentials. Try run sk login`);
150
221
  await this.sendDefaultAuthBehaviour(browserClient, event.requestId);
151
222
  return;
152
223
  }
153
- this.cli.writeError(`error providing auth: ${JSON.stringify(serverConfigResponse.errorObj)}`);
224
+ this.deps.cli.writeError(`error providing auth: ${JSON.stringify(serverConfigResponse.errorObj)}`);
154
225
  await this.sendDefaultAuthBehaviour(browserClient, event.requestId);
155
226
  }
156
227
  async sendDefaultAuthBehaviour(browserClient, requestId) {
@@ -0,0 +1,59 @@
1
+ import { expect } from "chai";
2
+ import { describe, it } from "mocha";
3
+ import { Script } from "node:vm";
4
+ import { SpeedKitInstallJs } from "../speed-kit-install-js.js";
5
+ const domain = "fixture.app.baqend.com";
6
+ const worker = "/apps/speed-kit/sw.js";
7
+ const local = "window.speedKit = {sw: " + JSON.stringify(worker) + "};";
8
+ async function render(remote, base64Encoded = false) {
9
+ const handler = new SpeedKitInstallJs({ appDomain: domain }, { getContent: () => local }, {
10
+ comment: () => undefined,
11
+ writeError: () => undefined,
12
+ });
13
+ const event = {
14
+ requestId: "remote-install-response",
15
+ request: { url: "https://" + domain + "/v1/speedkit/install.js" },
16
+ responseStatusCode: 200,
17
+ responseHeaders: [],
18
+ };
19
+ const client = {
20
+ send: async (method, parameters) => {
21
+ expect(method).to.equal("Fetch.getResponseBody");
22
+ expect(parameters.requestId).to.equal(event.requestId);
23
+ return {
24
+ base64Encoded,
25
+ body: base64Encoded ? Buffer.from(remote).toString("base64") : remote,
26
+ };
27
+ },
28
+ };
29
+ const response = await handler.handle(event, client);
30
+ if (!response || !("body" in response)) {
31
+ throw new Error("The valid install response was not fulfilled");
32
+ }
33
+ return Buffer.from(response.body, "base64").toString("utf8");
34
+ }
35
+ describe("SpeedKitInstallJs", () => {
36
+ it("keeps a queryless worker unchanged when a later search example contains a query", async () => {
37
+ const remote = 'window.speedKit = {sw: "/apps/speed-kit/sw.js",\n' +
38
+ 'blacklist: [/search/i, // e.g. /search?q=rucksack\n"/pages/"]};';
39
+ const rendered = await render(remote);
40
+ expect(rendered).to.equal(local);
41
+ expect(() => new Script(rendered)).not.to.throw();
42
+ });
43
+ for (const query of [
44
+ "?r=declared-version&v=2.22.0&gr=A",
45
+ "?r=version&literal=$$-$&-$'",
46
+ ]) {
47
+ for (const base64 of [false, true]) {
48
+ it("preserves the worker query " + JSON.stringify({ query, base64 }), async () => {
49
+ const remote = "window.speedKit = {sw: " + JSON.stringify(worker + query) + "};";
50
+ const rendered = await render(remote, base64);
51
+ expect(rendered).to.equal(remote);
52
+ expect(() => new Script(rendered)).not.to.throw();
53
+ });
54
+ }
55
+ }
56
+ it("leaves the local worker unchanged when the remote declaration is absent", async () => {
57
+ expect(await render('const search = "/search?q=rucksack";')).to.equal(local);
58
+ });
59
+ });
@@ -25,7 +25,10 @@ export class SpeedKitInstallJs {
25
25
  }
26
26
  async handle(event, client) {
27
27
  if (!event.request.url.includes(this.customerConfig.appDomain)) {
28
- this.cli.comment(`abort: ${event.request.url}`);
28
+ this.cli.comment(`abort: ${event.request.url}`, false, {
29
+ scope: "fetch",
30
+ data: { url: event.request.url, aborted: true },
31
+ });
29
32
  return new AbortResponse("Aborted");
30
33
  }
31
34
  if (!this.isValidResponse(event)) {
@@ -36,8 +39,8 @@ export class SpeedKitInstallJs {
36
39
  const configVersion = await this.extractConfigVersion(client, event);
37
40
  if (configVersion) {
38
41
  // append remote serviceWorkerParams to localVersion
39
- installJs = installJs.replace(/sw:[^"]*"([^"]*)"/s, (matched, selected) => {
40
- return matched.replace(selected, selected + configVersion);
42
+ installJs = installJs.replace(/\bsw\s*:\s*"([^"\r\n]*)"/, (matched, selected) => {
43
+ return matched.replace(selected, () => selected + configVersion);
41
44
  });
42
45
  }
43
46
  return new BaqendResponse(installJs, "text/javascript; charset=utf-8", event.responseHeaders);
@@ -50,10 +53,18 @@ export class SpeedKitInstallJs {
50
53
  async extractConfigVersion(client, event) {
51
54
  const originBodyResponse = await safe(this.getContent(client, event));
52
55
  if (originBodyResponse.success !== true) {
53
- this.cli.writeError(`could not fetch install resource: "${event.request.url}": ${originBodyResponse.error}`);
56
+ this.cli.writeError(`could not fetch install resource: "${event.request.url}": ${originBodyResponse.error}`, false, {
57
+ scope: "fetch",
58
+ data: {
59
+ url: event.request.url,
60
+ error: originBodyResponse.error,
61
+ },
62
+ });
54
63
  return;
55
64
  }
56
- const [, configVersion] = originBodyResponse.data.match(/sw:[^?]*(\?[^"]*)"/s) || [];
65
+ // Bound the query to the worker literal before its closing quote.
66
+ const [, configVersion] = originBodyResponse.data.match(/\bsw\s*:\s*"[^"?\r\n]*(\?[^"\r\n]*)"/) ||
67
+ [];
57
68
  return configVersion;
58
69
  }
59
70
  async getContent(client, event) {
@@ -3,6 +3,7 @@ import { Protocol } from "puppeteer-core";
3
3
  import { CustomerConfig } from "../../integration-api/index.js";
4
4
  import { AbortResponse } from "../browser/abort-response.js";
5
5
  import { FetchRequestPausedEventHandler } from "../onboarding-model.js";
6
+ import { RumBeacon } from "../control/control-protocol.js";
6
7
  import { VirtualOrestesApp } from "../virtual-orestes-app/index.js";
7
8
  /**
8
9
  * Intercepts v1/rum/pi requests,
@@ -11,10 +12,23 @@ import { VirtualOrestesApp } from "../virtual-orestes-app/index.js";
11
12
  *
12
13
  * @implements FetchRequestPausedEventHandler
13
14
  */
15
+ /** How many beacons the run keeps for `rum beacons`. */
16
+ export declare const BEACON_LIMIT = 200;
14
17
  export declare class SpeedKitRumPiRequest implements FetchRequestPausedEventHandler {
15
18
  private customerConfig;
16
19
  private orestesApp;
17
20
  readonly patterns: Protocol.Fetch.RequestPattern[];
21
+ /**
22
+ * The last beacons, as they left the page.
23
+ *
24
+ * `rum get` reads what Speed Kit merged; which beacon carried a field, and
25
+ * when — the question when a click should have tracked something — is only
26
+ * answerable from the beacons themselves.
27
+ */
28
+ private readonly kept;
29
+ private seq;
30
+ beacons(): RumBeacon[];
18
31
  constructor(customerConfig: CustomerConfig, orestesApp: VirtualOrestesApp);
19
32
  handle(event: Protocol.Fetch.RequestPausedEvent, _: CDPSession): Promise<AbortResponse | Partial<Protocol.Fetch.FulfillRequestRequest> | null>;
33
+ private keep;
20
34
  }
@@ -6,10 +6,24 @@ import { safe } from "../../../helpers/safe.js";
6
6
  *
7
7
  * @implements FetchRequestPausedEventHandler
8
8
  */
9
+ /** How many beacons the run keeps for `rum beacons`. */
10
+ export const BEACON_LIMIT = 200;
9
11
  export class SpeedKitRumPiRequest {
10
12
  customerConfig;
11
13
  orestesApp;
12
14
  patterns;
15
+ /**
16
+ * The last beacons, as they left the page.
17
+ *
18
+ * `rum get` reads what Speed Kit merged; which beacon carried a field, and
19
+ * when — the question when a click should have tracked something — is only
20
+ * answerable from the beacons themselves.
21
+ */
22
+ kept = [];
23
+ seq = 0;
24
+ beacons() {
25
+ return [...this.kept];
26
+ }
13
27
  constructor(customerConfig, orestesApp) {
14
28
  this.customerConfig = customerConfig;
15
29
  this.orestesApp = orestesApp;
@@ -25,6 +39,9 @@ export class SpeedKitRumPiRequest {
25
39
  return;
26
40
  }
27
41
  const result = safe(() => JSON.parse(event.request.postData));
42
+ this.keep(event, result.success === true && result.data && typeof result.data === "object"
43
+ ? result.data
44
+ : null);
28
45
  if (result.success === false) {
29
46
  return;
30
47
  }
@@ -35,4 +52,17 @@ export class SpeedKitRumPiRequest {
35
52
  // refresh in the background - do not block the intercepted rum/pi request
36
53
  void this.orestesApp.refreshUrl(changeDetection.url);
37
54
  }
55
+ keep(event, data) {
56
+ this.seq += 1;
57
+ this.kept.push({
58
+ seq: this.seq,
59
+ at: new Date().toISOString(),
60
+ url: event.request.url,
61
+ bytes: event.request.postData?.length ?? 0,
62
+ data,
63
+ });
64
+ if (this.kept.length > BEACON_LIMIT) {
65
+ this.kept.shift();
66
+ }
67
+ }
38
68
  }