@moluoxixi/ajax-package 0.0.39 → 0.0.41

package/es/BaseHttpClient.d.ts

@@ -1,15 +1,6 @@
 import { AxiosError, AxiosRequestConfig, AxiosResponse, InternalAxiosRequestConfig, default as axios } from 'axios';
 import { BaseHttpClientConfig } from './_types/index.ts';
 import { MessageInstance, NotificationInstance } from './_utils/index.ts';
-/**
- * BaseHttpClient 基础类
- * 提供最基础的 HTTP 请求功能，包括：
- * - 创建 axios 实例
- * - 自动添加 Token
- * - 基础错误处理（401、超时等）
- * - HTTP 方法（get、post、put、delete、all）
- * - 文件上传
- */
 export default class BaseHttpClient {
     protected baseURL: string;
     protected timeout: number;
@@ -25,25 +16,15 @@ export default class BaseHttpClient {
     protected messageInstance: MessageInstance;
     protected notificationInstance: NotificationInstance;
     protected addSign?: (config: AxiosRequestConfig) => void;
-    /**
-     * 检查是否在浏览器环境（在类初始化时判断）
-     * 注意：这是静态属性，所有实例共享
-     */
+    protected recentErrorCache: {
+        message: string;
+        timestamp: number;
+    } | null;
+    protected errorDebounceTime: number;
+    protected errorCacheTimer: NodeJS.Timeout | null;
     protected static readonly hasDocument: boolean;
-    /**
-     * 获取是否在浏览器环境（实例 getter）
-     * @returns 是否在浏览器环境
-     */
     protected get hasDocument(): boolean;
-    /**
-     * 解析 appendTo 配置，返回目标 HTMLElement
-     * @returns 目标元素，如果找不到且配置为 null 则返回 null，'body' 时返回 document.body，其他字符串作为选择器查找
-     */
     protected resolveAppendToTarget(): HTMLElement | null;
-    /**
-     * 获取或创建 ajaxPackage-container 容器元素
-     * @returns 容器元素，如果不是浏览器环境则返回 null
-     */
     protected getContainer(): HTMLElement | null;
     /**
      * 获取或创建 popover 容器元素（用于 Dialog）
@@ -55,124 +36,22 @@ export default class BaseHttpClient {
      * @returns 容器元素，如果不是浏览器环境则返回 null
      */
     getMessageContainer(): HTMLElement | null;
-    /**
-     * 创建 BaseHttpClient 实例
-     * @param config - HTTP 客户端配置对象
-     */
     constructor(config: BaseHttpClientConfig);
-    /**
-     * 处理请求配置，子类可重写此方法自定义请求配置
-     * @param config - 请求配置对象
-     * @returns 处理后的请求配置
-     */
     processRequestConfig(config: InternalAxiosRequestConfig): InternalAxiosRequestConfig<any>;
-    /**
-     * 处理响应配置，子类可重写此方法自定义响应处理
-     * 按照标准 HTTP 结构处理响应
-     * @param response - Axios 响应对象
-     * @returns 解析后的响应数据
-     */
     processResponseConfig(response: AxiosResponse): AxiosResponse['data'];
-    /**
-     * 处理 HTTP 状态码
-     * 子类可重写此方法来自定义 HTTP 状态码处理逻辑
-     * @param response - Axios 响应对象
-     */
     protected handleHttpStatus(response: AxiosResponse): void;
-    /**
-     * 处理成功响应
-     * 子类可重写此方法来自定义成功响应的处理逻辑
-     * @param response - Axios 响应对象
-     * @returns 解析后的响应数据
-     */
     protected handleSuccessResponse(response: AxiosResponse): AxiosResponse['data'];
-    /**
-     * 处理响应错误，子类可重写此方法自定义错误处理
-     * 按照标准 HTTP 错误结构处理错误
-     * @param error - Axios 错误对象
-     * @returns 处理后的错误对象
-     */
     processResponseError(error: AxiosError): Promise<AxiosError>;
-    /**
-     * 处理认证错误（401 - 未授权/登录失效）
-     * 子类可重写此方法来自定义认证错误处理逻辑
-     * @param error - Axios 错误对象
-     */
     protected handleAuthenticationError(error: AxiosError): void;
-    /**
-     * 处理超时错误
-     * 子类可重写此方法来自定义超时错误处理逻辑
-     * @param error - Axios 错误对象
-     */
     protected handleTimeoutError(error: AxiosError): void;
-    /**
-     * 处理网络错误（其他错误）
-     * 子类可重写此方法来自定义网络错误处理逻辑
-     * @param error - Axios 错误对象
-     */
     protected handleNetworkError(error: AxiosError): void;
-    /**
-     * 设置请求和响应拦截器
-     * 请求拦截器：自动添加 Token
-     * 响应拦截器：处理成功响应和错误响应（401、超时等）
-     */
     private setupInterceptors;
-    /**
-     * 发送 HTTP 请求，所有 HTTP 方法最终都调用此方法
-     * @param config - Axios 请求配置对象
-     * @returns 解析后的响应数据
-     */
     protected request<R>(config: AxiosRequestConfig): Promise<AxiosResponse['data']>;
-    /**
-     * 发送 GET 请求
-     * @param url - 请求 URL 路径
-     * @param params - 查询参数对象
-     * @param config - 额外的请求配置
-     * @returns 解析后的响应数据
-     */
     get<R>(url: string, params?: Record<string, any>, config?: AxiosRequestConfig): Promise<AxiosResponse['data']>;
-    /**
-     * 发送 POST 请求
-     * @param url - 请求 URL 路径
-     * @param data - 请求体数据
-     * @param config - 额外的请求配置
-     * @returns 解析后的响应数据
-     */
     post<R>(url: string, data?: Record<string, any>, config?: AxiosRequestConfig): Promise<AxiosResponse['data']>;
-    /**
-     * 发送 DELETE 请求
-     * @param url - 请求 URL 路径
-     * @param params - 查询参数对象
-     * @param config - 额外的请求配置
-     * @returns 解析后的响应数据
-     */
     delete<R>(url: string, params?: Record<string, any>, config?: AxiosRequestConfig): Promise<AxiosResponse['data']>;
-    /**
-     * 发送 PUT 请求
-     * @param url - 请求 URL 路径
-     * @param data - 请求体数据
-     * @param config - 额外的请求配置
-     * @returns 解析后的响应数据
-     */
     put<R>(url: string, data?: Record<string, any>, config?: AxiosRequestConfig): Promise<AxiosResponse['data']>;
-    /**
-     * 批量请求，并发发送多个请求
-     * @param requests - 请求配置数组或已发起的请求 Promise 数组
-     * @returns 所有请求的响应数据数组
-     */
     all<R>(requests: Array<AxiosRequestConfig | Promise<AxiosResponse<R>>>): Promise<AxiosResponse['data'][]>;
-    /**
-     * 文件上传，将文件包装为 FormData 发送
-     * @param url - 上传地址
-     * @param file - 文件对象
-     * @param config - 额外的请求配置
-     * @returns 解析后的响应数据
-     */
     uploadFile<R>(url: string, file: File | Blob, config?: AxiosRequestConfig): Promise<AxiosResponse['data']>;
-    /**
-     * 下载文件，将 Blob 对象下载到本地
-     * @param blob - Blob 对象
-     * @param filename - 文件名，如果不提供则使用时间戳
-     */
     downloadFile(blob: Blob, filename?: string): void;
 }

package/es/SystemErrorDialog.d.ts

@@ -1,7 +1,3 @@
-/**
- * SystemErrorDialog 组件
- * 使用 defineComponent 和 h 函数实现
- */
 declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     title: {
         type: StringConstructor;

package/es/_types/emits.d.ts

@@ -1,13 +1,6 @@
-/**
- * SystemErrorDialog 组件的 Emits 类型定义
- */
 export interface SystemErrorDialogEmitsType {
-    /** v-model 更新事件 */
     'update:modelValue': [val: boolean];
-    /** 关闭事件 */
     'close': [];
-    /** 确认事件 */
     'confirm': [data: any];
-    /** 上报事件 */
     'report': [];
 }

package/es/_utils/messageWrapper.d.ts

@@ -1,9 +1,3 @@
-/**
- * 创建消息实例的包装函数
- * @param hasDocument - 是否在浏览器环境
- * @param container - 容器元素或获取容器的函数，如果提供则消息将挂载到该容器中
- * @returns 消息函数实例，直接调用即可，支持传入 type: 'success' | 'error' | 'warning' | 'info'
- */
 export declare function createMessageWrapper(hasDocument: boolean, container?: HTMLElement | null | (() => HTMLElement | null)): (options: string | {
     message?: string;
     type?: "success" | "error" | "warning" | "info";

package/es/_utils/notificationWrapper.d.ts

@@ -1,9 +1,3 @@
-/**
- * 创建通知实例的包装函数（用于 errors / tips 展示）
- * @param hasDocument - 是否在浏览器环境
- * @param container - 容器元素或获取容器的函数，如果提供则通知将挂载到该容器中
- * @returns 通知函数实例，直接调用即可，支持传入 type: 'success' | 'error' | 'warning' | 'info'
- */
 export declare function createNotificationWrapper(hasDocument: boolean, container?: HTMLElement | null | (() => HTMLElement | null)): ((options: string | {
     message?: string;
     title?: string;

package/es/_utils/systemErrorInfo.d.ts

@@ -1,28 +1,7 @@
 import { AxiosResponse } from 'axios';
 import { SystemErrorDialogPropsType } from '../_types/index.ts';
-/**
- * 规范化请求参数对象
- * @param payload 请求参数
- * @returns 规范化后的对象
- */
 export declare function normalizePayload(payload: any): Record<string, any>;
-/**
- * 解析响应头中的 TraceId
- * @param headers 响应头
- * @returns TraceId 字符串
- */
 export declare function resolveTraceId(headers: AxiosResponse['headers'] | undefined): string;
-/**
- * 从 localStorage 中读取 userInfo
- * @returns userInfo 对象，如果不存在则返回空对象
- */
 export declare function getUserInfoFromLocalStorage(): Record<string, any>;
 export declare function getCurrentMenuLocalStorage(): Record<string, any>;
-/**
- * 从 AxiosResponse 中提取系统错误信息
- * @param response Axios 响应对象
- * @param code 错误代码
- * @param message 错误消息
- * @returns 提取的错误信息
- */
 export declare function extractSystemErrorInfo(response: AxiosResponse, code: number, message: string): Omit<SystemErrorDialogPropsType, 'title' | 'width'>;

package/es/class.d.ts

@@ -10,6 +10,11 @@ export default class BaseApi extends BaseHttpClient {
     protected responseFields: Required<BaseApiConfig['responseFields']>;
     protected enableSystemErrorDialog: boolean;
     protected systemErrorMessage: string;
+    /**
+     * 检查是否在浏览器环境（在类初始化时判断）
+     * 注意：这是静态属性，所有实例共享
+     */
+    private static readonly hasDocument;
     /**
      * SystemErrorDialog 实例
      * 注意：这是实例属性，每个实例有自己的对话框实例
@@ -27,6 +32,11 @@ export default class BaseApi extends BaseHttpClient {
      * 注意：这是静态属性，所有实例共享同一个错误信息存储
      */
     private static systemErrorInfoMap;
+    /**
+     * 获取是否在浏览器环境（实例 getter）
+     * @returns 是否在浏览器环境
+     */
+    protected get hasDocument(): boolean;
     /**
      * 获取系统错误信息存储（实例 getter）
      * @returns 系统错误信息存储 Map