@kkeve/suite 0.0.15 → 0.0.17

package/dist/core/cdp-resolver.js

@@ -1,93 +0,0 @@
-"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.resolveCdpWsUrl = resolveCdpWsUrl;
-const fs = __importStar(require("node:fs"));
-const os = __importStar(require("node:os"));
-const path = __importStar(require("node:path"));
-const node_child_process_1 = require("node:child_process");
-// TODO: consolidate doc-reading logic into keve-suite/spec
-function getChromeUserDataDir() {
-    const p = os.platform();
-    const h = os.homedir();
-    if (p === 'darwin')
-        return path.join(h, 'Library', 'Application Support', 'Google', 'Chrome');
-    if (p === 'win32')
-        return path.join(h, 'AppData', 'Local', 'Google', 'Chrome', 'User Data');
-    return path.join(h, '.config', 'google-chrome');
-}
-function getChromeWsUrlFromPort() {
-    const portFile = path.join(getChromeUserDataDir(), 'DevToolsActivePort');
-    if (!fs.existsSync(portFile))
-        return null;
-    try {
-        const [portStr, wsPath] = fs.readFileSync(portFile, 'utf8').trim().split('\n').map(l => l.trim()).filter(Boolean);
-        const port = parseInt(portStr, 10);
-        if (!port || !wsPath)
-            return null;
-        try {
-            (0, node_child_process_1.execSync)(`lsof -P -i TCP:${port} 2>/dev/null | grep LISTEN`, { encoding: 'utf8' });
-        }
-        catch {
-            return null;
-        }
-        return `ws://127.0.0.1:${port}${wsPath}`;
-    }
-    catch {
-        return null;
-    }
-}
-async function fetchWsUrlFromHttpEndpoint(endpoint) {
-    try {
-        const url = endpoint.replace(/\/$/, '') + '/json/version';
-        const res = await fetch(url, { signal: AbortSignal.timeout(5000) });
-        const data = await res.json();
-        return data.webSocketDebuggerUrl || null;
-    }
-    catch (e) {
-        console.warn(`[cdp-resolver] Failed to fetch from ${endpoint}: ${e.message}`);
-        return null;
-    }
-}
-async function resolveCdpWsUrl(options) {
-    if (options.wsEndpoint)
-        return options.wsEndpoint;
-    if (options.endpoint) {
-        const wsUrl = await fetchWsUrlFromHttpEndpoint(options.endpoint);
-        if (wsUrl)
-            return wsUrl;
-    }
-    return getChromeWsUrlFromPort();
-}

package/dist/core/global-setup.d.ts

@@ -1,6 +0,0 @@
-declare global {
-    var __keve_cdp_browser: import('@playwright/test').Browser | undefined;
-}
-export declare function getCdpBrowser(): Promise<import('@playwright/test').Browser | null>;
-export declare function isCdpMode(): boolean;
-export default function (): Promise<void>;

package/dist/core/global-setup.js

@@ -1,123 +0,0 @@
-"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.getCdpBrowser = getCdpBrowser;
-exports.isCdpMode = isCdpMode;
-exports.default = default_1;
-const fs = __importStar(require("node:fs"));
-const path = __importStar(require("node:path"));
-const auth_1 = require("./auth");
-async function getCdpBrowser() {
-    // 如果已有共享的 browser 对象，直接复用
-    if (globalThis.__keve_cdp_browser && globalThis.__keve_cdp_browser.isConnected()) {
-        return globalThis.__keve_cdp_browser;
-    }
-    const { chromium } = await Promise.resolve().then(() => __importStar(require('@playwright/test')));
-    let wsUrl = process.env.KEVE_CDP_WS_ENDPOINT;
-    // 如果只提供了 HTTP endpoint，自动获取 WebSocket URL
-    if (!wsUrl && process.env.KEVE_CDP_ENDPOINT) {
-        const httpUrl = process.env.KEVE_CDP_ENDPOINT.replace(/\/$/, '');
-        try {
-            const resp = await fetch(`${httpUrl}/json/version`, { signal: AbortSignal.timeout(5000) });
-            const data = await resp.json();
-            wsUrl = data.webSocketDebuggerUrl;
-            console.log(`[keve CDP] Resolved WS endpoint: ${wsUrl}`);
-        }
-        catch (e) {
-            console.warn(`[keve CDP] Failed to resolve CDP WebSocket URL from ${httpUrl}: ${e.message} — falling back to non-CDP mode`);
-            return null;
-        }
-    }
-    if (!wsUrl) {
-        console.warn(`[keve CDP] No CDP endpoint configured — falling back to non-CDP mode`);
-        return null;
-    }
-    try {
-        const browser = await chromium.connectOverCDP(wsUrl, { timeout: 15000 });
-        console.log(`[keve CDP] Connected via ${wsUrl}`);
-        globalThis.__keve_cdp_browser = browser;
-        return browser;
-    }
-    catch (connectErr) {
-        console.warn(`[keve CDP] connectOverCDP failed: ${connectErr.message} — falling back to non-CDP mode`);
-        return null;
-    }
-}
-function isCdpMode() {
-    return !!process.env.KEVE_CDP_WS_ENDPOINT || !!process.env.KEVE_CDP_ENDPOINT;
-}
-async function default_1() {
-    const projectRoot = path.resolve(process.cwd());
-    const storageStatePath = path.resolve(projectRoot, '.auth/storage-state.json');
-    const cdpEndpoint = process.env.KEVE_CDP_ENDPOINT || process.env.KEVE_CDP_WS_ENDPOINT;
-    if (cdpEndpoint) {
-        console.log(`[keve global-setup] CDP endpoint detected: ${cdpEndpoint}`);
-        // CDP 模式：在 global-setup 中提前连接一次，缓存 Browser 对象
-        // getCdpBrowser() 失败时返回 null 并清除 CDP 环境变量 → 后续 fixture 自动 fallback
-        const browser = await getCdpBrowser();
-        if (browser) {
-            const contexts = browser.contexts();
-            const pages = contexts.length > 0 ? contexts[0].pages() : [];
-            console.log(`[keve global-setup] CDP connected. contexts=${contexts.length}, pages=${pages.length}`);
-            if (pages.length > 0) {
-                console.log(`[keve global-setup] Existing tabs: ${pages.map(p => p.url()).join(', ')}`);
-            }
-        }
-        else {
-            console.warn(`[keve global-setup] CDP connection failed — tests will use non-CDP fallback (chromium.launch)`);
-        }
-        if (!fs.existsSync(storageStatePath)) {
-            const authDir = path.dirname(storageStatePath);
-            if (!fs.existsSync(authDir))
-                fs.mkdirSync(authDir, { recursive: true });
-            fs.writeFileSync(storageStatePath, JSON.stringify({ cookies: [], origins: [] }));
-        }
-        return;
-    }
-    console.log(`[keve global-setup] Acquiring fresh auth state...`);
-    const success = await (0, auth_1.acquireStorageState)({
-        logPrefix: '[keve global-setup]',
-    });
-    if (!success) {
-        console.warn(`[keve global-setup] Auth acquisition failed. Tests may fail due to auth issues.`);
-        if (!fs.existsSync(storageStatePath)) {
-            const authDir = path.dirname(storageStatePath);
-            if (!fs.existsSync(authDir))
-                fs.mkdirSync(authDir, { recursive: true });
-            fs.writeFileSync(storageStatePath, JSON.stringify({ cookies: [], origins: [] }));
-            console.log(`[keve global-setup] Created empty storage state → ${storageStatePath}`);
-        }
-    }
-}

package/dist/core/keve-decorators.d.ts

@@ -1,51 +0,0 @@
-/**
- * keve-decorators — @keveModel + @keveScene 装饰器
- *
- * 使用 TC39 Stage 3 装饰器 API (Playwright 1.58+ 默认支持)
- *
- * 执行顺序（TC39 Stage 3 规范）：
- * 1. Method decorator 函数调用 → 注册 addInitializer
- * 2. Class decorator 函数调用 → 注册 addInitializer
- * 3. Method addInitializers 执行 → @keveScene 注册场景到 WeakMap
- * 4. Class addInitializer 执行 → @keveModel 读取 WeakMap 并调用 test.describe
- *
- * 两层装饰器 + 函数调用：
- *   Model (模块) → test.describe → @keveModel
- *   Scene (场景) → test → @keveScene (fn.toString() 捕获完整脚本)
- *   Goal  (步骤) → 步骤元数据 → keveGoal() 函数调用（在方法体内）
- */
-import { type KeveGoalMeta } from './keve-registry';
-/** Called by keve-test.ts to register the extended test instance */
-export declare function setKeveTest(t: any): void;
-/** Get the current keve test instance (extended with fixtures) */
-export declare function getKeveTest(): any;
-export type { KeveGoalMeta, KeveEvalMeta, ErrorCategory } from './keve-registry';
-export interface KeveSceneMeta {
-    id: string;
-    description: string;
-    title: string;
-    code: string;
-    goals: KeveGoalMeta[];
-    fn: Function;
-}
-/**
- * @keveModel(name) — Class decorator (模块层)
- * Uses context.addInitializer to defer test.describe() registration
- * until AFTER all @keveScene addInitializers have run.
- */
-export declare function keveModel(id: string, description: string): <T extends {
-    new (...args: any[]): {};
-}>(ctor: T, context: ClassDecoratorContext) => T;
-/**
- * @keveScene(title) — Method decorator (场景层, static methods only)
- * Captures fn.toString() as the complete scene script.
- * Wraps fn with try-catch-finally to classify errors and decide skipAI.
- * Registers scene metadata to both WeakMap and global Map.
- *
- * The wrapper preserves the original function's destructuring signature by
- * extracting the parameter text from fn.toString() and constructing a wrapper
- * via new Function(), so Playwright can correctly resolve fixture dependencies.
- */
-export declare function keveScene(id: string, description: string): (fn: Function, context: ClassMethodDecoratorContext) => Function;
-/** 获取 Model 下注册的所有 Scene */
-export declare function getModelScenes(ctor: Function): KeveSceneMeta[] | null;

package/dist/core/keve-decorators.js

@@ -1,95 +0,0 @@
-"use strict";
-/**
- * keve-decorators — @keveModel + @keveScene 装饰器
- *
- * 使用 TC39 Stage 3 装饰器 API (Playwright 1.58+ 默认支持)
- *
- * 执行顺序（TC39 Stage 3 规范）：
- * 1. Method decorator 函数调用 → 注册 addInitializer
- * 2. Class decorator 函数调用 → 注册 addInitializer
- * 3. Method addInitializers 执行 → @keveScene 注册场景到 WeakMap
- * 4. Class addInitializer 执行 → @keveModel 读取 WeakMap 并调用 test.describe
- *
- * 两层装饰器 + 函数调用：
- *   Model (模块) → test.describe → @keveModel
- *   Scene (场景) → test → @keveScene (fn.toString() 捕获完整脚本)
- *   Goal  (步骤) → 步骤元数据 → keveGoal() 函数调用（在方法体内）
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setKeveTest = setKeveTest;
-exports.getKeveTest = getKeveTest;
-exports.keveModel = keveModel;
-exports.keveScene = keveScene;
-exports.getModelScenes = getModelScenes;
-const test_1 = require("@playwright/test");
-const keve_registry_1 = require("./keve-registry");
-// ─── Configurable test reference ────────────────────────────────────
-// keveModel needs to call test.describe / test — but it must use the EXTENDED test
-// (with keveGoal/keveAssert fixtures), not the base @playwright/test.
-// keve-test.ts calls setKeveTest() after creating the extended test.
-let _keveTest = test_1.test;
-/** Called by keve-test.ts to register the extended test instance */
-function setKeveTest(t) { _keveTest = t; }
-/** Get the current keve test instance (extended with fixtures) */
-function getKeveTest() { return _keveTest; }
-// ─── Internal Registry (WeakMap per Model constructor) ─────────────
-/** Model → Scene 列表：每个 @keveModel 类下注册的 @keveScene 列表 */
-const modelScenesMap = new WeakMap();
-// ─── Error Classification ──────────────────────────────────────────
-// Error classification moved to keve-report.ts onTestEnd — 
-// onTestEnd has access to result.error and result.status, which is more reliable
-// than try-catch in the decorator (async rejections, test-level timeouts can bypass decorator catch).
-// ─── TC39 Stage 3 Decorators ──────────────────────────────────────
-/**
- * @keveModel(name) — Class decorator (模块层)
- * Uses context.addInitializer to defer test.describe() registration
- * until AFTER all @keveScene addInitializers have run.
- */
-function keveModel(id, description) {
-    return (ctor, context) => {
-        context.addInitializer(function () {
-            const ctor = this;
-            const scenes = modelScenesMap.get(ctor) || [];
-            _keveTest.describe(`${id}: ${description}`, () => {
-                for (const scene of scenes) {
-                    _keveTest(scene.title, scene.fn);
-                }
-            });
-        });
-        return ctor;
-    };
-}
-/**
- * @keveScene(title) — Method decorator (场景层, static methods only)
- * Captures fn.toString() as the complete scene script.
- * Wraps fn with try-catch-finally to classify errors and decide skipAI.
- * Registers scene metadata to both WeakMap and global Map.
- *
- * The wrapper preserves the original function's destructuring signature by
- * extracting the parameter text from fn.toString() and constructing a wrapper
- * via new Function(), so Playwright can correctly resolve fixture dependencies.
- */
-function keveScene(id, description) {
-    return (fn, context) => {
-        const code = fn.toString(); // Capture original code BEFORE wrapping
-        const title = `${id}: ${description}`;
-        // Register the original function directly — Playwright resolves fixture dependencies
-        // by parsing fn.toString() / AST. Wrapping with new Function() breaks this resolution.
-        // Error classification is handled in onTestEnd (keve-report.ts), not here.
-        context.addInitializer(function () {
-            const ctor = this;
-            if (!modelScenesMap.has(ctor))
-                modelScenesMap.set(ctor, []);
-            const scene = { id, description, title, code, goals: [], fn };
-            modelScenesMap.get(ctor).push(scene);
-            // Register to global maps for Reporter access
-            keve_registry_1.sceneCodeMap.set(title, code); // Stores ORIGINAL code, not wrapped
-        });
-        return fn; // Return original function unchanged — preserves fixture parameter signature
-    };
-}
-// ─── Utility ───────────────────────────────────────────────────────
-/** 获取 Model 下注册的所有 Scene */
-function getModelScenes(ctor) {
-    return modelScenesMap.get(ctor) || null;
-}