@moluoxixi/ajax-package 0.0.11-beta.1

package/es/SystemErrorDialog.d.ts

@@ -0,0 +1,129 @@
+/**
+ * SystemErrorDialog 组件
+ * 使用 defineComponent 和 h 函数实现
+ */
+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<{
+    "onUpdate:modelValue"?: ((val: boolean) => any) | undefined;
+    onClose?: (() => any) | undefined;
+    onConfirm?: ((data: any) => 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,58 @@
+import { App } from 'vue';
+import { default as BaseApi } from '../class.ts';
+/**
+ * BaseApi 配置接口，用于配置 BaseApi 实例的所有选项
+ */
+export interface BaseApiConfig {
+    /** API 基础地址 */
+    baseURL?: string;
+    /** 请求超时时间（毫秒），默认 5000 */
+    timeout?: number;
+    /** 响应字段映射配置 */
+    responseFields?: {
+        /** 响应状态码字段名，默认 'Code' */
+        code?: string;
+        /** 响应消息字段名，默认 'Message' */
+        message?: string;
+        /** 响应数据字段名，默认 'data' */
+        data?: string;
+        /** 错误数组字段名 */
+        errors?: string;
+        /** 提示信息字段名 */
+        tips?: string;
+    };
+    /** 请求超时回调函数 */
+    onTimeout?: () => void;
+    /** 获取 token 的函数，每次请求前自动调用 */
+    getToken?: () => string | null;
+    /** 登录失效回调函数，当检测到 401 错误时调用 */
+    onLoginRequired?: () => void;
+    /** 是否启用 code === -1 的系统异常弹窗，默认为 true */
+    enableSystemErrorDialog?: boolean;
+    /** 允许其他任意配置项，会直接传递给 axios.create */
+    [key: string]: any;
+}
+/**
+ * Vue Axios 插件配置选项
+ */
+export interface vueAxiosPluginOptionsType {
+    /** 默认 HTTP 服务配置 */
+    default?: BaseApiConfig;
+    /** 是否在所有组件中通过 mixin 注入 $http，默认为 true */
+    globalMixin?: boolean;
+}
+/**
+ * Vue HTTP 服务类型，在 Vue 应用中通过 this.$http 或 inject('$http') 获取
+ */
+export type vueHttpServiceType = BaseApi;
+/**
+ * Vue Axios 插件类型，定义了 Vue 插件的标准接口
+ */
+export interface vueAxiosPluginType {
+    /**
+     * 安装插件
+     * @param app - Vue 应用实例
+     * @param options - 插件配置选项
+     */
+    install: (app: App, options?: vueAxiosPluginOptionsType) => void;
+}

package/es/_types/emits.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SystemErrorDialog 组件的 Emits 类型定义
+ */
+export interface SystemErrorDialogEmitsType {
+    /** v-model 更新事件 */
+    '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,27 @@
+/**
+ * SystemErrorDialog 组件的 Props 类型定义
+ */
+export interface SystemErrorDialogPropsType {
+    /** 对话框标题 */
+    title?: string;
+    /** 对话框宽度 */
+    width?: number | string;
+    /** 用户名 */
+    userName?: string;
+    /** 用户ID */
+    userId?: string;
+    /** 科室名称 */
+    deptName?: string;
+    /** 科室ID */
+    deptId?: string;
+    /** 客户端IP地址 */
+    clientIp?: string;
+    /** 请求URL路径 */
+    requestUrl?: string;
+    /** 链路追踪ID */
+    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,39 @@
+/**
+ * 创建消息实例的包装函数
+ * @returns 消息实例，支持 success、error、warning、info 方法
+ */
+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,12 @@
+/**
+ * 创建通知实例的包装函数（用于 errors / tips 展示）
+ * @returns 通知实例，支持 success、error、warning、info 方法
+ */
+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,27 @@
+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>;
+/**
+ * 从 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

@@ -0,0 +1,114 @@
+import { AxiosError, AxiosRequestConfig, AxiosResponse, InternalAxiosRequestConfig, default as axios } from 'axios';
+import { BaseApiConfig } from './_types/index.ts';
+import { MessageInstance, NotificationInstance } from './_utils/index.ts';
+/**
+ * BaseApi 类
+ * 基于 axios 封装的 HTTP 请求类，提供统一的请求处理、错误处理和响应解析
+ */
+export default class BaseApi {
+    protected baseURL: string;
+    protected timeout: number;
+    protected responseFields: Required<BaseApiConfig['responseFields']>;
+    protected onTimeout: () => void;
+    protected getToken?: () => string | null;
+    protected onLoginRequired?: () => void;
+    protected enableSystemErrorDialog: boolean;
+    instance: ReturnType<typeof axios.create>;
+    protected messageInstance: MessageInstance;
+    protected notificationInstance: NotificationInstance;
+    /**
+     * 创建 BaseApi 实例
+     * @param config - API 配置对象
+     */
+    constructor(config: BaseApiConfig);
+    /**
+     * 处理请求配置，子类可重写此方法自定义请求配置
+     * @param config - 请求配置对象
+     * @returns 处理后的请求配置
+     */
+    processRequestConfig(config: InternalAxiosRequestConfig): InternalAxiosRequestConfig<any>;
+    /**
+     * 处理响应配置，解析响应数据并处理错误
+     * 支持嵌套路径解析，自动处理登录失效、系统异常等错误
+     * @param response - Axios 响应对象
+     * @returns 解析后的响应数据
+     */
+    processResponseConfig(response: AxiosResponse): AxiosResponse['data'];
+    /**
+     * 处理响应错误，子类可重写此方法自定义错误处理
+     * @param error - Axios 错误对象
+     * @returns 处理后的错误对象
+     */
+    processResponseError(error: AxiosError): Promise<AxiosError>;
+    /**
+     * 设置请求和响应拦截器
+     * 请求拦截器：自动添加 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']>;
+    /**
+     * 显示系统异常对话框，当响应状态码为 -1 时调用
+     * @param response - Axios 响应对象
+     * @param responseData - 响应数据
+     * @param code - 错误状态码
+     * @param message - 错误消息
+     */
+    private showSystemExceptionDialog;
+    /**
+     * 上报错误信息到服务器，默认实现仅显示提示，子类可重写实现真实上报
+     * @param errorInfo - 错误信息对象
+     */
+    private reportError;
+}

package/es/index.d.ts

@@ -0,0 +1,4 @@
+import { default as BaseApi } from './class';
+import { default as VueAxiosPlugin, createHttpService, getHttpService } from './netseriver';
+export { BaseApi, createHttpService, getHttpService, VueAxiosPlugin, };
+export default getHttpService;