cssprobe-cli 0.3.0 → 0.4.0

package/dist/cli/program.js

@@ -9,11 +9,17 @@ const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const minimist_1 = require("./minimist");
 const command_1 = require("./command");
+const input_1 = require("./input");
 const commands_1 = require("./commands");
 const output_1 = require("./output");
 const config_1 = require("../config/config");
 const session_1 = require("../daemon/session");
 const session_ops_1 = require("./session-ops");
+const state_check_1 = require("./state-check");
+const launcher_1 = require("../browser/launcher");
+const schema_1 = require("../scenario/schema");
+const runner_1 = require("../scenario/runner");
+const reporters_1 = require("../scenario/reporters");
 const mcp_1 = require("../mcp");
 const globalOptions = ['json', 'raw', 'help', 'h', 'version', 'v', 'p', 'profile'];
 const booleanGlobalOptions = ['help', 'json', 'raw', 'version', 'v', 'h'];
@@ -52,15 +58,25 @@ async function program() {
         case 'close':
             await handleClose(command, rawArgs, output);
             return;
+        case 'doctor':
+            handleDoctor(command, rawArgs, output);
+            return;
+        case 'scenario':
+            await handleScenario(command, rawArgs, output);
+            return;
         case 'status':
             await handleStatus(output);
             return;
         case 'state-import':
             await handleStateImport(command, rawArgs, output);
             return;
+        case 'state-check':
+            handleStateCheck(command, rawArgs, output);
+            return;
         case 'state-save':
             await handleStateSave(command, rawArgs, output);
             return;
+        case 'frames':
         case 'inspect':
         case 'tree':
         case 'layout':
@@ -70,8 +86,17 @@ async function program() {
         case 'eval':
         case 'resize':
         case 'playwright':
+        case 'click':
+        case 'hover':
+        case 'type':
+        case 'wait-for':
+        case 'sample':
+        case 'wait-stable':
             await handleSessionCommand(commandName, command, rawArgs, output);
             return;
+        case 'run':
+            await handleRun(command, rawArgs, output);
+            return;
     }
     output.error(`Unknown command: ${commandName}. Run 'cssprobe-cli --help' for usage.`);
 }
@@ -141,6 +166,8 @@ async function handleOpen(command, args, output) {
             headed: !!parsed.headed,
             viewport,
             state: parsed.state,
+            expectUrl: parsed['expect-url'],
+            failOnLogin: !!parsed['fail-on-login'],
         });
         if (output.json) {
             console.log(JSON.stringify(result, null, 2));
@@ -176,11 +203,100 @@ async function handleClose(command, args, output) {
         output.error(e instanceof Error ? e.message : String(e));
     }
 }
+async function handleScenario(command, args, output) {
+    try {
+        const cmdArgs = splitArgs(args);
+        const parsed = (0, command_1.parseCommand)(command, cmdArgs);
+        const file = path_1.default.resolve(parsed.file);
+        if (!fs_1.default.existsSync(file))
+            output.error(`Scenario suite not found: ${file}`);
+        const raw = JSON.parse(fs_1.default.readFileSync(file, 'utf-8'));
+        const validation = schema_1.suiteSchema.safeParse(raw);
+        if (!validation.success) {
+            const issues = validation.error.issues
+                .map(issue => `${issue.path.join('.') || '(root)'}: ${issue.message}`)
+                .join('\n');
+            output.error(`Invalid scenario suite:\n${issues}`);
+        }
+        let viewport;
+        const viewportStr = parsed.viewport;
+        if (viewportStr) {
+            const parts = viewportStr.split('x');
+            const width = parseInt(parts[0], 10);
+            const height = parseInt(parts[1], 10);
+            if (parts.length !== 2 || isNaN(width) || isNaN(height)) {
+                output.error('Invalid viewport format. Use WxH (e.g. 1280x720)');
+            }
+            viewport = { width, height };
+        }
+        const result = await (0, runner_1.runScenario)(validation.data, file, {
+            artifactsDir: parsed.artifacts,
+            junitPath: parsed.junit,
+            bail: !!parsed.bail,
+            headed: !!parsed.headed,
+            browser: parsed.browser,
+            viewport,
+            state: parsed.state,
+        });
+        if (output.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log((0, reporters_1.formatConsole)(result.suite, result.results));
+            console.log(`Artifacts: ${result.artifactsDir}`);
+            if (parsed.junit)
+                console.log(`JUnit: ${path_1.default.resolve(parsed.junit)}`);
+        }
+        if (!result.ok)
+            process.exit(1);
+    }
+    catch (e) {
+        output.error(e instanceof Error ? e.message : String(e));
+    }
+}
+function handleDoctor(command, args, output) {
+    try {
+        const cmdArgs = splitArgs(args);
+        const parsed = (0, command_1.parseCommand)(command, cmdArgs);
+        const diagnosis = (0, launcher_1.diagnoseBrowser)(parsed.engine);
+        if (output.json) {
+            console.log(JSON.stringify(diagnosis, null, 2));
+            return;
+        }
+        console.log(`Platform: ${diagnosis.platform}`);
+        console.log(`Cache roots: ${diagnosis.cacheRoots.join(', ')}`);
+        console.log(`Expected: chromium ${diagnosis.expected.chromium ?? 'unknown'}, headless-shell ${diagnosis.expected.headlessShell ?? 'unknown'} (playwright-core ${diagnosis.expected.playwrightVersion ?? 'unknown'})`);
+        if (diagnosis.installs.length) {
+            console.log('Installed:');
+            for (const install of diagnosis.installs) {
+                console.log(`  ${install.kind}-${install.revision}${install.executable ? '' : ' (no executable)'} ${install.dir}`);
+            }
+        }
+        else {
+            console.log('Installed: none');
+        }
+        console.log(`Status: ${diagnosis.status}`);
+        if (diagnosis.hint)
+            console.log(`Hint: ${diagnosis.hint}`);
+    }
+    catch (e) {
+        output.error(e instanceof Error ? e.message : String(e));
+    }
+}
 async function handleStatus(output) {
     try {
         const result = await (0, session_ops_1.getSessionStatus)();
+        let page = null;
+        if (result.alive) {
+            try {
+                page = await (0, session_ops_1.getPageInfo)();
+            }
+            catch {
+                page = null;
+            }
+        }
         if (output.json) {
-            console.log(JSON.stringify(result, null, 2));
+            console.log(JSON.stringify({ ...result, page }, null, 2));
             return;
         }
         if (!result.config) {
@@ -191,15 +307,67 @@ async function handleStatus(output) {
         console.log(`Status: ${result.alive ? 'alive' : 'dead'}`);
         if (result.alive) {
             console.log(`Browser: ${result.config.browser.browserName}`);
+            if (page) {
+                console.log(`URL: ${page.url}`);
+                console.log(`Title: ${page.title}`);
+                console.log(`Frames: ${page.frames}`);
+            }
         }
     }
     catch (e) {
         output.error(e instanceof Error ? e.message : String(e));
     }
 }
+function handleStateCheck(command, args, output) {
+    try {
+        const cmdArgs = splitArgs(args);
+        const parsed = (0, command_1.parseCommand)(command, cmdArgs);
+        const file = path_1.default.resolve(parsed.state ??
+            path_1.default.join(os_1.default.homedir(), '.cssprobe-cli', 'states', 'session.json'));
+        if (!fs_1.default.existsSync(file))
+            output.error(`State file not found: ${file}`);
+        const raw = JSON.parse(fs_1.default.readFileSync(file, 'utf-8'));
+        if (!raw || !Array.isArray(raw.cookies))
+            throw new Error(`Invalid state file (missing cookies): ${file}`);
+        const report = (0, state_check_1.analyzeState)(raw, parsed.url);
+        if (output.json) {
+            console.log(JSON.stringify({ file, ...report }, null, 2));
+            return;
+        }
+        console.log(`State: ${file}`);
+        console.log(`Cookies: ${report.cookies} (${report.sessionCookies} session)`);
+        console.log(`Domains: ${report.domains.join(', ') || '(none)'}`);
+        if (report.targetMatches !== null) {
+            console.log(`Target match: ${report.targetMatches ? 'yes' : 'no'}`);
+        }
+        console.log(`Status: ${report.ok ? 'ok' : 'attention'}`);
+        for (const warning of report.warnings)
+            console.log(`Warning: ${warning}`);
+    }
+    catch (e) {
+        output.error(e instanceof Error ? e.message : String(e));
+    }
+}
+async function handleRun(command, args, output) {
+    const fileArg = args._[1];
+    if (!fileArg)
+        output.error('Usage: cssprobe-cli run <file>');
+    const file = path_1.default.resolve(fileArg);
+    if (!fs_1.default.existsSync(file))
+        output.error(`Flow script not found: ${file}`);
+    args._ = ['run', file];
+    await handleSessionCommand('run', command, args, output);
+}
 async function handleSessionCommand(commandName, command, args, output) {
     try {
         const cmdArgs = splitArgs(args);
+        if (commandName === 'eval' || commandName === 'playwright') {
+            const input = cmdArgs._[1];
+            if (typeof input === 'string') {
+                cmdArgs._ = cmdArgs._.slice();
+                cmdArgs._[1] = (0, input_1.resolveInputArg)(input);
+            }
+        }
         const parsed = (0, command_1.parseCommand)(command, cmdArgs);
         const result = await (0, session_ops_1.runSessionCommand)(commandName, command, parsed, !!args.json);
         // Screenshot: save the base64 data URL to a file and report the path
@@ -214,6 +382,8 @@ async function handleSessionCommand(commandName, command, args, output) {
             return;
         }
         console.log(result.text);
+        if (typeof result.exitCode === 'number' && result.exitCode !== 0)
+            process.exit(result.exitCode);
     }
     catch (e) {
         output.error(e instanceof Error ? e.message : String(e));

package/dist/cli/session-ops.d.ts

@@ -1,6 +1,7 @@
 import { Session } from '../daemon/session';
 import type { SessionConfig } from '../daemon/session';
 import type { AnyCommandSchema } from './command';
+export { saveScreenshotFile } from '../utils/screenshot';
 export interface OpenOptions {
     url?: string;
     browser?: string;
@@ -10,6 +11,8 @@ export interface OpenOptions {
         height: number;
     };
     state?: string;
+    expectUrl?: string;
+    failOnLogin?: boolean;
 }
 export interface OpenResult {
     sessionId: string;
@@ -20,6 +23,12 @@ export interface OpenResult {
         height: number;
     };
 }
+export interface PageInfo {
+    url: string;
+    title: string;
+    frames: number;
+}
+export declare function getPageInfo(): Promise<PageInfo>;
 export declare function openSession(opts: OpenOptions): Promise<OpenResult>;
 export declare function waitForSession(timeoutMs: number): Promise<Session | undefined>;
 export interface CloseResult {
@@ -39,5 +48,5 @@ export declare function getSessionStatus(): Promise<StatusResult>;
 export declare function buildDaemonArgs(commandName: string, command: AnyCommandSchema, parsed: Record<string, unknown>): string[];
 export declare function runSessionCommand(commandName: string, command: AnyCommandSchema, parsed: Record<string, unknown>, json?: boolean): Promise<{
     text: string;
+    exitCode?: number;
 }>;
-export declare function saveScreenshotFile(dataUrl: string, out?: string): string;

package/dist/cli/session-ops.js

@@ -1,49 +1,24 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveScreenshotFile = void 0;
+exports.getPageInfo = getPageInfo;
 exports.openSession = openSession;
 exports.waitForSession = waitForSession;
 exports.closeSession = closeSession;
 exports.getSessionStatus = getSessionStatus;
 exports.buildDaemonArgs = buildDaemonArgs;
 exports.runSessionCommand = runSessionCommand;
-exports.saveScreenshotFile = saveScreenshotFile;
-const fs = __importStar(require("fs"));
-const os = __importStar(require("os"));
-const path = __importStar(require("path"));
 const session_1 = require("../daemon/session");
+const url_guard_1 = require("./url-guard");
+var screenshot_1 = require("../utils/screenshot");
+Object.defineProperty(exports, "saveScreenshotFile", { enumerable: true, get: function () { return screenshot_1.saveScreenshotFile; } });
+async function getPageInfo() {
+    const session = await (0, session_1.loadSession)();
+    if (!session)
+        throw new Error('No active session. Run: cssprobe-cli open <url>');
+    const result = await session.run({ _: ['page-info'] });
+    return JSON.parse(result.text);
+}
 async function openSession(opts) {
     const url = opts.url || 'about:blank';
     const browser = opts.browser || 'chromium';
@@ -58,10 +33,24 @@ async function openSession(opts) {
     if (!session)
         throw new Error('Daemon failed to become ready within 5s. Check the daemon log for errors.');
     await session.run({ _: ['goto', url] });
+    const info = await getPageInfo();
+    const guardError = (() => {
+        if (opts.failOnLogin && (0, url_guard_1.looksLikeLoginUrl)(info.url)) {
+            return `Login required: page redirected to ${info.url}. Refresh the state file or log in manually.`;
+        }
+        if (opts.expectUrl && !(0, url_guard_1.matchesUrlPattern)(opts.expectUrl, info.url)) {
+            return `Expected URL to match ${opts.expectUrl}, got ${info.url}`;
+        }
+        return null;
+    })();
+    if (guardError) {
+        await closeSession();
+        throw new Error(guardError);
+    }
     return {
         sessionId: 'default',
         pid,
-        url,
+        url: info.url,
         viewport: opts.viewport || { width: 1280, height: 720 },
     };
 }
@@ -142,22 +131,4 @@ async function runSessionCommand(commandName, command, parsed, json = false) {
         runArgs.json = true;
     return await session.run(runArgs);
 }
-function saveScreenshotFile(dataUrl, out) {
-    const base64 = dataUrl.replace(/^data:image\/png;base64,/, '');
-    const buffer = Buffer.from(base64, 'base64');
-    const resolvedOut = out
-        ? path.resolve(out)
-        : (() => {
-            const dir = path.join(os.homedir(), '.cssprobe-cli', 'screenshots');
-            if (!fs.existsSync(dir))
-                fs.mkdirSync(dir, { recursive: true });
-            const ts = new Date().toISOString().replace(/[:.]/g, '-');
-            return path.join(dir, `screenshot-${ts}.png`);
-        })();
-    const dir = path.dirname(resolvedOut);
-    if (!fs.existsSync(dir))
-        fs.mkdirSync(dir, { recursive: true });
-    fs.writeFileSync(resolvedOut, buffer);
-    return resolvedOut;
-}
 //# sourceMappingURL=session-ops.js.map

package/dist/cli/state-check.d.ts

@@ -0,0 +1,17 @@
+export interface StorageCookie {
+    name: string;
+    domain: string;
+    expires?: number;
+}
+export interface StateReport {
+    cookies: number;
+    domains: string[];
+    expired: string[];
+    sessionCookies: number;
+    targetMatches: boolean | null;
+    warnings: string[];
+    ok: boolean;
+}
+export declare function analyzeState(state: {
+    cookies?: StorageCookie[];
+}, targetUrl?: string, nowMs?: number): StateReport;

package/dist/cli/state-check.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeState = analyzeState;
+function normalizeDomain(domain) {
+    return domain.replace(/^\./, '').toLowerCase();
+}
+function analyzeState(state, targetUrl, nowMs = Date.now()) {
+    const cookies = state.cookies ?? [];
+    const expired = [];
+    let sessionCookies = 0;
+    for (const cookie of cookies) {
+        if (cookie.expires === undefined || cookie.expires <= 0) {
+            sessionCookies++;
+        }
+        else if (cookie.expires * 1000 <= nowMs) {
+            expired.push(cookie.name);
+        }
+    }
+    const domains = Array.from(new Set(cookies.map(cookie => normalizeDomain(cookie.domain)))).sort();
+    let targetMatches = null;
+    if (targetUrl) {
+        try {
+            const host = new URL(targetUrl).hostname.toLowerCase();
+            targetMatches = cookies.some(cookie => {
+                const domain = normalizeDomain(cookie.domain);
+                return host === domain || host.endsWith(`.${domain}`);
+            });
+        }
+        catch {
+            throw new Error(`Invalid --url value: ${targetUrl}`);
+        }
+    }
+    const warnings = [];
+    if (!cookies.length)
+        warnings.push('no cookies in state file');
+    if (expired.length)
+        warnings.push(`expired cookies: ${expired.join(', ')}`);
+    if (targetMatches === false)
+        warnings.push(`no cookies match ${targetUrl}`);
+    const ok = cookies.length > 0 && expired.length === 0 && targetMatches !== false;
+    return { cookies: cookies.length, domains, expired, sessionCookies, targetMatches, warnings, ok };
+}
+//# sourceMappingURL=state-check.js.map

package/dist/cli/url-guard.d.ts

@@ -0,0 +1,2 @@
+export declare function looksLikeLoginUrl(raw: string): boolean;
+export declare function matchesUrlPattern(pattern: string, raw: string): boolean;

package/dist/cli/url-guard.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.looksLikeLoginUrl = looksLikeLoginUrl;
+exports.matchesUrlPattern = matchesUrlPattern;
+function looksLikeLoginUrl(raw) {
+    try {
+        const url = new URL(raw);
+        return /\/(?:s\/)?login(?:\/|$)/.test(url.pathname);
+    }
+    catch {
+        return false;
+    }
+}
+function matchesUrlPattern(pattern, raw) {
+    let regex;
+    try {
+        regex = new RegExp(pattern);
+    }
+    catch {
+        throw new Error(`Invalid --expect-url pattern: ${pattern}`);
+    }
+    return regex.test(raw);
+}
+//# sourceMappingURL=url-guard.js.map