@vercel/next-browser 0.1.7 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/next-browser",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "description": "Headed Playwright browser with React DevTools pre-loaded",
   "license": "MIT",
   "repository": {
@@ -21,20 +21,23 @@
   "bin": {
     "next-browser": "./dist/cli.js"
   },
-  "scripts": {
-    "start": "node src/cli.ts",
-    "typecheck": "tsc",
-    "build": "tsc -p tsconfig.build.json",
-    "prepack": "pnpm build"
-  },
   "dependencies": {
     "@next/playwright": "16.2.0-canary.80",
     "playwright": "^1.50.0",
     "source-map-js": "^1.2.1"
   },
-  "packageManager": "pnpm@10.29.2",
   "devDependencies": {
+    "@changesets/changelog-github": "^0.6.0",
+    "@changesets/cli": "^2.30.0",
     "@types/node": "^22.0.0",
     "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "start": "node src/cli.ts",
+    "typecheck": "tsc",
+    "build": "tsc -p tsconfig.build.json",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "pnpm build && changeset publish"
   }
-}
+}

package/dist/cloud-client.js

@@ -1,72 +0,0 @@
-import { connect as netConnect } from "node:net";
-import { readFileSync, existsSync, rmSync } from "node:fs";
-import { spawn } from "node:child_process";
-import { setTimeout as sleep } from "node:timers/promises";
-import { fileURLToPath } from "node:url";
-import { cloudSocketPath, cloudPidFile } from "./cloud-paths.js";
-export async function cloudSend(action, payload = {}) {
-    await ensureCloudDaemon();
-    const socket = await 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 ensureCloudDaemon() {
-    if (daemonAlive() && (await connect().then(ok, no)))
-        return;
-    const ext = import.meta.url.endsWith(".ts") ? ".ts" : ".js";
-    const daemon = fileURLToPath(new URL(`./cloud-daemon${ext}`, import.meta.url));
-    const child = spawn(process.execPath, [daemon], {
-        detached: true,
-        stdio: "ignore",
-    });
-    child.unref();
-    for (let i = 0; i < 50; i++) {
-        if (await connect().then(ok, no))
-            return;
-        await sleep(100);
-    }
-    throw new Error(`cloud daemon failed to start (${cloudSocketPath})`);
-}
-function daemonAlive() {
-    if (!existsSync(cloudPidFile))
-        return false;
-    const pid = Number(readFileSync(cloudPidFile, "utf-8"));
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        rmSync(cloudPidFile, { force: true });
-        rmSync(cloudSocketPath, { force: true });
-        return false;
-    }
-}
-function connect() {
-    return new Promise((resolve, reject) => {
-        const socket = netConnect(cloudSocketPath);
-        socket.once("connect", () => resolve(socket));
-        socket.once("error", reject);
-    });
-}
-function readLine(socket) {
-    return new Promise((resolve, reject) => {
-        let buffer = "";
-        socket.on("data", (chunk) => {
-            buffer += chunk;
-            const newline = buffer.indexOf("\n");
-            if (newline >= 0)
-                resolve(buffer.slice(0, newline));
-        });
-        socket.on("error", reject);
-    });
-}
-function ok(s) {
-    s.destroy();
-    return true;
-}
-function no() {
-    return false;
-}

package/dist/cloud-daemon.js

@@ -1,87 +0,0 @@
-import { createServer } from "node:net";
-import { mkdirSync, writeFileSync, rmSync } from "node:fs";
-import * as cloud from "./cloud.js";
-import { cloudSocketDir, cloudSocketPath, cloudPidFile } from "./cloud-paths.js";
-mkdirSync(cloudSocketDir, { recursive: true, mode: 0o700 });
-rmSync(cloudSocketPath, { force: true });
-rmSync(cloudPidFile, { force: true });
-writeFileSync(cloudPidFile, String(process.pid));
-const server = createServer((socket) => {
-    let buffer = "";
-    socket.on("data", (chunk) => {
-        buffer += chunk;
-        let newline;
-        while ((newline = buffer.indexOf("\n")) >= 0) {
-            const line = buffer.slice(0, newline);
-            buffer = buffer.slice(newline + 1);
-            if (line)
-                dispatch(line, socket);
-        }
-    });
-    socket.on("error", () => { });
-});
-server.listen(cloudSocketPath);
-process.on("SIGINT", shutdown);
-process.on("SIGTERM", shutdown);
-process.on("exit", cleanup);
-async function dispatch(line, socket) {
-    const cmd = JSON.parse(line);
-    const result = await run(cmd).catch((err) => ({
-        ok: false,
-        error: err.message,
-    }));
-    socket.write(JSON.stringify({ id: cmd.id, ...result }) + "\n");
-    if (cmd.action === "destroy")
-        setImmediate(shutdown);
-}
-async function run(cmd) {
-    if (cmd.action === "create") {
-        const data = await cloud.create();
-        return { ok: true, data };
-    }
-    if (cmd.action === "exec") {
-        if (!cmd.command)
-            return { ok: false, error: "missing command" };
-        const result = await cloud.exec(cmd.command);
-        const output = [
-            result.stdout,
-            result.stderr ? `stderr:\n${result.stderr}` : "",
-            result.exitCode !== 0 ? `exit code: ${result.exitCode}` : "",
-        ]
-            .filter(Boolean)
-            .join("\n");
-        if (result.exitCode === 0)
-            return { ok: true, data: output };
-        return { ok: false, error: output || `exit code: ${result.exitCode}` };
-    }
-    if (cmd.action === "status") {
-        const data = await cloud.status();
-        return { ok: true, data };
-    }
-    if (cmd.action === "upload") {
-        if (!cmd.localPath || !cmd.remotePath)
-            return { ok: false, error: "missing localPath or remotePath" };
-        const data = await cloud.upload(cmd.localPath, cmd.remotePath);
-        return { ok: true, data };
-    }
-    if (cmd.action === "destroy") {
-        const data = await cloud.destroy();
-        return { ok: true, data };
-    }
-    return { ok: false, error: `unknown action: ${cmd.action}` };
-}
-async function shutdown() {
-    try {
-        await cloud.destroy();
-    }
-    catch {
-        // best effort
-    }
-    server.close();
-    cleanup();
-    process.exit(0);
-}
-function cleanup() {
-    rmSync(cloudSocketPath, { force: true });
-    rmSync(cloudPidFile, { force: true });
-}

package/dist/cloud-paths.js

@@ -1,7 +0,0 @@
-import { homedir } from "node:os";
-import { join } from "node:path";
-const dir = join(homedir(), ".next-browser");
-export const cloudSocketDir = dir;
-export const cloudSocketPath = join(dir, "cloud.sock");
-export const cloudPidFile = join(dir, "cloud.pid");
-export const cloudStateFile = join(dir, "cloud.json");

package/dist/cloud.js

@@ -1,230 +0,0 @@
-/**
- * Cloud sandbox lifecycle and operations.
- * Wraps @vercel/sandbox SDK for creating/managing remote sandboxes.
- */
-import { readFileSync, writeFileSync, existsSync, rmSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { cloudStateFile } from "./cloud-paths.js";
-const __dirname = dirname(fileURLToPath(import.meta.url));
-async function getSandboxSDK() {
-    try {
-        return await import("@vercel/sandbox");
-    }
-    catch {
-        throw new Error("@vercel/sandbox is not installed. Run: pnpm add @vercel/sandbox");
-    }
-}
-function saveState(state) {
-    writeFileSync(cloudStateFile, JSON.stringify(state, null, 2));
-}
-function loadState() {
-    if (!existsSync(cloudStateFile))
-        return null;
-    try {
-        return JSON.parse(readFileSync(cloudStateFile, "utf-8"));
-    }
-    catch {
-        return null;
-    }
-}
-function clearState() {
-    rmSync(cloudStateFile, { force: true });
-}
-let sandbox = null;
-/** System dependencies required for headless Chromium on Amazon Linux 2023. */
-const CHROME_SYSTEM_DEPS = [
-    "nspr", "nss", "atk", "at-spi2-atk", "cups-libs", "libdrm",
-    "libxkbcommon", "libXcomposite", "libXdamage", "libXfixes",
-    "libXrandr", "mesa-libgbm", "alsa-lib", "cairo", "pango",
-    "glib2", "gtk3", "libX11", "libXext", "libXcursor", "libXi", "libXtst",
-];
-async function runInSandbox(cmd) {
-    if (!sandbox)
-        throw new Error("no sandbox");
-    const result = await sandbox.runCommand({
-        cmd: "bash",
-        args: ["-lc", cmd],
-    });
-    let stdout = "";
-    let stderr = "";
-    for await (const log of result.logs()) {
-        if (log.stream === "stdout")
-            stdout += log.data;
-        else
-            stderr += log.data;
-    }
-    await result.wait();
-    return { exitCode: result.exitCode, stdout, stderr };
-}
-export async function create() {
-    if (sandbox) {
-        return `sandbox already running: ${sandbox.sandboxId}`;
-    }
-    loadEnv();
-    const existing = loadState();
-    if (existing) {
-        try {
-            const { Sandbox } = await getSandboxSDK();
-            sandbox = await Sandbox.get({ sandboxId: existing.sandboxId });
-            if (sandbox.status === "running") {
-                return `reconnected to ${sandbox.sandboxId}`;
-            }
-        }
-        catch {
-            // stale state
-        }
-        clearState();
-    }
-    const { Sandbox } = await getSandboxSDK();
-    sandbox = await Sandbox.create({
-        resources: { vcpus: 8 },
-        timeout: 18_000_000, // 5 hours (max for Pro/Enterprise)
-        ports: [3000],
-        runtime: "node22",
-    });
-    const state = {
-        sandboxId: sandbox.sandboxId,
-        createdAt: new Date().toISOString(),
-    };
-    try {
-        const domain = sandbox.domain(3000);
-        state.publicUrl = domain.startsWith("http") ? domain : `https://${domain}`;
-    }
-    catch {
-        // no public URL yet
-    }
-    saveState(state);
-    // ── Full environment setup ───────────────────────────────────
-    // 1. Chrome system deps (headless Chromium on Amazon Linux 2023)
-    await runInSandbox(`sudo dnf install -y ${CHROME_SYSTEM_DEPS.join(" ")} > /dev/null 2>&1`);
-    // 2. next-browser + Playwright Chromium
-    await runInSandbox(`npm install -g @vercel/next-browser 2>&1 | tail -1`);
-    await runInSandbox(`npm install -g playwright @playwright/browser-chromium 2>&1 | tail -1`);
-    await runInSandbox(`npx playwright install chromium 2>&1 | tail -1`);
-    // 3. SSH key (for private git repos)
-    const { homedir } = await import("node:os");
-    const sshKeyPath = join(homedir(), ".ssh", "id_ed25519");
-    if (existsSync(sshKeyPath)) {
-        const key = readFileSync(sshKeyPath, "utf-8");
-        await runInSandbox(`mkdir -p ~/.ssh && chmod 700 ~/.ssh`);
-        await sandbox.writeFiles([
-            { path: "/home/vercel-sandbox/.ssh/id_ed25519", content: Buffer.from(key) },
-        ]);
-        await runInSandbox(`chmod 600 ~/.ssh/id_ed25519`);
-        await runInSandbox(`ssh-keyscan github.com >> ~/.ssh/known_hosts 2>/dev/null`);
-    }
-    // 4. npmrc (for private packages)
-    const npmrcPath = join(homedir(), ".npmrc");
-    if (existsSync(npmrcPath)) {
-        const npmrc = readFileSync(npmrcPath, "utf-8");
-        await sandbox.writeFiles([
-            { path: "/home/vercel-sandbox/.npmrc", content: Buffer.from(npmrc) },
-        ]);
-    }
-    // 5. Node 24 via nvm (many projects require it)
-    await runInSandbox(`curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash > /dev/null 2>&1`);
-    await runInSandbox(`source ~/.nvm/nvm.sh && nvm install 24 > /dev/null 2>&1`);
-    return [
-        `sandbox created: ${sandbox.sandboxId}`,
-        state.publicUrl ? `url: ${state.publicUrl}` : null,
-    ]
-        .filter(Boolean)
-        .join("\n");
-}
-export async function exec(command) {
-    if (!sandbox)
-        throw new Error("no sandbox running — run `cloud create` first");
-    return runInSandbox(command);
-}
-/** Upload a local file to the sandbox. */
-export async function upload(localPath, remotePath) {
-    if (!sandbox)
-        throw new Error("no sandbox running — run `cloud create` first");
-    const content = readFileSync(localPath);
-    await sandbox.writeFiles([{ path: remotePath, content }]);
-    return `uploaded ${localPath} → ${remotePath} (${content.length} bytes)`;
-}
-export async function destroy() {
-    if (!sandbox) {
-        const state = loadState();
-        if (state) {
-            try {
-                loadEnv();
-                const { Sandbox } = await getSandboxSDK();
-                sandbox = await Sandbox.get({ sandboxId: state.sandboxId });
-            }
-            catch {
-                clearState();
-                return "no sandbox to destroy (cleared stale state)";
-            }
-        }
-        else {
-            return "no sandbox running";
-        }
-    }
-    const id = sandbox.sandboxId;
-    await sandbox.stop({ blocking: true });
-    sandbox = null;
-    clearState();
-    return `destroyed ${id}`;
-}
-export async function status() {
-    const state = loadState();
-    if (!state)
-        return "no sandbox running";
-    if (sandbox) {
-        return [
-            `id:      ${sandbox.sandboxId}`,
-            `status:  ${sandbox.status}`,
-            `created: ${state.createdAt}`,
-            state.publicUrl ? `url:     ${state.publicUrl}` : null,
-        ]
-            .filter(Boolean)
-            .join("\n");
-    }
-    return [
-        `id:      ${state.sandboxId}`,
-        `status:  unknown (daemon not running)`,
-        `created: ${state.createdAt}`,
-        state.publicUrl ? `url:     ${state.publicUrl}` : null,
-    ]
-        .filter(Boolean)
-        .join("\n");
-}
-/**
- * Load .env.local for Vercel credentials.
- */
-function loadEnv() {
-    const candidates = [
-        join(__dirname, "..", ".env.local"),
-        join(__dirname, "..", "prototypes", "cloud", ".env.local"),
-        resolve(process.cwd(), ".env.local"),
-    ];
-    for (const candidate of candidates) {
-        try {
-            const content = readFileSync(candidate, "utf-8");
-            for (const line of content.split("\n")) {
-                const trimmed = line.trim();
-                if (!trimmed || trimmed.startsWith("#"))
-                    continue;
-                const eqIdx = trimmed.indexOf("=");
-                if (eqIdx === -1)
-                    continue;
-                const key = trimmed.slice(0, eqIdx);
-                let value = trimmed.slice(eqIdx + 1);
-                if ((value.startsWith('"') && value.endsWith('"')) ||
-                    (value.startsWith("'") && value.endsWith("'"))) {
-                    value = value.slice(1, -1);
-                }
-                if (!process.env[key]) {
-                    process.env[key] = value;
-                }
-            }
-            return;
-        }
-        catch {
-            continue;
-        }
-    }
-}