@samsara-dev/appwright 0.6.0 → 0.7.0

package/AGENTS.md

@@ -1,68 +1,54 @@
-# AGENTS OVERVIEW
+# Appwright Agent Guide
 
-This document summarizes the Appwright test automation project so autonomous agents understand the environment, capabilities, and workflows before making changes.
-
-## Project Snapshot
-
-- **Package name:** `@samsara-dev/appwright`
-- **Language:** TypeScript targeting Node.js ≥ 20.19
-- **Distribution entry:** `dist/index.js` (compiled via `npm run build`)
-- **Primary domains:** Mobile app end-to-end automation on real devices or device farms (BrowserStack, LambdaTest, local emulators)
-
-## Repository Layout
-
-- `src/` – TypeScript sources (single source of truth)
-- `dist/` – Generated JavaScript and type declarations; never edit manually
-- `example/` – Sample usage and fixtures
-- `docs/` – Generated documentation assets
-- `.changeset/` – Release notes authored via Changesets
-- `node_modules/` – Managed dependencies (do not commit edits)
-
-## Core Concepts & Types
-
-- `Device` class wraps a WebDriver client for mobile-specific flows and is exported from `src/index.ts`.
-- `Locator` utilities hold find strategies and timeout behavior derived from `TimeoutOptions`.
-- Providers (`src/providers/*`) bootstrap sessions for BrowserStack, LambdaTest, local, and emulator contexts.
-- Vision utilities in `src/vision` offer computer-vision-assisted interactions.
-
-## Key Commands
+## 1. Project Snapshot
+- **Repo type:** Single-package TypeScript library (no workspaces)
+- **Stack:** Node.js ≥20, TypeScript, Playwright fixtures, Vitest, ESLint (`@empiricalrun`)
+- **Docs:** Each major directory ships its own `AGENTS.md`; nearest file wins
 
+## 2. Root Setup Commands
 ```bash
-npm run build   # Compile TypeScript to dist/
-npm test        # Run Vitest test suite once
-
-npm run lint    # Lint via ESLint configuration
-npm run changeset # Create or update release notes
+npm ci                # install dependencies (use npm install for incremental updates)
+npm run lint          # ESLint with @empiricalrun rules
+npm run build         # tsc --build (typecheck + emit to dist/)
+npm test -- --run     # Vitest single pass (avoids interactive watch mode)
+npm run changeset     # prepare release notes when changes ship
 ```
 
-## Device Helper Summary
-
-- `device.getTimeouts()` – Returns the underlying WebDriver timeout configuration (implicit, pageLoad, script, command if available).
-- `device.getWindowRect()` – Exposes the active window rectangle `{ width, height, x, y }` for layout-aware actions.
-
-## Development Guardrails
-
-- Always apply edits in `src/` and rebuild; never patch `dist/` directly.
-- Ensure additions remain backward compatible; prefer optional or additive APIs.
-- Run build + tests before concluding any workflow to catch regressions.
-- Use Changesets for versioned changes and keep release notes concise.
-
-## Provider Notes
-
-- BrowserStack-specific capabilities live under `src/providers/browserstack` and may take advantage of executor scripts (e.g., camera image injection, keyboard state).
-- LambdaTest support mirrors BrowserStack patterns but with differing executor APIs.
-- Local and emulator providers rely on Appium capabilities configured through project fixtures.
-
-## Telemetry & Vision
-
-- Visual trace services are coordinated via `src/visualTrace` to capture screenshots across retries.
-- Vision-based interactions are powered by `@empiricalrun/llm` models; see `Device.beta` helpers for experimental flows.
-
-## Release Workflow
-
-1. Author a Changeset describing user-facing impact.
-2. Run `npm run build` and `npm test` to validate artifacts.
-3. Submit PR targeting `main`; CI validates lint/tests.
-4. Publish via `changeset publish` when ready for release.
-
-Agents should adhere to these guardrails to ensure repeatable, secure automation within the Appwright codebase.
+## 3. Universal Conventions
+- Share a short plan with maintainers **before editing** (hard requirement)
+- Author new code in `src/**`; never modify generated `dist/**`
+- Rely on `src/logger.ts` instead of raw `console` (exceptions stream subprocess output only)
+- Follow Conventional Commits (`feat:`, `fix:`, `chore:`) and branch from `main`
+- Keep APIs backward compatible; prefer additive options over breaking changes
+- Always generate a Changeset that captures the user-facing impact of the feature you worked on
+
+## 4. Security & Secrets
+- Never commit API keys, BrowserStack creds, or AWS secrets; load via environment variables
+- BrowserStack needs `BROWSERSTACK_USERNAME` / `BROWSERSTACK_ACCESS_KEY`
+- Remote build downloads require AWS credentials (`AWS_REGION` plus standard SDK env vars)
+- Avoid storing PII or test artifacts in the repo; use external storage for logs/videos
+
+## 5. JIT Index (what to open, not what to paste)
+
+### Package Structure
+- Core library: `src/` → [see src/AGENTS.md](src/AGENTS.md)
+- Device runtime: `src/device/` → [see src/device/AGENTS.md](src/device/AGENTS.md)
+- Providers (BrowserStack, LambdaTest, emulator, local): `src/providers/` → [see src/providers/AGENTS.md](src/providers/AGENTS.md)
+- Vision utilities: `src/vision/` → [see src/vision/AGENTS.md](src/vision/AGENTS.md)
+- Visual trace capture: `src/visualTrace/` → [see src/visualTrace/AGENTS.md](src/visualTrace/AGENTS.md)
+- Test suite: `src/tests/` → [see src/tests/AGENTS.md](src/tests/AGENTS.md)
+- Example consumer app: `example/` → [see example/AGENTS.md](example/AGENTS.md)
+
+### Quick Find Commands
+- Locate a public export: `rg -n "export .*" src/index.ts src/types` (fallback: `grep -rn "export .*" src/index.ts src/types`)
+- Discover provider hooks: `rg -n "DeviceProvider" src/providers` (fallback: `grep -rn "DeviceProvider" src/providers`)
+- Inspect Playwright fixtures: `rg -n "extend<TestLevelFixtures" src/fixture` (fallback: `grep -rn "extend<TestLevelFixtures" src/fixture`)
+- Track vision helpers: `rg -n "AppwrightVision" src/vision` (fallback: `grep -rn "AppwrightVision" src/vision`)
+- Find targeted tests: `rg -n "\\.spec\\.ts" src/tests` (fallback: `grep -rn "\.spec\.ts" src/tests`)
+- Review BrowserStack permission prompts wiring: `rg -n "permissionPrompts" src/providers src/types`
+
+## 6. Definition of Done
+- `npm run lint && npm run build && npm test -- --run` must all pass locally
+- Add a Changeset entry for user-facing changes
+- Ensure documentation in relevant `AGENTS.md` files reflects the update
+- Confirm the plan was shared and acknowledged before merging

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # appwright
 
+## 0.7.0
+
+### Minor Changes
+
+- 3f00c08: Add device-level controls for BrowserStack permission prompts, including Android auto-grant toggles and iOS alert behaviour that respects the iOS 13 capability flip.
+
+## 0.6.1
+
+### Patch Changes
+
+- 40979ac: - add BrowserStack S3 buildPath support with local download helper and coverage
+  - restructure hierarchical AGENTS.md guidance and reminders for contributors
+
 ## 0.6.0
 
 ### Minor Changes

package/dist/providers/browserstack/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/browserstack/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,eAAe,EACf,cAAc,EAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAqDtC,qBAAa,0BAA2B,YAAW,cAAc;IAC/D,OAAO,CAAC,cAAc,CAAC,CAA6B;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,OAAO,CAA+B;gBAG5C,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,EACrC,WAAW,EAAE,MAAM,GAAG,SAAS;IAU3B,WAAW;IAwDX,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAMlC,OAAO,CAAC,cAAc;YASR,YAAY;YAiBZ,iBAAiB;YAKjB,yBAAyB;WAK1B,aAAa,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAuFlD,eAAe,CAAC,OAAO,EAAE;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;IA2BD,OAAO,CAAC,YAAY;CAuFrB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/browserstack/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,eAAe,EACf,cAAc,EAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAsDtC,qBAAa,0BAA2B,YAAW,cAAc;IAC/D,OAAO,CAAC,cAAc,CAAC,CAA6B;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,OAAO,CAA+B;gBAG5C,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,EACrC,WAAW,EAAE,MAAM,GAAG,SAAS;IAU3B,WAAW;IA0EX,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAMlC,OAAO,CAAC,cAAc;YASR,YAAY;YAiBZ,iBAAiB;YAKjB,yBAAyB;WAK1B,aAAa,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAuFlD,eAAe,CAAC,OAAO,EAAE;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;IA2BD,OAAO,CAAC,YAAY;CAuHrB"}

package/dist/providers/browserstack/index.js

@@ -11,6 +11,7 @@ const path_1 = __importDefault(require("path"));
 const types_1 = require("../../types");
 const device_1 = require("../../device");
 const logger_1 = require("../../logger");
+const s3_1 = require("./s3");
 const API_BASE_URL = "https://api-cloud.browserstack.com/app-automate";
 const envVarKeyForBuild = (projectName) => `BROWSERSTACK_APP_URL_${projectName.toUpperCase()}`;
 function getAuthHeader() {
@@ -50,45 +51,59 @@ class BrowserStackDeviceProvider {
             throw new Error("BROWSERSTACK_USERNAME and BROWSERSTACK_ACCESS_KEY are required environment variables for this device provider.");
         }
         const buildPath = this.project.use.buildPath;
-        const isHttpUrl = buildPath.startsWith("http");
+        const isS3Url = (0, s3_1.isS3Uri)(buildPath);
+        const isHttpUrl = !isS3Url && buildPath.startsWith("http");
         const isBrowserStackUrl = buildPath.startsWith("bs://");
         let appUrl = undefined;
-        if (isBrowserStackUrl) {
-            appUrl = buildPath;
-        }
-        else {
-            // Upload the file to BrowserStack and get the appUrl
-            let body;
-            let headers = {
-                Authorization: getAuthHeader(),
-            };
-            if (isHttpUrl) {
-                body = new URLSearchParams({
-                    url: buildPath,
-                });
+        let downloadedArtifact;
+        try {
+            if (isBrowserStackUrl) {
+                appUrl = buildPath;
             }
             else {
-                if (!fs_1.default.existsSync(buildPath)) {
-                    throw new Error(`Build file not found: ${buildPath}`);
+                // Upload the file to BrowserStack and get the appUrl
+                let body;
+                let headers = {
+                    Authorization: getAuthHeader(),
+                };
+                let uploadSource = buildPath;
+                if (isS3Url) {
+                    logger_1.logger.log(`Downloading build from S3: ${buildPath}`);
+                    downloadedArtifact = await (0, s3_1.downloadS3Artifact)(buildPath);
+                    uploadSource = downloadedArtifact.filePath;
+                }
+                if (isHttpUrl) {
+                    body = new URLSearchParams({
+                        url: buildPath,
+                    });
+                }
+                else {
+                    if (!fs_1.default.existsSync(uploadSource)) {
+                        throw new Error(`Build file not found: ${uploadSource}`);
+                    }
+                    const form = new form_data_1.default();
+                    form.append("file", fs_1.default.createReadStream(uploadSource));
+                    headers = { ...headers, ...form.getHeaders() };
+                    body = form;
+                }
+                const fetch = (await import("node-fetch")).default;
+                logger_1.logger.log(`Uploading build to BrowserStack: ${uploadSource}`);
+                const response = await fetch(`${API_BASE_URL}/upload`, {
+                    method: "POST",
+                    headers,
+                    body,
+                });
+                const data = await response.json();
+                appUrl = data.app_url;
+                if (!appUrl) {
+                    logger_1.logger.error("Uploading the build failed:", data);
+                    throw new Error(`Failed to upload build to BrowserStack: ${JSON.stringify(data)}`);
                 }
-                const form = new form_data_1.default();
-                form.append("file", fs_1.default.createReadStream(buildPath));
-                headers = { ...headers, ...form.getHeaders() };
-                body = form;
-            }
-            const fetch = (await import("node-fetch")).default;
-            logger_1.logger.log(`Uploading: ${buildPath}`);
-            const response = await fetch(`${API_BASE_URL}/upload`, {
-                method: "POST",
-                headers,
-                body,
-            });
-            const data = await response.json();
-            appUrl = data.app_url;
-            if (!appUrl) {
-                logger_1.logger.error("Uploading the build failed:", data);
             }
         }
+        finally {
+            await downloadedArtifact?.cleanup();
+        }
         process.env[envVarKeyForBuild(this.project.name)] = appUrl;
     }
     async getDevice() {
@@ -235,6 +250,7 @@ class BrowserStackDeviceProvider {
         if (!process.env[envVarKey]) {
             throw new Error(`process.env.${envVarKey} is not set. Did the file upload work?`);
         }
+        const permissionPrompts = deviceConfig?.permissionPrompts;
         const bstackOptions = {
             debug: true,
             interactiveDebugging: true,
@@ -281,6 +297,38 @@ class BrowserStackDeviceProvider {
                 }
             }
         }
+        const capabilities = {
+            "bstack:options": bstackOptions,
+            "appium:app": process.env[envVarKey],
+            "appium:fullReset": true,
+            "appium:settings[snapshotMaxDepth]": 62,
+        };
+        if (platformName === types_1.Platform.ANDROID) {
+            const grantPreference = permissionPrompts?.android?.grantPermissions;
+            if (grantPreference !== "manual") {
+                capabilities["appium:autoGrantPermissions"] =
+                    typeof grantPreference === "boolean" ? grantPreference : true;
+            }
+        }
+        if (platformName === types_1.Platform.IOS) {
+            const iosBehavior = permissionPrompts?.ios?.behavior ?? "accept";
+            if (iosBehavior !== "manual") {
+                const osVersionNumeric = parseFloat(deviceConfig.osVersion);
+                const isFlipped = !Number.isNaN(osVersionNumeric) && osVersionNumeric >= 13;
+                const acceptKey = isFlipped
+                    ? "appium:autoDismissAlerts"
+                    : "appium:autoAcceptAlerts";
+                const dismissKey = isFlipped
+                    ? "appium:autoAcceptAlerts"
+                    : "appium:autoDismissAlerts";
+                if (iosBehavior === "accept") {
+                    capabilities[acceptKey] = true;
+                }
+                if (iosBehavior === "dismiss") {
+                    capabilities[dismissKey] = true;
+                }
+            }
+        }
         return {
             port: 443,
             path: "/wd/hub",
@@ -289,14 +337,7 @@ class BrowserStackDeviceProvider {
             user: process.env.BROWSERSTACK_USERNAME,
             key: process.env.BROWSERSTACK_ACCESS_KEY,
             hostname: "hub.browserstack.com",
-            capabilities: {
-                "bstack:options": bstackOptions,
-                "appium:autoGrantPermissions": true,
-                "appium:app": process.env[envVarKey],
-                "appium:autoAcceptAlerts": true,
-                "appium:fullReset": true,
-                "appium:settings[snapshotMaxDepth]": 62,
-            },
+            capabilities,
         };
     }
 }

package/dist/providers/browserstack/s3.d.ts

@@ -0,0 +1,11 @@
+export type DownloadedS3Artifact = {
+    filePath: string;
+    cleanup: () => Promise<void>;
+};
+export declare function isS3Uri(value: string): boolean;
+export declare function parseS3Uri(uri: string): {
+    bucket: string;
+    key: string;
+};
+export declare function downloadS3Artifact(uri: string): Promise<DownloadedS3Artifact>;
+//# sourceMappingURL=s3.d.ts.map

package/dist/providers/browserstack/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../../src/providers/browserstack/s3.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAoBvE;AAgDD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,oBAAoB,CAAC,CA8B/B"}

package/dist/providers/browserstack/s3.js

@@ -0,0 +1,102 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isS3Uri = isS3Uri;
+exports.parseS3Uri = parseS3Uri;
+exports.downloadS3Artifact = downloadS3Artifact;
+const fs_1 = __importDefault(require("fs"));
+const promises_1 = __importDefault(require("fs/promises"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const promises_2 = require("stream/promises");
+const stream_1 = require("stream");
+const client_s3_1 = require("@aws-sdk/client-s3");
+const S3_SCHEME = "s3://";
+const TEMP_PREFIX = "appwright-s3-";
+function isS3Uri(value) {
+    return value.startsWith(S3_SCHEME);
+}
+function parseS3Uri(uri) {
+    if (!isS3Uri(uri)) {
+        throw new Error(`Invalid S3 URI: ${uri}`);
+    }
+    const remainder = uri.slice(S3_SCHEME.length);
+    const firstSlash = remainder.indexOf("/");
+    if (firstSlash === -1) {
+        throw new Error(`S3 URI must be in the format s3://bucket/key. Received: ${uri}`);
+    }
+    const bucket = remainder.slice(0, firstSlash);
+    const key = remainder.slice(firstSlash + 1);
+    if (!bucket || !key) {
+        throw new Error(`S3 URI must include both bucket and key: ${uri}`);
+    }
+    return {
+        bucket,
+        key: decodeURIComponent(key),
+    };
+}
+async function writeBodyToFile(body, destination) {
+    if (!body) {
+        throw new Error("Received empty S3 object body");
+    }
+    if (body instanceof stream_1.Readable) {
+        await (0, promises_2.pipeline)(body, fs_1.default.createWriteStream(destination));
+        return;
+    }
+    if (typeof body.transformToByteArray === "function") {
+        const bytes = await body.transformToByteArray();
+        await promises_1.default.writeFile(destination, Buffer.from(bytes));
+        return;
+    }
+    if (typeof body.arrayBuffer === "function") {
+        const buffer = Buffer.from(await body.arrayBuffer());
+        await promises_1.default.writeFile(destination, buffer);
+        return;
+    }
+    if (Symbol.asyncIterator in Object(body)) {
+        const chunks = [];
+        const iterable = body;
+        for await (const chunk of iterable) {
+            if (typeof chunk === "string") {
+                chunks.push(Buffer.from(chunk));
+            }
+            else if (chunk instanceof Uint8Array) {
+                chunks.push(Buffer.from(chunk));
+            }
+            else {
+                chunks.push(Buffer.from(String(chunk)));
+            }
+        }
+        await promises_1.default.writeFile(destination, Buffer.concat(chunks));
+        return;
+    }
+    throw new Error("Unsupported S3 response body type");
+}
+async function downloadS3Artifact(uri) {
+    const { bucket, key } = parseS3Uri(uri);
+    const region = process.env.AWS_REGION ?? process.env.AWS_DEFAULT_REGION;
+    if (!region) {
+        throw new Error("Set AWS_REGION or AWS_DEFAULT_REGION to download builds from S3.");
+    }
+    const client = new client_s3_1.S3Client({ region });
+    const command = new client_s3_1.GetObjectCommand({ Bucket: bucket, Key: key });
+    const response = await client.send(command);
+    const tmpDir = await promises_1.default.mkdtemp(path_1.default.join(os_1.default.tmpdir(), TEMP_PREFIX));
+    const fileName = key.split("/").filter(Boolean).pop() ?? "artifact";
+    const destination = path_1.default.join(tmpDir, fileName);
+    try {
+        await writeBodyToFile(response.Body, destination);
+    }
+    catch (error) {
+        await promises_1.default.rm(tmpDir, { recursive: true, force: true });
+        throw error;
+    }
+    return {
+        filePath: destination,
+        cleanup: async () => {
+            await promises_1.default.rm(tmpDir, { recursive: true, force: true });
+        },
+    };
+}

package/dist/tests/browserstack.permissions.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browserstack.permissions.spec.d.ts.map

package/dist/tests/browserstack.permissions.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserstack.permissions.spec.d.ts","sourceRoot":"","sources":["../../src/tests/browserstack.permissions.spec.ts"],"names":[],"mappings":""}

package/dist/tests/browserstack.permissions.spec.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const browserstack_1 = require("../providers/browserstack");
+const types_1 = require("../types");
+const makeEnvKey = (projectName) => `BROWSERSTACK_APP_URL_${projectName.toUpperCase()}`;
+const baseDevice = {
+    provider: "browserstack",
+    name: "Test Device",
+    osVersion: "14",
+};
+const makeProvider = (platform, deviceOverrides = {}) => {
+    const projectName = "mobile";
+    const project = {
+        name: projectName,
+        use: {
+            buildPath: "bs://app-url",
+            platform,
+            expectTimeout: 5_000,
+            device: {
+                ...baseDevice,
+                ...deviceOverrides,
+            },
+        },
+    };
+    const provider = new browserstack_1.BrowserStackDeviceProvider(project, undefined);
+    process.env[makeEnvKey(projectName)] = "bs://app-url";
+    return { provider, projectName };
+};
+(0, vitest_1.afterEach)(() => {
+    delete process.env.BROWSERSTACK_USERNAME;
+    delete process.env.BROWSERSTACK_ACCESS_KEY;
+    Object.keys(process.env)
+        .filter((key) => key.startsWith("BROWSERSTACK_APP_URL_"))
+        .forEach((key) => delete process.env[key]);
+});
+(0, vitest_1.describe)("BrowserStack permission prompt capabilities", () => {
+    (0, vitest_1.test)("android defaults to auto-granting permissions", () => {
+        const { provider } = makeProvider(types_1.Platform.ANDROID);
+        const config = provider.createConfig();
+        (0, vitest_1.expect)(config.capabilities["appium:autoGrantPermissions"]).toBe(true);
+    });
+    (0, vitest_1.test)("android manual mode omits autoGrantPermissions capability", () => {
+        const { provider } = makeProvider(types_1.Platform.ANDROID, {
+            permissionPrompts: { android: { grantPermissions: "manual" } },
+        });
+        const config = provider.createConfig();
+        (0, vitest_1.expect)(config.capabilities).not.toHaveProperty("appium:autoGrantPermissions");
+    });
+    (0, vitest_1.test)("ios defaults to accepting alerts below iOS 13", () => {
+        const { provider } = makeProvider(types_1.Platform.IOS, {
+            osVersion: "12.4",
+        });
+        const config = provider.createConfig();
+        (0, vitest_1.expect)(config.capabilities["appium:autoAcceptAlerts"]).toBe(true);
+        (0, vitest_1.expect)(config.capabilities["appium:autoDismissAlerts"]).toBeUndefined();
+    });
+    (0, vitest_1.test)("ios defaults to accepting alerts on iOS 13+ using flipped capability", () => {
+        const { provider } = makeProvider(types_1.Platform.IOS, {
+            osVersion: "14.0",
+        });
+        const config = provider.createConfig();
+        (0, vitest_1.expect)(config.capabilities["appium:autoDismissAlerts"]).toBe(true);
+        (0, vitest_1.expect)(config.capabilities["appium:autoAcceptAlerts"]).toBeUndefined();
+    });
+    (0, vitest_1.test)("ios manual mode omits alert capabilities", () => {
+        const { provider } = makeProvider(types_1.Platform.IOS, {
+            osVersion: "15",
+            permissionPrompts: { ios: { behavior: "manual" } },
+        });
+        const config = provider.createConfig();
+        (0, vitest_1.expect)(config.capabilities).not.toHaveProperty("appium:autoAcceptAlerts");
+        (0, vitest_1.expect)(config.capabilities).not.toHaveProperty("appium:autoDismissAlerts");
+    });
+    (0, vitest_1.test)("ios dismiss behavior sets appropriate capability", () => {
+        const { provider } = makeProvider(types_1.Platform.IOS, {
+            osVersion: "12.0",
+            permissionPrompts: { ios: { behavior: "dismiss" } },
+        });
+        const config = provider.createConfig();
+        (0, vitest_1.expect)(config.capabilities["appium:autoDismissAlerts"]).toBe(true);
+        (0, vitest_1.expect)(config.capabilities["appium:autoAcceptAlerts"]).toBeUndefined();
+    });
+    (0, vitest_1.test)("ios dismiss on 13+ flips to autoAcceptAlerts capability", () => {
+        const { provider } = makeProvider(types_1.Platform.IOS, {
+            osVersion: "16.0",
+            permissionPrompts: { ios: { behavior: "dismiss" } },
+        });
+        const config = provider.createConfig();
+        (0, vitest_1.expect)(config.capabilities["appium:autoAcceptAlerts"]).toBe(true);
+        (0, vitest_1.expect)(config.capabilities["appium:autoDismissAlerts"]).toBeUndefined();
+    });
+});

package/dist/tests/browserstack.s3.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browserstack.s3.spec.d.ts.map

package/dist/tests/browserstack.s3.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserstack.s3.spec.d.ts","sourceRoot":"","sources":["../../src/tests/browserstack.s3.spec.ts"],"names":[],"mappings":""}

package/dist/tests/browserstack.s3.spec.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const stream_1 = require("stream");
+const promises_1 = __importDefault(require("fs/promises"));
+const sendMock = vitest_1.vi.fn();
+const capturedConfigs = [];
+vitest_1.vi.mock("@aws-sdk/client-s3", () => {
+    class MockS3Client {
+        constructor(options) {
+            capturedConfigs.push(options);
+        }
+        send = sendMock;
+    }
+    class MockGetObjectCommand {
+        input;
+        constructor(input) {
+            this.input = input;
+        }
+    }
+    return {
+        S3Client: MockS3Client,
+        GetObjectCommand: MockGetObjectCommand,
+        __esModule: true,
+    };
+});
+let browserstackS3;
+(0, vitest_1.beforeAll)(async () => {
+    browserstackS3 = await import("../providers/browserstack/s3.js");
+});
+(0, vitest_1.afterEach)(async () => {
+    sendMock.mockReset();
+    capturedConfigs.length = 0;
+    delete process.env.AWS_REGION;
+    delete process.env.AWS_DEFAULT_REGION;
+});
+(0, vitest_1.describe)("browserstack S3 helpers", () => {
+    (0, vitest_1.test)("parseS3Uri extracts bucket and decoded key", () => {
+        const result = browserstackS3.parseS3Uri("s3://my-bucket/builds/app%20v2.ipa");
+        (0, vitest_1.expect)(result).toEqual({
+            bucket: "my-bucket",
+            key: "builds/app v2.ipa",
+        });
+    });
+    (0, vitest_1.test)("downloadS3Artifact saves file locally and cleans up", async () => {
+        process.env.AWS_REGION = "us-west-2";
+        sendMock.mockResolvedValueOnce({
+            Body: stream_1.Readable.from(["test-binary"]),
+        });
+        const artifact = await browserstackS3.downloadS3Artifact("s3://test-bucket/apps/mobile.apk");
+        const fileContents = await promises_1.default.readFile(artifact.filePath, "utf-8");
+        (0, vitest_1.expect)(fileContents).toBe("test-binary");
+        (0, vitest_1.expect)(sendMock).toHaveBeenCalledTimes(1);
+        (0, vitest_1.expect)(sendMock.mock.calls[0]?.[0]).toMatchObject({
+            input: { Bucket: "test-bucket", Key: "apps/mobile.apk" },
+        });
+        (0, vitest_1.expect)(capturedConfigs[0]).toMatchObject({ region: "us-west-2" });
+        await artifact.cleanup();
+        await (0, vitest_1.expect)(promises_1.default.stat(artifact.filePath)).rejects.toMatchObject({
+            code: "ENOENT",
+        });
+    });
+    (0, vitest_1.test)("downloadS3Artifact throws when region is missing", async () => {
+        sendMock.mockResolvedValueOnce({
+            Body: stream_1.Readable.from(["unused"]),
+        });
+        await (0, vitest_1.expect)(browserstackS3.downloadS3Artifact("s3://bucket/key")).rejects.toThrow(/AWS_REGION/);
+        (0, vitest_1.expect)(sendMock).not.toHaveBeenCalled();
+    });
+    (0, vitest_1.test)("isS3Uri differentiates schemes", () => {
+        (0, vitest_1.expect)(browserstackS3.isS3Uri("s3://bucket/key")).toBe(true);
+        (0, vitest_1.expect)(browserstackS3.isS3Uri("https://example.com/app.apk")).toBe(false);
+        (0, vitest_1.expect)(browserstackS3.isS3Uri("bs://sample-app")).toBe(false);
+    });
+});

package/dist/types/index.d.ts

@@ -126,6 +126,25 @@ export type BrowserStackConfig = {
      * ```
      */
     updateAppSettings?: IosAppSettings;
+    /**
+     * Controls how BrowserStack handles system permission prompts for this device.
+     * Defaults to automatically granting Android permissions and accepting iOS alerts.
+     */
+    permissionPrompts?: BrowserStackPermissionPrompts;
+};
+export type BrowserStackPermissionPrompts = {
+    android?: {
+        /**
+         * When true, auto-grant Android app permissions on install. Set to false to disable, or "manual" to omit the capability entirely.
+         */
+        grantPermissions?: boolean | "manual";
+    };
+    ios?: {
+        /**
+         * Desired handling for iOS permission alerts. Defaults to "accept" and accounts for the iOS 13+ capability flip.
+         */
+        behavior?: "accept" | "dismiss" | "manual";
+    };
 };
 export type LambdaTestConfig = {
     provider: "lambdatest";

package/dist/types/index.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@samsara-dev/appwright",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -36,6 +36,7 @@
   "license": "Apache-2.0",
   "description": "E2E mobile app testing done right, with the Playwright test runner",
   "dependencies": {
+    "@aws-sdk/client-s3": "^3.932.0",
     "@empiricalrun/llm": "^0.9.25",
     "@ffmpeg-installer/ffmpeg": "^1.1.0",
     "@playwright/test": "^1.56.1",