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

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 (432) hide show
  1. package/README.md +1425 -14
  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 +7 -1
  6. package/dist/commands/diff.js +9 -3
  7. package/dist/commands/login.d.ts +3 -0
  8. package/dist/commands/login.js +14 -3
  9. package/dist/commands/onboarding/browser/click.d.ts +75 -0
  10. package/dist/commands/onboarding/browser/click.js +19 -0
  11. package/dist/commands/onboarding/browser/emulate.d.ts +105 -0
  12. package/dist/commands/onboarding/browser/emulate.js +26 -0
  13. package/dist/commands/onboarding/browser/navigate.d.ts +75 -0
  14. package/dist/commands/onboarding/browser/navigate.js +19 -0
  15. package/dist/commands/onboarding/browser/panel.d.ts +63 -0
  16. package/dist/commands/onboarding/browser/panel.js +12 -0
  17. package/dist/commands/onboarding/browser/reinstall-sw.d.ts +63 -0
  18. package/dist/commands/onboarding/browser/reinstall-sw.js +14 -0
  19. package/dist/commands/onboarding/browser/reset.d.ts +71 -0
  20. package/dist/commands/onboarding/browser/reset.js +18 -0
  21. package/dist/commands/onboarding/browser/screenshot.d.ts +77 -0
  22. package/dist/commands/onboarding/browser/screenshot.js +19 -0
  23. package/dist/commands/onboarding/browser/state.d.ts +63 -0
  24. package/dist/commands/onboarding/browser/state.js +12 -0
  25. package/dist/commands/onboarding/browser/tabs.d.ts +58 -0
  26. package/dist/commands/onboarding/browser/tabs.js +16 -0
  27. package/dist/commands/onboarding/cache/clear.d.ts +58 -0
  28. package/dist/commands/onboarding/cache/clear.js +12 -0
  29. package/dist/commands/onboarding/cache/errors.d.ts +58 -0
  30. package/dist/commands/onboarding/cache/errors.js +12 -0
  31. package/dist/commands/onboarding/cache/evict.d.ts +62 -0
  32. package/dist/commands/onboarding/cache/evict.js +15 -0
  33. package/dist/commands/onboarding/cache/get.d.ts +85 -0
  34. package/dist/commands/onboarding/cache/get.js +17 -0
  35. package/dist/commands/onboarding/cache/list.d.ts +58 -0
  36. package/dist/commands/onboarding/cache/list.js +15 -0
  37. package/dist/commands/onboarding/cache/prewarm.d.ts +73 -0
  38. package/dist/commands/onboarding/cache/prewarm.js +20 -0
  39. package/dist/commands/onboarding/cache/refresh.d.ts +62 -0
  40. package/dist/commands/onboarding/cache/refresh.js +18 -0
  41. package/dist/commands/onboarding/cdp.d.ts +81 -0
  42. package/dist/commands/onboarding/cdp.js +18 -0
  43. package/dist/commands/onboarding/debug/arm.d.ts +83 -0
  44. package/dist/commands/onboarding/debug/arm.js +19 -0
  45. package/dist/commands/onboarding/debug/await.d.ts +71 -0
  46. package/dist/commands/onboarding/debug/await.js +18 -0
  47. package/dist/commands/onboarding/debug/disarm.d.ts +63 -0
  48. package/dist/commands/onboarding/debug/disarm.js +12 -0
  49. package/dist/commands/onboarding/debug/eval.d.ts +75 -0
  50. package/dist/commands/onboarding/debug/eval.js +16 -0
  51. package/dist/commands/onboarding/debug/release.d.ts +63 -0
  52. package/dist/commands/onboarding/debug/release.js +12 -0
  53. package/dist/commands/onboarding/debug/resume.d.ts +63 -0
  54. package/dist/commands/onboarding/debug/resume.js +12 -0
  55. package/dist/commands/onboarding/debug/status.d.ts +63 -0
  56. package/dist/commands/onboarding/debug/status.js +12 -0
  57. package/dist/commands/onboarding/debug/step.d.ts +67 -0
  58. package/dist/commands/onboarding/debug/step.js +15 -0
  59. package/dist/commands/onboarding/files/list.d.ts +58 -0
  60. package/dist/commands/onboarding/files/list.js +12 -0
  61. package/dist/commands/onboarding/files/read.d.ts +73 -0
  62. package/dist/commands/onboarding/files/read.js +16 -0
  63. package/dist/commands/onboarding/files/rebuild.d.ts +63 -0
  64. package/dist/commands/onboarding/files/rebuild.js +18 -0
  65. package/dist/commands/onboarding/files/validate.d.ts +58 -0
  66. package/dist/commands/onboarding/files/validate.js +12 -0
  67. package/dist/commands/onboarding/fouc.d.ts +77 -0
  68. package/dist/commands/onboarding/fouc.js +16 -0
  69. package/dist/commands/onboarding/inject/add.d.ts +89 -0
  70. package/dist/commands/onboarding/inject/add.js +17 -0
  71. package/dist/commands/onboarding/inject/clear.d.ts +63 -0
  72. package/dist/commands/onboarding/inject/clear.js +12 -0
  73. package/dist/commands/onboarding/inject/list.d.ts +63 -0
  74. package/dist/commands/onboarding/inject/list.js +12 -0
  75. package/dist/commands/onboarding/inject/read.d.ts +75 -0
  76. package/dist/commands/onboarding/inject/read.js +18 -0
  77. package/dist/commands/onboarding/inject/recipes.d.ts +63 -0
  78. package/dist/commands/onboarding/inject/recipes.js +12 -0
  79. package/dist/commands/onboarding/inject/remove.d.ts +67 -0
  80. package/dist/commands/onboarding/inject/remove.js +15 -0
  81. package/dist/commands/onboarding/list.d.ts +13 -0
  82. package/dist/commands/onboarding/list.js +12 -0
  83. package/dist/commands/onboarding/logs.d.ts +41 -0
  84. package/dist/commands/onboarding/logs.js +257 -0
  85. package/dist/commands/onboarding/navwalk.d.ts +95 -0
  86. package/dist/commands/onboarding/navwalk.js +19 -0
  87. package/dist/commands/onboarding/response.d.ts +67 -0
  88. package/dist/commands/onboarding/response.js +18 -0
  89. package/dist/commands/onboarding/rum/beacons.d.ts +75 -0
  90. package/dist/commands/onboarding/rum/beacons.js +16 -0
  91. package/dist/commands/onboarding/rum/get.d.ts +77 -0
  92. package/dist/commands/onboarding/rum/get.js +18 -0
  93. package/dist/commands/onboarding/rum/key.d.ts +67 -0
  94. package/dist/commands/onboarding/rum/key.js +13 -0
  95. package/dist/commands/onboarding/rum/previous.d.ts +63 -0
  96. package/dist/commands/onboarding/rum/previous.js +12 -0
  97. package/dist/commands/onboarding/status.d.ts +13 -0
  98. package/dist/commands/onboarding/status.js +17 -0
  99. package/dist/commands/onboarding/stop.d.ts +13 -0
  100. package/dist/commands/onboarding/stop.js +17 -0
  101. package/dist/commands/onboarding/todo.d.ts +58 -0
  102. package/dist/commands/onboarding/todo.js +12 -0
  103. package/dist/commands/onboarding/viewport.d.ts +101 -0
  104. package/dist/commands/onboarding/viewport.js +18 -0
  105. package/dist/commands/onboarding/watch.d.ts +93 -0
  106. package/dist/commands/onboarding/watch.js +16 -0
  107. package/dist/commands/onboarding.d.ts +26 -0
  108. package/dist/commands/onboarding.js +221 -4
  109. package/dist/commands/origin-request.d.ts +4 -0
  110. package/dist/commands/origin-request.js +4 -0
  111. package/dist/commands/spec/onboarding.spec.d.ts +1 -0
  112. package/dist/commands/spec/onboarding.spec.js +127 -0
  113. package/dist/services/cli/build-info.d.ts +33 -0
  114. package/dist/services/cli/build-info.js +63 -0
  115. package/dist/services/cli/cli-environment-factory.d.ts +3 -0
  116. package/dist/services/cli/cli-environment-factory.js +1 -0
  117. package/dist/services/cli/cli-service-build-context.d.ts +3 -0
  118. package/dist/services/cli/cli-service-factory.js +1 -1
  119. package/dist/services/cli/cli-service-model.d.ts +29 -10
  120. package/dist/services/cli/cli-service.d.ts +60 -11
  121. package/dist/services/cli/cli-service.js +196 -32
  122. package/dist/services/cli/index.d.ts +2 -0
  123. package/dist/services/cli/index.js +2 -0
  124. package/dist/services/cli/sink.d.ts +47 -0
  125. package/dist/services/cli/sink.js +31 -0
  126. package/dist/services/cli/spec/build-identity.spec.d.ts +1 -0
  127. package/dist/services/cli/spec/build-identity.spec.js +85 -0
  128. package/dist/services/cli/spec/build-info.spec.d.ts +1 -0
  129. package/dist/services/cli/spec/build-info.spec.js +10 -0
  130. package/dist/services/cli/spec/cli-service-log.spec.d.ts +1 -0
  131. package/dist/services/cli/spec/cli-service-log.spec.js +133 -0
  132. package/dist/services/cli/spec/cli-service.spec.js +113 -50
  133. package/dist/services/cli/spec/memory-cli.d.ts +9 -0
  134. package/dist/services/cli/spec/memory-cli.js +9 -0
  135. package/dist/services/diff/config-at-ref.d.ts +20 -0
  136. package/dist/services/diff/config-at-ref.js +33 -0
  137. package/dist/services/diff/diff-service-build-context.d.ts +12 -0
  138. package/dist/services/diff/diff-service-build-context.js +45 -1
  139. package/dist/services/diff/diff-service-factory.d.ts +2 -0
  140. package/dist/services/diff/diff-service-factory.js +65 -25
  141. package/dist/services/diff/diff-service.d.ts +11 -0
  142. package/dist/services/diff/diff-service.js +37 -11
  143. package/dist/services/diff/page-source.d.ts +12 -0
  144. package/dist/services/diff/page-source.js +16 -11
  145. package/dist/services/diff/run-runtime-config.d.ts +33 -0
  146. package/dist/services/diff/run-runtime-config.js +74 -0
  147. package/dist/services/diff/sinks/tool-diff-sink.d.ts +3 -2
  148. package/dist/services/diff/sinks/tool-diff-sink.js +3 -2
  149. package/dist/services/diff/spec/config-at-ref.spec.d.ts +1 -0
  150. package/dist/services/diff/spec/config-at-ref.spec.js +46 -0
  151. package/dist/services/diff/spec/diff-service-build-context.spec.js +19 -0
  152. package/dist/services/diff/spec/diff-service.spec.js +95 -0
  153. package/dist/services/diff/spec/run-runtime-config.spec.d.ts +1 -0
  154. package/dist/services/diff/spec/run-runtime-config.spec.js +87 -0
  155. package/dist/services/git/git-repository.d.ts +2 -0
  156. package/dist/services/git/git-repository.js +6 -0
  157. package/dist/services/integration-api/customer-config-flags.js +1 -0
  158. package/dist/services/onboarding/browse/browse-service.d.ts +13 -1
  159. package/dist/services/onboarding/browse/browse-service.js +40 -7
  160. package/dist/services/onboarding/browser/answer-dialogs.d.ts +12 -0
  161. package/dist/services/onboarding/browser/answer-dialogs.js +25 -0
  162. package/dist/services/onboarding/browser/baqend-response.d.ts +17 -1
  163. package/dist/services/onboarding/browser/baqend-response.js +23 -0
  164. package/dist/services/onboarding/browser/console-log.d.ts +9 -0
  165. package/dist/services/onboarding/browser/console-log.js +27 -0
  166. package/dist/services/onboarding/browser/emulate-device.d.ts +12 -1
  167. package/dist/services/onboarding/browser/emulate-device.js +33 -6
  168. package/dist/services/onboarding/browser/executable/executable-validator.js +4 -2
  169. package/dist/services/onboarding/browser/extension/extension-bridge.js +5 -3
  170. package/dist/services/onboarding/browser/extension/extension-downloader.js +17 -8
  171. package/dist/services/onboarding/browser/extension/extension-validator.js +9 -4
  172. package/dist/services/onboarding/browser/launch-browser.d.ts +2 -1
  173. package/dist/services/onboarding/browser/launch-browser.js +3 -1
  174. package/dist/services/onboarding/control/body-inspect.d.ts +24 -0
  175. package/dist/services/onboarding/control/body-inspect.js +106 -0
  176. package/dist/services/onboarding/control/browser-session.d.ts +535 -0
  177. package/dist/services/onboarding/control/browser-session.js +1300 -0
  178. package/dist/services/onboarding/control/config-validation.d.ts +17 -0
  179. package/dist/services/onboarding/control/config-validation.js +46 -0
  180. package/dist/services/onboarding/control/control-protocol.d.ts +1428 -0
  181. package/dist/services/onboarding/control/control-protocol.js +58 -0
  182. package/dist/services/onboarding/control/control-server.d.ts +292 -0
  183. package/dist/services/onboarding/control/control-server.js +1629 -0
  184. package/dist/services/onboarding/control/debug-session.d.ts +219 -0
  185. package/dist/services/onboarding/control/debug-session.js +897 -0
  186. package/dist/services/onboarding/control/fouc.d.ts +23 -0
  187. package/dist/services/onboarding/control/fouc.js +151 -0
  188. package/dist/services/onboarding/control/index.d.ts +4 -0
  189. package/dist/services/onboarding/control/index.js +4 -0
  190. package/dist/services/onboarding/control/navigate-wait.d.ts +33 -0
  191. package/dist/services/onboarding/control/navigate-wait.js +56 -0
  192. package/dist/services/onboarding/control/navwalk.d.ts +65 -0
  193. package/dist/services/onboarding/control/navwalk.js +248 -0
  194. package/dist/services/onboarding/control/preload-registry.d.ts +150 -0
  195. package/dist/services/onboarding/control/preload-registry.js +829 -0
  196. package/dist/services/onboarding/control/response-explainer.d.ts +24 -0
  197. package/dist/services/onboarding/control/response-explainer.js +257 -0
  198. package/dist/services/onboarding/control/rum.d.ts +8 -0
  199. package/dist/services/onboarding/control/rum.js +220 -0
  200. package/dist/services/onboarding/control/service-worker-tracker.d.ts +68 -0
  201. package/dist/services/onboarding/control/service-worker-tracker.js +120 -0
  202. package/dist/services/onboarding/control/viewport.d.ts +45 -0
  203. package/dist/services/onboarding/control/viewport.js +344 -0
  204. package/dist/services/onboarding/control/watch.d.ts +26 -0
  205. package/dist/services/onboarding/control/watch.js +157 -0
  206. package/dist/services/onboarding/dashboard/diff-against-current-page.js +3 -1
  207. package/dist/services/onboarding/dashboard/index.js +7 -2
  208. package/dist/services/onboarding/fetch-event-handler.d.ts +24 -5
  209. package/dist/services/onboarding/fetch-event-handler.js +103 -32
  210. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +11 -2
  211. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +14 -0
  212. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +30 -0
  213. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +13 -0
  214. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +28 -1
  215. package/dist/services/onboarding/file-events/file-watcher.d.ts +42 -1
  216. package/dist/services/onboarding/file-events/file-watcher.js +117 -12
  217. package/dist/services/onboarding/inject/inject-service.js +1 -1
  218. package/dist/services/onboarding/onboarding-model.d.ts +30 -0
  219. package/dist/services/onboarding/onboarding-model.js +12 -1
  220. package/dist/services/onboarding/onboarding-service-build-context.d.ts +4 -0
  221. package/dist/services/onboarding/onboarding-service-build-context.js +7 -1
  222. package/dist/services/onboarding/onboarding-service-factory.d.ts +17 -1
  223. package/dist/services/onboarding/onboarding-service-factory.js +150 -23
  224. package/dist/services/onboarding/onboarding-service.d.ts +40 -1
  225. package/dist/services/onboarding/onboarding-service.js +136 -23
  226. package/dist/services/onboarding/request-cache/asset-key.d.ts +61 -0
  227. package/dist/services/onboarding/request-cache/asset-key.js +115 -0
  228. package/dist/services/onboarding/request-cache/cache.d.ts +62 -5
  229. package/dist/services/onboarding/request-cache/cache.js +128 -17
  230. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.d.ts +1 -0
  231. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.js +66 -0
  232. package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +1 -0
  233. package/dist/services/onboarding/spec/browser/console-log.spec.js +42 -0
  234. package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +1 -0
  235. package/dist/services/onboarding/spec/control/browser-session.spec.js +651 -0
  236. package/dist/services/onboarding/spec/control/control-server.spec.d.ts +1 -0
  237. package/dist/services/onboarding/spec/control/control-server.spec.js +371 -0
  238. package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +1 -0
  239. package/dist/services/onboarding/spec/control/debug-session.spec.js +751 -0
  240. package/dist/services/onboarding/spec/control/fakes.d.ts +31 -0
  241. package/dist/services/onboarding/spec/control/fakes.js +66 -0
  242. package/dist/services/onboarding/spec/control/fouc.spec.d.ts +1 -0
  243. package/dist/services/onboarding/spec/control/fouc.spec.js +167 -0
  244. package/dist/services/onboarding/spec/control/navigate-wait.spec.d.ts +1 -0
  245. package/dist/services/onboarding/spec/control/navigate-wait.spec.js +47 -0
  246. package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +1 -0
  247. package/dist/services/onboarding/spec/control/navwalk.spec.js +222 -0
  248. package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +1 -0
  249. package/dist/services/onboarding/spec/control/preload-registry.spec.js +432 -0
  250. package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +1 -0
  251. package/dist/services/onboarding/spec/control/response-explainer.spec.js +324 -0
  252. package/dist/services/onboarding/spec/control/rum.spec.d.ts +1 -0
  253. package/dist/services/onboarding/spec/control/rum.spec.js +222 -0
  254. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +1 -0
  255. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +193 -0
  256. package/dist/services/onboarding/spec/control/viewport.spec.d.ts +1 -0
  257. package/dist/services/onboarding/spec/control/viewport.spec.js +200 -0
  258. package/dist/services/onboarding/spec/control/watch.spec.d.ts +1 -0
  259. package/dist/services/onboarding/spec/control/watch.spec.js +187 -0
  260. package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +1 -0
  261. package/dist/services/onboarding/spec/fetch-event-handler.spec.js +219 -0
  262. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +1 -0
  263. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +41 -0
  264. package/dist/services/onboarding/spec/onboarding-model.spec.js +39 -3
  265. package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +25 -1
  266. package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +1 -0
  267. package/dist/services/onboarding/spec/request-cache/cache.spec.js +107 -0
  268. package/dist/services/onboarding/spec/todo-collector.spec.d.ts +1 -0
  269. package/dist/services/onboarding/spec/todo-collector.spec.js +136 -0
  270. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.d.ts +1 -0
  271. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.js +65 -0
  272. package/dist/services/onboarding/todo-collector.d.ts +7 -2
  273. package/dist/services/onboarding/todo-collector.js +49 -12
  274. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +38 -0
  275. package/dist/services/onboarding/virtual-orestes-app/index.js +113 -27
  276. package/dist/services/origin-request/asset-variations.d.ts +14 -0
  277. package/dist/services/origin-request/asset-variations.js +11 -4
  278. package/dist/services/origin-request/origin-fetcher.d.ts +7 -0
  279. package/dist/services/origin-request/origin-fetcher.js +43 -5
  280. package/dist/services/origin-request/origin-request-service-build-context.d.ts +17 -0
  281. package/dist/services/origin-request/origin-request-service-build-context.js +8 -0
  282. package/dist/services/origin-request/origin-request-service-factory.d.ts +0 -5
  283. package/dist/services/origin-request/origin-request-service-factory.js +2 -30
  284. package/dist/services/origin-request/origin-request-service.d.ts +121 -6
  285. package/dist/services/origin-request/origin-request-service.js +273 -49
  286. package/dist/services/origin-request/runtime-config-source.d.ts +6 -0
  287. package/dist/services/origin-request/runtime-config-source.js +15 -4
  288. package/dist/services/origin-request/spec/asset-variations.spec.js +20 -0
  289. package/dist/services/origin-request/spec/origin-request-service.spec.js +329 -6
  290. package/dist/services/query-builder/rules/rule-match.d.ts +35 -0
  291. package/dist/services/query-builder/rules/rule-match.js +70 -0
  292. package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +1 -0
  293. package/dist/services/query-builder/spec/rules/rule-match.spec.js +121 -0
  294. package/dist/services/run-control/browser/run-browser-contexts.d.ts +557 -0
  295. package/dist/services/run-control/browser/run-browser-contexts.js +91 -0
  296. package/dist/services/run-control/browser/run-browser-service-factory.d.ts +5 -0
  297. package/dist/services/run-control/browser/run-browser-service-factory.js +7 -0
  298. package/dist/services/run-control/browser/run-browser-service.d.ts +68 -0
  299. package/dist/services/run-control/browser/run-browser-service.js +206 -0
  300. package/dist/services/run-control/cache/run-cache-contexts.d.ts +349 -0
  301. package/dist/services/run-control/cache/run-cache-contexts.js +51 -0
  302. package/dist/services/run-control/cache/run-cache-service-factory.d.ts +6 -0
  303. package/dist/services/run-control/cache/run-cache-service-factory.js +12 -0
  304. package/dist/services/run-control/cache/run-cache-service.d.ts +35 -0
  305. package/dist/services/run-control/cache/run-cache-service.js +151 -0
  306. package/dist/services/run-control/control-client.d.ts +36 -0
  307. package/dist/services/run-control/control-client.js +147 -0
  308. package/dist/services/run-control/debug/run-debug-contexts.d.ts +416 -0
  309. package/dist/services/run-control/debug/run-debug-contexts.js +47 -0
  310. package/dist/services/run-control/debug/run-debug-service-factory.d.ts +5 -0
  311. package/dist/services/run-control/debug/run-debug-service-factory.js +7 -0
  312. package/dist/services/run-control/debug/run-debug-service.d.ts +39 -0
  313. package/dist/services/run-control/debug/run-debug-service.js +164 -0
  314. package/dist/services/run-control/files/run-files-contexts.d.ts +238 -0
  315. package/dist/services/run-control/files/run-files-contexts.js +26 -0
  316. package/dist/services/run-control/files/run-files-service-factory.d.ts +5 -0
  317. package/dist/services/run-control/files/run-files-service-factory.js +7 -0
  318. package/dist/services/run-control/files/run-files-service.d.ts +29 -0
  319. package/dist/services/run-control/files/run-files-service.js +120 -0
  320. package/dist/services/run-control/index.d.ts +32 -0
  321. package/dist/services/run-control/index.js +31 -0
  322. package/dist/services/run-control/inject/run-inject-contexts.d.ts +319 -0
  323. package/dist/services/run-control/inject/run-inject-contexts.js +38 -0
  324. package/dist/services/run-control/inject/run-inject-service-factory.d.ts +5 -0
  325. package/dist/services/run-control/inject/run-inject-service-factory.js +7 -0
  326. package/dist/services/run-control/inject/run-inject-service.d.ts +31 -0
  327. package/dist/services/run-control/inject/run-inject-service.js +227 -0
  328. package/dist/services/run-control/live-run.d.ts +37 -0
  329. package/dist/services/run-control/live-run.js +56 -0
  330. package/dist/services/run-control/probe/run-probe-contexts.d.ts +333 -0
  331. package/dist/services/run-control/probe/run-probe-contexts.js +73 -0
  332. package/dist/services/run-control/probe/run-probe-service-factory.d.ts +5 -0
  333. package/dist/services/run-control/probe/run-probe-service-factory.js +7 -0
  334. package/dist/services/run-control/probe/run-probe-service.d.ts +54 -0
  335. package/dist/services/run-control/probe/run-probe-service.js +194 -0
  336. package/dist/services/run-control/rum/run-rum-contexts.d.ts +216 -0
  337. package/dist/services/run-control/rum/run-rum-contexts.js +34 -0
  338. package/dist/services/run-control/rum/run-rum-service-factory.d.ts +5 -0
  339. package/dist/services/run-control/rum/run-rum-service-factory.js +7 -0
  340. package/dist/services/run-control/rum/run-rum-service.d.ts +36 -0
  341. package/dist/services/run-control/rum/run-rum-service.js +122 -0
  342. package/dist/services/run-control/run-answer.d.ts +28 -0
  343. package/dist/services/run-control/run-answer.js +58 -0
  344. package/dist/services/run-control/run-control-context.d.ts +102 -0
  345. package/dist/services/run-control/run-control-context.js +36 -0
  346. package/dist/services/run-control/run-control-flags.d.ts +12 -0
  347. package/dist/services/run-control/run-control-flags.js +22 -0
  348. package/dist/services/run-control/run-control-model.d.ts +9 -0
  349. package/dist/services/run-control/run-control-model.js +1 -0
  350. package/dist/services/run-control/run-control-service-factory.d.ts +14 -0
  351. package/dist/services/run-control/run-control-service-factory.js +26 -0
  352. package/dist/services/run-control/session/run-session-contexts.d.ts +25 -0
  353. package/dist/services/run-control/session/run-session-contexts.js +20 -0
  354. package/dist/services/run-control/session/run-session-service-factory.d.ts +8 -0
  355. package/dist/services/run-control/session/run-session-service-factory.js +18 -0
  356. package/dist/services/run-control/session/run-session-service.d.ts +32 -0
  357. package/dist/services/run-control/session/run-session-service.js +151 -0
  358. package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +1 -0
  359. package/dist/services/run-control/spec/browser/run-browser-service.spec.js +327 -0
  360. package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +1 -0
  361. package/dist/services/run-control/spec/cache/run-cache-service.spec.js +454 -0
  362. package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +1 -0
  363. package/dist/services/run-control/spec/debug/run-debug-service.spec.js +113 -0
  364. package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +1 -0
  365. package/dist/services/run-control/spec/files/run-files-service.spec.js +234 -0
  366. package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +1 -0
  367. package/dist/services/run-control/spec/inject/run-inject-service.spec.js +251 -0
  368. package/dist/services/run-control/spec/live-run-fixture.d.ts +32 -0
  369. package/dist/services/run-control/spec/live-run-fixture.js +109 -0
  370. package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +1 -0
  371. package/dist/services/run-control/spec/probe/run-probe-service.spec.js +108 -0
  372. package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +1 -0
  373. package/dist/services/run-control/spec/rum/run-rum-service.spec.js +47 -0
  374. package/dist/services/run-control/spec/run-answer.spec.d.ts +1 -0
  375. package/dist/services/run-control/spec/run-answer.spec.js +57 -0
  376. package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +1 -0
  377. package/dist/services/run-control/spec/session/run-session-service.spec.js +150 -0
  378. package/dist/services/run-log/crash-mirror.d.ts +31 -0
  379. package/dist/services/run-log/crash-mirror.js +69 -0
  380. package/dist/services/run-log/index.d.ts +11 -0
  381. package/dist/services/run-log/index.js +11 -0
  382. package/dist/services/run-log/jsonl-appender.d.ts +46 -0
  383. package/dist/services/run-log/jsonl-appender.js +91 -0
  384. package/dist/services/run-log/log-event-model.d.ts +104 -0
  385. package/dist/services/run-log/log-event-model.js +56 -0
  386. package/dist/services/run-log/log-query-service-factory.d.ts +11 -0
  387. package/dist/services/run-log/log-query-service-factory.js +14 -0
  388. package/dist/services/run-log/log-query-service.d.ts +59 -0
  389. package/dist/services/run-log/log-query-service.js +111 -0
  390. package/dist/services/run-log/log-reader.d.ts +84 -0
  391. package/dist/services/run-log/log-reader.js +180 -0
  392. package/dist/services/run-log/log-summary.d.ts +72 -0
  393. package/dist/services/run-log/log-summary.js +208 -0
  394. package/dist/services/run-log/redaction.d.ts +34 -0
  395. package/dist/services/run-log/redaction.js +124 -0
  396. package/dist/services/run-log/request-log.d.ts +82 -0
  397. package/dist/services/run-log/request-log.js +69 -0
  398. package/dist/services/run-log/request-summary.d.ts +76 -0
  399. package/dist/services/run-log/request-summary.js +0 -0
  400. package/dist/services/run-log/run-log.d.ts +61 -0
  401. package/dist/services/run-log/run-log.js +102 -0
  402. package/dist/services/run-log/spec/log-query-service.spec.d.ts +1 -0
  403. package/dist/services/run-log/spec/log-query-service.spec.js +197 -0
  404. package/dist/services/run-log/spec/log-reader.spec.d.ts +1 -0
  405. package/dist/services/run-log/spec/log-reader.spec.js +109 -0
  406. package/dist/services/run-log/spec/log-summary.spec.d.ts +1 -0
  407. package/dist/services/run-log/spec/log-summary.spec.js +153 -0
  408. package/dist/services/run-log/spec/redaction.spec.d.ts +1 -0
  409. package/dist/services/run-log/spec/redaction.spec.js +61 -0
  410. package/dist/services/run-log/spec/request-log.spec.d.ts +1 -0
  411. package/dist/services/run-log/spec/request-log.spec.js +101 -0
  412. package/dist/services/run-log/spec/request-summary.spec.d.ts +1 -0
  413. package/dist/services/run-log/spec/request-summary.spec.js +171 -0
  414. package/dist/services/run-log/spec/run-log.spec.d.ts +1 -0
  415. package/dist/services/run-log/spec/run-log.spec.js +122 -0
  416. package/dist/services/run-registry/exit-classification.d.ts +39 -0
  417. package/dist/services/run-registry/exit-classification.js +42 -0
  418. package/dist/services/run-registry/index.d.ts +3 -0
  419. package/dist/services/run-registry/index.js +3 -0
  420. package/dist/services/run-registry/process-identity.d.ts +28 -0
  421. package/dist/services/run-registry/process-identity.js +80 -0
  422. package/dist/services/run-registry/run-registry-model.d.ts +128 -0
  423. package/dist/services/run-registry/run-registry-model.js +16 -0
  424. package/dist/services/run-registry/run-registry.d.ts +155 -0
  425. package/dist/services/run-registry/run-registry.js +430 -0
  426. package/dist/services/run-registry/spec/exit-classification.spec.d.ts +1 -0
  427. package/dist/services/run-registry/spec/exit-classification.spec.js +82 -0
  428. package/dist/services/run-registry/spec/run-registry.spec.d.ts +1 -0
  429. package/dist/services/run-registry/spec/run-registry.spec.js +526 -0
  430. package/dist/services/setup/os/tool-registry.js +2 -2
  431. package/oclif.manifest.json +3409 -288
  432. package/package.json +20 -2
@@ -1,3 +1,6 @@
1
+ import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
2
+ import { tmpdir } from "node:os";
3
+ import path from "node:path";
1
4
  import { expect } from "chai";
2
5
  import { describe, it } from "mocha";
3
6
  import { DiffEngine } from "../diff-engine.js";
@@ -407,3 +410,95 @@ describe("DiffService variation", () => {
407
410
  ]);
408
411
  });
409
412
  });
413
+ /** A page source that renders whatever origin HTML it is given with `render`. */
414
+ function renderingSource(render) {
415
+ const origins = [];
416
+ const source = {
417
+ origins,
418
+ async origin(url, variation) {
419
+ origins.push(`${variation} ${url}`);
420
+ return { html: "<p>origin</p>" };
421
+ },
422
+ async fromHtml(html, _url, _variation, options) {
423
+ const content = render(html);
424
+ if (content instanceof PageSideFailure)
425
+ throw content;
426
+ return { label: options.label, content };
427
+ },
428
+ };
429
+ return source;
430
+ }
431
+ function baseService(before, after, options = {}) {
432
+ const shown = [];
433
+ const failed = [];
434
+ const removed = [];
435
+ const log = recordingLog();
436
+ const pages = renderingSource(after);
437
+ const diff = new DiffService({
438
+ options: {
439
+ pageUrl: "https://shop.test/c/shoes",
440
+ variation: "default",
441
+ base: "origin/main",
442
+ ...options,
443
+ },
444
+ log,
445
+ engine: new DiffEngine({
446
+ sink: {
447
+ async show(result) {
448
+ shown.push(result);
449
+ return undefined;
450
+ },
451
+ fail(comparison) {
452
+ failed.push(comparison);
453
+ },
454
+ },
455
+ }),
456
+ pages,
457
+ base: {
458
+ pages: renderingSource(before),
459
+ remove: async () => {
460
+ removed.push("base");
461
+ },
462
+ },
463
+ });
464
+ return { diff, shown, failed, removed, log, pages };
465
+ }
466
+ describe("DiffService base", () => {
467
+ it("renders one origin page with both configs and shows the change", async () => {
468
+ const { diff, shown, removed, pages } = baseService((html) => `${html}<p>old</p>`, (html) => `${html}<p>new</p>`, { variation: "mobile" });
469
+ expect(await diff.run()).to.equal("differs");
470
+ expect(pages.origins).to.deep.equal(["mobile https://shop.test/c/shoes"]);
471
+ expect(shown[0].left.label).to.equal("config at origin/main");
472
+ expect(shown[0].right.label).to.equal("working tree");
473
+ expect(removed).to.deep.equal(["base"]);
474
+ });
475
+ it("finds no diff when the change leaves the page alone", async () => {
476
+ const { diff } = baseService((html) => html, (html) => html);
477
+ expect(await diff.run()).to.equal("equal");
478
+ });
479
+ it("is uncacheable with the handler's message when the working tree throws", async () => {
480
+ const thrown = new PageSideFailure({
481
+ url: "https://shop.test/c/shoes",
482
+ variation: "default",
483
+ failure: documentHandlerFailure(new DocumentHandlerTransformError(new TypeError("grid is undefined"))),
484
+ });
485
+ const { diff, failed, log } = baseService((html) => html, () => thrown);
486
+ expect(await diff.run()).to.equal("uncacheable");
487
+ expect(failed).to.have.length(1);
488
+ expect(log.lines.join("\n")).to.contain("grid is undefined");
489
+ });
490
+ it("renders a saved page instead of requesting it", async () => {
491
+ const dir = mkdtempSync(path.join(tmpdir(), "sk-diff-spec-"));
492
+ const file = path.join(dir, "page.html");
493
+ writeFileSync(file, "<p>saved</p>");
494
+ const { diff, shown, pages } = baseService((html) => html, (html) => html, { html: file });
495
+ try {
496
+ expect(await diff.run()).to.equal("equal");
497
+ expect(pages.origins).to.have.length(0);
498
+ expect(shown[0].left.content).to.equal("<p>saved</p>");
499
+ }
500
+ finally {
501
+ rmSync(dir, { recursive: true });
502
+ }
503
+ });
504
+ });
@@ -0,0 +1,87 @@
1
+ import { expect } from "chai";
2
+ import { describe, it } from "mocha";
3
+ import ApplicationError from "../../error-handling/error/application-error.js";
4
+ import { memoryCli } from "../../cli/spec/memory-cli.js";
5
+ import { ControlError } from "../../run-control/control-client.js";
6
+ import { diffRuntimeConfig } from "../run-runtime-config.js";
7
+ const LOGIN_CONFIG = {
8
+ variations: { app: { headers: { "x-app": "1" } } },
9
+ authentications: [],
10
+ originMap: {},
11
+ };
12
+ /** A live run that answers `config.runtime` with `config`, or fails with `error`. */
13
+ function liveRun(config, error) {
14
+ return {
15
+ id: "shop-production-1",
16
+ request: async () => {
17
+ if (error)
18
+ throw error;
19
+ return { config };
20
+ },
21
+ };
22
+ }
23
+ describe("diffRuntimeConfig", () => {
24
+ it("should take the config the live run loaded, without the login", async () => {
25
+ const runConfig = { ...LOGIN_CONFIG, originMap: { a: {} } };
26
+ let loaded = false;
27
+ const config = await diffRuntimeConfig({
28
+ log: memoryCli(),
29
+ run: liveRun(runConfig),
30
+ load: async () => {
31
+ loaded = true;
32
+ return LOGIN_CONFIG;
33
+ },
34
+ });
35
+ expect(config).to.deep.equal(runConfig);
36
+ expect(loaded).to.equal(false);
37
+ });
38
+ it("should refuse when the run loaded no config, even with a login, and name the cause and fixes", async () => {
39
+ const error = await diffRuntimeConfig({
40
+ log: memoryCli(),
41
+ run: liveRun(null),
42
+ load: async () => LOGIN_CONFIG,
43
+ }).catch((caught) => caught);
44
+ expect(error).to.be.instanceOf(ApplicationError);
45
+ expect(error.message).to.contain("the live run shop-production-1 loaded no runtime config");
46
+ const suggestions = error.suggestions.join(" ");
47
+ expect(suggestions).to.contain("sk login");
48
+ expect(suggestions).to.contain("--variationsFile");
49
+ });
50
+ it("should refuse without a run and without a login, and name the alternatives", async () => {
51
+ const error = await diffRuntimeConfig({
52
+ log: memoryCli(),
53
+ load: async () => undefined,
54
+ }).catch((caught) => caught);
55
+ expect(error).to.be.instanceOf(ApplicationError);
56
+ expect(error.message).to.contain("no login");
57
+ const suggestions = error.suggestions.join(" ");
58
+ expect(suggestions).to.contain("sk login");
59
+ expect(suggestions).to.contain("--run");
60
+ expect(suggestions).to.contain("--variationsFile");
61
+ });
62
+ it("should refuse when --variationsFile cannot be read, and name the file", async () => {
63
+ const error = await diffRuntimeConfig({
64
+ log: memoryCli(),
65
+ file: "runtime.json",
66
+ load: async () => undefined,
67
+ }).catch((caught) => caught);
68
+ expect(error.message).to.contain("runtime.json could not be read");
69
+ });
70
+ it("should load the app's config when a found run of an older build cannot answer", async () => {
71
+ const config = await diffRuntimeConfig({
72
+ log: memoryCli(),
73
+ run: liveRun(null, new ControlError("UNKNOWN_OP", "no such op")),
74
+ load: async () => LOGIN_CONFIG,
75
+ });
76
+ expect(config).to.equal(LOGIN_CONFIG);
77
+ });
78
+ it("should not hide the failure of a run --run named", async () => {
79
+ const error = await diffRuntimeConfig({
80
+ log: memoryCli(),
81
+ run: liveRun(null, new ControlError("UNKNOWN_OP", "no such op")),
82
+ runNamed: true,
83
+ load: async () => LOGIN_CONFIG,
84
+ }).catch((caught) => caught);
85
+ expect(error).to.be.instanceOf(ControlError);
86
+ });
87
+ });
@@ -24,6 +24,8 @@ export declare class GitRepository {
24
24
  changedPaths(request: MergedRequest): string[];
25
25
  /** The paths below `directory` that the commit holds. */
26
26
  pathsAt(sha: string, directory: string): string[];
27
+ /** The commit where HEAD left `ref`: `ref` itself when HEAD contains it. */
28
+ mergeBase(ref: string): string;
27
29
  /** The content of one file in the commit. */
28
30
  contentAt(sha: string, filePath: string): string;
29
31
  /** The paths below `directory` that changed between the commit and HEAD. */
@@ -77,6 +77,10 @@ export class GitRepository {
77
77
  .split("\n")
78
78
  .filter((line) => line.length > 0);
79
79
  }
80
+ /** The commit where HEAD left `ref`: `ref` itself when HEAD contains it. */
81
+ mergeBase(ref) {
82
+ return this.run(["merge-base", "HEAD", ref]).trim();
83
+ }
80
84
  /** The content of one file in the commit. */
81
85
  contentAt(sha, filePath) {
82
86
  return this.run(["show", `${sha}:${filePath}`]);
@@ -111,6 +115,8 @@ function runGit(cwd) {
111
115
  cwd,
112
116
  encoding: "utf8",
113
117
  maxBuffer: 32 * 1024 * 1024,
118
+ // The error below carries git's stderr; inherited, it would print twice.
119
+ stdio: ["ignore", "pipe", "pipe"],
114
120
  });
115
121
  }
116
122
  catch (error) {
@@ -25,6 +25,7 @@ export const CLI_CONFIG_NAME = {
25
25
  export const CLI_CONFIG_IS_TEST = {
26
26
  useTestConfig: Flags.boolean({
27
27
  char: "t",
28
+ default: false,
28
29
  description: "Override app with configured testApp",
29
30
  }),
30
31
  };
@@ -1,18 +1,30 @@
1
1
  import { CliServiceInterface } from "../../cli/index.js";
2
2
  import { BrowserContext } from "../onboarding-model.js";
3
+ import { BrowserSession, ControlServer } from "../control/index.js";
3
4
  /**
4
5
  * `sk onboarding --browse`: the onboarding Chrome on the live site, as a visitor gets it.
5
6
  *
6
7
  * It launches the same Chrome as onboarding, with the same flags, profile and extensions. It
7
8
  * installs no request interception, serves no local files and injects no Speed Kit, so a site that
8
9
  * runs Speed Kit in production runs its own deployed build.
10
+ *
11
+ * A recorded run serves the control socket, so `sk onboarding browser …` and
12
+ * `debug …` reach it with `--run`, as they reach an onboarding run.
9
13
  */
10
14
  export declare class BrowseService {
11
15
  private readonly browserContext;
12
16
  private readonly cli;
13
- constructor(browserContext: BrowserContext, cli: CliServiceInterface);
17
+ /** Absent when the run was not recorded. */
18
+ private readonly controlServer?;
19
+ private readonly browserSession?;
20
+ constructor(browserContext: BrowserContext, cli: CliServiceInterface,
21
+ /** Absent when the run was not recorded. */
22
+ controlServer?: ControlServer, browserSession?: BrowserSession);
23
+ private readonly serviceWorkers;
14
24
  /** Opens the site, then blocks until the caller aborts `externalSignal` or Chrome disconnects. */
15
25
  run(externalSignal: AbortSignal): Promise<void>;
26
+ /** Feeds `sk onboarding browser state`, which reads what CDP streamed. */
27
+ private trackServiceWorkers;
16
28
  private readyLine;
17
29
  private findPage;
18
30
  }
@@ -1,21 +1,32 @@
1
1
  import { safe } from "../../../helpers/safe.js";
2
2
  import { launchBrowser, resetBrowserState } from "../browser/launch-browser.js";
3
- import { BROWSER_EVENTS } from "../onboarding-model.js";
3
+ import { BROWSER_EVENTS, CDP_SESSION, } from "../onboarding-model.js";
4
4
  import { waitForAbort } from "../onboarding-service.js";
5
+ import { ServiceWorkerTracker, } from "../control/index.js";
5
6
  /**
6
7
  * `sk onboarding --browse`: the onboarding Chrome on the live site, as a visitor gets it.
7
8
  *
8
9
  * It launches the same Chrome as onboarding, with the same flags, profile and extensions. It
9
10
  * installs no request interception, serves no local files and injects no Speed Kit, so a site that
10
11
  * runs Speed Kit in production runs its own deployed build.
12
+ *
13
+ * A recorded run serves the control socket, so `sk onboarding browser …` and
14
+ * `debug …` reach it with `--run`, as they reach an onboarding run.
11
15
  */
12
16
  export class BrowseService {
13
17
  browserContext;
14
18
  cli;
15
- constructor(browserContext, cli) {
19
+ controlServer;
20
+ browserSession;
21
+ constructor(browserContext, cli,
22
+ /** Absent when the run was not recorded. */
23
+ controlServer, browserSession) {
16
24
  this.browserContext = browserContext;
17
25
  this.cli = cli;
26
+ this.controlServer = controlServer;
27
+ this.browserSession = browserSession;
18
28
  }
29
+ serviceWorkers = new ServiceWorkerTracker();
19
30
  /** Opens the site, then blocks until the caller aborts `externalSignal` or Chrome disconnects. */
20
31
  async run(externalSignal) {
21
32
  this.cli.startAction("ONBOARDING:BROWSE:BROWSER", `prepare browser ${this.cli.style.bold(this.browserContext.browserVersionString)}`);
@@ -24,20 +35,36 @@ export class BrowseService {
24
35
  externalSignal,
25
36
  disconnected.signal,
26
37
  ]);
27
- const browser = await launchBrowser(this.browserContext);
38
+ if (this.controlServer) {
39
+ const listening = await safe(this.controlServer.listen(shutdownSignal));
40
+ if (listening.success !== true) {
41
+ this.cli.writeWarning(`control socket unavailable, external tools cannot reach this run: ${listening.error}`);
42
+ }
43
+ }
44
+ const browser = await launchBrowser(this.browserContext, this.cli);
28
45
  browser.on(BROWSER_EVENTS.DISCONNECTED, () => {
29
46
  this.cli.writeError("Browser disconnected, shutting down");
30
47
  disconnected.abort();
31
48
  });
32
49
  const page = await this.findPage(browser);
33
50
  const url = this.browserContext.domain;
51
+ const origin = new URL(url).origin;
34
52
  const reset = await safe(page
35
53
  .target()
36
54
  .createCDPSession()
37
- .then((session) => resetBrowserState(session, new URL(url).origin)));
55
+ .then((session) => {
56
+ this.trackServiceWorkers(session);
57
+ return resetBrowserState(session, origin);
58
+ }));
38
59
  if (reset.success !== true) {
39
60
  this.cli.writeWarning(`Could not reset the browser state: ${reset.error}`);
40
61
  }
62
+ this.browserSession?.attach(browser, page, {
63
+ origin,
64
+ origins: [origin],
65
+ reinstall: () => Promise.reject(new Error("browse mode installs no Speed Kit to reinstall")),
66
+ serviceWorkers: this.serviceWorkers,
67
+ });
41
68
  this.cli.successAction("ONBOARDING:BROWSE:BROWSER");
42
69
  const navigation = await safe(page.goto(url));
43
70
  if (navigation.success !== true) {
@@ -45,13 +72,19 @@ export class BrowseService {
45
72
  }
46
73
  this.cli.writeSuccess(this.readyLine(url));
47
74
  await waitForAbort(shutdownSignal);
75
+ this.browserSession?.detach();
48
76
  await safe(browser.close());
49
77
  }
78
+ /** Feeds `sk onboarding browser state`, which reads what CDP streamed. */
79
+ trackServiceWorkers(session) {
80
+ session.on(CDP_SESSION.EVENTS.SERVICE_WORKER.REGISTRATION_UPDATED, ({ registrations, }) => this.serviceWorkers.recordRegistrations(registrations));
81
+ session.on(CDP_SESSION.EVENTS.SERVICE_WORKER.VERSION_UPDATED, ({ versions }) => this.serviceWorkers.recordVersions(versions));
82
+ }
50
83
  readyLine(url) {
51
- const { debuggingPort, headless, debugPort } = this.browserContext;
52
- const cdp = debuggingPort || headless
84
+ const { debuggingPort, debugPort } = this.browserContext;
85
+ const cdp = debuggingPort
53
86
  ? `CDP on http://127.0.0.1:${debugPort}`
54
- : "no CDP port, pass -p or --headless to expose one";
87
+ : "no CDP port, pass -p to expose one";
55
88
  return `Browsing ${url} live, without interception or Speed Kit injection; ${cdp}. Press Ctrl+C to stop.`;
56
89
  }
57
90
  async findPage(browser) {
@@ -0,0 +1,12 @@
1
+ import { Browser } from "puppeteer";
2
+ import { CliServiceInterface } from "../../cli/index.js";
3
+ /**
4
+ * Answers every JavaScript dialog of every page of `browser`, and logs it.
5
+ *
6
+ * An open alert, confirm, prompt or beforeunload dialog blocks the page's main thread. Every CDP
7
+ * call then times out, a navigation never commits, and a headless run has nobody to close it: the
8
+ * run looked alive and every tool answered CDP_TIMEOUT until a restart. A confirm and a prompt are
9
+ * cancelled, which changes nothing on the site; an alert and a beforeunload are accepted, so the
10
+ * page goes on and a navigation leaves it.
11
+ */
12
+ export declare function answerDialogs(browser: Pick<Browser, "on" | "targets">, cli: Pick<CliServiceInterface, "writeWarning">): void;
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Answers every JavaScript dialog of every page of `browser`, and logs it.
3
+ *
4
+ * An open alert, confirm, prompt or beforeunload dialog blocks the page's main thread. Every CDP
5
+ * call then times out, a navigation never commits, and a headless run has nobody to close it: the
6
+ * run looked alive and every tool answered CDP_TIMEOUT until a restart. A confirm and a prompt are
7
+ * cancelled, which changes nothing on the site; an alert and a beforeunload are accepted, so the
8
+ * page goes on and a navigation leaves it.
9
+ */
10
+ export function answerDialogs(browser, cli) {
11
+ const watch = async (target) => {
12
+ const page = await target.page().catch(() => null);
13
+ page?.on("dialog", (dialog) => void answer(dialog, page, cli));
14
+ };
15
+ browser.on("targetcreated", watch);
16
+ for (const target of browser.targets())
17
+ void watch(target);
18
+ }
19
+ async function answer(dialog, page, cli) {
20
+ const type = dialog.type();
21
+ const accept = type === "alert" || type === "beforeunload";
22
+ cli.writeWarning(`the page opened a dialog (${type}: "${dialog.message().slice(0, 200)}"); ${accept ? "accepted" : "cancelled"} it, as a blocked page answers no tool`, false, { scope: "browser", data: { page: page.url(), dialog: type } });
23
+ // A dialog that a navigation already closed cannot be answered any more.
24
+ await (accept ? dialog.accept() : dialog.dismiss()).catch(() => undefined);
25
+ }
@@ -5,8 +5,24 @@ export declare class BaqendResponse implements Partial<Protocol.Fetch.FulfillReq
5
5
  readonly body: string;
6
6
  responseHeaders: Protocol.Fetch.HeaderEntry[];
7
7
  private readonly contentType;
8
- private readonly contentLength;
8
+ /**
9
+ * The size of the body as given, in bytes. Public because `body` is stored
10
+ * base64-encoded for Fetch.fulfillRequest, so its length is a third larger
11
+ * than the response it describes and means nothing to a reader.
12
+ */
13
+ readonly contentLength: number;
9
14
  constructor(body: string | Buffer, contentType?: string, headers?: Protocol.Fetch.HeaderEntry[], status?: number);
15
+ /**
16
+ * Rebuild a response that came back off disk, without re-running header
17
+ * augmentation.
18
+ *
19
+ * The constructor appends `via`, `Service-Worker-Allowed` and
20
+ * `Access-Control-Expose-Headers` unconditionally, so handing it headers it
21
+ * produced itself duplicates all three — on every cache hit, compounding.
22
+ * The stored headers are already final; they only need copying so a hit that
23
+ * sets `x-cache` does not write through to the cache's own array.
24
+ */
25
+ static fromCache(body: Buffer, responseHeaders: Protocol.Fetch.HeaderEntry[], responseCode: number): BaqendResponse;
10
26
  setHeader(name: string, value: string): void;
11
27
  protected addCustomHeaders(headers?: Protocol.Fetch.HeaderEntry[]): Protocol.Fetch.HeaderEntry[];
12
28
  }
@@ -19,6 +19,11 @@ export class BaqendResponse {
19
19
  body;
20
20
  responseHeaders;
21
21
  contentType;
22
+ /**
23
+ * The size of the body as given, in bytes. Public because `body` is stored
24
+ * base64-encoded for Fetch.fulfillRequest, so its length is a third larger
25
+ * than the response it describes and means nothing to a reader.
26
+ */
22
27
  contentLength;
23
28
  constructor(body, contentType, headers, status) {
24
29
  this.responseCode = status || DEFAULT_STATUS;
@@ -32,6 +37,24 @@ export class BaqendResponse {
32
37
  ? body.toString("base64")
33
38
  : Buffer.from(body).toString("base64");
34
39
  }
40
+ /**
41
+ * Rebuild a response that came back off disk, without re-running header
42
+ * augmentation.
43
+ *
44
+ * The constructor appends `via`, `Service-Worker-Allowed` and
45
+ * `Access-Control-Expose-Headers` unconditionally, so handing it headers it
46
+ * produced itself duplicates all three — on every cache hit, compounding.
47
+ * The stored headers are already final; they only need copying so a hit that
48
+ * sets `x-cache` does not write through to the cache's own array.
49
+ */
50
+ static fromCache(body, responseHeaders, responseCode) {
51
+ const response = Object.create(BaqendResponse.prototype);
52
+ response.responseCode = responseCode;
53
+ response.contentLength = body.length;
54
+ response.body = body.toString("base64");
55
+ response.responseHeaders = responseHeaders.map((header) => ({ ...header }));
56
+ return response;
57
+ }
35
58
  setHeader(name, value) {
36
59
  const sanitized = sanitizeHeaderValue(value);
37
60
  for (const header of this.responseHeaders) {
@@ -0,0 +1,9 @@
1
+ import { Page } from "puppeteer";
2
+ import { CliServiceInterface } from "../../cli/index.js";
3
+ /**
4
+ * Records the page's console warnings and errors, and the errors it did not
5
+ * catch, into the run's log under the `console` scope, never on the
6
+ * terminal. `sk onboarding logs --scope console` reads them back, so "no
7
+ * console errors" can be checked after a test without a probe.
8
+ */
9
+ export declare function recordConsole(page: Pick<Page, "on" | "url">, cli: Pick<CliServiceInterface, "logOnly">): void;
@@ -0,0 +1,27 @@
1
+ /** The console types worth a line: a log of every `console.log` would bury the run. */
2
+ const LEVELS = {
3
+ warn: "warn",
4
+ warning: "warn",
5
+ error: "error",
6
+ assert: "error",
7
+ };
8
+ /**
9
+ * Records the page's console warnings and errors, and the errors it did not
10
+ * catch, into the run's log under the `console` scope, never on the
11
+ * terminal. `sk onboarding logs --scope console` reads them back, so "no
12
+ * console errors" can be checked after a test without a probe.
13
+ */
14
+ export function recordConsole(page, cli) {
15
+ page.on("console", (message) => {
16
+ const level = LEVELS[message.type()];
17
+ if (!level)
18
+ return;
19
+ cli.logOnly(level, message.text(), {
20
+ scope: "console",
21
+ data: { page: page.url(), source: message.location()?.url },
22
+ });
23
+ });
24
+ page.on("pageerror", (error) => {
25
+ cli.logOnly("error", error instanceof Error ? error.message : String(error), { scope: "console", data: { page: page.url(), uncaught: true } });
26
+ });
27
+ }
@@ -1,4 +1,4 @@
1
- import { Browser } from "puppeteer";
1
+ import { Browser, CDPSession, Protocol } from "puppeteer";
2
2
  import { BrowserContext } from "../onboarding-model.js";
3
3
  /**
4
4
  * Emulates the device of `--device` on every page and Service Worker of `browser`: the ones open
@@ -11,3 +11,14 @@ import { BrowserContext } from "../onboarding-model.js";
11
11
  * The overrides live as long as this session, which lives as long as the browser connection.
12
12
  */
13
13
  export declare function emulateDevice(browser: Browser, browserContext: BrowserContext): Promise<void>;
14
+ /**
15
+ * Calls `handle` on every target of `browser` that `filter` admits: the ones open now, and every
16
+ * one opened later. A new target waits until `handle` is done, so its first request already
17
+ * carries what `handle` set.
18
+ *
19
+ * The wait is bounded and always ends: a handle that hangs on a stopped worker must never leave a
20
+ * page or worker paused at its first line.
21
+ *
22
+ * Detach the returned session to stop; its targets' sessions, and what was set in them, go with it.
23
+ */
24
+ export declare function onEveryTarget(browser: Browser, handle: (session: CDPSession, targetInfo: Protocol.Target.TargetInfo) => Promise<void>, filter?: Protocol.Target.TargetFilter): Promise<CDPSession>;
@@ -10,19 +10,49 @@ import { safe } from "../../../helpers/safe.js";
10
10
  * The overrides live as long as this session, which lives as long as the browser connection.
11
11
  */
12
12
  export async function emulateDevice(browser, browserContext) {
13
+ await onEveryTarget(browser, (session, targetInfo) => emulateTarget(session, targetInfo, browserContext));
14
+ }
15
+ /** How long {@link onEveryTarget} holds a new target before it lets it run. */
16
+ const HOLD_MS = 4000;
17
+ /**
18
+ * Calls `handle` on every target of `browser` that `filter` admits: the ones open now, and every
19
+ * one opened later. A new target waits until `handle` is done, so its first request already
20
+ * carries what `handle` set.
21
+ *
22
+ * The wait is bounded and always ends: a handle that hangs on a stopped worker must never leave a
23
+ * page or worker paused at its first line.
24
+ *
25
+ * Detach the returned session to stop; its targets' sessions, and what was set in them, go with it.
26
+ */
27
+ export async function onEveryTarget(browser, handle, filter) {
13
28
  const session = await browser.target().createCDPSession();
14
29
  session.on("Target.attachedToTarget", (event) => {
15
30
  const target = session.connection()?.session(event.sessionId);
16
- if (target)
17
- void emulateTarget(target, event, browserContext);
31
+ if (!target)
32
+ return;
33
+ void (async () => {
34
+ let timer;
35
+ await safe(Promise.race([
36
+ handle(target, event.targetInfo),
37
+ new Promise((resolve) => {
38
+ timer = setTimeout(resolve, HOLD_MS);
39
+ timer.unref();
40
+ }),
41
+ ]).finally(() => clearTimeout(timer)));
42
+ if (event.waitingForDebugger) {
43
+ await safe(target.send("Runtime.runIfWaitingForDebugger"));
44
+ }
45
+ })();
18
46
  });
19
47
  await session.send("Target.setAutoAttach", {
20
48
  autoAttach: true,
21
49
  waitForDebuggerOnStart: true,
22
50
  flatten: true,
51
+ ...(filter ? { filter } : {}),
23
52
  });
53
+ return session;
24
54
  }
25
- async function emulateTarget(session, { targetInfo, waitingForDebugger }, browserContext) {
55
+ async function emulateTarget(session, targetInfo, browserContext) {
26
56
  // Not the DevTools window that `devtools: true` docks next to a headed page.
27
57
  const isPage = targetInfo.type === "page" && !targetInfo.url.startsWith("devtools:");
28
58
  const { userAgent, metadata } = browserContext.emulation;
@@ -44,7 +74,4 @@ async function emulateTarget(session, { targetInfo, waitingForDebugger }, browse
44
74
  configuration: "mobile",
45
75
  }));
46
76
  }
47
- if (waitingForDebugger) {
48
- await safe(session.send("Runtime.runIfWaitingForDebugger"));
49
- }
50
77
  }
@@ -19,7 +19,7 @@ export class ExecutableValidator {
19
19
  }
20
20
  // write error if configured path is not executable
21
21
  if (userChromePath.length > 0) {
22
- this.cli.writeError(`Invalid "chromePath" configured: ${userChromePath}`);
22
+ this.cli.writeError(`Invalid "chromePath" configured: ${userChromePath}`, false, { scope: "browser", data: { chromePath: userChromePath } });
23
23
  }
24
24
  // check if a browser is installed via puppeteer
25
25
  const puppeteerCache = new Cache(this.environment.cacheDir);
@@ -32,7 +32,9 @@ export class ExecutableValidator {
32
32
  }
33
33
  // write warning that no browser is configured
34
34
  if (userChromePath.length === 0) {
35
- this.cli.writeWarning(`No Browser configured`);
35
+ this.cli.writeWarning(`No Browser configured`, false, {
36
+ scope: "browser",
37
+ });
36
38
  }
37
39
  // ask if you want to download stable chrome
38
40
  // Without a TTY a prompt never gets an answer and ends the process, so take its default: download.
@@ -101,7 +101,7 @@ export class ExtensionBridge {
101
101
  */
102
102
  async writeMessages(messages) {
103
103
  if (!this.available) {
104
- this.cli.writeWarning("ExtensionBridge.writeMessages called before init()");
104
+ this.cli.writeWarning("ExtensionBridge.writeMessages called before init()", false, { scope: "extension" });
105
105
  return;
106
106
  }
107
107
  this.pending = {
@@ -152,13 +152,15 @@ export class ExtensionBridge {
152
152
  if (this.failing)
153
153
  return;
154
154
  this.failing = true;
155
- this.cli.writeWarning(`The devtools panel is not receiving updates: ${error}. Retrying on the next page load.`);
155
+ this.cli.writeWarning(`The devtools panel is not receiving updates: ${error}. Retrying on the next page load.`, false, { scope: "extension", data: { error } });
156
156
  }
157
157
  reportRecovery() {
158
158
  if (!this.failing)
159
159
  return;
160
160
  this.failing = false;
161
- this.cli.writeSuccess("The devtools panel is receiving updates again.");
161
+ this.cli.writeSuccess("The devtools panel is receiving updates again.", false, {
162
+ scope: "extension",
163
+ });
162
164
  }
163
165
  async setStorageItems(values) {
164
166
  const page = await this.findWebPage();