@speedkit/cli 4.51.1 → 4.52.1

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 (442) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/README.md +1426 -14
  3. package/dist/base/run-control-command.d.ts +15 -0
  4. package/dist/base/run-control-command.js +20 -0
  5. package/dist/build-info.json +6 -0
  6. package/dist/commands/diff.d.ts +7 -1
  7. package/dist/commands/diff.js +9 -3
  8. package/dist/commands/login.d.ts +3 -0
  9. package/dist/commands/login.js +14 -3
  10. package/dist/commands/onboarding/browser/click.d.ts +75 -0
  11. package/dist/commands/onboarding/browser/click.js +19 -0
  12. package/dist/commands/onboarding/browser/emulate.d.ts +105 -0
  13. package/dist/commands/onboarding/browser/emulate.js +26 -0
  14. package/dist/commands/onboarding/browser/navigate.d.ts +75 -0
  15. package/dist/commands/onboarding/browser/navigate.js +19 -0
  16. package/dist/commands/onboarding/browser/panel.d.ts +63 -0
  17. package/dist/commands/onboarding/browser/panel.js +12 -0
  18. package/dist/commands/onboarding/browser/reinstall-sw.d.ts +63 -0
  19. package/dist/commands/onboarding/browser/reinstall-sw.js +14 -0
  20. package/dist/commands/onboarding/browser/reset.d.ts +71 -0
  21. package/dist/commands/onboarding/browser/reset.js +18 -0
  22. package/dist/commands/onboarding/browser/screenshot.d.ts +77 -0
  23. package/dist/commands/onboarding/browser/screenshot.js +19 -0
  24. package/dist/commands/onboarding/browser/state.d.ts +63 -0
  25. package/dist/commands/onboarding/browser/state.js +12 -0
  26. package/dist/commands/onboarding/browser/tabs.d.ts +58 -0
  27. package/dist/commands/onboarding/browser/tabs.js +16 -0
  28. package/dist/commands/onboarding/cache/clear.d.ts +58 -0
  29. package/dist/commands/onboarding/cache/clear.js +12 -0
  30. package/dist/commands/onboarding/cache/errors.d.ts +58 -0
  31. package/dist/commands/onboarding/cache/errors.js +12 -0
  32. package/dist/commands/onboarding/cache/evict.d.ts +62 -0
  33. package/dist/commands/onboarding/cache/evict.js +15 -0
  34. package/dist/commands/onboarding/cache/get.d.ts +85 -0
  35. package/dist/commands/onboarding/cache/get.js +17 -0
  36. package/dist/commands/onboarding/cache/list.d.ts +58 -0
  37. package/dist/commands/onboarding/cache/list.js +15 -0
  38. package/dist/commands/onboarding/cache/prewarm.d.ts +73 -0
  39. package/dist/commands/onboarding/cache/prewarm.js +20 -0
  40. package/dist/commands/onboarding/cache/refresh.d.ts +62 -0
  41. package/dist/commands/onboarding/cache/refresh.js +18 -0
  42. package/dist/commands/onboarding/cdp.d.ts +81 -0
  43. package/dist/commands/onboarding/cdp.js +18 -0
  44. package/dist/commands/onboarding/debug/arm.d.ts +83 -0
  45. package/dist/commands/onboarding/debug/arm.js +19 -0
  46. package/dist/commands/onboarding/debug/await.d.ts +71 -0
  47. package/dist/commands/onboarding/debug/await.js +18 -0
  48. package/dist/commands/onboarding/debug/disarm.d.ts +63 -0
  49. package/dist/commands/onboarding/debug/disarm.js +12 -0
  50. package/dist/commands/onboarding/debug/eval.d.ts +75 -0
  51. package/dist/commands/onboarding/debug/eval.js +16 -0
  52. package/dist/commands/onboarding/debug/release.d.ts +63 -0
  53. package/dist/commands/onboarding/debug/release.js +12 -0
  54. package/dist/commands/onboarding/debug/resume.d.ts +63 -0
  55. package/dist/commands/onboarding/debug/resume.js +12 -0
  56. package/dist/commands/onboarding/debug/status.d.ts +63 -0
  57. package/dist/commands/onboarding/debug/status.js +12 -0
  58. package/dist/commands/onboarding/debug/step.d.ts +67 -0
  59. package/dist/commands/onboarding/debug/step.js +15 -0
  60. package/dist/commands/onboarding/files/list.d.ts +58 -0
  61. package/dist/commands/onboarding/files/list.js +12 -0
  62. package/dist/commands/onboarding/files/read.d.ts +73 -0
  63. package/dist/commands/onboarding/files/read.js +16 -0
  64. package/dist/commands/onboarding/files/rebuild.d.ts +63 -0
  65. package/dist/commands/onboarding/files/rebuild.js +18 -0
  66. package/dist/commands/onboarding/files/validate.d.ts +58 -0
  67. package/dist/commands/onboarding/files/validate.js +12 -0
  68. package/dist/commands/onboarding/fouc.d.ts +77 -0
  69. package/dist/commands/onboarding/fouc.js +16 -0
  70. package/dist/commands/onboarding/inject/add.d.ts +89 -0
  71. package/dist/commands/onboarding/inject/add.js +17 -0
  72. package/dist/commands/onboarding/inject/clear.d.ts +63 -0
  73. package/dist/commands/onboarding/inject/clear.js +12 -0
  74. package/dist/commands/onboarding/inject/list.d.ts +63 -0
  75. package/dist/commands/onboarding/inject/list.js +12 -0
  76. package/dist/commands/onboarding/inject/read.d.ts +75 -0
  77. package/dist/commands/onboarding/inject/read.js +18 -0
  78. package/dist/commands/onboarding/inject/recipes.d.ts +63 -0
  79. package/dist/commands/onboarding/inject/recipes.js +12 -0
  80. package/dist/commands/onboarding/inject/remove.d.ts +67 -0
  81. package/dist/commands/onboarding/inject/remove.js +15 -0
  82. package/dist/commands/onboarding/list.d.ts +13 -0
  83. package/dist/commands/onboarding/list.js +12 -0
  84. package/dist/commands/onboarding/logs.d.ts +41 -0
  85. package/dist/commands/onboarding/logs.js +257 -0
  86. package/dist/commands/onboarding/navwalk.d.ts +95 -0
  87. package/dist/commands/onboarding/navwalk.js +19 -0
  88. package/dist/commands/onboarding/response.d.ts +67 -0
  89. package/dist/commands/onboarding/response.js +18 -0
  90. package/dist/commands/onboarding/rum/beacons.d.ts +75 -0
  91. package/dist/commands/onboarding/rum/beacons.js +16 -0
  92. package/dist/commands/onboarding/rum/get.d.ts +77 -0
  93. package/dist/commands/onboarding/rum/get.js +18 -0
  94. package/dist/commands/onboarding/rum/key.d.ts +67 -0
  95. package/dist/commands/onboarding/rum/key.js +13 -0
  96. package/dist/commands/onboarding/rum/previous.d.ts +63 -0
  97. package/dist/commands/onboarding/rum/previous.js +12 -0
  98. package/dist/commands/onboarding/status.d.ts +13 -0
  99. package/dist/commands/onboarding/status.js +17 -0
  100. package/dist/commands/onboarding/stop.d.ts +13 -0
  101. package/dist/commands/onboarding/stop.js +17 -0
  102. package/dist/commands/onboarding/todo.d.ts +58 -0
  103. package/dist/commands/onboarding/todo.js +12 -0
  104. package/dist/commands/onboarding/viewport.d.ts +101 -0
  105. package/dist/commands/onboarding/viewport.js +18 -0
  106. package/dist/commands/onboarding/watch.d.ts +93 -0
  107. package/dist/commands/onboarding/watch.js +16 -0
  108. package/dist/commands/onboarding.d.ts +26 -0
  109. package/dist/commands/onboarding.js +221 -4
  110. package/dist/commands/origin-request.d.ts +4 -0
  111. package/dist/commands/origin-request.js +4 -0
  112. package/dist/commands/spec/onboarding.spec.d.ts +1 -0
  113. package/dist/commands/spec/onboarding.spec.js +127 -0
  114. package/dist/services/browser-fetch/device-emulation.d.ts +11 -0
  115. package/dist/services/browser-fetch/device-emulation.js +14 -0
  116. package/dist/services/cli/build-info.d.ts +33 -0
  117. package/dist/services/cli/build-info.js +63 -0
  118. package/dist/services/cli/cli-environment-factory.d.ts +3 -0
  119. package/dist/services/cli/cli-environment-factory.js +1 -0
  120. package/dist/services/cli/cli-service-build-context.d.ts +3 -0
  121. package/dist/services/cli/cli-service-factory.js +1 -1
  122. package/dist/services/cli/cli-service-model.d.ts +29 -10
  123. package/dist/services/cli/cli-service.d.ts +60 -11
  124. package/dist/services/cli/cli-service.js +196 -32
  125. package/dist/services/cli/index.d.ts +2 -0
  126. package/dist/services/cli/index.js +2 -0
  127. package/dist/services/cli/sink.d.ts +47 -0
  128. package/dist/services/cli/sink.js +31 -0
  129. package/dist/services/cli/spec/build-identity.spec.d.ts +1 -0
  130. package/dist/services/cli/spec/build-identity.spec.js +85 -0
  131. package/dist/services/cli/spec/build-info.spec.d.ts +1 -0
  132. package/dist/services/cli/spec/build-info.spec.js +10 -0
  133. package/dist/services/cli/spec/cli-service-log.spec.d.ts +1 -0
  134. package/dist/services/cli/spec/cli-service-log.spec.js +133 -0
  135. package/dist/services/cli/spec/cli-service.spec.js +113 -50
  136. package/dist/services/cli/spec/memory-cli.d.ts +9 -0
  137. package/dist/services/cli/spec/memory-cli.js +9 -0
  138. package/dist/services/diff/config-at-ref.d.ts +20 -0
  139. package/dist/services/diff/config-at-ref.js +33 -0
  140. package/dist/services/diff/diff-service-build-context.d.ts +12 -0
  141. package/dist/services/diff/diff-service-build-context.js +45 -1
  142. package/dist/services/diff/diff-service-factory.d.ts +2 -0
  143. package/dist/services/diff/diff-service-factory.js +65 -25
  144. package/dist/services/diff/diff-service.d.ts +11 -0
  145. package/dist/services/diff/diff-service.js +37 -11
  146. package/dist/services/diff/page-source.d.ts +12 -0
  147. package/dist/services/diff/page-source.js +16 -11
  148. package/dist/services/diff/run-runtime-config.d.ts +33 -0
  149. package/dist/services/diff/run-runtime-config.js +74 -0
  150. package/dist/services/diff/sinks/tool-diff-sink.d.ts +3 -2
  151. package/dist/services/diff/sinks/tool-diff-sink.js +3 -2
  152. package/dist/services/diff/spec/config-at-ref.spec.d.ts +1 -0
  153. package/dist/services/diff/spec/config-at-ref.spec.js +46 -0
  154. package/dist/services/diff/spec/diff-service-build-context.spec.js +19 -0
  155. package/dist/services/diff/spec/diff-service.spec.js +95 -0
  156. package/dist/services/diff/spec/run-runtime-config.spec.d.ts +1 -0
  157. package/dist/services/diff/spec/run-runtime-config.spec.js +87 -0
  158. package/dist/services/git/git-repository.d.ts +2 -0
  159. package/dist/services/git/git-repository.js +6 -0
  160. package/dist/services/integration-api/customer-config-flags.js +1 -0
  161. package/dist/services/onboarding/browse/browse-service.d.ts +13 -1
  162. package/dist/services/onboarding/browse/browse-service.js +43 -7
  163. package/dist/services/onboarding/browser/answer-dialogs.d.ts +12 -0
  164. package/dist/services/onboarding/browser/answer-dialogs.js +25 -0
  165. package/dist/services/onboarding/browser/baqend-response.d.ts +17 -1
  166. package/dist/services/onboarding/browser/baqend-response.js +23 -0
  167. package/dist/services/onboarding/browser/console-log.d.ts +9 -0
  168. package/dist/services/onboarding/browser/console-log.js +27 -0
  169. package/dist/services/onboarding/browser/emulate-device.d.ts +12 -1
  170. package/dist/services/onboarding/browser/emulate-device.js +68 -13
  171. package/dist/services/onboarding/browser/executable/executable-validator.js +4 -2
  172. package/dist/services/onboarding/browser/extension/extension-bridge.js +5 -3
  173. package/dist/services/onboarding/browser/extension/extension-downloader.js +17 -8
  174. package/dist/services/onboarding/browser/extension/extension-validator.js +9 -4
  175. package/dist/services/onboarding/browser/launch-browser.d.ts +2 -1
  176. package/dist/services/onboarding/browser/launch-browser.js +6 -1
  177. package/dist/services/onboarding/browser/resume-restarted-workers.d.ts +14 -0
  178. package/dist/services/onboarding/browser/resume-restarted-workers.js +26 -0
  179. package/dist/services/onboarding/control/body-inspect.d.ts +24 -0
  180. package/dist/services/onboarding/control/body-inspect.js +106 -0
  181. package/dist/services/onboarding/control/browser-session.d.ts +547 -0
  182. package/dist/services/onboarding/control/browser-session.js +1337 -0
  183. package/dist/services/onboarding/control/config-validation.d.ts +17 -0
  184. package/dist/services/onboarding/control/config-validation.js +46 -0
  185. package/dist/services/onboarding/control/control-protocol.d.ts +1430 -0
  186. package/dist/services/onboarding/control/control-protocol.js +58 -0
  187. package/dist/services/onboarding/control/control-server.d.ts +292 -0
  188. package/dist/services/onboarding/control/control-server.js +1629 -0
  189. package/dist/services/onboarding/control/debug-session.d.ts +219 -0
  190. package/dist/services/onboarding/control/debug-session.js +897 -0
  191. package/dist/services/onboarding/control/fouc.d.ts +23 -0
  192. package/dist/services/onboarding/control/fouc.js +151 -0
  193. package/dist/services/onboarding/control/index.d.ts +4 -0
  194. package/dist/services/onboarding/control/index.js +4 -0
  195. package/dist/services/onboarding/control/navigate-wait.d.ts +33 -0
  196. package/dist/services/onboarding/control/navigate-wait.js +56 -0
  197. package/dist/services/onboarding/control/navwalk.d.ts +65 -0
  198. package/dist/services/onboarding/control/navwalk.js +248 -0
  199. package/dist/services/onboarding/control/preload-registry.d.ts +150 -0
  200. package/dist/services/onboarding/control/preload-registry.js +829 -0
  201. package/dist/services/onboarding/control/response-explainer.d.ts +24 -0
  202. package/dist/services/onboarding/control/response-explainer.js +257 -0
  203. package/dist/services/onboarding/control/rum.d.ts +8 -0
  204. package/dist/services/onboarding/control/rum.js +220 -0
  205. package/dist/services/onboarding/control/service-worker-tracker.d.ts +68 -0
  206. package/dist/services/onboarding/control/service-worker-tracker.js +120 -0
  207. package/dist/services/onboarding/control/viewport.d.ts +45 -0
  208. package/dist/services/onboarding/control/viewport.js +344 -0
  209. package/dist/services/onboarding/control/watch.d.ts +26 -0
  210. package/dist/services/onboarding/control/watch.js +157 -0
  211. package/dist/services/onboarding/dashboard/diff-against-current-page.js +3 -1
  212. package/dist/services/onboarding/dashboard/index.js +7 -2
  213. package/dist/services/onboarding/fetch-event-handler.d.ts +24 -5
  214. package/dist/services/onboarding/fetch-event-handler.js +103 -32
  215. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +11 -2
  216. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +14 -0
  217. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +30 -0
  218. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +13 -0
  219. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +28 -1
  220. package/dist/services/onboarding/file-events/file-watcher.d.ts +42 -1
  221. package/dist/services/onboarding/file-events/file-watcher.js +117 -12
  222. package/dist/services/onboarding/inject/inject-service.js +1 -1
  223. package/dist/services/onboarding/onboarding-model.d.ts +40 -7
  224. package/dist/services/onboarding/onboarding-model.js +20 -9
  225. package/dist/services/onboarding/onboarding-service-build-context.d.ts +4 -0
  226. package/dist/services/onboarding/onboarding-service-build-context.js +7 -1
  227. package/dist/services/onboarding/onboarding-service-factory.d.ts +17 -1
  228. package/dist/services/onboarding/onboarding-service-factory.js +150 -23
  229. package/dist/services/onboarding/onboarding-service.d.ts +40 -1
  230. package/dist/services/onboarding/onboarding-service.js +139 -23
  231. package/dist/services/onboarding/request-cache/asset-key.d.ts +61 -0
  232. package/dist/services/onboarding/request-cache/asset-key.js +115 -0
  233. package/dist/services/onboarding/request-cache/cache.d.ts +62 -5
  234. package/dist/services/onboarding/request-cache/cache.js +128 -17
  235. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.d.ts +1 -0
  236. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.js +66 -0
  237. package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +1 -0
  238. package/dist/services/onboarding/spec/browser/console-log.spec.js +42 -0
  239. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.d.ts +1 -0
  240. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.js +45 -0
  241. package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +1 -0
  242. package/dist/services/onboarding/spec/control/browser-session.spec.js +753 -0
  243. package/dist/services/onboarding/spec/control/control-server.spec.d.ts +1 -0
  244. package/dist/services/onboarding/spec/control/control-server.spec.js +371 -0
  245. package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +1 -0
  246. package/dist/services/onboarding/spec/control/debug-session.spec.js +751 -0
  247. package/dist/services/onboarding/spec/control/fakes.d.ts +31 -0
  248. package/dist/services/onboarding/spec/control/fakes.js +67 -0
  249. package/dist/services/onboarding/spec/control/fouc.spec.d.ts +1 -0
  250. package/dist/services/onboarding/spec/control/fouc.spec.js +167 -0
  251. package/dist/services/onboarding/spec/control/navigate-wait.spec.d.ts +1 -0
  252. package/dist/services/onboarding/spec/control/navigate-wait.spec.js +47 -0
  253. package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +1 -0
  254. package/dist/services/onboarding/spec/control/navwalk.spec.js +222 -0
  255. package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +1 -0
  256. package/dist/services/onboarding/spec/control/preload-registry.spec.js +432 -0
  257. package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +1 -0
  258. package/dist/services/onboarding/spec/control/response-explainer.spec.js +324 -0
  259. package/dist/services/onboarding/spec/control/rum.spec.d.ts +1 -0
  260. package/dist/services/onboarding/spec/control/rum.spec.js +222 -0
  261. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +1 -0
  262. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +193 -0
  263. package/dist/services/onboarding/spec/control/viewport.spec.d.ts +1 -0
  264. package/dist/services/onboarding/spec/control/viewport.spec.js +200 -0
  265. package/dist/services/onboarding/spec/control/watch.spec.d.ts +1 -0
  266. package/dist/services/onboarding/spec/control/watch.spec.js +187 -0
  267. package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +1 -0
  268. package/dist/services/onboarding/spec/fetch-event-handler.spec.js +219 -0
  269. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +1 -0
  270. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +41 -0
  271. package/dist/services/onboarding/spec/onboarding-model.spec.js +39 -3
  272. package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +25 -1
  273. package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +1 -0
  274. package/dist/services/onboarding/spec/request-cache/cache.spec.js +107 -0
  275. package/dist/services/onboarding/spec/todo-collector.spec.d.ts +1 -0
  276. package/dist/services/onboarding/spec/todo-collector.spec.js +136 -0
  277. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.d.ts +1 -0
  278. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.js +65 -0
  279. package/dist/services/onboarding/templates/install-speed-kit-html-template.js +11 -0
  280. package/dist/services/onboarding/templates/spec/install-speed-kit-html-template.spec.d.ts +1 -0
  281. package/dist/services/onboarding/templates/spec/install-speed-kit-html-template.spec.js +119 -0
  282. package/dist/services/onboarding/todo-collector.d.ts +7 -2
  283. package/dist/services/onboarding/todo-collector.js +49 -12
  284. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +38 -0
  285. package/dist/services/onboarding/virtual-orestes-app/index.js +113 -27
  286. package/dist/services/origin-request/asset-variations.d.ts +14 -0
  287. package/dist/services/origin-request/asset-variations.js +11 -4
  288. package/dist/services/origin-request/origin-fetcher.d.ts +7 -0
  289. package/dist/services/origin-request/origin-fetcher.js +43 -5
  290. package/dist/services/origin-request/origin-request-service-build-context.d.ts +17 -0
  291. package/dist/services/origin-request/origin-request-service-build-context.js +8 -0
  292. package/dist/services/origin-request/origin-request-service-factory.d.ts +0 -5
  293. package/dist/services/origin-request/origin-request-service-factory.js +2 -30
  294. package/dist/services/origin-request/origin-request-service.d.ts +121 -6
  295. package/dist/services/origin-request/origin-request-service.js +273 -49
  296. package/dist/services/origin-request/runtime-config-source.d.ts +6 -0
  297. package/dist/services/origin-request/runtime-config-source.js +15 -4
  298. package/dist/services/origin-request/spec/asset-variations.spec.js +20 -0
  299. package/dist/services/origin-request/spec/origin-request-service.spec.js +329 -6
  300. package/dist/services/query-builder/rules/rule-match.d.ts +35 -0
  301. package/dist/services/query-builder/rules/rule-match.js +70 -0
  302. package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +1 -0
  303. package/dist/services/query-builder/spec/rules/rule-match.spec.js +121 -0
  304. package/dist/services/run-control/browser/run-browser-contexts.d.ts +557 -0
  305. package/dist/services/run-control/browser/run-browser-contexts.js +91 -0
  306. package/dist/services/run-control/browser/run-browser-service-factory.d.ts +5 -0
  307. package/dist/services/run-control/browser/run-browser-service-factory.js +7 -0
  308. package/dist/services/run-control/browser/run-browser-service.d.ts +68 -0
  309. package/dist/services/run-control/browser/run-browser-service.js +206 -0
  310. package/dist/services/run-control/cache/run-cache-contexts.d.ts +349 -0
  311. package/dist/services/run-control/cache/run-cache-contexts.js +51 -0
  312. package/dist/services/run-control/cache/run-cache-service-factory.d.ts +6 -0
  313. package/dist/services/run-control/cache/run-cache-service-factory.js +12 -0
  314. package/dist/services/run-control/cache/run-cache-service.d.ts +35 -0
  315. package/dist/services/run-control/cache/run-cache-service.js +151 -0
  316. package/dist/services/run-control/control-client.d.ts +36 -0
  317. package/dist/services/run-control/control-client.js +147 -0
  318. package/dist/services/run-control/debug/run-debug-contexts.d.ts +416 -0
  319. package/dist/services/run-control/debug/run-debug-contexts.js +47 -0
  320. package/dist/services/run-control/debug/run-debug-service-factory.d.ts +5 -0
  321. package/dist/services/run-control/debug/run-debug-service-factory.js +7 -0
  322. package/dist/services/run-control/debug/run-debug-service.d.ts +39 -0
  323. package/dist/services/run-control/debug/run-debug-service.js +164 -0
  324. package/dist/services/run-control/files/run-files-contexts.d.ts +238 -0
  325. package/dist/services/run-control/files/run-files-contexts.js +26 -0
  326. package/dist/services/run-control/files/run-files-service-factory.d.ts +5 -0
  327. package/dist/services/run-control/files/run-files-service-factory.js +7 -0
  328. package/dist/services/run-control/files/run-files-service.d.ts +29 -0
  329. package/dist/services/run-control/files/run-files-service.js +120 -0
  330. package/dist/services/run-control/index.d.ts +32 -0
  331. package/dist/services/run-control/index.js +31 -0
  332. package/dist/services/run-control/inject/run-inject-contexts.d.ts +319 -0
  333. package/dist/services/run-control/inject/run-inject-contexts.js +38 -0
  334. package/dist/services/run-control/inject/run-inject-service-factory.d.ts +5 -0
  335. package/dist/services/run-control/inject/run-inject-service-factory.js +7 -0
  336. package/dist/services/run-control/inject/run-inject-service.d.ts +31 -0
  337. package/dist/services/run-control/inject/run-inject-service.js +227 -0
  338. package/dist/services/run-control/live-run.d.ts +37 -0
  339. package/dist/services/run-control/live-run.js +56 -0
  340. package/dist/services/run-control/probe/run-probe-contexts.d.ts +333 -0
  341. package/dist/services/run-control/probe/run-probe-contexts.js +73 -0
  342. package/dist/services/run-control/probe/run-probe-service-factory.d.ts +5 -0
  343. package/dist/services/run-control/probe/run-probe-service-factory.js +7 -0
  344. package/dist/services/run-control/probe/run-probe-service.d.ts +54 -0
  345. package/dist/services/run-control/probe/run-probe-service.js +194 -0
  346. package/dist/services/run-control/rum/run-rum-contexts.d.ts +216 -0
  347. package/dist/services/run-control/rum/run-rum-contexts.js +34 -0
  348. package/dist/services/run-control/rum/run-rum-service-factory.d.ts +5 -0
  349. package/dist/services/run-control/rum/run-rum-service-factory.js +7 -0
  350. package/dist/services/run-control/rum/run-rum-service.d.ts +36 -0
  351. package/dist/services/run-control/rum/run-rum-service.js +122 -0
  352. package/dist/services/run-control/run-answer.d.ts +28 -0
  353. package/dist/services/run-control/run-answer.js +58 -0
  354. package/dist/services/run-control/run-control-context.d.ts +102 -0
  355. package/dist/services/run-control/run-control-context.js +36 -0
  356. package/dist/services/run-control/run-control-flags.d.ts +12 -0
  357. package/dist/services/run-control/run-control-flags.js +22 -0
  358. package/dist/services/run-control/run-control-model.d.ts +9 -0
  359. package/dist/services/run-control/run-control-model.js +1 -0
  360. package/dist/services/run-control/run-control-service-factory.d.ts +14 -0
  361. package/dist/services/run-control/run-control-service-factory.js +26 -0
  362. package/dist/services/run-control/session/run-session-contexts.d.ts +25 -0
  363. package/dist/services/run-control/session/run-session-contexts.js +20 -0
  364. package/dist/services/run-control/session/run-session-service-factory.d.ts +8 -0
  365. package/dist/services/run-control/session/run-session-service-factory.js +18 -0
  366. package/dist/services/run-control/session/run-session-service.d.ts +32 -0
  367. package/dist/services/run-control/session/run-session-service.js +151 -0
  368. package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +1 -0
  369. package/dist/services/run-control/spec/browser/run-browser-service.spec.js +328 -0
  370. package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +1 -0
  371. package/dist/services/run-control/spec/cache/run-cache-service.spec.js +454 -0
  372. package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +1 -0
  373. package/dist/services/run-control/spec/debug/run-debug-service.spec.js +113 -0
  374. package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +1 -0
  375. package/dist/services/run-control/spec/files/run-files-service.spec.js +234 -0
  376. package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +1 -0
  377. package/dist/services/run-control/spec/inject/run-inject-service.spec.js +251 -0
  378. package/dist/services/run-control/spec/live-run-fixture.d.ts +32 -0
  379. package/dist/services/run-control/spec/live-run-fixture.js +109 -0
  380. package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +1 -0
  381. package/dist/services/run-control/spec/probe/run-probe-service.spec.js +108 -0
  382. package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +1 -0
  383. package/dist/services/run-control/spec/rum/run-rum-service.spec.js +47 -0
  384. package/dist/services/run-control/spec/run-answer.spec.d.ts +1 -0
  385. package/dist/services/run-control/spec/run-answer.spec.js +57 -0
  386. package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +1 -0
  387. package/dist/services/run-control/spec/session/run-session-service.spec.js +150 -0
  388. package/dist/services/run-log/crash-mirror.d.ts +31 -0
  389. package/dist/services/run-log/crash-mirror.js +69 -0
  390. package/dist/services/run-log/index.d.ts +11 -0
  391. package/dist/services/run-log/index.js +11 -0
  392. package/dist/services/run-log/jsonl-appender.d.ts +46 -0
  393. package/dist/services/run-log/jsonl-appender.js +91 -0
  394. package/dist/services/run-log/log-event-model.d.ts +104 -0
  395. package/dist/services/run-log/log-event-model.js +56 -0
  396. package/dist/services/run-log/log-query-service-factory.d.ts +11 -0
  397. package/dist/services/run-log/log-query-service-factory.js +14 -0
  398. package/dist/services/run-log/log-query-service.d.ts +59 -0
  399. package/dist/services/run-log/log-query-service.js +111 -0
  400. package/dist/services/run-log/log-reader.d.ts +84 -0
  401. package/dist/services/run-log/log-reader.js +180 -0
  402. package/dist/services/run-log/log-summary.d.ts +72 -0
  403. package/dist/services/run-log/log-summary.js +208 -0
  404. package/dist/services/run-log/redaction.d.ts +34 -0
  405. package/dist/services/run-log/redaction.js +124 -0
  406. package/dist/services/run-log/request-log.d.ts +82 -0
  407. package/dist/services/run-log/request-log.js +69 -0
  408. package/dist/services/run-log/request-summary.d.ts +76 -0
  409. package/dist/services/run-log/request-summary.js +0 -0
  410. package/dist/services/run-log/run-log.d.ts +61 -0
  411. package/dist/services/run-log/run-log.js +102 -0
  412. package/dist/services/run-log/spec/log-query-service.spec.d.ts +1 -0
  413. package/dist/services/run-log/spec/log-query-service.spec.js +197 -0
  414. package/dist/services/run-log/spec/log-reader.spec.d.ts +1 -0
  415. package/dist/services/run-log/spec/log-reader.spec.js +109 -0
  416. package/dist/services/run-log/spec/log-summary.spec.d.ts +1 -0
  417. package/dist/services/run-log/spec/log-summary.spec.js +153 -0
  418. package/dist/services/run-log/spec/redaction.spec.d.ts +1 -0
  419. package/dist/services/run-log/spec/redaction.spec.js +61 -0
  420. package/dist/services/run-log/spec/request-log.spec.d.ts +1 -0
  421. package/dist/services/run-log/spec/request-log.spec.js +101 -0
  422. package/dist/services/run-log/spec/request-summary.spec.d.ts +1 -0
  423. package/dist/services/run-log/spec/request-summary.spec.js +171 -0
  424. package/dist/services/run-log/spec/run-log.spec.d.ts +1 -0
  425. package/dist/services/run-log/spec/run-log.spec.js +122 -0
  426. package/dist/services/run-registry/exit-classification.d.ts +39 -0
  427. package/dist/services/run-registry/exit-classification.js +42 -0
  428. package/dist/services/run-registry/index.d.ts +3 -0
  429. package/dist/services/run-registry/index.js +3 -0
  430. package/dist/services/run-registry/process-identity.d.ts +28 -0
  431. package/dist/services/run-registry/process-identity.js +80 -0
  432. package/dist/services/run-registry/run-registry-model.d.ts +128 -0
  433. package/dist/services/run-registry/run-registry-model.js +16 -0
  434. package/dist/services/run-registry/run-registry.d.ts +155 -0
  435. package/dist/services/run-registry/run-registry.js +430 -0
  436. package/dist/services/run-registry/spec/exit-classification.spec.d.ts +1 -0
  437. package/dist/services/run-registry/spec/exit-classification.spec.js +82 -0
  438. package/dist/services/run-registry/spec/run-registry.spec.d.ts +1 -0
  439. package/dist/services/run-registry/spec/run-registry.spec.js +526 -0
  440. package/dist/services/setup/os/tool-registry.js +2 -2
  441. package/oclif.manifest.json +3414 -293
  442. package/package.json +20 -2
@@ -0,0 +1,371 @@
1
+ import { expect } from "chai";
2
+ import { afterEach, beforeEach, describe, it } from "mocha";
3
+ import { connect } from "node:net";
4
+ import { existsSync, mkdtempSync, rmSync, statSync } from "node:fs";
5
+ import { tmpdir } from "node:os";
6
+ import { join } from "node:path";
7
+ import { BaqendResponse } from "../../browser/baqend-response.js";
8
+ import { Cache } from "../../request-cache/cache.js";
9
+ import { ControlServer } from "../../control/control-server.js";
10
+ import { ServiceWorkerTracker } from "../../control/service-worker-tracker.js";
11
+ import { CONTROL_ERRORS, CONTROL_PROTOCOL_VERSION, CONTROL_SOCKET, } from "../../control/control-protocol.js";
12
+ import { memoryCli } from "../../../cli/spec/memory-cli.js";
13
+ /** One request in, one response out, over a real socket. */
14
+ function ask(path, lines, expected = lines.length) {
15
+ return new Promise((resolve, reject) => {
16
+ const socket = connect(path);
17
+ const responses = [];
18
+ let buffer = "";
19
+ const done = setTimeout(() => {
20
+ socket.destroy();
21
+ reject(new Error(`timed out with ${responses.length} of ${expected}`));
22
+ }, 2000);
23
+ socket.on("connect", () => {
24
+ for (const line of lines) {
25
+ socket.write(`${line}\n`);
26
+ }
27
+ });
28
+ socket.on("data", (chunk) => {
29
+ buffer += chunk.toString();
30
+ let newline = buffer.indexOf("\n");
31
+ while (newline !== -1) {
32
+ const line = buffer.slice(0, newline);
33
+ buffer = buffer.slice(newline + 1);
34
+ newline = buffer.indexOf("\n");
35
+ if (line.trim()) {
36
+ responses.push(JSON.parse(line));
37
+ }
38
+ }
39
+ if (responses.length >= expected) {
40
+ clearTimeout(done);
41
+ socket.destroy();
42
+ resolve(responses);
43
+ }
44
+ });
45
+ socket.on("error", reject);
46
+ });
47
+ }
48
+ /** The smallest FileListInterface a ControlServer needs. */
49
+ function fileList(files = []) {
50
+ return {
51
+ files,
52
+ hasFile: (name) => files.some((file) => file.name === name),
53
+ getByName: (name) => files.find((file) => file.name === name),
54
+ };
55
+ }
56
+ const hello = (version = CONTROL_PROTOCOL_VERSION) => JSON.stringify({ id: "h", op: "hello", version });
57
+ /** Narrows a response, and says what it actually was when it is the other one. */
58
+ function failure(response) {
59
+ if (response.status !== "error") {
60
+ throw new Error(`expected an error, got ${JSON.stringify(response)}`);
61
+ }
62
+ return response.error;
63
+ }
64
+ function success(response) {
65
+ if (response.status !== "ok") {
66
+ throw new Error(`expected success, got ${JSON.stringify(response)}`);
67
+ }
68
+ return response.data;
69
+ }
70
+ describe("ControlServer", () => {
71
+ let runDirectory;
72
+ let server;
73
+ let browserServer;
74
+ let pagelessServer;
75
+ let cache;
76
+ let controller;
77
+ /** Enough of a browser to answer; the CDP half is covered elsewhere. */
78
+ const stubBrowser = (available) => ({
79
+ available,
80
+ url: () => (available ? "https://shop.example.com/" : null),
81
+ evaluate: async () => undefined,
82
+ state: async () => ({
83
+ url: "https://shop.example.com/",
84
+ serviceWorkers: new ServiceWorkerTracker().state(),
85
+ }),
86
+ reset: async () => ({ url: null, did: "cleared" }),
87
+ reinstallServiceWorker: async () => ({ url: null, did: "reinstalled" }),
88
+ navigate: async () => ({ url: null, did: "navigated" }),
89
+ });
90
+ beforeEach(async () => {
91
+ runDirectory = mkdtempSync(join(tmpdir(), "sk-control-"));
92
+ cache = new Cache(memoryCli(), join(runDirectory, "dh-cache"));
93
+ server = new ControlServer(runDirectory, "example.com-production-1", {
94
+ cache,
95
+ cli: memoryCli(),
96
+ files: fileList(),
97
+ });
98
+ controller = new AbortController();
99
+ await server.listen(controller.signal);
100
+ // Separate directories, so each has its own socket and its own counter.
101
+ const withBrowser = mkdtempSync(join(tmpdir(), "sk-control-browser-"));
102
+ browserServer = new ControlServer(withBrowser, "example.com-production-2", {
103
+ cache,
104
+ cli: memoryCli(),
105
+ files: fileList(),
106
+ session: stubBrowser(true),
107
+ });
108
+ await browserServer.listen(controller.signal);
109
+ const withoutPage = mkdtempSync(join(tmpdir(), "sk-control-pageless-"));
110
+ pagelessServer = new ControlServer(withoutPage, "example.com-production-3", {
111
+ cache,
112
+ cli: memoryCli(),
113
+ files: fileList(),
114
+ session: stubBrowser(false),
115
+ });
116
+ await pagelessServer.listen(controller.signal);
117
+ });
118
+ afterEach(async () => {
119
+ controller.abort();
120
+ await Promise.all([
121
+ server.close(),
122
+ browserServer.close(),
123
+ pagelessServer.close(),
124
+ ]);
125
+ rmSync(runDirectory, { recursive: true, force: true });
126
+ });
127
+ it("should put its socket in the run directory, readable only by its owner", () => {
128
+ const mode = statSync(join(runDirectory, CONTROL_SOCKET)).mode & 0o777;
129
+ // What is behind this is a live browser session with the customer's
130
+ // credentials in it.
131
+ expect(mode).to.equal(0o600);
132
+ });
133
+ it("should greet a caller that speaks its version", async () => {
134
+ const [response] = await ask(server.socketPath, [hello()]);
135
+ expect(success(response)).to.include({
136
+ pid: process.pid,
137
+ runId: "example.com-production-1",
138
+ });
139
+ });
140
+ it("should refuse a caller that speaks another version, and say which it speaks", async () => {
141
+ const [response] = await ask(server.socketPath, [hello(99)]);
142
+ // `sk` gets upgraded while a run from the previous build is still going, so
143
+ // this is a real state, not a theoretical one.
144
+ const error = failure(response);
145
+ expect(error.code).to.equal(CONTROL_ERRORS.versionMismatch);
146
+ expect(error.version).to.equal(CONTROL_PROTOCOL_VERSION);
147
+ });
148
+ it("should refuse an op before the handshake", async () => {
149
+ const [response] = await ask(server.socketPath, [
150
+ JSON.stringify({ id: "1", op: "cache.list" }),
151
+ ]);
152
+ expect(failure(response).code).to.equal(CONTROL_ERRORS.helloRequired);
153
+ });
154
+ it("should refuse an op after a rejected handshake", async () => {
155
+ const [, second] = await ask(server.socketPath, [
156
+ hello(99),
157
+ JSON.stringify({ id: "1", op: "cache.list" }),
158
+ ]);
159
+ expect(failure(second).code).to.equal(CONTROL_ERRORS.helloRequired);
160
+ });
161
+ it("should answer a malformed line without dropping the connection", async () => {
162
+ const [bad, good] = await ask(server.socketPath, ["{ not json", hello()]);
163
+ expect(failure(bad).code).to.equal(CONTROL_ERRORS.malformed);
164
+ expect(good.status).to.equal("ok");
165
+ });
166
+ it("should decode cache keys into something readable", async () => {
167
+ const body = "<html>hi</html>";
168
+ cache.addEntry("https://myapp.app.baqend.com/v1/asset/https://shop.example.com/p?bqvariation=mobile", new BaqendResponse(body, "text/html; charset=utf-8"), body);
169
+ const [, listed] = await ask(server.socketPath, [
170
+ hello(),
171
+ JSON.stringify({ id: "1", op: "cache.list" }),
172
+ ]);
173
+ const { entries } = success(listed);
174
+ expect(entries).to.have.lengthOf(1);
175
+ expect(entries[0].originUrl).to.equal("https://shop.example.com/p");
176
+ expect(entries[0].variation).to.equal("mobile");
177
+ expect(entries[0].status).to.equal(200);
178
+ expect(entries[0].bytes).to.equal(body.length);
179
+ });
180
+ it("should carry a generation on every response, including errors", async () => {
181
+ server.bumpGeneration();
182
+ server.bumpGeneration();
183
+ const [greeting, refused] = await ask(server.socketPath, [
184
+ hello(),
185
+ JSON.stringify({ id: "1", op: "nope" }),
186
+ ]);
187
+ expect(greeting.generation).to.equal(2);
188
+ expect(refused.generation).to.equal(2);
189
+ expect(failure(refused).code).to.equal(CONTROL_ERRORS.unknownOp);
190
+ });
191
+ it("should bump the generation for a mutating browser op, and not for a read", async () => {
192
+ // The counter is how a reader tells that a measurement it took earlier
193
+ // predates its own reset. A read that bumped it would make every reader
194
+ // distrust data that is still good; a mutation that did not would let one
195
+ // trust data that is not.
196
+ const [, firstRead, secondRead, reset, afterReset] = await ask(browserServer.socketPath, [
197
+ hello(),
198
+ JSON.stringify({ id: "1", op: "browser.state" }),
199
+ JSON.stringify({ id: "2", op: "browser.state" }),
200
+ JSON.stringify({ id: "3", op: "browser.reset", scope: "cache" }),
201
+ JSON.stringify({ id: "4", op: "browser.state" }),
202
+ ]);
203
+ // Order first: these handlers are async, and dispatching them as the lines
204
+ // arrived let the last request answer before the reset it was sent after.
205
+ expect([
206
+ firstRead.id,
207
+ secondRead.id,
208
+ reset.id,
209
+ afterReset.id,
210
+ ]).to.deep.equal(["1", "2", "3", "4"]);
211
+ expect(secondRead.generation).to.equal(firstRead.generation);
212
+ expect(reset.generation).to.equal(firstRead.generation + 1);
213
+ // The read after the reset must carry the *new* generation. Answering it
214
+ // out of order gave it the old one, and the correlation id still matched,
215
+ // so nothing looked wrong.
216
+ expect(afterReset.generation).to.equal(reset.generation);
217
+ });
218
+ it("should say there is no page rather than fail obscurely", async () => {
219
+ const [, answer] = await ask(pagelessServer.socketPath, [
220
+ hello(),
221
+ JSON.stringify({ id: "1", op: "browser.state" }),
222
+ ]);
223
+ expect(failure(answer).code).to.equal(CONTROL_ERRORS.noPage);
224
+ });
225
+ it("should answer several requests on one connection, in order", async () => {
226
+ const responses = await ask(server.socketPath, [
227
+ hello(),
228
+ JSON.stringify({ id: "1", op: "cache.list" }),
229
+ JSON.stringify({ id: "2", op: "cache.list" }),
230
+ ]);
231
+ expect(responses.map((response) => response.id)).to.deep.equal([
232
+ "h",
233
+ "1",
234
+ "2",
235
+ ]);
236
+ });
237
+ it("should remove its socket synchronously at exit", () => {
238
+ // close() is async and a signal-ended run can exit before it lands, which
239
+ // left a live-looking socket in a dead run's directory.
240
+ expect(existsSync(server.socketPath)).to.equal(true);
241
+ process.emit("exit", 0);
242
+ expect(existsSync(server.socketPath)).to.equal(false);
243
+ });
244
+ it("should take over a socket left behind by a previous run", async () => {
245
+ // The run directory is per-pid, so anything at this path is this run's own
246
+ // leftover — binding must not fail with EADDRINUSE.
247
+ const second = new ControlServer(runDirectory, "example.com-production-1", {
248
+ cache,
249
+ cli: memoryCli(),
250
+ files: fileList(),
251
+ });
252
+ const secondController = new AbortController();
253
+ await second.listen(secondController.signal);
254
+ const [response] = await ask(second.socketPath, [hello()]);
255
+ expect(response.status).to.equal("ok");
256
+ secondController.abort();
257
+ await second.close();
258
+ });
259
+ });
260
+ /**
261
+ * Two callers, one run.
262
+ *
263
+ * The per-connection queue keeps one caller's requests in order and says
264
+ * nothing about two, which is not hypothetical: a run is asked from as many
265
+ * terminals and agents as are open. A
266
+ * `browser.reset` interleaved with a `cache.prewarm` leaves a half-built
267
+ * comparison that nothing reports as such.
268
+ */
269
+ describe("ControlServer — two callers at once", () => {
270
+ let runDirectory;
271
+ let server;
272
+ let controller;
273
+ let overlapped;
274
+ let inFlight;
275
+ const socketPath = () => join(runDirectory, CONTROL_SOCKET);
276
+ /** Records whether it was ever running alongside another of itself. */
277
+ const tracked = (work) => {
278
+ return async () => {
279
+ inFlight += 1;
280
+ if (inFlight > 1)
281
+ overlapped = true;
282
+ try {
283
+ // Two macrotasks, so an unserialised second call has every chance to
284
+ // start before this one finishes. Without the queue it takes it.
285
+ await new Promise((resolve) => setTimeout(resolve, 10));
286
+ return await work();
287
+ }
288
+ finally {
289
+ inFlight -= 1;
290
+ }
291
+ };
292
+ };
293
+ beforeEach(async () => {
294
+ overlapped = false;
295
+ inFlight = 0;
296
+ runDirectory = mkdtempSync(join(tmpdir(), "sk-control-queue-"));
297
+ const cache = new Cache(memoryCli(), join(runDirectory, "dh-cache"));
298
+ server = new ControlServer(runDirectory, "example.com-production-q", {
299
+ cache,
300
+ cli: memoryCli(),
301
+ files: fileList(),
302
+ origin: "https://shop.example.com",
303
+ prewarm: tracked(async () => {
304
+ const key = "https://myapp.app.baqend.com/v1/asset/https://shop.example.com/p";
305
+ const body = "<html>p</html>";
306
+ cache.addEntry(key, new BaqendResponse(body, "text/html; charset=utf-8"), body);
307
+ return key;
308
+ }),
309
+ cacheErrors: tracked(async () => []),
310
+ });
311
+ controller = new AbortController();
312
+ await server.listen(controller.signal);
313
+ });
314
+ afterEach(async () => {
315
+ controller.abort();
316
+ await server.close();
317
+ rmSync(runDirectory, { recursive: true, force: true });
318
+ });
319
+ const prewarm = (id) => ask(socketPath(), [
320
+ hello(),
321
+ JSON.stringify({ id, op: "cache.prewarm", url: "/p" }),
322
+ ]);
323
+ it("should not let two connections mutate at the same time", async () => {
324
+ const [first, second] = await Promise.all([prewarm("a"), prewarm("b")]);
325
+ expect(first[1].status, JSON.stringify(first[1])).to.equal("ok");
326
+ expect(second[1].status, JSON.stringify(second[1])).to.equal("ok");
327
+ expect(overlapped, "two mutations ran concurrently").to.equal(false);
328
+ });
329
+ // The other half of the rule, and the reason it is a mutation queue rather
330
+ // than a request queue: reads are the common case and the expensive ones wait
331
+ // on CDP, so serialising them would make one slow read block every caller for
332
+ // no correctness gain.
333
+ it("should let two connections read at the same time", async () => {
334
+ const read = (id) => ask(socketPath(), [hello(), JSON.stringify({ id, op: "cache.errors" })]);
335
+ await Promise.all([read("a"), read("b")]);
336
+ expect(overlapped, "reads were serialised against each other").to.equal(true);
337
+ });
338
+ });
339
+ describe("ControlServer — config.runtime", () => {
340
+ const ask1 = async (runtimeConfig) => {
341
+ const runDirectory = mkdtempSync(join(tmpdir(), "sk-control-runtime-"));
342
+ const controller = new AbortController();
343
+ const server = new ControlServer(runDirectory, "example.com-production-r", {
344
+ cache: new Cache(memoryCli(), join(runDirectory, "dh-cache")),
345
+ cli: memoryCli(),
346
+ files: fileList(),
347
+ runtimeConfig,
348
+ });
349
+ await server.listen(controller.signal);
350
+ try {
351
+ const [, response] = await ask(server.socketPath, [
352
+ hello(),
353
+ JSON.stringify({ id: "1", op: "config.runtime" }),
354
+ ]);
355
+ return response;
356
+ }
357
+ finally {
358
+ controller.abort();
359
+ await server.close();
360
+ rmSync(runDirectory, { recursive: true, force: true });
361
+ }
362
+ };
363
+ it("should answer null for a run that loaded no runtime config", async () => {
364
+ expect(success(await ask1(() => undefined))).to.deep.equal({
365
+ config: null,
366
+ });
367
+ });
368
+ it("should refuse on a run that loads no runtime config at all", async () => {
369
+ expect(failure(await ask1()).code).to.equal(CONTROL_ERRORS.handlerFailed);
370
+ });
371
+ });