@samsara-dev/appwright 0.4.0 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # appwright
 
+## 0.5.1
+
+### Patch Changes
+
+- d5b7e84: Apply BrowserStack iOS permission settings after the app install by default, using a worker fixture so sessions start with the requested configuration.
+
+## 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

package/dist/device/index.d.ts

@@ -1,5 +1,5 @@
 import type { Client as WebDriverClient } from "webdriver";
-import { AppwrightLocator, ExtractType, IosAppSettings, IosPermissionSettings, 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
      */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/device/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,WAAW,CAAC;AAE3D,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,QAAQ,EACR,cAAc,EACd,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAKlB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAO7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,qBAAa,MAAM;IAIf,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,QAAQ;IANlB,OAAO,CAAC,kBAAkB,CAAC,CAAqB;gBAGtC,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,WAAW,EAAE,cAAc,EAC3B,QAAQ,EAAE,MAAM;IAG1B;;OAEG;IACH,qBAAqB,CACnB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,iBAAiB,GACzB,IAAI;IAQP;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvC,OAAO,CAAC,EACN,QAAQ,EACR,YAAY,EACZ,WAAW,GACZ,EAAE;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KAC/B,GAAG,gBAAgB;IAWpB,OAAO,CAAC,MAAM;IAId,IAAI;sBAEQ,MAAM,YACJ;YACR,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,SAAS,CAAC,EAAE;gBACV,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;aACjB,CAAC;SACH,KACA,OAAO,CAAC;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;gBAItB,CAAC,SAAS,CAAC,CAAC,OAAO,UACvB,MAAM,YACJ;YACR,cAAc,CAAC,EAAE,CAAC,CAAC;YACnB,KAAK,CAAC,EAAE,QAAQ,CAAC;YACjB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,SAAS,CAAC,EAAE;gBACV,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;aACjB,CAAC;SACH,KACA,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;MAG1B;IAEF;;;;;;;OAOG;IACG,KAAK;IAiBX;;;;;;;;;;;OAWG;IAEG,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAoB5C;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,EAAE,KAAa,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAC1C,gBAAgB;IAsCnB;;;;;;;;;;;;OAYG;IACH,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,EAAE,KAAa,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAC1C,gBAAgB;IAiBnB;;;;;;;;;;OAUG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAI3C;;;;;;;;;OASG;IACH,WAAW,IAAI,QAAQ;IAMjB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM;IAc9B,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM;IAanC;;;;;;;;;;;;;;;;;OAiBG;IAEG,aAAa,CAAC,OAAO,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxD;;;;;;;;;;OAUG;IAEG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAqBzC;;;;;;;;;;;OAWG;IAEG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBnD,KAAK;IAmBL,cAAc,CAAC,OAAO,EAAE,MAAM;IAIpC;;OAEG;IAEG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC;;;;;;;;;;OAUG;IAEG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAU7B;;;OAGG;IAEG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBlD;;;;;;;;;;;;;;;;;OAiBG;IAEU,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnE;;;;;;;;;;;;;OAaG;IAEU,wBAAwB,CACnC,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,IAAI,CAAC;IAIhB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;CAe9B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/device/index.ts"],"names":[],"mappings":"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"}

package/dist/device/index.js

@@ -94,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

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,EAMd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AA2GnC,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,uRA6Ff,CAAC;AA8BH;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM;2BACY,gBAAgB,YAAY,aAAa;;;;;;;EAUtE,CAAC"}

package/dist/fixture/index.js

@@ -2,9 +2,80 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.expect = exports.test = void 0;
 const test_1 = require("@playwright/test");
+const types_1 = require("../types");
 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();
+async function applyIosAppSettings(project, device) {
+    if (project.use.platform !== types_1.Platform.IOS) {
+        return;
+    }
+    const deviceConfig = project.use.device;
+    if (!deviceConfig || deviceConfig.provider !== "browserstack") {
+        return;
+    }
+    const browserStackConfig = deviceConfig;
+    const envSettingsJson = process.env.APPWRIGHT_BS_UPDATE_APP_SETTINGS_JSON;
+    let settings;
+    if (envSettingsJson) {
+        try {
+            settings = JSON.parse(envSettingsJson);
+        }
+        catch (error) {
+            throw new Error("APPWRIGHT_BS_UPDATE_APP_SETTINGS_JSON is not valid JSON. Provide a valid JSON string.");
+        }
+    }
+    else {
+        settings = browserStackConfig.updateAppSettings;
+    }
+    if (!settings || typeof settings !== "object") {
+        return;
+    }
+    try {
+        await device.updateAppSettings(settings);
+        const hasPermissions = Object.prototype.hasOwnProperty.call(settings, "Permission Settings");
+        const customKeys = Object.keys(settings).filter((key) => key !== "Permission Settings");
+        if (hasPermissions || customKeys.length > 0) {
+            logger_1.logger.log(`iOS app settings applied before tests: permissions=${hasPermissions}, custom_keys=${customKeys.length}`);
+        }
+    }
+    catch (error) {
+        logger_1.logger.warn("Failed to apply iOS app settings in fixture", error);
+    }
+}
+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);
@@ -24,6 +95,7 @@ exports.test = test_1.test.extend({
         // Initialize Visual Trace Service for screenshot capture
         const visualTraceConfig = testInfo.project.use.visualTrace;
         device.initializeVisualTrace(testInfo, testInfo.retry, visualTraceConfig);
+        await applyIosAppSettings(testInfo.project, device);
         await deviceProvider.syncTestDetails?.({ name: testInfo.title });
         await use(device);
         await device.close();
@@ -54,13 +126,52 @@ 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();
+            await applyIosAppSettings(project, device);
+            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,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;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;CA2FrB"}
+{"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"}

package/dist/providers/browserstack/index.js

@@ -110,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);
@@ -273,14 +273,11 @@ class BrowserStackDeviceProvider {
                 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");
+                const settings = updateAppSettings;
+                const hasPermissions = !!settings["Permission Settings"];
+                const customKeys = Object.keys(settings).filter((key) => key !== "Permission Settings");
                 if (hasPermissions || customKeys.length > 0) {
-                    logger_1.logger.log(`iOS app settings configured: permissions=${hasPermissions}, custom_keys=${customKeys.length}`);
+                    logger_1.logger.log("iOS app settings detected; they will be applied after session start via fixtures.");
                 }
             }
         }

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

@@ -19,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 () => {
@@ -113,4 +141,57 @@ const createDevice = (executeScript = vitest_1.vi.fn()) => {
             });
         });
     });
+    (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/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.4.0",
+  "version": "0.5.1",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"