uxinspect 0.2.0 → 0.11.0

package/dist/bundle-size.js

@@ -0,0 +1,347 @@
+const CONCURRENCY = 6;
+const REQUEST_TIMEOUT_MS = 10_000;
+const MAX_JS_BYTES = 300 * 1024;
+const MAX_CSS_BYTES = 100 * 1024;
+const MIN_MINIFY_SAMPLE_BYTES = 2048;
+const WHITESPACE_RATIO_THRESHOLD = 0.15;
+const UNUSED_RATIO_THRESHOLD = 0.5;
+function isFetchableUrl(url) {
+    try {
+        const u = new URL(url);
+        return u.protocol === 'http:' || u.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+function classifyResource(entry) {
+    const initiator = (entry.initiatorType || '').toLowerCase();
+    let pathname = '';
+    try {
+        pathname = new URL(entry.name).pathname.toLowerCase();
+    }
+    catch {
+        pathname = entry.name.toLowerCase();
+    }
+    const isJsPath = /\.(m|c)?js(\?|$)/.test(pathname) || pathname.endsWith('.js');
+    const isCssPath = pathname.endsWith('.css') || /\.css(\?|$)/.test(pathname);
+    if (initiator === 'script' || isJsPath)
+        return 'js';
+    if (initiator === 'css' || isCssPath)
+        return 'css';
+    if (initiator === 'link' && isCssPath)
+        return 'css';
+    return null;
+}
+function detectFramework(source) {
+    if (/react\.production\.min|__REACT_DEVTOOLS|createElement\("/.test(source))
+        return 'react';
+    if (/Vue\.prototype|__VUE__|vue@\d/.test(source))
+        return 'vue';
+    if (/ng\.core|@angular\/core|__angularSeed/.test(source))
+        return 'angular';
+    if (/svelte\//.test(source))
+        return 'svelte';
+    if (/jQuery\.fn\.init|\$\.ajax\.extend/.test(source))
+        return 'jquery';
+    return undefined;
+}
+function extractPackageVersions(url) {
+    const out = [];
+    const re = /\/(@[\w.-]+\/[\w.-]+|[\w.-]+)@(\d+\.\d+\.\d+(?:[\w.-]*)?)\//g;
+    let match;
+    while ((match = re.exec(url)) !== null) {
+        const name = match[1];
+        const version = match[2];
+        if (name && version)
+            out.push({ name, version });
+    }
+    return out;
+}
+function computeWhitespaceRatio(source) {
+    if (source.length === 0)
+        return 0;
+    let whitespace = 0;
+    for (let i = 0; i < source.length; i++) {
+        const code = source.charCodeAt(i);
+        if (code === 0x20 || code === 0x09 || code === 0x0a || code === 0x0d)
+            whitespace++;
+    }
+    return whitespace / source.length;
+}
+function isLikelyNotMinified(source) {
+    if (source.length < MIN_MINIFY_SAMPLE_BYTES)
+        return false;
+    const ratio = computeWhitespaceRatio(source);
+    return ratio > WHITESPACE_RATIO_THRESHOLD;
+}
+async function fetchSource(url, page) {
+    try {
+        const res = await page.request.get(url, {
+            timeout: REQUEST_TIMEOUT_MS,
+            failOnStatusCode: false,
+        });
+        if (!res.ok())
+            return null;
+        const body = await res.body();
+        const source = body.toString('utf8');
+        const contentLengthHeader = res.headers()['content-length'];
+        const transferBytes = contentLengthHeader ? Number.parseInt(contentLengthHeader, 10) : body.byteLength;
+        return {
+            source,
+            transferBytes: Number.isFinite(transferBytes) && transferBytes >= 0 ? transferBytes : body.byteLength,
+        };
+    }
+    catch {
+        try {
+            const res = await fetch(url, {
+                method: 'GET',
+                redirect: 'follow',
+                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            });
+            if (!res.ok)
+                return null;
+            const buf = await res.arrayBuffer();
+            const source = new TextDecoder('utf-8').decode(buf);
+            const contentLengthHeader = res.headers.get('content-length');
+            const transferBytes = contentLengthHeader ? Number.parseInt(contentLengthHeader, 10) : buf.byteLength;
+            return {
+                source,
+                transferBytes: Number.isFinite(transferBytes) && transferBytes >= 0 ? transferBytes : buf.byteLength,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+async function runWithConcurrency(items, limit, worker) {
+    const results = new Array(items.length);
+    let cursor = 0;
+    const runners = [];
+    const spawn = async () => {
+        while (true) {
+            const idx = cursor++;
+            if (idx >= items.length)
+                return;
+            try {
+                const value = await worker(items[idx]);
+                results[idx] = { status: 'fulfilled', value };
+            }
+            catch (reason) {
+                results[idx] = { status: 'rejected', reason };
+            }
+        }
+    };
+    for (let i = 0; i < Math.min(limit, items.length); i++)
+        runners.push(spawn());
+    await Promise.all(runners);
+    return results;
+}
+function mergeCoverage(entries) {
+    const map = new Map();
+    for (const entry of entries) {
+        const total = entry.text?.length ?? 0;
+        let used = 0;
+        for (const range of entry.ranges) {
+            const len = Math.max(0, range.end - range.start);
+            used += len;
+        }
+        if (used > total && total > 0)
+            used = total;
+        const prev = map.get(entry.url);
+        if (prev) {
+            map.set(entry.url, { used: prev.used + used, total: prev.total + total });
+        }
+        else {
+            map.set(entry.url, { used, total });
+        }
+    }
+    return map;
+}
+export async function analyzeBundles(page) {
+    const pageUrl = page.url();
+    const entries = await page.evaluate(() => performance.getEntriesByType('resource')
+        .filter((r) => {
+        const init = (r.initiatorType || '').toLowerCase();
+        return init === 'script' || init === 'css' || init === 'link';
+    })
+        .map((r) => ({
+        name: r.name,
+        initiatorType: r.initiatorType,
+        encodedBodySize: r.encodedBodySize,
+        decodedBodySize: r.decodedBodySize,
+        transferSize: r.transferSize,
+    })));
+    const seen = new Set();
+    const targets = [];
+    for (const entry of entries) {
+        if (!isFetchableUrl(entry.name))
+            continue;
+        if (seen.has(entry.name))
+            continue;
+        const type = classifyResource(entry);
+        if (!type)
+            continue;
+        seen.add(entry.name);
+        targets.push({ url: entry.name, type, entry });
+    }
+    const pageWithCoverage = page;
+    const coverage = pageWithCoverage.coverage;
+    let jsCoverage = null;
+    let cssCoverage = null;
+    if (coverage && typeof coverage.stopJSCoverage === 'function') {
+        try {
+            const jsEntries = await coverage.stopJSCoverage();
+            jsCoverage = mergeCoverage(jsEntries);
+        }
+        catch {
+            jsCoverage = null;
+        }
+    }
+    if (coverage && typeof coverage.stopCSSCoverage === 'function') {
+        try {
+            const cssEntries = await coverage.stopCSSCoverage();
+            cssCoverage = mergeCoverage(cssEntries);
+        }
+        catch {
+            cssCoverage = null;
+        }
+    }
+    const fetched = await runWithConcurrency(targets, CONCURRENCY, async (t) => {
+        const result = await fetchSource(t.url, page);
+        return { target: t, result };
+    });
+    const bundles = [];
+    const issues = [];
+    const packageMap = new Map();
+    for (const settled of fetched) {
+        if (settled.status !== 'fulfilled')
+            continue;
+        const { target, result } = settled.value;
+        let bytes = target.entry.decodedBodySize;
+        let transferBytes = target.entry.transferSize || target.entry.encodedBodySize;
+        let source = '';
+        if (result) {
+            source = result.source;
+            if (!bytes || bytes <= 0)
+                bytes = Buffer.byteLength(source, 'utf8');
+            if (!transferBytes || transferBytes <= 0)
+                transferBytes = result.transferBytes;
+        }
+        if (!bytes || bytes <= 0)
+            bytes = transferBytes || 0;
+        if (!transferBytes || transferBytes <= 0)
+            transferBytes = bytes;
+        const framework = source ? detectFramework(source) : undefined;
+        const covMap = target.type === 'js' ? jsCoverage : cssCoverage;
+        const cov = covMap?.get(target.url);
+        let coverageUsedBytes;
+        let coverageUnusedBytes;
+        if (cov && cov.total > 0) {
+            coverageUsedBytes = cov.used;
+            coverageUnusedBytes = Math.max(0, cov.total - cov.used);
+        }
+        const bundle = {
+            url: target.url,
+            type: target.type,
+            bytes,
+            transferBytes,
+            coverageUsedBytes,
+            coverageUnusedBytes,
+            framework,
+        };
+        bundles.push(bundle);
+        if (target.type === 'js' && bytes > MAX_JS_BYTES) {
+            issues.push({
+                type: 'bundle-too-large',
+                target: target.url,
+                detail: `JS bundle ${(bytes / 1024).toFixed(1)}KB exceeds ${(MAX_JS_BYTES / 1024).toFixed(0)}KB budget`,
+            });
+        }
+        if (target.type === 'css' && bytes > MAX_CSS_BYTES) {
+            issues.push({
+                type: 'css-too-large',
+                target: target.url,
+                detail: `CSS bundle ${(bytes / 1024).toFixed(1)}KB exceeds ${(MAX_CSS_BYTES / 1024).toFixed(0)}KB budget`,
+            });
+        }
+        if (target.type === 'js' && source && isLikelyNotMinified(source)) {
+            issues.push({
+                type: 'no-minification',
+                target: target.url,
+                detail: `JS source has >${Math.round(WHITESPACE_RATIO_THRESHOLD * 100)}% whitespace; likely not minified`,
+            });
+        }
+        for (const pkg of extractPackageVersions(target.url)) {
+            let versions = packageMap.get(pkg.name);
+            if (!versions) {
+                versions = new Map();
+                packageMap.set(pkg.name, versions);
+            }
+            let urls = versions.get(pkg.version);
+            if (!urls) {
+                urls = new Set();
+                versions.set(pkg.version, urls);
+            }
+            urls.add(target.url);
+        }
+    }
+    const duplicatePackages = [];
+    for (const [name, versions] of packageMap) {
+        if (versions.size < 2)
+            continue;
+        const versionList = Array.from(versions.keys()).sort();
+        const bundleSet = new Set();
+        for (const urls of versions.values()) {
+            for (const u of urls)
+                bundleSet.add(u);
+        }
+        duplicatePackages.push({ name, versions: versionList, bundles: Array.from(bundleSet) });
+        issues.push({
+            type: 'duplicate-package',
+            target: name,
+            detail: `package "${name}" loaded at ${versionList.length} versions: ${versionList.join(', ')}`,
+        });
+    }
+    let totalJsBytes = 0;
+    let totalCssBytes = 0;
+    let totalJsTransferBytes = 0;
+    let totalCssTransferBytes = 0;
+    let totalBytes = 0;
+    let totalUnused = 0;
+    let sawCoverage = false;
+    for (const b of bundles) {
+        if (b.type === 'js') {
+            totalJsBytes += b.bytes;
+            totalJsTransferBytes += b.transferBytes;
+        }
+        else {
+            totalCssBytes += b.bytes;
+            totalCssTransferBytes += b.transferBytes;
+        }
+        totalBytes += b.bytes;
+        if (typeof b.coverageUnusedBytes === 'number') {
+            totalUnused += b.coverageUnusedBytes;
+            sawCoverage = true;
+        }
+    }
+    if (sawCoverage && totalBytes > 0 && totalUnused / totalBytes > UNUSED_RATIO_THRESHOLD) {
+        issues.push({
+            type: 'too-much-unused',
+            detail: `${((totalUnused / totalBytes) * 100).toFixed(1)}% of bundle bytes unused across JS+CSS`,
+        });
+    }
+    return {
+        page: pageUrl,
+        totalJsBytes,
+        totalCssBytes,
+        totalJsTransferBytes,
+        totalCssTransferBytes,
+        bundles,
+        duplicatePackages,
+        issues,
+        passed: issues.length === 0,
+    };
+}
+//# sourceMappingURL=bundle-size.js.map

package/dist/bundle-size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-size.js","sourceRoot":"","sources":["../src/bundle-size.ts"],"names":[],"mappings":"AA2EA,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,YAAY,GAAG,GAAG,GAAG,IAAI,CAAC;AAChC,MAAM,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC;AACjC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AACrC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AACxC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAEnC,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,CAAC,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAoB;IAC5C,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5D,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/E,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE5E,IAAI,SAAS,KAAK,QAAQ,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS;QAAE,OAAO,KAAK,CAAC;IACpD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CAAC,MAAc;IACrC,IAAI,0DAA0D,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IAC5F,IAAI,+BAA+B,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/D,IAAI,uCAAuC,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3E,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC7C,IAAI,mCAAmC,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC;IACtE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,sBAAsB,CAAC,GAAW;IACzC,MAAM,GAAG,GAA6C,EAAE,CAAC;IACzD,MAAM,EAAE,GAAG,8DAA8D,CAAC;IAC1E,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,IAAI,IAAI,OAAO;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAc;IAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI;YAAE,UAAU,EAAE,CAAC;IACrF,CAAC;IACD,OAAO,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;AACpC,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAc;IACzC,IAAI,MAAM,CAAC,MAAM,GAAG,uBAAuB;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,KAAK,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,KAAK,GAAG,0BAA0B,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,GAAW,EACX,IAAU;IAEV,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;YACtC,OAAO,EAAE,kBAAkB;YAC3B,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;YAAE,OAAO,IAAI,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,mBAAmB,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,gBAAgB,CAAC,CAAC;QAC5D,MAAM,aAAa,GAAG,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QACvG,OAAO;YACL,MAAM;YACN,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU;SACtG,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC3B,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,kBAAkB,CAAC;aAChD,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YACzB,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpD,MAAM,mBAAmB,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAC9D,MAAM,aAAa,GAAG,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;YACtG,OAAO;gBACL,MAAM;gBACN,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU;aACrG,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,KAAU,EACV,KAAa,EACb,MAA+B;IAE/B,MAAM,OAAO,GAA8B,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnE,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;QACtC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;YACrB,IAAI,GAAG,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAChC,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAE,CAAC,CAAC;gBACxC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;YAChD,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBAChB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9E,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,OAAwB;IAC7C,MAAM,GAAG,GAAG,IAAI,GAAG,EAA2C,CAAC;IAC/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YACjD,IAAI,IAAI,GAAG,CAAC;QACd,CAAC;QACD,IAAI,IAAI,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC;YAAE,IAAI,GAAG,KAAK,CAAC;QAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC;QAC5E,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAU;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAoB,EAAE,CACvD,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAiC;SACtE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACZ,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACnD,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,MAAM,CAAC;IAChE,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,eAAe,EAAE,CAAC,CAAC,eAAe;QAClC,eAAe,EAAE,CAAC,CAAC,eAAe;QAClC,YAAY,EAAE,CAAC,CAAC,YAAY;KAC7B,CAAC,CAAC,CACN,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAmE,EAAE,CAAC;IACnF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QAC1C,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QACnC,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,gBAAgB,GAAG,IAAmC,CAAC;IAC7D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC;IAC3C,IAAI,UAAU,GAAwD,IAAI,CAAC;IAC3E,IAAI,WAAW,GAAwD,IAAI,CAAC;IAC5E,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QAC9D,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,CAAC;YAClD,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAC/D,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,eAAe,EAAE,CAAC;YACpD,WAAW,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACzE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9C,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoC,CAAC;IAE/D,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW;YAAE,SAAS;QAC7C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QACzC,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC;QACzC,IAAI,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC;QAC9E,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YACvB,IAAI,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;gBAAE,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACpE,IAAI,CAAC,aAAa,IAAI,aAAa,IAAI,CAAC;gBAAE,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QACjF,CAAC;QACD,IAAI,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;YAAE,KAAK,GAAG,aAAa,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa,IAAI,aAAa,IAAI,CAAC;YAAE,aAAa,GAAG,KAAK,CAAC;QAEhE,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE/D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;QAC/D,MAAM,GAAG,GAAG,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,iBAAqC,CAAC;QAC1C,IAAI,mBAAuC,CAAC;QAC5C,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACzB,iBAAiB,GAAG,GAAG,CAAC,IAAI,CAAC;YAC7B,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,MAAM,GAAgB;YAC1B,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK;YACL,aAAa;YACb,iBAAiB;YACjB,mBAAmB;YACnB,SAAS;SACV,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAErB,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,GAAG,YAAY,EAAE,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,kBAAkB;gBACxB,MAAM,EAAE,MAAM,CAAC,GAAG;gBAClB,MAAM,EAAE,aAAa,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW;aACxG,CAAC,CAAC;QACL,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,GAAG,aAAa,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,eAAe;gBACrB,MAAM,EAAE,MAAM,CAAC,GAAG;gBAClB,MAAM,EAAE,cAAc,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW;aAC1G,CAAC,CAAC;QACL,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;YAClE,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,iBAAiB;gBACvB,MAAM,EAAE,MAAM,CAAC,GAAG;gBAClB,MAAM,EAAE,kBAAkB,IAAI,CAAC,KAAK,CAAC,0BAA0B,GAAG,GAAG,CAAC,mCAAmC;aAC1G,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,sBAAsB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,IAAI,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;gBAC1C,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACrC,CAAC;YACD,IAAI,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;gBACzB,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAClC,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,iBAAiB,GAAuB,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,UAAU,EAAE,CAAC;QAC1C,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC;YAAE,SAAS;QAChC,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,iBAAiB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACxF,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,YAAY,IAAI,eAAe,WAAW,CAAC,MAAM,cAAc,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAChG,CAAC,CAAC;IACL,CAAC;IAED,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,oBAAoB,GAAG,CAAC,CAAC;IAC7B,IAAI,qBAAqB,GAAG,CAAC,CAAC;IAC9B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACpB,YAAY,IAAI,CAAC,CAAC,KAAK,CAAC;YACxB,oBAAoB,IAAI,CAAC,CAAC,aAAa,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,aAAa,IAAI,CAAC,CAAC,KAAK,CAAC;YACzB,qBAAqB,IAAI,CAAC,CAAC,aAAa,CAAC;QAC3C,CAAC;QACD,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC;QACtB,IAAI,OAAO,CAAC,CAAC,mBAAmB,KAAK,QAAQ,EAAE,CAAC;YAC9C,WAAW,IAAI,CAAC,CAAC,mBAAmB,CAAC;YACrC,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;IAED,IAAI,WAAW,IAAI,UAAU,GAAG,CAAC,IAAI,WAAW,GAAG,UAAU,GAAG,sBAAsB,EAAE,CAAC;QACvF,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,iBAAiB;YACvB,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,wCAAwC;SACjG,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,IAAI,EAAE,OAAO;QACb,YAAY;QACZ,aAAa;QACb,oBAAoB;QACpB,qBAAqB;QACrB,OAAO;QACP,iBAAiB;QACjB,MAAM;QACN,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/cache-headers.d.ts

@@ -0,0 +1,33 @@
+import type { Page } from 'playwright';
+export type CacheCategory = 'html' | 'js' | 'css' | 'image' | 'font' | 'other';
+export type CacheIssueType = 'no-cache-control' | 'short-max-age' | 'missing-etag' | 'no-immutable-on-hashed' | 'html-cached-too-long';
+export interface CacheHeadersResource {
+    url: string;
+    cacheControl?: string;
+    etag?: string;
+    lastModified?: string;
+    expires?: string;
+    age?: string;
+    ageSeconds?: number;
+    maxAge?: number;
+    immutable: boolean;
+    noCache: boolean;
+    public: boolean;
+    private: boolean;
+    mustRevalidate: boolean;
+    staleWhileRevalidate?: number;
+    category: CacheCategory;
+}
+export interface CacheHeadersIssue {
+    type: CacheIssueType;
+    target: string;
+    detail?: string;
+}
+export interface CacheHeadersResult {
+    page: string;
+    resources: CacheHeadersResource[];
+    issues: CacheHeadersIssue[];
+    passed: boolean;
+}
+export declare function auditCacheHeaders(page: Page): Promise<CacheHeadersResult>;
+//# sourceMappingURL=cache-headers.d.ts.map

package/dist/cache-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-headers.d.ts","sourceRoot":"","sources":["../src/cache-headers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/E,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,eAAe,GACf,cAAc,GACd,wBAAwB,GACxB,sBAAsB,CAAC;AAE3B,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;CACjB;AA4OD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2C/E"}

package/dist/cache-headers.js

@@ -0,0 +1,270 @@
+const CONCURRENCY = 6;
+const REQUEST_TIMEOUT_MS = 5000;
+const MIN_STATIC_MAX_AGE = 3600;
+const MAX_HTML_MAX_AGE = 3600;
+function parseCacheControl(value) {
+    const out = {
+        raw: value || undefined,
+        immutable: false,
+        noCache: false,
+        noStore: false,
+        public: false,
+        private: false,
+        mustRevalidate: false,
+    };
+    if (!value)
+        return out;
+    const tokens = value.split(',').map((t) => t.trim()).filter(Boolean);
+    for (const token of tokens) {
+        const eq = token.indexOf('=');
+        const key = (eq >= 0 ? token.slice(0, eq) : token).toLowerCase();
+        const rawVal = eq >= 0 ? token.slice(eq + 1).trim().replace(/^"|"$/g, '') : '';
+        switch (key) {
+            case 'max-age': {
+                const n = Number.parseInt(rawVal, 10);
+                if (Number.isFinite(n))
+                    out.maxAge = n;
+                break;
+            }
+            case 's-maxage': {
+                const n = Number.parseInt(rawVal, 10);
+                if (Number.isFinite(n))
+                    out.sMaxAge = n;
+                break;
+            }
+            case 'stale-while-revalidate': {
+                const n = Number.parseInt(rawVal, 10);
+                if (Number.isFinite(n))
+                    out.staleWhileRevalidate = n;
+                break;
+            }
+            case 'immutable':
+                out.immutable = true;
+                break;
+            case 'no-cache':
+                out.noCache = true;
+                break;
+            case 'no-store':
+                out.noStore = true;
+                break;
+            case 'public':
+                out.public = true;
+                break;
+            case 'private':
+                out.private = true;
+                break;
+            case 'must-revalidate':
+                out.mustRevalidate = true;
+                break;
+        }
+    }
+    return out;
+}
+function categorizeUrl(url, isPageUrl) {
+    if (isPageUrl)
+        return 'html';
+    let pathname = '';
+    try {
+        pathname = new URL(url).pathname.toLowerCase();
+    }
+    catch {
+        pathname = url.toLowerCase();
+    }
+    if (pathname.endsWith('.html') || pathname.endsWith('.htm'))
+        return 'html';
+    if (pathname.endsWith('.js') || pathname.endsWith('.mjs') || pathname.endsWith('.cjs'))
+        return 'js';
+    if (pathname.endsWith('.css'))
+        return 'css';
+    if (/\.(woff2?|ttf|otf|eot)$/.test(pathname))
+        return 'font';
+    if (/\.(png|jpe?g|webp|svg|gif|avif|ico|bmp)$/.test(pathname))
+        return 'image';
+    return 'other';
+}
+function isHashedAsset(url) {
+    let pathname = '';
+    try {
+        pathname = new URL(url).pathname;
+    }
+    catch {
+        pathname = url;
+    }
+    const base = pathname.split('/').pop() || '';
+    // Matches filenames like: main.abc123.js, chunk-a1b2c3d4.css, app.1a2b3c4d5e6f.woff2
+    // Requires a hash segment (hex or base36-ish) of length >= 6 between dots before extension.
+    return /\.[A-Za-z0-9_-]{6,}\.[A-Za-z0-9]+$/.test(base) ||
+        /[.-][A-Fa-f0-9]{8,}\.[A-Za-z0-9]+$/.test(base);
+}
+function isFetchableUrl(url) {
+    try {
+        const u = new URL(url);
+        return u.protocol === 'http:' || u.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+async function fetchHeaders(url) {
+    try {
+        const res = await fetch(url, {
+            method: 'HEAD',
+            redirect: 'follow',
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        return res.headers;
+    }
+    catch {
+        try {
+            const res = await fetch(url, {
+                method: 'GET',
+                redirect: 'follow',
+                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            });
+            return res.headers;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+async function runWithConcurrency(items, limit, worker) {
+    const results = new Array(items.length);
+    let cursor = 0;
+    const runners = [];
+    const spawn = async () => {
+        while (true) {
+            const idx = cursor++;
+            if (idx >= items.length)
+                return;
+            try {
+                const value = await worker(items[idx]);
+                results[idx] = { status: 'fulfilled', value };
+            }
+            catch (reason) {
+                results[idx] = { status: 'rejected', reason };
+            }
+        }
+    };
+    for (let i = 0; i < Math.min(limit, items.length); i++)
+        runners.push(spawn());
+    await Promise.all(runners);
+    return results;
+}
+function buildResource(url, headers, isPageUrl) {
+    const category = categorizeUrl(url, isPageUrl);
+    const cacheControl = headers?.get('cache-control') || undefined;
+    const parsed = parseCacheControl(cacheControl);
+    const etag = headers?.get('etag') || undefined;
+    const lastModified = headers?.get('last-modified') || undefined;
+    const expires = headers?.get('expires') || undefined;
+    const age = headers?.get('age') || undefined;
+    let ageSeconds;
+    if (age) {
+        const n = Number.parseInt(age, 10);
+        if (Number.isFinite(n))
+            ageSeconds = n;
+    }
+    return {
+        url,
+        cacheControl,
+        etag,
+        lastModified,
+        expires,
+        age,
+        ageSeconds,
+        maxAge: parsed.maxAge,
+        immutable: parsed.immutable,
+        noCache: parsed.noCache,
+        public: parsed.public,
+        private: parsed.private,
+        mustRevalidate: parsed.mustRevalidate,
+        staleWhileRevalidate: parsed.staleWhileRevalidate,
+        category,
+    };
+}
+function evaluateIssues(resources) {
+    const issues = [];
+    for (const r of resources) {
+        const isStatic = r.category === 'js' || r.category === 'css' || r.category === 'image' || r.category === 'font';
+        if (isStatic) {
+            if (!r.cacheControl) {
+                issues.push({ type: 'no-cache-control', target: r.url, detail: 'static asset has no Cache-Control header' });
+            }
+            else if (typeof r.maxAge !== 'number' || r.maxAge < MIN_STATIC_MAX_AGE) {
+                issues.push({
+                    type: 'short-max-age',
+                    target: r.url,
+                    detail: `max-age=${r.maxAge ?? 'unset'} < ${MIN_STATIC_MAX_AGE}s recommended for static assets`,
+                });
+            }
+            if (isHashedAsset(r.url) && !r.immutable) {
+                issues.push({
+                    type: 'no-immutable-on-hashed',
+                    target: r.url,
+                    detail: 'hashed filename should include the immutable Cache-Control directive',
+                });
+            }
+            if (!r.etag && !r.lastModified) {
+                issues.push({
+                    type: 'missing-etag',
+                    target: r.url,
+                    detail: 'static asset missing both ETag and Last-Modified validators',
+                });
+            }
+        }
+        if (r.category === 'html') {
+            if (typeof r.maxAge === 'number' &&
+                r.maxAge > MAX_HTML_MAX_AGE &&
+                typeof r.staleWhileRevalidate !== 'number') {
+                issues.push({
+                    type: 'html-cached-too-long',
+                    target: r.url,
+                    detail: `HTML max-age=${r.maxAge}s without stale-while-revalidate`,
+                });
+            }
+        }
+    }
+    return issues;
+}
+export async function auditCacheHeaders(page) {
+    const pageUrl = page.url();
+    const entries = await page.evaluate(() => performance.getEntriesByType('resource').map((r) => ({
+        name: r.name,
+        initiatorType: r.initiatorType,
+    })));
+    const urlSet = new Set();
+    const urls = [];
+    const addUrl = (u) => {
+        if (!isFetchableUrl(u))
+            return;
+        if (urlSet.has(u))
+            return;
+        urlSet.add(u);
+        urls.push(u);
+    };
+    if (isFetchableUrl(pageUrl))
+        addUrl(pageUrl);
+    for (const e of entries)
+        addUrl(e.name);
+    const settled = await runWithConcurrency(urls, CONCURRENCY, async (url) => {
+        const headers = await fetchHeaders(url);
+        return { url, headers };
+    });
+    const resources = [];
+    for (const r of settled) {
+        if (r.status !== 'fulfilled')
+            continue;
+        const { url, headers } = r.value;
+        const isPageUrl = url === pageUrl;
+        resources.push(buildResource(url, headers, isPageUrl));
+    }
+    const issues = evaluateIssues(resources);
+    return {
+        page: pageUrl,
+        resources,
+        issues,
+        passed: issues.length === 0,
+    };
+}
+//# sourceMappingURL=cache-headers.js.map