压缩历史至 95081aff

2026-10-12 10:16:37 +08:00 · 2026-06-08 20:34:27 +08:00
commit 8a782525de
435 changed files with 71146 additions and 0 deletions
@@ -0,0 +1,117 @@
+import { BaseService } from '../core/base.service';
+import type {
+  OAuthLoginUrlResponse,
+  OAuthCallbackRequest,
+  User,
+} from './types';
+
+/**
+ * 认证服务
+ * 处理 OAuth 认证、用户信息获取、登出等
+ */
+export class AuthService extends BaseService {
+  protected static readonly basePath = '/api/v1/oauth';
+
+  /**
+   * 获取 OAuth 登录 URL
+   * @returns OAuth 授权 URL
+   * @throws {ApiErrorBase} 当获取失败时
+   * 
+   * @example
+   * ```typescript
+   * const url = await AuthService.getLoginUrl();
+   * window.location.href = url; // 重定向到 OAuth 授权页面
+   * ```
+   */
+  static async getLoginUrl(): Promise<OAuthLoginUrlResponse> {
+    return this.get<OAuthLoginUrlResponse>('/login');
+  }
+
+  /**
+   * 处理 OAuth 回调
+   * @param request - OAuth 回调参数（state 和 code）
+   * @throws {ApiErrorBase} 当回调处理失败时
+   * @throws {ValidationError} 当 state 无效时
+   * 
+   * @example
+   * ```typescript
+   * // 在回调页面获取 URL 参数
+   * const params = new URLSearchParams(window.location.search);
+   * const state = params.get('state');
+   * const code = params.get('code');
+   * 
+   * if (state && code) {
+   *   await AuthService.handleCallback({ state, code });
+   *   // 登录成功，跳转到首页
+   *   router.push('/home');
+   * }
+   * ```
+   */
+  static async handleCallback(request: OAuthCallbackRequest): Promise<void> {
+    return this.post<void>('/callback', request);
+  }
+
+  /**
+   * 获取当前登录用户信息
+   * @returns 用户信息
+   * @throws {UnauthorizedError} 当未登录时
+   * 
+   * @example
+   * ```typescript
+   * try {
+   *   const user = await AuthService.getUserInfo();
+   *   console.log('当前用户:', user.username);
+   * } catch (error) {
+   *   if (error instanceof UnauthorizedError) {
+   *     // 跳转到登录页
+   *     router.push('/login');
+   *   }
+   * }
+   * ```
+   */
+  static async getUserInfo(): Promise<User> {
+    return this.get<User>('/user-info');
+  }
+
+  /**
+   * 用户登出
+   * @throws {ApiErrorBase} 当登出失败时
+   * 
+   * @example
+   * ```typescript
+   * await AuthService.logout();
+   * // 清除本地状态
+   * router.push('/login');
+   * ```
+   */
+  static async logout(): Promise<void> {
+    await this.get<void>('/logout');
+  }
+
+  /**
+   * 发起登录流程
+   * 直接获取登录 URL 并重定向
+   * 
+   * @example
+   * ```typescript
+   * // 在登录按钮点击时调用
+   * await AuthService.initiateLogin();
+   * ```
+   */
+  static async initiateLogin(): Promise<void> {
+    if (typeof window !== 'undefined') {
+      const params = new URLSearchParams(window.location.search);
+      const callbackUrl = params.get('callbackUrl');
+
+      if (callbackUrl) {
+        sessionStorage.setItem('redirect_after_login', callbackUrl);
+      }
+    }
+
+    const url = await this.getLoginUrl();
+    if (typeof window !== 'undefined' && url) {
+      window.location.href = url;
+    }
+  }
+}
+