/**
 * git 子进程共享助手：credential helper 认证 + 可选显式代理 + 超时兜底。
 * token 绝不写进 remote URL，走一次性 credential helper 从 0600 token 文件读取。
 */
import { execFile } from "node:child_process";
import { promisify } from "node:util";

const run = promisify(execFile);

/** 自动同步类 git 操作的统一超时 */
export const GIT_TIMEOUT = 8000;

/**
 * 认证参数：清空外部 helper，改用从 token 文件读凭证的一次性 helper。
 * token 文件为两行（用户名\n令牌，通用 HTTPS）时逐行对应输出；
 * 单行旧格式沿用 GitHub 惯例 username=x-access-token、password=该行。
 */
export function gitAuthArgs(tokenFile: string): string[] {
  return [
    "-c",
    "credential.helper=",
    "-c",
    `credential.helper=!f() { L1=$(sed -n 1p "${tokenFile}"); L2=$(sed -n 2p "${tokenFile}"); if [ -n "$L2" ]; then echo "username=$L1"; echo "password=$L2"; else echo username=x-access-token; echo "password=$L1"; fi; }; f`,
  ];
}

/** 代理参数：仅当显式配置了代理时注入（否则由 git 走环境变量/直连） */
export function gitProxyArgs(proxy: string): string[] {
  return proxy ? ["-c", `http.proxy=${proxy}`] : [];
}

export interface GitOptions {
  tokenFile?: string;
  /** 为 true 时不注入 credential helper（ssh/local 远端零凭证） */
  noAuth?: boolean;
  proxy?: string;
  timeoutMs?: number;
  /** stdout/stderr 最大缓冲（字节）；git show 大 blob 默认 1MB 会爆，统一放宽 */
  maxBuffer?: number;
}

function buildPrefix(opts: GitOptions): string[] {
  return [
    ...(opts.tokenFile && !opts.noAuth ? gitAuthArgs(opts.tokenFile) : []),
    ...gitProxyArgs(opts.proxy ?? ""),
  ];
}

/** 在指定仓库目录内执行 git（自动带 -C） */
export async function gitIn(cwd: string, args: string[], opts: GitOptions = {}) {
  return run("git", ["-C", cwd, ...buildPrefix(opts), ...args], {
    timeout: opts.timeoutMs ?? GIT_TIMEOUT,
    maxBuffer: opts.maxBuffer ?? 256 * 1024 * 1024,
  });
}

/** 执行与仓库目录无关的 git 命令（如 clone） */
export async function git(args: string[], opts: GitOptions = {}) {
  return run("git", [...buildPrefix(opts), ...args], {
    timeout: opts.timeoutMs ?? GIT_TIMEOUT,
    maxBuffer: opts.maxBuffer ?? 256 * 1024 * 1024,
  });
}

// ---------- 按需会话存取辅助（稀疏存储模型） ----------

export interface GitLsEntry {
  path: string;
  mode: string;
  type: string;
  blob: string;
}

/** git ls-tree -r：列 tree 下条目（纯元数据；不能用 --long——partial clone 下
 * size 需要拉 blob 会触发 lazy fetch，认证失败则整体失败） */
export async function gitLsTree(
  repo: string,
  treeish: string,
  path: string,
  opts: GitOptions = {},
): Promise<GitLsEntry[]> {
  const { stdout } = await gitIn(
    repo,
    ["ls-tree", "-r", treeish, "--", path],
    { ...opts, timeoutMs: opts.timeoutMs ?? GIT_TIMEOUT },
  );
  const out: GitLsEntry[] = [];
  for (const line of stdout.split("\n")) {
    // 格式: <mode> <type> <blob>\t<path>
    const m = /^(\S+) (\S+) (\S+)\t(.+)$/.exec(line);
    if (m) out.push({ mode: m[1], type: m[2], blob: m[3], path: m[4] });
  }
  return out;
}

/** git show <treeish>:<path>：按需拉取 blob（partial clone 下自动 lazy fetch）。
 * 会话 JSONL 为 UTF-8 文本，utf8 stdout → Buffer 无损。 */
export async function gitShow(
  repo: string,
  treeish: string,
  path: string,
  opts: GitOptions = {},
): Promise<Buffer> {
  const { stdout } = await gitIn(repo, ["show", `${treeish}:${path}`], opts);
  return Buffer.from(stdout, "utf-8");
}

/** git hash-object -w：把文件写入对象库（不触碰工作区/index） */
export async function gitHashObject(
  repo: string,
  file: string,
  opts: GitOptions = {},
): Promise<string> {
  const { stdout } = await gitIn(repo, ["hash-object", "-w", file], opts);
  return stdout.trim();
}

/** git update-index --add --cacheinfo：把 blob 登记进 index（工作区可无此文件） */
export async function gitUpdateIndexCacheInfo(
  repo: string,
  path: string,
  blob: string,
  opts: GitOptions = {},
): Promise<void> {
  await gitIn(repo, ["update-index", "--add", "--cacheinfo", `100644,${blob},${path}`], opts);
}

/** git update-index --force-remove：从 index 移除路径（工作区可无此文件） */
export async function gitIndexRemove(
  repo: string,
  path: string,
  opts: GitOptions = {},
): Promise<void> {
  await gitIn(repo, ["update-index", "--force-remove", path], opts);
}