xxf_react 0.7.6 → 0.7.7

package/dist/http/interceptor/DefaultCacheInterceptor.d.ts

@@ -2,14 +2,19 @@
  * 全局缓存拦截器
  * 用于 xxf_react/http 的 ApiBuilder
  */
-import { CacheInterceptor } from "./CacheInterceptor";
+import { CacheInterceptor } from './CacheInterceptor';
 /**
  * 默认缓存拦截器
+ *
  * 只有满足以下条件才缓存：
  * - HTTP 状态码 = 200
- * - Content-Type 包含 application/json
- * - data 是有效对象
- * - ApiResponse.code = 0 或 200
+ * - Content-Type 包含 application/json（不区分大小写）
+ * - data 是有效对象或数组
+ * - ApiResponse.code 存在且为成功值（0 或 200）
+ *
+ * 特殊处理：
+ * - code 字段支持 number 或 string 类型
+ * - 所有检查都有异常保护，异常时默认不缓存
  *
  * @example
  * ```ts
@@ -22,17 +27,26 @@ import { CacheInterceptor } from "./CacheInterceptor";
 export declare const defaultCacheInterceptor: CacheInterceptor;
 /**
  * 创建自定义缓存拦截器
- * 在默认检查基础上添加自定义逻辑
+ *
+ * 在默认检查基础上添加自定义逻辑。
+ * 默认检查通过后才会执行自定义检查。
  *
  * @param customCheck 自定义检查函数，在默认检查通过后执行
+ * @returns 组合后的缓存拦截器
  *
  * @example
  * ```ts
+ * // 额外检查：只缓存有 data 字段的响应
  * const myInterceptor = createCacheInterceptor((ctx) => {
- *     // 额外检查：只缓存有 data 字段的响应
  *     const res = ctx.data as { data?: unknown }
  *     return res.data !== undefined
  * })
+ *
+ * // 额外检查：只缓存列表数据
+ * const listInterceptor = createCacheInterceptor((ctx) => {
+ *     const res = ctx.data as { data?: unknown[] }
+ *     return Array.isArray(res.data) && res.data.length > 0
+ * })
  * ```
  */
 export declare function createCacheInterceptor(customCheck?: (ctx: Parameters<CacheInterceptor>[0]) => boolean): CacheInterceptor;

package/dist/http/interceptor/DefaultCacheInterceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultCacheInterceptor.d.ts","sourceRoot":"","sources":["../../../src/http/interceptor/DefaultCacheInterceptor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAkBrC,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAClC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,GAChE,gBAAgB,CASlB"}
+{"version":3,"file":"DefaultCacheInterceptor.d.ts","sourceRoot":"","sources":["../../../src/http/interceptor/DefaultCacheInterceptor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAGrD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAuCrC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CAClC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,GAChE,gBAAgB,CAiBlB"}

package/dist/http/interceptor/DefaultCacheInterceptor.js

@@ -2,13 +2,19 @@
  * 全局缓存拦截器
  * 用于 xxf_react/http 的 ApiBuilder
  */
+import { isApiSuccess } from '../../models';
 /**
  * 默认缓存拦截器
+ *
  * 只有满足以下条件才缓存：
  * - HTTP 状态码 = 200
- * - Content-Type 包含 application/json
- * - data 是有效对象
- * - ApiResponse.code = 0 或 200
+ * - Content-Type 包含 application/json（不区分大小写）
+ * - data 是有效对象或数组
+ * - ApiResponse.code 存在且为成功值（0 或 200）
+ *
+ * 特殊处理：
+ * - code 字段支持 number 或 string 类型
+ * - 所有检查都有异常保护，异常时默认不缓存
  *
  * @example
  * ```ts
@@ -19,45 +25,82 @@
  * ```
  */
 export const defaultCacheInterceptor = (ctx) => {
-    // 检查 HTTP 状态码
-    if (ctx.status !== 200) {
-        return false;
-    }
-    // 检查 Content-Type 是否为 JSON
-    const contentType = ctx.headers.get('Content-Type') || '';
-    if (!contentType.includes('application/json')) {
-        return false;
+    var _a, _b;
+    try {
+        // 1. 检查 HTTP 状态码
+        if (ctx.status !== 200) {
+            return false;
+        }
+        // 2. 检查 Content-Type 是否为 JSON（不区分大小写）
+        const contentType = (_b = (_a = ctx.headers) === null || _a === void 0 ? void 0 : _a.get('Content-Type')) !== null && _b !== void 0 ? _b : '';
+        if (!contentType.toLowerCase().includes('application/json')) {
+            return false;
+        }
+        // 3. 检查 data 是否为有效对象或数组
+        if (ctx.data === null || ctx.data === undefined) {
+            return false;
+        }
+        if (typeof ctx.data !== 'object') {
+            return false;
+        }
+        // 4. 检查业务码（支持 number 或 string 类型）
+        const res = ctx.data;
+        if (res.code === undefined || res.code === null) {
+            // 没有 code 字段，不符合 ApiResponse 规范，不缓存
+            return false;
+        }
+        // 将 code 转换为 number 进行判断
+        const codeNum = typeof res.code === 'string' ? parseInt(res.code, 10) : res.code;
+        if (isNaN(codeNum)) {
+            return false;
+        }
+        return isApiSuccess(codeNum);
     }
-    // 检查 data 是否为有效对象
-    if (!ctx.data || typeof ctx.data !== 'object') {
+    catch {
+        // 任何异常都不缓存，保守策略
         return false;
     }
-    // 检查业务码：code 必须是 0 或 200
-    const res = ctx.data;
-    return !(res.code !== 0 && res.code !== 200);
 };
 /**
  * 创建自定义缓存拦截器
- * 在默认检查基础上添加自定义逻辑
+ *
+ * 在默认检查基础上添加自定义逻辑。
+ * 默认检查通过后才会执行自定义检查。
  *
  * @param customCheck 自定义检查函数，在默认检查通过后执行
+ * @returns 组合后的缓存拦截器
  *
  * @example
  * ```ts
+ * // 额外检查：只缓存有 data 字段的响应
  * const myInterceptor = createCacheInterceptor((ctx) => {
- *     // 额外检查：只缓存有 data 字段的响应
  *     const res = ctx.data as { data?: unknown }
  *     return res.data !== undefined
  * })
+ *
+ * // 额外检查：只缓存列表数据
+ * const listInterceptor = createCacheInterceptor((ctx) => {
+ *     const res = ctx.data as { data?: unknown[] }
+ *     return Array.isArray(res.data) && res.data.length > 0
+ * })
  * ```
  */
 export function createCacheInterceptor(customCheck) {
     return (ctx) => {
-        // 先执行默认检查
-        if (!defaultCacheInterceptor(ctx)) {
+        try {
+            // 先执行默认检查
+            if (!defaultCacheInterceptor(ctx)) {
+                return false;
+            }
+            // 执行自定义检查（如果有）
+            if (customCheck) {
+                return customCheck(ctx);
+            }
+            return true;
+        }
+        catch {
+            // 自定义检查异常时不缓存
             return false;
         }
-        // 执行自定义检查
-        return !(customCheck && !customCheck(ctx));
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xxf_react",
-  "version": "0.7.6",
+  "version": "0.7.7",
   "private": false,
   "type": "module",
   "main": "dist/index.js",