portholejs 0.1.0

package/dist/server/mjpeg.js

@@ -0,0 +1,92 @@
+import { pngToScaledJpeg } from "./frame-convert.js";
+export const MJPEG_BOUNDARY = "porthole-frame";
+export function multipartPart(frame) {
+    return Buffer.concat([
+        Buffer.from(`--${MJPEG_BOUNDARY}\r\nContent-Type: ${frame.mime}\r\nContent-Length: ${frame.data.byteLength}\r\n\r\n`),
+        Buffer.from(frame.data),
+        Buffer.from("\r\n"),
+    ]);
+}
+export class MjpegPoller {
+    getEngine;
+    fps;
+    clients = new Set();
+    timer = null;
+    polling = false;
+    constructor(getEngine, fps = 3) {
+        this.getEngine = getEngine;
+        this.fps = fps;
+    }
+    addClient(res) {
+        this.clients.add(res);
+        res.writeHead(200, {
+            "Content-Type": `multipart/x-mixed-replace; boundary=${MJPEG_BOUNDARY}`,
+            "Cache-Control": "no-store, no-cache, must-revalidate",
+            Pragma: "no-cache",
+            Connection: "close",
+        });
+        res.on("close", () => {
+            this.clients.delete(res);
+            if (this.clients.size === 0)
+                this.stop();
+        });
+        this.start();
+    }
+    start() {
+        if (this.timer || this.polling)
+            return;
+        this.schedule(0);
+    }
+    stop() {
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = null;
+    }
+    schedule(delayMs) {
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            void this.tick();
+        }, delayMs);
+    }
+    async tick() {
+        if (this.clients.size === 0 || this.polling)
+            return;
+        this.polling = true;
+        try {
+            const engine = this.getEngine();
+            const frame = await (engine?.captureFrame?.() ?? fallbackFrame(engine));
+            if (frame) {
+                const part = multipartPart(compressFrame(frame));
+                for (const client of this.clients) {
+                    client.write(part);
+                }
+            }
+        }
+        catch {
+            // Transient capture errors are expected while the emulator is busy.
+        }
+        finally {
+            this.polling = false;
+            if (this.clients.size > 0) {
+                this.schedule(Math.max(100, Math.round(1000 / this.fps)));
+            }
+        }
+    }
+}
+async function fallbackFrame(engine) {
+    if (!engine)
+        return null;
+    return { data: await engine.screenshot(), mime: "image/png" };
+}
+function compressFrame(frame) {
+    if (frame.mime !== "image/png")
+        return frame;
+    try {
+        return pngToScaledJpeg(frame.data);
+    }
+    catch {
+        // A malformed capture is better delivered raw than dropped.
+        return frame;
+    }
+}
+//# sourceMappingURL=mjpeg.js.map

package/dist/server/mjpeg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mjpeg.js","sourceRoot":"","sources":["../../src/server/mjpeg.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAE/C,MAAM,UAAU,aAAa,CAAC,KAAyC;IACrE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,CAAC,IAAI,CACT,KAAK,cAAc,qBAAqB,KAAK,CAAC,IAAI,uBAAuB,KAAK,CAAC,IAAI,CAAC,UAAU,UAAU,CACzG;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;KACpB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,WAAW;IAMH;IACA;IANX,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpC,KAAK,GAAyC,IAAI,CAAC;IACnD,OAAO,GAAG,KAAK,CAAC;IAExB,YACmB,SAA8B,EAC9B,MAAM,CAAC;QADP,cAAS,GAAT,SAAS,CAAqB;QAC9B,QAAG,GAAH,GAAG,CAAI;IACvB,CAAC;IAEJ,SAAS,CAAC,GAAmB;QAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACjB,cAAc,EAAE,uCAAuC,cAAc,EAAE;YACvE,eAAe,EAAE,qCAAqC;YACtD,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAEO,KAAK;QACX,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACvC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAEO,IAAI;QACV,IAAI,IAAI,CAAC,KAAK;YAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAEO,QAAQ,CAAC,OAAe;QAC9B,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QACnB,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACpD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;YACxE,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,IAAI,GAAG,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;gBACjD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBAClC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;QACtE,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACrB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBAC1B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,KAAK,UAAU,aAAa,CAC1B,MAAqB;IAErB,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,aAAa,CAAC,KAAyC;IAI9D,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,4DAA4D;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/server/ws.d.ts

@@ -0,0 +1,15 @@
+import type { IncomingMessage, Server } from "node:http";
+import { WebSocket } from "ws";
+import type { Engine } from "../engine/types.js";
+import type { DeviceInfo } from "../device-manager.js";
+export interface WsServerOptions {
+    httpServer: Server;
+    getEngine: () => Engine | null;
+    getDevice?: () => DeviceInfo;
+    token?: string;
+}
+export declare function createWsServer(opts: WsServerOptions): {
+    wss: import("ws").Server<typeof WebSocket, typeof IncomingMessage>;
+    attachEngine: (engine: Engine) => void;
+};
+//# sourceMappingURL=ws.d.ts.map

package/dist/server/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../src/server/ws.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAmB,SAAS,EAAE,MAAM,IAAI,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,oBAAoB,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAIvD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,UAAU,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe;;2BASpB,MAAM,KAAG,IAAI;EAkD5C"}

package/dist/server/ws.js

@@ -0,0 +1,102 @@
+import { WebSocketServer, WebSocket } from "ws";
+import { assertInputAllowed, parseInputEvent } from "../input-validation.js";
+import { encodeVideoPacket } from "../protocol.js";
+import { debugLog } from "../log.js";
+export function createWsServer(opts) {
+    const { httpServer, getEngine, getDevice, token } = opts;
+    const wss = new WebSocketServer({ server: httpServer, path: "/ws" });
+    let currentEngine = null;
+    let lastConfig = null;
+    let lastKeyframe = null;
+    function attachEngine(engine) {
+        currentEngine = engine;
+        engine.onVideoChunk((chunk) => {
+            const packet = Buffer.from(encodeVideoPacket(chunk));
+            if (chunk.type === "config") {
+                lastConfig = packet;
+            }
+            else {
+                // Cache keyframes for new clients
+                const isKey = chunk.keyframe ?? hasIdrNal(chunk.data);
+                if (isKey) {
+                    lastKeyframe = packet;
+                }
+            }
+            for (const client of wss.clients) {
+                if (client.readyState === WebSocket.OPEN) {
+                    client.send(packet);
+                }
+            }
+        });
+    }
+    wss.on("connection", (ws, req) => {
+        debugLog("ws", "client connected");
+        if (!isAuthorized(req, token)) {
+            ws.close(1008, "Porthole token required.");
+            return;
+        }
+        // Send cached config + keyframe so late-joining clients can decode immediately
+        if (lastConfig)
+            ws.send(lastConfig);
+        if (lastKeyframe)
+            ws.send(lastKeyframe);
+        ws.on("message", (data) => {
+            const engine = getEngine() ?? currentEngine;
+            if (!engine)
+                return;
+            try {
+                const event = parseInputEvent(JSON.parse(data.toString()));
+                const device = getDevice?.();
+                if (device)
+                    assertInputAllowed(device.profile, event);
+                void engine.sendInput(event);
+            }
+            catch {
+                debugLog("ws", "ignored invalid input message");
+                // Invalid message, ignore
+            }
+        });
+    });
+    return { wss, attachEngine };
+}
+function isAuthorized(req, token) {
+    if (!token)
+        return true;
+    if (isLocalAddress(req.socket.remoteAddress))
+        return true;
+    const url = new URL(req.url ?? "/", "http://localhost");
+    if (url.searchParams.get("token") === token)
+        return true;
+    return parseCookie(req.headers.cookie ?? "").get("porthole_token") === token;
+}
+function isLocalAddress(address) {
+    return (!address ||
+        address === "127.0.0.1" ||
+        address === "::1" ||
+        address === "::ffff:127.0.0.1");
+}
+function parseCookie(cookie) {
+    const values = new Map();
+    for (const part of cookie.split(";")) {
+        const [key, value] = part.trim().split("=");
+        if (key && value)
+            values.set(key, value);
+    }
+    return values;
+}
+function hasIdrNal(data) {
+    for (let i = 0; i < data.length - 4; i++) {
+        if (data[i] === 0 && data[i + 1] === 0) {
+            let offset = i + 2;
+            if (data[offset] === 0)
+                offset++;
+            if (data[offset] === 1) {
+                const nalByte = data[offset + 1];
+                if (nalByte !== undefined && (nalByte & 0x1f) === 5)
+                    return true;
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=ws.js.map

package/dist/server/ws.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,45 @@
+import type { Engine } from "./engine/types.js";
+import type { DeviceInfo } from "./device-manager.js";
+import type { InputEvent } from "./input.js";
+export interface SessionOptions {
+    device: DeviceInfo;
+    port: number;
+    host: string;
+    maxSize?: number;
+    maxFps?: number;
+    bitrate?: number;
+    bootedByUs?: boolean;
+    detached?: boolean;
+    token?: string;
+    forceMjpeg?: boolean;
+}
+export declare class Session {
+    private engine;
+    private server;
+    private attachEngine;
+    private restartAttempts;
+    private stopping;
+    private status;
+    private readonly device;
+    private readonly port;
+    private readonly host;
+    private readonly maxSize;
+    private readonly maxFps;
+    private readonly bitrate?;
+    private readonly bootedByUs;
+    private readonly detached;
+    private readonly token?;
+    private readonly forceMjpeg;
+    constructor(opts: SessionOptions);
+    start(): Promise<{
+        url: string;
+    }>;
+    private startEngine;
+    private restartEngine;
+    sendInput(event: InputEvent): Promise<void>;
+    screenshot(): Promise<Uint8Array>;
+    getEngine(): Engine | null;
+    stop(): Promise<void>;
+    private ensureTvAwake;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAQ7C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAyD;IACvE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;gBAEzB,IAAI,EAAE,cAAc;IAe1B,KAAK,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;YAgDzB,WAAW;YAmBX,aAAa;IAqBrB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3C,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAKvC,SAAS,IAAI,MAAM,GAAG,IAAI;IAIpB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAcb,aAAa;CA2B5B"}

package/dist/session.js

@@ -0,0 +1,188 @@
+import { randomBytes } from "node:crypto";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { ScrcpyEngine } from "./engine/scrcpy-engine.js";
+import { createHttpServer } from "./server/http.js";
+import { createWsServer } from "./server/ws.js";
+import { removeSession, upsertSession } from "./state.js";
+import { clientDistPath, scrcpyServerPath } from "./paths.js";
+import { adbBin, findAndroidSdk } from "./device-manager.js";
+import { AndroidKeycode } from "./keycodes.js";
+const execFileAsync = promisify(execFile);
+export class Session {
+    engine = null;
+    server = null;
+    attachEngine = null;
+    restartAttempts = 0;
+    stopping = false;
+    status = "waiting";
+    device;
+    port;
+    host;
+    maxSize;
+    maxFps;
+    bitrate;
+    bootedByUs;
+    detached;
+    token;
+    forceMjpeg;
+    constructor(opts) {
+        this.device = opts.device;
+        this.port = opts.port;
+        this.host = opts.host;
+        this.maxSize = opts.maxSize ?? 1280;
+        this.maxFps = opts.maxFps ?? 30;
+        this.bitrate = opts.bitrate;
+        this.bootedByUs = opts.bootedByUs ?? false;
+        this.detached = opts.detached ?? false;
+        this.token =
+            opts.token ??
+                (isLanHost(opts.host) ? randomBytes(18).toString("base64url") : undefined);
+        this.forceMjpeg = opts.forceMjpeg ?? false;
+    }
+    async start() {
+        if (!this.device.serial) {
+            throw new Error("Device has no serial — is it running?");
+        }
+        const clientDir = clientDistPath();
+        const { server, listen } = createHttpServer({
+            port: this.port,
+            host: this.host,
+            clientDir,
+            getEngine: () => this.engine,
+            getDevice: () => this.device,
+            handleInput: (event) => this.sendInput(event),
+            token: this.token,
+            forceMjpeg: this.forceMjpeg,
+            getStatus: () => this.status,
+        });
+        this.server = server;
+        const { attachEngine } = createWsServer({
+            httpServer: server,
+            getEngine: () => this.engine,
+            getDevice: () => this.device,
+            token: this.token,
+        });
+        this.attachEngine = attachEngine;
+        await this.startEngine();
+        await listen();
+        const baseUrl = `http://${this.host}:${this.port}`;
+        const url = this.token ? `${baseUrl}/?token=${this.token}` : baseUrl;
+        await upsertSession({
+            serial: this.device.serial,
+            avdName: this.device.name,
+            profile: this.device.profile,
+            pid: process.pid,
+            port: this.port,
+            host: this.host,
+            url,
+            startedAt: new Date().toISOString(),
+            bootedByUs: this.bootedByUs,
+            detached: this.detached,
+        });
+        return { url };
+    }
+    async startEngine() {
+        if (!this.device.serial)
+            throw new Error("Device has no serial — is it running?");
+        const engine = new ScrcpyEngine({
+            serial: this.device.serial,
+            maxSize: this.maxSize,
+            maxFps: this.maxFps,
+            bitrate: this.bitrate,
+            serverPath: scrcpyServerPath(),
+        });
+        this.engine = engine;
+        engine.onClose?.(() => {
+            if (!this.stopping)
+                void this.restartEngine();
+        });
+        await engine.start();
+        this.status = "ok";
+        this.restartAttempts = 0;
+        this.attachEngine?.(engine);
+    }
+    async restartEngine() {
+        if (this.restartAttempts >= 3) {
+            this.status = "dead";
+            return;
+        }
+        this.status = "reconnecting";
+        this.restartAttempts++;
+        const delay = 500 * 2 ** (this.restartAttempts - 1);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+        try {
+            await this.engine?.stop();
+        }
+        catch {
+            // ignore
+        }
+        try {
+            await this.startEngine();
+        }
+        catch {
+            await this.restartEngine();
+        }
+    }
+    async sendInput(event) {
+        if (!this.engine)
+            throw new Error("Session not started");
+        if (this.device.profile === "tv")
+            await this.ensureTvAwake();
+        await this.engine.sendInput(event);
+    }
+    async screenshot() {
+        if (!this.engine)
+            throw new Error("Session not started");
+        return this.engine.screenshot();
+    }
+    getEngine() {
+        return this.engine;
+    }
+    async stop() {
+        this.stopping = true;
+        if (this.engine) {
+            await this.engine.stop();
+            this.engine = null;
+        }
+        if (this.server) {
+            const server = this.server;
+            await new Promise((resolve) => server.close(() => resolve()));
+            this.server = null;
+        }
+        await removeSession({ port: this.port, pid: process.pid });
+    }
+    async ensureTvAwake() {
+        if (!this.device.serial)
+            return;
+        try {
+            const adb = adbBin(findAndroidSdk());
+            const { stdout } = await execFileAsync(adb, [
+                "-s",
+                this.device.serial,
+                "shell",
+                "dumpsys",
+                "power",
+            ]);
+            if (/mWakefulness=(Asleep|Dozing)|Display Power:\s*state=OFF/.test(stdout)) {
+                await this.engine?.sendInput({
+                    kind: "key",
+                    phase: "down",
+                    keycode: AndroidKeycode.KEYCODE_WAKEUP,
+                });
+                await this.engine?.sendInput({
+                    kind: "key",
+                    phase: "up",
+                    keycode: AndroidKeycode.KEYCODE_WAKEUP,
+                });
+            }
+        }
+        catch {
+            // Do not block real input on dumpsys failures.
+        }
+    }
+}
+function isLanHost(host) {
+    return host === "0.0.0.0" || host === "::" || host === "";
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,27 @@
+import type { DeviceProfile } from "./profiles.js";
+export interface PortholeSessionRecord {
+    serial: string;
+    avdName: string;
+    profile: DeviceProfile;
+    pid: number;
+    port: number;
+    host: string;
+    url: string;
+    startedAt: string;
+    bootedByUs: boolean;
+    detached?: boolean;
+}
+export interface PortholeState {
+    sessions: PortholeSessionRecord[];
+}
+export declare function statePath(): string;
+export declare function readState(path?: string): Promise<PortholeState>;
+export declare function writeState(state: PortholeState, path?: string): Promise<void>;
+export declare function upsertSession(record: PortholeSessionRecord, path?: string): Promise<void>;
+export declare function removeSession(match: {
+    serial?: string;
+    port?: number;
+    pid?: number;
+}, path?: string): Promise<void>;
+export declare function isSerialBootedByPorthole(serial: string): Promise<boolean>;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAsB,SAAS,CAAC,IAAI,SAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAY1E;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE,aAAa,EACpB,IAAI,SAAc,GACjB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,qBAAqB,EAC7B,IAAI,SAAc,GACjB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACvD,IAAI,SAAc,GACjB,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK/E"}

package/dist/state.js

@@ -0,0 +1,70 @@
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+export function statePath() {
+    return process.env["PORTHOLE_STATE_FILE"] ?? join(tmpdir(), "porthole", "state.json");
+}
+export async function readState(path = statePath()) {
+    try {
+        const raw = await readFile(path, "utf8");
+        const parsed = JSON.parse(raw);
+        return {
+            sessions: Array.isArray(parsed.sessions)
+                ? parsed.sessions.filter(isSessionRecord)
+                : [],
+        };
+    }
+    catch {
+        return { sessions: [] };
+    }
+}
+export async function writeState(state, path = statePath()) {
+    await mkdir(dirname(path), { recursive: true });
+    const tmpPath = `${path}.${process.pid}.tmp`;
+    await writeFile(tmpPath, JSON.stringify(state, null, 2) + "\n");
+    await rename(tmpPath, path);
+}
+export async function upsertSession(record, path = statePath()) {
+    const state = await readState(path);
+    const sessions = state.sessions.filter((session) => session.serial !== record.serial &&
+        session.port !== record.port &&
+        session.pid !== record.pid);
+    sessions.push(record);
+    await writeState({ sessions }, path);
+}
+export async function removeSession(match, path = statePath()) {
+    const state = await readState(path);
+    const sessions = state.sessions.filter((session) => {
+        if (match.serial && session.serial === match.serial)
+            return false;
+        if (match.port !== undefined && session.port === match.port)
+            return false;
+        if (match.pid !== undefined && session.pid === match.pid)
+            return false;
+        return true;
+    });
+    if (sessions.length === 0) {
+        await rm(path, { force: true });
+        return;
+    }
+    await writeState({ sessions }, path);
+}
+export async function isSerialBootedByPorthole(serial) {
+    const state = await readState();
+    return state.sessions.some((session) => session.serial === serial && session.bootedByUs);
+}
+function isSessionRecord(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const record = value;
+    return (typeof record.serial === "string" &&
+        typeof record.avdName === "string" &&
+        (record.profile === "phone" || record.profile === "tv") &&
+        typeof record.pid === "number" &&
+        typeof record.port === "number" &&
+        typeof record.host === "string" &&
+        typeof record.url === "string" &&
+        typeof record.startedAt === "string" &&
+        typeof record.bootedByUs === "boolean");
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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

package/dist/target-resolution.d.ts

@@ -0,0 +1,14 @@
+import type { DeviceInfo } from "./device-manager.js";
+export type TargetResolution = {
+    action: "attach";
+    device: DeviceInfo;
+} | {
+    action: "boot";
+    avdName: string;
+    profile: DeviceInfo["profile"];
+} | {
+    action: "error";
+    message: string;
+};
+export declare function resolveTarget(devices: DeviceInfo[], avd?: string, serial?: string): TargetResolution;
+//# sourceMappingURL=target-resolution.d.ts.map

package/dist/target-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-resolution.d.ts","sourceRoot":"","sources":["../src/target-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;CAAE,GACnE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,wBAAgB,aAAa,CAC3B,OAAO,EAAE,UAAU,EAAE,EACrB,GAAG,CAAC,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,gBAAgB,CAqClB"}

package/dist/target-resolution.js

@@ -0,0 +1,37 @@
+export function resolveTarget(devices, avd, serial) {
+    if (serial) {
+        const bySerial = devices.find((device) => device.serial === serial);
+        if (!bySerial) {
+            return { action: "error", message: `No running emulator with serial ${serial}.` };
+        }
+        if (bySerial.state === "stopped") {
+            return { action: "error", message: `Device ${serial} is not running.` };
+        }
+        return { action: "attach", device: bySerial };
+    }
+    if (avd) {
+        const named = devices.find((device) => device.name === avd);
+        if (!named) {
+            return { action: "error", message: `AVD "${avd}" not found.` };
+        }
+        if (named.state === "running" || named.state === "offline") {
+            return { action: "attach", device: named };
+        }
+        return { action: "boot", avdName: named.name, profile: named.profile };
+    }
+    const running = devices.filter((device) => device.state === "running");
+    if (running.length === 1) {
+        return { action: "attach", device: running[0] };
+    }
+    if (running.length === 0) {
+        return {
+            action: "error",
+            message: "No running emulator. Specify an AVD name to boot.",
+        };
+    }
+    return {
+        action: "error",
+        message: "Multiple emulators running. Specify --device or an AVD name.",
+    };
+}
+//# sourceMappingURL=target-resolution.js.map

package/dist/target-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-resolution.js","sourceRoot":"","sources":["../src/target-resolution.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,aAAa,CAC3B,OAAqB,EACrB,GAAY,EACZ,MAAe;IAEf,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QACpE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,mCAAmC,MAAM,GAAG,EAAE,CAAC;QACpF,CAAC;QACD,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,MAAM,kBAAkB,EAAE,CAAC;QAC1E,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAChD,CAAC;IAED,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,GAAG,cAAc,EAAE,CAAC;QACjE,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC3D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IACvE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,mDAAmD;SAC7D,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,8DAA8D;KACxE,CAAC;AACJ,CAAC"}