@infly/libs 2.0.43 → 2.0.44

package/module/REST.js

@@ -1,7 +1,23 @@
+/**
+ * REST HTTP 客户端（Vue 2 / axios 生态）
+ *
+ * ⚠️  本模块是 Vue 2 生态专用 axios 封装（依赖 process.env.VUE_APP_BASE_API、
+ *     window.location、TokenService），与 @infly/ts-libs 的 createHttpClient
+ *     （框架无关 fetch 客户端）是并行实现，非代码重复。
+ *
+ *     新项目（React/非 Vue 生态）请使用 @infly/ts-libs createHttpClient。
+ */
 import axios from "axios";
 import Uts from "./Uts.js";
 import TokenService from "./TokenService.js";
-import { resolveInternalServiceURL } from "./cjs/request-url-rules.cjs";
+import {
+  matchesConfiguredBaseURL,
+  resolveInternalServiceURL
+} from "./cjs/request-url-rules.cjs";
+import {
+  normalizeErrorPayload,
+  resolveStatusErrorMessage
+} from "./cjs/rest-error-rules.cjs";
 
 const baseURL = process.env.VUE_APP_BASE_API;
 const { env } = Uts.getEnv() || {};
@@ -28,7 +44,7 @@ function remapLocalhostToCurrentHost(url) {
 
     parsed.hostname = window.location.hostname;
     return parsed.toString();
-  } catch (e) {
+  } catch {
     return normalized;
   }
 }
@@ -66,6 +82,7 @@ export function createNotifyDedup(fn, ttl = 500) {
  * @param {Function} config.onLogout 登出回调
  * @param {Object} config.notify  Message-like 对象（如 ElementUI Message），传入后自动应用去重并构建 onNotify
  * @param {Function} config.onNotify 自定义通知回调；若传入 Message-like 对象也可自动识别
+ * @param {String[]} config.productionBaseURLs 由应用注入的正式 API 基地址；测试环境命中时告警
  * @returns {AxiosInstance}
  */
 export function createService(config) {
@@ -78,11 +95,12 @@ export function createService(config) {
     notify,
     onNotify: rawOnNotify,
     getTokenFunc = "getToken",
-    internalServiceURLRules = []
+    internalServiceURLRules = [],
+    productionBaseURLs = []
   } = config || {};
   // 统一在 REST 内部处理 baseURL，避免业务项目重复实现主机替换逻辑。
   const resolvedBaseURL = resolveServiceBaseURL(customBaseURL);
-  const isProdAPI = Uts.contain(["https://api.sutpay.com"], resolvedBaseURL);
+  const isProdAPI = matchesConfiguredBaseURL(resolvedBaseURL, productionBaseURLs);
   const service = axios.create({ baseURL: resolvedBaseURL });
 
   // 统一处理 notify 与 onNotify：
@@ -165,27 +183,21 @@ export function createService(config) {
     (error) => {
       const { response, request } = error || {};
       const { status, data } = response || {};
-      const { error: bufferError } = Uts.transArrayBufferToObj(data) ?? {};
-      const { error: dataError, detail, message } = data || {};
-      const errorMsg = bufferError || dataError || detail || message || `请求失败(${status})`;
+      const normalizedData = Uts.transArrayBufferToObj(data);
+      const backendErrorMsg = normalizeErrorPayload(normalizedData);
+      const errorMsg = backendErrorMsg || `请求失败(${status})`;
+
+      // 让仍按 data.error 读取错误的旧调用方也能兼容 detail/message/msg 返回。
+      if (response && normalizedData !== undefined) {
+        response.data = normalizedData;
+      }
 
       // 添加标识，表示错误已被拦截器处理
       error.handledByInterceptor = true;
 
-      // HTTP 状态码 → 固定提示语映射（400 直接用后端返回的 errorMsg）
-      const STATUS_MESSAGES = {
-        400: errorMsg,
-        401: "登录信息已过期，请重新登录",
-        403: "您没有权限访问，请联系管理员",
-        500: errorMsg || "服务器内部错误，请联系开发人员",
-        502: "网关错误，请稍后重试或联系开发人员",
-        503: "服务暂时不可用，请稍后重试",
-        504: "网关超时，请稍后重试或联系开发人员"
-      };
-
       // 按优先级确定最终提示语，合并为一次 handleNotify 调用
       const notifyMsg =
-        STATUS_MESSAGES[status] ??
+        resolveStatusErrorMessage(status, normalizedData) ??
         (response ? errorMsg : null) ??
         (request ? "网络请求失败，请检查网络连接" : null) ??
         (error.message || "请求配置错误");

package/module/TokenService.js

@@ -1,3 +1,12 @@
+/**
+ * Token 服务（Vue 2 / localStorage 生态）
+ *
+ * ⚠️  本模块是 Vue 2 生态专用（localStorage + cookie + 多 key 支持），
+ *     与 @infly/ts-libs 的 createStorageTokenStore（框架无关 Token 抽象）
+ *     是并行实现，非代码重复。
+ *
+ *     新项目（React/非 Vue 生态）请使用 @infly/ts-libs createStorageTokenStore。
+ */
 // TokenService.js
 import Uts from "./Uts"; // 假设Uts工具类在同级目录或可访问路径