@speedkit/cli 4.36.0 → 4.36.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 (480) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/README.md +3 -29
  3. package/dist/base/sk-command.d.ts +41 -0
  4. package/dist/base/sk-command.js +56 -0
  5. package/dist/commands/auto-prewarm.d.ts +6 -4
  6. package/dist/commands/auto-prewarm.js +13 -66
  7. package/dist/commands/autocomplete/fish.d.ts +2 -2
  8. package/dist/commands/autocomplete/fish.js +3 -2
  9. package/dist/commands/browser/clean.d.ts +2 -2
  10. package/dist/commands/browser/clean.js +6 -7
  11. package/dist/commands/browser/list.d.ts +2 -2
  12. package/dist/commands/browser/list.js +6 -8
  13. package/dist/commands/browser/update.d.ts +2 -2
  14. package/dist/commands/browser/update.js +9 -12
  15. package/dist/commands/bulk-deploy.d.ts +4 -2
  16. package/dist/commands/bulk-deploy.js +7 -37
  17. package/dist/commands/config/edit.d.ts +2 -2
  18. package/dist/commands/config/edit.js +2 -2
  19. package/dist/commands/config/setup.d.ts +5 -2
  20. package/dist/commands/config/setup.js +10 -19
  21. package/dist/commands/deploy.d.ts +12 -3
  22. package/dist/commands/deploy.js +14 -19
  23. package/dist/commands/diff-url-parameters.d.ts +5 -4
  24. package/dist/commands/diff-url-parameters.js +28 -18
  25. package/dist/commands/extension/add.d.ts +2 -2
  26. package/dist/commands/extension/add.js +6 -6
  27. package/dist/commands/extension/devtools.d.ts +2 -2
  28. package/dist/commands/extension/devtools.js +6 -7
  29. package/dist/commands/extension/list.d.ts +2 -2
  30. package/dist/commands/extension/list.js +5 -6
  31. package/dist/commands/extension/remove.d.ts +2 -2
  32. package/dist/commands/extension/remove.js +6 -6
  33. package/dist/commands/extension/update.d.ts +2 -2
  34. package/dist/commands/extension/update.js +5 -6
  35. package/dist/commands/find-pops.d.ts +2 -2
  36. package/dist/commands/find-pops.js +11 -11
  37. package/dist/commands/generate-customer-config.d.ts +5 -2
  38. package/dist/commands/generate-customer-config.js +9 -27
  39. package/dist/commands/generate-pop-config.d.ts +2 -2
  40. package/dist/commands/generate-pop-config.js +26 -26
  41. package/dist/commands/login.d.ts +2 -2
  42. package/dist/commands/login.js +6 -9
  43. package/dist/commands/onboarding.d.ts +18 -3
  44. package/dist/commands/onboarding.js +13 -11
  45. package/dist/commands/origin-request.d.ts +4 -2
  46. package/dist/commands/origin-request.js +10 -42
  47. package/dist/commands/prewarm.d.ts +4 -2
  48. package/dist/commands/prewarm.js +12 -56
  49. package/dist/commands/pull.d.ts +4 -2
  50. package/dist/commands/pull.js +9 -14
  51. package/dist/commands/query/parameter.d.ts +4 -2
  52. package/dist/commands/query/parameter.js +12 -19
  53. package/dist/commands/query/prewarm.d.ts +4 -2
  54. package/dist/commands/query/prewarm.js +16 -23
  55. package/dist/commands/revalidate.d.ts +4 -2
  56. package/dist/commands/revalidate.js +14 -56
  57. package/dist/commands/wpt-launcher.d.ts +2 -2
  58. package/dist/commands/wpt-launcher.js +17 -17
  59. package/dist/helpers/{chrome-flags.spec.js → spec/chrome-flags.spec.js} +1 -1
  60. package/dist/helpers/{origin-proxy.spec.js → spec/origin-proxy.spec.js} +1 -1
  61. package/dist/hooks/init/first-run.js +9 -10
  62. package/dist/hooks/{init → spec/init}/dns-result-order.spec.js +1 -1
  63. package/dist/hooks/{init → spec/init}/http1-global-dispatcher.spec.js +1 -1
  64. package/dist/models/context.d.ts +24 -0
  65. package/dist/models/context.js +31 -0
  66. package/dist/services/athena/athena-flags.d.ts +18 -0
  67. package/dist/services/athena/athena-flags.js +29 -0
  68. package/dist/services/athena/athena-service-build-context.d.ts +25 -0
  69. package/dist/services/athena/athena-service-build-context.js +4 -0
  70. package/dist/services/athena/athena-service-factory.d.ts +3 -14
  71. package/dist/services/athena/athena-service-factory.js +11 -25
  72. package/dist/services/athena/baqend-athena-service.d.ts +3 -14
  73. package/dist/services/athena/baqend-athena-service.js +8 -16
  74. package/dist/services/athena/index.d.ts +1 -0
  75. package/dist/services/athena/index.js +1 -0
  76. package/dist/services/athena/{athena-service.spec.js → spec/athena-service.spec.js} +1 -1
  77. package/dist/services/athena/{baqend-athena-service.spec.js → spec/baqend-athena-service.spec.js} +4 -4
  78. package/dist/services/browser-fetch/browser-origin-fetch.d.ts +2 -2
  79. package/dist/services/browser-fetch/browser-origin-fetch.js +1 -1
  80. package/dist/services/browser-fetch/browser-origin-fetcher.d.ts +3 -3
  81. package/dist/services/browser-fetch/browser-origin-fetcher.js +5 -5
  82. package/dist/services/browser-fetch/{browser-origin-fetch.spec.js → spec/browser-origin-fetch.spec.js} +12 -12
  83. package/dist/services/browser-fetch/{browser-origin-fetcher.spec.js → spec/browser-origin-fetcher.spec.js} +1 -1
  84. package/dist/services/browser-fetch/{browser-response.spec.js → spec/browser-response.spec.js} +1 -1
  85. package/dist/services/browser-fetch/{device-emulation.spec.js → spec/device-emulation.spec.js} +2 -2
  86. package/dist/services/bundler/{bundle-service.spec.js → spec/bundle-service.spec.js} +1 -1
  87. package/dist/services/cli/cli-environment-factory.d.ts +25 -0
  88. package/dist/services/cli/cli-environment-factory.js +30 -0
  89. package/dist/services/cli/cli-environment.d.ts +73 -0
  90. package/dist/services/cli/cli-environment.js +216 -0
  91. package/dist/services/cli/cli-service-build-context.d.ts +10 -0
  92. package/dist/services/cli/cli-service-build-context.js +4 -0
  93. package/dist/services/cli/cli-service-factory.d.ts +12 -4
  94. package/dist/services/cli/cli-service-factory.js +11 -9
  95. package/dist/services/cli/cli-service-model.d.ts +10 -6
  96. package/dist/services/cli/cli-service-model.js +0 -6
  97. package/dist/services/cli/cli-service.d.ts +52 -1
  98. package/dist/services/cli/cli-service.js +60 -14
  99. package/dist/services/cli/cli-settings.d.ts +37 -0
  100. package/dist/services/cli/cli-settings.js +23 -0
  101. package/dist/{helpers/clipboard.d.ts → services/cli/clipboard/clipboard-service.d.ts} +3 -1
  102. package/dist/{helpers/clipboard.js → services/cli/clipboard/clipboard-service.js} +6 -1
  103. package/dist/services/cli/clipboard/index.d.ts +1 -0
  104. package/dist/services/cli/clipboard/index.js +1 -0
  105. package/dist/services/cli/command-build-context.d.ts +23 -0
  106. package/dist/services/cli/index.d.ts +5 -0
  107. package/dist/services/cli/index.js +5 -0
  108. package/dist/services/cli/spec/cli-environment-detection.spec.js +52 -0
  109. package/dist/services/cli/spec/cli-environment.spec.js +125 -0
  110. package/dist/services/cli/{cli-service.spec.js → spec/cli-service.spec.js} +10 -20
  111. package/dist/services/config-api/client.d.ts +3 -3
  112. package/dist/services/config-api/client.js +4 -4
  113. package/dist/services/config-api/config-api-factory.js +3 -3
  114. package/dist/services/config-api/entity-manager-provider.d.ts +11 -0
  115. package/dist/services/config-api/{entity-manager-factory.js → entity-manager-provider.js} +7 -1
  116. package/dist/services/customer-config/customer-config-service-build-context.d.ts +33 -0
  117. package/dist/services/customer-config/customer-config-service-build-context.js +36 -0
  118. package/dist/services/customer-config/customer-config-service-factory.d.ts +3 -2
  119. package/dist/services/customer-config/customer-config-service-factory.js +5 -4
  120. package/dist/services/customer-config/customer-config-service.d.ts +5 -3
  121. package/dist/services/customer-config/customer-config-service.js +4 -3
  122. package/dist/services/customer-config/index.d.ts +1 -1
  123. package/dist/services/customer-config/index.js +1 -1
  124. package/dist/services/customer-config/site-analyzer/index.d.ts +4 -0
  125. package/dist/services/customer-config/site-analyzer/index.js +4 -0
  126. package/dist/{helpers/site-analyzer.d.ts → services/customer-config/site-analyzer/site-analyzer-model.d.ts} +0 -1
  127. package/dist/services/customer-config/site-analyzer/site-analyzer-service-build-context.d.ts +6 -0
  128. package/dist/services/customer-config/site-analyzer/site-analyzer-service-build-context.js +4 -0
  129. package/dist/services/customer-config/site-analyzer/site-analyzer-service-factory.d.ts +7 -0
  130. package/dist/services/customer-config/site-analyzer/site-analyzer-service-factory.js +10 -0
  131. package/dist/services/customer-config/site-analyzer/site-analyzer-service.d.ts +16 -0
  132. package/dist/{helpers/site-analyzer.js → services/customer-config/site-analyzer/site-analyzer-service.js} +20 -5
  133. package/dist/services/deploy/bulk/bulk-deploy-model.d.ts +0 -25
  134. package/dist/services/deploy/bulk/bulk-deploy-model.js +1 -27
  135. package/dist/services/deploy/bulk/bulk-deploy-service-build-context.d.ts +51 -0
  136. package/dist/services/deploy/bulk/bulk-deploy-service-build-context.js +50 -0
  137. package/dist/services/deploy/bulk/bulk-deploy-service-factory.d.ts +2 -4
  138. package/dist/services/deploy/bulk/bulk-deploy-service-factory.js +2 -5
  139. package/dist/services/deploy/bulk/bulk-deploy-service.d.ts +3 -2
  140. package/dist/services/deploy/bulk/config-deploy-factory.d.ts +3 -3
  141. package/dist/services/deploy/bulk/config-deploy-factory.js +16 -8
  142. package/dist/services/deploy/bulk/index.d.ts +1 -0
  143. package/dist/services/deploy/bulk/index.js +1 -0
  144. package/dist/services/deploy/checks/activation/customer-approval-check.d.ts +3 -1
  145. package/dist/services/deploy/checks/activation/customer-approval-check.js +4 -2
  146. package/dist/services/deploy/checks/post-deploy/deprecated-deployment-detection-check.d.ts +2 -2
  147. package/dist/services/deploy/checks/post-deploy/refresh-deployment-job-check.d.ts +2 -2
  148. package/dist/services/deploy/checks/post-deploy/revalidated-module-check.d.ts +2 -2
  149. package/dist/services/deploy/checks/post-deploy/save-files-check.d.ts +2 -2
  150. package/dist/services/deploy/checks/pre-deploy/device-detection-changed-check.d.ts +3 -1
  151. package/dist/services/deploy/checks/pre-deploy/device-detection-changed-check.js +4 -2
  152. package/dist/services/deploy/checks/pre-deploy/split-change-check.d.ts +3 -1
  153. package/dist/services/deploy/checks/pre-deploy/split-change-check.js +4 -2
  154. package/dist/services/deploy/deploy-service-build-context.d.ts +63 -0
  155. package/dist/services/deploy/deploy-service-build-context.js +64 -0
  156. package/dist/services/deploy/deploy-service-factory.d.ts +4 -6
  157. package/dist/services/deploy/deploy-service-factory.js +25 -14
  158. package/dist/services/deploy/deploy-service.d.ts +2 -2
  159. package/dist/services/deploy/handler/customer-config-handler.d.ts +2 -2
  160. package/dist/services/deploy/handler/install-resource-handler.d.ts +2 -2
  161. package/dist/services/deploy/handler/install-resource-modifier/deleted-file-check.d.ts +2 -2
  162. package/dist/services/deploy/handler/module-handler.d.ts +2 -2
  163. package/dist/services/deploy/handler/server-config-handler.d.ts +2 -2
  164. package/dist/services/deploy/mr/base-config-reader.d.ts +6 -4
  165. package/dist/services/deploy/mr/base-config-reader.js +14 -13
  166. package/dist/services/deploy/mr/index.d.ts +1 -0
  167. package/dist/services/deploy/mr/index.js +1 -0
  168. package/dist/services/deploy/mr/merge-request-deploy-model.d.ts +0 -35
  169. package/dist/services/deploy/mr/merge-request-deploy-model.js +0 -34
  170. package/dist/services/deploy/mr/merge-request-deploy-service-build-context.d.ts +32 -0
  171. package/dist/services/deploy/mr/merge-request-deploy-service-build-context.js +20 -0
  172. package/dist/services/deploy/mr/merge-request-deploy-service-factory.d.ts +2 -4
  173. package/dist/services/deploy/mr/merge-request-deploy-service-factory.js +31 -10
  174. package/dist/services/deploy/mr/merge-request-deploy-service.d.ts +3 -2
  175. package/dist/services/deploy/{bulk → spec/bulk}/bulk-deploy-service.spec.js +18 -7
  176. package/dist/services/deploy/{bulk → spec/bulk}/touched-configs.spec.js +2 -2
  177. package/dist/services/deploy/{checks → spec/checks}/activation/customer-approval-check.spec.js +9 -7
  178. package/dist/services/deploy/{checks → spec/checks}/post-deploy/refresh-deployment-job-check.spec.js +2 -2
  179. package/dist/services/deploy/{checks → spec/checks}/pre-deploy/split-change-check.spec.js +5 -4
  180. package/dist/services/deploy/{handler → spec/handler}/module-handler.spec.js +2 -2
  181. package/dist/services/deploy/{handler → spec/handler}/testing-installation-links.spec.js +1 -1
  182. package/dist/services/deploy/{mr → spec/mr}/live-state-check.spec.js +2 -2
  183. package/dist/services/deploy/{mr → spec/mr}/merge-request-description.spec.js +1 -1
  184. package/dist/services/deploy/{policy → spec/policy}/auto-deploy-policy.spec.js +2 -2
  185. package/dist/services/diff/diff-service-build-context.d.ts +14 -0
  186. package/dist/services/diff/diff-service-build-context.js +4 -0
  187. package/dist/services/diff/diff-service-factory.d.ts +4 -3
  188. package/dist/services/diff/diff-service-factory.js +3 -4
  189. package/dist/services/diff/diff-service.d.ts +10 -2
  190. package/dist/services/diff/diff-service.js +26 -3
  191. package/dist/services/diff/index.d.ts +2 -1
  192. package/dist/services/diff/index.js +2 -1
  193. package/dist/services/document-handler-runtime/document-handler-runtime-model.d.ts +7 -0
  194. package/dist/services/document-handler-runtime/document-handler-runtime-model.js +10 -0
  195. package/dist/services/document-handler-runtime/document-handler-runtime-service-build-context.d.ts +11 -0
  196. package/dist/services/document-handler-runtime/document-handler-runtime-service-build-context.js +4 -0
  197. package/dist/services/document-handler-runtime/document-handler-server.d.ts +2 -2
  198. package/dist/services/document-handler-runtime/document-handler-server.js +2 -2
  199. package/dist/services/document-handler-runtime/factory/document-handler-runtime-service-factory.d.ts +3 -14
  200. package/dist/services/document-handler-runtime/factory/document-handler-runtime-service-factory.js +14 -80
  201. package/dist/services/document-handler-runtime/server/request.js +1 -1
  202. package/dist/services/document-handler-runtime/{document-handler-abort.spec.js → spec/document-handler-abort.spec.js} +2 -2
  203. package/dist/services/document-handler-runtime/templates/database-mock.d.ts +1 -1
  204. package/dist/services/document-handler-runtime/templates/database-mock.js +1 -1
  205. package/dist/services/git/{git-repository.spec.js → spec/git-repository.spec.js} +1 -1
  206. package/dist/services/integration-api/customer-config-flags.d.ts +16 -0
  207. package/dist/services/integration-api/customer-config-flags.js +30 -0
  208. package/dist/services/integration-api/handler/customer-config-handler.d.ts +2 -2
  209. package/dist/services/integration-api/handler/install-resource-handler.d.ts +8 -0
  210. package/dist/services/integration-api/handler/install-resource-handler.js +10 -1
  211. package/dist/services/integration-api/index.d.ts +1 -0
  212. package/dist/services/integration-api/index.js +1 -0
  213. package/dist/services/integration-api/integration-api-factory.d.ts +4 -5
  214. package/dist/services/integration-api/integration-api-factory.js +11 -9
  215. package/dist/services/integration-api/integration-api-model.d.ts +0 -9
  216. package/dist/services/integration-api/integration-api-model.js +0 -16
  217. package/dist/services/integration-api/integration-api-service-build-context.d.ts +19 -0
  218. package/dist/services/integration-api/integration-api-service-build-context.js +4 -0
  219. package/dist/services/integration-api/spec/config-plugin.spec.js +1 -1
  220. package/dist/services/integration-api/spec/integration-api-service.spec.js +7 -3
  221. package/dist/services/integration-api/spec/speed-kit-config-file.spec.js +9 -2
  222. package/dist/services/integration-api/struct/config-plugin.d.ts +1 -1
  223. package/dist/services/integration-api/struct/config-plugin.js +12 -7
  224. package/dist/services/integration-api/struct/customer-config-file.js +1 -1
  225. package/dist/services/integration-api/struct/speed-kit-config-file.d.ts +18 -2
  226. package/dist/services/integration-api/struct/speed-kit-config-file.js +22 -12
  227. package/dist/services/integration-api/struct/speed-kit-config.d.ts +1 -1
  228. package/dist/services/integration-api/virtual/virtual-file-handler.d.ts +2 -2
  229. package/dist/services/onboarding/browser/config/browser-config.d.ts +3 -3
  230. package/dist/services/onboarding/browser/config/browser-config.js +5 -5
  231. package/dist/services/onboarding/browser/executable/executable-validator.d.ts +3 -4
  232. package/dist/services/onboarding/browser/executable/executable-validator.js +17 -15
  233. package/dist/services/onboarding/browser/extension/extension-downloader.d.ts +3 -4
  234. package/dist/services/onboarding/browser/extension/extension-downloader.js +6 -6
  235. package/dist/services/onboarding/browser/extension/extension-validator.d.ts +3 -4
  236. package/dist/services/onboarding/browser/extension/extension-validator.js +4 -4
  237. package/dist/services/onboarding/dashboard/diff-against-current-page.d.ts +2 -2
  238. package/dist/services/onboarding/dashboard/diff-against-current-page.js +1 -1
  239. package/dist/services/onboarding/dashboard/request-diff-service.d.ts +3 -1
  240. package/dist/services/onboarding/dashboard/request-diff-service.js +5 -3
  241. package/dist/services/onboarding/fetch-event-handler.d.ts +2 -2
  242. package/dist/services/onboarding/fetch-events/speed-kit-install-js.d.ts +3 -1
  243. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +5 -3
  244. package/dist/services/onboarding/file-events/file-watcher.d.ts +2 -2
  245. package/dist/services/onboarding/file-events/file-watcher.js +3 -2
  246. package/dist/services/onboarding/index.d.ts +1 -1
  247. package/dist/services/onboarding/index.js +1 -1
  248. package/dist/services/onboarding/onboarding-model.d.ts +8 -24
  249. package/dist/services/onboarding/onboarding-model.js +19 -87
  250. package/dist/services/onboarding/onboarding-service-build-context.d.ts +57 -0
  251. package/dist/services/onboarding/onboarding-service-build-context.js +67 -0
  252. package/dist/services/onboarding/onboarding-service-factory.d.ts +2 -4
  253. package/dist/services/onboarding/onboarding-service-factory.js +50 -37
  254. package/dist/services/onboarding/onboarding-service.d.ts +2 -2
  255. package/dist/services/onboarding/request-cache/cache.d.ts +2 -2
  256. package/dist/services/onboarding/server-config/index.d.ts +2 -2
  257. package/dist/services/onboarding/{browser → spec/browser}/executable/headed-user-agent.spec.js +1 -1
  258. package/dist/services/onboarding/{empty-service-worker.spec.js → spec/empty-service-worker.spec.js} +1 -1
  259. package/dist/services/onboarding/{onboarding-model.spec.js → spec/onboarding-model.spec.js} +13 -8
  260. package/dist/services/onboarding/{virtual-orestes-app → spec/virtual-orestes-app}/crawler.spec.js +1 -1
  261. package/dist/services/onboarding/{virtual-orestes-app → spec/virtual-orestes-app}/origin-error-cause.spec.js +1 -1
  262. package/dist/services/onboarding/virtual-orestes-app/crawler.d.ts +2 -2
  263. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +2 -2
  264. package/dist/services/origin-request/asset-variations.js +1 -1
  265. package/dist/services/origin-request/index.d.ts +1 -1
  266. package/dist/services/origin-request/index.js +1 -1
  267. package/dist/services/origin-request/origin-request-service-build-context.d.ts +52 -0
  268. package/dist/services/origin-request/origin-request-service-build-context.js +54 -0
  269. package/dist/services/origin-request/origin-request-service-factory.d.ts +2 -4
  270. package/dist/services/origin-request/origin-request-service-factory.js +10 -8
  271. package/dist/services/origin-request/origin-request-service.d.ts +3 -3
  272. package/dist/services/origin-request/{asset-variations.spec.js → spec/asset-variations.spec.js} +1 -1
  273. package/dist/services/pop-config/index.d.ts +1 -0
  274. package/dist/services/pop-config/index.js +1 -0
  275. package/dist/services/pop-config/pop-config-factory.d.ts +4 -1
  276. package/dist/services/pop-config/pop-config-factory.js +10 -3
  277. package/dist/services/pop-config/pop-config-service-build-context.d.ts +10 -0
  278. package/dist/services/pop-config/pop-config-service-build-context.js +4 -0
  279. package/dist/services/prewarm/assets/asset-api-client.d.ts +3 -1
  280. package/dist/services/prewarm/assets/asset-api-client.js +5 -3
  281. package/dist/services/prewarm/auto-pre-warm-factory.d.ts +3 -30
  282. package/dist/services/prewarm/auto-pre-warm-factory.js +7 -9
  283. package/dist/services/prewarm/auto-pre-warm-service-build-context.d.ts +84 -0
  284. package/dist/services/prewarm/auto-pre-warm-service-build-context.js +68 -0
  285. package/dist/services/prewarm/index.d.ts +2 -0
  286. package/dist/services/prewarm/index.js +2 -0
  287. package/dist/{helpers → services/prewarm}/normalize.d.ts +0 -6
  288. package/dist/{helpers → services/prewarm}/normalize.js +0 -8
  289. package/dist/services/prewarm/pre-warm-factory.d.ts +4 -3
  290. package/dist/services/prewarm/pre-warm-factory.js +5 -4
  291. package/dist/services/prewarm/pre-warm-model.d.ts +0 -10
  292. package/dist/services/prewarm/pre-warm-model.js +0 -18
  293. package/dist/services/prewarm/pre-warm-service-build-context.d.ts +47 -0
  294. package/dist/services/prewarm/pre-warm-service-build-context.js +64 -0
  295. package/dist/services/prewarm/{csv-reader.spec.js → spec/csv-reader.spec.js} +1 -1
  296. package/dist/services/prewarm/{prewarm-targets.spec.js → spec/prewarm-targets.spec.js} +1 -1
  297. package/dist/services/pull/index.d.ts +1 -0
  298. package/dist/services/pull/index.js +1 -0
  299. package/dist/services/pull/pull-service-build-context.d.ts +28 -0
  300. package/dist/services/pull/pull-service-build-context.js +17 -0
  301. package/dist/services/pull/pull-service-factory.d.ts +3 -4
  302. package/dist/services/pull/pull-service-factory.js +11 -10
  303. package/dist/services/pull/pull-service-model.d.ts +0 -5
  304. package/dist/services/pull/pull-service-model.js +0 -9
  305. package/dist/services/query-builder/query-builder-factory.d.ts +9 -6
  306. package/dist/services/query-builder/query-builder-factory.js +24 -11
  307. package/dist/{models/cli-parameters.d.ts → services/query-builder/query-builder-flags.d.ts} +1 -122
  308. package/dist/services/query-builder/query-builder-flags.js +150 -0
  309. package/dist/services/query-builder/query-builder-model.d.ts +1 -14
  310. package/dist/services/query-builder/query-builder-service-build-context.d.ts +113 -0
  311. package/dist/services/query-builder/query-builder-service-build-context.js +68 -0
  312. package/dist/services/query-builder/query-builder-service.d.ts +3 -3
  313. package/dist/services/query-builder/query-builder-service.js +4 -5
  314. package/dist/services/query-builder/{queries/spec → spec/queries}/golden.spec.js +3 -3
  315. package/dist/services/query-builder/{queries/spec → spec/queries}/pops-query.spec.js +2 -2
  316. package/dist/services/query-builder/{queries/spec → spec/queries}/queries.spec.js +3 -3
  317. package/dist/services/query-builder/{queries/spec → spec/queries}/reported-bugs.spec.js +2 -2
  318. package/dist/{models/cli-parameters.spec.js → services/query-builder/spec/query-builder-flags.spec.js} +1 -1
  319. package/dist/services/query-builder/{query-builder-service.spec.js → spec/query-builder-service.spec.js} +4 -4
  320. package/dist/services/query-builder/{rules/spec → spec/rules}/pattern-language.spec.js +1 -1
  321. package/dist/services/query-builder/{rules/spec → spec/rules}/rule-parser.spec.js +1 -1
  322. package/dist/services/query-builder/{rules/spec → spec/rules}/rule-reducer.spec.js +2 -2
  323. package/dist/services/query-builder/{rules/spec → spec/rules}/rule-relevance.spec.js +2 -2
  324. package/dist/services/query-builder/{rules/spec → spec/rules}/rule-to-sql.spec.js +2 -2
  325. package/dist/services/query-builder/{rules/spec → spec/rules}/runtime-semantics.spec.js +1 -1
  326. package/dist/services/query-builder/{rules/spec → spec/rules}/strip-parameters.spec.js +3 -3
  327. package/dist/services/query-builder/{sql/spec → spec/sql}/expression.spec.js +2 -2
  328. package/dist/services/query-builder/{sql/spec → spec/sql}/format.spec.js +2 -2
  329. package/dist/services/query-builder/{sql/spec → spec/sql}/predicate.spec.js +1 -1
  330. package/dist/services/query-builder/{sql/spec → spec/sql}/regex.spec.js +1 -1
  331. package/dist/services/revalidate/index.d.ts +1 -0
  332. package/dist/services/revalidate/index.js +1 -0
  333. package/dist/services/revalidate/revalidate-factory.d.ts +3 -3
  334. package/dist/services/revalidate/revalidate-factory.js +1 -2
  335. package/dist/services/revalidate/revalidate-model.d.ts +0 -9
  336. package/dist/services/revalidate/revalidate-model.js +0 -8
  337. package/dist/services/revalidate/revalidate-service-build-context.d.ts +38 -0
  338. package/dist/services/revalidate/revalidate-service-build-context.js +59 -0
  339. package/dist/services/revalidate/revalidate-service.d.ts +2 -2
  340. package/dist/services/revalidate/{revalidate-service.spec.js → spec/revalidate-service.spec.js} +1 -1
  341. package/dist/services/setup/browser/browser-setup-service.d.ts +3 -5
  342. package/dist/services/setup/browser/browser-setup-service.js +16 -18
  343. package/dist/services/setup/difftool/difftool-setup-service.d.ts +3 -5
  344. package/dist/services/setup/difftool/difftool-setup-service.js +5 -7
  345. package/dist/services/setup/extension/extension-installer.d.ts +1 -1
  346. package/dist/services/setup/extension/extension-setup-service.d.ts +3 -5
  347. package/dist/services/setup/extension/extension-setup-service.js +8 -10
  348. package/dist/services/setup/index.d.ts +1 -1
  349. package/dist/services/setup/index.js +1 -1
  350. package/dist/services/setup/setup-service-build-context.d.ts +27 -0
  351. package/dist/services/setup/setup-service-build-context.js +26 -0
  352. package/dist/services/setup/setup-service-factory.d.ts +2 -4
  353. package/dist/services/setup/setup-service-factory.js +10 -17
  354. package/dist/services/setup/setup-service.d.ts +4 -6
  355. package/dist/services/setup/setup-service.js +6 -7
  356. package/dist/services/setup/{extension → spec/extension}/crx.spec.js +1 -1
  357. package/dist/services/setup/{extension → spec/extension}/webstore.spec.js +1 -1
  358. package/dist/services/setup/spec/os/tool-registry.spec.d.ts +1 -0
  359. package/dist/services/setup/{os → spec/os}/tool-registry.spec.js +1 -1
  360. package/oclif.manifest.json +1 -52
  361. package/package.json +6 -3
  362. package/dist/commands/document-handler.d.ts +0 -16
  363. package/dist/commands/document-handler.js +0 -32
  364. package/dist/helpers/cli-config.d.ts +0 -59
  365. package/dist/helpers/cli-config.js +0 -180
  366. package/dist/helpers/cli-config.spec.js +0 -117
  367. package/dist/helpers/customer-config.d.ts +0 -45
  368. package/dist/helpers/customer-config.js +0 -136
  369. package/dist/helpers/environment.d.ts +0 -15
  370. package/dist/helpers/environment.js +0 -40
  371. package/dist/helpers/environment.spec.js +0 -28
  372. package/dist/helpers/file-helper.d.ts +0 -8
  373. package/dist/helpers/file-helper.js +0 -28
  374. package/dist/helpers/is-directory.d.ts +0 -5
  375. package/dist/helpers/is-directory.js +0 -19
  376. package/dist/helpers/is-file.d.ts +0 -5
  377. package/dist/helpers/is-file.js +0 -19
  378. package/dist/helpers/logging-helper.d.ts +0 -15
  379. package/dist/helpers/logging-helper.js +0 -23
  380. package/dist/helpers/scrape.d.ts +0 -1
  381. package/dist/helpers/scrape.js +0 -8
  382. package/dist/helpers/speed-kit-rule-to-reg-exp.d.ts +0 -1
  383. package/dist/helpers/speed-kit-rule-to-reg-exp.js +0 -6
  384. package/dist/models/cli-parameters.js +0 -299
  385. package/dist/models/install.d.ts +0 -24
  386. package/dist/services/config-api/entity-manager-factory.d.ts +0 -5
  387. package/dist/services/config-api-service.d.ts +0 -21
  388. package/dist/services/config-api-service.js +0 -107
  389. package/dist/services/customer-config/customer-config-service-context.d.ts +0 -13
  390. package/dist/services/customer-config/customer-config-service-context.js +0 -21
  391. package/dist/services/deploy/context/deploy-context.d.ts +0 -32
  392. package/dist/services/deploy/context/deploy-context.js +0 -72
  393. package/dist/services/diff/diff-model.d.ts +0 -9
  394. package/dist/services/diff/diff-model.js +0 -12
  395. package/dist/services/diff-service.d.ts +0 -27
  396. package/dist/services/diff-service.js +0 -116
  397. package/dist/services/document-handler-runtime/context/document-handler-runtime-context.d.ts +0 -24
  398. package/dist/services/document-handler-runtime/context/document-handler-runtime-context.js +0 -62
  399. package/dist/services/document-handler-runtime/document-handler-runtime-service.d.ts +0 -31
  400. package/dist/services/document-handler-runtime/document-handler-runtime-service.js +0 -222
  401. package/dist/services/document-handler-runtime/interface/document-handler-runtime-config-interface.d.ts +0 -3
  402. package/dist/services/document-handler-runtime/interface/document-handler-runtime-config-interface.js +0 -3
  403. package/dist/services/document-handler-runtime/templates/execute-document-handler.d.ts +0 -6
  404. package/dist/services/document-handler-runtime/templates/execute-document-handler.js +0 -74
  405. package/dist/services/document-handler-runtime/templates/orestes-mock.d.ts +0 -9
  406. package/dist/services/document-handler-runtime/templates/orestes-mock.js +0 -166
  407. package/dist/services/document-handler-runtime/templates/package-json.d.ts +0 -6
  408. package/dist/services/document-handler-runtime/templates/package-json.js +0 -17
  409. package/dist/services/document-handler-runtime/templates/test.d.ts +0 -6
  410. package/dist/services/document-handler-runtime/templates/test.js +0 -64
  411. package/dist/services/origin-request/origin-request-context.d.ts +0 -13
  412. package/dist/services/origin-request/origin-request-context.js +0 -23
  413. package/dist/services/query-builder/query-command.d.ts +0 -28
  414. package/dist/services/query-builder/query-command.js +0 -37
  415. package/dist/services/setup/setup-context.d.ts +0 -14
  416. package/dist/services/setup/setup-context.js +0 -15
  417. /package/dist/helpers/{chrome-flags.spec.d.ts → spec/chrome-flags.spec.d.ts} +0 -0
  418. /package/dist/helpers/{origin-proxy.spec.d.ts → spec/origin-proxy.spec.d.ts} +0 -0
  419. /package/dist/hooks/{init → spec/init}/dns-result-order.spec.d.ts +0 -0
  420. /package/dist/hooks/{init → spec/init}/http1-global-dispatcher.spec.d.ts +0 -0
  421. /package/dist/services/athena/{athena-service.spec.d.ts → spec/athena-service.spec.d.ts} +0 -0
  422. /package/dist/services/athena/{baqend-athena-service.spec.d.ts → spec/baqend-athena-service.spec.d.ts} +0 -0
  423. /package/dist/services/browser-fetch/{browser-origin-fetch.spec.d.ts → spec/browser-origin-fetch.spec.d.ts} +0 -0
  424. /package/dist/services/browser-fetch/{browser-origin-fetcher.spec.d.ts → spec/browser-origin-fetcher.spec.d.ts} +0 -0
  425. /package/dist/services/browser-fetch/{browser-response.spec.d.ts → spec/browser-response.spec.d.ts} +0 -0
  426. /package/dist/services/browser-fetch/{device-emulation.spec.d.ts → spec/device-emulation.spec.d.ts} +0 -0
  427. /package/dist/services/bundler/{bundle-service.spec.d.ts → spec/bundle-service.spec.d.ts} +0 -0
  428. /package/dist/{helpers/cli-config.spec.d.ts → services/cli/command-build-context.js} +0 -0
  429. /package/dist/{helpers/environment.spec.d.ts → services/cli/spec/cli-environment-detection.spec.d.ts} +0 -0
  430. /package/dist/{models/cli-parameters.spec.d.ts → services/cli/spec/cli-environment.spec.d.ts} +0 -0
  431. /package/dist/services/cli/{cli-service.spec.d.ts → spec/cli-service.spec.d.ts} +0 -0
  432. /package/dist/{models/install.js → services/customer-config/site-analyzer/site-analyzer-model.js} +0 -0
  433. /package/dist/services/deploy/{bulk → spec/bulk}/bulk-deploy-service.spec.d.ts +0 -0
  434. /package/dist/services/deploy/{bulk → spec/bulk}/touched-configs.spec.d.ts +0 -0
  435. /package/dist/services/deploy/{checks → spec/checks}/activation/customer-approval-check.spec.d.ts +0 -0
  436. /package/dist/services/deploy/{checks → spec/checks}/post-deploy/refresh-deployment-job-check.spec.d.ts +0 -0
  437. /package/dist/services/deploy/{checks → spec/checks}/pre-deploy/split-change-check.spec.d.ts +0 -0
  438. /package/dist/services/deploy/{handler → spec/handler}/module-handler.spec.d.ts +0 -0
  439. /package/dist/services/deploy/{handler → spec/handler}/testing-installation-links.spec.d.ts +0 -0
  440. /package/dist/services/deploy/{mr → spec/mr}/live-state-check.spec.d.ts +0 -0
  441. /package/dist/services/deploy/{mr → spec/mr}/merge-request-description.spec.d.ts +0 -0
  442. /package/dist/services/deploy/{policy → spec/policy}/auto-deploy-policy.spec.d.ts +0 -0
  443. /package/dist/{helpers/html-format-helper.d.ts → services/diff/html-format.d.ts} +0 -0
  444. /package/dist/{helpers/html-format-helper.js → services/diff/html-format.js} +0 -0
  445. /package/dist/services/document-handler-runtime/{document-handler-abort.spec.d.ts → spec/document-handler-abort.spec.d.ts} +0 -0
  446. /package/dist/services/git/{git-repository.spec.d.ts → spec/git-repository.spec.d.ts} +0 -0
  447. /package/dist/{helpers → services/integration-api}/array-helper.d.ts +0 -0
  448. /package/dist/{helpers → services/integration-api}/array-helper.js +0 -0
  449. /package/dist/services/onboarding/{browser → spec/browser}/executable/headed-user-agent.spec.d.ts +0 -0
  450. /package/dist/services/onboarding/{empty-service-worker.spec.d.ts → spec/empty-service-worker.spec.d.ts} +0 -0
  451. /package/dist/services/onboarding/{onboarding-model.spec.d.ts → spec/onboarding-model.spec.d.ts} +0 -0
  452. /package/dist/services/onboarding/{virtual-orestes-app → spec/virtual-orestes-app}/crawler.spec.d.ts +0 -0
  453. /package/dist/services/onboarding/{virtual-orestes-app → spec/virtual-orestes-app}/origin-error-cause.spec.d.ts +0 -0
  454. /package/dist/{helpers → services/origin-request}/java-regex.d.ts +0 -0
  455. /package/dist/{helpers → services/origin-request}/java-regex.js +0 -0
  456. /package/dist/services/origin-request/{asset-variations.spec.d.ts → spec/asset-variations.spec.d.ts} +0 -0
  457. /package/dist/services/prewarm/{csv-reader.spec.d.ts → spec/csv-reader.spec.d.ts} +0 -0
  458. /package/dist/services/prewarm/{prewarm-targets.spec.d.ts → spec/prewarm-targets.spec.d.ts} +0 -0
  459. /package/dist/services/query-builder/{queries/spec → spec/queries}/golden-configs.d.ts +0 -0
  460. /package/dist/services/query-builder/{queries/spec → spec/queries}/golden-configs.js +0 -0
  461. /package/dist/services/query-builder/{queries/spec → spec/queries}/golden.spec.d.ts +0 -0
  462. /package/dist/services/query-builder/{queries/spec → spec/queries}/pops-query.spec.d.ts +0 -0
  463. /package/dist/services/query-builder/{queries/spec → spec/queries}/queries.spec.d.ts +0 -0
  464. /package/dist/services/query-builder/{queries/spec → spec/queries}/reported-bugs.spec.d.ts +0 -0
  465. /package/dist/services/query-builder/{query-builder-service.spec.d.ts → spec/query-builder-flags.spec.d.ts} +0 -0
  466. /package/dist/services/query-builder/{rules/spec/pattern-language.spec.d.ts → spec/query-builder-service.spec.d.ts} +0 -0
  467. /package/dist/services/query-builder/{rules/spec/rule-parser.spec.d.ts → spec/rules/pattern-language.spec.d.ts} +0 -0
  468. /package/dist/services/query-builder/{rules/spec/rule-reducer.spec.d.ts → spec/rules/rule-parser.spec.d.ts} +0 -0
  469. /package/dist/services/query-builder/{rules/spec/rule-relevance.spec.d.ts → spec/rules/rule-reducer.spec.d.ts} +0 -0
  470. /package/dist/services/query-builder/{rules/spec/rule-to-sql.spec.d.ts → spec/rules/rule-relevance.spec.d.ts} +0 -0
  471. /package/dist/services/query-builder/{rules/spec/runtime-semantics.spec.d.ts → spec/rules/rule-to-sql.spec.d.ts} +0 -0
  472. /package/dist/services/query-builder/{rules/spec/strip-parameters.spec.d.ts → spec/rules/runtime-semantics.spec.d.ts} +0 -0
  473. /package/dist/services/query-builder/{sql/spec/expression.spec.d.ts → spec/rules/strip-parameters.spec.d.ts} +0 -0
  474. /package/dist/services/query-builder/{sql/spec/format.spec.d.ts → spec/sql/expression.spec.d.ts} +0 -0
  475. /package/dist/services/query-builder/{sql/spec/predicate.spec.d.ts → spec/sql/format.spec.d.ts} +0 -0
  476. /package/dist/services/query-builder/{sql/spec/regex.spec.d.ts → spec/sql/predicate.spec.d.ts} +0 -0
  477. /package/dist/services/{revalidate/revalidate-service.spec.d.ts → query-builder/spec/sql/regex.spec.d.ts} +0 -0
  478. /package/dist/services/{setup/extension/crx.spec.d.ts → revalidate/spec/revalidate-service.spec.d.ts} +0 -0
  479. /package/dist/services/setup/{extension/webstore.spec.d.ts → spec/extension/crx.spec.d.ts} +0 -0
  480. /package/dist/services/setup/{os/tool-registry.spec.d.ts → spec/extension/webstore.spec.d.ts} +0 -0
package/CHANGELOG.md CHANGED
@@ -1,3 +1,18 @@
1
+ ## [4.36.2](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.36.1...v4.36.2) (2026-09-25)
2
+
3
+
4
+ ### Bug Fixes
5
+
6
+ * **query:** keep the action lines out of a --quiet payload ([a71aa5e](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/a71aa5eb80ed0f121d43e1191efaf1135860bb9a))
7
+
8
+ ## [4.36.1](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.36.0...v4.36.1) (2026-09-25)
9
+
10
+
11
+ ### Bug Fixes
12
+
13
+ * **cli:** register the first-run init hook ([1e9c073](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/1e9c073caf296c158054a745a4a56f86dbeff1e8))
14
+ * **deploy:** let a deploy without --mr pass the --approval check ([72ae3d4](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/72ae3d4d08dd9b4371f82734ddbaceec7ba32842))
15
+
1
16
  # [4.36.0](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.35.1...v4.36.0) (2026-09-24)
2
17
 
3
18
 
package/README.md CHANGED
@@ -8,6 +8,8 @@
8
8
 
9
9
  ## Quicklinks
10
10
 
11
+ Working on the CLI itself? The contributing docs are in [docs/](./docs/index.md) — architecture, one page per service, and a command-to-service map.
12
+
11
13
  <!-- toc -->
12
14
  * [Usage](#usage)
13
15
  * [Commands](#commands)
@@ -15,19 +17,16 @@
15
17
 
16
18
  # Usage
17
19
 
18
- <!-- usage -->
19
20
  ```sh-session
20
21
  $ npm install -g @speedkit/cli
21
22
  $ sk COMMAND
22
23
  running command...
23
24
  $ sk (--version)
24
- @speedkit/cli/4.36.0 linux-x64 node-v22.23.3
25
25
  $ sk --help [COMMAND]
26
26
  USAGE
27
27
  $ sk COMMAND
28
28
  ...
29
29
  ```
30
- <!-- usagestop -->
31
30
 
32
31
  > **💡 NOTE:**
33
32
  Set up auto-completion for the CLI by executing [`sk autocomplete [SHELL]`](#sk-autocomplete-shell) once.
@@ -79,7 +78,6 @@ By either...
79
78
  * [`sk config setup`](#sk-config-setup)
80
79
  * [`sk deploy CUSTOMERPATH`](#sk-deploy-customerpath)
81
80
  * [`sk diff-url-parameters PAGEURL`](#sk-diff-url-parameters-pageurl)
82
- * [`sk document-handler CUSTOMERPATH`](#sk-document-handler-customerpath)
83
81
  * [`sk extension add [REF]`](#sk-extension-add-ref)
84
82
  * [`sk extension devtools`](#sk-extension-devtools)
85
83
  * [`sk extension list`](#sk-extension-list)
@@ -452,7 +450,7 @@ FLAGS
452
450
  -d, --dryRun dry run
453
451
  -t, --useTestConfig Override app with configured testApp
454
452
  -v, --verboseLevel Show all messages
455
- --approval=<option> [default: skip] what to do with a customer that approves every rollout themselves
453
+ --approval=<option> what to do with a customer that approves every rollout themselves
456
454
  <options: approved|testing|skip>
457
455
  --description=<value> the description every installation of the run gets, asked while it is left out
458
456
  --mr=<value> deploy the reviewed change of this merged merge request, without questions
@@ -492,30 +490,6 @@ EXAMPLES
492
490
  $ sk prewarm https://www.decathlon.de/ -h
493
491
  ```
494
492
 
495
- ## `sk document-handler CUSTOMERPATH`
496
-
497
- Creates testable documentHandler in folder {CUSTOMER_PATH}/test/src/
498
-
499
- ```
500
- USAGE
501
- $ sk document-handler CUSTOMERPATH [-c <value>] [-t <value>...]
502
-
503
- ARGUMENTS
504
- CUSTOMERPATH The customer config path
505
-
506
- FLAGS
507
- -c, --configName=<value> [default: production] The costumer config name
508
- -t, --CreateTests=<value>... name of the test to create
509
-
510
- DESCRIPTION
511
- Creates testable documentHandler in folder {CUSTOMER_PATH}/test/src/
512
-
513
- EXAMPLES
514
- $ sk documentHandler <customerPath> -c <configName>
515
-
516
- $ sk deploy customers/decathlon.de -c production
517
- ```
518
-
519
493
  ## `sk extension add [REF]`
520
494
 
521
495
  Install a Chrome extension into the onboarding browser by Web Store link or id
@@ -0,0 +1,41 @@
1
+ import { Command } from "@oclif/core";
2
+ import { CliEnvironment, CommandBuildContext } from "../services/cli/index.js";
3
+ /**
4
+ * The base of every `sk` command: before `run()` it builds the invocation's
5
+ * environment, with its one CLI, and — when the command names one — the build
6
+ * context of the service it runs.
7
+ *
8
+ * ```ts
9
+ * export default class Pull extends SkCommand<PullServiceBuildContext> {
10
+ * static buildContext = PullServiceBuildContext;
11
+ * static args = PullServiceBuildContext.args;
12
+ * static flags = PullServiceBuildContext.flags;
13
+ *
14
+ * async run() {
15
+ * const service = await new PullServiceFactory(this.context).buildService();
16
+ * await service.run();
17
+ * }
18
+ * }
19
+ * ```
20
+ *
21
+ * Building both here, once, is what makes the environment and the CLI single
22
+ * per run. Commands live in `src/commands/`, where oclif loads every file as a
23
+ * command, so this base lives outside it.
24
+ */
25
+ export declare abstract class SkCommand<Built = never> extends Command {
26
+ /** The build context this command creates from its args and flags, if any. */
27
+ static buildContext?: CommandBuildContext<unknown>;
28
+ /** The environment of this invocation; `environment.cli` is its CLI. */
29
+ protected environment: CliEnvironment;
30
+ /** The build context, when the command names one in `buildContext`. */
31
+ protected context: Built;
32
+ init(): Promise<void>;
33
+ /**
34
+ * The customer whose documentHandler node modules the environment points
35
+ * at. None by default; onboarding, which runs the documentHandler locally,
36
+ * names its customer.
37
+ */
38
+ protected customerPathForModules(_args: Record<string, unknown>): string | undefined;
39
+ /** Whether the CLI is built quiet: the command's `--quiet`, if it has one. */
40
+ protected quietCli(flags: Record<string, unknown>): boolean;
41
+ }
@@ -0,0 +1,56 @@
1
+ import { Command } from "@oclif/core";
2
+ import { CliEnvironmentFactory, } from "../services/cli/index.js";
3
+ /**
4
+ * The base of every `sk` command: before `run()` it builds the invocation's
5
+ * environment, with its one CLI, and — when the command names one — the build
6
+ * context of the service it runs.
7
+ *
8
+ * ```ts
9
+ * export default class Pull extends SkCommand<PullServiceBuildContext> {
10
+ * static buildContext = PullServiceBuildContext;
11
+ * static args = PullServiceBuildContext.args;
12
+ * static flags = PullServiceBuildContext.flags;
13
+ *
14
+ * async run() {
15
+ * const service = await new PullServiceFactory(this.context).buildService();
16
+ * await service.run();
17
+ * }
18
+ * }
19
+ * ```
20
+ *
21
+ * Building both here, once, is what makes the environment and the CLI single
22
+ * per run. Commands live in `src/commands/`, where oclif loads every file as a
23
+ * command, so this base lives outside it.
24
+ */
25
+ export class SkCommand extends Command {
26
+ /** The build context this command creates from its args and flags, if any. */
27
+ static buildContext;
28
+ /** The environment of this invocation; `environment.cli` is its CLI. */
29
+ environment;
30
+ /** The build context, when the command names one in `buildContext`. */
31
+ context;
32
+ async init() {
33
+ await super.init();
34
+ const { args, flags } = await this.parse();
35
+ this.environment = new CliEnvironmentFactory(this.config, {
36
+ customerPath: this.customerPathForModules(args),
37
+ quiet: this.quietCli(flags),
38
+ }).buildEnvironment();
39
+ const { buildContext } = this.constructor;
40
+ if (buildContext) {
41
+ this.context = buildContext.create(args, flags, this.environment);
42
+ }
43
+ }
44
+ /**
45
+ * The customer whose documentHandler node modules the environment points
46
+ * at. None by default; onboarding, which runs the documentHandler locally,
47
+ * names its customer.
48
+ */
49
+ customerPathForModules(_args) {
50
+ return undefined;
51
+ }
52
+ /** Whether the CLI is built quiet: the command's `--quiet`, if it has one. */
53
+ quietCli(flags) {
54
+ return flags["quiet"] === true;
55
+ }
56
+ }
@@ -1,12 +1,12 @@
1
- import { Command } from "@oclif/core";
2
- export default class AutoPrewarm extends Command {
1
+ import { SkCommand } from "../base/sk-command.js";
2
+ import { AutoPreWarmServiceBuildContext } from "../services/prewarm/index.js";
3
+ export default class AutoPrewarm extends SkCommand<AutoPreWarmServiceBuildContext> {
4
+ static buildContext: typeof AutoPreWarmServiceBuildContext;
3
5
  static args: {
4
6
  customerPath: import("@oclif/core/interfaces").Arg<string, {
5
7
  exists?: boolean;
6
8
  }>;
7
9
  };
8
- static description: string;
9
- static examples: string[];
10
10
  static flags: {
11
11
  variationPath: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
12
12
  keepParameterSorting: import("@oclif/core/interfaces").BooleanFlag<boolean>;
@@ -27,5 +27,7 @@ export default class AutoPrewarm extends Command {
27
27
  catalog: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
28
28
  workgroup: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
29
29
  };
30
+ static description: string;
31
+ static examples: string[];
30
32
  run(): Promise<void>;
31
33
  }
@@ -1,73 +1,20 @@
1
- import { Command, Flags } from "@oclif/core";
2
- import { CLI_ATHENA, CLI_CONFIG_NAME, CLI_CUSTOMER_CONFIG, CLI_QUERY_DAYS, CLI_QUERY_FILTERS, CLI_QUERY_PREWARM_LIST, CLIParameters, CLIParametersChar, CLIParametersExample, } from "../models/cli-parameters.js";
3
- import { CliConfig } from "../helpers/cli-config.js";
4
- import { AutoPreWarmFactory } from "../services/prewarm/index.js";
5
- export default class AutoPrewarm extends Command {
6
- static args = CLI_CUSTOMER_CONFIG;
1
+ import { SkCommand } from "../base/sk-command.js";
2
+ import { AutoPreWarmFactory, AutoPreWarmServiceBuildContext, } from "../services/prewarm/index.js";
3
+ export default class AutoPrewarm extends SkCommand {
4
+ static buildContext = AutoPreWarmServiceBuildContext;
5
+ static args = AutoPreWarmServiceBuildContext.args;
6
+ static flags = AutoPreWarmServiceBuildContext.flags;
7
7
  static description = "Build and execute the prewarm query for a customer config and start a prewarm job from the resulting URLs — no CSV needed";
8
8
  static examples = [
9
- `$ sk auto-prewarm <${CLIParameters.CustomerPath}> -${CLIParametersChar.ConfigName} <${CLIParameters.ConfigName}>`,
10
- `$ sk auto-prewarm ${CLIParametersExample.CustomerPath} -${CLIParametersChar.ConfigName} ${CLIParametersExample.ConfigName}`,
11
- `$ sk auto-prewarm ${CLIParametersExample.CustomerPath} --${CLIParameters.Device} ${CLIParametersExample.Devices}`,
12
- `$ sk auto-prewarm ${CLIParametersExample.CustomerPath} -${CLIParametersChar.Variation} ${CLIParametersExample.Variations}`,
13
- `$ sk auto-prewarm ${CLIParametersExample.CustomerPath} --${CLIParameters.Limit} 5000 --${CLIParameters.MinHits} 5`,
14
- `$ sk auto-prewarm ${CLIParametersExample.CustomerPath} --${CLIParameters.Workgroup} prewarming`,
9
+ `$ sk auto-prewarm <customerPath> -c <configName>`,
10
+ `$ sk auto-prewarm customers/decathlon.de -c production`,
11
+ `$ sk auto-prewarm customers/decathlon.de --device desktop,mobile`,
12
+ `$ sk auto-prewarm customers/decathlon.de -v MOBILE,DESKTOP`,
13
+ `$ sk auto-prewarm customers/decathlon.de --limit 5000 --minHits 5`,
14
+ `$ sk auto-prewarm customers/decathlon.de --workgroup prewarming`,
15
15
  ];
16
- static flags = {
17
- ...CLI_ATHENA,
18
- ...CLI_CONFIG_NAME,
19
- ...CLI_QUERY_DAYS,
20
- ...CLI_QUERY_FILTERS,
21
- // Every flag that shapes the pre-warm list, not a subset of them: this
22
- // command builds the same query `sk query prewarm` does, and a list it
23
- // could not narrow the same way could not be counted by that command
24
- // either — the two would describe different runs. `--count` is not among
25
- // them: this command warms the list rather than reporting its size.
26
- ...CLI_QUERY_PREWARM_LIST,
27
- // A variations file says what `--variation` says, read from disk.
28
- [CLIParameters.VariationPath]: Flags.file({
29
- char: CLIParametersChar.VariationPath,
30
- description: "path to variations.csv",
31
- exclusive: [CLIParameters.Device, CLIParameters.Variation],
32
- }),
33
- [CLIParameters.KeepParameterSorting]: Flags.boolean({
34
- char: CLIParametersChar.KeepParameterSorting,
35
- default: false,
36
- description: "Prevents alphabetical sorting of the URL parameters",
37
- }),
38
- [CLIParameters.Quiet]: Flags.boolean({
39
- char: CLIParametersChar.Quiet,
40
- default: false,
41
- description: "less output non interactive",
42
- }),
43
- [CLIParameters.Verbose]: Flags.boolean({
44
- default: false,
45
- description: "Log information about failed requests",
46
- }),
47
- };
48
16
  async run() {
49
- const { args: { customerPath }, flags: { configName, days, device, excludeNoindex, excludeNotFound, excludeSuspicious, hardNavigationsOnly, keepParameterSorting, limit, match, minHits, quiet, variation, variationPath, verbose, workgroup, catalog, }, } = await this.parse(AutoPrewarm);
50
- const service = await new AutoPreWarmFactory({
51
- customerPath,
52
- configName,
53
- days,
54
- device,
55
- excludeNoindex,
56
- excludeNotFound,
57
- excludeSuspicious,
58
- hardNavigationsOnly,
59
- limit,
60
- match,
61
- minHits,
62
- variation,
63
- variationPath,
64
- sortParameters: !keepParameterSorting,
65
- quiet,
66
- verbose,
67
- workgroup,
68
- catalog,
69
- isWindows: this.config.windows,
70
- }, new CliConfig(this.config).load()).getService();
17
+ const service = await new AutoPreWarmFactory(this.context).getService();
71
18
  await service.run();
72
19
  }
73
20
  }
@@ -1,11 +1,11 @@
1
- import { Command } from "@oclif/core";
1
+ import { SkCommand } from "../../base/sk-command.js";
2
2
  /**
3
3
  * Fish is not supported by @oclif/plugin-autocomplete (only bash, zsh and
4
4
  * powershell), so this command generates a fish completion script from the
5
5
  * oclif command manifest and installs it to ~/.config/fish/completions,
6
6
  * where fish picks it up automatically.
7
7
  */
8
- export default class AutocompleteFish extends Command {
8
+ export default class AutocompleteFish extends SkCommand {
9
9
  static description: string;
10
10
  static examples: string[];
11
11
  static flags: {
@@ -1,4 +1,5 @@
1
- import { Command, Flags } from "@oclif/core";
1
+ import { Flags } from "@oclif/core";
2
+ import { SkCommand } from "../../base/sk-command.js";
2
3
  import { mkdir, writeFile } from "node:fs/promises";
3
4
  import os from "node:os";
4
5
  import path from "node:path";
@@ -8,7 +9,7 @@ import path from "node:path";
8
9
  * oclif command manifest and installs it to ~/.config/fish/completions,
9
10
  * where fish picks it up automatically.
10
11
  */
11
- export default class AutocompleteFish extends Command {
12
+ export default class AutocompleteFish extends SkCommand {
12
13
  static description = "Generate fish shell completions and install them to ~/.config/fish/completions.";
13
14
  static examples = [
14
15
  "$ sk autocomplete fish",
@@ -1,5 +1,5 @@
1
- import { Command } from "@oclif/core";
2
- export default class BrowserClean extends Command {
1
+ import { SkCommand } from "../../base/sk-command.js";
2
+ export default class BrowserClean extends SkCommand {
3
3
  static description: string;
4
4
  static examples: string[];
5
5
  static flags: {
@@ -1,8 +1,7 @@
1
- import { Command, Flags } from "@oclif/core";
2
- import { CliServiceFactory } from "../../services/cli/index.js";
3
- import { CliConfig } from "../../helpers/cli-config.js";
1
+ import { Flags } from "@oclif/core";
2
+ import { SkCommand } from "../../base/sk-command.js";
4
3
  import { BrowserManager, } from "../../services/setup/index.js";
5
- export default class BrowserClean extends Command {
4
+ export default class BrowserClean extends SkCommand {
6
5
  static description = "Remove puppeteer-managed browser builds from the cache";
7
6
  static examples = ["$ sk browser clean", "$ sk browser clean --all"];
8
7
  static flags = {
@@ -13,9 +12,9 @@ export default class BrowserClean extends Command {
13
12
  };
14
13
  async run() {
15
14
  const { flags } = await this.parse(BrowserClean);
16
- const cli = new CliServiceFactory().getService();
17
- const userConfig = new CliConfig(this.config).load();
18
- const manager = new BrowserManager(userConfig.tempFolder, cli);
15
+ const cli = this.environment.cli;
16
+ const environment = this.environment;
17
+ const manager = new BrowserManager(environment.cacheDir, cli);
19
18
  const installed = manager.list();
20
19
  if (installed.length === 0) {
21
20
  cli.writeWarning("No puppeteer-managed browsers to clean.");
@@ -1,5 +1,5 @@
1
- import { Command } from "@oclif/core";
2
- export default class BrowserList extends Command {
1
+ import { SkCommand } from "../../base/sk-command.js";
2
+ export default class BrowserList extends SkCommand {
3
3
  static description: string;
4
4
  static examples: string[];
5
5
  run(): Promise<void>;
@@ -1,14 +1,12 @@
1
- import { Command } from "@oclif/core";
2
- import { CliServiceFactory } from "../../services/cli/index.js";
3
- import { CliConfig } from "../../helpers/cli-config.js";
1
+ import { SkCommand } from "../../base/sk-command.js";
4
2
  import { BrowserDetector, normalizePlatform, } from "../../services/setup/index.js";
5
- export default class BrowserList extends Command {
3
+ export default class BrowserList extends SkCommand {
6
4
  static description = "List detected system browsers and puppeteer-managed builds";
7
5
  static examples = ["$ sk browser list"];
8
6
  async run() {
9
- const cli = new CliServiceFactory().getService();
10
- const userConfig = new CliConfig(this.config).load();
11
- const detector = new BrowserDetector(normalizePlatform(this.config.platform), this.config.home, userConfig.tempFolder);
7
+ const cli = this.environment.cli;
8
+ const environment = this.environment;
9
+ const detector = new BrowserDetector(normalizePlatform(this.config.platform), this.config.home, environment.cacheDir);
12
10
  const browsers = detector.detectAll();
13
11
  if (browsers.length === 0) {
14
12
  cli.writeWarning("No browsers detected.");
@@ -18,7 +16,7 @@ export default class BrowserList extends Command {
18
16
  name: browser.name,
19
17
  source: browser.source,
20
18
  path: browser.executablePath,
21
- active: browser.executablePath === userConfig.chromePath ? "✔" : "",
19
+ active: browser.executablePath === environment.settings.chromePath ? "✔" : "",
22
20
  })), {
23
21
  name: { header: "Browser" },
24
22
  source: { header: "Source" },
@@ -1,5 +1,5 @@
1
- import { Command } from "@oclif/core";
2
- export default class BrowserUpdate extends Command {
1
+ import { SkCommand } from "../../base/sk-command.js";
2
+ export default class BrowserUpdate extends SkCommand {
3
3
  static description: string;
4
4
  static examples: string[];
5
5
  run(): Promise<void>;
@@ -1,28 +1,25 @@
1
- import { Command } from "@oclif/core";
2
- import { CliServiceFactory } from "../../services/cli/index.js";
3
- import { CliConfig } from "../../helpers/cli-config.js";
1
+ import { SkCommand } from "../../base/sk-command.js";
4
2
  import { BrowserManager } from "../../services/setup/index.js";
5
- export default class BrowserUpdate extends Command {
3
+ export default class BrowserUpdate extends SkCommand {
6
4
  static description = "Update the puppeteer-managed browser to the latest build of its channel";
7
5
  static examples = ["$ sk browser update"];
8
6
  async run() {
9
- const cli = new CliServiceFactory().getService();
10
- const cliConfig = new CliConfig(this.config);
11
- const userConfig = cliConfig.load();
12
- const channel = userConfig.browserChannel;
7
+ const cli = this.environment.cli;
8
+ const environment = this.environment;
9
+ const channel = environment.settings.browserChannel;
13
10
  if (channel !== "stable" && channel !== "experimental") {
14
11
  cli.writeWarning("No puppeteer-managed browser configured. Run `sk config setup` first.");
15
12
  return;
16
13
  }
17
- const manager = new BrowserManager(userConfig.tempFolder, cli);
14
+ const manager = new BrowserManager(environment.cacheDir, cli);
18
15
  const latest = await manager.resolveBuildId(channel);
19
- if (latest === userConfig.browserBuildId) {
16
+ if (latest === environment.settings.browserBuildId) {
20
17
  cli.writeSuccess(`Already on the latest ${channel} build (${latest}).`);
21
- cliConfig.save({ lastBrowserUpdateCheck: new Date().toISOString() });
18
+ environment.save({ lastBrowserUpdateCheck: new Date().toISOString() });
22
19
  return;
23
20
  }
24
21
  const installed = await manager.installChannel(channel);
25
- cliConfig.save({
22
+ environment.save({
26
23
  chromePath: installed.executablePath,
27
24
  browserBuildId: installed.buildId,
28
25
  lastBrowserUpdateCheck: new Date().toISOString(),
@@ -1,5 +1,7 @@
1
- import { Command } from "@oclif/core";
2
- export default class BulkDeploy extends Command {
1
+ import { SkCommand } from "../base/sk-command.js";
2
+ import { BulkDeployServiceBuildContext } from "../services/deploy/bulk/index.js";
3
+ export default class BulkDeploy extends SkCommand<BulkDeployServiceBuildContext> {
4
+ static buildContext: typeof BulkDeployServiceBuildContext;
3
5
  static args: {
4
6
  mr: import("@oclif/core/interfaces").Arg<number, {
5
7
  max?: number;
@@ -1,47 +1,17 @@
1
- import { Args, Command, Flags } from "@oclif/core";
2
- import { CliConfig } from "../helpers/cli-config.js";
3
- import { BulkDeployContext, BulkDeployServiceFactory, } from "../services/deploy/bulk/index.js";
1
+ import { SkCommand } from "../base/sk-command.js";
2
+ import { BulkDeployServiceBuildContext, BulkDeployServiceFactory, } from "../services/deploy/bulk/index.js";
4
3
  import { DeployOutcome } from "../services/deploy/mr/index.js";
5
- export default class BulkDeploy extends Command {
6
- static args = {
7
- mr: Args.integer({
8
- name: "mr",
9
- required: true,
10
- description: "The number of the merged merge request",
11
- }),
12
- };
4
+ export default class BulkDeploy extends SkCommand {
5
+ static buildContext = BulkDeployServiceBuildContext;
6
+ static args = BulkDeployServiceBuildContext.args;
13
7
  static description = "Deploys the production config of every customer of a merged merge request at once. Use sk deploy --mr for a single customer";
14
- static flags = {
15
- repository: Flags.directory({
16
- char: "r",
17
- default: ".",
18
- description: "A path in the repository that holds the customer configs",
19
- }),
20
- approval: Flags.string({
21
- options: ["approved", "testing", "skip"],
22
- description: "what to do with a customer that approves every rollout themselves",
23
- }),
24
- description: Flags.string({
25
- description: "the description every installation of the run gets, asked while it is left out",
26
- }),
27
- dryRun: Flags.boolean({
28
- char: "d",
29
- default: false,
30
- description: "dry run",
31
- }),
32
- yes: Flags.boolean({
33
- char: "y",
34
- default: false,
35
- description: "deploy the plan without the confirmation",
36
- }),
37
- };
8
+ static flags = BulkDeployServiceBuildContext.flags;
38
9
  static examples = [
39
10
  "$ sk bulk-deploy 8017",
40
11
  "$ sk bulk-deploy 8017 -r ../sk-onboarding --approval testing",
41
12
  ];
42
13
  async run() {
43
- const { args: { mr }, flags: { repository, approval, description, dryRun, yes }, } = await this.parse(BulkDeploy);
44
- const service = new BulkDeployServiceFactory(new BulkDeployContext(repository, mr, approval, description, dryRun, yes), new CliConfig(this.config).load()).getService();
14
+ const service = new BulkDeployServiceFactory(this.context).getService();
45
15
  const results = await service.run();
46
16
  // A failure of one configuration is a failure of the run, so a pipeline
47
17
  // that calls this command sees it.
@@ -1,5 +1,5 @@
1
- import { Command } from "@oclif/core";
2
- export default class Edit extends Command {
1
+ import { SkCommand } from "../../base/sk-command.js";
2
+ export default class Edit extends SkCommand {
3
3
  static description: string;
4
4
  static examples: string[];
5
5
  run(): Promise<void>;
@@ -1,9 +1,9 @@
1
- import { Command } from "@oclif/core";
1
+ import { SkCommand } from "../../base/sk-command.js";
2
2
  import path from "node:path";
3
3
  import { spawn } from "node:child_process";
4
4
  import * as dotenv from "dotenv";
5
5
  dotenv.config({ quiet: true });
6
- export default class Edit extends Command {
6
+ export default class Edit extends SkCommand {
7
7
  static description = "Edit cli config";
8
8
  static examples = [`$ sk config edit`];
9
9
  async run() {
@@ -1,7 +1,10 @@
1
- import { Command } from "@oclif/core";
2
- export default class Setup extends Command {
1
+ import { SkCommand } from "../../base/sk-command.js";
2
+ import { SetupServiceBuildContext } from "../../services/setup/index.js";
3
+ export default class Setup extends SkCommand<SetupServiceBuildContext> {
3
4
  static description: string;
4
5
  static examples: string[];
6
+ static buildContext: typeof SetupServiceBuildContext;
7
+ static args: {};
5
8
  static flags: {
6
9
  force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
7
10
  postInstall: import("@oclif/core/interfaces").BooleanFlag<boolean>;
@@ -1,26 +1,17 @@
1
- import { Command, Flags } from "@oclif/core";
2
- import { SetupContext, SetupServiceFactory, } from "../../services/setup/index.js";
3
- import { isNonInteractive } from "../../helpers/environment.js";
4
- export default class Setup extends Command {
1
+ import { SkCommand } from "../../base/sk-command.js";
2
+ import { SetupServiceBuildContext, SetupServiceFactory, } from "../../services/setup/index.js";
3
+ export default class Setup extends SkCommand {
5
4
  static description = "Run the Speed Kit CLI setup wizard (choose browser and diff tool)";
6
5
  static examples = ["$ sk config setup", "$ sk config setup --force"];
7
- static flags = {
8
- force: Flags.boolean({
9
- char: "f",
10
- description: "Re-run even if setup was already completed",
11
- }),
12
- postInstall: Flags.boolean({
13
- hidden: true,
14
- description: "Internal flag used by the npm postinstall hook",
15
- }),
16
- };
6
+ static buildContext = SetupServiceBuildContext;
7
+ static args = SetupServiceBuildContext.args;
8
+ static flags = SetupServiceBuildContext.flags;
17
9
  async run() {
18
- const { flags } = await this.parse(Setup);
19
- const context = new SetupContext(flags.postInstall, flags.force);
20
- const service = new SetupServiceFactory(this.config, context).getService();
10
+ const cli = this.environment.cli;
11
+ const service = new SetupServiceFactory(this.context).getService();
21
12
  // When triggered by postinstall, only run if it is safe and not yet done.
22
- if (flags.postInstall &&
23
- (isNonInteractive() || service.isFirstRunCompleted())) {
13
+ if (this.context.postInstall &&
14
+ (cli.nonInteractive || service.isFirstRunCompleted())) {
24
15
  return;
25
16
  }
26
17
  await service.run();
@@ -1,11 +1,20 @@
1
- import { Command } from "@oclif/core";
2
- export default class Deploy extends Command {
1
+ import { SkCommand } from "../base/sk-command.js";
2
+ export default class Deploy extends SkCommand {
3
3
  static args: {
4
4
  customerPath: import("@oclif/core/interfaces").Arg<string, {
5
5
  exists?: boolean;
6
6
  }>;
7
7
  };
8
- static flags: Record<string, Command.Flag>;
8
+ static flags: {
9
+ dryRun: import("@oclif/core/interfaces").BooleanFlag<boolean>;
10
+ verboseLevel: import("@oclif/core/interfaces").BooleanFlag<boolean>;
11
+ artifacts: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
12
+ mr: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
13
+ description: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
14
+ approval: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
15
+ useTestConfig: import("@oclif/core/interfaces").BooleanFlag<boolean>;
16
+ configName: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
17
+ };
9
18
  static description: string;
10
19
  static examples: string[];
11
20
  run(): Promise<void>;