system-testing 1.0.77 → 1.0.79

package/build/browser-process.js

@@ -0,0 +1,127 @@
+import Browser from "./browser.js";
+import BrowserCommandRunner from "./browser-command-runner.js";
+import BrowserRegistry from "./browser-registry.js";
+import { WebSocketServer } from "ws";
+/** 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 = false, port = 0 }) {
+        /**
+         * @param {import("ws").WebSocket} ws
+         * @returns {void}
+         */
+        this.onConnection = (ws) => {
+            ws.on("message", async (rawData) => {
+                const requestId = `${Date.now()}-${this.requestCount++}`;
+                try {
+                    const payload = JSON.parse(rawData.toString());
+                    const result = await this.handlePayload(payload);
+                    ws.send(JSON.stringify({ ok: true, requestId, result, type: "browser-command-result" }));
+                }
+                catch (error) {
+                    ws.send(JSON.stringify({
+                        error: error instanceof Error ? error.message : String(error),
+                        ok: false,
+                        requestId,
+                        type: "browser-command-result"
+                    }));
+                }
+            });
+        };
+        this.name = name;
+        this.browser = browser ?? new Browser({ debug, ...browserArgs });
+        this.baseUrl = baseUrl;
+        this.debug = debug;
+        this.requestRunner = new BrowserCommandRunner({ browser: this.browser });
+        this.requestCount = 0;
+        this.port = port;
+    }
+    /** @returns {Promise<void>} */
+    async start() {
+        if (!this.name) {
+            throw new Error("Browser process requires a name");
+        }
+        if (this.baseUrl) {
+            this.browser.getDriverAdapter().setBaseUrl(this.baseUrl);
+        }
+        await this.browser.getDriverAdapter().start();
+        await this.browser.setTimeouts(10000);
+        this.wss = new WebSocketServer({ port: this.port });
+        await new Promise((resolve) => {
+            this.wss.once("listening", resolve);
+        });
+        const address = this.wss.address();
+        if (!address || typeof address === "string") {
+            throw new Error("Could not resolve browser process port");
+        }
+        this.port = address.port;
+        this.wss.on("connection", this.onConnection);
+        await BrowserRegistry.register({
+            baseUrl: this.baseUrl,
+            name: this.name,
+            pid: process.pid,
+            port: this.port,
+            startedAt: new Date().toISOString()
+        });
+        const stop = async () => {
+            await this.stop();
+            process.exit(0);
+        };
+        process.once("SIGINT", stop);
+        process.once("SIGTERM", stop);
+    }
+    /** @returns {Promise<void>} */
+    async stop() {
+        if (this.stopped) {
+            return;
+        }
+        this.stopped = true;
+        await BrowserRegistry.unregister(this.name);
+        if (this.wss) {
+            await new Promise((resolve, reject) => {
+                this.wss.close((error) => {
+                    if (error) {
+                        reject(error);
+                    }
+                    else {
+                        resolve(undefined);
+                    }
+                });
+            });
+        }
+        await this.browser.stopDriver();
+    }
+    /**
+     * @param {Record<string, any>} payload
+     * @returns {Promise<any>}
+     */
+    async handlePayload(payload) {
+        if (payload.type !== "browser-command") {
+            throw new Error(`Unknown payload type: ${payload.type}`);
+        }
+        const command = payload.command;
+        const commandArgs = payload.args ? { ...payload.args } : {};
+        if (payload.url && !commandArgs.url) {
+            commandArgs.url = payload.url;
+        }
+        if (payload.path && !commandArgs.path) {
+            commandArgs.path = payload.path;
+        }
+        if (payload.selector && !commandArgs.selector) {
+            commandArgs.selector = payload.selector;
+        }
+        if (payload.testID && !commandArgs.testID) {
+            commandArgs.testID = payload.testID;
+        }
+        return await this.requestRunner.run(command, commandArgs);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJvd3Nlci1wcm9jZXNzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2Jyb3dzZXItcHJvY2Vzcy5qcyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLE9BQU8sTUFBTSxjQUFjLENBQUE7QUFDbEMsT0FBTyxvQkFBb0IsTUFBTSw2QkFBNkIsQ0FBQTtBQUM5RCxPQUFPLGVBQWUsTUFBTSx1QkFBdUIsQ0FBQTtBQUNuRCxPQUFPLEVBQUMsZUFBZSxFQUFDLE1BQU0sSUFBSSxDQUFBO0FBRWxDLDRFQUE0RTtBQUM1RSxNQUFNLENBQUMsT0FBTyxPQUFPLGNBQWM7SUFDakM7Ozs7Ozs7O09BUUc7SUFDSCxZQUFZLEVBQUMsSUFBSSxFQUFFLE9BQU8sRUFBRSxXQUFXLEdBQUcsRUFBRSxFQUFFLE9BQU8sRUFBRSxLQUFLLEdBQUcsS0FBSyxFQUFFLElBQUksR0FBRyxDQUFDLEVBQUM7UUE4RS9FOzs7V0FHRztRQUNILGlCQUFZLEdBQUcsQ0FBQyxFQUFFLEVBQUUsRUFBRTtZQUNwQixFQUFFLENBQUMsRUFBRSxDQUFDLFNBQVMsRUFBRSxLQUFLLEVBQUUsT0FBTyxFQUFFLEVBQUU7Z0JBQ2pDLE1BQU0sU0FBUyxHQUFHLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxJQUFJLElBQUksQ0FBQyxZQUFZLEVBQUUsRUFBRSxDQUFBO2dCQUV4RCxJQUFJLENBQUM7b0JBQ0gsTUFBTSxPQUFPLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FBQTtvQkFDOUMsTUFBTSxNQUFNLEdBQUcsTUFBTSxJQUFJLENBQUMsYUFBYSxDQUFDLE9BQU8sQ0FBQyxDQUFBO29CQUVoRCxFQUFFLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsRUFBQyxFQUFFLEVBQUUsSUFBSSxFQUFFLFNBQVMsRUFBRSxNQUFNLEVBQUUsSUFBSSxFQUFFLHdCQUF3QixFQUFDLENBQUMsQ0FBQyxDQUFBO2dC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QUE7UUFDMUQsQ0FBQztRQUVELE1BQU0sT0FBTyxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUE7UUFDL0IsTUFBTSxXQUFXLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBQyxHQUFHLE9BQU8sQ0FBQyxJQUFJLEVBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFBO1FBRXpELElBQUksT0FBTyxDQUFDLEdBQUcsSUFBSSxDQUFDLFdBQVcsQ0FBQyxHQUFHLEVBQUUsQ0FBQztZQUNwQyxXQUFXLENBQUMsR0FBRyxHQUFHLE9BQU8sQ0FBQyxHQUFHLENBQUE7UUFDL0IsQ0FBQztRQUVELElBQUksT0FBTyxDQUFDLElBQUksSUFBSSxDQUFDLFdBQVcsQ0FBQyxJQUFJLEVBQUUsQ0FBQztZQUN0QyxXQUFXLENBQUMsSUFBSSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUE7UUFDakMsQ0FBQztRQUVELElBQUksT0FBTyxDQUFDLFFBQVEsSUFBSSxDQUFDLFdBQVcsQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUM5QyxXQUFXLENBQUMsUUFBUSxHQUFHLE9BQU8sQ0FBQyxRQUFRLENBQUE7UUFDekMsQ0FBQztRQUVELElBQUksT0FBTyxDQUFDLE1BQU0sSUFBSSxDQUFDLFdBQVcsQ0FBQyxNQUFNLEVBQUUsQ0FBQztZQUMxQyxXQUFXLENBQUMsTUFBTSxHQUFHLE9BQU8sQ0FBQyxNQUFNLENBQUE7UUFDckMsQ0FBQztRQUVELE9BQU8sTUFBTSxJQUFJLENBQUMsYUFBYSxDQUFDLEdBQUcsQ0FBQyxPQUFPLEVBQUUsV0FBVyxDQUFDLENBQUE7SUFDM0QsQ0FBQztDQUNGIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IEJyb3dzZXIgZnJvbSBcIi4vYnJvd3Nlci5qc1wiXG5pbXBvcnQgQnJvd3NlckNvbW1hbmRSdW5uZXIgZnJvbSBcIi4vYnJvd3Nlci1jb21tYW5kLXJ1bm5lci5qc1wiXG5pbXBvcnQgQnJvd3NlclJlZ2lzdHJ5IGZyb20gXCIuL2Jyb3dzZXItcmVnaXN0cnkuanNcIlxuaW1wb3J0IHtXZWJTb2NrZXRTZXJ2ZXJ9IGZyb20gXCJ3c1wiXG5cbi8qKiBMb25nLXJ1bm5pbmcgYnJvd3NlciBkYWVtb24gZXhwb3NpbmcgYnJvd3NlciBjb21tYW5kcyBvdmVyIFdlYlNvY2tldC4gKi9cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIEJyb3dzZXJQcm9jZXNzIHtcbiAgLyoqXG4gICAqIEBwYXJhbSB7b2JqZWN0fSBhcmdzXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBhcmdzLm5hbWVcbiAgICogQHBhcmFtIHtCcm93c2VyfSBbYXJncy5icm93c2VyXVxuICAgKiBAcGFyYW0ge1JlY29yZDxzdHJpbmcsIGFueT59IFthcmdzLmJyb3dzZXJBcmdzXVxuICAgKiBAcGFyYW0ge3N0cmluZ30gW2FyZ3MuYmFzZVVybF1cbiAgICogQHBhcmFtIHtib29sZWFufSBbYXJncy5kZWJ1Z11cbiAgICogQHBhcmFtIHtudW1iZXJ9IFthcmdzLnBvcnRdXG4gICAqL1xuICBjb25zdHJ1Y3Rvcih7bmFtZSwgYnJvd3NlciwgYnJvd3NlckFyZ3MgPSB7fSwgYmFzZVVybCwgZGVidWcgPSBmYWxzZSwgcG9ydCA9IDB9KSB7XG4gICAgdGhpcy5uYW1lID0gbmFtZVxuICAgIHRoaXMuYnJvd3NlciA9IGJyb3dzZXIgPz8gbmV3IEJyb3dzZXIoe2RlYnVnLCAuLi5icm93c2VyQXJnc30pXG4gICAgdGhpcy5iYXNlVXJsID0gYmFzZVVybFxuICAgIHRoaXMuZGVidWcgPSBkZWJ1Z1xuICAgIHRoaXMucmVxdWVzdFJ1bm5lciA9IG5ldyBCcm93c2VyQ29tbWFuZFJ1bm5lcih7YnJvd3NlcjogdGhpcy5icm93c2VyfSlcbiAgICB0aGlzLnJlcXVlc3RDb3VudCA9IDBcbiAgICB0aGlzLnBvcnQgPSBwb3J0XG4gIH1cblxuICAvKiogQHJldHVybnMge1Byb21pc2U8dm9pZD59ICovXG4gIGFzeW5jIHN0YXJ0KCkge1xuICAgIGlmICghdGhpcy5uYW1lKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoXCJCcm93c2VyIHByb2Nlc3MgcmVxdWlyZXMgYSBuYW1lXCIpXG4gICAgfVxuXG4gICAgaWYgKHRoaXMuYmFzZVVybCkge1xuICAgICAgdGhpcy5icm93c2VyLmdldERyaXZlckFkYXB0ZXIoKS5zZXRCYXNlVXJsKHRoaXMuYmFzZVVybClcbiAgICB9XG5cbiAgICBhd2FpdCB0aGlzLmJyb3dzZXIuZ2V0RHJpdmVyQWRhcHRlcigpLnN0YXJ0KClcbiAgICBhd2FpdCB0aGlzLmJyb3dzZXIuc2V0VGltZW91dHMoMTAwMDApXG5cbiAgICB0aGlzLndzcyA9IG5ldyBXZWJTb2NrZXRTZXJ2ZXIoe3BvcnQ6IHRoaXMucG9ydH0pXG4gICAgYXdhaXQgbmV3IFByb21pc2UoKHJlc29sdmUpID0+IHtcbiAgICAgIHRoaXMud3NzLm9uY2UoXCJsaXN0ZW5pbmdcIiwgcmVzb2x2ZSlcbiAgICB9KVxuXG4gICAgY29uc3QgYWRkcmVzcyA9IHRoaXMud3NzLmFkZHJlc3MoKVxuXG4gICAgaWYgKCFhZGRyZXNzIHx8IHR5cGVvZiBhZGRyZXNzID09PSBcInN0cmluZ1wiKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoXCJDb3VsZCBub3QgcmVzb2x2ZSBicm93c2VyIHByb2Nlc3MgcG9ydFwiKVxuICAgIH1cblxuICAgIHRoaXMucG9ydCA9IGFkZHJlc3MucG9ydFxuICAgIHRoaXMud3NzLm9uKFwiY29ubmVjdGlvblwiLCB0aGlzLm9uQ29ubmVjdGlvbilcblxuICAgIGF3YWl0IEJyb3dzZXJSZWdpc3RyeS5yZWdpc3Rlcih7XG4gICAgICBiYXNlVXJsOiB0aGlzLmJhc2VVcmwsXG4gICAgICBuYW1lOiB0aGlzLm5hbWUsXG4gICAgICBwaWQ6IHByb2Nlc3MucGlkLFxuICAgICAgcG9ydDogdGhpcy5wb3J0LFxuICAgICAgc3RhcnRlZEF0OiBuZXcgRGF0ZSgpLnRvSVNPU3RyaW5nKClcbiAgICB9KVxuXG4gICAgY29uc3Qgc3RvcCA9IGFzeW5jICgpID0+IHtcbiAgICAgIGF3YWl0IHRoaXMuc3RvcCgpXG4gICAgICBwcm9jZXNzLmV4aXQoMClcbiAgICB9XG5cbiAgICBwcm9jZXNzLm9uY2UoXCJTSUdJTlRcIiwgc3RvcClcbiAgICBwcm9jZXNzLm9uY2UoXCJTSUdURVJNXCIsIHN0b3ApXG4gIH1cblxuICAvKiogQHJldHVybnMge1Byb21pc2U8dm9pZD59ICovXG4gIGFzeW5jIHN0b3AoKSB7XG4gICAgaWYgKHRoaXMuc3RvcHBlZCkge1xuICAgICAgcmV0dXJuXG4gICAgfVxuXG4gICAgdGhpcy5zdG9wcGVkID0gdHJ1ZVxuICAgIGF3YWl0IEJyb3dzZXJSZWdpc3RyeS51bnJlZ2lzdGVyKHRoaXMubmFtZSlcblxuICAgIGlmICh0aGlzLndzcykge1xuICAgICAgYXdhaXQgbmV3IFByb21pc2UoKHJlc29sdmUsIHJlamVjdCkgPT4ge1xuICAgICAgICB0aGlzLndzcy5jbG9zZSgoZXJyb3IpID0+IHtcbiAgICAgICAgICBpZiAoZXJyb3IpIHtcbiAgICAgICAgICAgIHJlamVjdChlcnJvcilcbiAgICAgICAgICB9IGVsc2Uge1xuICAgICAgICAgICAgcmVzb2x2ZSh1bmRlZmluZWQpXG4gICAgICAgICAgfVxuICAgICAgICB9KVxuICAgICAgfSlcbiAgICB9XG5cbiAgICBhd2FpdCB0aGlzLmJyb3dzZXIuc3RvcERyaXZlcigpXG4gIH1cblxuICAvKipcbiAgICogQHBhcmFtIHtpbXBvcnQoXCJ3c1wiKS5XZWJTb2NrZXR9IHdzXG4gICAqIEByZXR1cm5zIHt2b2lkfVxuICAgKi9cbiAgb25Db25uZWN0aW9uID0gKHdzKSA9PiB7XG4gICAgd3Mub24oXCJtZXNzYWdlXCIsIGFzeW5jIChyYXdEYXRhKSA9PiB7XG4gICAgICBjb25zdCByZXF1ZXN0SWQgPSBgJHtEYXRlLm5vdygpfS0ke3RoaXMucmVxdWVzdENvdW50Kyt9YFxuXG4gICAgICB0cnkge1xuICAgICAgICBjb25zdCBwYXlsb2FkID0gSlNPTi5wYXJzZShyYXdEYXRhLnRvU3RyaW5nKCkpXG4gICAgICAgIGNvbnN0IHJlc3VsdCA9IGF3YWl0IHRoaXMuaGFuZGxlUGF5bG9hZChwYXlsb2FkKVxuXG4gICAgICAgIHdzLnNlbmQoSlNPTi5zdHJpbmdpZnkoe29rOiB0cnVlLCByZXF1ZXN0SWQsIHJlc3VsdCwgdHlwZTogXCJicm93c2VyLWNvbW1hbmQtcmVzdWx0XCJ9KSlcbiAgICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICAgIHdzLnNlbmQoSlNPTi5zdHJpbmdpZnkoe1xuICAgICAgICAgIGVycm9yOiBlcnJvciBpbnN0YW5jZW9mIEVycm9yID8gZXJyb3IubWVzc2FnZSA6IFN0cmluZyhlcnJvciksXG4gICAgICAgICAgb2s6IGZhbHNlLFxuICAgICAgICAgIHJlcXVlc3RJZCxcbiAgICAgICAgICB0eXBlOiBcImJyb3dzZXItY29tbWFuZC1yZXN1bHRcIlxuICAgICAgICB9KSlcbiAgICAgIH1cbiAgICB9KVxuICB9XG5cbiAgLyoqXG4gICAqIEBwYXJhbSB7UmVjb3JkPHN0cmluZywgYW55Pn0gcGF5bG9hZFxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTxhbnk+fVxuICAgKi9cbiAgYXN5bmMgaGFuZGxlUGF5bG9hZChwYXlsb2FkKSB7XG4gICAgaWYgKHBheWxvYWQudHlwZSAhPT0gXCJicm93c2VyLWNvbW1hbmRcIikge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKGBVbmtub3duIHBheWxvYWQgdHlwZTogJHtwYXlsb2FkLnR5cGV9YClcbiAgICB9XG5cbiAgICBjb25zdCBjb21tYW5kID0gcGF5bG9hZC5jb21tYW5kXG4gICAgY29uc3QgY29tbWFuZEFyZ3MgPSBwYXlsb2FkLmFyZ3MgPyB7Li4ucGF5bG9hZC5hcmdzfSA6IHt9XG5cbiAgICBpZiAocGF5bG9hZC51cmwgJiYgIWNvbW1hbmRBcmdzLnVybCkge1xuICAgICAgY29tbWFuZEFyZ3MudXJsID0gcGF5bG9hZC51cmxcbiAgICB9XG5cbiAgICBpZiAocGF5bG9hZC5wYXRoICYmICFjb21tYW5kQXJncy5wYXRoKSB7XG4gICAgICBjb21tYW5kQXJncy5wYXRoID0gcGF5bG9hZC5wYXRoXG4gICAgfVxuXG4gICAgaWYgKHBheWxvYWQuc2VsZWN0b3IgJiYgIWNvbW1hbmRBcmdzLnNlbGVjdG9yKSB7XG4gICAgICBjb21tYW5kQXJncy5zZWxlY3RvciA9IHBheWxvYWQuc2VsZWN0b3JcbiAgICB9XG5cbiAgICBpZiAocGF5bG9hZC50ZXN0SUQgJiYgIWNvbW1hbmRBcmdzLnRlc3RJRCkge1xuICAgICAgY29tbWFuZEFyZ3MudGVzdElEID0gcGF5bG9hZC50ZXN0SURcbiAgICB9XG5cbiAgICByZXR1cm4gYXdhaXQgdGhpcy5yZXF1ZXN0UnVubmVyLnJ1bihjb21tYW5kLCBjb21tYW5kQXJncylcbiAgfVxufVxuIl19

package/build/browser-registry.d.ts

@@ -0,0 +1,34 @@
+/** Browser process registry. */
+export default class BrowserRegistry {
+    /** @returns {string} */
+    static getRegistryPath(): string;
+    /** @returns {Promise<Array<Record<string, any>>>} */
+    static list(): Promise<Array<Record<string, any>>>;
+    /**
+     * @param {Record<string, any>} entry
+     * @returns {Promise<void>}
+     */
+    static register(entry: Record<string, any>): Promise<void>;
+    /**
+     * @param {string} name
+     * @returns {Promise<void>}
+     */
+    static unregister(name: string): Promise<void>;
+    /**
+     * @param {string} [name]
+     * @returns {Promise<Record<string, any>>}
+     */
+    static resolve(name?: string): Promise<Record<string, any>>;
+    /**
+     * @param {number} pid
+     * @returns {boolean}
+     */
+    static isProcessAlive(pid: number): boolean;
+    /** @returns {Promise<Array<Record<string, any>>>} */
+    static _readRegistry(): Promise<Array<Record<string, any>>>;
+    /**
+     * @param {Array<Record<string, any>>} entries
+     * @returns {Promise<void>}
+     */
+    static _writeRegistry(entries: Array<Record<string, any>>): Promise<void>;
+}

package/build/browser-registry.js

@@ -0,0 +1,110 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+const registryPath = path.join(os.tmpdir(), "system-testing-browser-registry.json");
+/** Browser process registry. */
+export default class BrowserRegistry {
+    /** @returns {string} */
+    static getRegistryPath() {
+        return registryPath;
+    }
+    /** @returns {Promise<Array<Record<string, any>>>} */
+    static async list() {
+        const entries = await this._readRegistry();
+        const aliveEntries = [];
+        let dirty = false;
+        for (const entry of entries) {
+            if (this.isProcessAlive(entry.pid)) {
+                aliveEntries.push(entry);
+            }
+            else {
+                dirty = true;
+            }
+        }
+        if (dirty) {
+            await this._writeRegistry(aliveEntries);
+        }
+        return aliveEntries;
+    }
+    /**
+     * @param {Record<string, any>} entry
+     * @returns {Promise<void>}
+     */
+    static async register(entry) {
+        const entries = await this.list();
+        const filteredEntries = entries.filter((existingEntry) => existingEntry.name !== entry.name);
+        filteredEntries.push(entry);
+        await this._writeRegistry(filteredEntries);
+    }
+    /**
+     * @param {string} name
+     * @returns {Promise<void>}
+     */
+    static async unregister(name) {
+        const entries = await this.list();
+        const filteredEntries = entries.filter((entry) => entry.name !== name);
+        await this._writeRegistry(filteredEntries);
+    }
+    /**
+     * @param {string} [name]
+     * @returns {Promise<Record<string, any>>}
+     */
+    static async resolve(name) {
+        const entries = await this.list();
+        if (name) {
+            const entry = entries.find((candidate) => candidate.name === name);
+            if (!entry) {
+                throw new Error(`No running browser process found with name: ${name}`);
+            }
+            return entry;
+        }
+        if (entries.length === 1) {
+            return entries[0];
+        }
+        if (entries.length === 0) {
+            throw new Error("No running browser processes found");
+        }
+        throw new Error(`Multiple browser processes are running (${entries.length}); pass --name`);
+    }
+    /**
+     * @param {number} pid
+     * @returns {boolean}
+     */
+    static isProcessAlive(pid) {
+        if (!pid || typeof pid !== "number") {
+            return false;
+        }
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** @returns {Promise<Array<Record<string, any>>>} */
+    static async _readRegistry() {
+        try {
+            const fileContent = await fs.readFile(this.getRegistryPath(), "utf8");
+            const parsed = JSON.parse(fileContent);
+            if (!Array.isArray(parsed)) {
+                return [];
+            }
+            return parsed;
+        }
+        catch (error) {
+            if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+                return [];
+            }
+            throw error;
+        }
+    }
+    /**
+     * @param {Array<Record<string, any>>} entries
+     * @returns {Promise<void>}
+     */
+    static async _writeRegistry(entries) {
+        await fs.writeFile(this.getRegistryPath(), JSON.stringify(entries, null, 2));
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJvd3Nlci1yZWdpc3RyeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9icm93c2VyLXJlZ2lzdHJ5LmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxNQUFNLGtCQUFrQixDQUFBO0FBQ2pDLE9BQU8sRUFBRSxNQUFNLFNBQVMsQ0FBQTtBQUN4QixPQUFPLElBQUksTUFBTSxXQUFXLENBQUE7QUFFNUIsTUFBTSxZQUFZLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsTUFBTSxFQUFFLEVBQUUsc0NBQXNDLENBQUMsQ0FBQTtBQUVuRixnQ0FBZ0M7QUFDaEMsTUFBTSxDQUFDLE9BQU8sT0FBTyxlQUFlO0lBQ2xDLHdCQUF3QjtJQUN4QixNQUFNLENBQUMsZUFBZTtRQUNwQixPQUFPLFlBQVksQ0FBQTtJQUNyQixDQUFDO0lBRUQscURBQXFEO0lBQ3JELE1BQU0sQ0FBQyxLQUFLLENBQUMsSUFBSTtRQUNmLE1BQU0sT0FBTyxHQUFHLE1BQU0sSUFBSSxDQUFDLGFBQWEsRUFBRSxDQUFBO1FBQzFDLE1BQU0sWUFBWSxHQUFHLEVBQUUsQ0FBQTtRQUN2QixJQUFJLEtBQUssR0FBRyxLQUFLLENBQUE7UUFFakIsS0FBSyxNQUFNLEtBQUssSUFBSSxPQUFPLEVBQUUsQ0FBQztZQUM1QixJQUFJLElBQUksQ0FBQyxjQUFjLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7Z0JBQ25DLFlBQVksQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUE7WUFDMUIsQ0FBQztpQkFBTSxDQUFDO2dCQUNOLEtBQUssR0FBRyxJQUFJLENBQUE7WUFDZCxDQUFDO1FBQ0gsQ0FBQztRQUVELElBQUksS0FBSyxFQUFFLENBQUM7WUFDVixNQUFNLElBQUksQ0FBQyxjQUFjLENBQUMsWUFBWSxDQUFDLENBQUE7UUFDekMsQ0FBQztRQUVELE9BQU8sWUFBWSxDQUFBO0lBQ3JCLENBQUM7SUFFRDs7O09BR0c7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QUFDO1lBQ2YsSUFBSSxLQUFLLFlBQVksS0FBSyxJQUFJLE1BQU0sSUFBSSxLQUFLLElBQUksS0FBSyxDQUFDLElBQUksS0FBSyxRQUFRLEVBQUUsQ0FBQztnQkFDekUsT0FBTyxFQUFFLENBQUE7WUFDWCxDQUFDO1lBRUQsTUFBTSxLQUFLLENBQUE7UUFDYixDQUFDO0lBQ0gsQ0FBQztJQUVEOzs7T0FHRztJQUNILE1BQU0sQ0FBQyxLQUFLLENBQUMsY0FBYyxDQUFDLE9BQU87UUFDakMsTUFBTSxFQUFFLENBQUMsU0FBUyxDQUFDLElBQUksQ0FBQyxlQUFlLEVBQUUsRUFBRSxJQUFJLENBQUMsU0FBUyxDQUFDLE9BQU8sRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQTtJQUM5RSxDQUFDO0NBQ0YiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgZnMgZnJvbSBcIm5vZGU6ZnMvcHJvbWlzZXNcIlxuaW1wb3J0IG9zIGZyb20gXCJub2RlOm9zXCJcbmltcG9ydCBwYXRoIGZyb20gXCJub2RlOnBhdGhcIlxuXG5jb25zdCByZWdpc3RyeVBhdGggPSBwYXRoLmpvaW4ob3MudG1wZGlyKCksIFwic3lzdGVtLXRlc3RpbmctYnJvd3Nlci1yZWdpc3RyeS5qc29uXCIpXG5cbi8qKiBCcm93c2VyIHByb2Nlc3MgcmVnaXN0cnkuICovXG5leHBvcnQgZGVmYXVsdCBjbGFzcyBCcm93c2VyUmVnaXN0cnkge1xuICAvKiogQHJldHVybnMge3N0cmluZ30gKi9cbiAgc3RhdGljIGdldFJlZ2lzdHJ5UGF0aCgpIHtcbiAgICByZXR1cm4gcmVnaXN0cnlQYXRoXG4gIH1cblxuICAvKiogQHJldHVybnMge1Byb21pc2U8QXJyYXk8UmVjb3JkPHN0cmluZywgYW55Pj4+fSAqL1xuICBzdGF0aWMgYXN5bmMgbGlzdCgpIHtcbiAgICBjb25zdCBlbnRyaWVzID0gYXdhaXQgdGhpcy5fcmVhZFJlZ2lzdHJ5KClcbiAgICBjb25zdCBhbGl2ZUVudHJpZXMgPSBbXVxuICAgIGxldCBkaXJ0eSA9IGZhbHNlXG5cbiAgICBmb3IgKGNvbnN0IGVudHJ5IG9mIGVudHJpZXMpIHtcbiAgICAgIGlmICh0aGlzLmlzUHJvY2Vzc0FsaXZlKGVudHJ5LnBpZCkpIHtcbiAgICAgICAgYWxpdmVFbnRyaWVzLnB1c2goZW50cnkpXG4gICAgICB9IGVsc2Uge1xuICAgICAgICBkaXJ0eSA9IHRydWVcbiAgICAgIH1cbiAgICB9XG5cbiAgICBpZiAoZGlydHkpIHtcbiAgICAgIGF3YWl0IHRoaXMuX3dyaXRlUmVnaXN0cnkoYWxpdmVFbnRyaWVzKVxuICAgIH1cblxuICAgIHJldHVybiBhbGl2ZUVudHJpZXNcbiAgfVxuXG4gIC8qKlxuICAgKiBAcGFyYW0ge1JlY29yZDxzdHJpbmcsIGFueT59IGVudHJ5XG4gICAqIEByZXR1cm5zIHtQcm9taXNlPHZvaWQ+fVxuICAgKi9cbiAgc3RhdGljIGFzeW5jIHJlZ2lzdGVyKGVudHJ5KSB7XG4gICAgY29uc3QgZW50cmllcyA9IGF3YWl0IHRoaXMubGlzdCgpXG4gICAgY29uc3QgZmlsdGVyZWRFbnRyaWVzID0gZW50cmllcy5maWx0ZXIoKGV4aXN0aW5nRW50cnkpID0+IGV4aXN0aW5nRW50cnkubmFtZSAhPT0gZW50cnkubmFtZSlcblxuICAgIGZpbHRlcmVkRW50cmllcy5wdXNoKGVudHJ5KVxuICAgIGF3YWl0IHRoaXMuX3dyaXRlUmVnaXN0cnkoZmlsdGVyZWRFbnRyaWVzKVxuICB9XG5cbiAgLyoqXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBuYW1lXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPHZvaWQ+fVxuICAgKi9cbiAgc3RhdGljIGFzeW5jIHVucmVnaXN0ZXIobmFtZSkge1xuICAgIGNvbnN0IGVudHJpZXMgPSBhd2FpdCB0aGlzLmxpc3QoKVxuICAgIGNvbnN0IGZpbHRlcmVkRW50cmllcyA9IGVudHJpZXMuZmlsdGVyKChlbnRyeSkgPT4gZW50cnkubmFtZSAhPT0gbmFtZSlcblxuICAgIGF3YWl0IHRoaXMuX3dyaXRlUmVnaXN0cnkoZmlsdGVyZWRFbnRyaWVzKVxuICB9XG5cbiAgLyoqXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBbbmFtZV1cbiAgICogQHJldHVybnMge1Byb21pc2U8UmVjb3JkPHN0cmluZywgYW55Pj59XG4gICAqL1xuICBzdGF0aWMgYXN5bmMgcmVzb2x2ZShuYW1lKSB7XG4gICAgY29uc3QgZW50cmllcyA9IGF3YWl0IHRoaXMubGlzdCgpXG5cbiAgICBpZiAobmFtZSkge1xuICAgICAgY29uc3QgZW50cnkgPSBlbnRyaWVzLmZpbmQoKGNhbmRpZGF0ZSkgPT4gY2FuZGlkYXRlLm5hbWUgPT09IG5hbWUpXG5cbiAgICAgIGlmICghZW50cnkpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKGBObyBydW5uaW5nIGJyb3dzZXIgcHJvY2VzcyBmb3VuZCB3aXRoIG5hbWU6ICR7bmFtZX1gKVxuICAgICAgfVxuXG4gICAgICByZXR1cm4gZW50cnlcbiAgICB9XG5cbiAgICBpZiAoZW50cmllcy5sZW5ndGggPT09IDEpIHtcbiAgICAgIHJldHVybiBlbnRyaWVzWzBdXG4gICAgfVxuXG4gICAgaWYgKGVudHJpZXMubGVuZ3RoID09PSAwKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoXCJObyBydW5uaW5nIGJyb3dzZXIgcHJvY2Vzc2VzIGZvdW5kXCIpXG4gICAgfVxuXG4gICAgdGhyb3cgbmV3IEVycm9yKGBNdWx0aXBsZSBicm93c2VyIHByb2Nlc3NlcyBhcmUgcnVubmluZyAoJHtlbnRyaWVzLmxlbmd0aH0pOyBwYXNzIC0tbmFtZWApXG4gIH1cblxuICAvKipcbiAgICogQHBhcmFtIHtudW1iZXJ9IHBpZFxuICAgKiBAcmV0dXJucyB7Ym9vbGVhbn1cbiAgICovXG4gIHN0YXRpYyBpc1Byb2Nlc3NBbGl2ZShwaWQpIHtcbiAgICBpZiAoIXBpZCB8fCB0eXBlb2YgcGlkICE9PSBcIm51bWJlclwiKSB7XG4gICAgICByZXR1cm4gZmFsc2VcbiAgICB9XG5cbiAgICB0cnkge1xuICAgICAgcHJvY2Vzcy5raWxsKHBpZCwgMClcbiAgICAgIHJldHVybiB0cnVlXG4gICAgfSBjYXRjaCB7XG4gICAgICByZXR1cm4gZmFsc2VcbiAgICB9XG4gIH1cblxuICAvKiogQHJldHVybnMge1Byb21pc2U8QXJyYXk8UmVjb3JkPHN0cmluZywgYW55Pj4+fSAqL1xuICBzdGF0aWMgYXN5bmMgX3JlYWRSZWdpc3RyeSgpIHtcbiAgICB0cnkge1xuICAgICAgY29uc3QgZmlsZUNvbnRlbnQgPSBhd2FpdCBmcy5yZWFkRmlsZSh0aGlzLmdldFJlZ2lzdHJ5UGF0aCgpLCBcInV0ZjhcIilcbiAgICAgIGNvbnN0IHBhcnNlZCA9IEpTT04ucGFyc2UoZmlsZUNvbnRlbnQpXG5cbiAgICAgIGlmICghQXJyYXkuaXNBcnJheShwYXJzZWQpKSB7XG4gICAgICAgIHJldHVybiBbXVxuICAgICAgfVxuXG4gICAgICByZXR1cm4gcGFyc2VkXG4gICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgIGlmIChlcnJvciBpbnN0YW5jZW9mIEVycm9yICYmIFwiY29kZVwiIGluIGVycm9yICYmIGVycm9yLmNvZGUgPT09IFwiRU5PRU5UXCIpIHtcbiAgICAgICAgcmV0dXJuIFtdXG4gICAgICB9XG5cbiAgICAgIHRocm93IGVycm9yXG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIEBwYXJhbSB7QXJyYXk8UmVjb3JkPHN0cmluZywgYW55Pj59IGVudHJpZXNcbiAgICogQHJldHVybnMge1Byb21pc2U8dm9pZD59XG4gICAqL1xuICBzdGF0aWMgYXN5bmMgX3dyaXRlUmVnaXN0cnkoZW50cmllcykge1xuICAgIGF3YWl0IGZzLndyaXRlRmlsZSh0aGlzLmdldFJlZ2lzdHJ5UGF0aCgpLCBKU09OLnN0cmluZ2lmeShlbnRyaWVzLCBudWxsLCAyKSlcbiAgfVxufVxuIl19

package/build/browser.d.ts

@@ -0,0 +1,222 @@
+/**
+ * @typedef {object} BrowserArgs
+ * @property {boolean} [debug] Enable debug logging.
+ * @property {BrowserDriverConfig} [driver] Driver configuration.
+ * @property {import("./system-test-communicator.js").default} [communicator] Optional command communicator for helper-driven navigation.
+ * @property {string} [screenshotsPath] Directory used for saved screenshots and browser artifacts.
+ */
+/**
+ * @typedef {object} BrowserDriverConfig
+ * @property {"selenium"|"appium"} [type] Driver implementation to use.
+ * @property {Record<string, any>} [options] Driver-specific options.
+ */
+/** Generic browser session wrapper around the configured driver. */
+export default class Browser {
+    /** @param {BrowserArgs} [args] */
+    constructor({ debug, driver, communicator, screenshotsPath, ...restArgs }?: BrowserArgs);
+    /** @type {import("selenium-webdriver").WebDriver | undefined} */
+    driver: import("selenium-webdriver").WebDriver | undefined;
+    /** @type {import("./drivers/webdriver-driver.js").default | undefined} */
+    driverAdapter: import("./drivers/webdriver-driver.js").default | undefined;
+    _debug: boolean;
+    /** @type {BrowserDriverConfig | undefined} */
+    _driverConfig: BrowserDriverConfig | undefined;
+    /** @type {Error | undefined} */
+    _httpServerError: Error | undefined;
+    _screenshotsPath: string;
+    communicator: import("./system-test-communicator.js").default;
+    /**
+     * @param {BrowserDriverConfig} [driverConfig]
+     * @returns {import("./drivers/webdriver-driver.js").default}
+     */
+    createDriver(driverConfig?: BrowserDriverConfig): import("./drivers/webdriver-driver.js").default;
+    /**
+     * @param {import("./system-test-communicator.js").default | undefined} communicator
+     * @returns {void}
+     */
+    setCommunicator(communicator: import("./system-test-communicator.js").default | undefined): void;
+    /** @returns {boolean} */
+    communicatorExists(): boolean;
+    /**
+     * @param {string} baseSelector
+     * @returns {void}
+     */
+    setBaseSelector(baseSelector: string): void;
+    _baseSelector: string;
+    /** @returns {string | undefined} */
+    getBaseSelector(): string | undefined;
+    /**
+     * @param {string} selector
+     * @returns {string}
+     */
+    getSelector(selector: string): string;
+    /**
+     * @param {...any} args
+     * @returns {void}
+     */
+    debugError(...args: any[]): void;
+    /**
+     * @param {...any} args
+     * @returns {void}
+     */
+    debugLog(...args: any[]): void;
+    /** @returns {void} */
+    throwIfHttpServerError(): void;
+    /**
+     * @param {Error} error
+     * @returns {void}
+     */
+    onHttpServerError: (error: Error) => void;
+    /** @returns {import("selenium-webdriver").WebDriver} */
+    getDriver(): import("selenium-webdriver").WebDriver;
+    /** @returns {import("./drivers/webdriver-driver.js").default} */
+    getDriverAdapter(): import("./drivers/webdriver-driver.js").default;
+    /** @returns {number} */
+    getTimeouts(): number;
+    /** @returns {Promise<void>} */
+    restoreTimeouts(): Promise<void>;
+    /**
+     * @param {number} newTimeout
+     * @returns {Promise<void>}
+     */
+    driverSetTimeouts(newTimeout: number): Promise<void>;
+    /**
+     * @param {number} newTimeout
+     * @returns {Promise<void>}
+     */
+    setTimeouts(newTimeout: number): Promise<void>;
+    /** @returns {Promise<string[]>} */
+    getBrowserLogs(): Promise<string[]>;
+    /** @returns {Promise<string>} */
+    getCurrentUrl(): Promise<string>;
+    /**
+     * @param {string} selector
+     * @param {import("./system-test.js").FindArgs} [args]
+     * @returns {Promise<import("selenium-webdriver").WebElement[]>}
+     */
+    all(selector: string, args?: import("./system-test.js").FindArgs): Promise<import("selenium-webdriver").WebElement[]>;
+    /**
+     * @param {string} selector
+     * @param {import("./system-test.js").FindArgs} [args]
+     * @returns {Promise<import("selenium-webdriver").WebElement>}
+     */
+    find(selector: string, args?: import("./system-test.js").FindArgs): Promise<import("selenium-webdriver").WebElement>;
+    /**
+     * @param {string} testID
+     * @param {import("./system-test.js").FindArgs} [args]
+     * @returns {Promise<import("selenium-webdriver").WebElement>}
+     */
+    findByTestID(testID: string, args?: import("./system-test.js").FindArgs): Promise<import("selenium-webdriver").WebElement>;
+    /**
+     * @param {string} selector
+     * @param {import("./system-test.js").FindArgs} [args]
+     * @returns {Promise<import("selenium-webdriver").WebElement>}
+     */
+    findNoWait(selector: string, args?: import("./system-test.js").FindArgs): Promise<import("selenium-webdriver").WebElement>;
+    /**
+     * @param {string | import("selenium-webdriver").WebElement} elementOrIdentifier
+     * @param {import("./system-test.js").FindArgs} [args]
+     * @returns {Promise<void>}
+     */
+    click(elementOrIdentifier: string | import("selenium-webdriver").WebElement, args?: import("./system-test.js").FindArgs): Promise<void>;
+    /**
+     * @param {import("selenium-webdriver").WebElement|string|{selector: string} & import("./system-test.js").FindArgs} elementOrIdentifier
+     * @param {string} methodName
+     * @param {...any} args
+     * @returns {Promise<any>}
+     */
+    interact(elementOrIdentifier: import("selenium-webdriver").WebElement | string | ({
+        selector: string;
+    } & import("./system-test.js").FindArgs), methodName: string, ...args: any[]): Promise<any>;
+    /**
+     * @param {string} selector
+     * @param {import("./system-test.js").WaitForNoSelectorArgs} [args]
+     * @returns {Promise<void>}
+     */
+    waitForNoSelector(selector: string, args?: import("./system-test.js").WaitForNoSelectorArgs): Promise<void>;
+    /**
+     * @param {string} selector
+     * @param {import("./system-test.js").FindArgs} [args]
+     * @returns {Promise<void>}
+     */
+    expectNoElement(selector: string, args?: import("./system-test.js").FindArgs): Promise<void>;
+    /** @returns {Promise<string>} */
+    getHTML(): Promise<string>;
+    /**
+     * @param {string} path
+     * @returns {Promise<void>}
+     */
+    driverVisit(path: string): Promise<void>;
+    /**
+     * @param {string} type
+     * @param {string} path
+     * @returns {Promise<void>}
+     */
+    sendBrowserCommand(type: string, path: string): Promise<void>;
+    /**
+     * Visits a path using the injected browser helper when available, otherwise navigates directly with the driver.
+     * @param {string} path
+     * @returns {Promise<void>}
+     */
+    visit(path: string): Promise<void>;
+    /**
+     * Dismisses to a path via the injected browser helper when available, otherwise navigates directly with the driver.
+     * @param {string} path
+     * @returns {Promise<void>}
+     */
+    dismissTo(path: string): Promise<void>;
+    /**
+     * Formats browser logs for console output and truncates overly long output.
+     * @param {string[]} logs
+     * @param {number} [maxLines]
+     * @returns {string[]}
+     */
+    formatBrowserLogsForConsole(logs: string[], maxLines?: number): string[];
+    /**
+     * @param {string[]} logs
+     * @returns {void}
+     */
+    printBrowserLogsForFailure(logs: string[]): void;
+    /**
+     * Takes a screenshot, writes HTML/browser logs to disk, and returns the collected artifacts.
+     * @returns {Promise<{currentUrl: string, html: string, htmlPath: string, logs: string[], logsPath: string, screenshotPath: string}>}
+     */
+    takeScreenshot(): Promise<{
+        currentUrl: string;
+        html: string;
+        htmlPath: string;
+        logs: string[];
+        logsPath: string;
+        screenshotPath: string;
+    }>;
+    /** @returns {Promise<void>} */
+    stopDriver(): Promise<void>;
+}
+export type BrowserArgs = {
+    /**
+     * Enable debug logging.
+     */
+    debug?: boolean;
+    /**
+     * Driver configuration.
+     */
+    driver?: BrowserDriverConfig;
+    /**
+     * Optional command communicator for helper-driven navigation.
+     */
+    communicator?: import("./system-test-communicator.js").default;
+    /**
+     * Directory used for saved screenshots and browser artifacts.
+     */
+    screenshotsPath?: string;
+};
+export type BrowserDriverConfig = {
+    /**
+     * Driver implementation to use.
+     */
+    type?: "selenium" | "appium";
+    /**
+     * Driver-specific options.
+     */
+    options?: Record<string, any>;
+};