@samsara-dev/appwright 0.3.5 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # appwright
 
+## 0.5.0
+
+### Minor Changes
+
+- c40123e: Add per-test status syncing for persistentDevice so BrowserStack and LambdaTest sessions reflect test names and outcomes.
+
+## 0.4.0
+
+### Minor Changes
+
+- ddb33f3: Add BrowserStack `updateAppSettings` support for iOS devices, including runtime helpers, provider capability forwarding, and documentation.
+
 ## 0.3.5
 
 ### Patch Changes

package/README.md

@@ -116,6 +116,37 @@ the provider in your config.
 },
 ```
 
+#### iOS App Settings (BrowserStack)
+
+Configure iOS permissions by default in your config:
+
+```ts
+{
+  name: "ios",
+  use: {
+    platform: Platform.IOS,
+    device: {
+      provider: "browserstack",
+      name: "iPhone 16 Pro",
+      osVersion: "18",
+      updateAppSettings: {
+        "Permission Settings": {
+          Location: {
+            "ALLOW LOCATION ACCESS": "Always",
+            "Precise Location": "ON"
+          }
+        }
+      }
+    },
+    buildPath: "bs://<app-id>",
+  },
+}
+
+// Tests run with permissions already granted - no setup needed!
+```
+
+See the [iOS App Settings documentation](./docs/ios-app-settings-browserstack.md) for more details.
+
 #### Run tests on LambdaTest
 
 Appwright supports LambdaTest out of the box. To run tests on LambdaTest, configure

package/dist/device/index.d.ts

@@ -1,5 +1,5 @@
 import type { Client as WebDriverClient } from "webdriver";
-import { AppwrightLocator, ExtractType, Platform, TimeoutOptions, VisualTraceConfig } from "../types";
+import { AppwrightLocator, DeviceProvider, ExtractType, IosAppSettings, IosPermissionSettings, Platform, TimeoutOptions, VisualTraceConfig } from "../types";
 import { z } from "zod";
 import { LLMModel } from "@empiricalrun/llm";
 import { TestInfo } from "@playwright/test";
@@ -9,7 +9,20 @@ export declare class Device {
     private timeoutOpts;
     private provider;
     private visualTraceService?;
-    constructor(webDriverClient: WebDriverClient, bundleId: string | undefined, timeoutOpts: TimeoutOptions, provider: string);
+    private deviceProvider?;
+    private persistentSyncEnabled;
+    private activePersistentKey?;
+    constructor(webDriverClient: WebDriverClient, bundleId: string | undefined, timeoutOpts: TimeoutOptions, provider: string, deviceProvider?: DeviceProvider);
+    attachDeviceProvider(provider: DeviceProvider): void;
+    enablePersistentStatusSync(): void;
+    ensurePersistentLifecycle(testInfo: TestInfo): Promise<void>;
+    preparePersistentTest(testInfo: TestInfo): Promise<void>;
+    finalizePersistentTest(testInfo: TestInfo): Promise<void>;
+    private shouldSyncPersistent;
+    private persistentKey;
+    private mapPlaywrightStatus;
+    private failureReason;
+    private safeSync;
     /**
      * Initialize Visual Trace Service for screenshot capture during test execution
      */
@@ -196,5 +209,44 @@ export declare class Device {
      * To fill input fields using the selectors use `sendKeyStrokes` method from locator
      */
     sendKeyStrokes(value: string): Promise<void>;
+    /**
+     * Updates iOS app settings via BrowserStack executor (mid-session).
+     * For default settings, prefer configuring them in appwright.config.ts.
+     *
+     * @param args - Permission settings or Settings bundle entries
+     * @example
+     * // Update permissions mid-session
+     * await device.updateAppSettings({
+     *   'Permission Settings': { Camera: 'Allow' }
+     * });
+     *
+     * @example
+     * // Update custom settings
+     * await device.updateAppSettings({
+     *   'DarkMode': 1,
+     *   'Environment': 'production'
+     * });
+     */
+    updateAppSettings(args: IosAppSettings): Promise<void>;
+    /**
+     * Convenience method for updating iOS permission settings mid-session.
+     * For default permissions, prefer configuring them in appwright.config.ts.
+     *
+     * @param settings - iOS permission settings to update
+     * @example
+     * await device.updatePermissionSettings({
+     *   Location: {
+     *     'ALLOW LOCATION ACCESS': 'Always',
+     *     'Precise Location': 'ON'
+     *   },
+     *   Camera: 'Allow'
+     * });
+     */
+    updatePermissionSettings(settings: IosPermissionSettings): Promise<void>;
+    /**
+     * Validates that the current platform is iOS and provider is BrowserStack.
+     * @private
+     */
+    private assertIOSBrowserStack;
 }
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/device/index.js

@@ -56,6 +56,8 @@ let Device = (() => {
     let _screenshot_decorators;
     let _scroll_decorators;
     let _sendKeyStrokes_decorators;
+    let _updateAppSettings_decorators;
+    let _updatePermissionSettings_decorators;
     return class Device {
         static {
             const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
@@ -70,6 +72,8 @@ let Device = (() => {
             _screenshot_decorators = [utils_1.boxedStep];
             _scroll_decorators = [utils_1.boxedStep];
             _sendKeyStrokes_decorators = [utils_1.boxedStep];
+            _updateAppSettings_decorators = [utils_1.boxedStep];
+            _updatePermissionSettings_decorators = [utils_1.boxedStep];
             __esDecorate(this, null, _tap_decorators, { kind: "method", name: "tap", static: false, private: false, access: { has: obj => "tap" in obj, get: obj => obj.tap }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _terminateApp_decorators, { kind: "method", name: "terminateApp", static: false, private: false, access: { has: obj => "terminateApp" in obj, get: obj => obj.terminateApp }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _activateApp_decorators, { kind: "method", name: "activateApp", static: false, private: false, access: { has: obj => "activateApp" in obj, get: obj => obj.activateApp }, metadata: _metadata }, null, _instanceExtraInitializers);
@@ -81,6 +85,8 @@ let Device = (() => {
             __esDecorate(this, null, _screenshot_decorators, { kind: "method", name: "screenshot", static: false, private: false, access: { has: obj => "screenshot" in obj, get: obj => obj.screenshot }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _scroll_decorators, { kind: "method", name: "scroll", static: false, private: false, access: { has: obj => "scroll" in obj, get: obj => obj.scroll }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _sendKeyStrokes_decorators, { kind: "method", name: "sendKeyStrokes", static: false, private: false, access: { has: obj => "sendKeyStrokes" in obj, get: obj => obj.sendKeyStrokes }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _updateAppSettings_decorators, { kind: "method", name: "updateAppSettings", static: false, private: false, access: { has: obj => "updateAppSettings" in obj, get: obj => obj.updateAppSettings }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _updatePermissionSettings_decorators, { kind: "method", name: "updatePermissionSettings", static: false, private: false, access: { has: obj => "updatePermissionSettings" in obj, get: obj => obj.updatePermissionSettings }, metadata: _metadata }, null, _instanceExtraInitializers);
             if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
         webDriverClient = __runInitializers(this, _instanceExtraInitializers);
@@ -88,11 +94,95 @@ let Device = (() => {
         timeoutOpts;
         provider;
         visualTraceService;
-        constructor(webDriverClient, bundleId, timeoutOpts, provider) {
+        deviceProvider;
+        persistentSyncEnabled = false;
+        activePersistentKey;
+        constructor(webDriverClient, bundleId, timeoutOpts, provider, deviceProvider) {
             this.webDriverClient = webDriverClient;
             this.bundleId = bundleId;
             this.timeoutOpts = timeoutOpts;
             this.provider = provider;
+            this.deviceProvider = deviceProvider;
+        }
+        attachDeviceProvider(provider) {
+            this.deviceProvider = provider;
+        }
+        enablePersistentStatusSync() {
+            this.persistentSyncEnabled = true;
+        }
+        async ensurePersistentLifecycle(testInfo) {
+            if (!this.shouldSyncPersistent()) {
+                return;
+            }
+            await this.preparePersistentTest(testInfo);
+        }
+        async preparePersistentTest(testInfo) {
+            if (!this.shouldSyncPersistent()) {
+                return;
+            }
+            const key = this.persistentKey(testInfo);
+            if (this.activePersistentKey === key) {
+                return;
+            }
+            this.activePersistentKey = key;
+            await this.safeSync({ name: testInfo.title });
+        }
+        async finalizePersistentTest(testInfo) {
+            if (!this.shouldSyncPersistent()) {
+                return;
+            }
+            const key = this.persistentKey(testInfo);
+            if (!this.activePersistentKey) {
+                logger_1.logger.warn("finalizePersistentTest called before preparePersistentTest; syncing anyway.");
+            }
+            else if (this.activePersistentKey !== key) {
+                logger_1.logger.warn("finalizePersistentTest received unexpected test key; syncing anyway.");
+            }
+            const status = this.mapPlaywrightStatus(testInfo.status);
+            const reason = status === "failed" ? this.failureReason(testInfo) : undefined;
+            await this.safeSync({
+                name: testInfo.title,
+                status,
+                reason,
+            });
+            this.activePersistentKey = undefined;
+        }
+        shouldSyncPersistent() {
+            return (this.persistentSyncEnabled === true &&
+                typeof this.deviceProvider?.syncTestDetails === "function");
+        }
+        persistentKey(testInfo) {
+            return `${testInfo.testId}#${testInfo.retry}`;
+        }
+        mapPlaywrightStatus(status) {
+            switch (status) {
+                case "failed":
+                case "timedOut":
+                case "interrupted":
+                    return "failed";
+                case "passed":
+                case "skipped":
+                default:
+                    return "passed";
+            }
+        }
+        failureReason(testInfo) {
+            const error = testInfo.errors?.[0];
+            if (error?.message) {
+                return error.message;
+            }
+            return testInfo.error?.message;
+        }
+        async safeSync(details) {
+            if (!this.deviceProvider?.syncTestDetails) {
+                return;
+            }
+            try {
+                await this.deviceProvider.syncTestDetails(details);
+            }
+            catch (error) {
+                logger_1.logger.warn("Failed to sync test details", error);
+            }
         }
         /**
          * Initialize Visual Trace Service for screenshot capture during test execution
@@ -458,6 +548,65 @@ let Device = (() => {
             ]);
             await this.webDriverClient.releaseActions();
         }
+        /**
+         * Updates iOS app settings via BrowserStack executor (mid-session).
+         * For default settings, prefer configuring them in appwright.config.ts.
+         *
+         * @param args - Permission settings or Settings bundle entries
+         * @example
+         * // Update permissions mid-session
+         * await device.updateAppSettings({
+         *   'Permission Settings': { Camera: 'Allow' }
+         * });
+         *
+         * @example
+         * // Update custom settings
+         * await device.updateAppSettings({
+         *   'DarkMode': 1,
+         *   'Environment': 'production'
+         * });
+         */
+        async updateAppSettings(args) {
+            this.assertIOSBrowserStack("updateAppSettings");
+            const executor = {
+                action: "updateAppSettings",
+                arguments: args,
+            };
+            const script = `browserstack_executor: ${JSON.stringify(executor)}`;
+            await this.webDriverClient.executeScript(script, []);
+        }
+        /**
+         * Convenience method for updating iOS permission settings mid-session.
+         * For default permissions, prefer configuring them in appwright.config.ts.
+         *
+         * @param settings - iOS permission settings to update
+         * @example
+         * await device.updatePermissionSettings({
+         *   Location: {
+         *     'ALLOW LOCATION ACCESS': 'Always',
+         *     'Precise Location': 'ON'
+         *   },
+         *   Camera: 'Allow'
+         * });
+         */
+        async updatePermissionSettings(settings) {
+            return this.updateAppSettings({ "Permission Settings": settings });
+        }
+        /**
+         * Validates that the current platform is iOS and provider is BrowserStack.
+         * @private
+         */
+        assertIOSBrowserStack(methodName) {
+            if (this.getPlatform() !== types_1.Platform.IOS) {
+                throw new Error(`${methodName} is only supported on iOS platform. ` +
+                    `Current platform: ${this.getPlatform()}`);
+            }
+            if (this.provider !== "browserstack") {
+                throw new Error(`${methodName} is only supported with BrowserStack provider. ` +
+                    `Current provider: ${this.provider}. ` +
+                    `See https://www.browserstack.com/docs/app-automate/appium/advanced-features/ios-app-settings`);
+            }
+        }
     };
 })();
 exports.Device = Device;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fixture/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EAGd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAKnC,KAAK,iBAAiB,GAAG;IACvB;;;OAGG;IACH,cAAc,EAAE,cAAc,CAAC;IAE/B;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,IAAI,uRAyEf,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM;2BACY,gBAAgB,YAAY,aAAa;;;;;;;EAUtE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fixture/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EAGd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAqDnC,KAAK,iBAAiB,GAAG;IACvB;;;OAGG;IACH,cAAc,EAAE,cAAc,CAAC;IAE/B;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,IAAI,uRAkFf,CAAC;AA8BH;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM;2BACY,gBAAgB,YAAY,aAAa;;;;;;;EAUtE,CAAC"}

package/dist/fixture/index.js

@@ -5,6 +5,39 @@ const test_1 = require("@playwright/test");
 const providers_1 = require("../providers");
 const workerInfo_1 = require("./workerInfo");
 const appium_1 = require("../providers/appium");
+const logger_1 = require("../logger");
+const persistentDevicesByWorker = new Map();
+function createPersistentContext(device) {
+    return {
+        device,
+        activeOperations: 0,
+    };
+}
+async function runWithLifecycle(context, task) {
+    context.activeOperations += 1;
+    try {
+        await task();
+    }
+    finally {
+        context.activeOperations -= 1;
+        if (context.activeOperations === 0 && context.resolveIdle) {
+            context.resolveIdle();
+            context.resolveIdle = undefined;
+            context.idlePromise = undefined;
+        }
+    }
+}
+async function waitForLifecycleToComplete(context) {
+    if (context.activeOperations === 0) {
+        return;
+    }
+    if (!context.idlePromise) {
+        context.idlePromise = new Promise((resolve) => {
+            context.resolveIdle = resolve;
+        });
+    }
+    await context.idlePromise;
+}
 exports.test = test_1.test.extend({
     deviceProvider: async ({}, use, testInfo) => {
         const deviceProvider = (0, providers_1.createDeviceProvider)(testInfo.project);
@@ -54,13 +87,51 @@ exports.test = test_1.test.extend({
             const afterSession = new Date();
             const workerInfoStore = new workerInfo_1.WorkerInfoStore();
             await workerInfoStore.saveWorkerStartTime(workerIndex, sessionId, providerName, beforeSession, afterSession);
-            await use(device);
-            await workerInfoStore.saveWorkerEndTime(workerIndex, new Date());
-            await device.close();
+            device.attachDeviceProvider(deviceProvider);
+            device.enablePersistentStatusSync();
+            const context = createPersistentContext(device);
+            persistentDevicesByWorker.set(workerIndex, context);
+            try {
+                await use(device);
+            }
+            finally {
+                await waitForLifecycleToComplete(context);
+                persistentDevicesByWorker.delete(workerIndex);
+                await workerInfoStore.saveWorkerEndTime(workerIndex, new Date());
+                await device.close();
+            }
         },
         { scope: "worker" },
     ],
 });
+exports.test.beforeEach(async ({}, testInfo) => {
+    const context = persistentDevicesByWorker.get(testInfo.workerIndex);
+    if (!context) {
+        return;
+    }
+    await runWithLifecycle(context, async () => {
+        try {
+            await context.device.preparePersistentTest(testInfo);
+        }
+        catch (error) {
+            logger_1.logger.warn("Failed to prepare persistent test", error);
+        }
+    });
+});
+exports.test.afterEach(async ({}, testInfo) => {
+    const context = persistentDevicesByWorker.get(testInfo.workerIndex);
+    if (!context) {
+        return;
+    }
+    await runWithLifecycle(context, async () => {
+        try {
+            await context.device.finalizePersistentTest(testInfo);
+        }
+        catch (error) {
+            logger_1.logger.warn("Failed to finalize persistent test", error);
+        }
+    });
+});
 /**
  * Function to extend Playwright’s expect assertion capabilities.
  * This adds a new method `toBeVisible` which checks if an element is visible on the screen.

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,EAEf,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;YAgBZ,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;CAuDrB"}
+{"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;CA2FrB"}

package/dist/providers/browserstack/index.js

@@ -8,6 +8,7 @@ const async_retry_1 = __importDefault(require("async-retry"));
 const fs_1 = __importDefault(require("fs"));
 const form_data_1 = __importDefault(require("form-data"));
 const path_1 = __importDefault(require("path"));
+const types_1 = require("../../types");
 const device_1 = require("../../device");
 const logger_1 = require("../../logger");
 const API_BASE_URL = "https://api-cloud.browserstack.com/app-automate";
@@ -109,7 +110,7 @@ class BrowserStackDeviceProvider {
         const testOptions = {
             expectTimeout: this.project.use.expectTimeout,
         };
-        return new device_1.Device(webDriverClient, bundleId, testOptions, this.project.use.device?.provider);
+        return new device_1.Device(webDriverClient, bundleId, testOptions, this.project.use.device?.provider, this);
     }
     async getSessionDetails() {
         const data = await getSessionDetails(this.sessionId);
@@ -254,6 +255,35 @@ class BrowserStackDeviceProvider {
         if (typeof deviceConfig?.appProfiling === "boolean") {
             bstackOptions.appProfiling = deviceConfig.appProfiling;
         }
+        // iOS App Settings support (capability-based for session start)
+        if (platformName === types_1.Platform.IOS) {
+            // Support environment variable override for CI/CD
+            const envSettingsJson = process.env.APPWRIGHT_BS_UPDATE_APP_SETTINGS_JSON;
+            let updateAppSettings;
+            if (envSettingsJson) {
+                try {
+                    updateAppSettings = JSON.parse(envSettingsJson);
+                }
+                catch (e) {
+                    throw new Error("APPWRIGHT_BS_UPDATE_APP_SETTINGS_JSON is not valid JSON. " +
+                        "Provide a valid JSON string.");
+                }
+            }
+            else {
+                updateAppSettings = deviceConfig?.updateAppSettings;
+            }
+            if (updateAppSettings && typeof updateAppSettings === "object") {
+                // Add to bstack:options as per BrowserStack documentation
+                bstackOptions.updateAppSettings = updateAppSettings;
+                // Log for debugging (without exposing sensitive data)
+                const u = updateAppSettings;
+                const hasPermissions = !!u["Permission Settings"];
+                const customKeys = Object.keys(u).filter((k) => k !== "Permission Settings");
+                if (hasPermissions || customKeys.length > 0) {
+                    logger_1.logger.log(`iOS app settings configured: permissions=${hasPermissions}, custom_keys=${customKeys.length}`);
+                }
+            }
+        }
         return {
             port: 443,
             path: "/wd/hub",

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/emulator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EAIf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAOtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,qBAAa,gBAAiB,YAAW,cAAc;IAInD,OAAO,CAAC,OAAO;IAHjB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGT,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,EAC7C,WAAW,EAAE,MAAM,GAAG,SAAS;IAS3B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,WAAW;YA8BH,YAAY;YAwBZ,YAAY;CAmC3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/emulator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EAIf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAOtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,qBAAa,gBAAiB,YAAW,cAAc;IAInD,OAAO,CAAC,OAAO;IAHjB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGT,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,EAC7C,WAAW,EAAE,MAAM,GAAG,SAAS;IAS3B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,WAAW;YA8BH,YAAY;YAyBZ,YAAY;CAmC3B"}

package/dist/providers/emulator/index.js

@@ -49,7 +49,7 @@ Follow the steps mentioned in ${androidSimulatorConfigDocLink} to run test on An
         const testOptions = {
             expectTimeout,
         };
-        return new device_1.Device(webDriverClient, undefined, testOptions, this.project.use.device?.provider);
+        return new device_1.Device(webDriverClient, undefined, testOptions, this.project.use.device?.provider, this);
     }
     async createConfig() {
         const platformName = this.project.use.platform;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/lambdatest/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAoB,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAwDtC,qBAAa,wBAAyB,YAAW,cAAc;IAM3D,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,WAAW;IANrB,OAAO,CAAC,cAAc,CAAC,CAA2B;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,WAAW,CAAgC;gBAGzC,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,EACrC,WAAW,EAAE,MAAM,GAAG,SAAS;IASnC,WAAW;IA8DX,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAMlC,OAAO,CAAC,cAAc;YASR,YAAY;WAeb,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;IA6ElD,eAAe,CAAC,OAAO,EAAE;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;IA0BD,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,YAAY;CA8CrB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/lambdatest/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAoB,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAwDtC,qBAAa,wBAAyB,YAAW,cAAc;IAM3D,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,WAAW;IANrB,OAAO,CAAC,cAAc,CAAC,CAA2B;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,WAAW,CAAgC;gBAGzC,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,EACrC,WAAW,EAAE,MAAM,GAAG,SAAS;IASnC,WAAW;IA8DX,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAMlC,OAAO,CAAC,cAAc;YASR,YAAY;WAgBb,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;IA6ElD,eAAe,CAAC,OAAO,EAAE;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;IA0BD,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,YAAY;CA8CrB"}

package/dist/providers/lambdatest/index.js

@@ -119,7 +119,7 @@ class LambdaTestDeviceProvider {
         const testOptions = {
             expectTimeout: this.project.use.expectTimeout,
         };
-        return new device_1.Device(webDriverClient, this.appBundleId, testOptions, this.project.use.device?.provider);
+        return new device_1.Device(webDriverClient, this.appBundleId, testOptions, this.project.use.device?.provider, this);
     }
     static async downloadVideo(sessionId, outputDir, fileName) {
         const sessionData = await getSessionDetails(sessionId);

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EAIf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAY/C,qBAAa,mBAAoB,YAAW,cAAc;IAItD,OAAO,CAAC,OAAO;IAHjB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGT,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,EAC7C,WAAW,EAAE,MAAM,GAAG,SAAS;IAS3B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,WAAW;YAgBH,YAAY;YAyBZ,YAAY;CA6C3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EAIf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAY/C,qBAAa,mBAAoB,YAAW,cAAc;IAItD,OAAO,CAAC,OAAO;IAHjB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGT,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,EAC7C,WAAW,EAAE,MAAM,GAAG,SAAS;IAS3B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,WAAW;YAgBH,YAAY;YA0BZ,YAAY;CA6C3B"}

package/dist/providers/local/index.js

@@ -40,7 +40,7 @@ class LocalDeviceProvider {
         const testOptions = {
             expectTimeout,
         };
-        return new device_1.Device(webDriverClient, bundleId, testOptions, this.project.use.device?.provider);
+        return new device_1.Device(webDriverClient, bundleId, testOptions, this.project.use.device?.provider, this);
     }
     async createConfig() {
         const platformName = this.project.use.platform;

package/dist/tests/device.spec.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const vitest_1 = require("vitest");
 const test_1 = __importDefault(require("@playwright/test"));
 const device_1 = require("../device");
+const types_1 = require("../types");
 // Override Playwright's test.step/info to work in Vitest environment
 // so boxedStep decorator can execute without throwing.
 test_1.default.step = vitest_1.vi.fn(async (_name, body) => await body());
@@ -18,6 +19,34 @@ const createDevice = (executeScript = vitest_1.vi.fn()) => {
     const device = new device_1.Device(webDriverClient, "com.example.app", { expectTimeout: 1_000 }, "emulator");
     return { device, executeScript };
 };
+const makeTestInfo = (overrides = {}) => {
+    return {
+        title: "example test",
+        status: "passed",
+        errors: [],
+        error: undefined,
+        testId: "test-id",
+        retry: 0,
+        workerIndex: 0,
+        project: { use: {} },
+        ...overrides,
+    };
+};
+const createPersistentDevice = () => {
+    const { device } = createDevice();
+    const syncTestDetails = vitest_1.vi.fn().mockResolvedValue(undefined);
+    const provider = {
+        getDevice: vitest_1.vi.fn(),
+        syncTestDetails,
+    };
+    device.attachDeviceProvider(provider);
+    device.enablePersistentStatusSync();
+    return {
+        device,
+        syncTestDetails,
+        provider,
+    };
+};
 (0, vitest_1.describe)("Device", () => {
     (0, vitest_1.describe)("backgroundApp", () => {
         (0, vitest_1.test)("backgrounds indefinitely by default", async () => {
@@ -35,4 +64,134 @@ const createDevice = (executeScript = vitest_1.vi.fn()) => {
             ]);
         });
     });
+    (0, vitest_1.describe)("iOS App Settings (BrowserStack)", () => {
+        (0, vitest_1.describe)("updateAppSettings", () => {
+            (0, vitest_1.test)("formats browserstack_executor correctly for settings bundle", async () => {
+                const { device, executeScript } = createDevice();
+                vitest_1.vi.spyOn(device, "getPlatform").mockReturnValue(types_1.Platform.IOS);
+                device["provider"] = "browserstack";
+                const settings = {
+                    DarkMode: 1,
+                    Environment: "staging",
+                    "Child Settings": { "Child Setting 1": "abc" },
+                };
+                await device.updateAppSettings(settings);
+                (0, vitest_1.expect)(executeScript).toHaveBeenCalledWith(vitest_1.expect.stringContaining("browserstack_executor:"), []);
+                const call = executeScript.mock.calls[0][0];
+                const [, payloadString] = call.split("browserstack_executor: ");
+                if (!payloadString) {
+                    throw new Error("Expected browserstack_executor payload to be present");
+                }
+                const payload = JSON.parse(payloadString);
+                (0, vitest_1.expect)(payload).toEqual({
+                    action: "updateAppSettings",
+                    arguments: settings,
+                });
+            });
+            (0, vitest_1.test)("formats permission settings correctly", async () => {
+                const { device, executeScript } = createDevice();
+                vitest_1.vi.spyOn(device, "getPlatform").mockReturnValue(types_1.Platform.IOS);
+                device["provider"] = "browserstack";
+                const permissions = {
+                    "Permission Settings": {
+                        Location: {
+                            "ALLOW LOCATION ACCESS": "Always",
+                            "Precise Location": "ON",
+                        },
+                        Camera: "Allow",
+                    },
+                };
+                await device.updateAppSettings(permissions);
+                const call = executeScript.mock.calls[0][0];
+                const [, payloadString] = call.split("browserstack_executor: ");
+                if (!payloadString) {
+                    throw new Error("Expected browserstack_executor payload to be present");
+                }
+                const payload = JSON.parse(payloadString);
+                (0, vitest_1.expect)(payload.arguments).toEqual(permissions);
+            });
+            (0, vitest_1.test)("throws descriptive error for Android platform", async () => {
+                const { device } = createDevice();
+                vitest_1.vi.spyOn(device, "getPlatform").mockReturnValue(types_1.Platform.ANDROID);
+                device["provider"] = "browserstack";
+                await (0, vitest_1.expect)(device.updateAppSettings({})).rejects.toThrow("updateAppSettings is only supported on iOS platform. Current platform: android");
+            });
+            (0, vitest_1.test)("throws descriptive error for non-BrowserStack provider", async () => {
+                const { device } = createDevice();
+                vitest_1.vi.spyOn(device, "getPlatform").mockReturnValue(types_1.Platform.IOS);
+                device["provider"] = "emulator";
+                await (0, vitest_1.expect)(device.updateAppSettings({})).rejects.toThrow(/only supported with BrowserStack provider.*Current provider: emulator/);
+            });
+        });
+        (0, vitest_1.describe)("updatePermissionSettings", () => {
+            (0, vitest_1.test)("wraps settings in 'Permission Settings' key", async () => {
+                const { device } = createDevice();
+                vitest_1.vi.spyOn(device, "getPlatform").mockReturnValue(types_1.Platform.IOS);
+                device["provider"] = "browserstack";
+                const updateSpy = vitest_1.vi.spyOn(device, "updateAppSettings");
+                const permissions = {
+                    Camera: "Allow",
+                    Photos: "All Photos",
+                    Notifications: { "Allow Notifications": "ON" },
+                };
+                await device.updatePermissionSettings(permissions);
+                (0, vitest_1.expect)(updateSpy).toHaveBeenCalledWith({
+                    "Permission Settings": permissions,
+                });
+            });
+        });
+    });
+    (0, vitest_1.describe)("persistent sync", () => {
+        (0, vitest_1.test)("preparePersistentTest sends name once per test", async () => {
+            const { device, syncTestDetails } = createPersistentDevice();
+            const info = makeTestInfo({ title: "My test", testId: "t-1" });
+            await device.preparePersistentTest(info);
+            await device.preparePersistentTest(info);
+            (0, vitest_1.expect)(syncTestDetails).toHaveBeenCalledTimes(1);
+            (0, vitest_1.expect)(syncTestDetails).toHaveBeenCalledWith({ name: "My test" });
+        });
+        (0, vitest_1.test)("finalizePersistentTest maps failed status and reason", async () => {
+            const { device, syncTestDetails } = createPersistentDevice();
+            const info = makeTestInfo({
+                title: "fails",
+                status: "failed",
+                errors: [{ message: "boom" }],
+                testId: "t-2",
+            });
+            await device.finalizePersistentTest(info);
+            (0, vitest_1.expect)(syncTestDetails).toHaveBeenCalledWith(vitest_1.expect.objectContaining({
+                name: "fails",
+                status: "failed",
+                reason: "boom",
+            }));
+        });
+        (0, vitest_1.test)("ensurePersistentLifecycle triggers sync for new tests", async () => {
+            const { device, syncTestDetails } = createPersistentDevice();
+            const first = makeTestInfo({ title: "first", testId: "first", retry: 0 });
+            const second = makeTestInfo({
+                title: "second",
+                testId: "second",
+                retry: 0,
+            });
+            await device.ensurePersistentLifecycle(first);
+            await device.ensurePersistentLifecycle(second);
+            (0, vitest_1.expect)(syncTestDetails).toHaveBeenNthCalledWith(1, { name: "first" });
+            (0, vitest_1.expect)(syncTestDetails).toHaveBeenNthCalledWith(2, { name: "second" });
+        });
+        (0, vitest_1.test)("finalizePersistentTest defaults skipped to passed without reason", async () => {
+            const { device, syncTestDetails } = createPersistentDevice();
+            const info = makeTestInfo({
+                title: "skipped test",
+                status: "skipped",
+                testId: "t-3",
+            });
+            await device.finalizePersistentTest(info);
+            (0, vitest_1.expect)(syncTestDetails).toHaveBeenCalledWith(vitest_1.expect.objectContaining({
+                name: "skipped test",
+                status: "passed",
+            }));
+            const payload = syncTestDetails.mock.calls[0][0];
+            (0, vitest_1.expect)(payload.reason).toBeUndefined();
+        });
+    });
 });

package/dist/tests/vitest.config.mjs

@@ -1,6 +1,6 @@
 import { defineConfig } from "vitest/config";
 export default defineConfig({
     test: {
-        exclude: ["example/**", "node_modules/**", "dist/**"],
+        exclude: ["**/example/**", "node_modules/**", "dist/**"],
     },
 });

package/dist/types/index.d.ts

@@ -110,6 +110,22 @@ export type BrowserStackConfig = {
      * Defaults to 180 seconds (3 minutes).
      */
     idleTimeout?: number;
+    /**
+     * iOS app settings to configure at session start.
+     * Can include Permission Settings and/or custom Settings Bundle entries.
+     * Only supported on iOS devices with BrowserStack provider.
+     *
+     * @example
+     * ```ts
+     * {
+     *   'Permission Settings': {
+     *     Location: { 'ALLOW LOCATION ACCESS': 'Always' }
+     *   },
+     *   'Environment': 'staging'
+     * }
+     * ```
+     */
+    updateAppSettings?: IosAppSettings;
 };
 export type LambdaTestConfig = {
     provider: "lambdatest";
@@ -179,6 +195,36 @@ export type EmulatorConfig = {
      */
     orientation?: DeviceOrientation;
 };
+/**
+ * iOS permission settings structure (based on BrowserStack API).
+ * Supports both simple string values and nested objects for permissions.
+ */
+export type IosPermissionSettings = Partial<{
+    Location: Partial<{
+        "ALLOW LOCATION ACCESS": "Always" | "While Using the App" | "Never";
+        "Precise Location": "ON" | "OFF";
+    }>;
+    Camera: "Allow" | "Deny";
+    Contacts: "Allow" | "Deny";
+    Photos: "Add Photos Only" | "Selected Photos" | "All Photos" | "None";
+    Notifications: Partial<{
+        "Allow Notifications": "ON" | "OFF";
+    }>;
+    Language: string;
+}>;
+/**
+ * Settings bundle for custom app settings (iOS Settings Bundle).
+ */
+export type IosSettingsBundle = Record<string, unknown>;
+/**
+ * Combined type for all iOS settings (permissions + custom).
+ * Can include Permission Settings, custom Settings Bundle entries, or both.
+ */
+export type IosAppSettings = {
+    "Permission Settings": IosPermissionSettings;
+} | IosSettingsBundle | ({
+    "Permission Settings": IosPermissionSettings;
+} & IosSettingsBundle);
 export declare enum Platform {
     ANDROID = "android",
     IOS = "ios"

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/dist/utils.d.ts

@@ -4,9 +4,11 @@ export declare function boxedStep(target: Function, context: ClassMethodDecorato
     device?: {
         takeScreenshot: () => Promise<Buffer>;
         initializeVisualTrace?: (testInfo: any, retryIndex: number, config?: any) => void;
+        ensurePersistentLifecycle?: (testInfo: TestInfo) => Promise<void>;
     };
     takeScreenshot?: () => Promise<Buffer>;
     initializeVisualTrace?: (testInfo: any, retryIndex: number, config?: any) => void;
+    ensurePersistentLifecycle?: (testInfo: TestInfo) => Promise<void>;
 }, ...args: any) => Promise<any>;
 export declare function validateBuildPath(buildPath: string | undefined, expectedExtension: string): void;
 export declare function getLatestBuildToolsVersions(versions: string[]): string | undefined;

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQlD,wBAAgB,SAAS,CACvB,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,2BAA2B,UAG5B;IACJ,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE;QACP,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,qBAAqB,CAAC,EAAE,CACtB,QAAQ,EAAE,GAAG,EACb,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,GAAG,KACT,IAAI,CAAC;KACX,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,qBAAqB,CAAC,EAAE,CACtB,QAAQ,EAAE,GAAG,EACb,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,GAAG,KACT,IAAI,CAAC;CACX,WACQ,GAAG,kBAwEf;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,iBAAiB,EAAE,MAAM,QAoB1B;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAAE,GACjB,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuB7E;AAED,wBAAgB,QAAQ,WAEvB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CA2BT;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAST"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQlD,wBAAgB,SAAS,CACvB,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,2BAA2B,UAG5B;IACJ,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE;QACP,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,qBAAqB,CAAC,EAAE,CACtB,QAAQ,EAAE,GAAG,EACb,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,GAAG,KACT,IAAI,CAAC;QACV,yBAAyB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACnE,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,qBAAqB,CAAC,EAAE,CACtB,QAAQ,EAAE,GAAG,EACb,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,GAAG,KACT,IAAI,CAAC;IACV,yBAAyB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE,WACQ,GAAG,kBAgFf;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,iBAAiB,EAAE,MAAM,QAoB1B;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAAE,GACjB,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuB7E;AAED,wBAAgB,QAAQ,WAEvB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CA2BT;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAST"}

package/dist/utils.js

@@ -43,6 +43,11 @@ function boxedStep(target, context) {
                     try {
                         const testInfo = test_1.default.info();
                         const device = this.device || this;
+                        if (device &&
+                            typeof device.ensurePersistentLifecycle === "function" &&
+                            testInfo) {
+                            await device.ensurePersistentLifecycle(testInfo);
+                        }
                         // Initialize or reinitialize if needed
                         if (device?.initializeVisualTrace && testInfo) {
                             const needsInit = (0, visualTrace_1.needsVisualTraceReinitialization)(testInfo.testId, testInfo.retry);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@samsara-dev/appwright",
-  "version": "0.3.5",
+  "version": "0.5.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"