import type { ICommonResponse } from "#shared/types"; /** * 构造统一成功响应。 * * @param data 要返回给前端的数据,没有数据时传 null * @param msg 提示信息,默认“请求成功” * @returns 符合 ICommonResponse 格式的对象,code 固定为 0 */ export const createSuccessResponse = ( data: T | null = null, msg: string = "请求成功" ): ICommonResponse => { return { code: 0, data, msg }; }; /** * 构造统一错误响应。 * * @param code 错误码,默认 400;上游错误时传上游状态码 * @param msg 错误描述,展示给前端的提示文案 * @param data 附带的错误详情,通常是上游返回的原始响应体 * @returns 符合 ICommonResponse 格式的错误响应 */ export const createErrorResponse = ( code: number = 400, msg: string = "请求失败", data: unknown = null ): ICommonResponse => { return { code, data, msg }; }; /** * 将上游请求错误转换为统一响应。 * * @param error ofetch 抛出的错误对象 * @param fallbackMessage 当上游没有提供可用错误信息时的兜底提示 * @returns 符合 ICommonResponse 格式的错误响应 */ export const createUpstreamErrorResponse = ( error: unknown, fallbackMessage: string = "请求失败" ): ICommonResponse => { const fetchError = error as { data?: unknown; message?: string; response?: { _data?: unknown; status?: number; }; statusCode?: number; }; const errorData = fetchError.data ?? fetchError.response?._data ?? null; const errorMessage = typeof errorData === "string" ? errorData : fetchError.message || fallbackMessage; return createErrorResponse( fetchError.statusCode ?? fetchError.response?.status ?? 500, errorMessage, errorData ); };