@moluoxixi/ajax-package 0.0.16 → 0.0.17

package/es/BaseHttpClient.d.ts

@@ -0,0 +1,31 @@
+import { AxiosError, AxiosRequestConfig, AxiosResponse, InternalAxiosRequestConfig, default as axios } from 'axios';
+import { BaseHttpClientConfig } from './_types/index.ts';
+import { MessageInstance, NotificationInstance } from './_utils/index.ts';
+export default class BaseHttpClient {
+    protected baseURL: string;
+    protected timeout: number;
+    protected onTimeout: (messageInstance: MessageInstance) => void;
+    protected getToken?: () => string | null;
+    protected onLoginRequired?: (messageInstance: MessageInstance) => void;
+    instance: ReturnType<typeof axios.create>;
+    protected messageInstance: MessageInstance;
+    protected notificationInstance: NotificationInstance;
+    constructor(config: BaseHttpClientConfig);
+    processRequestConfig(config: InternalAxiosRequestConfig): InternalAxiosRequestConfig<any>;
+    processResponseConfig(response: AxiosResponse): AxiosResponse['data'];
+    protected handleHttpStatus(response: AxiosResponse): void;
+    protected handleSuccessResponse(response: AxiosResponse): AxiosResponse['data'];
+    processResponseError(error: AxiosError): Promise<AxiosError>;
+    protected handleAuthenticationError(error: AxiosError): void;
+    protected handleTimeoutError(error: AxiosError): void;
+    protected handleNetworkError(error: AxiosError): void;
+    private setupInterceptors;
+    protected request<R>(config: AxiosRequestConfig): Promise<AxiosResponse['data']>;
+    get<R>(url: string, params?: Record<string, any>, config?: AxiosRequestConfig): Promise<AxiosResponse['data']>;
+    post<R>(url: string, data?: Record<string, any>, config?: AxiosRequestConfig): Promise<AxiosResponse['data']>;
+    delete<R>(url: string, params?: Record<string, any>, config?: AxiosRequestConfig): Promise<AxiosResponse['data']>;
+    put<R>(url: string, data?: Record<string, any>, config?: AxiosRequestConfig): Promise<AxiosResponse['data']>;
+    all<R>(requests: Array<AxiosRequestConfig | Promise<AxiosResponse<R>>>): Promise<AxiosResponse['data'][]>;
+    uploadFile<R>(url: string, file: File | Blob, config?: AxiosRequestConfig): Promise<AxiosResponse['data']>;
+    downloadFile(blob: Blob, filename?: string): void;
+}

package/es/SystemErrorDialog.d.ts

@@ -0,0 +1,125 @@
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    title: {
+        type: StringConstructor;
+        default: string;
+    };
+    width: {
+        type: (StringConstructor | NumberConstructor)[];
+        default: number;
+    };
+    userName: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    userId: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    deptName: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    deptId: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    clientIp: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    requestUrl: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    traceId: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    errorMessage: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    errorCode: {
+        type: (StringConstructor | NumberConstructor)[];
+        default: undefined;
+    };
+    modelValue: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    'update:modelValue': (val: boolean) => true;
+    close: () => true;
+    confirm: (data: any) => true;
+    report: () => true;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    title: {
+        type: StringConstructor;
+        default: string;
+    };
+    width: {
+        type: (StringConstructor | NumberConstructor)[];
+        default: number;
+    };
+    userName: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    userId: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    deptName: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    deptId: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    clientIp: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    requestUrl: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    traceId: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    errorMessage: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    errorCode: {
+        type: (StringConstructor | NumberConstructor)[];
+        default: undefined;
+    };
+    modelValue: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>> & Readonly<{
+    onClose?: (() => any) | undefined;
+    onConfirm?: ((data: any) => any) | undefined;
+    "onUpdate:modelValue"?: ((val: boolean) => any) | undefined;
+    onReport?: (() => any) | undefined;
+}>, {
+    title: string;
+    width: string | number;
+    userName: string;
+    userId: string;
+    deptName: string;
+    deptId: string;
+    clientIp: string;
+    requestUrl: string;
+    traceId: string;
+    errorMessage: string;
+    errorCode: string | number;
+    modelValue: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/es/_types/api.d.ts

@@ -0,0 +1,82 @@
+import { AxiosRequestConfig } from 'axios';
+import { App } from 'vue';
+import { MessageInstance } from '../_utils/index.ts';
+import { default as BaseApi } from '../class.ts';
+export interface BaseHttpClientConfig {
+    baseURL?: string;
+    timeout?: number;
+    onTimeout?: (messageInstance: MessageInstance) => void;
+    getToken?: () => string | null;
+    onLoginRequired?: (messageInstance: MessageInstance) => void;
+    [key: string]: any;
+}
+export interface BaseApiConfig extends BaseHttpClientConfig {
+    responseFields?: {
+        code?: string;
+        message?: string;
+        data?: string;
+        errors?: string;
+        tips?: string;
+    };
+    enableSystemErrorDialog?: boolean;
+}
+export interface vueAxiosPluginOptionsType {
+    default?: BaseApiConfig;
+    globalMixin?: boolean;
+}
+export type vueHttpServiceType = BaseApi;
+export interface vueAxiosPluginType {
+    install: (app: App, options?: vueAxiosPluginOptionsType) => void;
+}
+/**
+ * 通知配置选项
+ */
+export interface NotificationOptions {
+    /**
+     * 通知标题
+     */
+    title?: string;
+    /**
+     * 通知类型
+     */
+    type?: 'success' | 'error' | 'warning' | 'info';
+    /**
+     * 通知持续时间（毫秒）
+     */
+    duration?: number;
+    /**
+     * 是否显示关闭按钮
+     */
+    showClose?: boolean;
+    /**
+     * 自定义类名
+     */
+    customClass?: string;
+    /**
+     * 自定义样式
+     */
+    customStyle?: string | Record<string, any>;
+    /**
+     * 其他通知选项
+     */
+    [key: string]: any;
+}
+/**
+ * 扩展 AxiosRequestConfig，支持自定义通知配置
+ */
+export interface ExtendedAxiosRequestConfig extends AxiosRequestConfig {
+    /**
+     * 错误通知配置选项，用于覆盖默认的错误通知参数
+     */
+    errorNotificationOptions?: NotificationOptions;
+    /**
+     * 提示通知配置选项，用于覆盖默认的提示通知参数
+     */
+    tipsNotificationOptions?: NotificationOptions;
+    /**
+     * 是否使用自定义消息处理
+     * 当为 true 时，handleBusinessError、handleErrorArray、handleTips 都不会执行
+     * 默认值为 false
+     */
+    isCustomMessage?: boolean;
+}

package/es/_types/emits.d.ts

@@ -0,0 +1,6 @@
+export interface SystemErrorDialogEmitsType {
+    'update:modelValue': [val: boolean];
+    'close': [];
+    'confirm': [data: any];
+    'report': [];
+}

package/es/_types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './api.ts';
+export * from './emits.ts';
+export type { SystemErrorDialogEmitsType } from './emits.ts';
+export * from './props.ts';

package/es/_types/props.d.ts

@@ -0,0 +1,13 @@
+export interface SystemErrorDialogPropsType {
+    title?: string;
+    width?: number | string;
+    userName?: string;
+    userId?: string;
+    deptName?: string;
+    deptId?: string;
+    clientIp?: string;
+    requestUrl?: string;
+    traceId?: string;
+    errorMessage?: string;
+    errorCode?: number | string;
+}

package/es/_utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './messageWrapper.ts';
+export * from './notificationWrapper.ts';
+export * from './systemErrorInfo.ts';

package/es/_utils/messageWrapper.d.ts

@@ -0,0 +1,35 @@
+export declare function createMessageWrapper(): (import('element-plus').MessageFn & {
+    primary: import('element-plus').MessageTypedFn;
+    success: import('element-plus').MessageTypedFn;
+    warning: import('element-plus').MessageTypedFn;
+    info: import('element-plus').MessageTypedFn;
+    error: import('element-plus').MessageTypedFn;
+} & import('vue').ObjectPlugin<any[]> & {
+    _context: import('vue').AppContext | null;
+}) | (import('element-plus').MessageFn & {
+    primary: import('element-plus').MessageTypedFn;
+    success: import('element-plus').MessageTypedFn;
+    warning: import('element-plus').MessageTypedFn;
+    info: import('element-plus').MessageTypedFn;
+    error: import('element-plus').MessageTypedFn;
+} & ((app: import('vue').App, ...options: any[]) => any) & Partial<import('vue').ObjectPlugin<any[]>> & {
+    _context: import('vue').AppContext | null;
+}) | {
+    success: (options: string | {
+        message?: string;
+        [key: string]: any;
+    }) => void;
+    error: (options: string | {
+        message?: string;
+        [key: string]: any;
+    }) => void;
+    warning: (options: string | {
+        message?: string;
+        [key: string]: any;
+    }) => void;
+    info: (options: string | {
+        message?: string;
+        [key: string]: any;
+    }) => void;
+};
+export type MessageInstance = ReturnType<typeof createMessageWrapper>;

package/es/_utils/notificationWrapper.d.ts

@@ -0,0 +1,8 @@
+export declare function createNotificationWrapper(): ((import('element-plus').Notify & import('vue').Plugin) & {
+    _context: import('vue').AppContext | null;
+}) | ((options: string | {
+    message?: string;
+    title?: string;
+    type?: "success" | "error" | "warning" | "info";
+}) => void);
+export type NotificationInstance = ReturnType<typeof createNotificationWrapper>;

package/es/_utils/systemErrorInfo.d.ts

@@ -0,0 +1,6 @@
+import { AxiosResponse } from 'axios';
+import { SystemErrorDialogPropsType } from '../_types/index.ts';
+export declare function normalizePayload(payload: any): Record<string, any>;
+export declare function resolveTraceId(headers: AxiosResponse['headers'] | undefined): string;
+export declare function getUserInfoFromLocalStorage(): Record<string, any>;
+export declare function extractSystemErrorInfo(response: AxiosResponse, code: number, message: string): Omit<SystemErrorDialogPropsType, 'title' | 'width'>;

package/es/class.d.ts

@@ -0,0 +1,44 @@
+import { AxiosError, AxiosResponse, InternalAxiosRequestConfig } from 'axios';
+import { BaseApiConfig, ExtendedAxiosRequestConfig, NotificationOptions } from './_types/index.ts';
+import { default as BaseHttpClient } from './BaseHttpClient.ts';
+export default class BaseApi extends BaseHttpClient {
+    protected responseFields: Required<BaseApiConfig['responseFields']>;
+    protected enableSystemErrorDialog: boolean;
+    constructor(config: BaseApiConfig);
+    processRequestConfig(config: InternalAxiosRequestConfig): InternalAxiosRequestConfig;
+    processResponseConfig(response: AxiosResponse): AxiosResponse['data'];
+    processResponseError(error: AxiosError): Promise<AxiosError>;
+    protected handleHttpStatus(response: AxiosResponse): void;
+    protected handleAuthenticationError(error: AxiosError): void;
+    protected handleTimeoutError(error: AxiosError): void;
+    protected handleNetworkError(error: AxiosError): void;
+    protected handleSuccessResponse(response: AxiosResponse): AxiosResponse['data'];
+    protected getValueByPath(obj: any, path: string | undefined): any;
+    protected parseResponseFields(data: any): {
+        code: any;
+        message: any;
+        responseData: any;
+    };
+    protected handleSystemError(response: AxiosResponse, code: any, message: any, responseData: any): void;
+    protected handleBusinessError(code: any, message: any, response: AxiosResponse): void;
+    protected handleErrorArray(httpData: any, response: AxiosResponse): void;
+    protected showErrorArrayNotification(errors: Array<{
+        code: string;
+        message: string;
+    }>, notificationOptions?: NotificationOptions): void;
+    protected handleTips(httpData: any, response: AxiosResponse): void;
+    protected showTipsNotification(tips: Array<{
+        code: string;
+        message: string;
+    }>, notificationOptions?: NotificationOptions): void;
+    private showSystemExceptionDialog;
+    protected reportError(errorInfo: any): Promise<void>;
+    protected request<R>(config: ExtendedAxiosRequestConfig): Promise<AxiosResponse['data']>;
+    get<R>(url: string, params?: Record<string, any>, config?: ExtendedAxiosRequestConfig): Promise<AxiosResponse['data']>;
+    post<R>(url: string, data?: Record<string, any>, config?: ExtendedAxiosRequestConfig): Promise<AxiosResponse['data']>;
+    delete<R>(url: string, params?: Record<string, any>, config?: ExtendedAxiosRequestConfig): Promise<AxiosResponse['data']>;
+    put<R>(url: string, data?: Record<string, any>, config?: ExtendedAxiosRequestConfig): Promise<AxiosResponse['data']>;
+    all<R>(requests: Array<ExtendedAxiosRequestConfig | Promise<AxiosResponse<R>>>): Promise<AxiosResponse['data'][]>;
+    uploadFile<R>(url: string, file: File | Blob, config?: ExtendedAxiosRequestConfig): Promise<AxiosResponse['data']>;
+    downloadFile(blob: Blob, filename?: string): void;
+}

package/es/index.d.ts

@@ -0,0 +1,6 @@
+import { default as BaseHttpClient } from './BaseHttpClient.ts';
+import { default as BaseApi } from './class.ts';
+import { default as VueAxiosPlugin, createHttpService, getHttpService } from './netseriver.ts';
+export { BaseApi, BaseHttpClient, createHttpService, getHttpService, VueAxiosPlugin, };
+export type { BaseApiConfig, BaseHttpClientConfig, vueAxiosPluginOptionsType, vueAxiosPluginType, vueHttpServiceType, } from './_types/index.ts';
+export default getHttpService;

package/es/index.mjs

@@ -2,9 +2,9 @@
   "use strict";
   try {
     if (typeof document !== "undefined") {
-      if (!document.getElementById("14c6052f-e4ae-4502-9336-1f25c81ac076")) {
+      if (!document.getElementById("75b05bee-ad6e-4470-b902-2118b507f825")) {
         var elementStyle = document.createElement("style");
-        elementStyle.id = "14c6052f-e4ae-4502-9336-1f25c81ac076";
+        elementStyle.id = "75b05bee-ad6e-4470-b902-2118b507f825";
         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);
       }
@@ -12183,10 +12183,6 @@ function defaultGetToken() {
   return typeof localStorage !== "undefined" ? localStorage.getItem("token") || "" : "";
 }
 class BaseHttpClient {
-  /**
-   * 创建 BaseHttpClient 实例
-   * @param config - HTTP 客户端配置对象
-   */
   constructor(config) {
     __publicField(this, "baseURL", "");
     __publicField(this, "timeout", 5e3);
@@ -12216,86 +12212,42 @@ 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") {
@@ -12306,11 +12258,6 @@ class BaseHttpClient {
       });
     }
   }
-  /**
-   * 设置请求和响应拦截器
-   * 请求拦截器：自动添加 Token
-   * 响应拦截器：处理成功响应和错误响应（401、超时等）
-   */
   setupInterceptors() {
     this.instance.interceptors.request.use(
       (config) => {
@@ -12337,59 +12284,21 @@ 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 [];
@@ -12402,13 +12311,6 @@ 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);
@@ -12420,11 +12322,6 @@ class BaseHttpClient {
       }
     });
   }
-  /**
-   * 下载文件，将 Blob 对象下载到本地
-   * @param blob - Blob 对象
-   * @param filename - 文件名，如果不提供则使用时间戳
-   */
   downloadFile(blob, filename) {
     if (typeof window === "undefined") {
       console.warn("downloadFile: 非浏览器环境，无法下载文件");
@@ -12540,12 +12437,10 @@ function createApiDialog(DialogComponent) {
               cleanup();
             }
           },
-          // 监听关闭事件
           onClose: () => {
             reject(new Error("对话框已关闭"));
             cleanup();
           },
-          // 监听确认事件（如有）
           onConfirm: (data) => {
             resolve(data);
             cleanup();
@@ -12596,10 +12491,6 @@ function createApiDialog(DialogComponent) {
 const hasDocument = typeof document !== "undefined";
 let systemErrorDialogInstance = null;
 class BaseApi extends BaseHttpClient {
-  /**
-   * 创建 BaseApi 实例
-   * @param config - API 配置对象
-   */
   constructor(config) {
     const {
       responseFields,
@@ -12613,125 +12504,68 @@ class BaseApi extends BaseHttpClient {
       code: "Code",
       message: "Message",
       data: "data",
-      errors: "errors",
-      tips: "tips",
+      errors: "data.errors",
+      tips: "data.tips",
       ...responseFields
     };
     this.enableSystemErrorDialog = enableSystemErrorDialog;
   }
-  /**
-   * 处理请求配置，子类可重写此方法自定义请求配置
-   * 显式声明以确保类型一致性，避免打包后的类型不兼容问题
-   * @param config - 请求配置对象
-   * @returns 处理后的请求配置
-   */
   processRequestConfig(config) {
     return super.processRequestConfig(config);
   }
-  /**
-   * 处理响应配置，子类可重写此方法自定义响应处理
-   * 显式声明以确保类型一致性，避免打包后的类型不兼容问题
-   * @param response - Axios 响应对象
-   * @returns 解析后的响应数据
-   */
   processResponseConfig(response) {
     return super.processResponseConfig(response);
   }
-  /**
-   * 处理响应错误，子类可重写此方法自定义错误处理
-   * 显式声明以确保类型一致性，避免打包后的类型不兼容问题
-   * @param error - Axios 错误对象
-   * @returns 处理后的错误对象
-   */
   async processResponseError(error) {
     return super.processResponseError(error);
   }
-  /**
-   * 处理 HTTP 状态码
-   * 重写父类方法，确保子类可以重写此方法
-   * @param response - Axios 响应对象
-   */
   handleHttpStatus(response) {
     return super.handleHttpStatus(response);
   }
-  /**
-   * 处理认证错误（401 - 未授权/登录失效）
-   * 重写父类方法，处理 HTTP 401 错误
-   * 子类可重写此方法来自定义 HTTP 认证错误处理逻辑
-   * @param error - Axios 错误对象
-   */
   handleAuthenticationError(error) {
     super.handleAuthenticationError(error);
   }
-  /**
-   * 处理超时错误
-   * 重写父类方法，确保子类可以重写此方法
-   * @param error - Axios 错误对象
-   */
   handleTimeoutError(error) {
     return super.handleTimeoutError(error);
   }
-  /**
-   * 处理网络错误（其他错误）
-   * 重写父类方法，确保子类可以重写此方法
-   * @param error - Axios 错误对象
-   */
   handleNetworkError(error) {
     return super.handleNetworkError(error);
   }
-  /**
-   * 处理成功响应
-   * 重写父类方法，在标准 HTTP 成功响应基础上，处理业务特定的响应结构
-   * 支持嵌套路径解析，自动处理业务层的登录失效、系统异常等错误
-   * 注意：HTTP 层的错误（如 HTTP 401、超时等）由父类 BaseHttpClient 处理
-   * @param response - Axios 响应对象
-   * @returns 解析后的响应数据
-   */
   handleSuccessResponse(response) {
     const httpData = super.handleSuccessResponse(response);
     const parsedFields = this.parseResponseFields(httpData);
     const { code, message: message2, responseData } = parsedFields;
+    const config = response.config;
+    const isCustomMessage = (config == null ? void 0 : config.isCustomMessage) ?? false;
     this.handleSystemError(response, code, message2, responseData);
-    this.handleBusinessError(code, message2);
-    this.handleErrorArray(responseData);
-    this.handleTips(responseData);
+    if (!isCustomMessage) {
+      this.handleBusinessError(code, message2, response);
+      this.handleErrorArray(httpData, response);
+      this.handleTips(httpData, response);
+    }
     return responseData;
   }
-  /**
-   * 解析响应字段，支持嵌套路径解析
-   * 子类可重写此方法来自定义字段解析逻辑
-   * @param data - 响应数据对象
-   * @returns 解析后的字段值对象
-   */
+  getValueByPath(obj, path) {
+    if (!path)
+      return obj;
+    const keys = path.split(".");
+    let result = obj;
+    for (const key of keys) {
+      if (result && typeof result === "object" && key in result) {
+        result = result[key];
+      } else {
+        return void 0;
+      }
+    }
+    return result;
+  }
   parseResponseFields(data) {
     var _a2, _b, _c;
-    const getValueByPath = (obj, path) => {
-      if (!path)
-        return obj;
-      const keys = path.split(".");
-      let result = obj;
-      for (const key of keys) {
-        if (result && typeof result === "object" && key in result) {
-          result = result[key];
-        } else {
-          return void 0;
-        }
-      }
-      return result;
-    };
-    const code = getValueByPath(data, (_a2 = this.responseFields) == null ? void 0 : _a2.code);
-    const message2 = getValueByPath(data, (_b = this.responseFields) == null ? void 0 : _b.message);
-    const responseData = getValueByPath(data, (_c = this.responseFields) == null ? void 0 : _c.data);
+    const code = this.getValueByPath(data, (_a2 = this.responseFields) == null ? void 0 : _a2.code);
+    const message2 = this.getValueByPath(data, (_b = this.responseFields) == null ? void 0 : _b.message);
+    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) {
@@ -12742,13 +12576,7 @@ class BaseApi extends BaseHttpClient {
       throw new Error(message2 || "系统异常");
     }
   }
-  /**
-   * 处理业务错误（其他非200错误码）
-   * 子类可重写此方法来自定义业务错误处理逻辑
-   * @param code - 响应状态码
-   * @param message - 错误消息
-   */
-  handleBusinessError(code, message2) {
+  handleBusinessError(code, message2, response) {
     var _a2;
     if (code && code !== 200) {
       (_a2 = this.messageInstance) == null ? void 0 : _a2.error({
@@ -12758,90 +12586,79 @@ class BaseApi extends BaseHttpClient {
       throw new Error(message2 || "请求失败");
     }
   }
-  /**
-   * 处理错误数组 errors（如果有配置）
-   * 子类可重写此方法来自定义错误数组处理逻辑
-   * @param responseData - 响应数据
-   */
-  handleErrorArray(responseData) {
+  handleErrorArray(httpData, response) {
     var _a2;
     const errorsField = (_a2 = this.responseFields) == null ? void 0 : _a2.errors;
     if (errorsField) {
-      const errors = responseData == null ? void 0 : responseData[errorsField];
+      const errors = this.getValueByPath(httpData, errorsField);
       if (Array.isArray(errors) && errors.length) {
-        this.showErrorArrayNotification(errors);
+        const config = response.config;
+        const notificationOptions = config == null ? void 0 : config.errorNotificationOptions;
+        this.showErrorArrayNotification(errors, notificationOptions);
         throw new Error("请求错误");
       }
     }
   }
-  /**
-   * 显示错误数组通知
-   * 子类可重写此方法来自定义错误数组通知显示方式
-   * @param errors - 错误数组
-   */
-  showErrorArrayNotification(errors) {
+  showErrorArrayNotification(errors, 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"
+    };
     if (hasDocument) {
-      (_a2 = this.notificationInstance) == null ? void 0 : _a2.call(this, {
-        title: "提示",
-        message: html,
-        type: "error"
-      });
+      const finalOptions = {
+        ...defaultOptions,
+        ...notificationOptions,
+        message: html
+      };
+      (_a2 = this.notificationInstance) == null ? void 0 : _a2.call(this, finalOptions);
     } else {
       const errorMessages = errors.map((item) => `${item.code}：${item.message}`).join("\n");
-      (_b = this.notificationInstance) == null ? void 0 : _b.call(this, {
-        title: "提示",
-        message: errorMessages,
-        type: "error"
-      });
+      const finalOptions = {
+        ...defaultOptions,
+        ...notificationOptions,
+        message: errorMessages
+      };
+      (_b = this.notificationInstance) == null ? void 0 : _b.call(this, finalOptions);
     }
   }
-  /**
-   * 处理提示信息 tips（如果有配置）
-   * 子类可重写此方法来自定义提示信息处理逻辑
-   * @param responseData - 响应数据
-   */
-  handleTips(responseData) {
+  handleTips(httpData, response) {
     var _a2;
     const tipsField = (_a2 = this.responseFields) == null ? void 0 : _a2.tips;
     if (tipsField) {
-      const tips = responseData == null ? void 0 : responseData[tipsField];
+      const tips = this.getValueByPath(httpData, tipsField);
       if (Array.isArray(tips) && tips.length) {
-        this.showTipsNotification(tips);
+        const config = response.config;
+        const notificationOptions = config == null ? void 0 : config.tipsNotificationOptions;
+        this.showTipsNotification(tips, notificationOptions);
       }
     }
   }
-  /**
-   * 显示提示信息通知
-   * 子类可重写此方法来自定义提示信息通知显示方式
-   * @param tips - 提示信息数组
-   */
-  showTipsNotification(tips) {
+  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) {
-      (_a2 = this.notificationInstance) == null ? void 0 : _a2.call(this, {
-        title: "提示",
-        message: html,
-        type: "warning"
-      });
+      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");
-      (_b = this.notificationInstance) == null ? void 0 : _b.call(this, {
-        title: "提示",
-        message: tipMessages,
-        type: "warning"
-      });
+      const finalOptions = {
+        ...defaultOptions,
+        ...notificationOptions,
+        message: tipMessages
+      };
+      (_b = this.notificationInstance) == null ? void 0 : _b.call(this, finalOptions);
     }
   }
-  /**
-   * 显示系统异常对话框，当响应状态码为 -1 时调用
-   * @param response - Axios 响应对象
-   * @param responseData - 响应数据
-   * @param code - 错误状态码
-   * @param message - 错误消息
-   */
   async showSystemExceptionDialog(response, responseData, code, message2) {
     if (!hasDocument) {
       console.error("系统异常信息：", responseData);
@@ -12880,10 +12697,6 @@ class BaseApi extends BaseHttpClient {
       console.error("系统异常信息：", responseData);
     }
   }
-  /**
-   * 上报错误信息到服务器，默认实现仅显示提示，子类可重写实现真实上报
-   * @param errorInfo - 错误信息对象
-   */
   async reportError(errorInfo) {
     var _a2, _b;
     try {
@@ -12901,85 +12714,27 @@ class BaseApi extends BaseHttpClient {
       });
     }
   }
-  /**
-   * 发送 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);
   }
@@ -12988,11 +12743,6 @@ 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;
@@ -13173,12 +12923,10 @@ 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",
@@ -13240,7 +12988,6 @@ const SystemErrorDialog = defineComponent({
                 )
               ) : null
             ]),
-            // SkyWalking 按钮
             h("div", { style: { padding: "16px 20px", borderBottom: "1px solid #ebeef5" } }, [
               h(
                 ElButton,
@@ -13252,7 +12999,6 @@ 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"}`)

package/es/netseriver.d.ts

@@ -0,0 +1,12 @@
+import { BaseApiConfig, vueAxiosPluginType, vueHttpServiceType } from './_types/index.ts';
+import { default as BaseApi } from './class.ts';
+declare global {
+    interface Window {
+        $http?: vueHttpServiceType;
+    }
+}
+declare function createHttpService(options?: BaseApiConfig): BaseApi;
+declare const VueAxiosPlugin: vueAxiosPluginType;
+declare function getHttpService(options?: BaseApiConfig): BaseApi;
+export default VueAxiosPlugin;
+export { createHttpService, getHttpService };

package/es/test/service.d.ts

@@ -0,0 +1,40 @@
+export default service;
+/**
+ * 创建 axios 实例
+ * @type {NewApi}
+ */
+declare const service: NewApi;
+/**
+ * 自定义 API 类，继承自 BaseApi
+ * 实现了原有的 axios 封装功能
+ */
+export class NewApi {
+    constructor(config?: {});
+    /**
+     * 处理请求配置
+     * 在请求发送之前进行一些处理
+     * 对应旧代码的请求拦截器逻辑
+     */
+    processRequestConfig(config: any): any;
+    /**
+     * 处理 HTTP 状态码
+     */
+    handleHttpStatus(response: any): void;
+    /**
+     * 处理业务错误（重写父类方法，不抛出错误，只显示消息）
+     */
+    handleBusinessError(code: any, message: any): void;
+    /**
+     * 处理成功响应（完全重写，符合旧代码逻辑）
+     */
+    handleSuccessResponse(response: any): any;
+    /**
+     * 处理超时错误（重写父类方法）
+     */
+    handleTimeoutError(error: any): void;
+    /**
+     * 处理网络错误（重写父类方法）
+     */
+    handleNetworkError(error: any): void;
+}
+export function showErrorNotification(title: any, errors: any): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moluoxixi/ajax-package",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "description": "AjaxPackage 组件",
   "sideEffects": [
     "*.css",