@speedkit/cli 4.51.1 → 4.52.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (439) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.md +1426 -14
  3. package/dist/base/run-control-command.d.ts +15 -0
  4. package/dist/base/run-control-command.js +20 -0
  5. package/dist/build-info.json +6 -0
  6. package/dist/commands/diff.d.ts +7 -1
  7. package/dist/commands/diff.js +9 -3
  8. package/dist/commands/login.d.ts +3 -0
  9. package/dist/commands/login.js +14 -3
  10. package/dist/commands/onboarding/browser/click.d.ts +75 -0
  11. package/dist/commands/onboarding/browser/click.js +19 -0
  12. package/dist/commands/onboarding/browser/emulate.d.ts +105 -0
  13. package/dist/commands/onboarding/browser/emulate.js +26 -0
  14. package/dist/commands/onboarding/browser/navigate.d.ts +75 -0
  15. package/dist/commands/onboarding/browser/navigate.js +19 -0
  16. package/dist/commands/onboarding/browser/panel.d.ts +63 -0
  17. package/dist/commands/onboarding/browser/panel.js +12 -0
  18. package/dist/commands/onboarding/browser/reinstall-sw.d.ts +63 -0
  19. package/dist/commands/onboarding/browser/reinstall-sw.js +14 -0
  20. package/dist/commands/onboarding/browser/reset.d.ts +71 -0
  21. package/dist/commands/onboarding/browser/reset.js +18 -0
  22. package/dist/commands/onboarding/browser/screenshot.d.ts +77 -0
  23. package/dist/commands/onboarding/browser/screenshot.js +19 -0
  24. package/dist/commands/onboarding/browser/state.d.ts +63 -0
  25. package/dist/commands/onboarding/browser/state.js +12 -0
  26. package/dist/commands/onboarding/browser/tabs.d.ts +58 -0
  27. package/dist/commands/onboarding/browser/tabs.js +16 -0
  28. package/dist/commands/onboarding/cache/clear.d.ts +58 -0
  29. package/dist/commands/onboarding/cache/clear.js +12 -0
  30. package/dist/commands/onboarding/cache/errors.d.ts +58 -0
  31. package/dist/commands/onboarding/cache/errors.js +12 -0
  32. package/dist/commands/onboarding/cache/evict.d.ts +62 -0
  33. package/dist/commands/onboarding/cache/evict.js +15 -0
  34. package/dist/commands/onboarding/cache/get.d.ts +85 -0
  35. package/dist/commands/onboarding/cache/get.js +17 -0
  36. package/dist/commands/onboarding/cache/list.d.ts +58 -0
  37. package/dist/commands/onboarding/cache/list.js +15 -0
  38. package/dist/commands/onboarding/cache/prewarm.d.ts +73 -0
  39. package/dist/commands/onboarding/cache/prewarm.js +20 -0
  40. package/dist/commands/onboarding/cache/refresh.d.ts +62 -0
  41. package/dist/commands/onboarding/cache/refresh.js +18 -0
  42. package/dist/commands/onboarding/cdp.d.ts +81 -0
  43. package/dist/commands/onboarding/cdp.js +18 -0
  44. package/dist/commands/onboarding/debug/arm.d.ts +83 -0
  45. package/dist/commands/onboarding/debug/arm.js +19 -0
  46. package/dist/commands/onboarding/debug/await.d.ts +71 -0
  47. package/dist/commands/onboarding/debug/await.js +18 -0
  48. package/dist/commands/onboarding/debug/disarm.d.ts +63 -0
  49. package/dist/commands/onboarding/debug/disarm.js +12 -0
  50. package/dist/commands/onboarding/debug/eval.d.ts +75 -0
  51. package/dist/commands/onboarding/debug/eval.js +16 -0
  52. package/dist/commands/onboarding/debug/release.d.ts +63 -0
  53. package/dist/commands/onboarding/debug/release.js +12 -0
  54. package/dist/commands/onboarding/debug/resume.d.ts +63 -0
  55. package/dist/commands/onboarding/debug/resume.js +12 -0
  56. package/dist/commands/onboarding/debug/status.d.ts +63 -0
  57. package/dist/commands/onboarding/debug/status.js +12 -0
  58. package/dist/commands/onboarding/debug/step.d.ts +67 -0
  59. package/dist/commands/onboarding/debug/step.js +15 -0
  60. package/dist/commands/onboarding/files/list.d.ts +58 -0
  61. package/dist/commands/onboarding/files/list.js +12 -0
  62. package/dist/commands/onboarding/files/read.d.ts +73 -0
  63. package/dist/commands/onboarding/files/read.js +16 -0
  64. package/dist/commands/onboarding/files/rebuild.d.ts +63 -0
  65. package/dist/commands/onboarding/files/rebuild.js +18 -0
  66. package/dist/commands/onboarding/files/validate.d.ts +58 -0
  67. package/dist/commands/onboarding/files/validate.js +12 -0
  68. package/dist/commands/onboarding/fouc.d.ts +77 -0
  69. package/dist/commands/onboarding/fouc.js +16 -0
  70. package/dist/commands/onboarding/inject/add.d.ts +89 -0
  71. package/dist/commands/onboarding/inject/add.js +17 -0
  72. package/dist/commands/onboarding/inject/clear.d.ts +63 -0
  73. package/dist/commands/onboarding/inject/clear.js +12 -0
  74. package/dist/commands/onboarding/inject/list.d.ts +63 -0
  75. package/dist/commands/onboarding/inject/list.js +12 -0
  76. package/dist/commands/onboarding/inject/read.d.ts +75 -0
  77. package/dist/commands/onboarding/inject/read.js +18 -0
  78. package/dist/commands/onboarding/inject/recipes.d.ts +63 -0
  79. package/dist/commands/onboarding/inject/recipes.js +12 -0
  80. package/dist/commands/onboarding/inject/remove.d.ts +67 -0
  81. package/dist/commands/onboarding/inject/remove.js +15 -0
  82. package/dist/commands/onboarding/list.d.ts +13 -0
  83. package/dist/commands/onboarding/list.js +12 -0
  84. package/dist/commands/onboarding/logs.d.ts +41 -0
  85. package/dist/commands/onboarding/logs.js +257 -0
  86. package/dist/commands/onboarding/navwalk.d.ts +95 -0
  87. package/dist/commands/onboarding/navwalk.js +19 -0
  88. package/dist/commands/onboarding/response.d.ts +67 -0
  89. package/dist/commands/onboarding/response.js +18 -0
  90. package/dist/commands/onboarding/rum/beacons.d.ts +75 -0
  91. package/dist/commands/onboarding/rum/beacons.js +16 -0
  92. package/dist/commands/onboarding/rum/get.d.ts +77 -0
  93. package/dist/commands/onboarding/rum/get.js +18 -0
  94. package/dist/commands/onboarding/rum/key.d.ts +67 -0
  95. package/dist/commands/onboarding/rum/key.js +13 -0
  96. package/dist/commands/onboarding/rum/previous.d.ts +63 -0
  97. package/dist/commands/onboarding/rum/previous.js +12 -0
  98. package/dist/commands/onboarding/status.d.ts +13 -0
  99. package/dist/commands/onboarding/status.js +17 -0
  100. package/dist/commands/onboarding/stop.d.ts +13 -0
  101. package/dist/commands/onboarding/stop.js +17 -0
  102. package/dist/commands/onboarding/todo.d.ts +58 -0
  103. package/dist/commands/onboarding/todo.js +12 -0
  104. package/dist/commands/onboarding/viewport.d.ts +101 -0
  105. package/dist/commands/onboarding/viewport.js +18 -0
  106. package/dist/commands/onboarding/watch.d.ts +93 -0
  107. package/dist/commands/onboarding/watch.js +16 -0
  108. package/dist/commands/onboarding.d.ts +26 -0
  109. package/dist/commands/onboarding.js +221 -4
  110. package/dist/commands/origin-request.d.ts +4 -0
  111. package/dist/commands/origin-request.js +4 -0
  112. package/dist/commands/spec/onboarding.spec.d.ts +1 -0
  113. package/dist/commands/spec/onboarding.spec.js +127 -0
  114. package/dist/services/browser-fetch/device-emulation.d.ts +11 -0
  115. package/dist/services/browser-fetch/device-emulation.js +14 -0
  116. package/dist/services/cli/build-info.d.ts +33 -0
  117. package/dist/services/cli/build-info.js +63 -0
  118. package/dist/services/cli/cli-environment-factory.d.ts +3 -0
  119. package/dist/services/cli/cli-environment-factory.js +1 -0
  120. package/dist/services/cli/cli-service-build-context.d.ts +3 -0
  121. package/dist/services/cli/cli-service-factory.js +1 -1
  122. package/dist/services/cli/cli-service-model.d.ts +29 -10
  123. package/dist/services/cli/cli-service.d.ts +60 -11
  124. package/dist/services/cli/cli-service.js +196 -32
  125. package/dist/services/cli/index.d.ts +2 -0
  126. package/dist/services/cli/index.js +2 -0
  127. package/dist/services/cli/sink.d.ts +47 -0
  128. package/dist/services/cli/sink.js +31 -0
  129. package/dist/services/cli/spec/build-identity.spec.d.ts +1 -0
  130. package/dist/services/cli/spec/build-identity.spec.js +85 -0
  131. package/dist/services/cli/spec/build-info.spec.d.ts +1 -0
  132. package/dist/services/cli/spec/build-info.spec.js +10 -0
  133. package/dist/services/cli/spec/cli-service-log.spec.d.ts +1 -0
  134. package/dist/services/cli/spec/cli-service-log.spec.js +133 -0
  135. package/dist/services/cli/spec/cli-service.spec.js +113 -50
  136. package/dist/services/cli/spec/memory-cli.d.ts +9 -0
  137. package/dist/services/cli/spec/memory-cli.js +9 -0
  138. package/dist/services/diff/config-at-ref.d.ts +20 -0
  139. package/dist/services/diff/config-at-ref.js +33 -0
  140. package/dist/services/diff/diff-service-build-context.d.ts +12 -0
  141. package/dist/services/diff/diff-service-build-context.js +45 -1
  142. package/dist/services/diff/diff-service-factory.d.ts +2 -0
  143. package/dist/services/diff/diff-service-factory.js +65 -25
  144. package/dist/services/diff/diff-service.d.ts +11 -0
  145. package/dist/services/diff/diff-service.js +37 -11
  146. package/dist/services/diff/page-source.d.ts +12 -0
  147. package/dist/services/diff/page-source.js +16 -11
  148. package/dist/services/diff/run-runtime-config.d.ts +33 -0
  149. package/dist/services/diff/run-runtime-config.js +74 -0
  150. package/dist/services/diff/sinks/tool-diff-sink.d.ts +3 -2
  151. package/dist/services/diff/sinks/tool-diff-sink.js +3 -2
  152. package/dist/services/diff/spec/config-at-ref.spec.d.ts +1 -0
  153. package/dist/services/diff/spec/config-at-ref.spec.js +46 -0
  154. package/dist/services/diff/spec/diff-service-build-context.spec.js +19 -0
  155. package/dist/services/diff/spec/diff-service.spec.js +95 -0
  156. package/dist/services/diff/spec/run-runtime-config.spec.d.ts +1 -0
  157. package/dist/services/diff/spec/run-runtime-config.spec.js +87 -0
  158. package/dist/services/git/git-repository.d.ts +2 -0
  159. package/dist/services/git/git-repository.js +6 -0
  160. package/dist/services/integration-api/customer-config-flags.js +1 -0
  161. package/dist/services/onboarding/browse/browse-service.d.ts +13 -1
  162. package/dist/services/onboarding/browse/browse-service.js +43 -7
  163. package/dist/services/onboarding/browser/answer-dialogs.d.ts +12 -0
  164. package/dist/services/onboarding/browser/answer-dialogs.js +25 -0
  165. package/dist/services/onboarding/browser/baqend-response.d.ts +17 -1
  166. package/dist/services/onboarding/browser/baqend-response.js +23 -0
  167. package/dist/services/onboarding/browser/console-log.d.ts +9 -0
  168. package/dist/services/onboarding/browser/console-log.js +27 -0
  169. package/dist/services/onboarding/browser/emulate-device.d.ts +12 -1
  170. package/dist/services/onboarding/browser/emulate-device.js +68 -13
  171. package/dist/services/onboarding/browser/executable/executable-validator.js +4 -2
  172. package/dist/services/onboarding/browser/extension/extension-bridge.js +5 -3
  173. package/dist/services/onboarding/browser/extension/extension-downloader.js +17 -8
  174. package/dist/services/onboarding/browser/extension/extension-validator.js +9 -4
  175. package/dist/services/onboarding/browser/launch-browser.d.ts +2 -1
  176. package/dist/services/onboarding/browser/launch-browser.js +6 -1
  177. package/dist/services/onboarding/browser/resume-restarted-workers.d.ts +14 -0
  178. package/dist/services/onboarding/browser/resume-restarted-workers.js +26 -0
  179. package/dist/services/onboarding/control/body-inspect.d.ts +24 -0
  180. package/dist/services/onboarding/control/body-inspect.js +106 -0
  181. package/dist/services/onboarding/control/browser-session.d.ts +547 -0
  182. package/dist/services/onboarding/control/browser-session.js +1337 -0
  183. package/dist/services/onboarding/control/config-validation.d.ts +17 -0
  184. package/dist/services/onboarding/control/config-validation.js +46 -0
  185. package/dist/services/onboarding/control/control-protocol.d.ts +1430 -0
  186. package/dist/services/onboarding/control/control-protocol.js +58 -0
  187. package/dist/services/onboarding/control/control-server.d.ts +292 -0
  188. package/dist/services/onboarding/control/control-server.js +1629 -0
  189. package/dist/services/onboarding/control/debug-session.d.ts +219 -0
  190. package/dist/services/onboarding/control/debug-session.js +897 -0
  191. package/dist/services/onboarding/control/fouc.d.ts +23 -0
  192. package/dist/services/onboarding/control/fouc.js +151 -0
  193. package/dist/services/onboarding/control/index.d.ts +4 -0
  194. package/dist/services/onboarding/control/index.js +4 -0
  195. package/dist/services/onboarding/control/navigate-wait.d.ts +33 -0
  196. package/dist/services/onboarding/control/navigate-wait.js +56 -0
  197. package/dist/services/onboarding/control/navwalk.d.ts +65 -0
  198. package/dist/services/onboarding/control/navwalk.js +248 -0
  199. package/dist/services/onboarding/control/preload-registry.d.ts +150 -0
  200. package/dist/services/onboarding/control/preload-registry.js +829 -0
  201. package/dist/services/onboarding/control/response-explainer.d.ts +24 -0
  202. package/dist/services/onboarding/control/response-explainer.js +257 -0
  203. package/dist/services/onboarding/control/rum.d.ts +8 -0
  204. package/dist/services/onboarding/control/rum.js +220 -0
  205. package/dist/services/onboarding/control/service-worker-tracker.d.ts +68 -0
  206. package/dist/services/onboarding/control/service-worker-tracker.js +120 -0
  207. package/dist/services/onboarding/control/viewport.d.ts +45 -0
  208. package/dist/services/onboarding/control/viewport.js +344 -0
  209. package/dist/services/onboarding/control/watch.d.ts +26 -0
  210. package/dist/services/onboarding/control/watch.js +157 -0
  211. package/dist/services/onboarding/dashboard/diff-against-current-page.js +3 -1
  212. package/dist/services/onboarding/dashboard/index.js +7 -2
  213. package/dist/services/onboarding/fetch-event-handler.d.ts +24 -5
  214. package/dist/services/onboarding/fetch-event-handler.js +103 -32
  215. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +11 -2
  216. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +14 -0
  217. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +30 -0
  218. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +13 -0
  219. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +28 -1
  220. package/dist/services/onboarding/file-events/file-watcher.d.ts +42 -1
  221. package/dist/services/onboarding/file-events/file-watcher.js +117 -12
  222. package/dist/services/onboarding/inject/inject-service.js +1 -1
  223. package/dist/services/onboarding/onboarding-model.d.ts +40 -7
  224. package/dist/services/onboarding/onboarding-model.js +20 -9
  225. package/dist/services/onboarding/onboarding-service-build-context.d.ts +4 -0
  226. package/dist/services/onboarding/onboarding-service-build-context.js +7 -1
  227. package/dist/services/onboarding/onboarding-service-factory.d.ts +17 -1
  228. package/dist/services/onboarding/onboarding-service-factory.js +150 -23
  229. package/dist/services/onboarding/onboarding-service.d.ts +40 -1
  230. package/dist/services/onboarding/onboarding-service.js +139 -23
  231. package/dist/services/onboarding/request-cache/asset-key.d.ts +61 -0
  232. package/dist/services/onboarding/request-cache/asset-key.js +115 -0
  233. package/dist/services/onboarding/request-cache/cache.d.ts +62 -5
  234. package/dist/services/onboarding/request-cache/cache.js +128 -17
  235. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.d.ts +1 -0
  236. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.js +66 -0
  237. package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +1 -0
  238. package/dist/services/onboarding/spec/browser/console-log.spec.js +42 -0
  239. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.d.ts +1 -0
  240. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.js +45 -0
  241. package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +1 -0
  242. package/dist/services/onboarding/spec/control/browser-session.spec.js +753 -0
  243. package/dist/services/onboarding/spec/control/control-server.spec.d.ts +1 -0
  244. package/dist/services/onboarding/spec/control/control-server.spec.js +371 -0
  245. package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +1 -0
  246. package/dist/services/onboarding/spec/control/debug-session.spec.js +751 -0
  247. package/dist/services/onboarding/spec/control/fakes.d.ts +31 -0
  248. package/dist/services/onboarding/spec/control/fakes.js +67 -0
  249. package/dist/services/onboarding/spec/control/fouc.spec.d.ts +1 -0
  250. package/dist/services/onboarding/spec/control/fouc.spec.js +167 -0
  251. package/dist/services/onboarding/spec/control/navigate-wait.spec.d.ts +1 -0
  252. package/dist/services/onboarding/spec/control/navigate-wait.spec.js +47 -0
  253. package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +1 -0
  254. package/dist/services/onboarding/spec/control/navwalk.spec.js +222 -0
  255. package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +1 -0
  256. package/dist/services/onboarding/spec/control/preload-registry.spec.js +432 -0
  257. package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +1 -0
  258. package/dist/services/onboarding/spec/control/response-explainer.spec.js +324 -0
  259. package/dist/services/onboarding/spec/control/rum.spec.d.ts +1 -0
  260. package/dist/services/onboarding/spec/control/rum.spec.js +222 -0
  261. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +1 -0
  262. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +193 -0
  263. package/dist/services/onboarding/spec/control/viewport.spec.d.ts +1 -0
  264. package/dist/services/onboarding/spec/control/viewport.spec.js +200 -0
  265. package/dist/services/onboarding/spec/control/watch.spec.d.ts +1 -0
  266. package/dist/services/onboarding/spec/control/watch.spec.js +187 -0
  267. package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +1 -0
  268. package/dist/services/onboarding/spec/fetch-event-handler.spec.js +219 -0
  269. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +1 -0
  270. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +41 -0
  271. package/dist/services/onboarding/spec/onboarding-model.spec.js +39 -3
  272. package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +25 -1
  273. package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +1 -0
  274. package/dist/services/onboarding/spec/request-cache/cache.spec.js +107 -0
  275. package/dist/services/onboarding/spec/todo-collector.spec.d.ts +1 -0
  276. package/dist/services/onboarding/spec/todo-collector.spec.js +136 -0
  277. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.d.ts +1 -0
  278. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.js +65 -0
  279. package/dist/services/onboarding/todo-collector.d.ts +7 -2
  280. package/dist/services/onboarding/todo-collector.js +49 -12
  281. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +38 -0
  282. package/dist/services/onboarding/virtual-orestes-app/index.js +113 -27
  283. package/dist/services/origin-request/asset-variations.d.ts +14 -0
  284. package/dist/services/origin-request/asset-variations.js +11 -4
  285. package/dist/services/origin-request/origin-fetcher.d.ts +7 -0
  286. package/dist/services/origin-request/origin-fetcher.js +43 -5
  287. package/dist/services/origin-request/origin-request-service-build-context.d.ts +17 -0
  288. package/dist/services/origin-request/origin-request-service-build-context.js +8 -0
  289. package/dist/services/origin-request/origin-request-service-factory.d.ts +0 -5
  290. package/dist/services/origin-request/origin-request-service-factory.js +2 -30
  291. package/dist/services/origin-request/origin-request-service.d.ts +121 -6
  292. package/dist/services/origin-request/origin-request-service.js +273 -49
  293. package/dist/services/origin-request/runtime-config-source.d.ts +6 -0
  294. package/dist/services/origin-request/runtime-config-source.js +15 -4
  295. package/dist/services/origin-request/spec/asset-variations.spec.js +20 -0
  296. package/dist/services/origin-request/spec/origin-request-service.spec.js +329 -6
  297. package/dist/services/query-builder/rules/rule-match.d.ts +35 -0
  298. package/dist/services/query-builder/rules/rule-match.js +70 -0
  299. package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +1 -0
  300. package/dist/services/query-builder/spec/rules/rule-match.spec.js +121 -0
  301. package/dist/services/run-control/browser/run-browser-contexts.d.ts +557 -0
  302. package/dist/services/run-control/browser/run-browser-contexts.js +91 -0
  303. package/dist/services/run-control/browser/run-browser-service-factory.d.ts +5 -0
  304. package/dist/services/run-control/browser/run-browser-service-factory.js +7 -0
  305. package/dist/services/run-control/browser/run-browser-service.d.ts +68 -0
  306. package/dist/services/run-control/browser/run-browser-service.js +206 -0
  307. package/dist/services/run-control/cache/run-cache-contexts.d.ts +349 -0
  308. package/dist/services/run-control/cache/run-cache-contexts.js +51 -0
  309. package/dist/services/run-control/cache/run-cache-service-factory.d.ts +6 -0
  310. package/dist/services/run-control/cache/run-cache-service-factory.js +12 -0
  311. package/dist/services/run-control/cache/run-cache-service.d.ts +35 -0
  312. package/dist/services/run-control/cache/run-cache-service.js +151 -0
  313. package/dist/services/run-control/control-client.d.ts +36 -0
  314. package/dist/services/run-control/control-client.js +147 -0
  315. package/dist/services/run-control/debug/run-debug-contexts.d.ts +416 -0
  316. package/dist/services/run-control/debug/run-debug-contexts.js +47 -0
  317. package/dist/services/run-control/debug/run-debug-service-factory.d.ts +5 -0
  318. package/dist/services/run-control/debug/run-debug-service-factory.js +7 -0
  319. package/dist/services/run-control/debug/run-debug-service.d.ts +39 -0
  320. package/dist/services/run-control/debug/run-debug-service.js +164 -0
  321. package/dist/services/run-control/files/run-files-contexts.d.ts +238 -0
  322. package/dist/services/run-control/files/run-files-contexts.js +26 -0
  323. package/dist/services/run-control/files/run-files-service-factory.d.ts +5 -0
  324. package/dist/services/run-control/files/run-files-service-factory.js +7 -0
  325. package/dist/services/run-control/files/run-files-service.d.ts +29 -0
  326. package/dist/services/run-control/files/run-files-service.js +120 -0
  327. package/dist/services/run-control/index.d.ts +32 -0
  328. package/dist/services/run-control/index.js +31 -0
  329. package/dist/services/run-control/inject/run-inject-contexts.d.ts +319 -0
  330. package/dist/services/run-control/inject/run-inject-contexts.js +38 -0
  331. package/dist/services/run-control/inject/run-inject-service-factory.d.ts +5 -0
  332. package/dist/services/run-control/inject/run-inject-service-factory.js +7 -0
  333. package/dist/services/run-control/inject/run-inject-service.d.ts +31 -0
  334. package/dist/services/run-control/inject/run-inject-service.js +227 -0
  335. package/dist/services/run-control/live-run.d.ts +37 -0
  336. package/dist/services/run-control/live-run.js +56 -0
  337. package/dist/services/run-control/probe/run-probe-contexts.d.ts +333 -0
  338. package/dist/services/run-control/probe/run-probe-contexts.js +73 -0
  339. package/dist/services/run-control/probe/run-probe-service-factory.d.ts +5 -0
  340. package/dist/services/run-control/probe/run-probe-service-factory.js +7 -0
  341. package/dist/services/run-control/probe/run-probe-service.d.ts +54 -0
  342. package/dist/services/run-control/probe/run-probe-service.js +194 -0
  343. package/dist/services/run-control/rum/run-rum-contexts.d.ts +216 -0
  344. package/dist/services/run-control/rum/run-rum-contexts.js +34 -0
  345. package/dist/services/run-control/rum/run-rum-service-factory.d.ts +5 -0
  346. package/dist/services/run-control/rum/run-rum-service-factory.js +7 -0
  347. package/dist/services/run-control/rum/run-rum-service.d.ts +36 -0
  348. package/dist/services/run-control/rum/run-rum-service.js +122 -0
  349. package/dist/services/run-control/run-answer.d.ts +28 -0
  350. package/dist/services/run-control/run-answer.js +58 -0
  351. package/dist/services/run-control/run-control-context.d.ts +102 -0
  352. package/dist/services/run-control/run-control-context.js +36 -0
  353. package/dist/services/run-control/run-control-flags.d.ts +12 -0
  354. package/dist/services/run-control/run-control-flags.js +22 -0
  355. package/dist/services/run-control/run-control-model.d.ts +9 -0
  356. package/dist/services/run-control/run-control-model.js +1 -0
  357. package/dist/services/run-control/run-control-service-factory.d.ts +14 -0
  358. package/dist/services/run-control/run-control-service-factory.js +26 -0
  359. package/dist/services/run-control/session/run-session-contexts.d.ts +25 -0
  360. package/dist/services/run-control/session/run-session-contexts.js +20 -0
  361. package/dist/services/run-control/session/run-session-service-factory.d.ts +8 -0
  362. package/dist/services/run-control/session/run-session-service-factory.js +18 -0
  363. package/dist/services/run-control/session/run-session-service.d.ts +32 -0
  364. package/dist/services/run-control/session/run-session-service.js +151 -0
  365. package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +1 -0
  366. package/dist/services/run-control/spec/browser/run-browser-service.spec.js +328 -0
  367. package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +1 -0
  368. package/dist/services/run-control/spec/cache/run-cache-service.spec.js +454 -0
  369. package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +1 -0
  370. package/dist/services/run-control/spec/debug/run-debug-service.spec.js +113 -0
  371. package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +1 -0
  372. package/dist/services/run-control/spec/files/run-files-service.spec.js +234 -0
  373. package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +1 -0
  374. package/dist/services/run-control/spec/inject/run-inject-service.spec.js +251 -0
  375. package/dist/services/run-control/spec/live-run-fixture.d.ts +32 -0
  376. package/dist/services/run-control/spec/live-run-fixture.js +109 -0
  377. package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +1 -0
  378. package/dist/services/run-control/spec/probe/run-probe-service.spec.js +108 -0
  379. package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +1 -0
  380. package/dist/services/run-control/spec/rum/run-rum-service.spec.js +47 -0
  381. package/dist/services/run-control/spec/run-answer.spec.d.ts +1 -0
  382. package/dist/services/run-control/spec/run-answer.spec.js +57 -0
  383. package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +1 -0
  384. package/dist/services/run-control/spec/session/run-session-service.spec.js +150 -0
  385. package/dist/services/run-log/crash-mirror.d.ts +31 -0
  386. package/dist/services/run-log/crash-mirror.js +69 -0
  387. package/dist/services/run-log/index.d.ts +11 -0
  388. package/dist/services/run-log/index.js +11 -0
  389. package/dist/services/run-log/jsonl-appender.d.ts +46 -0
  390. package/dist/services/run-log/jsonl-appender.js +91 -0
  391. package/dist/services/run-log/log-event-model.d.ts +104 -0
  392. package/dist/services/run-log/log-event-model.js +56 -0
  393. package/dist/services/run-log/log-query-service-factory.d.ts +11 -0
  394. package/dist/services/run-log/log-query-service-factory.js +14 -0
  395. package/dist/services/run-log/log-query-service.d.ts +59 -0
  396. package/dist/services/run-log/log-query-service.js +111 -0
  397. package/dist/services/run-log/log-reader.d.ts +84 -0
  398. package/dist/services/run-log/log-reader.js +180 -0
  399. package/dist/services/run-log/log-summary.d.ts +72 -0
  400. package/dist/services/run-log/log-summary.js +208 -0
  401. package/dist/services/run-log/redaction.d.ts +34 -0
  402. package/dist/services/run-log/redaction.js +124 -0
  403. package/dist/services/run-log/request-log.d.ts +82 -0
  404. package/dist/services/run-log/request-log.js +69 -0
  405. package/dist/services/run-log/request-summary.d.ts +76 -0
  406. package/dist/services/run-log/request-summary.js +0 -0
  407. package/dist/services/run-log/run-log.d.ts +61 -0
  408. package/dist/services/run-log/run-log.js +102 -0
  409. package/dist/services/run-log/spec/log-query-service.spec.d.ts +1 -0
  410. package/dist/services/run-log/spec/log-query-service.spec.js +197 -0
  411. package/dist/services/run-log/spec/log-reader.spec.d.ts +1 -0
  412. package/dist/services/run-log/spec/log-reader.spec.js +109 -0
  413. package/dist/services/run-log/spec/log-summary.spec.d.ts +1 -0
  414. package/dist/services/run-log/spec/log-summary.spec.js +153 -0
  415. package/dist/services/run-log/spec/redaction.spec.d.ts +1 -0
  416. package/dist/services/run-log/spec/redaction.spec.js +61 -0
  417. package/dist/services/run-log/spec/request-log.spec.d.ts +1 -0
  418. package/dist/services/run-log/spec/request-log.spec.js +101 -0
  419. package/dist/services/run-log/spec/request-summary.spec.d.ts +1 -0
  420. package/dist/services/run-log/spec/request-summary.spec.js +171 -0
  421. package/dist/services/run-log/spec/run-log.spec.d.ts +1 -0
  422. package/dist/services/run-log/spec/run-log.spec.js +122 -0
  423. package/dist/services/run-registry/exit-classification.d.ts +39 -0
  424. package/dist/services/run-registry/exit-classification.js +42 -0
  425. package/dist/services/run-registry/index.d.ts +3 -0
  426. package/dist/services/run-registry/index.js +3 -0
  427. package/dist/services/run-registry/process-identity.d.ts +28 -0
  428. package/dist/services/run-registry/process-identity.js +80 -0
  429. package/dist/services/run-registry/run-registry-model.d.ts +128 -0
  430. package/dist/services/run-registry/run-registry-model.js +16 -0
  431. package/dist/services/run-registry/run-registry.d.ts +155 -0
  432. package/dist/services/run-registry/run-registry.js +430 -0
  433. package/dist/services/run-registry/spec/exit-classification.spec.d.ts +1 -0
  434. package/dist/services/run-registry/spec/exit-classification.spec.js +82 -0
  435. package/dist/services/run-registry/spec/run-registry.spec.d.ts +1 -0
  436. package/dist/services/run-registry/spec/run-registry.spec.js +526 -0
  437. package/dist/services/setup/os/tool-registry.js +2 -2
  438. package/oclif.manifest.json +3493 -372
  439. package/package.json +20 -2
@@ -0,0 +1,193 @@
1
+ import { expect } from "chai";
2
+ import { describe, it } from "mocha";
3
+ import { ServiceWorkerTracker } from "../../control/service-worker-tracker.js";
4
+ function version(versionId, extra = {}) {
5
+ return {
6
+ versionId,
7
+ registrationId: "r1",
8
+ scriptURL: "https://shop.example.com/sw.js",
9
+ runningStatus: "running",
10
+ status: "activated",
11
+ ...extra,
12
+ };
13
+ }
14
+ function registration(registrationId, extra = {}) {
15
+ return {
16
+ registrationId,
17
+ scopeURL: "https://shop.example.com/",
18
+ isDeleted: false,
19
+ ...extra,
20
+ };
21
+ }
22
+ /** The page the run is on, for every test that expects an active worker. */
23
+ const PAGE = "https://shop.example.com/";
24
+ /** A registration covering {@link PAGE}, which `version()` belongs to. */
25
+ const ROOT = registration("r1");
26
+ describe("ServiceWorkerTracker", () => {
27
+ it("should answer nothing before any event has arrived", () => {
28
+ const state = new ServiceWorkerTracker().state();
29
+ expect(state.registrations).to.deep.equal([]);
30
+ expect(state.versions).to.deep.equal([]);
31
+ expect(state.activeVersionId).to.equal(undefined);
32
+ expect(state.foreign).to.equal(false);
33
+ });
34
+ it("should name the activated version, not merely list them", () => {
35
+ const tracker = new ServiceWorkerTracker();
36
+ tracker.recordRegistrations([ROOT]);
37
+ tracker.recordVersions([
38
+ version("1", { status: "redundant" }),
39
+ version("2", { status: "activated" }),
40
+ version("3", { status: "installing" }),
41
+ ]);
42
+ expect(tracker.state(PAGE).activeVersionId).to.equal("2");
43
+ });
44
+ it("should keep the latest word on a version rather than a second copy", () => {
45
+ // CDP re-sends a version on every runningStatus change, so an appending
46
+ // tracker would report the same worker three times in three states.
47
+ const tracker = new ServiceWorkerTracker();
48
+ tracker.recordVersions([version("1", { status: "installing" })]);
49
+ tracker.recordVersions([version("1", { status: "activating" })]);
50
+ tracker.recordVersions([version("1", { status: "activated" })]);
51
+ expect(tracker.state().versions).to.have.lengthOf(1);
52
+ expect(tracker.state().versions[0].status).to.equal("activated");
53
+ });
54
+ it("should remember a registration that was deleted, rather than forgetting it", () => {
55
+ // "There was one here and it is gone" is the answer to a live question. A
56
+ // worker that unregisters itself mid-session would otherwise look exactly
57
+ // like one that never existed. This is also what a `reset` with scope
58
+ // `all` produces — Chrome emits a deletion rather than going quiet — which
59
+ // is why the reset does not clear the tracker itself.
60
+ const tracker = new ServiceWorkerTracker();
61
+ tracker.recordRegistrations([registration("r1")]);
62
+ tracker.recordRegistrations([registration("r1", { isDeleted: true })]);
63
+ expect(tracker.state().registrations).to.deep.equal([
64
+ {
65
+ registrationId: "r1",
66
+ scopeURL: "https://shop.example.com/",
67
+ deleted: true,
68
+ },
69
+ ]);
70
+ });
71
+ it("should report a takeover on the version it happened to", () => {
72
+ const tracker = new ServiceWorkerTracker();
73
+ tracker.recordRegistrations([ROOT]);
74
+ tracker.recordVersions([version("7")]);
75
+ tracker.recordTakeover("7");
76
+ const state = tracker.state(PAGE);
77
+ expect(state.foreign).to.equal(true);
78
+ expect(state.takeovers).to.equal(1);
79
+ expect(state.lastTakeoverAt).to.be.a("string");
80
+ expect(state.versions[0].foreign).to.equal(true);
81
+ });
82
+ it("should not call the session foreign when the takeover was superseded", () => {
83
+ // The repair installs a new version. The count stays — it explains any
84
+ // measurement taken before it — but the active worker is ours again, and
85
+ // that is what `foreign` answers.
86
+ const tracker = new ServiceWorkerTracker();
87
+ tracker.recordRegistrations([ROOT]);
88
+ tracker.recordVersions([version("7")]);
89
+ tracker.recordTakeover("7");
90
+ tracker.recordVersions([
91
+ version("7", { status: "redundant" }),
92
+ version("8", { status: "activated" }),
93
+ ]);
94
+ const state = tracker.state(PAGE);
95
+ expect(state.foreign).to.equal(false);
96
+ expect(state.activeVersionId).to.equal("8");
97
+ // Still on the record, because it dates the measurements it invalidated.
98
+ expect(state.takeovers).to.equal(1);
99
+ expect(state.lastTakeoverAt).to.be.a("string");
100
+ });
101
+ it("should count every takeover, not just the last", () => {
102
+ const tracker = new ServiceWorkerTracker();
103
+ tracker.recordVersions([version("1"), version("2")]);
104
+ tracker.recordTakeover("1");
105
+ tracker.recordTakeover("2");
106
+ expect(tracker.state().takeovers).to.equal(2);
107
+ });
108
+ it("should pick the worker whose scope covers the page, not the first one listed", () => {
109
+ // The bug this replaces: `versions.find(v => v.status === "activated")`
110
+ // took the first activated version in insertion order, across every
111
+ // registration. A shop that scopes workers to `/basket`, `/checkout` and
112
+ // the root registers several, and the first is never the page's own — on
113
+ // atida the answer was the customer's empty wrapper-sw on `/basket`,
114
+ // through two reinstalls that each replaced the worker actually serving
115
+ // the page.
116
+ const tracker = new ServiceWorkerTracker();
117
+ tracker.recordRegistrations([
118
+ registration("basket", { scopeURL: "https://shop.example.com/basket" }),
119
+ ROOT,
120
+ ]);
121
+ tracker.recordVersions([
122
+ version("1", { registrationId: "basket" }),
123
+ version("9", { registrationId: "r1" }),
124
+ ]);
125
+ expect(tracker.state(PAGE).activeVersionId).to.equal("9");
126
+ });
127
+ it("should let the narrowest matching scope win", () => {
128
+ // Both registrations cover the url; the browser hands the page to the one
129
+ // with the longest matching scope, and so must this.
130
+ const tracker = new ServiceWorkerTracker();
131
+ tracker.recordRegistrations([
132
+ ROOT,
133
+ registration("basket", { scopeURL: "https://shop.example.com/basket" }),
134
+ ]);
135
+ tracker.recordVersions([
136
+ version("9", { registrationId: "r1" }),
137
+ version("1", { registrationId: "basket" }),
138
+ ]);
139
+ expect(tracker.state("https://shop.example.com/basket/checkout").activeVersionId).to.equal("1");
140
+ });
141
+ it("should see a takeover on the page's own worker, not on a bystander", () => {
142
+ // The failure that mattered. `foreign` is read off the active version, so
143
+ // choosing the wrong one left it `false` while the deployed build was in
144
+ // charge — and `foreign` is the single thing this tracker exists to
145
+ // report. The count still moved, which is the only reason it was visible.
146
+ const tracker = new ServiceWorkerTracker();
147
+ tracker.recordRegistrations([
148
+ registration("basket", { scopeURL: "https://shop.example.com/basket" }),
149
+ ROOT,
150
+ ]);
151
+ tracker.recordVersions([
152
+ version("1", { registrationId: "basket" }),
153
+ version("9", { registrationId: "r1" }),
154
+ ]);
155
+ tracker.recordTakeover("9");
156
+ expect(tracker.state(PAGE).foreign).to.equal(true);
157
+ });
158
+ it("should answer no active version while the new one is still activating", () => {
159
+ // Mid-reinstall there is no activated worker for the scope. Falling back
160
+ // to any activated version would put the original bug back, quietly.
161
+ const tracker = new ServiceWorkerTracker();
162
+ tracker.recordRegistrations([
163
+ registration("basket", { scopeURL: "https://shop.example.com/basket" }),
164
+ ROOT,
165
+ ]);
166
+ tracker.recordVersions([
167
+ version("1", { registrationId: "basket" }),
168
+ version("9", { registrationId: "r1", status: "activating" }),
169
+ ]);
170
+ expect(tracker.state(PAGE).activeVersionId).to.equal(undefined);
171
+ });
172
+ it("should not be answered by a registration that was deleted", () => {
173
+ const tracker = new ServiceWorkerTracker();
174
+ tracker.recordRegistrations([registration("r1", { isDeleted: true })]);
175
+ tracker.recordVersions([version("9", { registrationId: "r1" })]);
176
+ expect(tracker.state(PAGE).activeVersionId).to.equal(undefined);
177
+ });
178
+ it("should ignore a worker on another origin, such as an extension's", () => {
179
+ // Chrome reports the devtools extension's own service worker in the same
180
+ // stream. Its scope does not cover the page, so it can never be the answer.
181
+ const tracker = new ServiceWorkerTracker();
182
+ tracker.recordRegistrations([
183
+ registration("ext", { scopeURL: "chrome-extension://abc/" }),
184
+ ]);
185
+ tracker.recordVersions([
186
+ version("0", {
187
+ registrationId: "ext",
188
+ scriptURL: "chrome-extension://abc/background.js",
189
+ }),
190
+ ]);
191
+ expect(tracker.state(PAGE).activeVersionId).to.equal(undefined);
192
+ });
193
+ });
@@ -0,0 +1,200 @@
1
+ import { expect } from "chai";
2
+ import { describe, it } from "mocha";
3
+ import { BadRangeError, runViewportSweep, } from "../../control/viewport.js";
4
+ /**
5
+ * A page that re-renders at given widths, and nothing else.
6
+ *
7
+ * The point of the fake is that it mutates on *crossing* a threshold rather
8
+ * than while below one — which is what a real frontend does, and what the
9
+ * sweep's pin and confirmation both depend on.
10
+ */
11
+ class FakePage {
12
+ thresholds;
13
+ noise;
14
+ bootDiffers;
15
+ fluid;
16
+ resizes = [];
17
+ reloads = 0;
18
+ /** Keys queued by a crossing, drained by the next `drain`. */
19
+ pending = [];
20
+ width = null;
21
+ cleared = false;
22
+ constructor(thresholds = [],
23
+ /** Emitted on every drain, whatever the width — a carousel. */
24
+ noise = [],
25
+ /** Whether a fresh load at a wide width renders differently. */
26
+ bootDiffers = false,
27
+ /** Emitted on every resize, whatever the width — a fluid layout. */
28
+ fluid = []) {
29
+ this.thresholds = thresholds;
30
+ this.noise = noise;
31
+ this.bootDiffers = bootDiffers;
32
+ this.fluid = fluid;
33
+ }
34
+ async evaluate(expression) {
35
+ if (expression.includes("MutationObserver")) {
36
+ return true;
37
+ }
38
+ if (expression.includes("state.keys = []")) {
39
+ const keys = [...this.pending, ...this.noise];
40
+ this.pending = [];
41
+ return JSON.stringify(keys);
42
+ }
43
+ // The boot signature.
44
+ return (this.bootDiffers && (this.width ?? 0) > 800 ? "wide-dom" : "narrow-dom");
45
+ }
46
+ async resize(width) {
47
+ this.resizes.push(width);
48
+ const previous = this.width;
49
+ this.width = width;
50
+ this.cleared = false;
51
+ if (previous === null) {
52
+ return;
53
+ }
54
+ this.pending.push(...this.fluid);
55
+ this.thresholds.forEach((threshold, index) => {
56
+ if (previous < threshold !== width < threshold) {
57
+ // One element per threshold after the first, as on a real page: a
58
+ // header that swapped its class at fourteen widths would be following
59
+ // the width, not crossing breakpoints.
60
+ this.pending.push(`header.nav${index === 0 ? "" : index}:attributes[class]`);
61
+ }
62
+ });
63
+ }
64
+ async clearResize() {
65
+ this.cleared = true;
66
+ }
67
+ async reload() {
68
+ this.reloads += 1;
69
+ }
70
+ get wasCleared() {
71
+ return this.cleared;
72
+ }
73
+ }
74
+ /** Small range and settle, so the sweep is a test rather than a wait. */
75
+ const fast = { min: 700, max: 800, step: 20, settleMs: 50 };
76
+ describe("runViewportSweep", () => {
77
+ it("should pin a breakpoint to the exact pixel and confirm it reverses", async function () {
78
+ this.timeout(20_000);
79
+ const page = new FakePage([768]);
80
+ const result = await runViewportSweep(page, fast);
81
+ expect(result.breakpoints).to.have.length(1);
82
+ expect(result.breakpoints[0].width).to.equal(768);
83
+ expect(result.breakpoints[0].confirmed).to.equal(true);
84
+ expect(result.verdict).to.contain("768px");
85
+ });
86
+ it("should not report a carousel as a layout breakpoint", async function () {
87
+ // Anything that fires while the page is standing still is noise, learned
88
+ // before the sweep. Without that every page with a rotating banner reports
89
+ // a breakpoint at every width.
90
+ this.timeout(20_000);
91
+ const page = new FakePage([], ["div.slider:childList"]);
92
+ const result = await runViewportSweep(page, fast);
93
+ expect(result.breakpoints).to.deep.equal([]);
94
+ expect(result.noise).to.contain("div.slider:childList");
95
+ });
96
+ it("should call a CSS-only page CSS-only", async function () {
97
+ // The same DOM at every width and the same when loaded at either end: the
98
+ // CSS re-applies on the client over whatever snapshot was served, so one
99
+ // snapshot serves every device.
100
+ this.timeout(20_000);
101
+ const page = new FakePage([]);
102
+ const result = await runViewportSweep(page, fast);
103
+ expect(result.bootOnlyBranching).to.equal(false);
104
+ expect(result.verdict).to.contain("CSS-only responsiveness");
105
+ });
106
+ it("should catch a frontend that branches once at mount", async function () {
107
+ // It shows nothing at all to a resize sweep, so a clean sweep is not yet
108
+ // an answer — two loads and a DOM comparison are.
109
+ this.timeout(20_000);
110
+ const page = new FakePage([], [], true);
111
+ const result = await runViewportSweep(page, {
112
+ ...fast,
113
+ min: 400,
114
+ max: 1200,
115
+ step: 200,
116
+ });
117
+ expect(result.breakpoints).to.deep.equal([]);
118
+ expect(result.bootOnlyBranching).to.equal(true);
119
+ expect(page.reloads).to.equal(2);
120
+ expect(result.verdict).to.contain("branches once at mount");
121
+ });
122
+ it("should not take the load comparison when the sweep already answered", async function () {
123
+ this.timeout(20_000);
124
+ const page = new FakePage([768]);
125
+ const result = await runViewportSweep(page, fast);
126
+ expect(result.bootOnlyBranching).to.equal(null);
127
+ expect(page.reloads).to.equal(0);
128
+ });
129
+ it("should put the viewport back, including when it fails", async function () {
130
+ this.timeout(20_000);
131
+ const page = new FakePage([768]);
132
+ page.evaluate = async () => {
133
+ throw new Error("page went away");
134
+ };
135
+ await runViewportSweep(page, fast).catch(() => undefined);
136
+ // A sweep that threw halfway and left the window at 360px would look like
137
+ // a bug in everything looked at afterwards.
138
+ expect(page.wasCleared).to.equal(true);
139
+ });
140
+ it("should refuse a range narrower than one step", async () => {
141
+ const page = new FakePage();
142
+ const error = await runViewportSweep(page, {
143
+ min: 700,
144
+ max: 710,
145
+ step: 20,
146
+ }).catch((thrown) => thrown);
147
+ expect(error).to.be.instanceOf(BadRangeError);
148
+ });
149
+ it("should label a change it recognises, without hiding the evidence", async function () {
150
+ this.timeout(20_000);
151
+ const page = new FakePage([768]);
152
+ const result = await runViewportSweep(page, fast);
153
+ expect(result.breakpoints[0].hint).to.equal("navigation");
154
+ expect(result.breakpoints[0].changed).to.contain("header.nav:attributes[class]");
155
+ });
156
+ describe("on a fluid layout", () => {
157
+ // LiveStory and swiper rewrite inline style on every resize, and a slider
158
+ // recomputes its active slide's class. The sweep used to report every
159
+ // coarse step plus one pixel, and the one class swap that mattered did not
160
+ // stand out.
161
+ const wide = { min: 360, max: 1000, step: 40, settleMs: 20 };
162
+ it("should not count inline style as a breakpoint", async function () {
163
+ this.timeout(15000);
164
+ const page = new FakePage([600], [], false, [
165
+ "div.swiper-wrapper:attributes[style]",
166
+ ]);
167
+ const result = await runViewportSweep(page, wide);
168
+ expect(result.breakpoints.map((one) => one.width)).to.deep.equal([600]);
169
+ expect(result.breakpoints[0].confirmed).to.equal(true);
170
+ expect(result.styleOnlySteps).to.equal(result.steps - 1);
171
+ expect(result.verdict).to.contain("fluid layout");
172
+ });
173
+ it("should set aside a class that follows the width", async function () {
174
+ this.timeout(15000);
175
+ const page = new FakePage([600], [], false, [
176
+ "div.swiper-slide:attributes[class]",
177
+ ]);
178
+ const result = await runViewportSweep(page, wide);
179
+ expect(result.breakpoints.map((one) => one.width)).to.deep.equal([600]);
180
+ expect(result.fluid).to.deep.equal([
181
+ "div.swiper-slide:attributes[class]",
182
+ ]);
183
+ });
184
+ });
185
+ it("should say which intervals it did not pin", async function () {
186
+ this.timeout(30000);
187
+ // Fourteen thresholds, so two are past the pin limit.
188
+ const thresholds = Array.from({ length: 14 }, (_, index) => 410 + index * 40);
189
+ const page = new FakePage(thresholds);
190
+ const result = await runViewportSweep(page, {
191
+ min: 400,
192
+ max: 1000,
193
+ step: 40,
194
+ settleMs: 10,
195
+ });
196
+ expect(result.breakpoints).to.have.lengthOf(12);
197
+ expect(result.unpinned).to.have.lengthOf(2);
198
+ expect(result.verdict).to.contain("not pinned");
199
+ });
200
+ });
@@ -0,0 +1,187 @@
1
+ import { expect } from "chai";
2
+ import { describe, it } from "mocha";
3
+ import { createContext, runInContext } from "node:vm";
4
+ import { PreloadRegistry, } from "../../control/preload-registry.js";
5
+ import { runWatch } from "../../control/watch.js";
6
+ class FakeTransport {
7
+ pageAvailable = true;
8
+ added = [];
9
+ page = null;
10
+ counter = 0;
11
+ async addScript(source) {
12
+ this.added.push(source);
13
+ this.counter += 1;
14
+ return `cdp-${this.counter}`;
15
+ }
16
+ async removeScript() {
17
+ return undefined;
18
+ }
19
+ async evaluate(expression) {
20
+ if (expression.startsWith("JSON.stringify(window.__sk_inject")) {
21
+ return (this.page ? JSON.stringify(this.page) : null);
22
+ }
23
+ return undefined;
24
+ }
25
+ }
26
+ /** What the page would have buffered, in the shape the script writes. */
27
+ function slot(records, dropped = 0) {
28
+ return {
29
+ watch: {
30
+ records: records.map((v, index) => ({ t: index * 10, v })),
31
+ dropped,
32
+ disabled: false,
33
+ },
34
+ };
35
+ }
36
+ function sample(value) {
37
+ return { k: "sample", v: value };
38
+ }
39
+ describe("runWatch", () => {
40
+ const options = {
41
+ expression: "!!window.SpeedKit",
42
+ durationMs: 20,
43
+ intervalMs: 20,
44
+ };
45
+ it("should collapse a timeline to the ticks where it changed", async () => {
46
+ // A 15-second watch at 200ms is 75 samples of which two matter. The first
47
+ // is always kept: "what it started as" is half of what a transition means.
48
+ const transport = new FakeTransport();
49
+ const preloads = new PreloadRegistry(transport);
50
+ transport.page = slot([
51
+ sample(false),
52
+ sample(false),
53
+ sample(false),
54
+ sample(true),
55
+ sample(true),
56
+ ]);
57
+ const result = await runWatch(preloads, async () => undefined, options);
58
+ expect(result.samples.map((one) => one.v)).to.deep.equal([false, true]);
59
+ expect(result.totalSamples).to.equal(5);
60
+ expect(result.mode).to.equal("transitions");
61
+ });
62
+ it("should say when it raised a too-short interval", async () => {
63
+ const transport = new FakeTransport();
64
+ const preloads = new PreloadRegistry(transport);
65
+ transport.page = slot([sample(1)]);
66
+ const raised = await runWatch(preloads, async () => undefined, {
67
+ ...options,
68
+ intervalMs: 10,
69
+ });
70
+ const kept = await runWatch(preloads, async () => undefined, options);
71
+ expect(raised.intervalMs).to.equal(20);
72
+ expect(raised.notes).to.deep.equal([
73
+ "interval 10ms raised to 20ms, the shortest the sampler takes",
74
+ ]);
75
+ expect(kept.notes).to.deep.equal([]);
76
+ });
77
+ it("should hand back every tick when asked", async () => {
78
+ const transport = new FakeTransport();
79
+ const preloads = new PreloadRegistry(transport);
80
+ transport.page = slot([sample(1), sample(1), sample(2)]);
81
+ const result = await runWatch(preloads, async () => undefined, {
82
+ ...options,
83
+ full: true,
84
+ });
85
+ expect(result.samples).to.have.length(3);
86
+ expect(result.mode).to.equal("full");
87
+ });
88
+ it("should sort console and exceptions out of the same buffer", async () => {
89
+ // One buffer and one clock is what makes "the value flipped, and here is
90
+ // the exception thrown half a tick earlier" readable at all.
91
+ const transport = new FakeTransport();
92
+ const preloads = new PreloadRegistry(transport);
93
+ transport.page = slot([
94
+ sample(false),
95
+ { k: "console", level: "warn", text: "sw booting" },
96
+ { k: "exception", text: "x is not defined" },
97
+ sample(true),
98
+ ]);
99
+ const result = await runWatch(preloads, async () => undefined, options);
100
+ expect(result.console).to.deep.equal([
101
+ { t: 10, level: "warn", text: "sw booting" },
102
+ ]);
103
+ expect(result.exceptions).to.deep.equal([
104
+ { t: 20, level: "error", text: "x is not defined" },
105
+ ]);
106
+ expect(result.samples.map((one) => one.v)).to.deep.equal([false, true]);
107
+ });
108
+ it("should report a sample that threw without losing the timeline", async () => {
109
+ const transport = new FakeTransport();
110
+ const preloads = new PreloadRegistry(transport);
111
+ transport.page = slot([
112
+ { k: "sample", error: "SpeedKit is not defined" },
113
+ sample(true),
114
+ ]);
115
+ const result = await runWatch(preloads, async () => undefined, options);
116
+ expect(result.samples[0].error).to.equal("SpeedKit is not defined");
117
+ expect(result.samples[1].v).to.equal(true);
118
+ });
119
+ it("should reload only when asked, and say which it did", async () => {
120
+ const transport = new FakeTransport();
121
+ const preloads = new PreloadRegistry(transport);
122
+ transport.page = slot([sample(1)]);
123
+ let reloads = 0;
124
+ const without = await runWatch(preloads, async () => {
125
+ reloads += 1;
126
+ }, options);
127
+ const with_ = await runWatch(preloads, async () => {
128
+ reloads += 1;
129
+ }, { ...options, reload: true });
130
+ expect(reloads).to.equal(1);
131
+ expect(without.reloaded).to.equal(false);
132
+ expect(with_.reloaded).to.equal(true);
133
+ });
134
+ it("should not leave the sampler running afterwards", async () => {
135
+ // A watch left behind is a timer firing in the customer's page for as long
136
+ // as the run lives.
137
+ const transport = new FakeTransport();
138
+ const preloads = new PreloadRegistry(transport);
139
+ transport.page = slot([sample(1)]);
140
+ await runWatch(preloads, async () => undefined, options);
141
+ expect((await preloads.list()).preloads).to.have.length(0);
142
+ });
143
+ it("should release the sampler even when the drain fails", async () => {
144
+ const transport = new FakeTransport();
145
+ const preloads = new PreloadRegistry(transport);
146
+ transport.page = slot([sample(1)]);
147
+ const broken = new Error("socket went");
148
+ preloads.read = async () => {
149
+ throw broken;
150
+ };
151
+ const thrown = await runWatch(preloads, async () => undefined, options).catch((error) => error);
152
+ expect(thrown).to.equal(broken);
153
+ expect((await preloads.list()).preloads).to.have.length(0);
154
+ });
155
+ it("should report what the page buffer dropped", async () => {
156
+ const transport = new FakeTransport();
157
+ const preloads = new PreloadRegistry(transport);
158
+ transport.page = slot([sample(1)], 12);
159
+ const result = await runWatch(preloads, async () => undefined, options);
160
+ expect(result.dropped).to.equal(12);
161
+ });
162
+ it("should produce a script that parses and takes its first sample at once", async () => {
163
+ // Running it is what proves it: nothing in this repo compiles these
164
+ // strings, so a syntax error would otherwise reach a real page.
165
+ const transport = new FakeTransport();
166
+ const preloads = new PreloadRegistry(transport);
167
+ await runWatch(preloads, async () => undefined, {
168
+ ...options,
169
+ expression: "window.marker",
170
+ });
171
+ const window = { marker: "seen" };
172
+ const context = createContext({
173
+ window,
174
+ console: { log: () => undefined },
175
+ performance: { now: () => 0 },
176
+ setInterval: () => 0,
177
+ clearInterval: () => undefined,
178
+ setTimeout: () => 0,
179
+ });
180
+ runInContext(transport.added[0], context);
181
+ const slots = window.__sk_inject;
182
+ expect(slots.watch.records[0].v).to.deep.equal({
183
+ k: "sample",
184
+ v: "seen",
185
+ });
186
+ });
187
+ });