@djangocfg/seo 2.1.50

package/dist/link-checker/index.d.ts

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import { SeoIssue } from '../types/index.js';
+
+/**
+ * @djangocfg/seo - Link Checker
+ *
+ * Smart link checker using linkinator with proper error handling,
+ * timeout management, and filtering of problematic URLs.
+ *
+ * @example
+ * ```typescript
+ * import { checkLinks } from '@djangocfg/seo/link-checker';
+ *
+ * const result = await checkLinks({
+ *   url: 'https://example.com',
+ *   timeout: 60000,
+ * });
+ * ```
+ *
+ * @example CLI
+ * ```bash
+ * djangocfg-seo links --site https://example.com
+ * # or
+ * djangocfg-seo links # Interactive mode
+ * ```
+ */
+
+interface CheckLinksOptions {
+    /** Base URL to check (defaults to NEXT_PUBLIC_SITE_URL env variable) */
+    url?: string;
+    /** Timeout in milliseconds (default: 60000) */
+    timeout?: number;
+    /** URLs to skip (regex pattern) */
+    skipPattern?: string;
+    /** Show only broken links (default: true) */
+    showOnlyBroken?: boolean;
+    /** Maximum number of concurrent requests (default: 50) */
+    concurrency?: number;
+    /** Output file path for report (optional) */
+    outputFile?: string;
+    /** Report format: 'json', 'markdown', 'text' (default: 'text') */
+    reportFormat?: 'json' | 'markdown' | 'text';
+    /** Verbose logging (default: true) */
+    verbose?: boolean;
+}
+interface BrokenLink {
+    url: string;
+    status: number | string;
+    reason?: string;
+    isExternal: boolean;
+    sourceUrl?: string;
+}
+interface CheckLinksResult {
+    success: boolean;
+    broken: number;
+    total: number;
+    errors: BrokenLink[];
+    /** Internal broken links (same domain) */
+    internalErrors: BrokenLink[];
+    /** External broken links (different domain) */
+    externalErrors: BrokenLink[];
+    url: string;
+    timestamp: string;
+    duration?: number;
+}
+/**
+ * Check all links on a website
+ */
+declare function checkLinks(options: CheckLinksOptions): Promise<CheckLinksResult>;
+/**
+ * Convert link check results to SEO issues
+ * Separates internal (critical) from external (warning) issues
+ */
+declare function linkResultsToSeoIssues(result: CheckLinksResult): SeoIssue[];
+
+export { type BrokenLink, type CheckLinksOptions, type CheckLinksResult, checkLinks, linkResultsToSeoIssues };

package/dist/link-checker/index.mjs

@@ -0,0 +1,326 @@
+#!/usr/bin/env node
+import { mkdir, writeFile } from 'fs/promises';
+import * as linkinator from 'linkinator';
+import { dirname } from 'path';
+import chalk from 'chalk';
+
+var DEFAULT_SKIP_PATTERN = [
+  "github.com",
+  "twitter.com",
+  "linkedin.com",
+  "x.com",
+  "127.0.0.1",
+  "localhost:[0-9]+",
+  "api\\.localhost",
+  "demo\\.localhost",
+  "cdn-cgi",
+  // Cloudflare email protection
+  "mailto:",
+  // Email links
+  "tel:",
+  // Phone links
+  "javascript:"
+  // JavaScript links
+].join("|");
+function getSiteUrl(options) {
+  if (options.url) {
+    return options.url;
+  }
+  const envUrl = process.env.NEXT_PUBLIC_SITE_URL || process.env.SITE_URL || process.env.BASE_URL;
+  if (envUrl) {
+    return envUrl;
+  }
+  throw new Error(
+    "URL is required. Provide it via options.url or set NEXT_PUBLIC_SITE_URL environment variable."
+  );
+}
+function isExternalUrl(linkUrl, baseUrl) {
+  try {
+    const link = new URL(linkUrl);
+    const base = new URL(baseUrl);
+    return link.hostname !== base.hostname;
+  } catch {
+    return true;
+  }
+}
+async function checkLinks(options) {
+  const url = getSiteUrl(options);
+  const {
+    timeout = 6e4,
+    skipPattern = DEFAULT_SKIP_PATTERN,
+    showOnlyBroken = true,
+    concurrency = 50,
+    outputFile,
+    reportFormat = "text",
+    verbose = true
+  } = options;
+  const startTime = Date.now();
+  if (verbose) {
+    console.log(chalk.cyan(`
+\u{1F50D} Starting link check for: ${chalk.bold(url)}`));
+    console.log(chalk.dim(`   Timeout: ${timeout}ms | Concurrency: ${concurrency}`));
+    console.log("");
+  }
+  const skipRegex = new RegExp(skipPattern);
+  const checkOptions = {
+    path: url,
+    recurse: true,
+    timeout,
+    concurrency,
+    linksToSkip: (link) => {
+      return Promise.resolve(skipRegex.test(link));
+    }
+  };
+  const broken = [];
+  const internalErrors = [];
+  const externalErrors = [];
+  let total = 0;
+  try {
+    const results = await linkinator.check(checkOptions);
+    for (const result2 of results.links) {
+      total++;
+      const status = result2.status || 0;
+      const isExternal = isExternalUrl(result2.url, url);
+      if (status < 200 || status >= 400 || result2.state === "BROKEN") {
+        const statusValue = status || "TIMEOUT";
+        if (statusValue === "TIMEOUT" && isExternal) {
+          continue;
+        }
+        const brokenLink = {
+          url: result2.url,
+          status: statusValue,
+          reason: result2.state === "BROKEN" ? "BROKEN" : void 0,
+          isExternal,
+          sourceUrl: result2.parent
+        };
+        broken.push(brokenLink);
+        if (isExternal) {
+          externalErrors.push(brokenLink);
+        } else {
+          internalErrors.push(brokenLink);
+        }
+      }
+    }
+    const success = internalErrors.length === 0;
+    if (!showOnlyBroken || broken.length > 0) {
+      if (success && externalErrors.length === 0) {
+        console.log(`\u2705 All links are valid!`);
+        console.log(`   Checked ${total} links.`);
+      } else {
+        if (internalErrors.length > 0) {
+          console.log(chalk.red(`\u274C Found ${internalErrors.length} broken internal links:`));
+          for (const { url: linkUrl, status, reason } of internalErrors.slice(0, 20)) {
+            console.log(`   [${status}] ${linkUrl}${reason ? ` (${reason})` : ""}`);
+          }
+          if (internalErrors.length > 20) {
+            console.log(chalk.dim(`   ... and ${internalErrors.length - 20} more`));
+          }
+        }
+        if (externalErrors.length > 0) {
+          console.log("");
+          console.log(chalk.yellow(`\u26A0\uFE0F  Found ${externalErrors.length} broken external links:`));
+          for (const { url: linkUrl, status } of externalErrors.slice(0, 10)) {
+            console.log(`   [${status}] ${linkUrl}`);
+          }
+          if (externalErrors.length > 10) {
+            console.log(chalk.dim(`   ... and ${externalErrors.length - 10} more`));
+          }
+        }
+      }
+    }
+    const duration = Date.now() - startTime;
+    const result = {
+      success,
+      broken: broken.length,
+      total,
+      errors: broken,
+      internalErrors,
+      externalErrors,
+      url,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      duration
+    };
+    if (outputFile) {
+      await saveReport(result, outputFile, reportFormat);
+      console.log(chalk.green(`
+\u{1F4C4} Report saved to: ${chalk.cyan(outputFile)}`));
+    }
+    return result;
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    const errorName = error instanceof Error ? error.name : "UnknownError";
+    if (errorMessage.includes("timeout") || errorMessage.includes("TimeoutError") || errorName === "TimeoutError" || errorMessage.includes("aborted")) {
+      console.warn(chalk.yellow(`\u26A0\uFE0F  Some links timed out after ${timeout}ms`));
+      console.warn(chalk.dim(`   This is normal for slow or protected URLs.`));
+      if (total > 0) {
+        console.warn(chalk.dim(`   Checked ${total} links before timeout.`));
+      }
+      if (broken.length > 0) {
+        console.log(chalk.red(`
+\u274C Found ${broken.length} broken links:`));
+        for (const { url: url2, status, reason } of broken) {
+          const statusColor = typeof status === "number" && status >= 500 ? chalk.red : chalk.yellow;
+          console.log(
+            `   ${statusColor(`[${status}]`)} ${chalk.cyan(url2)}${reason ? chalk.dim(` (${reason})`) : ""}`
+          );
+        }
+      }
+    } else {
+      console.error(chalk.red(`\u274C Error checking links: ${errorMessage}`));
+    }
+    const duration = Date.now() - startTime;
+    const result = {
+      success: internalErrors.length === 0 && total > 0,
+      broken: broken.length,
+      total,
+      errors: broken,
+      internalErrors,
+      externalErrors,
+      url,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      duration
+    };
+    if (outputFile) {
+      try {
+        await saveReport(result, outputFile, reportFormat);
+        console.log(chalk.green(`
+\u{1F4C4} Report saved to: ${chalk.cyan(outputFile)}`));
+      } catch (saveError) {
+        console.warn(
+          chalk.yellow(
+            `
+\u26A0\uFE0F  Failed to save report: ${saveError instanceof Error ? saveError.message : String(saveError)}`
+          )
+        );
+      }
+    }
+    return result;
+  }
+}
+function linkResultsToSeoIssues(result) {
+  const issues = [];
+  for (const error of result.internalErrors) {
+    issues.push({
+      id: `broken-internal-link-${hash(error.url)}`,
+      url: error.url,
+      category: "technical",
+      severity: typeof error.status === "number" && error.status >= 500 ? "critical" : "error",
+      title: `Broken internal link: ${error.status}`,
+      description: `Internal link returned ${error.status} status${error.reason ? ` (${error.reason})` : ""}.`,
+      recommendation: "Fix the internal link. This affects user experience and SEO.",
+      detectedAt: result.timestamp,
+      metadata: {
+        status: error.status,
+        reason: error.reason,
+        sourceUrl: error.sourceUrl || result.url,
+        isExternal: false
+      }
+    });
+  }
+  for (const error of result.externalErrors) {
+    issues.push({
+      id: `broken-external-link-${hash(error.url)}`,
+      url: error.url,
+      category: "technical",
+      severity: "warning",
+      title: `Broken external link: ${error.status}`,
+      description: `External link returned ${error.status} status.`,
+      recommendation: "Consider removing or updating the external link.",
+      detectedAt: result.timestamp,
+      metadata: {
+        status: error.status,
+        reason: error.reason,
+        sourceUrl: error.sourceUrl || result.url,
+        isExternal: true
+      }
+    });
+  }
+  return issues;
+}
+async function saveReport(result, filePath, format) {
+  const dir = dirname(filePath);
+  if (dir !== ".") {
+    await mkdir(dir, { recursive: true });
+  }
+  let content;
+  switch (format) {
+    case "json":
+      content = JSON.stringify(result, null, 2);
+      break;
+    case "markdown":
+      content = generateMarkdownReport(result);
+      break;
+    case "text":
+    default:
+      content = generateTextReport(result);
+      break;
+  }
+  await writeFile(filePath, content, "utf-8");
+}
+function generateMarkdownReport(result) {
+  const lines = [];
+  lines.push("# Link Check Report");
+  lines.push("");
+  lines.push(`**URL:** ${result.url}`);
+  lines.push(`**Timestamp:** ${result.timestamp}`);
+  if (result.duration) {
+    lines.push(`**Duration:** ${(result.duration / 1e3).toFixed(2)}s`);
+  }
+  lines.push("");
+  lines.push(
+    `**Status:** ${result.success ? "\u2705 All links valid" : "\u274C Broken links found"}`
+  );
+  lines.push(`**Total links:** ${result.total}`);
+  lines.push(`**Broken links:** ${result.broken}`);
+  lines.push("");
+  if (result.errors.length > 0) {
+    lines.push("## Broken Links");
+    lines.push("");
+    lines.push("| Status | URL | Reason |");
+    lines.push("|--------|-----|--------|");
+    for (const { url, status, reason } of result.errors) {
+      lines.push(`| ${status} | ${url} | ${reason || "-"} |`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function generateTextReport(result) {
+  const lines = [];
+  lines.push("Link Check Report");
+  lines.push("=".repeat(50));
+  lines.push(`URL: ${result.url}`);
+  lines.push(`Timestamp: ${result.timestamp}`);
+  if (result.duration) {
+    lines.push(`Duration: ${(result.duration / 1e3).toFixed(2)}s`);
+  }
+  lines.push("");
+  lines.push(
+    `Status: ${result.success ? "\u2705 All links valid" : "\u274C Broken links found"}`
+  );
+  lines.push(`Total links: ${result.total}`);
+  lines.push(`Broken links: ${result.broken}`);
+  lines.push("");
+  if (result.errors.length > 0) {
+    lines.push("Broken Links:");
+    lines.push("-".repeat(50));
+    for (const { url, status, reason } of result.errors) {
+      lines.push(`[${status}] ${url}${reason ? ` (${reason})` : ""}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function hash(str) {
+  let h = 0;
+  for (let i = 0; i < str.length; i++) {
+    const char = str.charCodeAt(i);
+    h = (h << 5) - h + char;
+    h = h & h;
+  }
+  return Math.abs(h).toString(36);
+}
+
+export { checkLinks, linkResultsToSeoIssues };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/link-checker/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/link-checker/index.ts"],"names":["result","url"],"mappings":";;;;;;AAoDA,IAAM,oBAAA,GAAuB;AAAA,EAC3B,YAAA;AAAA,EACA,aAAA;AAAA,EACA,cAAA;AAAA,EACA,OAAA;AAAA,EACA,WAAA;AAAA,EACA,kBAAA;AAAA,EACA,iBAAA;AAAA,EACA,kBAAA;AAAA,EACA,SAAA;AAAA;AAAA,EACA,SAAA;AAAA;AAAA,EACA,MAAA;AAAA;AAAA,EACA;AAAA;AACF,CAAA,CAAE,KAAK,GAAG,CAAA;AA2BV,SAAS,WAAW,OAAA,EAAoC;AACtD,EAAA,IAAI,QAAQ,GAAA,EAAK;AACf,IAAA,OAAO,OAAA,CAAQ,GAAA;AAAA,EACjB;AAGA,EAAA,MAAM,MAAA,GACJ,QAAQ,GAAA,CAAI,oBAAA,IACZ,QAAQ,GAAA,CAAI,QAAA,IACZ,QAAQ,GAAA,CAAI,QAAA;AAEd,EAAA,IAAI,MAAA,EAAQ;AACV,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,IAAI,KAAA;AAAA,IACR;AAAA,GACF;AACF;AAKA,SAAS,aAAA,CAAc,SAAiB,OAAA,EAA0B;AAChE,EAAA,IAAI;AACF,IAAA,MAAM,IAAA,GAAO,IAAI,GAAA,CAAI,OAAO,CAAA;AAC5B,IAAA,MAAM,IAAA,GAAO,IAAI,GAAA,CAAI,OAAO,CAAA;AAC5B,IAAA,OAAO,IAAA,CAAK,aAAa,IAAA,CAAK,QAAA;AAAA,EAChC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAKA,eAAsB,WAAW,OAAA,EAAuD;AACtF,EAAA,MAAM,GAAA,GAAM,WAAW,OAAO,CAAA;AAC9B,EAAA,MAAM;AAAA,IACJ,OAAA,GAAU,GAAA;AAAA,IACV,WAAA,GAAc,oBAAA;AAAA,IACd,cAAA,GAAiB,IAAA;AAAA,IACjB,WAAA,GAAc,EAAA;AAAA,IACd,UAAA;AAAA,IACA,YAAA,GAAe,MAAA;AAAA,IACf,OAAA,GAAU;AAAA,GACZ,GAAI,OAAA;AAEJ,EAAA,MAAM,SAAA,GAAY,KAAK,GAAA,EAAI;AAE3B,EAAA,IAAI,OAAA,EAAS;AACX,IAAA,OAAA,CAAQ,GAAA,CAAI,MAAM,IAAA,CAAK;AAAA,mCAAA,EAAiC,KAAA,CAAM,IAAA,CAAK,GAAG,CAAC,EAAE,CAAC,CAAA;AAC1E,IAAA,OAAA,CAAQ,GAAA,CAAI,MAAM,GAAA,CAAI,CAAA,YAAA,EAAe,OAAO,CAAA,kBAAA,EAAqB,WAAW,EAAE,CAAC,CAAA;AAC/E,IAAA,OAAA,CAAQ,IAAI,EAAE,CAAA;AAAA,EAChB;AAEA,EAAA,MAAM,SAAA,GAAY,IAAI,MAAA,CAAO,WAAW,CAAA;AAExC,EAAA,MAAM,YAAA,GAA6B;AAAA,IACjC,IAAA,EAAM,GAAA;AAAA,IACN,OAAA,EAAS,IAAA;AAAA,IACT,OAAA;AAAA,IACA,WAAA;AAAA,IACA,WAAA,EAAa,CAAC,IAAA,KAAiB;AAC7B,MAAA,OAAO,OAAA,CAAQ,OAAA,CAAQ,SAAA,CAAU,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,IAC7C;AAAA,GACF;AAEA,EAAA,MAAM,SAAuB,EAAC;AAC9B,EAAA,MAAM,iBAA+B,EAAC;AACtC,EAAA,MAAM,iBAA+B,EAAC;AACtC,EAAA,IAAI,KAAA,GAAQ,CAAA;AAEZ,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,GAAU,MAAiB,UAAA,CAAA,KAAA,CAAM,YAAY,CAAA;AAEnD,IAAA,KAAA,MAAWA,OAAAA,IAAU,QAAQ,KAAA,EAAO;AAClC,MAAA,KAAA,EAAA;AACA,MAAA,MAAM,MAAA,GAASA,QAAO,MAAA,IAAU,CAAA;AAChC,MAAA,MAAM,UAAA,GAAa,aAAA,CAAcA,OAAAA,CAAO,GAAA,EAAK,GAAG,CAAA;AAEhD,MAAA,IAAI,SAAS,GAAA,IAAO,MAAA,IAAU,GAAA,IAAOA,OAAAA,CAAO,UAAU,QAAA,EAAU;AAC9D,QAAA,MAAM,cAAc,MAAA,IAAU,SAAA;AAG9B,QAAA,IAAI,WAAA,KAAgB,aAAa,UAAA,EAAY;AAC3C,UAAA;AAAA,QACF;AAEA,QAAA,MAAM,UAAA,GAAyB;AAAA,UAC7B,KAAKA,OAAAA,CAAO,GAAA;AAAA,UACZ,MAAA,EAAQ,WAAA;AAAA,UACR,MAAA,EAAQA,OAAAA,CAAO,KAAA,KAAU,QAAA,GAAW,QAAA,GAAW,KAAA,CAAA;AAAA,UAC/C,UAAA;AAAA,UACA,WAAWA,OAAAA,CAAO;AAAA,SACpB;AAEA,QAAA,MAAA,CAAO,KAAK,UAAU,CAAA;AAEtB,QAAA,IAAI,UAAA,EAAY;AACd,UAAA,cAAA,CAAe,KAAK,UAAU,CAAA;AAAA,QAChC,CAAA,MAAO;AACL,UAAA,cAAA,CAAe,KAAK,UAAU,CAAA;AAAA,QAChC;AAAA,MACF;AAAA,IACF;AAEA,IAAA,MAAM,OAAA,GAAU,eAAe,MAAA,KAAW,CAAA;AAE1C,IAAA,IAAI,CAAC,cAAA,IAAkB,MAAA,CAAO,MAAA,GAAS,CAAA,EAAG;AACxC,MAAA,IAAI,OAAA,IAAW,cAAA,CAAe,MAAA,KAAW,CAAA,EAAG;AAC1C,QAAA,OAAA,CAAQ,IAAI,CAAA,2BAAA,CAAwB,CAAA;AACpC,QAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,WAAA,EAAc,KAAK,CAAA,OAAA,CAAS,CAAA;AAAA,MAC1C,CAAA,MAAO;AAEL,QAAA,IAAI,cAAA,CAAe,SAAS,CAAA,EAAG;AAC7B,UAAA,OAAA,CAAQ,IAAI,KAAA,CAAM,GAAA,CAAI,gBAAW,cAAA,CAAe,MAAM,yBAAyB,CAAC,CAAA;AAChF,UAAA,KAAA,MAAW,EAAE,GAAA,EAAK,OAAA,EAAS,MAAA,EAAQ,MAAA,MAAY,cAAA,CAAe,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,EAAG;AAC1E,YAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,IAAA,EAAO,MAAM,CAAA,EAAA,EAAK,OAAO,CAAA,EAAG,MAAA,GAAS,CAAA,EAAA,EAAK,MAAM,CAAA,CAAA,CAAA,GAAM,EAAE,CAAA,CAAE,CAAA;AAAA,UACxE;AACA,UAAA,IAAI,cAAA,CAAe,SAAS,EAAA,EAAI;AAC9B,YAAA,OAAA,CAAQ,GAAA,CAAI,MAAM,GAAA,CAAI,CAAA,WAAA,EAAc,eAAe,MAAA,GAAS,EAAE,OAAO,CAAC,CAAA;AAAA,UACxE;AAAA,QACF;AAGA,QAAA,IAAI,cAAA,CAAe,SAAS,CAAA,EAAG;AAC7B,UAAA,OAAA,CAAQ,IAAI,EAAE,CAAA;AACd,UAAA,OAAA,CAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,uBAAa,cAAA,CAAe,MAAM,yBAAyB,CAAC,CAAA;AACrF,UAAA,KAAA,MAAW,EAAE,KAAK,OAAA,EAAS,MAAA,MAAY,cAAA,CAAe,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,EAAG;AAClE,YAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,IAAA,EAAO,MAAM,CAAA,EAAA,EAAK,OAAO,CAAA,CAAE,CAAA;AAAA,UACzC;AACA,UAAA,IAAI,cAAA,CAAe,SAAS,EAAA,EAAI;AAC9B,YAAA,OAAA,CAAQ,GAAA,CAAI,MAAM,GAAA,CAAI,CAAA,WAAA,EAAc,eAAe,MAAA,GAAS,EAAE,OAAO,CAAC,CAAA;AAAA,UACxE;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,EAAI,GAAI,SAAA;AAC9B,IAAA,MAAM,MAAA,GAA2B;AAAA,MAC/B,OAAA;AAAA,MACA,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,KAAA;AAAA,MACA,MAAA,EAAQ,MAAA;AAAA,MACR,cAAA;AAAA,MACA,cAAA;AAAA,MACA,GAAA;AAAA,MACA,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAAA,MAClC;AAAA,KACF;AAEA,IAAA,IAAI,UAAA,EAAY;AACd,MAAA,MAAM,UAAA,CAAW,MAAA,EAAQ,UAAA,EAAY,YAAY,CAAA;AACjD,MAAA,OAAA,CAAQ,GAAA,CAAI,MAAM,KAAA,CAAM;AAAA,2BAAA,EAAyB,KAAA,CAAM,IAAA,CAAK,UAAU,CAAC,EAAE,CAAC,CAAA;AAAA,IAC5E;AAEA,IAAA,OAAO,MAAA;AAAA,EACT,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,eAAe,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AAC1E,IAAA,MAAM,SAAA,GAAY,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,IAAA,GAAO,cAAA;AAExD,IAAA,IACE,YAAA,CAAa,QAAA,CAAS,SAAS,CAAA,IAC/B,YAAA,CAAa,QAAA,CAAS,cAAc,CAAA,IACpC,SAAA,KAAc,cAAA,IACd,YAAA,CAAa,QAAA,CAAS,SAAS,CAAA,EAC/B;AACA,MAAA,OAAA,CAAQ,KAAK,KAAA,CAAM,MAAA,CAAO,CAAA,yCAAA,EAAkC,OAAO,IAAI,CAAC,CAAA;AACxE,MAAA,OAAA,CAAQ,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,CAAA,6CAAA,CAA+C,CAAC,CAAA;AACvE,MAAA,IAAI,QAAQ,CAAA,EAAG;AACb,QAAA,OAAA,CAAQ,KAAK,KAAA,CAAM,GAAA,CAAI,CAAA,WAAA,EAAc,KAAK,wBAAwB,CAAC,CAAA;AAAA,MACrE;AAEA,MAAA,IAAI,MAAA,CAAO,SAAS,CAAA,EAAG;AACrB,QAAA,OAAA,CAAQ,GAAA,CAAI,MAAM,GAAA,CAAI;AAAA,aAAA,EAAa,MAAA,CAAO,MAAM,CAAA,cAAA,CAAgB,CAAC,CAAA;AACjE,QAAA,KAAA,MAAW,EAAE,GAAA,EAAAC,IAAAA,EAAK,MAAA,EAAQ,MAAA,MAAY,MAAA,EAAQ;AAC5C,UAAA,MAAM,WAAA,GACJ,OAAO,MAAA,KAAW,QAAA,IAAY,UAAU,GAAA,GAAM,KAAA,CAAM,MAAM,KAAA,CAAM,MAAA;AAClE,UAAA,OAAA,CAAQ,GAAA;AAAA,YACN,MAAM,WAAA,CAAY,CAAA,CAAA,EAAI,MAAM,CAAA,CAAA,CAAG,CAAC,IAAI,KAAA,CAAM,IAAA,CAAKA,IAAG,CAAC,CAAA,EAAG,SAAS,KAAA,CAAM,GAAA,CAAI,KAAK,MAAM,CAAA,CAAA,CAAG,IAAI,EAAE,CAAA;AAAA,WAC/F;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAA,MAAO;AACL,MAAA,OAAA,CAAQ,MAAM,KAAA,CAAM,GAAA,CAAI,CAAA,6BAAA,EAA2B,YAAY,EAAE,CAAC,CAAA;AAAA,IACpE;AAEA,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,EAAI,GAAI,SAAA;AAC9B,IAAA,MAAM,MAAA,GAA2B;AAAA,MAC/B,OAAA,EAAS,cAAA,CAAe,MAAA,KAAW,CAAA,IAAK,KAAA,GAAQ,CAAA;AAAA,MAChD,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,KAAA;AAAA,MACA,MAAA,EAAQ,MAAA;AAAA,MACR,cAAA;AAAA,MACA,cAAA;AAAA,MACA,GAAA;AAAA,MACA,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAAA,MAClC;AAAA,KACF;AAEA,IAAA,IAAI,UAAA,EAAY;AACd,MAAA,IAAI;AACF,QAAA,MAAM,UAAA,CAAW,MAAA,EAAQ,UAAA,EAAY,YAAY,CAAA;AACjD,QAAA,OAAA,CAAQ,GAAA,CAAI,MAAM,KAAA,CAAM;AAAA,2BAAA,EAAyB,KAAA,CAAM,IAAA,CAAK,UAAU,CAAC,EAAE,CAAC,CAAA;AAAA,MAC5E,SAAS,SAAA,EAAW;AAClB,QAAA,OAAA,CAAQ,IAAA;AAAA,UACN,KAAA,CAAM,MAAA;AAAA,YACJ;AAAA,qCAAA,EAAgC,qBAAqB,KAAA,GAAQ,SAAA,CAAU,OAAA,GAAU,MAAA,CAAO,SAAS,CAAC,CAAA;AAAA;AACpG,SACF;AAAA,MACF;AAAA,IACF;AAEA,IAAA,OAAO,MAAA;AAAA,EACT;AACF;AAMO,SAAS,uBAAuB,MAAA,EAAsC;AAC3E,EAAA,MAAM,SAAqB,EAAC;AAG5B,EAAA,KAAA,MAAW,KAAA,IAAS,OAAO,cAAA,EAAgB;AACzC,IAAA,MAAA,CAAO,IAAA,CAAK;AAAA,MACV,EAAA,EAAI,CAAA,qBAAA,EAAwB,IAAA,CAAK,KAAA,CAAM,GAAG,CAAC,CAAA,CAAA;AAAA,MAC3C,KAAK,KAAA,CAAM,GAAA;AAAA,MACX,QAAA,EAAU,WAAA;AAAA,MACV,QAAA,EAAU,OAAO,KAAA,CAAM,MAAA,KAAW,YAAY,KAAA,CAAM,MAAA,IAAU,MAAM,UAAA,GAAsB,OAAA;AAAA,MAC1F,KAAA,EAAO,CAAA,sBAAA,EAAyB,KAAA,CAAM,MAAM,CAAA,CAAA;AAAA,MAC5C,WAAA,EAAa,CAAA,uBAAA,EAA0B,KAAA,CAAM,MAAM,CAAA,OAAA,EAAU,KAAA,CAAM,MAAA,GAAS,CAAA,EAAA,EAAK,KAAA,CAAM,MAAM,CAAA,CAAA,CAAA,GAAM,EAAE,CAAA,CAAA,CAAA;AAAA,MACrG,cAAA,EAAgB,8DAAA;AAAA,MAChB,YAAY,MAAA,CAAO,SAAA;AAAA,MACnB,QAAA,EAAU;AAAA,QACR,QAAQ,KAAA,CAAM,MAAA;AAAA,QACd,QAAQ,KAAA,CAAM,MAAA;AAAA,QACd,SAAA,EAAW,KAAA,CAAM,SAAA,IAAa,MAAA,CAAO,GAAA;AAAA,QACrC,UAAA,EAAY;AAAA;AACd,KACD,CAAA;AAAA,EACH;AAGA,EAAA,KAAA,MAAW,KAAA,IAAS,OAAO,cAAA,EAAgB;AACzC,IAAA,MAAA,CAAO,IAAA,CAAK;AAAA,MACV,EAAA,EAAI,CAAA,qBAAA,EAAwB,IAAA,CAAK,KAAA,CAAM,GAAG,CAAC,CAAA,CAAA;AAAA,MAC3C,KAAK,KAAA,CAAM,GAAA;AAAA,MACX,QAAA,EAAU,WAAA;AAAA,MACV,QAAA,EAAU,SAAA;AAAA,MACV,KAAA,EAAO,CAAA,sBAAA,EAAyB,KAAA,CAAM,MAAM,CAAA,CAAA;AAAA,MAC5C,WAAA,EAAa,CAAA,uBAAA,EAA0B,KAAA,CAAM,MAAM,CAAA,QAAA,CAAA;AAAA,MACnD,cAAA,EAAgB,kDAAA;AAAA,MAChB,YAAY,MAAA,CAAO,SAAA;AAAA,MACnB,QAAA,EAAU;AAAA,QACR,QAAQ,KAAA,CAAM,MAAA;AAAA,QACd,QAAQ,KAAA,CAAM,MAAA;AAAA,QACd,SAAA,EAAW,KAAA,CAAM,SAAA,IAAa,MAAA,CAAO,GAAA;AAAA,QACrC,UAAA,EAAY;AAAA;AACd,KACD,CAAA;AAAA,EACH;AAEA,EAAA,OAAO,MAAA;AACT;AAEA,eAAe,UAAA,CACb,MAAA,EACA,QAAA,EACA,MAAA,EACe;AACf,EAAA,MAAM,GAAA,GAAM,QAAQ,QAAQ,CAAA;AAC5B,EAAA,IAAI,QAAQ,GAAA,EAAK;AACf,IAAA,MAAM,KAAA,CAAM,GAAA,EAAK,EAAE,SAAA,EAAW,MAAM,CAAA;AAAA,EACtC;AAEA,EAAA,IAAI,OAAA;AAEJ,EAAA,QAAQ,MAAA;AAAQ,IACd,KAAK,MAAA;AACH,MAAA,OAAA,GAAU,IAAA,CAAK,SAAA,CAAU,MAAA,EAAQ,IAAA,EAAM,CAAC,CAAA;AACxC,MAAA;AAAA,IAEF,KAAK,UAAA;AACH,MAAA,OAAA,GAAU,uBAAuB,MAAM,CAAA;AACvC,MAAA;AAAA,IAEF,KAAK,MAAA;AAAA,IACL;AACE,MAAA,OAAA,GAAU,mBAAmB,MAAM,CAAA;AACnC,MAAA;AAAA;AAGJ,EAAA,MAAM,SAAA,CAAU,QAAA,EAAU,OAAA,EAAS,OAAO,CAAA;AAC5C;AAEA,SAAS,uBAAuB,MAAA,EAAkC;AAChE,EAAA,MAAM,QAAkB,EAAC;AAEzB,EAAA,KAAA,CAAM,KAAK,qBAAqB,CAAA;AAChC,EAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AACb,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,SAAA,EAAY,MAAA,CAAO,GAAG,CAAA,CAAE,CAAA;AACnC,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,eAAA,EAAkB,MAAA,CAAO,SAAS,CAAA,CAAE,CAAA;AAC/C,EAAA,IAAI,OAAO,QAAA,EAAU;AACnB,IAAA,KAAA,CAAM,IAAA,CAAK,kBAAkB,MAAA,CAAO,QAAA,GAAW,KAAM,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,EACpE;AACA,EAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AACb,EAAA,KAAA,CAAM,IAAA;AAAA,IACJ,CAAA,YAAA,EAAe,MAAA,CAAO,OAAA,GAAU,wBAAA,GAAsB,2BAAsB,CAAA;AAAA,GAC9E;AACA,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,iBAAA,EAAoB,MAAA,CAAO,KAAK,CAAA,CAAE,CAAA;AAC7C,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,kBAAA,EAAqB,MAAA,CAAO,MAAM,CAAA,CAAE,CAAA;AAC/C,EAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AAEb,EAAA,IAAI,MAAA,CAAO,MAAA,CAAO,MAAA,GAAS,CAAA,EAAG;AAC5B,IAAA,KAAA,CAAM,KAAK,iBAAiB,CAAA;AAC5B,IAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AACb,IAAA,KAAA,CAAM,KAAK,2BAA2B,CAAA;AACtC,IAAA,KAAA,CAAM,KAAK,2BAA2B,CAAA;AACtC,IAAA,KAAA,MAAW,EAAE,GAAA,EAAK,MAAA,EAAQ,MAAA,EAAO,IAAK,OAAO,MAAA,EAAQ;AACnD,MAAA,KAAA,CAAM,IAAA,CAAK,KAAK,MAAM,CAAA,GAAA,EAAM,GAAG,CAAA,GAAA,EAAM,MAAA,IAAU,GAAG,CAAA,EAAA,CAAI,CAAA;AAAA,IACxD;AACA,IAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AAAA,EACf;AAEA,EAAA,OAAO,KAAA,CAAM,KAAK,IAAI,CAAA;AACxB;AAEA,SAAS,mBAAmB,MAAA,EAAkC;AAC5D,EAAA,MAAM,QAAkB,EAAC;AAEzB,EAAA,KAAA,CAAM,KAAK,mBAAmB,CAAA;AAC9B,EAAA,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAE,CAAC,CAAA;AACzB,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,KAAA,EAAQ,MAAA,CAAO,GAAG,CAAA,CAAE,CAAA;AAC/B,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,WAAA,EAAc,MAAA,CAAO,SAAS,CAAA,CAAE,CAAA;AAC3C,EAAA,IAAI,OAAO,QAAA,EAAU;AACnB,IAAA,KAAA,CAAM,IAAA,CAAK,cAAc,MAAA,CAAO,QAAA,GAAW,KAAM,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,EAChE;AACA,EAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AACb,EAAA,KAAA,CAAM,IAAA;AAAA,IACJ,CAAA,QAAA,EAAW,MAAA,CAAO,OAAA,GAAU,wBAAA,GAAsB,2BAAsB,CAAA;AAAA,GAC1E;AACA,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,aAAA,EAAgB,MAAA,CAAO,KAAK,CAAA,CAAE,CAAA;AACzC,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,cAAA,EAAiB,MAAA,CAAO,MAAM,CAAA,CAAE,CAAA;AAC3C,EAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AAEb,EAAA,IAAI,MAAA,CAAO,MAAA,CAAO,MAAA,GAAS,CAAA,EAAG;AAC5B,IAAA,KAAA,CAAM,KAAK,eAAe,CAAA;AAC1B,IAAA,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAE,CAAC,CAAA;AACzB,IAAA,KAAA,MAAW,EAAE,GAAA,EAAK,MAAA,EAAQ,MAAA,EAAO,IAAK,OAAO,MAAA,EAAQ;AACnD,MAAA,KAAA,CAAM,IAAA,CAAK,CAAA,CAAA,EAAI,MAAM,CAAA,EAAA,EAAK,GAAG,CAAA,EAAG,MAAA,GAAS,CAAA,EAAA,EAAK,MAAM,CAAA,CAAA,CAAA,GAAM,EAAE,CAAA,CAAE,CAAA;AAAA,IAChE;AACA,IAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AAAA,EACf;AAEA,EAAA,OAAO,KAAA,CAAM,KAAK,IAAI,CAAA;AACxB;AAEA,SAAS,KAAK,GAAA,EAAqB;AACjC,EAAA,IAAI,CAAA,GAAI,CAAA;AACR,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,QAAQ,CAAA,EAAA,EAAK;AACnC,IAAA,MAAM,IAAA,GAAO,GAAA,CAAI,UAAA,CAAW,CAAC,CAAA;AAC7B,IAAA,CAAA,GAAA,CAAK,CAAA,IAAK,KAAK,CAAA,GAAI,IAAA;AACnB,IAAA,CAAA,GAAI,CAAA,GAAI,CAAA;AAAA,EACV;AACA,EAAA,OAAO,IAAA,CAAK,GAAA,CAAI,CAAC,CAAA,CAAE,SAAS,EAAE,CAAA;AAChC","file":"index.mjs","sourcesContent":["#!/usr/bin/env node\n\n/**\n * @djangocfg/seo - Link Checker\n *\n * Smart link checker using linkinator with proper error handling,\n * timeout management, and filtering of problematic URLs.\n *\n * @example\n * ```typescript\n * import { checkLinks } from '@djangocfg/seo/link-checker';\n *\n * const result = await checkLinks({\n *   url: 'https://example.com',\n *   timeout: 60000,\n * });\n * ```\n *\n * @example CLI\n * ```bash\n * djangocfg-seo links --site https://example.com\n * # or\n * djangocfg-seo links # Interactive mode\n * ```\n */\n\nimport { mkdir, writeFile } from 'node:fs/promises';\nimport * as linkinator from 'linkinator';\nimport { dirname } from 'node:path';\nimport chalk from 'chalk';\nimport type { CheckOptions } from 'linkinator';\nimport type { SeoIssue } from '../types/index.js';\n\nexport interface CheckLinksOptions {\n  /** Base URL to check (defaults to NEXT_PUBLIC_SITE_URL env variable) */\n  url?: string;\n  /** Timeout in milliseconds (default: 60000) */\n  timeout?: number;\n  /** URLs to skip (regex pattern) */\n  skipPattern?: string;\n  /** Show only broken links (default: true) */\n  showOnlyBroken?: boolean;\n  /** Maximum number of concurrent requests (default: 50) */\n  concurrency?: number;\n  /** Output file path for report (optional) */\n  outputFile?: string;\n  /** Report format: 'json', 'markdown', 'text' (default: 'text') */\n  reportFormat?: 'json' | 'markdown' | 'text';\n  /** Verbose logging (default: true) */\n  verbose?: boolean;\n}\n\nconst DEFAULT_SKIP_PATTERN = [\n  'github.com',\n  'twitter.com',\n  'linkedin.com',\n  'x.com',\n  '127.0.0.1',\n  'localhost:[0-9]+',\n  'api\\\\.localhost',\n  'demo\\\\.localhost',\n  'cdn-cgi', // Cloudflare email protection\n  'mailto:', // Email links\n  'tel:', // Phone links\n  'javascript:', // JavaScript links\n].join('|');\n\nexport interface BrokenLink {\n  url: string;\n  status: number | string;\n  reason?: string;\n  isExternal: boolean;\n  sourceUrl?: string;\n}\n\nexport interface CheckLinksResult {\n  success: boolean;\n  broken: number;\n  total: number;\n  errors: BrokenLink[];\n  /** Internal broken links (same domain) */\n  internalErrors: BrokenLink[];\n  /** External broken links (different domain) */\n  externalErrors: BrokenLink[];\n  url: string;\n  timestamp: string;\n  duration?: number;\n}\n\n/**\n * Get site URL from options or environment variable\n */\nfunction getSiteUrl(options: CheckLinksOptions): string {\n  if (options.url) {\n    return options.url;\n  }\n\n  // Try environment variables\n  const envUrl =\n    process.env.NEXT_PUBLIC_SITE_URL ||\n    process.env.SITE_URL ||\n    process.env.BASE_URL;\n\n  if (envUrl) {\n    return envUrl;\n  }\n\n  throw new Error(\n    'URL is required. Provide it via options.url or set NEXT_PUBLIC_SITE_URL environment variable.'\n  );\n}\n\n/**\n * Check if URL is external (different domain)\n */\nfunction isExternalUrl(linkUrl: string, baseUrl: string): boolean {\n  try {\n    const link = new URL(linkUrl);\n    const base = new URL(baseUrl);\n    return link.hostname !== base.hostname;\n  } catch {\n    return true;\n  }\n}\n\n/**\n * Check all links on a website\n */\nexport async function checkLinks(options: CheckLinksOptions): Promise<CheckLinksResult> {\n  const url = getSiteUrl(options);\n  const {\n    timeout = 60000,\n    skipPattern = DEFAULT_SKIP_PATTERN,\n    showOnlyBroken = true,\n    concurrency = 50,\n    outputFile,\n    reportFormat = 'text',\n    verbose = true,\n  } = options;\n\n  const startTime = Date.now();\n\n  if (verbose) {\n    console.log(chalk.cyan(`\\n🔍 Starting link check for: ${chalk.bold(url)}`));\n    console.log(chalk.dim(`   Timeout: ${timeout}ms | Concurrency: ${concurrency}`));\n    console.log('');\n  }\n\n  const skipRegex = new RegExp(skipPattern);\n\n  const checkOptions: CheckOptions = {\n    path: url,\n    recurse: true,\n    timeout,\n    concurrency,\n    linksToSkip: (link: string) => {\n      return Promise.resolve(skipRegex.test(link));\n    },\n  };\n\n  const broken: BrokenLink[] = [];\n  const internalErrors: BrokenLink[] = [];\n  const externalErrors: BrokenLink[] = [];\n  let total = 0;\n\n  try {\n    const results = await linkinator.check(checkOptions);\n\n    for (const result of results.links) {\n      total++;\n      const status = result.status || 0;\n      const isExternal = isExternalUrl(result.url, url);\n\n      if (status < 200 || status >= 400 || result.state === 'BROKEN') {\n        const statusValue = status || 'TIMEOUT';\n\n        // Skip TIMEOUT errors on external URLs (rate limiting, slow servers)\n        if (statusValue === 'TIMEOUT' && isExternal) {\n          continue;\n        }\n\n        const brokenLink: BrokenLink = {\n          url: result.url,\n          status: statusValue,\n          reason: result.state === 'BROKEN' ? 'BROKEN' : undefined,\n          isExternal,\n          sourceUrl: result.parent,\n        };\n\n        broken.push(brokenLink);\n\n        if (isExternal) {\n          externalErrors.push(brokenLink);\n        } else {\n          internalErrors.push(brokenLink);\n        }\n      }\n    }\n\n    const success = internalErrors.length === 0;\n\n    if (!showOnlyBroken || broken.length > 0) {\n      if (success && externalErrors.length === 0) {\n        console.log(`✅ All links are valid!`);\n        console.log(`   Checked ${total} links.`);\n      } else {\n        // Show internal errors first (more important)\n        if (internalErrors.length > 0) {\n          console.log(chalk.red(`❌ Found ${internalErrors.length} broken internal links:`));\n          for (const { url: linkUrl, status, reason } of internalErrors.slice(0, 20)) {\n            console.log(`   [${status}] ${linkUrl}${reason ? ` (${reason})` : ''}`);\n          }\n          if (internalErrors.length > 20) {\n            console.log(chalk.dim(`   ... and ${internalErrors.length - 20} more`));\n          }\n        }\n\n        // Show external errors (less critical)\n        if (externalErrors.length > 0) {\n          console.log('');\n          console.log(chalk.yellow(`⚠️  Found ${externalErrors.length} broken external links:`));\n          for (const { url: linkUrl, status } of externalErrors.slice(0, 10)) {\n            console.log(`   [${status}] ${linkUrl}`);\n          }\n          if (externalErrors.length > 10) {\n            console.log(chalk.dim(`   ... and ${externalErrors.length - 10} more`));\n          }\n        }\n      }\n    }\n\n    const duration = Date.now() - startTime;\n    const result: CheckLinksResult = {\n      success,\n      broken: broken.length,\n      total,\n      errors: broken,\n      internalErrors,\n      externalErrors,\n      url,\n      timestamp: new Date().toISOString(),\n      duration,\n    };\n\n    if (outputFile) {\n      await saveReport(result, outputFile, reportFormat);\n      console.log(chalk.green(`\\n📄 Report saved to: ${chalk.cyan(outputFile)}`));\n    }\n\n    return result;\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    const errorName = error instanceof Error ? error.name : 'UnknownError';\n\n    if (\n      errorMessage.includes('timeout') ||\n      errorMessage.includes('TimeoutError') ||\n      errorName === 'TimeoutError' ||\n      errorMessage.includes('aborted')\n    ) {\n      console.warn(chalk.yellow(`⚠️  Some links timed out after ${timeout}ms`));\n      console.warn(chalk.dim(`   This is normal for slow or protected URLs.`));\n      if (total > 0) {\n        console.warn(chalk.dim(`   Checked ${total} links before timeout.`));\n      }\n\n      if (broken.length > 0) {\n        console.log(chalk.red(`\\n❌ Found ${broken.length} broken links:`));\n        for (const { url, status, reason } of broken) {\n          const statusColor =\n            typeof status === 'number' && status >= 500 ? chalk.red : chalk.yellow;\n          console.log(\n            `   ${statusColor(`[${status}]`)} ${chalk.cyan(url)}${reason ? chalk.dim(` (${reason})`) : ''}`\n          );\n        }\n      }\n    } else {\n      console.error(chalk.red(`❌ Error checking links: ${errorMessage}`));\n    }\n\n    const duration = Date.now() - startTime;\n    const result: CheckLinksResult = {\n      success: internalErrors.length === 0 && total > 0,\n      broken: broken.length,\n      total,\n      errors: broken,\n      internalErrors,\n      externalErrors,\n      url,\n      timestamp: new Date().toISOString(),\n      duration,\n    };\n\n    if (outputFile) {\n      try {\n        await saveReport(result, outputFile, reportFormat);\n        console.log(chalk.green(`\\n📄 Report saved to: ${chalk.cyan(outputFile)}`));\n      } catch (saveError) {\n        console.warn(\n          chalk.yellow(\n            `\\n⚠️  Failed to save report: ${saveError instanceof Error ? saveError.message : String(saveError)}`\n          )\n        );\n      }\n    }\n\n    return result;\n  }\n}\n\n/**\n * Convert link check results to SEO issues\n * Separates internal (critical) from external (warning) issues\n */\nexport function linkResultsToSeoIssues(result: CheckLinksResult): SeoIssue[] {\n  const issues: SeoIssue[] = [];\n\n  // Internal broken links are more critical\n  for (const error of result.internalErrors) {\n    issues.push({\n      id: `broken-internal-link-${hash(error.url)}`,\n      url: error.url,\n      category: 'technical' as const,\n      severity: typeof error.status === 'number' && error.status >= 500 ? 'critical' as const : 'error' as const,\n      title: `Broken internal link: ${error.status}`,\n      description: `Internal link returned ${error.status} status${error.reason ? ` (${error.reason})` : ''}.`,\n      recommendation: 'Fix the internal link. This affects user experience and SEO.',\n      detectedAt: result.timestamp,\n      metadata: {\n        status: error.status,\n        reason: error.reason,\n        sourceUrl: error.sourceUrl || result.url,\n        isExternal: false,\n      },\n    });\n  }\n\n  // External broken links are warnings\n  for (const error of result.externalErrors) {\n    issues.push({\n      id: `broken-external-link-${hash(error.url)}`,\n      url: error.url,\n      category: 'technical' as const,\n      severity: 'warning' as const,\n      title: `Broken external link: ${error.status}`,\n      description: `External link returned ${error.status} status.`,\n      recommendation: 'Consider removing or updating the external link.',\n      detectedAt: result.timestamp,\n      metadata: {\n        status: error.status,\n        reason: error.reason,\n        sourceUrl: error.sourceUrl || result.url,\n        isExternal: true,\n      },\n    });\n  }\n\n  return issues;\n}\n\nasync function saveReport(\n  result: CheckLinksResult,\n  filePath: string,\n  format: 'json' | 'markdown' | 'text'\n): Promise<void> {\n  const dir = dirname(filePath);\n  if (dir !== '.') {\n    await mkdir(dir, { recursive: true });\n  }\n\n  let content: string;\n\n  switch (format) {\n    case 'json':\n      content = JSON.stringify(result, null, 2);\n      break;\n\n    case 'markdown':\n      content = generateMarkdownReport(result);\n      break;\n\n    case 'text':\n    default:\n      content = generateTextReport(result);\n      break;\n  }\n\n  await writeFile(filePath, content, 'utf-8');\n}\n\nfunction generateMarkdownReport(result: CheckLinksResult): string {\n  const lines: string[] = [];\n\n  lines.push('# Link Check Report');\n  lines.push('');\n  lines.push(`**URL:** ${result.url}`);\n  lines.push(`**Timestamp:** ${result.timestamp}`);\n  if (result.duration) {\n    lines.push(`**Duration:** ${(result.duration / 1000).toFixed(2)}s`);\n  }\n  lines.push('');\n  lines.push(\n    `**Status:** ${result.success ? '✅ All links valid' : '❌ Broken links found'}`\n  );\n  lines.push(`**Total links:** ${result.total}`);\n  lines.push(`**Broken links:** ${result.broken}`);\n  lines.push('');\n\n  if (result.errors.length > 0) {\n    lines.push('## Broken Links');\n    lines.push('');\n    lines.push('| Status | URL | Reason |');\n    lines.push('|--------|-----|--------|');\n    for (const { url, status, reason } of result.errors) {\n      lines.push(`| ${status} | ${url} | ${reason || '-'} |`);\n    }\n    lines.push('');\n  }\n\n  return lines.join('\\n');\n}\n\nfunction generateTextReport(result: CheckLinksResult): string {\n  const lines: string[] = [];\n\n  lines.push('Link Check Report');\n  lines.push('='.repeat(50));\n  lines.push(`URL: ${result.url}`);\n  lines.push(`Timestamp: ${result.timestamp}`);\n  if (result.duration) {\n    lines.push(`Duration: ${(result.duration / 1000).toFixed(2)}s`);\n  }\n  lines.push('');\n  lines.push(\n    `Status: ${result.success ? '✅ All links valid' : '❌ Broken links found'}`\n  );\n  lines.push(`Total links: ${result.total}`);\n  lines.push(`Broken links: ${result.broken}`);\n  lines.push('');\n\n  if (result.errors.length > 0) {\n    lines.push('Broken Links:');\n    lines.push('-'.repeat(50));\n    for (const { url, status, reason } of result.errors) {\n      lines.push(`[${status}] ${url}${reason ? ` (${reason})` : ''}`);\n    }\n    lines.push('');\n  }\n\n  return lines.join('\\n');\n}\n\nfunction hash(str: string): string {\n  let h = 0;\n  for (let i = 0; i < str.length; i++) {\n    const char = str.charCodeAt(i);\n    h = (h << 5) - h + char;\n    h = h & h;\n  }\n  return Math.abs(h).toString(36);\n}\n"]}

package/dist/markdown-report-B3QdDzxE.d.ts

@@ -0,0 +1,193 @@
+import { SeoIssue, UrlInspectionResult, CrawlResult, SeoReport } from './types/index.js';
+
+/**
+ * @djangocfg/seo - Report Generator
+ * Main report generation orchestrator
+ */
+
+interface ReportGeneratorOptions {
+    outputDir: string;
+    formats: ('json' | 'markdown' | 'ai-summary' | 'split')[];
+    includeRawData?: boolean;
+    timestamp?: boolean;
+    /** Clear output directory before generating reports */
+    clearOutputDir?: boolean;
+    /** Maximum URLs to show per issue group (default: 10) */
+    maxUrlsPerIssue?: number;
+}
+interface GeneratedReports {
+    report: SeoReport;
+    files: {
+        json?: string;
+        markdown?: string;
+        aiSummary?: string;
+        split?: {
+            index: string;
+            categories: string[];
+        };
+    };
+}
+/**
+ * Generate and save SEO reports
+ */
+declare function generateAndSaveReports(siteUrl: string, data: {
+    issues: SeoIssue[];
+    urlInspections?: UrlInspectionResult[];
+    crawlResults?: CrawlResult[];
+}, options: ReportGeneratorOptions): Promise<GeneratedReports>;
+/**
+ * Print report summary to console
+ */
+declare function printReportSummary(report: SeoReport): void;
+/**
+ * Merge multiple reports into one
+ */
+declare function mergeReports(reports: SeoReport[]): SeoReport;
+
+/**
+ * @djangocfg/seo - JSON Report Generator
+ * Generate AI-friendly JSON reports
+ */
+
+interface JsonReportOptions {
+    includeRawData?: boolean;
+    prettyPrint?: boolean;
+    /** Maximum URLs to include per issue group (default: 10) */
+    maxUrlsPerIssue?: number;
+}
+/**
+ * Generate a comprehensive JSON report
+ */
+declare function generateJsonReport(siteUrl: string, data: {
+    issues: SeoIssue[];
+    urlInspections?: UrlInspectionResult[];
+    crawlResults?: CrawlResult[];
+}, options?: JsonReportOptions): SeoReport;
+/**
+ * Export report as JSON string
+ */
+declare function exportJsonReport(report: SeoReport, pretty?: boolean): string;
+/**
+ * Generate AI-optimized schema for the report
+ * This schema helps AI understand the report structure
+ */
+declare const AI_REPORT_SCHEMA: {
+    $schema: string;
+    title: string;
+    description: string;
+    type: string;
+    properties: {
+        id: {
+            type: string;
+            description: string;
+        };
+        siteUrl: {
+            type: string;
+            description: string;
+        };
+        generatedAt: {
+            type: string;
+            format: string;
+        };
+        summary: {
+            type: string;
+            description: string;
+            properties: {
+                totalUrls: {
+                    type: string;
+                };
+                indexedUrls: {
+                    type: string;
+                };
+                notIndexedUrls: {
+                    type: string;
+                };
+                healthScore: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                    description: string;
+                };
+            };
+        };
+        issues: {
+            type: string;
+            description: string;
+            items: {
+                type: string;
+                properties: {
+                    severity: {
+                        type: string;
+                        enum: string[];
+                    };
+                    category: {
+                        type: string;
+                        enum: string[];
+                    };
+                    title: {
+                        type: string;
+                    };
+                    description: {
+                        type: string;
+                    };
+                    recommendation: {
+                        type: string;
+                    };
+                    url: {
+                        type: string;
+                    };
+                };
+            };
+        };
+        recommendations: {
+            type: string;
+            description: string;
+            items: {
+                type: string;
+                properties: {
+                    priority: {
+                        type: string;
+                        minimum: number;
+                        maximum: number;
+                    };
+                    title: {
+                        type: string;
+                    };
+                    affectedUrls: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                    actionItems: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+};
+
+/**
+ * @djangocfg/seo - Markdown Report Generator
+ * Generate human-readable Markdown reports
+ */
+
+interface MarkdownReportOptions {
+    includeRawIssues?: boolean;
+    includeUrls?: boolean;
+    maxUrlsPerIssue?: number;
+}
+/**
+ * Generate a Markdown report from SEO data
+ */
+declare function generateMarkdownReport(report: SeoReport, options?: MarkdownReportOptions): string;
+/**
+ * Generate a concise summary for AI consumption
+ */
+declare function generateAiSummary(report: SeoReport): string;
+
+export { AI_REPORT_SCHEMA as A, type GeneratedReports as G, type JsonReportOptions as J, type MarkdownReportOptions as M, type ReportGeneratorOptions as R, generateJsonReport as a, generateMarkdownReport as b, generateAiSummary as c, exportJsonReport as e, generateAndSaveReports as g, mergeReports as m, printReportSummary as p };

package/dist/reports/index.d.ts

@@ -0,0 +1,24 @@
+export { A as AI_REPORT_SCHEMA, G as GeneratedReports, J as JsonReportOptions, M as MarkdownReportOptions, R as ReportGeneratorOptions, e as exportJsonReport, c as generateAiSummary, g as generateAndSaveReports, a as generateJsonReport, b as generateMarkdownReport, m as mergeReports, p as printReportSummary } from '../markdown-report-B3QdDzxE.js';
+import { SeoReport } from '../types/index.js';
+
+/**
+ * @djangocfg/seo - Split Report Generator
+ * Generates AI-friendly split reports (max 1000 lines each)
+ */
+
+interface SplitReportOptions {
+    outputDir: string;
+    /** Clear output directory before generating */
+    clearOutputDir?: boolean;
+}
+interface SplitReportResult {
+    indexFile: string;
+    categoryFiles: string[];
+    totalFiles: number;
+}
+/**
+ * Generate split reports for AI processing
+ */
+declare function generateSplitReports(report: SeoReport, options: SplitReportOptions): SplitReportResult;
+
+export { type SplitReportOptions, type SplitReportResult, generateSplitReports };