@astur-mobile/core 0.5.0-beta.5 → 0.7.0-beta

package/dist/session.d.ts

@@ -1,4 +1,4 @@
-import type { Coordinates, DeviceFileEntry, DeviceInfo, DeviceOrientation, DoctorCheck, DragGesture, DoubleTapOptions, ElementDragOptions, ElementDragTarget, ElementDoubleTapOptions, ElementFillOptions, ElementLongPressOptions, ElementSelector, ElementTapOptions, ElementWaitOptions, LaunchOptions, LongPressOptions, KeyboardState, MobileContextInfo, NetworkCapabilities, NetworkRedactionOptions, NetworkRequestFilter, NetworkRequestRecord, MobileElementSnapshot, MobileRole, NormalizedCapabilities, PlatformName, InspectorSession, LocatorSuggestion, RecordingStopOptions, RoleSelectorOptions, ScreenshotOptions, SwipeGesture, TapOptions, UiTreeSubscribeOptions, UiTreeUpdate, AsturConfig, AppResetOptions, AppUnderTest, Bounds, WebViewEndpoint, WebViewSelector } from '@astur-mobile/protocol';
+import type { AppResetOptions, AppUnderTest, AsturConfig, Bounds, BrowserCapabilities, Coordinates, DeviceFileEntry, DeviceInfo, DeviceOrientation, DeviceSelector, DoctorCheck, DoubleTapOptions, DragGesture, ElementDoubleTapOptions, ElementDragOptions, ElementDragTarget, ElementFillOptions, ElementLongPressOptions, ElementSelector, ElementTapOptions, ElementWaitOptions, ForegroundApp, InspectorSession, InstalledApp, KeyboardState, LaunchOptions, LocatorSuggestion, LongPressOptions, MobileContextInfo, MobileElementSnapshot, MobileRole, NetworkCapabilities, NetworkRedactionOptions, NetworkRequestFilter, NetworkRequestRecord, NormalizedCapabilities, PlatformName, RecordingStopOptions, RoleSelectorOptions, ScreenshotOptions, SwipeGesture, TapOptions, UiTreeSubscribeOptions, UiTreeUpdate, WebViewEndpoint, WebViewSelector } from '@astur-mobile/protocol';
 import { type RuntimeInspectorSessionOptions } from './inspector.js';
 import { MobileLocator } from './locator.js';
 import { WebContext, type WebEvaluator } from './webBridge.js';
@@ -16,6 +16,11 @@ export interface PlatformDriver {
     readonly platform: PlatformName;
     doctor(): Promise<DoctorCheck[]>;
     listDevices(): Promise<DeviceInfo[]>;
+    /**
+     * The device `createSession` would open for `selector` right now, found
+     * without touching it; `undefined` when none qualifies yet.
+     */
+    findDevice?(selector: DeviceSelector): Promise<DeviceInfo | undefined>;
     createSession(capabilities: NormalizedCapabilities): Promise<PlatformSession>;
 }
 export interface PlatformSession {
@@ -23,6 +28,12 @@ export interface PlatformSession {
     readonly deviceInfo: DeviceInfo;
     close(): Promise<void>;
     isAppInstalled?(identifier: string): Promise<boolean>;
+    /**
+     * Whether the installed `identifier` is exactly the build at `path`:
+     * `false` when it differs or is absent, `undefined` when that cannot be
+     * established. Callers must treat `undefined` as "reinstall".
+     */
+    isInstalledAppCurrent?(identifier: string, path: string): Promise<boolean | undefined>;
     installApp(path: string): Promise<void>;
     uninstallApp(identifier: string): Promise<void>;
     launchApp(options?: LaunchOptions): Promise<void>;
@@ -33,6 +44,11 @@ export interface PlatformSession {
     revokePermission?(identifier: string, permission: string): Promise<void>;
     resetApp(options?: AppResetOptions): Promise<void>;
     setOrientation?(orientation: DeviceOrientation): Promise<void>;
+    getOrientation?(): Promise<DeviceOrientation>;
+    listApps?(options?: {
+        system?: boolean;
+    }): Promise<InstalledApp[]>;
+    getForegroundApp?(): Promise<ForegroundApp | undefined>;
     lockDevice(): Promise<void>;
     unlockDevice(): Promise<void>;
     isDeviceLocked(): Promise<boolean>;
@@ -62,7 +78,31 @@ export interface PlatformSession {
     startRecording?(): Promise<void>;
     stopRecording?(options?: RecordingStopOptions): Promise<Buffer | undefined>;
     screenshot(): Promise<Buffer>;
+    /**
+     * Hands a URL to the OS. Deliberately not browser-specific — a deep link into
+     * the app under test goes through here too, which is why it stays `void` and
+     * does not try to find a page afterwards.
+     */
     openWeb(url: string): Promise<void>;
+    /**
+     * Launches the configured browser at a URL, rather than letting the OS pick a
+     * handler. Drivers that cannot target a browser omit this, and
+     * {@link AsturDevice.browser} reports it as unsupported.
+     */
+    openBrowser?(url: string): Promise<void>;
+    /** What this session can do with a browser, detected at runtime. */
+    getBrowserCapabilities?(): Promise<BrowserCapabilities>;
+    /**
+     * Opens a **new** browser tab and returns its target id.
+     *
+     * Optional because tab lifecycle is not universal: Chrome exposes it over the
+     * debugging socket, WebKit's remote inspector does not. A driver that omits
+     * these falls back to reusing one tab, which is weaker isolation but the only
+     * thing the platform allows.
+     */
+    openBrowserTab?(url: string): Promise<string | undefined>;
+    /** Closes a browser tab by target id. */
+    closeBrowserTab?(id: string): Promise<void>;
     pushFile?(localPath: string, remotePath: string): Promise<void>;
     pullFile?(remotePath: string): Promise<Buffer>;
     saveFile?(remotePath: string, localPath: string): Promise<void>;
@@ -108,6 +148,21 @@ export declare class AsturDevice {
         clearData: (target?: string | AppUnderTest) => Promise<void>;
         clearCache: (target?: string | AppUnderTest) => Promise<void>;
         reset: (options?: AppResetOptions) => Promise<void>;
+        /**
+         * Apps installed on the device.
+         *
+         * Third-party apps only by default: a full system listing runs to hundreds
+         * of entries and buries the one being tested. Pass `{ system: true }` when
+         * a test genuinely needs to assert on a built-in app.
+         */
+        list: (options?: {
+            system?: boolean;
+        }) => Promise<InstalledApp[]>;
+        /**
+         * The app in the foreground right now, or `undefined` when the device is
+         * showing the launcher or a system surface rather than an app.
+         */
+        foreground: () => Promise<ForegroundApp | undefined>;
     };
     readonly gestures: {
         tap: (point: Coordinates, options?: TapOptions) => Promise<void>;
@@ -123,6 +178,8 @@ export declare class AsturDevice {
         recentApps: () => Promise<void>;
     };
     readonly orientation: {
+        /** The device's current orientation. */
+        get: () => Promise<DeviceOrientation>;
         set: (orientation: DeviceOrientation) => Promise<void>;
         portrait: () => Promise<void>;
         landscape: () => Promise<void>;
@@ -161,6 +218,62 @@ export declare class AsturDevice {
          */
         clear: () => Promise<void>;
     };
+    /**
+     * The page currently open in the browser, if one has been opened.
+     *
+     * Held so navigation can dispose it before re-resolving, and so a suite that
+     * forgets to close is still cleaned up when the session ends.
+     */
+    private browserPage?;
+    /** Target id of the tab this session opened, when it opened one itself. */
+    private browserTabId?;
+    /**
+     * Drives a **browser** rather than the app under test — for testing a mobile
+     * web page on the same real device or emulator the native suite runs on.
+     *
+     * Everything below the page is the existing WebView machinery: once a tab is
+     * inspectable, the same injected-JS bridge drives it. What this adds is the
+     * target and navigation, which an in-app WebView never needed.
+     *
+     * Ask {@link browser.capabilities} before using it, the same way
+     * {@link network.capabilities} is asked, so a spec stays portable.
+     */
+    readonly browser: {
+        /** What this session can do with a browser. Never throws. */
+        capabilities: () => Promise<BrowserCapabilities>;
+        /**
+         * Launches the browser at `url` and returns a context on the page.
+         *
+         * The returned context is the handle to use until the next navigation —
+         * each navigation re-resolves the page and returns a fresh one.
+         */
+        open: (url: string, options?: {
+            timeout?: number;
+        }) => Promise<WebContext>;
+        /** Navigates the open page and returns it, now showing `url`. */
+        navigate: (url: string, options?: {
+            timeout?: number;
+        }) => Promise<WebContext>;
+        reload: (options?: {
+            timeout?: number;
+        }) => Promise<WebContext>;
+        back: (options?: {
+            timeout?: number;
+        }) => Promise<WebContext>;
+        forward: (options?: {
+            timeout?: number;
+        }) => Promise<WebContext>;
+        /** The open page's current URL. */
+        url: () => Promise<string>;
+        /**
+         * Closes the page, and its tab where the platform allows it. The browser
+         * itself is left running — starting it again per test costs seconds.
+         *
+         * The Astur fixture calls this after every test, so tabs cannot accumulate
+         * and no test inherits the previous one's page.
+         */
+        close: () => Promise<void>;
+    };
     readonly keyboard: {
         isVisible: () => Promise<boolean>;
         dismiss: () => Promise<void>;
@@ -219,12 +332,16 @@ export declare class AsturDevice {
     getByType(value: string, options?: {
         exact?: boolean;
     }): MobileLocator;
+    getByPlaceholder(value: string, options?: {
+        exact?: boolean;
+    }): MobileLocator;
     inspector(options?: RuntimeInspectorSessionOptions): InspectorSession;
     suggestLocators(selector: ElementSelector): Promise<LocatorSuggestion[]>;
     tap(point: Coordinates, options?: TapOptions): Promise<void>;
     doubleTap(point: Coordinates, options?: DoubleTapOptions): Promise<void>;
     longPress(point: Coordinates, options?: LongPressOptions): Promise<void>;
     pressAndHold(point: Coordinates, options?: LongPressOptions): Promise<void>;
+    getOrientation(): Promise<DeviceOrientation>;
     setOrientation(orientation: DeviceOrientation): Promise<void>;
     pressKey(key: string): Promise<void>;
     back(): Promise<void>;
@@ -253,6 +370,33 @@ export declare class AsturDevice {
      * frameworks (Flutter, React Native) on each platform that exposes the transport.
      */
     webContext(selector?: WebViewSelector): Promise<WebContext>;
+    /**
+     * Re-resolves the page after a history navigation.
+     *
+     * No URL to match on here — where `back()` lands is exactly what the test is
+     * asking about — so this takes whichever page the browser now shows.
+     */
+    /**
+     * Runs a history navigation on the attached tab and waits for it to settle.
+     *
+     * Deliberately stays on the same target rather than re-resolving. A browser
+     * keeps every tab a suite has opened, several on the same URL, so "find the
+     * page again" is ambiguous in a way it never is for an app's single WebView —
+     * and picking wrong silently drives a frozen background tab. Chromium keeps
+     * one target across a same-tab navigation; if the transport does die, the
+     * re-resolve below is the fallback rather than the norm.
+     */
+    private renavigate;
+    /**
+     * Brings the attached tab to `url`, navigating only if it is not already
+     * there — so an intent that happened to land correctly costs nothing.
+     */
+    private ensureAt;
+    /** Attaches to an already-open page, or resolves undefined. Never throws. */
+    private tryResolveBrowserPage;
+    private resolveBrowserPage;
+    private requireBrowserPage;
+    private closeBrowserPage;
     close(): Promise<void>;
 }
 export declare class AsturRuntime {
@@ -260,6 +404,11 @@ export declare class AsturRuntime {
     register(driver: PlatformDriver): this;
     doctor(): Promise<DoctorCheck[]>;
     listDevices(platform?: PlatformName): Promise<DeviceInfo[]>;
+    /**
+     * The device `createDevice(config)` would open, found without touching it.
+     * Reservation locks this, so two spellings of one device collide.
+     */
+    findDevice(config: AsturConfig): Promise<DeviceInfo | undefined>;
     createDevice(config: AsturConfig): Promise<AsturDevice>;
     private requireDriver;
 }

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

package/dist/session.js

@@ -6,6 +6,7 @@ import { createInspectorSession } from './inspector.js';
 import { preparePointerTargetForKeyboard } from './keyboard.js';
 import { by, captureMaskedScreenshot, findElements, MobileLocator, screenshotKey } from './locator.js';
 import { WebContext } from './webBridge.js';
+import { browserUnsupported, connectBrowserPage, currentUrl, markNavigation, pageMatcher, runNavigation, settlePage, waitForLoad, DEFAULT_PAGE_TIMEOUT_MS, REUSE_PROBE_MS } from './browser.js';
 import { delay } from './wait.js';
 export class AsturDevice {
     capabilities;
@@ -41,6 +42,29 @@ export class AsturDevice {
         },
         reset: async (options) => {
             await this.session.resetApp(options);
+        },
+        /**
+         * Apps installed on the device.
+         *
+         * Third-party apps only by default: a full system listing runs to hundreds
+         * of entries and buries the one being tested. Pass `{ system: true }` when
+         * a test genuinely needs to assert on a built-in app.
+         */
+        list: async (options) => {
+            if (!this.session.listApps) {
+                throw new AsturError('APP_LIST_UNSUPPORTED', 'This platform session cannot list installed apps.');
+            }
+            return this.session.listApps(options);
+        },
+        /**
+         * The app in the foreground right now, or `undefined` when the device is
+         * showing the launcher or a system surface rather than an app.
+         */
+        foreground: async () => {
+            if (!this.session.getForegroundApp) {
+                throw new AsturError('FOREGROUND_APP_UNSUPPORTED', 'This platform session cannot report the foreground app.');
+            }
+            return this.session.getForegroundApp();
         }
     };
     gestures = {
@@ -75,6 +99,13 @@ export class AsturDevice {
         }
     };
     orientation = {
+        /** The device's current orientation. */
+        get: async () => {
+            if (!this.session.getOrientation) {
+                throw new AsturError('ORIENTATION_READ_UNSUPPORTED', 'This platform session cannot report the current orientation.');
+            }
+            return this.session.getOrientation();
+        },
         set: async (orientation) => {
             await this.setOrientation(orientation);
         },
@@ -154,6 +185,113 @@ export class AsturDevice {
             await this.session.clearNetworkRequests?.();
         }
     };
+    /**
+     * The page currently open in the browser, if one has been opened.
+     *
+     * Held so navigation can dispose it before re-resolving, and so a suite that
+     * forgets to close is still cleaned up when the session ends.
+     */
+    browserPage;
+    /** Target id of the tab this session opened, when it opened one itself. */
+    browserTabId;
+    /**
+     * Drives a **browser** rather than the app under test — for testing a mobile
+     * web page on the same real device or emulator the native suite runs on.
+     *
+     * Everything below the page is the existing WebView machinery: once a tab is
+     * inspectable, the same injected-JS bridge drives it. What this adds is the
+     * target and navigation, which an in-app WebView never needed.
+     *
+     * Ask {@link browser.capabilities} before using it, the same way
+     * {@link network.capabilities} is asked, so a spec stays portable.
+     */
+    browser = {
+        /** What this session can do with a browser. Never throws. */
+        capabilities: async () => {
+            if (!this.session.getBrowserCapabilities || !this.session.openBrowser) {
+                return browserUnsupported(this.deviceInfo.platform, 'this driver has no browser target');
+            }
+            return this.session.getBrowserCapabilities();
+        },
+        /**
+         * Launches the browser at `url` and returns a context on the page.
+         *
+         * The returned context is the handle to use until the next navigation —
+         * each navigation re-resolves the page and returns a fresh one.
+         */
+        open: async (url, options) => {
+            const capabilities = await this.browser.capabilities();
+            if (!capabilities.supported || !this.session.openBrowser) {
+                throw new AsturError('BROWSER_NOT_SUPPORTED', capabilities.coverage);
+            }
+            await this.browser.close();
+            // Prefer a genuinely fresh tab, the way Playwright hands each test a new
+            // page. Chrome supports it over the debugging socket; WebKit's inspector
+            // does not, so iOS falls back to reusing one tab and reloading it.
+            if (this.session.openBrowserTab) {
+                const id = await this.session.openBrowserTab(url).catch(() => undefined);
+                if (id) {
+                    this.browserTabId = id;
+                    // Attach to the new tab without filtering on the URL. A tab created
+                    // over the debugging socket starts at about:blank and only reaches the
+                    // requested URL once it has loaded, so matching on the URL here waits
+                    // out the whole budget before falling back. `ensureAt` drives it there
+                    // in-page, which is both faster and the same code path as navigate().
+                    const opened = await this.resolveBrowserPage(undefined, options?.timeout);
+                    return this.ensureAt(opened, url, options?.timeout);
+                }
+            }
+            // Fallback: reuse whatever tab is open rather than firing the launch
+            // intent again. Each intent leaves another tab behind, so a suite that
+            // opens a page per test would climb to dozens and eventually attach to
+            // none of them.
+            const existing = await this.tryResolveBrowserPage(REUSE_PROBE_MS);
+            if (existing) {
+                return this.ensureAt(existing, url, options?.timeout);
+            }
+            // Nothing attachable: start the browser. The launch is not trusted to land
+            // on the URL, because Chrome dedupes a VIEW intent against an open tab and
+            // simply focuses it.
+            await this.session.openBrowser(url);
+            const page = await this.resolveBrowserPage(undefined, options?.timeout);
+            return this.ensureAt(page, url, options?.timeout);
+        },
+        /** Navigates the open page and returns it, now showing `url`. */
+        navigate: async (url, options) => {
+            return this.ensureAt(this.requireBrowserPage(), url, options?.timeout);
+        },
+        reload: async (options) => {
+            // Reload must come back to the same page, so reattach by URL rather than
+            // taking whichever tab answers first.
+            const current = await this.browser.url().catch(() => undefined);
+            return this.renavigate('location.reload()', options?.timeout, current);
+        },
+        back: async (options) => {
+            return this.renavigate('history.back()', options?.timeout);
+        },
+        forward: async (options) => {
+            return this.renavigate('history.forward()', options?.timeout);
+        },
+        /** The open page's current URL. */
+        url: async () => {
+            return String(await this.requireBrowserPage().evaluate('location.href') ?? '');
+        },
+        /**
+         * Closes the page, and its tab where the platform allows it. The browser
+         * itself is left running — starting it again per test costs seconds.
+         *
+         * The Astur fixture calls this after every test, so tabs cannot accumulate
+         * and no test inherits the previous one's page.
+         */
+        close: async () => {
+            await this.closeBrowserPage();
+            const id = this.browserTabId;
+            this.browserTabId = undefined;
+            if (id && this.session.closeBrowserTab) {
+                await this.session.closeBrowserTab(id).catch(() => undefined);
+            }
+        }
+    };
     keyboard = {
         isVisible: async () => {
             if (!this.session.getKeyboardState) {
@@ -284,6 +422,9 @@ export class AsturDevice {
     getByType(value, options) {
         return this.find(by.type(value, options));
     }
+    getByPlaceholder(value, options) {
+        return this.find(by.placeholder(value, options));
+    }
     inspector(options) {
         return createInspectorSession(this.session, options);
     }
@@ -311,6 +452,9 @@ export class AsturDevice {
     async pressAndHold(point, options) {
         await this.longPress(point, options);
     }
+    async getOrientation() {
+        return this.orientation.get();
+    }
     async setOrientation(orientation) {
         if (!this.session.setOrientation) {
             throw new AsturError('ORIENTATION_NOT_SUPPORTED', `${this.deviceInfo.platform} does not expose orientation control yet.`);
@@ -409,7 +553,83 @@ export class AsturDevice {
         }
         return new WebContext(await this.session.createWebEvaluator(selector));
     }
+    /**
+     * Re-resolves the page after a history navigation.
+     *
+     * No URL to match on here — where `back()` lands is exactly what the test is
+     * asking about — so this takes whichever page the browser now shows.
+     */
+    /**
+     * Runs a history navigation on the attached tab and waits for it to settle.
+     *
+     * Deliberately stays on the same target rather than re-resolving. A browser
+     * keeps every tab a suite has opened, several on the same URL, so "find the
+     * page again" is ambiguous in a way it never is for an app's single WebView —
+     * and picking wrong silently drives a frozen background tab. Chromium keeps
+     * one target across a same-tab navigation; if the transport does die, the
+     * re-resolve below is the fallback rather than the norm.
+     */
+    async renavigate(expression, timeout, expectUrl) {
+        const page = this.requireBrowserPage();
+        const token = await markNavigation(page);
+        await runNavigation(page, expression);
+        if (await settlePage(page, timeout ?? DEFAULT_PAGE_TIMEOUT_MS, { token, expectUrl })) {
+            return page;
+        }
+        await this.closeBrowserPage();
+        return this.resolveBrowserPage(expectUrl, timeout);
+    }
+    /**
+     * Brings the attached tab to `url`, navigating only if it is not already
+     * there — so an intent that happened to land correctly costs nothing.
+     */
+    async ensureAt(page, url, timeout) {
+        const timeoutMs = timeout ?? DEFAULT_PAGE_TIMEOUT_MS;
+        const alreadyThere = pageMatcher(url).test(await currentUrl(page) ?? '');
+        const token = await markNavigation(page);
+        // Load even when the tab already shows this URL. Reusing a tab is what keeps
+        // the browser from leaking one per test, but a reused tab still carries the
+        // previous test's DOM — a filled field, a submitted form — and skipping the
+        // load would silently hand that state to the next test.
+        await runNavigation(page, alreadyThere ? 'location.reload()' : `location.href = ${JSON.stringify(url)}`);
+        if (await settlePage(page, timeoutMs, { token, expectUrl: url })) {
+            return page;
+        }
+        await this.closeBrowserPage();
+        return this.resolveBrowserPage(url, timeout);
+    }
+    /** Attaches to an already-open page, or resolves undefined. Never throws. */
+    async tryResolveBrowserPage(timeoutMs) {
+        if (!this.session.createWebEvaluator) {
+            return undefined;
+        }
+        return this.resolveBrowserPage(undefined, timeoutMs).catch(() => undefined);
+    }
+    async resolveBrowserPage(url, timeout) {
+        if (!this.session.createWebEvaluator) {
+            throw new AsturError('BROWSER_NOT_SUPPORTED', `${this.deviceInfo.platform} has no DOM transport, so a browser page cannot be driven.`);
+        }
+        const timeoutMs = timeout ?? DEFAULT_PAGE_TIMEOUT_MS;
+        const page = await connectBrowserPage((selector) => this.session.createWebEvaluator(selector), { url, timeoutMs });
+        // Settle before handing the page over, so the first assertion is not racing
+        // a document that is still parsing.
+        await waitForLoad(page, timeoutMs);
+        this.browserPage = page;
+        return page;
+    }
+    requireBrowserPage() {
+        if (!this.browserPage) {
+            throw new AsturError('BROWSER_PAGE_NOT_OPEN', 'No browser page is open. Call device.browser.open(url) first.');
+        }
+        return this.browserPage;
+    }
+    async closeBrowserPage() {
+        const page = this.browserPage;
+        this.browserPage = undefined;
+        await page?.close().catch(() => undefined);
+    }
     async close() {
+        await this.browser.close().catch(() => undefined);
         await this.session.close();
     }
 }
@@ -437,6 +657,47 @@ function appIdentifier(capabilities, target) {
     }
     return identifier;
 }
+async function installAppUnderTest(session, platform) {
+    const app = session.capabilities.app;
+    if (!app?.path || app.install === 'never') {
+        return;
+    }
+    const identifier = app.packageName ?? app.bundleId;
+    // Kept as it always behaved while it is phased out: a clean install, which
+    // also wipes app data. `install: 'always'` installs over the top instead.
+    if (platform === 'android' && process.env.ASTUR_ANDROID_APP_FORCE_INSTALL === '1') {
+        if (identifier) {
+            try {
+                await session.uninstallApp(identifier);
+            }
+            catch {
+                // The package may not be installed yet; the install below is still
+                // the authoritative operation.
+            }
+        }
+        await session.installApp(app.path);
+        return;
+    }
+    if (app.install !== 'always' && identifier && await hasInstalledBuild(session, identifier, app.path)) {
+        return;
+    }
+    await session.installApp(app.path);
+}
+/**
+ * Whether the device already has the requested build. A driver that can compare
+ * builds decides, and "cannot tell" counts as no: a suite quietly running
+ * against a stale build costs more than a slower start. Drivers that cannot
+ * compare yet fall back to asking whether the package is present at all.
+ */
+async function hasInstalledBuild(session, identifier, path) {
+    if (session.isInstalledAppCurrent) {
+        return (await session.isInstalledAppCurrent(identifier, path).catch(() => undefined)) === true;
+    }
+    if (session.isAppInstalled) {
+        return session.isAppInstalled(identifier).catch(() => false);
+    }
+    return false;
+}
 export class AsturRuntime {
     drivers = new Map();
     register(driver) {
@@ -452,36 +713,31 @@ export class AsturRuntime {
         const devices = await Promise.all(drivers.map((driver) => driver.listDevices()));
         return devices.flat();
     }
+    /**
+     * The device `createDevice(config)` would open, found without touching it.
+     * Reservation locks this, so two spellings of one device collide.
+     */
+    async findDevice(config) {
+        const capabilities = normalizeCapabilities(config);
+        return this.requireDriver(capabilities.platform).findDevice?.(capabilities.device);
+    }
     async createDevice(config) {
         const capabilities = await materializeCapabilities(normalizeCapabilities(config));
         const driver = this.requireDriver(capabilities.platform);
         const session = await driver.createSession(capabilities);
-        const app = session.capabilities.app;
-        if (app?.path) {
-            const identifier = app.packageName ?? app.bundleId;
-            const forceInstall = capabilities.platform === 'android'
-                && process.env.ASTUR_ANDROID_APP_FORCE_INSTALL === '1';
-            if (forceInstall) {
-                if (identifier) {
-                    try {
-                        await session.uninstallApp(identifier);
-                    }
-                    catch {
-                        // The package may not be installed yet; the install below is still
-                        // the authoritative operation.
-                    }
-                }
-                await session.installApp(app.path);
-            }
-            else if (identifier && session.isAppInstalled) {
-                const installed = await session.isAppInstalled(identifier).catch(() => false);
-                if (!installed) {
-                    await session.installApp(app.path);
-                }
+        try {
+            await installAppUnderTest(session, capabilities.platform);
+        }
+        catch (error) {
+            // The session already holds an agent process, port forwards, and a
+            // device; a failed install must not strand them.
+            try {
+                await session.close();
             }
-            else {
-                await session.installApp(app.path);
+            catch {
+                // The install failure is the error worth reporting.
             }
+            throw error;
         }
         return new AsturDevice(session);
     }