appium-cdp-driver 1.0.7 → 1.0.8

package/build/scripts/brave.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const appium_uiautomator2_driver_1 = require("appium-uiautomator2-driver");
+const appium_adb_1 = require("appium-adb");
+const adb_js_1 = require("../src/adb.js");
+const logger_js_1 = __importDefault(require("../src/logger.js"));
+const asyncbox_1 = require("asyncbox");
+const browserReady_js_1 = require("./browserReady.js");
+const START_APP_WAIT_DURATION = 60000;
+const brave = {
+    pkg: 'com.brave.browser',
+    activity: 'com.google.android.apps.chrome.Main',
+};
+const common = {
+    waitDuration: START_APP_WAIT_DURATION,
+    optionalIntentArguments: '-d www.appium.io',
+};
+function skipWelcomeBrave() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const adbPort = (0, adb_js_1.resolveAdbPort)();
+        const adb = yield appium_adb_1.ADB.createADB({ adbPort });
+        yield adb.adbExec(['shell', 'pm', 'clear', 'com.brave.browser']);
+        // Optional: suppress Chromium's first-run experience. Off by default because
+        // /data/local/tmp/chrome-command-line is shared with Chrome and chromedriver,
+        // which writes its own chromeOptions.args there — clobbering it would change
+        // an unrelated Chrome session on the same device. Set CDP_SUPPRESS_FIRST_RUN=1
+        // to opt in; without it the readiness pass dismisses onboarding instead.
+        if (process.env.CDP_SUPPRESS_FIRST_RUN === '1') {
+            yield adb.adbExec([
+                'shell',
+                "echo '_ --disable-fre --no-first-run' > /data/local/tmp/chrome-command-line",
+            ]);
+        }
+        const driver = new appium_uiautomator2_driver_1.AndroidUiautomator2Driver();
+        const caps = {
+            platformName: "Android",
+            "appium:automationName": "UiAutomator2",
+            "appium:adbPort": adbPort,
+            "appium:deviceName": "Android Device",
+            "appium:appPackage": "com.brave.browser",
+            "appium:appActivity": "com.google.android.apps.chrome.Main",
+        };
+        try {
+            yield driver.createSession(null, {
+                alwaysMatch: caps,
+                firstMatch: [{}],
+            });
+            const activity = yield driver.getCurrentActivity();
+            logger_js_1.default.info(`Activity is ${activity}`);
+            if (activity.includes('Welcome')) {
+                const findElementWithWaitForCondition = (strategy_1, selector_1, ...args_1) => __awaiter(this, [strategy_1, selector_1, ...args_1], void 0, function* (strategy, selector, timeout = 20000) {
+                    try {
+                        return yield (0, asyncbox_1.waitForCondition)(() => __awaiter(this, void 0, void 0, function* () {
+                            try {
+                                logger_js_1.default.info(`Attempting to find element (${strategy}: ${selector})`);
+                                const element = yield driver.findElement(strategy, selector);
+                                logger_js_1.default.info(`Successfully found element (${strategy}: ${selector})`);
+                                return element;
+                            }
+                            catch (error) {
+                                // Return false to continue waiting
+                                return false;
+                            }
+                        }), {
+                            waitMs: timeout,
+                            intervalMs: 1000,
+                        });
+                    }
+                    catch (error) {
+                        throw new Error(`Failed to find element (${strategy}: ${selector}) within ${timeout}ms timeout: ${error.message}`);
+                    }
+                });
+                const cancelButton = yield findElementWithWaitForCondition('id', 'android:id/button2');
+                logger_js_1.default.info(`Cancel button is ${JSON.stringify(cancelButton, null, 2)}`);
+                yield driver.click(cancelButton.ELEMENT);
+                try {
+                    yield findElementWithWaitForCondition('xpath', '//android.widget.TextView[@text="Allow Brave to send you notifications?"]');
+                    const allowButton = yield findElementWithWaitForCondition('id', 'com.android.permissioncontroller:id/permission_allow_button');
+                    yield driver.click(allowButton.ELEMENT);
+                }
+                catch (error) {
+                    logger_js_1.default.info(`Help make Brave better text not found, skipping`);
+                }
+                const laterButton = yield findElementWithWaitForCondition('id', 'com.brave.browser:id/btn_negative');
+                yield driver.click(laterButton.ELEMENT);
+                yield findElementWithWaitForCondition('xpath', '//android.widget.TextView[@text="Help make Brave better."]');
+                const continueButton = yield findElementWithWaitForCondition('id', 'com.brave.browser:id/btn_positive');
+                yield driver.click(continueButton.ELEMENT);
+            }
+        }
+        catch (error) {
+            logger_js_1.default.info(`walkthrough did not complete (${error.message}) — checking readiness anyway`);
+        }
+        finally {
+            yield (0, browserReady_js_1.finishSession)(driver, { adb, pkg: brave.pkg, component: `${brave.pkg}/${brave.activity}`, socket: 'chrome_devtools_remote' });
+        }
+    });
+}
+(() => __awaiter(void 0, void 0, void 0, function* () {
+    yield skipWelcomeBrave();
+    process.exit(0);
+}))();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJhdmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zY3JpcHRzL2JyYXZlLmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7OztBQUVBLDJFQUF1RTtBQUN2RSwyQ0FBaUM7QUFDakMsMENBQStDO0FBQy9DLGlFQUFtQztBQUNuQyx1Q0FBNEM7QUFDNUMsdURBQWtEO0FBRWxELE1BQU0sdUJBQXVCLEdBQUcsS0FBSyxDQUFDO0FBRXRDLE1BQU0sS0FBSyxHQUFHO0lBQ1osR0FBRyxFQUFFLG1CQUFtQjtJQUN4QixRQUFRLEVBQUUscUNBQXFDO0NBQ2hELENBQUM7QUFFRixNQUFNLE1BQU0sR0FBRztJQUNiLFlBQVksRUFBRSx1QkFBdUI7SUFDckMsdUJBQXVCLEVBQUUsa0JBQWtCO0NBQzVDLENBQUM7QUFFRixTQUFlLGdCQUFnQjs7UUFDN0IsTUFBTSxPQUFPLEdBQUcsSUFBQSx1QkFBYyxHQUFFLENBQUM7UUFDakMsTUFBTSxHQUFHLEdBQUcsTUFBTSxnQkFBRyxDQUFDLFNBQVMsQ0FBQyxFQUFFLE9BQU8sRUFBRSxDQUFDLENBQUM7UUFDN0MsTUFBTSxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUMsT0FBTyxFQUFFLElBQUksRUFBRSxPQUFPLEVBQUUsbUJBQW1CLENBQUMsQ0FBQyxDQUFDO1FBQ2pFLDZFQUE2RTtRQUM3RSw4RUFBOEU7UUFDOUUsNkVBQTZFO1FBQzdFLCtFQUErRTtRQUMvRSx5RUFBeUU7UUFDekUsSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLHNCQUFzQixLQUFLLEdBQUcsRUFBRSxDQUFDO1lBQy9DLE1BQU0sR0FBRyxDQUFDLE9BQU8sQ0FBQztnQkFDaEIsT0FBTztnQkFDUCw2RUFBNkU7YUFDOUUsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztRQUNELE1BQU0sTUFBTSxHQUFHLElBQUksc0RBQXlCLEVBQUUsQ0FBQztRQUMvQyxNQUFNLElBQUksR0FBRztZQUNYLFlBQVksRUFBRSxTQUFTO1lBQ3ZC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

package/build/scripts/browserReady.js

@@ -0,0 +1,302 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pickPageTargets = pickPageTargets;
+exports.browserPid = browserPid;
+exports.ensureBrowserReady = ensureBrowserReady;
+exports.clickSafely = clickSafely;
+exports.finishSession = finishSession;
+const node_fetch_1 = __importDefault(require("node-fetch"));
+const get_port_1 = __importDefault(require("get-port"));
+const logger_js_1 = __importDefault(require("../src/logger.js"));
+/**
+ * Shared readiness helper for the skip-welcome-* scripts.
+ *
+ * The scripts clear the browser profile and then click through first-run
+ * onboarding. That choreography is inherently racy: dialog order and content
+ * vary per launch, some stages are conditional, and an Android system dialog
+ * (e.g. "System UI isn't responding") can cover the screen entirely. When it
+ * goes wrong the browser never opens its devtools socket and session creation
+ * fails later with "socket hang up" or "Debug list is empty or invalid".
+ *
+ * Instead of requiring a fixed sequence, converge on the end state the driver
+ * actually needs: the browser's own devtools socket, with onboarding gone and a
+ * page open. Dismiss whatever happens to be on screen, relaunch when stuck, and
+ * report honestly if it never becomes ready.
+ */
+const ONBOARDING_ACTIVITY = /Welcome|FirstRun|firstrun|Onboarding|HelpIntro/i;
+// Safe to click on first-run and system dialogs, in priority order. "Wait" is
+// first so an ANR dialog is cleared before anything underneath it is touched.
+const COMMON_SELECTORS = [
+    '//android.widget.Button[@text="Wait"]',
+    '//android.widget.Button[@text="OK"]',
+    '//android.widget.Button[@text="Continue"]',
+    '//android.widget.Button[@text="Next"]',
+    '//android.widget.Button[@text="Skip"]',
+    '//android.widget.Button[@text="Not now"]',
+    '//android.widget.Button[@text="Allow"]',
+];
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Targets the driver can actually attach to. Workers also carry a
+ * webSocketDebuggerUrl, so filtering on that field alone would accept a browser
+ * that has no page open — the state this check exists to reject.
+ */
+function pickPageTargets(targets) {
+    return (Array.isArray(targets) ? targets : []).filter((t) => t && t.type === 'page' && t.webSocketDebuggerUrl);
+}
+/**
+ * Resolve the devtools socket name, or null if the browser has not opened it.
+ * WebView-based browsers expose webview_devtools_remote_<pid>; the bare prefix
+ * also matches other apps' WebViews, so scope it to this package's pid.
+ */
+function resolveSocket(adb, socket, pkg, pidScoped) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const unix = String(yield adb.adbExec(['shell', 'cat', '/proc/net/unix']));
+        if (!pidScoped) {
+            // Several browsers share a socket name (chrome, brave and edge all use
+            // chrome_devtools_remote). Abstract names are unique per owner, so seeing
+            // the name proves *someone* opened it, not that we did — verifyReady()
+            // confirms ownership before trusting it.
+            return unix.includes(socket) ? socket : null;
+        }
+        const pid = yield browserPid(adb, pkg);
+        if (!pid) {
+            return null;
+        }
+        const scoped = `${socket}_${pid}`;
+        return unix.includes(scoped) ? scoped : null;
+    });
+}
+/**
+ * First pid of the package. pidof returns a space-separated list when the app
+ * has several processes, and only the first is the browser process whose
+ * WebView socket we want.
+ */
+function browserPid(adb, pkg) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const output = String(yield adb.adbExec(['shell', 'pidof', pkg])).trim();
+        return output ? output.split(/\s+/)[0] : null;
+    });
+}
+function getJson(port, path) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const response = yield (0, node_fetch_1.default)(`http://localhost:${port}${path}`);
+        return response.json();
+    });
+}
+/**
+ * Confirm the devtools endpoint belongs to the browser we are setting up.
+ * Chrome for Android reports the owning package in /json/version, which
+ * disambiguates the shared chrome_devtools_remote name.
+ */
+function ownedByPackage(port, pkg) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const version = yield getJson(port, '/json/version');
+            const owner = version['Android-Package'];
+            if (!owner) {
+                return true; // endpoint does not report an owner; nothing to contradict
+            }
+            if (owner !== pkg) {
+                logger_js_1.default.info(`ensureBrowserReady: devtools socket belongs to ${owner}, not ${pkg}`);
+                return false;
+            }
+        }
+        catch (e) {
+            logger_js_1.default.info(`ensureBrowserReady: /json/version check failed: ${e.message}`);
+        }
+        return true;
+    });
+}
+/**
+ * Ask /json/list the way the driver does. The socket can be up while the
+ * browser has no page — that is the "Debug list is empty or invalid" failure —
+ * so an attachable *page* is the only meaningful proof of readiness. Workers
+ * also carry a webSocketDebuggerUrl and must not be mistaken for one.
+ */
+function verifyReady(adb_1, socketName_1, pkg_1) {
+    return __awaiter(this, arguments, void 0, function* (adb, socketName, pkg, timeoutMs = 5000, intervalMs = 500) {
+        const port = yield (0, get_port_1.default)();
+        try {
+            yield adb.adbExec(['forward', `tcp:${port}`, `localabstract:${socketName}`]);
+            if (!(yield ownedByPackage(port, pkg))) {
+                return false;
+            }
+            const deadline = Date.now() + timeoutMs;
+            for (;;) {
+                let pages = [];
+                let total = -1;
+                try {
+                    const targets = yield getJson(port, '/json/list');
+                    if (Array.isArray(targets)) {
+                        total = targets.length;
+                        pages = pickPageTargets(targets);
+                    }
+                }
+                catch (e) {
+                    logger_js_1.default.info(`ensureBrowserReady: /json/list check failed: ${e.message}`);
+                }
+                if (pages.length > 0) {
+                    logger_js_1.default.info(`ensureBrowserReady: ${pkg} has ${pages.length} page target(s) of ${total}`);
+                    return true;
+                }
+                if (Date.now() >= deadline) {
+                    logger_js_1.default.info(`ensureBrowserReady: ${pkg} has no page target (targets=${total})`);
+                    return false;
+                }
+                yield sleep(intervalMs);
+            }
+        }
+        catch (error) {
+            logger_js_1.default.info(`ensureBrowserReady: readiness check failed: ${error.message}`);
+            return false;
+        }
+        finally {
+            try {
+                yield adb.adbExec(['forward', '--remove', `tcp:${port}`]);
+            }
+            catch (e) {
+                // the forward may already be gone
+            }
+        }
+    });
+}
+function currentActivity(driver) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            return String(yield driver.getCurrentActivity());
+        }
+        catch (e) {
+            return '';
+        }
+    });
+}
+function openPage(adb, pkg, component, url) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // target the component: a bare trailing package is not honoured by am, and the
+        // intent would open in whichever browser handles VIEW by default
+        const target = component || pkg;
+        yield adb.adbExec([
+            'shell', 'am', 'start', '-a', 'android.intent.action.VIEW', '-d', url, '-n', target,
+        ]);
+    });
+}
+/**
+ * @param {object} opts
+ * @param {object} opts.driver     UiAutomator2 driver used for the walkthrough
+ * @param {object} opts.adb        appium-adb instance
+ * @param {string} opts.pkg        browser package name
+ * @param {string} opts.socket     devtools socket name (see DEVTOOLS_SOCKET_MAP)
+ * @param {string} [opts.component] pkg/activity used to open a page in this browser
+ * @param {boolean} [opts.pidScoped]  socket name is suffixed with the pid (WebView apps)
+ * @param {string[]} [opts.selectors] browser-specific selectors, tried before the common ones
+ * @param {string} [opts.url]      page to open once the socket is up
+ * @param {number} [opts.attempts]
+ * @returns {Promise<boolean>} whether the browser became ready
+ */
+function ensureBrowserReady(opts) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { driver, adb, pkg, socket, component, pidScoped = false, selectors = [], url = 'https://www.appium.io', attempts = 12, intervalMs = 2500, } = opts;
+        const candidates = [...selectors, ...COMMON_SELECTORS];
+        for (let attempt = 0; attempt < attempts; attempt++) {
+            try {
+                // The process (and its socket) can exist while onboarding is still on
+                // screen, and even afterwards the browser may hold no debuggable page.
+                // Require onboarding gone, the socket up, and a page the driver can attach to.
+                const activity = yield currentActivity(driver);
+                if (ONBOARDING_ACTIVITY.test(activity)) {
+                    logger_js_1.default.info(`ensureBrowserReady: still on onboarding (${activity})`);
+                }
+                else {
+                    const socketName = yield resolveSocket(adb, socket, pkg, pidScoped);
+                    if (socketName) {
+                        yield openPage(adb, pkg, component, url);
+                        // poll rather than sleeping a fixed interval: usually the page is
+                        // there within a few hundred ms, and setup should not pay for the
+                        // worst case on every session
+                        if (yield verifyReady(adb, socketName, pkg)) {
+                            return true;
+                        }
+                    }
+                }
+            }
+            catch (e) {
+                // fall through to the dismissal pass
+            }
+            let clicked = null;
+            for (const selector of candidates) {
+                try {
+                    const element = yield driver.findElement('xpath', selector);
+                    yield driver.click(element.ELEMENT);
+                    clicked = selector;
+                    break;
+                }
+                catch (e) {
+                    // selector not present — try the next one
+                }
+            }
+            if (clicked) {
+                logger_js_1.default.info(`ensureBrowserReady: dismissed ${clicked}`);
+            }
+            else if (attempt % 3 === 2) {
+                logger_js_1.default.info(`ensureBrowserReady: nothing to dismiss, relaunching ${pkg}`);
+                try {
+                    yield openPage(adb, pkg, component, url);
+                }
+                catch (e) {
+                    // browser may still be starting
+                }
+            }
+            yield sleep(intervalMs);
+        }
+        return false;
+    });
+}
+/**
+ * Click an element without letting a stale/handled element abort the rest of the
+ * walkthrough — the screen often changes under it.
+ */
+function clickSafely(driver, element) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            yield driver.click(element.ELEMENT);
+        }
+        catch (error) {
+            logger_js_1.default.info(`click failed, continuing: ${error.message}`);
+        }
+    });
+}
+/**
+ * Close out a skip-welcome script: make the browser ready, always release the
+ * UiAutomator2 session, and fail loudly if the browser cannot serve a session.
+ * Without the throw, a script that dismissed nothing still exits 0 and the
+ * caller starts a session that is doomed to fail.
+ */
+function finishSession(driver, opts) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const ready = yield ensureBrowserReady(Object.assign({ driver }, opts));
+        logger_js_1.default.info(`${opts.pkg} devtools ready: ${ready}`);
+        try {
+            yield driver.deleteSession();
+        }
+        catch (e) {
+            logger_js_1.default.info(`deleteSession failed: ${e.message}`);
+        }
+        if (!ready) {
+            throw new Error(`${opts.pkg}: devtools socket never became available; the browser cannot serve a session`);
+        }
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJvd3NlclJlYWR5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc2NyaXB0cy9icm93c2VyUmVhZHkuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7QUF5Q0EsMENBSUM7QUE2QkQsZ0NBR0M7QUEyR0QsZ0RBNkRDO0FBTUQsa0NBTUM7QUFRRCxzQ0FXQztBQXBSRCw0REFBK0I7QUFDL0Isd0RBQStCO0FBQy9CLGlFQUFtQztBQUVuQzs7Ozs7Ozs7Ozs7Ozs7R0FjRztBQUVILE1BQU0sbUJBQW1CLEdBQUcsaURBQWlELENBQUM7QUFFOUUsOEVBQThFO0FBQzlFLDhFQUE4RTtBQUM5RSxNQUFNLGdCQUFnQixHQUFHO0lBQ3ZCLHVDQUF1QztJQUN2QyxxQ0FBcUM7SUFDckMsMkNBQTJDO0lBQzNDLHVDQUF1QztJQUN2Qyx1Q0FBdUM7SUFDdkMsMENBQTBDO0lBQzFDLHdDQUF3QztDQUN6QyxDQUFDO0FBRUYsTUFBTSxLQUFLLEdBQUcsQ0FBQyxFQUFFLEVBQUUsRUFBRSxDQUFDLElBQUksT0FBTyxDQUFDLENBQUMsT0FBTyxFQUFFLEVBQUUsQ0FBQyxVQUFVLENBQUMsT0FBTyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUM7QUFFeEU7Ozs7R0FJRztBQUNILFNBQWdCLGVBQWUsQ0FBQyxPQUFPO0lBQ3JDLE9BQU8sQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLE1BQU0sQ0FDbkQsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsSUFBSSxLQUFLLE1BQU0sSUFBSSxDQUFDLENBQUMsb0JBQW9CLENBQ3hELENBQUM7QUFDSixDQUFDO0FBRUQ7Ozs7R0FJRztBQUNILFNBQWUsYUFBYSxDQUFDLEdBQUcsRUFBRSxNQUFNLEVBQUUsR0FBRyxFQUFFLFNBQVM7O1FBQ3RELE1BQU0sSUFB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

package/build/scripts/duckduckgo.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const appium_uiautomator2_driver_1 = require("appium-uiautomator2-driver");
+const appium_adb_1 = require("appium-adb");
+const adb_js_1 = require("../src/adb.js");
+const logger_js_1 = __importDefault(require("../src/logger.js"));
+const asyncbox_1 = require("asyncbox");
+const browserReady_js_1 = require("./browserReady.js");
+const START_APP_WAIT_DURATION = 60000;
+const duckduckgo = {
+    pkg: 'com.duckduckgo.mobile.android',
+    activity: 'com.duckduckgo.app.browser.BrowserActivity',
+};
+const common = {
+    waitDuration: START_APP_WAIT_DURATION,
+    optionalIntentArguments: '-d www.appium.io',
+};
+function skipWelcomeDuckDuckGo() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const adbPort = (0, adb_js_1.resolveAdbPort)();
+        const adb = yield appium_adb_1.ADB.createADB({ adbPort });
+        yield adb.adbExec(['shell', 'pm', 'clear', 'com.duckduckgo.mobile.android']);
+        const driver = new appium_uiautomator2_driver_1.AndroidUiautomator2Driver();
+        const caps = {
+            platformName: "Android",
+            "appium:automationName": "UiAutomator2",
+            "appium:adbPort": adbPort,
+            "appium:deviceName": "Android Device",
+            "appium:appPackage": "com.duckduckgo.mobile.android",
+            "appium:appActivity": "com.duckduckgo.app.browser.BrowserActivity",
+        };
+        try {
+            yield driver.createSession(null, {
+                alwaysMatch: caps,
+                firstMatch: [{}],
+            });
+            const activity = yield driver.getCurrentActivity();
+            logger_js_1.default.info(`Activity is ${activity}`);
+            if (activity.includes('BrowserActivity')) {
+                const findElementWithWaitForCondition = (strategy_1, selector_1, ...args_1) => __awaiter(this, [strategy_1, selector_1, ...args_1], void 0, function* (strategy, selector, timeout = 6000) {
+                    try {
+                        return yield (0, asyncbox_1.waitForCondition)(() => __awaiter(this, void 0, void 0, function* () {
+                            try {
+                                logger_js_1.default.info(`Attempting to find element (${strategy}: ${selector})`);
+                                const element = yield driver.findElement(strategy, selector);
+                                logger_js_1.default.info(`Successfully found element (${strategy}: ${selector})`);
+                                return element;
+                            }
+                            catch (error) {
+                                // Return false to continue waiting
+                                return false;
+                            }
+                        }), {
+                            waitMs: timeout,
+                            intervalMs: 1000,
+                        });
+                    }
+                    catch (error) {
+                        throw new Error(`Failed to find element (${strategy}: ${selector}) within ${timeout}ms timeout: ${error.message}`);
+                    }
+                });
+                let attempt = 0;
+                let found = false;
+                const MAX_RETRIES = 3;
+                while (attempt < MAX_RETRIES && !found) {
+                    try {
+                        const dismissButton = yield findElementWithWaitForCondition('id', 'com.duckduckgo.mobile.android:id/bottomSheetPromoSecondaryButton');
+                        logger_js_1.default.info(`Dismiss button found: ${JSON.stringify(dismissButton, null, 2)} in attempt ${attempt}`);
+                        yield driver.click(dismissButton.ELEMENT);
+                        found = true;
+                    }
+                    catch (error) {
+                        logger_js_1.default.info(`Dismiss button not found, retrying after opening a url...`);
+                    }
+                    finally {
+                        yield adb.shell(['am', 'start', '-a', 'android.intent.action.VIEW', '-d', 'https://www.appium.io', duckduckgo.pkg]);
+                        attempt++;
+                    }
+                }
+            }
+        }
+        catch (error) {
+            logger_js_1.default.info(`walkthrough did not complete (${error.message}) — checking readiness anyway`);
+        }
+        finally {
+            yield (0, browserReady_js_1.finishSession)(driver, {
+                adb,
+                pkg: duckduckgo.pkg,
+                component: `${duckduckgo.pkg}/${duckduckgo.activity}`,
+                // WebView app: the socket carries the pid, and the bare prefix would also
+                // match other apps' WebViews
+                socket: 'webview_devtools_remote',
+                pidScoped: true,
+                selectors: [
+                    '//*[@resource-id="com.duckduckgo.mobile.android:id/primaryCta"]',
+                    '//*[@resource-id="com.duckduckgo.mobile.android:id/bottomSheetPromoSecondaryButton"]',
+                    '//*[@resource-id="com.duckduckgo.mobile.android:id/daxDialogDismissButton"]',
+                    '//android.widget.Button[@text="Got it"]',
+                    '//android.widget.Button[@text="Maybe later"]',
+                ],
+            });
+        }
+    });
+}
+(() => __awaiter(void 0, void 0, void 0, function* () {
+    yield skipWelcomeDuckDuckGo();
+    process.exit(0);
+}))();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZHVja2R1Y2tnby5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NjcmlwdHMvZHVja2R1Y2tnby5qcyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7QUFFQSwyRUFBdUU7QUFDdkUsMkNBQWlDO0FBQ2pDLDBDQUErQztBQUMvQyxpRUFBbUM7QUFDbkMsdUNBQTRDO0FBQzVDLHVEQUFrRDtBQUVsRCxNQUFNLHVCQUF1QixHQUFHLEtBQUssQ0FBQztBQUV0QyxNQUFNLFVBQVUsR0FBRztJQUNqQixHQUFHLEVBQUUsK0JBQStCO0lBQ3BDLFFBQVEsRUFBRSw0Q0FBNEM7Q0FDdkQsQ0FBQztBQUVGLE1BQU0sTUFBTSxHQUFHO0lBQ2IsWUFBWSxFQUFFLHVCQUF1QjtJQUNyQyx1QkFBdUIsRUFBRSxrQkFBa0I7Q0FDNUMsQ0FBQztBQUVGLFNBQWUscUJBQXFCOztRQUNsQyxNQUFNLE9BQU8sR0FBRyxJQUFBLHVCQUFjLEdBQUUsQ0FBQztRQUNqQyxNQUFNLEdBQUcsR0FBRyxNQUFNLGdCQUFHLENBQUMsU0FBUyxDQUFDLEVBQUUsT0FBTyxFQUFFLENBQUMsQ0FBQztRQUM3QyxNQUFNLEdBQUcsQ0FBQyxPQUFPLENBQUMsQ0FBQyxPQUFPLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSwrQkFBK0IsQ0FBQyxDQUFDLENBQUM7UUFDN0UsTUFBTSxNQUFNLEdBQUcsSUFBSSxzREFBeUIsRUFBRSxDQUFDO1FBQy9DLE1BQU0sSUFBSSxHQUFHO1lBQ1gsWUFBWSxFQUFFLFNBQVM7WUFDdkIsdUJBQXVCLEVBQUUsY0FBYztZQUN2QyxnQkFBZ0IsRUFBRSxPQUFPO1lBQ3pCLG1CQUFtQixFQUFFLGdCQUFnQjtZQUNyQyxtQkFBbUIsRUFBRSwrQkFBK0I7WUFDcEQsb0JBQW9CLEVBQUUsNENBQTRDO1NBQ25FLENBQUM7UUFDRixJQUFJLENBQUM7WUFDSCxNQUFNLE1BQU0sQ0FBQyxhQUFhLENBQUMsSUFBSSxFQUFFO2dCQUMvQixXQUFX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