thugit-oauth

适用于清华大学 GitLab（Tsinghua Git）的 OAuth 认证库，支持获取访问令牌和用户信息。其中用户信息包括真实姓名、学号、用户名和邮箱。

使用方法

在 Tsinghua Git 上创建一个 OAuth 应用。记录其 AppID 和 Secret，并且添加一个指向你的后端服务器的 Redirect URI，例如 https://example.com/auth/callback。你的 OAuth 应用至少需要以下权限：

• read_user

在后端监听这一地址，然后从 URL Query Parameters 中获取 code，并使用它来获取访问令牌：

const accessToken = await getOauthAccessToken({
  oauthAppId,
  oauthAppSecret,
  authorizationCode,
  redirectUri,
  signal, // 可选
  timeoutMs: 5000, // 可选，默认值 10000
});

在获取到访问令牌后，就可以使用它来获取用户信息了：

const userInfo = await getUserInfoByToken(accessToken, {
  signal,
  timeoutMs: 5000,
}); // 第二个参数是可选的
console.log(userInfo);

请求默认会在 10 秒后超时；将 timeoutMs 设为 0 可以禁用超时。非成功 HTTP 响应会抛出 TsinghuaGitHttpError，其中包含状态码和响应内容；超时会抛出 TsinghuaGitTimeoutError。传入的 AbortSignal 被中止时，请求会以原始中止原因失败。