@speedkit/cli 4.51.0-run-control.4 → 4.51.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 (485) hide show
  1. package/CHANGELOG.md +30 -0
  2. package/README.md +14 -1426
  3. package/dist/commands/diff.d.ts +1 -7
  4. package/dist/commands/diff.js +3 -9
  5. package/dist/commands/login.d.ts +0 -3
  6. package/dist/commands/login.js +3 -14
  7. package/dist/commands/onboarding.d.ts +0 -26
  8. package/dist/commands/onboarding.js +4 -221
  9. package/dist/commands/origin-request.d.ts +0 -4
  10. package/dist/commands/origin-request.js +0 -4
  11. package/dist/services/browser-fetch/device-emulation.d.ts +0 -11
  12. package/dist/services/browser-fetch/device-emulation.js +0 -14
  13. package/dist/services/bundler/bundle-service-factory.d.ts +3 -0
  14. package/dist/services/bundler/bundle-service-factory.js +5 -1
  15. package/dist/services/bundler/bundle-service.d.ts +10 -1
  16. package/dist/services/bundler/bundle-service.js +16 -1
  17. package/dist/services/bundler/error/packjockel-error.d.ts +3 -0
  18. package/dist/services/bundler/error/packjockel-error.js +3 -0
  19. package/dist/services/bundler/index.d.ts +1 -0
  20. package/dist/services/bundler/index.js +1 -0
  21. package/dist/services/bundler/packjockel-service.d.ts +112 -0
  22. package/dist/services/bundler/packjockel-service.js +202 -0
  23. package/dist/services/bundler/spec/packjockel-service.spec.js +186 -0
  24. package/dist/services/cli/cli-environment-factory.d.ts +0 -3
  25. package/dist/services/cli/cli-environment-factory.js +0 -1
  26. package/dist/services/cli/cli-service-build-context.d.ts +0 -3
  27. package/dist/services/cli/cli-service-factory.js +1 -1
  28. package/dist/services/cli/cli-service-model.d.ts +10 -29
  29. package/dist/services/cli/cli-service.d.ts +11 -60
  30. package/dist/services/cli/cli-service.js +32 -196
  31. package/dist/services/cli/index.d.ts +0 -2
  32. package/dist/services/cli/index.js +0 -2
  33. package/dist/services/cli/spec/cli-service.spec.js +50 -113
  34. package/dist/services/deploy/checks/activation/customer-approval-check.js +1 -1
  35. package/dist/services/deploy/checks/pre-deploy/device-detection-changed-check.js +2 -3
  36. package/dist/services/deploy/checks/pre-deploy/split-change-check.js +2 -3
  37. package/dist/services/deploy/handler/customer-config-handler.d.ts +9 -0
  38. package/dist/services/deploy/handler/customer-config-handler.js +41 -6
  39. package/dist/services/deploy/interface/install.d.ts +7 -1
  40. package/dist/services/deploy/mr/live-state-check.js +21 -2
  41. package/dist/services/deploy/policy/auto-deploy-policy.js +2 -0
  42. package/dist/services/deploy/policy/deploy-policy-model.d.ts +4 -0
  43. package/dist/services/deploy/policy/deploy-policy-model.js +4 -0
  44. package/dist/services/deploy/policy/testing-deploy-policy.js +2 -0
  45. package/dist/services/deploy/spec/handler/customer-config-handler.spec.js +98 -0
  46. package/dist/services/deploy/spec/mr/live-state-check.spec.js +45 -4
  47. package/dist/services/deploy/spec/policy/auto-deploy-policy.spec.js +2 -0
  48. package/dist/services/deploy/spec/policy/testing-deploy-policy.spec.js +3 -1
  49. package/dist/services/diff/diff-service-build-context.d.ts +0 -12
  50. package/dist/services/diff/diff-service-build-context.js +1 -45
  51. package/dist/services/diff/diff-service-factory.d.ts +0 -2
  52. package/dist/services/diff/diff-service-factory.js +25 -65
  53. package/dist/services/diff/diff-service.d.ts +0 -11
  54. package/dist/services/diff/diff-service.js +11 -37
  55. package/dist/services/diff/page-source.d.ts +0 -12
  56. package/dist/services/diff/page-source.js +11 -16
  57. package/dist/services/diff/sinks/tool-diff-sink.d.ts +2 -3
  58. package/dist/services/diff/sinks/tool-diff-sink.js +2 -3
  59. package/dist/services/diff/spec/diff-service-build-context.spec.js +0 -19
  60. package/dist/services/diff/spec/diff-service.spec.js +0 -95
  61. package/dist/services/document-handler-runtime/document-handler-browser-mock.d.ts +13 -0
  62. package/dist/services/document-handler-runtime/document-handler-browser-mock.js +69 -0
  63. package/dist/services/document-handler-runtime/document-handler-server.d.ts +27 -0
  64. package/dist/services/document-handler-runtime/document-handler-server.js +112 -19
  65. package/dist/services/document-handler-runtime/spec/document-handler-browser-mock.spec.js +34 -0
  66. package/dist/services/git/git-repository.d.ts +0 -2
  67. package/dist/services/git/git-repository.js +0 -6
  68. package/dist/services/integration-api/customer-config-flags.js +0 -1
  69. package/dist/services/integration-api/integration-api-model.d.ts +4 -1
  70. package/dist/services/integration-api/spec/customer-config-file.spec.js +56 -0
  71. package/dist/services/integration-api/spec/speed-kit-config-file.spec.js +68 -8
  72. package/dist/services/integration-api/struct/customer-config-file.d.ts +15 -0
  73. package/dist/services/integration-api/struct/customer-config-file.js +42 -0
  74. package/dist/services/integration-api/struct/customer-config.d.ts +55 -1
  75. package/dist/services/integration-api/struct/customer-config.js +70 -3
  76. package/dist/services/integration-api/struct/speed-kit-config-file.d.ts +11 -4
  77. package/dist/services/integration-api/struct/speed-kit-config-file.js +31 -10
  78. package/dist/services/onboarding/browse/browse-service.d.ts +1 -13
  79. package/dist/services/onboarding/browse/browse-service.js +7 -43
  80. package/dist/services/onboarding/browser/baqend-response.d.ts +1 -17
  81. package/dist/services/onboarding/browser/baqend-response.js +0 -23
  82. package/dist/services/onboarding/browser/emulate-device.d.ts +1 -12
  83. package/dist/services/onboarding/browser/emulate-device.js +13 -68
  84. package/dist/services/onboarding/browser/executable/executable-validator.js +2 -4
  85. package/dist/services/onboarding/browser/extension/extension-bridge.js +3 -5
  86. package/dist/services/onboarding/browser/extension/extension-downloader.js +8 -17
  87. package/dist/services/onboarding/browser/extension/extension-validator.js +4 -9
  88. package/dist/services/onboarding/browser/launch-browser.d.ts +1 -2
  89. package/dist/services/onboarding/browser/launch-browser.js +1 -6
  90. package/dist/services/onboarding/config-renderer/speed-kit-install-context.d.ts +2 -0
  91. package/dist/services/onboarding/config-renderer/speed-kit-install-context.js +29 -8
  92. package/dist/services/onboarding/dashboard/diff-against-current-page.js +1 -3
  93. package/dist/services/onboarding/dashboard/index.js +2 -7
  94. package/dist/services/onboarding/fetch-event-handler.d.ts +5 -24
  95. package/dist/services/onboarding/fetch-event-handler.js +32 -103
  96. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +2 -11
  97. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +0 -14
  98. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +0 -30
  99. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +3 -14
  100. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +10 -29
  101. package/dist/services/onboarding/file-events/file-watcher.d.ts +4 -43
  102. package/dist/services/onboarding/file-events/file-watcher.js +21 -119
  103. package/dist/services/onboarding/inject/inject-service.js +1 -1
  104. package/dist/services/onboarding/onboarding-model.d.ts +7 -40
  105. package/dist/services/onboarding/onboarding-model.js +9 -20
  106. package/dist/services/onboarding/onboarding-service-build-context.d.ts +0 -4
  107. package/dist/services/onboarding/onboarding-service-build-context.js +1 -7
  108. package/dist/services/onboarding/onboarding-service-factory.d.ts +1 -17
  109. package/dist/services/onboarding/onboarding-service-factory.js +35 -152
  110. package/dist/services/onboarding/onboarding-service.d.ts +1 -40
  111. package/dist/services/onboarding/onboarding-service.js +23 -139
  112. package/dist/services/onboarding/request-cache/cache.d.ts +5 -62
  113. package/dist/services/onboarding/request-cache/cache.js +17 -128
  114. package/dist/services/onboarding/spec/file-events/file-watcher.spec.js +67 -0
  115. package/dist/services/onboarding/spec/onboarding-model.spec.js +3 -39
  116. package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +1 -25
  117. package/dist/services/onboarding/templates/install-speed-kit-js-template.js +5 -0
  118. package/dist/services/onboarding/todo-collector.d.ts +2 -7
  119. package/dist/services/onboarding/todo-collector.js +12 -49
  120. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +0 -38
  121. package/dist/services/onboarding/virtual-orestes-app/index.js +27 -113
  122. package/dist/services/origin-request/asset-variations.d.ts +0 -14
  123. package/dist/services/origin-request/asset-variations.js +4 -11
  124. package/dist/services/origin-request/origin-fetcher.d.ts +0 -7
  125. package/dist/services/origin-request/origin-fetcher.js +5 -43
  126. package/dist/services/origin-request/origin-request-service-build-context.d.ts +0 -17
  127. package/dist/services/origin-request/origin-request-service-build-context.js +0 -8
  128. package/dist/services/origin-request/origin-request-service-factory.d.ts +5 -0
  129. package/dist/services/origin-request/origin-request-service-factory.js +30 -2
  130. package/dist/services/origin-request/origin-request-service.d.ts +6 -121
  131. package/dist/services/origin-request/origin-request-service.js +49 -273
  132. package/dist/services/origin-request/runtime-config-source.d.ts +0 -6
  133. package/dist/services/origin-request/runtime-config-source.js +4 -15
  134. package/dist/services/origin-request/spec/asset-variations.spec.js +0 -20
  135. package/dist/services/origin-request/spec/origin-request-service.spec.js +6 -329
  136. package/dist/services/pull/pull-service.js +23 -5
  137. package/dist/services/query-builder/query-builder-factory.js +3 -3
  138. package/dist/services/setup/os/tool-registry.js +2 -2
  139. package/oclif.manifest.json +288 -3409
  140. package/package.json +3 -20
  141. package/dist/base/run-control-command.d.ts +0 -15
  142. package/dist/base/run-control-command.js +0 -20
  143. package/dist/build-info.json +0 -6
  144. package/dist/commands/onboarding/browser/click.d.ts +0 -75
  145. package/dist/commands/onboarding/browser/click.js +0 -19
  146. package/dist/commands/onboarding/browser/emulate.d.ts +0 -105
  147. package/dist/commands/onboarding/browser/emulate.js +0 -26
  148. package/dist/commands/onboarding/browser/navigate.d.ts +0 -75
  149. package/dist/commands/onboarding/browser/navigate.js +0 -19
  150. package/dist/commands/onboarding/browser/panel.d.ts +0 -63
  151. package/dist/commands/onboarding/browser/panel.js +0 -12
  152. package/dist/commands/onboarding/browser/reinstall-sw.d.ts +0 -63
  153. package/dist/commands/onboarding/browser/reinstall-sw.js +0 -14
  154. package/dist/commands/onboarding/browser/reset.d.ts +0 -71
  155. package/dist/commands/onboarding/browser/reset.js +0 -18
  156. package/dist/commands/onboarding/browser/screenshot.d.ts +0 -77
  157. package/dist/commands/onboarding/browser/screenshot.js +0 -19
  158. package/dist/commands/onboarding/browser/state.d.ts +0 -63
  159. package/dist/commands/onboarding/browser/state.js +0 -12
  160. package/dist/commands/onboarding/browser/tabs.d.ts +0 -58
  161. package/dist/commands/onboarding/browser/tabs.js +0 -16
  162. package/dist/commands/onboarding/cache/clear.d.ts +0 -58
  163. package/dist/commands/onboarding/cache/clear.js +0 -12
  164. package/dist/commands/onboarding/cache/errors.d.ts +0 -58
  165. package/dist/commands/onboarding/cache/errors.js +0 -12
  166. package/dist/commands/onboarding/cache/evict.d.ts +0 -62
  167. package/dist/commands/onboarding/cache/evict.js +0 -15
  168. package/dist/commands/onboarding/cache/get.d.ts +0 -85
  169. package/dist/commands/onboarding/cache/get.js +0 -17
  170. package/dist/commands/onboarding/cache/list.d.ts +0 -58
  171. package/dist/commands/onboarding/cache/list.js +0 -15
  172. package/dist/commands/onboarding/cache/prewarm.d.ts +0 -73
  173. package/dist/commands/onboarding/cache/prewarm.js +0 -20
  174. package/dist/commands/onboarding/cache/refresh.d.ts +0 -62
  175. package/dist/commands/onboarding/cache/refresh.js +0 -18
  176. package/dist/commands/onboarding/cdp.d.ts +0 -81
  177. package/dist/commands/onboarding/cdp.js +0 -18
  178. package/dist/commands/onboarding/debug/arm.d.ts +0 -83
  179. package/dist/commands/onboarding/debug/arm.js +0 -19
  180. package/dist/commands/onboarding/debug/await.d.ts +0 -71
  181. package/dist/commands/onboarding/debug/await.js +0 -18
  182. package/dist/commands/onboarding/debug/disarm.d.ts +0 -63
  183. package/dist/commands/onboarding/debug/disarm.js +0 -12
  184. package/dist/commands/onboarding/debug/eval.d.ts +0 -75
  185. package/dist/commands/onboarding/debug/eval.js +0 -16
  186. package/dist/commands/onboarding/debug/release.d.ts +0 -63
  187. package/dist/commands/onboarding/debug/release.js +0 -12
  188. package/dist/commands/onboarding/debug/resume.d.ts +0 -63
  189. package/dist/commands/onboarding/debug/resume.js +0 -12
  190. package/dist/commands/onboarding/debug/status.d.ts +0 -63
  191. package/dist/commands/onboarding/debug/status.js +0 -12
  192. package/dist/commands/onboarding/debug/step.d.ts +0 -67
  193. package/dist/commands/onboarding/debug/step.js +0 -15
  194. package/dist/commands/onboarding/files/list.d.ts +0 -58
  195. package/dist/commands/onboarding/files/list.js +0 -12
  196. package/dist/commands/onboarding/files/read.d.ts +0 -73
  197. package/dist/commands/onboarding/files/read.js +0 -16
  198. package/dist/commands/onboarding/files/rebuild.d.ts +0 -63
  199. package/dist/commands/onboarding/files/rebuild.js +0 -18
  200. package/dist/commands/onboarding/files/validate.d.ts +0 -58
  201. package/dist/commands/onboarding/files/validate.js +0 -12
  202. package/dist/commands/onboarding/fouc.d.ts +0 -77
  203. package/dist/commands/onboarding/fouc.js +0 -16
  204. package/dist/commands/onboarding/inject/add.d.ts +0 -89
  205. package/dist/commands/onboarding/inject/add.js +0 -17
  206. package/dist/commands/onboarding/inject/clear.d.ts +0 -63
  207. package/dist/commands/onboarding/inject/clear.js +0 -12
  208. package/dist/commands/onboarding/inject/list.d.ts +0 -63
  209. package/dist/commands/onboarding/inject/list.js +0 -12
  210. package/dist/commands/onboarding/inject/read.d.ts +0 -75
  211. package/dist/commands/onboarding/inject/read.js +0 -18
  212. package/dist/commands/onboarding/inject/recipes.d.ts +0 -63
  213. package/dist/commands/onboarding/inject/recipes.js +0 -12
  214. package/dist/commands/onboarding/inject/remove.d.ts +0 -67
  215. package/dist/commands/onboarding/inject/remove.js +0 -15
  216. package/dist/commands/onboarding/list.d.ts +0 -13
  217. package/dist/commands/onboarding/list.js +0 -12
  218. package/dist/commands/onboarding/logs.d.ts +0 -41
  219. package/dist/commands/onboarding/logs.js +0 -257
  220. package/dist/commands/onboarding/navwalk.d.ts +0 -95
  221. package/dist/commands/onboarding/navwalk.js +0 -19
  222. package/dist/commands/onboarding/response.d.ts +0 -67
  223. package/dist/commands/onboarding/response.js +0 -18
  224. package/dist/commands/onboarding/rum/beacons.d.ts +0 -75
  225. package/dist/commands/onboarding/rum/beacons.js +0 -16
  226. package/dist/commands/onboarding/rum/get.d.ts +0 -77
  227. package/dist/commands/onboarding/rum/get.js +0 -18
  228. package/dist/commands/onboarding/rum/key.d.ts +0 -67
  229. package/dist/commands/onboarding/rum/key.js +0 -13
  230. package/dist/commands/onboarding/rum/previous.d.ts +0 -63
  231. package/dist/commands/onboarding/rum/previous.js +0 -12
  232. package/dist/commands/onboarding/status.d.ts +0 -13
  233. package/dist/commands/onboarding/status.js +0 -17
  234. package/dist/commands/onboarding/stop.d.ts +0 -13
  235. package/dist/commands/onboarding/stop.js +0 -17
  236. package/dist/commands/onboarding/todo.d.ts +0 -58
  237. package/dist/commands/onboarding/todo.js +0 -12
  238. package/dist/commands/onboarding/viewport.d.ts +0 -101
  239. package/dist/commands/onboarding/viewport.js +0 -18
  240. package/dist/commands/onboarding/watch.d.ts +0 -93
  241. package/dist/commands/onboarding/watch.js +0 -16
  242. package/dist/commands/spec/onboarding.spec.js +0 -127
  243. package/dist/services/cli/build-info.d.ts +0 -33
  244. package/dist/services/cli/build-info.js +0 -63
  245. package/dist/services/cli/sink.d.ts +0 -47
  246. package/dist/services/cli/sink.js +0 -31
  247. package/dist/services/cli/spec/build-identity.spec.js +0 -85
  248. package/dist/services/cli/spec/build-info.spec.js +0 -10
  249. package/dist/services/cli/spec/cli-service-log.spec.js +0 -133
  250. package/dist/services/cli/spec/memory-cli.d.ts +0 -9
  251. package/dist/services/cli/spec/memory-cli.js +0 -9
  252. package/dist/services/diff/config-at-ref.d.ts +0 -20
  253. package/dist/services/diff/config-at-ref.js +0 -33
  254. package/dist/services/diff/run-runtime-config.d.ts +0 -33
  255. package/dist/services/diff/run-runtime-config.js +0 -74
  256. package/dist/services/diff/spec/config-at-ref.spec.js +0 -46
  257. package/dist/services/diff/spec/run-runtime-config.spec.d.ts +0 -1
  258. package/dist/services/diff/spec/run-runtime-config.spec.js +0 -87
  259. package/dist/services/onboarding/browser/answer-dialogs.d.ts +0 -12
  260. package/dist/services/onboarding/browser/answer-dialogs.js +0 -25
  261. package/dist/services/onboarding/browser/console-log.d.ts +0 -9
  262. package/dist/services/onboarding/browser/console-log.js +0 -27
  263. package/dist/services/onboarding/browser/resume-restarted-workers.d.ts +0 -14
  264. package/dist/services/onboarding/browser/resume-restarted-workers.js +0 -26
  265. package/dist/services/onboarding/control/body-inspect.d.ts +0 -24
  266. package/dist/services/onboarding/control/body-inspect.js +0 -106
  267. package/dist/services/onboarding/control/browser-session.d.ts +0 -547
  268. package/dist/services/onboarding/control/browser-session.js +0 -1337
  269. package/dist/services/onboarding/control/config-validation.d.ts +0 -17
  270. package/dist/services/onboarding/control/config-validation.js +0 -46
  271. package/dist/services/onboarding/control/control-protocol.d.ts +0 -1430
  272. package/dist/services/onboarding/control/control-protocol.js +0 -58
  273. package/dist/services/onboarding/control/control-server.d.ts +0 -292
  274. package/dist/services/onboarding/control/control-server.js +0 -1629
  275. package/dist/services/onboarding/control/debug-session.d.ts +0 -219
  276. package/dist/services/onboarding/control/debug-session.js +0 -897
  277. package/dist/services/onboarding/control/fouc.d.ts +0 -23
  278. package/dist/services/onboarding/control/fouc.js +0 -151
  279. package/dist/services/onboarding/control/index.d.ts +0 -4
  280. package/dist/services/onboarding/control/index.js +0 -4
  281. package/dist/services/onboarding/control/navigate-wait.d.ts +0 -33
  282. package/dist/services/onboarding/control/navigate-wait.js +0 -56
  283. package/dist/services/onboarding/control/navwalk.d.ts +0 -65
  284. package/dist/services/onboarding/control/navwalk.js +0 -248
  285. package/dist/services/onboarding/control/preload-registry.d.ts +0 -150
  286. package/dist/services/onboarding/control/preload-registry.js +0 -829
  287. package/dist/services/onboarding/control/response-explainer.d.ts +0 -24
  288. package/dist/services/onboarding/control/response-explainer.js +0 -257
  289. package/dist/services/onboarding/control/rum.d.ts +0 -8
  290. package/dist/services/onboarding/control/rum.js +0 -220
  291. package/dist/services/onboarding/control/service-worker-tracker.d.ts +0 -68
  292. package/dist/services/onboarding/control/service-worker-tracker.js +0 -120
  293. package/dist/services/onboarding/control/viewport.d.ts +0 -45
  294. package/dist/services/onboarding/control/viewport.js +0 -344
  295. package/dist/services/onboarding/control/watch.d.ts +0 -26
  296. package/dist/services/onboarding/control/watch.js +0 -157
  297. package/dist/services/onboarding/request-cache/asset-key.d.ts +0 -61
  298. package/dist/services/onboarding/request-cache/asset-key.js +0 -115
  299. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.d.ts +0 -1
  300. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.js +0 -66
  301. package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +0 -1
  302. package/dist/services/onboarding/spec/browser/console-log.spec.js +0 -42
  303. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.d.ts +0 -1
  304. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.js +0 -45
  305. package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +0 -1
  306. package/dist/services/onboarding/spec/control/browser-session.spec.js +0 -753
  307. package/dist/services/onboarding/spec/control/control-server.spec.d.ts +0 -1
  308. package/dist/services/onboarding/spec/control/control-server.spec.js +0 -371
  309. package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +0 -1
  310. package/dist/services/onboarding/spec/control/debug-session.spec.js +0 -751
  311. package/dist/services/onboarding/spec/control/fakes.d.ts +0 -31
  312. package/dist/services/onboarding/spec/control/fakes.js +0 -67
  313. package/dist/services/onboarding/spec/control/fouc.spec.d.ts +0 -1
  314. package/dist/services/onboarding/spec/control/fouc.spec.js +0 -167
  315. package/dist/services/onboarding/spec/control/navigate-wait.spec.d.ts +0 -1
  316. package/dist/services/onboarding/spec/control/navigate-wait.spec.js +0 -47
  317. package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +0 -1
  318. package/dist/services/onboarding/spec/control/navwalk.spec.js +0 -222
  319. package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +0 -1
  320. package/dist/services/onboarding/spec/control/preload-registry.spec.js +0 -432
  321. package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +0 -1
  322. package/dist/services/onboarding/spec/control/response-explainer.spec.js +0 -324
  323. package/dist/services/onboarding/spec/control/rum.spec.d.ts +0 -1
  324. package/dist/services/onboarding/spec/control/rum.spec.js +0 -222
  325. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +0 -1
  326. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +0 -193
  327. package/dist/services/onboarding/spec/control/viewport.spec.d.ts +0 -1
  328. package/dist/services/onboarding/spec/control/viewport.spec.js +0 -200
  329. package/dist/services/onboarding/spec/control/watch.spec.d.ts +0 -1
  330. package/dist/services/onboarding/spec/control/watch.spec.js +0 -187
  331. package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +0 -1
  332. package/dist/services/onboarding/spec/fetch-event-handler.spec.js +0 -219
  333. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +0 -1
  334. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +0 -41
  335. package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +0 -1
  336. package/dist/services/onboarding/spec/request-cache/cache.spec.js +0 -107
  337. package/dist/services/onboarding/spec/todo-collector.spec.d.ts +0 -1
  338. package/dist/services/onboarding/spec/todo-collector.spec.js +0 -136
  339. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.d.ts +0 -1
  340. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.js +0 -65
  341. package/dist/services/query-builder/rules/rule-match.d.ts +0 -35
  342. package/dist/services/query-builder/rules/rule-match.js +0 -70
  343. package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +0 -1
  344. package/dist/services/query-builder/spec/rules/rule-match.spec.js +0 -121
  345. package/dist/services/run-control/browser/run-browser-contexts.d.ts +0 -557
  346. package/dist/services/run-control/browser/run-browser-contexts.js +0 -91
  347. package/dist/services/run-control/browser/run-browser-service-factory.d.ts +0 -5
  348. package/dist/services/run-control/browser/run-browser-service-factory.js +0 -7
  349. package/dist/services/run-control/browser/run-browser-service.d.ts +0 -68
  350. package/dist/services/run-control/browser/run-browser-service.js +0 -206
  351. package/dist/services/run-control/cache/run-cache-contexts.d.ts +0 -349
  352. package/dist/services/run-control/cache/run-cache-contexts.js +0 -51
  353. package/dist/services/run-control/cache/run-cache-service-factory.d.ts +0 -6
  354. package/dist/services/run-control/cache/run-cache-service-factory.js +0 -12
  355. package/dist/services/run-control/cache/run-cache-service.d.ts +0 -35
  356. package/dist/services/run-control/cache/run-cache-service.js +0 -151
  357. package/dist/services/run-control/control-client.d.ts +0 -36
  358. package/dist/services/run-control/control-client.js +0 -147
  359. package/dist/services/run-control/debug/run-debug-contexts.d.ts +0 -416
  360. package/dist/services/run-control/debug/run-debug-contexts.js +0 -47
  361. package/dist/services/run-control/debug/run-debug-service-factory.d.ts +0 -5
  362. package/dist/services/run-control/debug/run-debug-service-factory.js +0 -7
  363. package/dist/services/run-control/debug/run-debug-service.d.ts +0 -39
  364. package/dist/services/run-control/debug/run-debug-service.js +0 -164
  365. package/dist/services/run-control/files/run-files-contexts.d.ts +0 -238
  366. package/dist/services/run-control/files/run-files-contexts.js +0 -26
  367. package/dist/services/run-control/files/run-files-service-factory.d.ts +0 -5
  368. package/dist/services/run-control/files/run-files-service-factory.js +0 -7
  369. package/dist/services/run-control/files/run-files-service.d.ts +0 -29
  370. package/dist/services/run-control/files/run-files-service.js +0 -120
  371. package/dist/services/run-control/index.d.ts +0 -32
  372. package/dist/services/run-control/index.js +0 -31
  373. package/dist/services/run-control/inject/run-inject-contexts.d.ts +0 -319
  374. package/dist/services/run-control/inject/run-inject-contexts.js +0 -38
  375. package/dist/services/run-control/inject/run-inject-service-factory.d.ts +0 -5
  376. package/dist/services/run-control/inject/run-inject-service-factory.js +0 -7
  377. package/dist/services/run-control/inject/run-inject-service.d.ts +0 -31
  378. package/dist/services/run-control/inject/run-inject-service.js +0 -227
  379. package/dist/services/run-control/live-run.d.ts +0 -37
  380. package/dist/services/run-control/live-run.js +0 -56
  381. package/dist/services/run-control/probe/run-probe-contexts.d.ts +0 -333
  382. package/dist/services/run-control/probe/run-probe-contexts.js +0 -73
  383. package/dist/services/run-control/probe/run-probe-service-factory.d.ts +0 -5
  384. package/dist/services/run-control/probe/run-probe-service-factory.js +0 -7
  385. package/dist/services/run-control/probe/run-probe-service.d.ts +0 -54
  386. package/dist/services/run-control/probe/run-probe-service.js +0 -194
  387. package/dist/services/run-control/rum/run-rum-contexts.d.ts +0 -216
  388. package/dist/services/run-control/rum/run-rum-contexts.js +0 -34
  389. package/dist/services/run-control/rum/run-rum-service-factory.d.ts +0 -5
  390. package/dist/services/run-control/rum/run-rum-service-factory.js +0 -7
  391. package/dist/services/run-control/rum/run-rum-service.d.ts +0 -36
  392. package/dist/services/run-control/rum/run-rum-service.js +0 -122
  393. package/dist/services/run-control/run-answer.d.ts +0 -28
  394. package/dist/services/run-control/run-answer.js +0 -58
  395. package/dist/services/run-control/run-control-context.d.ts +0 -102
  396. package/dist/services/run-control/run-control-context.js +0 -36
  397. package/dist/services/run-control/run-control-flags.d.ts +0 -12
  398. package/dist/services/run-control/run-control-flags.js +0 -22
  399. package/dist/services/run-control/run-control-model.d.ts +0 -9
  400. package/dist/services/run-control/run-control-model.js +0 -1
  401. package/dist/services/run-control/run-control-service-factory.d.ts +0 -14
  402. package/dist/services/run-control/run-control-service-factory.js +0 -26
  403. package/dist/services/run-control/session/run-session-contexts.d.ts +0 -25
  404. package/dist/services/run-control/session/run-session-contexts.js +0 -20
  405. package/dist/services/run-control/session/run-session-service-factory.d.ts +0 -8
  406. package/dist/services/run-control/session/run-session-service-factory.js +0 -18
  407. package/dist/services/run-control/session/run-session-service.d.ts +0 -32
  408. package/dist/services/run-control/session/run-session-service.js +0 -151
  409. package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +0 -1
  410. package/dist/services/run-control/spec/browser/run-browser-service.spec.js +0 -328
  411. package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +0 -1
  412. package/dist/services/run-control/spec/cache/run-cache-service.spec.js +0 -454
  413. package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +0 -1
  414. package/dist/services/run-control/spec/debug/run-debug-service.spec.js +0 -113
  415. package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +0 -1
  416. package/dist/services/run-control/spec/files/run-files-service.spec.js +0 -234
  417. package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +0 -1
  418. package/dist/services/run-control/spec/inject/run-inject-service.spec.js +0 -251
  419. package/dist/services/run-control/spec/live-run-fixture.d.ts +0 -32
  420. package/dist/services/run-control/spec/live-run-fixture.js +0 -109
  421. package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +0 -1
  422. package/dist/services/run-control/spec/probe/run-probe-service.spec.js +0 -108
  423. package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +0 -1
  424. package/dist/services/run-control/spec/rum/run-rum-service.spec.js +0 -47
  425. package/dist/services/run-control/spec/run-answer.spec.d.ts +0 -1
  426. package/dist/services/run-control/spec/run-answer.spec.js +0 -57
  427. package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +0 -1
  428. package/dist/services/run-control/spec/session/run-session-service.spec.js +0 -150
  429. package/dist/services/run-log/crash-mirror.d.ts +0 -31
  430. package/dist/services/run-log/crash-mirror.js +0 -69
  431. package/dist/services/run-log/index.d.ts +0 -11
  432. package/dist/services/run-log/index.js +0 -11
  433. package/dist/services/run-log/jsonl-appender.d.ts +0 -46
  434. package/dist/services/run-log/jsonl-appender.js +0 -91
  435. package/dist/services/run-log/log-event-model.d.ts +0 -104
  436. package/dist/services/run-log/log-event-model.js +0 -56
  437. package/dist/services/run-log/log-query-service-factory.d.ts +0 -11
  438. package/dist/services/run-log/log-query-service-factory.js +0 -14
  439. package/dist/services/run-log/log-query-service.d.ts +0 -59
  440. package/dist/services/run-log/log-query-service.js +0 -111
  441. package/dist/services/run-log/log-reader.d.ts +0 -84
  442. package/dist/services/run-log/log-reader.js +0 -180
  443. package/dist/services/run-log/log-summary.d.ts +0 -72
  444. package/dist/services/run-log/log-summary.js +0 -208
  445. package/dist/services/run-log/redaction.d.ts +0 -34
  446. package/dist/services/run-log/redaction.js +0 -124
  447. package/dist/services/run-log/request-log.d.ts +0 -82
  448. package/dist/services/run-log/request-log.js +0 -69
  449. package/dist/services/run-log/request-summary.d.ts +0 -76
  450. package/dist/services/run-log/request-summary.js +0 -0
  451. package/dist/services/run-log/run-log.d.ts +0 -61
  452. package/dist/services/run-log/run-log.js +0 -102
  453. package/dist/services/run-log/spec/log-query-service.spec.d.ts +0 -1
  454. package/dist/services/run-log/spec/log-query-service.spec.js +0 -197
  455. package/dist/services/run-log/spec/log-reader.spec.d.ts +0 -1
  456. package/dist/services/run-log/spec/log-reader.spec.js +0 -109
  457. package/dist/services/run-log/spec/log-summary.spec.d.ts +0 -1
  458. package/dist/services/run-log/spec/log-summary.spec.js +0 -153
  459. package/dist/services/run-log/spec/redaction.spec.d.ts +0 -1
  460. package/dist/services/run-log/spec/redaction.spec.js +0 -61
  461. package/dist/services/run-log/spec/request-log.spec.d.ts +0 -1
  462. package/dist/services/run-log/spec/request-log.spec.js +0 -101
  463. package/dist/services/run-log/spec/request-summary.spec.d.ts +0 -1
  464. package/dist/services/run-log/spec/request-summary.spec.js +0 -171
  465. package/dist/services/run-log/spec/run-log.spec.d.ts +0 -1
  466. package/dist/services/run-log/spec/run-log.spec.js +0 -122
  467. package/dist/services/run-registry/exit-classification.d.ts +0 -39
  468. package/dist/services/run-registry/exit-classification.js +0 -42
  469. package/dist/services/run-registry/index.d.ts +0 -3
  470. package/dist/services/run-registry/index.js +0 -3
  471. package/dist/services/run-registry/process-identity.d.ts +0 -28
  472. package/dist/services/run-registry/process-identity.js +0 -80
  473. package/dist/services/run-registry/run-registry-model.d.ts +0 -128
  474. package/dist/services/run-registry/run-registry-model.js +0 -16
  475. package/dist/services/run-registry/run-registry.d.ts +0 -155
  476. package/dist/services/run-registry/run-registry.js +0 -430
  477. package/dist/services/run-registry/spec/exit-classification.spec.d.ts +0 -1
  478. package/dist/services/run-registry/spec/exit-classification.spec.js +0 -82
  479. package/dist/services/run-registry/spec/run-registry.spec.d.ts +0 -1
  480. package/dist/services/run-registry/spec/run-registry.spec.js +0 -526
  481. /package/dist/{commands/spec/onboarding.spec.d.ts → services/bundler/spec/packjockel-service.spec.d.ts} +0 -0
  482. /package/dist/services/{cli/spec/build-identity.spec.d.ts → deploy/spec/handler/customer-config-handler.spec.d.ts} +0 -0
  483. /package/dist/services/{cli/spec/build-info.spec.d.ts → document-handler-runtime/spec/document-handler-browser-mock.spec.d.ts} +0 -0
  484. /package/dist/services/{cli/spec/cli-service-log.spec.d.ts → integration-api/spec/customer-config-file.spec.d.ts} +0 -0
  485. /package/dist/services/{diff/spec/config-at-ref.spec.d.ts → onboarding/spec/file-events/file-watcher.spec.d.ts} +0 -0
@@ -1,120 +0,0 @@
1
- /**
2
- * What service workers the run has seen, kept because nothing can ask.
3
- *
4
- * CDP has no "list the registrations" command — `ServiceWorker.enable` starts a
5
- * stream of `workerRegistrationUpdated` and `workerVersionUpdated` events and
6
- * that is the only source. A reader arriving later, which every run command is,
7
- * has missed them. So the run keeps the latest state as it goes.
8
- *
9
- * Asking the page instead (`navigator.serviceWorker.getRegistrations()`) looks
10
- * simpler and answers a different question: it reports scope and script url but
11
- * no version id and no history, so it cannot tell a locally installed worker
12
- * from the deployed one that replaced it. That distinction is the reason this
13
- * exists — a takeover is silent, and with static routing it freezes the routes
14
- * from the *deployed* config, so locally enabled pages bypass the worker
15
- * entirely and every navigation reports `SwBooting`. Hours have gone into
16
- * diagnosing that from the symptom.
17
- */
18
- export class ServiceWorkerTracker {
19
- registrations = new Map();
20
- versions = new Map();
21
- takeovers = 0;
22
- lastTakeoverAt;
23
- /** From `ServiceWorker.workerRegistrationUpdated`. */
24
- recordRegistrations(registrations) {
25
- for (const registration of registrations) {
26
- // A deleted registration is kept, not dropped. "There was one here and it
27
- // is gone" is the answer to a live question — a worker that unregisters
28
- // itself mid-session looks identical to one that never existed.
29
- this.registrations.set(registration.registrationId, {
30
- registrationId: registration.registrationId,
31
- scopeURL: registration.scopeURL,
32
- deleted: Boolean(registration.isDeleted),
33
- });
34
- }
35
- }
36
- /** From `ServiceWorker.workerVersionUpdated`. */
37
- recordVersions(versions) {
38
- for (const version of versions) {
39
- this.versions.set(version.versionId, {
40
- versionId: version.versionId,
41
- registrationId: version.registrationId,
42
- scriptURL: version.scriptURL,
43
- status: version.status,
44
- runningStatus: version.runningStatus,
45
- targetId: version.targetId,
46
- });
47
- }
48
- }
49
- /**
50
- * The run decided a deployed worker took over.
51
- *
52
- * Recorded rather than derived: the decision needs `lastServedAt` from the
53
- * local sw.js route, which lives in the run and not here. This only keeps the
54
- * verdict so a reader can see it after the fact.
55
- */
56
- recordTakeover(versionId) {
57
- this.takeovers += 1;
58
- this.lastTakeoverAt = new Date().toISOString();
59
- const version = this.versions.get(versionId);
60
- if (version) {
61
- this.versions.set(versionId, { ...version, foreign: true });
62
- }
63
- }
64
- /**
65
- * What is installed, and which of it is in charge of `pageUrl`.
66
- *
67
- * The active version has to be chosen against the page, not off the top of
68
- * the list. This used to be `versions.find(v => v.status === "activated")` —
69
- * the first activated version in insertion order, across every registration
70
- * — and on a shop with scoped workers that is never the page's own. atida
71
- * registers six (`/basket`, `/checkout`, `/login`, …) and the answer was
72
- * always the customer's empty `wrapper-sw.js` on `/basket`, through two
73
- * reinstalls that each replaced the worker actually serving the page.
74
- *
75
- * `foreign` is read off this version, so picking the wrong one hid the
76
- * takeover this tracker exists to report: the run marks the right version in
77
- * {@link recordTakeover}, and the flag was then read from a different one
78
- * that nobody had marked. `takeovers` still counted, which is the only
79
- * reason it was visible at all.
80
- */
81
- state(pageUrl) {
82
- const versions = [...this.versions.values()];
83
- const active = this.activeVersionFor(pageUrl);
84
- return {
85
- registrations: [...this.registrations.values()],
86
- versions,
87
- activeVersionId: active?.versionId,
88
- // The question a debugger is actually asking. False here means "no
89
- // takeover *seen*" — a run that started after one would not know.
90
- foreign: Boolean(active?.foreign),
91
- takeovers: this.takeovers,
92
- lastTakeoverAt: this.lastTakeoverAt,
93
- };
94
- }
95
- /**
96
- * The activated worker controlling this url.
97
- *
98
- * A registration controls a url when its scope is a prefix of it, and the
99
- * narrowest matching scope wins — the rule the browser itself applies, so a
100
- * page under `/basket` is answered by the `/basket` worker and the homepage
101
- * by the root one. A deleted registration controls nothing.
102
- *
103
- * `undefined` is a real answer: mid-reinstall the new version is still
104
- * `activating` and no activated worker controls the page. Falling back to
105
- * "any activated version" would put the original bug back, quietly.
106
- */
107
- activeVersionFor(pageUrl) {
108
- if (!pageUrl) {
109
- return undefined;
110
- }
111
- const controlling = [...this.registrations.values()]
112
- .filter((registration) => !registration.deleted && pageUrl.startsWith(registration.scopeURL))
113
- .sort((a, b) => b.scopeURL.length - a.scopeURL.length)[0];
114
- if (!controlling) {
115
- return undefined;
116
- }
117
- return [...this.versions.values()].find((version) => version.registrationId === controlling.registrationId &&
118
- version.status === "activated");
119
- }
120
- }
@@ -1,45 +0,0 @@
1
- import { ViewportData } from "./control-protocol.js";
2
- export declare class BadRangeError extends Error {
3
- readonly code = "BAD_RANGE";
4
- }
5
- /**
6
- * What a width sweep needs from the browser.
7
- *
8
- * `resize` rather than a CDP handle, because the override has to be cleared
9
- * again afterwards and a caller that forgot would leave the run's browser
10
- * pinned to whatever width the sweep ended on.
11
- */
12
- export interface ViewportBrowser {
13
- evaluate<T>(expression: string): Promise<T>;
14
- resize(width: number, height: number): Promise<void>;
15
- clearResize(): Promise<void>;
16
- reload(): Promise<void>;
17
- }
18
- export interface ViewportOptions {
19
- min?: number;
20
- max?: number;
21
- step?: number;
22
- settleMs?: number;
23
- height?: number;
24
- }
25
- /**
26
- * Find the widths where the page's own JavaScript changes the DOM.
27
- *
28
- * `tools/sk-breakpoints.mjs` promoted. The question it answers is which device
29
- * variations a customer actually needs: an SSR snapshot is captured at one
30
- * width, and serving it at another is only wrong where the frontend *JS* would
31
- * have rendered something different.
32
- *
33
- * Which is why this watches mutations rather than diffing element counts.
34
- * Pure CSS responsiveness — the same DOM, restyled by a media query — produces
35
- * no mutation and correctly reports no variation needed, because the CSS
36
- * re-applies on the client over whatever snapshot was served. A class swap that
37
- * turns a nav into a hamburger changes no node count at all and is exactly the
38
- * case that does need one. Only a MutationObserver sees both correctly.
39
- *
40
- * Two things it does not do, so they are not mistaken for clean results. It
41
- * reports at most one breakpoint per coarse step, because the pin stops at the
42
- * first pixel that mutates; and `bootOnlyBranching` is a yes/no rather than a
43
- * width, since finding the width would mean a reload per probe.
44
- */
45
- export declare function runViewportSweep(browser: ViewportBrowser, options: ViewportOptions): Promise<ViewportData>;
@@ -1,344 +0,0 @@
1
- const DEFAULT_MIN = 360;
2
- const DEFAULT_MAX = 1600;
3
- const DEFAULT_STEP = 20;
4
- const DEFAULT_SETTLE_MS = 350;
5
- const DEFAULT_HEIGHT = 900;
6
- /** Dwells at the start width, to learn what mutates on its own. */
7
- const NOISE_DWELLS = 6;
8
- /** A page with more than this is not telling us about layout breakpoints. */
9
- const MAX_BREAKPOINTS = 12;
10
- /**
11
- * A layout change seen at this share of the coarse steps or more is the page
12
- * following the width continuously — a slider recomputing which slide is
13
- * active — rather than a breakpoint.
14
- */
15
- const FLUID_SHARE = 0.5;
16
- /** How many mutation keys any one list in the answer carries. */
17
- const KEY_LIMIT = 8;
18
- export class BadRangeError extends Error {
19
- code = "BAD_RANGE";
20
- }
21
- /**
22
- * Find the widths where the page's own JavaScript changes the DOM.
23
- *
24
- * `tools/sk-breakpoints.mjs` promoted. The question it answers is which device
25
- * variations a customer actually needs: an SSR snapshot is captured at one
26
- * width, and serving it at another is only wrong where the frontend *JS* would
27
- * have rendered something different.
28
- *
29
- * Which is why this watches mutations rather than diffing element counts.
30
- * Pure CSS responsiveness — the same DOM, restyled by a media query — produces
31
- * no mutation and correctly reports no variation needed, because the CSS
32
- * re-applies on the client over whatever snapshot was served. A class swap that
33
- * turns a nav into a hamburger changes no node count at all and is exactly the
34
- * case that does need one. Only a MutationObserver sees both correctly.
35
- *
36
- * Two things it does not do, so they are not mistaken for clean results. It
37
- * reports at most one breakpoint per coarse step, because the pin stops at the
38
- * first pixel that mutates; and `bootOnlyBranching` is a yes/no rather than a
39
- * width, since finding the width would mean a reload per probe.
40
- */
41
- export async function runViewportSweep(browser, options) {
42
- const min = Math.max(200, options.min ?? DEFAULT_MIN);
43
- const max = Math.min(4000, options.max ?? DEFAULT_MAX);
44
- const step = Math.max(1, options.step ?? DEFAULT_STEP);
45
- const settleMs = Math.max(50, options.settleMs ?? DEFAULT_SETTLE_MS);
46
- const height = options.height ?? DEFAULT_HEIGHT;
47
- if (max - min < step) {
48
- throw new BadRangeError(`${min} to ${max} is narrower than one ${step}px step — widen the range or lower the step`);
49
- }
50
- try {
51
- await browser.resize(min, height);
52
- await delay(settleMs * 3);
53
- await install(browser);
54
- // Everything that fires while the page is standing still is noise:
55
- // carousels, polling, late hydration. Learned first, so the sweep is not
56
- // reading a rotating banner as a layout breakpoint.
57
- const noise = new Set();
58
- for (let dwell = 0; dwell < NOISE_DWELLS; dwell += 1) {
59
- await delay(settleMs);
60
- for (const key of await drain(browser)) {
61
- noise.add(key);
62
- }
63
- }
64
- // Inline style is set aside before anything else. A fluid layout — a
65
- // slider, a sticky header computing its offset — rewrites it on every
66
- // resize, and a snapshot served at another width is corrected by that same
67
- // script on the client, so it never needs a variation. Counting it buried
68
- // the one class swap that does under a thousand style writes.
69
- const steps = [];
70
- let styleOnlySteps = 0;
71
- let previous = min;
72
- for (let width = min + step; width <= max; width += step) {
73
- await browser.resize(width, height);
74
- await delay(settleMs);
75
- const changed = (await drain(browser)).filter((key) => !noise.has(key));
76
- const layout = changed.filter((key) => !isStyleOnly(key));
77
- if (layout.length === 0 && changed.length > 0) {
78
- styleOnlySteps += 1;
79
- }
80
- steps.push({ from: previous, to: width, layout });
81
- previous = width;
82
- }
83
- // What changes at most steps is following the width, not crossing one.
84
- const fluid = fluidKeys(steps);
85
- const ignored = new Set([...noise, ...fluid]);
86
- const intervals = steps
87
- .map((one) => ({
88
- ...one,
89
- changed: one.layout.filter((key) => !ignored.has(key)),
90
- }))
91
- .filter((one) => one.changed.length > 0);
92
- const breakpoints = [];
93
- for (const interval of intervals.slice(0, MAX_BREAKPOINTS)) {
94
- breakpoints.push(await pin(browser, interval, { height, settleMs, noise: ignored }));
95
- }
96
- // Said rather than dropped: a sweep that pinned twelve and stopped used to
97
- // read as a sweep that ended at the twelfth.
98
- const unpinned = intervals
99
- .slice(MAX_BREAKPOINTS)
100
- .map(({ from, to }) => ({ from, to }));
101
- const bootOnlyBranching = breakpoints.length === 0
102
- ? await bootDiffers(browser, { min, max, height, settleMs })
103
- : null;
104
- return {
105
- min,
106
- max,
107
- step,
108
- breakpoints,
109
- unpinned,
110
- noise: [...noise].slice(0, KEY_LIMIT),
111
- fluid: fluid.slice(0, KEY_LIMIT),
112
- styleOnlySteps,
113
- steps: steps.length,
114
- bootOnlyBranching,
115
- verdict: verdictFor({
116
- breakpoints,
117
- unpinned,
118
- bootOnlyBranching,
119
- styleOnlySteps,
120
- steps: steps.length,
121
- }),
122
- };
123
- }
124
- finally {
125
- // The run's browser goes back to its own size whatever happened. A sweep
126
- // that threw halfway and left the window at 360px would look like a bug in
127
- // everything looked at afterwards.
128
- await browser.clearResize().catch(() => undefined);
129
- }
130
- }
131
- /**
132
- * Narrow an interval to the exact pixel, then check it reverses.
133
- *
134
- * One pixel at a time, upward from the bottom of the interval, because the
135
- * mutation fires on the *crossing*: widening past 768 mutates and every other
136
- * width in the interval does not. That makes the probe a point question rather
137
- * than a monotone one, and a binary search over it converges on the top of the
138
- * interval instead of the breakpoint — it needs "true at w implies true above
139
- * w", which is exactly what is not the case here.
140
- *
141
- * The confirmation matters as much as the pin: a real breakpoint mutates in
142
- * both directions, and one-off churn that happened to land in this interval
143
- * does not.
144
- */
145
- async function pin(browser, interval, context) {
146
- // Back to the bottom, and discard what that crossing itself produced.
147
- await browser.resize(interval.from, context.height);
148
- await delay(context.settleMs);
149
- await drain(browser);
150
- let width = interval.to;
151
- let changed = interval.changed;
152
- for (let probe = interval.from + 1; probe <= interval.to; probe += 1) {
153
- await browser.resize(probe, context.height);
154
- await delay(context.settleMs);
155
- const keys = (await drain(browser)).filter((key) => !context.noise.has(key) && !isStyleOnly(key));
156
- if (keys.length > 0) {
157
- width = probe;
158
- changed = keys;
159
- break;
160
- }
161
- }
162
- const confirmed = await reverses(browser, width, context);
163
- return {
164
- width,
165
- confirmed,
166
- changed: changed.slice(0, KEY_LIMIT),
167
- changedTotal: changed.length,
168
- hint: hintFor(changed),
169
- };
170
- }
171
- /** A real breakpoint mutates on the way back down as well as on the way up. */
172
- async function reverses(browser, width, context) {
173
- await browser.resize(width, context.height);
174
- await delay(context.settleMs);
175
- await drain(browser);
176
- await browser.resize(width - 1, context.height);
177
- await delay(context.settleMs);
178
- return ((await drain(browser)).filter((key) => !context.noise.has(key) && !isStyleOnly(key)).length > 0);
179
- }
180
- /**
181
- * Whether the page renders differently when it is *loaded* at each width.
182
- *
183
- * Frontend that reads the width once at mount and never re-renders shows
184
- * nothing at all to a resize sweep, so a clean sweep is not yet an answer. Two
185
- * loads and a DOM signature are, and they are cheap enough to be worth taking
186
- * whenever the sweep found nothing.
187
- */
188
- async function bootDiffers(browser, { min, max, height, settleMs, }) {
189
- try {
190
- await browser.resize(min, height);
191
- await browser.reload();
192
- await delay(settleMs * 6);
193
- const atMin = await browser.evaluate(SIGNATURE);
194
- await browser.resize(max, height);
195
- await browser.reload();
196
- await delay(settleMs * 6);
197
- const atMax = await browser.evaluate(SIGNATURE);
198
- return atMin !== atMax;
199
- }
200
- catch {
201
- // A reload that failed says nothing either way, and `null` is the only
202
- // honest answer for a check that did not happen.
203
- return null;
204
- }
205
- }
206
- function verdictFor({ breakpoints, unpinned, bootOnlyBranching, styleOnlySteps, steps, }) {
207
- const fluidNote = styleOnlySteps > 0
208
- ? ` Inline style alone changed at ${styleOnlySteps} of ${steps} widths — a fluid layout, which needs no variation, so it is not counted.`
209
- : "";
210
- if (breakpoints.length > 0) {
211
- const confirmed = breakpoints.filter((one) => one.confirmed);
212
- const more = unpinned.length > 0
213
- ? ` ${unpinned.length} more interval${unpinned.length === 1 ? "" : "s"} changed above ${breakpoints[breakpoints.length - 1].width}px and were not pinned; narrow --min/--max to look at them.`
214
- : "";
215
- return `${breakpoints.length} width${breakpoints.length === 1 ? "" : "s"} where the frontend re-renders (${confirmed.map((one) => `${one.width}px`).join(", ") || "none"} confirmed) — a snapshot captured on one side of these is wrong on the other.${more}${fluidNote}`;
216
- }
217
- if (bootOnlyBranching) {
218
- return `no resize breakpoint, but the page renders differently when loaded narrow and wide — the frontend branches once at mount, so a variation is still needed.${fluidNote}`;
219
- }
220
- if (bootOnlyBranching === false) {
221
- return `no breakpoint: the DOM is the same at every width and the same when loaded at either end. This is CSS-only responsiveness, so one snapshot serves every device.${fluidNote}`;
222
- }
223
- return `no resize breakpoint found, and the load comparison could not be taken.${fluidNote}`;
224
- }
225
- /** A change to inline style alone — what a fluid layout writes on every resize. */
226
- function isStyleOnly(key) {
227
- return key.endsWith(":attributes[style]");
228
- }
229
- /**
230
- * Layout changes that fire at most coarse steps: the page following the width
231
- * rather than crossing a threshold. Needs a few steps to say anything.
232
- */
233
- function fluidKeys(steps) {
234
- if (steps.length < 4) {
235
- return [];
236
- }
237
- const seen = new Map();
238
- for (const step of steps) {
239
- for (const key of new Set(step.layout)) {
240
- seen.set(key, (seen.get(key) ?? 0) + 1);
241
- }
242
- }
243
- const threshold = Math.ceil(steps.length * FLUID_SHARE);
244
- return [...seen]
245
- .filter(([, count]) => count >= threshold)
246
- .sort((a, b) => b[1] - a[1])
247
- .map(([key]) => key);
248
- }
249
- /**
250
- * A guess at what kind of change this is.
251
- *
252
- * Only ever a hint: the selectors are the evidence and this is a label for
253
- * skimming. Wrong labels are cheap here, missing evidence would not be.
254
- */
255
- function hintFor(changed) {
256
- const text = changed.join(" ").toLowerCase();
257
- for (const [needle, hint] of [
258
- ["hamburger", "hamburger menu"],
259
- ["burger", "hamburger menu"],
260
- ["drawer", "drawer navigation"],
261
- ["mobile", "mobile variant"],
262
- ["desktop", "desktop variant"],
263
- ["nav", "navigation"],
264
- ]) {
265
- if (text.includes(needle)) {
266
- return hint;
267
- }
268
- }
269
- return null;
270
- }
271
- /** Element count plus the classes of the first elements that carry any. */
272
- const SIGNATURE = `(function () {
273
- var classes = Array.prototype.slice
274
- .call(document.querySelectorAll("[class]"))
275
- .slice(0, 200)
276
- .map(function (element) { return String(element.className); })
277
- .join("|");
278
- return document.querySelectorAll("*").length + ":" + classes;
279
- })()`;
280
- /**
281
- * Install the observer, once per document.
282
- *
283
- * childList plus the two attributes a responsive frontend actually swaps. A
284
- * broader filter would drown the signal in style churn that no layout depends
285
- * on.
286
- */
287
- async function install(browser) {
288
- await browser.evaluate(`(function () {
289
- if (window.__sk_viewport) {
290
- window.__sk_viewport.keys = [];
291
- return true;
292
- }
293
-
294
- var state = { keys: [] };
295
- window.__sk_viewport = state;
296
-
297
- function describe(target) {
298
- if (!target || target.nodeType !== 1) return "node";
299
- return (
300
- target.tagName.toLowerCase() +
301
- (target.id ? "#" + target.id : "") +
302
- (target.className ? "." + String(target.className).trim().split(/\\s+/).slice(0, 2).join(".") : "")
303
- );
304
- }
305
-
306
- new MutationObserver(function (records) {
307
- for (var i = 0; i < records.length; i++) {
308
- var record = records[i];
309
- var key = describe(record.target) + ":" + record.type +
310
- (record.attributeName ? "[" + record.attributeName + "]" : "");
311
- if (state.keys.indexOf(key) === -1) state.keys.push(key);
312
- }
313
- }).observe(document.documentElement, {
314
- childList: true,
315
- subtree: true,
316
- attributes: true,
317
- attributeFilter: ["class", "style"]
318
- });
319
-
320
- return true;
321
- })()`);
322
- }
323
- /** Take what has accumulated and reset, so each step reports only its own. */
324
- async function drain(browser) {
325
- const serialized = await browser.evaluate(`(function () {
326
- var state = window.__sk_viewport;
327
- if (!state) return "[]";
328
- var keys = state.keys;
329
- state.keys = [];
330
- return JSON.stringify(keys);
331
- })()`);
332
- try {
333
- return JSON.parse(serialized ?? "[]");
334
- }
335
- catch {
336
- return [];
337
- }
338
- }
339
- function delay(ms) {
340
- return new Promise((resolve) => {
341
- const timer = setTimeout(resolve, ms);
342
- timer.unref();
343
- });
344
- }
@@ -1,26 +0,0 @@
1
- import { WatchData } from "./control-protocol.js";
2
- import { PreloadRegistry } from "./preload-registry.js";
3
- export interface WatchOptions {
4
- expression: string;
5
- intervalMs?: number;
6
- durationMs?: number;
7
- reload?: boolean;
8
- full?: boolean;
9
- }
10
- /**
11
- * Sample an expression across a navigation and report what it did.
12
- *
13
- * `tools/sk-watch.mjs` promoted. It exists because an intermittent or
14
- * good-then-broken symptom cannot be caught by a single evaluation — by the
15
- * time anyone can ask, the page is in whichever state it ended up in. A preload
16
- * samples from t=0 of the next load and survives the navigation, so the
17
- * question becomes "what did this value do" rather than "what is it now".
18
- *
19
- * Console messages and page exceptions are collected from inside the page
20
- * rather than over CDP. That keeps the whole capture in one buffer with one
21
- * clock, and it needs no subscription that would outlive the call. The cost is
22
- * real and worth stating: messages the *browser* emits rather than the page —
23
- * a CSP violation, a failed request — are not console calls and do not appear
24
- * here.
25
- */
26
- export declare function runWatch(preloads: PreloadRegistry, reload: () => Promise<void>, options: WatchOptions): Promise<WatchData>;