@xenon-device-management/xenon 2.15.0 → 2.17.0

package/lib/test/unit/ios-driver-log.spec.js

@@ -0,0 +1,168 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const iosDriverLog_1 = require("../../src/services/logcat/iosDriverLog");
+// The driver's own log class (test/helpers/driver-log.ts): an iPhone's and a
+// simulator's `logs.syslog` extend it, so what Xenon reads is what the driver keeps.
+const driver_log_1 = require("../helpers/driver-log");
+const IPHONE_ERROR = 'Oct  5 20:31:40 iPhone SpringBoard(FrontBoard)[57] <Error>: Failed to launch com.example.shop';
+const IPHONE_NOTICE = 'Oct  5 20:31:41 iPhone backboardd[61] <Notice>: touch began';
+const SIM_FAULT = '2026-10-05 20:31:40.123 F  Shop[4127:8812] (UIKitCore) [com.apple.UIKit:Crash] Terminating app';
+const SIM_DEFAULT = '2026-10-05 20:31:40.200 Df SpringBoard[1234:5678] (FrontBoard) launched';
+describe('iosDriverLog', () => {
+    describe('iosLineLevel', () => {
+        it("reads an iPhone's syslog level", () => {
+            (0, chai_1.expect)((0, iosDriverLog_1.iosLineLevel)(IPHONE_ERROR)).to.equal('E');
+            (0, chai_1.expect)((0, iosDriverLog_1.iosLineLevel)(IPHONE_NOTICE)).to.equal('I');
+            (0, chai_1.expect)((0, iosDriverLog_1.iosLineLevel)(IPHONE_ERROR.replace('<Error>', '<Fault>'))).to.equal('F');
+            (0, chai_1.expect)((0, iosDriverLog_1.iosLineLevel)(IPHONE_ERROR.replace('<Error>', '<Warning>'))).to.equal('W');
+        });
+        it("reads a simulator's compact type", () => {
+            (0, chai_1.expect)((0, iosDriverLog_1.iosLineLevel)(SIM_FAULT)).to.equal('F');
+            (0, chai_1.expect)((0, iosDriverLog_1.iosLineLevel)(SIM_DEFAULT)).to.equal('I');
+            (0, chai_1.expect)((0, iosDriverLog_1.iosLineLevel)(SIM_DEFAULT.replace(' Df ', ' E  '))).to.equal('E');
+            (0, chai_1.expect)((0, iosDriverLog_1.iosLineLevel)(SIM_DEFAULT.replace(' Df ', ' Db '))).to.equal('D');
+        });
+        it('takes a line with no level of its own as I', () => {
+            (0, chai_1.expect)((0, iosDriverLog_1.iosLineLevel)('\t0   Shop   0x0000000100abc123 main + 42')).to.equal('I');
+        });
+    });
+    describe('recordFromDriverLog', () => {
+        it('keeps the line as printed, at the time it reached the server', () => {
+            const rec = (0, iosDriverLog_1.recordFromDriverLog)({
+                timestamp: 1791000000123,
+                level: 'ALL',
+                message: IPHONE_ERROR,
+            });
+            (0, chai_1.expect)(rec).to.include({ ts: 1791000000123, level: 'E', message: IPHONE_ERROR });
+            (0, chai_1.expect)((0, iosDriverLog_1.iosLineText)(rec)).to.equal(IPHONE_ERROR);
+        });
+        it("drops what `log stream` prints before the simulator's first line", () => {
+            for (const banner of [
+                'Filtering the log data using "subsystem != \\"com.apple.CoreTelephony\\""',
+                'Timestamp               Ty Process[PID:TID]',
+            ]) {
+                (0, chai_1.expect)((0, iosDriverLog_1.recordFromDriverLog)({ timestamp: 1, message: banner }), banner).to.equal(null);
+            }
+        });
+        it("keeps a crash report's continuation lines, and drops empty ones", () => {
+            (0, chai_1.expect)((0, iosDriverLog_1.recordFromDriverLog)({ timestamp: 1, message: '\tThread 0 Crashed:' })).to.not.equal(null);
+            (0, chai_1.expect)((0, iosDriverLog_1.recordFromDriverLog)({ timestamp: 1, message: '   ' })).to.equal(null);
+            (0, chai_1.expect)((0, iosDriverLog_1.recordFromDriverLog)(undefined)).to.equal(null);
+        });
+    });
+    describe("the driver's own log", () => {
+        it('is something Xenon can listen to', () => {
+            (0, chai_1.expect)((0, iosDriverLog_1.isDriverLog)(new driver_log_1.TestDriverLog())).to.equal(true);
+            (0, chai_1.expect)((0, iosDriverLog_1.isDriverLog)(undefined)).to.equal(false);
+            (0, chai_1.expect)((0, iosDriverLog_1.isDriverLog)({ on() { } })).to.equal(false);
+        });
+        it('gives the lines it holds, oldest first, without taking them from the test', () => __awaiter(void 0, void 0, void 0, function* () {
+            const driverLog = new driver_log_1.TestDriverLog();
+            driverLog.line('first');
+            driverLog.line('second');
+            driverLog.line('third');
+            (0, chai_1.expect)((0, iosDriverLog_1.bufferedDriverLog)(driverLog).map((e) => e.message)).to.deep.equal([
+                'first',
+                'second',
+                'third',
+            ]);
+            // A test's own `getLog('syslog')` still gets every line.
+            const forTheTest = yield driverLog.getLogs();
+            (0, chai_1.expect)(forTheTest.map((e) => e.message)).to.deep.equal([
+                'first',
+                'second',
+                'third',
+            ]);
+        }));
+        it('gives nothing for a log of another shape', () => {
+            (0, chai_1.expect)((0, iosDriverLog_1.bufferedDriverLog)({})).to.deep.equal([]);
+            (0, chai_1.expect)((0, iosDriverLog_1.bufferedDriverLog)({ logs: { rvalues: () => [1] } })).to.deep.equal([]);
+            (0, chai_1.expect)((0, iosDriverLog_1.bufferedDriverLog)({
+                logs: { rvalues: () => [1] },
+                _deserializeEntry: () => {
+                    throw new Error('changed');
+                },
+            })).to.deep.equal([]);
+        });
+    });
+    // Lines as an iPhone 14 Plus (iOS 26.5) printed them during a session on
+    // Settings (com.apple.Preferences), pid 8429.
+    describe('IosAppLines', () => {
+        const at = (proc, text, level = 'Notice') => `Oct  5 23:48:33 Rabindras-iPhone ${proc} <${level}>: ${text}`;
+        const ANNOUNCE = at('runningboardd(RunningBoard)[34]', 'Acquiring assertion targeting [app<com.apple.Preferences(FEEDEEEE-DDDD)>:8429] from originator [osservice<com.apple.SpringBoard>:36947]');
+        // Written by the app's own code: no library, or the app's own binary.
+        const APP = at('Preferences[8429]', 'loading content for context');
+        const DAEMON = at('duetexpertd(DuetExpertCenter)[412]', 'Updating predictions');
+        const keeps = (f, m) => f.keeps(m, (0, iosDriverLog_1.iosLineLevel)(m));
+        it("keeps the app's own lines, the app manager's lines about it and faults, and leaves the rest", () => {
+            const f = new iosDriverLog_1.IosAppLines('com.apple.Preferences');
+            (0, chai_1.expect)(keeps(f, ANNOUNCE), 'the app manager names the app').to.equal(true);
+            (0, chai_1.expect)(keeps(f, APP), "the app's own code").to.equal(true);
+            (0, chai_1.expect)(keeps(f, at('Preferences(Preferences)[8429]', 'opened a pane')), 'its own binary').to.equal(true);
+            (0, chai_1.expect)(keeps(f, DAEMON), 'daemon chatter').to.equal(false);
+            (0, chai_1.expect)(keeps(f, at('wifid(WiFiPolicy)[61]', 'link quality dropped', 'Fault')), 'a fault').to.equal(true);
+            (0, chai_1.expect)(keeps(f, at('trustd(Security)[127]', 'SecKeyVerifySignature failed', 'Error'))).to.equal(false);
+        });
+        // Measured on Edge: 8,839 lines from its process, 5 of them its own code.
+        it("leaves out the frameworks' ordinary lines inside the app, and keeps their errors", () => {
+            const f = new iosDriverLog_1.IosAppLines('com.apple.Preferences');
+            f.learn(ANNOUNCE);
+            (0, chai_1.expect)(keeps(f, at('Preferences(UIKitCore)[8429]', 'Ending task with identifier 43'))).to.equal(false);
+            (0, chai_1.expect)(keeps(f, at('Preferences(CFNetwork)[8429]', 'Task finished', 'Error'))).to.equal(true);
+            (0, chai_1.expect)(keeps(f, at('Preferences(WebKit)[8429]', 'WebContent crashed', 'Fault'))).to.equal(true);
+        });
+        it('keeps a crash report or a memory kill that names the app by its executable', () => {
+            const f = new iosDriverLog_1.IosAppLines('com.apple.Preferences');
+            f.learn(ANNOUNCE);
+            f.learn(APP);
+            (0, chai_1.expect)(keeps(f, at('ReportCrash[9001]', 'Formulating fatal 309 report for corpse[8429] Preferences'))).to.equal(true);
+            (0, chai_1.expect)(keeps(f, at('ReportCrash[9001]', 'Saved crash report for Preferences[8429]'))).to.equal(true);
+            (0, chai_1.expect)(keeps(f, 'Oct  5 23:48:40 Rabindras-iPhone kernel[0] <Notice>: memorystatus: killing pid 8429 [Preferences]')).to.equal(true);
+            // A relaunch: a new pid, the same executable.
+            (0, chai_1.expect)(keeps(f, at('Preferences[8447]', 'scene connected'))).to.equal(true);
+        });
+        it("leaves out the daemons that only repeat the app's state", () => {
+            const f = new iosDriverLog_1.IosAppLines('com.apple.Preferences');
+            f.learn(ANNOUNCE);
+            for (const line of [
+                at('CommCenter(RunningBoardServices)[100]', 'Received state update for 8429 (app<com.apple.Preferences(FEEDEEEE)>, running-active-NotVisible'),
+                at('mobileassetd(MobileAssetDaemon)[120]', 'com.apple.Preferences issued query command'),
+            ]) {
+                (0, chai_1.expect)(keeps(f, line), line).to.equal(false);
+            }
+            (0, chai_1.expect)(keeps(f, at('SpringBoard(FrontBoard)[36947]', 'Application com.apple.Preferences exited'))).to.equal(true);
+        });
+        it('lets a line with no header follow the line before it', () => {
+            const f = new iosDriverLog_1.IosAppLines('com.apple.Preferences');
+            (0, chai_1.expect)(keeps(f, ANNOUNCE)).to.equal(true);
+            (0, chai_1.expect)(keeps(f, '    AssetLocale = "en_IN";')).to.equal(true);
+            (0, chai_1.expect)(keeps(f, DAEMON)).to.equal(false);
+            (0, chai_1.expect)(keeps(f, '    AssetLocale = "en_IN";')).to.equal(false);
+        });
+        it("reads a simulator's compact lines the same way", () => {
+            const f = new iosDriverLog_1.IosAppLines('com.example.shop');
+            const sim = (proc, text, type = 'Df') => `2026-10-05 20:31:40.123 ${type} ${proc} ${text}`;
+            (0, chai_1.expect)(keeps(f, sim('runningboardd[90:1200]', 'Acquiring assertion [app<com.example.shop(UUID)>:4127]'))).to.equal(true);
+            (0, chai_1.expect)(keeps(f, sim('Shop[4127:8812]', '(Shop) launched'))).to.equal(true);
+            (0, chai_1.expect)(keeps(f, sim('Shop[4127:8812]', '(UIKitCore) scene active'))).to.equal(false);
+            (0, chai_1.expect)(keeps(f, sim('Shop[4127:8812]', '(CFNetwork) task failed', 'E'))).to.equal(true);
+            (0, chai_1.expect)(keeps(f, sim('locationd[77:300]', 'region update'))).to.equal(false);
+            (0, chai_1.expect)(keeps(f, sim('Shop[4127:8812]', 'Terminating app', 'F'))).to.equal(true);
+        });
+        it("doesn't take a bundle id's dots as any character", () => {
+            const f = new iosDriverLog_1.IosAppLines('com.example.shop');
+            f.learn('Oct  5 23:48:33 iPhone runningboardd[34] <Notice>: [app<comXexampleXshop(UUID)>:5555]');
+            (0, chai_1.expect)(keeps(f, 'Oct  5 23:48:33 iPhone Other[5555] <Notice>: hello')).to.equal(false);
+        });
+    });
+});

package/lib/test/unit/ios-simulator-session-readiness.spec.js

@@ -0,0 +1,187 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const chai_1 = __importDefault(require("chai"));
+const sinon_1 = __importDefault(require("sinon"));
+const node_simctl_1 = require("node-simctl");
+const DeviceUtils = __importStar(require("../../src/device-utils"));
+const db_1 = require("../../src/data-service/db");
+const device_service_1 = require("../../src/data-service/device-service");
+const IOSDeviceManager_1 = __importDefault(require("../../src/device-managers/IOSDeviceManager"));
+const IOSStreamService_1 = __importDefault(require("../../src/device-managers/ios/IOSStreamService"));
+const WDAClient_1 = require("../../src/device-managers/ios/WDAClient");
+const IPluginArgs_1 = require("../../src/interfaces/IPluginArgs");
+const XenonCapabilityManager_1 = require("../../src/XenonCapabilityManager");
+const test_container_1 = require("../helpers/test-container");
+const loki_stores_1 = require("../helpers/loki-stores");
+const scratch_database_1 = require("../helpers/scratch-database");
+const expect = chai_1.default.expect;
+/**
+ * A simulator's WebDriverAgent is the XCUITest driver's: the driver builds,
+ * installs and launches it on the session's `wdaLocalPort` once Appium
+ * creates the session, as plain Appium does. Xenon runs WDA only on an
+ * iPhone (go-ios `runwda`, for the live preview).
+ *
+ * Allocation used to require WDA to answer on the simulator's port before
+ * handing it over, and to "recover" it by rebooting the simulator, which
+ * starts no WDA. So every session on a simulator whose WDA wasn't already up
+ * was refused: "Device <udid> is unhealthy and could not be autonomously
+ * recovered."
+ */
+describe('iOS simulator sessions: the driver starts WebDriverAgent', () => {
+    const scratch = (0, scratch_database_1.useScratchDatabase)();
+    (0, loki_stores_1.useLokiStores)();
+    const sandbox = sinon_1.default.createSandbox();
+    const HOST = 'http://127.0.0.1:4723';
+    const SIMULATOR = '35429994-B029-4AF4-9634-880B89DAC782';
+    const IPHONE = '00008150-000E78612168C01C';
+    const pluginArgs = Object.assign({}, IPluginArgs_1.DefaultPluginArgs, {
+        platform: 'ios',
+        iosDeviceType: 'both',
+    });
+    const device = (udid, over = {}) => (Object.assign({ udid, name: 'iPhone 16 Pro', platform: 'ios', sdk: '18.4', host: HOST, busy: false, offline: false, userBlocked: false, state: 'Booted', deviceType: 'simulator', realDevice: false, 
+        // Leased by discovery for a booted simulator; nothing listens on it
+        // until the driver launches WDA there.
+        wdaLocalPort: 8102, mjpegServerPort: 9102, totalUtilizationTimeMilliSec: 0, sessionStartTime: 0 }, over));
+    let wdaAsked;
+    let simctlCommands;
+    before(() => (0, test_container_1.resetTestContainer)());
+    after(() => (0, test_container_1.resetTestContainer)());
+    beforeEach(() => __awaiter(void 0, void 0, void 0, function* () {
+        sandbox.stub(process, 'kill');
+        (yield db_1.XenonDatabase.DeviceModel).removeDataOnly();
+        yield scratch.db.lease.deleteMany({});
+        sandbox.stub(DeviceUtils, 'setUtilizationTime').resolves();
+        sandbox.stub(IOSStreamService_1.default.prototype, 'getStreamStatus').returns(undefined);
+        // Nothing answers on the simulator's port, as on a freshly booted one.
+        wdaAsked = sandbox.stub(WDAClient_1.WDAClient.prototype, 'verifyWDAStatus').resolves(false);
+        // Every simctl call (shutdown, boot, list) goes through exec.
+        simctlCommands = [];
+        sandbox.stub(node_simctl_1.Simctl.prototype, 'exec').callsFake((subcommand) => __awaiter(void 0, void 0, void 0, function* () {
+            simctlCommands.push(subcommand);
+            return { stdout: '', stderr: '', code: 0 };
+        }));
+        (0, test_container_1.createTestXenonManager)(pluginArgs);
+    }));
+    afterEach(() => sandbox.restore());
+    const caps = (udid) => ({
+        alwaysMatch: {
+            platformName: 'iOS',
+            'appium:automationName': 'XCUITest',
+            'appium:udid': udid,
+        },
+        firstMatch: [{}],
+    });
+    it('allocates a booted simulator whose WebDriverAgent is not running yet', () => __awaiter(void 0, void 0, void 0, function* () {
+        yield (0, device_service_1.addNewDevice)([device(SIMULATOR)]);
+        const requested = caps(SIMULATOR);
+        const allocated = yield DeviceUtils.allocateDeviceForSession(requested, 2000, 100, pluginArgs);
+        expect(allocated.udid).to.equal(SIMULATOR);
+        expect(wdaAsked.called, 'asked WebDriverAgent').to.equal(false);
+        expect(simctlCommands, 'rebooted the simulator').to.not.include('shutdown');
+        expect(simctlCommands, 'rebooted the simulator').to.not.include('boot');
+        // The driver gets the port to launch its own WDA on, and no URL of one.
+        const fm = requested.firstMatch[0];
+        expect(fm['appium:wdaLocalPort']).to.equal(8102);
+        expect(fm).to.not.have.property('appium:webDriverAgentUrl');
+    }));
+    it('allocates a shut-down simulator, which the driver boots', () => __awaiter(void 0, void 0, void 0, function* () {
+        // Discovery leases no port to a shut-down simulator.
+        yield (0, device_service_1.addNewDevice)([
+            device(SIMULATOR, { state: 'Shutdown', wdaLocalPort: undefined, mjpegServerPort: 9103 }),
+        ]);
+        const requested = caps(SIMULATOR);
+        const allocated = yield DeviceUtils.allocateDeviceForSession(requested, 2000, 100, pluginArgs);
+        expect(allocated.udid).to.equal(SIMULATOR);
+        expect(wdaAsked.called).to.equal(false);
+        expect(simctlCommands).to.not.include('boot');
+        // It gets one now, for the driver's WDA.
+        expect(requested.firstMatch[0]['appium:wdaLocalPort']).to.be.a('number');
+    }));
+    describe('a live preview open on the phone', () => {
+        // The preview's stream entry for the phone: on an iPhone, the WDA Xenon
+        // runs; on a simulator, at most an attach to a driver's WDA, which goes
+        // with the session that started it.
+        beforeEach(() => {
+            IOSStreamService_1.default.prototype.getStreamStatus.returns({
+                status: 'running',
+                wdaPort: 8150,
+            });
+        });
+        it("never points a simulator session at it: the driver's own WDA, on the simulator's port", () => __awaiter(void 0, void 0, void 0, function* () {
+            const requested = caps(SIMULATOR);
+            yield (0, XenonCapabilityManager_1.iOSCapabilities)(requested, device(SIMULATOR));
+            const fm = requested.firstMatch[0];
+            expect(fm).to.not.have.property('appium:webDriverAgentUrl');
+            expect(fm['appium:wdaLocalPort']).to.equal(8102);
+            expect(fm['appium:mjpegServerPort']).to.equal(9102);
+        }));
+        it('still points an iPhone session at the WDA Xenon runs there', () => __awaiter(void 0, void 0, void 0, function* () {
+            const requested = caps(IPHONE);
+            yield (0, XenonCapabilityManager_1.iOSCapabilities)(requested, device(IPHONE, { realDevice: true, deviceType: 'real' }));
+            const fm = requested.firstMatch[0];
+            expect(fm['appium:webDriverAgentUrl']).to.equal('http://127.0.0.1:8150');
+            expect(fm).to.not.have.property('appium:wdaLocalPort');
+        }));
+    });
+    describe('an iPhone, whose WebDriverAgent Xenon runs', () => {
+        const iphone = () => device(IPHONE, { realDevice: true, deviceType: 'real' });
+        it('is still checked: ready when WebDriverAgent answers', () => __awaiter(void 0, void 0, void 0, function* () {
+            wdaAsked.resolves(true);
+            const manager = new IOSDeviceManager_1.default({ pluginArgs });
+            expect(yield manager.readyForSession(iphone())).to.equal(true);
+            expect(wdaAsked.calledOnceWith(IPHONE)).to.equal(true);
+        }));
+        it('is still refused when WebDriverAgent does not answer and cannot be started', () => __awaiter(void 0, void 0, void 0, function* () {
+            const manager = new IOSDeviceManager_1.default({ pluginArgs });
+            const recover = sandbox.stub(manager, 'recoverHealth').resolves(false);
+            expect(yield manager.readyForSession(iphone())).to.equal(false);
+            expect(recover.calledOnce).to.equal(true);
+        }));
+    });
+});

package/lib/test/unit/ios-simulator-session-teardown.spec.js

@@ -0,0 +1,158 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const chai_1 = require("chai");
+const sinon_1 = __importDefault(require("sinon"));
+const typedi_1 = require("typedi");
+const DeviceService = __importStar(require("../../src/data-service/device-service"));
+const IOSStreamService_1 = __importDefault(require("../../src/device-managers/ios/IOSStreamService"));
+const event_manager_1 = require("../../src/dashboard/event-manager");
+const SessionLifecycleService_1 = require("../../src/services/SessionLifecycleService");
+const SessionMetricsService_1 = require("../../src/services/metrics/SessionMetricsService");
+const PhoneNetworkRestore_1 = require("../../src/services/network/PhoneNetworkRestore");
+const VideoPipelineService_1 = require("../../src/services/VideoPipelineService");
+const LocalSession_1 = require("../../src/sessions/LocalSession");
+const SessionManager_1 = require("../../src/sessions/SessionManager");
+const container_registration_1 = require("../helpers/container-registration");
+const scratch_database_1 = require("../helpers/scratch-database");
+/**
+ * What Xenon does around a session on an iOS simulator, whose WebDriverAgent
+ * the XCUITest driver runs on this Mac.
+ *
+ * A session that passed every command ended failed: its end stopped a
+ * performance recording that Xenon starts only on an iPhone, the driver
+ * refuses that on a simulator without relaxed security, and the refused stop
+ * counted as a failed command of the session. Its video was never written:
+ * it was read from the iPhone stream's USB forward (iproxy), which on a
+ * simulator forwards nothing, while the simulator's own WebDriverAgent serves
+ * the picture on this Mac at the session's mjpegServerPort.
+ */
+const SIMULATOR = '35429994-B029-4AF4-9634-880B89DAC782';
+const IPHONE = '00008150-000E78612168C01C';
+const device = (udid, realDevice) => ({
+    udid,
+    name: 'iPhone 16 Pro',
+    platform: 'ios',
+    sdk: '18.4',
+    host: 'http://127.0.0.1:4723',
+    realDevice,
+    deviceType: realDevice ? 'real' : 'simulator',
+    screenWidth: '402',
+    screenHeight: '874',
+});
+describe('iOS simulator sessions: around the session', function () {
+    this.timeout(30000);
+    afterEach(() => sinon_1.default.restore());
+    describe('the end of a session', () => {
+        (0, scratch_database_1.useScratchDatabase)();
+        let restoreRegs;
+        beforeEach(() => {
+            restoreRegs = (0, container_registration_1.saveRegistrations)(PhoneNetworkRestore_1.PhoneNetworkRestore, SessionMetricsService_1.SessionMetricsService);
+            typedi_1.Container.set(PhoneNetworkRestore_1.PhoneNetworkRestore, { restoreSession: sinon_1.default.stub().resolves() });
+            typedi_1.Container.set(SessionMetricsService_1.SessionMetricsService, { stop: sinon_1.default.stub().resolves() });
+            sinon_1.default.stub(DeviceService, 'releaseSessionDevices').resolves();
+            sinon_1.default.stub(event_manager_1.DASHBORD_EVENT_MANAGER, 'onSessionStopped').resolves();
+            sinon_1.default.stub(SessionManager_1.SESSION_MANAGER, 'removeSession');
+        });
+        afterEach(() => restoreRegs());
+        /** Deletes a session on `phone`; resolves to whether its end stopped a performance recording. */
+        function endSessionOn(phone) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const stopPerformanceRecording = sinon_1.default.stub().resolves(null);
+                const session = {
+                    isStopping: false,
+                    getId: () => 's-1',
+                    getDevice: () => phone,
+                    stopPerformanceRecording,
+                    isVideoRecordingInProgress: () => false,
+                };
+                sinon_1.default.stub(SessionManager_1.SESSION_MANAGER, 'getSession').returns(session);
+                yield typedi_1.Container.get(SessionLifecycleService_1.SessionLifecycleService).deleteSession(sinon_1.default.stub().resolves(), 's-1');
+                return stopPerformanceRecording.called;
+            });
+        }
+        it('stops no performance recording on a simulator, where none was started', () => __awaiter(this, void 0, void 0, function* () {
+            (0, chai_1.expect)(yield endSessionOn(device(SIMULATOR, false))).to.equal(false);
+        }));
+        it("still stops an iPhone's, which Xenon started", () => __awaiter(this, void 0, void 0, function* () {
+            (0, chai_1.expect)(yield endSessionOn(device(IPHONE, true))).to.equal(true);
+        }));
+    });
+    describe('the session video', () => {
+        let startRecording;
+        let startStream;
+        beforeEach(() => {
+            startRecording = sinon_1.default.stub(VideoPipelineService_1.VideoPipelineService.prototype, 'startRecording').resolves();
+            startStream = sinon_1.default
+                .stub(IOSStreamService_1.default.prototype, 'startStream')
+                .resolves({ mjpegPort: 9150 });
+        });
+        const local = (phone) => new LocalSession_1.LocalSession({
+            sessionId: 's-video',
+            device: phone,
+            // The capabilities the driver answered the create with.
+            sessionResponse: { udid: phone.udid, wdaLocalPort: 8101, mjpegServerPort: 9101 },
+            xenonOption: {},
+            driver: { opts: { address: '127.0.0.1', port: 4723, basePath: '/wd/hub' }, sessions: {} },
+        });
+        it("is read from the simulator's own WebDriverAgent, at the session's MJPEG port", () => __awaiter(this, void 0, void 0, function* () {
+            yield local(device(SIMULATOR, false)).startVideoRecording();
+            (0, chai_1.expect)(startStream.called, 'started the iPhone stream').to.equal(false);
+            (0, chai_1.expect)(startRecording.calledOnce).to.equal(true);
+            (0, chai_1.expect)(startRecording.firstCall.args[0]).to.deep.include({
+                udid: SIMULATOR,
+                mjpegPort: 9101,
+            });
+        }));
+        it("is still read from an iPhone's stream", () => __awaiter(this, void 0, void 0, function* () {
+            yield local(device(IPHONE, true)).startVideoRecording();
+            (0, chai_1.expect)(startStream.calledOnceWith(IPHONE)).to.equal(true);
+            (0, chai_1.expect)(startRecording.firstCall.args[0]).to.deep.include({ udid: IPHONE, mjpegPort: 9150 });
+        }));
+    });
+});