course-projects.ts

import { cache } from "react";

export type CourseProjectEntry = {
  id: string;
  href: string;
  title: string;
  institution?: string;
  grade?: string;
  summary: string;
  tags: string[];
  external?: boolean;
  hintLabel?: string;
  /** GitHub repo backing this entry — About/Topics/stars are fetched live */
  repo?: string;
  /** Live star count merged in by getCourseProjects */
  stars?: number;
};

/**
 * Course projects shown on /proj. For GitHub-backed entries the
 * summary, tags, and stars mirror the repo's About, Topics, and star count —
 * fetched live; the values below are fallbacks kept in sync by hand.
 */
export const COURSE_PROJECTS: CourseProjectEntry[] = [
  {
    id: "kai-course-notes",
    href: "https://kai-course-notes.kaichen.dev",
    title: "Kai Course Notes",
    summary:
      "Course notes & materials — handwritten & LaTeX notes, homework, and projects. Web-native notes on the Notion branch.",
    tags: [
      "computer-science",
      "course-notes",
      "coursework",
      "latex",
      "lecture-notes",
      "mathematics",
      "oxford",
      "statistics",
      "study-notes",
      "sustech",
      "uc-berkeley",
    ],
    external: true,
    hintLabel: "kai-course-notes.kaichen.dev",
    repo: "kaiiiichen/Kai-Course-Notes",
  },
];

const REVALIDATE_SECONDS = 120;

/**
 * COURSE_PROJECTS with the GitHub-backed fields (About → summary,
 * Topics → tags, stars) merged in live — same cadence as personal projects.
 */
export const getCourseProjects = cache(async function getCourseProjects(): Promise<
  CourseProjectEntry[]
> {
  const token = process.env.GITHUB_TOKEN;

  return Promise.all(
    COURSE_PROJECTS.map(async (entry) => {
      if (!entry.repo) return entry;
      try {
        const res = await fetch(`https://api.github.com/repos/${entry.repo}`, {
          headers: token ? { Authorization: `Bearer ${token}` } : undefined,
          next: { revalidate: REVALIDATE_SECONDS, tags: ["github-stars"] },
        });
        if (!res.ok) return entry;
        const json: {
          description?: string | null;
          topics?: string[];
          stargazers_count?: number;
        } = await res.json();
        return {
          ...entry,
          // GitHub data takes priority; fallback only if null/undefined
          summary: json.description ?? entry.summary,
          tags: json.topics ?? entry.tags,
          stars:
            typeof json.stargazers_count === "number" ? json.stargazers_count : entry.stars,
        };
      } catch {
        return entry;
      }
    })
  );
});