@xenon-device-management/xenon 2.0.0 → 2.2.0

package/lib/test/unit/hub-node-same-host.spec.js

@@ -0,0 +1,356 @@
+"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 events_1 = require("events");
+const chai_1 = require("chai");
+const sinon_1 = __importDefault(require("sinon"));
+const typedi_1 = require("typedi");
+const prisma_1 = require("../../src/prisma");
+const prisma_store_1 = require("../../src/data-service/prisma-store");
+const device_store_1 = require("../../src/data-service/device-store");
+const device_service_1 = require("../../src/data-service/device-service");
+const device_utils_1 = require("../../src/device-utils");
+const helpers = __importStar(require("../../src/helpers"));
+const NodeDevices_1 = __importDefault(require("../../src/device-managers/NodeDevices"));
+const AndroidDeviceManager_1 = __importDefault(require("../../src/device-managers/AndroidDeviceManager"));
+const IOSDiscoveryService_1 = require("../../src/device-managers/ios/IOSDiscoveryService");
+const iOSTracker_1 = require("../../src/device-managers/iOSTracker");
+const device_managers_1 = require("../../src/device-managers");
+const localDeviceHosts_1 = require("../../src/device-managers/localDeviceHosts");
+const PluginContext_1 = require("../../src/PluginContext");
+const IPluginArgs_1 = require("../../src/interfaces/IPluginArgs");
+const SocketServer_1 = require("../../src/services/SocketServer");
+const NotificationService_1 = require("../../src/services/NotificationService");
+const container_registration_1 = require("../helpers/container-registration");
+const fake_device_table_1 = require("../helpers/fake-device-table");
+/**
+ * A hub on :4724 and a node on :4725 on one machine share an IP, so their
+ * phones' hosts differ only by port. Seen on 2026-09-28: the node registered
+ * its phone with the hub, and the hub's own local sync deleted it a few
+ * seconds later as "no longer discovered on this host", because it decided
+ * which rows were its own by IP.
+ */
+const IP = '192.168.0.104';
+const HUB = `http://${IP}:4724`;
+const NODE = `http://${IP}:4725`;
+const hubHosts = (over = {}) => (0, localDeviceHosts_1.localDeviceHosts)(Object.assign({ bindHostOrIp: IP }, over), 4724);
+const nodeHosts = (over = {}) => (0, localDeviceHosts_1.localDeviceHosts)(Object.assign({ bindHostOrIp: IP }, over), 4725);
+const phone = (udid, host, over = {}) => (Object.assign({ udid,
+    host, name: udid, platform: 'android', deviceType: 'real', realDevice: true, state: 'device', sdk: '14' }, over));
+const context = (args, port) => {
+    const ctx = new PluginContext_1.PluginContext();
+    ctx.setContext(Object.assign({}, IPluginArgs_1.DefaultPluginArgs, args), port, 'test-node', '');
+    return ctx;
+};
+describe('localDeviceHosts', () => {
+    it("is this server's origin when nothing else files a phone elsewhere", () => {
+        const local = hubHosts();
+        (0, chai_1.expect)(local.origin).to.equal(HUB);
+        (0, chai_1.expect)([...local.hosts]).to.deep.equal([HUB]);
+    });
+    it('adds both remoteMachineProxyIP forms: with the port (Android) and as given (iOS)', () => {
+        (0, chai_1.expect)([...hubHosts({ remoteMachineProxyIP: '203.0.113.7' }).hosts]).to.have.members([
+            HUB,
+            'http://203.0.113.7:4724',
+            '203.0.113.7',
+        ]);
+    });
+    it('adds each adbRemote server, with adb’s default port when none is given', () => {
+        (0, chai_1.expect)((0, localDeviceHosts_1.parseAdbRemote)('10.0.0.9')).to.deep.equal({ adbHost: '10.0.0.9', adbPort: 5037 });
+        (0, chai_1.expect)([...hubHosts({ adbRemote: ['10.0.0.9', '10.0.0.8:5038'] }).hosts]).to.have.members([
+            HUB,
+            'http://10.0.0.9:5037',
+            'http://10.0.0.8:5038',
+        ]);
+    });
+    it('matches a whole host only, never an IP, a prefix or a path', () => {
+        const local = hubHosts();
+        (0, chai_1.expect)((0, localDeviceHosts_1.isLocalDeviceHost)(local, HUB)).to.equal(true);
+        for (const other of [
+            NODE,
+            IP,
+            `${HUB}/wd/hub`,
+            `http://${IP}/wd/hub`,
+            'http://192.168.0.10:4724',
+        ]) {
+            (0, chai_1.expect)((0, localDeviceHosts_1.isLocalDeviceHost)(local, other), other).to.equal(false);
+        }
+        (0, chai_1.expect)((0, localDeviceHosts_1.isLocalDeviceHost)(local, undefined)).to.equal(false);
+    });
+});
+describe('A hub and a node on one machine keep to their own phones', () => {
+    let table;
+    let discover;
+    let restoreContainer;
+    let savedStore;
+    const seed = (rows) => {
+        table = (0, fake_device_table_1.fakeDeviceTable)(rows);
+        for (const m of Object.keys(table.delegate)) {
+            sinon_1.default.stub(prisma_1.prisma.device, m).callsFake(table.delegate[m]);
+        }
+    };
+    beforeEach(() => {
+        discover = () => __awaiter(void 0, void 0, void 0, function* () { return []; });
+        restoreContainer = (0, container_registration_1.saveRegistrations)(device_managers_1.XenonManager, SocketServer_1.SocketServer, NotificationService_1.NotificationService, iOSTracker_1.IosTracker);
+        typedi_1.Container.set({
+            id: device_managers_1.XenonManager,
+            value: { getDevices: (known) => discover(known) },
+        });
+        typedi_1.Container.set({
+            id: SocketServer_1.SocketServer,
+            value: {
+                emitToDashboard: () => undefined,
+                emitToDashboardForDevices: () => __awaiter(void 0, void 0, void 0, function* () { return undefined; }),
+                hasScopedDashboard: () => false,
+            },
+        });
+        typedi_1.Container.set({ id: NotificationService_1.NotificationService, value: { dispatchEvent: () => __awaiter(void 0, void 0, void 0, function* () { return undefined; }) } });
+        sinon_1.default.stub(prisma_1.prisma.lease, 'findMany').resolves([]);
+        savedStore = device_store_1.DeviceStoreFactory._deviceStore;
+        device_store_1.DeviceStoreFactory._deviceStore = new prisma_store_1.PrismaDeviceStore();
+    });
+    afterEach(() => {
+        device_store_1.DeviceStoreFactory._deviceStore = savedStore;
+        sinon_1.default.restore();
+        restoreContainer();
+    });
+    describe("the hub's local sync", () => {
+        it("removes the hub's own stale phone and keeps the node's", () => __awaiter(void 0, void 0, void 0, function* () {
+            seed([phone('hub-phone', HUB), phone('node-phone', NODE)]);
+            yield (0, device_utils_1.updateDeviceList)(hubHosts());
+            (0, chai_1.expect)(table.row('hub-phone')).to.equal(undefined);
+            (0, chai_1.expect)(table.row('node-phone')).to.include({ host: NODE });
+        }));
+        it("keeps phones on the hub's IP whose host has a path and another port or none", () => __awaiter(void 0, void 0, void 0, function* () {
+            seed([
+                phone('hub-phone', HUB),
+                phone('behind-proxy', `http://${IP}/wd/hub`),
+                phone('node-wd-hub', `${NODE}/wd/hub`),
+            ]);
+            yield (0, device_utils_1.updateDeviceList)(hubHosts());
+            (0, chai_1.expect)(table.row('hub-phone')).to.equal(undefined);
+            (0, chai_1.expect)(table.row('behind-proxy')).to.include({ host: `http://${IP}/wd/hub` });
+            (0, chai_1.expect)(table.row('node-wd-hub')).to.include({ host: `${NODE}/wd/hub` });
+        }));
+        it('prunes its own phones filed under remoteMachineProxyIP, in both forms', () => __awaiter(void 0, void 0, void 0, function* () {
+            seed([
+                phone('android-proxied', 'http://203.0.113.7:4724'),
+                phone('iphone-proxied', '203.0.113.7', { platform: 'ios' }),
+                phone('node-phone', NODE),
+            ]);
+            yield (0, device_utils_1.updateDeviceList)(hubHosts({ remoteMachineProxyIP: '203.0.113.7' }));
+            (0, chai_1.expect)(table.row('android-proxied')).to.equal(undefined);
+            (0, chai_1.expect)(table.row('iphone-proxied')).to.equal(undefined);
+            (0, chai_1.expect)(table.row('node-phone')).to.include({ host: NODE });
+        }));
+        it('treats a remoteMachineProxyIP with a path as one whole host', () => __awaiter(void 0, void 0, void 0, function* () {
+            seed([
+                phone('hub-iphone', 'https://lab.example.com/hub', { platform: 'ios' }),
+                phone('node-iphone', 'https://lab.example.com/hub-node', { platform: 'ios' }),
+            ]);
+            yield (0, device_utils_1.updateDeviceList)(hubHosts({ remoteMachineProxyIP: 'https://lab.example.com/hub' }));
+            (0, chai_1.expect)(table.row('hub-iphone')).to.equal(undefined);
+            (0, chai_1.expect)(table.row('node-iphone')).to.include({ host: 'https://lab.example.com/hub-node' });
+        }));
+        it('prunes a phone on one of its adbRemote servers that is gone', () => __awaiter(void 0, void 0, void 0, function* () {
+            seed([phone('remote-adb', 'http://10.0.0.9:5037'), phone('node-phone', NODE)]);
+            yield (0, device_utils_1.updateDeviceList)(hubHosts({ adbRemote: ['10.0.0.9'] }));
+            (0, chai_1.expect)(table.row('remote-adb')).to.equal(undefined);
+            (0, chai_1.expect)(table.row('node-phone')).to.include({ host: NODE });
+        }));
+    });
+    describe("the node's own sync", () => {
+        it("prunes the node's stale phone, tells the hub, and leaves the hub's row alone", () => __awaiter(void 0, void 0, void 0, function* () {
+            // One table for both, as when the two share a database.
+            seed([phone('node-live', NODE), phone('node-gone', NODE), phone('hub-phone', HUB)]);
+            discover = (known) => __awaiter(void 0, void 0, void 0, function* () { return known.filter((d) => d.udid === 'node-live').map((d) => (Object.assign({}, d))); });
+            sinon_1.default.stub(helpers, 'isXenonRunning').resolves(true);
+            const post = sinon_1.default.stub(NodeDevices_1.default.prototype, 'postDevicesToHub').resolves();
+            yield (0, device_utils_1.updateDeviceList)(nodeHosts(), HUB);
+            (0, chai_1.expect)(table.row('node-gone')).to.equal(undefined);
+            (0, chai_1.expect)(table.row('node-live')).to.include({ host: NODE });
+            (0, chai_1.expect)(table.row('hub-phone')).to.include({ host: HUB });
+            const removed = post.getCalls().filter((c) => c.args[1] === 'remove');
+            (0, chai_1.expect)(removed).to.have.length(1);
+            (0, chai_1.expect)(removed[0].args[0].map((d) => d.udid)).to.deep.equal(['node-gone']);
+        }));
+    });
+    describe("the hub's stale-host check", () => {
+        it('host-checks a node on the same IP, and drops its phones when it is down', () => __awaiter(void 0, void 0, void 0, function* () {
+            seed([phone('hub-phone', HUB), phone('node-phone', NODE)]);
+            const alive = sinon_1.default.stub(helpers, 'isXenonRunning').resolves(false);
+            yield (0, device_utils_1.removeStaleDevices)(hubHosts());
+            (0, chai_1.expect)(alive.calledWith(NODE)).to.equal(true);
+            (0, chai_1.expect)(alive.calledWith(HUB)).to.equal(false);
+            (0, chai_1.expect)(table.row('node-phone')).to.equal(undefined);
+            (0, chai_1.expect)(table.row('hub-phone')).to.include({ host: HUB });
+        }));
+        it("keeps a live node's phones", () => __awaiter(void 0, void 0, void 0, function* () {
+            seed([phone('hub-phone', HUB), phone('node-phone', NODE)]);
+            const alive = sinon_1.default.stub(helpers, 'isXenonRunning').resolves(true);
+            yield (0, device_utils_1.removeStaleDevices)(hubHosts());
+            (0, chai_1.expect)(alive.calledWith(NODE)).to.equal(true);
+            (0, chai_1.expect)(table.row('node-phone')).to.include({ host: NODE });
+            (0, chai_1.expect)(table.row('hub-phone')).to.include({ host: HUB });
+        }));
+        it("does not take a node whose IP starts with the hub's for its own", () => __awaiter(void 0, void 0, void 0, function* () {
+            seed([phone('hub-phone', 'http://192.168.0.10:4724'), phone('node-phone', NODE)]);
+            sinon_1.default.stub(helpers, 'isXenonRunning').resolves(false);
+            yield (0, device_utils_1.removeStaleDevices)((0, localDeviceHosts_1.localDeviceHosts)({ bindHostOrIp: '192.168.0.10' }, 4724));
+            (0, chai_1.expect)(table.row('node-phone')).to.equal(undefined);
+            (0, chai_1.expect)(table.row('hub-phone')).to.include({ host: 'http://192.168.0.10:4724' });
+        }));
+        it('never host-checks its own phones, in any host form', () => __awaiter(void 0, void 0, void 0, function* () {
+            seed([
+                phone('origin', HUB),
+                phone('android-proxied', 'http://203.0.113.7:4724'),
+                phone('iphone-proxied', '203.0.113.7', { platform: 'ios' }),
+                phone('remote-adb', 'http://10.0.0.9:5037'),
+            ]);
+            const alive = sinon_1.default.stub(helpers, 'isXenonRunning').resolves(false);
+            yield (0, device_utils_1.removeStaleDevices)(hubHosts({ remoteMachineProxyIP: '203.0.113.7', adbRemote: ['10.0.0.9'] }));
+            (0, chai_1.expect)(alive.called).to.equal(false);
+            for (const udid of ['origin', 'android-proxied', 'iphone-proxied', 'remote-adb']) {
+                (0, chai_1.expect)(table.row(udid), udid).to.not.equal(undefined);
+            }
+        }));
+    });
+    describe('a node leaving the hub', () => {
+        // The hub's /register?type=unregister handler.
+        const hubReceives = () => sinon_1.default
+            .stub(NodeDevices_1.default.prototype, 'unRegisterNode')
+            .callsFake((host, nodeId) => __awaiter(void 0, void 0, void 0, function* () {
+            yield (0, device_service_1.removeNodeDevices)([{ host, nodeId }], (d) => d.host === HUB);
+        }));
+        it("removes only the node's phones from the hub", () => __awaiter(void 0, void 0, void 0, function* () {
+            seed([phone('hub-phone', HUB), phone('node-phone', NODE)]);
+            const sent = hubReceives();
+            yield (0, device_utils_1.unregisterNodeFromHub)(HUB, nodeHosts());
+            (0, chai_1.expect)(sent.getCalls().map((c) => c.args[0])).to.deep.equal([NODE]);
+            (0, chai_1.expect)(table.row('node-phone')).to.equal(undefined);
+            (0, chai_1.expect)(table.row('hub-phone')).to.include({ host: HUB });
+        }));
+        it('sends only URLs, which the hub matches exactly, never a bare proxy address', () => __awaiter(void 0, void 0, void 0, function* () {
+            seed([phone('hub-phone', HUB), phone('other-node', 'http://203.0.113.7:4726')]);
+            const sent = hubReceives();
+            yield (0, device_utils_1.unregisterNodeFromHub)(HUB, nodeHosts({ remoteMachineProxyIP: '203.0.113.7' }));
+            (0, chai_1.expect)(sent.getCalls().map((c) => c.args[0])).to.have.members([
+                NODE,
+                'http://203.0.113.7:4725',
+            ]);
+            (0, chai_1.expect)(table.row('other-node')).to.include({ host: 'http://203.0.113.7:4726' });
+            (0, chai_1.expect)(table.row('hub-phone')).to.include({ host: HUB });
+        }));
+    });
+    describe("the hub's Android discovery", () => {
+        const localAdb = { adbPort: 5037 };
+        let deviceInfo;
+        // resetTestContainer() (test/helpers/test-container.ts) stubs these two on
+        // the prototype for the rest of the process, so in a full run discovery
+        // never reaches them. Put the real ones on this instance.
+        const real = (fn) => { var _a; return (_a = fn.wrappedMethod) !== null && _a !== void 0 ? _a : fn; };
+        const hubAndroid = (adb = localAdb) => {
+            const manager = new AndroidDeviceManager_1.default(context({ bindHostOrIp: IP }, 4724));
+            const proto = AndroidDeviceManager_1.default.prototype;
+            Object.assign(manager, {
+                getDevices: real(proto.getDevices),
+                fetchAndroidDevices: real(proto.fetchAndroidDevices),
+            });
+            sinon_1.default.stub(manager, 'requireSdkRoot').resolves();
+            sinon_1.default
+                .stub(manager, 'getConnectedDevices')
+                .resolves(new Map([[adb, [{ udid: 'shared', state: 'device' }]]]));
+            deviceInfo = sinon_1.default
+                .stub(manager, 'deviceInfo')
+                .callsFake((device) => __awaiter(void 0, void 0, void 0, function* () { return phone(device.udid, HUB); }));
+            return manager;
+        };
+        it('builds its own row for a phone the node on the same IP already listed', () => __awaiter(void 0, void 0, void 0, function* () {
+            const devices = yield hubAndroid().getDevices({ androidDeviceType: 'both' }, [
+                phone('shared', NODE),
+            ]);
+            (0, chai_1.expect)(deviceInfo.calledOnce).to.equal(true);
+            (0, chai_1.expect)(devices.map((d) => d.host)).to.deep.equal([HUB]);
+        }));
+        it('reuses its own row without asking the phone again', () => __awaiter(void 0, void 0, void 0, function* () {
+            const devices = yield hubAndroid().getDevices({ androidDeviceType: 'both' }, [
+                phone('shared', HUB),
+            ]);
+            (0, chai_1.expect)(deviceInfo.called).to.equal(false);
+            (0, chai_1.expect)(devices.map((d) => d.host)).to.deep.equal([HUB]);
+        }));
+        it('reuses its row for a phone on an adbRemote server, filed under that server', () => __awaiter(void 0, void 0, void 0, function* () {
+            const remote = 'http://10.0.0.9:5037';
+            const devices = yield hubAndroid({ adbHost: '10.0.0.9', adbPort: 5037 }).getDevices({ androidDeviceType: 'both' }, [phone('shared', remote)]);
+            (0, chai_1.expect)(deviceInfo.called).to.equal(false);
+            (0, chai_1.expect)(devices.map((d) => d.host)).to.deep.equal([remote]);
+        }));
+    });
+    describe('a phone unplugged from one server', () => {
+        it("Android: removes that server's row only, not another's with the same udid", () => __awaiter(void 0, void 0, void 0, function* () {
+            // emulator-5554 is on every machine running an emulator; the node's
+            // IP starts with the hub's.
+            const hub = 'http://192.168.0.10:4724';
+            seed([phone('emulator-5554', hub), phone('emulator-5554', NODE)]);
+            const args = Object.assign({}, IPluginArgs_1.DefaultPluginArgs, { bindHostOrIp: '192.168.0.10' });
+            const manager = new AndroidDeviceManager_1.default(context(args, 4724));
+            yield manager.onDeviceRemoved({ id: 'emulator-5554', type: 'offline' }, args);
+            const left = (yield prisma_1.prisma.device.findMany());
+            (0, chai_1.expect)(left.map((d) => d.host)).to.deep.equal([NODE]);
+        }));
+        it("iOS: removes that server's row only", () => __awaiter(void 0, void 0, void 0, function* () {
+            seed([phone('iphone', HUB, { platform: 'ios' }), phone('iphone', NODE, { platform: 'ios' })]);
+            const usbmux = new events_1.EventEmitter();
+            typedi_1.Container.set({ id: iOSTracker_1.IosTracker, value: { getListener: () => usbmux } });
+            new IOSDiscoveryService_1.IOSDiscoveryService(context({ bindHostOrIp: IP }, 4724)).trackIOSDevices();
+            yield usbmux.listeners('detached')[0]('iphone');
+            const left = (yield prisma_1.prisma.device.findMany());
+            (0, chai_1.expect)(left.map((d) => d.host)).to.deep.equal([NODE]);
+        }));
+    });
+});

package/lib/test/unit/hub-register-removal.spec.js

@@ -0,0 +1,165 @@
+"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());
+    });
+};
+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 express_1 = __importDefault(require("express"));
+const loopbackRequest_1 = __importDefault(require("../helpers/loopbackRequest"));
+const typedi_1 = require("typedi");
+const grid_1 = __importDefault(require("../../src/app/routers/grid"));
+const PluginContext_1 = require("../../src/PluginContext");
+const IPluginArgs_1 = require("../../src/interfaces/IPluginArgs");
+const device_store_1 = require("../../src/data-service/device-store");
+const prisma_store_1 = require("../../src/data-service/prisma-store");
+const SocketServer_1 = require("../../src/services/SocketServer");
+const NotificationService_1 = require("../../src/services/NotificationService");
+const container_registration_1 = require("../helpers/container-registration");
+const scratch_database_1 = require("../helpers/scratch-database");
+/**
+ * A node asks the hub to forget its phones with `POST /xenon/api/register`:
+ * `type=remove` with the phones (one unplugged, or pruned as stale), and
+ * `type=unregister&host=` once per host when it shuts down. The hub matched
+ * the host of either as a substring whenever it wasn't a URL, and a remove
+ * with no host matched the udid alone, so a node (an older one sends its bare
+ * IP) could delete the hub's own phones, or another node's. Only the asking
+ * node's phones go: by its nodeId when it names one, else by exact host, and
+ * never one of the hub's own.
+ */
+describe('a node’s request to forget its phones, on the hub', () => {
+    const scratch = (0, scratch_database_1.useScratchDatabase)();
+    const HUB_NODE_ID = 'hub-node-id';
+    const HUB = 'http://10.0.0.1:4724';
+    const NODE = 'http://10.0.0.1:4725';
+    const OTHER_NODE = 'http://10.0.0.1:4726';
+    let app;
+    let context;
+    let saved;
+    let restore;
+    beforeEach(() => __awaiter(void 0, void 0, void 0, function* () {
+        restore = (0, container_registration_1.saveRegistrations)(SocketServer_1.SocketServer, NotificationService_1.NotificationService);
+        typedi_1.Container.set({
+            id: SocketServer_1.SocketServer,
+            value: {
+                emitToDashboard: () => undefined,
+                emitToDashboardForDevices: () => __awaiter(void 0, void 0, void 0, function* () { return undefined; }),
+                hasScopedDashboard: () => false,
+            },
+        });
+        typedi_1.Container.set({ id: NotificationService_1.NotificationService, value: { dispatchEvent: () => __awaiter(void 0, void 0, void 0, function* () { return undefined; }) } });
+        context = typedi_1.Container.get(PluginContext_1.PluginContext);
+        saved = { context: Object.assign({}, context), store: device_store_1.DeviceStoreFactory._deviceStore };
+        device_store_1.DeviceStoreFactory._deviceStore = new prisma_store_1.PrismaDeviceStore();
+        const pluginArgs = Object.assign(Object.assign({}, IPluginArgs_1.DefaultPluginArgs), { bindHostOrIp: '10.0.0.1' });
+        context.setContext(pluginArgs, 4724, HUB_NODE_ID, '');
+        app = (0, express_1.default)();
+        app.use(express_1.default.json());
+        // The node's per-node key: role ADMIN, scope devices.
+        app.use((req, _res, next) => {
+            req.auth = { userId: 'node-key-owner', role: 'ADMIN', scopes: 'devices' };
+            next();
+        });
+        const router = express_1.default.Router();
+        grid_1.default.register(router, pluginArgs);
+        app.use('/xenon/api', router);
+        yield scratch.db.device.deleteMany({});
+        const rows = [
+            ['emulator-5554', HUB, HUB_NODE_ID],
+            ['hub-iphone', HUB, HUB_NODE_ID],
+            // The hub's own iPhone, filed under a bare remoteMachineProxyIP.
+            ['hub-bare-iphone', '10.0.0.1', HUB_NODE_ID],
+            ['emulator-5554', NODE, 'node-1'],
+            ['node-phone', NODE, 'node-1'],
+            ['node-iphone', '10.0.0.1', 'node-1'],
+            ['emulator-5554', OTHER_NODE, 'node-2'],
+            ['other-node-phone', OTHER_NODE, 'node-2'],
+        ];
+        for (const [udid, host, nodeId] of rows) {
+            yield scratch.db.device.create({
+                data: { udid, host, nodeId, platform: 'android', name: udid },
+            });
+        }
+    }));
+    afterEach(() => {
+        Object.assign(context, saved.context);
+        device_store_1.DeviceStoreFactory._deviceStore = saved.store;
+        sinon_1.default.restore();
+        restore();
+    });
+    const left = () => __awaiter(void 0, void 0, void 0, function* () {
+        return (yield scratch.db.device.findMany({ select: { udid: true, host: true } }))
+            .map((d) => `${d.udid}@${d.host}`)
+            .sort();
+    });
+    const ALL = [
+        `emulator-5554@${HUB}`,
+        `emulator-5554@${NODE}`,
+        `emulator-5554@${OTHER_NODE}`,
+        'hub-bare-iphone@10.0.0.1',
+        `hub-iphone@${HUB}`,
+        'node-iphone@10.0.0.1',
+        `node-phone@${NODE}`,
+        `other-node-phone@${OTHER_NODE}`,
+    ];
+    const without = (...gone) => ALL.filter((row) => !gone.includes(row));
+    const register = (type, body, query = {}) => (0, loopbackRequest_1.default)(app)
+        .post('/xenon/api/register')
+        .query(Object.assign({ type }, query))
+        .send(body)
+        .expect(200);
+    describe('unregister (a node shutting down)', () => {
+        it('by the node’s exact host takes its phones there, and nobody else’s', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield register('unregister', [], { host: NODE });
+            (0, chai_1.expect)(yield left()).to.deep.equal(without(`emulator-5554@${NODE}`, `node-phone@${NODE}`));
+        }));
+        it('by a bare IP (an older node) takes only what is filed under exactly it, never the hub’s', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield register('unregister', [], { host: '10.0.0.1' });
+            (0, chai_1.expect)(yield left()).to.deep.equal(without('node-iphone@10.0.0.1'));
+        }));
+        it('naming the hub’s own host takes none of the hub’s phones', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield register('unregister', [], { host: HUB });
+            (0, chai_1.expect)(yield left()).to.deep.equal(ALL);
+        }));
+        it('with the node’s id takes every phone it reported, whatever the host', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield register('unregister', [], { host: NODE, nodeId: 'node-1' });
+            (0, chai_1.expect)(yield left()).to.deep.equal(without(`emulator-5554@${NODE}`, `node-phone@${NODE}`, 'node-iphone@10.0.0.1'));
+        }));
+        it('with the hub’s own id takes nothing', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield register('unregister', [], { host: HUB, nodeId: HUB_NODE_ID });
+            (0, chai_1.expect)(yield left()).to.deep.equal(ALL);
+        }));
+    });
+    describe('remove (a node’s phone unplugged or stale)', () => {
+        it('takes that phone at the node’s exact host only', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield register('remove', [{ udid: 'emulator-5554', host: NODE }]);
+            (0, chai_1.expect)(yield left()).to.deep.equal(without(`emulator-5554@${NODE}`));
+        }));
+        it('with a bare IP (an older node) takes nothing', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield register('remove', [{ udid: 'emulator-5554', host: '10.0.0.1' }]);
+            (0, chai_1.expect)(yield left()).to.deep.equal(ALL);
+        }));
+        it('with no host takes nothing, never every row with that udid', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield register('remove', [{ udid: 'emulator-5554' }]);
+            (0, chai_1.expect)(yield left()).to.deep.equal(ALL);
+        }));
+        it('naming one of the hub’s own phones takes nothing', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield register('remove', [{ udid: 'emulator-5554', host: HUB }]);
+            (0, chai_1.expect)(yield left()).to.deep.equal(ALL);
+        }));
+        it('with the node’s id takes its phone, even filed under a bare host', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield register('remove', [{ udid: 'node-iphone', host: '10.0.0.1', nodeId: 'node-1' }]);
+            (0, chai_1.expect)(yield left()).to.deep.equal(without('node-iphone@10.0.0.1'));
+        }));
+    });
+});