XTLS_Xray-docs-next/scripts/gen-contributors.mjs

import { execSync } from "node:child_process";
import fs from "node:fs";
import path from "node:path";
import crypto from "node:crypto";

const ROOT = process.cwd();
const DOCS_DIR = path.resolve(ROOT, "docs");
const OUT_DIR = path.resolve(ROOT, ".vitepress/.generated");
const OUT_FILE = path.join(OUT_DIR, "contributors.json");

function walk(dir) {
    const out = [];
    for (const name of fs.readdirSync(dir)) {
        const p = path.join(dir, name);
        const st = fs.statSync(p);
        if (st.isDirectory()) out.push(...walk(p));
        else if (p.endsWith(".md")) out.push(p);
    }
    return out;
}

function md5(s) {
    return crypto.createHash("md5").update(s.trim().toLowerCase()).digest("hex");
}

function parseGithubUsernameFromNoreply(email = "") {
    // 1) 12345+username@users.noreply.github.com
    // 2) username@users.noreply.github.com
    const m1 = email.match(/^[^+]+\+([^@]+)@users\.noreply\.github\.com$/i);
    if (m1?.[1]) return m1[1];
    const m2 = email.match(/^([^@]+)@users\.noreply\.github\.com$/i);
    if (m2?.[1]) return m2[1];
    return null;
}

function avatarUrlFor(email = "") {
    const gh = parseGithubUsernameFromNoreply(email);
    if (gh) {
        return `https://unavatar.io/github/${encodeURIComponent(gh)}`;
    }
    if (email) {
        return `https://www.gravatar.com/avatar/${md5(email)}?d=identicon&s=64`;
    }
    return `https://www.gravatar.com/avatar/?d=identicon&s=64`;
}

function gitContributors(fileAbsPath) {
    const rel = path.relative(process.cwd(), fileAbsPath).replaceAll("\\", "/");
    let raw = "";
    try {
        raw = execSync(`git log --follow --format="%aN|%aE" -- "${rel}"`, {
            encoding: "utf8",
        });
    } catch {
        return [];
    }

    const map = new Map();
    raw
        .split("\n")
        .map((s) => s.trim())
        .filter(Boolean)
        .forEach((line) => {
            const [name, email] = line.split("|");
            const key = (email || name || "").toLowerCase();
            if (!map.has(key)) {
                const github = parseGithubUsernameFromNoreply(email);
                map.set(key, {
                    name,
                    email,
                    github,
                    avatarUrl: avatarUrlFor(email),
                    commits: 0,
                });
            }
            map.get(key).commits += 1;
        });

    return [...map.values()].sort((a, b) => b.commits - a.commits);
}

const files = walk(DOCS_DIR);
const data = {};

for (const abs of files) {
    const relToDocs = path.relative(DOCS_DIR, abs).replaceAll("\\", "/");
    let route = "/" + relToDocs.replace(/\.md$/, "");
    route = route.replace(/\/index$/, "/"); // docs/a/index.md -> /a/
    data[route] = gitContributors(abs);
}

fs.mkdirSync(OUT_DIR, { recursive: true });
fs.writeFileSync(OUT_FILE, JSON.stringify(data, null, 2), "utf8");
console.log(`Generated contributors for ${files.length} pages -> ${OUT_FILE}`);