system-testing 1.0.78 → 1.0.81

package/README.md

@@ -8,6 +8,34 @@ Rails inspired system testing for Expo apps.
 npm install --save-dev system-testing
 ```
 
+## Choose the right layer
+
+This package has three main entry points:
+
+- `SystemTest`: full app-oriented system testing with selector helpers, app bootstrapping, WebSocket communication, screenshots, logs, and Scoundrel support.
+- `Browser`: lower-level driver session for opening URLs, taking screenshots, and reading HTML/logs without the rest of the system-test flow.
+- `system-testing` CLI browser daemon: a long-running named browser process that can be controlled from CLI commands or WebSocket messages.
+- `useSystemTest*` hooks: browser-side integration that lets your app respond to `visit` / `dismissTo` commands from `SystemTest`.
+
+Use `SystemTest` if you are testing your app. Use `Browser` if you just want a Selenium/Appium-backed browser session.
+
+## Getting started
+
+1. Add one of the browser-side hooks to your app:
+   `useSystemTestExpo` for Expo Router, or `useSystemTest` / `useSystemTestReactNative` for your own navigation stack.
+2. Wrap your app in a root element with `testID="systemTestingComponent"`.
+3. Make sure your root test route renders an element with `testID="blankText"`, or change `SystemTest.rootPath`.
+4. Start tests with `SystemTest.run(...)` for app flows, or instantiate `Browser` directly for ordinary browsing/capture.
+
+Minimal app-side requirements:
+
+```jsx
+<View testID="systemTestingComponent" dataSet={{focussed: "true"}}>
+  <Text testID="blankText">Blank</Text>
+  {children}
+</View>
+```
+
 ## Usage
 
 ```js
@@ -90,9 +118,160 @@ await SystemTest.run({
 
 If you already run an Appium server, provide `serverUrl` instead of `serverArgs`. By default, `findByTestID` uses the Appium `accessibility id` strategy. To use CSS instead (for web contexts), set `options.testIdStrategy` to `"css"` and optionally `options.testIdAttribute` (defaults to `"data-testid"`).
 
-### Using `useSystemTest` in your Expo app
+For local or CI web runs against Chrome, `npm run test:appium:web` now resolves and downloads a matching Chrome for Testing `chromedriver` binary before it starts Appium. That keeps the Appium web path reproducible even when the installed Chrome patch version changes.
+
+### Generic browser usage
+
+`Browser` is the lower-level browser/session class behind `SystemTest`. Use it when you want driver-backed browsing, screenshots, logs, and HTML capture without the rest of the system-test bootstrapping.
+
+```js
+import {Browser} from "system-testing/build/index.js"
+
+const browser = new Browser()
+
+browser.getDriverAdapter().setBaseUrl("https://example.com")
+await browser.getDriverAdapter().start()
+await browser.setTimeouts(10000)
+
+await browser.visit("/")
+
+const html = await browser.getHTML()
+const logs = await browser.getBrowserLogs()
+const screenshot = await browser.takeScreenshot()
+
+await browser.stopDriver()
+```
 
-`useSystemTest` wires your Expo app to the system-testing runner: it listens for WebSocket commands, initializes the browser helper, and lets tests navigate or reset state. Add it near the root layout of your Expo Router app (for example in `_layout.tsx` or a top-level provider component).
+If `visit()`/`dismissTo()` should drive in-app navigation through the browser-side helper instead of direct URL loads, inject a communicator when constructing `Browser`. Without one, it falls back to direct driver navigation, which makes it usable for ordinary website browsing as well.
+
+Common `Browser` flow:
+
+1. Create the browser with the desired driver config.
+2. Set the base URL on the driver adapter.
+3. Start the driver and set timeouts.
+4. Call `visit()`.
+5. Read `getHTML()`, `getBrowserLogs()`, `getCurrentUrl()`, or `takeScreenshot()`.
+6. Call `stopDriver()` during teardown.
+
+Useful browser methods:
+
+- `visit(pathOrUrl)`: uses the helper communicator if present, otherwise loads directly through Selenium/Appium.
+- `dismissTo(pathOrUrl)`: same fallback behavior as `visit()`.
+- `getHTML()`: returns the current page source.
+- `getBrowserLogs()`: returns collected browser logs, or Appium logcat output for Android native runs.
+- `takeScreenshot()`: writes screenshot, HTML, and logs to disk and returns the artifact paths.
+
+If you want app-level navigation instead of direct URL loads, keep `Browser` for the driver/session side and use one of the `useSystemTest*` hooks in the app so the communicator has something to talk to.
+
+`react` and `expo-router` are optional peer dependencies. Install them only in apps that import the React/Expo hook helpers; CLI/browser-daemon consumers should not need React just to use `system-testing`.
+
+### Browser daemon CLI
+
+If you want an external agent to drive a reusable browser process, start the browser daemon:
+
+```bash
+npx system-testing browser my-browser
+```
+
+Optional arguments:
+
+- `--port 1991`: use a fixed WebSocket port instead of an ephemeral one
+- `--base-url https://example.com`: set the browser base URL so relative `visit` paths work
+- `--driver selenium|appium`: choose the driver type
+- `--debug`: enable browser debug logging
+
+The process stays running until you stop it. On start it prints JSON with at least the browser `name`, `pid`, and `port`.
+
+List running browser daemons:
+
+```bash
+npx system-testing browser-list
+```
+
+This prints one line per browser with the name and port. Use `--json` if you want machine-readable output.
+
+Stop a running browser daemon:
+
+```bash
+npx system-testing browser-stop --name my-browser
+```
+
+If only one browser daemon is running, `browser-stop` can omit `--name`.
+
+Send commands from the CLI:
+
+```bash
+npx system-testing browser-command --name my-browser --visit=https://example.com/path
+npx system-testing browser-command --name my-browser --find-by-test-id saveButton
+npx system-testing browser-command --name my-browser --find-by-test-id saveButton --timeout 15
+npx system-testing browser-command --name my-browser --click='[data-testid="saveButton"]'
+npx system-testing browser-command --name my-browser --get-html
+npx system-testing browser-command --name my-browser --get-browser-logs
+npx system-testing browser-command --name my-browser --take-screenshot
+```
+
+If only one browser daemon is running, `browser-command` can omit `--name`. Results are printed as JSON so automation tools can parse them easily.
+
+CLI `--timeout` values are supported on navigation and selector-based commands. Bare numbers are interpreted as seconds, and explicit `ms` / `s` suffixes are also accepted.
+
+Generic commands are also supported:
+
+```bash
+npx system-testing browser-command \
+  --name my-browser \
+  --command=interact \
+  --selector='[data-testid="emailInput"]' \
+  --method=sendKeys \
+  --arg='user@example.com'
+```
+
+The browser daemon is intended for agent-style development workflows where an AI or script needs to open the app, inspect HTML, locate elements, click controls, and read logs while validating layout or behavior changes.
+
+### Browser daemon WebSocket protocol
+
+The daemon also accepts WebSocket commands on its configured port. Send JSON payloads like:
+
+```json
+{"type":"browser-command","command":"visit","url":"https://example.com/path"}
+```
+
+Another example:
+
+```json
+{"type":"browser-command","command":"findByTestID","args":{"testID":"saveButton"}}
+```
+
+The server responds with JSON:
+
+```json
+{"ok":true,"requestId":"...","type":"browser-command-result","result":{"ok":true}}
+```
+
+If the command fails:
+
+```json
+{"ok":false,"requestId":"...","type":"browser-command-result","error":"..."}
+```
+
+Supported daemon commands currently include:
+
+- `visit`
+- `dismissTo`
+- `setBaseSelector`
+- `getCurrentUrl`
+- `getHTML`
+- `getBrowserLogs`
+- `takeScreenshot`
+- `find`
+- `findByTestID`
+- `click`
+- `waitForNoSelector`
+- `expectNoElement`
+- `interact`
+
+### Using `useSystemTestExpo` in your Expo app
+
+`useSystemTestExpo` wires your Expo app to the system-testing runner: it listens for WebSocket commands, initializes the browser helper, and lets tests navigate or reset state. Add it near the root layout of your Expo Router app (for example in `_layout.tsx` or a top-level provider component).
 
 To enable system tests in native builds, set `EXPO_PUBLIC_SYSTEM_TEST=true` at build time (and optionally `EXPO_PUBLIC_SYSTEM_TEST_HOST` to reach the test runner from a device/emulator). For native Appium runs, set `SYSTEM_TEST_HOST=native` in the test environment and point Appium at your APK.
 
@@ -100,10 +279,12 @@ Minimal example:
 
 ```jsx
 import {Stack} from "expo-router"
-import useSystemTest from "system-testing/build/use-system-test.js"
+import useSystemTestExpo from "system-testing/build/use-system-test-expo.js"
 
 export default function RootLayout() {
-  const {enabled, systemTestBrowserHelper} = useSystemTest({
+  const {enabled, systemTestBrowserHelper} = useSystemTestExpo({
+    // Optional: inject your own helper instance instead of using the shared default
+    // browserHelper: mySystemTestBrowserHelper,
     onFirstInitialize: () => {
       // One-time setup the first time the helper initializes
     },
@@ -129,12 +310,51 @@ export default function RootLayout() {
 
 Notes:
 - The hook auto-connects when the page is opened with `?systemTest=true` (as the runner does).
+- Pass `browserHelper` if you want to inject a prebuilt `SystemTestBrowserHelper`; otherwise the hook creates and enables a shared default instance.
 - `onFirstInitialize` runs only on the first `initialize` command; use it for one-time setup.
 - `onInitialize` is registered once when the helper is ready, but it runs on every `initialize` command (each `SystemTest.run`); use it to reset globals/session.
 - If you need scoundrel remote evaluation, wait for `systemTestBrowserHelper` and register your classes there, as shown in the commented snippet above.
 - Add a root wrapper with `testID="systemTestingComponent"` (and optionally `data-focussed="true"`) around your app so the runner has a stable element to detect and scope selectors against.
 - From your tests, use `await systemTest.getScoundrelClient()` to obtain the browser Scoundrel client for remote evaluation.
-- `useSystemTest` calls `useRouter()` from `expo-router`. If you are not using Expo Router, install `expo-router` or provide your own guard to avoid navigation errors.
+- `useSystemTestExpo` calls `useRouter()` from `expo-router`.
+
+### Using `useSystemTest` or `useSystemTestReactNative` without Expo Router
+
+`useSystemTest` is the generic runtime-agnostic hook. Provide `onNavigate` and `onDismissTo` callbacks for your own navigation stack. `useSystemTestReactNative` is a convenience wrapper around the same generic API for non-Expo React Native apps.
+
+Use these when:
+
+- you are not using Expo Router
+- you want to inject your own navigation behavior
+- you want to share the same app-side helper integration across different routing setups
+
+```js
+import useSystemTestReactNative from "system-testing/build/use-system-test-react-native.js"
+
+export default function App({navigation}) {
+  useSystemTestReactNative({
+    onDismissTo: ({path}) => {
+      navigation.reset({
+        index: 0,
+        routes: [{name: path}]
+      })
+    },
+    onNavigate: ({path}) => {
+      navigation.navigate(path)
+    }
+  })
+
+  return <Navigator />
+}
+```
+
+The generic hook options are:
+
+- `browserHelper`: inject an existing `SystemTestBrowserHelper` instance instead of using the shared default
+- `onFirstInitialize`: one-time setup callback
+- `onInitialize`: callback that runs on every `initialize` command
+- `onNavigate`: handler for `visit(...)`
+- `onDismissTo`: handler for `dismissTo(...)`
 
 ### Root path and `blankText`
 
@@ -208,4 +428,10 @@ This tears down the browser, servers, and sockets, then starts them again so sub
 
 ## Dummy Expo app
 
-A ready-to-run Expo Router dummy app that uses `system-testing` lives in `spec/dummy`. Build the web bundle with `npm run export:web` and execute the sample system test with `npm run test:system` from that folder.
+A ready-to-run Expo Router dummy app that uses `system-testing` lives in `spec/dummy`.
+
+Useful commands from the package root:
+
+- `npm run export:web`: build the dummy Expo app for web
+- `SYSTEM_TEST_HOST=dist npx jasmine spec/system-test.spec.js`: run the sample system specs against the exported bundle
+- `SYSTEM_TEST_HOST=dist npx jasmine spec/system-test-logging.spec.js`: run the browser-log capture spec

package/build/browser-command-client.d.ts

@@ -0,0 +1,19 @@
+/** Sends browser commands to a running browser daemon. */
+export default class BrowserCommandClient {
+    /**
+     * @param {object} args
+     * @param {string} [args.name]
+     * @param {number} [args.port]
+     */
+    constructor({ name, port }?: {
+        name?: string;
+        port?: number;
+    });
+    name: string;
+    port: number;
+    /**
+     * @param {Record<string, any>} payload
+     * @returns {Promise<any>}
+     */
+    send(payload: Record<string, any>): Promise<any>;
+}

package/build/browser-command-client.js

@@ -0,0 +1,39 @@
+import BrowserRegistry from "./browser-registry.js";
+import WebSocket from "ws";
+/** Sends browser commands to a running browser daemon. */
+export default class BrowserCommandClient {
+    /**
+     * @param {object} args
+     * @param {string} [args.name]
+     * @param {number} [args.port]
+     */
+    constructor({ name, port } = {}) {
+        this.name = name;
+        this.port = port;
+    }
+    /**
+     * @param {Record<string, any>} payload
+     * @returns {Promise<any>}
+     */
+    async send(payload) {
+        const resolvedPort = this.port ?? (await BrowserRegistry.resolve(this.name)).port;
+        const ws = new WebSocket(`ws://127.0.0.1:${resolvedPort}`);
+        return await new Promise((resolve, reject) => {
+            ws.on("open", () => {
+                ws.send(JSON.stringify(payload));
+            });
+            ws.on("message", (rawData) => {
+                const response = JSON.parse(rawData.toString());
+                ws.close();
+                if (response.ok) {
+                    resolve(response.result);
+                }
+                else {
+                    reject(new Error(response.error));
+                }
+            });
+            ws.on("error", reject);
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJvd3Nlci1jb21tYW5kLWNsaWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9icm93c2VyLWNvbW1hbmQtY2xpZW50LmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sZUFBZSxNQUFNLHVCQUF1QixDQUFBO0FBQ25ELE9BQU8sU0FBUyxNQUFNLElBQUksQ0FBQTtBQUUxQiwwREFBMEQ7QUFDMUQsTUFBTSxDQUFDLE9BQU8sT0FBTyxvQkFBb0I7SUFDdkM7Ozs7T0FJRztJQUNILFlBQVksRUFBQyxJQUFJLEVBQUUsSUFBSSxFQUFDLEdBQUcsRUFBRTtRQUMzQixJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQTtRQUNoQixJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQTtJQUNsQixDQUFDO0lBRUQ7OztPQUdHO0lBQ0gsS0FBSyxDQUFDLElBQUksQ0FBQyxPQUFPO1FBQ2hCLE1BQU0sWUFBWSxHQUFHLElBQUksQ0FBQyxJQUFJLElBQUksQ0FBQyxNQUFNLGVBQWUsQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFBO1FBQ2pGLE1BQU0sRUFBRSxHQUFHLElBQUksU0FBUyxDQUFDLGtCQUFrQixZQUFZLEVBQUUsQ0FBQyxDQUFBO1FBRTFELE9BQU8sTUFBTSxJQUFJLE9BQU8sQ0FBQyxDQUFDLE9BQU8sRUFBRSxNQUFNLEVBQUUsRUFBRTtZQUMzQyxFQUFFLENBQUMsRUFBRSxDQUFDLE1BQU0sRUFBRSxHQUFHLEVBQUU7Z0JBQ2pCLEVBQUUsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFBO1lBQ2xDLENBQUMsQ0FBQyxDQUFBO1lBRUYsRUFBRSxDQUFDLEVBQUUsQ0FBQyxTQUFTLEVBQUUsQ0FBQyxPQUFPLEVBQUUsRUFBRTtnQkFDM0IsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FBQTtnQkFFL0MsRUFBRSxDQUFDLEtBQUssRUFBRSxDQUFBO2dCQUVWLElBQUksUUFBUSxDQUFDLEVBQUUsRUFBRSxDQUFDO29CQUNoQixPQUFPLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxDQUFBO2dCQUMxQixDQUFDO3FCQUFNLENBQUM7b0JBQ04sTUFBTSxDQUFDLElBQUksS0FBSyxDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFBO2dCQUNuQyxDQUFDO1lBQ0gsQ0FBQyxDQUFDLENBQUE7WUFFRixFQUFFLENBQUMsRUFBRSxDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsQ0FBQTtRQUN4QixDQUFDLENBQUMsQ0FBQTtJQUNKLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCBCcm93c2VyUmVnaXN0cnkgZnJvbSBcIi4vYnJvd3Nlci1yZWdpc3RyeS5qc1wiXG5pbXBvcnQgV2ViU29ja2V0IGZyb20gXCJ3c1wiXG5cbi8qKiBTZW5kcyBicm93c2VyIGNvbW1hbmRzIHRvIGEgcnVubmluZyBicm93c2VyIGRhZW1vbi4gKi9cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIEJyb3dzZXJDb21tYW5kQ2xpZW50IHtcbiAgLyoqXG4gICAqIEBwYXJhbSB7b2JqZWN0fSBhcmdzXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBbYXJncy5uYW1lXVxuICAgKiBAcGFyYW0ge251bWJlcn0gW2FyZ3MucG9ydF1cbiAgICovXG4gIGNvbnN0cnVjdG9yKHtuYW1lLCBwb3J0fSA9IHt9KSB7XG4gICAgdGhpcy5uYW1lID0gbmFtZVxuICAgIHRoaXMucG9ydCA9IHBvcnRcbiAgfVxuXG4gIC8qKlxuICAgKiBAcGFyYW0ge1JlY29yZDxzdHJpbmcsIGFueT59IHBheWxvYWRcbiAgICogQHJldHVybnMge1Byb21pc2U8YW55Pn1cbiAgICovXG4gIGFzeW5jIHNlbmQocGF5bG9hZCkge1xuICAgIGNvbnN0IHJlc29sdmVkUG9ydCA9IHRoaXMucG9ydCA/PyAoYXdhaXQgQnJvd3NlclJlZ2lzdHJ5LnJlc29sdmUodGhpcy5uYW1lKSkucG9ydFxuICAgIGNvbnN0IHdzID0gbmV3IFdlYlNvY2tldChgd3M6Ly8xMjcuMC4wLjE6JHtyZXNvbHZlZFBvcnR9YClcblxuICAgIHJldHVybiBhd2FpdCBuZXcgUHJvbWlzZSgocmVzb2x2ZSwgcmVqZWN0KSA9PiB7XG4gICAgICB3cy5vbihcIm9wZW5cIiwgKCkgPT4ge1xuICAgICAgICB3cy5zZW5kKEpTT04uc3RyaW5naWZ5KHBheWxvYWQpKVxuICAgICAgfSlcblxuICAgICAgd3Mub24oXCJtZXNzYWdlXCIsIChyYXdEYXRhKSA9PiB7XG4gICAgICAgIGNvbnN0IHJlc3BvbnNlID0gSlNPTi5wYXJzZShyYXdEYXRhLnRvU3RyaW5nKCkpXG5cbiAgICAgICAgd3MuY2xvc2UoKVxuXG4gICAgICAgIGlmIChyZXNwb25zZS5vaykge1xuICAgICAgICAgIHJlc29sdmUocmVzcG9uc2UucmVzdWx0KVxuICAgICAgICB9IGVsc2Uge1xuICAgICAgICAgIHJlamVjdChuZXcgRXJyb3IocmVzcG9uc2UuZXJyb3IpKVxuICAgICAgICB9XG4gICAgICB9KVxuXG4gICAgICB3cy5vbihcImVycm9yXCIsIHJlamVjdClcbiAgICB9KVxuICB9XG59XG4iXX0=

package/build/browser-command-runner.d.ts

@@ -0,0 +1,34 @@
+/** Runs browser commands across CLI and WebSocket transports. */
+export default class BrowserCommandRunner {
+    /**
+     * @param {object} args
+     * @param {import("./browser.js").default} args.browser
+     */
+    constructor({ browser }: {
+        browser: import("./browser.js").default;
+    });
+    browser: import("./browser.js").default;
+    /**
+     * @param {Record<string, any>} commandArgs
+     * @returns {{timeout?: number}}
+     */
+    normalizeTimeoutArgs(commandArgs: Record<string, any>): {
+        timeout?: number;
+    };
+    /**
+     * @param {Record<string, any>} commandArgs
+     * @returns {import("./system-test.js").FindArgs}
+     */
+    normalizeFindArgs(commandArgs: Record<string, any>): import("./system-test.js").FindArgs;
+    /**
+     * @param {import("selenium-webdriver").WebElement} element
+     * @returns {Promise<Record<string, any>>}
+     */
+    serializeElement(element: import("selenium-webdriver").WebElement): Promise<Record<string, any>>;
+    /**
+     * @param {string} command
+     * @param {Record<string, any>} commandArgs
+     * @returns {Promise<any>}
+     */
+    run(command: string, commandArgs?: Record<string, any>): Promise<any>;
+}

package/build/browser-command-runner.js

@@ -0,0 +1,155 @@
+/** Runs browser commands across CLI and WebSocket transports. */
+export default class BrowserCommandRunner {
+    /**
+     * @param {object} args
+     * @param {import("./browser.js").default} args.browser
+     */
+    constructor({ browser }) {
+        this.browser = browser;
+    }
+    /**
+     * @param {Record<string, any>} commandArgs
+     * @returns {{timeout?: number}}
+     */
+    normalizeTimeoutArgs(commandArgs) {
+        const normalizedArgs = {};
+        if ("timeout" in commandArgs && commandArgs.timeout !== undefined) {
+            normalizedArgs.timeout = Number(commandArgs.timeout);
+            if (Number.isNaN(normalizedArgs.timeout)) {
+                throw new Error(`Invalid timeout: ${commandArgs.timeout}`);
+            }
+        }
+        return normalizedArgs;
+    }
+    /**
+     * @param {Record<string, any>} commandArgs
+     * @returns {import("./system-test.js").FindArgs}
+     */
+    normalizeFindArgs(commandArgs) {
+        const findArgs = /** @type {import("./system-test.js").FindArgs} */ (this.normalizeTimeoutArgs(commandArgs));
+        if ("visible" in commandArgs && commandArgs.visible !== undefined) {
+            if (commandArgs.visible === null || commandArgs.visible === "null") {
+                findArgs.visible = null;
+            }
+            else if (typeof commandArgs.visible === "boolean") {
+                findArgs.visible = commandArgs.visible;
+            }
+            else {
+                findArgs.visible = commandArgs.visible === "true";
+            }
+        }
+        if ("useBaseSelector" in commandArgs && commandArgs.useBaseSelector !== undefined) {
+            if (typeof commandArgs.useBaseSelector === "boolean") {
+                findArgs.useBaseSelector = commandArgs.useBaseSelector;
+            }
+            else {
+                findArgs.useBaseSelector = commandArgs.useBaseSelector === "true";
+            }
+        }
+        return findArgs;
+    }
+    /**
+     * @param {import("selenium-webdriver").WebElement} element
+     * @returns {Promise<Record<string, any>>}
+     */
+    async serializeElement(element) {
+        const text = await element.getText();
+        const tagName = await element.getTagName();
+        const displayed = await element.isDisplayed();
+        return { displayed, tagName, text };
+    }
+    /**
+     * @param {string} command
+     * @param {Record<string, any>} commandArgs
+     * @returns {Promise<any>}
+     */
+    async run(command, commandArgs = {}) {
+        if (command === "visit") {
+            const path = commandArgs.path ?? commandArgs.url;
+            if (!path) {
+                throw new Error("visit requires path or url");
+            }
+            await this.browser.visit(path, this.normalizeTimeoutArgs(commandArgs));
+            return { ok: true };
+        }
+        if (command === "dismissTo") {
+            const path = commandArgs.path ?? commandArgs.url;
+            if (!path) {
+                throw new Error("dismissTo requires path or url");
+            }
+            await this.browser.dismissTo(path, this.normalizeTimeoutArgs(commandArgs));
+            return { ok: true };
+        }
+        if (command === "setBaseSelector") {
+            if (!commandArgs.selector) {
+                throw new Error("setBaseSelector requires selector");
+            }
+            this.browser.setBaseSelector(commandArgs.selector);
+            return { ok: true };
+        }
+        if (command === "getCurrentUrl") {
+            return { currentUrl: await this.browser.getCurrentUrl() };
+        }
+        if (command === "getHTML") {
+            return { html: await this.browser.getHTML() };
+        }
+        if (command === "getBrowserLogs") {
+            return { logs: await this.browser.getBrowserLogs() };
+        }
+        if (command === "takeScreenshot") {
+            return await this.browser.takeScreenshot();
+        }
+        if (command === "find") {
+            if (!commandArgs.selector) {
+                throw new Error("find requires selector");
+            }
+            const element = await this.browser.find(commandArgs.selector, this.normalizeFindArgs(commandArgs));
+            return { element: await this.serializeElement(element) };
+        }
+        if (command === "findByTestID") {
+            const testID = commandArgs.testID ?? commandArgs.testId;
+            if (!testID) {
+                throw new Error("findByTestID requires testID");
+            }
+            const element = await this.browser.findByTestID(testID, this.normalizeFindArgs(commandArgs));
+            return { element: await this.serializeElement(element) };
+        }
+        if (command === "click") {
+            const selector = commandArgs.selector;
+            if (!selector) {
+                throw new Error("click requires selector");
+            }
+            await this.browser.click(selector, this.normalizeFindArgs(commandArgs));
+            return { ok: true };
+        }
+        if (command === "waitForNoSelector") {
+            if (!commandArgs.selector) {
+                throw new Error("waitForNoSelector requires selector");
+            }
+            await this.browser.waitForNoSelector(commandArgs.selector, this.normalizeFindArgs(commandArgs));
+            return { ok: true };
+        }
+        if (command === "expectNoElement") {
+            if (!commandArgs.selector) {
+                throw new Error("expectNoElement requires selector");
+            }
+            await this.browser.expectNoElement(commandArgs.selector, this.normalizeFindArgs(commandArgs));
+            return { ok: true };
+        }
+        if (command === "interact") {
+            const selector = commandArgs.selector;
+            const methodName = commandArgs.methodName ?? commandArgs.method;
+            const methodArgs = Array.isArray(commandArgs.args) ? commandArgs.args : [];
+            if (!selector) {
+                throw new Error("interact requires selector");
+            }
+            if (!methodName) {
+                throw new Error("interact requires methodName");
+            }
+            const result = await this.browser.interact({ selector, ...this.normalizeFindArgs(commandArgs) }, methodName, ...methodArgs);
+            return { result };
+        }
+        throw new Error(`Unknown browser command: ${command}`);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJvd3Nlci1jb21tYW5kLXJ1bm5lci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9icm93c2VyLWNvbW1hbmQtcnVubmVyLmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGlFQUFpRTtBQUNqRSxNQUFNLENBQUMsT0FBTyxPQUFPLG9CQUFvQjtJQUN2Qzs7O09BR0c7SUFDSCxZQUFZLEVBQUMsT0FBTyxFQUFDO1FBQ25CLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFBO0lBQ3hCLENBQUM7SUFFRDs7O09BR0c7SUFDSCxvQkFBb0IsQ0FBQyxXQUFXO1FBQzlCLE1BQU0sY0FBYyxHQUFHLEVBQUUsQ0FBQTtRQUV6QixJQUFJLFNBQVMsSUFBSSxXQUFXLElBQUksV0FBVyxDQUFDLE9BQU8sS0FBSyxTQUFTLEVBQUUsQ0FBQztZQUNsRSxjQUFjLENBQUMsT0FBTyxHQUFHLE1BQU0sQ0FBQyxXQUFXLENBQUMsT0FBTyxDQUFDLENBQUE7WUFFcEQsSUFBSSxNQUFNLENBQUMsS0FBSyxDQUFDLGNBQWMsQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDO2dCQUN6QyxNQUFNLElBQUksS0FBSyxDQUFDLG9CQUFvQixXQUFXLENBQUMsT0FBTyxFQUFFLENBQUMsQ0FBQTtZQUM1RCxDQUFDO1FBQ0gsQ0FBQztRQUVELE9BQU8sY0FBYyxDQUFBO0lBQ3ZCLENBQUM7SUFFRDs7O09BR0c7SUFDSCxpQkFBaUIsQ0FBQyxXQUFXO1FBQzNCLE1BQU0sUUFBUSxHQUFHLGtEQUFrRCxDQUFDLENBQUMsSUFBSSxDQUFDLG9CQUFvQixDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUE7UUFFNUcsSUFBSSxTQUFTLElBQUksV0FBVyxJQUFJLFdBQVcsQ0FBQyxPQUFPLEtBQUssU0FBUyxFQUFFLENBQUM7WUFDbEUsSUFBSSxXQUFXLENBQUMsT0FBTyxLQUFLLElBQUksSUFBSSxXQUFXLENBQUMsT0FBTyxLQUFLLE1BQU0sRUFBRSxDQUFDO2dCQUNuRSxRQUFRLENBQUMsT0FBTyxHQUFHLElBQUksQ0FBQTtZQUN6QixDQUFDO2lCQUFNLElBQUksT0FBTyxXQUFXLENBQUMsT0FBTyxLQUFLLFNBQVMsRUFBRSxDQUFDO2dCQUNwRCxRQUFRLENBQUMsT0FBTyxHQUFHLFdBQVcsQ0FBQyxPQUFPLENBQUE7WUFDeEMsQ0FBQztpQkFBTSxDQUFDO2dCQUNOLFFBQVEsQ0FBQyxPQUFPLEdBQUcsV0FBVyxDQUFDLE9BQU8sS0FBSyxNQUFNLENBQUE7WUFDbkQsQ0FBQztRQUNILENBQUM7UUFFRCxJQUFJLGlCQUFpQixJQUFJLFdBQVcsSUFBSSxXQUFXLENBQUMsZUFBZSxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQ2xGLElBQUksT0FBTyxXQUFXLENBQUMsZUFBZSxLQUFLLFNBQVMsRUFBRSxDQUFDO2dCQUNyRCxRQUFRLENBQUMsZUFBZSxHQUFHLFdBQVcsQ0FBQyxlQUFlLENBQUE7WUFDeEQsQ0FBQztpQkFBTSxDQUFDO2dCQUNOLFFBQVEsQ0FBQyxlQUFlLEdBQUcsV0FBVyxDQUFDLGVBQWUsS0FBSyxNQUFNLENBQUE7WUFDbkUsQ0FBQztRQUNILENBQUM7UUFFRCxPQUFPLFFBQVEsQ0FBQTtJQUNqQixDQUFDO0lBRUQ7OztPQUdHO0lBQ0gsS0FBSyxDQUFDLGdCQUFnQixDQUFDLE9BQU87UUFDNUIsTUFBTSxJQUFJLEdBQUcsTUFBTSxPQUFPLENBQUMsT0FBTyxFQUFFLENBQUE7UUFDcEMsTUFBTSxPQUFPLEdBQUcsTUFBTSxPQUFPLENBQUMsVUFBVSxFQUFFLENBQUE7UUFDMUMsTUFBTSxTQUFTLEdBQUcsTUFBTSxPQUFPLENBQUMsV0FBVyxFQUFFLENBQUE7UUFFN0MsT0FBTyxFQUFDLFNBQVMsRUFBRSxPQUFPLEVBQUUsSUFBSSxFQUFDLENBQUE7SUFDbkMsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxLQUFLLENBQUMsR0FBRyxDQUFDLE9BQU8sRUFBRSxXQUFXLEdBQUcsRUFBRTtRQUNqQyxJQUFJLE9BQU8sS0FBSyxPQUFPLEVBQUUsQ0FBQztZQUN4QixNQUFNLElBQUksR0FBRyxXQUFXLENBQUMsSUFBSSxJQUFJLFdBQVcsQ0FBQyxHQUFHLENBQUE7WUFFaEQsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDO2dCQUNWLE1BQU0sSUFBSSxLQUFLLENBQUMsNEJBQTRCLENBQUMsQ0FBQTtZQUMvQyxDQUFDO1lBRUQsTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLG9CQUFvQixDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUE7WUFDdEUsT0FBTyxFQUFDLEVBQUUsRUFBRSxJQUFJLEVBQUMsQ0FBQTtRQUNuQixDQUFDO1FBRUQsSUFBSSxPQUFPLEtBQUssV0FBVyxFQUFFLENBQUM7WUFDNUIsTUFBTSxJQUFJLEdBQUcsV0FBVyxDQUFDLElBQUksSUFBSSxXQUFXLENBQUMsR0FBRyxDQUFBO1lBRWhELElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztnQkFDVixNQUFNLElBQUksS0FBSyxDQUFDLGdDQUFnQyxDQUFDLENBQUE7WUFDbkQsQ0FBQztZQUVELE1BQU0sSUFBSSxDQUFDLE9BQU8sQ0FBQyxTQUFTLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxvQkFBb0IsQ0FBQyxXQUFXLENBQUMsQ0FBQyxDQUFBO1lBQzFFLE9BQU8sRUFBQyxFQUFFLEVBQUUsSUFBSSxFQUFDLENBQUE7UUFDbkIsQ0FBQztRQUVELElBQUksT0FBTyxLQUFLLGlCQUFpQixFQUFFLENBQUM7WUFDbEMsSUFBSSxDQUFDLFdBQVcsQ0FBQyxRQUFRLEVBQUUsQ0FBQztnQkFDMUIsTUFBTSxJQUFJLEtBQUssQ0FBQyxtQ0FBbUMsQ0FBQyxDQUFBO1lBQ3RELENBQUM7WUFFRCxJQUFJLENBQUMsT0FBTyxDQUFDLGVBQWUsQ0FBQyxXQUFXLENBQUMsUUFBUSxDQUFDLENBQUE7WUFDbEQsT0FBTyxFQUFDLEVBQUUsRUFBRSxJQUFJLEVBQUMsQ0FBQTtRQUNuQixDQUFDO1FBRUQsSUFBSSxPQUFPLEtBQUssZUFBZSxFQUFFLENBQUM7WUFDaEMsT0FBTyxFQUFDLFVBQVUsRUFBRSxNQUFNLElBQUksQ0FBQyxPQUFPLENBQUMsYUFBYSxFQUFFLEVBQUMsQ0FBQTtRQUN6RCxDQUFDO1FBRUQsSUFBSSxPQUFPLEtBQUssU0FBUyxFQUFFLENBQUM7WUFDMUIsT0FBTyxFQUFDLElBQUksRUFBRSxNQUFNLElBQUksQ0FBQyxPQUFPLENBQUMsT0FBTyxFQUFFLEVBQUMsQ0FBQTtRQUM3QyxDQUFDO1FBRUQsSUFBSSxPQUFPLEtBQUssZ0JBQWdCLEVBQUUsQ0FBQztZQUNqQyxPQUFPLEVBQUMsSUFBSSxFQUFFLE1BQU0sSUFBSSxDQUFDLE9BQU8sQ0FBQyxjQUFjLEVBQUUsRUFBQyxDQUFBO1FBQ3BELENBQUM7UUFFRCxJQUFJLE9BQU8sS0FBSyxnQkFBZ0IsRUFBRSxDQUFDO1lBQ2pDLE9BQU8sTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLGNBQWMsRUFBRSxDQUFBO1FBQzVDLENBQUM7UUFFRCxJQUFJLE9BQU8sS0FBSyxNQUFNLEVBQUUsQ0FBQztZQUN2QixJQUFJLENBQUMsV0FBVyxDQUFDLFFBQVEsRUFBRSxDQUFDO2dCQUMxQixNQUFNLElBQUksS0FBSyxDQUFDLHdCQUF3QixDQUFDLENBQUE7WUFDM0MsQ0FBQztZQUVELE1BQU0sT0FBTyxHQUFHLE1BQU0sSUFBSSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsV0FBVyxDQUFDLFFBQVEsRUFBRSxJQUFJLENBQUMsaUJBQWlCLENBQUMsV0FBVyxDQUFDLENBQUMsQ0FBQTtZQUVsRyxPQUFPLEVBQUMsT0FBTyxFQUFFLE1BQU0sSUFBSSxDQUFDLGdCQUFnQixDQUFDLE9BQU8sQ0FBQyxFQUFDLENBQUE7UUFDeEQsQ0FBQztRQUVELElBQUksT0FBTyxLQUFLLGNBQWMsRUFBRSxDQUFDO1lBQy9CLE1BQU0sTUFBTSxHQUFHLFdBQVcsQ0FBQyxNQUFNLElBQUksV0FBVyxDQUFDLE1BQU0sQ0FBQTtZQUV2RCxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUM7Z0JBQ1osTUFBTSxJQUFJLEtBQUssQ0FBQyw4QkFBOEIsQ0FBQyxDQUFBO1lBQ2pELENBQUM7WUFFRCxNQUFNLE9BQU8sR0FBRyxNQUFNLElBQUksQ0FBQyxPQUFPLENBQUMsWUFBWSxDQUFDLE1BQU0sRUFBRSxJQUFJLENBQUMsaUJBQWlCLENBQUMsV0FBVyxDQUFDLENBQUMsQ0FBQTtZQUU1RixPQUFPLEVBQUMsT0FBTyxFQUFFLE1BQU0sSUFBSSxDQUFDLGdCQUFnQixDQUFDLE9BQU8sQ0FBQyxFQUFDLENBQUE7UUFDeEQsQ0FBQztRQUVELElBQUksT0FBTyxLQUFLLE9BQU8sRUFBRSxDQUFDO1lBQ3hCLE1BQU0sUUFBUSxHQUFHLFdBQVcsQ0FBQyxRQUFRLENBQUE7WUFFckMsSUFBSSxDQUFDLFFBQVEsRUFBRSxDQUFDO2dCQUNkLE1BQU0sSUFBSSxLQUFLLENBQUMseUJBQXlCLENBQUMsQ0FBQTtZQUM1QyxDQUFDO1lBRUQsTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxRQUFRLEVBQUUsSUFBSSxDQUFDLGlCQUFpQixDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUE7WUFDdkUsT0FBTyxFQUFDLEVBQUUsRUFBRSxJQUFJLEVBQUMsQ0FBQTtRQUNuQixDQUFDO1FBRUQsSUFBSSxPQUFPLEtBQUssbUJBQW1CLEVBQUUsQ0FBQztZQUNwQyxJQUFJLENBQUMsV0FBVyxDQUFDLFFBQVEsRUFBRSxDQUFDO2dCQUMxQixNQUFNLElBQUksS0FBSyxDQUFDLHFDQUFxQyxDQUFDLENBQUE7WUFDeEQsQ0FBQztZQUVELE1BQU0sSUFBSSxDQUFDLE9BQU8sQ0FBQyxpQkFBaUIsQ0FBQyxXQUFXLENBQUMsUUFBUSxFQUFFLElBQUksQ0FBQyxpQkFBaUIsQ0FBQyxXQUFXLENBQUMsQ0FBQyxDQUFBO1lBQy9GLE9BQU8sRUFBQyxFQUFFLEVBQUUsSUFBSSxFQUFDLENBQUE7UUFDbkIsQ0FBQztRQUVELElBQUksT0FBTyxLQUFLLGlCQUFpQixFQUFFLENBQUM7WUFDbEMsSUFBSSxDQUFDLFdBQVcsQ0FBQyxRQUFRLEVBQUUsQ0FBQztnQkFDMUIsTUFBTSxJQUFJLEtBQUssQ0FBQyxtQ0FBbUMsQ0FBQyxDQUFBO1lBQ3RELENBQUM7WUFFRCxNQUFNLElBQUksQ0FBQyxPQUFPLENBQUMsZUFBZSxDQUFDLFdBQVcsQ0FBQyxRQUFRLEVBQUUsSUFBSSxDQUFDLGlCQUFpQixDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUE7WUFDN0YsT0FBTyxFQUFDLEVBQUUsRUFBRSxJQUFJLEVBQUMsQ0FBQTtRQUNuQixDQUFDO1FBRUQsSUFBSSxPQUFPLEtBQUssVUFBVSxFQUFFLENBQUM7WUFDM0IsTUFBTSxRQUFRLEdBQUcsV0FBVyxDQUFDLFFBQVEsQ0FBQTtZQUNyQyxNQUFNLFVBQVUsR0FBRyxXQUFXLENBQUMsVUFBVSxJQUFJLFdBQVcsQ0FBQyxNQUFNLENBQUE7WUFDL0QsTUFBTSxVQUFVLEdBQUcsS0FBSyxDQUFDLE9BQU8sQ0FBQyxXQUFXLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxDQUFDLFdBQVcsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQTtZQUUxRSxJQUFJLENBQUMsUUFBUSxFQUFFLENBQUM7Z0JBQ2QsTUFBTSxJQUFJLEtBQUssQ0FBQyw0QkFBNEIsQ0FBQyxDQUFBO1lBQy9DLENBQUM7WUFFRCxJQUFJLENBQUMsVUFBVSxFQUFFLENBQUM7Z0JBQ2hCLE1BQU0sSUFBSSxLQUFLLENBQUMsOEJBQThCLENBQUMsQ0FBQTtZQUNqRCxDQUFDO1lBRUQsTUFBTSxNQUFNLEdBQUcsTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxFQUFDLFFBQVEsRUFBRSxHQUFHLElBQUksQ0FBQyxpQkFBaUIsQ0FBQyxXQUFXLENBQUMsRUFBQyxFQUFFLFVBQVUsRUFBRSxHQUFHLFVBQVUsQ0FBQyxDQUFBO1lBRXpILE9BQU8sRUFBQyxNQUFNLEVBQUMsQ0FBQTtRQUNqQixDQUFDO1FBRUQsTUFBTSxJQUFJLEtBQUssQ0FBQyw0QkFBNEIsT0FBTyxFQUFFLENBQUMsQ0FBQTtJQUN4RCxDQUFDO0NBQ0YiLCJzb3VyY2VzQ29udGVudCI6WyIvKiogUnVucyBicm93c2VyIGNvbW1hbmRzIGFjcm9zcyBDTEkgYW5kIFdlYlNvY2tldCB0cmFuc3BvcnRzLiAqL1xuZXhwb3J0IGRlZmF1bHQgY2xhc3MgQnJvd3NlckNvbW1hbmRSdW5uZXIge1xuICAvKipcbiAgICogQHBhcmFtIHtvYmplY3R9IGFyZ3NcbiAgICogQHBhcmFtIHtpbXBvcnQoXCIuL2Jyb3dzZXIuanNcIikuZGVmYXVsdH0gYXJncy5icm93c2VyXG4gICAqL1xuICBjb25zdHJ1Y3Rvcih7YnJvd3Nlcn0pIHtcbiAgICB0aGlzLmJyb3dzZXIgPSBicm93c2VyXG4gIH1cblxuICAvKipcbiAgICogQHBhcmFtIHtSZWNvcmQ8c3RyaW5nLCBhbnk+fSBjb21tYW5kQXJnc1xuICAgKiBAcmV0dXJucyB7e3RpbWVvdXQ/OiBudW1iZXJ9fVxuICAgKi9cbiAgbm9ybWFsaXplVGltZW91dEFyZ3MoY29tbWFuZEFyZ3MpIHtcbiAgICBjb25zdCBub3JtYWxpemVkQXJncyA9IHt9XG5cbiAgICBpZiAoXCJ0aW1lb3V0XCIgaW4gY29tbWFuZEFyZ3MgJiYgY29tbWFuZEFyZ3MudGltZW91dCAhPT0gdW5kZWZpbmVkKSB7XG4gICAgICBub3JtYWxpemVkQXJncy50aW1lb3V0ID0gTnVtYmVyKGNvbW1hbmRBcmdzLnRpbWVvdXQpXG5cbiAgICAgIGlmIChOdW1iZXIuaXNOYU4obm9ybWFsaXplZEFyZ3MudGltZW91dCkpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKGBJbnZhbGlkIHRpbWVvdXQ6ICR7Y29tbWFuZEFyZ3MudGltZW91dH1gKVxuICAgICAgfVxuICAgIH1cblxuICAgIHJldHVybiBub3JtYWxpemVkQXJnc1xuICB9XG5cbiAgLyoqXG4gICAqIEBwYXJhbSB7UmVjb3JkPHN0cmluZywgYW55Pn0gY29tbWFuZEFyZ3NcbiAgICogQHJldHVybnMge2ltcG9ydChcIi4vc3lzdGVtLXRlc3QuanNcIikuRmluZEFyZ3N9XG4gICAqL1xuICBub3JtYWxpemVGaW5kQXJncyhjb21tYW5kQXJncykge1xuICAgIGNvbnN0IGZpbmRBcmdzID0gLyoqIEB0eXBlIHtpbXBvcnQoXCIuL3N5c3RlbS10ZXN0LmpzXCIpLkZpbmRBcmdzfSAqLyAodGhpcy5ub3JtYWxpemVUaW1lb3V0QXJncyhjb21tYW5kQXJncykpXG5cbiAgICBpZiAoXCJ2aXNpYmxlXCIgaW4gY29tbWFuZEFyZ3MgJiYgY29tbWFuZEFyZ3MudmlzaWJsZSAhPT0gdW5kZWZpbmVkKSB7XG4gICAgICBpZiAoY29tbWFuZEFyZ3MudmlzaWJsZSA9PT0gbnVsbCB8fCBjb21tYW5kQXJncy52aXNpYmxlID09PSBcIm51bGxcIikge1xuICAgICAgICBmaW5kQXJncy52aXNpYmxlID0gbnVsbFxuICAgICAgfSBlbHNlIGlmICh0eXBlb2YgY29tbWFuZEFyZ3MudmlzaWJsZSA9PT0gXCJib29sZWFuXCIpIHtcbiAgICAgICAgZmluZEFyZ3MudmlzaWJsZSA9IGNvbW1hbmRBcmdzLnZpc2libGVcbiAgICAgIH0gZWxzZSB7XG4gICAgICAgIGZpbmRBcmdzLnZpc2libGUgPSBjb21tYW5kQXJncy52aXNpYmxlID09PSBcInRydWVcIlxuICAgICAgfVxuICAgIH1cblxuICAgIGlmIChcInVzZUJhc2VTZWxlY3RvclwiIGluIGNvbW1hbmRBcmdzICYmIGNvbW1hbmRBcmdzLnVzZUJhc2VTZWxlY3RvciAhPT0gdW5kZWZpbmVkKSB7XG4gICAgICBpZiAodHlwZW9mIGNvbW1hbmRBcmdzLnVzZUJhc2VTZWxlY3RvciA9PT0gXCJib29sZWFuXCIpIHtcbiAgICAgICAgZmluZEFyZ3MudXNlQmFzZVNlbGVjdG9yID0gY29tbWFuZEFyZ3MudXNlQmFzZVNlbGVjdG9yXG4gICAgICB9IGVsc2Uge1xuICAgICAgICBmaW5kQXJncy51c2VCYXNlU2VsZWN0b3IgPSBjb21tYW5kQXJncy51c2VCYXNlU2VsZWN0b3IgPT09IFwidHJ1ZVwiXG4gICAgICB9XG4gICAgfVxuXG4gICAgcmV0dXJuIGZpbmRBcmdzXG4gIH1cblxuICAvKipcbiAgICogQHBhcmFtIHtpbXBvcnQoXCJzZWxlbml1bS13ZWJkcml2ZXJcIikuV2ViRWxlbWVudH0gZWxlbWVudFxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTxSZWNvcmQ8c3RyaW5nLCBhbnk+Pn1cbiAgICovXG4gIGFzeW5jIHNlcmlhbGl6ZUVsZW1lbnQoZWxlbWVudCkge1xuICAgIGNvbnN0IHRleHQgPSBhd2FpdCBlbGVtZW50LmdldFRleHQoKVxuICAgIGNvbnN0IHRhZ05hbWUgPSBhd2FpdCBlbGVtZW50LmdldFRhZ05hbWUoKVxuICAgIGNvbnN0IGRpc3BsYXllZCA9IGF3YWl0IGVsZW1lbnQuaXNEaXNwbGF5ZWQoKVxuXG4gICAgcmV0dXJuIHtkaXNwbGF5ZWQsIHRhZ05hbWUsIHRleHR9XG4gIH1cblxuICAvKipcbiAgICogQHBhcmFtIHtzdHJpbmd9IGNvbW1hbmRcbiAgICogQHBhcmFtIHtSZWNvcmQ8c3RyaW5nLCBhbnk+fSBjb21tYW5kQXJnc1xuICAgKiBAcmV0dXJucyB7UHJvbWlzZTxhbnk+fVxuICAgKi9cbiAgYXN5bmMgcnVuKGNvbW1hbmQsIGNvbW1hbmRBcmdzID0ge30pIHtcbiAgICBpZiAoY29tbWFuZCA9PT0gXCJ2aXNpdFwiKSB7XG4gICAgICBjb25zdCBwYXRoID0gY29tbWFuZEFyZ3MucGF0aCA/PyBjb21tYW5kQXJncy51cmxcblxuICAgICAgaWYgKCFwYXRoKSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcihcInZpc2l0IHJlcXVpcmVzIHBhdGggb3IgdXJsXCIpXG4gICAgICB9XG5cbiAgICAgIGF3YWl0IHRoaXMuYnJvd3Nlci52aXNpdChwYXRoLCB0aGlzLm5vcm1hbGl6ZVRpbWVvdXRBcmdzKGNvbW1hbmRBcmdzKSlcbiAgICAgIHJldHVybiB7b2s6IHRydWV9XG4gICAgfVxuXG4gICAgaWYgKGNvbW1hbmQgPT09IFwiZGlzbWlzc1RvXCIpIHtcbiAgICAgIGNvbnN0IHBhdGggPSBjb21tYW5kQXJncy5wYXRoID8/IGNvbW1hbmRBcmdzLnVybFxuXG4gICAgICBpZiAoIXBhdGgpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFwiZGlzbWlzc1RvIHJlcXVpcmVzIHBhdGggb3IgdXJsXCIpXG4gICAgICB9XG5cbiAgICAgIGF3YWl0IHRoaXMuYnJvd3Nlci5kaXNtaXNzVG8ocGF0aCwgdGhpcy5ub3JtYWxpemVUaW1lb3V0QXJncyhjb21tYW5kQXJncykpXG4gICAgICByZXR1cm4ge29rOiB0cnVlfVxuICAgIH1cblxuICAgIGlmIChjb21tYW5kID09PSBcInNldEJhc2VTZWxlY3RvclwiKSB7XG4gICAgICBpZiAoIWNvbW1hbmRBcmdzLnNlbGVjdG9yKSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcihcInNldEJhc2VTZWxlY3RvciByZXF1aXJlcyBzZWxlY3RvclwiKVxuICAgICAgfVxuXG4gICAgICB0aGlzLmJyb3dzZXIuc2V0QmFzZVNlbGVjdG9yKGNvbW1hbmRBcmdzLnNlbGVjdG9yKVxuICAgICAgcmV0dXJuIHtvazogdHJ1ZX1cbiAgICB9XG5cbiAgICBpZiAoY29tbWFuZCA9PT0gXCJnZXRDdXJyZW50VXJsXCIpIHtcbiAgICAgIHJldHVybiB7Y3VycmVudFVybDogYXdhaXQgdGhpcy5icm93c2VyLmdldEN1cnJlbnRVcmwoKX1cbiAgICB9XG5cbiAgICBpZiAoY29tbWFuZCA9PT0gXCJnZXRIVE1MXCIpIHtcbiAgICAgIHJldHVybiB7aHRtbDogYXdhaXQgdGhpcy5icm93c2VyLmdldEhUTUwoKX1cbiAgICB9XG5cbiAgICBpZiAoY29tbWFuZCA9PT0gXCJnZXRCcm93c2VyTG9nc1wiKSB7XG4gICAgICByZXR1cm4ge2xvZ3M6IGF3YWl0IHRoaXMuYnJvd3Nlci5nZXRCcm93c2VyTG9ncygpfVxuICAgIH1cblxuICAgIGlmIChjb21tYW5kID09PSBcInRha2VTY3JlZW5zaG90XCIpIHtcbiAgICAgIHJldHVybiBhd2FpdCB0aGlzLmJyb3dzZXIudGFrZVNjcmVlbnNob3QoKVxuICAgIH1cblxuICAgIGlmIChjb21tYW5kID09PSBcImZpbmRcIikge1xuICAgICAgaWYgKCFjb21tYW5kQXJncy5zZWxlY3Rvcikge1xuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoXCJmaW5kIHJlcXVpcmVzIHNlbGVjdG9yXCIpXG4gICAgICB9XG5cbiAgICAgIGNvbnN0IGVsZW1lbnQgPSBhd2FpdCB0aGlzLmJyb3dzZXIuZmluZChjb21tYW5kQXJncy5zZWxlY3RvciwgdGhpcy5ub3JtYWxpemVGaW5kQXJncyhjb21tYW5kQXJncykpXG5cbiAgICAgIHJldHVybiB7ZWxlbWVudDogYXdhaXQgdGhpcy5zZXJpYWxpemVFbGVtZW50KGVsZW1lbnQpfVxuICAgIH1cblxuICAgIGlmIChjb21tYW5kID09PSBcImZpbmRCeVRlc3RJRFwiKSB7XG4gICAgICBjb25zdCB0ZXN0SUQgPSBjb21tYW5kQXJncy50ZXN0SUQgPz8gY29tbWFuZEFyZ3MudGVzdElkXG5cbiAgICAgIGlmICghdGVzdElEKSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcihcImZpbmRCeVRlc3RJRCByZXF1aXJlcyB0ZXN0SURcIilcbiAgICAgIH1cblxuICAgICAgY29uc3QgZWxlbWVudCA9IGF3YWl0IHRoaXMuYnJvd3Nlci5maW5kQnlUZXN0SUQodGVzdElELCB0aGlzLm5vcm1hbGl6ZUZpbmRBcmdzKGNvbW1hbmRBcmdzKSlcblxuICAgICAgcmV0dXJuIHtlbGVtZW50OiBhd2FpdCB0aGlzLnNlcmlhbGl6ZUVsZW1lbnQoZWxlbWVudCl9XG4gICAgfVxuXG4gICAgaWYgKGNvbW1hbmQgPT09IFwiY2xpY2tcIikge1xuICAgICAgY29uc3Qgc2VsZWN0b3IgPSBjb21tYW5kQXJncy5zZWxlY3RvclxuXG4gICAgICBpZiAoIXNlbGVjdG9yKSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcihcImNsaWNrIHJlcXVpcmVzIHNlbGVjdG9yXCIpXG4gICAgICB9XG5cbiAgICAgIGF3YWl0IHRoaXMuYnJvd3Nlci5jbGljayhzZWxlY3RvciwgdGhpcy5ub3JtYWxpemVGaW5kQXJncyhjb21tYW5kQXJncykpXG4gICAgICByZXR1cm4ge29rOiB0cnVlfVxuICAgIH1cblxuICAgIGlmIChjb21tYW5kID09PSBcIndhaXRGb3JOb1NlbGVjdG9yXCIpIHtcbiAgICAgIGlmICghY29tbWFuZEFyZ3Muc2VsZWN0b3IpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFwid2FpdEZvck5vU2VsZWN0b3IgcmVxdWlyZXMgc2VsZWN0b3JcIilcbiAgICAgIH1cblxuICAgICAgYXdhaXQgdGhpcy5icm93c2VyLndhaXRGb3JOb1NlbGVjdG9yKGNvbW1hbmRBcmdzLnNlbGVjdG9yLCB0aGlzLm5vcm1hbGl6ZUZpbmRBcmdzKGNvbW1hbmRBcmdzKSlcbiAgICAgIHJldHVybiB7b2s6IHRydWV9XG4gICAgfVxuXG4gICAgaWYgKGNvbW1hbmQgPT09IFwiZXhwZWN0Tm9FbGVtZW50XCIpIHtcbiAgICAgIGlmICghY29tbWFuZEFyZ3Muc2VsZWN0b3IpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFwiZXhwZWN0Tm9FbGVtZW50IHJlcXVpcmVzIHNlbGVjdG9yXCIpXG4gICAgICB9XG5cbiAgICAgIGF3YWl0IHRoaXMuYnJvd3Nlci5leHBlY3ROb0VsZW1lbnQoY29tbWFuZEFyZ3Muc2VsZWN0b3IsIHRoaXMubm9ybWFsaXplRmluZEFyZ3MoY29tbWFuZEFyZ3MpKVxuICAgICAgcmV0dXJuIHtvazogdHJ1ZX1cbiAgICB9XG5cbiAgICBpZiAoY29tbWFuZCA9PT0gXCJpbnRlcmFjdFwiKSB7XG4gICAgICBjb25zdCBzZWxlY3RvciA9IGNvbW1hbmRBcmdzLnNlbGVjdG9yXG4gICAgICBjb25zdCBtZXRob2ROYW1lID0gY29tbWFuZEFyZ3MubWV0aG9kTmFtZSA/PyBjb21tYW5kQXJncy5tZXRob2RcbiAgICAgIGNvbnN0IG1ldGhvZEFyZ3MgPSBBcnJheS5pc0FycmF5KGNvbW1hbmRBcmdzLmFyZ3MpID8gY29tbWFuZEFyZ3MuYXJncyA6IFtdXG5cbiAgICAgIGlmICghc2VsZWN0b3IpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFwiaW50ZXJhY3QgcmVxdWlyZXMgc2VsZWN0b3JcIilcbiAgICAgIH1cblxuICAgICAgaWYgKCFtZXRob2ROYW1lKSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcihcImludGVyYWN0IHJlcXVpcmVzIG1ldGhvZE5hbWVcIilcbiAgICAgIH1cblxuICAgICAgY29uc3QgcmVzdWx0ID0gYXdhaXQgdGhpcy5icm93c2VyLmludGVyYWN0KHtzZWxlY3RvciwgLi4udGhpcy5ub3JtYWxpemVGaW5kQXJncyhjb21tYW5kQXJncyl9LCBtZXRob2ROYW1lLCAuLi5tZXRob2RBcmdzKVxuXG4gICAgICByZXR1cm4ge3Jlc3VsdH1cbiAgICB9XG5cbiAgICB0aHJvdyBuZXcgRXJyb3IoYFVua25vd24gYnJvd3NlciBjb21tYW5kOiAke2NvbW1hbmR9YClcbiAgfVxufVxuIl19

package/build/browser-daemon-constants.d.ts

@@ -0,0 +1,2 @@
+export const browserDaemonStopTimeoutMs: 10000;
+export const browserDaemonVerifyTimeoutMs: 1000;

package/build/browser-daemon-constants.js

@@ -0,0 +1,3 @@
+export const browserDaemonStopTimeoutMs = 10000;
+export const browserDaemonVerifyTimeoutMs = 1000;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJvd3Nlci1kYWVtb24tY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2Jyb3dzZXItZGFlbW9uLWNvbnN0YW50cy5qcyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxNQUFNLENBQUMsTUFBTSwwQkFBMEIsR0FBRyxLQUFLLENBQUE7QUFDL0MsTUFBTSxDQUFDLE1BQU0sNEJBQTRCLEdBQUcsSUFBSSxDQUFBIiwic291cmNlc0NvbnRlbnQiOlsiZXhwb3J0IGNvbnN0IGJyb3dzZXJEYWVtb25TdG9wVGltZW91dE1zID0gMTAwMDBcbmV4cG9ydCBjb25zdCBicm93c2VyRGFlbW9uVmVyaWZ5VGltZW91dE1zID0gMTAwMFxuIl19

package/build/browser-process.d.ts

@@ -0,0 +1,45 @@
+/** Long-running browser daemon exposing browser commands over WebSocket. */
+export default class BrowserProcess {
+    /**
+     * @param {object} args
+     * @param {string} args.name
+     * @param {Browser} [args.browser]
+     * @param {Record<string, any>} [args.browserArgs]
+     * @param {string} [args.baseUrl]
+     * @param {boolean} [args.debug]
+     * @param {number} [args.port]
+     */
+    constructor({ name, browser, browserArgs, baseUrl, debug, port }: {
+        name: string;
+        browser?: Browser;
+        browserArgs?: Record<string, any>;
+        baseUrl?: string;
+        debug?: boolean;
+        port?: number;
+    });
+    name: string;
+    browser: Browser;
+    baseUrl: string;
+    debug: boolean;
+    requestRunner: BrowserCommandRunner;
+    requestCount: number;
+    port: number;
+    /** @returns {Promise<void>} */
+    start(): Promise<void>;
+    wss: import("ws").Server<typeof import("ws").default, typeof import("node:http").IncomingMessage>;
+    /** @returns {Promise<void>} */
+    stop(): Promise<void>;
+    stopped: boolean;
+    /**
+     * @param {import("ws").WebSocket} ws
+     * @returns {void}
+     */
+    onConnection: (ws: import("ws").WebSocket) => void;
+    /**
+     * @param {Record<string, any>} payload
+     * @returns {Promise<any>}
+     */
+    handlePayload(payload: Record<string, any>): Promise<any>;
+}
+import Browser from "./browser.js";
+import BrowserCommandRunner from "./browser-command-runner.js";