@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,234 @@
1
+ import { expect } from "chai";
2
+ import { afterEach, beforeEach, describe, it } from "mocha";
3
+ import { readFileSync } from "node:fs";
4
+ import { FILE_TYPE, } from "../../../integration-api/index.js";
5
+ import { TodoCollector } from "../../../onboarding/todo-collector.js";
6
+ import { RunFilesServiceFactory } from "../../files/run-files-service-factory.js";
7
+ import { LiveRunFixture, answer, failure, said, summary, } from "../live-run-fixture.js";
8
+ /** A file as the run holds it. `path` is absent for a virtual one, by design. */
9
+ function file(name, type, content, path) {
10
+ return {
11
+ name,
12
+ type,
13
+ getContent: () => content,
14
+ skipFile: () => undefined,
15
+ shouldSkipFile: () => false,
16
+ ...(path ? { path, isUpdated: () => false } : {}),
17
+ };
18
+ }
19
+ function fileList(files) {
20
+ return {
21
+ files,
22
+ hasFile: (name) => files.some((f) => f.name === name),
23
+ getByName: (name) => files.find((f) => f.name === name),
24
+ };
25
+ }
26
+ function resource(path, content) {
27
+ return {
28
+ path,
29
+ type: FILE_TYPE.CONFIG_FILE,
30
+ getContent: () => content,
31
+ };
32
+ }
33
+ /**
34
+ * The minified artifact a config change has to survive into — one line, and
35
+ * long enough on both sides of the match to prove a grep does not return it.
36
+ */
37
+ const BUNDLE = [
38
+ "var ".padEnd(600, "x"),
39
+ ";setAssetList([1,2]);",
40
+ "var ".padEnd(600, "z"),
41
+ ";",
42
+ ].join("");
43
+ describe("RunFilesService over the control socket", () => {
44
+ let fixture;
45
+ const filesOp = (op) => (sink, json) => op(new RunFilesServiceFactory(fixture.context(sink, json, {})).buildService());
46
+ const serve = (collaborators) => fixture.serve("example.com-production-live", collaborators);
47
+ beforeEach(() => {
48
+ fixture = new LiveRunFixture();
49
+ });
50
+ afterEach(() => fixture.close());
51
+ describe("list and read", () => {
52
+ beforeEach(() => serve({
53
+ files: fileList([
54
+ file("config_SpeedKit", FILE_TYPE.CONFIG_FILE, "module.exports = { appName: 'x' };", "/customers/example.com/production/config_SpeedKit.js"),
55
+ file("bundle_documentHandler", FILE_TYPE.VIRTUAL_FILE, BUNDLE),
56
+ ]),
57
+ }));
58
+ it("should name every file, and mark the ones with no file on disk", async () => {
59
+ const { files } = (await answer(filesOp((files) => files.list())));
60
+ expect(files.map((f) => f.name)).to.deep.equal([
61
+ "config_SpeedKit",
62
+ "bundle_documentHandler",
63
+ ]);
64
+ // A virtual file has no path, and the watcher skips it — "I edited it
65
+ // and nothing happened" has a legitimate cause, visible here.
66
+ expect(files[1].virtual).to.equal(true);
67
+ expect(files[1].path).to.equal(undefined);
68
+ expect(files[0].path).to.contain("config_SpeedKit.js");
69
+ });
70
+ it("should answer whether a change reached the bundle, without printing it", async () => {
71
+ const sink = await said(filesOp((files) => files.read({
72
+ name: "bundle_documentHandler",
73
+ grep: "setAssetList\\(",
74
+ })), true);
75
+ const raw = sink.payloads.join("");
76
+ const { file: read } = JSON.parse(raw);
77
+ expect(read.grep.count).to.equal(1);
78
+ expect(read.bytes).to.equal(BUNDLE.length);
79
+ // The bundle is one line, so "the matching line" would be the whole
80
+ // document — the grep returns a window around the hit instead, and the
81
+ // artifact keeps the rest.
82
+ expect(raw).to.not.contain(BUNDLE);
83
+ expect(raw.length).to.be.lessThan(BUNDLE.length);
84
+ expect(readFileSync(read.bodyPath, "utf8")).to.equal(BUNDLE);
85
+ // ...and it lands as .js, so it opens as what it is.
86
+ expect(read.bodyPath.endsWith(".js")).to.equal(true);
87
+ });
88
+ it("should report a missing match as zero, which is the answer", async () => {
89
+ const { file: read } = (await answer(filesOp((files) => files.read({
90
+ name: "bundle_documentHandler",
91
+ grep: "neverBuiltThis\\(",
92
+ }))));
93
+ expect(read.grep.count).to.equal(0);
94
+ });
95
+ it("should list what it does have when asked for a name it does not", async () => {
96
+ const failed = await failure(filesOp((files) => files.read({ name: "config_nonsense" })));
97
+ expect(failed.code).to.equal("NO_SUCH_FILE");
98
+ // The useful part of this failure is what does exist.
99
+ expect(failed.detail.available).to.deep.equal([
100
+ "config_SpeedKit",
101
+ "bundle_documentHandler",
102
+ ]);
103
+ });
104
+ });
105
+ describe("rebuild and validate", () => {
106
+ // The blast radius is the part a caller cannot infer, and the part that
107
+ // decides whether the measurement they took a minute ago still stands.
108
+ it("should say what a documentHandler rebuild invalidated", async () => {
109
+ await serve({
110
+ rebuild: async () => [
111
+ {
112
+ target: "documentHandler",
113
+ did: ["rebuilt the local documentHandler", "cleared the dh-cache"],
114
+ },
115
+ ],
116
+ });
117
+ const body = await answer(filesOp((files) => files.rebuild("documentHandler")));
118
+ const line = await summary(filesOp((files) => files.rebuild("documentHandler")));
119
+ expect(body.cacheCleared).to.equal(true);
120
+ expect(body.reinstallsServiceWorker).to.equal(false);
121
+ expect(line).to.contain("dh-cache emptied");
122
+ });
123
+ it("should say an install rebuild arms a service-worker reinstall", async () => {
124
+ await serve({
125
+ rebuild: async () => [
126
+ { target: "install", did: ["rebuilt the install resource"] },
127
+ ],
128
+ });
129
+ const body = await answer(filesOp((files) => files.rebuild("install")));
130
+ expect(body.reinstallsServiceWorker).to.equal(true);
131
+ expect(body.cacheCleared).to.equal(false);
132
+ });
133
+ it("should refuse a rebuild on a run that has not wired its watchers", async () => {
134
+ await serve({});
135
+ const failed = await failure(filesOp((files) => files.rebuild()));
136
+ expect(failed.code).to.equal("NO_REBUILD");
137
+ });
138
+ it("should report a clean config as valid", async () => {
139
+ await serve({ validate: () => [] });
140
+ const body = await answer(filesOp((files) => files.validate()));
141
+ expect(body.valid).to.equal(true);
142
+ expect(body.problems).to.deep.equal([]);
143
+ });
144
+ // Both validators throw at their first problem, so a failing answer is a
145
+ // lower bound. Saying so is the difference between "one fix away" and "at
146
+ // least one fix away".
147
+ it("should carry a validator's own suggestions, and say it stops at the first", async () => {
148
+ await serve({
149
+ validate: () => [
150
+ {
151
+ validator: "mandatoryFiles",
152
+ message: 'Mandatory file "config_customer" is missing',
153
+ code: "MANDATORY_CONFIG_FILE_IS_MISSING",
154
+ suggestions: ["Add file config_customer to config"],
155
+ },
156
+ ],
157
+ });
158
+ const body = await answer(filesOp((files) => files.validate()));
159
+ const sink = await said(filesOp((files) => files.validate()), false);
160
+ expect(body.valid).to.equal(false);
161
+ expect(body.firstProblemPerValidator).to.equal(true);
162
+ expect(body.problems[0].suggestions).to.deep.equal(["Add file config_customer to config"]);
163
+ expect(sink.lines[0]).to.contain("may be more");
164
+ expect(sink.lines.join("\n")).to.contain("Add file config_customer to config");
165
+ });
166
+ });
167
+ describe("todo", () => {
168
+ it("should return every task with the file and line to open", async () => {
169
+ await serve({
170
+ todos: new TodoCollector([
171
+ resource("/customers/example.com/production/config_SpeedKit.js", [
172
+ "const config = {",
173
+ "// TODO ask about the split test id",
174
+ "one",
175
+ "two",
176
+ "three",
177
+ "// TODO confirm stripQueryParams with the customer",
178
+ "four",
179
+ "five",
180
+ "six",
181
+ ].join("\n")),
182
+ ]),
183
+ });
184
+ const { tasks } = (await answer(filesOp((files) => files.todo())));
185
+ expect(tasks).to.have.lengthOf(2);
186
+ expect(tasks[0].todo).to.equal("TODO ask about the split test id");
187
+ expect(tasks[0].file).to.equal("/customers/example.com/production/config_SpeedKit.js");
188
+ expect(tasks[1].line).to.be.greaterThan(tasks[0].line);
189
+ });
190
+ it("should hand back readable context, not percent-escapes", async () => {
191
+ // The collector encodes it for the devtools panel's transport. Passing
192
+ // that on would be a small lie about what is in the file.
193
+ await serve({
194
+ todos: new TodoCollector([
195
+ resource("/customers/example.com/production/config_documentHandler.js", [
196
+ "// TODO check",
197
+ "const a = {b: 1};",
198
+ "second line",
199
+ "third line",
200
+ ].join("\n")),
201
+ ]),
202
+ });
203
+ const [task] = (await answer(filesOp((files) => files.todo()))).tasks;
204
+ expect(task.context).to.contain("const a = {b: 1};");
205
+ expect(task.context).to.not.contain("%20");
206
+ });
207
+ it("should name the files rather than only counting", async () => {
208
+ // "4 open tasks" answers nothing: one file with four notes is a
209
+ // different situation from four files with one each.
210
+ await serve({
211
+ todos: new TodoCollector([
212
+ resource("/customers/example.com/production/config_SpeedKit.js", ["// TODO one", "a", "b", "c"].join("\n")),
213
+ resource("/customers/example.com/production/config_documentHandler.js", ["// TODO two", "a", "b", "c"].join("\n")),
214
+ ]),
215
+ });
216
+ expect(await summary(filesOp((files) => files.todo()))).to.equal("2 open tasks in config_SpeedKit.js, config_documentHandler.js");
217
+ });
218
+ it("should say plainly when there is nothing open", async () => {
219
+ await serve({
220
+ todos: new TodoCollector([
221
+ resource("/customers/example.com/production/config_SpeedKit.js", "const config = {};\n"),
222
+ ]),
223
+ });
224
+ expect(await summary(filesOp((files) => files.todo()))).to.equal("no open tasks in this config");
225
+ });
226
+ it("should answer an empty list rather than fail when nothing collects", async () => {
227
+ // A run older than this op has no collector wired to its socket. An
228
+ // empty list is the honest answer; a crash would read as "this config is
229
+ // broken".
230
+ await serve({});
231
+ expect((await answer(filesOp((files) => files.todo()))).tasks).to.deep.equal([]);
232
+ });
233
+ });
234
+ });
@@ -0,0 +1,251 @@
1
+ import { expect } from "chai";
2
+ import { afterEach, beforeEach, describe, it } from "mocha";
3
+ import { MemorySink } from "../../../cli/index.js";
4
+ import { memoryCli } from "../../../cli/spec/memory-cli.js";
5
+ import { ServiceWorkerTracker } from "../../../onboarding/control/service-worker-tracker.js";
6
+ import { PreloadRegistry, } from "../../../onboarding/control/preload-registry.js";
7
+ import { DebugSession } from "../../../onboarding/control/debug-session.js";
8
+ import { inertBrowserCapabilities, inertBrowserTransport, } from "../../../onboarding/spec/control/fakes.js";
9
+ import { RunInjectServiceFactory } from "../../inject/run-inject-service-factory.js";
10
+ import { LiveRunFixture, answer, failure, said, summary, } from "../live-run-fixture.js";
11
+ /** A page that accepts registrations and can be given a buffer to report. */
12
+ class FakePage {
13
+ pageAvailable = true;
14
+ added = [];
15
+ slots = null;
16
+ counter = 0;
17
+ async addScript(source) {
18
+ this.added.push(source);
19
+ this.counter += 1;
20
+ return `cdp-${this.counter}`;
21
+ }
22
+ async removeScript() {
23
+ // Nothing to unregister on a fake; what matters here is the hop.
24
+ return undefined;
25
+ }
26
+ async evaluate(expression) {
27
+ if (expression.startsWith("JSON.stringify(window.__sk_inject")) {
28
+ return (this.slots ? JSON.stringify(this.slots) : null);
29
+ }
30
+ return undefined;
31
+ }
32
+ }
33
+ class FakeBrowser {
34
+ serviceWorkers = new ServiceWorkerTracker();
35
+ page = new FakePage();
36
+ preloads = new PreloadRegistry(this.page);
37
+ debug = new DebugSession(inertBrowserTransport(), this.preloads);
38
+ available = true;
39
+ rest = inertBrowserCapabilities();
40
+ resize = this.rest.resize;
41
+ clearResize = this.rest.clearResize;
42
+ collectDocumentRequests = this.rest.collectDocumentRequests;
43
+ reload = this.rest.reload;
44
+ emulate = this.rest.emulate;
45
+ screenshot = this.rest.screenshot;
46
+ tabs = this.rest.tabs;
47
+ click = this.rest.click;
48
+ rawCdp = this.rest.rawCdp;
49
+ async tab() {
50
+ return this;
51
+ }
52
+ url() {
53
+ return "https://shop.example.com/p";
54
+ }
55
+ async evaluate() {
56
+ throw new Error("not used here");
57
+ }
58
+ async state() {
59
+ return {
60
+ url: this.url(),
61
+ serviceWorkers: this.serviceWorkers.state(this.url()),
62
+ };
63
+ }
64
+ async reset(scope) {
65
+ return { url: this.url(), did: `reset ${scope}` };
66
+ }
67
+ async reinstallServiceWorker() {
68
+ return { url: this.url(), did: "reinstalled" };
69
+ }
70
+ async navigate(url) {
71
+ return { url, did: `navigated to ${url}` };
72
+ }
73
+ async showPanel() {
74
+ return { url: null, did: "showed the panel" };
75
+ }
76
+ }
77
+ describe("RunInjectService over the control socket", () => {
78
+ let fixture;
79
+ let browser;
80
+ /** What the run itself printed — its terminal, not the command's. */
81
+ let runOutput;
82
+ /** One op, built the way its command builds it. */
83
+ const injectOp = (op) => (sink, json) => op(new RunInjectServiceFactory(fixture.context(sink, json, {})).buildService());
84
+ const add = (input) => said(injectOp((inject) => inject.add(input)), true);
85
+ beforeEach(async () => {
86
+ fixture = new LiveRunFixture();
87
+ browser = new FakeBrowser();
88
+ runOutput = new MemorySink();
89
+ await fixture.serve("example.com-production-live", {
90
+ session: browser,
91
+ cli: memoryCli(runOutput),
92
+ });
93
+ });
94
+ afterEach(() => fixture.close());
95
+ it("should name the recipes and what each one takes", async () => {
96
+ const line = await summary(injectOp((inject) => inject.recipes()));
97
+ const { recipes } = (await answer(injectOp((inject) => inject.recipes())));
98
+ expect(line).to.contain("spy");
99
+ expect(recipes.map((recipe) => recipe.name)).to.contain("mark-timeline");
100
+ });
101
+ it("should put an injection on the run's own output", async () => {
102
+ // The guardrail that matters most. Everything else done through the socket
103
+ // is visible in what it changes; an injected script is visible in nothing,
104
+ // and the human watching the run's terminal is the only one who can catch
105
+ // it.
106
+ await add({ recipe: "spy", param: ["path=dataLayer.push"] });
107
+ const announced = runOutput.lines.filter((line) => line.includes("injected"));
108
+ expect(announced).to.have.length(1);
109
+ expect(announced[0]).to.contain("p1");
110
+ expect(announced[0]).to.contain("recipe");
111
+ });
112
+ it("should tell a caller to reload when the recipe needs one", async () => {
113
+ // A caller that adds `mark-timeline` and reads it straight away gets an
114
+ // empty buffer and concludes the marks are never emitted.
115
+ const line = await summary(injectOp((inject) => inject.add({ recipe: "mark-timeline" })));
116
+ expect(line).to.contain("NEXT navigation");
117
+ });
118
+ it("should separate a script that has not run from one that saw nothing", async () => {
119
+ await add({ recipe: "mark-timeline" });
120
+ const beforeNavigation = await summary(injectOp((inject) => inject.read("p1")));
121
+ browser.page.slots = { p1: { records: [], dropped: 0 } };
122
+ const afterNavigation = await summary(injectOp((inject) => inject.read("p1")));
123
+ expect(beforeNavigation).to.contain("navigate or reload");
124
+ expect(afterNavigation).to.contain("0 records");
125
+ });
126
+ it("should report what a buffer holds, newest last", async () => {
127
+ await add({ source: "record(1)" });
128
+ browser.page.slots = {
129
+ p1: {
130
+ records: [
131
+ { t: 1, v: "a" },
132
+ { t: 2, v: "b" },
133
+ ],
134
+ dropped: 3,
135
+ },
136
+ };
137
+ const data = (await answer(injectOp((inject) => inject.read("p1"))));
138
+ const line = await summary(injectOp((inject) => inject.read("p1")));
139
+ expect(data.records.map((record) => record.v)).to.deep.equal(["a", "b"]);
140
+ expect(line).to.contain("3 of the oldest dropped");
141
+ });
142
+ it("should name the preload ids when a read names none", async () => {
143
+ await add({ source: "record(1)" });
144
+ await add({ recipe: "mark-timeline" });
145
+ const failed = await failure(injectOp((inject) => inject.read(undefined)));
146
+ expect(failed.code).to.equal("PRELOAD_REQUIRED");
147
+ expect(failed.message).to.contain("p1, p2");
148
+ expect(failed.detail.preloads).to.deep.equal(["p1", "p2"]);
149
+ });
150
+ it("should read a param as JSON when it parses, and as a string otherwise", async () => {
151
+ await add({
152
+ recipe: "sample",
153
+ param: ["expression=document.title", "intervalMs=50"],
154
+ });
155
+ // The recipe renders its params into the source: a number stays a number,
156
+ // and an expression that is not JSON arrives as the text it was.
157
+ const [source] = browser.page.added;
158
+ expect(source).to.contain("50");
159
+ expect(source).to.not.contain('"50"');
160
+ expect(source).to.contain("document.title");
161
+ });
162
+ it("should refuse a param that is not name=value, before the hop", async () => {
163
+ const failed = await failure(injectOp((inject) => inject.add({ recipe: "spy", param: ["path"] })));
164
+ expect(failed.code).to.equal("BAD_PARAM");
165
+ expect(browser.page.added).to.deep.equal([]);
166
+ });
167
+ it("should hand back the recipes when asked for one that does not exist", async () => {
168
+ const failed = await failure(injectOp((inject) => inject.add({ recipe: "spie" })));
169
+ expect(failed.code).to.equal("UNKNOWN_RECIPE");
170
+ expect(failed.detail.recipes).to.contain("spy");
171
+ });
172
+ it("should refuse a recipe and raw source together", async () => {
173
+ const failed = await failure(injectOp((inject) => inject.add({ recipe: "mark-timeline", source: "record(1)" })));
174
+ expect(failed.code).to.equal("INJECT_SOURCE_REQUIRED");
175
+ });
176
+ it("should list what is injected, and say what expired", async () => {
177
+ await add({ source: "record(1)" });
178
+ await add({ recipe: "spy", param: ["path=a.b"] });
179
+ const line = await summary(injectOp((inject) => inject.list()));
180
+ const data = (await answer(injectOp((inject) => inject.list())));
181
+ expect(line).to.contain("2/8 injected");
182
+ expect(data.preloads).to.have.length(2);
183
+ });
184
+ it("should say which half of a removal happened", async () => {
185
+ // Unregistering stops the next document; the copy already running had to
186
+ // be switched off through the page. A spy that kept recording after it was
187
+ // removed is the failure this line exists to rule out.
188
+ await add({ source: "record(1)" });
189
+ const sink = await said(injectOp((inject) => inject.remove("p1")), false);
190
+ expect(sink.lines[0]).to.contain("switched off");
191
+ expect(sink.lines[0]).to.contain("0 left");
192
+ });
193
+ it("should refuse a run whose browser is gone", async () => {
194
+ await fixture.close();
195
+ fixture = new LiveRunFixture();
196
+ fixture.writeRun({ id: "gone.com-production-dead" });
197
+ const failed = await failure(injectOp((inject) => inject.list()));
198
+ expect(failed.code).to.equal("NO_LIVE_RUN");
199
+ });
200
+ it("should offer web vitals as a recipe that needs no reload", async () => {
201
+ // Buffered observers deliver what happened before they were added, so the
202
+ // load that is already on screen is readable straight away.
203
+ const { recipes } = (await answer(injectOp((inject) => inject.recipes())));
204
+ const vitals = recipes.find((recipe) => recipe.name === "web-vitals");
205
+ expect(vitals?.needsReload).to.equal(false);
206
+ await add({ recipe: "web-vitals" });
207
+ const [source] = browser.page.added;
208
+ expect(source).to.contain("largest-contentful-paint");
209
+ expect(source).to.contain("buffered: true");
210
+ });
211
+ it("should say a painted load without a layout shift has a CLS of 0", async () => {
212
+ // The browser reports no layout-shift entry when nothing shifted, so an
213
+ // absent CLS record is a CLS of 0, not a metric left unmeasured.
214
+ await add({ recipe: "web-vitals" });
215
+ browser.page.slots = {
216
+ p1: {
217
+ records: [
218
+ { t: 1, v: { metric: "fcp", value: 300 }, load: "1700" },
219
+ { t: 2, v: { metric: "lcp", value: 500 }, load: "1700" },
220
+ { t: 3, v: { metric: "fcp", value: 280 }, load: "1800" },
221
+ { t: 4, v: { metric: "cls", value: 0.1, total: 0.1 }, load: "1800" },
222
+ ],
223
+ dropped: 0,
224
+ },
225
+ };
226
+ const line = await summary(injectOp((inject) => inject.read("p1")));
227
+ expect(line).to.contain("load 1700 had no layout shift: CLS 0 so far");
228
+ expect(line).to.not.contain("load 1800 had no layout shift");
229
+ });
230
+ it("should say a load that painted nothing has no LCP to measure", async () => {
231
+ // A window the compositor does not draw paints nothing; "no LCP" there
232
+ // is an absence, not a measurement.
233
+ await add({ recipe: "web-vitals" });
234
+ browser.page.slots = {
235
+ p1: {
236
+ records: [
237
+ {
238
+ t: 1,
239
+ v: { metric: "page", visibility: "hidden", focused: false },
240
+ load: "1700",
241
+ },
242
+ { t: 130, v: { metric: "ttfb", value: 120 }, load: "1700" },
243
+ ],
244
+ dropped: 0,
245
+ },
246
+ };
247
+ const line = await summary(injectOp((inject) => inject.read("p1")));
248
+ expect(line).to.contain("load 1700 painted nothing yet");
249
+ expect(line).to.contain("hidden and unfocused");
250
+ });
251
+ });
@@ -0,0 +1,32 @@
1
+ import { MemorySink } from "../../cli/index.js";
2
+ import { ControlServerCollaborators } from "../../onboarding/control/control-server.js";
3
+ import { RunMeta } from "../../run-registry/run-registry-model.js";
4
+ import { ControlError } from "../control-client.js";
5
+ import { RunControlBuildContext } from "../run-control-context.js";
6
+ /**
7
+ * A run registry in a temp dir, with runs that are live — a real ControlServer
8
+ * on a real socket — or finished.
9
+ *
10
+ * What the specs exercise is the whole hop: a factory resolves the run, the
11
+ * service connects, handshakes and asks. Only the browser behind the server is
12
+ * ever faked.
13
+ */
14
+ export declare class LiveRunFixture {
15
+ readonly cacheDirectory: string;
16
+ private readonly servers;
17
+ /** Records a run in the registry without serving it. Finished by default. */
18
+ writeRun(meta: Partial<RunMeta> & Pick<RunMeta, "id">): string;
19
+ /** A live run, claimed by this process, whose socket is being served. */
20
+ serve(id: string, collaborators?: Partial<ControlServerCollaborators>): Promise<string>;
21
+ /** The build context a command would hand its factory. */
22
+ context<Input>(sink: MemorySink, json: boolean, input: Input): RunControlBuildContext<Input>;
23
+ close(): Promise<void>;
24
+ }
25
+ /** What a run-control op said, captured. */
26
+ export declare function said(op: (sink: MemorySink, json: boolean) => Promise<void>, json: boolean): Promise<MemorySink>;
27
+ /** What `--json` prints, checking nothing else reached stdout. */
28
+ export declare function answer(op: (sink: MemorySink, json: boolean) => Promise<void>): Promise<Record<string, unknown>>;
29
+ /** The summary line a person reads first. */
30
+ export declare function summary(op: (sink: MemorySink, json: boolean) => Promise<void>): Promise<string>;
31
+ /** How the op fails, as the command would report it. */
32
+ export declare function failure(op: (sink: MemorySink, json: boolean) => Promise<void>): Promise<ControlError>;
@@ -0,0 +1,109 @@
1
+ import { expect } from "chai";
2
+ import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+ import { MemorySink } from "../../cli/index.js";
6
+ import { memoryCli } from "../../cli/spec/memory-cli.js";
7
+ import { Cache } from "../../onboarding/request-cache/cache.js";
8
+ import { ControlServer, } from "../../onboarding/control/control-server.js";
9
+ import { META_FILE } from "../../run-registry/run-registry-model.js";
10
+ import { processStartToken } from "../../run-registry/process-identity.js";
11
+ import { ControlError } from "../control-client.js";
12
+ const DEAD_PID = 2_147_483_646;
13
+ /**
14
+ * A run registry in a temp dir, with runs that are live — a real ControlServer
15
+ * on a real socket — or finished.
16
+ *
17
+ * What the specs exercise is the whole hop: a factory resolves the run, the
18
+ * service connects, handshakes and asks. Only the browser behind the server is
19
+ * ever faked.
20
+ */
21
+ export class LiveRunFixture {
22
+ cacheDirectory = mkdtempSync(join(tmpdir(), "sk-run-control-"));
23
+ servers = [];
24
+ /** Records a run in the registry without serving it. Finished by default. */
25
+ writeRun(meta) {
26
+ const full = {
27
+ customer: "example.com",
28
+ customerPath: "customers/example.com",
29
+ configName: "production",
30
+ pid: DEAD_PID,
31
+ startedAt: new Date().toISOString(),
32
+ status: "finished",
33
+ flags: {
34
+ local: true,
35
+ headless: false,
36
+ useTestConfig: false,
37
+ ignoreContentSecurityPolicy: false,
38
+ },
39
+ cliVersion: "0.0.0",
40
+ ...meta,
41
+ };
42
+ const dir = join(this.cacheDirectory, "runs", full.id);
43
+ mkdirSync(dir, { recursive: true });
44
+ writeFileSync(join(dir, META_FILE), JSON.stringify(full));
45
+ return dir;
46
+ }
47
+ /** A live run, claimed by this process, whose socket is being served. */
48
+ async serve(id, collaborators = {}) {
49
+ const dir = this.writeRun({
50
+ id,
51
+ status: "running",
52
+ pid: process.pid,
53
+ startToken: processStartToken(process.pid) ?? undefined,
54
+ });
55
+ const server = new ControlServer(dir, id, {
56
+ cache: new Cache(memoryCli(), join(dir, "dh-cache")),
57
+ cli: memoryCli(),
58
+ files: { files: [] },
59
+ ...collaborators,
60
+ });
61
+ const stop = new AbortController();
62
+ await server.listen(stop.signal);
63
+ this.servers.push({ server, stop });
64
+ return dir;
65
+ }
66
+ /** The build context a command would hand its factory. */
67
+ context(sink, json, input) {
68
+ const environment = {
69
+ cli: memoryCli(sink),
70
+ cacheDir: this.cacheDirectory,
71
+ };
72
+ return { environment, json, input };
73
+ }
74
+ async close() {
75
+ for (const { server, stop } of this.servers) {
76
+ stop.abort();
77
+ await server.close();
78
+ }
79
+ rmSync(this.cacheDirectory, { recursive: true, force: true });
80
+ }
81
+ }
82
+ /** What a run-control op said, captured. */
83
+ export async function said(op, json) {
84
+ const sink = new MemorySink();
85
+ await op(sink, json);
86
+ return sink;
87
+ }
88
+ /** What `--json` prints, checking nothing else reached stdout. */
89
+ export async function answer(op) {
90
+ const sink = await said(op, true);
91
+ expect(sink.lines, "nothing but the document on stdout").to.deep.equal([]);
92
+ return JSON.parse(sink.payloads.join(""));
93
+ }
94
+ /** The summary line a person reads first. */
95
+ export async function summary(op) {
96
+ return (await said(op, false)).lines[0];
97
+ }
98
+ /** How the op fails, as the command would report it. */
99
+ export async function failure(op) {
100
+ try {
101
+ await said(op, true);
102
+ }
103
+ catch (error) {
104
+ const failed = ControlError.from(error);
105
+ expect(failed, String(error)).to.be.instanceOf(ControlError);
106
+ return failed;
107
+ }
108
+ expect.fail("the op should have failed");
109
+ }