mcp-web-validator 1.3.19 → 1.3.21

package/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to this project are documented here. The project follows [Se
 
 ## [Unreleased]
 
+## [1.3.21] - 2026-09-22
+
+### Fixed
+
+- Flagged multiple simultaneously usable `rel="canonical"` declarations and ignored canonical annotations that Google does not use for canonicalization, while preserving existing head scoping, rel-token, and empty-target behavior.
+- Aligned the lazily installed Chrome Headless Shell build with Puppeteer Core 25.11.0's declared supported revision and added a regression guard to prevent future runtime drift.
+
+### Changed
+
+- Upgraded `encoding-sniffer` to 1.0.2 and refreshed the Puppeteer screenshot runtime dependency set to Puppeteer/Puppeteer Core 25.11.0 with `@puppeteer/browsers` 3.2.2.
+
+## [1.3.20] - 2026-09-22
+
+### Fixed
+
+- Gave XML byte-order marks precedence over conflicting HTTP charset declarations for XML media types while preserving HTTP charset precedence over XML declarations when no BOM is present.
+- Reported present-but-empty viewport metadata as unusable instead of treating it as a configured mobile viewport declaration.
+
 ## [1.3.19] - 2026-09-22
 
 ### Fixed

package/dist/network.d.ts

@@ -36,7 +36,7 @@ export declare function getErrorMessage(error: unknown): string;
 export declare function resolvePublicHttpUrl(input: string | URL): Promise<ResolvedPublicHttpUrl>;
 export declare function assertPublicHttpUrl(input: string | URL): Promise<URL>;
 export declare function cancelResponseBody(response: Response): Promise<void>;
-export declare function readResponseText(response: Response, maxBytes: number, encoding?: string, sniffHtmlEncoding?: boolean, sniffXmlEncoding?: boolean): Promise<string>;
+export declare function readResponseText(response: Response, maxBytes: number, encoding?: string, sniffHtmlEncoding?: boolean, sniffXmlEncoding?: boolean, preferXmlBom?: boolean): Promise<string>;
 /** Fetches a public HTTP(S) URL while validating every redirect target. */
 export declare function fetchPublicHttp(input: string | URL, options?: PublicFetchOptions): Promise<PublicHttpResult>;
 /** Fetches bounded text from a public URL and rejects non-success responses. */

package/dist/network.js

@@ -195,7 +195,7 @@ function isSupportedCharacterEncoding(encoding) {
         return false;
     }
 }
-function getXmlCharacterEncoding(bytes) {
+function getXmlBomCharacterEncoding(bytes) {
     if (bytes.length >= 4) {
         if (bytes[0] === 0x00 && bytes[1] === 0x00 && bytes[2] === 0xfe && bytes[3] === 0xff) {
             return "utf-32be";
@@ -203,12 +203,6 @@ function getXmlCharacterEncoding(bytes) {
         if (bytes[0] === 0xff && bytes[1] === 0xfe && bytes[2] === 0x00 && bytes[3] === 0x00) {
             return "utf-32le";
         }
-        if (bytes[0] === 0x00 && bytes[1] === 0x3c && bytes[2] === 0x00 && bytes[3] === 0x3f) {
-            return "utf-16be";
-        }
-        if (bytes[0] === 0x3c && bytes[1] === 0x00 && bytes[2] === 0x3f && bytes[3] === 0x00) {
-            return "utf-16le";
-        }
     }
     if (bytes.length >= 3 && bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf) {
         return "utf-8";
@@ -221,6 +215,21 @@ function getXmlCharacterEncoding(bytes) {
             return "utf-16le";
         }
     }
+    return undefined;
+}
+function getXmlCharacterEncoding(bytes) {
+    const bomEncoding = getXmlBomCharacterEncoding(bytes);
+    if (bomEncoding) {
+        return bomEncoding;
+    }
+    if (bytes.length >= 4) {
+        if (bytes[0] === 0x00 && bytes[1] === 0x3c && bytes[2] === 0x00 && bytes[3] === 0x3f) {
+            return "utf-16be";
+        }
+        if (bytes[0] === 0x3c && bytes[1] === 0x00 && bytes[2] === 0x3f && bytes[3] === 0x00) {
+            return "utf-16le";
+        }
+    }
     const declarationBytes = bytes.subarray(0, HTML_ENCODING_SNIFF_BYTES);
     let declaration = "";
     for (const byte of declarationBytes) {
@@ -229,7 +238,7 @@ function getXmlCharacterEncoding(bytes) {
     const match = /^<\?xml\s+[^?]*\bencoding\s*=\s*(["'])([^"']+)\1/i.exec(declaration);
     return match?.[2].trim() || "utf-8";
 }
-export async function readResponseText(response, maxBytes, encoding, sniffHtmlEncoding = false, sniffXmlEncoding = false) {
+export async function readResponseText(response, maxBytes, encoding, sniffHtmlEncoding = false, sniffXmlEncoding = false, preferXmlBom = false) {
     assertPositiveInteger(maxBytes, "maxBytes");
     const declaredLength = Number(response.headers.get("content-length"));
     if (Number.isFinite(declaredLength) && declaredLength > maxBytes) {
@@ -258,7 +267,7 @@ export async function readResponseText(response, maxBytes, encoding, sniffHtmlEn
         if (decoder)
             return;
         let encodingLabel = encoding ?? "utf-8";
-        if (encoding === undefined && (sniffHtmlEncoding || sniffXmlEncoding)) {
+        if ((encoding === undefined && (sniffHtmlEncoding || sniffXmlEncoding)) || preferXmlBom) {
             const sniffLength = Math.min(pendingBytes, HTML_ENCODING_SNIFF_BYTES);
             const sniffBytes = new Uint8Array(sniffLength);
             let copied = 0;
@@ -269,12 +278,17 @@ export async function readResponseText(response, maxBytes, encoding, sniffHtmlEn
                 sniffBytes.set(chunk.subarray(0, length), copied);
                 copied += length;
             }
-            encodingLabel = sniffXmlEncoding
-                ? getXmlCharacterEncoding(sniffBytes)
-                : getEncoding(sniffBytes, {
-                    maxBytes: HTML_ENCODING_SNIFF_BYTES,
-                    defaultEncoding: "utf-8",
-                });
+            if (preferXmlBom) {
+                encodingLabel = getXmlBomCharacterEncoding(sniffBytes) ?? encodingLabel;
+            }
+            else {
+                encodingLabel = sniffXmlEncoding
+                    ? getXmlCharacterEncoding(sniffBytes)
+                    : getEncoding(sniffBytes, {
+                        maxBytes: HTML_ENCODING_SNIFF_BYTES,
+                        defaultEncoding: "utf-8",
+                    });
+            }
         }
         decoder = await createDecoder(encodingLabel);
         for (const chunk of pendingChunks) {
@@ -283,7 +297,7 @@ export async function readResponseText(response, maxBytes, encoding, sniffHtmlEn
         pendingChunks = [];
         pendingBytes = 0;
     };
-    if (encoding !== undefined || (!sniffHtmlEncoding && !sniffXmlEncoding)) {
+    if (!preferXmlBom && (encoding !== undefined || (!sniffHtmlEncoding && !sniffXmlEncoding))) {
         await startDecoder();
     }
     try {
@@ -427,11 +441,13 @@ export async function fetchPublicText(input, options = {}) {
     const declaredEncoding = getDeclaredCharacterEncoding(contentTypeHeader);
     const shouldSniffHtmlEncoding = contentType === "text/html"
         && (declaredEncoding === undefined || !isSupportedCharacterEncoding(declaredEncoding));
-    const shouldSniffXmlEncoding = declaredEncoding === undefined
-        && contentType !== null
+    const isXmlContentType = contentType !== null
         && (contentType === "application/xml" || contentType === "text/xml" || contentType.endsWith("+xml"));
+    const shouldSniffXmlEncoding = declaredEncoding === undefined
+        && isXmlContentType;
+    const shouldPreferXmlBom = declaredEncoding !== undefined && isXmlContentType;
     return {
-        text: await readResponseText(response, maxBytes, shouldSniffHtmlEncoding || shouldSniffXmlEncoding ? undefined : declaredEncoding, shouldSniffHtmlEncoding, shouldSniffXmlEncoding),
+        text: await readResponseText(response, maxBytes, shouldSniffHtmlEncoding || shouldSniffXmlEncoding ? undefined : declaredEncoding, shouldSniffHtmlEncoding, shouldSniffXmlEncoding, shouldPreferXmlBom),
         url: url.href,
         status: response.status,
         contentType: contentTypeHeader,

package/dist/network.js.map

@@ -1 +1 @@
-{"version":3,"file":"network.js","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,MAAM,cAAc,GAAG,KAAK,CAAC;AAC7B,MAAM,cAAc,GAAG,KAAK,CAAC;AAC7B,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAExC,MAAM,gBAAgB,GAAG,IAAI,SAAS,EAAE,CAAC;AACzC,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI;IAC9B,CAAC,SAAS,EAAE,CAAC,CAAC;IACd,CAAC,UAAU,EAAE,CAAC,CAAC;IACf,CAAC,YAAY,EAAE,EAAE,CAAC;IAClB,CAAC,WAAW,EAAE,CAAC,CAAC;IAChB,CAAC,aAAa,EAAE,EAAE,CAAC;IACnB,CAAC,YAAY,EAAE,EAAE,CAAC;IAClB,CAAC,WAAW,EAAE,EAAE,CAAC;IACjB,CAAC,WAAW,EAAE,EAAE,CAAC;IACjB,CAAC,aAAa,EAAE,EAAE,CAAC;IACnB,CAAC,aAAa,EAAE,EAAE,CAAC;IACnB,CAAC,YAAY,EAAE,EAAE,CAAC;IAClB,CAAC,cAAc,EAAE,EAAE,CAAC;IACpB,CAAC,aAAa,EAAE,EAAE,CAAC;IACnB,CAAC,WAAW,EAAE,CAAC,CAAC;IAChB,CAAC,WAAW,EAAE,CAAC,CAAC;CACR,EAAE,CAAC;IACX,gBAAgB,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI;IAC9B,CAAC,IAAI,EAAE,EAAE,CAAC;IACV,CAAC,QAAQ,EAAE,CAAC,CAAC;IACb,CAAC,QAAQ,EAAE,EAAE,CAAC;IACd,CAAC,QAAQ,EAAE,CAAC,CAAC;IACb,CAAC,QAAQ,EAAE,EAAE,CAAC;IACd,CAAC,UAAU,EAAE,EAAE,CAAC;IAChB,CAAC,WAAW,EAAE,EAAE,CAAC;IACjB,CAAC,YAAY,EAAE,EAAE,CAAC;IAClB,CAAC,QAAQ,EAAE,EAAE,CAAC;CACN,EAAE,CAAC;IACX,gBAAgB,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,mBAAmB,GAAG,IAAI,SAAS,EAAE,CAAC;AAC5C,mBAAmB,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AAEnD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,WAAW;IACX,uBAAuB;IACvB,eAAe;IACf,cAAc;CACf,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG;IAC9B,YAAY;IACZ,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,OAAO;IACP,UAAU;IACV,UAAU;IACV,QAAQ;CACT,CAAC;AAEF,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AA+B5D,MAAM,OAAO,cAAe,SAAQ,KAAK;IACrB,IAAI,GAAG,gBAAgB,CAAC;CAC3C;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACjE,OAAO,mBAAmB,CAAC;QAC7B,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC;IACrC,CAAC;IAED,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC;AAC7E,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa,EAAE,KAAa;IACzD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,eAAe,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QACxE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvB,CAAC,CAAC,QAAQ,CAAC;IACb,OAAO,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,eAAe,CAAC,OAAe,EAAE,MAAc;IACtD,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,mBAAmB,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC;eAC5C,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,WAAW,CAAI,OAAmB,EAAE,SAAiB,EAAE,KAAa;IACjF,IAAI,OAAmC,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,OAAO;YACP,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBAC3B,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,YAAY,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YACjF,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,EAAE,CAAC;YACZ,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAmB;IAC5D,MAAM,MAAM,GAAG,KAAK,YAAY,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACzD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;QACxF,MAAM,IAAI,cAAc,CAAC,kCAAkC,cAAc,aAAa,CAAC,CAAC;IAC1F,CAAC;IAED,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,cAAc,CAAC,2CAA2C,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChE,MAAM,IAAI,cAAc,CAAC,sCAAsC,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,cAAc,CAAC,6CAA6C,CAAC,CAAC;IAC1E,CAAC;IACD,6EAA6E;IAC7E,iFAAiF;IACjF,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,IAAI,cAAc,CAAC,+CAA+C,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;IACjB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,cAAc,CAAC,0BAA0B,CAAC,CAAC;IACvD,CAAC;IACD,IACE,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC;WAC3B,uBAAuB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EACtE,CAAC;QACD,MAAM,IAAI,cAAc,CAAC,iBAAiB,QAAQ,iBAAiB,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,iBAAiB,GAAG,aAAa;QACrC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QAChD,CAAC,CAAC,MAAM,WAAW,CACjB,MAAM,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAC/C,cAAc,EACd,YAAY,CACb,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACzB,MAAM,IAAI,cAAc,CAAC,mCAAmC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC,CAAC,CAAC;IAEL,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,cAAc,CAAC,4CAA4C,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,iBAAiB,EAAE,CAAC;QACvC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,cAAc,CAAC,+CAA+C,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAmB;IAC3D,OAAO,CAAC,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAkB;IACzD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,kFAAkF;IACpF,CAAC;AACH,CAAC;AAED,SAAS,4BAA4B,CAAC,WAA0B;IAC9D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,kDAAkD,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,4BAA4B,CAAC,QAAgB;IACpD,IAAI,CAAC;QACH,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAiB;IAChD,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACrF,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACrF,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACrF,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACrF,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACrF,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3C,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3C,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,gBAAgB,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC;IACtE,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACpC,WAAW,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACpE,CAAC;IACD,MAAM,KAAK,GAAG,mDAAmD,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpF,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAkB,EAClB,QAAgB,EAChB,QAAiB,EACjB,iBAAiB,GAAG,KAAK,EACzB,gBAAgB,GAAG,KAAK;IAExB,qBAAqB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAE5C,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACtE,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,QAAQ,EAAE,CAAC;QACjE,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,aAAa,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,OAAgC,CAAC;IACrC,IAAI,aAAa,GAAiB,EAAE,CAAC;IACrC,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,MAAM,aAAa,GAAG,KAAK,EAAE,aAAqB,EAAwB,EAAE;QAC1E,IAAI,CAAC;YACH,OAAO,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,4CAA4C,aAAa,GAAG,CAAC,CAAC;QAChF,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,KAAK,IAAmB,EAAE;QAC7C,IAAI,OAAO;YAAE,OAAO;QACpB,IAAI,aAAa,GAAG,QAAQ,IAAI,OAAO,CAAC;QACxC,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,iBAAiB,IAAI,gBAAgB,CAAC,EAAE,CAAC;YACtE,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC;YACtE,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;YAC/C,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;gBAClC,IAAI,MAAM,IAAI,WAAW;oBAAE,MAAM;gBACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,WAAW,GAAG,MAAM,CAAC,CAAC;gBAChE,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;gBAClD,MAAM,IAAI,MAAM,CAAC;YACnB,CAAC;YACD,aAAa,GAAG,gBAAgB;gBAC9B,CAAC,CAAC,uBAAuB,CAAC,UAAU,CAAC;gBACrC,CAAC,CAAC,WAAW,CAAC,UAAU,EAAE;oBACtB,QAAQ,EAAE,yBAAyB;oBACnC,eAAe,EAAE,OAAO;iBACzB,CAAC,CAAC;QACT,CAAC;QACD,OAAO,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,CAAC;QAC7C,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,aAAa,GAAG,EAAE,CAAC;QACnB,YAAY,GAAG,CAAC,CAAC;IACnB,CAAC,CAAC;IAEF,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,iBAAiB,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxE,MAAM,YAAY,EAAE,CAAC;IACvB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM;YACR,CAAC;YAED,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC;YAC/B,IAAI,UAAU,GAAG,QAAQ,EAAE,CAAC;gBAC1B,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,aAAa,CAAC,CAAC;YACjE,CAAC;YAED,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC1B,YAAY,IAAI,KAAK,CAAC,UAAU,CAAC;gBACjC,IAAI,YAAY,IAAI,yBAAyB,EAAE,CAAC;oBAC9C,MAAM,YAAY,EAAE,CAAC;gBACvB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QACD,MAAM,YAAY,EAAE,CAAC;QACrB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAC7B,iBAAqE;IAErE,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;IAErE,OAAO,IAAI,KAAK,CAAC;QACf,4EAA4E;QAC5E,+DAA+D;QAC/D,UAAU,EAAE,CAAC;QACb,OAAO,EAAE;YACP,MAAM,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;gBACvC,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC1F,MAAM,UAAU,GAAG,eAAe;oBAChC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,eAAe,CAAC;oBACjE,CAAC,CAAC,SAAS,CAAC;gBAEd,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC5B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,+DAA+D,CAA0B,CAAC;oBAClH,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC;oBACzB,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACpB,OAAO;gBACT,CAAC;gBAED,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;oBAChB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;oBAC3B,OAAO;gBACT,CAAC;gBAED,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;gBAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YACpD,CAAC;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAAC,UAAiB;IAC/C,8EAA8E;IAC9E,mFAAmF;IACnF,KAAK,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAmB,EACnB,OAAO,GAAuB,EAAE;IAEhC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAC1D,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,qBAAqB,CAAC;IACnE,qBAAqB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,CAAC,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,aAAa,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACtD,KAAK,IAAI,aAAa,GAAG,CAAC,GAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,sBAAsB,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACnE,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,GAAG,EAAE;gBACxC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;gBAC/B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;gBACtC,UAAU;aAC4B,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,CAAC;QACd,CAAC;QAED,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,sBAAsB,CAAC,UAAU,CAAC,CAAC;YACnC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,CAAC,GAAG,EAAE,CAAC;QAC9C,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,sBAAsB,CAAC,UAAU,CAAC,CAAC;YACnC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,CAAC,GAAG,EAAE,CAAC;QAC9C,CAAC;QAED,IAAI,aAAa,IAAI,YAAY,EAAE,CAAC;YAClC,sBAAsB,CAAC,UAAU,CAAC,CAAC;YACnC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,CAAC,GAAG,EAAE,CAAC;QAC9C,CAAC;QAED,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,WAAgB,CAAC;QACrB,IAAI,CAAC;YACH,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,cAAc,CAAC,oCAAoC,CAAC,CAAC;QACjE,CAAC;QACD,aAAa,GAAG,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAmB,EACnB,OAAO,GAAsB,EAAE;IAE/B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC;IAC/C,qBAAqB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAE5C,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE;QACrD,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC/B,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,iBAAiB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,iBAAiB,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC;IACtF,IACE,OAAO,CAAC,oBAAoB;WACzB,CAAC,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,EAClG,CAAC;QACD,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,yCAAyC,WAAW,IAAI,SAAS,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,gBAAgB,GAAG,4BAA4B,CAAC,iBAAiB,CAAC,CAAC;IACzE,MAAM,uBAAuB,GAAG,WAAW,KAAK,WAAW;WACtD,CAAC,gBAAgB,KAAK,SAAS,IAAI,CAAC,4BAA4B,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACzF,MAAM,sBAAsB,GAAG,gBAAgB,KAAK,SAAS;WACxD,WAAW,KAAK,IAAI;WACpB,CAAC,WAAW,KAAK,iBAAiB,IAAI,WAAW,KAAK,UAAU,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACvG,OAAO;QACL,IAAI,EAAE,MAAM,gBAAgB,CAC1B,QAAQ,EACR,QAAQ,EACR,uBAAuB,IAAI,sBAAsB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,EAChF,uBAAuB,EACvB,sBAAsB,CACvB;QACD,GAAG,EAAE,GAAG,CAAC,IAAI;QACb,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,WAAW,EAAE,iBAAiB;KAC/B,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB,EAAE,QAAgB;IACnE,qBAAqB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,gBAAgB,YAAY,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACjD,IAAI,QAAQ,CAAC,UAAU,GAAG,QAAQ,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,gBAAgB,YAAY,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC","sourcesContent":["import { lookup } from \"node:dns/promises\";\nimport * as fs from \"node:fs/promises\";\nimport { BlockList, isIP } from \"node:net\";\nimport * as path from \"node:path\";\nimport { getEncoding } from \"encoding-sniffer/sniffer\";\nimport { Agent } from \"undici\";\n\nconst DEFAULT_TIMEOUT_MS = 10_000;\nconst DEFAULT_MAX_REDIRECTS = 5;\nconst DNS_TIMEOUT_MS = 5_000;\nconst MAX_URL_LENGTH = 8_192;\nconst HTML_ENCODING_SNIFF_BYTES = 1_024;\n\nconst blockedAddresses = new BlockList();\nfor (const [network, prefix] of [\n  [\"0.0.0.0\", 8],\n  [\"10.0.0.0\", 8],\n  [\"100.64.0.0\", 10],\n  [\"127.0.0.0\", 8],\n  [\"169.254.0.0\", 16],\n  [\"172.16.0.0\", 12],\n  [\"192.0.0.0\", 24],\n  [\"192.0.2.0\", 24],\n  [\"192.88.99.0\", 24],\n  [\"192.168.0.0\", 16],\n  [\"198.18.0.0\", 15],\n  [\"198.51.100.0\", 24],\n  [\"203.0.113.0\", 24],\n  [\"224.0.0.0\", 4],\n  [\"240.0.0.0\", 4],\n] as const) {\n  blockedAddresses.addSubnet(network, prefix, \"ipv4\");\n}\n\nfor (const [network, prefix] of [\n  [\"::\", 96],\n  [\"fc00::\", 7],\n  [\"fe80::\", 10],\n  [\"ff00::\", 8],\n  [\"2001::\", 32],\n  [\"2001:2::\", 48],\n  [\"2001:10::\", 28],\n  [\"2001:db8::\", 32],\n  [\"2002::\", 16],\n] as const) {\n  blockedAddresses.addSubnet(network, prefix, \"ipv6\");\n}\n\nconst publicIpv6Addresses = new BlockList();\npublicIpv6Addresses.addSubnet(\"2000::\", 3, \"ipv6\");\n\nconst blockedHostnames = new Set([\n  \"localhost\",\n  \"localhost.localdomain\",\n  \"ip6-localhost\",\n  \"ip6-loopback\",\n]);\n\nconst blockedHostnameSuffixes = [\n  \".localhost\",\n  \".local\",\n  \".internal\",\n  \".home.arpa\",\n  \".test\",\n  \".invalid\",\n  \".example\",\n  \".onion\",\n];\n\nconst redirectStatuses = new Set([301, 302, 303, 307, 308]);\n\nexport interface PublicFetchOptions {\n  method?: \"GET\" | \"HEAD\";\n  headers?: Record<string, string>;\n  timeoutMs?: number;\n  maxRedirects?: number;\n}\n\nexport interface PublicTextOptions extends PublicFetchOptions {\n  maxBytes?: number;\n  acceptedContentTypes?: readonly string[];\n}\n\nexport interface PublicTextResult {\n  text: string;\n  url: string;\n  status: number;\n  contentType: string | null;\n}\n\nexport interface PublicHttpResult {\n  response: Response;\n  url: URL;\n}\n\nexport interface ResolvedPublicHttpUrl {\n  url: URL;\n  addresses: Array<{ address: string; family: number }>;\n}\n\nexport class PublicUrlError extends Error {\n  override readonly name = \"PublicUrlError\";\n}\n\nexport function getErrorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    if (error.name === \"TimeoutError\" || error.name === \"AbortError\") {\n      return \"Request timed out\";\n    }\n    return error.message || error.name;\n  }\n\n  return typeof error === \"string\" && error.trim() ? error : \"Unknown error\";\n}\n\nfunction assertPositiveInteger(value: number, label: string): void {\n  if (!Number.isSafeInteger(value) || value <= 0) {\n    throw new Error(`${label} must be a positive integer`);\n  }\n}\n\nfunction normalizeHostname(hostname: string): string {\n  const withoutBrackets = hostname.startsWith(\"[\") && hostname.endsWith(\"]\")\n    ? hostname.slice(1, -1)\n    : hostname;\n  return withoutBrackets.replace(/\\.$/, \"\").toLowerCase();\n}\n\nfunction isPublicAddress(address: string, family: number): boolean {\n  if (family === 4) {\n    return !blockedAddresses.check(address, \"ipv4\");\n  }\n\n  if (family === 6) {\n    return publicIpv6Addresses.check(address, \"ipv6\")\n      && !blockedAddresses.check(address, \"ipv6\");\n  }\n\n  return false;\n}\n\nasync function withTimeout<T>(promise: Promise<T>, timeoutMs: number, label: string): Promise<T> {\n  let timeout: NodeJS.Timeout | undefined;\n  try {\n    return await Promise.race([\n      promise,\n      new Promise<T>((_, reject) => {\n        timeout = setTimeout(() => reject(new Error(`${label} timed out`)), timeoutMs);\n      }),\n    ]);\n  } finally {\n    if (timeout) {\n      clearTimeout(timeout);\n    }\n  }\n}\n\n/**\n * Parses an HTTP(S) URL and rejects hostnames that resolve to local, private,\n * documentation, multicast, or otherwise non-public address space.\n */\nexport async function resolvePublicHttpUrl(input: string | URL): Promise<ResolvedPublicHttpUrl> {\n  const rawUrl = input instanceof URL ? input.href : input;\n  if (typeof rawUrl !== \"string\" || rawUrl.length === 0 || rawUrl.length > MAX_URL_LENGTH) {\n    throw new PublicUrlError(`URL must contain between 1 and ${MAX_URL_LENGTH} characters`);\n  }\n\n  let parsed: URL;\n  try {\n    parsed = new URL(rawUrl);\n  } catch {\n    throw new PublicUrlError(\"URL must be an absolute HTTP or HTTPS URL\");\n  }\n\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new PublicUrlError(\"Only HTTP and HTTPS URLs are allowed\");\n  }\n  if (parsed.username || parsed.password) {\n    throw new PublicUrlError(\"URLs containing credentials are not allowed\");\n  }\n  // URL normalizes matching defaults (HTTP :80 / HTTPS :443) to an empty port.\n  // Any remaining port is custom or mismatched to the scheme and must be rejected.\n  if (parsed.port) {\n    throw new PublicUrlError(\"Only default HTTP and HTTPS ports are allowed\");\n  }\n\n  parsed.hash = \"\";\n  const hostname = normalizeHostname(parsed.hostname);\n  if (!hostname) {\n    throw new PublicUrlError(\"URL hostname is required\");\n  }\n  if (\n    blockedHostnames.has(hostname)\n    || blockedHostnameSuffixes.some((suffix) => hostname.endsWith(suffix))\n  ) {\n    throw new PublicUrlError(`URL hostname \"${hostname}\" is not public`);\n  }\n\n  const literalFamily = isIP(hostname);\n  const resolvedAddresses = literalFamily\n    ? [{ address: hostname, family: literalFamily }]\n    : await withTimeout(\n      lookup(hostname, { all: true, verbatim: true }),\n      DNS_TIMEOUT_MS,\n      \"DNS lookup\",\n    ).catch((error: unknown) => {\n      throw new PublicUrlError(`Unable to resolve URL hostname: ${getErrorMessage(error)}`);\n    });\n\n  if (resolvedAddresses.length === 0) {\n    throw new PublicUrlError(\"URL hostname did not resolve to an address\");\n  }\n\n  for (const record of resolvedAddresses) {\n    if (!isPublicAddress(record.address, record.family)) {\n      throw new PublicUrlError(`URL hostname resolves to non-public address ${record.address}`);\n    }\n  }\n\n  return { url: parsed, addresses: resolvedAddresses };\n}\n\nexport async function assertPublicHttpUrl(input: string | URL): Promise<URL> {\n  return (await resolvePublicHttpUrl(input)).url;\n}\n\nexport async function cancelResponseBody(response: Response): Promise<void> {\n  if (!response.body) {\n    return;\n  }\n\n  try {\n    await response.body.cancel();\n  } catch {\n    // The stream may already be closed or consumed; there is nothing left to release.\n  }\n}\n\nfunction getDeclaredCharacterEncoding(contentType: string | null): string | undefined {\n  if (!contentType) {\n    return undefined;\n  }\n\n  const match = /(?:^|;)\\s*charset\\s*=\\s*(?:\"([^\"]*)\"|([^;\\s]*))/i.exec(contentType);\n  if (!match) {\n    return undefined;\n  }\n  return (match[1] ?? match[2] ?? \"\").trim();\n}\n\nfunction isSupportedCharacterEncoding(encoding: string): boolean {\n  try {\n    new TextDecoder(encoding);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction getXmlCharacterEncoding(bytes: Uint8Array): string {\n  if (bytes.length >= 4) {\n    if (bytes[0] === 0x00 && bytes[1] === 0x00 && bytes[2] === 0xfe && bytes[3] === 0xff) {\n      return \"utf-32be\";\n    }\n    if (bytes[0] === 0xff && bytes[1] === 0xfe && bytes[2] === 0x00 && bytes[3] === 0x00) {\n      return \"utf-32le\";\n    }\n    if (bytes[0] === 0x00 && bytes[1] === 0x3c && bytes[2] === 0x00 && bytes[3] === 0x3f) {\n      return \"utf-16be\";\n    }\n    if (bytes[0] === 0x3c && bytes[1] === 0x00 && bytes[2] === 0x3f && bytes[3] === 0x00) {\n      return \"utf-16le\";\n    }\n  }\n  if (bytes.length >= 3 && bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf) {\n    return \"utf-8\";\n  }\n  if (bytes.length >= 2) {\n    if (bytes[0] === 0xfe && bytes[1] === 0xff) {\n      return \"utf-16be\";\n    }\n    if (bytes[0] === 0xff && bytes[1] === 0xfe) {\n      return \"utf-16le\";\n    }\n  }\n\n  const declarationBytes = bytes.subarray(0, HTML_ENCODING_SNIFF_BYTES);\n  let declaration = \"\";\n  for (const byte of declarationBytes) {\n    declaration += byte < 0x80 ? String.fromCharCode(byte) : \"\\ufffd\";\n  }\n  const match = /^<\\?xml\\s+[^?]*\\bencoding\\s*=\\s*([\"'])([^\"']+)\\1/i.exec(declaration);\n  return match?.[2].trim() || \"utf-8\";\n}\n\nexport async function readResponseText(\n  response: Response,\n  maxBytes: number,\n  encoding?: string,\n  sniffHtmlEncoding = false,\n  sniffXmlEncoding = false,\n): Promise<string> {\n  assertPositiveInteger(maxBytes, \"maxBytes\");\n\n  const declaredLength = Number(response.headers.get(\"content-length\"));\n  if (Number.isFinite(declaredLength) && declaredLength > maxBytes) {\n    await cancelResponseBody(response);\n    throw new Error(`Response exceeds the ${maxBytes}-byte limit`);\n  }\n\n  if (!response.body) {\n    return \"\";\n  }\n\n  const reader = response.body.getReader();\n  let totalBytes = 0;\n  let text = \"\";\n  let decoder: TextDecoder | undefined;\n  let pendingChunks: Uint8Array[] = [];\n  let pendingBytes = 0;\n\n  const createDecoder = async (encodingLabel: string): Promise<TextDecoder> => {\n    try {\n      return new TextDecoder(encodingLabel);\n    } catch {\n      await reader.cancel();\n      throw new Error(`Unsupported response character encoding \"${encodingLabel}\"`);\n    }\n  };\n\n  const startDecoder = async (): Promise<void> => {\n    if (decoder) return;\n    let encodingLabel = encoding ?? \"utf-8\";\n    if (encoding === undefined && (sniffHtmlEncoding || sniffXmlEncoding)) {\n      const sniffLength = Math.min(pendingBytes, HTML_ENCODING_SNIFF_BYTES);\n      const sniffBytes = new Uint8Array(sniffLength);\n      let copied = 0;\n      for (const chunk of pendingChunks) {\n        if (copied >= sniffLength) break;\n        const length = Math.min(chunk.byteLength, sniffLength - copied);\n        sniffBytes.set(chunk.subarray(0, length), copied);\n        copied += length;\n      }\n      encodingLabel = sniffXmlEncoding\n        ? getXmlCharacterEncoding(sniffBytes)\n        : getEncoding(sniffBytes, {\n            maxBytes: HTML_ENCODING_SNIFF_BYTES,\n            defaultEncoding: \"utf-8\",\n          });\n    }\n    decoder = await createDecoder(encodingLabel);\n    for (const chunk of pendingChunks) {\n      text += decoder.decode(chunk, { stream: true });\n    }\n    pendingChunks = [];\n    pendingBytes = 0;\n  };\n\n  if (encoding !== undefined || (!sniffHtmlEncoding && !sniffXmlEncoding)) {\n    await startDecoder();\n  }\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) {\n        break;\n      }\n\n      totalBytes += value.byteLength;\n      if (totalBytes > maxBytes) {\n        await reader.cancel();\n        throw new Error(`Response exceeds the ${maxBytes}-byte limit`);\n      }\n\n      if (!decoder) {\n        pendingChunks.push(value);\n        pendingBytes += value.byteLength;\n        if (pendingBytes >= HTML_ENCODING_SNIFF_BYTES) {\n          await startDecoder();\n        }\n      } else {\n        text += decoder.decode(value, { stream: true });\n      }\n    }\n    await startDecoder();\n    if (!decoder) {\n      throw new Error(\"Response decoder was not initialized\");\n    }\n    text += decoder.decode();\n    return text;\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nfunction createPinnedDispatcher(\n  resolvedAddresses: ReadonlyArray<{ address: string; family: number }>,\n): Agent {\n  const addresses = resolvedAddresses.map((record) => ({ ...record }));\n\n  return new Agent({\n    // Every validated request gets its own non-reused connection so a later DNS\n    // answer cannot replace the address set approved for this hop.\n    pipelining: 0,\n    connect: {\n      lookup: (_hostname, options, callback) => {\n        const requestedFamily = options.family === 4 || options.family === 6 ? options.family : 0;\n        const candidates = requestedFamily\n          ? addresses.filter((record) => record.family === requestedFamily)\n          : addresses;\n\n        if (candidates.length === 0) {\n          const error = new Error(\"No validated address is available for the requested IP family\") as NodeJS.ErrnoException;\n          error.code = \"ENOTFOUND\";\n          callback(error, []);\n          return;\n        }\n\n        if (options.all) {\n          callback(null, candidates);\n          return;\n        }\n\n        const selected = candidates[0];\n        callback(null, selected.address, selected.family);\n      },\n    },\n  });\n}\n\nfunction beginClosingDispatcher(dispatcher: Agent): void {\n  // close() waits for the active response stream to finish, so starting it here\n  // releases the request-scoped Agent without interrupting callers reading the body.\n  void dispatcher.close().catch(() => {});\n}\n\n/** Fetches a public HTTP(S) URL while validating every redirect target. */\nexport async function fetchPublicHttp(\n  input: string | URL,\n  options: PublicFetchOptions = {},\n): Promise<PublicHttpResult> {\n  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const maxRedirects = options.maxRedirects ?? DEFAULT_MAX_REDIRECTS;\n  assertPositiveInteger(timeoutMs, \"timeoutMs\");\n  if (!Number.isSafeInteger(maxRedirects) || maxRedirects < 0 || maxRedirects > 10) {\n    throw new Error(\"maxRedirects must be an integer between 0 and 10\");\n  }\n\n  let currentTarget = await resolvePublicHttpUrl(input);\n  for (let redirectCount = 0; ; redirectCount += 1) {\n    const dispatcher = createPinnedDispatcher(currentTarget.addresses);\n    let response: Response;\n    try {\n      response = await fetch(currentTarget.url, {\n        method: options.method ?? \"GET\",\n        headers: options.headers,\n        redirect: \"manual\",\n        signal: AbortSignal.timeout(timeoutMs),\n        dispatcher,\n      } as RequestInit & { dispatcher: Agent });\n    } catch (error) {\n      await dispatcher.close();\n      throw error;\n    }\n\n    if (!redirectStatuses.has(response.status)) {\n      beginClosingDispatcher(dispatcher);\n      return { response, url: currentTarget.url };\n    }\n\n    const location = response.headers.get(\"location\");\n    if (!location) {\n      beginClosingDispatcher(dispatcher);\n      return { response, url: currentTarget.url };\n    }\n\n    if (redirectCount >= maxRedirects) {\n      beginClosingDispatcher(dispatcher);\n      return { response, url: currentTarget.url };\n    }\n\n    await cancelResponseBody(response);\n    await dispatcher.close();\n    let redirectUrl: URL;\n    try {\n      redirectUrl = new URL(location, currentTarget.url);\n    } catch {\n      throw new PublicUrlError(\"Redirect target is not a valid URL\");\n    }\n    currentTarget = await resolvePublicHttpUrl(redirectUrl);\n  }\n}\n\n/** Fetches bounded text from a public URL and rejects non-success responses. */\nexport async function fetchPublicText(\n  input: string | URL,\n  options: PublicTextOptions = {},\n): Promise<PublicTextResult> {\n  const maxBytes = options.maxBytes ?? 2_000_000;\n  assertPositiveInteger(maxBytes, \"maxBytes\");\n\n  const { response, url } = await fetchPublicHttp(input, {\n    method: \"GET\",\n    headers: options.headers,\n    timeoutMs: options.timeoutMs,\n    maxRedirects: options.maxRedirects,\n  });\n\n  if (!response.ok) {\n    const status = response.status;\n    await cancelResponseBody(response);\n    throw new Error(`URL returned HTTP status ${status}`);\n  }\n\n  const contentTypeHeader = response.headers.get(\"content-type\");\n  const contentType = contentTypeHeader?.split(\";\", 1)[0]?.trim().toLowerCase() || null;\n  if (\n    options.acceptedContentTypes\n    && !options.acceptedContentTypes.some((accepted) => accepted.trim().toLowerCase() === contentType)\n  ) {\n    await cancelResponseBody(response);\n    throw new Error(`URL returned unsupported content type ${contentType ?? \"missing\"}`);\n  }\n\n  const declaredEncoding = getDeclaredCharacterEncoding(contentTypeHeader);\n  const shouldSniffHtmlEncoding = contentType === \"text/html\"\n    && (declaredEncoding === undefined || !isSupportedCharacterEncoding(declaredEncoding));\n  const shouldSniffXmlEncoding = declaredEncoding === undefined\n    && contentType !== null\n    && (contentType === \"application/xml\" || contentType === \"text/xml\" || contentType.endsWith(\"+xml\"));\n  return {\n    text: await readResponseText(\n      response,\n      maxBytes,\n      shouldSniffHtmlEncoding || shouldSniffXmlEncoding ? undefined : declaredEncoding,\n      shouldSniffHtmlEncoding,\n      shouldSniffXmlEncoding,\n    ),\n    url: url.href,\n    status: response.status,\n    contentType: contentTypeHeader,\n  };\n}\n\n/** Reads a UTF-8 file only when it is a regular file within the requested cap. */\nexport async function readTextFile(filePath: string, maxBytes: number): Promise<string> {\n  assertPositiveInteger(maxBytes, \"maxBytes\");\n  const resolvedPath = path.resolve(filePath);\n  const stats = await fs.stat(resolvedPath);\n  if (!stats.isFile()) {\n    throw new Error(`Path is not a regular file: ${resolvedPath}`);\n  }\n  if (stats.size > maxBytes) {\n    throw new Error(`File exceeds the ${maxBytes}-byte limit: ${resolvedPath}`);\n  }\n\n  const contents = await fs.readFile(resolvedPath);\n  if (contents.byteLength > maxBytes) {\n    throw new Error(`File exceeds the ${maxBytes}-byte limit: ${resolvedPath}`);\n  }\n  return contents.toString(\"utf8\");\n}\n"]}
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"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","sourcesContent":["import { lookup } from \"node:dns/promises\";\nimport * as fs from \"node:fs/promises\";\nimport { BlockList, isIP } from \"node:net\";\nimport * as path from \"node:path\";\nimport { getEncoding } from \"encoding-sniffer/sniffer\";\nimport { Agent } from \"undici\";\n\nconst DEFAULT_TIMEOUT_MS = 10_000;\nconst DEFAULT_MAX_REDIRECTS = 5;\nconst DNS_TIMEOUT_MS = 5_000;\nconst MAX_URL_LENGTH = 8_192;\nconst HTML_ENCODING_SNIFF_BYTES = 1_024;\n\nconst blockedAddresses = new BlockList();\nfor (const [network, prefix] of [\n  [\"0.0.0.0\", 8],\n  [\"10.0.0.0\", 8],\n  [\"100.64.0.0\", 10],\n  [\"127.0.0.0\", 8],\n  [\"169.254.0.0\", 16],\n  [\"172.16.0.0\", 12],\n  [\"192.0.0.0\", 24],\n  [\"192.0.2.0\", 24],\n  [\"192.88.99.0\", 24],\n  [\"192.168.0.0\", 16],\n  [\"198.18.0.0\", 15],\n  [\"198.51.100.0\", 24],\n  [\"203.0.113.0\", 24],\n  [\"224.0.0.0\", 4],\n  [\"240.0.0.0\", 4],\n] as const) {\n  blockedAddresses.addSubnet(network, prefix, \"ipv4\");\n}\n\nfor (const [network, prefix] of [\n  [\"::\", 96],\n  [\"fc00::\", 7],\n  [\"fe80::\", 10],\n  [\"ff00::\", 8],\n  [\"2001::\", 32],\n  [\"2001:2::\", 48],\n  [\"2001:10::\", 28],\n  [\"2001:db8::\", 32],\n  [\"2002::\", 16],\n] as const) {\n  blockedAddresses.addSubnet(network, prefix, \"ipv6\");\n}\n\nconst publicIpv6Addresses = new BlockList();\npublicIpv6Addresses.addSubnet(\"2000::\", 3, \"ipv6\");\n\nconst blockedHostnames = new Set([\n  \"localhost\",\n  \"localhost.localdomain\",\n  \"ip6-localhost\",\n  \"ip6-loopback\",\n]);\n\nconst blockedHostnameSuffixes = [\n  \".localhost\",\n  \".local\",\n  \".internal\",\n  \".home.arpa\",\n  \".test\",\n  \".invalid\",\n  \".example\",\n  \".onion\",\n];\n\nconst redirectStatuses = new Set([301, 302, 303, 307, 308]);\n\nexport interface PublicFetchOptions {\n  method?: \"GET\" | \"HEAD\";\n  headers?: Record<string, string>;\n  timeoutMs?: number;\n  maxRedirects?: number;\n}\n\nexport interface PublicTextOptions extends PublicFetchOptions {\n  maxBytes?: number;\n  acceptedContentTypes?: readonly string[];\n}\n\nexport interface PublicTextResult {\n  text: string;\n  url: string;\n  status: number;\n  contentType: string | null;\n}\n\nexport interface PublicHttpResult {\n  response: Response;\n  url: URL;\n}\n\nexport interface ResolvedPublicHttpUrl {\n  url: URL;\n  addresses: Array<{ address: string; family: number }>;\n}\n\nexport class PublicUrlError extends Error {\n  override readonly name = \"PublicUrlError\";\n}\n\nexport function getErrorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    if (error.name === \"TimeoutError\" || error.name === \"AbortError\") {\n      return \"Request timed out\";\n    }\n    return error.message || error.name;\n  }\n\n  return typeof error === \"string\" && error.trim() ? error : \"Unknown error\";\n}\n\nfunction assertPositiveInteger(value: number, label: string): void {\n  if (!Number.isSafeInteger(value) || value <= 0) {\n    throw new Error(`${label} must be a positive integer`);\n  }\n}\n\nfunction normalizeHostname(hostname: string): string {\n  const withoutBrackets = hostname.startsWith(\"[\") && hostname.endsWith(\"]\")\n    ? hostname.slice(1, -1)\n    : hostname;\n  return withoutBrackets.replace(/\\.$/, \"\").toLowerCase();\n}\n\nfunction isPublicAddress(address: string, family: number): boolean {\n  if (family === 4) {\n    return !blockedAddresses.check(address, \"ipv4\");\n  }\n\n  if (family === 6) {\n    return publicIpv6Addresses.check(address, \"ipv6\")\n      && !blockedAddresses.check(address, \"ipv6\");\n  }\n\n  return false;\n}\n\nasync function withTimeout<T>(promise: Promise<T>, timeoutMs: number, label: string): Promise<T> {\n  let timeout: NodeJS.Timeout | undefined;\n  try {\n    return await Promise.race([\n      promise,\n      new Promise<T>((_, reject) => {\n        timeout = setTimeout(() => reject(new Error(`${label} timed out`)), timeoutMs);\n      }),\n    ]);\n  } finally {\n    if (timeout) {\n      clearTimeout(timeout);\n    }\n  }\n}\n\n/**\n * Parses an HTTP(S) URL and rejects hostnames that resolve to local, private,\n * documentation, multicast, or otherwise non-public address space.\n */\nexport async function resolvePublicHttpUrl(input: string | URL): Promise<ResolvedPublicHttpUrl> {\n  const rawUrl = input instanceof URL ? input.href : input;\n  if (typeof rawUrl !== \"string\" || rawUrl.length === 0 || rawUrl.length > MAX_URL_LENGTH) {\n    throw new PublicUrlError(`URL must contain between 1 and ${MAX_URL_LENGTH} characters`);\n  }\n\n  let parsed: URL;\n  try {\n    parsed = new URL(rawUrl);\n  } catch {\n    throw new PublicUrlError(\"URL must be an absolute HTTP or HTTPS URL\");\n  }\n\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new PublicUrlError(\"Only HTTP and HTTPS URLs are allowed\");\n  }\n  if (parsed.username || parsed.password) {\n    throw new PublicUrlError(\"URLs containing credentials are not allowed\");\n  }\n  // URL normalizes matching defaults (HTTP :80 / HTTPS :443) to an empty port.\n  // Any remaining port is custom or mismatched to the scheme and must be rejected.\n  if (parsed.port) {\n    throw new PublicUrlError(\"Only default HTTP and HTTPS ports are allowed\");\n  }\n\n  parsed.hash = \"\";\n  const hostname = normalizeHostname(parsed.hostname);\n  if (!hostname) {\n    throw new PublicUrlError(\"URL hostname is required\");\n  }\n  if (\n    blockedHostnames.has(hostname)\n    || blockedHostnameSuffixes.some((suffix) => hostname.endsWith(suffix))\n  ) {\n    throw new PublicUrlError(`URL hostname \"${hostname}\" is not public`);\n  }\n\n  const literalFamily = isIP(hostname);\n  const resolvedAddresses = literalFamily\n    ? [{ address: hostname, family: literalFamily }]\n    : await withTimeout(\n      lookup(hostname, { all: true, verbatim: true }),\n      DNS_TIMEOUT_MS,\n      \"DNS lookup\",\n    ).catch((error: unknown) => {\n      throw new PublicUrlError(`Unable to resolve URL hostname: ${getErrorMessage(error)}`);\n    });\n\n  if (resolvedAddresses.length === 0) {\n    throw new PublicUrlError(\"URL hostname did not resolve to an address\");\n  }\n\n  for (const record of resolvedAddresses) {\n    if (!isPublicAddress(record.address, record.family)) {\n      throw new PublicUrlError(`URL hostname resolves to non-public address ${record.address}`);\n    }\n  }\n\n  return { url: parsed, addresses: resolvedAddresses };\n}\n\nexport async function assertPublicHttpUrl(input: string | URL): Promise<URL> {\n  return (await resolvePublicHttpUrl(input)).url;\n}\n\nexport async function cancelResponseBody(response: Response): Promise<void> {\n  if (!response.body) {\n    return;\n  }\n\n  try {\n    await response.body.cancel();\n  } catch {\n    // The stream may already be closed or consumed; there is nothing left to release.\n  }\n}\n\nfunction getDeclaredCharacterEncoding(contentType: string | null): string | undefined {\n  if (!contentType) {\n    return undefined;\n  }\n\n  const match = /(?:^|;)\\s*charset\\s*=\\s*(?:\"([^\"]*)\"|([^;\\s]*))/i.exec(contentType);\n  if (!match) {\n    return undefined;\n  }\n  return (match[1] ?? match[2] ?? \"\").trim();\n}\n\nfunction isSupportedCharacterEncoding(encoding: string): boolean {\n  try {\n    new TextDecoder(encoding);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction getXmlBomCharacterEncoding(bytes: Uint8Array): string | undefined {\n  if (bytes.length >= 4) {\n    if (bytes[0] === 0x00 && bytes[1] === 0x00 && bytes[2] === 0xfe && bytes[3] === 0xff) {\n      return \"utf-32be\";\n    }\n    if (bytes[0] === 0xff && bytes[1] === 0xfe && bytes[2] === 0x00 && bytes[3] === 0x00) {\n      return \"utf-32le\";\n    }\n  }\n  if (bytes.length >= 3 && bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf) {\n    return \"utf-8\";\n  }\n  if (bytes.length >= 2) {\n    if (bytes[0] === 0xfe && bytes[1] === 0xff) {\n      return \"utf-16be\";\n    }\n    if (bytes[0] === 0xff && bytes[1] === 0xfe) {\n      return \"utf-16le\";\n    }\n  }\n  return undefined;\n}\n\nfunction getXmlCharacterEncoding(bytes: Uint8Array): string {\n  const bomEncoding = getXmlBomCharacterEncoding(bytes);\n  if (bomEncoding) {\n    return bomEncoding;\n  }\n  if (bytes.length >= 4) {\n    if (bytes[0] === 0x00 && bytes[1] === 0x3c && bytes[2] === 0x00 && bytes[3] === 0x3f) {\n      return \"utf-16be\";\n    }\n    if (bytes[0] === 0x3c && bytes[1] === 0x00 && bytes[2] === 0x3f && bytes[3] === 0x00) {\n      return \"utf-16le\";\n    }\n  }\n\n  const declarationBytes = bytes.subarray(0, HTML_ENCODING_SNIFF_BYTES);\n  let declaration = \"\";\n  for (const byte of declarationBytes) {\n    declaration += byte < 0x80 ? String.fromCharCode(byte) : \"\\ufffd\";\n  }\n  const match = /^<\\?xml\\s+[^?]*\\bencoding\\s*=\\s*([\"'])([^\"']+)\\1/i.exec(declaration);\n  return match?.[2].trim() || \"utf-8\";\n}\n\nexport async function readResponseText(\n  response: Response,\n  maxBytes: number,\n  encoding?: string,\n  sniffHtmlEncoding = false,\n  sniffXmlEncoding = false,\n  preferXmlBom = false,\n): Promise<string> {\n  assertPositiveInteger(maxBytes, \"maxBytes\");\n\n  const declaredLength = Number(response.headers.get(\"content-length\"));\n  if (Number.isFinite(declaredLength) && declaredLength > maxBytes) {\n    await cancelResponseBody(response);\n    throw new Error(`Response exceeds the ${maxBytes}-byte limit`);\n  }\n\n  if (!response.body) {\n    return \"\";\n  }\n\n  const reader = response.body.getReader();\n  let totalBytes = 0;\n  let text = \"\";\n  let decoder: TextDecoder | undefined;\n  let pendingChunks: Uint8Array[] = [];\n  let pendingBytes = 0;\n\n  const createDecoder = async (encodingLabel: string): Promise<TextDecoder> => {\n    try {\n      return new TextDecoder(encodingLabel);\n    } catch {\n      await reader.cancel();\n      throw new Error(`Unsupported response character encoding \"${encodingLabel}\"`);\n    }\n  };\n\n  const startDecoder = async (): Promise<void> => {\n    if (decoder) return;\n    let encodingLabel = encoding ?? \"utf-8\";\n    if ((encoding === undefined && (sniffHtmlEncoding || sniffXmlEncoding)) || preferXmlBom) {\n      const sniffLength = Math.min(pendingBytes, HTML_ENCODING_SNIFF_BYTES);\n      const sniffBytes = new Uint8Array(sniffLength);\n      let copied = 0;\n      for (const chunk of pendingChunks) {\n        if (copied >= sniffLength) break;\n        const length = Math.min(chunk.byteLength, sniffLength - copied);\n        sniffBytes.set(chunk.subarray(0, length), copied);\n        copied += length;\n      }\n      if (preferXmlBom) {\n        encodingLabel = getXmlBomCharacterEncoding(sniffBytes) ?? encodingLabel;\n      } else {\n        encodingLabel = sniffXmlEncoding\n          ? getXmlCharacterEncoding(sniffBytes)\n          : getEncoding(sniffBytes, {\n              maxBytes: HTML_ENCODING_SNIFF_BYTES,\n              defaultEncoding: \"utf-8\",\n            });\n      }\n    }\n    decoder = await createDecoder(encodingLabel);\n    for (const chunk of pendingChunks) {\n      text += decoder.decode(chunk, { stream: true });\n    }\n    pendingChunks = [];\n    pendingBytes = 0;\n  };\n\n  if (!preferXmlBom && (encoding !== undefined || (!sniffHtmlEncoding && !sniffXmlEncoding))) {\n    await startDecoder();\n  }\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) {\n        break;\n      }\n\n      totalBytes += value.byteLength;\n      if (totalBytes > maxBytes) {\n        await reader.cancel();\n        throw new Error(`Response exceeds the ${maxBytes}-byte limit`);\n      }\n\n      if (!decoder) {\n        pendingChunks.push(value);\n        pendingBytes += value.byteLength;\n        if (pendingBytes >= HTML_ENCODING_SNIFF_BYTES) {\n          await startDecoder();\n        }\n      } else {\n        text += decoder.decode(value, { stream: true });\n      }\n    }\n    await startDecoder();\n    if (!decoder) {\n      throw new Error(\"Response decoder was not initialized\");\n    }\n    text += decoder.decode();\n    return text;\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nfunction createPinnedDispatcher(\n  resolvedAddresses: ReadonlyArray<{ address: string; family: number }>,\n): Agent {\n  const addresses = resolvedAddresses.map((record) => ({ ...record }));\n\n  return new Agent({\n    // Every validated request gets its own non-reused connection so a later DNS\n    // answer cannot replace the address set approved for this hop.\n    pipelining: 0,\n    connect: {\n      lookup: (_hostname, options, callback) => {\n        const requestedFamily = options.family === 4 || options.family === 6 ? options.family : 0;\n        const candidates = requestedFamily\n          ? addresses.filter((record) => record.family === requestedFamily)\n          : addresses;\n\n        if (candidates.length === 0) {\n          const error = new Error(\"No validated address is available for the requested IP family\") as NodeJS.ErrnoException;\n          error.code = \"ENOTFOUND\";\n          callback(error, []);\n          return;\n        }\n\n        if (options.all) {\n          callback(null, candidates);\n          return;\n        }\n\n        const selected = candidates[0];\n        callback(null, selected.address, selected.family);\n      },\n    },\n  });\n}\n\nfunction beginClosingDispatcher(dispatcher: Agent): void {\n  // close() waits for the active response stream to finish, so starting it here\n  // releases the request-scoped Agent without interrupting callers reading the body.\n  void dispatcher.close().catch(() => {});\n}\n\n/** Fetches a public HTTP(S) URL while validating every redirect target. */\nexport async function fetchPublicHttp(\n  input: string | URL,\n  options: PublicFetchOptions = {},\n): Promise<PublicHttpResult> {\n  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const maxRedirects = options.maxRedirects ?? DEFAULT_MAX_REDIRECTS;\n  assertPositiveInteger(timeoutMs, \"timeoutMs\");\n  if (!Number.isSafeInteger(maxRedirects) || maxRedirects < 0 || maxRedirects > 10) {\n    throw new Error(\"maxRedirects must be an integer between 0 and 10\");\n  }\n\n  let currentTarget = await resolvePublicHttpUrl(input);\n  for (let redirectCount = 0; ; redirectCount += 1) {\n    const dispatcher = createPinnedDispatcher(currentTarget.addresses);\n    let response: Response;\n    try {\n      response = await fetch(currentTarget.url, {\n        method: options.method ?? \"GET\",\n        headers: options.headers,\n        redirect: \"manual\",\n        signal: AbortSignal.timeout(timeoutMs),\n        dispatcher,\n      } as RequestInit & { dispatcher: Agent });\n    } catch (error) {\n      await dispatcher.close();\n      throw error;\n    }\n\n    if (!redirectStatuses.has(response.status)) {\n      beginClosingDispatcher(dispatcher);\n      return { response, url: currentTarget.url };\n    }\n\n    const location = response.headers.get(\"location\");\n    if (!location) {\n      beginClosingDispatcher(dispatcher);\n      return { response, url: currentTarget.url };\n    }\n\n    if (redirectCount >= maxRedirects) {\n      beginClosingDispatcher(dispatcher);\n      return { response, url: currentTarget.url };\n    }\n\n    await cancelResponseBody(response);\n    await dispatcher.close();\n    let redirectUrl: URL;\n    try {\n      redirectUrl = new URL(location, currentTarget.url);\n    } catch {\n      throw new PublicUrlError(\"Redirect target is not a valid URL\");\n    }\n    currentTarget = await resolvePublicHttpUrl(redirectUrl);\n  }\n}\n\n/** Fetches bounded text from a public URL and rejects non-success responses. */\nexport async function fetchPublicText(\n  input: string | URL,\n  options: PublicTextOptions = {},\n): Promise<PublicTextResult> {\n  const maxBytes = options.maxBytes ?? 2_000_000;\n  assertPositiveInteger(maxBytes, \"maxBytes\");\n\n  const { response, url } = await fetchPublicHttp(input, {\n    method: \"GET\",\n    headers: options.headers,\n    timeoutMs: options.timeoutMs,\n    maxRedirects: options.maxRedirects,\n  });\n\n  if (!response.ok) {\n    const status = response.status;\n    await cancelResponseBody(response);\n    throw new Error(`URL returned HTTP status ${status}`);\n  }\n\n  const contentTypeHeader = response.headers.get(\"content-type\");\n  const contentType = contentTypeHeader?.split(\";\", 1)[0]?.trim().toLowerCase() || null;\n  if (\n    options.acceptedContentTypes\n    && !options.acceptedContentTypes.some((accepted) => accepted.trim().toLowerCase() === contentType)\n  ) {\n    await cancelResponseBody(response);\n    throw new Error(`URL returned unsupported content type ${contentType ?? \"missing\"}`);\n  }\n\n  const declaredEncoding = getDeclaredCharacterEncoding(contentTypeHeader);\n  const shouldSniffHtmlEncoding = contentType === \"text/html\"\n    && (declaredEncoding === undefined || !isSupportedCharacterEncoding(declaredEncoding));\n  const isXmlContentType = contentType !== null\n    && (contentType === \"application/xml\" || contentType === \"text/xml\" || contentType.endsWith(\"+xml\"));\n  const shouldSniffXmlEncoding = declaredEncoding === undefined\n    && isXmlContentType;\n  const shouldPreferXmlBom = declaredEncoding !== undefined && isXmlContentType;\n  return {\n    text: await readResponseText(\n      response,\n      maxBytes,\n      shouldSniffHtmlEncoding || shouldSniffXmlEncoding ? undefined : declaredEncoding,\n      shouldSniffHtmlEncoding,\n      shouldSniffXmlEncoding,\n      shouldPreferXmlBom,\n    ),\n    url: url.href,\n    status: response.status,\n    contentType: contentTypeHeader,\n  };\n}\n\n/** Reads a UTF-8 file only when it is a regular file within the requested cap. */\nexport async function readTextFile(filePath: string, maxBytes: number): Promise<string> {\n  assertPositiveInteger(maxBytes, \"maxBytes\");\n  const resolvedPath = path.resolve(filePath);\n  const stats = await fs.stat(resolvedPath);\n  if (!stats.isFile()) {\n    throw new Error(`Path is not a regular file: ${resolvedPath}`);\n  }\n  if (stats.size > maxBytes) {\n    throw new Error(`File exceeds the ${maxBytes}-byte limit: ${resolvedPath}`);\n  }\n\n  const contents = await fs.readFile(resolvedPath);\n  if (contents.byteLength > maxBytes) {\n    throw new Error(`File exceeds the ${maxBytes}-byte limit: ${resolvedPath}`);\n  }\n  return contents.toString(\"utf8\");\n}\n"]}

package/dist/screenshot.d.ts

@@ -12,7 +12,7 @@ export interface ScreenshotResult {
     outputPath: string;
 }
 export declare const SCREENSHOT_HEADLESS_MODE: "shell";
-export declare const SCREENSHOT_BROWSER_BUILD_ID = "152.0.7977.42";
+export declare const SCREENSHOT_BROWSER_BUILD_ID = "153.0.8010.36";
 type BrowserInstaller = (options: InstallOptions & {
     unpack?: true;
 }) => Promise<{

package/dist/screenshot.js

@@ -17,7 +17,7 @@ const MAX_VIEWPORT_DIMENSION = 7_680;
 const SAFE_VIEWPORT_NAME = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/;
 const NAVIGATION_TIMEOUT_MS = 30_000;
 export const SCREENSHOT_HEADLESS_MODE = "shell";
-export const SCREENSHOT_BROWSER_BUILD_ID = "152.0.7977.42";
+export const SCREENSHOT_BROWSER_BUILD_ID = "153.0.8010.36";
 export async function resolveScreenshotBrowserExecutable(options = {}) {
     const platform = options.platform ?? detectBrowserPlatform();
     if (!platform) {

package/dist/screenshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../src/screenshot.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Browser as ManagedBrowser,\n  computeExecutablePath,\n  detectBrowserPlatform,\n  install as installBrowser,\n  type BrowserPlatform,\n  type InstallOptions,\n} from \"@puppeteer/browsers\";\nimport puppeteer, { type Browser as PuppeteerBrowser } from \"puppeteer-core\";\nimport * as path from \"path\";\nimport * as fs from \"fs/promises\";\nimport * as os from \"node:os\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { assertPublicHttpUrl, getErrorMessage } from \"./network.js\";\nimport { startScreenshotTransportProxy } from \"./screenshot-proxy.js\";\n\nexport interface ViewportConfig {\n  name: string;\n  width: number;\n  height: number;\n}\n\nexport interface ScreenshotResult {\n  viewportName: string;\n  width: number;\n  height: number;\n  outputPath: string;\n}\n\nconst DEFAULT_VIEWPORTS: ViewportConfig[] = [\n  { name: \"desktop\", width: 1440, height: 900 },\n  { name: \"tablet\", width: 768, height: 1024 },\n  { name: \"mobile\", width: 375, height: 812 }\n];\n\nconst MAX_VIEWPORTS = 10;\nconst MIN_VIEWPORT_DIMENSION = 100;\nconst MAX_VIEWPORT_DIMENSION = 7_680;\nconst SAFE_VIEWPORT_NAME = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/;\nconst NAVIGATION_TIMEOUT_MS = 30_000;\n\nexport const SCREENSHOT_HEADLESS_MODE = \"shell\" as const;\nexport const SCREENSHOT_BROWSER_BUILD_ID = \"152.0.7977.42\";\n\ntype BrowserInstaller = (options: InstallOptions & { unpack?: true }) => Promise<{ executablePath: string }>;\n\nexport interface ScreenshotBrowserRuntime {\n  launch(proxyServer: string): Promise<PuppeteerBrowser>;\n}\n\nexport async function resolveScreenshotBrowserExecutable(options: {\n  cacheDir?: string;\n  platform?: BrowserPlatform;\n  installer?: BrowserInstaller;\n} = {}): Promise<string> {\n  const platform = options.platform ?? detectBrowserPlatform();\n  if (!platform) {\n    throw new Error(\"Screenshot capture is not supported on this operating system\");\n  }\n\n  const cacheDir = options.cacheDir\n    ?? process.env.PUPPETEER_CACHE_DIR\n    ?? path.join(os.homedir(), \".cache\", \"puppeteer\");\n  const browser = ManagedBrowser.CHROMEHEADLESSSHELL;\n  const executablePath = computeExecutablePath({\n    browser,\n    buildId: SCREENSHOT_BROWSER_BUILD_ID,\n    cacheDir,\n    platform,\n  });\n\n  try {\n    await fs.access(executablePath);\n    return executablePath;\n  } catch {\n    // First screenshot use installs only the verified headless shell, not full Chrome.\n  }\n\n  try {\n    const installed = await (options.installer ?? installBrowser)({\n      browser,\n      buildId: SCREENSHOT_BROWSER_BUILD_ID,\n      cacheDir,\n      platform,\n    });\n    return installed.executablePath;\n  } catch (cause: unknown) {\n    throw new Error(\n      `Screenshot browser setup failed: ${getErrorMessage(cause)}`,\n      { cause },\n    );\n  }\n}\n\nlet screenshotBrowserExecutablePromise: Promise<string> | undefined;\n\nconst defaultScreenshotBrowserRuntime: ScreenshotBrowserRuntime = {\n  async launch(proxyServer: string): Promise<PuppeteerBrowser> {\n    screenshotBrowserExecutablePromise ??= resolveScreenshotBrowserExecutable();\n    let executablePath: string;\n    try {\n      executablePath = await screenshotBrowserExecutablePromise;\n    } catch (cause) {\n      screenshotBrowserExecutablePromise = undefined;\n      throw cause;\n    }\n    return puppeteer.launch({\n      executablePath,\n      headless: SCREENSHOT_HEADLESS_MODE,\n      args: [\n        `--proxy-server=${proxyServer}`,\n        \"--proxy-bypass-list=<-loopback>\",\n      ],\n    });\n  },\n};\n\ninterface InterceptedRequest {\n  url(): string;\n  isInterceptResolutionHandled(): boolean;\n  continue(): Promise<unknown>;\n  abort(errorCode?: string): Promise<unknown>;\n}\n\nfunction validateViewports(viewports: ViewportConfig[]): ViewportConfig[] {\n  if (viewports.length === 0 || viewports.length > MAX_VIEWPORTS) {\n    throw new Error(`Between 1 and ${MAX_VIEWPORTS} viewports are required`);\n  }\n\n  const outputNames = new Set<string>();\n  return viewports.map((viewport, index) => {\n    if (!viewport || typeof viewport !== \"object\") {\n      throw new Error(`Viewport #${index + 1} must be an object`);\n    }\n    if (typeof viewport.name !== \"string\" || !SAFE_VIEWPORT_NAME.test(viewport.name)) {\n      throw new Error(\n        `Viewport #${index + 1} name must match ${SAFE_VIEWPORT_NAME.source}`,\n      );\n    }\n    for (const [label, value] of [[\"width\", viewport.width], [\"height\", viewport.height]] as const) {\n      if (\n        !Number.isSafeInteger(value)\n        || value < MIN_VIEWPORT_DIMENSION\n        || value > MAX_VIEWPORT_DIMENSION\n      ) {\n        throw new Error(\n          `Viewport #${index + 1} ${label} must be an integer between ${MIN_VIEWPORT_DIMENSION} and ${MAX_VIEWPORT_DIMENSION}`,\n        );\n      }\n    }\n\n    const outputName = `${viewport.name}_${viewport.width}x${viewport.height}.png`.toLowerCase();\n    if (outputNames.has(outputName)) {\n      throw new Error(`Duplicate viewport output filename: ${outputName}`);\n    }\n    outputNames.add(outputName);\n    return { name: viewport.name, width: viewport.width, height: viewport.height };\n  });\n}\n\nfunction resolveContainedOutputPath(outputDirectory: string, fileName: string): string {\n  const outputPath = path.resolve(outputDirectory, fileName);\n  const relativePath = path.relative(outputDirectory, outputPath);\n  if (relativePath.startsWith(\"..\") || path.isAbsolute(relativePath)) {\n    throw new Error(\"Screenshot output path escapes the requested output directory\");\n  }\n  return outputPath;\n}\n\nfunction isPathWithinDirectory(directory: string, filePath: string): boolean {\n  const relativePath = path.relative(directory, filePath);\n  return relativePath === \"\" || (!relativePath.startsWith(\"..\") && !path.isAbsolute(relativePath));\n}\n\nasync function assertLocalScreenshotRequestAllowed(requestUrl: URL, localDirectory: string): Promise<void> {\n  if (requestUrl.hostname) {\n    throw new Error(\"Blocked local file request with a host name\");\n  }\n\n  let resolvedPath: string;\n  try {\n    resolvedPath = await fs.realpath(fileURLToPath(requestUrl));\n  } catch (error: unknown) {\n    throw new Error(`Blocked local file request: ${getErrorMessage(error)}`);\n  }\n\n  if (!isPathWithinDirectory(localDirectory, resolvedPath)) {\n    throw new Error(\"Blocked local file request outside the selected file directory\");\n  }\n}\n\nasync function assertScreenshotRequestAllowed(requestUrl: string, localDirectory?: string): Promise<void> {\n  let parsedUrl: URL;\n  try {\n    parsedUrl = new URL(requestUrl);\n  } catch {\n    throw new Error(\"Blocked invalid page request URL\");\n  }\n\n  if (parsedUrl.protocol === \"http:\" || parsedUrl.protocol === \"https:\") {\n    await assertPublicHttpUrl(parsedUrl);\n    return;\n  }\n\n  if (parsedUrl.protocol === \"data:\" || parsedUrl.protocol === \"blob:\") {\n    return;\n  }\n\n  if (parsedUrl.protocol === \"file:\" && localDirectory) {\n    await assertLocalScreenshotRequestAllowed(parsedUrl, localDirectory);\n    return;\n  }\n\n  throw new Error(`Blocked unsupported page request protocol ${parsedUrl.protocol}`);\n}\n\nasync function resolveScreenshotRequest(\n  request: InterceptedRequest,\n  localDirectory: string | undefined,\n  onBlocked: (message: string) => void,\n): Promise<void> {\n  if (request.isInterceptResolutionHandled()) {\n    return;\n  }\n\n  try {\n    await assertScreenshotRequestAllowed(request.url(), localDirectory);\n    if (request.isInterceptResolutionHandled()) {\n      return;\n    }\n    await request.continue();\n  } catch (error: unknown) {\n    onBlocked(getErrorMessage(error));\n    if (request.isInterceptResolutionHandled()) {\n      return;\n    }\n    await request.abort(\"blockedbyclient\");\n  }\n}\n\n/**\n * Captures screenshots of a local HTML file or remote URL at different viewport sizes.\n * @param targetPath Local file path or HTTP(S) URL\n * @param outputDirectory Absolute path to save screenshots\n * @param customViewports Optional custom viewport settings\n */\nexport async function captureScreenshots(\n  targetPath: string,\n  outputDirectory: string,\n  customViewports?: ViewportConfig[],\n  browserRuntime: ScreenshotBrowserRuntime = defaultScreenshotBrowserRuntime,\n): Promise<ScreenshotResult[]> {\n  if (typeof targetPath !== \"string\" || targetPath.trim() === \"\") {\n    throw new Error(\"targetPath must be a non-empty string\");\n  }\n  if (typeof outputDirectory !== \"string\" || outputDirectory.trim() === \"\") {\n    throw new Error(\"outputDirectory must be a non-empty string\");\n  }\n\n  const viewports = validateViewports(\n    customViewports && customViewports.length > 0 ? customViewports : DEFAULT_VIEWPORTS,\n  );\n  const resolvedOutputDirectory = path.resolve(outputDirectory);\n\n  // Resolve target to file:// URL if it is a local file path\n  let targetUrl: string;\n  let localDirectory: string | undefined;\n  if (/^https?:\\/\\//i.test(targetPath)) {\n    targetUrl = (await assertPublicHttpUrl(targetPath)).href;\n  } else {\n    const absolutePath = path.resolve(targetPath);\n    const resolvedPath = await fs.realpath(absolutePath);\n    const stats = await fs.stat(resolvedPath);\n    if (!stats.isFile()) {\n      throw new Error(`Screenshot target is not a regular file: ${resolvedPath}`);\n    }\n    localDirectory = path.dirname(resolvedPath);\n    targetUrl = pathToFileURL(resolvedPath).href;\n  }\n\n  // Ensure output directory exists\n  await fs.mkdir(resolvedOutputDirectory, { recursive: true });\n\n  const results: ScreenshotResult[] = [];\n  let blockedRequestMessage: string | undefined;\n  const transportProxy = await startScreenshotTransportProxy((message) => {\n    blockedRequestMessage ??= message;\n  });\n  let browser: PuppeteerBrowser | undefined;\n\n  try {\n    browser = await browserRuntime.launch(transportProxy.url);\n    const page = await browser.newPage();\n    page.setDefaultNavigationTimeout(NAVIGATION_TIMEOUT_MS);\n\n    await page.setRequestInterception(true);\n    page.on(\"request\", (request) => {\n      void resolveScreenshotRequest(request, localDirectory, (message) => {\n        blockedRequestMessage ??= message;\n      }).catch(() => {\n        // Puppeteer will surface navigation failures; avoid an unhandled listener rejection.\n      });\n    });\n\n    for (const vp of viewports) {\n      await page.setViewport({\n        width: vp.width,\n        height: vp.height,\n        deviceScaleFactor: 1\n      });\n\n      // Load URL (wait until network is idle or DOM loaded)\n      try {\n        await page.goto(targetUrl, {\n          waitUntil: \"domcontentloaded\",\n          timeout: NAVIGATION_TIMEOUT_MS,\n        });\n      } catch (error: unknown) {\n        if (blockedRequestMessage) {\n          throw new Error(`Screenshot navigation blocked: ${blockedRequestMessage}`);\n        }\n        throw new Error(`Screenshot navigation failed: ${getErrorMessage(error)}`);\n      }\n\n      // Short wait for any animations or layout adjustments to settle\n      await new Promise((resolve) => setTimeout(resolve, 500));\n\n      const fileName = `${vp.name}_${vp.width}x${vp.height}.png`;\n      const outputPath = resolveContainedOutputPath(resolvedOutputDirectory, fileName);\n\n      await page.screenshot({\n        path: outputPath,\n        fullPage: false // Captures above the fold viewport\n      });\n\n      results.push({\n        viewportName: vp.name,\n        width: vp.width,\n        height: vp.height,\n        outputPath\n      });\n    }\n  } finally {\n    if (browser) {\n      await browser.close();\n    }\n    await transportProxy.close();\n  }\n\n  return results;\n}\n"]}
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../src/screenshot.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Browser as ManagedBrowser,\n  computeExecutablePath,\n  detectBrowserPlatform,\n  install as installBrowser,\n  type BrowserPlatform,\n  type InstallOptions,\n} from \"@puppeteer/browsers\";\nimport puppeteer, { type Browser as PuppeteerBrowser } from \"puppeteer-core\";\nimport * as path from \"path\";\nimport * as fs from \"fs/promises\";\nimport * as os from \"node:os\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { assertPublicHttpUrl, getErrorMessage } from \"./network.js\";\nimport { startScreenshotTransportProxy } from \"./screenshot-proxy.js\";\n\nexport interface ViewportConfig {\n  name: string;\n  width: number;\n  height: number;\n}\n\nexport interface ScreenshotResult {\n  viewportName: string;\n  width: number;\n  height: number;\n  outputPath: string;\n}\n\nconst DEFAULT_VIEWPORTS: ViewportConfig[] = [\n  { name: \"desktop\", width: 1440, height: 900 },\n  { name: \"tablet\", width: 768, height: 1024 },\n  { name: \"mobile\", width: 375, height: 812 }\n];\n\nconst MAX_VIEWPORTS = 10;\nconst MIN_VIEWPORT_DIMENSION = 100;\nconst MAX_VIEWPORT_DIMENSION = 7_680;\nconst SAFE_VIEWPORT_NAME = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/;\nconst NAVIGATION_TIMEOUT_MS = 30_000;\n\nexport const SCREENSHOT_HEADLESS_MODE = \"shell\" as const;\nexport const SCREENSHOT_BROWSER_BUILD_ID = \"153.0.8010.36\";\n\ntype BrowserInstaller = (options: InstallOptions & { unpack?: true }) => Promise<{ executablePath: string }>;\n\nexport interface ScreenshotBrowserRuntime {\n  launch(proxyServer: string): Promise<PuppeteerBrowser>;\n}\n\nexport async function resolveScreenshotBrowserExecutable(options: {\n  cacheDir?: string;\n  platform?: BrowserPlatform;\n  installer?: BrowserInstaller;\n} = {}): Promise<string> {\n  const platform = options.platform ?? detectBrowserPlatform();\n  if (!platform) {\n    throw new Error(\"Screenshot capture is not supported on this operating system\");\n  }\n\n  const cacheDir = options.cacheDir\n    ?? process.env.PUPPETEER_CACHE_DIR\n    ?? path.join(os.homedir(), \".cache\", \"puppeteer\");\n  const browser = ManagedBrowser.CHROMEHEADLESSSHELL;\n  const executablePath = computeExecutablePath({\n    browser,\n    buildId: SCREENSHOT_BROWSER_BUILD_ID,\n    cacheDir,\n    platform,\n  });\n\n  try {\n    await fs.access(executablePath);\n    return executablePath;\n  } catch {\n    // First screenshot use installs only the verified headless shell, not full Chrome.\n  }\n\n  try {\n    const installed = await (options.installer ?? installBrowser)({\n      browser,\n      buildId: SCREENSHOT_BROWSER_BUILD_ID,\n      cacheDir,\n      platform,\n    });\n    return installed.executablePath;\n  } catch (cause: unknown) {\n    throw new Error(\n      `Screenshot browser setup failed: ${getErrorMessage(cause)}`,\n      { cause },\n    );\n  }\n}\n\nlet screenshotBrowserExecutablePromise: Promise<string> | undefined;\n\nconst defaultScreenshotBrowserRuntime: ScreenshotBrowserRuntime = {\n  async launch(proxyServer: string): Promise<PuppeteerBrowser> {\n    screenshotBrowserExecutablePromise ??= resolveScreenshotBrowserExecutable();\n    let executablePath: string;\n    try {\n      executablePath = await screenshotBrowserExecutablePromise;\n    } catch (cause) {\n      screenshotBrowserExecutablePromise = undefined;\n      throw cause;\n    }\n    return puppeteer.launch({\n      executablePath,\n      headless: SCREENSHOT_HEADLESS_MODE,\n      args: [\n        `--proxy-server=${proxyServer}`,\n        \"--proxy-bypass-list=<-loopback>\",\n      ],\n    });\n  },\n};\n\ninterface InterceptedRequest {\n  url(): string;\n  isInterceptResolutionHandled(): boolean;\n  continue(): Promise<unknown>;\n  abort(errorCode?: string): Promise<unknown>;\n}\n\nfunction validateViewports(viewports: ViewportConfig[]): ViewportConfig[] {\n  if (viewports.length === 0 || viewports.length > MAX_VIEWPORTS) {\n    throw new Error(`Between 1 and ${MAX_VIEWPORTS} viewports are required`);\n  }\n\n  const outputNames = new Set<string>();\n  return viewports.map((viewport, index) => {\n    if (!viewport || typeof viewport !== \"object\") {\n      throw new Error(`Viewport #${index + 1} must be an object`);\n    }\n    if (typeof viewport.name !== \"string\" || !SAFE_VIEWPORT_NAME.test(viewport.name)) {\n      throw new Error(\n        `Viewport #${index + 1} name must match ${SAFE_VIEWPORT_NAME.source}`,\n      );\n    }\n    for (const [label, value] of [[\"width\", viewport.width], [\"height\", viewport.height]] as const) {\n      if (\n        !Number.isSafeInteger(value)\n        || value < MIN_VIEWPORT_DIMENSION\n        || value > MAX_VIEWPORT_DIMENSION\n      ) {\n        throw new Error(\n          `Viewport #${index + 1} ${label} must be an integer between ${MIN_VIEWPORT_DIMENSION} and ${MAX_VIEWPORT_DIMENSION}`,\n        );\n      }\n    }\n\n    const outputName = `${viewport.name}_${viewport.width}x${viewport.height}.png`.toLowerCase();\n    if (outputNames.has(outputName)) {\n      throw new Error(`Duplicate viewport output filename: ${outputName}`);\n    }\n    outputNames.add(outputName);\n    return { name: viewport.name, width: viewport.width, height: viewport.height };\n  });\n}\n\nfunction resolveContainedOutputPath(outputDirectory: string, fileName: string): string {\n  const outputPath = path.resolve(outputDirectory, fileName);\n  const relativePath = path.relative(outputDirectory, outputPath);\n  if (relativePath.startsWith(\"..\") || path.isAbsolute(relativePath)) {\n    throw new Error(\"Screenshot output path escapes the requested output directory\");\n  }\n  return outputPath;\n}\n\nfunction isPathWithinDirectory(directory: string, filePath: string): boolean {\n  const relativePath = path.relative(directory, filePath);\n  return relativePath === \"\" || (!relativePath.startsWith(\"..\") && !path.isAbsolute(relativePath));\n}\n\nasync function assertLocalScreenshotRequestAllowed(requestUrl: URL, localDirectory: string): Promise<void> {\n  if (requestUrl.hostname) {\n    throw new Error(\"Blocked local file request with a host name\");\n  }\n\n  let resolvedPath: string;\n  try {\n    resolvedPath = await fs.realpath(fileURLToPath(requestUrl));\n  } catch (error: unknown) {\n    throw new Error(`Blocked local file request: ${getErrorMessage(error)}`);\n  }\n\n  if (!isPathWithinDirectory(localDirectory, resolvedPath)) {\n    throw new Error(\"Blocked local file request outside the selected file directory\");\n  }\n}\n\nasync function assertScreenshotRequestAllowed(requestUrl: string, localDirectory?: string): Promise<void> {\n  let parsedUrl: URL;\n  try {\n    parsedUrl = new URL(requestUrl);\n  } catch {\n    throw new Error(\"Blocked invalid page request URL\");\n  }\n\n  if (parsedUrl.protocol === \"http:\" || parsedUrl.protocol === \"https:\") {\n    await assertPublicHttpUrl(parsedUrl);\n    return;\n  }\n\n  if (parsedUrl.protocol === \"data:\" || parsedUrl.protocol === \"blob:\") {\n    return;\n  }\n\n  if (parsedUrl.protocol === \"file:\" && localDirectory) {\n    await assertLocalScreenshotRequestAllowed(parsedUrl, localDirectory);\n    return;\n  }\n\n  throw new Error(`Blocked unsupported page request protocol ${parsedUrl.protocol}`);\n}\n\nasync function resolveScreenshotRequest(\n  request: InterceptedRequest,\n  localDirectory: string | undefined,\n  onBlocked: (message: string) => void,\n): Promise<void> {\n  if (request.isInterceptResolutionHandled()) {\n    return;\n  }\n\n  try {\n    await assertScreenshotRequestAllowed(request.url(), localDirectory);\n    if (request.isInterceptResolutionHandled()) {\n      return;\n    }\n    await request.continue();\n  } catch (error: unknown) {\n    onBlocked(getErrorMessage(error));\n    if (request.isInterceptResolutionHandled()) {\n      return;\n    }\n    await request.abort(\"blockedbyclient\");\n  }\n}\n\n/**\n * Captures screenshots of a local HTML file or remote URL at different viewport sizes.\n * @param targetPath Local file path or HTTP(S) URL\n * @param outputDirectory Absolute path to save screenshots\n * @param customViewports Optional custom viewport settings\n */\nexport async function captureScreenshots(\n  targetPath: string,\n  outputDirectory: string,\n  customViewports?: ViewportConfig[],\n  browserRuntime: ScreenshotBrowserRuntime = defaultScreenshotBrowserRuntime,\n): Promise<ScreenshotResult[]> {\n  if (typeof targetPath !== \"string\" || targetPath.trim() === \"\") {\n    throw new Error(\"targetPath must be a non-empty string\");\n  }\n  if (typeof outputDirectory !== \"string\" || outputDirectory.trim() === \"\") {\n    throw new Error(\"outputDirectory must be a non-empty string\");\n  }\n\n  const viewports = validateViewports(\n    customViewports && customViewports.length > 0 ? customViewports : DEFAULT_VIEWPORTS,\n  );\n  const resolvedOutputDirectory = path.resolve(outputDirectory);\n\n  // Resolve target to file:// URL if it is a local file path\n  let targetUrl: string;\n  let localDirectory: string | undefined;\n  if (/^https?:\\/\\//i.test(targetPath)) {\n    targetUrl = (await assertPublicHttpUrl(targetPath)).href;\n  } else {\n    const absolutePath = path.resolve(targetPath);\n    const resolvedPath = await fs.realpath(absolutePath);\n    const stats = await fs.stat(resolvedPath);\n    if (!stats.isFile()) {\n      throw new Error(`Screenshot target is not a regular file: ${resolvedPath}`);\n    }\n    localDirectory = path.dirname(resolvedPath);\n    targetUrl = pathToFileURL(resolvedPath).href;\n  }\n\n  // Ensure output directory exists\n  await fs.mkdir(resolvedOutputDirectory, { recursive: true });\n\n  const results: ScreenshotResult[] = [];\n  let blockedRequestMessage: string | undefined;\n  const transportProxy = await startScreenshotTransportProxy((message) => {\n    blockedRequestMessage ??= message;\n  });\n  let browser: PuppeteerBrowser | undefined;\n\n  try {\n    browser = await browserRuntime.launch(transportProxy.url);\n    const page = await browser.newPage();\n    page.setDefaultNavigationTimeout(NAVIGATION_TIMEOUT_MS);\n\n    await page.setRequestInterception(true);\n    page.on(\"request\", (request) => {\n      void resolveScreenshotRequest(request, localDirectory, (message) => {\n        blockedRequestMessage ??= message;\n      }).catch(() => {\n        // Puppeteer will surface navigation failures; avoid an unhandled listener rejection.\n      });\n    });\n\n    for (const vp of viewports) {\n      await page.setViewport({\n        width: vp.width,\n        height: vp.height,\n        deviceScaleFactor: 1\n      });\n\n      // Load URL (wait until network is idle or DOM loaded)\n      try {\n        await page.goto(targetUrl, {\n          waitUntil: \"domcontentloaded\",\n          timeout: NAVIGATION_TIMEOUT_MS,\n        });\n      } catch (error: unknown) {\n        if (blockedRequestMessage) {\n          throw new Error(`Screenshot navigation blocked: ${blockedRequestMessage}`);\n        }\n        throw new Error(`Screenshot navigation failed: ${getErrorMessage(error)}`);\n      }\n\n      // Short wait for any animations or layout adjustments to settle\n      await new Promise((resolve) => setTimeout(resolve, 500));\n\n      const fileName = `${vp.name}_${vp.width}x${vp.height}.png`;\n      const outputPath = resolveContainedOutputPath(resolvedOutputDirectory, fileName);\n\n      await page.screenshot({\n        path: outputPath,\n        fullPage: false // Captures above the fold viewport\n      });\n\n      results.push({\n        viewportName: vp.name,\n        width: vp.width,\n        height: vp.height,\n        outputPath\n      });\n    }\n  } finally {\n    if (browser) {\n      await browser.close();\n    }\n    await transportProxy.close();\n  }\n\n  return results;\n}\n"]}

package/dist/seo-auditor.js

@@ -134,7 +134,8 @@ export function auditSeoMetadataDetailed(htmlContent) {
             .split(/[\t\n\f\r ]+/)
             .some((token) => token.toLowerCase() === "canonical");
     });
-    const usableCanonical = canonicalLinks.filter((_, element) => Boolean($(element).attr("href")?.trim()));
+    const nonEmptyCanonical = canonicalLinks.filter((_, element) => Boolean($(element).attr("href")?.trim()));
+    const usableCanonical = nonEmptyCanonical.filter((_, element) => !["hreflang", "lang", "media", "type"].some((attribute) => $(element).attr(attribute) !== undefined));
     if (canonicalLinks.length === 0) {
         add({
             code: "seo.canonical.missing",
@@ -144,11 +145,29 @@ export function auditSeoMetadataDetailed(htmlContent) {
         });
     }
     else if (usableCanonical.length === 0) {
+        if (nonEmptyCanonical.length > 0) {
+            add({
+                code: "seo.canonical.unusable",
+                severity: "warning",
+                category: "SEO",
+                message: "Canonical link is present but uses attributes Google ignores for canonicalization. Use a plain rel=\"canonical\" link in <head>.",
+            });
+        }
+        else {
+            add({
+                code: "seo.canonical.missing",
+                severity: "warning",
+                category: "SEO",
+                message: "Canonical link is present but its href is empty. Provide a usable canonical target or remove the declaration.",
+            });
+        }
+    }
+    else if (usableCanonical.length > 1) {
         add({
-            code: "seo.canonical.missing",
+            code: "seo.canonical.multiple",
             severity: "warning",
             category: "SEO",
-            message: "Canonical link is present but its href is empty. Provide a usable canonical target or remove the declaration.",
+            message: "Multiple usable canonical link relations are declared. Keep one unambiguous canonical target.",
         });
     }
     // --- Viewport Meta Tag (Mobile Responsiveness) ---
@@ -161,6 +180,14 @@ export function auditSeoMetadataDetailed(htmlContent) {
             message: "Missing <meta name=\"viewport\"> tag. Review mobile rendering; this tag helps browsers size and scale the page on mobile devices.",
         });
     }
+    else if (viewport.filter((_, element) => Boolean($(element).attr("content")?.trim())).length === 0) {
+        add({
+            code: "seo.viewport.unusable",
+            severity: "error",
+            category: "SEO",
+            message: "Viewport meta tag is present but its content is empty. Provide viewport settings such as width=device-width.",
+        });
+    }
     // --- Heading Structure ---
     const h1Tags = $("h1");
     if (h1Tags.length === 0) {

package/dist/seo-auditor.js.map

@@ -1 +1 @@
-{"version":3,"file":"seo-auditor.js","sourceRoot":"","sources":["../src/seo-auditor.ts"],"names":[],"mappings":"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","sourcesContent":["import * as cheerio from \"cheerio\";\nimport {\n  assertPublicHttpUrl,\n  cancelResponseBody,\n  fetchPublicHttp,\n  getErrorMessage,\n  PublicUrlError,\n} from \"./network.js\";\nimport { PACKAGE_VERSION } from \"./version.js\";\n\nexport const MAX_AUDIT_ISSUES = 200;\nexport const MAX_LINKS_TO_CHECK = 25;\nconst LINK_CHECK_CONCURRENCY = 5;\nconst LINK_CHECK_TIMEOUT_MS = 5_000;\nconst LINK_CHECK_USER_AGENT = `mcp-web-validator/${PACKAGE_VERSION} (+https://digestseo.com/validator-mcp/)`;\n\nexport interface SEOIssue {\n  code: string;\n  severity: \"error\" | \"warning\" | \"info\";\n  category: \"SEO\" | \"Schema\" | \"BrokenLinks\" | \"Accessibility\";\n  message: string;\n  element?: string;\n}\n\nexport interface LinkStatus {\n  url: string;\n  status: number | string;\n  ok: boolean;\n  message?: string;\n}\n\nexport interface AuditCounts {\n  error: number;\n  warning: number;\n  info: number;\n}\n\nexport interface AuditDetails {\n  issues: SEOIssue[];\n  totalIssues: number;\n  truncated: boolean;\n  counts: AuditCounts;\n}\n\nfunction addIssue(issues: SEOIssue[], issue: SEOIssue): void {\n  if (issues.length < MAX_AUDIT_ISSUES) {\n    issues.push(issue);\n  }\n}\n\nfunction createIssueCollector(): {\n  issues: SEOIssue[];\n  add: (issue: SEOIssue) => void;\n  details: () => AuditDetails;\n} {\n  const issues: SEOIssue[] = [];\n  let totalIssues = 0;\n  const counts: AuditCounts = { error: 0, warning: 0, info: 0 };\n  return {\n    issues,\n    add(issue) {\n      totalIssues += 1;\n      counts[issue.severity] += 1;\n      addIssue(issues, issue);\n    },\n    details() {\n      return {\n        issues,\n        totalIssues,\n        truncated: totalIssues > issues.length,\n        counts: { ...counts },\n      };\n    },\n  };\n}\n\nfunction isJsonLdScriptType(type: string | undefined): boolean {\n  return type?.split(\";\", 1)[0].trim().toLowerCase() === \"application/ld+json\";\n}\n\nfunction hasJsonLdDocumentShape(value: unknown): boolean {\n  if (Array.isArray(value)) {\n    return value.every((entry) => typeof entry === \"object\" && entry !== null && !Array.isArray(entry));\n  }\n  return typeof value === \"object\" && value !== null;\n}\n\n/**\n * Audits technical SEO and accessibility basics on HTML content using Cheerio\n */\nexport function auditSeoMetadataDetailed(htmlContent: string): AuditDetails {\n  const $ = cheerio.load(htmlContent);\n  const collector = createIssueCollector();\n  const { add } = collector;\n\n  // --- Title Tag Audits ---\n  const titleTag = $(\"head > title\");\n  if (titleTag.length === 0) {\n    add({\n      code: \"seo.title.missing_or_empty\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Missing <title> tag. Add a concise, descriptive title to help represent the page in search results.\",\n    });\n  } else {\n    const titleText = titleTag.text().trim();\n    if (titleText.length === 0) {\n      add({\n        code: \"seo.title.missing_or_empty\",\n        severity: \"error\",\n        category: \"SEO\",\n        message: \"The <title> tag is empty.\",\n      });\n    } else if (titleText.length < 30) {\n      add({\n        code: \"seo.title.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Title is ${titleText.length} characters. This is shorter than the audit's common editorial range; review whether it describes the page clearly.`,\n        element: `<title>${titleText}</title>`,\n      });\n    } else if (titleText.length > 60) {\n      add({\n        code: \"seo.title.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Title is ${titleText.length} characters. This is longer than the audit's common editorial range; Google title links may be shortened or rewritten depending on context and device.`,\n        element: `<title>${titleText}</title>`,\n      });\n    }\n  }\n\n  // --- Meta Description Audits ---\n  const metaDescription = $('head > meta[name=\"description\" i]');\n  if (metaDescription.length === 0) {\n    add({\n      code: \"seo.meta_description.missing_or_empty\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Missing <meta name=\\\"description\\\">. Add a concise, accurate page summary; Google may use page content or this description to generate a snippet.\",\n    });\n  } else {\n    const descText = metaDescription.attr(\"content\")?.trim() || \"\";\n    if (descText.length === 0) {\n      add({\n        code: \"seo.meta_description.missing_or_empty\",\n        severity: \"error\",\n        category: \"SEO\",\n        message: \"Meta description content attribute is empty.\",\n      });\n    } else if (descText.length < 120) {\n      add({\n        code: \"seo.meta_description.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Meta description is ${descText.length} characters. This is shorter than the audit's common editorial range; review whether it provides a useful page summary.`,\n        element: `<meta name=\"description\" content=\"${descText}\">`,\n      });\n    } else if (descText.length > 160) {\n      add({\n        code: \"seo.meta_description.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Meta description is ${descText.length} characters. This is longer than the audit's common editorial range; displayed snippets may be shortened depending on the query and device.`,\n        element: `<meta name=\"description\" content=\"${descText}\">`,\n      });\n    }\n  }\n\n  // --- Canonical Link ---\n  const canonicalLinks = $(\"head > link[rel]\").filter((_, element) => {\n    const rel = $(element).attr(\"rel\") ?? \"\";\n    return rel\n      .trim()\n      .split(/[\\t\\n\\f\\r ]+/)\n      .some((token) => token.toLowerCase() === \"canonical\");\n  });\n  const usableCanonical = canonicalLinks.filter((_, element) => Boolean($(element).attr(\"href\")?.trim()));\n  if (canonicalLinks.length === 0) {\n    add({\n      code: \"seo.canonical.missing\",\n      severity: \"info\",\n      category: \"SEO\",\n      message: \"No rel=\\\"canonical\\\" preference is declared. This is optional unless the page needs an explicit canonicalization signal.\",\n    });\n  } else if (usableCanonical.length === 0) {\n    add({\n      code: \"seo.canonical.missing\",\n      severity: \"warning\",\n      category: \"SEO\",\n      message: \"Canonical link is present but its href is empty. Provide a usable canonical target or remove the declaration.\",\n    });\n  }\n\n  // --- Viewport Meta Tag (Mobile Responsiveness) ---\n  const viewport = $('head > meta[name=\"viewport\" i]');\n  if (viewport.length === 0) {\n    add({\n      code: \"seo.viewport.missing\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Missing <meta name=\\\"viewport\\\"> tag. Review mobile rendering; this tag helps browsers size and scale the page on mobile devices.\",\n    });\n  }\n\n  // --- Heading Structure ---\n  const h1Tags = $(\"h1\");\n  if (h1Tags.length === 0) {\n    add({\n      code: \"seo.h1.missing\",\n      severity: \"warning\",\n      category: \"SEO\",\n      message: \"No <h1> heading found. Review whether the page has a clear main heading and a meaningful heading hierarchy.\",\n    });\n  } else if (h1Tags.length > 1) {\n    add({\n      code: \"seo.h1.multiple\",\n      severity: \"info\",\n      category: \"SEO\",\n      message: `Found multiple (${h1Tags.length}) <h1> headings. Multiple H1s are not inherently an SEO error; ensure the heading hierarchy is meaningful and the main visual title is clear.`,\n    });\n  }\n\n  // --- Images Alt Tags (SEO + Accessibility) ---\n  $(\"img\").each((_, element) => {\n    const img = $(element);\n    const src = img.attr(\"src\") || \"unknown-source\";\n    const alt = img.attr(\"alt\");\n\n    if (alt === undefined) {\n      add({\n        code: \"accessibility.image_alt.missing\",\n        severity: \"error\",\n        category: \"Accessibility\",\n        message: \"Missing 'alt' attribute on image. This makes it inaccessible to screen readers.\",\n        element: `<img src=\"${src}\">`,\n      });\n    } else if (alt.trim() === \"\") {\n      // Empty alt is acceptable for purely decorative images, but worth warning\n      add({\n        code: \"accessibility.image_alt.empty\",\n        severity: \"info\",\n        category: \"Accessibility\",\n        message: \"Empty 'alt' attribute found. Ensure this image is purely decorative, otherwise add descriptive text.\",\n        element: `<img src=\"${src}\" alt=\"\">`,\n      });\n    }\n  });\n\n  // --- Open Graph / Social Tags ---\n  const ogTitle = $('head > meta[property=\"og:title\"]');\n  const ogImage = $('head > meta[property=\"og:image\"]');\n  if (ogTitle.length === 0 || ogImage.length === 0) {\n    add({\n      code: \"seo.open_graph.missing\",\n      severity: \"info\",\n      category: \"SEO\",\n      message: \"Missing Open Graph social metadata (og:title / og:image). Add these to control preview cards on platforms like LinkedIn and X.\",\n    });\n  }\n\n  return collector.details();\n}\n\nexport function auditSeoMetadata(htmlContent: string): SEOIssue[] {\n  return auditSeoMetadataDetailed(htmlContent).issues;\n}\n\n/**\n * Parses and validates JSON-LD Schema markup\n */\nexport function validateSchemaMarkupDetailed(htmlContent: string): AuditDetails {\n  const $ = cheerio.load(htmlContent);\n  const collector = createIssueCollector();\n  const { add } = collector;\n  const blocks = $(\"script[type]\").filter((_, element) => isJsonLdScriptType($(element).attr(\"type\")));\n\n  blocks.each((index, element) => {\n    const scriptText = $(element).html() || \"\";\n    if (scriptText.trim() === \"\") {\n      add({\n        code: \"schema.jsonld.empty\",\n        severity: \"warning\",\n        category: \"Schema\",\n        message: `JSON-LD block #${index + 1} is empty.`,\n      });\n      return;\n    }\n\n    try {\n      const parsed = JSON.parse(scriptText) as unknown;\n      if (!hasJsonLdDocumentShape(parsed)) {\n        add({\n          code: \"schema.jsonld.invalid_document\",\n          severity: \"error\",\n          category: \"Schema\",\n          message: \"Invalid JSON-LD document shape: the top level must be an object or an array of objects.\",\n          element: `<script type=\"application/ld+json\">...</script>`,\n        });\n      }\n    } catch (error: unknown) {\n      add({\n        code: \"schema.jsonld.invalid_json\",\n        severity: \"error\",\n        category: \"Schema\",\n        message: `Invalid JSON-LD schema syntax: ${getErrorMessage(error)}`,\n        element: `<script type=\"application/ld+json\">...</script>`,\n      });\n    }\n  });\n\n  return collector.details();\n}\n\nexport function validateSchemaMarkup(htmlContent: string): SEOIssue[] {\n  return validateSchemaMarkupDetailed(htmlContent).issues;\n}\n\n/**\n * Extracts and tests links, treating 3xx responses as reachable redirects and 4xx/5xx as broken.\n */\nexport async function checkBrokenLinks(\n  htmlContent: string,\n  baseUrl?: string,\n  maxLinks = MAX_LINKS_TO_CHECK,\n): Promise<LinkStatus[]> {\n  if (!Number.isSafeInteger(maxLinks) || maxLinks <= 0) {\n    throw new Error(\"maxLinks must be a positive integer\");\n  }\n  const linkLimit = Math.min(maxLinks, MAX_LINKS_TO_CHECK);\n  const $ = cheerio.load(htmlContent);\n  const fallbackBaseUrl = baseUrl ? await assertPublicHttpUrl(baseUrl) : undefined;\n  let parsedBaseUrl = fallbackBaseUrl;\n  const documentBaseHref = $(\"base[href]\").first().attr(\"href\");\n  if (documentBaseHref !== undefined) {\n    let resolvedDocumentBase: URL | undefined;\n    try {\n      resolvedDocumentBase = fallbackBaseUrl\n        ? new URL(documentBaseHref, fallbackBaseUrl)\n        : new URL(documentBaseHref);\n    } catch {\n      parsedBaseUrl = undefined;\n    }\n    if (resolvedDocumentBase) {\n      try {\n        parsedBaseUrl = await assertPublicHttpUrl(resolvedDocumentBase);\n      } catch (error: unknown) {\n        if (!(error instanceof PublicUrlError)) {\n          throw error;\n        }\n        parsedBaseUrl = undefined;\n      }\n    }\n  }\n  const urls: string[] = [];\n  const seenUrls = new Set<string>();\n\n  $(\"a\").each((_, element) => {\n    if (urls.length >= linkLimit) {\n      return false;\n    }\n\n    const href = $(element).attr(\"href\")?.trim();\n    if (!href || href.startsWith(\"#\")) {\n      return;\n    }\n\n    let resolvedUrl: URL;\n    try {\n      resolvedUrl = parsedBaseUrl ? new URL(href, parsedBaseUrl) : new URL(href);\n    } catch {\n      // Relative links require a public base URL; unsupported or malformed links are skipped.\n      return;\n    }\n\n    if (resolvedUrl.protocol !== \"http:\" && resolvedUrl.protocol !== \"https:\") {\n      return;\n    }\n\n    resolvedUrl.hash = \"\";\n    const normalizedUrl = resolvedUrl.href;\n    if (!seenUrls.has(normalizedUrl)) {\n      seenUrls.add(normalizedUrl);\n      urls.push(normalizedUrl);\n    }\n  });\n\n  const results = new Array<LinkStatus>(urls.length);\n  let nextIndex = 0;\n\n  async function checkLink(url: string): Promise<LinkStatus> {\n    try {\n      const headResult = await fetchPublicHttp(url, {\n        method: \"HEAD\",\n        headers: { \"User-Agent\": LINK_CHECK_USER_AGENT },\n        timeoutMs: LINK_CHECK_TIMEOUT_MS,\n        maxRedirects: 0,\n      });\n      const headStatus = headResult.response.status;\n      const headFinalUrl = headResult.url.href;\n      await cancelResponseBody(headResult.response);\n\n      // Some sites reject or do not implement HEAD even when the linked resource is available.\n      if (headStatus === 405 || headStatus === 403 || headStatus === 501) {\n        let getResult = await fetchPublicHttp(url, {\n          method: \"GET\",\n          headers: {\n            Range: \"bytes=0-0\",\n            \"User-Agent\": LINK_CHECK_USER_AGENT,\n          },\n          timeoutMs: LINK_CHECK_TIMEOUT_MS,\n          maxRedirects: 0,\n        });\n        if (getResult.response.status === 416) {\n          await cancelResponseBody(getResult.response);\n          getResult = await fetchPublicHttp(url, {\n            method: \"GET\",\n            headers: { \"User-Agent\": LINK_CHECK_USER_AGENT },\n            timeoutMs: LINK_CHECK_TIMEOUT_MS,\n            maxRedirects: 0,\n          });\n        }\n\n        const status = getResult.response.status;\n        const ok = status >= 200 && status < 400;\n        const finalUrl = getResult.url.href;\n        await cancelResponseBody(getResult.response);\n        return {\n          url,\n          status,\n          ok,\n          message:\n            status >= 300 && status < 400\n              ? \"Redirect not followed\"\n              : finalUrl !== url\n                ? `Redirected to ${finalUrl}`\n                : undefined,\n        };\n      }\n\n      return {\n        url,\n        status: headStatus,\n        ok: headStatus >= 200 && headStatus < 400,\n        message:\n          headStatus >= 300 && headStatus < 400\n            ? \"Redirect not followed\"\n            : headFinalUrl !== url\n              ? `Redirected to ${headFinalUrl}`\n              : undefined,\n      };\n    } catch (error: unknown) {\n      return {\n        url,\n        status: error instanceof PublicUrlError ? \"blocked\" : \"failed\",\n        ok: false,\n        message: getErrorMessage(error),\n      };\n    }\n  }\n\n  async function worker(): Promise<void> {\n    while (true) {\n      const index = nextIndex;\n      nextIndex += 1;\n      if (index >= urls.length) {\n        return;\n      }\n      results[index] = await checkLink(urls[index]);\n    }\n  }\n\n  const workerCount = Math.min(LINK_CHECK_CONCURRENCY, urls.length);\n  await Promise.all(Array.from({ length: workerCount }, () => worker()));\n  return results;\n}\n"]}
+{"version":3,"file":"seo-auditor.js","sourceRoot":"","sources":["../src/seo-auditor.ts"],"names":[],"mappings":"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","sourcesContent":["import * as cheerio from \"cheerio\";\nimport {\n  assertPublicHttpUrl,\n  cancelResponseBody,\n  fetchPublicHttp,\n  getErrorMessage,\n  PublicUrlError,\n} from \"./network.js\";\nimport { PACKAGE_VERSION } from \"./version.js\";\n\nexport const MAX_AUDIT_ISSUES = 200;\nexport const MAX_LINKS_TO_CHECK = 25;\nconst LINK_CHECK_CONCURRENCY = 5;\nconst LINK_CHECK_TIMEOUT_MS = 5_000;\nconst LINK_CHECK_USER_AGENT = `mcp-web-validator/${PACKAGE_VERSION} (+https://digestseo.com/validator-mcp/)`;\n\nexport interface SEOIssue {\n  code: string;\n  severity: \"error\" | \"warning\" | \"info\";\n  category: \"SEO\" | \"Schema\" | \"BrokenLinks\" | \"Accessibility\";\n  message: string;\n  element?: string;\n}\n\nexport interface LinkStatus {\n  url: string;\n  status: number | string;\n  ok: boolean;\n  message?: string;\n}\n\nexport interface AuditCounts {\n  error: number;\n  warning: number;\n  info: number;\n}\n\nexport interface AuditDetails {\n  issues: SEOIssue[];\n  totalIssues: number;\n  truncated: boolean;\n  counts: AuditCounts;\n}\n\nfunction addIssue(issues: SEOIssue[], issue: SEOIssue): void {\n  if (issues.length < MAX_AUDIT_ISSUES) {\n    issues.push(issue);\n  }\n}\n\nfunction createIssueCollector(): {\n  issues: SEOIssue[];\n  add: (issue: SEOIssue) => void;\n  details: () => AuditDetails;\n} {\n  const issues: SEOIssue[] = [];\n  let totalIssues = 0;\n  const counts: AuditCounts = { error: 0, warning: 0, info: 0 };\n  return {\n    issues,\n    add(issue) {\n      totalIssues += 1;\n      counts[issue.severity] += 1;\n      addIssue(issues, issue);\n    },\n    details() {\n      return {\n        issues,\n        totalIssues,\n        truncated: totalIssues > issues.length,\n        counts: { ...counts },\n      };\n    },\n  };\n}\n\nfunction isJsonLdScriptType(type: string | undefined): boolean {\n  return type?.split(\";\", 1)[0].trim().toLowerCase() === \"application/ld+json\";\n}\n\nfunction hasJsonLdDocumentShape(value: unknown): boolean {\n  if (Array.isArray(value)) {\n    return value.every((entry) => typeof entry === \"object\" && entry !== null && !Array.isArray(entry));\n  }\n  return typeof value === \"object\" && value !== null;\n}\n\n/**\n * Audits technical SEO and accessibility basics on HTML content using Cheerio\n */\nexport function auditSeoMetadataDetailed(htmlContent: string): AuditDetails {\n  const $ = cheerio.load(htmlContent);\n  const collector = createIssueCollector();\n  const { add } = collector;\n\n  // --- Title Tag Audits ---\n  const titleTag = $(\"head > title\");\n  if (titleTag.length === 0) {\n    add({\n      code: \"seo.title.missing_or_empty\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Missing <title> tag. Add a concise, descriptive title to help represent the page in search results.\",\n    });\n  } else {\n    const titleText = titleTag.text().trim();\n    if (titleText.length === 0) {\n      add({\n        code: \"seo.title.missing_or_empty\",\n        severity: \"error\",\n        category: \"SEO\",\n        message: \"The <title> tag is empty.\",\n      });\n    } else if (titleText.length < 30) {\n      add({\n        code: \"seo.title.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Title is ${titleText.length} characters. This is shorter than the audit's common editorial range; review whether it describes the page clearly.`,\n        element: `<title>${titleText}</title>`,\n      });\n    } else if (titleText.length > 60) {\n      add({\n        code: \"seo.title.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Title is ${titleText.length} characters. This is longer than the audit's common editorial range; Google title links may be shortened or rewritten depending on context and device.`,\n        element: `<title>${titleText}</title>`,\n      });\n    }\n  }\n\n  // --- Meta Description Audits ---\n  const metaDescription = $('head > meta[name=\"description\" i]');\n  if (metaDescription.length === 0) {\n    add({\n      code: \"seo.meta_description.missing_or_empty\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Missing <meta name=\\\"description\\\">. Add a concise, accurate page summary; Google may use page content or this description to generate a snippet.\",\n    });\n  } else {\n    const descText = metaDescription.attr(\"content\")?.trim() || \"\";\n    if (descText.length === 0) {\n      add({\n        code: \"seo.meta_description.missing_or_empty\",\n        severity: \"error\",\n        category: \"SEO\",\n        message: \"Meta description content attribute is empty.\",\n      });\n    } else if (descText.length < 120) {\n      add({\n        code: \"seo.meta_description.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Meta description is ${descText.length} characters. This is shorter than the audit's common editorial range; review whether it provides a useful page summary.`,\n        element: `<meta name=\"description\" content=\"${descText}\">`,\n      });\n    } else if (descText.length > 160) {\n      add({\n        code: \"seo.meta_description.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Meta description is ${descText.length} characters. This is longer than the audit's common editorial range; displayed snippets may be shortened depending on the query and device.`,\n        element: `<meta name=\"description\" content=\"${descText}\">`,\n      });\n    }\n  }\n\n  // --- Canonical Link ---\n  const canonicalLinks = $(\"head > link[rel]\").filter((_, element) => {\n    const rel = $(element).attr(\"rel\") ?? \"\";\n    return rel\n      .trim()\n      .split(/[\\t\\n\\f\\r ]+/)\n      .some((token) => token.toLowerCase() === \"canonical\");\n  });\n  const nonEmptyCanonical = canonicalLinks.filter((_, element) => Boolean($(element).attr(\"href\")?.trim()));\n  const usableCanonical = nonEmptyCanonical.filter(\n    (_, element) => ![\"hreflang\", \"lang\", \"media\", \"type\"].some((attribute) => $(element).attr(attribute) !== undefined),\n  );\n  if (canonicalLinks.length === 0) {\n    add({\n      code: \"seo.canonical.missing\",\n      severity: \"info\",\n      category: \"SEO\",\n      message: \"No rel=\\\"canonical\\\" preference is declared. This is optional unless the page needs an explicit canonicalization signal.\",\n    });\n  } else if (usableCanonical.length === 0) {\n    if (nonEmptyCanonical.length > 0) {\n      add({\n        code: \"seo.canonical.unusable\",\n        severity: \"warning\",\n        category: \"SEO\",\n        message: \"Canonical link is present but uses attributes Google ignores for canonicalization. Use a plain rel=\\\"canonical\\\" link in <head>.\",\n      });\n    } else {\n      add({\n        code: \"seo.canonical.missing\",\n        severity: \"warning\",\n        category: \"SEO\",\n        message: \"Canonical link is present but its href is empty. Provide a usable canonical target or remove the declaration.\",\n      });\n    }\n  } else if (usableCanonical.length > 1) {\n    add({\n      code: \"seo.canonical.multiple\",\n      severity: \"warning\",\n      category: \"SEO\",\n      message: \"Multiple usable canonical link relations are declared. Keep one unambiguous canonical target.\",\n    });\n  }\n\n  // --- Viewport Meta Tag (Mobile Responsiveness) ---\n  const viewport = $('head > meta[name=\"viewport\" i]');\n  if (viewport.length === 0) {\n    add({\n      code: \"seo.viewport.missing\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Missing <meta name=\\\"viewport\\\"> tag. Review mobile rendering; this tag helps browsers size and scale the page on mobile devices.\",\n    });\n  } else if (viewport.filter((_, element) => Boolean($(element).attr(\"content\")?.trim())).length === 0) {\n    add({\n      code: \"seo.viewport.unusable\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Viewport meta tag is present but its content is empty. Provide viewport settings such as width=device-width.\",\n    });\n  }\n\n  // --- Heading Structure ---\n  const h1Tags = $(\"h1\");\n  if (h1Tags.length === 0) {\n    add({\n      code: \"seo.h1.missing\",\n      severity: \"warning\",\n      category: \"SEO\",\n      message: \"No <h1> heading found. Review whether the page has a clear main heading and a meaningful heading hierarchy.\",\n    });\n  } else if (h1Tags.length > 1) {\n    add({\n      code: \"seo.h1.multiple\",\n      severity: \"info\",\n      category: \"SEO\",\n      message: `Found multiple (${h1Tags.length}) <h1> headings. Multiple H1s are not inherently an SEO error; ensure the heading hierarchy is meaningful and the main visual title is clear.`,\n    });\n  }\n\n  // --- Images Alt Tags (SEO + Accessibility) ---\n  $(\"img\").each((_, element) => {\n    const img = $(element);\n    const src = img.attr(\"src\") || \"unknown-source\";\n    const alt = img.attr(\"alt\");\n\n    if (alt === undefined) {\n      add({\n        code: \"accessibility.image_alt.missing\",\n        severity: \"error\",\n        category: \"Accessibility\",\n        message: \"Missing 'alt' attribute on image. This makes it inaccessible to screen readers.\",\n        element: `<img src=\"${src}\">`,\n      });\n    } else if (alt.trim() === \"\") {\n      // Empty alt is acceptable for purely decorative images, but worth warning\n      add({\n        code: \"accessibility.image_alt.empty\",\n        severity: \"info\",\n        category: \"Accessibility\",\n        message: \"Empty 'alt' attribute found. Ensure this image is purely decorative, otherwise add descriptive text.\",\n        element: `<img src=\"${src}\" alt=\"\">`,\n      });\n    }\n  });\n\n  // --- Open Graph / Social Tags ---\n  const ogTitle = $('head > meta[property=\"og:title\"]');\n  const ogImage = $('head > meta[property=\"og:image\"]');\n  if (ogTitle.length === 0 || ogImage.length === 0) {\n    add({\n      code: \"seo.open_graph.missing\",\n      severity: \"info\",\n      category: \"SEO\",\n      message: \"Missing Open Graph social metadata (og:title / og:image). Add these to control preview cards on platforms like LinkedIn and X.\",\n    });\n  }\n\n  return collector.details();\n}\n\nexport function auditSeoMetadata(htmlContent: string): SEOIssue[] {\n  return auditSeoMetadataDetailed(htmlContent).issues;\n}\n\n/**\n * Parses and validates JSON-LD Schema markup\n */\nexport function validateSchemaMarkupDetailed(htmlContent: string): AuditDetails {\n  const $ = cheerio.load(htmlContent);\n  const collector = createIssueCollector();\n  const { add } = collector;\n  const blocks = $(\"script[type]\").filter((_, element) => isJsonLdScriptType($(element).attr(\"type\")));\n\n  blocks.each((index, element) => {\n    const scriptText = $(element).html() || \"\";\n    if (scriptText.trim() === \"\") {\n      add({\n        code: \"schema.jsonld.empty\",\n        severity: \"warning\",\n        category: \"Schema\",\n        message: `JSON-LD block #${index + 1} is empty.`,\n      });\n      return;\n    }\n\n    try {\n      const parsed = JSON.parse(scriptText) as unknown;\n      if (!hasJsonLdDocumentShape(parsed)) {\n        add({\n          code: \"schema.jsonld.invalid_document\",\n          severity: \"error\",\n          category: \"Schema\",\n          message: \"Invalid JSON-LD document shape: the top level must be an object or an array of objects.\",\n          element: `<script type=\"application/ld+json\">...</script>`,\n        });\n      }\n    } catch (error: unknown) {\n      add({\n        code: \"schema.jsonld.invalid_json\",\n        severity: \"error\",\n        category: \"Schema\",\n        message: `Invalid JSON-LD schema syntax: ${getErrorMessage(error)}`,\n        element: `<script type=\"application/ld+json\">...</script>`,\n      });\n    }\n  });\n\n  return collector.details();\n}\n\nexport function validateSchemaMarkup(htmlContent: string): SEOIssue[] {\n  return validateSchemaMarkupDetailed(htmlContent).issues;\n}\n\n/**\n * Extracts and tests links, treating 3xx responses as reachable redirects and 4xx/5xx as broken.\n */\nexport async function checkBrokenLinks(\n  htmlContent: string,\n  baseUrl?: string,\n  maxLinks = MAX_LINKS_TO_CHECK,\n): Promise<LinkStatus[]> {\n  if (!Number.isSafeInteger(maxLinks) || maxLinks <= 0) {\n    throw new Error(\"maxLinks must be a positive integer\");\n  }\n  const linkLimit = Math.min(maxLinks, MAX_LINKS_TO_CHECK);\n  const $ = cheerio.load(htmlContent);\n  const fallbackBaseUrl = baseUrl ? await assertPublicHttpUrl(baseUrl) : undefined;\n  let parsedBaseUrl = fallbackBaseUrl;\n  const documentBaseHref = $(\"base[href]\").first().attr(\"href\");\n  if (documentBaseHref !== undefined) {\n    let resolvedDocumentBase: URL | undefined;\n    try {\n      resolvedDocumentBase = fallbackBaseUrl\n        ? new URL(documentBaseHref, fallbackBaseUrl)\n        : new URL(documentBaseHref);\n    } catch {\n      parsedBaseUrl = undefined;\n    }\n    if (resolvedDocumentBase) {\n      try {\n        parsedBaseUrl = await assertPublicHttpUrl(resolvedDocumentBase);\n      } catch (error: unknown) {\n        if (!(error instanceof PublicUrlError)) {\n          throw error;\n        }\n        parsedBaseUrl = undefined;\n      }\n    }\n  }\n  const urls: string[] = [];\n  const seenUrls = new Set<string>();\n\n  $(\"a\").each((_, element) => {\n    if (urls.length >= linkLimit) {\n      return false;\n    }\n\n    const href = $(element).attr(\"href\")?.trim();\n    if (!href || href.startsWith(\"#\")) {\n      return;\n    }\n\n    let resolvedUrl: URL;\n    try {\n      resolvedUrl = parsedBaseUrl ? new URL(href, parsedBaseUrl) : new URL(href);\n    } catch {\n      // Relative links require a public base URL; unsupported or malformed links are skipped.\n      return;\n    }\n\n    if (resolvedUrl.protocol !== \"http:\" && resolvedUrl.protocol !== \"https:\") {\n      return;\n    }\n\n    resolvedUrl.hash = \"\";\n    const normalizedUrl = resolvedUrl.href;\n    if (!seenUrls.has(normalizedUrl)) {\n      seenUrls.add(normalizedUrl);\n      urls.push(normalizedUrl);\n    }\n  });\n\n  const results = new Array<LinkStatus>(urls.length);\n  let nextIndex = 0;\n\n  async function checkLink(url: string): Promise<LinkStatus> {\n    try {\n      const headResult = await fetchPublicHttp(url, {\n        method: \"HEAD\",\n        headers: { \"User-Agent\": LINK_CHECK_USER_AGENT },\n        timeoutMs: LINK_CHECK_TIMEOUT_MS,\n        maxRedirects: 0,\n      });\n      const headStatus = headResult.response.status;\n      const headFinalUrl = headResult.url.href;\n      await cancelResponseBody(headResult.response);\n\n      // Some sites reject or do not implement HEAD even when the linked resource is available.\n      if (headStatus === 405 || headStatus === 403 || headStatus === 501) {\n        let getResult = await fetchPublicHttp(url, {\n          method: \"GET\",\n          headers: {\n            Range: \"bytes=0-0\",\n            \"User-Agent\": LINK_CHECK_USER_AGENT,\n          },\n          timeoutMs: LINK_CHECK_TIMEOUT_MS,\n          maxRedirects: 0,\n        });\n        if (getResult.response.status === 416) {\n          await cancelResponseBody(getResult.response);\n          getResult = await fetchPublicHttp(url, {\n            method: \"GET\",\n            headers: { \"User-Agent\": LINK_CHECK_USER_AGENT },\n            timeoutMs: LINK_CHECK_TIMEOUT_MS,\n            maxRedirects: 0,\n          });\n        }\n\n        const status = getResult.response.status;\n        const ok = status >= 200 && status < 400;\n        const finalUrl = getResult.url.href;\n        await cancelResponseBody(getResult.response);\n        return {\n          url,\n          status,\n          ok,\n          message:\n            status >= 300 && status < 400\n              ? \"Redirect not followed\"\n              : finalUrl !== url\n                ? `Redirected to ${finalUrl}`\n                : undefined,\n        };\n      }\n\n      return {\n        url,\n        status: headStatus,\n        ok: headStatus >= 200 && headStatus < 400,\n        message:\n          headStatus >= 300 && headStatus < 400\n            ? \"Redirect not followed\"\n            : headFinalUrl !== url\n              ? `Redirected to ${headFinalUrl}`\n              : undefined,\n      };\n    } catch (error: unknown) {\n      return {\n        url,\n        status: error instanceof PublicUrlError ? \"blocked\" : \"failed\",\n        ok: false,\n        message: getErrorMessage(error),\n      };\n    }\n  }\n\n  async function worker(): Promise<void> {\n    while (true) {\n      const index = nextIndex;\n      nextIndex += 1;\n      if (index >= urls.length) {\n        return;\n      }\n      results[index] = await checkLink(urls[index]);\n    }\n  }\n\n  const workerCount = Math.min(LINK_CHECK_CONCURRENCY, urls.length);\n  await Promise.all(Array.from({ length: workerCount }, () => worker()));\n  return results;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-web-validator",
-  "version": "1.3.19",
+  "version": "1.3.21",
   "description": "W3C HTML/CSS Validator and Technical SEO Audit MCP Server for AI coding assistants.",
   "main": "dist/index.js",
   "bin": {
@@ -49,17 +49,17 @@
   },
   "mcpName": "io.github.AKzar1el/mcp-web-validator",
   "dependencies": {
-    "@puppeteer/browsers": "3.2.0",
+    "@puppeteer/browsers": "3.2.2",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "cheerio": "^1.0.0",
-    "encoding-sniffer": "0.2.1",
-    "puppeteer-core": "25.7.0",
+    "encoding-sniffer": "1.0.2",
+    "puppeteer-core": "25.11.0",
     "undici": "^7.29.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",
-    "puppeteer": "25.7.0",
+    "puppeteer": "25.11.0",
     "tsx": "^4.23.0",
     "typescript": "^7.0.2"
   }