Show contributor on last update

This change shows who made the last update on a page and in what commit that change was made.

Author: CookieSource

astro.config.mjs

@@ -37,6 +37,9 @@ export default defineConfig({
       customCss: ["@/styles/global.css"],
       editLink: {
         baseUrl: "https://github.com/AerynOS/dotdev/edit/main/",
+      lastUpdated: true,
+      components: {
+        LastUpdated: "./src/components/LastUpdated.astro",
       },
       plugins: [starlightLinksValidator()],
       sidebar: [

src/components/LastUpdated.astro

@@ -0,0 +1,41 @@
+---
+import { REPO, getCommitInfo } from "@/utils/git";
+
+const { lang, lastUpdated, entry } = Astro.locals.starlightRoute;
+const filePath = entry?.filePath;
+
+const info = filePath ? await getCommitInfo(filePath) : null;
+---
+
+{
+	lastUpdated && (
+		<p>
+			<span class="nowrap">
+				Last updated:
+				<time datetime={lastUpdated.toISOString()}>
+					{lastUpdated.toLocaleDateString(lang, {
+						dateStyle: "medium",
+						timeZone: "UTC",
+					})}
+				</time>
+			</span>{" "}
+			{info && (
+				<span class="nowrap">
+					by <a href={info.committer.href}>{info.committer.name}</a> in{" "}
+					<a href={`https://github.com/${REPO}/commit/${info.hash}`}>{info.hash.substring(0, 7)}</a>
+				</span>
+			)}
+		</p>
+	)
+}
+
+<style>
+	a,
+	a:visited {
+		color: var(--sl-color-accent-high);
+	}
+
+	.nowrap {
+		white-space: nowrap;
+	}
+</style>

src/utils/git.ts

@@ -0,0 +1,71 @@
+import { execSync } from "node:child_process";
+
+export interface CommitterInfo {
+	name: string;
+	href: string;
+}
+
+export interface CommitInfo {
+	hash: string;
+	committer: CommitterInfo;
+}
+
+export const REPO = "AerynOS/dotdev";
+
+const cache = new Map<string, CommitterInfo>();
+
+const baseHeaders = {
+	Accept: "application/vnd.github+json",
+	"User-Agent": "AerynOS/docs (https://aerynos.dev)",
+};
+
+const GITHUB_OPTIONS: RequestInit = process.env.GITHUB_TOKEN
+	? {
+			headers: {
+				...baseHeaders,
+				Authorization: `Bearer ${process.env.GITHUB_TOKEN}`,
+			},
+		}
+	: { headers: baseHeaders };
+
+export const getCommitInfo = async (filePath: string): Promise<CommitInfo | null> => {
+	let hash: string;
+	let email: string;
+	let name: string;
+
+	try {
+		const raw = execSync(`git log -1 --format="%H,%ae,%an" -- "${filePath}"`, { stdio: ["ignore", "pipe", "ignore"] })
+			.toString()
+			.trim();
+		if (!raw) return null;
+		[hash, email, name] = raw.split(",", 3);
+	} catch {
+		return null;
+	}
+
+	if (!hash || !email || !name) {
+		return null;
+	}
+
+	const cached = cache.get(email);
+	if (cached) {
+		return { hash, committer: cached };
+	}
+
+	const info: CommitterInfo = { name, href: `mailto:${email}` };
+
+	try {
+		const res = await fetch(`https://api.github.com/repos/${REPO}/commits/${hash}`, GITHUB_OPTIONS);
+		if (res.ok) {
+			const commit = (await res.json()) as { author?: { html_url?: string } };
+			if (commit.author?.html_url) {
+				info.href = commit.author.html_url;
+			}
+		}
+	} catch {
+		// ignore network errors and fall back to mailto link
+	}
+
+	cache.set(email, info);
+	return { hash, committer: info };
+};