@xenon-device-management/xenon 1.2.0 → 1.3.0

package/lib/test/unit/ProcessRegistry.test.js

@@ -0,0 +1,70 @@
+"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 ProcessRegistry_1 = require("../../src/services/ProcessRegistry");
+const events_1 = require("events");
+class FakeChild extends events_1.EventEmitter {
+    constructor(pid) {
+        super();
+        this.killed = false;
+        this.pid = pid;
+    }
+    kill(signal) {
+        this.killed = signal === 'SIGKILL' ? true : this.killed;
+        return true;
+    }
+}
+describe('ProcessRegistry', () => {
+    it('tracks and untracks processes', () => {
+        const reg = new ProcessRegistry_1.ProcessRegistry();
+        const child = new FakeChild(12345);
+        const id = reg.track({ kind: 'wda', udid: 'u1', process: child });
+        (0, chai_1.expect)(reg.snapshot()).to.have.length(1);
+        reg.untrack(id);
+        (0, chai_1.expect)(reg.snapshot()).to.have.length(0);
+    });
+    it('sends SIGTERM then SIGKILL when a child ignores SIGTERM', () => __awaiter(void 0, void 0, void 0, function* () {
+        const reg = new ProcessRegistry_1.ProcessRegistry();
+        const child = new FakeChild(12345);
+        const sent = [];
+        child.kill = (sig) => {
+            sent.push(sig);
+            return true;
+        };
+        const id = reg.track({ kind: 'wda', udid: 'u1', process: child });
+        const p = reg.terminate(id, { gracefulMs: 50 });
+        yield p;
+        (0, chai_1.expect)(sent[0]).to.equal('SIGTERM');
+        (0, chai_1.expect)(sent[sent.length - 1]).to.equal('SIGKILL');
+    }));
+    it('terminateForUdid kills only matching tracked processes', () => __awaiter(void 0, void 0, void 0, function* () {
+        const reg = new ProcessRegistry_1.ProcessRegistry();
+        const a = new FakeChild(1);
+        const b = new FakeChild(2);
+        const signalsA = [];
+        const signalsB = [];
+        a.kill = (s) => {
+            signalsA.push(s);
+            a.emit('exit', 0);
+            return true;
+        };
+        b.kill = (s) => {
+            signalsB.push(s);
+            return true;
+        };
+        reg.track({ kind: 'wda', udid: 'u1', process: a });
+        reg.track({ kind: 'wda', udid: 'u2', process: b });
+        yield reg.terminateForUdid('u1', { gracefulMs: 10 });
+        (0, chai_1.expect)(signalsA.length).to.be.greaterThan(0);
+        (0, chai_1.expect)(signalsB.length).to.equal(0);
+    }));
+});

package/lib/test/unit/apiKeyMiddleware.test.js

@@ -0,0 +1,58 @@
+"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 typedi_1 = require("typedi");
+const apiKeyMiddleware_1 = require("../../src/middleware/apiKeyMiddleware");
+const ApiKeyService_1 = require("../../src/services/ApiKeyService");
+function mockReq(headers = {}, query = {}) {
+    return { headers, query };
+}
+function mockRes() {
+    const json = sinon_1.default.stub();
+    const status = sinon_1.default.stub().returnsThis();
+    return { status, json, locals: {} };
+}
+describe('apiKeyMiddleware', () => {
+    afterEach(() => sinon_1.default.restore());
+    it('401 when header missing', () => __awaiter(void 0, void 0, void 0, function* () {
+        const req = mockReq();
+        const res = mockRes();
+        const next = sinon_1.default.stub();
+        yield (0, apiKeyMiddleware_1.apiKeyMiddleware)(req, res, next);
+        (0, chai_1.expect)(res.status.calledWith(401)).to.be.true;
+        (0, chai_1.expect)(next.called).to.be.false;
+    }));
+    it('401 when key invalid', () => __awaiter(void 0, void 0, void 0, function* () {
+        sinon_1.default.stub(typedi_1.Container.get(ApiKeyService_1.ApiKeyService), 'verify').resolves(null);
+        const req = mockReq({ 'x-xenon-api-key': 'bad' });
+        const res = mockRes();
+        const next = sinon_1.default.stub();
+        yield (0, apiKeyMiddleware_1.apiKeyMiddleware)(req, res, next);
+        (0, chai_1.expect)(res.status.calledWith(401)).to.be.true;
+    }));
+    it('calls next and attaches apiKey on success', () => __awaiter(void 0, void 0, void 0, function* () {
+        sinon_1.default
+            .stub(typedi_1.Container.get(ApiKeyService_1.ApiKeyService), 'verify')
+            .resolves({ id: 'k1', scopes: 'read', rateLimit: 300 });
+        const req = mockReq({ 'x-xenon-api-key': 'good' });
+        const res = mockRes();
+        const next = sinon_1.default.stub();
+        yield (0, apiKeyMiddleware_1.apiKeyMiddleware)(req, res, next);
+        (0, chai_1.expect)(next.calledOnce).to.be.true;
+        (0, chai_1.expect)(req.apiKey.id).to.equal('k1');
+    }));
+});

package/lib/test/unit/nodeSecretMiddleware.test.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const sinon_1 = __importDefault(require("sinon"));
+const nodeSecretMiddleware_1 = require("../../src/middleware/nodeSecretMiddleware");
+function mockReq(headers = {}) {
+    return { headers };
+}
+function mockRes() {
+    const json = sinon_1.default.stub();
+    const status = sinon_1.default.stub().returnsThis();
+    return { status, json };
+}
+describe('nodeSecretMiddleware', () => {
+    it('401 on mismatch when secret is configured', () => {
+        const mw = (0, nodeSecretMiddleware_1.nodeSecretMiddleware)('expected');
+        const req = mockReq({ 'x-xenon-node-secret': 'wrong' });
+        const res = mockRes();
+        const next = sinon_1.default.stub();
+        mw(req, res, next);
+        (0, chai_1.expect)(res.status.calledWith(401)).to.be.true;
+    });
+    it('calls next on match', () => {
+        const mw = (0, nodeSecretMiddleware_1.nodeSecretMiddleware)('shared');
+        const next = sinon_1.default.stub();
+        mw(mockReq({ 'x-xenon-node-secret': 'shared' }), mockRes(), next);
+        (0, chai_1.expect)(next.calledOnce).to.be.true;
+    });
+    it('permits + warns when secret unset', () => {
+        const mw = (0, nodeSecretMiddleware_1.nodeSecretMiddleware)(undefined);
+        const next = sinon_1.default.stub();
+        mw(mockReq(), mockRes(), next);
+        (0, chai_1.expect)(next.calledOnce).to.be.true;
+    });
+});

package/lib/test/unit/rateLimitMiddleware.test.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const sinon_1 = __importDefault(require("sinon"));
+const rateLimitMiddleware_1 = require("../../src/middleware/rateLimitMiddleware");
+function mockReq(keyId, rateLimit) {
+    return { apiKey: { id: keyId, rateLimit } };
+}
+function mockRes() {
+    const json = sinon_1.default.stub();
+    const status = sinon_1.default.stub().returnsThis();
+    const set = sinon_1.default.stub();
+    return { status, json, set };
+}
+describe('rateLimitMiddleware', () => {
+    beforeEach(() => (0, rateLimitMiddleware_1.__resetBucketsForTests)());
+    it('allows traffic within the limit', () => {
+        const next = sinon_1.default.stub();
+        const mw = (0, rateLimitMiddleware_1.rateLimitMiddleware)();
+        for (let i = 0; i < 5; i++)
+            mw(mockReq('k1', 60), mockRes(), next);
+        (0, chai_1.expect)(next.callCount).to.equal(5);
+    });
+    it('429 when bucket exhausted', () => {
+        const next = sinon_1.default.stub();
+        const mw = (0, rateLimitMiddleware_1.rateLimitMiddleware)();
+        const req = mockReq('k2', 3);
+        const res = mockRes();
+        for (let i = 0; i < 3; i++)
+            mw(req, res, next);
+        mw(req, res, next);
+        (0, chai_1.expect)(res.status.calledWith(429)).to.be.true;
+    });
+});

package/lib/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/InternalHttpClient.ts","../src/PluginContext.ts","../src/XenonCapabilityManager.ts","../src/chromeUtils.ts","../src/config.ts","../src/device-utils.ts","../src/index.ts","../src/logger.ts","../src/plugin.ts","../src/prisma.ts","../src/app/index.ts","../src/app/swagger-docs.ts","../src/app/swagger.ts","../src/app/routers/apps.ts","../src/app/routers/config.ts","../src/app/routers/control.ts","../src/app/routers/dashboard.ts","../src/app/routers/grid.ts","../src/app/routers/reservation.ts","../src/app/routers/webhook.ts","../src/commands/handle.ts","../src/commands/index.ts","../src/dashboard/asset-manager.ts","../src/dashboard/commands.ts","../src/dashboard/event-manager.ts","../src/dashboard/services/app-service.ts","../src/dashboard/services/failure-analysis-service.ts","../src/dashboard/services/session-service.ts","../src/data-service/CircuitBreaker.ts","../src/data-service/config-service.ts","../src/data-service/db.ts","../src/data-service/device-service.ts","../src/data-service/device-store.interface.ts","../src/data-service/device-store.ts","../src/data-service/pending-sessions-service.ts","../src/data-service/pluginArgs.ts","../src/data-service/prisma-service.ts","../src/data-service/prisma-store.ts","../src/data-service/queue-service.ts","../src/data-service/web-config-service.ts","../src/device-managers/AndroidDeviceManager.ts","../src/device-managers/ChromeDriverManager.ts","../src/device-managers/HealthMonitorService.ts","../src/device-managers/IOSDeviceManager.ts","../src/device-managers/NodeDevices.ts","../src/device-managers/iOSTracker.ts","../src/device-managers/index.ts","../src/device-managers/android/AndroidStreamService.ts","../src/device-managers/android/DeviceLockManager.ts","../src/device-managers/cloud/CapabilityManager.ts","../src/device-managers/cloud/Devices.ts","../src/device-managers/ios/IOSDiscoveryService.ts","../src/device-managers/ios/IOSStreamService.ts","../src/device-managers/ios/WDAClient.ts","../src/enums/Capabilities.ts","../src/enums/Cloud.ts","../src/enums/Platform.ts","../src/enums/SessionType.ts","../src/enums/SocketEvents.ts","../src/generated/client/default.d.ts","../src/generated/client/default.js","../src/generated/client/edge.d.ts","../src/generated/client/edge.js","../src/generated/client/index-browser.js","../src/generated/client/index.d.ts","../src/generated/client/index.js","../src/generated/client/wasm.d.ts","../src/generated/client/wasm.js","../src/generated/client/runtime/edge-esm.js","../src/generated/client/runtime/edge.js","../src/generated/client/runtime/index-browser.d.ts","../src/generated/client/runtime/index-browser.js","../src/generated/client/runtime/library.d.ts","../src/generated/client/runtime/library.js","../src/generated/client/runtime/react-native.js","../src/generated/client/runtime/wasm.js","../src/helpers/UniversalMjpegProxy.ts","../src/helpers/index.ts","../src/interceptors/CommandInterceptor.ts","../src/interfaces/ICloudManager.ts","../src/interfaces/IDevice.ts","../src/interfaces/IDeviceFilterOptions.ts","../src/interfaces/IDeviceManager.ts","../src/interfaces/IOptions.ts","../src/interfaces/IPluginArgs.ts","../src/interfaces/ISessionCapability.ts","../src/profiling/AndroidAppProfiler.ts","../src/proxy/wd-command-proxy.ts","../src/scripts/generate-database-migration.ts","../src/scripts/initialize-database.ts","../src/scripts/install-go-ios.ts","../src/scripts/prepare-prisma.ts","../src/scripts/run-migrations.ts","../src/services/AICommandService.ts","../src/services/AIService.ts","../src/services/CleanupService.ts","../src/services/EventBus.ts","../src/services/InspectorService.ts","../src/services/MetricsService.ts","../src/services/NetworkConditioningService.ts","../src/services/NotificationService.ts","../src/services/OrphanSweeper.ts","../src/services/PortAllocator.ts","../src/services/RequestLogService.ts","../src/services/ResourceIsolationService.ts","../src/services/SecurityService.ts","../src/services/ServerManager.ts","../src/services/SessionHeartbeatService.ts","../src/services/SessionLifecycleService.ts","../src/services/SocketClient.ts","../src/services/SocketServer.ts","../src/services/TracingService.ts","../src/services/VideoPipelineService.ts","../src/services/healing/FuzzyXmlHealingProvider.ts","../src/services/healing/HealEtalonService.ts","../src/services/healing/HealedLocatorGenerator.ts","../src/services/healing/HealingOrchestrator.ts","../src/services/healing/LlmHealingProvider.ts","../src/services/healing/OcrHealingProvider.ts","../src/services/healing/ResilioTreeHealingProvider.ts","../src/services/healing/VisualAiHealingProvider.ts","../src/services/healing/types.ts","../src/services/omni-vision/OmniVisionService.ts","../src/services/omni-vision/VisionAssertionService.ts","../src/sessions/CloudSession.ts","../src/sessions/LocalSession.ts","../src/sessions/RemoteSession.ts","../src/sessions/SessionManager.ts","../src/sessions/XenonSession.ts","../src/types/CLIArgs.ts","../src/types/CloudArgs.ts","../src/types/CloudSchema.ts","../src/types/DeviceType.ts","../src/types/DeviceUpdate.ts","../src/types/IOSDevice.ts","../src/types/Platform.ts","../src/types/SessionStatus.ts","../src/types/healing.d.ts","../src/validators/CapabilityValidator.ts","../test/e2e/e2ehelper.ts","../test/e2e/plugin-harness.ts","../test/e2e/plugin.spec.ts","../test/e2e/startup-verification.spec.ts","../test/e2e/telemetry_verification.spec.ts","../test/e2e/video-recording-test.spec.js","../test/e2e/android/conf.spec.js","../test/e2e/android/conf2.spec.js","../test/e2e/android/conf3.spec.js","../test/e2e/hubnode/forward-request.spec.ts","../test/e2e/hubnode/hubnode.spec.ts","../test/e2e/ios/conf1.spec.js","../test/e2e/ios/conf2.spec.js","../test/helpers/test-container.ts","../test/integration/androidDevices.spec.ts","../test/integration/cliArgs.js","../test/integration/testHelpers.js","../test/integration/ios/01iOSSimulator.spec.ts","../test/integration/ios/02iOSDevices.spec.ts","../test/unit/AndroidDeviceManager.spec.ts","../test/unit/ChromeDriverManager.spec.js","../test/unit/CleanupService.spec.ts","../test/unit/DeviceModel.spec.ts","../test/unit/FuzzyXmlHealingProvider.test.ts","../test/unit/GetAdbOriginal.js","../test/unit/HealingCascade.test.ts","../test/unit/IOSDeviceManager.spec.js","../test/unit/OrphanSweeper.test.ts","../test/unit/PortAllocator.test.ts","../test/unit/RemoteIOs.spec.js","../test/unit/ResilioTreeHealingProvider.test.ts","../test/unit/SessionHeartbeatWrite.test.ts","../test/unit/commands.spec.js","../test/unit/config.spec.js","../test/unit/device-service.spec.ts","../test/unit/device-utils.spec.ts","../test/unit/helpers.spec.ts","../test/unit/omni-vision.spec.ts","../test/unit/plugin.spec.ts","../test/unit/prisma.spec.ts","../test/unit/fixtures/device.config.js","../test/unit/fixtures/devices.js"],"version":"5.9.3"}
+{"root":["../src/InternalHttpClient.ts","../src/PluginContext.ts","../src/XenonCapabilityManager.ts","../src/chromeUtils.ts","../src/config.ts","../src/device-utils.ts","../src/index.ts","../src/logger.ts","../src/plugin.ts","../src/prisma.ts","../src/app/index.ts","../src/app/swagger-docs.ts","../src/app/swagger.ts","../src/app/routers/apikeys.ts","../src/app/routers/apps.ts","../src/app/routers/auth.ts","../src/app/routers/config.ts","../src/app/routers/control.ts","../src/app/routers/dashboard.ts","../src/app/routers/grid.ts","../src/app/routers/processes.ts","../src/app/routers/reservation.ts","../src/app/routers/webhook.ts","../src/auth/nodeSecret.ts","../src/commands/handle.ts","../src/commands/index.ts","../src/dashboard/asset-manager.ts","../src/dashboard/commands.ts","../src/dashboard/event-manager.ts","../src/dashboard/services/app-service.ts","../src/dashboard/services/failure-analysis-service.ts","../src/dashboard/services/session-service.ts","../src/data-service/CircuitBreaker.ts","../src/data-service/config-service.ts","../src/data-service/db.ts","../src/data-service/device-service.ts","../src/data-service/device-store.interface.ts","../src/data-service/device-store.ts","../src/data-service/pending-sessions-service.ts","../src/data-service/pluginArgs.ts","../src/data-service/prisma-service.ts","../src/data-service/prisma-store.ts","../src/data-service/queue-service.ts","../src/data-service/web-config-service.ts","../src/device-managers/AndroidDeviceManager.ts","../src/device-managers/ChromeDriverManager.ts","../src/device-managers/HealthMonitorService.ts","../src/device-managers/IOSDeviceManager.ts","../src/device-managers/NodeDevices.ts","../src/device-managers/iOSTracker.ts","../src/device-managers/index.ts","../src/device-managers/android/AndroidStreamService.ts","../src/device-managers/android/DeviceLockManager.ts","../src/device-managers/cloud/CapabilityManager.ts","../src/device-managers/cloud/Devices.ts","../src/device-managers/ios/IOSDiscoveryService.ts","../src/device-managers/ios/IOSStreamService.ts","../src/device-managers/ios/WDAClient.ts","../src/enums/Capabilities.ts","../src/enums/Cloud.ts","../src/enums/Platform.ts","../src/enums/SessionType.ts","../src/enums/SocketEvents.ts","../src/generated/client/default.d.ts","../src/generated/client/default.js","../src/generated/client/edge.d.ts","../src/generated/client/edge.js","../src/generated/client/index-browser.js","../src/generated/client/index.d.ts","../src/generated/client/index.js","../src/generated/client/wasm.d.ts","../src/generated/client/wasm.js","../src/generated/client/runtime/edge-esm.js","../src/generated/client/runtime/edge.js","../src/generated/client/runtime/index-browser.d.ts","../src/generated/client/runtime/index-browser.js","../src/generated/client/runtime/library.d.ts","../src/generated/client/runtime/library.js","../src/generated/client/runtime/react-native.js","../src/generated/client/runtime/wasm.js","../src/helpers/UniversalMjpegProxy.ts","../src/helpers/index.ts","../src/interceptors/CommandInterceptor.ts","../src/interfaces/ICloudManager.ts","../src/interfaces/IDevice.ts","../src/interfaces/IDeviceFilterOptions.ts","../src/interfaces/IDeviceManager.ts","../src/interfaces/IOptions.ts","../src/interfaces/IPluginArgs.ts","../src/interfaces/ISessionCapability.ts","../src/logging/sessionContext.ts","../src/middleware/apiKeyMiddleware.ts","../src/middleware/csrfMiddleware.ts","../src/middleware/nodeSecretMiddleware.ts","../src/middleware/rateLimitMiddleware.ts","../src/middleware/scopeGuard.ts","../src/profiling/AndroidAppProfiler.ts","../src/proxy/wd-command-proxy.ts","../src/scripts/generate-database-migration.ts","../src/scripts/initialize-database.ts","../src/scripts/install-go-ios.ts","../src/scripts/prepare-prisma.ts","../src/scripts/run-migrations.ts","../src/services/AICommandService.ts","../src/services/AIService.ts","../src/services/ApiKeyService.ts","../src/services/CircuitBreaker.ts","../src/services/CleanupService.ts","../src/services/DeviceReconciler.ts","../src/services/EventBus.ts","../src/services/InspectorService.ts","../src/services/MetricsService.ts","../src/services/NetworkConditioningService.ts","../src/services/NotificationService.ts","../src/services/OrphanSweeper.ts","../src/services/PortAllocator.ts","../src/services/ProcessMetricsService.ts","../src/services/ProcessRegistry.ts","../src/services/RequestLogService.ts","../src/services/ResourceIsolationService.ts","../src/services/SecurityService.ts","../src/services/ServerManager.ts","../src/services/SessionHeartbeatService.ts","../src/services/SessionLifecycleService.ts","../src/services/ShutdownCoordinator.ts","../src/services/SocketClient.ts","../src/services/SocketServer.ts","../src/services/TracingService.ts","../src/services/VideoPipelineService.ts","../src/services/healing/FuzzyXmlHealingProvider.ts","../src/services/healing/HealEtalonService.ts","../src/services/healing/HealedLocatorGenerator.ts","../src/services/healing/HealingMetrics.ts","../src/services/healing/HealingOrchestrator.ts","../src/services/healing/LlmHealingProvider.ts","../src/services/healing/OcrHealingProvider.ts","../src/services/healing/ResilioTreeHealingProvider.ts","../src/services/healing/VisualAiHealingProvider.ts","../src/services/healing/types.ts","../src/services/omni-vision/OmniVisionService.ts","../src/services/omni-vision/VisionAssertionService.ts","../src/sessions/CloudSession.ts","../src/sessions/LocalSession.ts","../src/sessions/RemoteSession.ts","../src/sessions/SessionManager.ts","../src/sessions/XenonSession.ts","../src/types/CLIArgs.ts","../src/types/CloudArgs.ts","../src/types/CloudSchema.ts","../src/types/DeviceType.ts","../src/types/DeviceUpdate.ts","../src/types/IOSDevice.ts","../src/types/Platform.ts","../src/types/SessionStatus.ts","../src/types/express.d.ts","../src/types/healing.d.ts","../src/validators/CapabilityValidator.ts","../test/e2e/e2ehelper.ts","../test/e2e/plugin-harness.ts","../test/e2e/plugin.spec.ts","../test/e2e/startup-verification.spec.ts","../test/e2e/telemetry_verification.spec.ts","../test/e2e/video-recording-test.spec.js","../test/e2e/android/conf.spec.js","../test/e2e/android/conf2.spec.js","../test/e2e/android/conf3.spec.js","../test/e2e/hubnode/forward-request.spec.ts","../test/e2e/hubnode/hubnode.spec.ts","../test/e2e/ios/conf1.spec.js","../test/e2e/ios/conf2.spec.js","../test/helpers/test-container.ts","../test/integration/androidDevices.spec.ts","../test/integration/cliArgs.js","../test/integration/testHelpers.js","../test/integration/ios/01iOSSimulator.spec.ts","../test/integration/ios/02iOSDevices.spec.ts","../test/unit/AndroidDeviceManager.spec.ts","../test/unit/ApiKeyService.test.ts","../test/unit/ChromeDriverManager.spec.js","../test/unit/CleanupService.spec.ts","../test/unit/DeviceModel.spec.ts","../test/unit/FuzzyXmlHealingProvider.test.ts","../test/unit/GetAdbOriginal.js","../test/unit/HealingCascade.test.ts","../test/unit/IOSDeviceManager.spec.js","../test/unit/OrphanSweeper.test.ts","../test/unit/PortAllocator.test.ts","../test/unit/ProcessRegistry.test.ts","../test/unit/RemoteIOs.spec.js","../test/unit/ResilioTreeHealingProvider.test.ts","../test/unit/SessionHeartbeatWrite.test.ts","../test/unit/apiKeyMiddleware.test.ts","../test/unit/commands.spec.js","../test/unit/config.spec.js","../test/unit/device-service.spec.ts","../test/unit/device-utils.spec.ts","../test/unit/helpers.spec.ts","../test/unit/nodeSecretMiddleware.test.ts","../test/unit/omni-vision.spec.ts","../test/unit/plugin.spec.ts","../test/unit/prisma.spec.ts","../test/unit/rateLimitMiddleware.test.ts","../test/unit/fixtures/device.config.js","../test/unit/fixtures/devices.js"],"version":"5.9.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xenon-device-management/xenon",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Xenon - Intelligent Mobile Infrastructure. A self-healing device orchestration platform for Appium.",
   "main": "./lib/src/index.js",
   "exports": {
@@ -214,4 +214,4 @@
   "typedoc": {
     "entryPoint": "lib/src/index.js"
   }
-}
+}

package/prisma/migrations/20260423081701_add_session_indexes/migration.sql

@@ -0,0 +1,8 @@
+-- CreateIndex
+CREATE INDEX "Session_build_id_idx" ON "Session"("build_id");
+
+-- CreateIndex
+CREATE INDEX "Session_device_udid_idx" ON "Session"("device_udid");
+
+-- CreateIndex
+CREATE INDEX "Session_device_platform_status_idx" ON "Session"("device_platform", "status");

package/prisma/schema.prisma

@@ -53,6 +53,9 @@ model Session {
   SessionLog              SessionLog[]
 
   @@index([status, last_heartbeat_at])
+  @@index([build_id])
+  @@index([device_udid])
+  @@index([device_platform, status])
 }
 
 model SessionLog {

package/schema.json

@@ -10,7 +10,8 @@
                 "android",
                 "both"
             ],
-            "default": "both"
+            "default": "both",
+            "description": "Which mobile platform(s) Xenon should discover and orchestrate."
         },
         "androidDeviceType": {
             "title": "DeviceTypeToInclude",
@@ -20,14 +21,16 @@
                 "real",
                 "simulated"
             ],
-            "default": "both"
+            "default": "both",
+            "description": "Which Android device kinds to include: physical devices, emulators, or both."
         },
         "simulators": {
             "type": "array",
             "items": {
                 "$ref": "#/definitions/SimulatorConfig"
             },
-            "default": []
+            "default": [],
+            "description": "Allow-list of iOS simulators (by name + sdk) to expose. Empty array means expose all discoverable simulators."
         },
         "iosDeviceType": {
             "title": "DeviceTypeToInclude1",
@@ -37,28 +40,34 @@
                 "real",
                 "simulated"
             ],
-            "default": "both"
+            "default": "both",
+            "description": "Which iOS device kinds to include: physical devices, simulators, or both."
         },
         "hub": {
-            "type": "string"
+            "type": "string",
+            "description": "URL of the Xenon hub this instance should register with as a node (e.g. http://hub.example:4723). Omit to run as a standalone hub."
         },
         "remoteMachineProxyIP": {
-            "type": "string"
+            "type": "string",
+            "description": "Public host/URL that clients should use to reach this node when running behind a reverse proxy or NAT."
         },
         "adbRemote": {
             "type": "array",
             "items": {
                 "type": "string"
             },
-            "default": []
+            "default": [],
+            "description": "List of remote ADB hosts in host:port form (e.g. '192.168.1.50:5037') to discover Android devices on other machines."
         },
         "skipChromeDownload": {
             "type": "boolean",
-            "default": true
+            "default": true,
+            "description": "Skip the automatic ChromeDriver download performed by uiautomator2. Leave true unless you specifically need Xenon to manage Chrome binaries."
         },
         "maxSessions": {
             "type": "number",
-            "default": 8
+            "default": 8,
+            "description": "Maximum number of Appium sessions this node will run concurrently. Additional requests queue until a slot frees."
         },
         "cloud": {
             "type": "object",
@@ -77,7 +86,8 @@
             "items": {
                 "$ref": "#/definitions/EmulatorConfig"
             },
-            "default": []
+            "default": [],
+            "description": "Allow-list of Android emulator AVDs to expose. Empty array means expose all discoverable emulators."
         },
         "proxy": {
             "type": "object",
@@ -85,64 +95,79 @@
         },
         "deviceAvailabilityTimeoutMs": {
             "type": "number",
-            "default": 300000
+            "default": 300000,
+            "description": "How long (ms) a session request waits for a free device before failing."
         },
         "deviceAvailabilityQueryIntervalMs": {
             "type": "number",
-            "default": 10000
+            "default": 10000,
+            "description": "How often (ms) the session queue polls for a free device while waiting."
         },
         "sendNodeDevicesToHubIntervalMs": {
             "type": "number",
-            "default": 30000
+            "default": 30000,
+            "description": "How often (ms) a node pushes its current device list to the hub. Only used when `hub` is set."
         },
         "checkStaleDevicesIntervalMs": {
             "type": "number",
-            "default": 30000
+            "default": 30000,
+            "description": "How often (ms) the hub prunes devices from nodes that have stopped heartbeating."
         },
         "checkBlockedDevicesIntervalMs": {
             "type": "number",
-            "default": 30000
+            "default": 30000,
+            "description": "How often (ms) to re-evaluate manually-blocked devices and the session reconciler that frees orphaned busy devices."
         },
         "newCommandTimeoutSec": {
             "type": "number",
-            "default": 60
+            "default": 60,
+            "description": "Default Appium newCommandTimeout (seconds) applied when a client does not send one. Also drives the reconciler that releases devices idle past this threshold."
         },
         "bindHostOrIp": {
             "type": "string",
-            "default": "127.0.0.1"
+            "default": "127.0.0.1",
+            "description": "Host/IP the Xenon REST and WebSocket server binds to. Set to 0.0.0.0 to expose on all interfaces."
         },
         "enableDashboard": {
             "type": "boolean",
-            "default": false
+            "default": false,
+            "description": "Serve the React dashboard at /xenon/ and the Socket.io event stream."
         },
         "bootedSimulators": {
             "type": "boolean",
-            "default": false
+            "default": false,
+            "description": "Only discover iOS simulators that are already booted. Recommended on machines with many installed simulators — avoids allocating WDA/MJPEG ports for shutdown sims (the WDA pool is 8100-8199, 100 ports)."
         },
         "bootedEmulators": {
             "type": "boolean",
-            "default": false
+            "default": false,
+            "description": "Only discover Android emulators that are already booted."
         },
         "removeDevicesFromDatabaseBeforeRunningThePlugin": {
             "type": "boolean",
-            "default": false
+            "default": false,
+            "description": "Wipe the persisted Device table at startup so discovery begins from a clean slate. Useful after hardware changes."
         },
         "healthCheckIntervalMs": {
             "type": "number",
-            "default": 86400000
+            "default": 86400000,
+            "description": "Default interval (ms) between background device health checks. Overridden when `healthCheckSchedule` is set."
         },
         "healthCheckSchedule": {
-            "type": "string"
+            "type": "string",
+            "description": "Cron expression for the device health-check job (e.g. '0 * * * *' for hourly). When set, takes precedence over `healthCheckIntervalMs`."
         },
         "databaseProvider": {
             "type": "string",
             "enum": [
                 "sqlite",
                 "postgresql"
-            ]
+            ],
+            "description": "Database backend. Defaults to sqlite (file under ~/.cache/xenon). Use postgresql for multi-node hub deployments."
         },
         "databaseUrl": {
-            "type": "string"
+            "type": "string",
+            "description": "Prisma-style database URL. For sqlite: `file:/path/to/xenon.db`. For postgres: `postgresql://user:pass@host/db`. Falls back to the DATABASE_URL env var."
         },
         "aiProvider": {
             "type": "string",
@@ -151,55 +176,77 @@
                 "openai",
                 "anthropic",
                 "ollama"
-            ]
+            ],
+            "description": "AI provider for the LLM healing tier and visual analysis. Also controlled by XENON_AI_PROVIDER."
         },
         "aiModel": {
-            "type": "string"
+            "type": "string",
+            "description": "Override the default model for the selected `aiProvider` (e.g. 'gemini-1.5-pro', 'gpt-4o', 'claude-sonnet-4-6'). Falls back to XENON_AI_MODEL."
         },
         "aiBaseUrl": {
-            "type": "string"
+            "type": "string",
+            "description": "Custom base URL for the AI provider (e.g. a local Ollama server or an OpenAI-compatible gateway). Falls back to XENON_AI_BASE_URL."
         },
         "geminiApiKey": {
-            "type": "string"
+            "type": "string",
+            "description": "Gemini API key. Prefer setting XENON_GEMINI_API_KEY (or GEMINI_API_KEY) via environment instead of committing it to a config file."
         },
         "openaiApiKey": {
-            "type": "string"
+            "type": "string",
+            "description": "OpenAI API key. Prefer setting XENON_OPENAI_API_KEY (or OPENAI_API_KEY) via environment."
         },
         "anthropicApiKey": {
-            "type": "string"
+            "type": "string",
+            "description": "Anthropic API key. Prefer setting XENON_ANTHROPIC_API_KEY (or ANTHROPIC_API_KEY) via environment."
         },
         "enableSelfHealing": {
             "type": "boolean",
-            "default": true
+            "default": true,
+            "description": "Enable the 5-tier self-healing pipeline (Native → Fuzzy XML → OCR → Visual AI → LLM) for failed findElement calls. Can also be toggled at runtime from the dashboard."
         },
         "buildCleanupDays": {
             "type": "number",
-            "default": 30
+            "default": 30,
+            "description": "Builds/sessions older than this many days are purged by the cleanup job."
         },
         "buildCleanupMaxCount": {
             "type": "number",
-            "default": 100
+            "default": 100,
+            "description": "Maximum number of builds to retain. Oldest-first eviction beyond this cap regardless of `buildCleanupDays`."
         },
         "buildCleanupSchedule": {
             "type": "string",
-            "default": "0 0 * * *"
+            "default": "0 0 * * *",
+            "description": "Cron expression for the retention job. Default '0 0 * * *' runs at midnight."
         },
         "deleteBuildAssets": {
             "type": "boolean",
-            "default": true
+            "default": true,
+            "description": "When true, the cleanup job also deletes session video recordings and screenshots from disk (not just DB rows)."
         },
         "sessionHeartbeatIntervalMs": {
             "type": "number",
-            "default": 30000
+            "default": 30000,
+            "description": "How often (ms) each active session writes a heartbeat. The orphan sweeper uses ~3× this interval to detect abandoned sessions."
         },
         "enableJsonLogging": {
             "type": "boolean",
-            "default": false
+            "default": false,
+            "description": "Emit structured JSON log lines instead of human-readable text. Recommended for shipping logs to a log aggregator."
         },
         "tlsRejectUnauthorized": {
             "type": "boolean",
             "default": true,
             "description": "Whether to verify TLS certificates for internal outgoing requests. Default is true. Set to false only for dev/test."
+        },
+        "authDisabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "Disable API key authentication for all /xenon/api/* endpoints. Use only in local dev environments."
+        },
+        "nodeSecret": {
+            "type": "string",
+            "description": "Shared secret for hub-node channel authentication. Nodes must send this value in X-Xenon-Node-Secret header."
         }
     },
     "required": [