@presto1314w/vite-devtools-browser 0.1.2 → 0.1.4

package/dist/cli.js

@@ -1,131 +1,176 @@
 #!/usr/bin/env node
 import { readFileSync } from "node:fs";
 import { send } from "./client.js";
-const args = process.argv.slice(2);
-const cmd = args[0];
-const arg = args[1];
-if (cmd === "--help" || cmd === "-h" || !cmd) {
-    printUsage();
-    process.exit(0);
-}
-if (cmd === "open") {
-    if (!arg) {
-        console.error("usage: vite-browser open <url> [--cookies-json <file>]");
-        process.exit(1);
-    }
-    const url = normalizeUrl(arg);
-    const cookieIdx = args.indexOf("--cookies-json");
-    const cookieFile = cookieIdx >= 0 ? args[cookieIdx + 1] : undefined;
-    if (cookieFile) {
-        const res = await send("open");
-        if (!res.ok)
-            exit(res, "");
-        const raw = readFileSync(cookieFile, "utf-8");
-        const cookies = JSON.parse(raw);
-        const domain = new URL(url).hostname;
-        const cRes = await send("cookies", { cookies, domain });
-        if (!cRes.ok)
-            exit(cRes, "");
-        await send("goto", { url });
-        exit(res, `opened -> ${url} (${cookies.length} cookies for ${domain})`);
-    }
-    const res = await send("open", { url });
-    exit(res, `opened -> ${url}`);
-}
-if (cmd === "close") {
-    const res = await send("close");
-    exit(res, "closed");
+export function normalizeUrl(value) {
+    if (value.includes("://"))
+        return value;
+    return `http://${value}`;
 }
-if (cmd === "goto") {
-    if (!arg) {
-        console.error("usage: vite-browser goto <url>");
-        process.exit(1);
+export function parseNumberFlag(args, name, fallback) {
+    const idx = args.indexOf(name);
+    if (idx < 0)
+        return fallback;
+    return Number.parseInt(args[idx + 1] ?? String(fallback), 10);
+}
+export async function runCli(argv, io) {
+    const args = argv.slice(2);
+    const cmd = args[0];
+    const arg = args[1];
+    if (cmd === "--help" || cmd === "-h" || !cmd) {
+        io.stdout(printUsage());
+        io.exit(0);
     }
-    const res = await send("goto", { url: normalizeUrl(arg) });
-    exit(res, res.ok ? `-> ${res.data}` : "");
-}
-if (cmd === "back") {
-    const res = await send("back");
-    exit(res, "back");
-}
-if (cmd === "reload") {
-    const res = await send("reload");
-    exit(res, res.ok ? `reloaded -> ${res.data}` : "");
-}
-if (cmd === "detect") {
-    const res = await send("detect");
-    exit(res, res.ok && res.data ? String(res.data) : "");
-}
-if (cmd === "vue" && arg === "tree") {
-    const id = args[2];
-    const res = await send("vue-tree", { id });
-    exit(res, res.ok && res.data ? String(res.data) : "");
-}
-if (cmd === "vue" && arg === "pinia") {
-    const store = args[2];
-    const res = await send("vue-pinia", { store });
-    exit(res, res.ok && res.data ? String(res.data) : "");
-}
-if (cmd === "vue" && arg === "router") {
-    const res = await send("vue-router");
-    exit(res, res.ok && res.data ? String(res.data) : "");
-}
-if (cmd === "react" && arg === "tree") {
-    const id = args[2];
-    const res = await send("react-tree", { id });
-    exit(res, res.ok && res.data ? String(res.data) : "");
-}
-if (cmd === "svelte" && arg === "tree") {
-    const id = args[2];
-    const res = await send("svelte-tree", { id });
-    exit(res, res.ok && res.data ? String(res.data) : "");
-}
-if (cmd === "vite" && arg === "restart") {
-    const res = await send("vite-restart");
-    exit(res, res.ok && res.data ? String(res.data) : "restarted");
-}
-if (cmd === "vite" && arg === "hmr") {
-    const res = await send("vite-hmr");
-    exit(res, res.ok && res.data ? String(res.data) : "");
-}
-if (cmd === "errors") {
-    const res = await send("errors");
-    exit(res, res.ok && res.data ? String(res.data) : "no errors");
-}
-if (cmd === "logs") {
-    const res = await send("logs");
-    exit(res, res.ok && res.data ? String(res.data) : "");
-}
-if (cmd === "screenshot") {
-    const res = await send("screenshot");
-    exit(res, res.ok && res.data ? String(res.data) : "");
-}
-if (cmd === "eval") {
-    if (!arg) {
-        console.error("usage: vite-browser eval <script>");
-        process.exit(1);
+    if (cmd === "open") {
+        if (!arg) {
+            io.stderr("usage: vite-browser open <url> [--cookies-json <file>]");
+            io.exit(1);
+        }
+        const url = normalizeUrl(arg);
+        const cookieIdx = args.indexOf("--cookies-json");
+        const cookieFile = cookieIdx >= 0 ? args[cookieIdx + 1] : undefined;
+        if (cookieFile) {
+            const res = await io.send("open");
+            if (!res.ok)
+                exit(io, res, "");
+            const raw = io.readFile(cookieFile, "utf-8");
+            const cookies = JSON.parse(raw);
+            const domain = new URL(url).hostname;
+            const cRes = await io.send("cookies", { cookies, domain });
+            if (!cRes.ok)
+                exit(io, cRes, "");
+            await io.send("goto", { url });
+            exit(io, res, `opened -> ${url} (${cookies.length} cookies for ${domain})`);
+        }
+        const res = await io.send("open", { url });
+        exit(io, res, `opened -> ${url}`);
     }
-    const res = await send("eval", { script: arg });
-    exit(res, res.ok && res.data ? String(res.data) : "");
-}
-if (cmd === "network") {
-    const idx = arg ? parseInt(arg, 10) : undefined;
-    const res = await send("network", { idx });
-    exit(res, res.ok && res.data ? String(res.data) : "");
+    if (cmd === "close") {
+        const res = await io.send("close");
+        exit(io, res, "closed");
+    }
+    if (cmd === "goto") {
+        if (!arg) {
+            io.stderr("usage: vite-browser goto <url>");
+            io.exit(1);
+        }
+        const res = await io.send("goto", { url: normalizeUrl(arg) });
+        exit(io, res, res.ok ? `-> ${res.data}` : "");
+    }
+    if (cmd === "back") {
+        const res = await io.send("back");
+        exit(io, res, "back");
+    }
+    if (cmd === "reload") {
+        const res = await io.send("reload");
+        exit(io, res, res.ok ? `reloaded -> ${res.data}` : "");
+    }
+    if (cmd === "detect") {
+        const res = await io.send("detect");
+        exit(io, res, res.ok && res.data ? String(res.data) : "");
+    }
+    if (cmd === "vue" && arg === "tree") {
+        const id = args[2];
+        const res = await io.send("vue-tree", { id });
+        exit(io, res, res.ok && res.data ? String(res.data) : "");
+    }
+    if (cmd === "vue" && arg === "pinia") {
+        const store = args[2];
+        const res = await io.send("vue-pinia", { store });
+        exit(io, res, res.ok && res.data ? String(res.data) : "");
+    }
+    if (cmd === "vue" && arg === "router") {
+        const res = await io.send("vue-router");
+        exit(io, res, res.ok && res.data ? String(res.data) : "");
+    }
+    if (cmd === "react" && arg === "tree") {
+        const id = args[2];
+        const res = await io.send("react-tree", { id });
+        exit(io, res, res.ok && res.data ? String(res.data) : "");
+    }
+    if (cmd === "svelte" && arg === "tree") {
+        const id = args[2];
+        const res = await io.send("svelte-tree", { id });
+        exit(io, res, res.ok && res.data ? String(res.data) : "");
+    }
+    if (cmd === "vite" && arg === "restart") {
+        const res = await io.send("vite-restart");
+        exit(io, res, res.ok && res.data ? String(res.data) : "restarted");
+    }
+    if (cmd === "vite" && arg === "hmr") {
+        const sub = args[2];
+        if (sub === "clear") {
+            const res = await io.send("vite-hmr", { mode: "clear" });
+            exit(io, res, res.ok && res.data ? String(res.data) : "cleared HMR trace");
+        }
+        if (sub === "trace") {
+            const limit = parseNumberFlag(args, "--limit", 20);
+            const res = await io.send("vite-hmr", { mode: "trace", limit });
+            exit(io, res, res.ok && res.data ? String(res.data) : "");
+        }
+        const res = await io.send("vite-hmr", { mode: "summary", limit: 20 });
+        exit(io, res, res.ok && res.data ? String(res.data) : "");
+    }
+    if (cmd === "vite" && arg === "runtime") {
+        const res = await io.send("vite-runtime");
+        exit(io, res, res.ok && res.data ? String(res.data) : "");
+    }
+    if (cmd === "vite" && arg === "module-graph") {
+        const sub = args[2];
+        const filterIdx = args.indexOf("--filter");
+        const filter = filterIdx >= 0 ? args[filterIdx + 1] : undefined;
+        const limit = parseNumberFlag(args, "--limit", 200);
+        if (sub === "clear") {
+            const res = await io.send("vite-module-graph", { mode: "clear" });
+            exit(io, res, res.ok && res.data ? String(res.data) : "cleared module-graph baseline");
+        }
+        if (sub === "trace") {
+            const res = await io.send("vite-module-graph", { mode: "trace", filter, limit });
+            exit(io, res, res.ok && res.data ? String(res.data) : "");
+        }
+        const res = await io.send("vite-module-graph", { mode: "snapshot", filter, limit });
+        exit(io, res, res.ok && res.data ? String(res.data) : "");
+    }
+    if (cmd === "errors") {
+        const mapped = args.includes("--mapped");
+        const inlineSource = args.includes("--inline-source");
+        const res = await io.send("errors", { mapped, inlineSource });
+        exit(io, res, res.ok && res.data ? String(res.data) : "no errors");
+    }
+    if (cmd === "logs") {
+        const res = await io.send("logs");
+        exit(io, res, res.ok && res.data ? String(res.data) : "");
+    }
+    if (cmd === "screenshot") {
+        const res = await io.send("screenshot");
+        exit(io, res, res.ok && res.data ? String(res.data) : "");
+    }
+    if (cmd === "eval") {
+        if (!arg) {
+            io.stderr("usage: vite-browser eval <script>");
+            io.exit(1);
+        }
+        const res = await io.send("eval", { script: arg });
+        exit(io, res, res.ok && res.data ? String(res.data) : "");
+    }
+    if (cmd === "network") {
+        const idx = arg ? parseInt(arg, 10) : undefined;
+        const res = await io.send("network", { idx });
+        exit(io, res, res.ok && res.data ? String(res.data) : "");
+    }
+    io.stderr(`unknown command: ${cmd}`);
+    io.exit(1);
 }
-console.error(`unknown command: ${cmd}`);
-process.exit(1);
-function exit(res, msg) {
+export function exit(io, res, msg) {
     if (!res.ok) {
-        console.error(res.error || "error");
-        process.exit(1);
+        io.stderr(res.error || "error");
+        io.exit(1);
     }
     if (msg)
-        console.log(msg);
-    process.exit(0);
+        io.stdout(msg);
+    io.exit(0);
 }
-function printUsage() {
-    console.log(`
+export function printUsage() {
+    return `
 vite-browser - Programmatic access to Vue/React/Svelte DevTools and Vite dev server
 
 USAGE
@@ -154,8 +199,18 @@ SVELTE COMMANDS
 
 VITE COMMANDS
   vite restart                        Restart Vite dev server
-  vite hmr                            Show HMR status
+  vite hmr                            Show HMR summary
+  vite hmr trace [--limit <n>]        Show HMR timeline
+  vite hmr clear                      Clear tracked HMR timeline
+  vite runtime                        Show Vite runtime status
+  vite module-graph [--filter <txt>] [--limit <n>]
+                                     Show loaded Vite module resources
+  vite module-graph trace [--filter <txt>] [--limit <n>]
+                                     Show module additions/removals since baseline
+  vite module-graph clear             Clear module-graph baseline
   errors                              Show build/runtime errors
+  errors --mapped                     Show errors with source-map mapping
+  errors --mapped --inline-source     Include mapped source snippets
   logs                                Show dev server logs
 
 UTILITIES
@@ -165,10 +220,14 @@ UTILITIES
 
 OPTIONS
   -h, --help                          Show this help message
-`);
-}
-function normalizeUrl(value) {
-    if (value.includes("://"))
-        return value;
-    return `http://${value}`;
+`;
+}
+if (process.argv[1] && import.meta.url.endsWith(process.argv[1].replaceAll("\\", "/"))) {
+    await runCli(process.argv, {
+        send,
+        readFile: readFileSync,
+        stdout: (text) => console.log(text),
+        stderr: (text) => console.error(text),
+        exit: (code) => process.exit(code),
+    });
 }

package/dist/client.d.ts

@@ -1,3 +1,7 @@
+import { type Socket } from "node:net";
+import { readFileSync, existsSync, rmSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { setTimeout as sleep } from "node:timers/promises";
 export type Response = {
     ok: true;
     data?: unknown;
@@ -5,4 +9,24 @@ export type Response = {
     ok: false;
     error: string;
 };
+export type ClientDeps = {
+    socketPath: string;
+    pidFile: string;
+    existsSync: typeof existsSync;
+    readFileSync: typeof readFileSync;
+    rmSync: typeof rmSync;
+    processKill: typeof process.kill;
+    spawn: typeof spawn;
+    connect: () => Promise<Socket>;
+    sleep: typeof sleep;
+    daemonPath: string;
+};
+export declare function createClientDeps(): ClientDeps;
 export declare function send(action: string, payload?: Record<string, unknown>): Promise<Response>;
+export declare function ensureDaemon(deps: ClientDeps): Promise<void>;
+export declare function daemonAlive(deps: Pick<ClientDeps, "existsSync" | "pidFile" | "readFileSync" | "processKill" | "rmSync" | "socketPath">): boolean;
+export declare function connect(): Promise<Socket>;
+export declare function readLine(socket: Pick<Socket, "on">): Promise<string>;
+export declare function ok(s: Pick<Socket, "destroy">): boolean;
+export declare function no(): boolean;
+export declare function removeSocketFile(path: string, removeFile?: typeof rmSync): void;

package/dist/client.js

@@ -4,54 +4,69 @@ import { spawn } from "node:child_process";
 import { setTimeout as sleep } from "node:timers/promises";
 import { fileURLToPath } from "node:url";
 import { socketPath, pidFile } from "./paths.js";
+export function createClientDeps() {
+    const ext = import.meta.url.endsWith(".ts") ? ".ts" : ".js";
+    const daemonPath = fileURLToPath(new URL(`./daemon${ext}`, import.meta.url));
+    return {
+        socketPath,
+        pidFile,
+        existsSync,
+        readFileSync,
+        rmSync,
+        processKill: process.kill.bind(process),
+        spawn,
+        connect,
+        sleep,
+        daemonPath,
+    };
+}
 export async function send(action, payload = {}) {
-    await ensureDaemon();
-    const socket = await connect();
+    const deps = createClientDeps();
+    await ensureDaemon(deps);
+    const socket = await deps.connect();
     const id = String(Date.now());
     socket.write(JSON.stringify({ id, action, ...payload }) + "\n");
     const line = await readLine(socket);
     socket.end();
     return JSON.parse(line);
 }
-async function ensureDaemon() {
-    if (daemonAlive() && (await connect().then(ok, no)))
+export async function ensureDaemon(deps) {
+    if (daemonAlive(deps) && (await deps.connect().then(ok, no)))
         return;
-    const ext = import.meta.url.endsWith(".ts") ? ".ts" : ".js";
-    const daemon = fileURLToPath(new URL(`./daemon${ext}`, import.meta.url));
-    const child = spawn(process.execPath, [daemon], {
+    const child = deps.spawn(process.execPath, [deps.daemonPath], {
         detached: true,
         stdio: "ignore",
     });
     child.unref();
     for (let i = 0; i < 50; i++) {
-        if (await connect().then(ok, no))
+        if (await deps.connect().then(ok, no))
             return;
-        await sleep(100);
+        await deps.sleep(100);
     }
-    throw new Error(`daemon failed to start (${socketPath})`);
+    throw new Error(`daemon failed to start (${deps.socketPath})`);
 }
-function daemonAlive() {
-    if (!existsSync(pidFile))
+export function daemonAlive(deps) {
+    if (!deps.existsSync(deps.pidFile))
         return false;
-    const pid = Number(readFileSync(pidFile, "utf-8"));
+    const pid = Number(deps.readFileSync(deps.pidFile, "utf-8"));
     try {
-        process.kill(pid, 0);
+        deps.processKill(pid, 0);
         return true;
     }
     catch {
-        rmSync(pidFile, { force: true });
-        removeSocketFile();
+        deps.rmSync(deps.pidFile, { force: true });
+        removeSocketFile(deps.socketPath, deps.rmSync);
         return false;
     }
 }
-function connect() {
+export function connect() {
     return new Promise((resolve, reject) => {
         const socket = netConnect(socketPath);
         socket.once("connect", () => resolve(socket));
         socket.once("error", reject);
     });
 }
-function readLine(socket) {
+export function readLine(socket) {
     return new Promise((resolve, reject) => {
         let buffer = "";
         socket.on("data", (chunk) => {
@@ -63,15 +78,15 @@ function readLine(socket) {
         socket.on("error", reject);
     });
 }
-function ok(s) {
+export function ok(s) {
     s.destroy();
     return true;
 }
-function no() {
+export function no() {
     return false;
 }
-function removeSocketFile() {
+export function removeSocketFile(path, removeFile = rmSync) {
     if (process.platform === "win32")
         return;
-    rmSync(socketPath, { force: true });
+    removeFile(path, { force: true });
 }

package/dist/daemon.d.ts

@@ -1 +1,57 @@
-export {};
+import type { Socket } from "node:net";
+import * as browser from "./browser.js";
+export type BrowserApi = typeof browser;
+export type Cmd = {
+    action: string;
+    url?: string;
+    id?: string;
+    script?: string;
+    idx?: number;
+    mode?: "summary" | "trace" | "clear" | "snapshot";
+    limit?: number;
+    filter?: string;
+    mapped?: boolean;
+    inlineSource?: boolean;
+    cookies?: {
+        name: string;
+        value: string;
+    }[];
+    domain?: string;
+    store?: string;
+};
+export declare function cleanError(err: unknown): string;
+export declare function createRunner(api?: BrowserApi): (cmd: Cmd) => Promise<{
+    ok: boolean;
+    data?: undefined;
+    error?: undefined;
+} | {
+    ok: boolean;
+    data: number;
+    error?: undefined;
+} | {
+    ok: boolean;
+    data: string;
+    error?: undefined;
+} | {
+    ok: boolean;
+    error: string;
+    data?: undefined;
+}>;
+export declare function dispatchLine(line: string, socket: Pick<Socket, "write">, run?: (cmd: Cmd) => Promise<{
+    ok: boolean;
+    data?: undefined;
+    error?: undefined;
+} | {
+    ok: boolean;
+    data: number;
+    error?: undefined;
+} | {
+    ok: boolean;
+    data: string;
+    error?: undefined;
+} | {
+    ok: boolean;
+    error: string;
+    data?: undefined;
+}>, onClose?: () => void): Promise<void>;
+export declare function startDaemon(): void;