@speedkit/cli 4.51.0 → 4.52.0
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/spec/speed-kit-install-js.spec.d.ts +1 -0
- package/dist/services/onboarding/fetch-events/spec/speed-kit-install-js.spec.js +59 -0
- package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +16 -5
- 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/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 +3479 -358
- package/package.json +20 -2
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/** Bumped whenever a change would make an older peer misread a message. */
|
|
2
|
+
export const CONTROL_PROTOCOL_VERSION = 1;
|
|
3
|
+
/** Filename inside the run directory. Unix socket, mode 0600. */
|
|
4
|
+
export const CONTROL_SOCKET = "control.sock";
|
|
5
|
+
export const CONTROL_ERRORS = {
|
|
6
|
+
/** The peer speaks a version this run does not. */
|
|
7
|
+
versionMismatch: "PROTOCOL_VERSION_MISMATCH",
|
|
8
|
+
/** Something was sent before `hello`. */
|
|
9
|
+
helloRequired: "HELLO_REQUIRED",
|
|
10
|
+
/** No such op — the run is older or newer than the caller thinks. */
|
|
11
|
+
unknownOp: "UNKNOWN_OP",
|
|
12
|
+
/** The frame did not parse. */
|
|
13
|
+
malformed: "MALFORMED_REQUEST",
|
|
14
|
+
/** The handler threw. */
|
|
15
|
+
handlerFailed: "HANDLER_FAILED",
|
|
16
|
+
/** No cache entry matched the key. */
|
|
17
|
+
noSuchEntry: "NO_SUCH_CACHE_ENTRY",
|
|
18
|
+
/** The key matched more than one entry. */
|
|
19
|
+
ambiguousEntry: "AMBIGUOUS_CACHE_KEY",
|
|
20
|
+
/** No file with that logical name in this run. */
|
|
21
|
+
noSuchFile: "NO_SUCH_FILE",
|
|
22
|
+
/** The run has no page — not started yet, or the browser has gone. */
|
|
23
|
+
noPage: "NO_PAGE",
|
|
24
|
+
/** The expression threw, or the page did not answer. */
|
|
25
|
+
evaluationFailed: "PAGE_EVALUATION_FAILED",
|
|
26
|
+
/** A browser op this run cannot perform — no browser, or no install page. */
|
|
27
|
+
browserUnavailable: "BROWSER_UNAVAILABLE",
|
|
28
|
+
/** A navigate target that is not a url, or points off the customer origin. */
|
|
29
|
+
badUrl: "BAD_URL",
|
|
30
|
+
/** The SpeedKit config could not be evaluated, so no rule verdict is possible. */
|
|
31
|
+
configUnreadable: "CONFIG_UNREADABLE",
|
|
32
|
+
/** This run cannot build cache entries — not `--local`, or older than the op. */
|
|
33
|
+
noLocalCache: "NO_LOCAL_CACHE",
|
|
34
|
+
/** Every requested variation failed to build. */
|
|
35
|
+
prewarmFailed: "PREWARM_FAILED",
|
|
36
|
+
/** This run cannot rebuild — it was started without the watcher wiring. */
|
|
37
|
+
noRebuild: "NO_REBUILD",
|
|
38
|
+
/** No preload with that id is registered on this run. */
|
|
39
|
+
noSuchPreload: "NO_SUCH_PRELOAD",
|
|
40
|
+
/** `inject.add` got neither a recipe nor source, or both. */
|
|
41
|
+
injectSourceRequired: "INJECT_SOURCE_REQUIRED",
|
|
42
|
+
/** No recipe by that name — the answer names the ones that exist. */
|
|
43
|
+
unknownRecipe: "UNKNOWN_RECIPE",
|
|
44
|
+
/** A recipe was called without a required param, or with an unknown one. */
|
|
45
|
+
badRecipeParams: "BAD_RECIPE_PARAMS",
|
|
46
|
+
/** The registry is full. The answer names what to remove. */
|
|
47
|
+
tooManyPreloads: "TOO_MANY_PRELOADS",
|
|
48
|
+
/** A step or resume was asked for while the page was not paused. */
|
|
49
|
+
notPaused: "NOT_PAUSED",
|
|
50
|
+
/** A debug op that needs the hooks installed, on a run that has not armed. */
|
|
51
|
+
notArmed: "NOT_ARMED",
|
|
52
|
+
/** No such breakpoint number. */
|
|
53
|
+
noSuchBreakpoint: "NO_SUCH_BREAKPOINT",
|
|
54
|
+
/** The trigger matched no control on the page. */
|
|
55
|
+
noTrigger: "NO_TRIGGER",
|
|
56
|
+
/** A width range that cannot be swept. */
|
|
57
|
+
badRange: "BAD_RANGE",
|
|
58
|
+
};
|
|
@@ -0,0 +1,292 @@
|
|
|
1
|
+
import { CliServiceInterface } from "../../cli/index.js";
|
|
2
|
+
import type { OriginRequestConfig } from "../../origin-request/index.js";
|
|
3
|
+
import { FileListInterface } from "../../integration-api/index.js";
|
|
4
|
+
import { Cache } from "../request-cache/cache.js";
|
|
5
|
+
import { TodoCollector } from "../todo-collector.js";
|
|
6
|
+
import { BrowserController } from "./browser-session.js";
|
|
7
|
+
import { SpeedKitConfig } from "../../integration-api/struct/speed-kit-config.js";
|
|
8
|
+
import { RumBeacon, LocalCacheErrorEntry, RebuildStep, RebuildTarget, ValidationProblem } from "./control-protocol.js";
|
|
9
|
+
export interface ControlServerCollaborators {
|
|
10
|
+
cache: Cache;
|
|
11
|
+
cli: CliServiceInterface;
|
|
12
|
+
files: FileListInterface;
|
|
13
|
+
/** Absent until the run has opened a page; ops that need one say so. */
|
|
14
|
+
session?: BrowserController;
|
|
15
|
+
/** The open tasks in the customer's config files. */
|
|
16
|
+
todos?: TodoCollector;
|
|
17
|
+
/**
|
|
18
|
+
* The evaluated `config_SpeedKit`, re-read per call.
|
|
19
|
+
*
|
|
20
|
+
* A function rather than a value because the whole point of a run is that
|
|
21
|
+
* the config is being edited: a snapshot taken at startup would explain a
|
|
22
|
+
* url against a config the user has since changed, which is the most
|
|
23
|
+
* expensive kind of wrong answer this tool could give.
|
|
24
|
+
*/
|
|
25
|
+
speedKitConfig?: () => Promise<SpeedKitConfig>;
|
|
26
|
+
/** The origin a relative url is resolved against. */
|
|
27
|
+
origin?: string;
|
|
28
|
+
/**
|
|
29
|
+
* Builds and caches one variation of a url, returning the key it landed on.
|
|
30
|
+
*
|
|
31
|
+
* A capability rather than the `VirtualOrestesApp` itself, like
|
|
32
|
+
* {@link speedKitConfig}: the control server has no business driving the
|
|
33
|
+
* fetch handler, and a narrow function is the whole of what it needs. Absent
|
|
34
|
+
* on a run without `--local`, which has no local documentHandler to build
|
|
35
|
+
* with — and on a run older than this op.
|
|
36
|
+
*/
|
|
37
|
+
prewarm?: (originUrl: string, variation: string) => Promise<string>;
|
|
38
|
+
/** The variations the run's runtime config names, for a prewarm of all. */
|
|
39
|
+
variations?: () => string[];
|
|
40
|
+
/**
|
|
41
|
+
* The local documentHandler's build failures, as the run collects them.
|
|
42
|
+
*
|
|
43
|
+
* Already gathered and already shipped to the devtools panel; this is the
|
|
44
|
+
* same list for a caller that has no panel. A capability rather than the app,
|
|
45
|
+
* for the reason {@link prewarm} gives.
|
|
46
|
+
*/
|
|
47
|
+
cacheErrors?: () => LocalCacheErrorEntry[];
|
|
48
|
+
/** The last RUM beacons, as the run intercepted them. */
|
|
49
|
+
rumBeacons?: () => RumBeacon[];
|
|
50
|
+
/**
|
|
51
|
+
* Trigger one of the run's rebuild groups, as if a file in it had changed.
|
|
52
|
+
*
|
|
53
|
+
* Absent on a run whose watchers were never wired — a test harness, or a run
|
|
54
|
+
* that ended before its page was ready.
|
|
55
|
+
*/
|
|
56
|
+
rebuild?: (target: RebuildTarget) => Promise<RebuildStep[]>;
|
|
57
|
+
/** Re-runs the config and mandatory-file validators against what is loaded. */
|
|
58
|
+
validate?: () => ValidationProblem[];
|
|
59
|
+
/**
|
|
60
|
+
* The runtime config the run loaded, or undefined when it loaded none.
|
|
61
|
+
* Absent on a run that loads no runtime config at all, such as browse mode.
|
|
62
|
+
*/
|
|
63
|
+
runtimeConfig?: () => OriginRequestConfig | undefined;
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Serves the control protocol on a unix socket inside the run directory.
|
|
67
|
+
*
|
|
68
|
+
* A unix socket rather than a TCP port, and 0600 rather than anything wider:
|
|
69
|
+
* what is on the other side of this is a live browser session with the
|
|
70
|
+
* customer's credentials in it. A local port is an unauthenticated RPC into
|
|
71
|
+
* that for every process on the machine.
|
|
72
|
+
*/
|
|
73
|
+
export declare class ControlServer {
|
|
74
|
+
private readonly runDirectory;
|
|
75
|
+
private readonly runId;
|
|
76
|
+
private readonly collaborators;
|
|
77
|
+
private server?;
|
|
78
|
+
private generation;
|
|
79
|
+
private readonly connections;
|
|
80
|
+
/**
|
|
81
|
+
* One queue per run for the ops that change something.
|
|
82
|
+
*
|
|
83
|
+
* The per-connection queue below keeps one caller's requests in order, which
|
|
84
|
+
* is what stops a `browser.state` answering from before the `browser.reset`
|
|
85
|
+
* that preceded it. It says nothing about two callers, and two is not
|
|
86
|
+
* hypothetical: a run is asked from as many terminals and agents as are
|
|
87
|
+
* open. A `browser.reset` interleaved with a
|
|
88
|
+
* `cache.prewarm` leaves a half-built comparison that nothing reports as
|
|
89
|
+
* such.
|
|
90
|
+
*
|
|
91
|
+
* Reads stay concurrent, deliberately. They are the common case and the
|
|
92
|
+
* expensive ones wait on CDP; serialising them would make one slow read block
|
|
93
|
+
* every other caller for no correctness gain.
|
|
94
|
+
*/
|
|
95
|
+
private mutations;
|
|
96
|
+
constructor(runDirectory: string, runId: string, collaborators: ControlServerCollaborators);
|
|
97
|
+
get socketPath(): string;
|
|
98
|
+
/**
|
|
99
|
+
* Start listening, and stop when the run does.
|
|
100
|
+
*
|
|
101
|
+
* Tied to the signal the onboarding run already threads through, so the
|
|
102
|
+
* socket cannot outlive the thing it controls.
|
|
103
|
+
*/
|
|
104
|
+
listen(signal: AbortSignal): Promise<void>;
|
|
105
|
+
/** Bound once, so it can be removed again rather than leaking per run. */
|
|
106
|
+
private readonly unlinkOnExit;
|
|
107
|
+
close(): Promise<void>;
|
|
108
|
+
/** Bumped by any op that changes what a reader would observe. */
|
|
109
|
+
bumpGeneration(): number;
|
|
110
|
+
private accept;
|
|
111
|
+
/** @returns whether the connection has completed its handshake. */
|
|
112
|
+
private handleLine;
|
|
113
|
+
/**
|
|
114
|
+
* Run this after every mutation already queued, whatever became of them.
|
|
115
|
+
*
|
|
116
|
+
* `then(work, work)` rather than `then(work)`: a failed mutation must not
|
|
117
|
+
* strand every mutation behind it, and `dispatch` answers its own errors
|
|
118
|
+
* anyway. The chain is reduced to a settled promise before it is stored, so a
|
|
119
|
+
* rejection cannot surface later as an unhandled one.
|
|
120
|
+
*/
|
|
121
|
+
private serialize;
|
|
122
|
+
private replyToHello;
|
|
123
|
+
private dispatch;
|
|
124
|
+
private listCache;
|
|
125
|
+
/**
|
|
126
|
+
* One entry, by exact key or by an origin url that names exactly one.
|
|
127
|
+
*
|
|
128
|
+
* Matching by substring is what `Cache.removeEntry` does and it surprises
|
|
129
|
+
* people, so here an ambiguous key is an error listing what it matched rather
|
|
130
|
+
* than a silent pick of the first.
|
|
131
|
+
*/
|
|
132
|
+
private getCacheEntry;
|
|
133
|
+
/**
|
|
134
|
+
* A caller's url against the origin this run is driving.
|
|
135
|
+
*
|
|
136
|
+
* Normalised the way `@speedkit/rules`' own `destructURL` does, so a base
|
|
137
|
+
* without a scheme cannot take the whole op down. `new URL(input, base)`
|
|
138
|
+
* parses the base first and throws when it is not absolute — even when the
|
|
139
|
+
* input is — and the thrown error says nothing about which of the two was at
|
|
140
|
+
* fault. That cost a testing session: every url form came back BAD_URL
|
|
141
|
+
* blaming the url, while the base was a bare hostname.
|
|
142
|
+
*/
|
|
143
|
+
private resolveUrl;
|
|
144
|
+
/**
|
|
145
|
+
* Build cache entries for a url that nothing has requested.
|
|
146
|
+
*
|
|
147
|
+
* The gap this closes: the dh-cache only ever fills as a side effect of the
|
|
148
|
+
* browser asking for a page, and the browser is one device at a time. So the
|
|
149
|
+
* comparison people actually want — mobile against desktop, or a url with a
|
|
150
|
+
* parameter against the same url without — could not be set up at all, no
|
|
151
|
+
* matter how the run was driven.
|
|
152
|
+
*
|
|
153
|
+
* Each variation is built independently and reported independently. One
|
|
154
|
+
* variation failing is a fact about that variation, usually a transform that
|
|
155
|
+
* throws on it, and it must not cost the caller the ones that worked.
|
|
156
|
+
*/
|
|
157
|
+
private prewarmCache;
|
|
158
|
+
/** The keys in the cache right now, for telling a build from a hit. */
|
|
159
|
+
private cacheKeysNow;
|
|
160
|
+
private clearCache;
|
|
161
|
+
/**
|
|
162
|
+
* Drop entries by key, and report what that actually took.
|
|
163
|
+
*
|
|
164
|
+
* `Cache.removeEntry` matches by **substring**, which is the surprise this
|
|
165
|
+
* op has to surface rather than hide — a site's homepage url is a prefix of
|
|
166
|
+
* every url on the site, so evicting "the homepage" can empty the cache. The
|
|
167
|
+
* removal is measured by diffing the key set rather than predicted from the
|
|
168
|
+
* argument, so the answer is what happened even if that matching changes.
|
|
169
|
+
*/
|
|
170
|
+
private evictCache;
|
|
171
|
+
/**
|
|
172
|
+
* Rebuild cached entries from the origin, and say whether the bytes moved.
|
|
173
|
+
*
|
|
174
|
+
* Built on the same `prewarm` capability rather than on `refreshUrl`: the
|
|
175
|
+
* run's own refresh is fire-and-forget by design — it exists to keep a page
|
|
176
|
+
* warm in the background and logs its failures instead of returning them.
|
|
177
|
+
* The question here is the opposite kind, "did the origin actually change",
|
|
178
|
+
* and it needs the before and after hashes of every entry it touched.
|
|
179
|
+
*/
|
|
180
|
+
private refreshCache;
|
|
181
|
+
private listCacheErrors;
|
|
182
|
+
private rebuildFiles;
|
|
183
|
+
/** Never logged: the config carries the origin's basic-auth passwords. */
|
|
184
|
+
private readRuntimeConfig;
|
|
185
|
+
private validateFiles;
|
|
186
|
+
/**
|
|
187
|
+
* Why a url came back the way it did.
|
|
188
|
+
*
|
|
189
|
+
* Three sources, none of which answers alone: the rule sets say what Speed
|
|
190
|
+
* Kit is *allowed* to do with the url, the cache says whether the
|
|
191
|
+
* documentHandler has ever handled it, and the page says what actually
|
|
192
|
+
* happened — but only when the url is the page in front of the run.
|
|
193
|
+
*/
|
|
194
|
+
private explainResponse;
|
|
195
|
+
/**
|
|
196
|
+
* What `cache prewarm --all` builds: default, every variation the page has
|
|
197
|
+
* produced in this run, and every one the runtime config names.
|
|
198
|
+
*
|
|
199
|
+
* Not the three device defaults: whether a config ever produces `tablet` is
|
|
200
|
+
* decided in the browser, and building it for a site that never does is an
|
|
201
|
+
* SSR build nobody reads. What the cache has seen is evidence; the names are
|
|
202
|
+
* the config's own.
|
|
203
|
+
*/
|
|
204
|
+
private everyVariation;
|
|
205
|
+
/**
|
|
206
|
+
* The beacons since a cursor, and with `key` only those that carried it —
|
|
207
|
+
* with where in the payload and what it said.
|
|
208
|
+
*/
|
|
209
|
+
private readBeacons;
|
|
210
|
+
/** The sweep, on the page `url` names when it names one. */
|
|
211
|
+
private sweepViewport;
|
|
212
|
+
/** Every page the documentHandler has cached: pages known to be accelerated. */
|
|
213
|
+
private cachedPages;
|
|
214
|
+
/** The cached entry for this url, when the documentHandler has one. */
|
|
215
|
+
private cacheFactsFor;
|
|
216
|
+
/**
|
|
217
|
+
* What the page reported, but only when it *is* this url.
|
|
218
|
+
*
|
|
219
|
+
* Reporting the current page's RUM against a different url would be the
|
|
220
|
+
* confident wrong answer this whole tool exists to prevent.
|
|
221
|
+
*/
|
|
222
|
+
private pageFactsFor;
|
|
223
|
+
/**
|
|
224
|
+
* The open tasks, decoded.
|
|
225
|
+
*
|
|
226
|
+
* The collector encodes `context` for the devtools panel's transport;
|
|
227
|
+
* handing an agent percent-escapes of its own config would be a small lie
|
|
228
|
+
* about what is in the file.
|
|
229
|
+
*/
|
|
230
|
+
private listTodos;
|
|
231
|
+
/**
|
|
232
|
+
* The browser, or the typed reason there is none.
|
|
233
|
+
*
|
|
234
|
+
* Same guard as {@link readRum}: a run that has not opened its page yet is an
|
|
235
|
+
* ordinary state, not a failure, and it deserves a code a caller can branch
|
|
236
|
+
* on rather than whatever puppeteer throws from a closed target.
|
|
237
|
+
*/
|
|
238
|
+
/**
|
|
239
|
+
* The page a request acts on: the run's own, or the tab `tab` names.
|
|
240
|
+
*
|
|
241
|
+
* Resolved per request rather than switched for the run, so two callers on
|
|
242
|
+
* two tabs never see each other's choice.
|
|
243
|
+
*/
|
|
244
|
+
private browser;
|
|
245
|
+
/**
|
|
246
|
+
* The preload registry, without requiring a page.
|
|
247
|
+
*
|
|
248
|
+
* Unlike every other browser op: a registration outlives the document it was
|
|
249
|
+
* made against, so listing and removing one has to work between navigations
|
|
250
|
+
* and after a tab has closed. Adding one still needs a page, and says so from
|
|
251
|
+
* further in.
|
|
252
|
+
*/
|
|
253
|
+
private preloads;
|
|
254
|
+
/**
|
|
255
|
+
* Put an injection on the run's own output.
|
|
256
|
+
*
|
|
257
|
+
* The guardrail that matters most on this tool. Everything else an agent does
|
|
258
|
+
* through the socket is visible in what it changes; an injected script is
|
|
259
|
+
* visible in nothing, outlives the turn that added it, and silently colours
|
|
260
|
+
* every measurement taken afterwards. The human watching the terminal is the
|
|
261
|
+
* only one who can catch that, and they cannot catch what was never printed.
|
|
262
|
+
*/
|
|
263
|
+
private announceInjection;
|
|
264
|
+
private mutateBrowser;
|
|
265
|
+
private readRum;
|
|
266
|
+
/**
|
|
267
|
+
* Every file this run knows about, built ones included.
|
|
268
|
+
*
|
|
269
|
+
* The logical-name-to-path mapping is not guessable, and half the entries are
|
|
270
|
+
* optional per customer — so a reader that has to stat paths and guess is
|
|
271
|
+
* doing the thing this exists to stop.
|
|
272
|
+
*/
|
|
273
|
+
private listFiles;
|
|
274
|
+
private readFile;
|
|
275
|
+
private describeFile;
|
|
276
|
+
/**
|
|
277
|
+
* A screenshot, written next to the run's other artifacts so the run's
|
|
278
|
+
* retention prunes it. Named by time and device, not content: two captures of
|
|
279
|
+
* the same page are two moments, and the name says which device each shows.
|
|
280
|
+
*/
|
|
281
|
+
private takeScreenshot;
|
|
282
|
+
/** Content-addressed, so reading the same body twice does not write it twice. */
|
|
283
|
+
private writeArtifact;
|
|
284
|
+
private contentTypeOf;
|
|
285
|
+
private reply;
|
|
286
|
+
/**
|
|
287
|
+
* A socket file outlives the process that made it, so binding fails with
|
|
288
|
+
* EADDRINUSE against a run that is long gone. The run directory is per-pid,
|
|
289
|
+
* so anything here belongs to this run's own id and is safe to clear.
|
|
290
|
+
*/
|
|
291
|
+
private removeStaleSocket;
|
|
292
|
+
}
|