laxy-verify 1.2.0 → 1.2.2

package/README.md

@@ -63,23 +63,18 @@ This is most useful if you ship frontend apps and want a practical gate before:
 - QA handoff
 - production release
 
-## vs other tools
-
-No single competitor covers this combination. Here is where each tool stops:
-
-|  | laxy-verify | LHCI | Checkly | Percy / Argos | Unlighthouse | QA Wolf |
-|--|--|--|--|--|--|--|
-| Build failure detection | yes | no | no | no | no | no |
-| Auto-generated E2E | yes | no | write your own | no | no | yes |
-| Security audit | yes | no | no | no | no | no |
-| Lighthouse (multi-run avg) | yes | yes | no | no | yes | no |
-| Visual diff | yes | no | no | yes | no | no |
-| Multi-viewport checks | yes | no | separate config | no | yes | no |
-| Ship/hold release decision | yes | score only | no | no | no | no |
-| Zero config to start | yes | no | no | no | partial | no |
-| Free full coverage | yes | yes | limited | limited | yes | enterprise |
-
-LHCI gives you Lighthouse. Percy gives you visual diffs. Checkly watches your production uptime. None of them produce a merge or release decision from one command.
+## Why not just LHCI?
+
+|  | laxy-verify | LHCI | Checkly | Percy |
+|--|--|--|--|--|
+| Production build failure detection | Yes | No | No | No |
+| User-flow E2E verification | Yes | No | Manual setup | No |
+| Lighthouse scoring | Yes | Yes | No | No |
+| Visual regression check | Yes | No | No | Yes |
+| Release decision (`hold` / `client-ready`) | Yes | No, score only | No | No |
+| Zero-config local start | Yes | No | No | No |
+
+LHCI measures Lighthouse. `laxy-verify` is for deciding whether this frontend is actually safe to ship.
 
 ## The failures it is meant to catch
 

package/dist/audit/broken-links.d.ts

@@ -1,21 +1,21 @@
-/**
- * Broken-links audit.
- * Uses the crawl result to find all internal links, then validates each
- * with an HTTP HEAD/GET request. Links that return 4xx/5xx or timeout are
- * reported as blockers.
- */
-import { type CrawlResult } from "../crawler.js";
-export interface BrokenLink {
-    url: string;
-    path: string;
-    status: number;
-    statusText: string;
-    severity: "critical" | "high";
-}
-export interface BrokenLinksResult {
-    brokenLinks: BrokenLink[];
-    checkedCount: number;
-    hasBrokenLinks: boolean;
-    summary: string;
-}
-export declare function auditBrokenLinks(crawlResult: CrawlResult, baseUrl: string, abortSignal?: AbortSignal): Promise<BrokenLinksResult>;
+/**
+ * Broken-links audit.
+ * Uses the crawl result to find all internal links, then validates each
+ * with an HTTP HEAD/GET request. Links that return 4xx/5xx or timeout are
+ * reported as blockers.
+ */
+import { type CrawlResult } from "../crawler.js";
+export interface BrokenLink {
+    url: string;
+    path: string;
+    status: number;
+    statusText: string;
+    severity: "critical" | "high";
+}
+export interface BrokenLinksResult {
+    brokenLinks: BrokenLink[];
+    checkedCount: number;
+    hasBrokenLinks: boolean;
+    summary: string;
+}
+export declare function auditBrokenLinks(crawlResult: CrawlResult, baseUrl: string, abortSignal?: AbortSignal): Promise<BrokenLinksResult>;

package/dist/audit/broken-links.js

@@ -1,86 +1,86 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.auditBrokenLinks = auditBrokenLinks;
-const TIMEOUT_MS = 5000;
-const VALID_OK_STATUS = [200, 201, 202, 203, 204, 301, 302, 303, 307, 308];
-function isSuccessStatus(n) {
-    return VALID_OK_STATUS.includes(n);
-}
-async function auditBrokenLinks(crawlResult, baseUrl, abortSignal) {
-    const origin = new URL(baseUrl).origin;
-    const allUrls = [];
-    for (const page of crawlResult.pages) {
-        for (const href of page.internalLinks) {
-            try {
-                const url = new URL(href, baseUrl).href;
-                if (!allUrls.includes(url))
-                    allUrls.push(url);
-            }
-            catch {
-                // skip malformed URLs
-            }
-        }
-    }
-    const uniqueUrls = allUrls;
-    const brokenLinks = [];
-    await Promise.all(uniqueUrls.map(async (url) => {
-        if (abortSignal?.aborted)
-            return;
-        try {
-            const controller = new AbortController();
-            const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
-            let status = 0;
-            let statusText = "";
-            try {
-                const res = await fetch(url, {
-                    method: "HEAD",
-                    redirect: "follow",
-                    signal: controller.signal,
-                });
-                status = res.status;
-                statusText = res.statusText;
-            }
-            catch {
-                // Fall back to GET if HEAD is not allowed
-                const controller2 = new AbortController();
-                const timer2 = setTimeout(() => controller2.abort(), TIMEOUT_MS);
-                try {
-                    const res = await fetch(url, {
-                        method: "GET",
-                        redirect: "follow",
-                        signal: controller2.signal,
-                    });
-                    status = res.status;
-                    statusText = res.statusText;
-                }
-                catch {
-                    status = 0;
-                    statusText = "timeout or network error";
-                }
-                clearTimeout(timer2);
-            }
-            clearTimeout(timer);
-            if (!isSuccessStatus(status)) {
-                const severity = status >= 500 ? "critical" : "high";
-                let path = url;
-                try {
-                    path = new URL(url).pathname;
-                }
-                catch { }
-                brokenLinks.push({ url, path, status, statusText, severity });
-            }
-        }
-        catch {
-            // skip
-        }
-    }));
-    const summary = brokenLinks.length === 0
-        ? `All ${uniqueUrls.length} links OK`
-        : `${brokenLinks.length} broken link(s) found`;
-    return {
-        brokenLinks,
-        checkedCount: uniqueUrls.length,
-        hasBrokenLinks: brokenLinks.length > 0,
-        summary,
-    };
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auditBrokenLinks = auditBrokenLinks;
+const TIMEOUT_MS = 5000;
+const VALID_OK_STATUS = [200, 201, 202, 203, 204, 301, 302, 303, 307, 308];
+function isSuccessStatus(n) {
+    return VALID_OK_STATUS.includes(n);
+}
+async function auditBrokenLinks(crawlResult, baseUrl, abortSignal) {
+    const origin = new URL(baseUrl).origin;
+    const allUrls = [];
+    for (const page of crawlResult.pages) {
+        for (const href of page.internalLinks) {
+            try {
+                const url = new URL(href, baseUrl).href;
+                if (!allUrls.includes(url))
+                    allUrls.push(url);
+            }
+            catch {
+                // skip malformed URLs
+            }
+        }
+    }
+    const uniqueUrls = allUrls;
+    const brokenLinks = [];
+    await Promise.all(uniqueUrls.map(async (url) => {
+        if (abortSignal?.aborted)
+            return;
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+            let status = 0;
+            let statusText = "";
+            try {
+                const res = await fetch(url, {
+                    method: "HEAD",
+                    redirect: "follow",
+                    signal: controller.signal,
+                });
+                status = res.status;
+                statusText = res.statusText;
+            }
+            catch {
+                // Fall back to GET if HEAD is not allowed
+                const controller2 = new AbortController();
+                const timer2 = setTimeout(() => controller2.abort(), TIMEOUT_MS);
+                try {
+                    const res = await fetch(url, {
+                        method: "GET",
+                        redirect: "follow",
+                        signal: controller2.signal,
+                    });
+                    status = res.status;
+                    statusText = res.statusText;
+                }
+                catch {
+                    status = 0;
+                    statusText = "timeout or network error";
+                }
+                clearTimeout(timer2);
+            }
+            clearTimeout(timer);
+            if (!isSuccessStatus(status)) {
+                const severity = status >= 500 ? "critical" : "high";
+                let path = url;
+                try {
+                    path = new URL(url).pathname;
+                }
+                catch { }
+                brokenLinks.push({ url, path, status, statusText, severity });
+            }
+        }
+        catch {
+            // skip
+        }
+    }));
+    const summary = brokenLinks.length === 0
+        ? `All ${uniqueUrls.length} links OK`
+        : `${brokenLinks.length} broken link(s) found`;
+    return {
+        brokenLinks,
+        checkedCount: uniqueUrls.length,
+        hasBrokenLinks: brokenLinks.length > 0,
+        summary,
+    };
+}

package/dist/auth.d.ts

@@ -1,11 +1,11 @@
-export declare const LAXY_API_URL: string;
-export declare function loadToken(): string | null;
-export declare function saveToken(token: string, email: string, expiresInSec: number): void;
-export declare function clearToken(): void;
-export declare function whoami(): void;
-/**
- * Get or create a stable repo_id for the given project directory.
- * Stored in ~/.laxy/repos.json keyed by absolute project path.
- */
-export declare function getOrCreateRepoId(projectDir: string): string;
-export declare function login(emailArg?: string): Promise<void>;
+export declare const LAXY_API_URL: string;
+export declare function loadToken(): string | null;
+export declare function saveToken(token: string, email: string, expiresInSec: number): void;
+export declare function clearToken(): void;
+export declare function whoami(): void;
+/**
+ * Get or create a stable repo_id for the given project directory.
+ * Stored in ~/.laxy/repos.json keyed by absolute project path.
+ */
+export declare function getOrCreateRepoId(projectDir: string): string;
+export declare function login(emailArg?: string): Promise<void>;