@speedkit/cli 4.51.0 → 4.52.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (441) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/README.md +1426 -14
  3. package/dist/base/run-control-command.d.ts +15 -0
  4. package/dist/base/run-control-command.js +20 -0
  5. package/dist/build-info.json +6 -0
  6. package/dist/commands/diff.d.ts +7 -1
  7. package/dist/commands/diff.js +9 -3
  8. package/dist/commands/login.d.ts +3 -0
  9. package/dist/commands/login.js +14 -3
  10. package/dist/commands/onboarding/browser/click.d.ts +75 -0
  11. package/dist/commands/onboarding/browser/click.js +19 -0
  12. package/dist/commands/onboarding/browser/emulate.d.ts +105 -0
  13. package/dist/commands/onboarding/browser/emulate.js +26 -0
  14. package/dist/commands/onboarding/browser/navigate.d.ts +75 -0
  15. package/dist/commands/onboarding/browser/navigate.js +19 -0
  16. package/dist/commands/onboarding/browser/panel.d.ts +63 -0
  17. package/dist/commands/onboarding/browser/panel.js +12 -0
  18. package/dist/commands/onboarding/browser/reinstall-sw.d.ts +63 -0
  19. package/dist/commands/onboarding/browser/reinstall-sw.js +14 -0
  20. package/dist/commands/onboarding/browser/reset.d.ts +71 -0
  21. package/dist/commands/onboarding/browser/reset.js +18 -0
  22. package/dist/commands/onboarding/browser/screenshot.d.ts +77 -0
  23. package/dist/commands/onboarding/browser/screenshot.js +19 -0
  24. package/dist/commands/onboarding/browser/state.d.ts +63 -0
  25. package/dist/commands/onboarding/browser/state.js +12 -0
  26. package/dist/commands/onboarding/browser/tabs.d.ts +58 -0
  27. package/dist/commands/onboarding/browser/tabs.js +16 -0
  28. package/dist/commands/onboarding/cache/clear.d.ts +58 -0
  29. package/dist/commands/onboarding/cache/clear.js +12 -0
  30. package/dist/commands/onboarding/cache/errors.d.ts +58 -0
  31. package/dist/commands/onboarding/cache/errors.js +12 -0
  32. package/dist/commands/onboarding/cache/evict.d.ts +62 -0
  33. package/dist/commands/onboarding/cache/evict.js +15 -0
  34. package/dist/commands/onboarding/cache/get.d.ts +85 -0
  35. package/dist/commands/onboarding/cache/get.js +17 -0
  36. package/dist/commands/onboarding/cache/list.d.ts +58 -0
  37. package/dist/commands/onboarding/cache/list.js +15 -0
  38. package/dist/commands/onboarding/cache/prewarm.d.ts +73 -0
  39. package/dist/commands/onboarding/cache/prewarm.js +20 -0
  40. package/dist/commands/onboarding/cache/refresh.d.ts +62 -0
  41. package/dist/commands/onboarding/cache/refresh.js +18 -0
  42. package/dist/commands/onboarding/cdp.d.ts +81 -0
  43. package/dist/commands/onboarding/cdp.js +18 -0
  44. package/dist/commands/onboarding/debug/arm.d.ts +83 -0
  45. package/dist/commands/onboarding/debug/arm.js +19 -0
  46. package/dist/commands/onboarding/debug/await.d.ts +71 -0
  47. package/dist/commands/onboarding/debug/await.js +18 -0
  48. package/dist/commands/onboarding/debug/disarm.d.ts +63 -0
  49. package/dist/commands/onboarding/debug/disarm.js +12 -0
  50. package/dist/commands/onboarding/debug/eval.d.ts +75 -0
  51. package/dist/commands/onboarding/debug/eval.js +16 -0
  52. package/dist/commands/onboarding/debug/release.d.ts +63 -0
  53. package/dist/commands/onboarding/debug/release.js +12 -0
  54. package/dist/commands/onboarding/debug/resume.d.ts +63 -0
  55. package/dist/commands/onboarding/debug/resume.js +12 -0
  56. package/dist/commands/onboarding/debug/status.d.ts +63 -0
  57. package/dist/commands/onboarding/debug/status.js +12 -0
  58. package/dist/commands/onboarding/debug/step.d.ts +67 -0
  59. package/dist/commands/onboarding/debug/step.js +15 -0
  60. package/dist/commands/onboarding/files/list.d.ts +58 -0
  61. package/dist/commands/onboarding/files/list.js +12 -0
  62. package/dist/commands/onboarding/files/read.d.ts +73 -0
  63. package/dist/commands/onboarding/files/read.js +16 -0
  64. package/dist/commands/onboarding/files/rebuild.d.ts +63 -0
  65. package/dist/commands/onboarding/files/rebuild.js +18 -0
  66. package/dist/commands/onboarding/files/validate.d.ts +58 -0
  67. package/dist/commands/onboarding/files/validate.js +12 -0
  68. package/dist/commands/onboarding/fouc.d.ts +77 -0
  69. package/dist/commands/onboarding/fouc.js +16 -0
  70. package/dist/commands/onboarding/inject/add.d.ts +89 -0
  71. package/dist/commands/onboarding/inject/add.js +17 -0
  72. package/dist/commands/onboarding/inject/clear.d.ts +63 -0
  73. package/dist/commands/onboarding/inject/clear.js +12 -0
  74. package/dist/commands/onboarding/inject/list.d.ts +63 -0
  75. package/dist/commands/onboarding/inject/list.js +12 -0
  76. package/dist/commands/onboarding/inject/read.d.ts +75 -0
  77. package/dist/commands/onboarding/inject/read.js +18 -0
  78. package/dist/commands/onboarding/inject/recipes.d.ts +63 -0
  79. package/dist/commands/onboarding/inject/recipes.js +12 -0
  80. package/dist/commands/onboarding/inject/remove.d.ts +67 -0
  81. package/dist/commands/onboarding/inject/remove.js +15 -0
  82. package/dist/commands/onboarding/list.d.ts +13 -0
  83. package/dist/commands/onboarding/list.js +12 -0
  84. package/dist/commands/onboarding/logs.d.ts +41 -0
  85. package/dist/commands/onboarding/logs.js +257 -0
  86. package/dist/commands/onboarding/navwalk.d.ts +95 -0
  87. package/dist/commands/onboarding/navwalk.js +19 -0
  88. package/dist/commands/onboarding/response.d.ts +67 -0
  89. package/dist/commands/onboarding/response.js +18 -0
  90. package/dist/commands/onboarding/rum/beacons.d.ts +75 -0
  91. package/dist/commands/onboarding/rum/beacons.js +16 -0
  92. package/dist/commands/onboarding/rum/get.d.ts +77 -0
  93. package/dist/commands/onboarding/rum/get.js +18 -0
  94. package/dist/commands/onboarding/rum/key.d.ts +67 -0
  95. package/dist/commands/onboarding/rum/key.js +13 -0
  96. package/dist/commands/onboarding/rum/previous.d.ts +63 -0
  97. package/dist/commands/onboarding/rum/previous.js +12 -0
  98. package/dist/commands/onboarding/status.d.ts +13 -0
  99. package/dist/commands/onboarding/status.js +17 -0
  100. package/dist/commands/onboarding/stop.d.ts +13 -0
  101. package/dist/commands/onboarding/stop.js +17 -0
  102. package/dist/commands/onboarding/todo.d.ts +58 -0
  103. package/dist/commands/onboarding/todo.js +12 -0
  104. package/dist/commands/onboarding/viewport.d.ts +101 -0
  105. package/dist/commands/onboarding/viewport.js +18 -0
  106. package/dist/commands/onboarding/watch.d.ts +93 -0
  107. package/dist/commands/onboarding/watch.js +16 -0
  108. package/dist/commands/onboarding.d.ts +26 -0
  109. package/dist/commands/onboarding.js +221 -4
  110. package/dist/commands/origin-request.d.ts +4 -0
  111. package/dist/commands/origin-request.js +4 -0
  112. package/dist/commands/spec/onboarding.spec.d.ts +1 -0
  113. package/dist/commands/spec/onboarding.spec.js +127 -0
  114. package/dist/services/browser-fetch/device-emulation.d.ts +11 -0
  115. package/dist/services/browser-fetch/device-emulation.js +14 -0
  116. package/dist/services/cli/build-info.d.ts +33 -0
  117. package/dist/services/cli/build-info.js +63 -0
  118. package/dist/services/cli/cli-environment-factory.d.ts +3 -0
  119. package/dist/services/cli/cli-environment-factory.js +1 -0
  120. package/dist/services/cli/cli-service-build-context.d.ts +3 -0
  121. package/dist/services/cli/cli-service-factory.js +1 -1
  122. package/dist/services/cli/cli-service-model.d.ts +29 -10
  123. package/dist/services/cli/cli-service.d.ts +60 -11
  124. package/dist/services/cli/cli-service.js +196 -32
  125. package/dist/services/cli/index.d.ts +2 -0
  126. package/dist/services/cli/index.js +2 -0
  127. package/dist/services/cli/sink.d.ts +47 -0
  128. package/dist/services/cli/sink.js +31 -0
  129. package/dist/services/cli/spec/build-identity.spec.d.ts +1 -0
  130. package/dist/services/cli/spec/build-identity.spec.js +85 -0
  131. package/dist/services/cli/spec/build-info.spec.d.ts +1 -0
  132. package/dist/services/cli/spec/build-info.spec.js +10 -0
  133. package/dist/services/cli/spec/cli-service-log.spec.d.ts +1 -0
  134. package/dist/services/cli/spec/cli-service-log.spec.js +133 -0
  135. package/dist/services/cli/spec/cli-service.spec.js +113 -50
  136. package/dist/services/cli/spec/memory-cli.d.ts +9 -0
  137. package/dist/services/cli/spec/memory-cli.js +9 -0
  138. package/dist/services/diff/config-at-ref.d.ts +20 -0
  139. package/dist/services/diff/config-at-ref.js +33 -0
  140. package/dist/services/diff/diff-service-build-context.d.ts +12 -0
  141. package/dist/services/diff/diff-service-build-context.js +45 -1
  142. package/dist/services/diff/diff-service-factory.d.ts +2 -0
  143. package/dist/services/diff/diff-service-factory.js +65 -25
  144. package/dist/services/diff/diff-service.d.ts +11 -0
  145. package/dist/services/diff/diff-service.js +37 -11
  146. package/dist/services/diff/page-source.d.ts +12 -0
  147. package/dist/services/diff/page-source.js +16 -11
  148. package/dist/services/diff/run-runtime-config.d.ts +33 -0
  149. package/dist/services/diff/run-runtime-config.js +74 -0
  150. package/dist/services/diff/sinks/tool-diff-sink.d.ts +3 -2
  151. package/dist/services/diff/sinks/tool-diff-sink.js +3 -2
  152. package/dist/services/diff/spec/config-at-ref.spec.d.ts +1 -0
  153. package/dist/services/diff/spec/config-at-ref.spec.js +46 -0
  154. package/dist/services/diff/spec/diff-service-build-context.spec.js +19 -0
  155. package/dist/services/diff/spec/diff-service.spec.js +95 -0
  156. package/dist/services/diff/spec/run-runtime-config.spec.d.ts +1 -0
  157. package/dist/services/diff/spec/run-runtime-config.spec.js +87 -0
  158. package/dist/services/git/git-repository.d.ts +2 -0
  159. package/dist/services/git/git-repository.js +6 -0
  160. package/dist/services/integration-api/customer-config-flags.js +1 -0
  161. package/dist/services/onboarding/browse/browse-service.d.ts +13 -1
  162. package/dist/services/onboarding/browse/browse-service.js +43 -7
  163. package/dist/services/onboarding/browser/answer-dialogs.d.ts +12 -0
  164. package/dist/services/onboarding/browser/answer-dialogs.js +25 -0
  165. package/dist/services/onboarding/browser/baqend-response.d.ts +17 -1
  166. package/dist/services/onboarding/browser/baqend-response.js +23 -0
  167. package/dist/services/onboarding/browser/console-log.d.ts +9 -0
  168. package/dist/services/onboarding/browser/console-log.js +27 -0
  169. package/dist/services/onboarding/browser/emulate-device.d.ts +12 -1
  170. package/dist/services/onboarding/browser/emulate-device.js +68 -13
  171. package/dist/services/onboarding/browser/executable/executable-validator.js +4 -2
  172. package/dist/services/onboarding/browser/extension/extension-bridge.js +5 -3
  173. package/dist/services/onboarding/browser/extension/extension-downloader.js +17 -8
  174. package/dist/services/onboarding/browser/extension/extension-validator.js +9 -4
  175. package/dist/services/onboarding/browser/launch-browser.d.ts +2 -1
  176. package/dist/services/onboarding/browser/launch-browser.js +6 -1
  177. package/dist/services/onboarding/browser/resume-restarted-workers.d.ts +14 -0
  178. package/dist/services/onboarding/browser/resume-restarted-workers.js +26 -0
  179. package/dist/services/onboarding/control/body-inspect.d.ts +24 -0
  180. package/dist/services/onboarding/control/body-inspect.js +106 -0
  181. package/dist/services/onboarding/control/browser-session.d.ts +547 -0
  182. package/dist/services/onboarding/control/browser-session.js +1337 -0
  183. package/dist/services/onboarding/control/config-validation.d.ts +17 -0
  184. package/dist/services/onboarding/control/config-validation.js +46 -0
  185. package/dist/services/onboarding/control/control-protocol.d.ts +1430 -0
  186. package/dist/services/onboarding/control/control-protocol.js +58 -0
  187. package/dist/services/onboarding/control/control-server.d.ts +292 -0
  188. package/dist/services/onboarding/control/control-server.js +1629 -0
  189. package/dist/services/onboarding/control/debug-session.d.ts +219 -0
  190. package/dist/services/onboarding/control/debug-session.js +897 -0
  191. package/dist/services/onboarding/control/fouc.d.ts +23 -0
  192. package/dist/services/onboarding/control/fouc.js +151 -0
  193. package/dist/services/onboarding/control/index.d.ts +4 -0
  194. package/dist/services/onboarding/control/index.js +4 -0
  195. package/dist/services/onboarding/control/navigate-wait.d.ts +33 -0
  196. package/dist/services/onboarding/control/navigate-wait.js +56 -0
  197. package/dist/services/onboarding/control/navwalk.d.ts +65 -0
  198. package/dist/services/onboarding/control/navwalk.js +248 -0
  199. package/dist/services/onboarding/control/preload-registry.d.ts +150 -0
  200. package/dist/services/onboarding/control/preload-registry.js +829 -0
  201. package/dist/services/onboarding/control/response-explainer.d.ts +24 -0
  202. package/dist/services/onboarding/control/response-explainer.js +257 -0
  203. package/dist/services/onboarding/control/rum.d.ts +8 -0
  204. package/dist/services/onboarding/control/rum.js +220 -0
  205. package/dist/services/onboarding/control/service-worker-tracker.d.ts +68 -0
  206. package/dist/services/onboarding/control/service-worker-tracker.js +120 -0
  207. package/dist/services/onboarding/control/viewport.d.ts +45 -0
  208. package/dist/services/onboarding/control/viewport.js +344 -0
  209. package/dist/services/onboarding/control/watch.d.ts +26 -0
  210. package/dist/services/onboarding/control/watch.js +157 -0
  211. package/dist/services/onboarding/dashboard/diff-against-current-page.js +3 -1
  212. package/dist/services/onboarding/dashboard/index.js +7 -2
  213. package/dist/services/onboarding/fetch-event-handler.d.ts +24 -5
  214. package/dist/services/onboarding/fetch-event-handler.js +103 -32
  215. package/dist/services/onboarding/fetch-events/spec/speed-kit-install-js.spec.d.ts +1 -0
  216. package/dist/services/onboarding/fetch-events/spec/speed-kit-install-js.spec.js +59 -0
  217. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +16 -5
  218. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +14 -0
  219. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +30 -0
  220. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +13 -0
  221. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +28 -1
  222. package/dist/services/onboarding/file-events/file-watcher.d.ts +42 -1
  223. package/dist/services/onboarding/file-events/file-watcher.js +117 -12
  224. package/dist/services/onboarding/inject/inject-service.js +1 -1
  225. package/dist/services/onboarding/onboarding-model.d.ts +40 -7
  226. package/dist/services/onboarding/onboarding-model.js +20 -9
  227. package/dist/services/onboarding/onboarding-service-build-context.d.ts +4 -0
  228. package/dist/services/onboarding/onboarding-service-build-context.js +7 -1
  229. package/dist/services/onboarding/onboarding-service-factory.d.ts +17 -1
  230. package/dist/services/onboarding/onboarding-service-factory.js +150 -23
  231. package/dist/services/onboarding/onboarding-service.d.ts +40 -1
  232. package/dist/services/onboarding/onboarding-service.js +139 -23
  233. package/dist/services/onboarding/request-cache/asset-key.d.ts +61 -0
  234. package/dist/services/onboarding/request-cache/asset-key.js +115 -0
  235. package/dist/services/onboarding/request-cache/cache.d.ts +62 -5
  236. package/dist/services/onboarding/request-cache/cache.js +128 -17
  237. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.d.ts +1 -0
  238. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.js +66 -0
  239. package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +1 -0
  240. package/dist/services/onboarding/spec/browser/console-log.spec.js +42 -0
  241. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.d.ts +1 -0
  242. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.js +45 -0
  243. package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +1 -0
  244. package/dist/services/onboarding/spec/control/browser-session.spec.js +753 -0
  245. package/dist/services/onboarding/spec/control/control-server.spec.d.ts +1 -0
  246. package/dist/services/onboarding/spec/control/control-server.spec.js +371 -0
  247. package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +1 -0
  248. package/dist/services/onboarding/spec/control/debug-session.spec.js +751 -0
  249. package/dist/services/onboarding/spec/control/fakes.d.ts +31 -0
  250. package/dist/services/onboarding/spec/control/fakes.js +67 -0
  251. package/dist/services/onboarding/spec/control/fouc.spec.d.ts +1 -0
  252. package/dist/services/onboarding/spec/control/fouc.spec.js +167 -0
  253. package/dist/services/onboarding/spec/control/navigate-wait.spec.d.ts +1 -0
  254. package/dist/services/onboarding/spec/control/navigate-wait.spec.js +47 -0
  255. package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +1 -0
  256. package/dist/services/onboarding/spec/control/navwalk.spec.js +222 -0
  257. package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +1 -0
  258. package/dist/services/onboarding/spec/control/preload-registry.spec.js +432 -0
  259. package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +1 -0
  260. package/dist/services/onboarding/spec/control/response-explainer.spec.js +324 -0
  261. package/dist/services/onboarding/spec/control/rum.spec.d.ts +1 -0
  262. package/dist/services/onboarding/spec/control/rum.spec.js +222 -0
  263. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +1 -0
  264. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +193 -0
  265. package/dist/services/onboarding/spec/control/viewport.spec.d.ts +1 -0
  266. package/dist/services/onboarding/spec/control/viewport.spec.js +200 -0
  267. package/dist/services/onboarding/spec/control/watch.spec.d.ts +1 -0
  268. package/dist/services/onboarding/spec/control/watch.spec.js +187 -0
  269. package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +1 -0
  270. package/dist/services/onboarding/spec/fetch-event-handler.spec.js +219 -0
  271. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +1 -0
  272. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +41 -0
  273. package/dist/services/onboarding/spec/onboarding-model.spec.js +39 -3
  274. package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +25 -1
  275. package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +1 -0
  276. package/dist/services/onboarding/spec/request-cache/cache.spec.js +107 -0
  277. package/dist/services/onboarding/spec/todo-collector.spec.d.ts +1 -0
  278. package/dist/services/onboarding/spec/todo-collector.spec.js +136 -0
  279. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.d.ts +1 -0
  280. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.js +65 -0
  281. package/dist/services/onboarding/todo-collector.d.ts +7 -2
  282. package/dist/services/onboarding/todo-collector.js +49 -12
  283. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +38 -0
  284. package/dist/services/onboarding/virtual-orestes-app/index.js +113 -27
  285. package/dist/services/origin-request/asset-variations.d.ts +14 -0
  286. package/dist/services/origin-request/asset-variations.js +11 -4
  287. package/dist/services/origin-request/origin-fetcher.d.ts +7 -0
  288. package/dist/services/origin-request/origin-fetcher.js +43 -5
  289. package/dist/services/origin-request/origin-request-service-build-context.d.ts +17 -0
  290. package/dist/services/origin-request/origin-request-service-build-context.js +8 -0
  291. package/dist/services/origin-request/origin-request-service-factory.d.ts +0 -5
  292. package/dist/services/origin-request/origin-request-service-factory.js +2 -30
  293. package/dist/services/origin-request/origin-request-service.d.ts +121 -6
  294. package/dist/services/origin-request/origin-request-service.js +273 -49
  295. package/dist/services/origin-request/runtime-config-source.d.ts +6 -0
  296. package/dist/services/origin-request/runtime-config-source.js +15 -4
  297. package/dist/services/origin-request/spec/asset-variations.spec.js +20 -0
  298. package/dist/services/origin-request/spec/origin-request-service.spec.js +329 -6
  299. package/dist/services/query-builder/rules/rule-match.d.ts +35 -0
  300. package/dist/services/query-builder/rules/rule-match.js +70 -0
  301. package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +1 -0
  302. package/dist/services/query-builder/spec/rules/rule-match.spec.js +121 -0
  303. package/dist/services/run-control/browser/run-browser-contexts.d.ts +557 -0
  304. package/dist/services/run-control/browser/run-browser-contexts.js +91 -0
  305. package/dist/services/run-control/browser/run-browser-service-factory.d.ts +5 -0
  306. package/dist/services/run-control/browser/run-browser-service-factory.js +7 -0
  307. package/dist/services/run-control/browser/run-browser-service.d.ts +68 -0
  308. package/dist/services/run-control/browser/run-browser-service.js +206 -0
  309. package/dist/services/run-control/cache/run-cache-contexts.d.ts +349 -0
  310. package/dist/services/run-control/cache/run-cache-contexts.js +51 -0
  311. package/dist/services/run-control/cache/run-cache-service-factory.d.ts +6 -0
  312. package/dist/services/run-control/cache/run-cache-service-factory.js +12 -0
  313. package/dist/services/run-control/cache/run-cache-service.d.ts +35 -0
  314. package/dist/services/run-control/cache/run-cache-service.js +151 -0
  315. package/dist/services/run-control/control-client.d.ts +36 -0
  316. package/dist/services/run-control/control-client.js +147 -0
  317. package/dist/services/run-control/debug/run-debug-contexts.d.ts +416 -0
  318. package/dist/services/run-control/debug/run-debug-contexts.js +47 -0
  319. package/dist/services/run-control/debug/run-debug-service-factory.d.ts +5 -0
  320. package/dist/services/run-control/debug/run-debug-service-factory.js +7 -0
  321. package/dist/services/run-control/debug/run-debug-service.d.ts +39 -0
  322. package/dist/services/run-control/debug/run-debug-service.js +164 -0
  323. package/dist/services/run-control/files/run-files-contexts.d.ts +238 -0
  324. package/dist/services/run-control/files/run-files-contexts.js +26 -0
  325. package/dist/services/run-control/files/run-files-service-factory.d.ts +5 -0
  326. package/dist/services/run-control/files/run-files-service-factory.js +7 -0
  327. package/dist/services/run-control/files/run-files-service.d.ts +29 -0
  328. package/dist/services/run-control/files/run-files-service.js +120 -0
  329. package/dist/services/run-control/index.d.ts +32 -0
  330. package/dist/services/run-control/index.js +31 -0
  331. package/dist/services/run-control/inject/run-inject-contexts.d.ts +319 -0
  332. package/dist/services/run-control/inject/run-inject-contexts.js +38 -0
  333. package/dist/services/run-control/inject/run-inject-service-factory.d.ts +5 -0
  334. package/dist/services/run-control/inject/run-inject-service-factory.js +7 -0
  335. package/dist/services/run-control/inject/run-inject-service.d.ts +31 -0
  336. package/dist/services/run-control/inject/run-inject-service.js +227 -0
  337. package/dist/services/run-control/live-run.d.ts +37 -0
  338. package/dist/services/run-control/live-run.js +56 -0
  339. package/dist/services/run-control/probe/run-probe-contexts.d.ts +333 -0
  340. package/dist/services/run-control/probe/run-probe-contexts.js +73 -0
  341. package/dist/services/run-control/probe/run-probe-service-factory.d.ts +5 -0
  342. package/dist/services/run-control/probe/run-probe-service-factory.js +7 -0
  343. package/dist/services/run-control/probe/run-probe-service.d.ts +54 -0
  344. package/dist/services/run-control/probe/run-probe-service.js +194 -0
  345. package/dist/services/run-control/rum/run-rum-contexts.d.ts +216 -0
  346. package/dist/services/run-control/rum/run-rum-contexts.js +34 -0
  347. package/dist/services/run-control/rum/run-rum-service-factory.d.ts +5 -0
  348. package/dist/services/run-control/rum/run-rum-service-factory.js +7 -0
  349. package/dist/services/run-control/rum/run-rum-service.d.ts +36 -0
  350. package/dist/services/run-control/rum/run-rum-service.js +122 -0
  351. package/dist/services/run-control/run-answer.d.ts +28 -0
  352. package/dist/services/run-control/run-answer.js +58 -0
  353. package/dist/services/run-control/run-control-context.d.ts +102 -0
  354. package/dist/services/run-control/run-control-context.js +36 -0
  355. package/dist/services/run-control/run-control-flags.d.ts +12 -0
  356. package/dist/services/run-control/run-control-flags.js +22 -0
  357. package/dist/services/run-control/run-control-model.d.ts +9 -0
  358. package/dist/services/run-control/run-control-model.js +1 -0
  359. package/dist/services/run-control/run-control-service-factory.d.ts +14 -0
  360. package/dist/services/run-control/run-control-service-factory.js +26 -0
  361. package/dist/services/run-control/session/run-session-contexts.d.ts +25 -0
  362. package/dist/services/run-control/session/run-session-contexts.js +20 -0
  363. package/dist/services/run-control/session/run-session-service-factory.d.ts +8 -0
  364. package/dist/services/run-control/session/run-session-service-factory.js +18 -0
  365. package/dist/services/run-control/session/run-session-service.d.ts +32 -0
  366. package/dist/services/run-control/session/run-session-service.js +151 -0
  367. package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +1 -0
  368. package/dist/services/run-control/spec/browser/run-browser-service.spec.js +328 -0
  369. package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +1 -0
  370. package/dist/services/run-control/spec/cache/run-cache-service.spec.js +454 -0
  371. package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +1 -0
  372. package/dist/services/run-control/spec/debug/run-debug-service.spec.js +113 -0
  373. package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +1 -0
  374. package/dist/services/run-control/spec/files/run-files-service.spec.js +234 -0
  375. package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +1 -0
  376. package/dist/services/run-control/spec/inject/run-inject-service.spec.js +251 -0
  377. package/dist/services/run-control/spec/live-run-fixture.d.ts +32 -0
  378. package/dist/services/run-control/spec/live-run-fixture.js +109 -0
  379. package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +1 -0
  380. package/dist/services/run-control/spec/probe/run-probe-service.spec.js +108 -0
  381. package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +1 -0
  382. package/dist/services/run-control/spec/rum/run-rum-service.spec.js +47 -0
  383. package/dist/services/run-control/spec/run-answer.spec.d.ts +1 -0
  384. package/dist/services/run-control/spec/run-answer.spec.js +57 -0
  385. package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +1 -0
  386. package/dist/services/run-control/spec/session/run-session-service.spec.js +150 -0
  387. package/dist/services/run-log/crash-mirror.d.ts +31 -0
  388. package/dist/services/run-log/crash-mirror.js +69 -0
  389. package/dist/services/run-log/index.d.ts +11 -0
  390. package/dist/services/run-log/index.js +11 -0
  391. package/dist/services/run-log/jsonl-appender.d.ts +46 -0
  392. package/dist/services/run-log/jsonl-appender.js +91 -0
  393. package/dist/services/run-log/log-event-model.d.ts +104 -0
  394. package/dist/services/run-log/log-event-model.js +56 -0
  395. package/dist/services/run-log/log-query-service-factory.d.ts +11 -0
  396. package/dist/services/run-log/log-query-service-factory.js +14 -0
  397. package/dist/services/run-log/log-query-service.d.ts +59 -0
  398. package/dist/services/run-log/log-query-service.js +111 -0
  399. package/dist/services/run-log/log-reader.d.ts +84 -0
  400. package/dist/services/run-log/log-reader.js +180 -0
  401. package/dist/services/run-log/log-summary.d.ts +72 -0
  402. package/dist/services/run-log/log-summary.js +208 -0
  403. package/dist/services/run-log/redaction.d.ts +34 -0
  404. package/dist/services/run-log/redaction.js +124 -0
  405. package/dist/services/run-log/request-log.d.ts +82 -0
  406. package/dist/services/run-log/request-log.js +69 -0
  407. package/dist/services/run-log/request-summary.d.ts +76 -0
  408. package/dist/services/run-log/request-summary.js +0 -0
  409. package/dist/services/run-log/run-log.d.ts +61 -0
  410. package/dist/services/run-log/run-log.js +102 -0
  411. package/dist/services/run-log/spec/log-query-service.spec.d.ts +1 -0
  412. package/dist/services/run-log/spec/log-query-service.spec.js +197 -0
  413. package/dist/services/run-log/spec/log-reader.spec.d.ts +1 -0
  414. package/dist/services/run-log/spec/log-reader.spec.js +109 -0
  415. package/dist/services/run-log/spec/log-summary.spec.d.ts +1 -0
  416. package/dist/services/run-log/spec/log-summary.spec.js +153 -0
  417. package/dist/services/run-log/spec/redaction.spec.d.ts +1 -0
  418. package/dist/services/run-log/spec/redaction.spec.js +61 -0
  419. package/dist/services/run-log/spec/request-log.spec.d.ts +1 -0
  420. package/dist/services/run-log/spec/request-log.spec.js +101 -0
  421. package/dist/services/run-log/spec/request-summary.spec.d.ts +1 -0
  422. package/dist/services/run-log/spec/request-summary.spec.js +171 -0
  423. package/dist/services/run-log/spec/run-log.spec.d.ts +1 -0
  424. package/dist/services/run-log/spec/run-log.spec.js +122 -0
  425. package/dist/services/run-registry/exit-classification.d.ts +39 -0
  426. package/dist/services/run-registry/exit-classification.js +42 -0
  427. package/dist/services/run-registry/index.d.ts +3 -0
  428. package/dist/services/run-registry/index.js +3 -0
  429. package/dist/services/run-registry/process-identity.d.ts +28 -0
  430. package/dist/services/run-registry/process-identity.js +80 -0
  431. package/dist/services/run-registry/run-registry-model.d.ts +128 -0
  432. package/dist/services/run-registry/run-registry-model.js +16 -0
  433. package/dist/services/run-registry/run-registry.d.ts +155 -0
  434. package/dist/services/run-registry/run-registry.js +430 -0
  435. package/dist/services/run-registry/spec/exit-classification.spec.d.ts +1 -0
  436. package/dist/services/run-registry/spec/exit-classification.spec.js +82 -0
  437. package/dist/services/run-registry/spec/run-registry.spec.d.ts +1 -0
  438. package/dist/services/run-registry/spec/run-registry.spec.js +526 -0
  439. package/dist/services/setup/os/tool-registry.js +2 -2
  440. package/oclif.manifest.json +3479 -358
  441. package/package.json +20 -2
@@ -0,0 +1,56 @@
1
+ import { ControlClient, ControlError } from "./control-client.js";
2
+ /** Long enough for a question, short enough that a stall is reported. */
3
+ const QUESTION_BUDGET_MS = 5000;
4
+ /**
5
+ * A run that is live, and the one way to ask it something.
6
+ *
7
+ * Opens a connection per request and closes it again, as `ControlClient`
8
+ * intends: nothing is cached between two questions, because the run moves
9
+ * underneath.
10
+ */
11
+ export class LiveRun {
12
+ run;
13
+ timeoutMs;
14
+ tab;
15
+ constructor(run,
16
+ /** `--timeout`: overrides every op's own budget when given. */
17
+ timeoutMs,
18
+ /** `--tab`: sent with every request, and ignored by ops about the run. */
19
+ tab) {
20
+ this.run = run;
21
+ this.timeoutMs = timeoutMs;
22
+ this.tab = tab;
23
+ }
24
+ /**
25
+ * The run `--run` names, refused unless it is live.
26
+ *
27
+ * Everything an op asks lives in the run's memory, so a finished run is not
28
+ * an empty answer but no answer — and saying "0 entries" would read as one.
29
+ */
30
+ static resolve(registry, selector, options = {}) {
31
+ const run = registry.resolve(selector);
32
+ if (!run.live) {
33
+ throw new ControlError("NO_LIVE_RUN", options.notLive?.(run) ??
34
+ `Run ${run.meta.id} is ${run.status}; what it held went with the process.`, {
35
+ run: run.meta.id,
36
+ status: run.status,
37
+ next: "Start one with `sk onboarding <customerPath>`.",
38
+ });
39
+ }
40
+ return new LiveRun(run, options.timeoutMs, options.tab);
41
+ }
42
+ get id() {
43
+ return this.run.meta.id;
44
+ }
45
+ /** Ask once, within `budgetMs` unless `--timeout` said otherwise. */
46
+ async request(command, budgetMs = QUESTION_BUDGET_MS) {
47
+ const timeoutMs = this.timeoutMs ?? budgetMs;
48
+ const client = await ControlClient.connectTo(this.run, timeoutMs);
49
+ try {
50
+ return await client.request(this.tab ? { ...command, tab: this.tab } : command, timeoutMs);
51
+ }
52
+ finally {
53
+ client.close();
54
+ }
55
+ }
56
+ }
@@ -0,0 +1,333 @@
1
+ export declare const ResponseBuildContext: {
2
+ new (values: import("../run-control-context.js").RunControlBuildContextValues<{
3
+ url: string;
4
+ } & {
5
+ tab: string;
6
+ json: boolean | undefined;
7
+ }>): {
8
+ readonly run?: string;
9
+ readonly json: boolean;
10
+ readonly timeout?: number;
11
+ readonly tab?: string;
12
+ readonly input: {
13
+ url: string;
14
+ } & {
15
+ tab: string;
16
+ json: boolean | undefined;
17
+ };
18
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
19
+ };
20
+ readonly args: {
21
+ url: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
22
+ };
23
+ readonly flags: {
24
+ run: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
25
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
26
+ timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
27
+ } & {
28
+ tab: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
29
+ };
30
+ create(parsedArgs: {
31
+ url: string;
32
+ }, parsedFlags: {
33
+ run: string;
34
+ json: boolean | undefined;
35
+ timeout: number;
36
+ tab: string;
37
+ }, environment: import("../../cli/cli-environment.js").CliEnvironment): {
38
+ readonly run?: string;
39
+ readonly json: boolean;
40
+ readonly timeout?: number;
41
+ readonly tab?: string;
42
+ readonly input: {
43
+ url: string;
44
+ } & {
45
+ tab: string;
46
+ json: boolean | undefined;
47
+ };
48
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
49
+ };
50
+ };
51
+ export declare const WatchBuildContext: {
52
+ new (values: import("../run-control-context.js").RunControlBuildContextValues<{
53
+ expression: string;
54
+ } & {
55
+ interval: number;
56
+ duration: number;
57
+ reload: any;
58
+ full: any;
59
+ tab: string;
60
+ json: boolean | undefined;
61
+ }>): {
62
+ readonly run?: string;
63
+ readonly json: boolean;
64
+ readonly timeout?: number;
65
+ readonly tab?: string;
66
+ readonly input: {
67
+ expression: string;
68
+ } & {
69
+ interval: number;
70
+ duration: number;
71
+ reload: any;
72
+ full: any;
73
+ tab: string;
74
+ json: boolean | undefined;
75
+ };
76
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
77
+ };
78
+ readonly args: {
79
+ expression: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
80
+ };
81
+ readonly flags: {
82
+ run: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
83
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
84
+ timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
85
+ } & {
86
+ interval: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
87
+ duration: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
88
+ reload: import("@oclif/core/interfaces").BooleanFlag<any>;
89
+ full: import("@oclif/core/interfaces").BooleanFlag<any>;
90
+ } & {
91
+ tab: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
92
+ };
93
+ create(parsedArgs: {
94
+ expression: string;
95
+ }, parsedFlags: {
96
+ run: string;
97
+ json: boolean | undefined;
98
+ timeout: number;
99
+ interval: number;
100
+ duration: number;
101
+ reload: any;
102
+ full: any;
103
+ tab: string;
104
+ }, environment: import("../../cli/cli-environment.js").CliEnvironment): {
105
+ readonly run?: string;
106
+ readonly json: boolean;
107
+ readonly timeout?: number;
108
+ readonly tab?: string;
109
+ readonly input: {
110
+ expression: string;
111
+ } & {
112
+ interval: number;
113
+ duration: number;
114
+ reload: any;
115
+ full: any;
116
+ tab: string;
117
+ json: boolean | undefined;
118
+ };
119
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
120
+ };
121
+ };
122
+ export declare const NavwalkBuildContext: {
123
+ new (values: import("../run-control-context.js").RunControlBuildContextValues<{
124
+ [x: string]: any;
125
+ } & {
126
+ flow: "login" | "checkout";
127
+ click: string;
128
+ url: string;
129
+ wait: number;
130
+ all: any;
131
+ tab: string;
132
+ json: boolean | undefined;
133
+ }>): {
134
+ readonly run?: string;
135
+ readonly json: boolean;
136
+ readonly timeout?: number;
137
+ readonly tab?: string;
138
+ readonly input: {
139
+ [x: string]: any;
140
+ } & {
141
+ flow: "login" | "checkout";
142
+ click: string;
143
+ url: string;
144
+ wait: number;
145
+ all: any;
146
+ tab: string;
147
+ json: boolean | undefined;
148
+ };
149
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
150
+ };
151
+ readonly args: {};
152
+ readonly flags: {
153
+ run: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
154
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
155
+ timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
156
+ } & {
157
+ flow: import("@oclif/core/interfaces").OptionFlag<"login" | "checkout", import("@oclif/core/interfaces").CustomOptions>;
158
+ click: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
159
+ url: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
160
+ wait: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
161
+ all: import("@oclif/core/interfaces").BooleanFlag<any>;
162
+ } & {
163
+ tab: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
164
+ };
165
+ create(parsedArgs: {
166
+ [x: string]: any;
167
+ }, parsedFlags: {
168
+ run: string;
169
+ json: boolean | undefined;
170
+ timeout: number;
171
+ flow: "login" | "checkout";
172
+ click: string;
173
+ url: string;
174
+ wait: number;
175
+ all: any;
176
+ tab: string;
177
+ }, environment: import("../../cli/cli-environment.js").CliEnvironment): {
178
+ readonly run?: string;
179
+ readonly json: boolean;
180
+ readonly timeout?: number;
181
+ readonly tab?: string;
182
+ readonly input: {
183
+ [x: string]: any;
184
+ } & {
185
+ flow: "login" | "checkout";
186
+ click: string;
187
+ url: string;
188
+ wait: number;
189
+ all: any;
190
+ tab: string;
191
+ json: boolean | undefined;
192
+ };
193
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
194
+ };
195
+ };
196
+ export declare const FoucBuildContext: {
197
+ new (values: import("../run-control-context.js").RunControlBuildContextValues<{
198
+ [x: string]: any;
199
+ } & {
200
+ selector: string;
201
+ duration: number;
202
+ tab: string;
203
+ json: boolean | undefined;
204
+ }>): {
205
+ readonly run?: string;
206
+ readonly json: boolean;
207
+ readonly timeout?: number;
208
+ readonly tab?: string;
209
+ readonly input: {
210
+ [x: string]: any;
211
+ } & {
212
+ selector: string;
213
+ duration: number;
214
+ tab: string;
215
+ json: boolean | undefined;
216
+ };
217
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
218
+ };
219
+ readonly args: {};
220
+ readonly flags: {
221
+ run: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
222
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
223
+ timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
224
+ } & {
225
+ selector: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
226
+ duration: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
227
+ } & {
228
+ tab: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
229
+ };
230
+ create(parsedArgs: {
231
+ [x: string]: any;
232
+ }, parsedFlags: {
233
+ run: string;
234
+ json: boolean | undefined;
235
+ timeout: number;
236
+ selector: string;
237
+ duration: number;
238
+ tab: string;
239
+ }, environment: import("../../cli/cli-environment.js").CliEnvironment): {
240
+ readonly run?: string;
241
+ readonly json: boolean;
242
+ readonly timeout?: number;
243
+ readonly tab?: string;
244
+ readonly input: {
245
+ [x: string]: any;
246
+ } & {
247
+ selector: string;
248
+ duration: number;
249
+ tab: string;
250
+ json: boolean | undefined;
251
+ };
252
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
253
+ };
254
+ };
255
+ export declare const ViewportBuildContext: {
256
+ new (values: import("../run-control-context.js").RunControlBuildContextValues<{
257
+ [x: string]: any;
258
+ } & {
259
+ min: number;
260
+ max: number;
261
+ step: number;
262
+ settle: number;
263
+ height: number;
264
+ url: string;
265
+ tab: string;
266
+ json: boolean | undefined;
267
+ }>): {
268
+ readonly run?: string;
269
+ readonly json: boolean;
270
+ readonly timeout?: number;
271
+ readonly tab?: string;
272
+ readonly input: {
273
+ [x: string]: any;
274
+ } & {
275
+ min: number;
276
+ max: number;
277
+ step: number;
278
+ settle: number;
279
+ height: number;
280
+ url: string;
281
+ tab: string;
282
+ json: boolean | undefined;
283
+ };
284
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
285
+ };
286
+ readonly args: {};
287
+ readonly flags: {
288
+ run: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
289
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
290
+ timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
291
+ } & {
292
+ min: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
293
+ max: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
294
+ step: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
295
+ settle: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
296
+ height: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
297
+ url: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
298
+ } & {
299
+ tab: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
300
+ };
301
+ create(parsedArgs: {
302
+ [x: string]: any;
303
+ }, parsedFlags: {
304
+ run: string;
305
+ json: boolean | undefined;
306
+ timeout: number;
307
+ min: number;
308
+ max: number;
309
+ step: number;
310
+ settle: number;
311
+ height: number;
312
+ url: string;
313
+ tab: string;
314
+ }, environment: import("../../cli/cli-environment.js").CliEnvironment): {
315
+ readonly run?: string;
316
+ readonly json: boolean;
317
+ readonly timeout?: number;
318
+ readonly tab?: string;
319
+ readonly input: {
320
+ [x: string]: any;
321
+ } & {
322
+ min: number;
323
+ max: number;
324
+ step: number;
325
+ settle: number;
326
+ height: number;
327
+ url: string;
328
+ tab: string;
329
+ json: boolean | undefined;
330
+ };
331
+ readonly environment: import("../../cli/cli-environment.js").CliEnvironment;
332
+ };
333
+ };
@@ -0,0 +1,73 @@
1
+ import { Args, Flags } from "@oclif/core";
2
+ import { pageControlContext } from "../run-control-context.js";
3
+ export const ResponseBuildContext = pageControlContext({
4
+ url: Args.string({
5
+ name: "url",
6
+ required: false,
7
+ description: "Absolute, or relative to the customer origin. Omitted means the page the run is on",
8
+ }),
9
+ }, {});
10
+ export const WatchBuildContext = pageControlContext({
11
+ expression: Args.string({
12
+ name: "expression",
13
+ required: true,
14
+ description: "JavaScript returning a JSON-able value, evaluated every tick, e.g. '!!window.SpeedKit'",
15
+ }),
16
+ }, {
17
+ interval: Flags.integer({
18
+ description: "Milliseconds between samples. Default 200",
19
+ }),
20
+ duration: Flags.integer({
21
+ description: "How long to watch, in ms. Default 15000, at most 120000",
22
+ }),
23
+ reload: Flags.boolean({
24
+ default: false,
25
+ description: "Reload first, so the timeline starts at t=0 of a fresh load. Almost always right for a question about page load",
26
+ }),
27
+ full: Flags.boolean({
28
+ default: false,
29
+ description: "Every sample, not only the ones where the value changed",
30
+ }),
31
+ });
32
+ export const NavwalkBuildContext = pageControlContext({}, {
33
+ flow: Flags.option({
34
+ options: ["login", "checkout"],
35
+ description: "The built-in trigger; checkout starts at /cart. Default login when no --click is given",
36
+ })(),
37
+ click: Flags.string({
38
+ description: "The control to click: a CSS selector, or text matched against links and buttons",
39
+ }),
40
+ url: Flags.string({
41
+ description: "Navigate here first, so the walk starts somewhere known",
42
+ }),
43
+ wait: Flags.integer({
44
+ description: "How long to collect after the click, in ms. Default 9000",
45
+ }),
46
+ all: Flags.boolean({
47
+ default: false,
48
+ exclusive: ["flow", "click"],
49
+ description: "Walk both built-in flows, login then checkout, and report them together",
50
+ }),
51
+ });
52
+ export const FoucBuildContext = pageControlContext({}, {
53
+ selector: Flags.string({
54
+ description: "The element whose styling decides whether the paint was styled, e.g. a hero. Default the body",
55
+ }),
56
+ duration: Flags.integer({
57
+ description: "How long to sample after the reload, in ms. Default 8000",
58
+ }),
59
+ });
60
+ export const ViewportBuildContext = pageControlContext({}, {
61
+ min: Flags.integer({ description: "Narrowest width. Default 360" }),
62
+ max: Flags.integer({ description: "Widest width. Default 1600" }),
63
+ step: Flags.integer({
64
+ description: "Coarse increment before pinning to the pixel. Default 20; lower it for breakpoints close together",
65
+ }),
66
+ settle: Flags.integer({
67
+ description: "How long the page gets to react to each resize, in ms. Default 350",
68
+ }),
69
+ height: Flags.integer({ description: "Viewport height. Default 900" }),
70
+ url: Flags.string({
71
+ description: "Navigate here first, so the sweep is of a known page",
72
+ }),
73
+ });
@@ -0,0 +1,5 @@
1
+ import { RunControlServiceFactory } from "../run-control-service-factory.js";
2
+ import { RunProbeService } from "./run-probe-service.js";
3
+ export declare class RunProbeServiceFactory extends RunControlServiceFactory<RunProbeService> {
4
+ buildService(): RunProbeService;
5
+ }
@@ -0,0 +1,7 @@
1
+ import { RunControlServiceFactory } from "../run-control-service-factory.js";
2
+ import { RunProbeService } from "./run-probe-service.js";
3
+ export class RunProbeServiceFactory extends RunControlServiceFactory {
4
+ buildService() {
5
+ return new RunProbeService(this.deps((dead) => `Run ${dead.meta.id} is ${dead.status}. Asking the page anything needs a page.`));
6
+ }
7
+ }
@@ -0,0 +1,54 @@
1
+ import { NavwalkFlow } from "../../onboarding/control/control-protocol.js";
2
+ import { RunControlServiceDeps } from "../run-control-model.js";
3
+ export interface WatchInput {
4
+ expression: string;
5
+ interval?: number;
6
+ duration?: number;
7
+ reload?: boolean;
8
+ full?: boolean;
9
+ }
10
+ export interface NavwalkInput {
11
+ /** Both built-in flows, one after the other. */
12
+ all?: boolean;
13
+ flow?: NavwalkFlow;
14
+ click?: string;
15
+ url?: string;
16
+ wait?: number;
17
+ }
18
+ export interface FoucInput {
19
+ selector?: string;
20
+ duration?: number;
21
+ }
22
+ export interface ViewportInput {
23
+ url?: string;
24
+ min?: number;
25
+ max?: number;
26
+ step?: number;
27
+ settle?: number;
28
+ height?: number;
29
+ }
30
+ /**
31
+ * Questions about the page that one evaluation cannot answer: why a url came
32
+ * back the way it did, and what the page did over a load, a flow or a sweep
33
+ * of widths. All but `response` drive the page while they ask.
34
+ */
35
+ export declare class RunProbeService {
36
+ private readonly cli;
37
+ private readonly run;
38
+ private readonly answer;
39
+ constructor(deps: RunControlServiceDeps);
40
+ /**
41
+ * Why was this page not accelerated: the rule verdict, the cache entry and
42
+ * what Speed Kit reported, side by side. Rules are read from the config as
43
+ * it is on disk now, so it follows an edit.
44
+ */
45
+ response(url?: string): Promise<void>;
46
+ /** An expression's timeline across a load, with the console beside it. */
47
+ watch(input: WatchInput): Promise<void>;
48
+ /** Every same-origin document hop a login or checkout flow makes. */
49
+ navwalk(input: NavwalkInput): Promise<void>;
50
+ /** Whether the page painted before it was styled. Always reloads. */
51
+ fouc(input: FoucInput): Promise<void>;
52
+ /** The widths where the page's own JavaScript changes the DOM. */
53
+ viewport(input: ViewportInput): Promise<void>;
54
+ }