mcp-web-validator 1.3.14 → 1.3.16

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to this project are documented here. The project follows [Se
 
 ## [Unreleased]
 
+## [1.3.16] - 2026-09-22
+
+### Fixed
+
+- Labeled pure advisory action lists as review items instead of "Fix first" work while preserving Fix-first prioritization when errors or warnings exist.
+- Accepted CR, LF, and CRLF robots.txt line endings in hosted sitemap-first site audits, matching RFC 9309 parsing syntax.
+- Aligned hosted broken-link resolution with document-base semantics so the first safe `<base href>` overrides the fallback page URL, while unsafe declared bases no longer cause relative links to be checked against the wrong fallback target.
+- Added hosted sitemap discovery for Google-supported RSS 2.0, Atom 1.0, and plain-text sitemap representations while preserving same-origin/public crawl guards.
+- Fell back to HTML encoding sniffing when a `text/html` response declares an unsupported HTTP charset, while preserving supported transport charset precedence.
+
+## [1.3.15] - 2026-09-22
+
+### Fixed
+
+- Pinned Chromium screenshot HTTP(S) connections to DNS answers revalidated as public at proxy connection time, closing a DNS-rebinding/TOCTOU gap while preserving the original hostname for TLS/SNI validation.
+- Scoped Open Graph title/image checks to the document head so body-only metadata lookalikes cannot suppress missing social-preview guidance.
+
 ## [1.3.14] - 2026-09-21
 
 ### Fixed

package/README.md

@@ -73,7 +73,7 @@ The hosted app exposes eight tools:
 | `check_broken_links` | Check up to 20 authorized public links extracted from supplied HTML. |
 | `generate_validation_report` | Combine the checks for supplied markup; `base_url` resolves relative links but does not fetch a page. |
 
-`audit_public_webpage` follows at most three validated redirects, accepts a bounded `text/html` response, and records the final URL. It does not crawl additional pages, execute JavaScript, authenticate, or fetch linked stylesheets and assets. `audit_public_site` first locks the final public origin, reads bounded same-origin `robots.txt` and XML sitemap documents, then audits at most eight eligible sitemap pages in one call. It never follows HTML links, subdomains, external sitemap entries, private/reserved destinations, custom ports, or cross-origin redirects; use `page_offset` when the response says more eligible pages remain. The fetched HTML is sent to `https://html5.validator.nu/`, the same external Nu HTML Checker used by `validate_html` and the report tool. CSS parsing, SEO analysis, and JSON-LD parsing run inside the DigestSEO Worker. Optional link checks make capped `HEAD` requests, with a bounded `GET` fallback where necessary, to eligible public HTTP(S) URLs; link redirects are reported but not followed. The site tool intentionally does not perform site-wide link checking. The hosted app does not retain tool inputs, fetched HTML, or results.
+`audit_public_webpage` follows at most three validated redirects, accepts a bounded `text/html` response, and records the final URL. It does not crawl additional pages, execute JavaScript, authenticate, or fetch linked stylesheets and assets. `audit_public_site` first locks the final public origin, reads bounded same-origin `robots.txt` plus XML Sitemap, RSS 2.0, Atom 1.0, and plain-text sitemap representations, then audits at most eight eligible sitemap pages in one call. It never follows HTML links, subdomains, external sitemap entries, private/reserved destinations, custom ports, or cross-origin redirects; use `page_offset` when the response says more eligible pages remain. The fetched HTML is sent to `https://html5.validator.nu/`, the same external Nu HTML Checker used by `validate_html` and the report tool. CSS parsing, SEO analysis, and JSON-LD parsing run inside the DigestSEO Worker. Optional link checks make capped `HEAD` requests, with a bounded `GET` fallback where necessary, to eligible public HTTP(S) URLs; link redirects are reported but not followed. The site tool intentionally does not perform site-wide link checking. The hosted app does not retain tool inputs, fetched HTML, or results.
 
 ## Privacy Policy
 

package/dist/network.d.ts

@@ -18,10 +18,22 @@ export interface PublicHttpResult {
     response: Response;
     url: URL;
 }
+export interface ResolvedPublicHttpUrl {
+    url: URL;
+    addresses: Array<{
+        address: string;
+        family: number;
+    }>;
+}
 export declare class PublicUrlError extends Error {
     readonly name = "PublicUrlError";
 }
 export declare function getErrorMessage(error: unknown): string;
+/**
+ * Parses an HTTP(S) URL and rejects hostnames that resolve to local, private,
+ * documentation, multicast, or otherwise non-public address space.
+ */
+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): Promise<string>;

package/dist/network.js

@@ -114,7 +114,7 @@ async function withTimeout(promise, timeoutMs, label) {
  * Parses an HTTP(S) URL and rejects hostnames that resolve to local, private,
  * documentation, multicast, or otherwise non-public address space.
  */
-async function resolvePublicHttpUrl(input) {
+export async function resolvePublicHttpUrl(input) {
     const rawUrl = input instanceof URL ? input.href : input;
     if (typeof rawUrl !== "string" || rawUrl.length === 0 || rawUrl.length > MAX_URL_LENGTH) {
         throw new PublicUrlError(`URL must contain between 1 and ${MAX_URL_LENGTH} characters`);
@@ -186,6 +186,15 @@ function getDeclaredCharacterEncoding(contentType) {
     }
     return (match[1] ?? match[2] ?? "").trim();
 }
+function isSupportedCharacterEncoding(encoding) {
+    try {
+        new TextDecoder(encoding);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 export async function readResponseText(response, maxBytes, encoding, sniffHtmlEncoding = false) {
     assertPositiveInteger(maxBytes, "maxBytes");
     const declaredLength = Number(response.headers.get("content-length"));
@@ -380,8 +389,10 @@ export async function fetchPublicText(input, options = {}) {
         throw new Error(`URL returned unsupported content type ${contentType ?? "missing"}`);
     }
     const declaredEncoding = getDeclaredCharacterEncoding(contentTypeHeader);
+    const shouldSniffHtmlEncoding = contentType === "text/html"
+        && (declaredEncoding === undefined || !isSupportedCharacterEncoding(declaredEncoding));
     return {
-        text: await readResponseText(response, maxBytes, declaredEncoding, declaredEncoding === undefined && contentType === "text/html"),
+        text: await readResponseText(response, maxBytes, shouldSniffHtmlEncoding ? undefined : declaredEncoding, shouldSniffHtmlEncoding),
         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":"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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\ninterface 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 */\nasync 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\nexport async function readResponseText(\n  response: Response,\n  maxBytes: number,\n  encoding?: string,\n  sniffHtmlEncoding = 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) {\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 = 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) {\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  return {\n    text: await readResponseText(\n      response,\n      maxBytes,\n      declaredEncoding,\n      declaredEncoding === undefined && contentType === \"text/html\",\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\nexport async function readResponseText(\n  response: Response,\n  maxBytes: number,\n  encoding?: string,\n  sniffHtmlEncoding = 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) {\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 = 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) {\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  return {\n    text: await readResponseText(\n      response,\n      maxBytes,\n      shouldSniffHtmlEncoding ? undefined : declaredEncoding,\n      shouldSniffHtmlEncoding,\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/presentation.js

@@ -67,9 +67,12 @@ function toolContent(options) {
     if (options.note) {
         sections.push(collapseWhitespace(options.note, 500));
     }
-    const actions = formatActions(options.actions ?? []);
+    const actionItems = options.actions ?? [];
+    const actions = formatActions(actionItems);
     if (actions) {
-        sections.push(`**Fix first**\n${actions}`);
+        const hasActionableItem = actionItems.some((item) => item.priority < 2);
+        const actionHeading = options.status === "review suggested" || !hasActionableItem ? "Review" : "Fix first";
+        sections.push(`**${actionHeading}**\n${actions}`);
     }
     sections.push(`**Next step:** ${collapseWhitespace(options.nextStep, 400)}`);
     return sections.join("\n\n");

package/dist/presentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"presentation.js","sourceRoot":"","sources":["../src/presentation.ts"],"names":[],"mappings":"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","sourcesContent":["import * as cheerio from \"cheerio\";\nimport type { ValidationReport } from \"./report.js\";\nimport type { LinkStatus, SEOIssue } from \"./seo-auditor.js\";\nimport {\n  getW3CMessageSeverity,\n  type CSSMessage,\n  type W3CMessage,\n} from \"./w3c-validator.js\";\n\ntype ActionPriority = 0 | 1 | 2;\n\ninterface ActionItem {\n  message: string;\n  priority: ActionPriority;\n  location?: string;\n}\n\ninterface ValidationReportResult extends ValidationReport {\n  errors?: string[];\n}\n\nfunction collapseWhitespace(value: string, maxLength = 240): string {\n  const collapsed = value.replace(/\\s+/g, \" \").trim();\n  if (collapsed.length <= maxLength) {\n    return collapsed;\n  }\n  return `${collapsed.slice(0, Math.max(0, maxLength - 1)).trimEnd()}…`;\n}\n\n/** Escapes untrusted text while leaving the surrounding, controlled Markdown intact. */\nfunction markdownText(value: string, maxLength = 240): string {\n  return collapseWhitespace(value, maxLength)\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\\\\/g, \"\\\\\\\\\")\n    .replace(/([`*_[\\]{}()#+\\-.!|~])/g, \"\\\\$1\");\n}\n\n/** Wraps untrusted identifiers and paths in a code span that cannot be closed by their content. */\nfunction markdownCode(value: string, maxLength = 240): string {\n  const collapsed = collapseWhitespace(value, maxLength);\n  const longestBacktickRun = Math.max(\n    0,\n    ...Array.from(collapsed.matchAll(/`+/g), (match) => match[0].length),\n  );\n  const delimiter = \"`\".repeat(longestBacktickRun + 1);\n  const content = collapsed.startsWith(\"`\") || collapsed.endsWith(\"`\")\n    ? ` ${collapsed} `\n    : collapsed;\n  return `${delimiter}${content}${delimiter}`;\n}\n\nfunction countLabel(count: number, singular: string, plural = `${singular}s`): string {\n  return `${count} ${count === 1 ? singular : plural}`;\n}\n\nfunction priorityForSeverity(severity: string): ActionPriority {\n  if (severity.toLowerCase() === \"error\") return 0;\n  if (severity.toLowerCase() === \"warning\") return 1;\n  return 2;\n}\n\nfunction formatLocation(line?: number, column?: number): string | undefined {\n  if (line === undefined && column === undefined) return undefined;\n  if (line === undefined) return `column ${column}`;\n  if (column === undefined) return `line ${line}`;\n  return `line ${line}, column ${column}`;\n}\n\nfunction formatActions(items: ActionItem[]): string | undefined {\n  const prioritized = items\n    .map((item, index) => ({ item, index }))\n    .sort((left, right) => left.item.priority - right.item.priority || left.index - right.index)\n    .slice(0, 3)\n    .map(({ item }) => {\n      const label = item.priority === 0 ? \"Error\" : item.priority === 1 ? \"Warning\" : \"Check\";\n      const location = item.location\n        ? ` · ${markdownCode(item.location, 120)}`\n        : \"\";\n      return `- **${label}**${location}: ${markdownText(item.message)}`;\n    });\n\n  return prioritized.length > 0 ? prioritized.join(\"\\n\") : undefined;\n}\n\nfunction toolContent(options: {\n  title: string;\n  status: string;\n  outcome: string;\n  nextStep: string;\n  actions?: ActionItem[];\n  note?: string;\n}): string {\n  const sections = [\n    `### ${options.title}: ${options.status}`,\n    collapseWhitespace(options.outcome, 500),\n  ];\n  if (options.note) {\n    sections.push(collapseWhitespace(options.note, 500));\n  }\n  const actions = formatActions(options.actions ?? []);\n  if (actions) {\n    sections.push(`**Fix first**\\n${actions}`);\n  }\n  sections.push(`**Next step:** ${collapseWhitespace(options.nextStep, 400)}`);\n  return sections.join(\"\\n\\n\");\n}\n\nexport function htmlValidationContent(messages: W3CMessage[], source?: string): string {\n  const errorCount = messages.filter((message) => getW3CMessageSeverity(message) === \"error\").length;\n  const warningCount = messages.filter((message) => getW3CMessageSeverity(message) === \"warning\").length;\n  const infoCount = messages.length - errorCount - warningCount;\n  const sourceText = source ? ` for ${markdownCode(source, 180)}` : \"\";\n  if (messages.length === 0) {\n    return toolContent({\n      title: \"HTML validation\",\n      status: \"clean\",\n      outcome: `The W3C validator returned no HTML diagnostics${sourceText}.`,\n      nextStep: \"Keep this result as a baseline and validate again after the next markup change.\",\n    });\n  }\n\n  const hasActionableDiagnostics = errorCount > 0 || warningCount > 0;\n  return toolContent({\n    title: \"HTML validation\",\n    status: hasActionableDiagnostics ? \"attention needed\" : \"review suggested\",\n    outcome: `The W3C validator returned ${countLabel(errorCount, \"error\")}, ${countLabel(warningCount, \"warning\")}, and ${countLabel(infoCount, \"informational diagnostic\")}${sourceText}.`,\n    actions: messages.map((message) => ({\n      priority: priorityForSeverity(getW3CMessageSeverity(message)),\n      message: message.message,\n      location: formatLocation(message.lastLine ?? message.firstLine, message.lastColumn ?? message.firstColumn),\n    })),\n    nextStep: hasActionableDiagnostics\n      ? \"Fix errors first, then warnings, and rerun HTML validation to confirm the markup is clean.\"\n      : \"Review the informational diagnostics, then rerun validation after relevant markup changes.\",\n  });\n}\n\nexport function cssValidationContent(messages: CSSMessage[]): string {\n  if (messages.length === 0) {\n    return toolContent({\n      title: \"CSS validation\",\n      status: \"clean\",\n      outcome: \"The W3C validator returned no CSS errors.\",\n      nextStep: \"Validate again after the next stylesheet change.\",\n    });\n  }\n\n  const compatibilityLimitations = messages.filter(\n    (message) => message.compatibility === \"known-validator-limitation\",\n  );\n  const actionableErrors = messages.length - compatibilityLimitations.length;\n\n  return toolContent({\n    title: \"CSS validation\",\n    status: actionableErrors > 0 ? \"attention needed\" : \"review suggested\",\n    outcome: compatibilityLimitations.length > 0\n      ? `The W3C validator returned ${countLabel(messages.length, \"CSS error\")}; ${countLabel(compatibilityLimitations.length, \"diagnostic\")} ${compatibilityLimitations.length === 1 ? \"matches\" : \"match\"} a known validator limitation.`\n      : `The W3C validator returned ${countLabel(messages.length, \"CSS error\")}.`,\n    actions: messages.map((message) => ({\n      priority: message.compatibility === \"known-validator-limitation\" ? 2 : 0,\n      message: message.context ? `${message.message} Context: ${message.context}` : message.message,\n      location: formatLocation(message.line),\n    })),\n    nextStep: actionableErrors > 0\n      ? \"Correct the actionable errors, then rerun CSS validation because one syntax issue can cause later diagnostics.\"\n      : \"Review the marked @container diagnostic against current CSS specifications; do not treat it as invalid CSS by itself.\",\n    note: compatibilityLimitations.length > 0\n      ? \"Jigsaw currently does not recognize the standards-defined @container rule. The upstream diagnostic is preserved and marked as a known validator limitation.\"\n      : undefined,\n  });\n}\n\nexport function seoAuditContent(issues: SEOIssue[], totalIssues: number, truncated: boolean): string {\n  const errors = issues.filter((issue) => issue.severity === \"error\").length;\n  const warnings = issues.filter((issue) => issue.severity === \"warning\").length;\n  const info = issues.filter((issue) => issue.severity === \"info\").length;\n  if (totalIssues === 0) {\n    return toolContent({\n      title: \"SEO audit\",\n      status: \"clean within this audit\",\n      outcome: \"This focused rules-based audit found no SEO or accessibility issues in the supplied HTML.\",\n      nextStep: \"Keep the metadata current and rerun the audit whenever the page template changes.\",\n      note: \"This result does not replace a crawl, performance test, or Search Console review.\",\n    });\n  }\n\n  const hasActionableFindings = errors > 0 || warnings > 0;\n  return toolContent({\n    title: \"SEO audit\",\n    status: hasActionableFindings ? \"attention needed\" : \"review suggested\",\n    outcome: `The audit found ${countLabel(errors, \"error\")}, ${countLabel(warnings, \"warning\")}, and ${countLabel(info, \"suggestion\")}.`,\n    actions: issues.map((issue) => ({\n      priority: priorityForSeverity(issue.severity),\n      message: issue.message,\n      location: issue.element ? collapseWhitespace(issue.element, 120) : undefined,\n    })),\n    nextStep: hasActionableFindings\n      ? \"Address errors first, then warnings, and rerun the audit after updating the page.\"\n      : \"Review the suggestions that apply to this page, then rerun the audit after relevant template changes.\",\n    note: truncated\n      ? `Showing the first ${issues.length} of ${totalIssues} findings in structured output.`\n      : undefined,\n  });\n}\n\nfunction countJsonLdBlocks(htmlContent: string): number {\n  const $ = cheerio.load(htmlContent);\n  return $(\"script[type]\").filter((_, element) => {\n    const type = $(element).attr(\"type\");\n    return type?.split(\";\", 1)[0].trim().toLowerCase() === \"application/ld+json\";\n  }).length;\n}\n\nexport function schemaValidationContent(\n  issues: SEOIssue[],\n  totalIssues: number,\n  truncated: boolean,\n  htmlContent: string,\n): string {\n  const blockCount = countJsonLdBlocks(htmlContent);\n  if (blockCount === 0) {\n    return toolContent({\n      title: \"JSON-LD syntax\",\n      status: \"not present\",\n      outcome: \"No JSON-LD script blocks were found, so there was no structured data to parse.\",\n      nextStep: \"Add JSON-LD only when it accurately describes visible page content, then validate it again.\",\n    });\n  }\n  if (totalIssues === 0) {\n    return toolContent({\n      title: \"JSON-LD syntax\",\n      status: \"clean\",\n      outcome: `${countLabel(blockCount, \"JSON-LD block\")} parsed without syntax errors.`,\n      nextStep: \"Verify the properties against the relevant Schema.org type and search-engine requirements.\",\n      note: \"This check covers JSON syntax only; it does not validate vocabulary semantics or rich-result eligibility.\",\n    });\n  }\n\n  return toolContent({\n    title: \"JSON-LD syntax\",\n    status: \"attention needed\",\n    outcome: `${countLabel(totalIssues, \"syntax issue\")} ${totalIssues === 1 ? \"was\" : \"were\"} found across ${countLabel(blockCount, \"JSON-LD block\")}.`,\n    actions: issues.map((issue) => ({\n      priority: priorityForSeverity(issue.severity),\n      message: issue.message,\n    })),\n    nextStep: \"Repair the invalid or empty blocks, then rerun this syntax check before testing rich-result eligibility.\",\n    note: truncated\n      ? `Showing the first ${issues.length} of ${totalIssues} findings in structured output.`\n      : undefined,\n  });\n}\n\nfunction linkPriority(link: LinkStatus): ActionPriority {\n  if (isRedirect(link)) return 1;\n  return 0;\n}\n\nfunction isRedirect(link: LinkStatus): boolean {\n  return typeof link.status === \"number\" && link.status >= 300 && link.status < 400;\n}\n\nfunction linkActionMessage(link: LinkStatus): string {\n  if (isRedirect(link)) {\n    return `${link.status} redirect; destination was not followed`;\n  }\n  return `Link returned ${typeof link.status === \"number\" ? `HTTP ${link.status}` : link.status}${link.message ? ` — ${link.message}` : \"\"}`;\n}\n\nexport function linkCheckContent(links: LinkStatus[], baseUrl?: string): string {\n  if (links.length === 0) {\n    return toolContent({\n      title: \"Link check\",\n      status: \"nothing checked\",\n      outcome: \"No eligible public HTTP(S) links were found, so no link requests were made.\",\n      nextStep: baseUrl\n        ? \"Confirm the HTML contains reachable anchor URLs, then run the check again.\"\n        : \"If the page uses relative links, provide its public base URL and run the check again.\",\n    });\n  }\n\n  const unreachable = links.filter((link) => !link.ok);\n  const redirects = links.filter(isRedirect);\n  if (unreachable.length === 0 && redirects.length === 0) {\n    return toolContent({\n      title: \"Link check\",\n      status: \"clean\",\n      outcome: links.length === 1\n        ? \"The checked link returned a successful response.\"\n        : `All ${links.length} checked links returned a successful response.`,\n      nextStep: \"Recheck periodically because external link availability can change.\",\n    });\n  }\n\n  const actions = [\n    ...unreachable,\n    ...redirects,\n  ].map((link) => ({\n    priority: linkPriority(link),\n    location: link.url,\n    message: linkActionMessage(link),\n  }));\n\n  const linkOutcome = [\n    unreachable.length > 0\n      ? `${countLabel(unreachable.length, \"link\")} ${unreachable.length === 1 ? \"is\" : \"are\"} broken or unreachable`\n      : \"no checked links are broken or unreachable\",\n    redirects.length > 0\n      ? `${countLabel(redirects.length, \"redirect\")} ${redirects.length === 1 ? \"needs\" : \"need\"} review`\n      : undefined,\n  ].filter((item): item is string => item !== undefined).join(\"; \");\n\n  return toolContent({\n    title: \"Link check\",\n    status: unreachable.length > 0 ? \"attention needed\" : \"review suggested\",\n    outcome: `${linkOutcome} of ${links.length} checked. Redirect destinations are not followed.`,\n    actions,\n    nextStep: \"Update failed destinations and review redirects, then rerun the link check.\",\n  });\n}\n\nfunction reportActionItems(reportData: ValidationReportResult): ActionItem[] {\n  return [\n    ...(reportData.errors ?? []).map((message) => ({\n      priority: 0 as const,\n      message,\n    })),\n    ...reportData.htmlMessages.map((message) => ({\n      priority: priorityForSeverity(getW3CMessageSeverity(message)),\n      message: `HTML: ${message.message}`,\n      location: formatLocation(message.lastLine ?? message.firstLine, message.lastColumn ?? message.firstColumn),\n    })),\n    ...reportData.cssMessages.map((message) => ({\n      priority: message.compatibility === \"known-validator-limitation\" ? 2 as const : 0 as const,\n      message: `CSS: ${message.message}`,\n      location: formatLocation(message.line),\n    })),\n    ...reportData.seoIssues.map((issue) => ({\n      priority: priorityForSeverity(issue.severity),\n      message: `${issue.category}: ${issue.message}`,\n      location: issue.element ? collapseWhitespace(issue.element, 120) : undefined,\n    })),\n    ...reportData.schemaIssues.map((issue) => ({\n      priority: priorityForSeverity(issue.severity),\n      message: `JSON-LD: ${issue.message}`,\n    })),\n    ...reportData.links\n      .filter((link) => !link.ok || isRedirect(link))\n      .map((link) => ({\n        priority: linkPriority(link),\n        message: linkActionMessage(link),\n        location: link.url,\n      })),\n  ];\n}\n\nexport function reportContent(reportData: ValidationReportResult): string {\n  const { summary } = reportData;\n  const actions = reportActionItems(reportData);\n  const partial = reportData.failedChecks.length > 0;\n  const compatibilityLimited = summary.cssCompatibilityLimitations > 0;\n  const hasActionableFinding = actions.some((action) => action.priority < 2);\n  const status = partial\n    ? \"partial\"\n    : compatibilityLimited\n      ? \"compatibility-limited\"\n      : actions.length === 0\n        ? \"clean across completed checks\"\n        : hasActionableFinding\n          ? \"attention needed\"\n          : \"review suggested\";\n  const cssSummary = summary.cssScore === null\n    ? reportData.failedChecks.includes(\"css\")\n      ? \"CSS validation unavailable\"\n      : compatibilityLimited\n        ? `${countLabel(summary.cssErrors, \"CSS error\")}, including ${countLabel(summary.cssCompatibilityLimitations, \"known validator limitation\")}`\n        : \"CSS not audited\"\n    : countLabel(summary.cssErrors, \"CSS error\");\n  const redirects = reportData.links.filter(isRedirect).length;\n  const linkSummary = summary.linkScore === null\n    ? reportData.failedChecks.includes(\"links\")\n      ? \"link checking unavailable\"\n      : \"no eligible links checked\"\n    : `${summary.brokenLinks} broken or unreachable and ${countLabel(redirects, \"redirect\")} to review of ${countLabel(summary.linksChecked, \"link\")}`;\n  const checkLabels = {\n    input: \"input file\",\n    html: \"HTML validation\",\n    css: \"CSS validation\",\n    seo: \"SEO analysis\",\n    schema: \"JSON-LD analysis\",\n    links: \"link checking\",\n  } as const;\n  const unavailableChecks = reportData.failedChecks\n    .filter((check) => check !== \"input\")\n    .map((check) => checkLabels[check]);\n  return toolContent({\n    title: \"Validation report\",\n    status,\n    outcome: partial\n      ? `Partial validation report: ${unavailableChecks.join(\", \")} ${unavailableChecks.length === 1 ? \"was\" : \"were\"} unavailable; remaining checks completed. HTML has ${countLabel(summary.htmlErrors, \"error\")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, \"error\")}; JSON-LD has ${countLabel(summary.schemaErrors, \"syntax error\")}; ${linkSummary}.`\n      : compatibilityLimited\n        ? `The overall heuristic score is withheld because CSS validation includes ${countLabel(summary.cssCompatibilityLimitations, \"known validator limitation\")}. HTML has ${countLabel(summary.htmlErrors, \"error\")} and ${countLabel(summary.htmlWarnings, \"warning\")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, \"error\")} and ${countLabel(summary.seoWarnings, \"warning\")}; JSON-LD has ${countLabel(summary.schemaErrors, \"syntax error\")}; ${linkSummary}.`\n        : `The report's heuristic overall score is **${summary.overallScore}/100**. HTML has ${countLabel(summary.htmlErrors, \"error\")} and ${countLabel(summary.htmlWarnings, \"warning\")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, \"error\")} and ${countLabel(summary.seoWarnings, \"warning\")}; JSON-LD has ${countLabel(summary.schemaErrors, \"syntax error\")}; ${linkSummary}.`,\n    actions,\n    nextStep: partial\n      ? \"Review the completed findings, then retry the unavailable checks.\"\n      : compatibilityLimited\n        ? \"Review actionable findings normally, and treat the marked @container diagnostic as an upstream validator limitation rather than proof of invalid CSS.\"\n        : actions.length === 0\n          ? \"Use the full Markdown report as the audit record and rerun it after meaningful page changes.\"\n          : \"Work through these priorities, then regenerate the report to compare the heuristic score.\",\n    note: partial\n      ? \"No overall score is shown while one or more checks are unavailable.\"\n      : compatibilityLimited\n        ? \"CSS and overall scores are withheld while a known Jigsaw parser limitation is present; the original upstream diagnostic remains visible.\"\n        : \"The score is a triage heuristic based on these checks, not a Lighthouse score or a search-ranking prediction.\",\n  });\n}\n\nexport function screenshotCaptureContent(count: number, outputDirectory: string): string {\n  return toolContent({\n    title: \"Screenshot capture\",\n    status: \"complete\",\n    outcome: `Saved ${countLabel(count, \"PNG screenshot\")} to ${markdownCode(outputDirectory)}.`,\n    nextStep: \"Open the PNG files and compare the rendered layouts at each requested viewport.\",\n  });\n}\n\nexport function failureContent(title: string, error: string, nextStep: string): string {\n  return toolContent({\n    title,\n    status: \"could not finish\",\n    outcome: markdownText(error, 500),\n    nextStep,\n  });\n}\n"]}
+{"version":3,"file":"presentation.js","sourceRoot":"","sources":["../src/presentation.ts"],"names":[],"mappings":"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","sourcesContent":["import * as cheerio from \"cheerio\";\nimport type { ValidationReport } from \"./report.js\";\nimport type { LinkStatus, SEOIssue } from \"./seo-auditor.js\";\nimport {\n  getW3CMessageSeverity,\n  type CSSMessage,\n  type W3CMessage,\n} from \"./w3c-validator.js\";\n\ntype ActionPriority = 0 | 1 | 2;\n\ninterface ActionItem {\n  message: string;\n  priority: ActionPriority;\n  location?: string;\n}\n\ninterface ValidationReportResult extends ValidationReport {\n  errors?: string[];\n}\n\nfunction collapseWhitespace(value: string, maxLength = 240): string {\n  const collapsed = value.replace(/\\s+/g, \" \").trim();\n  if (collapsed.length <= maxLength) {\n    return collapsed;\n  }\n  return `${collapsed.slice(0, Math.max(0, maxLength - 1)).trimEnd()}…`;\n}\n\n/** Escapes untrusted text while leaving the surrounding, controlled Markdown intact. */\nfunction markdownText(value: string, maxLength = 240): string {\n  return collapseWhitespace(value, maxLength)\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\\\\/g, \"\\\\\\\\\")\n    .replace(/([`*_[\\]{}()#+\\-.!|~])/g, \"\\\\$1\");\n}\n\n/** Wraps untrusted identifiers and paths in a code span that cannot be closed by their content. */\nfunction markdownCode(value: string, maxLength = 240): string {\n  const collapsed = collapseWhitespace(value, maxLength);\n  const longestBacktickRun = Math.max(\n    0,\n    ...Array.from(collapsed.matchAll(/`+/g), (match) => match[0].length),\n  );\n  const delimiter = \"`\".repeat(longestBacktickRun + 1);\n  const content = collapsed.startsWith(\"`\") || collapsed.endsWith(\"`\")\n    ? ` ${collapsed} `\n    : collapsed;\n  return `${delimiter}${content}${delimiter}`;\n}\n\nfunction countLabel(count: number, singular: string, plural = `${singular}s`): string {\n  return `${count} ${count === 1 ? singular : plural}`;\n}\n\nfunction priorityForSeverity(severity: string): ActionPriority {\n  if (severity.toLowerCase() === \"error\") return 0;\n  if (severity.toLowerCase() === \"warning\") return 1;\n  return 2;\n}\n\nfunction formatLocation(line?: number, column?: number): string | undefined {\n  if (line === undefined && column === undefined) return undefined;\n  if (line === undefined) return `column ${column}`;\n  if (column === undefined) return `line ${line}`;\n  return `line ${line}, column ${column}`;\n}\n\nfunction formatActions(items: ActionItem[]): string | undefined {\n  const prioritized = items\n    .map((item, index) => ({ item, index }))\n    .sort((left, right) => left.item.priority - right.item.priority || left.index - right.index)\n    .slice(0, 3)\n    .map(({ item }) => {\n      const label = item.priority === 0 ? \"Error\" : item.priority === 1 ? \"Warning\" : \"Check\";\n      const location = item.location\n        ? ` · ${markdownCode(item.location, 120)}`\n        : \"\";\n      return `- **${label}**${location}: ${markdownText(item.message)}`;\n    });\n\n  return prioritized.length > 0 ? prioritized.join(\"\\n\") : undefined;\n}\n\nfunction toolContent(options: {\n  title: string;\n  status: string;\n  outcome: string;\n  nextStep: string;\n  actions?: ActionItem[];\n  note?: string;\n}): string {\n  const sections = [\n    `### ${options.title}: ${options.status}`,\n    collapseWhitespace(options.outcome, 500),\n  ];\n  if (options.note) {\n    sections.push(collapseWhitespace(options.note, 500));\n  }\n  const actionItems = options.actions ?? [];\n  const actions = formatActions(actionItems);\n  if (actions) {\n    const hasActionableItem = actionItems.some((item) => item.priority < 2);\n    const actionHeading = options.status === \"review suggested\" || !hasActionableItem ? \"Review\" : \"Fix first\";\n    sections.push(`**${actionHeading}**\\n${actions}`);\n  }\n  sections.push(`**Next step:** ${collapseWhitespace(options.nextStep, 400)}`);\n  return sections.join(\"\\n\\n\");\n}\n\nexport function htmlValidationContent(messages: W3CMessage[], source?: string): string {\n  const errorCount = messages.filter((message) => getW3CMessageSeverity(message) === \"error\").length;\n  const warningCount = messages.filter((message) => getW3CMessageSeverity(message) === \"warning\").length;\n  const infoCount = messages.length - errorCount - warningCount;\n  const sourceText = source ? ` for ${markdownCode(source, 180)}` : \"\";\n  if (messages.length === 0) {\n    return toolContent({\n      title: \"HTML validation\",\n      status: \"clean\",\n      outcome: `The W3C validator returned no HTML diagnostics${sourceText}.`,\n      nextStep: \"Keep this result as a baseline and validate again after the next markup change.\",\n    });\n  }\n\n  const hasActionableDiagnostics = errorCount > 0 || warningCount > 0;\n  return toolContent({\n    title: \"HTML validation\",\n    status: hasActionableDiagnostics ? \"attention needed\" : \"review suggested\",\n    outcome: `The W3C validator returned ${countLabel(errorCount, \"error\")}, ${countLabel(warningCount, \"warning\")}, and ${countLabel(infoCount, \"informational diagnostic\")}${sourceText}.`,\n    actions: messages.map((message) => ({\n      priority: priorityForSeverity(getW3CMessageSeverity(message)),\n      message: message.message,\n      location: formatLocation(message.lastLine ?? message.firstLine, message.lastColumn ?? message.firstColumn),\n    })),\n    nextStep: hasActionableDiagnostics\n      ? \"Fix errors first, then warnings, and rerun HTML validation to confirm the markup is clean.\"\n      : \"Review the informational diagnostics, then rerun validation after relevant markup changes.\",\n  });\n}\n\nexport function cssValidationContent(messages: CSSMessage[]): string {\n  if (messages.length === 0) {\n    return toolContent({\n      title: \"CSS validation\",\n      status: \"clean\",\n      outcome: \"The W3C validator returned no CSS errors.\",\n      nextStep: \"Validate again after the next stylesheet change.\",\n    });\n  }\n\n  const compatibilityLimitations = messages.filter(\n    (message) => message.compatibility === \"known-validator-limitation\",\n  );\n  const actionableErrors = messages.length - compatibilityLimitations.length;\n\n  return toolContent({\n    title: \"CSS validation\",\n    status: actionableErrors > 0 ? \"attention needed\" : \"review suggested\",\n    outcome: compatibilityLimitations.length > 0\n      ? `The W3C validator returned ${countLabel(messages.length, \"CSS error\")}; ${countLabel(compatibilityLimitations.length, \"diagnostic\")} ${compatibilityLimitations.length === 1 ? \"matches\" : \"match\"} a known validator limitation.`\n      : `The W3C validator returned ${countLabel(messages.length, \"CSS error\")}.`,\n    actions: messages.map((message) => ({\n      priority: message.compatibility === \"known-validator-limitation\" ? 2 : 0,\n      message: message.context ? `${message.message} Context: ${message.context}` : message.message,\n      location: formatLocation(message.line),\n    })),\n    nextStep: actionableErrors > 0\n      ? \"Correct the actionable errors, then rerun CSS validation because one syntax issue can cause later diagnostics.\"\n      : \"Review the marked @container diagnostic against current CSS specifications; do not treat it as invalid CSS by itself.\",\n    note: compatibilityLimitations.length > 0\n      ? \"Jigsaw currently does not recognize the standards-defined @container rule. The upstream diagnostic is preserved and marked as a known validator limitation.\"\n      : undefined,\n  });\n}\n\nexport function seoAuditContent(issues: SEOIssue[], totalIssues: number, truncated: boolean): string {\n  const errors = issues.filter((issue) => issue.severity === \"error\").length;\n  const warnings = issues.filter((issue) => issue.severity === \"warning\").length;\n  const info = issues.filter((issue) => issue.severity === \"info\").length;\n  if (totalIssues === 0) {\n    return toolContent({\n      title: \"SEO audit\",\n      status: \"clean within this audit\",\n      outcome: \"This focused rules-based audit found no SEO or accessibility issues in the supplied HTML.\",\n      nextStep: \"Keep the metadata current and rerun the audit whenever the page template changes.\",\n      note: \"This result does not replace a crawl, performance test, or Search Console review.\",\n    });\n  }\n\n  const hasActionableFindings = errors > 0 || warnings > 0;\n  return toolContent({\n    title: \"SEO audit\",\n    status: hasActionableFindings ? \"attention needed\" : \"review suggested\",\n    outcome: `The audit found ${countLabel(errors, \"error\")}, ${countLabel(warnings, \"warning\")}, and ${countLabel(info, \"suggestion\")}.`,\n    actions: issues.map((issue) => ({\n      priority: priorityForSeverity(issue.severity),\n      message: issue.message,\n      location: issue.element ? collapseWhitespace(issue.element, 120) : undefined,\n    })),\n    nextStep: hasActionableFindings\n      ? \"Address errors first, then warnings, and rerun the audit after updating the page.\"\n      : \"Review the suggestions that apply to this page, then rerun the audit after relevant template changes.\",\n    note: truncated\n      ? `Showing the first ${issues.length} of ${totalIssues} findings in structured output.`\n      : undefined,\n  });\n}\n\nfunction countJsonLdBlocks(htmlContent: string): number {\n  const $ = cheerio.load(htmlContent);\n  return $(\"script[type]\").filter((_, element) => {\n    const type = $(element).attr(\"type\");\n    return type?.split(\";\", 1)[0].trim().toLowerCase() === \"application/ld+json\";\n  }).length;\n}\n\nexport function schemaValidationContent(\n  issues: SEOIssue[],\n  totalIssues: number,\n  truncated: boolean,\n  htmlContent: string,\n): string {\n  const blockCount = countJsonLdBlocks(htmlContent);\n  if (blockCount === 0) {\n    return toolContent({\n      title: \"JSON-LD syntax\",\n      status: \"not present\",\n      outcome: \"No JSON-LD script blocks were found, so there was no structured data to parse.\",\n      nextStep: \"Add JSON-LD only when it accurately describes visible page content, then validate it again.\",\n    });\n  }\n  if (totalIssues === 0) {\n    return toolContent({\n      title: \"JSON-LD syntax\",\n      status: \"clean\",\n      outcome: `${countLabel(blockCount, \"JSON-LD block\")} parsed without syntax errors.`,\n      nextStep: \"Verify the properties against the relevant Schema.org type and search-engine requirements.\",\n      note: \"This check covers JSON syntax only; it does not validate vocabulary semantics or rich-result eligibility.\",\n    });\n  }\n\n  return toolContent({\n    title: \"JSON-LD syntax\",\n    status: \"attention needed\",\n    outcome: `${countLabel(totalIssues, \"syntax issue\")} ${totalIssues === 1 ? \"was\" : \"were\"} found across ${countLabel(blockCount, \"JSON-LD block\")}.`,\n    actions: issues.map((issue) => ({\n      priority: priorityForSeverity(issue.severity),\n      message: issue.message,\n    })),\n    nextStep: \"Repair the invalid or empty blocks, then rerun this syntax check before testing rich-result eligibility.\",\n    note: truncated\n      ? `Showing the first ${issues.length} of ${totalIssues} findings in structured output.`\n      : undefined,\n  });\n}\n\nfunction linkPriority(link: LinkStatus): ActionPriority {\n  if (isRedirect(link)) return 1;\n  return 0;\n}\n\nfunction isRedirect(link: LinkStatus): boolean {\n  return typeof link.status === \"number\" && link.status >= 300 && link.status < 400;\n}\n\nfunction linkActionMessage(link: LinkStatus): string {\n  if (isRedirect(link)) {\n    return `${link.status} redirect; destination was not followed`;\n  }\n  return `Link returned ${typeof link.status === \"number\" ? `HTTP ${link.status}` : link.status}${link.message ? ` — ${link.message}` : \"\"}`;\n}\n\nexport function linkCheckContent(links: LinkStatus[], baseUrl?: string): string {\n  if (links.length === 0) {\n    return toolContent({\n      title: \"Link check\",\n      status: \"nothing checked\",\n      outcome: \"No eligible public HTTP(S) links were found, so no link requests were made.\",\n      nextStep: baseUrl\n        ? \"Confirm the HTML contains reachable anchor URLs, then run the check again.\"\n        : \"If the page uses relative links, provide its public base URL and run the check again.\",\n    });\n  }\n\n  const unreachable = links.filter((link) => !link.ok);\n  const redirects = links.filter(isRedirect);\n  if (unreachable.length === 0 && redirects.length === 0) {\n    return toolContent({\n      title: \"Link check\",\n      status: \"clean\",\n      outcome: links.length === 1\n        ? \"The checked link returned a successful response.\"\n        : `All ${links.length} checked links returned a successful response.`,\n      nextStep: \"Recheck periodically because external link availability can change.\",\n    });\n  }\n\n  const actions = [\n    ...unreachable,\n    ...redirects,\n  ].map((link) => ({\n    priority: linkPriority(link),\n    location: link.url,\n    message: linkActionMessage(link),\n  }));\n\n  const linkOutcome = [\n    unreachable.length > 0\n      ? `${countLabel(unreachable.length, \"link\")} ${unreachable.length === 1 ? \"is\" : \"are\"} broken or unreachable`\n      : \"no checked links are broken or unreachable\",\n    redirects.length > 0\n      ? `${countLabel(redirects.length, \"redirect\")} ${redirects.length === 1 ? \"needs\" : \"need\"} review`\n      : undefined,\n  ].filter((item): item is string => item !== undefined).join(\"; \");\n\n  return toolContent({\n    title: \"Link check\",\n    status: unreachable.length > 0 ? \"attention needed\" : \"review suggested\",\n    outcome: `${linkOutcome} of ${links.length} checked. Redirect destinations are not followed.`,\n    actions,\n    nextStep: \"Update failed destinations and review redirects, then rerun the link check.\",\n  });\n}\n\nfunction reportActionItems(reportData: ValidationReportResult): ActionItem[] {\n  return [\n    ...(reportData.errors ?? []).map((message) => ({\n      priority: 0 as const,\n      message,\n    })),\n    ...reportData.htmlMessages.map((message) => ({\n      priority: priorityForSeverity(getW3CMessageSeverity(message)),\n      message: `HTML: ${message.message}`,\n      location: formatLocation(message.lastLine ?? message.firstLine, message.lastColumn ?? message.firstColumn),\n    })),\n    ...reportData.cssMessages.map((message) => ({\n      priority: message.compatibility === \"known-validator-limitation\" ? 2 as const : 0 as const,\n      message: `CSS: ${message.message}`,\n      location: formatLocation(message.line),\n    })),\n    ...reportData.seoIssues.map((issue) => ({\n      priority: priorityForSeverity(issue.severity),\n      message: `${issue.category}: ${issue.message}`,\n      location: issue.element ? collapseWhitespace(issue.element, 120) : undefined,\n    })),\n    ...reportData.schemaIssues.map((issue) => ({\n      priority: priorityForSeverity(issue.severity),\n      message: `JSON-LD: ${issue.message}`,\n    })),\n    ...reportData.links\n      .filter((link) => !link.ok || isRedirect(link))\n      .map((link) => ({\n        priority: linkPriority(link),\n        message: linkActionMessage(link),\n        location: link.url,\n      })),\n  ];\n}\n\nexport function reportContent(reportData: ValidationReportResult): string {\n  const { summary } = reportData;\n  const actions = reportActionItems(reportData);\n  const partial = reportData.failedChecks.length > 0;\n  const compatibilityLimited = summary.cssCompatibilityLimitations > 0;\n  const hasActionableFinding = actions.some((action) => action.priority < 2);\n  const status = partial\n    ? \"partial\"\n    : compatibilityLimited\n      ? \"compatibility-limited\"\n      : actions.length === 0\n        ? \"clean across completed checks\"\n        : hasActionableFinding\n          ? \"attention needed\"\n          : \"review suggested\";\n  const cssSummary = summary.cssScore === null\n    ? reportData.failedChecks.includes(\"css\")\n      ? \"CSS validation unavailable\"\n      : compatibilityLimited\n        ? `${countLabel(summary.cssErrors, \"CSS error\")}, including ${countLabel(summary.cssCompatibilityLimitations, \"known validator limitation\")}`\n        : \"CSS not audited\"\n    : countLabel(summary.cssErrors, \"CSS error\");\n  const redirects = reportData.links.filter(isRedirect).length;\n  const linkSummary = summary.linkScore === null\n    ? reportData.failedChecks.includes(\"links\")\n      ? \"link checking unavailable\"\n      : \"no eligible links checked\"\n    : `${summary.brokenLinks} broken or unreachable and ${countLabel(redirects, \"redirect\")} to review of ${countLabel(summary.linksChecked, \"link\")}`;\n  const checkLabels = {\n    input: \"input file\",\n    html: \"HTML validation\",\n    css: \"CSS validation\",\n    seo: \"SEO analysis\",\n    schema: \"JSON-LD analysis\",\n    links: \"link checking\",\n  } as const;\n  const unavailableChecks = reportData.failedChecks\n    .filter((check) => check !== \"input\")\n    .map((check) => checkLabels[check]);\n  return toolContent({\n    title: \"Validation report\",\n    status,\n    outcome: partial\n      ? `Partial validation report: ${unavailableChecks.join(\", \")} ${unavailableChecks.length === 1 ? \"was\" : \"were\"} unavailable; remaining checks completed. HTML has ${countLabel(summary.htmlErrors, \"error\")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, \"error\")}; JSON-LD has ${countLabel(summary.schemaErrors, \"syntax error\")}; ${linkSummary}.`\n      : compatibilityLimited\n        ? `The overall heuristic score is withheld because CSS validation includes ${countLabel(summary.cssCompatibilityLimitations, \"known validator limitation\")}. HTML has ${countLabel(summary.htmlErrors, \"error\")} and ${countLabel(summary.htmlWarnings, \"warning\")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, \"error\")} and ${countLabel(summary.seoWarnings, \"warning\")}; JSON-LD has ${countLabel(summary.schemaErrors, \"syntax error\")}; ${linkSummary}.`\n        : `The report's heuristic overall score is **${summary.overallScore}/100**. HTML has ${countLabel(summary.htmlErrors, \"error\")} and ${countLabel(summary.htmlWarnings, \"warning\")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, \"error\")} and ${countLabel(summary.seoWarnings, \"warning\")}; JSON-LD has ${countLabel(summary.schemaErrors, \"syntax error\")}; ${linkSummary}.`,\n    actions,\n    nextStep: partial\n      ? \"Review the completed findings, then retry the unavailable checks.\"\n      : compatibilityLimited\n        ? \"Review actionable findings normally, and treat the marked @container diagnostic as an upstream validator limitation rather than proof of invalid CSS.\"\n        : actions.length === 0\n          ? \"Use the full Markdown report as the audit record and rerun it after meaningful page changes.\"\n          : \"Work through these priorities, then regenerate the report to compare the heuristic score.\",\n    note: partial\n      ? \"No overall score is shown while one or more checks are unavailable.\"\n      : compatibilityLimited\n        ? \"CSS and overall scores are withheld while a known Jigsaw parser limitation is present; the original upstream diagnostic remains visible.\"\n        : \"The score is a triage heuristic based on these checks, not a Lighthouse score or a search-ranking prediction.\",\n  });\n}\n\nexport function screenshotCaptureContent(count: number, outputDirectory: string): string {\n  return toolContent({\n    title: \"Screenshot capture\",\n    status: \"complete\",\n    outcome: `Saved ${countLabel(count, \"PNG screenshot\")} to ${markdownCode(outputDirectory)}.`,\n    nextStep: \"Open the PNG files and compare the rendered layouts at each requested viewport.\",\n  });\n}\n\nexport function failureContent(title: string, error: string, nextStep: string): string {\n  return toolContent({\n    title,\n    status: \"could not finish\",\n    outcome: markdownText(error, 500),\n    nextStep,\n  });\n}\n"]}

package/dist/screenshot-proxy.d.ts

@@ -0,0 +1,5 @@
+export interface ScreenshotTransportProxy {
+    url: string;
+    close(): Promise<void>;
+}
+export declare function startScreenshotTransportProxy(onBlocked: (message: string) => void): Promise<ScreenshotTransportProxy>;

package/dist/screenshot-proxy.js

@@ -0,0 +1,226 @@
+import * as http from "node:http";
+import * as https from "node:https";
+import * as net from "node:net";
+import { getErrorMessage, resolvePublicHttpUrl, } from "./network.js";
+const PROXY_CONNECT_TIMEOUT_MS = 5_000;
+const LOOPBACK_HOST = "127.0.0.1";
+function createPinnedLookup(addresses) {
+    const pinned = addresses.map((record) => ({ ...record }));
+    return (_hostname, options, callback) => {
+        const requestedFamily = options.family === 4 || options.family === 6 ? options.family : 0;
+        const candidates = requestedFamily
+            ? pinned.filter((record) => record.family === requestedFamily)
+            : pinned;
+        if (candidates.length === 0) {
+            const error = new Error("No validated address is available for the requested IP family");
+            error.code = "ENOTFOUND";
+            callback(error, []);
+            return;
+        }
+        if (options.all) {
+            callback(null, candidates);
+            return;
+        }
+        const selected = candidates[0];
+        callback(null, selected.address, selected.family);
+    };
+}
+async function connectPinnedTcp(addresses, port) {
+    let lastError;
+    for (const record of addresses) {
+        try {
+            return await new Promise((resolve, reject) => {
+                const socket = net.connect({
+                    host: record.address,
+                    port,
+                    family: record.family === 6 ? 6 : 4,
+                });
+                let settled = false;
+                let timer;
+                const finish = (error) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    if (timer)
+                        clearTimeout(timer);
+                    socket.off("error", onError);
+                    if (error) {
+                        socket.destroy();
+                        reject(error);
+                    }
+                    else {
+                        resolve(socket);
+                    }
+                };
+                const onError = (error) => finish(error);
+                timer = setTimeout(() => finish(new Error("Pinned screenshot proxy connection timed out")), PROXY_CONNECT_TIMEOUT_MS);
+                socket.once("error", onError);
+                socket.once("connect", () => finish());
+            });
+        }
+        catch (error) {
+            lastError = error;
+        }
+    }
+    throw lastError ?? new Error("No validated address was available for the screenshot proxy connection");
+}
+function sendProxyFailure(response) {
+    if (!response.headersSent) {
+        response.writeHead(502, {
+            Connection: "close",
+            "Content-Length": "0",
+        });
+    }
+    response.end();
+}
+function sendTunnelFailure(socket) {
+    if (socket.destroyed)
+        return;
+    socket.end("HTTP/1.1 502 Bad Gateway\r\nConnection: close\r\nContent-Length: 0\r\n\r\n");
+}
+function proxyRequestUrl(request) {
+    const requestUrl = request.url?.trim();
+    if (!requestUrl) {
+        throw new Error("Blocked empty screenshot proxy request URL");
+    }
+    if (/^https?:\/\//i.test(requestUrl)) {
+        return requestUrl;
+    }
+    const host = request.headers.host?.trim();
+    if (!host) {
+        throw new Error("Blocked screenshot proxy request without a Host header");
+    }
+    return `http://${host}${requestUrl.startsWith("/") ? requestUrl : `/${requestUrl}`}`;
+}
+async function forwardHttpRequest(request, response, onBlocked) {
+    let target;
+    try {
+        target = await resolvePublicHttpUrl(proxyRequestUrl(request));
+    }
+    catch (error) {
+        onBlocked(getErrorMessage(error));
+        sendProxyFailure(response);
+        return;
+    }
+    const headers = { ...request.headers };
+    delete headers["proxy-authorization"];
+    delete headers["proxy-connection"];
+    headers.host = target.url.host;
+    const handleResponse = (upstreamResponse) => {
+        response.writeHead(upstreamResponse.statusCode ?? 502, upstreamResponse.headers);
+        upstreamResponse.pipe(response);
+    };
+    const requestOptions = {
+        hostname: target.url.hostname,
+        port: target.url.protocol === "https:" ? 443 : 80,
+        method: request.method,
+        path: `${target.url.pathname}${target.url.search}`,
+        headers,
+        lookup: createPinnedLookup(target.addresses),
+        agent: false,
+    };
+    let upstreamRequest;
+    if (target.url.protocol === "https:") {
+        const httpsOptions = {
+            ...requestOptions,
+            servername: target.url.hostname,
+        };
+        upstreamRequest = https.request(httpsOptions, handleResponse);
+    }
+    else {
+        upstreamRequest = http.request(requestOptions, handleResponse);
+    }
+    upstreamRequest.once("error", () => sendProxyFailure(response));
+    request.once("aborted", () => upstreamRequest.destroy());
+    request.pipe(upstreamRequest);
+}
+async function forwardConnect(request, clientSocket, head, onBlocked, trackUpstream) {
+    const authority = request.url?.trim();
+    if (!authority) {
+        onBlocked("Blocked empty screenshot proxy tunnel target");
+        sendTunnelFailure(clientSocket);
+        return;
+    }
+    let target;
+    try {
+        target = await resolvePublicHttpUrl(`https://${authority}/`);
+    }
+    catch (error) {
+        onBlocked(getErrorMessage(error));
+        sendTunnelFailure(clientSocket);
+        return;
+    }
+    let upstreamSocket;
+    try {
+        upstreamSocket = await connectPinnedTcp(target.addresses, 443);
+    }
+    catch {
+        sendTunnelFailure(clientSocket);
+        return;
+    }
+    trackUpstream(upstreamSocket);
+    clientSocket.write("HTTP/1.1 200 Connection Established\r\n\r\n");
+    if (head.length > 0)
+        upstreamSocket.write(head);
+    clientSocket.once("error", () => upstreamSocket.destroy());
+    upstreamSocket.once("error", () => clientSocket.destroy());
+    clientSocket.once("close", () => upstreamSocket.destroy());
+    upstreamSocket.once("close", () => clientSocket.destroy());
+    clientSocket.pipe(upstreamSocket);
+    upstreamSocket.pipe(clientSocket);
+}
+export async function startScreenshotTransportProxy(onBlocked) {
+    const clientSockets = new Set();
+    const upstreamSockets = new Set();
+    const server = http.createServer((request, response) => {
+        void forwardHttpRequest(request, response, onBlocked).catch(() => {
+            sendProxyFailure(response);
+        });
+    });
+    server.on("connection", (socket) => {
+        clientSockets.add(socket);
+        socket.once("close", () => clientSockets.delete(socket));
+    });
+    server.on("connect", (request, socket, head) => {
+        void forwardConnect(request, socket, head, onBlocked, (upstreamSocket) => {
+            upstreamSockets.add(upstreamSocket);
+            upstreamSocket.once("close", () => upstreamSockets.delete(upstreamSocket));
+        }).catch(() => sendTunnelFailure(socket));
+    });
+    server.on("clientError", (_error, socket) => {
+        if (!socket.destroyed) {
+            socket.end("HTTP/1.1 400 Bad Request\r\nConnection: close\r\nContent-Length: 0\r\n\r\n");
+        }
+    });
+    await new Promise((resolve, reject) => {
+        const onError = (error) => reject(error);
+        server.once("error", onError);
+        server.listen(0, LOOPBACK_HOST, () => {
+            server.off("error", onError);
+            resolve();
+        });
+    });
+    const address = server.address();
+    if (!address || typeof address === "string") {
+        server.close();
+        throw new Error("Screenshot transport proxy did not expose a loopback TCP address");
+    }
+    let closed = false;
+    return {
+        url: `http://${LOOPBACK_HOST}:${address.port}`,
+        async close() {
+            if (closed)
+                return;
+            closed = true;
+            const closePromise = new Promise((resolve) => {
+                server.close(() => resolve());
+            });
+            for (const socket of clientSockets)
+                socket.destroy();
+            for (const socket of upstreamSockets)
+                socket.destroy();
+            await closePromise;
+        },
+    };
+}
+//# sourceMappingURL=screenshot-proxy.js.map

package/dist/screenshot-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-proxy.js","sourceRoot":"","sources":["../src/screenshot-proxy.ts"],"names":[],"mappings":"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","sourcesContent":["import * as http from \"node:http\";\nimport * as https from \"node:https\";\nimport * as net from \"node:net\";\nimport {\n  getErrorMessage,\n  resolvePublicHttpUrl,\n  type ResolvedPublicHttpUrl,\n} from \"./network.js\";\n\nconst PROXY_CONNECT_TIMEOUT_MS = 5_000;\nconst LOOPBACK_HOST = \"127.0.0.1\";\n\ntype ResolvedAddress = ResolvedPublicHttpUrl[\"addresses\"][number];\n\nexport interface ScreenshotTransportProxy {\n  url: string;\n  close(): Promise<void>;\n}\n\nfunction createPinnedLookup(addresses: readonly ResolvedAddress[]): net.LookupFunction {\n  const pinned = addresses.map((record) => ({ ...record }));\n  return (_hostname, options, callback): void => {\n    const requestedFamily = options.family === 4 || options.family === 6 ? options.family : 0;\n    const candidates = requestedFamily\n      ? pinned.filter((record) => record.family === requestedFamily)\n      : pinned;\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    if (options.all) {\n      callback(null, candidates);\n      return;\n    }\n    const selected = candidates[0];\n    callback(null, selected.address, selected.family);\n  };\n}\n\nasync function connectPinnedTcp(\n  addresses: readonly ResolvedAddress[],\n  port: number,\n): Promise<net.Socket> {\n  let lastError: unknown;\n  for (const record of addresses) {\n    try {\n      return await new Promise<net.Socket>((resolve, reject) => {\n        const socket = net.connect({\n          host: record.address,\n          port,\n          family: record.family === 6 ? 6 : 4,\n        });\n        let settled = false;\n        let timer: NodeJS.Timeout | undefined;\n        const finish = (error?: unknown): void => {\n          if (settled) return;\n          settled = true;\n          if (timer) clearTimeout(timer);\n          socket.off(\"error\", onError);\n          if (error) {\n            socket.destroy();\n            reject(error);\n          } else {\n            resolve(socket);\n          }\n        };\n        const onError = (error: Error): void => finish(error);\n        timer = setTimeout(\n          () => finish(new Error(\"Pinned screenshot proxy connection timed out\")),\n          PROXY_CONNECT_TIMEOUT_MS,\n        );\n        socket.once(\"error\", onError);\n        socket.once(\"connect\", () => finish());\n      });\n    } catch (error) {\n      lastError = error;\n    }\n  }\n  throw lastError ?? new Error(\"No validated address was available for the screenshot proxy connection\");\n}\n\nfunction sendProxyFailure(response: http.ServerResponse): void {\n  if (!response.headersSent) {\n    response.writeHead(502, {\n      Connection: \"close\",\n      \"Content-Length\": \"0\",\n    });\n  }\n  response.end();\n}\n\nfunction sendTunnelFailure(socket: net.Socket): void {\n  if (socket.destroyed) return;\n  socket.end(\n    \"HTTP/1.1 502 Bad Gateway\\r\\nConnection: close\\r\\nContent-Length: 0\\r\\n\\r\\n\",\n  );\n}\n\nfunction proxyRequestUrl(request: http.IncomingMessage): string {\n  const requestUrl = request.url?.trim();\n  if (!requestUrl) {\n    throw new Error(\"Blocked empty screenshot proxy request URL\");\n  }\n  if (/^https?:\\/\\//i.test(requestUrl)) {\n    return requestUrl;\n  }\n  const host = request.headers.host?.trim();\n  if (!host) {\n    throw new Error(\"Blocked screenshot proxy request without a Host header\");\n  }\n  return `http://${host}${requestUrl.startsWith(\"/\") ? requestUrl : `/${requestUrl}`}`;\n}\n\nasync function forwardHttpRequest(\n  request: http.IncomingMessage,\n  response: http.ServerResponse,\n  onBlocked: (message: string) => void,\n): Promise<void> {\n  let target: ResolvedPublicHttpUrl;\n  try {\n    target = await resolvePublicHttpUrl(proxyRequestUrl(request));\n  } catch (error) {\n    onBlocked(getErrorMessage(error));\n    sendProxyFailure(response);\n    return;\n  }\n\n  const headers: http.OutgoingHttpHeaders = { ...request.headers };\n  delete headers[\"proxy-authorization\"];\n  delete headers[\"proxy-connection\"];\n  headers.host = target.url.host;\n\n  const handleResponse = (upstreamResponse: http.IncomingMessage): void => {\n    response.writeHead(upstreamResponse.statusCode ?? 502, upstreamResponse.headers);\n    upstreamResponse.pipe(response);\n  };\n  const requestOptions: http.RequestOptions = {\n    hostname: target.url.hostname,\n    port: target.url.protocol === \"https:\" ? 443 : 80,\n    method: request.method,\n    path: `${target.url.pathname}${target.url.search}`,\n    headers,\n    lookup: createPinnedLookup(target.addresses),\n    agent: false,\n  };\n  let upstreamRequest: http.ClientRequest;\n  if (target.url.protocol === \"https:\") {\n    const httpsOptions: https.RequestOptions = {\n      ...requestOptions,\n      servername: target.url.hostname,\n    };\n    upstreamRequest = https.request(httpsOptions, handleResponse);\n  } else {\n    upstreamRequest = http.request(requestOptions, handleResponse);\n  }\n\n  upstreamRequest.once(\"error\", () => sendProxyFailure(response));\n  request.once(\"aborted\", () => upstreamRequest.destroy());\n  request.pipe(upstreamRequest);\n}\n\nasync function forwardConnect(\n  request: http.IncomingMessage,\n  clientSocket: net.Socket,\n  head: Buffer,\n  onBlocked: (message: string) => void,\n  trackUpstream: (socket: net.Socket) => void,\n): Promise<void> {\n  const authority = request.url?.trim();\n  if (!authority) {\n    onBlocked(\"Blocked empty screenshot proxy tunnel target\");\n    sendTunnelFailure(clientSocket);\n    return;\n  }\n\n  let target: ResolvedPublicHttpUrl;\n  try {\n    target = await resolvePublicHttpUrl(`https://${authority}/`);\n  } catch (error) {\n    onBlocked(getErrorMessage(error));\n    sendTunnelFailure(clientSocket);\n    return;\n  }\n\n  let upstreamSocket: net.Socket;\n  try {\n    upstreamSocket = await connectPinnedTcp(target.addresses, 443);\n  } catch {\n    sendTunnelFailure(clientSocket);\n    return;\n  }\n  trackUpstream(upstreamSocket);\n\n  clientSocket.write(\"HTTP/1.1 200 Connection Established\\r\\n\\r\\n\");\n  if (head.length > 0) upstreamSocket.write(head);\n\n  clientSocket.once(\"error\", () => upstreamSocket.destroy());\n  upstreamSocket.once(\"error\", () => clientSocket.destroy());\n  clientSocket.once(\"close\", () => upstreamSocket.destroy());\n  upstreamSocket.once(\"close\", () => clientSocket.destroy());\n  clientSocket.pipe(upstreamSocket);\n  upstreamSocket.pipe(clientSocket);\n}\n\nexport async function startScreenshotTransportProxy(\n  onBlocked: (message: string) => void,\n): Promise<ScreenshotTransportProxy> {\n  const clientSockets = new Set<net.Socket>();\n  const upstreamSockets = new Set<net.Socket>();\n  const server = http.createServer((request, response) => {\n    void forwardHttpRequest(request, response, onBlocked).catch(() => {\n      sendProxyFailure(response);\n    });\n  });\n\n  server.on(\"connection\", (socket) => {\n    clientSockets.add(socket);\n    socket.once(\"close\", () => clientSockets.delete(socket));\n  });\n  server.on(\"connect\", (request, socket, head) => {\n    void forwardConnect(\n      request,\n      socket as net.Socket,\n      head,\n      onBlocked,\n      (upstreamSocket) => {\n        upstreamSockets.add(upstreamSocket);\n        upstreamSocket.once(\"close\", () => upstreamSockets.delete(upstreamSocket));\n      },\n    ).catch(() => sendTunnelFailure(socket as net.Socket));\n  });\n  server.on(\"clientError\", (_error, socket) => {\n    if (!socket.destroyed) {\n      socket.end(\"HTTP/1.1 400 Bad Request\\r\\nConnection: close\\r\\nContent-Length: 0\\r\\n\\r\\n\");\n    }\n  });\n\n  await new Promise<void>((resolve, reject) => {\n    const onError = (error: Error): void => reject(error);\n    server.once(\"error\", onError);\n    server.listen(0, LOOPBACK_HOST, () => {\n      server.off(\"error\", onError);\n      resolve();\n    });\n  });\n\n  const address = server.address();\n  if (!address || typeof address === \"string\") {\n    server.close();\n    throw new Error(\"Screenshot transport proxy did not expose a loopback TCP address\");\n  }\n\n  let closed = false;\n  return {\n    url: `http://${LOOPBACK_HOST}:${address.port}`,\n    async close(): Promise<void> {\n      if (closed) return;\n      closed = true;\n      const closePromise = new Promise<void>((resolve) => {\n        server.close(() => resolve());\n      });\n      for (const socket of clientSockets) socket.destroy();\n      for (const socket of upstreamSockets) socket.destroy();\n      await closePromise;\n    },\n  };\n}\n"]}

package/dist/screenshot.d.ts

@@ -19,7 +19,7 @@ type BrowserInstaller = (options: InstallOptions & {
     executablePath: string;
 }>;
 export interface ScreenshotBrowserRuntime {
-    launch(): Promise<PuppeteerBrowser>;
+    launch(proxyServer: string): Promise<PuppeteerBrowser>;
 }
 export declare function resolveScreenshotBrowserExecutable(options?: {
     cacheDir?: string;

package/dist/screenshot.js

@@ -5,6 +5,7 @@ import * as fs from "fs/promises";
 import * as os from "node:os";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { assertPublicHttpUrl, getErrorMessage } from "./network.js";
+import { startScreenshotTransportProxy } from "./screenshot-proxy.js";
 const DEFAULT_VIEWPORTS = [
     { name: "desktop", width: 1440, height: 900 },
     { name: "tablet", width: 768, height: 1024 },
@@ -54,7 +55,7 @@ export async function resolveScreenshotBrowserExecutable(options = {}) {
 }
 let screenshotBrowserExecutablePromise;
 const defaultScreenshotBrowserRuntime = {
-    async launch() {
+    async launch(proxyServer) {
         screenshotBrowserExecutablePromise ??= resolveScreenshotBrowserExecutable();
         let executablePath;
         try {
@@ -67,6 +68,10 @@ const defaultScreenshotBrowserRuntime = {
         return puppeteer.launch({
             executablePath,
             headless: SCREENSHOT_HEADLESS_MODE,
+            args: [
+                `--proxy-server=${proxyServer}`,
+                "--proxy-bypass-list=<-loopback>",
+            ],
         });
     },
 };
@@ -197,12 +202,16 @@ export async function captureScreenshots(targetPath, outputDirectory, customView
     }
     // Ensure output directory exists
     await fs.mkdir(resolvedOutputDirectory, { recursive: true });
-    const browser = await browserRuntime.launch();
     const results = [];
+    let blockedRequestMessage;
+    const transportProxy = await startScreenshotTransportProxy((message) => {
+        blockedRequestMessage ??= message;
+    });
+    let browser;
     try {
+        browser = await browserRuntime.launch(transportProxy.url);
         const page = await browser.newPage();
         page.setDefaultNavigationTimeout(NAVIGATION_TIMEOUT_MS);
-        let blockedRequestMessage;
         await page.setRequestInterception(true);
         page.on("request", (request) => {
             void resolveScreenshotRequest(request, localDirectory, (message) => {
@@ -247,7 +256,10 @@ export async function captureScreenshots(targetPath, outputDirectory, customView
         }
     }
     finally {
-        await browser.close();
+        if (browser) {
+            await browser.close();
+        }
+        await transportProxy.close();
     }
     return results;
 }

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\";\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(): 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(): 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    });\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 browser = await browserRuntime.launch();\n\n  const results: ScreenshotResult[] = [];\n\n  try {\n    const page = await browser.newPage();\n    page.setDefaultNavigationTimeout(NAVIGATION_TIMEOUT_MS);\n\n    let blockedRequestMessage: string | undefined;\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    await browser.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 = \"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"]}

package/dist/seo-auditor.js

@@ -196,8 +196,8 @@ export function auditSeoMetadataDetailed(htmlContent) {
         }
     });
     // --- Open Graph / Social Tags ---
-    const ogTitle = $('meta[property="og:title"]');
-    const ogImage = $('meta[property="og:image"]');
+    const ogTitle = $('head > meta[property="og:title"]');
+    const ogImage = $('head > meta[property="og:image"]');
     if (ogTitle.length === 0 || ogImage.length === 0) {
         add({
             code: "seo.open_graph.missing",

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 AuditDetails {\n  issues: SEOIssue[];\n  totalIssues: number;\n  truncated: boolean;\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  return {\n    issues,\n    add(issue) {\n      totalIssues += 1;\n      addIssue(issues, issue);\n    },\n    details() {\n      return {\n        issues,\n        totalIssues,\n        truncated: totalIssues > issues.length,\n      };\n    },\n  };\n}\n\nfunction isJsonLdScriptType(type: string | undefined): boolean {\n  return type?.split(\";\", 1)[0].trim().toLowerCase() === \"application/ld+json\";\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 = $('meta[property=\"og:title\"]');\n  const ogImage = $('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      JSON.parse(scriptText);\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 AuditDetails {\n  issues: SEOIssue[];\n  totalIssues: number;\n  truncated: boolean;\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  return {\n    issues,\n    add(issue) {\n      totalIssues += 1;\n      addIssue(issues, issue);\n    },\n    details() {\n      return {\n        issues,\n        totalIssues,\n        truncated: totalIssues > issues.length,\n      };\n    },\n  };\n}\n\nfunction isJsonLdScriptType(type: string | undefined): boolean {\n  return type?.split(\";\", 1)[0].trim().toLowerCase() === \"application/ld+json\";\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      JSON.parse(scriptText);\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.14",
+  "version": "1.3.16",
   "description": "W3C HTML/CSS Validator and Technical SEO Audit MCP Server for AI coding assistants.",
   "main": "dist/index.js",
   "bin": {