wavelet init

2026-10-10 17:26:38 +08:00 · 2026-06-18 15:24:48 +08:00
parent d6a7011885
commit 99738bbc17
714 changed files with 139987 additions and 0 deletions
@@ -0,0 +1,188 @@
+import apiClient from './api-client';
+import {ApiResponse} from './types';
+import {InternalAxiosRequestConfig} from 'axios';
+
+/**
+ * 服务基类
+ * 提供通用的 HTTP 方法封装
+ *
+ * @example
+ * ```typescript
+ * class UserService extends BaseService {
+ *   protected static readonly basePath = '/api/v1/users';
+ *
+ *   static async getAll() {
+ *     return this.get<User[]>('/');
+ *   }
+ * }
+ * ```
+ */
+export class BaseService {
+  /**
+   * API 基础路径
+   * 子类必须重写此属性
+   */
+  protected static readonly basePath: string = '';
+
+  /**
+   * 获取完整的 API 路径
+   * @param path - API 路径
+   * @returns 完整路径
+   */
+  protected static getFullPath(path: string): string {
+    return `${ this.basePath }${ path }`;
+  }
+
+  /**
+   * GET 请求
+   * @template T - 响应数据类型
+   * @param path - API 路径
+   * @param params - 查询参数
+   * @param config - 额外的请求配置
+   * @returns 响应数据
+   */
+  protected static async get<T>(
+    path: string,
+    params?: Record<string, unknown>,
+    config?: InternalAxiosRequestConfig,
+  ): Promise<T> {
+    const requestConfig: InternalAxiosRequestConfig = {
+      ...config,
+      params,
+    } as InternalAxiosRequestConfig;
+    const response = await apiClient.get<ApiResponse<T>>(
+      this.getFullPath(path),
+      requestConfig,
+    );
+    return response.data.data;
+  }
+
+  /**
+   * POST 请求
+   * @template T - 响应数据类型
+   * @param path - API 路径
+   * @param data - 请求数据
+   * @param config - 额外的请求配置
+   * @returns 响应数据
+   */
+  protected static async post<T>(
+    path: string,
+    data?: unknown,
+    config?: InternalAxiosRequestConfig,
+  ): Promise<T> {
+    const response = await apiClient.post<ApiResponse<T>>(
+      this.getFullPath(path),
+      data,
+      config,
+    );
+    return response.data.data;
+  }
+
+  /**
+   * PUT 请求
+   * @template T - 响应数据类型
+   * @param path - API 路径
+   * @param data - 请求数据
+   * @param config - 额外的请求配置
+   * @returns 响应数据
+   */
+  protected static async put<T>(
+    path: string,
+    data?: unknown,
+    config?: InternalAxiosRequestConfig,
+  ): Promise<T> {
+    const response = await apiClient.put<ApiResponse<T>>(
+      this.getFullPath(path),
+      data,
+      config,
+    );
+    return response.data.data;
+  }
+
+  /**
+   * PATCH 请求
+   * @template T - 响应数据类型
+   * @param path - API 路径
+   * @param data - 请求数据
+   * @param config - 额外的请求配置
+   * @returns 响应数据
+   */
+  protected static async patch<T>(
+    path: string,
+    data?: unknown,
+    config?: InternalAxiosRequestConfig,
+  ): Promise<T> {
+    const response = await apiClient.patch<ApiResponse<T>>(
+      this.getFullPath(path),
+      data,
+      config,
+    );
+    return response.data.data;
+  }
+
+  /**
+   * DELETE 请求
+   * @template T - 响应数据类型
+   * @param path - API 路径
+   * @param params - 查询参数
+   * @param config - 额外的请求配置
+   * @returns 响应数据
+   */
+  protected static async delete<T>(
+    path: string,
+    params?: Record<string, unknown>,
+    config?: InternalAxiosRequestConfig,
+  ): Promise<T> {
+    const requestConfig: InternalAxiosRequestConfig = {
+      ...config,
+      params,
+    } as InternalAxiosRequestConfig;
+    const response = await apiClient.delete<ApiResponse<T>>(
+      this.getFullPath(path),
+      requestConfig,
+    );
+    return response.data.data;
+  }
+
+  /**
+   * 原始 GET 请求（用于特殊 API 端点）
+   * @template T - 响应数据类型
+   * @param url - 完整 URL
+   * @param params - 查询参数
+   * @returns 响应数据（不经过 response.data.data 解包）
+   *
+   * @remarks
+   * 仅用于不遵循标准响应格式的特殊端点（如 /api.php）
+   */
+  protected static async rawGet<T>(
+    url: string,
+    params?: unknown,
+  ): Promise<T> {
+    const response = await apiClient.get<T>(
+      url,
+      { params } as InternalAxiosRequestConfig,
+    );
+    return response.data;
+  }
+
+  /**
+   * 原始 POST 请求（用于特殊 API 端点）
+   * @template T - 响应数据类型
+   * @param url - 完整 URL
+   * @param data - 请求数据
+   * @param config - 额外的请求配置
+   * @returns 响应数据（不经过 response.data.data 解包）
+   *
+   * @remarks
+   * 仅用于不遵循标准响应格式的特殊端点（如 /api.php）
+   */
+  protected static async rawPost<T>(
+    url: string,
+    data?: unknown,
+    config?: InternalAxiosRequestConfig,
+  ): Promise<T> {
+    const response = await apiClient.post<T>(url, data, config);
+    return response.data;
+  }
+}
+