github.ts

import { cache } from "react";

// GitHub 相关工具方法：集中维护仓库常量与文档路径生成逻辑
const GITHUB_OWNER = "InvolutionHell";
const GITHUB_REPO = "involutionhell.github.io";
const DEFAULT_BRANCH = "main";
const DOCS_BASE = "app/docs";

const REPO_BASE_URL = `https://github.com/${GITHUB_OWNER}/${GITHUB_REPO}`;

// 拼接路径并清理多余斜杠，避免出现 // 或首尾斜杠
function joinPath(...segments: (string | undefined)[]) {
  return segments
    .filter((segment) => (segment ?? "").trim().length > 0)
    .join("/")
    .replace(/\/+/g, "/")
    .replace(/^\/+/, "")
    .replace(/\/+$/, "");
}

// 将路径逐段 URL 编码，处理中文等特殊字符
function encodeRepoPath(...segments: (string | undefined)[]) {
  const joined = joinPath(...segments);
  if (!joined) return "";
  return joined
    .split("/")
    .map((segment) => encodeURIComponent(segment))
    .join("/");
}

// 构建文档的 GitHub 编辑链接
export function buildDocsEditUrl(relativeDocPath: string) {
  const encoded = encodeRepoPath(DOCS_BASE, relativeDocPath);
  return `${REPO_BASE_URL}/edit/${DEFAULT_BRANCH}/${encoded}`;
}

// 构建在 GitHub 新建文档的链接，附带 frontmatter 参数
export function buildDocsNewUrl(relativeDir: string, params: URLSearchParams) {
  const encodedDir = encodeRepoPath(DOCS_BASE, relativeDir);
  const query = params.toString();
  const suffix = query ? `?${query}` : "";
  return `${REPO_BASE_URL}/new/${DEFAULT_BRANCH}/${encodedDir}${suffix}`;
}

// 帮助预览完整 docs 路径（未编码）
export function normalizeDocsPath(relative: string) {
  return joinPath(DOCS_BASE, relative);
}

// 暴露常量给其他场景复用
export const githubConstants = {
  owner: GITHUB_OWNER,
  repo: GITHUB_REPO,
  defaultBranch: DEFAULT_BRANCH,
  docsBase: DOCS_BASE,
  repoBaseUrl: REPO_BASE_URL,
};



// Define contributor data structure
interface Contributor {
  login: string;
  avatar_url: string;
  html_url: string;
}

// Use React's cache function for request caching and deduplication
export const getContributors = cache(
  async (filePath: string): Promise<Contributor[]> => {
    try {
      // Use GITHUB_TOKEN environment variable for authorization to increase API rate limit
      const headers: HeadersInit = {};
      if (process.env.GITHUB_TOKEN) {
        headers.Authorization = `token ${process.env.GITHUB_TOKEN}`;
      }

      const response = await fetch(
        `https://api.github.com/repos/InvolutionHell/involutionhell.github.io/commits?path=${filePath}`,
        {
          headers,
          // Use next.revalidate to configure cache strategy (e.g., revalidate every hour)
          next: { revalidate: 3600 },
        },
      );

      if (!response.ok) {
        // If request fails, return empty array
        console.error(
          `Failed to fetch contributors for ${filePath}: ${response.statusText}`,
        );
        return [];
      }

      const commits = await response.json();

      // Use Map to deduplicate contributors
      const uniqueContributors = new Map<string, Contributor>();
      commits.forEach((commit: { author?: Contributor }) => {
        if (commit.author) {
          uniqueContributors.set(commit.author.login, {
            login: commit.author.login,
            avatar_url: commit.author.avatar_url,
            html_url: commit.author.html_url,
          });
        }
      });

      return Array.from(uniqueContributors.values());
    } catch (error) {
      console.error(`Error fetching contributors for ${filePath}:`, error);
      return [];
    }
  },
);