vercel-seo-audit 0.1.0

package/dist/audit/redirects.js

@@ -0,0 +1,134 @@
+import { COMMON_PAGES } from '../constants.js';
+import { followRedirectChain, fetchPage, fetchWithoutRedirect, } from '../utils/http.js';
+import { getMetaRefresh } from '../utils/html-parser.js';
+import { toHttpUrl, isHttps, hasTrailingSlash, addTrailingSlash, removeTrailingSlash, getOrigin, } from '../utils/url.js';
+export async function auditRedirects(ctx) {
+    const findings = [];
+    const { normalizedUrl, fetchOptions } = ctx;
+    // 1. Homepage redirect chain
+    const chain = await followRedirectChain(normalizedUrl, fetchOptions);
+    if (chain.isCircular) {
+        findings.push({
+            code: 'REDIRECT_LOOP',
+            severity: 'error',
+            category: 'redirect',
+            message: 'Redirect loop detected on homepage',
+            explanation: 'A redirect loop prevents search engines and users from reaching your page, causing crawl failures.',
+            suggestion: 'Check your server configuration and middleware for circular redirects.',
+            details: { hops: chain.hops },
+            url: normalizedUrl,
+        });
+    }
+    else if (chain.hops.length > 1) {
+        findings.push({
+            code: 'REDIRECT_CHAIN',
+            severity: 'warning',
+            category: 'redirect',
+            message: `Redirect chain with ${chain.hops.length} hops detected`,
+            explanation: 'Long redirect chains slow down page loading and may cause search engines to drop the page from the index.',
+            suggestion: 'Reduce the chain to a single redirect by pointing directly to the final URL.',
+            details: { hops: chain.hops, finalUrl: chain.finalUrl },
+            url: normalizedUrl,
+        });
+    }
+    // 2. HTTP → HTTPS check
+    if (isHttps(normalizedUrl)) {
+        try {
+            const httpUrl = toHttpUrl(normalizedUrl);
+            const httpChain = await followRedirectChain(httpUrl, fetchOptions);
+            if (isHttps(httpChain.finalUrl)) {
+                findings.push({
+                    code: 'HTTP_TO_HTTPS_REDIRECT',
+                    severity: 'pass',
+                    category: 'redirect',
+                    message: 'HTTP correctly redirects to HTTPS',
+                    explanation: 'HTTP to HTTPS redirects ensure users always reach the secure version of your site.',
+                    suggestion: 'No action needed.',
+                    url: httpUrl,
+                });
+            }
+            else {
+                findings.push({
+                    code: 'HTTP_NO_HTTPS_REDIRECT',
+                    severity: 'warning',
+                    category: 'redirect',
+                    message: 'HTTP does not redirect to HTTPS',
+                    explanation: 'Without an HTTP→HTTPS redirect, search engines may index the insecure version of your site.',
+                    suggestion: 'Configure your server or Vercel project to redirect HTTP traffic to HTTPS.',
+                    url: httpUrl,
+                });
+            }
+        }
+        catch {
+            // HTTP variant may not exist — not an issue
+        }
+    }
+    // 3. Trailing slash check
+    try {
+        const withSlash = addTrailingSlash(normalizedUrl);
+        const withoutSlash = removeTrailingSlash(normalizedUrl);
+        const testUrl = hasTrailingSlash(normalizedUrl) ? withoutSlash : withSlash;
+        const slashRes = await fetchWithoutRedirect(testUrl, fetchOptions);
+        if (slashRes.status >= 300 && slashRes.status < 400) {
+            const status = slashRes.status;
+            findings.push({
+                code: 'TRAILING_SLASH_REDIRECT',
+                severity: status === 308 ? 'info' : 'info',
+                category: 'redirect',
+                message: `Trailing slash ${hasTrailingSlash(normalizedUrl) ? 'removal' : 'addition'} causes ${status} redirect`,
+                explanation: 'Inconsistent trailing slash handling can create duplicate content issues for search engines.',
+                suggestion: 'Ensure consistent trailing slash behavior across your site. In Next.js, use the trailingSlash config option.',
+                details: { testedUrl: testUrl, status },
+                url: testUrl,
+            });
+        }
+    }
+    catch {
+        // Not critical
+    }
+    // 4. Meta refresh detection
+    try {
+        const page = await fetchPage(normalizedUrl, fetchOptions);
+        const metaRefreshUrl = getMetaRefresh(page.body);
+        if (metaRefreshUrl) {
+            findings.push({
+                code: 'META_REFRESH_REDIRECT',
+                severity: 'warning',
+                category: 'redirect',
+                message: 'Meta refresh redirect detected on homepage',
+                explanation: 'Meta refresh redirects are slower than server-side redirects and may confuse search engines.',
+                suggestion: 'Replace the meta refresh with a 301 server-side redirect.',
+                details: { targetUrl: metaRefreshUrl },
+                url: normalizedUrl,
+            });
+        }
+    }
+    catch {
+        // Not critical
+    }
+    // 5. Common page redirect checks
+    const origin = getOrigin(normalizedUrl);
+    for (const path of COMMON_PAGES) {
+        try {
+            const pageUrl = `${origin}${path}`;
+            const pageChain = await followRedirectChain(pageUrl, fetchOptions);
+            if (pageChain.hops.length > 1) {
+                findings.push({
+                    code: 'COMMON_PAGE_REDIRECT',
+                    severity: 'info',
+                    category: 'redirect',
+                    message: `${path} has a ${pageChain.hops.length}-hop redirect chain`,
+                    explanation: 'Redirect chains on commonly linked pages waste crawl budget.',
+                    suggestion: 'Reduce to a single redirect or update internal links to point to the final URL.',
+                    details: { hops: pageChain.hops, finalUrl: pageChain.finalUrl },
+                    url: pageUrl,
+                });
+            }
+        }
+        catch {
+            // Page may not exist
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=redirects.js.map

package/dist/audit/redirects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirects.js","sourceRoot":"","sources":["../../src/audit/redirects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EACL,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,GACV,MAAM,iBAAiB,CAAC;AAEzB,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAiB;IACpD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC;IAE5C,6BAA6B;IAC7B,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAErE,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,UAAU;YACpB,OAAO,EAAE,oCAAoC;YAC7C,WAAW,EACT,oGAAoG;YACtG,UAAU,EAAE,wEAAwE;YACpF,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;YAC7B,GAAG,EAAE,aAAa;SACnB,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,UAAU;YACpB,OAAO,EAAE,uBAAuB,KAAK,CAAC,IAAI,CAAC,MAAM,gBAAgB;YACjE,WAAW,EACT,2GAA2G;YAC7G,UAAU,EACR,8EAA8E;YAChF,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;YACvD,GAAG,EAAE,aAAa;SACnB,CAAC,CAAC;IACL,CAAC;IAED,wBAAwB;IACxB,IAAI,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;YACzC,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YACnE,IAAI,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,wBAAwB;oBAC9B,QAAQ,EAAE,MAAM;oBAChB,QAAQ,EAAE,UAAU;oBACpB,OAAO,EAAE,mCAAmC;oBAC5C,WAAW,EACT,oFAAoF;oBACtF,UAAU,EAAE,mBAAmB;oBAC/B,GAAG,EAAE,OAAO;iBACb,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,wBAAwB;oBAC9B,QAAQ,EAAE,SAAS;oBACnB,QAAQ,EAAE,UAAU;oBACpB,OAAO,EAAE,iCAAiC;oBAC1C,WAAW,EACT,6FAA6F;oBAC/F,UAAU,EACR,4EAA4E;oBAC9E,GAAG,EAAE,OAAO;iBACb,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;QAC9C,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,YAAY,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;QAE3E,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACnE,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACpD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,yBAAyB;gBAC/B,QAAQ,EAAE,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;gBAC1C,QAAQ,EAAE,UAAU;gBACpB,OAAO,EAAE,kBAAkB,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,WAAW,MAAM,WAAW;gBAC/G,WAAW,EACT,8FAA8F;gBAChG,UAAU,EACR,8GAA8G;gBAChH,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE;gBACvC,GAAG,EAAE,OAAO;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEjD,IAAI,cAAc,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,uBAAuB;gBAC7B,QAAQ,EAAE,SAAS;gBACnB,QAAQ,EAAE,UAAU;gBACpB,OAAO,EAAE,4CAA4C;gBACrD,WAAW,EACT,8FAA8F;gBAChG,UAAU,EACR,2DAA2D;gBAC7D,OAAO,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE;gBACtC,GAAG,EAAE,aAAa;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,iCAAiC;IACjC,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC;YACnC,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YACnE,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,sBAAsB;oBAC5B,QAAQ,EAAE,MAAM;oBAChB,QAAQ,EAAE,UAAU;oBACpB,OAAO,EAAE,GAAG,IAAI,UAAU,SAAS,CAAC,IAAI,CAAC,MAAM,qBAAqB;oBACpE,WAAW,EACT,8DAA8D;oBAChE,UAAU,EAAE,iFAAiF;oBAC7F,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE;oBAC/D,GAAG,EAAE,OAAO;iBACb,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/audit/robots.d.ts

@@ -0,0 +1,3 @@
+import type { AuditContext, AuditFinding } from '../types.js';
+export declare function auditRobots(ctx: AuditContext): Promise<AuditFinding[]>;
+//# sourceMappingURL=robots.d.ts.map

package/dist/audit/robots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../../src/audit/robots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAuC9D,wBAAsB,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAgG5E"}

package/dist/audit/robots.js

@@ -0,0 +1,115 @@
+import { DEFAULT_PATHS } from '../constants.js';
+import { fetchPage } from '../utils/http.js';
+import { getOrigin } from '../utils/url.js';
+function parseRobotsTxt(txt) {
+    const lines = txt.split('\n').map((l) => l.trim());
+    const rules = [];
+    const sitemaps = [];
+    let current = null;
+    for (const line of lines) {
+        if (line.startsWith('#') || line === '')
+            continue;
+        const [key, ...rest] = line.split(':');
+        const value = rest.join(':').trim();
+        const keyLower = key.toLowerCase().trim();
+        if (keyLower === 'user-agent') {
+            current = { userAgent: value, disallow: [], allow: [] };
+            rules.push(current);
+        }
+        else if (keyLower === 'disallow' && current) {
+            if (value)
+                current.disallow.push(value);
+        }
+        else if (keyLower === 'allow' && current) {
+            if (value)
+                current.allow.push(value);
+        }
+        else if (keyLower === 'sitemap') {
+            if (value)
+                sitemaps.push(value);
+        }
+    }
+    return { rules, sitemaps };
+}
+export async function auditRobots(ctx) {
+    const findings = [];
+    const origin = getOrigin(ctx.normalizedUrl);
+    const robotsUrl = `${origin}${DEFAULT_PATHS.robotsTxt}`;
+    let robotsTxt;
+    try {
+        const res = await fetchPage(robotsUrl, ctx.fetchOptions);
+        if (res.status === 200) {
+            robotsTxt = res.body;
+            // Store for cross-module use
+            ctx.robotsTxt = robotsTxt;
+        }
+        else {
+            findings.push({
+                code: 'ROBOTS_MISSING',
+                severity: 'warning',
+                category: 'robots',
+                message: 'robots.txt not found',
+                explanation: 'Without a robots.txt, search engines have no guidance on which pages to crawl or avoid.',
+                suggestion: 'Create a robots.txt file at the root of your site. In Next.js App Router, use the metadata API.',
+                url: robotsUrl,
+            });
+            return findings;
+        }
+    }
+    catch {
+        findings.push({
+            code: 'ROBOTS_MISSING',
+            severity: 'warning',
+            category: 'robots',
+            message: 'robots.txt could not be fetched',
+            explanation: 'Without a robots.txt, search engines have no guidance on which pages to crawl or avoid.',
+            suggestion: 'Ensure robots.txt is accessible at the root of your domain.',
+            url: robotsUrl,
+        });
+        return findings;
+    }
+    const { rules, sitemaps } = parseRobotsTxt(robotsTxt);
+    // Check for blocking all crawlers
+    for (const rule of rules) {
+        const ua = rule.userAgent.toLowerCase();
+        if (ua === '*' && rule.disallow.includes('/')) {
+            findings.push({
+                code: 'ROBOTS_BLOCKS_ALL',
+                severity: 'error',
+                category: 'robots',
+                message: 'robots.txt blocks all crawlers',
+                explanation: 'Disallow: / for all user agents prevents search engines from indexing any page on your site.',
+                suggestion: 'Remove or scope the Disallow: / rule unless you intentionally want to prevent indexing.',
+                details: { rule },
+                url: robotsUrl,
+            });
+        }
+        if ((ua === 'googlebot' || ua === 'googlebot-news' || ua === 'googlebot-image') &&
+            rule.disallow.includes('/')) {
+            findings.push({
+                code: 'ROBOTS_BLOCKS_GOOGLEBOT',
+                severity: 'error',
+                category: 'robots',
+                message: `robots.txt blocks ${rule.userAgent}`,
+                explanation: 'Blocking Googlebot prevents Google from indexing your site.',
+                suggestion: `Remove the Disallow: / for ${rule.userAgent} unless intentional.`,
+                details: { rule },
+                url: robotsUrl,
+            });
+        }
+    }
+    // Check for sitemap directive
+    if (sitemaps.length === 0) {
+        findings.push({
+            code: 'ROBOTS_NO_SITEMAP',
+            severity: 'info',
+            category: 'robots',
+            message: 'No Sitemap directive found in robots.txt',
+            explanation: 'Declaring your sitemap URL in robots.txt helps search engines discover it faster.',
+            suggestion: 'Add a Sitemap: https://yourdomain.com/sitemap.xml line to robots.txt.',
+            url: robotsUrl,
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=robots.js.map

package/dist/audit/robots.js.map

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

package/dist/audit/sitemap.d.ts

@@ -0,0 +1,3 @@
+import type { AuditContext, AuditFinding } from '../types.js';
+export declare function auditSitemap(ctx: AuditContext): Promise<AuditFinding[]>;
+//# sourceMappingURL=sitemap.d.ts.map

package/dist/audit/sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/audit/sitemap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM9D,wBAAsB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAiK7E"}

package/dist/audit/sitemap.js

@@ -0,0 +1,152 @@
+import { DEFAULT_PATHS, SITEMAP_SAMPLE_SIZE } from '../constants.js';
+import { fetchPage, fetchHead, followRedirectChain } from '../utils/http.js';
+import { parseSitemapXml } from '../utils/xml-parser.js';
+import { getOrigin } from '../utils/url.js';
+export async function auditSitemap(ctx) {
+    const findings = [];
+    const origin = getOrigin(ctx.normalizedUrl);
+    const sitemapUrl = `${origin}${DEFAULT_PATHS.sitemapXml}`;
+    // 1. Check if sitemap is redirected
+    const chain = await followRedirectChain(sitemapUrl, ctx.fetchOptions);
+    if (chain.hops.length > 0) {
+        findings.push({
+            code: 'SITEMAP_REDIRECTED',
+            severity: 'warning',
+            category: 'sitemap',
+            message: 'Sitemap URL is redirected',
+            explanation: 'Some search engines may not follow redirects to sitemaps, which could cause discovery issues.',
+            suggestion: 'Serve the sitemap directly at /sitemap.xml without redirects.',
+            details: { hops: chain.hops, finalUrl: chain.finalUrl },
+            url: sitemapUrl,
+        });
+    }
+    // 2. Fetch and parse the sitemap
+    let sitemapBody;
+    try {
+        const res = await fetchPage(sitemapUrl, ctx.fetchOptions);
+        if (res.status !== 200) {
+            findings.push({
+                code: 'SITEMAP_MISSING',
+                severity: 'warning',
+                category: 'sitemap',
+                message: 'sitemap.xml not found',
+                explanation: 'Without a sitemap, search engines rely solely on crawling to discover your pages, which may miss content.',
+                suggestion: 'Generate a sitemap.xml. In Next.js App Router, export a sitemap function from app/sitemap.ts.',
+                url: sitemapUrl,
+            });
+            return findings;
+        }
+        sitemapBody = res.body;
+    }
+    catch {
+        findings.push({
+            code: 'SITEMAP_MISSING',
+            severity: 'warning',
+            category: 'sitemap',
+            message: 'sitemap.xml could not be fetched',
+            explanation: 'Without a sitemap, search engines rely solely on crawling to discover your pages.',
+            suggestion: 'Ensure sitemap.xml is accessible at the root of your domain.',
+            url: sitemapUrl,
+        });
+        return findings;
+    }
+    let parsed;
+    try {
+        parsed = parseSitemapXml(sitemapBody);
+    }
+    catch {
+        findings.push({
+            code: 'SITEMAP_MISSING',
+            severity: 'error',
+            category: 'sitemap',
+            message: 'sitemap.xml contains invalid XML',
+            explanation: 'Search engines cannot read malformed sitemap files.',
+            suggestion: 'Validate and fix your sitemap XML structure.',
+            url: sitemapUrl,
+        });
+        return findings;
+    }
+    // 3. Handle sitemap index
+    if (parsed.type === 'sitemapindex') {
+        findings.push({
+            code: 'SITEMAP_MISSING',
+            severity: 'pass',
+            category: 'sitemap',
+            message: `Sitemap index found with ${parsed.sitemaps.length} sitemap(s)`,
+            explanation: 'A sitemap index is a valid approach for organizing large sitemaps.',
+            suggestion: 'No action needed.',
+            details: { sitemaps: parsed.sitemaps },
+            url: sitemapUrl,
+        });
+        return findings;
+    }
+    // 4. Check for empty sitemap
+    if (parsed.urls.length === 0) {
+        findings.push({
+            code: 'SITEMAP_EMPTY',
+            severity: 'warning',
+            category: 'sitemap',
+            message: 'Sitemap contains no URLs',
+            explanation: 'An empty sitemap provides no value for search engine crawling.',
+            suggestion: 'Add your site pages to the sitemap.',
+            url: sitemapUrl,
+        });
+        return findings;
+    }
+    // 5. Sample URLs for status checks
+    const sample = parsed.urls.slice(0, SITEMAP_SAMPLE_SIZE);
+    let errorCount = 0;
+    for (const entry of sample) {
+        try {
+            const { status } = await fetchHead(entry.loc, ctx.fetchOptions);
+            if (status >= 400) {
+                errorCount++;
+                findings.push({
+                    code: 'SITEMAP_URL_ERROR',
+                    severity: 'warning',
+                    category: 'sitemap',
+                    message: `Sitemap URL returns ${status}: ${entry.loc}`,
+                    explanation: 'Sitemap URLs returning error status codes waste crawl budget and signal poor site quality.',
+                    suggestion: 'Remove broken URLs from the sitemap or fix the underlying pages.',
+                    details: { status },
+                    url: entry.loc,
+                });
+            }
+        }
+        catch {
+            // Network error for one URL shouldn't stop the audit
+        }
+    }
+    if (errorCount === 0) {
+        findings.push({
+            code: 'SITEMAP_MISSING',
+            severity: 'pass',
+            category: 'sitemap',
+            message: `Sitemap found with ${parsed.urls.length} URLs (${sample.length} sampled, all OK)`,
+            explanation: 'Your sitemap is valid and URLs are accessible.',
+            suggestion: 'No action needed.',
+            url: sitemapUrl,
+        });
+    }
+    // 6. Cross-reference with robots.txt Sitemap directive
+    if (ctx.robotsTxt) {
+        const robotsSitemaps = ctx.robotsTxt
+            .split('\n')
+            .filter((l) => l.toLowerCase().trim().startsWith('sitemap:'))
+            .map((l) => l.split(':').slice(1).join(':').trim());
+        if (robotsSitemaps.length > 0 && !robotsSitemaps.includes(sitemapUrl) && !robotsSitemaps.includes(chain.finalUrl)) {
+            findings.push({
+                code: 'SITEMAP_ROBOTS_MISMATCH',
+                severity: 'info',
+                category: 'sitemap',
+                message: 'Sitemap URL in robots.txt does not match /sitemap.xml',
+                explanation: 'Mismatched sitemap URLs between robots.txt and the default location may confuse crawlers.',
+                suggestion: 'Ensure robots.txt Sitemap directive matches your actual sitemap URL.',
+                details: { robotsSitemaps },
+                url: sitemapUrl,
+            });
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=sitemap.js.map

package/dist/audit/sitemap.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,51 @@
+import { Command } from 'commander';
+import { runAudit } from './runner.js';
+import { formatReport, formatJson } from './utils/output.js';
+const program = new Command();
+program
+    .name('vercel-seo-audit')
+    .description('Diagnose SEO and indexing issues for Next.js/Vercel websites')
+    .version('0.1.0')
+    .argument('<url>', 'URL to audit (e.g. https://example.com)')
+    .option('--json', 'Output results as JSON')
+    .option('--verbose', 'Show detailed information for each finding')
+    .option('--timeout <ms>', 'Request timeout in milliseconds', '10000')
+    .action(async (url, options) => {
+    const timeout = parseInt(options.timeout, 10);
+    if (isNaN(timeout) || timeout <= 0) {
+        console.error('Error: --timeout must be a positive number');
+        process.exit(2);
+    }
+    // Validate URL
+    try {
+        const testUrl = /^https?:\/\//i.test(url) ? url : `https://${url}`;
+        new URL(testUrl);
+    }
+    catch {
+        console.error(`Error: Invalid URL "${url}"`);
+        process.exit(2);
+    }
+    try {
+        const report = await runAudit(url, {
+            verbose: options.verbose,
+            timeout,
+        });
+        if (options.json) {
+            console.log(formatJson(report));
+        }
+        else {
+            console.log(formatReport(report, options.verbose ?? false));
+        }
+        // Exit code based on findings
+        if (report.summary.errors > 0) {
+            process.exit(1);
+        }
+        process.exit(0);
+    }
+    catch (err) {
+        console.error('Fatal error:', err instanceof Error ? err.message : err);
+        process.exit(2);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,kBAAkB,CAAC;KACxB,WAAW,CAAC,8DAA8D,CAAC;KAC3E,OAAO,CAAC,OAAO,CAAC;KAChB,QAAQ,CAAC,OAAO,EAAE,yCAAyC,CAAC;KAC5D,MAAM,CAAC,QAAQ,EAAE,wBAAwB,CAAC;KAC1C,MAAM,CAAC,WAAW,EAAE,4CAA4C,CAAC;KACjE,MAAM,CAAC,gBAAgB,EAAE,iCAAiC,EAAE,OAAO,CAAC;KACpE,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAA+D,EAAE,EAAE;IAC7F,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,eAAe;IACf,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,GAAG,EAAE,CAAC;QACnE,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,uBAAuB,GAAG,GAAG,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE;YACjC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC;QAC9D,CAAC;QAED,8BAA8B;QAC9B,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,11 @@
+export declare const DEFAULT_TIMEOUT = 10000;
+export declare const MAX_REDIRECTS = 20;
+export declare const USER_AGENT = "vercel-seo-audit/0.1.0";
+export declare const SITEMAP_SAMPLE_SIZE = 10;
+export declare const COMMON_PAGES: string[];
+export declare const DEFAULT_PATHS: {
+    readonly robotsTxt: "/robots.txt";
+    readonly sitemapXml: "/sitemap.xml";
+    readonly faviconIco: "/favicon.ico";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,QAAS,CAAC;AACtC,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,UAAU,2BAA2B,CAAC;AACnD,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,eAAO,MAAM,YAAY,UAA8C,CAAC;AAExE,eAAO,MAAM,aAAa;;;;CAIhB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,11 @@
+export const DEFAULT_TIMEOUT = 10_000;
+export const MAX_REDIRECTS = 20;
+export const USER_AGENT = 'vercel-seo-audit/0.1.0';
+export const SITEMAP_SAMPLE_SIZE = 10;
+export const COMMON_PAGES = ['/about', '/contact', '/blog', '/pricing'];
+export const DEFAULT_PATHS = {
+    robotsTxt: '/robots.txt',
+    sitemapXml: '/sitemap.xml',
+    faviconIco: '/favicon.ico',
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AACtC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,MAAM,CAAC,MAAM,UAAU,GAAG,wBAAwB,CAAC;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS,EAAE,aAAa;IACxB,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE,cAAc;CAClB,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,6 @@
+import type { AuditReport } from './types.js';
+export declare function runAudit(url: string, opts?: {
+    verbose?: boolean;
+    timeout?: number;
+}): Promise<AuditReport>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,WAAW,EAEZ,MAAM,YAAY,CAAC;AA+CpB,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACjD,OAAO,CAAC,WAAW,CAAC,CAuCtB"}

package/dist/runner.js

@@ -0,0 +1,55 @@
+import { normalizeUrl } from './utils/url.js';
+import { auditRedirects, auditRobots, auditSitemap, auditMetadata, auditFavicon, auditNextjs, } from './audit/index.js';
+const phase1Modules = [
+    { name: 'robots', run: auditRobots },
+    { name: 'redirects', run: auditRedirects },
+];
+const phase2Modules = [
+    { name: 'sitemap', run: auditSitemap },
+    { name: 'metadata', run: auditMetadata },
+    { name: 'favicon', run: auditFavicon },
+    { name: 'nextjs', run: auditNextjs },
+];
+async function runModules(modules, ctx) {
+    const results = await Promise.allSettled(modules.map(async (mod) => {
+        const findings = await mod.run(ctx);
+        return { module: mod.name, findings };
+    }));
+    return results
+        .filter((r) => r.status === 'fulfilled')
+        .map((r) => r.value);
+}
+export async function runAudit(url, opts = {}) {
+    const start = Date.now();
+    const normalized = normalizeUrl(url);
+    const fetchOptions = {
+        timeout: opts.timeout,
+    };
+    const ctx = {
+        url,
+        normalizedUrl: normalized,
+        fetchOptions,
+        verbose: opts.verbose ?? false,
+    };
+    // Phase 1: robots + redirects (parallel)
+    const phase1Results = await runModules(phase1Modules, ctx);
+    // Phase 2: sitemap, metadata, favicon, nextjs (parallel)
+    const phase2Results = await runModules(phase2Modules, ctx);
+    const allModules = [...phase1Results, ...phase2Results];
+    // Compute summary
+    const allFindings = allModules.flatMap((m) => m.findings);
+    const summary = {
+        errors: allFindings.filter((f) => f.severity === 'error').length,
+        warnings: allFindings.filter((f) => f.severity === 'warning').length,
+        info: allFindings.filter((f) => f.severity === 'info').length,
+        passed: allFindings.filter((f) => f.severity === 'pass').length,
+    };
+    return {
+        url: normalized,
+        timestamp: new Date().toISOString(),
+        duration: Date.now() - start,
+        summary,
+        modules: allModules,
+    };
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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