@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,432 @@
1
+ import { expect } from "chai";
2
+ import { describe, it } from "mocha";
3
+ import { createContext, runInContext } from "node:vm";
4
+ import { BadRecipeParamsError, InjectSourceRequiredError, NoSuchPreloadError, PRELOAD_LIMIT, PreloadRegistry, TooManyPreloadsError, UnknownRecipeError, } from "../../control/preload-registry.js";
5
+ class FakeTransport {
6
+ pageAvailable = true;
7
+ added = [];
8
+ removed = [];
9
+ evaluated = [];
10
+ /** What `window.__sk_inject` holds, or null when nothing has run. */
11
+ page = null;
12
+ counter = 0;
13
+ async addScript(source) {
14
+ this.added.push(source);
15
+ this.counter += 1;
16
+ return `cdp-${this.counter}`;
17
+ }
18
+ async removeScript(identifier) {
19
+ this.removed.push(identifier);
20
+ }
21
+ async evaluate(expression) {
22
+ this.evaluated.push(expression);
23
+ if (expression.startsWith("JSON.stringify(window.__sk_inject")) {
24
+ return (this.page ? JSON.stringify(this.page) : null);
25
+ }
26
+ return undefined;
27
+ }
28
+ }
29
+ /**
30
+ * Run an injected script the way a browser would.
31
+ *
32
+ * Worth the vm rather than asserting on the source text: a recipe is a string
33
+ * this repo builds and nothing here compiles, so a syntax error or a typo'd
34
+ * property would otherwise reach a real page before anyone noticed. Running it
35
+ * proves it parses, installs, and — for `spy` — calls through.
36
+ */
37
+ function page(storage = new Map()) {
38
+ const window = {};
39
+ const listeners = {};
40
+ const marks = [];
41
+ const location = { href: "https://shop.example.com/" };
42
+ const history = {
43
+ pushState: (_state, _title, url) => {
44
+ location.href = url;
45
+ },
46
+ replaceState: (_state, _title, url) => {
47
+ location.href = url;
48
+ },
49
+ };
50
+ const context = createContext({
51
+ window,
52
+ location,
53
+ history,
54
+ addEventListener: (type, listener) => {
55
+ (listeners[type] ??= []).push(listener);
56
+ },
57
+ sessionStorage: {
58
+ getItem: (key) => storage.get(key) ?? null,
59
+ setItem: (key, value) => storage.set(key, value),
60
+ removeItem: (key) => storage.delete(key),
61
+ },
62
+ Date,
63
+ performance: {
64
+ timeOrigin: 1_700_000_000_000,
65
+ now: () => 0,
66
+ mark: (name) => {
67
+ marks.push(name);
68
+ },
69
+ },
70
+ // A no-op: every case here has its target present on the first attempt, so
71
+ // the poll never runs. A timer that fired synchronously would recurse.
72
+ setTimeout: () => 0,
73
+ setInterval: () => 0,
74
+ clearInterval: () => undefined,
75
+ });
76
+ return {
77
+ window,
78
+ marks,
79
+ history,
80
+ storage,
81
+ /** The page going away, as a navigation does. */
82
+ leave: () => (listeners.pagehide ?? []).forEach((listener) => listener()),
83
+ run: (source) => runInContext(source, context),
84
+ evaluate: (expression) => runInContext(expression, context),
85
+ slots: () => window.__sk_inject,
86
+ };
87
+ }
88
+ /** chai here has no promise plugin, so a rejection is caught rather than matched. */
89
+ async function rejection(work) {
90
+ try {
91
+ await work;
92
+ }
93
+ catch (error) {
94
+ return error;
95
+ }
96
+ throw new Error("expected a rejection, but the call resolved");
97
+ }
98
+ describe("PreloadRegistry", () => {
99
+ describe("what it refuses", () => {
100
+ it("should refuse both a recipe and raw source, and neither", async () => {
101
+ const registry = new PreloadRegistry(new FakeTransport());
102
+ expect(await rejection(registry.add({ recipe: "spy", source: "record(1)" }))).to.be.instanceOf(InjectSourceRequiredError);
103
+ expect(await rejection(registry.add({}))).to.be.instanceOf(InjectSourceRequiredError);
104
+ });
105
+ it("should name the recipes that exist when asked for one that does not", async () => {
106
+ const registry = new PreloadRegistry(new FakeTransport());
107
+ const error = await registry
108
+ .add({ recipe: "spie", params: { path: "dataLayer.push" } })
109
+ .catch((thrown) => thrown);
110
+ expect(error).to.be.instanceOf(UnknownRecipeError);
111
+ expect(error.recipes).to.contain("spy");
112
+ });
113
+ it("should refuse an unknown param rather than quietly using the default", async () => {
114
+ // The case this exists for: a caller that misspells `intervalMs` and is
115
+ // silently given 200 gets a timeline that looks right and is not the one
116
+ // it asked for.
117
+ const registry = new PreloadRegistry(new FakeTransport());
118
+ const error = await registry
119
+ .add({
120
+ recipe: "sample",
121
+ params: { expression: "1", intervalMS: 50 },
122
+ })
123
+ .catch((thrown) => thrown);
124
+ expect(error).to.be.instanceOf(BadRecipeParamsError);
125
+ expect(error.message).to.contain("intervalMS");
126
+ });
127
+ it("should name a missing required param", async () => {
128
+ const registry = new PreloadRegistry(new FakeTransport());
129
+ const error = await registry
130
+ .add({ recipe: "spy", params: {} })
131
+ .catch((thrown) => thrown);
132
+ expect(error).to.be.instanceOf(BadRecipeParamsError);
133
+ expect(error.message).to.contain("path");
134
+ });
135
+ it("should refuse a stub that names both a value and a return", async () => {
136
+ const registry = new PreloadRegistry(new FakeTransport());
137
+ expect(await rejection(registry.add({
138
+ recipe: "stub",
139
+ params: { path: "a.b", value: 1, returns: 2 },
140
+ }))).to.be.instanceOf(BadRecipeParamsError);
141
+ });
142
+ it("should stop at the limit and name what to remove", async () => {
143
+ const registry = new PreloadRegistry(new FakeTransport());
144
+ for (let index = 0; index < PRELOAD_LIMIT; index += 1) {
145
+ await registry.add({ source: "record(1)" });
146
+ }
147
+ const error = await registry
148
+ .add({ source: "record(1)" })
149
+ .catch((thrown) => thrown);
150
+ expect(error).to.be.instanceOf(TooManyPreloadsError);
151
+ expect(error.registered).to.have.length(PRELOAD_LIMIT);
152
+ });
153
+ it("should refuse to read a preload it does not have", async () => {
154
+ const registry = new PreloadRegistry(new FakeTransport());
155
+ expect(await rejection(registry.read("p9"))).to.be.instanceOf(NoSuchPreloadError);
156
+ });
157
+ });
158
+ describe("lifetime", () => {
159
+ it("should default to an expiry and let a caller opt out of one", async () => {
160
+ const registry = new PreloadRegistry(new FakeTransport());
161
+ const withDefault = await registry.add({ source: "record(1)" });
162
+ const forever = await registry.add({
163
+ source: "record(2)",
164
+ ttlMinutes: 0,
165
+ });
166
+ expect(withDefault.preload.expiresAt).to.be.a("string");
167
+ expect(forever.preload.expiresAt).to.equal(null);
168
+ });
169
+ it("should unregister and switch off the copy already running", async () => {
170
+ // Two halves, and only doing the first would leave a spy recording into
171
+ // a buffer nothing lists any more.
172
+ const transport = new FakeTransport();
173
+ const registry = new PreloadRegistry(transport);
174
+ const added = await registry.add({ source: "record(1)" });
175
+ const removed = await registry.remove(added.preload.id);
176
+ expect(transport.removed).to.have.length(1);
177
+ expect(removed.stoppedInPage).to.equal(true);
178
+ expect(transport.evaluated.at(-1)).to.contain("disabled = true");
179
+ });
180
+ it("should register everything again when the session is remade", async () => {
181
+ // A detached CDP session takes its registrations with it. Without this
182
+ // the entry survives while the script runs nowhere, and every empty
183
+ // buffer read afterwards is wrong in the same direction.
184
+ const transport = new FakeTransport();
185
+ const registry = new PreloadRegistry(transport);
186
+ await registry.add({ source: "record(1)" });
187
+ await registry.add({ source: "record(2)" });
188
+ const before = transport.added.length;
189
+ await registry.reapply();
190
+ expect(transport.added).to.have.length(before + 2);
191
+ });
192
+ it("should apply a mid-life recipe now and leave a document-start one alone", async () => {
193
+ const transport = new FakeTransport();
194
+ const registry = new PreloadRegistry(transport);
195
+ await registry.add({ recipe: "spy", params: { path: "dataLayer.push" } });
196
+ await registry.add({ recipe: "mark-timeline" });
197
+ const injected = transport.evaluated.filter((expression) => expression.includes("sourceURL=__sk-inject"));
198
+ // Exactly one of the two was run against the document that is loaded.
199
+ // `mark-timeline` wraps a seam that document has already passed, so
200
+ // running it now would only produce an empty buffer that reads like a
201
+ // finding.
202
+ expect(injected).to.have.length(1);
203
+ expect(injected[0]).to.contain("dataLayer.push");
204
+ });
205
+ });
206
+ describe("reading the buffer", () => {
207
+ it("should separate a script that has not run from one that saw nothing", async () => {
208
+ const transport = new FakeTransport();
209
+ const registry = new PreloadRegistry(transport);
210
+ const added = await registry.add({ recipe: "mark-timeline" });
211
+ const id = added.preload.id;
212
+ const beforeNavigation = await registry.read(id);
213
+ transport.page = {
214
+ [id]: { records: [], dropped: 0, disabled: false },
215
+ };
216
+ const afterNavigation = await registry.read(id);
217
+ expect(beforeNavigation.active).to.equal(false);
218
+ expect(beforeNavigation.records).to.equal(null);
219
+ expect(afterNavigation.active).to.equal(true);
220
+ expect(afterNavigation.records).to.deep.equal([]);
221
+ });
222
+ it("should return the newest records and say that it truncated", async () => {
223
+ const transport = new FakeTransport();
224
+ const registry = new PreloadRegistry(transport);
225
+ const added = await registry.add({ source: "record(1)" });
226
+ const id = added.preload.id;
227
+ transport.page = {
228
+ [id]: {
229
+ records: [1, 2, 3, 4, 5].map((value) => ({ t: value, v: value })),
230
+ dropped: 7,
231
+ disabled: false,
232
+ },
233
+ };
234
+ const read = await registry.read(id, 2);
235
+ expect(read.records).to.deep.equal([
236
+ { t: 4, v: 4 },
237
+ { t: 5, v: 5 },
238
+ ]);
239
+ expect(read.total).to.equal(5);
240
+ expect(read.truncated).to.equal(true);
241
+ expect(read.dropped).to.equal(7);
242
+ });
243
+ it("should answer without a page rather than failing", async () => {
244
+ const transport = new FakeTransport();
245
+ const registry = new PreloadRegistry(transport);
246
+ await registry.add({ source: "record(1)" });
247
+ transport.pageAvailable = false;
248
+ const listed = await registry.list();
249
+ expect(listed.preloads).to.have.length(1);
250
+ expect(listed.preloads[0].active).to.equal(false);
251
+ expect(listed.preloads[0].buffered).to.equal(null);
252
+ });
253
+ });
254
+ describe("which page load a record came from", () => {
255
+ it("should tag records with the load and url, and move on with a single-page navigation", async () => {
256
+ // Two loads' records in one buffer read as one load: web-vitals' CLS
257
+ // total kept climbing from one page into the next.
258
+ const transport = new FakeTransport();
259
+ const registry = new PreloadRegistry(transport);
260
+ const { window, run, slots, history } = page();
261
+ window.track = () => undefined;
262
+ await registry.add({ recipe: "spy", params: { path: "track" } });
263
+ run(transport.added[0]);
264
+ window.track();
265
+ history.pushState(null, "", "https://shop.example.com/p/2");
266
+ window.track();
267
+ const [first, second] = slots().p1.records;
268
+ expect(first.load).to.equal("1700000000000");
269
+ expect(first.url).to.equal("https://shop.example.com/");
270
+ expect(second.load).to.equal("1700000000000.1");
271
+ expect(second.url).to.equal("https://shop.example.com/p/2");
272
+ });
273
+ });
274
+ describe("across a hard navigation", () => {
275
+ it("should keep the last load's records, labelled, in the next document", async () => {
276
+ // The SSR load and the load Speed Kit hands over to are two documents;
277
+ // the first one's records used to go with it.
278
+ const transport = new FakeTransport();
279
+ const registry = new PreloadRegistry(transport);
280
+ await registry.add({ recipe: "spy", params: { path: "track" } });
281
+ const first = page();
282
+ first.window.track = () => undefined;
283
+ first.run(transport.added[0]);
284
+ first.window.track();
285
+ first.leave();
286
+ const second = page(first.storage);
287
+ second.window.track = () => undefined;
288
+ second.run(transport.added[0]);
289
+ second.window.track();
290
+ expect(second.slots().p1.records).to.have.lengthOf(2);
291
+ });
292
+ it("should not carry a reserved sampler's samples into the load it watches", async () => {
293
+ // fouc reloads and reads only that load; an earlier load's samples
294
+ // would read as part of it.
295
+ const transport = new FakeTransport();
296
+ const registry = new PreloadRegistry(transport);
297
+ await registry.reserve("fouc", "record(1);");
298
+ const first = page();
299
+ first.run(transport.added[0]);
300
+ first.leave();
301
+ const second = page(first.storage);
302
+ second.run(transport.added[0]);
303
+ expect(second.slots().fouc.records).to.have.lengthOf(1);
304
+ });
305
+ });
306
+ describe("what the recipes actually emit", () => {
307
+ it("should install a spy that calls through and keeps the return value", async () => {
308
+ const transport = new FakeTransport();
309
+ const registry = new PreloadRegistry(transport);
310
+ const { window, run, slots } = page();
311
+ const seen = [];
312
+ window.dataLayer = {
313
+ push: (value) => {
314
+ seen.push(value);
315
+ return 42;
316
+ },
317
+ };
318
+ await registry.add({ recipe: "spy", params: { path: "dataLayer.push" } });
319
+ run(transport.added[0]);
320
+ const returned = window.dataLayer.push({ event: "purchase" });
321
+ // A spy that changed either of these would be reporting on a page that no
322
+ // longer behaves like the one being debugged.
323
+ expect(seen).to.deep.equal([{ event: "purchase" }]);
324
+ expect(returned).to.equal(42);
325
+ expect(slots().p1.records).to.have.length(1);
326
+ expect(slots().p1.records[0].v).to.deep.equal({
327
+ call: "dataLayer.push",
328
+ args: [{ event: "purchase" }],
329
+ });
330
+ });
331
+ it("should wrap performance.mark without swallowing the call", async () => {
332
+ const transport = new FakeTransport();
333
+ const registry = new PreloadRegistry(transport);
334
+ const { marks, run, evaluate, slots } = page();
335
+ await registry.add({ recipe: "mark-timeline" });
336
+ run(transport.added[0]);
337
+ evaluate('performance.mark("baqend-blocking-script-start")');
338
+ expect(marks).to.deep.equal(["baqend-blocking-script-start"]);
339
+ expect(slots().p1.records[0].v).to.deep.equal({
340
+ mark: "baqend-blocking-script-start",
341
+ });
342
+ });
343
+ it("should honour a mark pattern", async () => {
344
+ const transport = new FakeTransport();
345
+ const registry = new PreloadRegistry(transport);
346
+ const { run, evaluate, slots } = page();
347
+ await registry.add({
348
+ recipe: "mark-timeline",
349
+ params: { pattern: "^sk-" },
350
+ });
351
+ run(transport.added[0]);
352
+ evaluate('performance.mark("baqend-blocking-script-start")');
353
+ evaluate('performance.mark("sk-prerender-observe-end")');
354
+ expect(slots().p1.records).to.have.length(1);
355
+ expect(slots().p1.records[0].v).to.deep.equal({
356
+ mark: "sk-prerender-observe-end",
357
+ });
358
+ });
359
+ it("should install a stub that answers with what was asked for", async () => {
360
+ const transport = new FakeTransport();
361
+ const registry = new PreloadRegistry(transport);
362
+ const { window, run } = page();
363
+ window.sk = { device: () => "desktop" };
364
+ await registry.add({
365
+ recipe: "stub",
366
+ params: { path: "sk.device", returns: "mobile" },
367
+ });
368
+ run(transport.added[0]);
369
+ expect(window.sk.device()).to.equal("mobile");
370
+ });
371
+ it("should not wrap a seam twice when the same script runs again", async () => {
372
+ // A document that somehow runs it twice — a re-apply after a reconnect —
373
+ // must not report every call twice.
374
+ const transport = new FakeTransport();
375
+ const registry = new PreloadRegistry(transport);
376
+ const { window, run, slots } = page();
377
+ window.dataLayer = { push: () => undefined };
378
+ await registry.add({ recipe: "spy", params: { path: "dataLayer.push" } });
379
+ run(transport.added[0]);
380
+ run(transport.added[0]);
381
+ window.dataLayer.push({ a: 1 });
382
+ expect(slots().p1.records).to.have.length(1);
383
+ });
384
+ it("should survive raw source that throws, and report why", async () => {
385
+ // A preload runs in the MAIN world before any page script, so an
386
+ // unguarded throw here is thrown before the site has run a line.
387
+ const transport = new FakeTransport();
388
+ const registry = new PreloadRegistry(transport);
389
+ const { run, slots } = page();
390
+ await registry.add({ source: 'throw new Error("boom");' });
391
+ run(transport.added[0]);
392
+ expect(slots().p1.error).to.contain("boom");
393
+ });
394
+ it("should reach a global as a property rather than a bare identifier", async () => {
395
+ // A bare identifier that does not exist throws a ReferenceError that
396
+ // takes the whole injected script with it.
397
+ const transport = new FakeTransport();
398
+ const registry = new PreloadRegistry(transport);
399
+ const { run, slots } = page();
400
+ await registry.add({
401
+ recipe: "spy",
402
+ params: { path: "nothing.here.at.all" },
403
+ });
404
+ run(transport.added[0]);
405
+ expect(slots().p1.error).to.equal(undefined);
406
+ });
407
+ it("should name itself in a stack trace", async () => {
408
+ const registry = new PreloadRegistry(new FakeTransport());
409
+ const added = await registry.add({ source: "record(1)" });
410
+ expect(added.preload.bytes).to.be.greaterThan(0);
411
+ expect(added.preload.sourceSha).to.have.length(12);
412
+ });
413
+ });
414
+ describe("recipes()", () => {
415
+ it("should describe every recipe without leaking its builder", () => {
416
+ const registry = new PreloadRegistry(new FakeTransport());
417
+ const { recipes } = registry.recipes();
418
+ expect(recipes.map((recipe) => recipe.name)).to.deep.equal([
419
+ "mark-timeline",
420
+ "sample",
421
+ "spy",
422
+ "web-vitals",
423
+ "stub",
424
+ ]);
425
+ expect(recipes[0]).to.not.have.property("build");
426
+ // The one param that is inlined as code rather than as a literal. A
427
+ // caller has to know which of its arguments is about to be evaluated.
428
+ const sample = recipes.find((recipe) => recipe.name === "sample");
429
+ expect(sample?.params.find((param) => param.name === "expression")?.code).to.equal(true);
430
+ });
431
+ });
432
+ });