@moluoxixi/ajax-package 0.0.17 → 0.0.19

package/es/index.mjs

@@ -2,9 +2,9 @@
   "use strict";
   try {
     if (typeof document !== "undefined") {
-      if (!document.getElementById("75b05bee-ad6e-4470-b902-2118b507f825")) {
+      if (!document.getElementById("42dc4169-50f1-494b-a774-1a3f602f5896")) {
         var elementStyle = document.createElement("style");
-        elementStyle.id = "75b05bee-ad6e-4470-b902-2118b507f825";
+        elementStyle.id = "42dc4169-50f1-494b-a774-1a3f602f5896";
         elementStyle.appendChild(document.createTextNode("._root_11p33_1 .el-dialog__header {\n  padding: 0 12px 12px;\n}\n\n._root_11p33_1 .el-dialog__body {\n  border-top: 1px solid #e5e7eb;\n  border-bottom: 1px solid #e5e7eb;\n  padding: 0 12px;\n}\n\n._root_11p33_1 .el-dialog__footer {\n  padding: 0 12px;\n}"));
         document.head.appendChild(elementStyle);
       }
@@ -12049,9 +12049,9 @@ notify.closeAll = closeAll;
 notify.updateOffsets = updateOffsets;
 notify._context = null;
 const ElNotification = withInstallFunction(notify, "$notify");
-const hasDocument$2 = typeof document !== "undefined";
+const hasDocument$1 = typeof document !== "undefined";
 function createMessageWrapper() {
-  if (hasDocument$2) {
+  if (hasDocument$1) {
     return ElMessage;
   }
   return {
@@ -12071,9 +12071,9 @@ function createMessageWrapper() {
     }
   };
 }
-const hasDocument$1 = typeof document !== "undefined";
+const hasDocument = typeof document !== "undefined";
 function createNotificationWrapper() {
-  if (hasDocument$1) {
+  if (hasDocument) {
     return ElNotification;
   }
   const consoleNotification = (options, level = "info") => {
@@ -12183,6 +12183,10 @@ function defaultGetToken() {
   return typeof localStorage !== "undefined" ? localStorage.getItem("token") || "" : "";
 }
 class BaseHttpClient {
+  /**
+   * 创建 BaseHttpClient 实例
+   * @param config - HTTP 客户端配置对象
+   */
   constructor(config) {
     __publicField(this, "baseURL", "");
     __publicField(this, "timeout", 5e3);
@@ -12212,42 +12216,86 @@ class BaseHttpClient {
       baseURL: this.baseURL,
       timeout: this.timeout,
       ...axiosConfig
+      // 将所有剩余参数传给axios.create
     });
     this.setupInterceptors();
   }
+  /**
+   * 处理请求配置，子类可重写此方法自定义请求配置
+   * @param config - 请求配置对象
+   * @returns 处理后的请求配置
+   */
   processRequestConfig(config) {
     return config;
   }
+  /**
+   * 处理响应配置，子类可重写此方法自定义响应处理
+   * 按照标准 HTTP 结构处理响应
+   * @param response - Axios 响应对象
+   * @returns 解析后的响应数据
+   */
   processResponseConfig(response) {
     this.handleHttpStatus(response);
     return this.handleSuccessResponse(response);
   }
+  /**
+   * 处理 HTTP 状态码
+   * 子类可重写此方法来自定义 HTTP 状态码处理逻辑
+   * @param response - Axios 响应对象
+   */
   handleHttpStatus(response) {
     var _a2;
     if (response.status !== 200) {
       throw new Error(((_a2 = response.data) == null ? void 0 : _a2.message) || `HTTP Error: ${response.status}`);
     }
   }
+  /**
+   * 处理成功响应
+   * 子类可重写此方法来自定义成功响应的处理逻辑
+   * @param response - Axios 响应对象
+   * @returns 解析后的响应数据
+   */
   handleSuccessResponse(response) {
     return response.data;
   }
+  /**
+   * 处理响应错误，子类可重写此方法自定义错误处理
+   * 按照标准 HTTP 错误结构处理错误
+   * @param error - Axios 错误对象
+   * @returns 处理后的错误对象
+   */
   async processResponseError(error) {
     this.handleAuthenticationError(error);
     this.handleTimeoutError(error);
     this.handleNetworkError(error);
     return error;
   }
+  /**
+   * 处理认证错误（401 - 未授权/登录失效）
+   * 子类可重写此方法来自定义认证错误处理逻辑
+   * @param error - Axios 错误对象
+   */
   handleAuthenticationError(error) {
     var _a2, _b;
     if (((_a2 = error.response) == null ? void 0 : _a2.status) === 401) {
       (_b = this.onLoginRequired) == null ? void 0 : _b.call(this, this.messageInstance);
     }
   }
+  /**
+   * 处理超时错误
+   * 子类可重写此方法来自定义超时错误处理逻辑
+   * @param error - Axios 错误对象
+   */
   handleTimeoutError(error) {
     if (error.code === "ECONNABORTED" && error.message.includes("timeout")) {
       this.onTimeout(this.messageInstance);
     }
   }
+  /**
+   * 处理网络错误（其他错误）
+   * 子类可重写此方法来自定义网络错误处理逻辑
+   * @param error - Axios 错误对象
+   */
   handleNetworkError(error) {
     var _a2, _b, _c;
     if (((_a2 = error.response) == null ? void 0 : _a2.status) !== 401 && error.code !== "ECONNABORTED") {
@@ -12258,6 +12306,11 @@ class BaseHttpClient {
       });
     }
   }
+  /**
+   * 设置请求和响应拦截器
+   * 请求拦截器：自动添加 Token
+   * 响应拦截器：处理成功响应和错误响应（401、超时等）
+   */
   setupInterceptors() {
     this.instance.interceptors.request.use(
       (config) => {
@@ -12284,21 +12337,59 @@ class BaseHttpClient {
       }
     );
   }
+  /**
+   * 发送 HTTP 请求，所有 HTTP 方法最终都调用此方法
+   * @param config - Axios 请求配置对象
+   * @returns 解析后的响应数据
+   */
   async request(config) {
     return this.instance.request(config);
   }
+  /**
+   * 发送 GET 请求
+   * @param url - 请求 URL 路径
+   * @param params - 查询参数对象
+   * @param config - 额外的请求配置
+   * @returns 解析后的响应数据
+   */
   async get(url, params, config) {
     return this.request({ ...config, url, method: "get", params });
   }
+  /**
+   * 发送 POST 请求
+   * @param url - 请求 URL 路径
+   * @param data - 请求体数据
+   * @param config - 额外的请求配置
+   * @returns 解析后的响应数据
+   */
   async post(url, data, config) {
     return this.request({ ...config, url, method: "post", data });
   }
+  /**
+   * 发送 DELETE 请求
+   * @param url - 请求 URL 路径
+   * @param params - 查询参数对象
+   * @param config - 额外的请求配置
+   * @returns 解析后的响应数据
+   */
   async delete(url, params, config) {
     return this.request({ ...config, url, method: "delete", params });
   }
+  /**
+   * 发送 PUT 请求
+   * @param url - 请求 URL 路径
+   * @param data - 请求体数据
+   * @param config - 额外的请求配置
+   * @returns 解析后的响应数据
+   */
   async put(url, data, config) {
     return this.request({ ...config, url, method: "put", data });
   }
+  /**
+   * 批量请求，并发发送多个请求
+   * @param requests - 请求配置数组或已发起的请求 Promise 数组
+   * @returns 所有请求的响应数据数组
+   */
   async all(requests) {
     if (!requests.length)
       return [];
@@ -12311,6 +12402,13 @@ class BaseHttpClient {
     const promises = requests.map((config) => this.request(config));
     return await Promise.all(promises);
   }
+  /**
+   * 文件上传，将文件包装为 FormData 发送
+   * @param url - 上传地址
+   * @param file - 文件对象
+   * @param config - 额外的请求配置
+   * @returns 解析后的响应数据
+   */
   async uploadFile(url, file, config) {
     const formData = new FormData();
     formData.append("file", file);
@@ -12322,6 +12420,11 @@ class BaseHttpClient {
       }
     });
   }
+  /**
+   * 下载文件，将 Blob 对象下载到本地
+   * @param blob - Blob 对象
+   * @param filename - 文件名，如果不提供则使用时间戳
+   */
   downloadFile(blob, filename) {
     if (typeof window === "undefined") {
       console.warn("downloadFile: 非浏览器环境，无法下载文件");
@@ -12437,10 +12540,12 @@ function createApiDialog(DialogComponent) {
               cleanup();
             }
           },
+          // 监听关闭事件
           onClose: () => {
             reject(new Error("对话框已关闭"));
             cleanup();
           },
+          // 监听确认事件（如有）
           onConfirm: (data) => {
             resolve(data);
             cleanup();
@@ -12488,18 +12593,33 @@ function createApiDialog(DialogComponent) {
     close: close2
   };
 }
-const hasDocument = typeof document !== "undefined";
-let systemErrorDialogInstance = null;
-class BaseApi extends BaseHttpClient {
+const _BaseApi = class _BaseApi extends BaseHttpClient {
+  /**
+   * 创建 BaseApi 实例
+   * @param config - API 配置对象
+   */
   constructor(config) {
     const {
       responseFields,
       enableSystemErrorDialog = true,
+      systemErrorMessage = "系统错误",
       ...baseConfig
     } = config;
     super(baseConfig);
     __publicField(this, "responseFields");
     __publicField(this, "enableSystemErrorDialog");
+    __publicField(this, "systemErrorMessage");
+    /**
+     * SystemErrorDialog 实例
+     * 注意：这是实例属性，每个实例有自己的对话框实例
+     * 在构造函数中初始化（如果启用系统错误弹窗）
+     */
+    __publicField(this, "systemErrorDialogInstance", null);
+    /**
+     * SystemErrorDialog 初始化 Promise
+     * 用于跟踪初始化状态，避免重复初始化
+     */
+    __publicField(this, "systemErrorDialogInitPromise", null);
     this.responseFields = {
       code: "Code",
       message: "Message",
@@ -12509,28 +12629,112 @@ class BaseApi extends BaseHttpClient {
       ...responseFields
     };
     this.enableSystemErrorDialog = enableSystemErrorDialog;
+    this.systemErrorMessage = systemErrorMessage;
+    if (this.enableSystemErrorDialog && this.hasDocument) {
+      this.systemErrorDialogInitPromise = this.initSystemErrorDialog();
+    }
   }
-  processRequestConfig(config) {
-    return super.processRequestConfig(config);
-  }
-  processResponseConfig(response) {
-    return super.processResponseConfig(response);
-  }
-  async processResponseError(error) {
-    return super.processResponseError(error);
+  /**
+   * 获取是否在浏览器环境（实例 getter）
+   * @returns 是否在浏览器环境
+   */
+  get hasDocument() {
+    return _BaseApi.hasDocument;
   }
-  handleHttpStatus(response) {
-    return super.handleHttpStatus(response);
+  /**
+   * 获取系统错误信息存储（实例 getter）
+   * @returns 系统错误信息存储 Map
+   */
+  get systemErrorInfoMap() {
+    return _BaseApi.systemErrorInfoMap;
   }
-  handleAuthenticationError(error) {
-    super.handleAuthenticationError(error);
+  /**
+   * 生成唯一错误ID（实例方法）
+   * @returns 唯一错误ID
+   */
+  generateErrorId() {
+    return `system_error_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
   }
-  handleTimeoutError(error) {
-    return super.handleTimeoutError(error);
+  /**
+   * 打开系统错误详细弹窗（实例方法）
+   * @param errorId - 错误ID
+   */
+  async openSystemErrorDialog(errorId) {
+    const errorInfo = this.systemErrorInfoMap.get(errorId);
+    if (!errorInfo) {
+      console.warn("未找到错误信息，ID:", errorId);
+      return;
+    }
+    this.systemErrorInfoMap.delete(errorId);
+    try {
+      if (!this.systemErrorDialogInstance) {
+        if (this.systemErrorDialogInitPromise) {
+          try {
+            await this.systemErrorDialogInitPromise;
+          } catch {
+            console.error("系统异常信息：", errorInfo.responseData);
+            return;
+          }
+        } else {
+          try {
+            await this.initSystemErrorDialog();
+          } catch {
+            console.error("系统异常信息：", errorInfo.responseData);
+            return;
+          }
+        }
+        if (!this.systemErrorDialogInstance) {
+          console.error("系统异常信息：", errorInfo.responseData);
+          return;
+        }
+      }
+      const errorInfoData = extractSystemErrorInfo(
+        errorInfo.response,
+        errorInfo.code,
+        errorInfo.message
+      );
+      this.systemErrorDialogInstance.show({
+        props: {
+          title: "系统异常信息",
+          width: 600,
+          ...errorInfoData
+        }
+      }).then((result) => {
+        if (result == null ? void 0 : result.reported) {
+          /* @__PURE__ */ console.log("系统异常已上报:", result);
+        } else {
+          /* @__PURE__ */ console.log("系统异常对话框已确认");
+        }
+      }).catch((e) => {
+        /* @__PURE__ */ console.log("系统异常对话框已关闭", e);
+      });
+    } catch (error) {
+      console.error("显示系统异常对话框失败：", error);
+      console.error("系统异常信息：", errorInfo.responseData);
+    }
   }
-  handleNetworkError(error) {
-    return super.handleNetworkError(error);
+  /**
+   * 初始化 SystemErrorDialog 实例
+   * 在构造函数中调用，提前加载对话框组件
+   * @returns Promise，初始化完成后 resolve
+   */
+  async initSystemErrorDialog() {
+    try {
+      const { default: SystemErrorDialog2 } = await dynamicImports(Promise.resolve().then(() => SystemErrorDialog$1), ["default"]);
+      this.systemErrorDialogInstance = createApiDialog(SystemErrorDialog2);
+    } catch (error) {
+      console.warn("Failed to load SystemErrorDialog:", error);
+      throw error;
+    }
   }
+  /**
+   * 处理成功响应
+   * 重写父类方法，在标准 HTTP 成功响应基础上，处理业务特定的响应结构
+   * 支持嵌套路径解析，自动处理业务层的登录失效、系统异常等错误
+   * 注意：HTTP 层的错误（如 HTTP 401、超时等）由父类 BaseHttpClient 处理
+   * @param response - Axios 响应对象
+   * @returns 解析后的响应数据
+   */
   handleSuccessResponse(response) {
     const httpData = super.handleSuccessResponse(response);
     const parsedFields = this.parseResponseFields(httpData);
@@ -12539,12 +12743,18 @@ class BaseApi extends BaseHttpClient {
     const isCustomMessage = (config == null ? void 0 : config.isCustomMessage) ?? false;
     this.handleSystemError(response, code, message2, responseData);
     if (!isCustomMessage) {
-      this.handleBusinessError(code, message2, response);
+      this.handleBusinessError(code, message2);
       this.handleErrorArray(httpData, response);
       this.handleTips(httpData, response);
     }
     return responseData;
   }
+  /**
+   * 支持路径解析的辅助函数
+   * @param obj - 要解析的对象
+   * @param path - 路径字符串，支持点号分隔的嵌套路径，如 'data.errors'
+   * @returns 解析后的值，如果路径不存在则返回 undefined
+   */
   getValueByPath(obj, path) {
     if (!path)
       return obj;
@@ -12559,6 +12769,12 @@ class BaseApi extends BaseHttpClient {
     }
     return result;
   }
+  /**
+   * 解析响应字段，支持嵌套路径解析
+   * 子类可重写此方法来自定义字段解析逻辑
+   * @param data - 响应数据对象
+   * @returns 解析后的字段值对象
+   */
   parseResponseFields(data) {
     var _a2, _b, _c;
     const code = this.getValueByPath(data, (_a2 = this.responseFields) == null ? void 0 : _a2.code);
@@ -12566,17 +12782,95 @@ class BaseApi extends BaseHttpClient {
     const responseData = this.getValueByPath(data, (_c = this.responseFields) == null ? void 0 : _c.data);
     return { code, message: message2, responseData };
   }
+  /**
+   * 处理系统异常错误（-1 - 系统异常）
+   * 子类可重写此方法来自定义系统异常处理逻辑
+   * @param response - Axios 响应对象
+   * @param code - 响应状态码
+   * @param message - 错误消息
+   * @param responseData - 响应数据
+   */
   handleSystemError(response, code, message2, responseData) {
     if (code === -1) {
       if (this.enableSystemErrorDialog) {
-        this.showSystemExceptionDialog(response, responseData, code, message2).catch((error) => {
-          console.error("显示系统异常对话框失败：", error);
-        });
+        this.showSystemErrorMessage(response, responseData, code, message2);
       }
       throw new Error(message2 || "系统异常");
     }
   }
-  handleBusinessError(code, message2, response) {
+  /**
+   * 显示系统错误消息（带可点击 icon）
+   * 使用 vNode 渲染，点击 icon 后打开详细错误弹窗
+   * @param response - Axios 响应对象
+   * @param responseData - 响应数据
+   * @param code - 错误状态码
+   * @param message - 错误消息
+   */
+  showSystemErrorMessage(response, responseData, code, message2) {
+    var _a2;
+    if (!this.hasDocument) {
+      console.error("系统异常信息：", responseData);
+      return;
+    }
+    const errorId = this.generateErrorId();
+    this.systemErrorInfoMap.set(errorId, {
+      response,
+      responseData,
+      code,
+      message: message2
+    });
+    setTimeout(() => {
+      this.systemErrorInfoMap.delete(errorId);
+    }, 5 * 60 * 1e3);
+    const handleIconClick = () => {
+      this.openSystemErrorDialog(errorId).catch((error) => {
+        console.error("打开系统错误对话框失败：", error);
+      });
+    };
+    const messageVNode = h("div", {
+      style: {
+        display: "flex",
+        alignItems: "center",
+        gap: "8px",
+        maxWidth: "100%"
+      }
+    }, [
+      h("div", {
+        style: {
+          color: "var(--el-message-text-color)",
+          lineHeight: "24px"
+        }
+      }, message2 || this.systemErrorMessage),
+      h("svg", {
+        onClick: handleIconClick,
+        style: {
+          cursor: "pointer",
+          color: "#F56C6C",
+          width: "16px",
+          height: "16px",
+          flexShrink: 0
+        },
+        viewBox: "0 0 1024 1024",
+        fill: "currentColor",
+        xmlns: "http://www.w3.org/2000/svg"
+      }, [
+        h("path", {
+          d: "M512 64C264.6 64 64 264.6 64 512s200.6 448 448 448 448-200.6 448-448S759.4 64 512 64zm32 664c0 4.4-3.6 8-8 8h-48c-4.4 0-8-3.6-8-8V456c0-4.4 3.6-8 8-8h48c4.4 0 8 3.6 8 8v272zm-32-344a48.01 48.01 0 0 1 0-96 48.01 48.01 0 0 1 0 96z"
+        })
+      ])
+    ]);
+    (_a2 = this.messageInstance) == null ? void 0 : _a2.error({
+      message: messageVNode,
+      duration: 5 * 1e3
+    });
+  }
+  /**
+   * 处理业务错误（其他非200错误码）
+   * 子类可重写此方法来自定义业务错误处理逻辑
+   * @param code - 响应状态码
+   * @param message - 错误消息
+   */
+  handleBusinessError(code, message2) {
     var _a2;
     if (code && code !== 200) {
       (_a2 = this.messageInstance) == null ? void 0 : _a2.error({
@@ -12586,6 +12880,12 @@ class BaseApi extends BaseHttpClient {
       throw new Error(message2 || "请求失败");
     }
   }
+  /**
+   * 处理错误数组 errors（如果有配置）
+   * 子类可重写此方法来自定义错误数组处理逻辑
+   * @param httpData - HTTP 响应数据
+   * @param response - Axios 响应对象
+   */
   handleErrorArray(httpData, response) {
     var _a2;
     const errorsField = (_a2 = this.responseFields) == null ? void 0 : _a2.errors;
@@ -12599,14 +12899,21 @@ class BaseApi extends BaseHttpClient {
       }
     }
   }
-  showErrorArrayNotification(errors, notificationOptions) {
+  /**
+   * 显示通知的通用方法
+   * @param items - 通知项数组
+   * @param type - 通知类型
+   * @param color - HTML 颜色
+   * @param notificationOptions - 通知配置选项
+   */
+  showNotification(items, type, color, notificationOptions) {
     var _a2, _b;
-    const html = errors.map((item) => `<div style="font-size: 14px;color:red">${item.code}：${item.message}</div>`).join("");
     const defaultOptions = {
       title: "提示",
-      type: "error"
+      type
     };
-    if (hasDocument) {
+    if (this.hasDocument) {
+      const html = items.map((item) => `<div style="font-size: 14px;color:${color}">${item.code}：${item.message}</div>`).join("");
       const finalOptions = {
         ...defaultOptions,
         ...notificationOptions,
@@ -12614,15 +12921,30 @@ class BaseApi extends BaseHttpClient {
       };
       (_a2 = this.notificationInstance) == null ? void 0 : _a2.call(this, finalOptions);
     } else {
-      const errorMessages = errors.map((item) => `${item.code}：${item.message}`).join("\n");
+      const messages = items.map((item) => `${item.code}：${item.message}`).join("\n");
       const finalOptions = {
         ...defaultOptions,
         ...notificationOptions,
-        message: errorMessages
+        message: messages
       };
       (_b = this.notificationInstance) == null ? void 0 : _b.call(this, finalOptions);
     }
   }
+  /**
+   * 显示错误数组通知
+   * 子类可重写此方法来自定义错误数组通知显示方式
+   * @param errors - 错误数组
+   * @param notificationOptions - 通知配置选项
+   */
+  showErrorArrayNotification(errors, notificationOptions) {
+    this.showNotification(errors, "error", "red", notificationOptions);
+  }
+  /**
+   * 处理提示信息 tips（如果有配置）
+   * 子类可重写此方法来自定义提示信息处理逻辑
+   * @param httpData - HTTP 响应数据
+   * @param response - Axios 响应对象
+   */
   handleTips(httpData, response) {
     var _a2;
     const tipsField = (_a2 = this.responseFields) == null ? void 0 : _a2.tips;
@@ -12635,114 +12957,119 @@ class BaseApi extends BaseHttpClient {
       }
     }
   }
+  /**
+   * 显示提示信息通知
+   * 子类可重写此方法来自定义提示信息通知显示方式
+   * @param tips - 提示信息数组
+   * @param notificationOptions - 通知配置选项
+   */
   showTipsNotification(tips, notificationOptions) {
-    var _a2, _b;
-    const html = tips.map((item) => `<div style="font-size: 14px;color:#E6A23C">${item.code}：${item.message}</div>`).join("");
-    const defaultOptions = {
-      title: "提示",
-      type: "warning"
-    };
-    if (hasDocument) {
-      const finalOptions = {
-        ...defaultOptions,
-        ...notificationOptions,
-        message: html
-      };
-      (_a2 = this.notificationInstance) == null ? void 0 : _a2.call(this, finalOptions);
-    } else {
-      const tipMessages = tips.map((item) => `${item.code}：${item.message}`).join("\n");
-      const finalOptions = {
-        ...defaultOptions,
-        ...notificationOptions,
-        message: tipMessages
-      };
-      (_b = this.notificationInstance) == null ? void 0 : _b.call(this, finalOptions);
-    }
-  }
-  async showSystemExceptionDialog(response, responseData, code, message2) {
-    if (!hasDocument) {
-      console.error("系统异常信息：", responseData);
-      return;
-    }
-    try {
-      if (!systemErrorDialogInstance) {
-        try {
-          const { default: SystemErrorDialog2 } = await dynamicImports(Promise.resolve().then(() => SystemErrorDialog$1), ["default"]);
-          systemErrorDialogInstance = createApiDialog(SystemErrorDialog2);
-        } catch (error) {
-          console.warn("Failed to load SystemErrorDialog:", error);
-          console.error("系统异常信息：", responseData);
-          return;
-        }
-      }
-      const errorInfo = extractSystemErrorInfo(response, code, message2);
-      systemErrorDialogInstance.show({
-        props: {
-          title: "系统异常信息",
-          width: 600,
-          ...errorInfo
-        }
-      }).then((result) => {
-        if (result == null ? void 0 : result.reported) {
-          /* @__PURE__ */ console.log("系统异常已上报:", result);
-          this.reportError(result.errorInfo);
-        } else {
-          /* @__PURE__ */ console.log("系统异常对话框已确认");
-        }
-      }).catch((e) => {
-        /* @__PURE__ */ console.log("系统异常对话框已关闭", e);
-      });
-    } catch (error) {
-      console.error("显示系统异常对话框失败：", error);
-      console.error("系统异常信息：", responseData);
-    }
-  }
-  async reportError(errorInfo) {
-    var _a2, _b;
-    try {
-      /* @__PURE__ */ console.log("🚀 开始上报错误信息:", errorInfo);
-      /* @__PURE__ */ console.log("✅ 错误信息上报成功");
-      (_a2 = this.messageInstance) == null ? void 0 : _a2.success({
-        message: "错误信息已成功上报",
-        duration: 3 * 1e3
-      });
-    } catch (error) {
-      console.error("❌ 错误信息上报失败:", error);
-      (_b = this.messageInstance) == null ? void 0 : _b.error({
-        message: "错误信息上报失败，请稍后重试",
-        duration: 5 * 1e3
-      });
-    }
+    this.showNotification(tips, "warning", "#E6A23C", notificationOptions);
   }
+  /**
+   * 发送 HTTP 请求，所有 HTTP 方法最终都调用此方法
+   * 显式声明以确保类型一致性，子类可重写此方法
+   * @param config - Axios 请求配置对象
+   * @returns 解析后的响应数据
+   */
   async request(config) {
     return super.request(config);
   }
+  /**
+   * 发送 GET 请求
+   * 显式声明以确保类型一致性，子类可重写此方法
+   * @param url - 请求 URL 路径
+   * @param params - 查询参数对象
+   * @param config - 额外的请求配置
+   * @returns 解析后的响应数据
+   */
   async get(url, params, config) {
     return super.get(url, params, config);
   }
+  /**
+   * 发送 POST 请求
+   * 显式声明以确保类型一致性，子类可重写此方法
+   * @param url - 请求 URL 路径
+   * @param data - 请求体数据
+   * @param config - 额外的请求配置
+   * @returns 解析后的响应数据
+   */
   async post(url, data, config) {
     return super.post(url, data, config);
   }
+  /**
+   * 发送 DELETE 请求
+   * 显式声明以确保类型一致性，子类可重写此方法
+   * @param url - 请求 URL 路径
+   * @param params - 查询参数对象
+   * @param config - 额外的请求配置
+   * @returns 解析后的响应数据
+   */
   async delete(url, params, config) {
     return super.delete(url, params, config);
   }
+  /**
+   * 发送 PUT 请求
+   * 显式声明以确保类型一致性，子类可重写此方法
+   * @param url - 请求 URL 路径
+   * @param data - 请求体数据
+   * @param config - 额外的请求配置
+   * @returns 解析后的响应数据
+   */
   async put(url, data, config) {
     return super.put(url, data, config);
   }
+  /**
+   * 批量请求，并发发送多个请求
+   * 显式声明以确保类型一致性，子类可重写此方法
+   * @param requests - 请求配置数组或已发起的请求 Promise 数组
+   * @returns 所有请求的响应数据数组
+   */
   async all(requests) {
     return super.all(requests);
   }
+  /**
+   * 文件上传，将文件包装为 FormData 发送
+   * 显式声明以确保类型一致性，子类可重写此方法
+   * @param url - 上传地址
+   * @param file - 文件对象
+   * @param config - 额外的请求配置
+   * @returns 解析后的响应数据
+   */
   async uploadFile(url, file, config) {
     return super.uploadFile(url, file, config);
   }
+  /**
+   * 下载文件，将 Blob 对象下载到本地
+   * 显式声明以确保类型一致性，子类可重写此方法
+   * @param blob - Blob 对象
+   * @param filename - 文件名，如果不提供则使用时间戳
+   */
   downloadFile(blob, filename) {
     return super.downloadFile(blob, filename);
   }
-}
+};
+/**
+ * 检查是否在浏览器环境（在类初始化时判断）
+ * 注意：这是静态属性，所有实例共享
+ */
+__publicField(_BaseApi, "hasDocument", typeof document !== "undefined");
+/**
+ * 系统错误信息存储，用于在点击 icon 时打开详细错误弹窗
+ * key: 错误ID，value: 错误信息对象
+ * 注意：这是静态属性，所有实例共享同一个错误信息存储
+ */
+__publicField(_BaseApi, "systemErrorInfoMap", /* @__PURE__ */ new Map());
+let BaseApi = _BaseApi;
 function createHttpService(options = {}) {
   return new BaseApi(options);
 }
 const VueAxiosPlugin = {
+  /**
+   * 安装插件
+   * @param app - Vue 应用实例
+   * @param options - 插件配置选项
+   */
   install(app, options = {}) {
     const httpService = createHttpService(options.default ?? {});
     app.config.globalProperties.$http = httpService;
@@ -12923,10 +13250,12 @@ const SystemErrorDialog = defineComponent({
             h("span", { style: { fontWeight: "bold", fontSize: "16px" } }, props.title || "系统异常信息")
           ]),
           default: () => h("div", { style: { padding: 0, maxHeight: "500px", overflowY: "auto" } }, [
+            // 第一块：无法完成您的请求
             h("div", { style: { padding: "20px", borderBottom: "1px solid #ebeef5" } }, [
               h("h3", { style: { margin: "0 0 12px 0", fontSize: "16px", fontWeight: "bold", color: "#303133" } }, "无法完成您的请求"),
               h("p", { style: { margin: 0, color: "#606266", lineHeight: 1.5 } }, "系统在处理您的请求时遇到了问题，可能是由于服务暂时不可用。")
             ]),
+            // 第二块：技术摘要（可展开）
             h("div", { style: { borderBottom: "1px solid #ebeef5" } }, [
               h(
                 "div",
@@ -12988,6 +13317,7 @@ const SystemErrorDialog = defineComponent({
                 )
               ) : null
             ]),
+            // SkyWalking 按钮
             h("div", { style: { padding: "16px 20px", borderBottom: "1px solid #ebeef5" } }, [
               h(
                 ElButton,
@@ -12999,6 +13329,7 @@ const SystemErrorDialog = defineComponent({
                 { default: () => "📊 在SkyWalking中查看详情" }
               )
             ]),
+            // 黑色错误信息区域
             h("div", { style: { backgroundColor: "#2c3e50", color: "#fff", padding: "16px 20px", fontFamily: 'Monaco, Consolas, "Courier New", monospace', fontSize: "12px", lineHeight: 1.5, maxHeight: "200px", overflowY: "auto" } }, [
               h("div", { style: { marginBottom: "8px", color: "#ecf0f1" } }, `Trace ID: ${props.traceId || "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8"}`),
               h("div", { style: { color: "#e74c3c", fontWeight: "bold", whiteSpace: "pre-wrap" } }, `Error: ${props.errorMessage || "Connection timeout after 5000ms"}`)