diggylab 0.1.35 → 0.1.36

package/README.md

@@ -7,8 +7,8 @@ headless Chromium — the Electron app is not involved.
 ## Requirements
 
 - Node.js 20+
-- Linux packages: `xvfb`, `x11vnc`, `websockify`, `novnc` (Debian/Ubuntu: `apt install xvfb x11vnc websockify novnc`). The Docker image below bundles them.
-- Chromium for Playwright: run `diggylab install-browser` once after installing the CLI.
+- Linux packages: `xvfb`, `x11vnc`, `websockify`, `novnc` — run `diggylab install-display` (Debian/Ubuntu) or install them yourself. The Docker image below bundles them.
+- Chromium for Playwright: downloaded automatically during `npm install`; rerun `diggylab install-browser` if that download failed.
 
 ## Install
 
@@ -61,7 +61,8 @@ npm publish apps/desktop-agent/dist-npm --access public
 | `login` | Opens the Facebook login page on a virtual screen and prints a noVNC link + QR code. Log in from your phone; the session is stored encrypted on the server. |
 | `run` | Connects the WebSocket worker, receives assigned scans, scans headlessly, uploads results. |
 | `status` | Shows the config directory, API origin, paired device, and Facebook session state. |
-| `install-browser` | Downloads the Chromium build Playwright needs (one time, ~150 MB). Run it once after installing the CLI. |
+| `install-browser` | Downloads the Chromium build Playwright needs (~150 MB). It also runs during `npm install`, so you only need it if that download failed. |
+| `install-display` | On Debian/Ubuntu, installs `xvfb`, `x11vnc`, `websockify`, and `novnc` for the shared login screen. |
 | `unpair` | Removes device credentials, the Facebook session, and pending scans. |
 
 Useful options: `--api <origin>` (default `https://api.diggylab.com`), `--port` / `--bind` /

package/cli.js

@@ -2351,6 +2351,12 @@ function parseCliArgs(argv) {
   return { command, options };
 }
 
+// src/cli/browser-install.ts
+function browserInstallCommands(platform) {
+  const install = ["install", "chromium"];
+  return platform === "linux" ? [["install", "--with-deps", "chromium"], install] : [install];
+}
+
 // src/cli/file-crypto.ts
 import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto";
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
@@ -2540,13 +2546,14 @@ Usage:
   diggylab run
   diggylab status
   diggylab install-browser
+  diggylab install-display
   diggylab unpair
 
 Global options:
   --config <directory>   Agent state directory (default ~/.diggylab)
   --api <origin>         API origin (default $DIGGYLAB_API_URL or https://api.diggylab.com)`;
 var MISSING_BROWSER_HINT = "Chromium for Playwright is not installed yet. Run `diggylab install-browser` once.";
-var MISSING_DISPLAY_HINT = "The shared login screen needs Xvfb, x11vnc, websockify, and noVNC. Install them (apt install xvfb x11vnc websockify novnc) or use the Docker image.";
+var MISSING_DISPLAY_HINT = "The shared login screen needs Xvfb, x11vnc, websockify, and noVNC. Run `diggylab install-display` (Debian/Ubuntu) or use the Docker image.";
 function agentVersion() {
   let directory = fileURLToPath(new URL(".", import.meta.url));
   for (let depth = 0; depth < 4; depth += 1) {
@@ -2721,10 +2728,11 @@ function playwrightCliPath() {
   }
 }
 async function commandInstallBrowser(io) {
+  const soft = process.env.npm_lifecycle_event === "postinstall";
   const cli = playwrightCliPath();
   if (!cli) {
     io.error("Could not locate the bundled Playwright. Reinstall with `npm install -g diggylab@latest`.");
-    return 1;
+    return soft ? 0 : 1;
   }
   io.log("Downloading Chromium for Playwright...");
   const run = (args) => new Promise((resolve, reject) => {
@@ -2732,16 +2740,42 @@ async function commandInstallBrowser(io) {
     child.once("error", reject);
     child.once("exit", (value) => resolve(value ?? 1));
   });
-  let code = process.platform === "linux" ? await run(["install", "--with-deps", "chromium"]) : 0;
+  let code = 1;
+  for (const [index, args] of browserInstallCommands(process.platform).entries()) {
+    if (index > 0) io.log("Installing the system libraries failed; downloading the browser only...");
+    code = await run(args);
+    if (code === 0) break;
+  }
   if (code !== 0) {
-    io.log("Installing the system libraries failed; downloading the browser only...");
-    code = await run(["install", "chromium"]);
+    io.error(soft ? "Chromium download failed. Run `diggylab install-browser` later." : "Chromium download failed. Check the network and try again.");
+    return soft ? 0 : code;
+  }
+  io.log("Chromium installed.");
+  return 0;
+}
+async function commandInstallDisplay(io) {
+  if (process.platform !== "linux") {
+    io.log("The shared login screen is only needed on a Linux server; desktops open a browser window.");
+    return 0;
+  }
+  if (!existsSync2("/usr/bin/apt-get")) {
+    io.error("Automatic installation supports Debian/Ubuntu. Install xvfb, x11vnc, websockify, and noVNC with your package manager.");
+    return 1;
   }
+  const sudo = typeof process.getuid === "function" && process.getuid() !== 0 ? ["sudo"] : [];
+  const run = (args) => new Promise((resolve, reject) => {
+    const child = spawn2(args[0], args.slice(1), { stdio: "inherit" });
+    child.once("error", reject);
+    child.once("exit", (value) => resolve(value ?? 1));
+  });
+  io.log("Installing xvfb, x11vnc, websockify, and noVNC...");
+  await run([...sudo, "apt-get", "update"]).catch(() => 1);
+  const code = await run([...sudo, "apt-get", "install", "-y", "xvfb", "x11vnc", "websockify", "novnc"]);
   if (code !== 0) {
-    io.error("Chromium download failed. Check the network and try again.");
+    io.error("Installation failed. Run the same command with apt manually.");
     return code;
   }
-  io.log("Chromium installed.");
+  io.log("Login screen packages installed.");
   return 0;
 }
 async function commandRun(runtime, io) {
@@ -2866,12 +2900,13 @@ async function main(argv, io = console) {
     io.log(USAGE);
     return 0;
   }
-  if (!["install-browser", "login", "pair", "run", "status", "unpair"].includes(command)) {
+  if (!["install-browser", "install-display", "login", "pair", "run", "status", "unpair"].includes(command)) {
     io.error(`Unknown command "${command}".`);
     io.error(USAGE);
     return 2;
   }
   if (command === "install-browser") return commandInstallBrowser(io);
+  if (command === "install-display") return commandInstallDisplay(io);
   const runtime = createRuntime(parsed.options);
   switch (command) {
     case "pair":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diggylab",
-  "version": "0.1.35",
+  "version": "0.1.36",
   "description": "DiggyLab Desktop Agent collects posts and information from Facebook Groups on a paired computer. (headless CLI)",
   "type": "module",
   "bin": {
@@ -18,6 +18,9 @@
     "qrcode-terminal": "^0.12.0",
     "ws": "^8.21.3"
   },
+  "scripts": {
+    "postinstall": "node cli.js install-browser"
+  },
   "license": "UNLICENSED",
   "publishConfig": {
     "access": "public"