uxinspect 0.2.0 → 0.11.0

package/dist/web-worker-audit.js

@@ -0,0 +1,324 @@
+const LONG_TASK_RTT_MS = 200;
+const MODULE_ADVISE_BYTES = 10 * 1024;
+const BURST_THRESHOLD_PER_SEC = 20;
+const DEFAULT_DURATION_MS = 3000;
+const DEFAULT_MAX_WORKERS = 8;
+const RTT_TIMEOUT_MS = 500;
+export async function auditWebWorkers(page, opts = {}) {
+    const durationMs = opts.durationMs ?? DEFAULT_DURATION_MS;
+    const maxWorkers = opts.maxWorkers ?? DEFAULT_MAX_WORKERS;
+    const pageUrl = page.url();
+    const issues = [];
+    await page.addInitScript(() => {
+        const w = window;
+        if (w.__uxi_web_worker_audit)
+            return;
+        const state = {
+            sharedWorkers: [],
+            postMessages: [],
+            classicWorkers: [],
+            moduleWorkers: [],
+        };
+        w.__uxi_web_worker_audit = state;
+        try {
+            const OriginalWorker = window.Worker;
+            if (OriginalWorker) {
+                const patched = function PatchedWorker(scriptURL, options) {
+                    const href = typeof scriptURL === 'string'
+                        ? scriptURL
+                        : scriptURL && typeof scriptURL.toString === 'function'
+                            ? scriptURL.toString()
+                            : '';
+                    try {
+                        if (options && options.type === 'module')
+                            state.moduleWorkers.push(href);
+                        else
+                            state.classicWorkers.push(href);
+                    }
+                    catch {
+                        /* ignore tracking errors */
+                    }
+                    const instance = new OriginalWorker(scriptURL, options);
+                    try {
+                        const origPost = instance.postMessage.bind(instance);
+                        instance.postMessage = function trackedPostMessage(msg, transferOrOptions) {
+                            try {
+                                state.postMessages.push({ url: href, at: Date.now() });
+                            }
+                            catch {
+                                /* ignore */
+                            }
+                            if (Array.isArray(transferOrOptions)) {
+                                return origPost(msg, transferOrOptions);
+                            }
+                            if (transferOrOptions) {
+                                return origPost(msg, transferOrOptions);
+                            }
+                            return origPost(msg);
+                        };
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                    return instance;
+                };
+                patched.prototype = OriginalWorker.prototype;
+                window.Worker = patched;
+            }
+        }
+        catch {
+            /* ignore Worker patch failure */
+        }
+        try {
+            const OriginalShared = window
+                .SharedWorker;
+            if (OriginalShared) {
+                const patchedShared = function PatchedSharedWorker(scriptURL, options) {
+                    const href = typeof scriptURL === 'string'
+                        ? scriptURL
+                        : scriptURL && typeof scriptURL.toString === 'function'
+                            ? scriptURL.toString()
+                            : '';
+                    try {
+                        state.sharedWorkers.push({ url: href, createdAt: Date.now() });
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                    return new OriginalShared(scriptURL, options);
+                };
+                patchedShared.prototype = OriginalShared.prototype;
+                window.SharedWorker = patchedShared;
+            }
+        }
+        catch {
+            /* ignore SharedWorker patch failure */
+        }
+    });
+    const tracking = new Map();
+    const attachListeners = (worker) => {
+        if (tracking.has(worker))
+            return;
+        const entry = {
+            worker,
+            url: worker.url(),
+            messageCount: 0,
+            errorCount: 0,
+            alive: true,
+        };
+        tracking.set(worker, entry);
+        const onConsole = (msg) => {
+            entry.messageCount++;
+            if (msg.type() === 'error')
+                entry.errorCount++;
+        };
+        const onClose = () => {
+            entry.alive = false;
+        };
+        try {
+            worker.on('console', onConsole);
+            worker.on('close', onClose);
+        }
+        catch {
+            /* older Playwright may not surface these */
+        }
+    };
+    for (const existing of page.workers())
+        attachListeners(existing);
+    const onNewWorker = (worker) => attachListeners(worker);
+    page.on('worker', onNewWorker);
+    const pageErrors = [];
+    const onPageError = (err) => {
+        pageErrors.push({ message: err.message, stack: err.stack });
+    };
+    page.on('pageerror', onPageError);
+    await page.waitForTimeout(durationMs);
+    page.off('worker', onNewWorker);
+    page.off('pageerror', onPageError);
+    const injected = await page
+        .evaluate(() => {
+        const w = window;
+        return w.__uxi_web_worker_audit
+            ? {
+                sharedWorkers: w.__uxi_web_worker_audit.sharedWorkers.slice(),
+                postMessages: w.__uxi_web_worker_audit.postMessages.slice(),
+                classicWorkers: w.__uxi_web_worker_audit.classicWorkers.slice(),
+                moduleWorkers: w.__uxi_web_worker_audit.moduleWorkers.slice(),
+            }
+            : null;
+    })
+        .catch(() => null);
+    const serviceWorkers = await page
+        .evaluate(async () => {
+        const out = [];
+        const nav = navigator;
+        if (!nav.serviceWorker || !nav.serviceWorker.getRegistrations)
+            return out;
+        try {
+            const regs = await nav.serviceWorker.getRegistrations();
+            for (const reg of regs) {
+                const sw = reg.active || reg.installing || reg.waiting;
+                if (!sw)
+                    continue;
+                out.push({
+                    scriptURL: sw.scriptURL,
+                    scope: reg.scope,
+                    state: sw.state,
+                });
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        return out;
+    })
+        .catch(() => []);
+    const entries = [];
+    const classicUrls = new Set(injected?.classicWorkers ?? []);
+    const moduleUrls = new Set(injected?.moduleWorkers ?? []);
+    const postMessageByUrl = new Map();
+    if (injected) {
+        for (const pm of injected.postMessages) {
+            postMessageByUrl.set(pm.url, (postMessageByUrl.get(pm.url) ?? 0) + 1);
+        }
+    }
+    for (const [, tracked] of tracking) {
+        const url = tracked.url;
+        const postCount = postMessageByUrl.get(url) ?? 0;
+        let sizeBytes;
+        if (/^https?:/i.test(url)) {
+            try {
+                const res = await page.request.get(url, { failOnStatusCode: false });
+                if (res.status() >= 400) {
+                    issues.push({
+                        kind: 'worker-fetch-failed',
+                        worker: url,
+                        message: `worker script fetch returned ${res.status()}`,
+                    });
+                }
+                else {
+                    try {
+                        const body = await res.body();
+                        sizeBytes = body.byteLength;
+                    }
+                    catch {
+                        sizeBytes = undefined;
+                    }
+                }
+            }
+            catch {
+                /* network failure — skip */
+            }
+        }
+        entries.push({
+            url,
+            kind: 'worker',
+            active: tracked.alive,
+            sizeBytes,
+            messageCount: tracked.messageCount + postCount,
+            errorCount: tracked.errorCount,
+        });
+        if (tracked.errorCount > 0) {
+            issues.push({
+                kind: 'worker-error',
+                worker: url,
+                message: `worker logged ${tracked.errorCount} console error(s)`,
+            });
+        }
+        if (classicUrls.has(url) &&
+            !moduleUrls.has(url) &&
+            typeof sizeBytes === 'number' &&
+            sizeBytes > MODULE_ADVISE_BYTES) {
+            issues.push({
+                kind: 'no-module-worker',
+                worker: url,
+                message: `classic worker ${sizeBytes} bytes — consider { type: 'module' }`,
+            });
+        }
+        if (durationMs > 0 && postCount / (durationMs / 1000) > BURST_THRESHOLD_PER_SEC) {
+            issues.push({
+                kind: 'worker-blocking-main',
+                worker: url,
+                message: `postMessage burst ${Math.round(postCount / (durationMs / 1000))}/s exceeds ${BURST_THRESHOLD_PER_SEC}/s`,
+            });
+        }
+        if (tracked.alive) {
+            const drift = await measureRoundTripDrift(tracked.worker);
+            if (drift !== null && drift > LONG_TASK_RTT_MS) {
+                issues.push({
+                    kind: 'long-running-worker',
+                    worker: url,
+                    message: `worker roundtrip ${Math.round(drift)}ms > ${LONG_TASK_RTT_MS}ms threshold`,
+                });
+            }
+        }
+    }
+    if (injected) {
+        for (const sw of injected.sharedWorkers) {
+            entries.push({
+                url: sw.url,
+                kind: 'shared-worker',
+                active: true,
+                messageCount: 0,
+                errorCount: 0,
+            });
+        }
+    }
+    for (const sw of serviceWorkers) {
+        entries.push({
+            url: sw.scriptURL,
+            kind: 'service-worker',
+            scope: sw.scope,
+            active: sw.state === 'activated' || sw.state === 'activating',
+            messageCount: 0,
+            errorCount: 0,
+        });
+    }
+    for (const err of pageErrors) {
+        const match = entries.find((e) => e.kind === 'worker' && typeof err.stack === 'string' && err.stack.includes(e.url));
+        if (match) {
+            match.errorCount++;
+            issues.push({
+                kind: 'worker-error',
+                worker: match.url,
+                message: err.message,
+            });
+        }
+    }
+    if (entries.length > maxWorkers) {
+        issues.push({
+            kind: 'too-many-workers',
+            worker: pageUrl,
+            message: `${entries.length} workers exceeds max of ${maxWorkers}`,
+        });
+    }
+    return {
+        page: pageUrl,
+        workers: entries,
+        issues,
+        passed: issues.length === 0,
+    };
+}
+async function measureRoundTripDrift(worker) {
+    try {
+        const result = await Promise.race([
+            worker.evaluate(() => {
+                const start = performance.now();
+                return performance.now() - start;
+            }),
+            new Promise((resolve) => {
+                setTimeout(() => resolve(null), RTT_TIMEOUT_MS);
+            }),
+        ]);
+        if (result === null)
+            return RTT_TIMEOUT_MS + 1;
+        const wallStart = Date.now();
+        await worker.evaluate(() => 1);
+        const wallEnd = Date.now();
+        return wallEnd - wallStart;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=web-worker-audit.js.map

package/dist/web-worker-audit.js.map

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

package/dist/webfonts.d.ts

@@ -0,0 +1,26 @@
+import type { Page } from 'playwright';
+export interface WebfontEntry {
+    family: string;
+    url?: string;
+    format?: string;
+    source: 'google' | 'adobe' | 'self-hosted' | 'system' | 'other';
+    size?: number;
+    loadDurationMs?: number;
+    fontDisplay?: string;
+    preloaded: boolean;
+}
+export interface WebfontIssue {
+    type: 'missing-font-display' | 'too-many-fonts' | 'no-preload-critical-font' | 'large-font-file' | 'using-google-fonts-css';
+    target?: string;
+    detail: string;
+}
+export interface WebfontsResult {
+    page: string;
+    fonts: WebfontEntry[];
+    totalFontBytes: number;
+    totalFontsLoaded: number;
+    issues: WebfontIssue[];
+    passed: boolean;
+}
+export declare function auditWebfonts(page: Page): Promise<WebfontsResult>;
+//# sourceMappingURL=webfonts.d.ts.map

package/dist/webfonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webfonts.d.ts","sourceRoot":"","sources":["../src/webfonts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EACA,sBAAsB,GACtB,gBAAgB,GAChB,0BAA0B,GAC1B,iBAAiB,GACjB,wBAAwB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,CA0RvE"}

package/dist/webfonts.js

@@ -0,0 +1,244 @@
+export async function auditWebfonts(page) {
+    const url = page.url();
+    const { fonts, googleFontsCssLinks } = await page.evaluate(() => {
+        function hostnameOf(u) {
+            try {
+                return new URL(u, window.location.href).hostname;
+            }
+            catch {
+                return '';
+            }
+        }
+        function categorize(u) {
+            if (!u)
+                return 'system';
+            const host = hostnameOf(u);
+            if (!host)
+                return 'other';
+            if (host === 'fonts.googleapis.com' || host === 'fonts.gstatic.com')
+                return 'google';
+            if (host === 'use.typekit.net' ||
+                host === 'use.fontawesome.com' ||
+                host.endsWith('typekit.net') ||
+                host.includes('adobe'))
+                return 'adobe';
+            if (host === window.location.hostname)
+                return 'self-hosted';
+            return 'other';
+        }
+        function extractUrl(src) {
+            if (!src)
+                return undefined;
+            const m = src.match(/url\(\s*(['"]?)([^'")]+)\1\s*\)/);
+            return m ? m[2] : undefined;
+        }
+        function extractFormat(src) {
+            if (!src)
+                return undefined;
+            const m = src.match(/format\(\s*(['"]?)([^'")]+)\1\s*\)/);
+            return m ? m[2] : undefined;
+        }
+        // Preloaded font URLs
+        const preloaded = new Set();
+        const preloadLinks = Array.from(document.querySelectorAll('link[rel="preload"][as="font"]'));
+        for (const link of preloadLinks) {
+            const href = link.href;
+            if (href)
+                preloaded.add(href);
+        }
+        // Google Fonts CSS links (render-blocking)
+        const googleFontsCssLinks = [];
+        const allLinks = Array.from(document.querySelectorAll('link[href]'));
+        for (const link of allLinks) {
+            const href = link.href;
+            if (href && href.includes('fonts.googleapis.com')) {
+                googleFontsCssLinks.push(href);
+            }
+        }
+        const faces = [];
+        const sheets = Array.from(document.styleSheets);
+        for (const sheet of sheets) {
+            let rules = null;
+            try {
+                rules = sheet.cssRules;
+            }
+            catch {
+                // CORS-blocked stylesheet
+                continue;
+            }
+            if (!rules)
+                continue;
+            for (const rule of Array.from(rules)) {
+                if (rule.constructor.name === 'CSSFontFaceRule' || rule.type === 5) {
+                    const style = rule.style;
+                    const rawFamily = style.getPropertyValue('font-family').trim().replace(/^['"]|['"]$/g, '');
+                    const src = style.getPropertyValue('src');
+                    const display = style.getPropertyValue('font-display').trim() || undefined;
+                    faces.push({
+                        family: rawFamily,
+                        url: extractUrl(src),
+                        format: extractFormat(src),
+                        fontDisplay: display,
+                    });
+                }
+            }
+        }
+        // FontFaceSet iteration
+        const loaded = [];
+        try {
+            const fs = document.fonts;
+            if (fs) {
+                fs.forEach((ff) => {
+                    loaded.push({
+                        family: (ff.family || '').replace(/^['"]|['"]$/g, ''),
+                        display: ff.display,
+                        status: ff.status,
+                    });
+                });
+            }
+        }
+        catch {
+            // ignore
+        }
+        const resources = [];
+        try {
+            const entries = performance.getEntriesByType('resource');
+            for (const e of entries) {
+                const isFontFile = /\.(woff2?|ttf|otf|eot)(\?|#|$)/i.test(e.name);
+                const fromCss = e.initiatorType === 'css';
+                if (isFontFile || fromCss) {
+                    resources.push({
+                        name: e.name,
+                        transferSize: e.transferSize,
+                        duration: e.duration,
+                        initiatorType: e.initiatorType,
+                    });
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+        const merged = [];
+        const seenUrls = new Set();
+        for (const face of faces) {
+            const entry = {
+                family: face.family,
+                url: face.url,
+                format: face.format,
+                source: categorize(face.url),
+                fontDisplay: face.fontDisplay,
+                preloaded: false,
+            };
+            if (face.url) {
+                const absolute = (() => {
+                    try {
+                        return new URL(face.url, window.location.href).href;
+                    }
+                    catch {
+                        return face.url;
+                    }
+                })();
+                entry.preloaded = preloaded.has(absolute);
+                const res = resources.find(r => r.name === absolute || r.name.endsWith(face.url));
+                if (res) {
+                    entry.size = res.transferSize;
+                    entry.loadDurationMs = Math.round(res.duration);
+                }
+                seenUrls.add(absolute);
+            }
+            merged.push(entry);
+        }
+        // Add any font resource not covered by @font-face (CORS-blocked stylesheets)
+        for (const res of resources) {
+            if (!/\.(woff2?|ttf|otf|eot)(\?|#|$)/i.test(res.name))
+                continue;
+            if (seenUrls.has(res.name))
+                continue;
+            const matchedFace = loaded.find(l => l.family);
+            merged.push({
+                family: matchedFace?.family || 'unknown',
+                url: res.name,
+                format: (res.name.match(/\.(woff2?|ttf|otf|eot)/i)?.[1] || undefined)?.toLowerCase(),
+                source: categorize(res.name),
+                size: res.transferSize,
+                loadDurationMs: Math.round(res.duration),
+                fontDisplay: matchedFace?.display,
+                preloaded: preloaded.has(res.name),
+            });
+            seenUrls.add(res.name);
+        }
+        // Also include FontFaceSet-only families that have no @font-face match (system or API-added)
+        for (const l of loaded) {
+            if (!l.family)
+                continue;
+            const exists = merged.some(m => m.family.toLowerCase() === l.family.toLowerCase());
+            if (!exists) {
+                merged.push({
+                    family: l.family,
+                    source: 'system',
+                    fontDisplay: l.display,
+                    preloaded: false,
+                });
+            }
+        }
+        return { fonts: merged, googleFontsCssLinks };
+    });
+    // Build issues
+    const issues = [];
+    for (const f of fonts) {
+        if (f.url && (!f.fontDisplay || f.fontDisplay === 'auto' || f.fontDisplay === 'block')) {
+            issues.push({
+                type: 'missing-font-display',
+                target: f.url || f.family,
+                detail: `Font "${f.family}" has font-display: ${f.fontDisplay || 'not set'} (use swap, fallback, or optional)`,
+            });
+        }
+        if (typeof f.size === 'number' && f.size > 100 * 1024) {
+            issues.push({
+                type: 'large-font-file',
+                target: f.url || f.family,
+                detail: `Font file is ${Math.round(f.size / 1024)}KB (>100KB)`,
+            });
+        }
+        if (f.url &&
+            !f.preloaded &&
+            typeof f.loadDurationMs === 'number' &&
+            f.loadDurationMs > 0 &&
+            // approximate "critical / above-the-fold" = loaded in first 1000ms
+            f.loadDurationMs <= 1000) {
+            issues.push({
+                type: 'no-preload-critical-font',
+                target: f.url,
+                detail: `Critical font "${f.family}" loaded quickly but is not preloaded`,
+            });
+        }
+    }
+    const distinctFontFiles = new Set(fonts.filter(f => f.url).map(f => f.url));
+    if (distinctFontFiles.size > 4) {
+        issues.push({
+            type: 'too-many-fonts',
+            detail: `${distinctFontFiles.size} distinct font files loaded (>4)`,
+        });
+    }
+    if (googleFontsCssLinks.length > 0) {
+        for (const href of googleFontsCssLinks) {
+            issues.push({
+                type: 'using-google-fonts-css',
+                target: href,
+                detail: 'Google Fonts CSS link is render-blocking; self-host or use preconnect + font-display: swap',
+            });
+        }
+    }
+    const totalFontBytes = fonts.reduce((sum, f) => sum + (typeof f.size === 'number' ? f.size : 0), 0);
+    const totalFontsLoaded = fonts.filter(f => f.url).length;
+    return {
+        page: url,
+        fonts,
+        totalFontBytes,
+        totalFontsLoaded,
+        issues,
+        passed: issues.length === 0,
+    };
+}
+//# sourceMappingURL=webfonts.js.map

package/dist/webfonts.js.map

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

package/dist/webhook-reporter.d.ts

@@ -0,0 +1,20 @@
+import type { InspectResult } from './types.js';
+export interface WebhookReporterOptions {
+    url: string;
+    method?: 'POST' | 'PUT';
+    headers?: Record<string, string>;
+    timeout?: number;
+    retries?: number;
+    hmacSecret?: string;
+    payloadMode?: 'full' | 'summary';
+    onlyOnFail?: boolean;
+}
+export interface WebhookReporterOutcome {
+    posted: boolean;
+    status?: number;
+    attempts: number;
+    error?: string;
+    skipped?: boolean;
+}
+export declare function postWebhookReport(result: InspectResult, opts: WebhookReporterOptions): Promise<WebhookReporterOutcome>;
+//# sourceMappingURL=webhook-reporter.d.ts.map

package/dist/webhook-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-reporter.d.ts","sourceRoot":"","sources":["../src/webhook-reporter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAoED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CA0EjC"}