system-testing 1.0.77 → 1.0.79

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,147 @@ 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()
+```
+
+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.
+
+### 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.
 
-`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).
+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 --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.
+
+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 +266,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 +297,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`
 
@@ -181,7 +388,7 @@ Use `useBaseSelector: false` only for modal or overlay content. Keep the default
 Most selector helpers accept the same options:
 
 - `timeout` (number): override how long the lookup should wait.
-- `visible` (boolean): require elements to be visible (`true`) or hidden (`false`).
+- `visible` (boolean|null): require elements to be visible (`true`) or hidden (`false`), or disable visibility filtering with `null`.
 - `useBaseSelector` (boolean): scope the selector to the focused container.
 
 These options are supported by `find`, `findByTestID`, and `all`. `click` also accepts the same options when a selector string is used:
@@ -208,4 +415,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,27 @@
+/** 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 {Record<string, any>}
+     */
+    normalizeFindArgs(commandArgs: Record<string, any>): Record<string, any>;
+    /**
+     * @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,144 @@
+/** 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 {Record<string, any>}
+     */
+    normalizeFindArgs(commandArgs) {
+        const findArgs = {};
+        if ("timeout" in commandArgs && commandArgs.timeout !== undefined) {
+            findArgs.timeout = Number(commandArgs.timeout);
+        }
+        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);
+            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);
+            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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJvd3Nlci1jb21tYW5kLXJ1bm5lci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9icm93c2VyLWNvbW1hbmQtcnVubmVyLmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGlFQUFpRTtBQUNqRSxNQUFNLENBQUMsT0FBTyxPQUFPLG9CQUFvQjtJQUN2Qzs7O09BR0c7SUFDSCxZQUFZLEVBQUMsT0FBTyxFQUFDO1FBQ25CLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFBO0lBQ3hCLENBQUM7SUFFRDs7O09BR0c7SUFDSCxpQkFBaUIsQ0FBQyxXQUFXO1FBQzNCLE1BQU0sUUFBUSxHQUFHLEVBQUUsQ0FBQTtRQUVuQixJQUFJLFNBQVMsSUFBSSxXQUFXLElBQUksV0FBVyxDQUFDLE9BQU8sS0FBSyxTQUFTLEVBQUUsQ0FBQztZQUNsRSxRQUFRLENBQUMsT0FBTyxHQUFHLE1BQU0sQ0FBQyxXQUFXLENBQUMsT0FBTyxDQUFDLENBQUE7UUFDaEQsQ0FBQztRQUVELElBQUksU0FBUyxJQUFJLFdBQVcsSUFBSSxXQUFXLENBQUMsT0FBTyxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQ2xFLElBQUksV0FBVyxDQUFDLE9BQU8sS0FBSyxJQUFJLElBQUksV0FBVyxDQUFDLE9BQU8sS0FBSyxNQUFNLEVBQUUsQ0FBQztnQkFDbkUsUUFBUSxDQUFDLE9BQU8sR0FBRyxJQUFJLENBQUE7WUFDekIsQ0FBQztpQkFBTSxJQUFJLE9BQU8sV0FBVyxDQUFDLE9BQU8sS0FBSyxTQUFTLEVBQUUsQ0FBQztnQkFDcEQsUUFBUSxDQUFDLE9BQU8sR0FBRyxXQUFXLENBQUMsT0FBTyxDQUFBO1lBQ3hDLENBQUM7aUJBQU0sQ0FBQztnQkFDTixRQUFRLENBQUMsT0FBTyxHQUFHLFdBQVcsQ0FBQyxPQUFPLEtBQUssTUFBTSxDQUFBO1lBQ25ELENBQUM7UUFDSCxDQUFDO1FBRUQsSUFBSSxpQkFBaUIsSUFBSSxXQUFXLElBQUksV0FBVyxDQUFDLGVBQWUs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TyxDQUFDLFdBQVcsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUMsV0FBVyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFBO1lBRTFFLElBQUksQ0FBQyxRQUFRLEVBQUUsQ0FBQztnQkFDZCxNQUFNLElBQUksS0FBSyxDQUFDLDRCQUE0QixDQUFDLENBQUE7WUFDL0MsQ0FBQztZQUVELElBQUksQ0FBQyxVQUFVLEVBQUUsQ0FBQztnQkFDaEIsTUFBTSxJQUFJLEtBQUssQ0FBQyw4QkFBOEIsQ0FBQyxDQUFBO1lBQ2pELENBQUM7WUFFRCxNQUFNLE1BQU0sR0FBRyxNQUFNLElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLEVBQUMsUUFBUSxFQUFFLEdBQUcsSUFBSSxDQUFDLGlCQUFpQixDQUFDLFdBQVcsQ0FBQyxFQUFDLEVBQUUsVUFBVSxFQUFFLEdBQUcsVUFBVSxDQUFDLENBQUE7WUFFekgsT0FBTyxFQUFDLE1BQU0sRUFBQyxDQUFBO1FBQ2pCLENBQUM7UUFFRCxNQUFNLElBQUksS0FBSyxDQUFDLDRCQUE0QixPQUFPLEVBQUUsQ0FBQyxDQUFBO0lBQ3hELENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8qKiBSdW5zIGJyb3dzZXIgY29tbWFuZHMgYWNyb3NzIENMSSBhbmQgV2ViU29ja2V0IHRyYW5zcG9ydHMuICovXG5leHBvcnQgZGVmYXVsdCBjbGFzcyBCcm93c2VyQ29tbWFuZFJ1bm5lciB7XG4gIC8qKlxuICAgKiBAcGFyYW0ge29iamVjdH0gYXJnc1xuICAgKiBAcGFyYW0ge2ltcG9ydChcIi4vYnJvd3Nlci5qc1wiKS5kZWZhdWx0fSBhcmdzLmJyb3dzZXJcbiAgICovXG4gIGNvbnN0cnVjdG9yKHticm93c2VyfSkge1xuICAgIHRoaXMuYnJvd3NlciA9IGJyb3dzZXJcbiAgfVxuXG4gIC8qKlxuICAgKiBAcGFyYW0ge1JlY29yZDxzdHJpbmcsIGFueT59IGNvbW1hbmRBcmdzXG4gICAqIEByZXR1cm5zIHtSZWNvcmQ8c3RyaW5nLCBhbnk+fVxuICAgKi9cbiAgbm9ybWFsaXplRmluZEFyZ3MoY29tbWFuZEFyZ3MpIHtcbiAgICBjb25zdCBmaW5kQXJncyA9IHt9XG5cbiAgICBpZiAoXCJ0aW1lb3V0XCIgaW4gY29tbWFuZEFyZ3MgJiYgY29tbWFuZEFyZ3MudGltZW91dCAhPT0gdW5kZWZpbmVkKSB7XG4gICAgICBmaW5kQXJncy50aW1lb3V0ID0gTnVtYmVyKGNvbW1hbmRBcmdzLnRpbWVvdXQpXG4gICAgfVxuXG4gICAgaWYgKFwidmlzaWJsZVwiIGluIGNvbW1hbmRBcmdzICYmIGNvbW1hbmRBcmdzLnZpc2libGUgIT09IHVuZGVmaW5lZCkge1xuICAgICAgaWYgKGNvbW1hbmRBcmdzLnZpc2libGUgPT09IG51bGwgfHwgY29tbWFuZEFyZ3MudmlzaWJsZSA9PT0gXCJudWxsXCIpIHtcbiAgICAgICAgZmluZEFyZ3MudmlzaWJsZSA9IG51bGxcbiAgICAgIH0gZWxzZSBpZiAodHlwZW9mIGNvbW1hbmRBcmdzLnZpc2libGUgPT09IFwiYm9vbGVhblwiKSB7XG4gICAgICAgIGZpbmRBcmdzLnZpc2libGUgPSBjb21tYW5kQXJncy52aXNpYmxlXG4gICAgICB9IGVsc2Uge1xuICAgICAgICBmaW5kQXJncy52aXNpYmxlID0gY29tbWFuZEFyZ3MudmlzaWJsZSA9PT0gXCJ0cnVlXCJcbiAgICAgIH1cbiAgICB9XG5cbiAgICBpZiAoXCJ1c2VCYXNlU2VsZWN0b3JcIiBpbiBjb21tYW5kQXJncyAmJiBjb21tYW5kQXJncy51c2VCYXNlU2VsZWN0b3IgIT09IHVuZGVmaW5lZCkge1xuICAgICAgaWYgKHR5cGVvZiBjb21tYW5kQXJncy51c2VCYXNlU2VsZWN0b3IgPT09IFwiYm9vbGVhblwiKSB7XG4gICAgICAgIGZpbmRBcmdzLnVzZUJhc2VTZWxlY3RvciA9IGNvbW1hbmRBcmdzLnVzZUJhc2VTZWxlY3RvclxuICAgICAgfSBlbHNlIHtcbiAgICAgICAgZmluZEFyZ3MudXNlQmFzZVNlbGVjdG9yID0gY29tbWFuZEFyZ3MudXNlQmFzZVNlbGVjdG9yID09PSBcInRydWVcIlxuICAgICAgfVxuICAgIH1cblxuICAgIHJldHVybiBmaW5kQXJnc1xuICB9XG5cbiAgLyoqXG4gICAqIEBwYXJhbSB7aW1wb3J0KFwic2VsZW5pdW0td2ViZHJpdmVyXCIpLldlYkVsZW1lbnR9IGVsZW1lbnRcbiAgICogQHJldHVybnMge1Byb21pc2U8UmVjb3JkPHN0cmluZywgYW55Pj59XG4gICAqL1xuICBhc3luYyBzZXJpYWxpemVFbGVtZW50KGVsZW1lbnQpIHtcbiAgICBjb25zdCB0ZXh0ID0gYXdhaXQgZWxlbWVudC5nZXRUZXh0KClcbiAgICBjb25zdCB0YWdOYW1lID0gYXdhaXQgZWxlbWVudC5nZXRUYWdOYW1lKClcbiAgICBjb25zdCBkaXNwbGF5ZWQgPSBhd2FpdCBlbGVtZW50LmlzRGlzcGxheWVkKClcblxuICAgIHJldHVybiB7ZGlzcGxheWVkLCB0YWdOYW1lLCB0ZXh0fVxuICB9XG5cbiAgLyoqXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBjb21tYW5kXG4gICAqIEBwYXJhbSB7UmVjb3JkPHN0cmluZywgYW55Pn0gY29tbWFuZEFyZ3NcbiAgICogQHJldHVybnMge1Byb21pc2U8YW55Pn1cbiAgICovXG4gIGFzeW5jIHJ1bihjb21tYW5kLCBjb21tYW5kQXJncyA9IHt9KSB7XG4gICAgaWYgKGNvbW1hbmQgPT09IFwidmlzaXRcIikge1xuICAgICAgY29uc3QgcGF0aCA9IGNvbW1hbmRBcmdzLnBhdGggPz8gY29tbWFuZEFyZ3MudXJsXG5cbiAgICAgIGlmICghcGF0aCkge1xuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoXCJ2aXNpdCByZXF1aXJlcyBwYXRoIG9yIHVybFwiKVxuICAgICAgfVxuXG4gICAgICBhd2FpdCB0aGlzLmJyb3dzZXIudmlzaXQocGF0aClcbiAgICAgIHJldHVybiB7b2s6IHRydWV9XG4gICAgfVxuXG4gICAgaWYgKGNvbW1hbmQgPT09IFwiZGlzbWlzc1RvXCIpIHtcbiAgICAgIGNvbnN0IHBhdGggPSBjb21tYW5kQXJncy5wYXRoID8/IGNvbW1hbmRBcmdzLnVybFxuXG4gICAgICBpZiAoIXBhdGgpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFwiZGlzbWlzc1RvIHJlcXVpcmVzIHBhdGggb3IgdXJsXCIpXG4gICAgICB9XG5cbiAgICAgIGF3YWl0IHRoaXMuYnJvd3Nlci5kaXNtaXNzVG8ocGF0aClcbiAgICAgIHJldHVybiB7b2s6IHRydWV9XG4gICAgfVxuXG4gICAgaWYgKGNvbW1hbmQgPT09IFwic2V0QmFzZVNlbGVjdG9yXCIpIHtcbiAgICAgIGlmICghY29tbWFuZEFyZ3Muc2VsZWN0b3IpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFwic2V0QmFzZVNlbGVjdG9yIHJlcXVpcmVzIHNlbGVjdG9yXCIpXG4gICAgICB9XG5cbiAgICAgIHRoaXMuYnJvd3Nlci5zZXRCYXNlU2VsZWN0b3IoY29tbWFuZEFyZ3Muc2VsZWN0b3IpXG4gICAgICByZXR1cm4ge29rOiB0cnVlfVxuICAgIH1cblxuICAgIGlmIChjb21tYW5kID09PSBcImdldEN1cnJlbnRVcmxcIikge1xuICAgICAgcmV0dXJuIHtjdXJyZW50VXJsOiBhd2FpdCB0aGlzLmJyb3dzZXIuZ2V0Q3VycmVudFVybCgpfVxuICAgIH1cblxuICAgIGlmIChjb21tYW5kID09PSBcImdldEhUTUxcIikge1xuICAgICAgcmV0dXJuIHtodG1sOiBhd2FpdCB0aGlzLmJyb3dzZXIuZ2V0SFRNTCgpfVxuICAgIH1cblxuICAgIGlmIChjb21tYW5kID09PSBcImdldEJyb3dzZXJMb2dzXCIpIHtcbiAgICAgIHJldHVybiB7bG9nczogYXdhaXQgdGhpcy5icm93c2VyLmdldEJyb3dzZXJMb2dzKCl9XG4gICAgfVxuXG4gICAgaWYgKGNvbW1hbmQgPT09IFwidGFrZVNjcmVlbnNob3RcIikge1xuICAgICAgcmV0dXJuIGF3YWl0IHRoaXMuYnJvd3Nlci50YWtlU2NyZWVuc2hvdCgpXG4gICAgfVxuXG4gICAgaWYgKGNvbW1hbmQgPT09IFwiZmluZFwiKSB7XG4gICAgICBpZiAoIWNvbW1hbmRBcmdzLnNlbGVjdG9yKSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcihcImZpbmQgcmVxdWlyZXMgc2VsZWN0b3JcIilcbiAgICAgIH1cblxuICAgICAgY29uc3QgZWxlbWVudCA9IGF3YWl0IHRoaXMuYnJvd3Nlci5maW5kKGNvbW1hbmRBcmdzLnNlbGVjdG9yLCB0aGlzLm5vcm1hbGl6ZUZpbmRBcmdzKGNvbW1hbmRBcmdzKSlcblxuICAgICAgcmV0dXJuIHtlbGVtZW50OiBhd2FpdCB0aGlzLnNlcmlhbGl6ZUVsZW1lbnQoZWxlbWVudCl9XG4gICAgfVxuXG4gICAgaWYgKGNvbW1hbmQgPT09IFwiZmluZEJ5VGVzdElEXCIpIHtcbiAgICAgIGNvbnN0IHRlc3RJRCA9IGNvbW1hbmRBcmdzLnRlc3RJRCA/PyBjb21tYW5kQXJncy50ZXN0SWRcblxuICAgICAgaWYgKCF0ZXN0SUQpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFwiZmluZEJ5VGVzdElEIHJlcXVpcmVzIHRlc3RJRFwiKVxuICAgICAgfVxuXG4gICAgICBjb25zdCBlbGVtZW50ID0gYXdhaXQgdGhpcy5icm93c2VyLmZpbmRCeVRlc3RJRCh0ZXN0SUQsIHRoaXMubm9ybWFsaXplRmluZEFyZ3MoY29tbWFuZEFyZ3MpKVxuXG4gICAgICByZXR1cm4ge2VsZW1lbnQ6IGF3YWl0IHRoaXMuc2VyaWFsaXplRWxlbWVudChlbGVtZW50KX1cbiAgICB9XG5cbiAgICBpZiAoY29tbWFuZCA9PT0gXCJjbGlja1wiKSB7XG4gICAgICBjb25zdCBzZWxlY3RvciA9IGNvbW1hbmRBcmdzLnNlbGVjdG9yXG5cbiAgICAgIGlmICghc2VsZWN0b3IpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFwiY2xpY2sgcmVxdWlyZXMgc2VsZWN0b3JcIilcbiAgICAgIH1cblxuICAgICAgYXdhaXQgdGhpcy5icm93c2VyLmNsaWNrKHNlbGVjdG9yLCB0aGlzLm5vcm1hbGl6ZUZpbmRBcmdzKGNvbW1hbmRBcmdzKSlcbiAgICAgIHJldHVybiB7b2s6IHRydWV9XG4gICAgfVxuXG4gICAgaWYgKGNvbW1hbmQgPT09IFwid2FpdEZvck5vU2VsZWN0b3JcIikge1xuICAgICAgaWYgKCFjb21tYW5kQXJncy5zZWxlY3Rvcikge1xuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoXCJ3YWl0Rm9yTm9TZWxlY3RvciByZXF1aXJlcyBzZWxlY3RvclwiKVxuICAgICAgfVxuXG4gICAgICBhd2FpdCB0aGlzLmJyb3dzZXIud2FpdEZvck5vU2VsZWN0b3IoY29tbWFuZEFyZ3Muc2VsZWN0b3IsIHRoaXMubm9ybWFsaXplRmluZEFyZ3MoY29tbWFuZEFyZ3MpKVxuICAgICAgcmV0dXJuIHtvazogdHJ1ZX1cbiAgICB9XG5cbiAgICBpZiAoY29tbWFuZCA9PT0gXCJleHBlY3ROb0VsZW1lbnRcIikge1xuICAgICAgaWYgKCFjb21tYW5kQXJncy5zZWxlY3Rvcikge1xuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoXCJleHBlY3ROb0VsZW1lbnQgcmVxdWlyZXMgc2VsZWN0b3JcIilcbiAgICAgIH1cblxuICAgICAgYXdhaXQgdGhpcy5icm93c2VyLmV4cGVjdE5vRWxlbWVudChjb21tYW5kQXJncy5zZWxlY3RvciwgdGhpcy5ub3JtYWxpemVGaW5kQXJncyhjb21tYW5kQXJncykpXG4gICAgICByZXR1cm4ge29rOiB0cnVlfVxuICAgIH1cblxuICAgIGlmIChjb21tYW5kID09PSBcImludGVyYWN0XCIpIHtcbiAgICAgIGNvbnN0IHNlbGVjdG9yID0gY29tbWFuZEFyZ3Muc2VsZWN0b3JcbiAgICAgIGNvbnN0IG1ldGhvZE5hbWUgPSBjb21tYW5kQXJncy5tZXRob2ROYW1lID8/IGNvbW1hbmRBcmdzLm1ldGhvZFxuICAgICAgY29uc3QgbWV0aG9kQXJncyA9IEFycmF5LmlzQXJyYXkoY29tbWFuZEFyZ3MuYXJncykgPyBjb21tYW5kQXJncy5hcmdzIDogW11cblxuICAgICAgaWYgKCFzZWxlY3Rvcikge1xuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoXCJpbnRlcmFjdCByZXF1aXJlcyBzZWxlY3RvclwiKVxuICAgICAgfVxuXG4gICAgICBpZiAoIW1ldGhvZE5hbWUpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFwiaW50ZXJhY3QgcmVxdWlyZXMgbWV0aG9kTmFtZVwiKVxuICAgICAgfVxuXG4gICAgICBjb25zdCByZXN1bHQgPSBhd2FpdCB0aGlzLmJyb3dzZXIuaW50ZXJhY3Qoe3NlbGVjdG9yLCAuLi50aGlzLm5vcm1hbGl6ZUZpbmRBcmdzKGNvbW1hbmRBcmdzKX0sIG1ldGhvZE5hbWUsIC4uLm1ldGhvZEFyZ3MpXG5cbiAgICAgIHJldHVybiB7cmVzdWx0fVxuICAgIH1cblxuICAgIHRocm93IG5ldyBFcnJvcihgVW5rbm93biBicm93c2VyIGNvbW1hbmQ6ICR7Y29tbWFuZH1gKVxuICB9XG59XG4iXX0=

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";