147 lines
4.5 KiB
TypeScript
147 lines
4.5 KiB
TypeScript
import { workspaceRoot } from '@nx/devkit';
|
|
import { XMLParser } from 'fast-xml-parser';
|
|
import { existsSync, readJSONSync } from 'fs-extra';
|
|
import * as glob from 'glob';
|
|
import { readFileSync } from 'node:fs';
|
|
import { join } from 'node:path';
|
|
import * as parseLinks from 'parse-markdown-links';
|
|
|
|
/**
|
|
* Check the integrity of internal links on nx-dev
|
|
* - Error if a link present in markdown files target a non-existing nextjs app url
|
|
* - Scans docs content, gather all links and validated them again nextjs sitemap.
|
|
*/
|
|
function readFileContents(path: string): string {
|
|
return readFileSync(path, 'utf-8');
|
|
}
|
|
function isLinkInternal(linkPath: string): boolean {
|
|
return linkPath.startsWith('/');
|
|
}
|
|
function isNotAsset(linkPath: string): boolean {
|
|
return !linkPath.startsWith('/assets');
|
|
}
|
|
function isNotImage(linkPath: string): boolean {
|
|
return (
|
|
!linkPath.endsWith('.png') &&
|
|
!linkPath.endsWith('.jpg') &&
|
|
!linkPath.endsWith('.jpeg') &&
|
|
!linkPath.endsWith('.gif') &&
|
|
!linkPath.endsWith('.webp') &&
|
|
!linkPath.endsWith('.svg') &&
|
|
!linkPath.endsWith('.avif')
|
|
);
|
|
}
|
|
function removeAnchors(linkPath: string): string {
|
|
return linkPath.split('#')[0];
|
|
}
|
|
function extractAllLinks(basePath: string): Record<string, string[]> {
|
|
return glob.sync(`${basePath}/**/*.md`).reduce((acc, path) => {
|
|
const fileContents = readFileContents(path);
|
|
const cardLinks = (fileContents.match(/url="(.*?)"/g) || []).map((v) =>
|
|
v.slice(5, -1)
|
|
);
|
|
const links = parseLinks(fileContents)
|
|
.concat(cardLinks)
|
|
.filter(isLinkInternal)
|
|
.filter(isNotAsset)
|
|
.filter(isNotImage)
|
|
.map(removeAnchors);
|
|
if (links.length) {
|
|
acc[path.replace(basePath, '')] = links;
|
|
}
|
|
return acc;
|
|
}, {});
|
|
}
|
|
function readSiteMapIndex(directoryPath: string, filename: string): string[] {
|
|
const parser = new XMLParser();
|
|
const sitemapIndex: {
|
|
sitemapindex: {
|
|
sitemap: {
|
|
loc: string;
|
|
};
|
|
};
|
|
} = parser.parse(readFileContents(join(directoryPath, filename)));
|
|
return [
|
|
join(
|
|
directoryPath,
|
|
sitemapIndex.sitemapindex.sitemap.loc.replace('https://nx.dev', '')
|
|
),
|
|
];
|
|
}
|
|
function readSiteMapLinks(filePath: string): string[] {
|
|
const parser = new XMLParser();
|
|
const sitemap: {
|
|
urlset: {
|
|
url: {
|
|
loc: string;
|
|
changefreq: string;
|
|
priority: number;
|
|
lastmod: string;
|
|
}[];
|
|
};
|
|
} = parser.parse(readFileContents(filePath));
|
|
return sitemap.urlset.url.map((obj) => obj.loc);
|
|
}
|
|
|
|
/**
|
|
* This function checks if a link is for a private package.
|
|
* When link is for a private package, it is not included in the sitemap.
|
|
* However, some shared docs might be written for this private package during development.
|
|
* @param link e.g. /nx-api/vite/generators/configuration
|
|
* @returns true if the link is for a private package or NODE_ENV is not development, false otherwise.
|
|
*/
|
|
function checkLinkIsForPrivatePackage(link: string) {
|
|
// skip this check in dev mode
|
|
if (process.env.NODE_ENV === 'development') {
|
|
return false;
|
|
}
|
|
const pathSegments = link.split('/').filter(Boolean);
|
|
if (pathSegments[0] === 'nx-api') {
|
|
// TODO(v17): Remove this once vue is public or once this logic is fixed
|
|
if (pathSegments[1] === 'vue') {
|
|
return true;
|
|
}
|
|
|
|
const packageJsonPath = join(
|
|
workspaceRoot,
|
|
'packages',
|
|
pathSegments[1],
|
|
'package.json'
|
|
);
|
|
if (existsSync(packageJsonPath)) {
|
|
return readJSONSync(packageJsonPath).private ?? false;
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
|
|
// Main
|
|
const documentLinks = extractAllLinks(join(workspaceRoot, 'docs'));
|
|
const sitemapLinks = readSiteMapIndex(
|
|
join(workspaceRoot, 'dist/nx-dev/nx-dev/public/'),
|
|
'sitemap.xml'
|
|
).flatMap((path) => readSiteMapLinks(path));
|
|
const errors: Array<{ file: string; link: string }> = [];
|
|
for (let file in documentLinks) {
|
|
for (let link of documentLinks[file]) {
|
|
// TODO(@isaacplmann): This ignores errors which are links TO private packages. It allows links FROM public packages (public docs) TO private packages (404 links)
|
|
if (
|
|
!sitemapLinks.includes(['https://nx.dev', link].join('')) &&
|
|
!checkLinkIsForPrivatePackage(link)
|
|
) {
|
|
errors.push({ file, link });
|
|
}
|
|
}
|
|
}
|
|
|
|
console.log(`i/ Internal Link Check`);
|
|
if (errors.length) {
|
|
console.log(`ERROR\n${errors.length} links are pointing to nowhere:`);
|
|
errors.forEach((error) =>
|
|
console.error(`⚠ File:${error.file}\n -> ${error.link}\n`)
|
|
);
|
|
process.exit(1);
|
|
}
|
|
console.log(`i/ No internal 404 link detected.`);
|
|
process.exit(0);
|