uxinspect 0.2.0 → 0.11.0

package/dist/cache-headers.js.map

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

package/dist/canonical-audit.d.ts

@@ -0,0 +1,19 @@
+import type { Page } from 'playwright';
+export type CanonicalIssueType = 'missing-canonical' | 'relative-canonical' | 'protocol-mismatch' | 'host-mismatch' | 'trailing-slash-mismatch' | 'case-mismatch' | 'query-param-mismatch' | 'canonical-chain' | 'canonical-points-to-redirect' | 'canonical-points-to-404' | 'self-referential-fragment' | 'multiple-canonicals' | 'canonical-not-in-head' | 'canonical-mismatches-og-url';
+export interface CanonicalIssue {
+    type: CanonicalIssueType;
+    severity: 'info' | 'warn' | 'error';
+    detail: string;
+}
+export interface CanonicalAuditResult {
+    page: string;
+    canonical: string | null;
+    effectiveCanonical: string | null;
+    ogUrl: string | null;
+    issues: CanonicalIssue[];
+    passed: boolean;
+}
+export declare function auditCanonical(page: Page, opts?: {
+    followChain?: boolean;
+}): Promise<CanonicalAuditResult>;
+//# sourceMappingURL=canonical-audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-audit.d.ts","sourceRoot":"","sources":["../src/canonical-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,YAAY,CAAC;AAGvD,MAAM,MAAM,kBAAkB,GAC1B,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,eAAe,GACf,yBAAyB,GACzB,eAAe,GACf,sBAAsB,GACtB,iBAAiB,GACjB,8BAA8B,GAC9B,yBAAyB,GACzB,2BAA2B,GAC3B,qBAAqB,GACrB,uBAAuB,GACvB,6BAA6B,CAAC;AAElC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;CACjB;AAkHD,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CAiI/B"}

package/dist/canonical-audit.js

@@ -0,0 +1,196 @@
+import { URL } from 'node:url';
+const TRACKING_PARAMS = new Set([
+    'utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
+    'utm_id', 'fbclid', 'gclid', 'ref', 'session', 'sid',
+]);
+const DEFAULT_PORTS = { 'http:': '80', 'https:': '443' };
+function stripDefaultPort(u) {
+    if (u.port && DEFAULT_PORTS[u.protocol] === u.port)
+        u.port = '';
+}
+function stripTrackingParams(u) {
+    const keep = [];
+    u.searchParams.forEach((v, k) => {
+        if (!TRACKING_PARAMS.has(k.toLowerCase()))
+            keep.push([k, v]);
+    });
+    u.search = '';
+    for (const [k, v] of keep)
+        u.searchParams.append(k, v);
+}
+function stripWww(host) {
+    return host.startsWith('www.') ? host.slice(4) : host;
+}
+function normalizeUrl(raw) {
+    const u = new URL(raw);
+    u.protocol = u.protocol.toLowerCase();
+    u.hostname = u.hostname.toLowerCase();
+    stripDefaultPort(u);
+    stripTrackingParams(u);
+    u.hash = '';
+    return u.toString();
+}
+function nonTrackingParams(u) {
+    const out = [];
+    u.searchParams.forEach((_v, k) => {
+        if (!TRACKING_PARAMS.has(k.toLowerCase()))
+            out.push(k);
+    });
+    return out;
+}
+function trailingSlash(path) {
+    return path.length > 1 && path.endsWith('/');
+}
+async function readDom(page) {
+    return await page.evaluate(() => {
+        const links = Array.from(document.querySelectorAll('link[rel="canonical"]'));
+        const hrefs = [];
+        const inHead = [];
+        for (const link of links) {
+            hrefs.push(link.getAttribute('href') ?? '');
+            inHead.push(link.parentElement?.tagName?.toLowerCase() === 'head');
+        }
+        const og = document.querySelector('meta[property="og:url"]');
+        return { hrefs, inHead, ogUrl: og?.getAttribute('content') ?? null };
+    });
+}
+async function fetchCanonical(ctx, url, maxRedirects) {
+    try {
+        const res = await ctx.request.get(url, { maxRedirects, failOnStatusCode: false });
+        let body = '';
+        try {
+            body = await res.text();
+        }
+        catch {
+            body = '';
+        }
+        const headers = res.headers();
+        return {
+            status: res.status(),
+            redirectLocation: headers['location'] ?? null,
+            finalUrl: res.url(),
+            body,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function extractCanonicalFromHtml(html) {
+    const tag = /<link[^>]+rel\s*=\s*["']?canonical["']?[^>]*>/i.exec(html);
+    if (!tag)
+        return null;
+    const m = /href\s*=\s*["']([^"']+)["']/i.exec(tag[0]);
+    return m ? m[1] : null;
+}
+function pushIssue(issues, type, severity, detail) {
+    issues.push({ type, severity, detail });
+}
+export async function auditCanonical(page, opts) {
+    const followChain = opts?.followChain ?? true;
+    const pageUrl = page.url();
+    const issues = [];
+    const dom = await readDom(page);
+    const ogUrl = dom.ogUrl;
+    if (dom.hrefs.length === 0) {
+        pushIssue(issues, 'missing-canonical', 'error', 'no link[rel="canonical"] found');
+        return { page: pageUrl, canonical: null, effectiveCanonical: null, ogUrl, issues, passed: false };
+    }
+    if (dom.hrefs.length > 1) {
+        pushIssue(issues, 'multiple-canonicals', 'error', `found ${dom.hrefs.length} canonical links; using first`);
+    }
+    const rawCanonical = dom.hrefs[0];
+    if (!dom.inHead[0]) {
+        pushIssue(issues, 'canonical-not-in-head', 'warn', 'canonical link is not inside <head>');
+    }
+    if (!/^[a-z][a-z0-9+.-]*:/i.test(rawCanonical)) {
+        pushIssue(issues, 'relative-canonical', 'warn', `canonical "${rawCanonical}" is relative`);
+    }
+    let canonicalAbs;
+    try {
+        canonicalAbs = new URL(rawCanonical, pageUrl);
+    }
+    catch {
+        pushIssue(issues, 'missing-canonical', 'error', `canonical "${rawCanonical}" is not a valid URL`);
+        return {
+            page: pageUrl, canonical: rawCanonical, effectiveCanonical: rawCanonical,
+            ogUrl, issues, passed: false,
+        };
+    }
+    const pageU = new URL(pageUrl);
+    if (canonicalAbs.hash) {
+        pushIssue(issues, 'self-referential-fragment', 'error', `canonical contains fragment "${canonicalAbs.hash}"`);
+    }
+    if (canonicalAbs.protocol !== pageU.protocol) {
+        pushIssue(issues, 'protocol-mismatch', 'error', `page is ${pageU.protocol} but canonical is ${canonicalAbs.protocol}`);
+    }
+    const cHost = canonicalAbs.hostname.toLowerCase();
+    const pHost = pageU.hostname.toLowerCase();
+    if (cHost !== pHost && stripWww(cHost) !== stripWww(pHost)) {
+        pushIssue(issues, 'host-mismatch', 'warn', `canonical host "${canonicalAbs.hostname}" differs from page host "${pageU.hostname}"`);
+    }
+    if (trailingSlash(canonicalAbs.pathname) !== trailingSlash(pageU.pathname)) {
+        pushIssue(issues, 'trailing-slash-mismatch', 'info', `canonical path "${canonicalAbs.pathname}" trailing slash differs from page "${pageU.pathname}"`);
+    }
+    if (canonicalAbs.pathname !== pageU.pathname &&
+        canonicalAbs.pathname.toLowerCase() === pageU.pathname.toLowerCase()) {
+        pushIssue(issues, 'case-mismatch', 'info', 'canonical path case differs from page path');
+    }
+    const cParams = nonTrackingParams(canonicalAbs);
+    const pParams = nonTrackingParams(pageU);
+    if (cParams.length === 0 && pParams.length > 0) {
+        pushIssue(issues, 'query-param-mismatch', 'warn', `page has non-tracking params [${pParams.join(', ')}] but canonical has none`);
+    }
+    let effectiveCanonical = canonicalAbs.toString();
+    if (followChain) {
+        const ctx = page.context();
+        const initial = await fetchCanonical(ctx, canonicalAbs.toString(), 0);
+        if (initial) {
+            if (initial.status >= 300 && initial.status < 400) {
+                pushIssue(issues, 'canonical-points-to-redirect', 'error', `canonical "${canonicalAbs.toString()}" returned ${initial.status}` +
+                    (initial.redirectLocation ? ` -> ${initial.redirectLocation}` : ''));
+                const followed = await fetchCanonical(ctx, canonicalAbs.toString(), 5);
+                if (followed) {
+                    effectiveCanonical = followed.finalUrl;
+                    const targetCanonical = extractCanonicalFromHtml(followed.body);
+                    if (targetCanonical) {
+                        let targetAbs;
+                        try {
+                            targetAbs = new URL(targetCanonical, followed.finalUrl).toString();
+                        }
+                        catch {
+                            targetAbs = targetCanonical;
+                        }
+                        try {
+                            if (normalizeUrl(targetAbs) !== normalizeUrl(canonicalAbs.toString())) {
+                                pushIssue(issues, 'canonical-chain', 'error', `canonical -> redirect target declares different canonical "${targetAbs}"`);
+                            }
+                        }
+                        catch { /* normalization failed; skip chain comparison */ }
+                    }
+                }
+            }
+            else if (initial.status >= 400) {
+                pushIssue(issues, 'canonical-points-to-404', 'error', `canonical "${canonicalAbs.toString()}" returned ${initial.status}`);
+            }
+        }
+    }
+    if (ogUrl) {
+        try {
+            const ogAbs = new URL(ogUrl, pageUrl).toString();
+            if (normalizeUrl(ogAbs) !== normalizeUrl(canonicalAbs.toString())) {
+                pushIssue(issues, 'canonical-mismatches-og-url', 'warn', `og:url "${ogUrl}" differs from canonical "${canonicalAbs.toString()}"`);
+            }
+        }
+        catch { /* og:url not a valid URL; ignore */ }
+    }
+    return {
+        page: pageUrl,
+        canonical: canonicalAbs.toString(),
+        effectiveCanonical,
+        ogUrl,
+        issues,
+        passed: issues.every((i) => i.severity !== 'error'),
+    };
+}
+//# sourceMappingURL=canonical-audit.js.map

package/dist/canonical-audit.js.map

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

package/dist/chaos.d.ts

@@ -0,0 +1,38 @@
+import type { Page } from 'playwright';
+export type ChaosAction = 'click' | 'type' | 'scroll' | 'key' | 'hover' | 'resize';
+export interface ChaosEvent {
+    action: ChaosAction;
+    target?: string;
+    value?: string;
+    timestamp: number;
+    error?: string;
+}
+export interface ChaosError {
+    kind: 'console' | 'pageerror' | 'requestfailed' | 'unhandled-rejection';
+    message: string;
+    url?: string;
+    atEventIndex: number;
+}
+export interface ChaosResult {
+    page: string;
+    totalActions: number;
+    actionsByKind: Record<ChaosAction, number>;
+    events: ChaosEvent[];
+    errors: ChaosError[];
+    durationMs: number;
+    finalUrl: string;
+    crashed: boolean;
+    passed: boolean;
+}
+export interface ChaosOptions {
+    durationMs?: number;
+    maxActions?: number;
+    seed?: number;
+    weights?: Partial<Record<ChaosAction, number>>;
+    typeStrings?: string[];
+    keyList?: string[];
+    avoidNavigation?: boolean;
+    stopOnError?: boolean;
+}
+export declare function runChaos(page: Page, opts?: ChaosOptions): Promise<ChaosResult>;
+//# sourceMappingURL=chaos.d.ts.map

package/dist/chaos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chaos.d.ts","sourceRoot":"","sources":["../src/chaos.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAA0C,MAAM,YAAY,CAAC;AAE/E,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,eAAe,GAAG,qBAAqB,CAAC;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAuJD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAkKpF"}

package/dist/chaos.js

@@ -0,0 +1,348 @@
+const DEFAULT_WEIGHTS = {
+    click: 40, scroll: 20, key: 15, type: 10, hover: 10, resize: 5,
+};
+const DEFAULT_TYPE_STRINGS = ['a', 'test', ' ', '123', ''];
+const DEFAULT_KEYS = ['Tab', 'Enter', 'Escape', 'ArrowDown', 'ArrowUp', 'Space'];
+const CANDIDATE_SELECTOR = 'button, a[href], [role="button"], input, textarea, select';
+const HOVER_SELECTOR = 'button, a, [role="button"], [role="link"], [role="menuitem"], [tabindex], img, svg';
+const EDITABLE_SELECTOR = 'input:not([type="hidden"]):not([disabled]), textarea:not([disabled])';
+const REFRESH_EVERY = 10;
+function mulberry32(seed) {
+    let state = seed >>> 0;
+    return () => {
+        state = (state + 0x6d2b79f5) >>> 0;
+        let t = state;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+function pickAction(rand, weights) {
+    const entries = Object.entries(weights);
+    const total = entries.reduce((n, [, w]) => n + Math.max(0, w), 0);
+    if (total <= 0)
+        return 'click';
+    let r = rand() * total;
+    for (const [action, w] of entries) {
+        r -= Math.max(0, w);
+        if (r <= 0)
+            return action;
+    }
+    return entries[entries.length - 1][0];
+}
+function randInt(rand, min, max) {
+    return Math.floor(rand() * (max - min + 1)) + min;
+}
+function pickOne(rand, list) {
+    if (list.length === 0)
+        return undefined;
+    return list[Math.floor(rand() * list.length)];
+}
+async function describeHandle(handle) {
+    try {
+        return await handle.evaluate((el) => {
+            const tag = el.tagName.toLowerCase();
+            const id = el.id ? `#${el.id}` : '';
+            const name = el.getAttribute('name');
+            const role = el.getAttribute('role');
+            const type = el.getAttribute('type');
+            const testid = el.getAttribute('data-testid');
+            const text = (el.textContent ?? '').trim().slice(0, 30);
+            const parts = [tag + id];
+            if (testid)
+                parts.push(`[data-testid="${testid}"]`);
+            if (role)
+                parts.push(`[role="${role}"]`);
+            if (type)
+                parts.push(`[type="${type}"]`);
+            if (name)
+                parts.push(`[name="${name}"]`);
+            if (text)
+                parts.push(`"${text}"`);
+            return parts.join(' ');
+        });
+    }
+    catch {
+        return '<detached>';
+    }
+}
+async function isSameOrigin(handle, origin) {
+    try {
+        return await handle.evaluate((el, o) => {
+            if (el.tagName !== 'A')
+                return true;
+            const href = el.href;
+            if (!href)
+                return true;
+            try {
+                const u = new URL(href, window.location.href);
+                if (u.protocol !== 'http:' && u.protocol !== 'https:')
+                    return false;
+                return u.origin === o;
+            }
+            catch {
+                return false;
+            }
+        }, origin);
+    }
+    catch {
+        return false;
+    }
+}
+async function isVisible(handle) {
+    try {
+        return await handle.isVisible();
+    }
+    catch {
+        return false;
+    }
+}
+async function installRejectionCounter(page) {
+    await page.evaluate(() => {
+        const w = window;
+        if (w.__uxinspect_rejections__)
+            return;
+        const store = { count: 0, messages: [] };
+        w.__uxinspect_rejections__ = store;
+        window.addEventListener('unhandledrejection', (e) => {
+            store.count += 1;
+            const reason = e.reason;
+            const msg = reason instanceof Error ? reason.message
+                : typeof reason === 'string' ? reason
+                    : (() => { try {
+                        return JSON.stringify(reason);
+                    }
+                    catch {
+                        return String(reason);
+                    } })();
+            store.messages.push(msg.slice(0, 500));
+        });
+    });
+}
+async function readRejections(page) {
+    try {
+        return await page.evaluate(() => {
+            const w = window;
+            const store = w.__uxinspect_rejections__;
+            if (!store)
+                return [];
+            const copy = store.messages.slice();
+            store.messages = [];
+            store.count = 0;
+            return copy;
+        });
+    }
+    catch {
+        return [];
+    }
+}
+async function refreshCandidates(page, avoidNavigation) {
+    let handles = [];
+    try {
+        handles = await page.$$(CANDIDATE_SELECTOR);
+    }
+    catch {
+        return [];
+    }
+    if (!avoidNavigation)
+        return handles;
+    let origin = '';
+    try {
+        origin = new URL(page.url()).origin;
+    }
+    catch {
+        origin = '';
+    }
+    if (!origin)
+        return handles;
+    const filtered = [];
+    for (const h of handles) {
+        if (await isSameOrigin(h, origin))
+            filtered.push(h);
+    }
+    return filtered;
+}
+async function pickFirstVisible(page, selector) {
+    let handles = [];
+    try {
+        handles = await page.$$(selector);
+    }
+    catch {
+        return undefined;
+    }
+    for (const h of handles) {
+        if (await isVisible(h))
+            return h;
+    }
+    return undefined;
+}
+export async function runChaos(page, opts) {
+    const durationMs = opts?.durationMs ?? 15000;
+    const maxActions = opts?.maxActions ?? 100;
+    const seed = opts?.seed ?? Date.now();
+    const avoidNavigation = opts?.avoidNavigation ?? true;
+    const stopOnError = opts?.stopOnError ?? false;
+    const typeStrings = opts?.typeStrings ?? DEFAULT_TYPE_STRINGS;
+    const keyList = opts?.keyList ?? DEFAULT_KEYS;
+    const weights = { ...DEFAULT_WEIGHTS, ...(opts?.weights ?? {}) };
+    const rand = mulberry32(seed >>> 0);
+    const startUrl = page.url();
+    const start = Date.now();
+    const events = [];
+    const errors = [];
+    const actionsByKind = {
+        click: 0, type: 0, scroll: 0, key: 0, hover: 0, resize: 0,
+    };
+    let currentEventIndex = -1;
+    const onConsole = (msg) => {
+        if (msg.type() !== 'error')
+            return;
+        errors.push({
+            kind: 'console',
+            message: msg.text().slice(0, 2000),
+            url: msg.location().url || undefined,
+            atEventIndex: currentEventIndex,
+        });
+    };
+    const onPageError = (err) => {
+        errors.push({
+            kind: 'pageerror',
+            message: (err.message || String(err)).slice(0, 2000),
+            atEventIndex: currentEventIndex,
+        });
+    };
+    const onRequestFailed = (req) => {
+        const failure = req.failure();
+        const reason = failure?.errorText ?? 'request failed';
+        errors.push({
+            kind: 'requestfailed',
+            message: `${req.method()} ${req.url()} failed: ${reason}`.slice(0, 2000),
+            url: req.url(),
+            atEventIndex: currentEventIndex,
+        });
+    };
+    page.on('console', onConsole);
+    page.on('pageerror', onPageError);
+    page.on('requestfailed', onRequestFailed);
+    try {
+        await installRejectionCounter(page);
+    }
+    catch { /* page may not be ready */ }
+    let candidates = await refreshCandidates(page, avoidNavigation);
+    let crashed = false;
+    const deadline = start + durationMs;
+    for (let i = 0; i < maxActions; i++) {
+        if (Date.now() >= deadline)
+            break;
+        if (page.isClosed()) {
+            crashed = true;
+            break;
+        }
+        if (i > 0 && i % REFRESH_EVERY === 0) {
+            candidates = await refreshCandidates(page, avoidNavigation);
+        }
+        const action = pickAction(rand, weights);
+        const event = { action, timestamp: Date.now() - start };
+        events.push(event);
+        currentEventIndex = events.length - 1;
+        try {
+            if (action === 'click') {
+                const handle = pickOne(rand, candidates);
+                if (!handle) {
+                    event.error = 'no-candidates';
+                }
+                else {
+                    event.target = await describeHandle(handle);
+                    await handle.click({ timeout: 1500, trial: false });
+                    actionsByKind.click += 1;
+                }
+            }
+            else if (action === 'type') {
+                const handle = await pickFirstVisible(page, EDITABLE_SELECTOR);
+                if (!handle) {
+                    event.error = 'no-editable';
+                }
+                else {
+                    const value = pickOne(rand, typeStrings) ?? '';
+                    event.target = await describeHandle(handle);
+                    event.value = value;
+                    await handle.focus().catch(() => undefined);
+                    if (value.length > 0) {
+                        await page.keyboard.type(value, { delay: 10 });
+                    }
+                    else {
+                        await page.keyboard.press('Backspace');
+                    }
+                    actionsByKind.type += 1;
+                }
+            }
+            else if (action === 'scroll') {
+                const dy = randInt(rand, -800, 800);
+                event.value = String(dy);
+                await page.evaluate((n) => { window.scrollBy(0, n); }, dy);
+                actionsByKind.scroll += 1;
+            }
+            else if (action === 'key') {
+                const key = pickOne(rand, keyList) ?? 'Tab';
+                event.value = key;
+                await page.keyboard.press(key);
+                actionsByKind.key += 1;
+            }
+            else if (action === 'hover') {
+                const handle = await pickFirstVisible(page, HOVER_SELECTOR);
+                if (!handle) {
+                    event.error = 'no-hoverable';
+                }
+                else {
+                    event.target = await describeHandle(handle);
+                    await handle.hover({ timeout: 1500, trial: false }).catch(() => undefined);
+                    actionsByKind.hover += 1;
+                }
+            }
+            else if (action === 'resize') {
+                const w = randInt(rand, 320, 1920);
+                const h = randInt(rand, 480, 1080);
+                event.value = `${w}x${h}`;
+                await page.setViewportSize({ width: w, height: h });
+                actionsByKind.resize += 1;
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            event.error = message.slice(0, 500);
+        }
+        if (stopOnError && errors.length > 0)
+            break;
+        if (page.isClosed()) {
+            crashed = true;
+            break;
+        }
+        const delay = randInt(rand, 40, 120);
+        await new Promise((resolve) => { setTimeout(resolve, delay); });
+    }
+    const leftoverRejections = await readRejections(page);
+    for (const message of leftoverRejections) {
+        errors.push({
+            kind: 'unhandled-rejection',
+            message,
+            atEventIndex: events.length - 1,
+        });
+    }
+    page.off('console', onConsole);
+    page.off('pageerror', onPageError);
+    page.off('requestfailed', onRequestFailed);
+    const finalUrl = page.isClosed() ? startUrl : page.url();
+    const totalActions = Object.values(actionsByKind).reduce((n, v) => n + v, 0);
+    return {
+        page: startUrl,
+        totalActions,
+        actionsByKind,
+        events,
+        errors,
+        durationMs: Date.now() - start,
+        finalUrl,
+        crashed,
+        passed: !crashed && errors.length === 0,
+    };
+}
+//# sourceMappingURL=chaos.js.map