@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.
- package/CHANGELOG.md +14 -0
- package/README.md +1426 -14
- package/dist/base/run-control-command.d.ts +15 -0
- package/dist/base/run-control-command.js +20 -0
- package/dist/build-info.json +6 -0
- package/dist/commands/diff.d.ts +7 -1
- package/dist/commands/diff.js +9 -3
- package/dist/commands/login.d.ts +3 -0
- package/dist/commands/login.js +14 -3
- package/dist/commands/onboarding/browser/click.d.ts +75 -0
- package/dist/commands/onboarding/browser/click.js +19 -0
- package/dist/commands/onboarding/browser/emulate.d.ts +105 -0
- package/dist/commands/onboarding/browser/emulate.js +26 -0
- package/dist/commands/onboarding/browser/navigate.d.ts +75 -0
- package/dist/commands/onboarding/browser/navigate.js +19 -0
- package/dist/commands/onboarding/browser/panel.d.ts +63 -0
- package/dist/commands/onboarding/browser/panel.js +12 -0
- package/dist/commands/onboarding/browser/reinstall-sw.d.ts +63 -0
- package/dist/commands/onboarding/browser/reinstall-sw.js +14 -0
- package/dist/commands/onboarding/browser/reset.d.ts +71 -0
- package/dist/commands/onboarding/browser/reset.js +18 -0
- package/dist/commands/onboarding/browser/screenshot.d.ts +77 -0
- package/dist/commands/onboarding/browser/screenshot.js +19 -0
- package/dist/commands/onboarding/browser/state.d.ts +63 -0
- package/dist/commands/onboarding/browser/state.js +12 -0
- package/dist/commands/onboarding/browser/tabs.d.ts +58 -0
- package/dist/commands/onboarding/browser/tabs.js +16 -0
- package/dist/commands/onboarding/cache/clear.d.ts +58 -0
- package/dist/commands/onboarding/cache/clear.js +12 -0
- package/dist/commands/onboarding/cache/errors.d.ts +58 -0
- package/dist/commands/onboarding/cache/errors.js +12 -0
- package/dist/commands/onboarding/cache/evict.d.ts +62 -0
- package/dist/commands/onboarding/cache/evict.js +15 -0
- package/dist/commands/onboarding/cache/get.d.ts +85 -0
- package/dist/commands/onboarding/cache/get.js +17 -0
- package/dist/commands/onboarding/cache/list.d.ts +58 -0
- package/dist/commands/onboarding/cache/list.js +15 -0
- package/dist/commands/onboarding/cache/prewarm.d.ts +73 -0
- package/dist/commands/onboarding/cache/prewarm.js +20 -0
- package/dist/commands/onboarding/cache/refresh.d.ts +62 -0
- package/dist/commands/onboarding/cache/refresh.js +18 -0
- package/dist/commands/onboarding/cdp.d.ts +81 -0
- package/dist/commands/onboarding/cdp.js +18 -0
- package/dist/commands/onboarding/debug/arm.d.ts +83 -0
- package/dist/commands/onboarding/debug/arm.js +19 -0
- package/dist/commands/onboarding/debug/await.d.ts +71 -0
- package/dist/commands/onboarding/debug/await.js +18 -0
- package/dist/commands/onboarding/debug/disarm.d.ts +63 -0
- package/dist/commands/onboarding/debug/disarm.js +12 -0
- package/dist/commands/onboarding/debug/eval.d.ts +75 -0
- package/dist/commands/onboarding/debug/eval.js +16 -0
- package/dist/commands/onboarding/debug/release.d.ts +63 -0
- package/dist/commands/onboarding/debug/release.js +12 -0
- package/dist/commands/onboarding/debug/resume.d.ts +63 -0
- package/dist/commands/onboarding/debug/resume.js +12 -0
- package/dist/commands/onboarding/debug/status.d.ts +63 -0
- package/dist/commands/onboarding/debug/status.js +12 -0
- package/dist/commands/onboarding/debug/step.d.ts +67 -0
- package/dist/commands/onboarding/debug/step.js +15 -0
- package/dist/commands/onboarding/files/list.d.ts +58 -0
- package/dist/commands/onboarding/files/list.js +12 -0
- package/dist/commands/onboarding/files/read.d.ts +73 -0
- package/dist/commands/onboarding/files/read.js +16 -0
- package/dist/commands/onboarding/files/rebuild.d.ts +63 -0
- package/dist/commands/onboarding/files/rebuild.js +18 -0
- package/dist/commands/onboarding/files/validate.d.ts +58 -0
- package/dist/commands/onboarding/files/validate.js +12 -0
- package/dist/commands/onboarding/fouc.d.ts +77 -0
- package/dist/commands/onboarding/fouc.js +16 -0
- package/dist/commands/onboarding/inject/add.d.ts +89 -0
- package/dist/commands/onboarding/inject/add.js +17 -0
- package/dist/commands/onboarding/inject/clear.d.ts +63 -0
- package/dist/commands/onboarding/inject/clear.js +12 -0
- package/dist/commands/onboarding/inject/list.d.ts +63 -0
- package/dist/commands/onboarding/inject/list.js +12 -0
- package/dist/commands/onboarding/inject/read.d.ts +75 -0
- package/dist/commands/onboarding/inject/read.js +18 -0
- package/dist/commands/onboarding/inject/recipes.d.ts +63 -0
- package/dist/commands/onboarding/inject/recipes.js +12 -0
- package/dist/commands/onboarding/inject/remove.d.ts +67 -0
- package/dist/commands/onboarding/inject/remove.js +15 -0
- package/dist/commands/onboarding/list.d.ts +13 -0
- package/dist/commands/onboarding/list.js +12 -0
- package/dist/commands/onboarding/logs.d.ts +41 -0
- package/dist/commands/onboarding/logs.js +257 -0
- package/dist/commands/onboarding/navwalk.d.ts +95 -0
- package/dist/commands/onboarding/navwalk.js +19 -0
- package/dist/commands/onboarding/response.d.ts +67 -0
- package/dist/commands/onboarding/response.js +18 -0
- package/dist/commands/onboarding/rum/beacons.d.ts +75 -0
- package/dist/commands/onboarding/rum/beacons.js +16 -0
- package/dist/commands/onboarding/rum/get.d.ts +77 -0
- package/dist/commands/onboarding/rum/get.js +18 -0
- package/dist/commands/onboarding/rum/key.d.ts +67 -0
- package/dist/commands/onboarding/rum/key.js +13 -0
- package/dist/commands/onboarding/rum/previous.d.ts +63 -0
- package/dist/commands/onboarding/rum/previous.js +12 -0
- package/dist/commands/onboarding/status.d.ts +13 -0
- package/dist/commands/onboarding/status.js +17 -0
- package/dist/commands/onboarding/stop.d.ts +13 -0
- package/dist/commands/onboarding/stop.js +17 -0
- package/dist/commands/onboarding/todo.d.ts +58 -0
- package/dist/commands/onboarding/todo.js +12 -0
- package/dist/commands/onboarding/viewport.d.ts +101 -0
- package/dist/commands/onboarding/viewport.js +18 -0
- package/dist/commands/onboarding/watch.d.ts +93 -0
- package/dist/commands/onboarding/watch.js +16 -0
- package/dist/commands/onboarding.d.ts +26 -0
- package/dist/commands/onboarding.js +221 -4
- package/dist/commands/origin-request.d.ts +4 -0
- package/dist/commands/origin-request.js +4 -0
- package/dist/commands/spec/onboarding.spec.d.ts +1 -0
- package/dist/commands/spec/onboarding.spec.js +127 -0
- package/dist/services/browser-fetch/device-emulation.d.ts +11 -0
- package/dist/services/browser-fetch/device-emulation.js +14 -0
- package/dist/services/cli/build-info.d.ts +33 -0
- package/dist/services/cli/build-info.js +63 -0
- package/dist/services/cli/cli-environment-factory.d.ts +3 -0
- package/dist/services/cli/cli-environment-factory.js +1 -0
- package/dist/services/cli/cli-service-build-context.d.ts +3 -0
- package/dist/services/cli/cli-service-factory.js +1 -1
- package/dist/services/cli/cli-service-model.d.ts +29 -10
- package/dist/services/cli/cli-service.d.ts +60 -11
- package/dist/services/cli/cli-service.js +196 -32
- package/dist/services/cli/index.d.ts +2 -0
- package/dist/services/cli/index.js +2 -0
- package/dist/services/cli/sink.d.ts +47 -0
- package/dist/services/cli/sink.js +31 -0
- package/dist/services/cli/spec/build-identity.spec.d.ts +1 -0
- package/dist/services/cli/spec/build-identity.spec.js +85 -0
- package/dist/services/cli/spec/build-info.spec.d.ts +1 -0
- package/dist/services/cli/spec/build-info.spec.js +10 -0
- package/dist/services/cli/spec/cli-service-log.spec.d.ts +1 -0
- package/dist/services/cli/spec/cli-service-log.spec.js +133 -0
- package/dist/services/cli/spec/cli-service.spec.js +113 -50
- package/dist/services/cli/spec/memory-cli.d.ts +9 -0
- package/dist/services/cli/spec/memory-cli.js +9 -0
- package/dist/services/diff/config-at-ref.d.ts +20 -0
- package/dist/services/diff/config-at-ref.js +33 -0
- package/dist/services/diff/diff-service-build-context.d.ts +12 -0
- package/dist/services/diff/diff-service-build-context.js +45 -1
- package/dist/services/diff/diff-service-factory.d.ts +2 -0
- package/dist/services/diff/diff-service-factory.js +65 -25
- package/dist/services/diff/diff-service.d.ts +11 -0
- package/dist/services/diff/diff-service.js +37 -11
- package/dist/services/diff/page-source.d.ts +12 -0
- package/dist/services/diff/page-source.js +16 -11
- package/dist/services/diff/run-runtime-config.d.ts +33 -0
- package/dist/services/diff/run-runtime-config.js +74 -0
- package/dist/services/diff/sinks/tool-diff-sink.d.ts +3 -2
- package/dist/services/diff/sinks/tool-diff-sink.js +3 -2
- package/dist/services/diff/spec/config-at-ref.spec.d.ts +1 -0
- package/dist/services/diff/spec/config-at-ref.spec.js +46 -0
- package/dist/services/diff/spec/diff-service-build-context.spec.js +19 -0
- package/dist/services/diff/spec/diff-service.spec.js +95 -0
- package/dist/services/diff/spec/run-runtime-config.spec.d.ts +1 -0
- package/dist/services/diff/spec/run-runtime-config.spec.js +87 -0
- package/dist/services/git/git-repository.d.ts +2 -0
- package/dist/services/git/git-repository.js +6 -0
- package/dist/services/integration-api/customer-config-flags.js +1 -0
- package/dist/services/onboarding/browse/browse-service.d.ts +13 -1
- package/dist/services/onboarding/browse/browse-service.js +43 -7
- package/dist/services/onboarding/browser/answer-dialogs.d.ts +12 -0
- package/dist/services/onboarding/browser/answer-dialogs.js +25 -0
- package/dist/services/onboarding/browser/baqend-response.d.ts +17 -1
- package/dist/services/onboarding/browser/baqend-response.js +23 -0
- package/dist/services/onboarding/browser/console-log.d.ts +9 -0
- package/dist/services/onboarding/browser/console-log.js +27 -0
- package/dist/services/onboarding/browser/emulate-device.d.ts +12 -1
- package/dist/services/onboarding/browser/emulate-device.js +68 -13
- package/dist/services/onboarding/browser/executable/executable-validator.js +4 -2
- package/dist/services/onboarding/browser/extension/extension-bridge.js +5 -3
- package/dist/services/onboarding/browser/extension/extension-downloader.js +17 -8
- package/dist/services/onboarding/browser/extension/extension-validator.js +9 -4
- package/dist/services/onboarding/browser/launch-browser.d.ts +2 -1
- package/dist/services/onboarding/browser/launch-browser.js +6 -1
- package/dist/services/onboarding/browser/resume-restarted-workers.d.ts +14 -0
- package/dist/services/onboarding/browser/resume-restarted-workers.js +26 -0
- package/dist/services/onboarding/control/body-inspect.d.ts +24 -0
- package/dist/services/onboarding/control/body-inspect.js +106 -0
- package/dist/services/onboarding/control/browser-session.d.ts +547 -0
- package/dist/services/onboarding/control/browser-session.js +1337 -0
- package/dist/services/onboarding/control/config-validation.d.ts +17 -0
- package/dist/services/onboarding/control/config-validation.js +46 -0
- package/dist/services/onboarding/control/control-protocol.d.ts +1430 -0
- package/dist/services/onboarding/control/control-protocol.js +58 -0
- package/dist/services/onboarding/control/control-server.d.ts +292 -0
- package/dist/services/onboarding/control/control-server.js +1629 -0
- package/dist/services/onboarding/control/debug-session.d.ts +219 -0
- package/dist/services/onboarding/control/debug-session.js +897 -0
- package/dist/services/onboarding/control/fouc.d.ts +23 -0
- package/dist/services/onboarding/control/fouc.js +151 -0
- package/dist/services/onboarding/control/index.d.ts +4 -0
- package/dist/services/onboarding/control/index.js +4 -0
- package/dist/services/onboarding/control/navigate-wait.d.ts +33 -0
- package/dist/services/onboarding/control/navigate-wait.js +56 -0
- package/dist/services/onboarding/control/navwalk.d.ts +65 -0
- package/dist/services/onboarding/control/navwalk.js +248 -0
- package/dist/services/onboarding/control/preload-registry.d.ts +150 -0
- package/dist/services/onboarding/control/preload-registry.js +829 -0
- package/dist/services/onboarding/control/response-explainer.d.ts +24 -0
- package/dist/services/onboarding/control/response-explainer.js +257 -0
- package/dist/services/onboarding/control/rum.d.ts +8 -0
- package/dist/services/onboarding/control/rum.js +220 -0
- package/dist/services/onboarding/control/service-worker-tracker.d.ts +68 -0
- package/dist/services/onboarding/control/service-worker-tracker.js +120 -0
- package/dist/services/onboarding/control/viewport.d.ts +45 -0
- package/dist/services/onboarding/control/viewport.js +344 -0
- package/dist/services/onboarding/control/watch.d.ts +26 -0
- package/dist/services/onboarding/control/watch.js +157 -0
- package/dist/services/onboarding/dashboard/diff-against-current-page.js +3 -1
- package/dist/services/onboarding/dashboard/index.js +7 -2
- package/dist/services/onboarding/fetch-event-handler.d.ts +24 -5
- package/dist/services/onboarding/fetch-event-handler.js +103 -32
- package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +11 -2
- package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +14 -0
- package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +30 -0
- package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +13 -0
- package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +28 -1
- package/dist/services/onboarding/file-events/file-watcher.d.ts +42 -1
- package/dist/services/onboarding/file-events/file-watcher.js +117 -12
- package/dist/services/onboarding/inject/inject-service.js +1 -1
- package/dist/services/onboarding/onboarding-model.d.ts +40 -7
- package/dist/services/onboarding/onboarding-model.js +20 -9
- package/dist/services/onboarding/onboarding-service-build-context.d.ts +4 -0
- package/dist/services/onboarding/onboarding-service-build-context.js +7 -1
- package/dist/services/onboarding/onboarding-service-factory.d.ts +17 -1
- package/dist/services/onboarding/onboarding-service-factory.js +150 -23
- package/dist/services/onboarding/onboarding-service.d.ts +40 -1
- package/dist/services/onboarding/onboarding-service.js +139 -23
- package/dist/services/onboarding/request-cache/asset-key.d.ts +61 -0
- package/dist/services/onboarding/request-cache/asset-key.js +115 -0
- package/dist/services/onboarding/request-cache/cache.d.ts +62 -5
- package/dist/services/onboarding/request-cache/cache.js +128 -17
- package/dist/services/onboarding/spec/browser/answer-dialogs.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/browser/answer-dialogs.spec.js +66 -0
- package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/browser/console-log.spec.js +42 -0
- package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.js +45 -0
- package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/control/browser-session.spec.js +753 -0
- package/dist/services/onboarding/spec/control/control-server.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/control/control-server.spec.js +371 -0
- package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/control/debug-session.spec.js +751 -0
- package/dist/services/onboarding/spec/control/fakes.d.ts +31 -0
- package/dist/services/onboarding/spec/control/fakes.js +67 -0
- package/dist/services/onboarding/spec/control/fouc.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/control/fouc.spec.js +167 -0
- package/dist/services/onboarding/spec/control/navigate-wait.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/control/navigate-wait.spec.js +47 -0
- package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/control/navwalk.spec.js +222 -0
- package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/control/preload-registry.spec.js +432 -0
- package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/control/response-explainer.spec.js +324 -0
- package/dist/services/onboarding/spec/control/rum.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/control/rum.spec.js +222 -0
- package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +193 -0
- package/dist/services/onboarding/spec/control/viewport.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/control/viewport.spec.js +200 -0
- package/dist/services/onboarding/spec/control/watch.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/control/watch.spec.js +187 -0
- package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/fetch-event-handler.spec.js +219 -0
- package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +41 -0
- package/dist/services/onboarding/spec/onboarding-model.spec.js +39 -3
- package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +25 -1
- package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/request-cache/cache.spec.js +107 -0
- package/dist/services/onboarding/spec/todo-collector.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/todo-collector.spec.js +136 -0
- package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.d.ts +1 -0
- package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.js +65 -0
- package/dist/services/onboarding/templates/install-speed-kit-html-template.js +11 -0
- package/dist/services/onboarding/templates/spec/install-speed-kit-html-template.spec.d.ts +1 -0
- package/dist/services/onboarding/templates/spec/install-speed-kit-html-template.spec.js +119 -0
- package/dist/services/onboarding/todo-collector.d.ts +7 -2
- package/dist/services/onboarding/todo-collector.js +49 -12
- package/dist/services/onboarding/virtual-orestes-app/index.d.ts +38 -0
- package/dist/services/onboarding/virtual-orestes-app/index.js +113 -27
- package/dist/services/origin-request/asset-variations.d.ts +14 -0
- package/dist/services/origin-request/asset-variations.js +11 -4
- package/dist/services/origin-request/origin-fetcher.d.ts +7 -0
- package/dist/services/origin-request/origin-fetcher.js +43 -5
- package/dist/services/origin-request/origin-request-service-build-context.d.ts +17 -0
- package/dist/services/origin-request/origin-request-service-build-context.js +8 -0
- package/dist/services/origin-request/origin-request-service-factory.d.ts +0 -5
- package/dist/services/origin-request/origin-request-service-factory.js +2 -30
- package/dist/services/origin-request/origin-request-service.d.ts +121 -6
- package/dist/services/origin-request/origin-request-service.js +273 -49
- package/dist/services/origin-request/runtime-config-source.d.ts +6 -0
- package/dist/services/origin-request/runtime-config-source.js +15 -4
- package/dist/services/origin-request/spec/asset-variations.spec.js +20 -0
- package/dist/services/origin-request/spec/origin-request-service.spec.js +329 -6
- package/dist/services/query-builder/rules/rule-match.d.ts +35 -0
- package/dist/services/query-builder/rules/rule-match.js +70 -0
- package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +1 -0
- package/dist/services/query-builder/spec/rules/rule-match.spec.js +121 -0
- package/dist/services/run-control/browser/run-browser-contexts.d.ts +557 -0
- package/dist/services/run-control/browser/run-browser-contexts.js +91 -0
- package/dist/services/run-control/browser/run-browser-service-factory.d.ts +5 -0
- package/dist/services/run-control/browser/run-browser-service-factory.js +7 -0
- package/dist/services/run-control/browser/run-browser-service.d.ts +68 -0
- package/dist/services/run-control/browser/run-browser-service.js +206 -0
- package/dist/services/run-control/cache/run-cache-contexts.d.ts +349 -0
- package/dist/services/run-control/cache/run-cache-contexts.js +51 -0
- package/dist/services/run-control/cache/run-cache-service-factory.d.ts +6 -0
- package/dist/services/run-control/cache/run-cache-service-factory.js +12 -0
- package/dist/services/run-control/cache/run-cache-service.d.ts +35 -0
- package/dist/services/run-control/cache/run-cache-service.js +151 -0
- package/dist/services/run-control/control-client.d.ts +36 -0
- package/dist/services/run-control/control-client.js +147 -0
- package/dist/services/run-control/debug/run-debug-contexts.d.ts +416 -0
- package/dist/services/run-control/debug/run-debug-contexts.js +47 -0
- package/dist/services/run-control/debug/run-debug-service-factory.d.ts +5 -0
- package/dist/services/run-control/debug/run-debug-service-factory.js +7 -0
- package/dist/services/run-control/debug/run-debug-service.d.ts +39 -0
- package/dist/services/run-control/debug/run-debug-service.js +164 -0
- package/dist/services/run-control/files/run-files-contexts.d.ts +238 -0
- package/dist/services/run-control/files/run-files-contexts.js +26 -0
- package/dist/services/run-control/files/run-files-service-factory.d.ts +5 -0
- package/dist/services/run-control/files/run-files-service-factory.js +7 -0
- package/dist/services/run-control/files/run-files-service.d.ts +29 -0
- package/dist/services/run-control/files/run-files-service.js +120 -0
- package/dist/services/run-control/index.d.ts +32 -0
- package/dist/services/run-control/index.js +31 -0
- package/dist/services/run-control/inject/run-inject-contexts.d.ts +319 -0
- package/dist/services/run-control/inject/run-inject-contexts.js +38 -0
- package/dist/services/run-control/inject/run-inject-service-factory.d.ts +5 -0
- package/dist/services/run-control/inject/run-inject-service-factory.js +7 -0
- package/dist/services/run-control/inject/run-inject-service.d.ts +31 -0
- package/dist/services/run-control/inject/run-inject-service.js +227 -0
- package/dist/services/run-control/live-run.d.ts +37 -0
- package/dist/services/run-control/live-run.js +56 -0
- package/dist/services/run-control/probe/run-probe-contexts.d.ts +333 -0
- package/dist/services/run-control/probe/run-probe-contexts.js +73 -0
- package/dist/services/run-control/probe/run-probe-service-factory.d.ts +5 -0
- package/dist/services/run-control/probe/run-probe-service-factory.js +7 -0
- package/dist/services/run-control/probe/run-probe-service.d.ts +54 -0
- package/dist/services/run-control/probe/run-probe-service.js +194 -0
- package/dist/services/run-control/rum/run-rum-contexts.d.ts +216 -0
- package/dist/services/run-control/rum/run-rum-contexts.js +34 -0
- package/dist/services/run-control/rum/run-rum-service-factory.d.ts +5 -0
- package/dist/services/run-control/rum/run-rum-service-factory.js +7 -0
- package/dist/services/run-control/rum/run-rum-service.d.ts +36 -0
- package/dist/services/run-control/rum/run-rum-service.js +122 -0
- package/dist/services/run-control/run-answer.d.ts +28 -0
- package/dist/services/run-control/run-answer.js +58 -0
- package/dist/services/run-control/run-control-context.d.ts +102 -0
- package/dist/services/run-control/run-control-context.js +36 -0
- package/dist/services/run-control/run-control-flags.d.ts +12 -0
- package/dist/services/run-control/run-control-flags.js +22 -0
- package/dist/services/run-control/run-control-model.d.ts +9 -0
- package/dist/services/run-control/run-control-model.js +1 -0
- package/dist/services/run-control/run-control-service-factory.d.ts +14 -0
- package/dist/services/run-control/run-control-service-factory.js +26 -0
- package/dist/services/run-control/session/run-session-contexts.d.ts +25 -0
- package/dist/services/run-control/session/run-session-contexts.js +20 -0
- package/dist/services/run-control/session/run-session-service-factory.d.ts +8 -0
- package/dist/services/run-control/session/run-session-service-factory.js +18 -0
- package/dist/services/run-control/session/run-session-service.d.ts +32 -0
- package/dist/services/run-control/session/run-session-service.js +151 -0
- package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +1 -0
- package/dist/services/run-control/spec/browser/run-browser-service.spec.js +328 -0
- package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +1 -0
- package/dist/services/run-control/spec/cache/run-cache-service.spec.js +454 -0
- package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +1 -0
- package/dist/services/run-control/spec/debug/run-debug-service.spec.js +113 -0
- package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +1 -0
- package/dist/services/run-control/spec/files/run-files-service.spec.js +234 -0
- package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +1 -0
- package/dist/services/run-control/spec/inject/run-inject-service.spec.js +251 -0
- package/dist/services/run-control/spec/live-run-fixture.d.ts +32 -0
- package/dist/services/run-control/spec/live-run-fixture.js +109 -0
- package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +1 -0
- package/dist/services/run-control/spec/probe/run-probe-service.spec.js +108 -0
- package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +1 -0
- package/dist/services/run-control/spec/rum/run-rum-service.spec.js +47 -0
- package/dist/services/run-control/spec/run-answer.spec.d.ts +1 -0
- package/dist/services/run-control/spec/run-answer.spec.js +57 -0
- package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +1 -0
- package/dist/services/run-control/spec/session/run-session-service.spec.js +150 -0
- package/dist/services/run-log/crash-mirror.d.ts +31 -0
- package/dist/services/run-log/crash-mirror.js +69 -0
- package/dist/services/run-log/index.d.ts +11 -0
- package/dist/services/run-log/index.js +11 -0
- package/dist/services/run-log/jsonl-appender.d.ts +46 -0
- package/dist/services/run-log/jsonl-appender.js +91 -0
- package/dist/services/run-log/log-event-model.d.ts +104 -0
- package/dist/services/run-log/log-event-model.js +56 -0
- package/dist/services/run-log/log-query-service-factory.d.ts +11 -0
- package/dist/services/run-log/log-query-service-factory.js +14 -0
- package/dist/services/run-log/log-query-service.d.ts +59 -0
- package/dist/services/run-log/log-query-service.js +111 -0
- package/dist/services/run-log/log-reader.d.ts +84 -0
- package/dist/services/run-log/log-reader.js +180 -0
- package/dist/services/run-log/log-summary.d.ts +72 -0
- package/dist/services/run-log/log-summary.js +208 -0
- package/dist/services/run-log/redaction.d.ts +34 -0
- package/dist/services/run-log/redaction.js +124 -0
- package/dist/services/run-log/request-log.d.ts +82 -0
- package/dist/services/run-log/request-log.js +69 -0
- package/dist/services/run-log/request-summary.d.ts +76 -0
- package/dist/services/run-log/request-summary.js +0 -0
- package/dist/services/run-log/run-log.d.ts +61 -0
- package/dist/services/run-log/run-log.js +102 -0
- package/dist/services/run-log/spec/log-query-service.spec.d.ts +1 -0
- package/dist/services/run-log/spec/log-query-service.spec.js +197 -0
- package/dist/services/run-log/spec/log-reader.spec.d.ts +1 -0
- package/dist/services/run-log/spec/log-reader.spec.js +109 -0
- package/dist/services/run-log/spec/log-summary.spec.d.ts +1 -0
- package/dist/services/run-log/spec/log-summary.spec.js +153 -0
- package/dist/services/run-log/spec/redaction.spec.d.ts +1 -0
- package/dist/services/run-log/spec/redaction.spec.js +61 -0
- package/dist/services/run-log/spec/request-log.spec.d.ts +1 -0
- package/dist/services/run-log/spec/request-log.spec.js +101 -0
- package/dist/services/run-log/spec/request-summary.spec.d.ts +1 -0
- package/dist/services/run-log/spec/request-summary.spec.js +171 -0
- package/dist/services/run-log/spec/run-log.spec.d.ts +1 -0
- package/dist/services/run-log/spec/run-log.spec.js +122 -0
- package/dist/services/run-registry/exit-classification.d.ts +39 -0
- package/dist/services/run-registry/exit-classification.js +42 -0
- package/dist/services/run-registry/index.d.ts +3 -0
- package/dist/services/run-registry/index.js +3 -0
- package/dist/services/run-registry/process-identity.d.ts +28 -0
- package/dist/services/run-registry/process-identity.js +80 -0
- package/dist/services/run-registry/run-registry-model.d.ts +128 -0
- package/dist/services/run-registry/run-registry-model.js +16 -0
- package/dist/services/run-registry/run-registry.d.ts +155 -0
- package/dist/services/run-registry/run-registry.js +430 -0
- package/dist/services/run-registry/spec/exit-classification.spec.d.ts +1 -0
- package/dist/services/run-registry/spec/exit-classification.spec.js +82 -0
- package/dist/services/run-registry/spec/run-registry.spec.d.ts +1 -0
- package/dist/services/run-registry/spec/run-registry.spec.js +526 -0
- package/dist/services/setup/os/tool-registry.js +2 -2
- package/oclif.manifest.json +3414 -293
- package/package.json +20 -2
|
@@ -22,6 +22,13 @@ const DEVICE_DEFAULTS = {
|
|
|
22
22
|
mobile: { headers: { "user-agent": MOBILE_USER_AGENT } },
|
|
23
23
|
tablet: { headers: { "user-agent": TABLET_USER_AGENT } },
|
|
24
24
|
};
|
|
25
|
+
/**
|
|
26
|
+
* The variation types the server resolves whether a config defines them or not.
|
|
27
|
+
*
|
|
28
|
+
* Exported because "which variations exist" is otherwise answered with the config's own keys alone,
|
|
29
|
+
* and a config that defines none reads as "nothing can be passed" while these three still work.
|
|
30
|
+
*/
|
|
31
|
+
export const DEVICE_DEFAULT_TYPES = Object.keys(DEVICE_DEFAULTS);
|
|
25
32
|
/** Group names a template captures, e.g. `storeId` from `(?<storeId>.*)`. */
|
|
26
33
|
const CAPTURING_TEMPLATES = /<(\w+)>/g;
|
|
27
34
|
/** Thrown where the server would throw UndefinedVariationException. */
|
|
@@ -64,6 +71,7 @@ function applyTemplate(entry, variationType) {
|
|
|
64
71
|
};
|
|
65
72
|
return {
|
|
66
73
|
matchedKey: entry.matchedKey,
|
|
74
|
+
viaTemplate: true,
|
|
67
75
|
urlPrefix: entry.urlPrefix ? substitute(entry.urlPrefix) : entry.urlPrefix,
|
|
68
76
|
encodePrefixedUrl: entry.encodePrefixedUrl,
|
|
69
77
|
queryParams: (entry.queryParams ?? []).map(substitute),
|
|
@@ -180,16 +188,15 @@ export function resolveRequest(custom, url, variationType, { hostOverride, origi
|
|
|
180
188
|
const originalHost = originEntry?.origin && originEntry.overrideHostHeader
|
|
181
189
|
? parsed.hostname
|
|
182
190
|
: undefined;
|
|
183
|
-
const isTemplate = chain.some((config) => config.matchedKey !== WILD_CARD &&
|
|
184
|
-
!DEVICE_DEFAULTS[config.matchedKey ?? ""]) &&
|
|
185
|
-
!chain.some((config) => config.matchedKey?.startsWith("device-default:"));
|
|
186
191
|
const headers = buildHeaders(chain, hostOverride, originEntry, originalHost);
|
|
187
192
|
const originMapHeaders = Object.entries(originEntry?.headers ?? {})
|
|
188
193
|
.filter(([key, value]) => headers[key.toLowerCase()] === String(value))
|
|
189
194
|
.map(([key]) => key.toLowerCase());
|
|
190
195
|
return {
|
|
191
196
|
appliedKeys: chain.map((config) => config.matchedKey ?? "?"),
|
|
192
|
-
resolutionPath:
|
|
197
|
+
resolutionPath: chain.some((config) => config.viaTemplate)
|
|
198
|
+
? "template"
|
|
199
|
+
: "named",
|
|
193
200
|
...(originMapKey ? { originMapKey, originMapHeaders } : {}),
|
|
194
201
|
url: buildUrl(requestUrl, chain),
|
|
195
202
|
headers,
|
|
@@ -35,6 +35,13 @@ export declare class OriginFetcher {
|
|
|
35
35
|
/** Warnings already shown, so a per-fetch condition is reported once per session. */
|
|
36
36
|
private readonly warned;
|
|
37
37
|
constructor(deps: OriginFetcherDeps);
|
|
38
|
+
/**
|
|
39
|
+
* The variations the runtime config names. The wildcard and the regex
|
|
40
|
+
* templates are not variations of their own, and the device defaults are
|
|
41
|
+
* left out: whether a config ever produces `tablet` is decided in the
|
|
42
|
+
* browser, by `detectDevice` or the user agent, and nothing here can tell.
|
|
43
|
+
*/
|
|
44
|
+
namedVariations(): string[];
|
|
38
45
|
/** The request, without sending it. */
|
|
39
46
|
prepare(originUrl: string, variation?: string): PreparedOriginRequest;
|
|
40
47
|
/**
|
|
@@ -18,6 +18,18 @@ export class OriginFetcher {
|
|
|
18
18
|
constructor(deps) {
|
|
19
19
|
this.deps = deps;
|
|
20
20
|
}
|
|
21
|
+
/**
|
|
22
|
+
* The variations the runtime config names. The wildcard and the regex
|
|
23
|
+
* templates are not variations of their own, and the device defaults are
|
|
24
|
+
* left out: whether a config ever produces `tablet` is decided in the
|
|
25
|
+
* browser, by `detectDevice` or the user agent, and nothing here can tell.
|
|
26
|
+
*/
|
|
27
|
+
namedVariations() {
|
|
28
|
+
const variations = this.deps.config?.variations ?? {};
|
|
29
|
+
return Object.entries(variations)
|
|
30
|
+
.filter(([key, entry]) => key !== "*" && !key.startsWith("device-default:") && !entry?.regex)
|
|
31
|
+
.map(([key]) => key);
|
|
32
|
+
}
|
|
21
33
|
/** The request, without sending it. */
|
|
22
34
|
prepare(originUrl, variation) {
|
|
23
35
|
// A missing runtime config is not reported here; the load that failed says what it costs.
|
|
@@ -42,15 +54,38 @@ export class OriginFetcher {
|
|
|
42
54
|
async fetch(originUrl, variation) {
|
|
43
55
|
const { url, init } = this.prepare(originUrl, variation);
|
|
44
56
|
const action = `ORIGIN:FETCH:${randomUUID()}`;
|
|
45
|
-
this.deps.cli.startAction(action, `[documentHandler:fetch]: ${url}
|
|
57
|
+
this.deps.cli.startAction(action, `[documentHandler:fetch]: ${url}`, {
|
|
58
|
+
scope: "documentHandler",
|
|
59
|
+
data: { url, originUrl, variation },
|
|
60
|
+
});
|
|
61
|
+
const startedAt = Date.now();
|
|
46
62
|
try {
|
|
47
63
|
const response = await originFetch(url, init);
|
|
48
|
-
this.deps.cli.successAction(action
|
|
64
|
+
this.deps.cli.successAction(action, undefined, {
|
|
65
|
+
scope: "documentHandler",
|
|
66
|
+
data: {
|
|
67
|
+
url,
|
|
68
|
+
variation,
|
|
69
|
+
status: response.status,
|
|
70
|
+
durationMs: Date.now() - startedAt,
|
|
71
|
+
},
|
|
72
|
+
});
|
|
49
73
|
return { response, url };
|
|
50
74
|
}
|
|
51
75
|
catch (error) {
|
|
52
|
-
this.deps.cli.failAction(action, `error while fetching Asset: ${originUrl}
|
|
53
|
-
|
|
76
|
+
this.deps.cli.failAction(action, `error while fetching Asset: ${originUrl}`, {
|
|
77
|
+
scope: "documentHandler",
|
|
78
|
+
data: {
|
|
79
|
+
url,
|
|
80
|
+
originUrl,
|
|
81
|
+
variation,
|
|
82
|
+
durationMs: Date.now() - startedAt,
|
|
83
|
+
error: String(error),
|
|
84
|
+
},
|
|
85
|
+
});
|
|
86
|
+
this.deps.cli.writeError(String(error), false, {
|
|
87
|
+
scope: "documentHandler",
|
|
88
|
+
});
|
|
54
89
|
return undefined;
|
|
55
90
|
}
|
|
56
91
|
}
|
|
@@ -94,6 +129,9 @@ export class OriginFetcher {
|
|
|
94
129
|
if (this.warned.has(key))
|
|
95
130
|
return;
|
|
96
131
|
this.warned.add(key);
|
|
97
|
-
this.deps.cli.writeWarning(message
|
|
132
|
+
this.deps.cli.writeWarning(message, false, {
|
|
133
|
+
scope: "documentHandler",
|
|
134
|
+
data: { once: key },
|
|
135
|
+
});
|
|
98
136
|
}
|
|
99
137
|
}
|
|
@@ -11,6 +11,8 @@ declare const flags: {
|
|
|
11
11
|
host: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
|
|
12
12
|
body: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
|
|
13
13
|
grep: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
|
|
14
|
+
select: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
|
|
15
|
+
maxMatches: Interfaces.OptionFlag<number, Interfaces.CustomOptions>;
|
|
14
16
|
json: Interfaces.BooleanFlag<boolean>;
|
|
15
17
|
variations: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
|
|
16
18
|
raw: Interfaces.BooleanFlag<boolean>;
|
|
@@ -26,8 +28,21 @@ export interface OriginRequestOptions {
|
|
|
26
28
|
readonly host?: string;
|
|
27
29
|
readonly bodyFile?: string;
|
|
28
30
|
readonly grep?: string;
|
|
31
|
+
readonly select?: string;
|
|
32
|
+
readonly maxMatches?: number;
|
|
29
33
|
readonly json?: boolean;
|
|
30
34
|
readonly variationsFile?: string;
|
|
35
|
+
/**
|
|
36
|
+
* The origin a relative {@link pageUrl} is resolved against, when the
|
|
37
|
+
* caller knows one the config cannot supply.
|
|
38
|
+
*
|
|
39
|
+
* A customer with several origins and no `domain` has no base in its
|
|
40
|
+
* config, and picking `origins[0]` would answer about the wrong site. But
|
|
41
|
+
* a run *is* on one of them — the one `-d` or the startup prompt chose —
|
|
42
|
+
* and that is the origin whoever is asking means. Passed in rather than
|
|
43
|
+
* looked up, because this service has no idea a run exists.
|
|
44
|
+
*/
|
|
45
|
+
readonly base?: string;
|
|
31
46
|
}
|
|
32
47
|
export interface OriginRequestServiceBuildContextValues extends CommandContextValues, OriginRequestOptions {
|
|
33
48
|
}
|
|
@@ -45,6 +60,8 @@ export declare class OriginRequestServiceBuildContext extends OriginRequestServi
|
|
|
45
60
|
host: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
|
|
46
61
|
body: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
|
|
47
62
|
grep: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
|
|
63
|
+
select: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
|
|
64
|
+
maxMatches: Interfaces.OptionFlag<number, Interfaces.CustomOptions>;
|
|
48
65
|
json: Interfaces.BooleanFlag<boolean>;
|
|
49
66
|
variations: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
|
|
50
67
|
raw: Interfaces.BooleanFlag<boolean>;
|
|
@@ -34,6 +34,12 @@ const flags = {
|
|
|
34
34
|
grep: Flags.string({
|
|
35
35
|
description: "Print body lines matching this regex, case-insensitive",
|
|
36
36
|
}),
|
|
37
|
+
select: Flags.string({
|
|
38
|
+
description: "Count and sample what this CSS selector matches in the body, e.g. 'script[src*=\"analytics\"]'",
|
|
39
|
+
}),
|
|
40
|
+
maxMatches: Flags.integer({
|
|
41
|
+
description: "How many --select and --grep matches to show. Default 10",
|
|
42
|
+
}),
|
|
37
43
|
json: Flags.boolean({
|
|
38
44
|
description: "Machine-readable output",
|
|
39
45
|
}),
|
|
@@ -72,6 +78,8 @@ export class OriginRequestServiceBuildContext extends Context() {
|
|
|
72
78
|
host: parsedFlags.host,
|
|
73
79
|
bodyFile: parsedFlags.body,
|
|
74
80
|
grep: parsedFlags.grep,
|
|
81
|
+
select: parsedFlags.select,
|
|
82
|
+
maxMatches: parsedFlags.maxMatches,
|
|
75
83
|
json: parsedFlags.json,
|
|
76
84
|
variationsFile: parsedFlags.variations,
|
|
77
85
|
});
|
|
@@ -6,11 +6,6 @@ export declare class OriginRequestServiceFactory {
|
|
|
6
6
|
constructor(context: OriginRequestServiceBuildContext);
|
|
7
7
|
buildService(): Promise<OriginRequestService>;
|
|
8
8
|
private build;
|
|
9
|
-
/**
|
|
10
|
-
* The runtime config: a local file when one is named, else the app's. Without a customer there is
|
|
11
|
-
* no app, and the request carries Speed Kit's device defaults only.
|
|
12
|
-
*/
|
|
13
|
-
private loadRuntimeConfig;
|
|
14
9
|
private getIntegrationFiles;
|
|
15
10
|
private getConfigApi;
|
|
16
11
|
}
|
|
@@ -2,8 +2,6 @@ import { ConfigApiContext, ConfigApiServiceFactory, } from "../config-api/index.
|
|
|
2
2
|
import { IntegrationApiServiceBuildContext, IntegrationApiFactory, } from "../integration-api/index.js";
|
|
3
3
|
import { applyOriginProxy } from "../../helpers/origin-proxy.js";
|
|
4
4
|
import { OriginRequestService } from "./origin-request-service.js";
|
|
5
|
-
import { OriginFetcher } from "./origin-fetcher.js";
|
|
6
|
-
import { RuntimeConfigSource, } from "./runtime-config-source.js";
|
|
7
5
|
export class OriginRequestServiceFactory {
|
|
8
6
|
context;
|
|
9
7
|
service = undefined;
|
|
@@ -18,39 +16,13 @@ export class OriginRequestServiceFactory {
|
|
|
18
16
|
}
|
|
19
17
|
async build() {
|
|
20
18
|
const cli = this.context.environment.cli;
|
|
19
|
+
// `sk origin-request --raw <url>` names no customer: no app, so no runtime config.
|
|
21
20
|
const customer = this.context.customerPath
|
|
22
21
|
? (await this.getIntegrationFiles(this.context.customerPath)).getCustomerConfig().config
|
|
23
22
|
: undefined;
|
|
24
23
|
// `--json` owns stdout, so the proxy line stays out of a machine-readable run.
|
|
25
24
|
applyOriginProxy(customer?.chromeFlags, this.context.json ? undefined : cli);
|
|
26
|
-
|
|
27
|
-
const config = await this.loadRuntimeConfig(customer?.app);
|
|
28
|
-
this.service = new OriginRequestService(this.context, cli, config
|
|
29
|
-
? new OriginFetcher({
|
|
30
|
-
cli,
|
|
31
|
-
config,
|
|
32
|
-
host: this.context.host,
|
|
33
|
-
strict: true,
|
|
34
|
-
})
|
|
35
|
-
: undefined);
|
|
36
|
-
}
|
|
37
|
-
/**
|
|
38
|
-
* The runtime config: a local file when one is named, else the app's. Without a customer there is
|
|
39
|
-
* no app, and the request carries Speed Kit's device defaults only.
|
|
40
|
-
*/
|
|
41
|
-
async loadRuntimeConfig(app) {
|
|
42
|
-
const cli = this.context.environment.cli;
|
|
43
|
-
if (!app && !this.context.variationsFile) {
|
|
44
|
-
if (!this.context.json) {
|
|
45
|
-
cli.writeWarning("no customer: the request carries Speed Kit's device defaults only, no variation of an app");
|
|
46
|
-
}
|
|
47
|
-
return { variations: {}, authentications: [], originMap: {} };
|
|
48
|
-
}
|
|
49
|
-
return new RuntimeConfigSource({
|
|
50
|
-
cli,
|
|
51
|
-
configApi: app ? this.getConfigApi(app) : undefined,
|
|
52
|
-
fileFlag: "--variations",
|
|
53
|
-
}).load(this.context.variationsFile);
|
|
25
|
+
this.service = new OriginRequestService(this.context, cli, customer ? this.getConfigApi(customer.app) : undefined, customer);
|
|
54
26
|
}
|
|
55
27
|
async getIntegrationFiles(customerPath) {
|
|
56
28
|
const integrationApiContext = new IntegrationApiServiceBuildContext({
|
|
@@ -1,12 +1,70 @@
|
|
|
1
1
|
import { CliServiceInterface } from "../cli/index.js";
|
|
2
|
+
import { ConfigApiService } from "../config-api/index.js";
|
|
3
|
+
import { CustomerConfig } from "../integration-api/index.js";
|
|
2
4
|
import { OriginRequestOptions } from "./origin-request-service-build-context.js";
|
|
3
|
-
import { OriginFetcher } from "./origin-fetcher.js";
|
|
4
5
|
import { ResolvedRequest } from "./asset-variations.js";
|
|
5
6
|
/**
|
|
6
7
|
* The headers as reported. Origin basic auth and the origin map's headers are sent, but their
|
|
7
8
|
* values are not printed: the runtime config stores credentials there, such as a bypass token.
|
|
8
9
|
*/
|
|
9
10
|
export declare function printable(headers: Record<string, string>, { originMapHeaders }: ResolvedRequest): Record<string, string>;
|
|
11
|
+
/** What the origin answered, and the request that was sent to get it. */
|
|
12
|
+
export interface OriginRequestResult {
|
|
13
|
+
outcome: "fetched";
|
|
14
|
+
variation: string;
|
|
15
|
+
/** Every variation the config defines, so a wrong guess is one call from right. */
|
|
16
|
+
variations: string[];
|
|
17
|
+
/** And the ones the server resolves regardless — a config often defines none. */
|
|
18
|
+
deviceDefaults: string[];
|
|
19
|
+
resolutionPath: "named" | "template";
|
|
20
|
+
appliedKeys: string[];
|
|
21
|
+
/** The `speedKit.originMap` entry the request was rewritten by, if any. */
|
|
22
|
+
originMapKey?: string;
|
|
23
|
+
requestUrl: string;
|
|
24
|
+
requestHeaders: Record<string, string>;
|
|
25
|
+
curl: string;
|
|
26
|
+
status: number;
|
|
27
|
+
statusText: string;
|
|
28
|
+
responseHeaders: Record<string, string>;
|
|
29
|
+
setCookie: string[];
|
|
30
|
+
body: string;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* A reason no request was sent, as data rather than a printed line.
|
|
34
|
+
*
|
|
35
|
+
* Every one of these is a thing the caller can act on — log in, pass a file,
|
|
36
|
+
* pick a variation that exists — so each carries what the next attempt needs.
|
|
37
|
+
* Discriminated by a string: `strict` is off in this project, and a boolean
|
|
38
|
+
* discriminant does not narrow under it.
|
|
39
|
+
*/
|
|
40
|
+
export type OriginRequestFailure = {
|
|
41
|
+
outcome: "config-unavailable";
|
|
42
|
+
message: string;
|
|
43
|
+
cause: string;
|
|
44
|
+
} | {
|
|
45
|
+
outcome: "unreadable-variations";
|
|
46
|
+
message: string;
|
|
47
|
+
file: string;
|
|
48
|
+
} | {
|
|
49
|
+
outcome: "unknown-variation";
|
|
50
|
+
message: string;
|
|
51
|
+
requested: string;
|
|
52
|
+
/** What the config defines. `*` is the wildcard and a template key is a regex. */
|
|
53
|
+
available: string[];
|
|
54
|
+
deviceDefaults: string[];
|
|
55
|
+
} | {
|
|
56
|
+
outcome: "bad-url";
|
|
57
|
+
message: string;
|
|
58
|
+
url: string;
|
|
59
|
+
base: string | null;
|
|
60
|
+
};
|
|
61
|
+
export type OriginRequestOutcome = OriginRequestResult | OriginRequestFailure;
|
|
62
|
+
/** The variations a customer's deployed config defines. */
|
|
63
|
+
export type VariationListOutcome = {
|
|
64
|
+
outcome: "variations";
|
|
65
|
+
variations: string[];
|
|
66
|
+
deviceDefaults: string[];
|
|
67
|
+
} | OriginRequestFailure;
|
|
10
68
|
/**
|
|
11
69
|
* Fetches a page from origin with exactly the headers Speed Kit's server would send for a cache
|
|
12
70
|
* variation, then reports what the origin answered.
|
|
@@ -15,6 +73,10 @@ export declare function printable(headers: Record<string, string>, { originMapHe
|
|
|
15
73
|
* — without waiting for a render or reading backend logs. The variations come from the app's
|
|
16
74
|
* deployed runtime config, so the simulation follows production rather than a local file.
|
|
17
75
|
*
|
|
76
|
+
* {@link run} renders for a terminal; {@link execute} returns the same work as data. The split
|
|
77
|
+
* keeps the failures typed: a failure a human reads as one line is an outcome a caller can branch
|
|
78
|
+
* on, and the tests read it that way.
|
|
79
|
+
*
|
|
18
80
|
* Known deviations from the server, all deliberate:
|
|
19
81
|
* - Revalidation headers (If-None-Match, If-Modified-Since) apply only when refreshing a cached
|
|
20
82
|
* entry, so they are out of scope.
|
|
@@ -23,12 +85,65 @@ export declare function printable(headers: Record<string, string>, { originMapHe
|
|
|
23
85
|
export declare class OriginRequestService {
|
|
24
86
|
private readonly context;
|
|
25
87
|
private readonly cli;
|
|
26
|
-
/** Absent
|
|
27
|
-
private readonly
|
|
88
|
+
/** Absent without a customer: there is no app to load a runtime config from. */
|
|
89
|
+
private readonly configApi;
|
|
90
|
+
private readonly customer?;
|
|
28
91
|
constructor(context: OriginRequestOptions, cli: CliServiceInterface,
|
|
29
|
-
/** Absent
|
|
30
|
-
|
|
31
|
-
/** False when
|
|
92
|
+
/** Absent without a customer: there is no app to load a runtime config from. */
|
|
93
|
+
configApi: ConfigApiService | undefined, customer?: CustomerConfig);
|
|
94
|
+
/** False when no request was sent, so the command can exit 2 like `sk diff`. */
|
|
32
95
|
run(): Promise<boolean>;
|
|
96
|
+
/**
|
|
97
|
+
* The request, as data.
|
|
98
|
+
*
|
|
99
|
+
* A failure comes back as an outcome rather than a thrown error, because
|
|
100
|
+
* every one of them is an ordinary answer to "can this be simulated" — not
|
|
101
|
+
* logged in, no variations configured, a variation that does not exist. Only
|
|
102
|
+
* a genuinely unexpected error still throws.
|
|
103
|
+
*/
|
|
104
|
+
execute(): Promise<OriginRequestOutcome>;
|
|
105
|
+
/**
|
|
106
|
+
* Which variations exist, without sending anything to the origin.
|
|
107
|
+
*
|
|
108
|
+
* The answer to "what do I pass as `variation`", which otherwise costs a
|
|
109
|
+
* request that is known in advance to be refused.
|
|
110
|
+
*/
|
|
111
|
+
listVariations(): Promise<VariationListOutcome>;
|
|
112
|
+
/**
|
|
113
|
+
* Resolves the requested page against the customer's own origin, so a path is enough.
|
|
114
|
+
*
|
|
115
|
+
* Normalised the way the control socket does, and for the same reason: `new URL(input, base)`
|
|
116
|
+
* parses the base first and throws when it is not absolute — even when the input is — and
|
|
117
|
+
* `domain` is a bare host in every `config_customer` that has one. Blaming the input for a base
|
|
118
|
+
* that was wrong already cost one testing session.
|
|
119
|
+
*
|
|
120
|
+
* `domain` is optional, and plenty of configs carry only `origins` — so a single origin serves as
|
|
121
|
+
* the base too. Several origins and no `domain` used to be refused outright: picking the first
|
|
122
|
+
* would be a guess, and a page fetched from the wrong one of a customer's origins answers like a
|
|
123
|
+
* real result.
|
|
124
|
+
*
|
|
125
|
+
* {@link OriginRequestOptions.base} is the way out of that, and it wins over both — a caller that
|
|
126
|
+
* supplies one knows something the config does not. For a run that is the origin it is actually
|
|
127
|
+
* driving, which is why `sk onboarding response` accepted `/sale` on a twelve-origin customer while this
|
|
128
|
+
* refused it: the same question, two answers, for no reason the caller could see.
|
|
129
|
+
*/
|
|
130
|
+
private absoluteUrl;
|
|
131
|
+
/**
|
|
132
|
+
* Reads `speedKit.variations` from the app's deployed runtime config, or from a local file when
|
|
133
|
+
* `--variations` is given.
|
|
134
|
+
*/
|
|
135
|
+
private loadVariations;
|
|
136
|
+
/**
|
|
137
|
+
* `--raw` without a customer: no app, so no runtime config. An empty set is the point here —
|
|
138
|
+
* only Speed Kit's device defaults resolve, and no origin basic auth is sent — which is the
|
|
139
|
+
* request `sk diff --raw` makes for a site that has no config yet.
|
|
140
|
+
*/
|
|
141
|
+
private noApp;
|
|
142
|
+
private fetchRuntimeConfig;
|
|
143
|
+
private readVariationsFile;
|
|
33
144
|
private report;
|
|
145
|
+
/** `--select`, counted and sampled: "did the origin send it" in one number. */
|
|
146
|
+
private selected;
|
|
147
|
+
/** `--grep`, case-insensitive as its flag says, each line windowed. */
|
|
148
|
+
private grepped;
|
|
34
149
|
}
|