Show broken links for versions under Maintenance Support

To reduce work in fixing broken links for versions that we no longer support, the script checks for broken link for versions of docs that are currently under Maintenance Support.

Author: josh-wong

scripts/filter-broken-link-warnings.js

@@ -1,26 +1,47 @@
 const fs = require("fs");
+const path = require("path");
 
+// Paths
 const logFile = "brokenLinks.log";
+const unsupportedVersionsFile = path.join(process.cwd(), "src", "pages", "unsupported-versions.mdx");
 
-// Read the full log file
+// Read unsupported versions from the MDX file.
+let unsupportedVersions = [];
+try {
+  const mdxContent = fs.readFileSync(unsupportedVersionsFile, "utf8");
+  // Extract unsupported version numbers (like 3.7, 3.6, etc.).
+  unsupportedVersions = Array.from(mdxContent.matchAll(/ScalarDB (\d+\.\d+)/g), match => match[1]);
+} catch (err) {
+  console.error("Error reading unsupported versions file:", err);
+  process.exit(1);
+}
+
+if (unsupportedVersions.length === 0) {
+  console.log("No unsupported versions found. Exiting.");
+  process.exit(0);
+}
+
+// Define the prefixes to filter for broken links.
+const prefixes = [
+  "- Broken link on source page path",
+  "   -> linking to "
+];
+
+// Read the log file and filter lines based on unsupported versions.
 fs.readFile(logFile, "utf8", (err, data) => {
   if (err) {
     console.error("Error reading log file:", err);
     process.exit(1);
   }
 
-  // Define the prefixes to filter
-  const prefixes = [
-    "- Broken link on source page path",
-    "   -> linking to "
-  ];
-
-  // Filter lines that start with any of the specified prefixes
   const filteredLines = data
     .split("\n")
-    .filter((line) => prefixes.some((prefix) => line.startsWith(prefix)));
+    .filter((line) =>
+      prefixes.some((prefix) => line.startsWith(prefix)) &&
+      !unsupportedVersions.some((version) => line.includes(`/docs/${version}/`)) // Exclude unsupported versions.
+    );
 
-  // Overwrite the log file with only the filtered lines
+  // Overwrite the log file with filtered lines.
   fs.writeFile(logFile, filteredLines.join("\n"), "utf8", (err) => {
     if (err) {
       console.error("Error writing filtered log file:", err);