axios-wrapper-pro 1.0.4 → 1.0.5

package/dist/index.mjs

@@ -0,0 +1,339 @@
+// src/index.ts
+import axios2 from "axios";
+
+// src/utils.ts
+import axios from "axios";
+function isFunction(variable) {
+  return typeof variable === "function";
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isCancel(error) {
+  return axios.isCancel(error);
+}
+
+// src/config.ts
+var DEFAULT_CONFIG = {
+  baseURL: "",
+  timeout: 1e4,
+  headers: {
+    "Content-Type": "application/json;charset=utf-8"
+  }
+};
+var DEFAULT_RETRY_CONFIG = {
+  count: 0,
+  delay: 1e3,
+  condition: (error) => {
+    var _a;
+    if (isCancel(error)) return false;
+    if (!(error == null ? void 0 : error.response)) return true;
+    return ((_a = error == null ? void 0 : error.response) == null ? void 0 : _a.status) >= 500;
+  }
+};
+var DEFAULT_INTERCEPTOR = {
+  request: (config) => config,
+  requestError: (error) => Promise.reject(error),
+  response: (response) => response,
+  responseError: (error) => Promise.reject(error)
+};
+
+// src/index.ts
+var AxiosWrapperPro = class {
+  constructor(options = {}) {
+    this._abortControllers = /* @__PURE__ */ new Map();
+    this._retryConfig = {
+      ...DEFAULT_RETRY_CONFIG,
+      ...(options == null ? void 0 : options.retry) || {}
+    };
+    this._paramsSerializer = isFunction(options.paramsSerializer) ? options.paramsSerializer : null;
+    const axiosConfig = {
+      ...DEFAULT_CONFIG,
+      ...options.baseURL && { baseURL: options.baseURL },
+      ...options.timeout && { timeout: options.timeout },
+      headers: { ...DEFAULT_CONFIG.headers, ...options.headers }
+    };
+    if (this._paramsSerializer) {
+      axiosConfig.paramsSerializer = this._paramsSerializer;
+    }
+    this._instance = axios2.create(axiosConfig);
+    this._interceptorConfig = options.interceptors || {};
+    this._initRequestInterceptors();
+    this._initResponseInterceptors();
+  }
+  /**
+   * 获取拦截器配置，未配置的使用默认值
+   * @returns {InterceptorConfig} 完整的拦截器配置
+   */
+  _getInterceptors() {
+    const { request, requestError, response, responseError } = this._interceptorConfig;
+    return {
+      request: isFunction(request) ? request : DEFAULT_INTERCEPTOR.request,
+      requestError: isFunction(requestError) ? requestError : DEFAULT_INTERCEPTOR.requestError,
+      response: isFunction(response) ? response : DEFAULT_INTERCEPTOR.response,
+      responseError: isFunction(responseError) ? responseError : DEFAULT_INTERCEPTOR.responseError
+    };
+  }
+  /**
+   * 初始化请求拦截器
+   */
+  _initRequestInterceptors() {
+    const { request, requestError } = this._getInterceptors();
+    this._requestInterceptorId = this._instance.interceptors.request.use(request, requestError);
+  }
+  /**
+   * 初始化响应拦截器
+   */
+  _initResponseInterceptors() {
+    const { response, responseError } = this._getInterceptors();
+    this._responseInterceptorId = this._instance.interceptors.response.use(
+      (res) => {
+        const key = res.config._requestKey;
+        key && this._abortControllers.delete(key);
+        return response(res);
+      },
+      (error) => {
+        var _a;
+        const key = (_a = error.config) == null ? void 0 : _a._requestKey;
+        key && this._abortControllers.delete(key);
+        return responseError(error);
+      }
+    );
+  }
+  /**
+   * 设置请求拦截器，移除旧拦截器，更新拦截器配置，重新初始化拦截器
+   * @param {InterceptorConfig["request"]} interceptor 拦截器
+   * @param {InterceptorConfig["requestError"]} errorInterceptor 错误拦截器
+   */
+  setRequestInterceptor(interceptor, errorInterceptor) {
+    if (this._requestInterceptorId !== void 0) {
+      this._instance.interceptors.request.eject(this._requestInterceptorId);
+    }
+    this._interceptorConfig.request = interceptor;
+    this._interceptorConfig.requestError = errorInterceptor;
+    this._initRequestInterceptors();
+  }
+  /**
+   * 设置响应拦截器，移除旧拦截器，更新拦截器配置，重新初始化拦截器
+   * @param {InterceptorConfig["response"]} interceptor 拦截器
+   * @param {InterceptorConfig["responseError"]} errorInterceptor 错误拦截器
+   */
+  setResponseInterceptor(interceptor, errorInterceptor) {
+    if (this._responseInterceptorId !== void 0) {
+      this._instance.interceptors.response.eject(this._responseInterceptorId);
+    }
+    this._interceptorConfig.response = interceptor;
+    this._interceptorConfig.responseError = errorInterceptor;
+    this._initResponseInterceptors();
+  }
+  /**
+   * 设置取消控制器
+   * @param {AxiosRequestConfig} config 请求配置
+   * @param {RequestKey} customKey 自定义key
+   * @returns {InternalAxiosRequestConfig} 处理后的配置
+   */
+  _setupAbortController(config, customKey) {
+    const key = customKey != null ? customKey : this._generateRequestKey(config);
+    this.cancelRequest(key);
+    const controller = new AbortController();
+    this._abortControllers.set(key, controller);
+    return { ...config, signal: controller.signal, _requestKey: key };
+  }
+  /**
+   * 生成请求唯一标识
+   * @param {AxiosRequestConfig} config 请求配置
+   * @returns {string} 请求唯一标识
+   */
+  _generateRequestKey(config) {
+    const method = (config.method || "GET").toUpperCase();
+    const url = config.url || "";
+    const params = config.params ? { ...config.params } : null;
+    if (params == null ? void 0 : params._t) {
+      delete params._t;
+    }
+    const serializer = isFunction(config.paramsSerializer) ? config.paramsSerializer : this._paramsSerializer;
+    let paramsStr = "";
+    if (params) {
+      paramsStr = serializer ? serializer(params) : this._stableStringify(params);
+    }
+    let dataStr = "";
+    if (["POST", "PUT", "PATCH", "DELETE"].includes(method) && config.data) {
+      dataStr = typeof config.data === "string" ? config.data : this._stableStringify(config.data);
+    }
+    return `${method}|${url}|${paramsStr}|${dataStr}`;
+  }
+  /**
+   * 稳定的JSON序列化，确保相同内容生成相同字符串
+   * @param {any} obj 待序列化对象
+   * @returns {string} 序列化后的字符串
+   */
+  _stableStringify(obj) {
+    if (obj === null || obj === void 0) {
+      return "";
+    }
+    if (Array.isArray(obj)) {
+      return "[" + obj.map((item) => this._stableStringify(item)).join(",") + "]";
+    }
+    if (typeof obj === "object") {
+      const sortedKeys = Object.keys(obj).sort();
+      const pairs = sortedKeys.map((key) => `"${key}":${this._stableStringify(obj[key])}`);
+      return "{" + pairs.join(",") + "}";
+    }
+    return JSON.stringify(obj);
+  }
+  /**
+   * 取消指定请求
+   * @param {RequestKey} key 请求标识
+   * @param {string} [reason] 取消原因
+   * @returns {boolean} 是否成功取消
+   */
+  cancelRequest(key, reason) {
+    const controller = this._abortControllers.get(key);
+    if (controller) {
+      controller.abort(reason || "\u8BF7\u6C42\u5DF2\u53D6\u6D88");
+      this._abortControllers.delete(key);
+      return true;
+    }
+    return false;
+  }
+  /**
+   * 取消所有请求
+   * @param {string} [reason] 取消原因
+   * @returns {number} 被取消的请求数量
+   */
+  cancelAllRequests(reason) {
+    const count = this._abortControllers.size;
+    this._abortControllers.forEach((controller) => {
+      controller.abort(reason || "\u8BF7\u6C42\u5DF2\u53D6\u6D88");
+    });
+    this._abortControllers.clear();
+    return count;
+  }
+  /**
+   * 设置默认请求头
+   * @param {string} key 请求头名称
+   * @param {string} value 请求头值
+   */
+  setHeader(key, value) {
+    this._instance.defaults.headers.common[key] = value;
+  }
+  /**
+   * 批量设置请求头
+   * @param {Record<string, string>} headers 请求头对象
+   */
+  setHeaders(headers) {
+    Object.entries(headers).forEach(([key, value]) => {
+      this._instance.defaults.headers.common[key] = value;
+    });
+  }
+  /**
+   * 移除请求头
+   * @param {string} key 请求头名称
+   */
+  removeHeader(key) {
+    delete this._instance.defaults.headers.common[key];
+  }
+  /** 获取基础URL */
+  getBaseURL() {
+    return this._instance.defaults.baseURL || "";
+  }
+  /** 设置基础URL */
+  setBaseURL(url) {
+    this._instance.defaults.baseURL = url;
+  }
+  /** 获取 Axios 实例 */
+  getInstance() {
+    return this._instance;
+  }
+  /**
+   * 通用请求方法
+   * @param {string} method 请求方法
+   * @param {string} url 请求地址
+   * @param {RequestConfig} [config={}] 请求配置
+   * @returns {Promise<AxiosResponse>} 响应数据
+   */
+  async request(method, url, config = {}) {
+    const { requestKey, retry, ...restConfig } = config;
+    const retryConfig = {
+      ...this._retryConfig,
+      ...retry || {}
+    };
+    const requestConfig = { method, url, ...restConfig };
+    let lastError = null;
+    const configKey = requestKey != null ? requestKey : this._generateRequestKey(requestConfig);
+    for (let attempt = 0; attempt <= retryConfig.count; attempt++) {
+      try {
+        if (attempt > 0) {
+          this._abortControllers.delete(configKey);
+        }
+        const finalConfig = this._setupAbortController(requestConfig, configKey);
+        const result = await this._instance.request(finalConfig);
+        return result;
+      } catch (error) {
+        lastError = error;
+        this._abortControllers.delete(configKey);
+        const isLast = attempt === retryConfig.count;
+        const shouldRetry = retryConfig.condition(error);
+        const isCancelled = axios2.isCancel(error);
+        if (isLast || !shouldRetry || isCancelled) {
+          break;
+        }
+        if (retryConfig.delay > 0) {
+          await sleep(retryConfig.delay);
+        }
+      }
+    }
+    return Promise.reject(lastError);
+  }
+  /**
+   * GET请求
+   * @param {string} url 请求地址
+   * @param {RequestConfig} [options] 请求选项
+   * @returns {Promise<AxiosResponse>} 响应数据
+   */
+  get(url, options = {}) {
+    return this.request("GET", url, options);
+  }
+  /**
+   * POST请求
+   * @param {string} url 请求地址
+   * @param {any} [data] 请求数据
+   * @param {RequestConfig} [options] 其他选项
+   * @returns {Promise<AxiosResponse>} 响应数据
+   */
+  post(url, data = {}, options = {}) {
+    return this.request("POST", url, { ...options, data });
+  }
+  /**
+   * PUT请求
+   * @param {string} url 请求地址
+   * @param {any} [data] 请求数据
+   * @param {RequestConfig} [options] 其他选项
+   * @returns {Promise<AxiosResponse>} 响应数据
+   */
+  put(url, data = {}, options = {}) {
+    return this.request("PUT", url, { ...options, data });
+  }
+  /**
+   * DELETE请求
+   * @param {string} url 请求地址
+   * @param {RequestConfig} [options] 请求选项
+   * @returns {Promise<AxiosResponse>} 响应数据
+   */
+  delete(url, options = {}) {
+    return this.request("DELETE", url, options);
+  }
+  /**
+   * PATCH请求
+   * @param {string} url 请求地址
+   * @param {any} [data] 请求数据
+   * @param {RequestConfig} [options] 其他选项
+   * @returns {Promise<AxiosResponse>} 响应数据
+   */
+  patch(url, data = {}, options = {}) {
+    return this.request("PATCH", url, { ...options, data });
+  }
+};
+export {
+  AxiosWrapperPro
+};

package/dist/utils.d.ts

@@ -16,5 +16,5 @@ export declare function sleep(ms: number): Promise<void>;
  * @param {AxiosError} error 错误对象
  * @returns {boolean} 如果是axios取消请求的错误则返回true，否则返回false
  */
-export declare function isCancel(error: AxiosError<any>): error is import("axios").CanceledError<any>;
+export declare function isCancel(error: AxiosError<any>): boolean;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAE1C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,QAAQ,CAElE;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,+CAE9C"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAE1C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,QAAQ,CAElE;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,WAE9C"}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "axios-wrapper-pro",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "基于 Axios 的增强型 HTTP 客户端，支持请求去重、自动取消、重试机制和可配置拦截器",
   "scripts": {
-    "build": "tsc",
-    "build:watch": "tsc --watch",
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "build:watch": "tsup src/index.ts --format cjs,esm --dts --watch",
     "release": "npm publish",
     "test": "npm test"
   },
@@ -36,9 +36,10 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "typescript": "^5.0.0",
     "axios": "^1.6.0",
     "ts-loader": "^9.5.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.0.0",
     "webpack": "^5.90.0",
     "webpack-cli": "^5.1.0"
   }