refactor: error handling, add commit link

Author: zlataovce

src/components/overrides/LastUpdated.astro

@@ -1,24 +1,42 @@
 ---
-import { type GitHubAccount, getGitHubAccountFromFile } from "/src/utils/git-utils.ts";
+import { REPO, getCommitInfo } from "../../utils/git";
 
 const { lang, lastUpdated } = Astro.locals.starlightRoute;
 const filePath = Astro.locals.starlightRoute.entry.filePath;
 
-const acc: GitHubAccount = await getGitHubAccountFromFile(filePath);
+const info = await getCommitInfo(filePath);
 ---
 
 {
   lastUpdated && (
-    <p>
-      {"Last updated: "}
-      <time datetime={lastUpdated.toISOString()}>
-        {lastUpdated.toLocaleDateString(lang, {
-          dateStyle: "medium",
-          timeZone: "UTC",
-        })}
-      </time>
-      {" by "}
-      <a href={acc.accountLink}>{acc.displayName}</a>
-    </p>
+    <div class="last-updated">
+      <p>
+        Last updated:
+        <time datetime={lastUpdated.toISOString()}>
+          {lastUpdated.toLocaleDateString(lang, {
+            dateStyle: "medium",
+            timeZone: "UTC",
+          })}
+        </time>
+      </p>
+      {info && (
+        <p class="commit">
+          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>
+        </p>
+      )}
+    </div>
   )
 }
+
+<style>
+  .last-updated {
+    display: flex;
+    flex-direction: column;
+    line-height: 1.5;
+  }
+
+  .commit {
+    font-size: var(--sl-text-2xs);
+  }
+</style>

src/utils/git-utils.ts

@@ -0,0 +1,65 @@
+import { execSync } from "child_process";
+
+export interface CommitterInfo {
+  name: string;
+  href: string;
+}
+
+export interface CommitInfo {
+  hash: string;
+  committer: CommitterInfo;
+}
+
+const token: string | null = import.meta.env.GITHUB_TOKEN;
+
+const options: RequestInit =
+  token != null
+    ? {
+        headers: {
+          Accept: "application/vnd.github+json",
+          "User-Agent": "papermc-docs/author",
+          Authorization: `Bearer ${token}`,
+        },
+      }
+    : {
+        headers: {
+          Accept: "application/vnd.github+json",
+          "User-Agent": "papermc-docs/author",
+        },
+      };
+
+export const REPO = "PaperMC/docs";
+const cache = new Map<string, CommitterInfo>();
+
+export const getCommitInfo = async (filePath: string): Promise<CommitInfo | null> => {
+  let email: string, hash: string;
+  try {
+    email = execSync(`git log -1 --pretty="format:%ae" -- "${filePath}"`).toString();
+    hash = execSync(`git log -1 --pretty="format:%H" -- "${filePath}"`).toString();
+  } catch (e) {
+    return null;
+  }
+
+  const cached = cache.get(email);
+  if (cached) {
+    return { hash, committer: cached };
+  }
+
+  let name: string;
+  try {
+    name = execSync(`git log -1 --pretty="format:%an" -- "${filePath}"`).toString();
+  } catch (e) {
+    return null;
+  }
+
+  const info: CommitterInfo = { name, href: `mailto:${email}` };
+
+  const res = await fetch(`https://api.github.com/repos/${REPO}/commits/${hash}`, options);
+  if (res.ok) {
+    const commit = await res.json();
+    info.href = commit.author.html_url;
+  }
+
+  cache.set(email, info);
+  return { hash, committer: info };
+};