@dazhicheng/utils 1.3.24 → 1.3.25

package/dist/axios/type.d.ts

@@ -30,18 +30,41 @@ export type UnwrapApiResponse<T> = string extends keyof T ? T : T extends {
     data: infer D;
 } ? D : T;
 /**
- * 请求成功时的返回类型：`responseAllData !== true` 时为业务 data；为 true 时为完整 Axios 响应。
- * 调用处若未传 `responseAllData: true`，可按 UnwrapApiResponse&lt;T&gt; 使用（或断言）。
+ * 请求成功时的运行时联合类型（实现层使用）：`responseAllData !== true` 时为业务 data；为 true 时为完整 Axios 响应。
+ * 对外接口 {@link TtHttpReturnType} 使用重载区分，避免业务侧拿到 `| AxiosResponse` 联合导致与常用写法冲突。
  */
 export type TtHttpResult<T> = UnwrapApiResponse<T> | AxiosResponse<BaseResponse<UnwrapApiResponse<T>>>;
 type OmitMethod = Omit<ExtendedAxiosRequestConfig, "method">;
+/** 完整 Axios 响应（与 `responseAllData: true` 时 request 泛型一致） */
+export type TtHttpFullResponse<T> = AxiosResponse<BaseResponse<UnwrapApiResponse<T>>>;
+/**
+ * @description TtHttp 实例方法类型：按 `responseAllData` 重载返回值，默认仅返回业务载荷 `UnwrapApiResponse&lt;T&gt;`。
+ */
 export interface TtHttpReturnType {
-    get<T>(config: OmitMethod): Promise<TtHttpResult<T>>;
-    post<T>(config: OmitMethod): Promise<TtHttpResult<T>>;
-    put<T>(config: OmitMethod): Promise<TtHttpResult<T>>;
-    del<T>(config: OmitMethod): Promise<TtHttpResult<T>>;
-    patch<T>(config: OmitMethod): Promise<TtHttpResult<T>>;
-    request<T>(config: ExtendedAxiosRequestConfig): Promise<TtHttpResult<T>>;
+    get<T>(config: OmitMethod & {
+        responseAllData: true;
+    }): Promise<TtHttpFullResponse<T>>;
+    get<T>(config?: OmitMethod): Promise<UnwrapApiResponse<T>>;
+    post<T>(config: OmitMethod & {
+        responseAllData: true;
+    }): Promise<TtHttpFullResponse<T>>;
+    post<T>(config?: OmitMethod): Promise<UnwrapApiResponse<T>>;
+    put<T>(config: OmitMethod & {
+        responseAllData: true;
+    }): Promise<TtHttpFullResponse<T>>;
+    put<T>(config?: OmitMethod): Promise<UnwrapApiResponse<T>>;
+    del<T>(config: OmitMethod & {
+        responseAllData: true;
+    }): Promise<TtHttpFullResponse<T>>;
+    del<T>(config?: OmitMethod): Promise<UnwrapApiResponse<T>>;
+    patch<T>(config: OmitMethod & {
+        responseAllData: true;
+    }): Promise<TtHttpFullResponse<T>>;
+    patch<T>(config?: OmitMethod): Promise<UnwrapApiResponse<T>>;
+    request<T>(config: ExtendedAxiosRequestConfig & {
+        responseAllData: true;
+    }): Promise<TtHttpFullResponse<T>>;
+    request<T>(config: ExtendedAxiosRequestConfig): Promise<UnwrapApiResponse<T>>;
     logOut: () => void;
     setBaseUrl: (url: string) => void;
 }