laxy-verify 1.2.2 → 1.3.0

package/dist/entitlement.d.ts

@@ -1,11 +1,15 @@
-export interface EntitlementFeatures {
-    plan: string;
-    github_actions: boolean;
-    queue_priority: boolean;
-    parallel_execution: boolean;
-}
-export type TestablePlan = "free" | "pro" | "team";
-export declare function normalizePlan(plan?: string | null): TestablePlan;
-export declare function getEntitlements(): Promise<EntitlementFeatures>;
-export declare function applyPlanOverride(features: EntitlementFeatures, overridePlan?: TestablePlan): EntitlementFeatures;
-export declare function printPlanBanner(features: EntitlementFeatures): void;
+export interface EntitlementFeatures {
+    plan: string;
+    github_actions: boolean;
+    queue_priority: boolean;
+    parallel_execution: boolean;
+    ai_failure_analysis: boolean;
+    compare_env: boolean;
+    share_result: boolean;
+    history_trend: boolean;
+}
+export type TestablePlan = "free" | "pro" | "team";
+export declare function normalizePlan(plan?: string | null): TestablePlan;
+export declare function getEntitlements(): Promise<EntitlementFeatures>;
+export declare function applyPlanOverride(features: EntitlementFeatures, overridePlan?: TestablePlan): EntitlementFeatures;
+export declare function printPlanBanner(features: EntitlementFeatures): void;

package/dist/entitlement.js

@@ -1,90 +1,98 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizePlan = normalizePlan;
-exports.getEntitlements = getEntitlements;
-exports.applyPlanOverride = applyPlanOverride;
-exports.printPlanBanner = printPlanBanner;
-/**
- * Fetches account entitlements for laxy-verify.
- *
- * The CLI asks /api/v1/cli-entitlement for the current plan and enabled automation flags.
- * Responses are cached briefly to avoid repeated network calls during a single run.
- * If the request fails or the user is not logged in, the CLI safely falls back to the unlocked verification defaults.
- */
-const auth_js_1 = require("./auth.js");
-const FREE_FEATURES = {
-    plan: "free",
-    // Automation features — not available without login
-    github_actions: false,
-    queue_priority: false,
-    parallel_execution: false,
-};
-let cache = null;
-const CACHE_TTL_MS = 5 * 60 * 1000;
-const PLAN_RANK = {
-    free: 0,
-    pro: 1,
-    team: 2,
-};
-function normalizePlan(plan) {
-    if (plan === "pro")
-        return "pro";
-    if (plan === "team")
-        return "team";
-    return "free";
-}
-function getPlanRank(plan) {
-    return PLAN_RANK[plan ?? "free"] ?? 0;
-}
-async function getEntitlements() {
-    if (cache && Date.now() - cache.fetchedAt < CACHE_TTL_MS) {
-        return cache.features;
-    }
-    const token = (0, auth_js_1.loadToken)();
-    if (!token)
-        return FREE_FEATURES;
-    try {
-        const res = await fetch(`${auth_js_1.LAXY_API_URL}/api/v1/cli-entitlement`, {
-            headers: { Authorization: `Bearer ${token}` },
-        });
-        if (!res.ok) {
-            if (res.status === 401) {
-                console.error("  Note: your CLI session is no longer valid. Run laxy-verify login again to refresh your account metadata.");
-            }
-            return FREE_FEATURES;
-        }
-        const features = (await res.json());
-        cache = { features, fetchedAt: Date.now() };
-        return features;
-    }
-    catch {
-        return FREE_FEATURES;
-    }
-}
-function applyPlanOverride(features, overridePlan) {
-    if (!overridePlan)
-        return features;
-    const isTeam = overridePlan === "team";
-    const isPro = overridePlan === "pro" || overridePlan === "team";
-    return {
-        ...features,
-        plan: overridePlan,
-        // All verification features run on every plan
-        // github_actions — Pro and Team
-        github_actions: isPro,
-        // queue_priority, parallel_execution — Team only
-        queue_priority: isTeam,
-        parallel_execution: isTeam,
-    };
-}
-function printPlanBanner(features) {
-    const planLabels = {
-        free: "Free",
-        pro: "Pro",
-        team: "Team",
-    };
-    const label = planLabels[features.plan] ?? features.plan;
-    if (features.plan !== "free") {
-        console.log(`  Plan: ${label}`);
-    }
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePlan = normalizePlan;
+exports.getEntitlements = getEntitlements;
+exports.applyPlanOverride = applyPlanOverride;
+exports.printPlanBanner = printPlanBanner;
+/**
+ * Fetches account entitlements for laxy-verify.
+ *
+ * The CLI asks /api/v1/cli-entitlement for the current plan and enabled automation flags.
+ * Responses are cached briefly to avoid repeated network calls during a single run.
+ * If the request fails or the user is not logged in, the CLI safely falls back to the unlocked verification defaults.
+ */
+const auth_js_1 = require("./auth.js");
+const FREE_FEATURES = {
+    plan: "free",
+    // Automation features — not available without login
+    github_actions: false,
+    queue_priority: false,
+    parallel_execution: false,
+    ai_failure_analysis: false,
+    compare_env: false,
+    share_result: false,
+    history_trend: false,
+};
+let cache = null;
+const CACHE_TTL_MS = 5 * 60 * 1000;
+const PLAN_RANK = {
+    free: 0,
+    pro: 1,
+    team: 2,
+};
+function normalizePlan(plan) {
+    if (plan === "pro")
+        return "pro";
+    if (plan === "team")
+        return "team";
+    return "free";
+}
+function getPlanRank(plan) {
+    return PLAN_RANK[plan ?? "free"] ?? 0;
+}
+async function getEntitlements() {
+    if (cache && Date.now() - cache.fetchedAt < CACHE_TTL_MS) {
+        return cache.features;
+    }
+    const token = (0, auth_js_1.loadToken)();
+    if (!token)
+        return FREE_FEATURES;
+    try {
+        const res = await fetch(`${auth_js_1.LAXY_API_URL}/api/v1/cli-entitlement`, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        if (!res.ok) {
+            if (res.status === 401) {
+                console.error("  Note: your CLI session is no longer valid. Run laxy-verify login again to refresh your account metadata.");
+            }
+            return FREE_FEATURES;
+        }
+        const features = (await res.json());
+        cache = { features, fetchedAt: Date.now() };
+        return features;
+    }
+    catch {
+        return FREE_FEATURES;
+    }
+}
+function applyPlanOverride(features, overridePlan) {
+    if (!overridePlan)
+        return features;
+    const isTeam = overridePlan === "team";
+    const isPro = overridePlan === "pro" || overridePlan === "team";
+    return {
+        ...features,
+        plan: overridePlan,
+        // All verification features run on every plan
+        // github_actions, ai_failure_analysis, compare_env, share_result, history_trend — Pro and Team
+        github_actions: isPro,
+        ai_failure_analysis: isPro,
+        compare_env: isPro,
+        share_result: isPro,
+        history_trend: isPro,
+        // queue_priority, parallel_execution — Team only
+        queue_priority: isTeam,
+        parallel_execution: isTeam,
+    };
+}
+function printPlanBanner(features) {
+    const planLabels = {
+        free: "Free",
+        pro: "Pro",
+        team: "Team",
+    };
+    const label = planLabels[features.plan] ?? features.plan;
+    if (features.plan !== "free") {
+        console.log(`  Plan: ${label}`);
+    }
+}

package/dist/init.js

@@ -1,81 +1,147 @@
-"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.runInit = runInit;
-const fs = __importStar(require("node:fs"));
-const path = __importStar(require("node:path"));
-const detect_js_1 = require("./detect.js");
-function runInit(dir) {
-    const laxyYmlPath = path.join(dir, ".laxy.yml");
-    const workflowDir = path.join(dir, ".github", "workflows");
-    const workflowPath = path.join(workflowDir, "laxy-verify.yml");
-    const gitignorePath = path.join(dir, ".gitignore");
-    if (fs.existsSync(laxyYmlPath)) {
-        console.log(".laxy.yml already exists. Skipping. Delete it to regenerate.");
-    }
-    else {
-        let detectedFramework = null;
-        let detectedPort = 3000;
-        try {
-            const detected = (0, detect_js_1.detect)(dir);
-            detectedFramework = detected.framework ?? "auto";
-            detectedPort = detected.port;
-        }
-        catch {
-            // Keep defaults when auto-detection fails.
-        }
+"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.runInit = runInit;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const detect_js_1 = require("./detect.js");
+const init_analysis_js_1 = require("./init-analysis.js");
+function renderStringList(items, indent = "  ") {
+    return items.map((item) => `${indent}- ${item}`).join("\n");
+}
+function renderScenarios() {
+    return `scenarios:
+  - name: "로그인 후 대시보드 접근"
+    steps:
+      - goto: /login
+      - fill: input[name=email]
+        with: test@example.com
+      - fill: input[name=password]
+        with: testpass123!
+      - click: button[type=submit]
+      - expect_visible: main`;
+}
+function runInit(dir) {
+    const laxyYmlPath = path.join(dir, ".laxy.yml");
+    const workflowDir = path.join(dir, ".github", "workflows");
+    const workflowPath = path.join(workflowDir, "laxy-verify.yml");
+    const gitignorePath = path.join(dir, ".gitignore");
+    if (fs.existsSync(laxyYmlPath)) {
+        console.log(".laxy.yml already exists. Skipping. Delete it to regenerate.");
+    }
+    else {
+        let detectedFramework = null;
+        let detectedPort = 3000;
+        const initAnalysis = (0, init_analysis_js_1.analyzeProjectForInit)(dir);
+        try {
+            const detected = (0, detect_js_1.detect)(dir);
+            detectedFramework = detected.framework ?? "auto";
+            detectedPort = detected.port;
+        }
+        catch {
+            // Keep defaults when auto-detection fails.
+        }
+        const extraRoutesBlock = initAnalysis.extraRoutes.length > 0
+            ? `extra_routes:\n${renderStringList(initAnalysis.extraRoutes)}\n\n`
+            : "";
+        const scenarioBlocks = initAnalysis.scenarios.length > 0
+            ? [
+                "scenarios:",
+                ...initAnalysis.scenarios.flatMap((scenario) => [
+                    `  - name: "${scenario.name.replace(/"/g, '\\"')}"`,
+                    "    steps:",
+                    ...scenario.steps.flatMap((step) => {
+                        if (step.goto)
+                            return [`      - goto: ${step.goto}`];
+                        if (step.fill && step.with !== undefined) {
+                            return [
+                                `      - fill: ${step.fill}`,
+                                `        with: ${step.with}`,
+                            ];
+                        }
+                        if (step.click)
+                            return [`      - click: ${step.click}`];
+                        if (step.expect_visible)
+                            return [`      - expect_visible: ${step.expect_visible}`];
+                        if (step.expect_text)
+                            return [`      - expect_text: ${step.expect_text}`];
+                        if (step.wait !== undefined)
+                            return [`      - wait: ${step.wait}`];
+                        return [];
+                    }),
+                ]),
+            ].join("\n")
+            : renderScenarios();
         const ymlContent = `# Generated by laxy-verify --init
 # See https://github.com/SUNgm24/Laxy/tree/main/laxy-verify for full docs
 framework: ${detectedFramework}   # auto-detected
 port: ${detectedPort}
 fail_on: bronze
+lighthouse_runs: 3
 
 thresholds:
   performance: 70
   accessibility: 85
   seo: 80
   best_practices: 80
-`;
-        fs.writeFileSync(laxyYmlPath, ymlContent, "utf-8");
-        console.log("Created .laxy.yml");
-    }
-    if (fs.existsSync(workflowPath)) {
-        console.log(".github/workflows/laxy-verify.yml already exists. Skipping.");
-    }
-    else {
-        fs.mkdirSync(workflowDir, { recursive: true });
+
+${extraRoutesBlock}visual_diff:
+  pixelmatch_threshold: 0.1
+  warn_threshold: 30
+  rollback_threshold: 60
+  disable_animations: true
+  ignore_selectors:
+    - "[data-dynamic]"
+    - "[data-ignore-diff]"
+
+${scenarioBlocks}
+`;
+        fs.writeFileSync(laxyYmlPath, ymlContent, "utf-8");
+        console.log("Created .laxy.yml");
+        if (initAnalysis.scenarios.length > 0) {
+            console.log(`Seeded ${initAnalysis.scenarios.length} draft E2E scenario(s) from your app structure.`);
+        }
+        if (initAnalysis.extraRoutes.length > 0) {
+            console.log(`Detected ${initAnalysis.extraRoutes.length} extra route(s) for SPA / multi-page coverage.`);
+        }
+    }
+    if (fs.existsSync(workflowPath)) {
+        console.log(".github/workflows/laxy-verify.yml already exists. Skipping.");
+    }
+    else {
+        fs.mkdirSync(workflowDir, { recursive: true });
         const workflowContent = `name: Laxy Verify
 on:
   pull_request:
@@ -132,23 +198,23 @@ jobs:
           path: .laxy-result.json
           retention-days: 30
           overwrite: true
-`;
-        fs.writeFileSync(workflowPath, workflowContent, "utf-8");
-        console.log("Created .github/workflows/laxy-verify.yml");
-    }
-    const gitignoreEntries = [".lighthouseci/", ".laxy-result.json"];
-    if (fs.existsSync(gitignorePath)) {
-        const existing = fs.readFileSync(gitignorePath, "utf-8");
-        const lines = existing.split("\n").map((line) => line.trim());
-        const missing = gitignoreEntries.filter((entry) => !lines.includes(entry));
-        if (missing.length > 0) {
-            fs.appendFileSync(gitignorePath, `${missing.join("\n")}\n`, "utf-8");
-            console.log(`Appended to .gitignore: ${missing.join(", ")}`);
-        }
-    }
-    else {
-        fs.writeFileSync(gitignorePath, `${gitignoreEntries.join("\n")}\n`, "utf-8");
-        console.log("Created .gitignore");
-    }
-    console.log("\n  Done. Run 'npx laxy-verify .' to verify your project.");
-}
+`;
+        fs.writeFileSync(workflowPath, workflowContent, "utf-8");
+        console.log("Created .github/workflows/laxy-verify.yml");
+    }
+    const gitignoreEntries = [".lighthouseci/", ".laxy-result.json"];
+    if (fs.existsSync(gitignorePath)) {
+        const existing = fs.readFileSync(gitignorePath, "utf-8");
+        const lines = existing.split("\n").map((line) => line.trim());
+        const missing = gitignoreEntries.filter((entry) => !lines.includes(entry));
+        if (missing.length > 0) {
+            fs.appendFileSync(gitignorePath, `${missing.join("\n")}\n`, "utf-8");
+            console.log(`Appended to .gitignore: ${missing.join(", ")}`);
+        }
+    }
+    else {
+        fs.writeFileSync(gitignorePath, `${gitignoreEntries.join("\n")}\n`, "utf-8");
+        console.log("Created .gitignore");
+    }
+    console.log("\n  Done. Run 'npx laxy-verify .' to verify your project.");
+}

package/dist/lighthouse.d.ts

@@ -1,7 +1,37 @@
-import type { LighthouseScores } from "./grade.js";
-interface LhResult {
-    scores: LighthouseScores | null;
-    errors: string[];
-}
-export declare function runLighthouse(port: number, runs: number): Promise<LhResult>;
-export {};
+import type { LighthouseScores } from "./grade.js";
+interface LhResult {
+    scores: LighthouseScores | null;
+    errors: string[];
+}
+export interface RouteScoreResult {
+    route: string;
+    scores: LighthouseScores | null;
+    errors: string[];
+}
+export interface MultiRouteLhResult {
+    /** Weighted average: root (/) = 2x weight, other routes = 1x */
+    aggregated: LighthouseScores | null;
+    perRoute: RouteScoreResult[];
+    /** True if every route that produced scores individually passed all thresholds */
+    allRoutesPass(thresholds: {
+        performance: number;
+        accessibility: number;
+        seo: number;
+        bestPractices: number;
+    }): boolean;
+}
+export declare function runLighthouse(port: number, runs: number, routePath?: string): Promise<LhResult>;
+/** Run Lighthouse against an arbitrary external URL (Pro: compare-env feature). */
+export declare function runLighthouseOnUrl(fullUrl: string, runs: number): Promise<LhResult>;
+/**
+ * Run Lighthouse on multiple routes and aggregate results.
+ *
+ * Aggregation strategy (weighted average):
+ *   - Root route "/" receives weight 2 (most visible page)
+ *   - All other routes receive weight 1
+ *
+ * Gold eligibility: every route must individually pass all thresholds.
+ * Silver/Bronze eligibility: based on the weighted-average aggregate score.
+ */
+export declare function runLighthouseOnRoutes(port: number, runs: number, routes: string[]): Promise<MultiRouteLhResult>;
+export {};