@tantawowa/hosanna-tools 2.20.0 → 2.22.0

package/dist/device/device-cli.d.ts

@@ -0,0 +1,22 @@
+import type { Device, DeviceRunOptions, DeviceType } from './types.js';
+import type { DriverRegistry } from './driver-registry.js';
+export declare const DEVICE_TYPES: readonly DeviceType[];
+export interface DeviceListCommandOptions {
+    cwd: string;
+    type?: DeviceType;
+    json?: boolean;
+    env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
+    registry?: DriverRegistry;
+}
+export interface DeviceRunCommandOptions extends Omit<DeviceRunOptions, 'cwd'> {
+    cwd: string;
+    registry?: DriverRegistry;
+}
+type DeviceListMap = Map<string, Device[]>;
+export declare function createDefaultDriverRegistry(): DriverRegistry;
+export declare function runDeviceListCommand(options: DeviceListCommandOptions): Promise<void>;
+export declare function collectDevices(options: DeviceListCommandOptions): Promise<Map<DeviceType, Device[]>>;
+export declare function runDeviceRunCommand(options: DeviceRunCommandOptions): Promise<void>;
+export declare function formatDeviceListText(grouped: DeviceListMap): string;
+export declare function formatDeviceListJson(grouped: DeviceListMap): Record<string, Array<Omit<Device, 'password' | 'raw'>>>;
+export {};

package/dist/device/device-cli.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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEVICE_TYPES = void 0;
+exports.createDefaultDriverRegistry = createDefaultDriverRegistry;
+exports.runDeviceListCommand = runDeviceListCommand;
+exports.collectDevices = collectDevices;
+exports.runDeviceRunCommand = runDeviceRunCommand;
+exports.formatDeviceListText = formatDeviceListText;
+exports.formatDeviceListJson = formatDeviceListJson;
+const driver_registry_js_1 = require("./driver-registry.js");
+const devices_file_js_1 = require("./devices-file.js");
+const roku_driver_js_1 = require("./drivers/roku-driver.js");
+exports.DEVICE_TYPES = ['roku', 'ios', 'apple-tv', 'android', 'android-tv'];
+function createDefaultDriverRegistry() {
+    return (0, driver_registry_js_1.createDriverRegistry)([
+        new roku_driver_js_1.RokuDriver(),
+    ]);
+}
+async function runDeviceListCommand(options) {
+    const grouped = await collectDevices(options);
+    if (options.json) {
+        console.info(JSON.stringify(formatDeviceListJson(grouped), null, 2));
+    }
+    else {
+        console.info(formatDeviceListText(grouped));
+    }
+}
+async function collectDevices(options) {
+    var _a;
+    const registry = (_a = options.registry) !== null && _a !== void 0 ? _a : createDefaultDriverRegistry();
+    const types = options.type ? [options.type] : exports.DEVICE_TYPES;
+    const fileDevices = (0, devices_file_js_1.loadDevicesFile)({ cwd: options.cwd }).devices;
+    const grouped = new Map();
+    for (const type of types) {
+        try {
+            grouped.set(type, await registry.discover(type, { cwd: options.cwd, env: options.env }));
+        }
+        catch (_b) {
+            grouped.set(type, fileDevices
+                .filter(device => device.type === type)
+                .map(device => (Object.assign(Object.assign({}, device), { online: false }))));
+        }
+    }
+    return grouped;
+}
+async function runDeviceRunCommand(options) {
+    var _a, _b, _c, _d;
+    const registry = (_a = options.registry) !== null && _a !== void 0 ? _a : createDefaultDriverRegistry();
+    const driver = registry.getDriver(options.type);
+    const device = await registry.resolveDevice({
+        type: options.type,
+        cwd: options.cwd,
+        device: options.device,
+        env: options.env,
+    });
+    if (!options.noBuild && driver.build) {
+        await driver.build(device, Object.assign(Object.assign({}, options), { cwd: options.cwd }));
+    }
+    if (options.type === 'roku') {
+        const mod = await Promise.resolve().then(() => __importStar(require('../support-tools/run-roku.js')));
+        await mod.runRoku({
+            cwd: options.cwd,
+            ip: (_b = device.ip) !== null && _b !== void 0 ? _b : device.id,
+            installerPassword: options.installerPassword || ((_c = options.env) === null || _c === void 0 ? void 0 : _c.ROKU_DEVPASSWORD) || process.env.ROKU_DEVPASSWORD || device.password,
+            appPackage: options.appPackage,
+            sourceRoot: (_d = options.sourceRoot) !== null && _d !== void 0 ? _d : (options.appPackage ? undefined : 'platforms/roku/src'),
+            sourceMapRoot: options.sourceMapRoot,
+            files: options.files,
+            logs: options.logs,
+            logOutput: !options.noLogs,
+            applySourceMapToPaths: options.applySourceMapToPaths,
+            dotenv: true,
+        });
+        return;
+    }
+    await driver.deploy(device, Object.assign(Object.assign({}, options), { cwd: options.cwd }));
+    await driver.launch(device, Object.assign(Object.assign({}, options), { cwd: options.cwd }));
+    if (!options.noLogs) {
+        const handle = driver.streamLogs(device, Object.assign(Object.assign({}, options), { cwd: options.cwd }));
+        await new Promise((resolve) => {
+            const onSignal = () => {
+                handle.stop();
+                resolve();
+            };
+            process.once('SIGINT', onSignal);
+            process.once('SIGTERM', onSignal);
+        });
+    }
+}
+function formatDeviceListText(grouped) {
+    var _a;
+    const lines = [];
+    for (const [type, devices] of grouped.entries()) {
+        lines.push(`${type}`);
+        if (devices.length === 0) {
+            lines.push('  (none)');
+            continue;
+        }
+        for (const device of devices) {
+            const preferred = device.isPreferred ? '★' : ' ';
+            const defaultMarker = device.isDefault ? '✓' : ' ';
+            const status = device.online === false ? 'offline' : 'online';
+            const source = device.source === 'devices-file' ? 'file' : device.source;
+            lines.push(`  ${preferred}${defaultMarker} ${(_a = device.ip) !== null && _a !== void 0 ? _a : device.id}  ${device.name}  ${status}  ${source}`);
+        }
+    }
+    return lines.join('\n');
+}
+function formatDeviceListJson(grouped) {
+    const result = {};
+    for (const [type, devices] of grouped.entries()) {
+        result[type] = devices.map(device => ({
+            type: device.type,
+            id: device.id,
+            ip: device.ip,
+            name: device.name,
+            source: device.source,
+            online: device.online,
+            isDefault: device.isDefault,
+            isPreferred: device.isPreferred,
+        }));
+    }
+    return result;
+}
+//# sourceMappingURL=device-cli.js.map

package/dist/device/device-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-cli.js","sourceRoot":"","sources":["../../src/device/device-cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,kEAIC;AAED,oDAOC;AAED,wCAiBC;AAED,kDA0DC;AAED,oDAiBC;AAED,oDAeC;AArJD,6DAA4D;AAC5D,uDAAoD;AACpD,6DAAsD;AAEzC,QAAA,YAAY,GAA0B,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,CAAU,CAAC;AAiBjH,SAAgB,2BAA2B;IACzC,OAAO,IAAA,yCAAoB,EAAC;QAC1B,IAAI,2BAAU,EAAE;KACjB,CAAC,CAAC;AACL,CAAC;AAEM,KAAK,UAAU,oBAAoB,CAAC,OAAiC;IAC1E,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,OAAiC;;IACpE,MAAM,QAAQ,GAAG,MAAA,OAAO,CAAC,QAAQ,mCAAI,2BAA2B,EAAE,CAAC;IACnE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,oBAAY,CAAC;IAC3D,MAAM,WAAW,GAAG,IAAA,iCAAe,EAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC;IAClE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEhD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC3F,CAAC;QAAC,WAAM,CAAC;YACP,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW;iBAC1B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC;iBACtC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,iCAAM,MAAM,KAAE,MAAM,EAAE,KAAK,IAAG,CAAC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAEM,KAAK,UAAU,mBAAmB,CAAC,OAAgC;;IACxE,MAAM,QAAQ,GAAG,MAAA,OAAO,CAAC,QAAQ,mCAAI,2BAA2B,EAAE,CAAC;IACnE,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC;QAC1C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACrC,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,kCACpB,OAAO,KACV,GAAG,EAAE,OAAO,CAAC,GAAG,IAChB,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,wDAAa,8BAA8B,GAAC,CAAC;QACzD,MAAM,GAAG,CAAC,OAAO,CAAC;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,EAAE,EAAE,MAAA,MAAM,CAAC,EAAE,mCAAI,MAAM,CAAC,EAAE;YAC1B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,KAAI,MAAA,OAAO,CAAC,GAAG,0CAAE,gBAAgB,CAAA,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,MAAM,CAAC,QAAQ;YAChI,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,UAAU,EAAE,MAAA,OAAO,CAAC,UAAU,mCAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC;YACzF,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,CAAC,OAAO,CAAC,MAAM;YAC1B,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;YACpD,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,kCACrB,OAAO,KACV,GAAG,EAAE,OAAO,CAAC,GAAG,IAChB,CAAC;IACH,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,kCACrB,OAAO,KACV,GAAG,EAAE,OAAO,CAAC,GAAG,IAChB,CAAC;IAEH,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,kCAClC,OAAO,KACV,GAAG,EAAE,OAAO,CAAC,GAAG,IAChB,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,QAAQ,GAAG,GAAG,EAAE;gBACpB,MAAM,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAgB,oBAAoB,CAAC,OAAsB;;IACzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QACtB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACjD,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACnD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACzE,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,GAAG,aAAa,IAAI,MAAA,MAAM,CAAC,EAAE,mCAAI,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC;QAC/G,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAgB,oBAAoB,CAAC,OAAsB;IACzD,MAAM,MAAM,GAA4D,EAAE,CAAC;IAC3E,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACpC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC,CAAC,CAAC;IACN,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/device/device-driver.d.ts

@@ -0,0 +1 @@
+export type { DeviceDriver, DeviceDiscoveryOptions, DeviceRunOptions, LogStreamHandle, } from './types.js';

package/dist/device/device-driver.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=device-driver.js.map

package/dist/device/device-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-driver.js","sourceRoot":"","sources":["../../src/device/device-driver.ts"],"names":[],"mappings":""}

package/dist/device/devices-file.d.ts

@@ -0,0 +1,12 @@
+import type { Device } from './types.js';
+export interface LoadDevicesFileOptions {
+    cwd: string;
+    homeDir?: string;
+}
+export interface LoadDevicesFileResult {
+    devices: Device[];
+    warnings: string[];
+}
+export declare function loadDevicesFile(options: LoadDevicesFileOptions): LoadDevicesFileResult;
+export declare function mergeDevices(discoveredDevices: Device[], fileDevices: Device[]): Device[];
+export declare function deviceKey(device: Pick<Device, 'type' | 'id' | 'ip'>): string;

package/dist/device/devices-file.js

@@ -0,0 +1,112 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadDevicesFile = loadDevicesFile;
+exports.mergeDevices = mergeDevices;
+exports.deviceKey = deviceKey;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const DEVICE_TYPES = new Set(['roku', 'ios', 'apple-tv', 'android', 'android-tv']);
+function loadDevicesFile(options) {
+    var _a;
+    const cwd = options.cwd;
+    const homeDir = (_a = options.homeDir) !== null && _a !== void 0 ? _a : os_1.default.homedir();
+    const warnings = [];
+    const devicesByKey = new Map();
+    for (const filePath of [path_1.default.join(homeDir, '.hs-devices.json'), path_1.default.join(cwd, '.hs-devices.json')]) {
+        if (!fs_1.default.existsSync(filePath))
+            continue;
+        const parsed = JSON.parse(fs_1.default.readFileSync(filePath, 'utf8'));
+        if (!Array.isArray(parsed.devices)) {
+            warnings.push(`${filePath} does not contain a devices array.`);
+            continue;
+        }
+        for (const entry of parsed.devices) {
+            const device = normalizeFileEntry(entry, filePath, warnings);
+            if (!device)
+                continue;
+            devicesByKey.set(deviceKey(device), device);
+        }
+    }
+    const devices = Array.from(devicesByKey.values());
+    const firstDefaultByType = new Set();
+    for (const device of devices) {
+        if (!device.isDefault)
+            continue;
+        if (firstDefaultByType.has(device.type)) {
+            device.isDefault = false;
+            warnings.push(`Multiple default devices configured for type ${device.type}; using the first.`);
+        }
+        else {
+            firstDefaultByType.add(device.type);
+        }
+    }
+    return { devices, warnings };
+}
+function mergeDevices(discoveredDevices, fileDevices) {
+    var _a, _b, _c, _d, _e;
+    const discoveredByKey = new Map();
+    const matchedKeys = new Set();
+    for (const discovered of discoveredDevices) {
+        const normalized = Object.assign(Object.assign({}, discovered), { id: discovered.id || discovered.ip || discovered.name, online: (_a = discovered.online) !== null && _a !== void 0 ? _a : true, isPreferred: (_b = discovered.isPreferred) !== null && _b !== void 0 ? _b : false });
+        discoveredByKey.set(deviceKey(normalized), normalized);
+    }
+    const merged = [];
+    for (const fileDevice of fileDevices) {
+        const key = deviceKey(fileDevice);
+        const discovered = discoveredByKey.get(key);
+        if (discovered) {
+            matchedKeys.add(key);
+            merged.push(Object.assign(Object.assign({}, discovered), { name: fileDevice.name || discovered.name, ip: (_c = fileDevice.ip) !== null && _c !== void 0 ? _c : discovered.ip, password: fileDevice.password, isDefault: Boolean(fileDevice.isDefault), isPreferred: true, online: true, source: 'discovered', raw: discovered.raw }));
+        }
+        else {
+            merged.push(Object.assign(Object.assign({}, fileDevice), { online: false, isPreferred: true }));
+        }
+    }
+    for (const discovered of discoveredByKey.values()) {
+        if (matchedKeys.has(deviceKey(discovered)))
+            continue;
+        merged.push(Object.assign(Object.assign({}, discovered), { online: (_d = discovered.online) !== null && _d !== void 0 ? _d : true, isPreferred: (_e = discovered.isPreferred) !== null && _e !== void 0 ? _e : false }));
+    }
+    return merged.sort((a, b) => {
+        if (Boolean(a.isPreferred) !== Boolean(b.isPreferred))
+            return a.isPreferred ? -1 : 1;
+        if (Boolean(a.isDefault) !== Boolean(b.isDefault))
+            return a.isDefault ? -1 : 1;
+        return a.name.localeCompare(b.name);
+    });
+}
+function deviceKey(device) {
+    var _a, _b;
+    const id = device.type === 'roku' ? ((_a = device.ip) !== null && _a !== void 0 ? _a : device.id) : ((_b = device.id) !== null && _b !== void 0 ? _b : device.ip);
+    return `${device.type}:${String(id).toLowerCase()}`;
+}
+function normalizeFileEntry(entry, filePath, warnings) {
+    const type = typeof entry.type === 'string' ? entry.type : undefined;
+    if (!type || !DEVICE_TYPES.has(type)) {
+        warnings.push(`Ignoring device in ${filePath} with invalid type: ${String(entry.type)}`);
+        return null;
+    }
+    const ip = typeof entry.ip === 'string' && entry.ip.trim() ? entry.ip.trim() : undefined;
+    const id = typeof entry.id === 'string' && entry.id.trim() ? entry.id.trim() : ip;
+    if (!id) {
+        warnings.push(`Ignoring ${type} device in ${filePath} without id or ip.`);
+        return null;
+    }
+    const name = typeof entry.name === 'string' && entry.name.trim() ? entry.name.trim() : id;
+    const password = typeof entry.password === 'string' ? entry.password : undefined;
+    return {
+        type,
+        id,
+        ip,
+        name,
+        password,
+        source: 'devices-file',
+        isPreferred: true,
+        isDefault: entry.default === true,
+    };
+}
+//# sourceMappingURL=devices-file.js.map

package/dist/device/devices-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices-file.js","sourceRoot":"","sources":["../../src/device/devices-file.ts"],"names":[],"mappings":";;;;;AA0BA,0CAiCC;AAED,oCAsDC;AAED,8BAGC;AAxHD,4CAAoB;AACpB,4CAAoB;AACpB,gDAAwB;AAGxB,MAAM,YAAY,GAAG,IAAI,GAAG,CAAa,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;AAqB/F,SAAgB,eAAe,CAAC,OAA+B;;IAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,MAAM,OAAO,GAAG,MAAA,OAAO,CAAC,OAAO,mCAAI,YAAE,CAAC,OAAO,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE/C,KAAK,MAAM,QAAQ,IAAI,CAAC,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC;QACpG,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,SAAS;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAmC,CAAC;QAC/F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,oCAAoC,CAAC,CAAC;YAC/D,SAAS;QACX,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC7D,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAClD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAc,CAAC;IACjD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,SAAS;QAChC,IAAI,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,gDAAgD,MAAM,CAAC,IAAI,oBAAoB,CAAC,CAAC;QACjG,CAAC;aAAM,CAAC;YACN,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,SAAgB,YAAY,CAAC,iBAA2B,EAAE,WAAqB;;IAC7E,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAEtC,KAAK,MAAM,UAAU,IAAI,iBAAiB,EAAE,CAAC;QAC3C,MAAM,UAAU,mCACX,UAAU,KACb,EAAE,EAAE,UAAU,CAAC,EAAE,IAAI,UAAU,CAAC,EAAE,IAAI,UAAU,CAAC,IAAI,EACrD,MAAM,EAAE,MAAA,UAAU,CAAC,MAAM,mCAAI,IAAI,EACjC,WAAW,EAAE,MAAA,UAAU,CAAC,WAAW,mCAAI,KAAK,GAC7C,CAAC;QACF,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;QAClC,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,UAAU,EAAE,CAAC;YACf,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrB,MAAM,CAAC,IAAI,iCACN,UAAU,KACb,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,EACxC,EAAE,EAAE,MAAA,UAAU,CAAC,EAAE,mCAAI,UAAU,CAAC,EAAE,EAClC,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAC7B,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EACxC,WAAW,EAAE,IAAI,EACjB,MAAM,EAAE,IAAI,EACZ,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,UAAU,CAAC,GAAG,IACnB,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,iCACN,UAAU,KACb,MAAM,EAAE,KAAK,EACb,WAAW,EAAE,IAAI,IACjB,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;QAClD,IAAI,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAAE,SAAS;QACrD,MAAM,CAAC,IAAI,iCACN,UAAU,KACb,MAAM,EAAE,MAAA,UAAU,CAAC,MAAM,mCAAI,IAAI,EACjC,WAAW,EAAE,MAAA,UAAU,CAAC,WAAW,mCAAI,KAAK,IAC5C,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1B,IAAI,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;YAAE,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrF,IAAI,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,SAAS,CAAC,MAA0C;;IAClE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,MAAA,MAAM,CAAC,EAAE,mCAAI,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAA,MAAM,CAAC,EAAE,mCAAI,MAAM,CAAC,EAAE,CAAC,CAAC;IACxF,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAqB,EAAE,QAAgB,EAAE,QAAkB;IACrF,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAkB,CAAC,CAAC,CAAC,SAAS,CAAC;IACnF,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,sBAAsB,QAAQ,uBAAuB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,QAAQ,CAAC,IAAI,CAAC,YAAY,IAAI,cAAc,QAAQ,oBAAoB,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1F,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjF,OAAO;QACL,IAAI;QACJ,EAAE;QACF,EAAE;QACF,IAAI;QACJ,QAAQ;QACR,MAAM,EAAE,cAAc;QACtB,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,KAAK,CAAC,OAAO,KAAK,IAAI;KAClC,CAAC;AACJ,CAAC"}

package/dist/device/discovery/roku-ssdp.d.ts

@@ -0,0 +1,16 @@
+export interface RokuSsdpResponse {
+    ip: string;
+    location: string;
+    usn?: string;
+}
+export interface RokuDeviceInfo {
+    name: string;
+    modelName?: string;
+    serialNumber?: string;
+}
+export declare function parseSsdpResponse(message: Buffer | string): RokuSsdpResponse | null;
+export declare function parseRokuDeviceInfo(xml: string): RokuDeviceInfo;
+export declare function discoverRokus(options?: {
+    timeoutMs?: number;
+}): Promise<RokuSsdpResponse[]>;
+export declare function fetchRokuDeviceInfo(ip: string): Promise<RokuDeviceInfo | null>;

package/dist/device/discovery/roku-ssdp.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSsdpResponse = parseSsdpResponse;
+exports.parseRokuDeviceInfo = parseRokuDeviceInfo;
+exports.discoverRokus = discoverRokus;
+exports.fetchRokuDeviceInfo = fetchRokuDeviceInfo;
+const dgram_1 = __importDefault(require("dgram"));
+const http_1 = __importDefault(require("http"));
+function parseSsdpResponse(message) {
+    var _a;
+    const text = Buffer.isBuffer(message) ? message.toString('utf8') : message;
+    const headers = new Map();
+    for (const line of text.split(/\r?\n/)) {
+        const index = line.indexOf(':');
+        if (index < 0)
+            continue;
+        headers.set(line.slice(0, index).trim().toLowerCase(), line.slice(index + 1).trim());
+    }
+    const st = (_a = headers.get('st')) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+    const location = headers.get('location');
+    if (st !== 'roku:ecp' || !location)
+        return null;
+    try {
+        const url = new URL(location);
+        return {
+            ip: url.hostname,
+            location,
+            usn: headers.get('usn'),
+        };
+    }
+    catch (_b) {
+        return null;
+    }
+}
+function parseRokuDeviceInfo(xml) {
+    const friendlyName = readXmlTag(xml, 'friendly-device-name');
+    const userName = readXmlTag(xml, 'user-device-name');
+    const modelName = readXmlTag(xml, 'model-name');
+    const serialNumber = readXmlTag(xml, 'serial-number');
+    return {
+        name: friendlyName || userName || modelName || serialNumber || 'Roku',
+        modelName,
+        serialNumber,
+    };
+}
+async function discoverRokus(options = {}) {
+    var _a;
+    const timeoutMs = (_a = options.timeoutMs) !== null && _a !== void 0 ? _a : 3000;
+    const socket = dgram_1.default.createSocket('udp4');
+    const responses = new Map();
+    const search = [
+        'M-SEARCH * HTTP/1.1',
+        'HOST: 239.255.255.250:1900',
+        'MAN: "ssdp:discover"',
+        'MX: 3',
+        'ST: roku:ecp',
+        '',
+        '',
+    ].join('\r\n');
+    return new Promise((resolve) => {
+        const finish = () => {
+            try {
+                socket.close();
+            }
+            catch (_a) {
+                // ignore close errors
+            }
+            resolve(Array.from(responses.values()));
+        };
+        socket.on('message', message => {
+            const parsed = parseSsdpResponse(message);
+            if (parsed)
+                responses.set(parsed.ip, parsed);
+        });
+        socket.on('error', finish);
+        socket.bind(() => {
+            socket.setBroadcast(true);
+            socket.send(search, 1900, '239.255.255.250');
+            setTimeout(finish, timeoutMs);
+        });
+    });
+}
+async function fetchRokuDeviceInfo(ip) {
+    return new Promise((resolve) => {
+        const request = http_1.default.get(`http://${ip}:8060/query/device-info`, response => {
+            let body = '';
+            response.setEncoding('utf8');
+            response.on('data', chunk => {
+                body += chunk;
+            });
+            response.on('end', () => {
+                if (response.statusCode && response.statusCode >= 200 && response.statusCode < 300) {
+                    resolve(parseRokuDeviceInfo(body));
+                }
+                else {
+                    resolve(null);
+                }
+            });
+        });
+        request.setTimeout(1500, () => {
+            request.destroy();
+            resolve(null);
+        });
+        request.on('error', () => resolve(null));
+    });
+}
+function readXmlTag(xml, tagName) {
+    var _a;
+    const pattern = new RegExp(`<${tagName}>([^<]*)</${tagName}>`, 'i');
+    const match = pattern.exec(xml);
+    return ((_a = match === null || match === void 0 ? void 0 : match[1]) === null || _a === void 0 ? void 0 : _a.trim()) || undefined;
+}
+//# sourceMappingURL=roku-ssdp.js.map

package/dist/device/discovery/roku-ssdp.js.map

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

package/dist/device/driver-registry.d.ts

@@ -0,0 +1,12 @@
+import type { Device, DeviceDriver, DeviceType, ResolveDeviceOptions } from './types.js';
+export interface DriverRegistry {
+    getDriver(type: DeviceType): DeviceDriver;
+    discover(type: DeviceType, options: {
+        cwd: string;
+        env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
+    }): Promise<Device[]>;
+    resolveDevice(options: ResolveDeviceOptions): Promise<Device>;
+}
+export declare function createDriverRegistry(drivers: DeviceDriver[]): DriverRegistry;
+export declare function findDevice(devices: Device[], selector: string): Device | undefined;
+export declare function formatDeviceList(devices: Device[]): string;

package/dist/device/driver-registry.js

@@ -0,0 +1,114 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDriverRegistry = createDriverRegistry;
+exports.findDevice = findDevice;
+exports.formatDeviceList = formatDeviceList;
+const readline_1 = __importDefault(require("readline"));
+const ENV_DEVICE_KEYS = {
+    roku: ['ROKU_IP'],
+    android: ['ANDROID_SERIAL', 'HS_TARGET'],
+    'android-tv': ['ANDROID_SERIAL', 'HS_TARGET'],
+    ios: ['HS_TARGET'],
+    'apple-tv': ['HS_TARGET'],
+};
+function createDriverRegistry(drivers) {
+    const byType = new Map();
+    for (const driver of drivers) {
+        for (const type of driver.types) {
+            byType.set(type, driver);
+        }
+    }
+    function getDriver(type) {
+        const driver = byType.get(type);
+        if (!driver)
+            throw new Error(`No device driver registered for type ${type}.`);
+        return driver;
+    }
+    async function discover(type, options) {
+        return getDriver(type).discover({ cwd: options.cwd, env: options.env });
+    }
+    async function resolveDevice(options) {
+        var _a, _b, _c;
+        const env = (_a = options.env) !== null && _a !== void 0 ? _a : process.env;
+        const devices = await discover(options.type, { cwd: options.cwd, env });
+        const explicit = (_b = options.device) === null || _b === void 0 ? void 0 : _b.trim();
+        if (explicit) {
+            const match = findDevice(devices, explicit);
+            if (match)
+                return match;
+            throw new Error(`No ${options.type} device matched "${explicit}".\n${formatDeviceList(devices)}`);
+        }
+        for (const key of ENV_DEVICE_KEYS[options.type]) {
+            const value = (_c = env[key]) === null || _c === void 0 ? void 0 : _c.trim();
+            if (!value)
+                continue;
+            const match = findDevice(devices, value);
+            if (match)
+                return Object.assign(Object.assign({}, match), { source: match.source === 'discovered' ? match.source : 'env' });
+            return {
+                type: options.type,
+                id: value,
+                ip: options.type === 'roku' ? value : undefined,
+                name: value,
+                source: 'env',
+                online: true,
+            };
+        }
+        const defaultDevice = devices.find(device => device.isDefault && device.online !== false);
+        if (defaultDevice)
+            return defaultDevice;
+        const onlineDevices = devices.filter(device => device.online !== false);
+        if (onlineDevices.length === 1)
+            return onlineDevices[0];
+        if (onlineDevices.length > 1 && options.isTTY !== false && process.stdin.isTTY) {
+            return promptForDevice(options.type, onlineDevices);
+        }
+        if (onlineDevices.length > 1) {
+            throw new Error(`Multiple ${options.type} devices found. Re-run with --device <id|ip|name>.\n${formatDeviceList(devices)}`);
+        }
+        throw new Error(`No online ${options.type} devices found.\n${formatDeviceList(devices)}`);
+    }
+    return { getDriver, discover, resolveDevice };
+}
+function findDevice(devices, selector) {
+    const needle = selector.toLowerCase();
+    return devices.find(device => {
+        var _a;
+        return device.id.toLowerCase() === needle ||
+            ((_a = device.ip) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === needle ||
+            device.name.toLowerCase().includes(needle);
+    });
+}
+function formatDeviceList(devices) {
+    if (devices.length === 0)
+        return '  (none)';
+    return devices.map(device => {
+        const markers = `${device.isPreferred ? '★' : ' '} ${device.isDefault ? '✓' : ' '}`;
+        const status = device.online === false ? 'offline' : 'online';
+        const address = device.ip && device.ip !== device.id ? `${device.id} ${device.ip}` : device.id;
+        return `  ${markers} ${device.type} ${address} ${device.name} (${status})`;
+    }).join('\n');
+}
+async function promptForDevice(type, devices) {
+    console.info(`Select a ${type} device:`);
+    devices.forEach((device, index) => {
+        var _a;
+        console.info(`  ${index + 1}. ${device.name} (${(_a = device.ip) !== null && _a !== void 0 ? _a : device.id})`);
+    });
+    const answer = await new Promise((resolve) => {
+        const rl = readline_1.default.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question('Device number: ', value => {
+            rl.close();
+            resolve(value);
+        });
+    });
+    const index = Number(answer) - 1;
+    if (!Number.isInteger(index) || index < 0 || index >= devices.length) {
+        throw new Error(`Invalid ${type} device selection: ${answer}`);
+    }
+    return devices[index];
+}
+//# sourceMappingURL=driver-registry.js.map

package/dist/device/driver-registry.js.map

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

package/dist/device/drivers/roku-driver.d.ts

@@ -0,0 +1,30 @@
+import type { Device, DeviceDiscoveryOptions, DeviceDriver, DeviceRunOptions, LogStreamHandle } from '../types.js';
+export interface RokuDeployOptions {
+    ip?: string;
+    installerPassword?: string;
+    appPackage?: string;
+    sourceRoot?: string;
+    sourceMapRoot?: string;
+    files?: string[];
+    logs?: boolean;
+    logOutput?: boolean;
+    applySourceMapToPaths?: boolean;
+    dotenv?: boolean;
+}
+export type ResolvedDeployParams = {
+    ip: string;
+    installerPassword: string;
+    cwd: string;
+    opts: RokuDeployOptions;
+};
+export declare function mask(val?: string): string;
+export declare function formatDeployError(err: unknown): string;
+export declare function performDeploy(params: ResolvedDeployParams): Promise<void>;
+export declare class RokuDriver implements DeviceDriver {
+    readonly types: readonly ["roku"];
+    discover(opts: DeviceDiscoveryOptions): Promise<Device[]>;
+    build(_device: Device, opts: DeviceRunOptions): Promise<void>;
+    deploy(device: Device, opts: DeviceRunOptions): Promise<void>;
+    launch(_device: Device, _opts: DeviceRunOptions): Promise<void>;
+    streamLogs(device: Device): LogStreamHandle;
+}