uxinspect 0.2.0 → 0.11.0

package/dist/discord-formatter.js

@@ -0,0 +1,191 @@
+const COLOR_PASS = 0x10b981;
+const COLOR_FAIL = 0xef4444;
+const MAX_DESCRIPTION = 4096;
+const MAX_FIELD_VALUE = 1024;
+const MAX_FIELDS = 25;
+const MAX_EMBEDS = 10;
+const DEFAULT_USERNAME = 'uxinspect';
+const DEFAULT_TOP_FAILURES = 5;
+const ELLIPSIS = '…';
+const REQUEST_TIMEOUT_MS = 10_000;
+function truncate(value, max) {
+    if (value.length <= max)
+        return value;
+    if (max <= ELLIPSIS.length)
+        return value.slice(0, max);
+    return value.slice(0, max - ELLIPSIS.length) + ELLIPSIS;
+}
+function safeField(name, value, inline = true) {
+    return { name, value: truncate(value, MAX_FIELD_VALUE), inline };
+}
+function countA11yByImpact(result, impact) {
+    let n = 0;
+    for (const page of result.a11y ?? []) {
+        for (const v of page.violations) {
+            if (v.impact === impact)
+                n++;
+        }
+    }
+    return n;
+}
+function countBrokenLinks(result) {
+    let n = 0;
+    for (const r of result.links ?? [])
+        n += r.broken.length;
+    return n;
+}
+function countConsoleErrors(result) {
+    let n = 0;
+    for (const r of result.consoleErrors ?? []) {
+        for (const issue of r.issues) {
+            if (issue.type === 'error' ||
+                issue.type === 'pageerror' ||
+                issue.type === 'unhandledrejection') {
+                n++;
+            }
+        }
+    }
+    return n;
+}
+function firstPerfMetrics(result) {
+    const first = result.perf?.[0];
+    if (!first)
+        return { lcp: '—', cls: '—' };
+    const lcp = Number.isFinite(first.metrics.lcp) ? `${Math.round(first.metrics.lcp)}ms` : '—';
+    const cls = Number.isFinite(first.metrics.cls) ? first.metrics.cls.toFixed(3) : '—';
+    return { lcp, cls };
+}
+function collectFailureNames(result, limit) {
+    const names = [];
+    for (const flow of result.flows) {
+        if (!flow.passed)
+            names.push(`flow: ${flow.name}${flow.error ? ` — ${flow.error}` : ''}`);
+    }
+    for (const v of result.visual ?? []) {
+        if (!v.passed)
+            names.push(`visual: ${v.page} @ ${v.viewport} (${v.diffPixels}px)`);
+    }
+    for (const page of result.a11y ?? []) {
+        for (const v of page.violations) {
+            if (v.impact === 'critical' || v.impact === 'serious') {
+                names.push(`a11y[${v.impact}]: ${v.id} — ${v.help}`);
+            }
+        }
+    }
+    for (const r of result.links ?? []) {
+        for (const b of r.broken)
+            names.push(`link ${b.status}: ${b.url}`);
+    }
+    for (const b of result.budget ?? []) {
+        names.push(`budget ${b.category}/${b.metric}: ${b.message}`);
+    }
+    const seen = new Set();
+    const unique = [];
+    for (const n of names) {
+        if (seen.has(n))
+            continue;
+        seen.add(n);
+        unique.push(n);
+        if (unique.length >= limit)
+            break;
+    }
+    return unique;
+}
+function buildMainEmbed(result, opts) {
+    const passed = result.passed;
+    const totalFlows = result.flows.length;
+    const passedFlows = result.flows.filter((f) => f.passed).length;
+    const visualFails = (result.visual ?? []).filter((v) => !v.passed).length;
+    const critical = countA11yByImpact(result, 'critical');
+    const serious = countA11yByImpact(result, 'serious');
+    const broken = countBrokenLinks(result);
+    const consoleErrs = countConsoleErrors(result);
+    const { lcp, cls } = firstPerfMetrics(result);
+    const durSec = Math.max(0, Math.round(result.durationMs / 1000));
+    const title = `${passed ? '✓ Passed' : '✗ Failed'} — UX audit`;
+    const description = truncate(`${result.url}\nDuration: ${durSec}s`, MAX_DESCRIPTION);
+    const fields = [
+        safeField('Flows', `${passedFlows}/${totalFlows}`),
+        safeField('A11y criticals', String(critical)),
+        safeField('A11y serious', String(serious)),
+        safeField('Visual diffs', String(visualFails)),
+        safeField('LCP', lcp),
+        safeField('CLS', cls),
+        safeField('Broken links', String(broken)),
+        safeField('Console errors', String(consoleErrs)),
+        safeField('Duration', `${durSec}s`),
+    ].slice(0, MAX_FIELDS);
+    const embed = {
+        title,
+        description,
+        color: passed ? COLOR_PASS : COLOR_FAIL,
+        timestamp: result.finishedAt,
+        fields,
+        footer: { text: 'uxinspect' },
+    };
+    if (opts.reportUrl)
+        embed.url = opts.reportUrl;
+    return embed;
+}
+function buildFailuresEmbed(result, limit) {
+    const names = collectFailureNames(result, limit);
+    if (names.length === 0)
+        return undefined;
+    const body = names.map((n) => `• ${n}`).join('\n');
+    return {
+        title: 'Top failures',
+        description: truncate(body, MAX_DESCRIPTION),
+        color: COLOR_FAIL,
+    };
+}
+export function toDiscordEmbed(result, opts) {
+    const options = opts ?? {};
+    const username = options.username ?? DEFAULT_USERNAME;
+    const topN = options.includeTopFailures && options.includeTopFailures > 0
+        ? Math.floor(options.includeTopFailures)
+        : DEFAULT_TOP_FAILURES;
+    const embeds = [buildMainEmbed(result, options)];
+    if (!result.passed) {
+        const fail = buildFailuresEmbed(result, topN);
+        if (fail)
+            embeds.push(fail);
+    }
+    const status = result.passed ? 'PASS' : 'FAIL';
+    const durSec = Math.max(0, Math.round(result.durationMs / 1000));
+    const fallback = `uxinspect ${status} — ${result.url} · ${durSec}s`;
+    const mention = !result.passed && options.mentionOnFail ? ` ${options.mentionOnFail}` : '';
+    const content = truncate(`${fallback}${mention}`, 2000);
+    const payload = {
+        content,
+        username,
+        embeds: embeds.slice(0, MAX_EMBEDS),
+    };
+    return payload;
+}
+export async function postDiscordEmbed(webhookUrl, payload) {
+    try {
+        const res = await fetch(webhookUrl, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        const ok = res.status === 204 || (res.status >= 200 && res.status < 300);
+        if (ok)
+            return { ok: true, status: res.status };
+        let body = '';
+        try {
+            body = await res.text();
+        }
+        catch {
+            body = '';
+        }
+        const error = body ? `HTTP ${res.status}: ${truncate(body, 200)}` : `HTTP ${res.status}`;
+        return { ok: false, status: res.status, error };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, status: 0, error: `chat notification failed: ${message}` };
+    }
+}
+//# sourceMappingURL=discord-formatter.js.map

package/dist/discord-formatter.js.map

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

package/dist/dom-audit.d.ts

@@ -0,0 +1,23 @@
+import type { Page } from 'playwright';
+export interface DomAuditIssue {
+    type: 'too-many-nodes' | 'too-deep' | 'too-wide';
+    detail: string;
+}
+export interface DomAuditResult {
+    page: string;
+    totalNodes: number;
+    maxDepth: number;
+    maxChildrenOfAnyNode: number;
+    deepestPath?: string;
+    widestNodeSelector?: string;
+    shadowRoots: number;
+    iframes: number;
+    issues: DomAuditIssue[];
+    passed: boolean;
+}
+export declare function auditDomSize(page: Page, opts?: {
+    maxNodes?: number;
+    maxDepth?: number;
+    maxChildren?: number;
+}): Promise<DomAuditResult>;
+//# sourceMappingURL=dom-audit.d.ts.map

package/dist/dom-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-audit.d.ts","sourceRoot":"","sources":["../src/dom-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,gBAAgB,GAAG,UAAU,GAAG,UAAU,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB;AAYD,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE,OAAO,CAAC,cAAc,CAAC,CA4HzB"}

package/dist/dom-audit.js

@@ -0,0 +1,111 @@
+export async function auditDomSize(page, opts) {
+    const maxNodes = opts?.maxNodes ?? 1500;
+    const maxDepth = opts?.maxDepth ?? 32;
+    const maxChildren = opts?.maxChildren ?? 60;
+    const stats = await page.evaluate(() => {
+        const shortSelector = (el) => {
+            let s = el.tagName.toLowerCase();
+            if (el.id)
+                s += `#${el.id}`;
+            const firstClass = el.classList?.[0];
+            if (firstClass)
+                s += `.${firstClass}`;
+            return s;
+        };
+        const ancestorChain = (el, limit = 8) => {
+            const chain = [];
+            let cur = el;
+            while (cur && chain.length < limit) {
+                chain.unshift(shortSelector(cur));
+                cur = cur.parentElement;
+            }
+            return chain.join(' > ');
+        };
+        let totalNodes = 0;
+        let deepest = 0;
+        let deepestEl = null;
+        let widestCount = 0;
+        let widestEl = null;
+        let shadowRoots = 0;
+        let iframes = 0;
+        const root = document.documentElement;
+        if (!root) {
+            return {
+                totalNodes: 0,
+                maxDepth: 0,
+                maxChildrenOfAnyNode: 0,
+                shadowRoots: 0,
+                iframes: 0,
+            };
+        }
+        const stack = [{ el: root, depth: 1 }];
+        while (stack.length > 0) {
+            const frame = stack.pop();
+            if (!frame)
+                break;
+            const { el, depth } = frame;
+            totalNodes += 1;
+            if (depth > deepest) {
+                deepest = depth;
+                deepestEl = el;
+            }
+            const childCount = el.children.length;
+            if (childCount > widestCount) {
+                widestCount = childCount;
+                widestEl = el;
+            }
+            if (el.shadowRoot) {
+                shadowRoots += 1;
+            }
+            if (el.tagName === 'IFRAME') {
+                iframes += 1;
+            }
+            for (let i = childCount - 1; i >= 0; i--) {
+                const child = el.children[i];
+                if (child)
+                    stack.push({ el: child, depth: depth + 1 });
+            }
+        }
+        return {
+            totalNodes,
+            maxDepth: deepest,
+            maxChildrenOfAnyNode: widestCount,
+            deepestPath: deepestEl ? ancestorChain(deepestEl, 8) : undefined,
+            widestNodeSelector: widestEl ? shortSelector(widestEl) : undefined,
+            shadowRoots,
+            iframes,
+        };
+    });
+    const issues = [];
+    if (stats.totalNodes > maxNodes) {
+        issues.push({
+            type: 'too-many-nodes',
+            detail: `${stats.totalNodes} nodes exceeds limit ${maxNodes}`,
+        });
+    }
+    if (stats.maxDepth > maxDepth) {
+        issues.push({
+            type: 'too-deep',
+            detail: `depth ${stats.maxDepth} exceeds limit ${maxDepth}${stats.deepestPath ? ` at ${stats.deepestPath}` : ''}`,
+        });
+    }
+    if (stats.maxChildrenOfAnyNode > maxChildren) {
+        issues.push({
+            type: 'too-wide',
+            detail: `${stats.widestNodeSelector ?? 'element'} has ${stats.maxChildrenOfAnyNode} children, exceeds limit ${maxChildren}`,
+        });
+    }
+    return {
+        page: page.url(),
+        totalNodes: stats.totalNodes,
+        maxDepth: stats.maxDepth,
+        maxChildrenOfAnyNode: stats.maxChildrenOfAnyNode,
+        deepestPath: stats.deepestPath,
+        widestNodeSelector: stats.widestNodeSelector,
+        shadowRoots: stats.shadowRoots,
+        iframes: stats.iframes,
+        issues,
+        passed: issues.length === 0,
+    };
+}
+//# sourceMappingURL=dom-audit.js.map

package/dist/dom-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-audit.js","sourceRoot":"","sources":["../src/dom-audit.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAU,EACV,IAAqE;IAErE,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC;IAE5C,MAAM,KAAK,GAAa,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;QAC/C,MAAM,aAAa,GAAG,CAAC,EAAW,EAAU,EAAE;YAC5C,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,EAAE,CAAC,EAAE;gBAAE,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,UAAU;gBAAE,CAAC,IAAI,IAAI,UAAU,EAAE,CAAC;YACtC,OAAO,CAAC,CAAC;QACX,CAAC,CAAC;QAEF,MAAM,aAAa,GAAG,CAAC,EAAW,EAAE,KAAK,GAAG,CAAC,EAAU,EAAE;YACvD,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,GAAG,GAAmB,EAAE,CAAC;YAC7B,OAAO,GAAG,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;gBACnC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClC,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC;YAC1B,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC;QAEF,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,SAAS,GAAmB,IAAI,CAAC;QACrC,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,QAAQ,GAAmB,IAAI,CAAC;QACpC,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,MAAM,IAAI,GAAG,QAAQ,CAAC,eAAe,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,UAAU,EAAE,CAAC;gBACb,QAAQ,EAAE,CAAC;gBACX,oBAAoB,EAAE,CAAC;gBACvB,WAAW,EAAE,CAAC;gBACd,OAAO,EAAE,CAAC;aACC,CAAC;QAChB,CAAC;QAGD,MAAM,KAAK,GAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAEhD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK;gBAAE,MAAM;YAClB,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;YAE5B,UAAU,IAAI,CAAC,CAAC;YAEhB,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;gBACpB,OAAO,GAAG,KAAK,CAAC;gBAChB,SAAS,GAAG,EAAE,CAAC;YACjB,CAAC;YAED,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;YACtC,IAAI,UAAU,GAAG,WAAW,EAAE,CAAC;gBAC7B,WAAW,GAAG,UAAU,CAAC;gBACzB,QAAQ,GAAG,EAAE,CAAC;YAChB,CAAC;YAED,IAAK,EAAmD,CAAC,UAAU,EAAE,CAAC;gBACpE,WAAW,IAAI,CAAC,CAAC;YACnB,CAAC;YAED,IAAI,EAAE,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC,CAAC;YACf,CAAC;YAED,KAAK,IAAI,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzC,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC7B,IAAI,KAAK;oBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,OAAO;YACL,UAAU;YACV,QAAQ,EAAE,OAAO;YACjB,oBAAoB,EAAE,WAAW;YACjC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;YAChE,kBAAkB,EAAE,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;YAClE,WAAW;YACX,OAAO;SACR,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,IAAI,KAAK,CAAC,UAAU,GAAG,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,GAAG,KAAK,CAAC,UAAU,wBAAwB,QAAQ,EAAE;SAC9D,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,SAAS,KAAK,CAAC,QAAQ,kBAAkB,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;SAClH,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,oBAAoB,GAAG,WAAW,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,GAAG,KAAK,CAAC,kBAAkB,IAAI,SAAS,QAAQ,KAAK,CAAC,oBAAoB,4BAA4B,WAAW,EAAE;SAC5H,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;QAChB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM;QACN,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,IAAI,EAEV,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,YAAY,EAAE,SAAS,EAAE,CAAC;CAC1C;AAoBD,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,IAAI,CAAqB;IAE3B,MAAM,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyD/C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,IAAI,GAAG,IAAI;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,cAAc,CAAA;KAAE,CAEzD;CACF;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;CAK1B,CAAC"}
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,IAAI,EAEV,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,YAAY,EAAE,SAAS,EAAE,CAAC;CAC1C;AAoBD,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,IAAI,CAAqB;IAE3B,MAAM,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmE/C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,IAAI,GAAG,IAAI;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,cAAc,CAAA;KAAE,CAEzD;CACF;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;CAK1B,CAAC"}

package/dist/driver.js

@@ -47,6 +47,16 @@ export class Driver {
             Object.assign(ctxOpts, devices[opts.device]);
         }
         this.context = await this.browser.newContext(ctxOpts);
+        // Stub for esbuild/tsx `--keep-names` helper. When this library is loaded
+        // via tsx (unbundled), esbuild wraps inner function expressions with
+        // `__name(fn, 'name')`. That helper is not defined in the page context and
+        // would crash every `page.evaluate` callback that declares named helpers.
+        // Injecting a pass-through makes the identifier resolve harmlessly.
+        await this.context.addInitScript(() => {
+            const g = globalThis;
+            if (typeof g.__name !== 'function')
+                g.__name = (fn) => fn;
+        });
         if (opts.trace) {
             await this.context.tracing.start({ screenshots: true, snapshots: true, sources: true });
         }

package/dist/driver.js.map

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

package/dist/error-page-audit.d.ts

@@ -0,0 +1,26 @@
+import type { BrowserContext } from 'playwright';
+export interface ErrorPageCheck {
+    probedUrl: string;
+    expectedKind: '404' | '500';
+    actualStatus: number;
+    hasBranding: boolean;
+    hasHomeLink: boolean;
+    hasSearch: boolean;
+    hasNavigation: boolean;
+    byteSize: number;
+    wordCount: number;
+    isSoftError: boolean;
+}
+export interface ErrorPageIssue {
+    kind: 'soft-404' | 'generic-error-page' | 'no-home-link' | 'no-search' | 'missing-error-page' | 'wrong-status';
+    probedUrl: string;
+    message: string;
+}
+export interface ErrorPageAuditResult {
+    origin: string;
+    checks: ErrorPageCheck[];
+    issues: ErrorPageIssue[];
+    passed: boolean;
+}
+export declare function auditErrorPages(ctx: BrowserContext, originUrl: string): Promise<ErrorPageAuditResult>;
+//# sourceMappingURL=error-page-audit.d.ts.map

package/dist/error-page-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-page-audit.d.ts","sourceRoot":"","sources":["../src/error-page-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,KAAK,GAAG,KAAK,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EACA,UAAU,GACV,oBAAoB,GACpB,cAAc,GACd,WAAW,GACX,oBAAoB,GACpB,cAAc,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;CACjB;AAuPD,wBAAsB,eAAe,CACnC,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC,CAe/B"}

package/dist/error-page-audit.js

@@ -0,0 +1,219 @@
+const NAV_TIMEOUT_MS = 15_000;
+const SOFT_404_WORD_THRESHOLD = 500;
+const FATAL_ISSUE_KINDS = new Set([
+    'soft-404',
+    'wrong-status',
+    'missing-error-page',
+]);
+function randomToken() {
+    const now = Date.now().toString(36);
+    const rand = Math.random().toString(36).slice(2, 10);
+    return `${now}-${rand}`;
+}
+function normalizeOrigin(originUrl) {
+    try {
+        const u = new URL(originUrl);
+        return `${u.protocol}//${u.host}`;
+    }
+    catch {
+        return originUrl.replace(/\/+$/, '');
+    }
+}
+function buildProbes(origin) {
+    const base = normalizeOrigin(origin);
+    const token = randomToken();
+    return [
+        { url: `${base}/uxinspect-nonexistent-${token}`, expectedKind: '404' },
+        { url: `${base}/does-not-exist-xyz-abc`, expectedKind: '404' },
+        { url: `${base}/uxinspect-trigger-500?x=${token}`, expectedKind: '500' },
+    ];
+}
+async function collectSignals(page) {
+    return await page.evaluate(() => {
+        const hasLogoImg = document.querySelector('img[alt*="logo" i]') !== null;
+        const iconLink = document.querySelector('link[rel="icon"], link[rel="shortcut icon"], link[rel="apple-touch-icon"]');
+        let iconHasHref = false;
+        if (iconLink instanceof HTMLLinkElement) {
+            iconHasHref = iconLink.getAttribute('href') !== null && iconLink.getAttribute('href').trim().length > 0;
+        }
+        const hasBranding = hasLogoImg || iconHasHref;
+        const homeLink = document.querySelector('a[href="/"]') !== null ||
+            document.querySelector('a[href="/home"]') !== null;
+        const hasSearch = document.querySelector('input[type="search"]') !== null ||
+            document.querySelector('form[role="search"]') !== null;
+        const hasNavigation = document.querySelector('nav') !== null ||
+            document.querySelector('[role="navigation"]') !== null;
+        const body = document.body;
+        const raw = body ? (body.innerText ?? '') : '';
+        const trimmed = raw.trim();
+        const words = trimmed.length === 0 ? 0 : trimmed.split(/\s+/).length;
+        return {
+            hasBranding,
+            hasHomeLink: homeLink,
+            hasSearch,
+            hasNavigation,
+            wordCount: words,
+            bodyText: trimmed,
+        };
+    });
+}
+function looksLikeErrorText(text) {
+    const lower = text.toLowerCase();
+    if (lower.includes('404'))
+        return true;
+    if (lower.includes('not found'))
+        return true;
+    return false;
+}
+async function measureByteSize(response) {
+    if (!response)
+        return 0;
+    try {
+        const body = await response.body();
+        return body.byteLength;
+    }
+    catch {
+        return 0;
+    }
+}
+function buildFailedCheck(spec) {
+    return {
+        probedUrl: spec.url,
+        expectedKind: spec.expectedKind,
+        actualStatus: 0,
+        hasBranding: false,
+        hasHomeLink: false,
+        hasSearch: false,
+        hasNavigation: false,
+        byteSize: 0,
+        wordCount: 0,
+        isSoftError: false,
+    };
+}
+async function closeQuietly(page) {
+    try {
+        await page.close();
+    }
+    catch {
+        /* ignore */
+    }
+}
+async function probeOne(ctx, spec) {
+    const issues = [];
+    let page;
+    try {
+        page = await ctx.newPage();
+    }
+    catch {
+        issues.push({
+            kind: 'missing-error-page',
+            probedUrl: spec.url,
+            message: 'failed to open probe page in browser context',
+        });
+        return { check: buildFailedCheck(spec), issues };
+    }
+    let response = null;
+    let navError = null;
+    try {
+        response = await page.goto(spec.url, {
+            waitUntil: 'domcontentloaded',
+            timeout: NAV_TIMEOUT_MS,
+        });
+    }
+    catch (err) {
+        navError = err instanceof Error ? err.message : 'navigation failed';
+    }
+    if (!response || navError) {
+        issues.push({
+            kind: 'missing-error-page',
+            probedUrl: spec.url,
+            message: navError ?? 'no response received',
+        });
+        await closeQuietly(page);
+        return { check: buildFailedCheck(spec), issues };
+    }
+    const actualStatus = response.status();
+    const byteSize = await measureByteSize(response);
+    let signals;
+    try {
+        signals = await collectSignals(page);
+    }
+    catch {
+        signals = {
+            hasBranding: false,
+            hasHomeLink: false,
+            hasSearch: false,
+            hasNavigation: false,
+            wordCount: 0,
+            bodyText: '',
+        };
+    }
+    const bodyLooksLikeError = looksLikeErrorText(signals.bodyText);
+    const isSoftError = spec.expectedKind === '404' &&
+        actualStatus === 200 &&
+        signals.wordCount < SOFT_404_WORD_THRESHOLD;
+    if (spec.expectedKind === '404' && actualStatus === 200 && bodyLooksLikeError) {
+        issues.push({
+            kind: 'wrong-status',
+            probedUrl: spec.url,
+            message: `page body looks like an error (contains "404"/"not found") but server returned 200`,
+        });
+    }
+    if (isSoftError) {
+        issues.push({
+            kind: 'soft-404',
+            probedUrl: spec.url,
+            message: `expected 404 but got 200 with only ${signals.wordCount} words — likely a soft 404`,
+        });
+    }
+    if (!signals.hasBranding) {
+        issues.push({
+            kind: 'generic-error-page',
+            probedUrl: spec.url,
+            message: 'no logo image or icon link detected — page looks generic/unbranded',
+        });
+    }
+    if (!signals.hasHomeLink) {
+        issues.push({
+            kind: 'no-home-link',
+            probedUrl: spec.url,
+            message: 'no <a href="/"> or <a href="/home"> link found',
+        });
+    }
+    if (!signals.hasSearch) {
+        issues.push({
+            kind: 'no-search',
+            probedUrl: spec.url,
+            message: 'no search input or search form detected (advisory)',
+        });
+    }
+    const check = {
+        probedUrl: spec.url,
+        expectedKind: spec.expectedKind,
+        actualStatus,
+        hasBranding: signals.hasBranding,
+        hasHomeLink: signals.hasHomeLink,
+        hasSearch: signals.hasSearch,
+        hasNavigation: signals.hasNavigation,
+        byteSize,
+        wordCount: signals.wordCount,
+        isSoftError,
+    };
+    await closeQuietly(page);
+    return { check, issues };
+}
+export async function auditErrorPages(ctx, originUrl) {
+    const origin = normalizeOrigin(originUrl);
+    const probes = buildProbes(origin);
+    const checks = [];
+    const issues = [];
+    for (const spec of probes) {
+        const { check, issues: probeIssues } = await probeOne(ctx, spec);
+        checks.push(check);
+        for (const issue of probeIssues)
+            issues.push(issue);
+    }
+    const passed = !issues.some((i) => FATAL_ISSUE_KINDS.has(i.kind));
+    return { origin, checks, issues, passed };
+}
+//# sourceMappingURL=error-page-audit.js.map