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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (432) hide show
  1. package/README.md +1425 -14
  2. package/dist/base/run-control-command.d.ts +15 -0
  3. package/dist/base/run-control-command.js +20 -0
  4. package/dist/build-info.json +6 -0
  5. package/dist/commands/diff.d.ts +7 -1
  6. package/dist/commands/diff.js +9 -3
  7. package/dist/commands/login.d.ts +3 -0
  8. package/dist/commands/login.js +14 -3
  9. package/dist/commands/onboarding/browser/click.d.ts +75 -0
  10. package/dist/commands/onboarding/browser/click.js +19 -0
  11. package/dist/commands/onboarding/browser/emulate.d.ts +105 -0
  12. package/dist/commands/onboarding/browser/emulate.js +26 -0
  13. package/dist/commands/onboarding/browser/navigate.d.ts +75 -0
  14. package/dist/commands/onboarding/browser/navigate.js +19 -0
  15. package/dist/commands/onboarding/browser/panel.d.ts +63 -0
  16. package/dist/commands/onboarding/browser/panel.js +12 -0
  17. package/dist/commands/onboarding/browser/reinstall-sw.d.ts +63 -0
  18. package/dist/commands/onboarding/browser/reinstall-sw.js +14 -0
  19. package/dist/commands/onboarding/browser/reset.d.ts +71 -0
  20. package/dist/commands/onboarding/browser/reset.js +18 -0
  21. package/dist/commands/onboarding/browser/screenshot.d.ts +77 -0
  22. package/dist/commands/onboarding/browser/screenshot.js +19 -0
  23. package/dist/commands/onboarding/browser/state.d.ts +63 -0
  24. package/dist/commands/onboarding/browser/state.js +12 -0
  25. package/dist/commands/onboarding/browser/tabs.d.ts +58 -0
  26. package/dist/commands/onboarding/browser/tabs.js +16 -0
  27. package/dist/commands/onboarding/cache/clear.d.ts +58 -0
  28. package/dist/commands/onboarding/cache/clear.js +12 -0
  29. package/dist/commands/onboarding/cache/errors.d.ts +58 -0
  30. package/dist/commands/onboarding/cache/errors.js +12 -0
  31. package/dist/commands/onboarding/cache/evict.d.ts +62 -0
  32. package/dist/commands/onboarding/cache/evict.js +15 -0
  33. package/dist/commands/onboarding/cache/get.d.ts +85 -0
  34. package/dist/commands/onboarding/cache/get.js +17 -0
  35. package/dist/commands/onboarding/cache/list.d.ts +58 -0
  36. package/dist/commands/onboarding/cache/list.js +15 -0
  37. package/dist/commands/onboarding/cache/prewarm.d.ts +73 -0
  38. package/dist/commands/onboarding/cache/prewarm.js +20 -0
  39. package/dist/commands/onboarding/cache/refresh.d.ts +62 -0
  40. package/dist/commands/onboarding/cache/refresh.js +18 -0
  41. package/dist/commands/onboarding/cdp.d.ts +81 -0
  42. package/dist/commands/onboarding/cdp.js +18 -0
  43. package/dist/commands/onboarding/debug/arm.d.ts +83 -0
  44. package/dist/commands/onboarding/debug/arm.js +19 -0
  45. package/dist/commands/onboarding/debug/await.d.ts +71 -0
  46. package/dist/commands/onboarding/debug/await.js +18 -0
  47. package/dist/commands/onboarding/debug/disarm.d.ts +63 -0
  48. package/dist/commands/onboarding/debug/disarm.js +12 -0
  49. package/dist/commands/onboarding/debug/eval.d.ts +75 -0
  50. package/dist/commands/onboarding/debug/eval.js +16 -0
  51. package/dist/commands/onboarding/debug/release.d.ts +63 -0
  52. package/dist/commands/onboarding/debug/release.js +12 -0
  53. package/dist/commands/onboarding/debug/resume.d.ts +63 -0
  54. package/dist/commands/onboarding/debug/resume.js +12 -0
  55. package/dist/commands/onboarding/debug/status.d.ts +63 -0
  56. package/dist/commands/onboarding/debug/status.js +12 -0
  57. package/dist/commands/onboarding/debug/step.d.ts +67 -0
  58. package/dist/commands/onboarding/debug/step.js +15 -0
  59. package/dist/commands/onboarding/files/list.d.ts +58 -0
  60. package/dist/commands/onboarding/files/list.js +12 -0
  61. package/dist/commands/onboarding/files/read.d.ts +73 -0
  62. package/dist/commands/onboarding/files/read.js +16 -0
  63. package/dist/commands/onboarding/files/rebuild.d.ts +63 -0
  64. package/dist/commands/onboarding/files/rebuild.js +18 -0
  65. package/dist/commands/onboarding/files/validate.d.ts +58 -0
  66. package/dist/commands/onboarding/files/validate.js +12 -0
  67. package/dist/commands/onboarding/fouc.d.ts +77 -0
  68. package/dist/commands/onboarding/fouc.js +16 -0
  69. package/dist/commands/onboarding/inject/add.d.ts +89 -0
  70. package/dist/commands/onboarding/inject/add.js +17 -0
  71. package/dist/commands/onboarding/inject/clear.d.ts +63 -0
  72. package/dist/commands/onboarding/inject/clear.js +12 -0
  73. package/dist/commands/onboarding/inject/list.d.ts +63 -0
  74. package/dist/commands/onboarding/inject/list.js +12 -0
  75. package/dist/commands/onboarding/inject/read.d.ts +75 -0
  76. package/dist/commands/onboarding/inject/read.js +18 -0
  77. package/dist/commands/onboarding/inject/recipes.d.ts +63 -0
  78. package/dist/commands/onboarding/inject/recipes.js +12 -0
  79. package/dist/commands/onboarding/inject/remove.d.ts +67 -0
  80. package/dist/commands/onboarding/inject/remove.js +15 -0
  81. package/dist/commands/onboarding/list.d.ts +13 -0
  82. package/dist/commands/onboarding/list.js +12 -0
  83. package/dist/commands/onboarding/logs.d.ts +41 -0
  84. package/dist/commands/onboarding/logs.js +257 -0
  85. package/dist/commands/onboarding/navwalk.d.ts +95 -0
  86. package/dist/commands/onboarding/navwalk.js +19 -0
  87. package/dist/commands/onboarding/response.d.ts +67 -0
  88. package/dist/commands/onboarding/response.js +18 -0
  89. package/dist/commands/onboarding/rum/beacons.d.ts +75 -0
  90. package/dist/commands/onboarding/rum/beacons.js +16 -0
  91. package/dist/commands/onboarding/rum/get.d.ts +77 -0
  92. package/dist/commands/onboarding/rum/get.js +18 -0
  93. package/dist/commands/onboarding/rum/key.d.ts +67 -0
  94. package/dist/commands/onboarding/rum/key.js +13 -0
  95. package/dist/commands/onboarding/rum/previous.d.ts +63 -0
  96. package/dist/commands/onboarding/rum/previous.js +12 -0
  97. package/dist/commands/onboarding/status.d.ts +13 -0
  98. package/dist/commands/onboarding/status.js +17 -0
  99. package/dist/commands/onboarding/stop.d.ts +13 -0
  100. package/dist/commands/onboarding/stop.js +17 -0
  101. package/dist/commands/onboarding/todo.d.ts +58 -0
  102. package/dist/commands/onboarding/todo.js +12 -0
  103. package/dist/commands/onboarding/viewport.d.ts +101 -0
  104. package/dist/commands/onboarding/viewport.js +18 -0
  105. package/dist/commands/onboarding/watch.d.ts +93 -0
  106. package/dist/commands/onboarding/watch.js +16 -0
  107. package/dist/commands/onboarding.d.ts +26 -0
  108. package/dist/commands/onboarding.js +221 -4
  109. package/dist/commands/origin-request.d.ts +4 -0
  110. package/dist/commands/origin-request.js +4 -0
  111. package/dist/commands/spec/onboarding.spec.d.ts +1 -0
  112. package/dist/commands/spec/onboarding.spec.js +127 -0
  113. package/dist/services/cli/build-info.d.ts +33 -0
  114. package/dist/services/cli/build-info.js +63 -0
  115. package/dist/services/cli/cli-environment-factory.d.ts +3 -0
  116. package/dist/services/cli/cli-environment-factory.js +1 -0
  117. package/dist/services/cli/cli-service-build-context.d.ts +3 -0
  118. package/dist/services/cli/cli-service-factory.js +1 -1
  119. package/dist/services/cli/cli-service-model.d.ts +29 -10
  120. package/dist/services/cli/cli-service.d.ts +60 -11
  121. package/dist/services/cli/cli-service.js +196 -32
  122. package/dist/services/cli/index.d.ts +2 -0
  123. package/dist/services/cli/index.js +2 -0
  124. package/dist/services/cli/sink.d.ts +47 -0
  125. package/dist/services/cli/sink.js +31 -0
  126. package/dist/services/cli/spec/build-identity.spec.d.ts +1 -0
  127. package/dist/services/cli/spec/build-identity.spec.js +85 -0
  128. package/dist/services/cli/spec/build-info.spec.d.ts +1 -0
  129. package/dist/services/cli/spec/build-info.spec.js +10 -0
  130. package/dist/services/cli/spec/cli-service-log.spec.d.ts +1 -0
  131. package/dist/services/cli/spec/cli-service-log.spec.js +133 -0
  132. package/dist/services/cli/spec/cli-service.spec.js +113 -50
  133. package/dist/services/cli/spec/memory-cli.d.ts +9 -0
  134. package/dist/services/cli/spec/memory-cli.js +9 -0
  135. package/dist/services/diff/config-at-ref.d.ts +20 -0
  136. package/dist/services/diff/config-at-ref.js +33 -0
  137. package/dist/services/diff/diff-service-build-context.d.ts +12 -0
  138. package/dist/services/diff/diff-service-build-context.js +45 -1
  139. package/dist/services/diff/diff-service-factory.d.ts +2 -0
  140. package/dist/services/diff/diff-service-factory.js +65 -25
  141. package/dist/services/diff/diff-service.d.ts +11 -0
  142. package/dist/services/diff/diff-service.js +37 -11
  143. package/dist/services/diff/page-source.d.ts +12 -0
  144. package/dist/services/diff/page-source.js +16 -11
  145. package/dist/services/diff/run-runtime-config.d.ts +33 -0
  146. package/dist/services/diff/run-runtime-config.js +74 -0
  147. package/dist/services/diff/sinks/tool-diff-sink.d.ts +3 -2
  148. package/dist/services/diff/sinks/tool-diff-sink.js +3 -2
  149. package/dist/services/diff/spec/config-at-ref.spec.d.ts +1 -0
  150. package/dist/services/diff/spec/config-at-ref.spec.js +46 -0
  151. package/dist/services/diff/spec/diff-service-build-context.spec.js +19 -0
  152. package/dist/services/diff/spec/diff-service.spec.js +95 -0
  153. package/dist/services/diff/spec/run-runtime-config.spec.d.ts +1 -0
  154. package/dist/services/diff/spec/run-runtime-config.spec.js +87 -0
  155. package/dist/services/git/git-repository.d.ts +2 -0
  156. package/dist/services/git/git-repository.js +6 -0
  157. package/dist/services/integration-api/customer-config-flags.js +1 -0
  158. package/dist/services/onboarding/browse/browse-service.d.ts +13 -1
  159. package/dist/services/onboarding/browse/browse-service.js +40 -7
  160. package/dist/services/onboarding/browser/answer-dialogs.d.ts +12 -0
  161. package/dist/services/onboarding/browser/answer-dialogs.js +25 -0
  162. package/dist/services/onboarding/browser/baqend-response.d.ts +17 -1
  163. package/dist/services/onboarding/browser/baqend-response.js +23 -0
  164. package/dist/services/onboarding/browser/console-log.d.ts +9 -0
  165. package/dist/services/onboarding/browser/console-log.js +27 -0
  166. package/dist/services/onboarding/browser/emulate-device.d.ts +12 -1
  167. package/dist/services/onboarding/browser/emulate-device.js +33 -6
  168. package/dist/services/onboarding/browser/executable/executable-validator.js +4 -2
  169. package/dist/services/onboarding/browser/extension/extension-bridge.js +5 -3
  170. package/dist/services/onboarding/browser/extension/extension-downloader.js +17 -8
  171. package/dist/services/onboarding/browser/extension/extension-validator.js +9 -4
  172. package/dist/services/onboarding/browser/launch-browser.d.ts +2 -1
  173. package/dist/services/onboarding/browser/launch-browser.js +3 -1
  174. package/dist/services/onboarding/control/body-inspect.d.ts +24 -0
  175. package/dist/services/onboarding/control/body-inspect.js +106 -0
  176. package/dist/services/onboarding/control/browser-session.d.ts +535 -0
  177. package/dist/services/onboarding/control/browser-session.js +1300 -0
  178. package/dist/services/onboarding/control/config-validation.d.ts +17 -0
  179. package/dist/services/onboarding/control/config-validation.js +46 -0
  180. package/dist/services/onboarding/control/control-protocol.d.ts +1428 -0
  181. package/dist/services/onboarding/control/control-protocol.js +58 -0
  182. package/dist/services/onboarding/control/control-server.d.ts +292 -0
  183. package/dist/services/onboarding/control/control-server.js +1629 -0
  184. package/dist/services/onboarding/control/debug-session.d.ts +219 -0
  185. package/dist/services/onboarding/control/debug-session.js +897 -0
  186. package/dist/services/onboarding/control/fouc.d.ts +23 -0
  187. package/dist/services/onboarding/control/fouc.js +151 -0
  188. package/dist/services/onboarding/control/index.d.ts +4 -0
  189. package/dist/services/onboarding/control/index.js +4 -0
  190. package/dist/services/onboarding/control/navigate-wait.d.ts +33 -0
  191. package/dist/services/onboarding/control/navigate-wait.js +56 -0
  192. package/dist/services/onboarding/control/navwalk.d.ts +65 -0
  193. package/dist/services/onboarding/control/navwalk.js +248 -0
  194. package/dist/services/onboarding/control/preload-registry.d.ts +150 -0
  195. package/dist/services/onboarding/control/preload-registry.js +829 -0
  196. package/dist/services/onboarding/control/response-explainer.d.ts +24 -0
  197. package/dist/services/onboarding/control/response-explainer.js +257 -0
  198. package/dist/services/onboarding/control/rum.d.ts +8 -0
  199. package/dist/services/onboarding/control/rum.js +220 -0
  200. package/dist/services/onboarding/control/service-worker-tracker.d.ts +68 -0
  201. package/dist/services/onboarding/control/service-worker-tracker.js +120 -0
  202. package/dist/services/onboarding/control/viewport.d.ts +45 -0
  203. package/dist/services/onboarding/control/viewport.js +344 -0
  204. package/dist/services/onboarding/control/watch.d.ts +26 -0
  205. package/dist/services/onboarding/control/watch.js +157 -0
  206. package/dist/services/onboarding/dashboard/diff-against-current-page.js +3 -1
  207. package/dist/services/onboarding/dashboard/index.js +7 -2
  208. package/dist/services/onboarding/fetch-event-handler.d.ts +24 -5
  209. package/dist/services/onboarding/fetch-event-handler.js +103 -32
  210. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +11 -2
  211. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +14 -0
  212. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +30 -0
  213. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +13 -0
  214. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +28 -1
  215. package/dist/services/onboarding/file-events/file-watcher.d.ts +42 -1
  216. package/dist/services/onboarding/file-events/file-watcher.js +117 -12
  217. package/dist/services/onboarding/inject/inject-service.js +1 -1
  218. package/dist/services/onboarding/onboarding-model.d.ts +30 -0
  219. package/dist/services/onboarding/onboarding-model.js +12 -1
  220. package/dist/services/onboarding/onboarding-service-build-context.d.ts +4 -0
  221. package/dist/services/onboarding/onboarding-service-build-context.js +7 -1
  222. package/dist/services/onboarding/onboarding-service-factory.d.ts +17 -1
  223. package/dist/services/onboarding/onboarding-service-factory.js +150 -23
  224. package/dist/services/onboarding/onboarding-service.d.ts +40 -1
  225. package/dist/services/onboarding/onboarding-service.js +136 -23
  226. package/dist/services/onboarding/request-cache/asset-key.d.ts +61 -0
  227. package/dist/services/onboarding/request-cache/asset-key.js +115 -0
  228. package/dist/services/onboarding/request-cache/cache.d.ts +62 -5
  229. package/dist/services/onboarding/request-cache/cache.js +128 -17
  230. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.d.ts +1 -0
  231. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.js +66 -0
  232. package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +1 -0
  233. package/dist/services/onboarding/spec/browser/console-log.spec.js +42 -0
  234. package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +1 -0
  235. package/dist/services/onboarding/spec/control/browser-session.spec.js +651 -0
  236. package/dist/services/onboarding/spec/control/control-server.spec.d.ts +1 -0
  237. package/dist/services/onboarding/spec/control/control-server.spec.js +371 -0
  238. package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +1 -0
  239. package/dist/services/onboarding/spec/control/debug-session.spec.js +751 -0
  240. package/dist/services/onboarding/spec/control/fakes.d.ts +31 -0
  241. package/dist/services/onboarding/spec/control/fakes.js +66 -0
  242. package/dist/services/onboarding/spec/control/fouc.spec.d.ts +1 -0
  243. package/dist/services/onboarding/spec/control/fouc.spec.js +167 -0
  244. package/dist/services/onboarding/spec/control/navigate-wait.spec.d.ts +1 -0
  245. package/dist/services/onboarding/spec/control/navigate-wait.spec.js +47 -0
  246. package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +1 -0
  247. package/dist/services/onboarding/spec/control/navwalk.spec.js +222 -0
  248. package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +1 -0
  249. package/dist/services/onboarding/spec/control/preload-registry.spec.js +432 -0
  250. package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +1 -0
  251. package/dist/services/onboarding/spec/control/response-explainer.spec.js +324 -0
  252. package/dist/services/onboarding/spec/control/rum.spec.d.ts +1 -0
  253. package/dist/services/onboarding/spec/control/rum.spec.js +222 -0
  254. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +1 -0
  255. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +193 -0
  256. package/dist/services/onboarding/spec/control/viewport.spec.d.ts +1 -0
  257. package/dist/services/onboarding/spec/control/viewport.spec.js +200 -0
  258. package/dist/services/onboarding/spec/control/watch.spec.d.ts +1 -0
  259. package/dist/services/onboarding/spec/control/watch.spec.js +187 -0
  260. package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +1 -0
  261. package/dist/services/onboarding/spec/fetch-event-handler.spec.js +219 -0
  262. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +1 -0
  263. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +41 -0
  264. package/dist/services/onboarding/spec/onboarding-model.spec.js +39 -3
  265. package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +25 -1
  266. package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +1 -0
  267. package/dist/services/onboarding/spec/request-cache/cache.spec.js +107 -0
  268. package/dist/services/onboarding/spec/todo-collector.spec.d.ts +1 -0
  269. package/dist/services/onboarding/spec/todo-collector.spec.js +136 -0
  270. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.d.ts +1 -0
  271. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.js +65 -0
  272. package/dist/services/onboarding/todo-collector.d.ts +7 -2
  273. package/dist/services/onboarding/todo-collector.js +49 -12
  274. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +38 -0
  275. package/dist/services/onboarding/virtual-orestes-app/index.js +113 -27
  276. package/dist/services/origin-request/asset-variations.d.ts +14 -0
  277. package/dist/services/origin-request/asset-variations.js +11 -4
  278. package/dist/services/origin-request/origin-fetcher.d.ts +7 -0
  279. package/dist/services/origin-request/origin-fetcher.js +43 -5
  280. package/dist/services/origin-request/origin-request-service-build-context.d.ts +17 -0
  281. package/dist/services/origin-request/origin-request-service-build-context.js +8 -0
  282. package/dist/services/origin-request/origin-request-service-factory.d.ts +0 -5
  283. package/dist/services/origin-request/origin-request-service-factory.js +2 -30
  284. package/dist/services/origin-request/origin-request-service.d.ts +121 -6
  285. package/dist/services/origin-request/origin-request-service.js +273 -49
  286. package/dist/services/origin-request/runtime-config-source.d.ts +6 -0
  287. package/dist/services/origin-request/runtime-config-source.js +15 -4
  288. package/dist/services/origin-request/spec/asset-variations.spec.js +20 -0
  289. package/dist/services/origin-request/spec/origin-request-service.spec.js +329 -6
  290. package/dist/services/query-builder/rules/rule-match.d.ts +35 -0
  291. package/dist/services/query-builder/rules/rule-match.js +70 -0
  292. package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +1 -0
  293. package/dist/services/query-builder/spec/rules/rule-match.spec.js +121 -0
  294. package/dist/services/run-control/browser/run-browser-contexts.d.ts +557 -0
  295. package/dist/services/run-control/browser/run-browser-contexts.js +91 -0
  296. package/dist/services/run-control/browser/run-browser-service-factory.d.ts +5 -0
  297. package/dist/services/run-control/browser/run-browser-service-factory.js +7 -0
  298. package/dist/services/run-control/browser/run-browser-service.d.ts +68 -0
  299. package/dist/services/run-control/browser/run-browser-service.js +206 -0
  300. package/dist/services/run-control/cache/run-cache-contexts.d.ts +349 -0
  301. package/dist/services/run-control/cache/run-cache-contexts.js +51 -0
  302. package/dist/services/run-control/cache/run-cache-service-factory.d.ts +6 -0
  303. package/dist/services/run-control/cache/run-cache-service-factory.js +12 -0
  304. package/dist/services/run-control/cache/run-cache-service.d.ts +35 -0
  305. package/dist/services/run-control/cache/run-cache-service.js +151 -0
  306. package/dist/services/run-control/control-client.d.ts +36 -0
  307. package/dist/services/run-control/control-client.js +147 -0
  308. package/dist/services/run-control/debug/run-debug-contexts.d.ts +416 -0
  309. package/dist/services/run-control/debug/run-debug-contexts.js +47 -0
  310. package/dist/services/run-control/debug/run-debug-service-factory.d.ts +5 -0
  311. package/dist/services/run-control/debug/run-debug-service-factory.js +7 -0
  312. package/dist/services/run-control/debug/run-debug-service.d.ts +39 -0
  313. package/dist/services/run-control/debug/run-debug-service.js +164 -0
  314. package/dist/services/run-control/files/run-files-contexts.d.ts +238 -0
  315. package/dist/services/run-control/files/run-files-contexts.js +26 -0
  316. package/dist/services/run-control/files/run-files-service-factory.d.ts +5 -0
  317. package/dist/services/run-control/files/run-files-service-factory.js +7 -0
  318. package/dist/services/run-control/files/run-files-service.d.ts +29 -0
  319. package/dist/services/run-control/files/run-files-service.js +120 -0
  320. package/dist/services/run-control/index.d.ts +32 -0
  321. package/dist/services/run-control/index.js +31 -0
  322. package/dist/services/run-control/inject/run-inject-contexts.d.ts +319 -0
  323. package/dist/services/run-control/inject/run-inject-contexts.js +38 -0
  324. package/dist/services/run-control/inject/run-inject-service-factory.d.ts +5 -0
  325. package/dist/services/run-control/inject/run-inject-service-factory.js +7 -0
  326. package/dist/services/run-control/inject/run-inject-service.d.ts +31 -0
  327. package/dist/services/run-control/inject/run-inject-service.js +227 -0
  328. package/dist/services/run-control/live-run.d.ts +37 -0
  329. package/dist/services/run-control/live-run.js +56 -0
  330. package/dist/services/run-control/probe/run-probe-contexts.d.ts +333 -0
  331. package/dist/services/run-control/probe/run-probe-contexts.js +73 -0
  332. package/dist/services/run-control/probe/run-probe-service-factory.d.ts +5 -0
  333. package/dist/services/run-control/probe/run-probe-service-factory.js +7 -0
  334. package/dist/services/run-control/probe/run-probe-service.d.ts +54 -0
  335. package/dist/services/run-control/probe/run-probe-service.js +194 -0
  336. package/dist/services/run-control/rum/run-rum-contexts.d.ts +216 -0
  337. package/dist/services/run-control/rum/run-rum-contexts.js +34 -0
  338. package/dist/services/run-control/rum/run-rum-service-factory.d.ts +5 -0
  339. package/dist/services/run-control/rum/run-rum-service-factory.js +7 -0
  340. package/dist/services/run-control/rum/run-rum-service.d.ts +36 -0
  341. package/dist/services/run-control/rum/run-rum-service.js +122 -0
  342. package/dist/services/run-control/run-answer.d.ts +28 -0
  343. package/dist/services/run-control/run-answer.js +58 -0
  344. package/dist/services/run-control/run-control-context.d.ts +102 -0
  345. package/dist/services/run-control/run-control-context.js +36 -0
  346. package/dist/services/run-control/run-control-flags.d.ts +12 -0
  347. package/dist/services/run-control/run-control-flags.js +22 -0
  348. package/dist/services/run-control/run-control-model.d.ts +9 -0
  349. package/dist/services/run-control/run-control-model.js +1 -0
  350. package/dist/services/run-control/run-control-service-factory.d.ts +14 -0
  351. package/dist/services/run-control/run-control-service-factory.js +26 -0
  352. package/dist/services/run-control/session/run-session-contexts.d.ts +25 -0
  353. package/dist/services/run-control/session/run-session-contexts.js +20 -0
  354. package/dist/services/run-control/session/run-session-service-factory.d.ts +8 -0
  355. package/dist/services/run-control/session/run-session-service-factory.js +18 -0
  356. package/dist/services/run-control/session/run-session-service.d.ts +32 -0
  357. package/dist/services/run-control/session/run-session-service.js +151 -0
  358. package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +1 -0
  359. package/dist/services/run-control/spec/browser/run-browser-service.spec.js +327 -0
  360. package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +1 -0
  361. package/dist/services/run-control/spec/cache/run-cache-service.spec.js +454 -0
  362. package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +1 -0
  363. package/dist/services/run-control/spec/debug/run-debug-service.spec.js +113 -0
  364. package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +1 -0
  365. package/dist/services/run-control/spec/files/run-files-service.spec.js +234 -0
  366. package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +1 -0
  367. package/dist/services/run-control/spec/inject/run-inject-service.spec.js +251 -0
  368. package/dist/services/run-control/spec/live-run-fixture.d.ts +32 -0
  369. package/dist/services/run-control/spec/live-run-fixture.js +109 -0
  370. package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +1 -0
  371. package/dist/services/run-control/spec/probe/run-probe-service.spec.js +108 -0
  372. package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +1 -0
  373. package/dist/services/run-control/spec/rum/run-rum-service.spec.js +47 -0
  374. package/dist/services/run-control/spec/run-answer.spec.d.ts +1 -0
  375. package/dist/services/run-control/spec/run-answer.spec.js +57 -0
  376. package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +1 -0
  377. package/dist/services/run-control/spec/session/run-session-service.spec.js +150 -0
  378. package/dist/services/run-log/crash-mirror.d.ts +31 -0
  379. package/dist/services/run-log/crash-mirror.js +69 -0
  380. package/dist/services/run-log/index.d.ts +11 -0
  381. package/dist/services/run-log/index.js +11 -0
  382. package/dist/services/run-log/jsonl-appender.d.ts +46 -0
  383. package/dist/services/run-log/jsonl-appender.js +91 -0
  384. package/dist/services/run-log/log-event-model.d.ts +104 -0
  385. package/dist/services/run-log/log-event-model.js +56 -0
  386. package/dist/services/run-log/log-query-service-factory.d.ts +11 -0
  387. package/dist/services/run-log/log-query-service-factory.js +14 -0
  388. package/dist/services/run-log/log-query-service.d.ts +59 -0
  389. package/dist/services/run-log/log-query-service.js +111 -0
  390. package/dist/services/run-log/log-reader.d.ts +84 -0
  391. package/dist/services/run-log/log-reader.js +180 -0
  392. package/dist/services/run-log/log-summary.d.ts +72 -0
  393. package/dist/services/run-log/log-summary.js +208 -0
  394. package/dist/services/run-log/redaction.d.ts +34 -0
  395. package/dist/services/run-log/redaction.js +124 -0
  396. package/dist/services/run-log/request-log.d.ts +82 -0
  397. package/dist/services/run-log/request-log.js +69 -0
  398. package/dist/services/run-log/request-summary.d.ts +76 -0
  399. package/dist/services/run-log/request-summary.js +0 -0
  400. package/dist/services/run-log/run-log.d.ts +61 -0
  401. package/dist/services/run-log/run-log.js +102 -0
  402. package/dist/services/run-log/spec/log-query-service.spec.d.ts +1 -0
  403. package/dist/services/run-log/spec/log-query-service.spec.js +197 -0
  404. package/dist/services/run-log/spec/log-reader.spec.d.ts +1 -0
  405. package/dist/services/run-log/spec/log-reader.spec.js +109 -0
  406. package/dist/services/run-log/spec/log-summary.spec.d.ts +1 -0
  407. package/dist/services/run-log/spec/log-summary.spec.js +153 -0
  408. package/dist/services/run-log/spec/redaction.spec.d.ts +1 -0
  409. package/dist/services/run-log/spec/redaction.spec.js +61 -0
  410. package/dist/services/run-log/spec/request-log.spec.d.ts +1 -0
  411. package/dist/services/run-log/spec/request-log.spec.js +101 -0
  412. package/dist/services/run-log/spec/request-summary.spec.d.ts +1 -0
  413. package/dist/services/run-log/spec/request-summary.spec.js +171 -0
  414. package/dist/services/run-log/spec/run-log.spec.d.ts +1 -0
  415. package/dist/services/run-log/spec/run-log.spec.js +122 -0
  416. package/dist/services/run-registry/exit-classification.d.ts +39 -0
  417. package/dist/services/run-registry/exit-classification.js +42 -0
  418. package/dist/services/run-registry/index.d.ts +3 -0
  419. package/dist/services/run-registry/index.js +3 -0
  420. package/dist/services/run-registry/process-identity.d.ts +28 -0
  421. package/dist/services/run-registry/process-identity.js +80 -0
  422. package/dist/services/run-registry/run-registry-model.d.ts +128 -0
  423. package/dist/services/run-registry/run-registry-model.js +16 -0
  424. package/dist/services/run-registry/run-registry.d.ts +155 -0
  425. package/dist/services/run-registry/run-registry.js +430 -0
  426. package/dist/services/run-registry/spec/exit-classification.spec.d.ts +1 -0
  427. package/dist/services/run-registry/spec/exit-classification.spec.js +82 -0
  428. package/dist/services/run-registry/spec/run-registry.spec.d.ts +1 -0
  429. package/dist/services/run-registry/spec/run-registry.spec.js +526 -0
  430. package/dist/services/setup/os/tool-registry.js +2 -2
  431. package/oclif.manifest.json +3409 -288
  432. package/package.json +20 -2
@@ -0,0 +1,61 @@
1
+ /**
2
+ * The dh-cache is keyed by the full asset request url, which is a Speed Kit
3
+ * asset url with the origin url embedded in its path and the cache variation on
4
+ * a `bqvariation` search parameter:
5
+ *
6
+ * ```
7
+ * https://<app>.app.baqend.com/v1/asset/https://shop.example.com/p?bqvariation=mobile
8
+ * ```
9
+ *
10
+ * That is the right key — it is exactly what the browser asked for — and the
11
+ * wrong thing to show anyone. Decoding it is what lets a reader see
12
+ * `{originUrl, variation}` instead of 120 opaque characters.
13
+ */
14
+ /** What an absent `bqvariation` means, in the words `buildResponse` uses. */
15
+ export declare const DEFAULT_VARIATION = "default";
16
+ export interface DecodedAssetKey {
17
+ /** The origin url the entry is for, or the key itself if it does not decode. */
18
+ originUrl: string;
19
+ /** The cache variation, or null for the default. */
20
+ variation: string | null;
21
+ }
22
+ /**
23
+ * The origin url an asset request is for: everything after the asset path, with
24
+ * Speed Kit's own `bq*` parameters removed.
25
+ *
26
+ * Returns null when the key is not an asset url — a caller that cannot decode a
27
+ * key should say so rather than present a mangled one.
28
+ */
29
+ export declare function assetOriginUrl(key: string): string | null;
30
+ /**
31
+ * The key the dh-cache stores a request under: the request url without
32
+ * {@link BOOKKEEPING_PARAMETERS}.
33
+ *
34
+ * Keyed by the raw url, one page was several entries — `bqpi` counts page
35
+ * impressions, so a page's second request missed its first — and an entry
36
+ * `cache prewarm` built, which carries none of them, was never the one the
37
+ * page read. `bqcv` goes too: a run copies it from the deployed install
38
+ * resource, so it stays the same however the local config changes. A string
39
+ * that is not a url is returned as it is.
40
+ */
41
+ export declare function cacheKey(requestUri: string): string;
42
+ /** The variation an asset request carries, or null for the default. */
43
+ export declare function assetVariation(key: string): string | null;
44
+ export declare function decodeAssetKey(key: string): DecodedAssetKey;
45
+ /**
46
+ * The asset request url a browser would have sent for this origin url and
47
+ * variation — the key the dh-cache stores an entry under.
48
+ *
49
+ * The inverse of {@link decodeAssetKey}, and it has to agree with it exactly:
50
+ * an entry written under a key no request will ever match is cached and
51
+ * unreachable, which looks from outside like a cache that silently does
52
+ * nothing.
53
+ *
54
+ * The origin url goes in verbatim. Speed Kit strips query parameters in the
55
+ * *service worker*, before an asset request is made at all, so building the
56
+ * request here bypasses that — two urls differing only in a parameter stay two
57
+ * entries even where the worker would have collapsed them. That is the point
58
+ * for anyone comparing them, and a trap for anyone assuming this reproduces
59
+ * what the browser would have asked for.
60
+ */
61
+ export declare function assetRequestUrl(appDomain: string, originUrl: string, variation?: string): string;
@@ -0,0 +1,115 @@
1
+ /**
2
+ * The dh-cache is keyed by the full asset request url, which is a Speed Kit
3
+ * asset url with the origin url embedded in its path and the cache variation on
4
+ * a `bqvariation` search parameter:
5
+ *
6
+ * ```
7
+ * https://<app>.app.baqend.com/v1/asset/https://shop.example.com/p?bqvariation=mobile
8
+ * ```
9
+ *
10
+ * That is the right key — it is exactly what the browser asked for — and the
11
+ * wrong thing to show anyone. Decoding it is what lets a reader see
12
+ * `{originUrl, variation}` instead of 120 opaque characters.
13
+ */
14
+ const ASSET_PATH = "app.baqend.com/v1/asset/";
15
+ const VARIATION_PARAMETER = "bqvariation";
16
+ /** What an absent `bqvariation` means, in the words `buildResponse` uses. */
17
+ export const DEFAULT_VARIATION = "default";
18
+ /**
19
+ * The origin url an asset request is for: everything after the asset path, with
20
+ * Speed Kit's own `bq*` parameters removed.
21
+ *
22
+ * Returns null when the key is not an asset url — a caller that cannot decode a
23
+ * key should say so rather than present a mangled one.
24
+ */
25
+ export function assetOriginUrl(key) {
26
+ let url;
27
+ try {
28
+ url = new URL(key);
29
+ }
30
+ catch {
31
+ return null;
32
+ }
33
+ for (const name of [...url.searchParams.keys()]) {
34
+ if (name.startsWith("bq")) {
35
+ url.searchParams.delete(name);
36
+ }
37
+ }
38
+ const [, origin] = url.toString().split(ASSET_PATH);
39
+ return origin ?? null;
40
+ }
41
+ /**
42
+ * Speed Kit's per-request bookkeeping on an asset url: the deployed config and
43
+ * Speed Kit versions, the page-impression counter (with its `;…` suffix), the
44
+ * fetch mode and the debug pass. None of them changes the document the
45
+ * documentHandler builds.
46
+ */
47
+ const BOOKKEEPING_PARAMETERS = ["bqcv", "bqsk", "bqpi", "bqcache", "bqpass"];
48
+ /**
49
+ * The key the dh-cache stores a request under: the request url without
50
+ * {@link BOOKKEEPING_PARAMETERS}.
51
+ *
52
+ * Keyed by the raw url, one page was several entries — `bqpi` counts page
53
+ * impressions, so a page's second request missed its first — and an entry
54
+ * `cache prewarm` built, which carries none of them, was never the one the
55
+ * page read. `bqcv` goes too: a run copies it from the deployed install
56
+ * resource, so it stays the same however the local config changes. A string
57
+ * that is not a url is returned as it is.
58
+ */
59
+ export function cacheKey(requestUri) {
60
+ let url;
61
+ try {
62
+ url = new URL(requestUri);
63
+ }
64
+ catch {
65
+ return requestUri;
66
+ }
67
+ if (!BOOKKEEPING_PARAMETERS.some((name) => url.searchParams.has(name))) {
68
+ return requestUri;
69
+ }
70
+ for (const name of BOOKKEEPING_PARAMETERS) {
71
+ url.searchParams.delete(name);
72
+ }
73
+ return url.toString();
74
+ }
75
+ /** The variation an asset request carries, or null for the default. */
76
+ export function assetVariation(key) {
77
+ try {
78
+ return new URL(key).searchParams.get(VARIATION_PARAMETER)?.trim() || null;
79
+ }
80
+ catch {
81
+ return null;
82
+ }
83
+ }
84
+ export function decodeAssetKey(key) {
85
+ return {
86
+ originUrl: assetOriginUrl(key) ?? key,
87
+ variation: assetVariation(key),
88
+ };
89
+ }
90
+ /**
91
+ * The asset request url a browser would have sent for this origin url and
92
+ * variation — the key the dh-cache stores an entry under.
93
+ *
94
+ * The inverse of {@link decodeAssetKey}, and it has to agree with it exactly:
95
+ * an entry written under a key no request will ever match is cached and
96
+ * unreachable, which looks from outside like a cache that silently does
97
+ * nothing.
98
+ *
99
+ * The origin url goes in verbatim. Speed Kit strips query parameters in the
100
+ * *service worker*, before an asset request is made at all, so building the
101
+ * request here bypasses that — two urls differing only in a parameter stay two
102
+ * entries even where the worker would have collapsed them. That is the point
103
+ * for anyone comparing them, and a trap for anyone assuming this reproduces
104
+ * what the browser would have asked for.
105
+ */
106
+ export function assetRequestUrl(appDomain, originUrl, variation) {
107
+ const url = new URL(`https://${appDomain}/v1/asset/${originUrl}`);
108
+ // The default carries no parameter, because that is how the worker sends it
109
+ // and `buildResponse` reads its absence as `default`. Writing it explicitly
110
+ // would key the default variation apart from every entry the browser makes.
111
+ if (variation && variation !== DEFAULT_VARIATION) {
112
+ url.searchParams.set(VARIATION_PARAMETER, variation);
113
+ }
114
+ return url.toString();
115
+ }
@@ -1,15 +1,72 @@
1
+ import { Protocol } from "devtools-protocol";
1
2
  import { BaqendResponse } from "../browser/baqend-response.js";
2
3
  import { CliServiceInterface } from "../../cli/index.js";
4
+ /** What the cache remembers about an entry, without holding its body. */
5
+ export interface CacheEntry {
6
+ status: number;
7
+ headers: Protocol.Fetch.HeaderEntry[];
8
+ contentType: string | null;
9
+ /** Size of the decoded body. */
10
+ bytes: number;
11
+ /** Hash of the content, so "did the origin actually change" is answerable. */
12
+ sha: string;
13
+ /** Where the decoded body lives. */
14
+ path: string;
15
+ cachedAt: string;
16
+ }
3
17
  /**
4
- * This class represents a cache for storing responses from the localDocumentHandler.
18
+ * The local documentHandler's response cache, kept on disk.
19
+ *
20
+ * Bodies are written as they are cached and read back when they are served,
21
+ * rather than held in memory. A transformed page is commonly several hundred
22
+ * kilobytes, and `BaqendResponse` stores its body base64-encoded — a third
23
+ * larger again — so a session that browses a site of any size accumulates
24
+ * hundreds of megabytes it never releases.
25
+ *
26
+ * Stored **decoded**. The content exists decoded before a response is built,
27
+ * and only Chrome's `Fetch.fulfillRequest` needs base64, so encoding on the way
28
+ * out is both cheaper and leaves a file that can simply be opened.
29
+ *
30
+ * The read this adds to a cache hit is nothing next to what follows it: the
31
+ * file was written moments ago and is in the page cache, while the response
32
+ * still has to cross CDP into Chrome.
33
+ *
34
+ * Living in the run directory means two further things fall out. The bodies are
35
+ * pruned by the run's own retention, and a finished run's cache is still
36
+ * readable — which is what makes a post-mortem possible at all.
5
37
  */
6
38
  export declare class Cache {
7
39
  private cli;
8
- private inMemoryCache;
9
- constructor(cli: CliServiceInterface);
10
- getAll(): IterableIterator<[string, BaqendResponse]>;
40
+ private readonly directory;
41
+ private readonly entries;
42
+ constructor(cli: CliServiceInterface, directory: string);
43
+ /** Metadata for every entry. No body is read. */
44
+ getAll(): IterableIterator<[string, CacheEntry]>;
45
+ /** Metadata for one entry, without touching the disk. */
46
+ getMeta(requestUri: string): CacheEntry | null;
47
+ has(requestUri: string): boolean;
48
+ /**
49
+ * The cached response, rebuilt from disk.
50
+ *
51
+ * Returns null when the entry is unknown *or* its body has gone — a file
52
+ * removed underneath us is a cache miss, not a crash.
53
+ */
11
54
  getEntry(requestUri: string): BaqendResponse | null;
12
- addEntry(requestUri: string, response: BaqendResponse): void;
55
+ /**
56
+ * @param body the response as it exists before Chrome's base64 encoding.
57
+ */
58
+ addEntry(requestUri: string, response: BaqendResponse, body: string | Buffer): void;
59
+ /** Note: a **substring** match over keys, not an exact one. It surprises people. */
13
60
  removeEntry(requestUri: string): void;
14
61
  clear(): void;
62
+ /** Everything this cache wrote, for a run that is shutting down. */
63
+ destroy(): void;
64
+ /**
65
+ * Named after the key, not the content.
66
+ *
67
+ * Content-addressing would let two urls with identical bodies share a file,
68
+ * and then evicting one would pull the body out from under the other.
69
+ */
70
+ private pathFor;
71
+ private unlink;
15
72
  }
@@ -1,36 +1,147 @@
1
+ import { createHash } from "node:crypto";
2
+ import { mkdirSync, readFileSync, rmSync, unlinkSync, writeFileSync, } from "node:fs";
3
+ import { join } from "node:path";
4
+ import { BaqendResponse } from "../browser/baqend-response.js";
5
+ import { cacheKey } from "./asset-key.js";
1
6
  /**
2
- * This class represents a cache for storing responses from the localDocumentHandler.
7
+ * The local documentHandler's response cache, kept on disk.
8
+ *
9
+ * Bodies are written as they are cached and read back when they are served,
10
+ * rather than held in memory. A transformed page is commonly several hundred
11
+ * kilobytes, and `BaqendResponse` stores its body base64-encoded — a third
12
+ * larger again — so a session that browses a site of any size accumulates
13
+ * hundreds of megabytes it never releases.
14
+ *
15
+ * Stored **decoded**. The content exists decoded before a response is built,
16
+ * and only Chrome's `Fetch.fulfillRequest` needs base64, so encoding on the way
17
+ * out is both cheaper and leaves a file that can simply be opened.
18
+ *
19
+ * The read this adds to a cache hit is nothing next to what follows it: the
20
+ * file was written moments ago and is in the page cache, while the response
21
+ * still has to cross CDP into Chrome.
22
+ *
23
+ * Living in the run directory means two further things fall out. The bodies are
24
+ * pruned by the run's own retention, and a finished run's cache is still
25
+ * readable — which is what makes a post-mortem possible at all.
3
26
  */
4
27
  export class Cache {
5
28
  cli;
6
- inMemoryCache = new Map();
7
- constructor(cli) {
29
+ directory;
30
+ entries = new Map();
31
+ constructor(cli, directory) {
8
32
  this.cli = cli;
33
+ this.directory = directory;
9
34
  }
35
+ /** Metadata for every entry. No body is read. */
10
36
  getAll() {
11
- return this.inMemoryCache.entries();
37
+ return this.entries.entries();
12
38
  }
39
+ /** Metadata for one entry, without touching the disk. */
40
+ getMeta(requestUri) {
41
+ return this.entries.get(cacheKey(requestUri)) ?? null;
42
+ }
43
+ has(requestUri) {
44
+ return this.entries.has(cacheKey(requestUri));
45
+ }
46
+ /**
47
+ * The cached response, rebuilt from disk.
48
+ *
49
+ * Returns null when the entry is unknown *or* its body has gone — a file
50
+ * removed underneath us is a cache miss, not a crash.
51
+ */
13
52
  getEntry(requestUri) {
14
- if (this.inMemoryCache.has(requestUri)) {
15
- return this.inMemoryCache.get(requestUri);
53
+ const key = cacheKey(requestUri);
54
+ const entry = this.entries.get(key);
55
+ if (!entry) {
56
+ return null;
57
+ }
58
+ try {
59
+ return BaqendResponse.fromCache(readFileSync(entry.path), entry.headers, entry.status);
60
+ }
61
+ catch {
62
+ this.entries.delete(key);
63
+ return null;
16
64
  }
17
65
  }
18
- addEntry(requestUri, response) {
19
- this.inMemoryCache.set(requestUri, response);
66
+ /**
67
+ * @param body the response as it exists before Chrome's base64 encoding.
68
+ */
69
+ addEntry(requestUri, response, body) {
70
+ const bytes = Buffer.isBuffer(body) ? body : Buffer.from(body);
71
+ const key = cacheKey(requestUri);
72
+ const path = this.pathFor(key);
73
+ try {
74
+ mkdirSync(this.directory, { recursive: true });
75
+ writeFileSync(path, bytes);
76
+ }
77
+ catch (error) {
78
+ this.cli.writeError(`could not cache ${requestUri}: ${error instanceof Error ? error.message : error}`, false, {
79
+ scope: "cache",
80
+ data: {
81
+ url: requestUri,
82
+ bytes: bytes.length,
83
+ error: error instanceof Error ? error.message : String(error),
84
+ },
85
+ });
86
+ return;
87
+ }
88
+ this.entries.set(key, {
89
+ status: response.responseCode,
90
+ headers: response.responseHeaders.map((header) => ({ ...header })),
91
+ contentType: response.responseHeaders.find((header) => header.name.toLowerCase() === "content-type")?.value ?? null,
92
+ bytes: bytes.length,
93
+ sha: createHash("sha256").update(bytes).digest("hex").slice(0, 16),
94
+ path,
95
+ cachedAt: new Date().toISOString(),
96
+ });
20
97
  }
98
+ /** Note: a **substring** match over keys, not an exact one. It surprises people. */
21
99
  removeEntry(requestUri) {
22
- const keysToDelete = [];
23
- for (const key of this.inMemoryCache.keys()) {
24
- if (key.includes(requestUri)) {
25
- keysToDelete.push(key);
100
+ const needle = cacheKey(requestUri);
101
+ for (const [key, entry] of [...this.entries.entries()]) {
102
+ if (!key.includes(needle)) {
103
+ continue;
26
104
  }
27
- }
28
- for (const key of keysToDelete) {
29
- this.inMemoryCache.delete(key);
105
+ this.entries.delete(key);
106
+ this.unlink(entry.path);
30
107
  }
31
108
  }
32
109
  clear() {
33
- this.cli.writeSuccess("clear cached requests from local documentHandler");
34
- this.inMemoryCache.clear();
110
+ this.cli.writeSuccess("clear cached requests from local documentHandler", false, { scope: "cache", data: { cleared: this.entries.size } });
111
+ for (const entry of this.entries.values()) {
112
+ this.unlink(entry.path);
113
+ }
114
+ this.entries.clear();
115
+ }
116
+ /** Everything this cache wrote, for a run that is shutting down. */
117
+ destroy() {
118
+ this.entries.clear();
119
+ try {
120
+ rmSync(this.directory, { recursive: true, force: true });
121
+ }
122
+ catch {
123
+ // a cache we cannot delete is not worth failing a shutdown over
124
+ }
125
+ }
126
+ /**
127
+ * Named after the key, not the content.
128
+ *
129
+ * Content-addressing would let two urls with identical bodies share a file,
130
+ * and then evicting one would pull the body out from under the other.
131
+ */
132
+ pathFor(requestUri) {
133
+ const name = createHash("sha256")
134
+ .update(requestUri)
135
+ .digest("hex")
136
+ .slice(0, 32);
137
+ return join(this.directory, `${name}.body`);
138
+ }
139
+ unlink(path) {
140
+ try {
141
+ unlinkSync(path);
142
+ }
143
+ catch {
144
+ // already gone, which is the state we wanted
145
+ }
35
146
  }
36
147
  }
@@ -0,0 +1,66 @@
1
+ import { EventEmitter } from "node:events";
2
+ import { expect } from "chai";
3
+ import { describe, it } from "mocha";
4
+ import { answerDialogs } from "../../browser/answer-dialogs.js";
5
+ /** A dialog that records how it was answered. */
6
+ function dialog(type, answers) {
7
+ return {
8
+ type: () => type,
9
+ message: () => `${type} text`,
10
+ accept: async () => void answers.push(`${type}: accepted`),
11
+ dismiss: async () => void answers.push(`${type}: cancelled`),
12
+ };
13
+ }
14
+ const tick = () => new Promise((resolve) => setImmediate(resolve));
15
+ describe("answerDialogs", () => {
16
+ it("answers every dialog of open and later pages, and logs each", async () => {
17
+ const browser = new EventEmitter();
18
+ const page = Object.assign(new EventEmitter(), {
19
+ url: () => "https://shop.test/",
20
+ });
21
+ const later = Object.assign(new EventEmitter(), {
22
+ url: () => "https://shop.test/2",
23
+ });
24
+ browser.targets = () => [
25
+ { page: async () => page },
26
+ { page: async () => null },
27
+ ];
28
+ const warnings = [];
29
+ const answers = [];
30
+ answerDialogs(browser, {
31
+ writeWarning: (text) => void warnings.push(text),
32
+ });
33
+ browser.emit("targetcreated", { page: async () => later });
34
+ await tick();
35
+ page.emit("dialog", dialog("alert", answers));
36
+ page.emit("dialog", dialog("confirm", answers));
37
+ later.emit("dialog", dialog("beforeunload", answers));
38
+ later.emit("dialog", dialog("prompt", answers));
39
+ await tick();
40
+ expect(answers).to.deep.equal([
41
+ "alert: accepted",
42
+ "confirm: cancelled",
43
+ "beforeunload: accepted",
44
+ "prompt: cancelled",
45
+ ]);
46
+ expect(warnings).to.have.length(4);
47
+ expect(warnings[0]).to.contain('a dialog (alert: "alert text")');
48
+ });
49
+ it("stays quiet when a navigation already closed the dialog", async () => {
50
+ const browser = Object.assign(new EventEmitter(), {
51
+ targets: () => [],
52
+ });
53
+ const page = Object.assign(new EventEmitter(), {
54
+ url: () => "https://shop.test/",
55
+ });
56
+ answerDialogs(browser, { writeWarning: () => undefined });
57
+ browser.emit("targetcreated", { page: async () => page });
58
+ await tick();
59
+ const closed = {
60
+ ...dialog("alert", []),
61
+ accept: () => Promise.reject(new Error("No dialog is showing")),
62
+ };
63
+ page.emit("dialog", closed);
64
+ await tick();
65
+ });
66
+ });
@@ -0,0 +1,42 @@
1
+ import { EventEmitter } from "node:events";
2
+ import { expect } from "chai";
3
+ import { describe, it } from "mocha";
4
+ import { recordConsole } from "../../browser/console-log.js";
5
+ /** A page that emits what a test hands it. */
6
+ function fakePage() {
7
+ const page = new EventEmitter();
8
+ page.url = () => "https://shop.test/c/shoes";
9
+ return page;
10
+ }
11
+ function message(type, text) {
12
+ return {
13
+ type: () => type,
14
+ text: () => text,
15
+ location: () => ({ url: "https://shop.test/app.js" }),
16
+ };
17
+ }
18
+ describe("recordConsole", () => {
19
+ it("records warnings, errors and uncaught errors in the log only", () => {
20
+ const page = fakePage();
21
+ const logged = [];
22
+ recordConsole(page, {
23
+ logOnly: (...args) => logged.push(args),
24
+ });
25
+ page.emit("console", message("log", "noise"));
26
+ page.emit("console", message("warning", "deprecated"));
27
+ page.emit("console", message("error", "grid is undefined"));
28
+ page.emit("pageerror", new TypeError("x is not a function"));
29
+ expect(logged.map(([level, text]) => `${level} ${text}`)).to.deep.equal([
30
+ "warn deprecated",
31
+ "error grid is undefined",
32
+ "error x is not a function",
33
+ ]);
34
+ expect(logged[1][2]).to.deep.equal({
35
+ scope: "console",
36
+ data: {
37
+ page: "https://shop.test/c/shoes",
38
+ source: "https://shop.test/app.js",
39
+ },
40
+ });
41
+ });
42
+ });