playwright-e2e-mcp 0.1.0

package/dist/utils/path-utils.js

@@ -0,0 +1,211 @@
+/**
+ * Cross-platform path handling.
+ *
+ * All path logic here is *lexical* (string based, no fs access) so that
+ * Windows paths behave correctly when unit tests run on macOS/Linux and
+ * vice versa. Backslashes are normalized everywhere, drive letters and
+ * UNC prefixes are preserved, and user-supplied paths are sandboxed to
+ * the project root to block "../../etc/passwd" style escapes.
+ */
+import { randomBytes } from 'node:crypto';
+import os from 'node:os';
+import path from 'node:path';
+import { PlaywrightMcpError } from '../types/index.js';
+const DRIVE_RE = /^[a-zA-Z]:\//;
+/** Schemes like http:// — two+ chars so "C://" (drive) is not caught. */
+const URL_RE = /^[a-zA-Z][a-zA-Z0-9+.-]+:\/\//;
+const TEST_FILE_RE = /\.(spec|test)\.(ts|mts|cts|js|mjs|cjs|tsx|jsx)$/i;
+/** Replace backslashes with slashes, collapsing duplicate separators. */
+export function normalizeSeparators(p) {
+    const slashed = p.replace(/\\/g, '/');
+    const isUnc = slashed.startsWith('//');
+    const collapsed = slashed.replace(/\/{2,}/g, '/');
+    if (isUnc && !DRIVE_RE.test(collapsed))
+        return `/${collapsed}`;
+    return collapsed;
+}
+/** True when the path is Windows-style (drive letter or UNC). */
+export function isWindowsPath(p) {
+    const s = normalizeSeparators(p);
+    return DRIVE_RE.test(s) || s.startsWith('//');
+}
+function isCaseInsensitive(p) {
+    const s = normalizeSeparators(p);
+    return DRIVE_RE.test(s) || s.startsWith('//');
+}
+/** True for absolute paths on either platform (/, C:/ or //unc). */
+export function isAbsolutePath(p) {
+    const s = normalizeSeparators(p);
+    return s.startsWith('/') || DRIVE_RE.test(s);
+}
+/**
+ * Normalize separators and collapse `.` / `..` segments lexically.
+ * Leading `..` on relative paths is preserved; escapes above an absolute
+ * root (/, C:/, //server) are dropped.
+ */
+export function normalizePath(p) {
+    const s = normalizeSeparators(p);
+    let root = '';
+    let rest = s;
+    if (DRIVE_RE.test(s)) {
+        root = s.slice(0, 3); // "C:/"
+        rest = s.slice(3);
+    }
+    else if (s.startsWith('//')) {
+        root = '//';
+        rest = s.slice(2);
+    }
+    else if (s.startsWith('/')) {
+        root = '/';
+        rest = s.slice(1);
+    }
+    const out = [];
+    for (const segment of rest.split('/')) {
+        if (segment === '' || segment === '.')
+            continue;
+        if (segment === '..') {
+            const top = out[out.length - 1];
+            if (out.length > 0 && top !== '..') {
+                out.pop();
+            }
+            else if (root === '') {
+                out.push('..');
+            }
+            continue;
+        }
+        out.push(segment);
+    }
+    return root + out.join('/');
+}
+/** Resolve `target` against `base` (both normalized lexically). */
+export function resolvePath(base, target) {
+    const normalizedTarget = normalizePath(target);
+    if (isAbsolutePath(normalizedTarget))
+        return normalizedTarget;
+    const normalizedBase = normalizePath(base);
+    if (normalizedBase === '')
+        return normalizedPathJoin(normalizedTarget);
+    return normalizePath(`${normalizedBase}/${normalizedTarget}`);
+}
+function normalizedPathJoin(p) {
+    return p === '' ? '.' : p;
+}
+/** Lexical containment check (case-insensitive for drive/UNC paths). */
+export function isPathInside(child, parent) {
+    const c = normalizePath(child);
+    const p = normalizePath(parent);
+    if (c === '' || p === '')
+        return false;
+    const insensitive = isCaseInsensitive(c) || isCaseInsensitive(p);
+    const cc = insensitive ? c.toLowerCase() : c;
+    const pp = insensitive ? p.toLowerCase() : p;
+    if (cc === pp)
+        return true;
+    const prefix = pp.endsWith('/') ? pp : `${pp}/`;
+    return cc.startsWith(prefix);
+}
+/** Expand a leading `~` to the user's home directory. */
+export function expandHome(p) {
+    if (p === '~')
+        return os.homedir();
+    if (p.startsWith('~/') || p.startsWith('~\\')) {
+        return os.homedir() + p.slice(1);
+    }
+    return p;
+}
+/**
+ * Sandbox a user-supplied path to the project root.
+ *
+ * Accepts relative or absolute inputs, expands `~`, normalizes
+ * separators, then verifies the result stays inside `projectRoot`.
+ * Throws PlaywrightMcpError(INVALID_PATH) for traversal escapes,
+ * absolute paths outside the root, URLs, null bytes, and empty values.
+ *
+ * @returns Normalized absolute path with forward slashes.
+ */
+export function sanitizeUserPath(input, projectRoot) {
+    if (typeof input !== 'string') {
+        throw new PlaywrightMcpError('Path must be a string', 'INVALID_PATH', {
+            hint: 'Pass a path relative to the project root, e.g. "tests/login.spec.ts".',
+        });
+    }
+    const raw = input.trim();
+    if (raw === '') {
+        throw new PlaywrightMcpError('Path must not be empty', 'INVALID_PATH', {
+            hint: 'Pass a path relative to the project root, e.g. "tests/login.spec.ts".',
+        });
+    }
+    if (raw.includes('\0')) {
+        throw new PlaywrightMcpError('Path contains a null byte', 'INVALID_PATH', {
+            hint: 'Remove null bytes from the path.',
+        });
+    }
+    if (URL_RE.test(raw)) {
+        throw new PlaywrightMcpError(`"${raw}" looks like a URL, not a filesystem path`, 'INVALID_PATH', {
+            hint: 'Pass a local path relative to the project root.',
+        });
+    }
+    const root = normalizePath(projectRoot);
+    if (!isAbsolutePath(root)) {
+        throw new PlaywrightMcpError(`Project root must be absolute, got "${projectRoot}"`, 'INVALID_PATH');
+    }
+    const expanded = normalizePath(expandHome(raw));
+    const resolved = resolvePath(root, expanded);
+    if (!isPathInside(resolved, root)) {
+        throw new PlaywrightMcpError(`Path "${raw}" resolves outside the project root`, 'INVALID_PATH', {
+            hint: `Only paths inside ${root} are allowed. Directory traversal (..), absolute paths outside the project, and symlinks out of the project are rejected.`,
+            details: `resolved=${resolved}`,
+        });
+    }
+    return resolved;
+}
+/** Convert a normalized path to the host platform's native form. */
+export function toNativePath(p) {
+    const normalized = normalizePath(p);
+    return process.platform === 'win32' ? path.win32.normalize(normalized) : path.posix.normalize(normalized);
+}
+/** Always-forward-slash form (used in messages and tool output). */
+export function toPosixPath(p) {
+    return normalizePath(p);
+}
+/** Path of `p` relative to `root`, posix style; absolute if not inside. */
+export function relativeToRoot(root, p) {
+    const r = normalizePath(root);
+    const c = normalizePath(p);
+    if (!isPathInside(c, r))
+        return c;
+    if (c === r)
+        return '';
+    const base = r.endsWith('/') ? r : `${r}/`;
+    return c.slice(base.length);
+}
+/** Build an absolute path under the project root. */
+export function joinProjectPath(root, ...segments) {
+    return resolvePath(root, segments.join('/'));
+}
+/** A unique path inside the OS temp dir (used for JSON reports). */
+export function tempFilePath(prefix, extension = '.json') {
+    const unique = `${Date.now().toString(36)}-${randomBytes(6).toString('hex')}`;
+    return normalizePath(path.join(os.tmpdir(), `${prefix}-${unique}${extension}`));
+}
+/** True when a filename looks like a Playwright test/spec file. */
+export function isTestFile(p) {
+    return TEST_FILE_RE.test(normalizeSeparators(p));
+}
+/**
+ * Validate a free-form CLI argument list: rejects NUL bytes and
+ * shell-looking metacharacters that could smuggle extra commands.
+ */
+export function sanitizeCliArg(arg) {
+    const raw = typeof arg === 'string' ? arg.trim() : '';
+    if (raw === '') {
+        throw new PlaywrightMcpError('Argument must not be empty', 'INVALID_PATH');
+    }
+    if (/[\0;&|><`$]/.test(raw)) {
+        throw new PlaywrightMcpError(`Argument "${raw}" contains forbidden shell characters`, 'INVALID_PATH', {
+            hint: 'Arguments are executed directly (no shell); remove ; & | > < ` $ characters.',
+        });
+    }
+    return raw;
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/utils/path-utils.js.map

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

package/dist/utils/playwright-runner.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Core Playwright execution logic.
+ *
+ * Runs the project's local Playwright CLI as a child process (never a
+ * shell), streams and caps its output, enforces a hard wall-clock
+ * timeout with process-*group* cleanup, collects the JSON report, and
+ * converts every failure mode — missing install, dead dev server,
+ * syntax error, browser crash, full disk, client disconnect — into a
+ * structured result.
+ */
+import type { ListTestsOptions, ListTestsResult, RunTestOptions, RunTestResult } from '../types/index.js';
+/**
+ * Locate the project's local Playwright CLI (playwright/cli.js), which
+ * we invoke directly with `node` — no shell, no npx, cross-platform.
+ */
+export declare function resolvePlaywrightCli(projectRoot: string): Promise<string | null>;
+export interface RunProcessOptions {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    timeoutMs: number;
+    signal?: AbortSignal;
+}
+export interface ProcessOutcome {
+    code: number | null;
+    signalName: NodeJS.Signals | null;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+    aborted: boolean;
+    spawnError: {
+        code: string;
+        message: string;
+    } | null;
+}
+/**
+ * Spawn a process with output capping, tree-kill timeout and abort.
+ * Children are tracked so shutdown/disconnect can never orphan them.
+ */
+export declare function runProcess(command: string, args: string[], options: RunProcessOptions): Promise<ProcessOutcome>;
+/**
+ * Force-kill every child still running (and its tree). Called on
+ * shutdown and when the MCP client disconnects so no browser or test
+ * worker outlives the server.
+ */
+export declare function killActiveChildren(): number;
+/**
+ * Execute Playwright tests and return a structured result. Throws
+ * PlaywrightMcpError only for precondition failures (no Playwright
+ * installed, bad paths); test failures come back as data.
+ */
+export declare function runTests(options: RunTestOptions): Promise<RunTestResult>;
+/** List tests via `playwright test --list`, falling back to file scan. */
+export declare function listTests(options: ListTestsOptions): Promise<ListTestsResult>;
+export interface ServerProbe {
+    reachable: boolean;
+    status?: number;
+    error?: string;
+}
+/**
+ * Quick reachability check for the app under test, used to tell the
+ * user "start your dev server" instead of surfacing ECONNREFUSED.
+ */
+export declare function probeServer(url: string, timeoutMs?: number): Promise<ServerProbe>;