@8bitbish/screenshot-service 1.0.0 → 1.0.1

package/dist/setup/pair.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pairAndroidWireless = pairAndroidWireless;
+exports.getLastAndroidEndpoint = getLastAndroidEndpoint;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const detect_1 = require("./detect");
+const ANDROID_IP_FILE = (0, path_1.join)((0, os_1.homedir)(), ".screenshotAssistent-android-ip");
+function emitStep(cb, patch) {
+    const p = { ...patch };
+    cb?.(p);
+    return p;
+}
+/**
+ * Pair and connect an Android device over wireless ADB.
+ *
+ * Phone setup (user-driven, before calling this):
+ *   Settings → Developer Options → Wireless Debugging ON → Pair device with pairing code
+ *   The phone shows: IP, pairing port, 6-digit code.
+ *
+ * What this does:
+ *   1. `adb pair ip:port` and feeds the code via stdin (no terminal prompt).
+ *   2. `adb connect ip:5555` (or custom connectPort) to establish the data connection.
+ *   3. Saves the IP for auto-reconnect on subsequent screenshots.
+ */
+async function pairAndroidWireless(opts, onProgress) {
+    const { ip, port, code, connectPort = "5555" } = opts;
+    if (!/^\d+\.\d+\.\d+\.\d+$/.test(ip))
+        throw new Error(`Invalid IP address: ${ip}`);
+    if (!/^\d+$/.test(port))
+        throw new Error(`Invalid pairing port: ${port}`);
+    if (!/^\d{6}$/.test(code))
+        throw new Error(`Pairing code must be 6 digits: got "${code}"`);
+    const { adb } = await (0, detect_1.checkAndroidSetup)();
+    if (!adb) {
+        throw new Error("adb not found. Run installAndroidDeps() first.");
+    }
+    const TOTAL = 2;
+    // ── Step 1: pair ───────────────────────────────────────────────────────────
+    let pair = emitStep(onProgress, {
+        id: "pair", label: `Pairing with ${ip}:${port}`, status: "running", index: 1, total: TOTAL,
+    });
+    await new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)(adb, ["pair", `${ip}:${port}`], {
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const lines = [];
+        const onOut = (chunk) => {
+            const text = chunk.toString("utf8");
+            lines.push(text);
+            for (const line of text.split("\n")) {
+                if (!line.trim())
+                    continue;
+                onProgress?.({ ...pair, log: line });
+            }
+        };
+        child.stdout.on("data", onOut);
+        child.stderr.on("data", onOut);
+        // adb pair prompts "Enter pairing code: " on stdin — feed the code immediately
+        child.stdin.write(`${code}\n`);
+        child.stdin.end();
+        child.on("error", reject);
+        child.on("close", (exitCode) => {
+            const combined = lines.join("");
+            if (exitCode === 0 && /successfully paired/i.test(combined)) {
+                resolve();
+            }
+            else {
+                reject(new Error("Pairing failed. Check the IP/port/code are correct and that the phone's pairing screen is still open.\n" +
+                    combined.trim()));
+            }
+        });
+    });
+    emitStep(onProgress, { ...pair, status: "done" });
+    // ── Step 2: connect ───────────────────────────────────────────────────────
+    let connect = emitStep(onProgress, {
+        id: "connect", label: `Connecting to ${ip}:${connectPort}`, status: "running", index: 2, total: TOTAL,
+    });
+    await new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)(adb, ["connect", `${ip}:${connectPort}`], { stdio: ["ignore", "pipe", "pipe"] });
+        const lines = [];
+        const onOut = (chunk) => {
+            const text = chunk.toString("utf8");
+            lines.push(text);
+            for (const line of text.split("\n")) {
+                if (!line.trim())
+                    continue;
+                onProgress?.({ ...connect, log: line });
+            }
+        };
+        child.stdout.on("data", onOut);
+        child.stderr.on("data", onOut);
+        child.on("error", reject);
+        child.on("close", (exitCode) => {
+            const combined = lines.join("");
+            // adb connect returns 0 even on failure — check the output text
+            if (exitCode === 0 && /connected to/i.test(combined) && !/failed to connect/i.test(combined)) {
+                resolve();
+            }
+            else {
+                reject(new Error("Connect failed. Make sure your Mac and phone are on the same WiFi and Wireless Debugging is on.\n" +
+                    combined.trim()));
+            }
+        });
+    });
+    // Save IP for auto-reconnect
+    try {
+        (0, fs_1.writeFileSync)(ANDROID_IP_FILE, `${ip}:${connectPort}`, "utf8");
+    }
+    catch { }
+    emitStep(onProgress, { ...connect, status: "done" });
+}
+/** Returns the last saved wireless ADB endpoint (e.g. "192.168.1.50:5555"), or null. */
+function getLastAndroidEndpoint() {
+    try {
+        const v = (0, fs_1.readFileSync)(ANDROID_IP_FILE, "utf8").trim();
+        return v || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=pair.js.map

package/dist/setup/pair.js.map

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

package/dist/setup/python.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Returns the path to the first python binary that has pymobiledevice3 installed,
+ * or null if none found. Never throws — use {@link findPythonOrThrow} when an
+ * exception is the right behaviour.
+ */
+export declare function findPython(): string | null;
+export declare function findPythonOrThrow(): string;
+/** Returns the path to a python3 binary (with or without pymobiledevice3), or null. */
+export declare function findAnyPython3(): string | null;
+//# sourceMappingURL=python.d.ts.map

package/dist/setup/python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../setup/python.ts"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAQ1C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAO1C;AAED,uFAAuF;AACvF,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAQ9C"}

package/dist/setup/python.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findPython = findPython;
+exports.findPythonOrThrow = findPythonOrThrow;
+exports.findAnyPython3 = findAnyPython3;
+const child_process_1 = require("child_process");
+// Candidate python binaries to try, in preference order. Newer versions first so
+// users on 3.14+ get picked up automatically when those land.
+const PYTHON_CANDIDATES = [
+    "/opt/homebrew/bin/python3.14",
+    "/usr/local/bin/python3.14",
+    "python3.14",
+    "/opt/homebrew/bin/python3.13",
+    "/usr/local/bin/python3.13",
+    "python3.13",
+    "/opt/homebrew/bin/python3.12",
+    "/usr/local/bin/python3.12",
+    "python3.12",
+    "/opt/homebrew/bin/python3.11",
+    "/usr/local/bin/python3.11",
+    "python3.11",
+    "/opt/homebrew/bin/python3",
+    "/usr/local/bin/python3",
+    "python3",
+];
+/**
+ * Returns the path to the first python binary that has pymobiledevice3 installed,
+ * or null if none found. Never throws — use {@link findPythonOrThrow} when an
+ * exception is the right behaviour.
+ */
+function findPython() {
+    for (const p of PYTHON_CANDIDATES) {
+        try {
+            (0, child_process_1.execFileSync)(p, ["-c", "import pymobiledevice3"], { stdio: "ignore" });
+            return p;
+        }
+        catch { }
+    }
+    return null;
+}
+function findPythonOrThrow() {
+    const p = findPython();
+    if (p)
+        return p;
+    throw new Error("Python with pymobiledevice3 not found. Run the iOS setup wizard or:\n" +
+        "  npx @8bitbish/screenshot-service setup-ios");
+}
+/** Returns the path to a python3 binary (with or without pymobiledevice3), or null. */
+function findAnyPython3() {
+    for (const p of PYTHON_CANDIDATES) {
+        try {
+            (0, child_process_1.execFileSync)(p, ["--version"], { stdio: "ignore" });
+            return p;
+        }
+        catch { }
+    }
+    return null;
+}
+//# sourceMappingURL=python.js.map

package/dist/setup/python.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.js","sourceRoot":"","sources":["../../setup/python.ts"],"names":[],"mappings":";;AA2BA,gCAQC;AAED,8CAOC;AAGD,wCAQC;AAvDD,iDAA6C;AAE7C,iFAAiF;AACjF,8DAA8D;AAC9D,MAAM,iBAAiB,GAAG;IACxB,8BAA8B;IAC9B,2BAA2B;IAC3B,YAAY;IACZ,8BAA8B;IAC9B,2BAA2B;IAC3B,YAAY;IACZ,8BAA8B;IAC9B,2BAA2B;IAC3B,YAAY;IACZ,8BAA8B;IAC9B,2BAA2B;IAC3B,YAAY;IACZ,2BAA2B;IAC3B,wBAAwB;IACxB,SAAS;CACV,CAAC;AAEF;;;;GAIG;AACH,SAAgB,UAAU;IACxB,KAAK,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,IAAA,4BAAY,EAAC,CAAC,EAAE,CAAC,IAAI,EAAE,wBAAwB,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvE,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,iBAAiB;IAC/B,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAChB,MAAM,IAAI,KAAK,CACb,uEAAuE;QACvE,8CAA8C,CAC/C,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,SAAgB,cAAc;IAC5B,KAAK,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,IAAA,4BAAY,EAAC,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/setup/types.d.ts

@@ -0,0 +1,37 @@
+export interface IosSetupStatus {
+    brew: boolean;
+    python: string | null;
+    pymobiledevice3: boolean;
+    sudoers: boolean;
+    deviceVisible: boolean;
+    ok: boolean;
+}
+export interface AndroidSetupStatus {
+    adb: string | null;
+    deviceConnected: boolean;
+    ok: boolean;
+}
+export type SetupStepStatus = "running" | "done" | "skipped" | "error";
+export interface SetupProgress {
+    /** Stable id for the step — e.g. "brew", "python", "pymobiledevice3", "sudoers". */
+    id: string;
+    /** Human-readable label — e.g. "Installing Python 3.13". */
+    label: string;
+    /** Optional sub-detail — e.g. the package name being installed. */
+    detail?: string;
+    /** Raw log line from the underlying subprocess, when available. */
+    log?: string;
+    status: SetupStepStatus;
+    /** Step index / total, for UI progress bars. */
+    index: number;
+    total: number;
+}
+export type SetupProgressCallback = (p: SetupProgress) => void;
+export interface AndroidPairOptions {
+    ip: string;
+    port: string;
+    code: string;
+    /** Optional override for the connect port. Defaults to 5555. */
+    connectPort?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/setup/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../setup/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/setup/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Shared types for the setup/wizard subsystem.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/setup/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../setup/types.ts"],"names":[],"mappings":";AAAA,+CAA+C"}

package/dist/wizard/index.d.ts

@@ -0,0 +1,18 @@
+export interface SetupWindowOptions {
+    /** Which platform's wizard to show. */
+    platform: "ios" | "android";
+    /** Optional parent BrowserWindow — wizard becomes modal to it. */
+    parent?: import("electron").BrowserWindow;
+    /** Override the window title. Default: "Setup". */
+    title?: string;
+}
+/**
+ * Open the setup wizard as a native window. Resolves when the user closes the
+ * window (whether they finished setup or bailed out).
+ *
+ * The window contains an HTML wizard that calls back into the main process
+ * over IPC to drive {@link installIosDeps}, {@link installAndroidDeps}, and
+ * {@link pairAndroidWireless}. The user never sees a terminal.
+ */
+export declare function createSetupWindow(opts: SetupWindowOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/wizard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../wizard/index.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,UAAU,EAAE,aAAa,CAAC;IAC1C,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiF/E"}

package/dist/wizard/index.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSetupWindow = createSetupWindow;
+const path_1 = require("path");
+const setup_1 = require("../setup");
+let cachedElectron = null;
+function loadElectron() {
+    if (cachedElectron)
+        return cachedElectron;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        cachedElectron = require("electron");
+        return cachedElectron;
+    }
+    catch (err) {
+        throw new Error("electron is required to open the setup wizard window. Install it in your host app:\n" +
+            "  npm install electron");
+    }
+}
+/**
+ * Open the setup wizard as a native window. Resolves when the user closes the
+ * window (whether they finished setup or bailed out).
+ *
+ * The window contains an HTML wizard that calls back into the main process
+ * over IPC to drive {@link installIosDeps}, {@link installAndroidDeps}, and
+ * {@link pairAndroidWireless}. The user never sees a terminal.
+ */
+async function createSetupWindow(opts) {
+    const electron = loadElectron();
+    const { BrowserWindow, ipcMain } = electron;
+    const win = new BrowserWindow({
+        width: 640,
+        height: 720,
+        minWidth: 560,
+        minHeight: 560,
+        title: opts.title ?? (opts.platform === "ios" ? "Setup iPhone capture" : "Setup Android capture"),
+        parent: opts.parent,
+        modal: !!opts.parent,
+        resizable: true,
+        minimizable: false,
+        maximizable: false,
+        fullscreenable: false,
+        autoHideMenuBar: true,
+        backgroundColor: "#0e0f12",
+        show: false,
+        webPreferences: {
+            preload: (0, path_1.join)(__dirname, "preload.js"),
+            contextIsolation: true,
+            nodeIntegration: false,
+            sandbox: false,
+        },
+    });
+    win.once("ready-to-show", () => win.show());
+    win.loadFile((0, path_1.join)(__dirname, "renderer", "index.html"), {
+        query: { platform: opts.platform },
+    });
+    // ── IPC handlers (scoped to this window) ────────────────────────────────────
+    // We register handlers per-window to keep them isolated and ensure they are
+    // cleaned up when the window closes.
+    const channels = {
+        checkIos: `wizard:${win.id}:check-ios`,
+        installIos: `wizard:${win.id}:install-ios`,
+        checkAndroid: `wizard:${win.id}:check-android`,
+        installAndroid: `wizard:${win.id}:install-android`,
+        pairAndroid: `wizard:${win.id}:pair-android`,
+        close: `wizard:${win.id}:close`,
+    };
+    // Expose channel names to renderer via initial-load query (read by preload).
+    win.webContents.on("did-finish-load", () => {
+        win.webContents.send("wizard:init", { platform: opts.platform, channels });
+    });
+    ipcMain.handle(channels.checkIos, async () => (0, setup_1.checkIosSetup)());
+    ipcMain.handle(channels.checkAndroid, async () => (0, setup_1.checkAndroidSetup)());
+    ipcMain.handle(channels.installIos, async () => {
+        await (0, setup_1.installIosDeps)((p) => {
+            if (!win.isDestroyed())
+                win.webContents.send(`${channels.installIos}:progress`, p);
+        });
+    });
+    ipcMain.handle(channels.installAndroid, async () => {
+        await (0, setup_1.installAndroidDeps)((p) => {
+            if (!win.isDestroyed())
+                win.webContents.send(`${channels.installAndroid}:progress`, p);
+        });
+    });
+    ipcMain.handle(channels.pairAndroid, async (_e, opts) => {
+        await (0, setup_1.pairAndroidWireless)(opts, (p) => {
+            if (!win.isDestroyed())
+                win.webContents.send(`${channels.pairAndroid}:progress`, p);
+        });
+    });
+    ipcMain.handle(channels.close, async () => {
+        if (!win.isDestroyed())
+            win.close();
+    });
+    // Resolve when the window closes
+    return new Promise((resolve) => {
+        win.on("closed", () => {
+            for (const ch of Object.values(channels)) {
+                try {
+                    ipcMain.removeHandler(ch);
+                }
+                catch { }
+            }
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/wizard/index.js.map

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

package/dist/wizard/preload.js

@@ -0,0 +1,53 @@
+'use strict';
+
+// Preload script for the wizard BrowserWindow. Bridges renderer-side JS to the
+// main process's setup IPC handlers without exposing Node APIs.
+//
+// Plain JavaScript (rather than TypeScript) so the package can build without
+// electron's type definitions installed — electron is an optional peer dep.
+
+const { contextBridge, ipcRenderer } = require('electron');
+
+let initPayload = null;
+const initListeners = [];
+
+ipcRenderer.on('wizard:init', (_e, payload) => {
+  initPayload = payload;
+  while (initListeners.length) initListeners.shift()(payload);
+});
+
+function waitForInit() {
+  if (initPayload) return Promise.resolve(initPayload);
+  return new Promise((resolve) => initListeners.push(resolve));
+}
+
+async function invoke(channelKey, ...args) {
+  const { channels } = await waitForInit();
+  const channel = channels[channelKey];
+  if (!channel) throw new Error(`Unknown wizard channel: ${channelKey}`);
+  return ipcRenderer.invoke(channel, ...args);
+}
+
+function onProgress(channelKey, cb) {
+  let cleanup = () => {};
+  waitForInit().then(({ channels }) => {
+    const channel = channels[channelKey] + ':progress';
+    const handler = (_e, p) => cb(p);
+    ipcRenderer.on(channel, handler);
+    cleanup = () => ipcRenderer.removeListener(channel, handler);
+  });
+  return () => cleanup();
+}
+
+contextBridge.exposeInMainWorld('wizard', {
+  init: waitForInit,
+  checkIos:        () => invoke('checkIos'),
+  installIos:      () => invoke('installIos'),
+  onInstallIosProgress:     (cb) => onProgress('installIos', cb),
+  checkAndroid:    () => invoke('checkAndroid'),
+  installAndroid:  () => invoke('installAndroid'),
+  onInstallAndroidProgress: (cb) => onProgress('installAndroid', cb),
+  pairAndroid:     (opts) => invoke('pairAndroid', opts),
+  onPairAndroidProgress:    (cb) => onProgress('pairAndroid', cb),
+  close:           () => invoke('close'),
+});