xxf_react 0.8.5 → 0.8.6

package/dist/http/demo/api-builder.demo.js

@@ -0,0 +1,343 @@
+/**
+ * ApiBuilder 使用示例
+ *
+ * 此文件演示 ApiBuilder 的核心特性：
+ * 1. 泛型累积 - 链式调用自动累积端点类型
+ * 2. Body 类型约束 - POST/PUT/PATCH 请求体类型检查
+ * 3. 端点名称字面量 - 调用不存在的端点会编译报错
+ * 4. 缓存策略 - CacheMode 控制缓存行为
+ * 5. 多次响应 - 支持缓存优先场景下的两次数据返回
+ */
+import { ApiBuilder } from '../api/ApiBuilder';
+import { CacheMode } from '../models/CacheMode';
+// ============================================================================
+// 创建 API 服务
+// ============================================================================
+export const userApi = ApiBuilder.create({
+    baseUrl: 'https://api.example.com',
+    timeout: 10000,
+    defaultCache: {
+        mode: CacheMode.FirstRemote,
+        ttl: 5 * 60 * 1000,
+    },
+})
+    // GET 请求 - 无路径参数
+    .get('getUsers', {
+    path: '/users',
+    cache: { mode: CacheMode.FirstCache },
+})
+    // GET 请求 - 有路径参数
+    .get('getUser', {
+    path: '/users/{id}',
+    cache: { mode: CacheMode.IfCache, ttl: 60000 },
+})
+    // GET 请求 - 分页
+    .get('getUsersPaginated', {
+    path: '/users/paginated',
+})
+    // POST 请求 - 有 body 类型
+    .post('createUser', {
+    path: '/users',
+})
+    // POST 请求 - 无 body 类型（触发器）
+    .post('activateUser', {
+    path: '/users/{id}/activate',
+})
+    // PUT 请求 - 完整更新
+    .put('updateUser', {
+    path: '/users/{id}',
+})
+    // PATCH 请求 - 部分更新
+    .patch('patchUser', {
+    path: '/users/{id}',
+})
+    // DELETE 请求
+    .delete('deleteUser', {
+    path: '/users/{id}',
+})
+    // 扩展 ky 实例（添加拦截器）
+    .extend({
+    hooks: {
+        beforeRequest: [
+            (request) => {
+                const token = 'mock-token';
+                request.headers.set('Authorization', `Bearer ${token}`);
+            },
+        ],
+    },
+})
+    .build();
+// ============================================================================
+// 使用示例 - 类型安全调用
+// ============================================================================
+async function demo() {
+    // ✅ GET 无路径参数
+    const users = await userApi.getUsers();
+    console.log('Users:', users);
+    // ✅ GET 有路径参数
+    const user = await userApi.getUser({
+        pathParams: { id: '123' },
+    });
+    console.log('User:', user);
+    // ✅ GET 带 query 参数
+    const paginatedUsers = await userApi.getUsersPaginated({
+        query: { page: 1, pageSize: 10 },
+    });
+    console.log('Paginated:', paginatedUsers);
+    // ✅ POST 有 body 类型约束
+    const newUser = await userApi.createUser({
+        body: { name: 'John', email: 'john@example.com' },
+    });
+    console.log('Created:', newUser);
+    // ✅ POST 无 body（触发器）
+    await userApi.activateUser({
+        pathParams: { id: '123' },
+    });
+    // ✅ PUT 完整更新
+    const updatedUser = await userApi.updateUser({
+        pathParams: { id: '123' },
+        body: { name: 'John Updated', email: 'john.updated@example.com' },
+    });
+    console.log('Updated:', updatedUser);
+    // ✅ PATCH 部分更新
+    const patchedUser = await userApi.patchUser({
+        pathParams: { id: '123' },
+        body: { name: 'John Patched' },
+    });
+    console.log('Patched:', patchedUser);
+    // ✅ DELETE
+    await userApi.deleteUser({
+        pathParams: { id: '123' },
+    });
+    // ✅ 覆盖缓存配置
+    const freshUser = await userApi.getUser({
+        pathParams: { id: '123' },
+        cache: { mode: CacheMode.OnlyRemote },
+    });
+    console.log('Fresh:', freshUser);
+}
+// ============================================================================
+// CacheMode 缓存模式详解
+// ============================================================================
+/**
+ * CacheMode 枚举值说明：
+ *
+ * - OnlyRemote:   只请求网络，不使用缓存（适用于实时性要求高的数据）
+ * - OnlyCache:    只读取缓存，不请求网络（适用于离线场景）
+ * - FirstCache:   先返回缓存，再请求网络更新（可能返回两次数据）
+ * - FirstRemote:  先请求网络，失败时回退到缓存（网络优先）
+ * - IfCache:      有缓存则用缓存，无缓存则请求网络（只返回一次）
+ */
+/**
+ * 缓存模式使用示例
+ */
+async function cacheModeDemo() {
+    // 1. OnlyRemote - 始终请求网络，忽略缓存
+    // 适用场景：提交表单、实时数据
+    const realTimeData = await userApi.getUser({
+        pathParams: { id: '123' },
+        cache: { mode: CacheMode.OnlyRemote },
+    });
+    console.log('实时数据:', realTimeData);
+    // 2. OnlyCache - 只读缓存，不请求网络
+    // 适用场景：离线模式、快速展示历史数据
+    try {
+        const cachedData = await userApi.getUser({
+            pathParams: { id: '123' },
+            cache: { mode: CacheMode.OnlyCache },
+        });
+        console.log('缓存数据:', cachedData);
+    }
+    catch (error) {
+        console.log('无缓存数据');
+    }
+    // 3. IfCache - 有缓存用缓存，无缓存请求网络（只返回一次）
+    // 适用场景：静态资源、不常变化的配置
+    const configData = await userApi.getUsers({
+        cache: { mode: CacheMode.IfCache, ttl: 60 * 60 * 1000 }, // 1小时
+    });
+    console.log('配置数据:', configData);
+    // 4. FirstRemote - 优先网络，失败回退缓存（只返回一次）
+    // 适用场景：希望获取最新数据，但网络不稳定时有兜底
+    const freshData = await userApi.getUser({
+        pathParams: { id: '123' },
+        cache: { mode: CacheMode.FirstRemote },
+    });
+    console.log('最新数据:', freshData);
+}
+// ============================================================================
+// 多次响应处理 - FirstCache 模式的核心特性
+// ============================================================================
+/**
+ * FirstCache 模式会返回两次数据：
+ * 1. 第一次：从缓存返回（如果有缓存），fromCache = true
+ * 2. 第二次：从网络返回最新数据，fromCache = false
+ *
+ * 这种模式非常适合：
+ * - 列表页快速展示 + 后台刷新
+ * - 详情页先显示旧数据，再更新为最新数据
+ * - 提升用户体验，减少白屏时间
+ */
+/**
+ * 方式一：使用 for await 处理多次响应
+ * 推荐用于需要处理每次响应的场景
+ */
+async function multiResponseWithForAwait() {
+    console.log('=== for await 方式 ===');
+    for await (const { data, fromCache } of userApi.getUser({
+        pathParams: { id: '123' },
+        cache: { mode: CacheMode.FirstCache },
+    })) {
+        if (fromCache) {
+            console.log('📦 缓存数据（快速展示）:', data);
+            // 可以先用缓存数据渲染 UI
+        }
+        else {
+            console.log('🌐 网络数据（最新）:', data);
+            // 用最新数据更新 UI
+        }
+    }
+    console.log('✅ 请求完成');
+}
+/**
+ * 方式二：使用 subscribe 处理多次响应
+ * 推荐用于 React/Vue 等框架中的响应式更新
+ */
+async function multiResponseWithSubscribe() {
+    console.log('=== subscribe 方式 ===');
+    await userApi
+        .getUser({
+        pathParams: { id: '123' },
+        cache: { mode: CacheMode.FirstCache },
+    })
+        .subscribe({
+        onData: (data, fromCache) => {
+            if (fromCache) {
+                console.log('📦 缓存数据:', data);
+                // setState({ user: data, loading: false })
+            }
+            else {
+                console.log('🌐 网络数据:', data);
+                // setState({ user: data, loading: false, isStale: false })
+            }
+        },
+        onError: (error) => {
+            console.error('❌ 请求失败:', error);
+            // setState({ error, loading: false })
+        },
+        onComplete: () => {
+            console.log('✅ 请求完成');
+        },
+    });
+}
+/**
+ * 方式三：只需要最终结果时使用 await
+ * 注意：await 只返回最后一次响应（网络数据）
+ */
+async function singleResponseWithAwait() {
+    console.log('=== await 方式（只获取最终结果）===');
+    // 直接 await 只会返回最终的网络数据
+    const user = await userApi.getUser({
+        pathParams: { id: '123' },
+        cache: { mode: CacheMode.FirstCache },
+    });
+    console.log('最终数据:', user);
+}
+/**
+ * React 组件中的典型用法示例（伪代码）
+ */
+function reactUsageExample() {
+    /*
+    // React 组件示例
+    function UserProfile({ userId }: { userId: string }) {
+        const [user, setUser] = useState<User | null>(null)
+        const [isStale, setIsStale] = useState(false)
+        const [loading, setLoading] = useState(true)
+
+        useEffect(() => {
+            let cancelled = false
+
+            // 使用 subscribe 处理多次响应
+            userApi.getUser({
+                pathParams: { id: userId },
+                cache: { mode: CacheMode.FirstCache }
+            }).subscribe({
+                onData: (data, fromCache) => {
+                    if (cancelled) return
+                    setUser(data)
+                    setIsStale(fromCache)  // 标记是否为陈旧数据
+                    setLoading(false)
+                },
+                onError: (error) => {
+                    if (cancelled) return
+                    console.error(error)
+                    setLoading(false)
+                }
+            })
+
+            return () => { cancelled = true }
+        }, [userId])
+
+        if (loading) return <div>加载中...</div>
+        if (!user) return <div>用户不存在</div>
+
+        return (
+            <div>
+                {isStale && <span className="badge">数据更新中...</span>}
+                <h1>{user.name}</h1>
+                <p>{user.email}</p>
+            </div>
+        )
+    }
+    */
+}
+// ============================================================================
+// 类型错误示例
+// ============================================================================
+/**
+ * 类型安全验证
+ *
+ * 注意：由于 TypeScript 对深层交叉类型的处理限制，
+ * 当链式调用超过 4 个端点时，类型推断可能不够精确。
+ * 建议：保持单个 builder 的端点数量在 4 个以内，或分批构建。
+ *
+ * 以下是简化版本的类型安全验证（2-3 个端点）
+ */
+const simpleApi = ApiBuilder.create({ baseUrl: 'http://test' })
+    .get('getUser', { path: '/users/{id}' })
+    .post('createUser', { path: '/users' })
+    .build();
+function typeErrors() {
+    // ❌ body 类型不匹配（缺少 email）
+    // @ts-expect-error email is required
+    simpleApi.createUser({ body: { name: 'John' } });
+    // ❌ body 类型不匹配（错误的属性）
+    // @ts-expect-error wrong property
+    simpleApi.createUser({ body: { wrong: 'x' } });
+    // ❌ GET 请求不应该有 body
+    // @ts-expect-error body not allowed for GET
+    simpleApi.getUser({ pathParams: { id: '1' }, body: {} });
+}
+/**
+ * 类型兼容性验证示例
+ */
+function verifyTypeCompatibility() {
+    const api = ApiBuilder.create({ baseUrl: 'http://test' })
+        .get('getUser', { path: '/users/{id}' })
+        .get('getUsers', { path: '/users' })
+        .post('createUser', { path: '/users' })
+        .put('updateUser', { path: '/users/{id}' })
+        .delete('deleteUser', { path: '/users/{id}' })
+        .build();
+    // ✅ 使用类型断言确保 API 符合定义
+    // 注意：由于 TypeScript 深层交叉类型限制，需要通过 unknown 进行断言
+    const typedApi = api;
+    // 现在可以获得精确的类型检查
+    typedApi.createUser({ body: { name: 'John', email: 'john@test.com' } });
+    typedApi.getUser({ pathParams: { id: '1' } });
+    console.log('Typed API:', typedApi);
+}
+// ============================================================================
+// 导出
+// ============================================================================
+export { demo, typeErrors, verifyTypeCompatibility, cacheModeDemo, multiResponseWithForAwait, multiResponseWithSubscribe, singleResponseWithAwait, reactUsageExample, };

package/dist/http/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * HTTP 网络框架
+ *
+ * 基于 ky + idb-keyval，支持：
+ * - 内存 + 磁盘双层缓存
+ * - 6 种缓存模式
+ * - AsyncGenerator 流式响应
+ * - 类 Retrofit 的 API 定义方式
+ *
+ * @example
+ * ```ts
+ * import { ApiBuilder, CacheMode } from 'xxf_react/http'
+ *
+ * const userApi = ApiBuilder.create({
+ *   baseUrl: 'https://api.example.com',
+ * })
+ *   .get<User>('getUser', {
+ *     path: '/users/{id}',
+ *     cache: { mode: CacheMode.IfCache, ttl: 60000 },
+ *   })
+ *   .build()
+ *
+ * // 方式1: 简单 await
+ * const user = await userApi.getUser({ pathParams: { id: '123' } })
+ *
+ * // 方式2: for await 多次响应
+ * for await (const { data, fromCache } of userApi.getUser({ pathParams: { id: '123' } })) {
+ *   console.log(data, fromCache)
+ * }
+ *
+ * // 方式3: subscribe 安全消费
+ * await userApi.getUser({ pathParams: { id: '123' } }).subscribe({
+ *   onData: (data, fromCache) => console.log(data),
+ *   onError: (e) => console.error(e),
+ * })
+ * ```
+ */
+export { CacheMode } from './types';
+export type { ApiResult, ApiCallback } from './types';
+export type { CacheConfig, CacheKeyRequest, CacheEntry, DiskLruCacheConfig, HttpCacheConfig, LruMetadataEntry, LruMetadata, } from './types';
+export type { CacheInterceptor, CacheInterceptorContext, CacheInterceptorResult, } from './types';
+/** 默认缓存拦截器：检查 HTTP 200 + JSON + ApiResponse.code */
+export { defaultCacheInterceptor, createCacheInterceptor } from './interceptor';
+export type { HttpClientConfig, RequestConfig, ApiOptions } from './types';
+export type { ApiEndpoint, ApiDefinition, ApiEndpointWithBody, ApiEndpointWithoutBody, ApiEndpointWithBodyRequired, ApiEndpointWithBodyOptional, Simplify, } from './api';
+/** 磁盘 LRU 缓存（从 cache 模块重导出） */
+export { DiskLruCache } from '../cache';
+/** HTTP 缓存（内存 + 磁盘双层） */
+export { HttpCache } from './cache';
+export { HttpClient, ApiStream } from './client';
+export { ApiBuilder } from './api';
+//# sourceMappingURL=index.d.ts.map

package/dist/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAKH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAKnC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAKrD,YAAY,EAER,WAAW,EACX,eAAe,EAEf,UAAU,EAEV,kBAAkB,EAClB,eAAe,EAEf,gBAAgB,EAChB,WAAW,GACd,MAAM,SAAS,CAAA;AAKhB,YAAY,EACR,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,GACzB,MAAM,SAAS,CAAA;AAKhB,oDAAoD;AACpD,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAK/E,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAK1E,YAAY,EACR,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,2BAA2B,EAC3B,QAAQ,GACX,MAAM,OAAO,CAAA;AAKd,+BAA+B;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,yBAAyB;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAKnC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAKhD,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA"}

package/dist/http/index.js

@@ -0,0 +1,61 @@
+/**
+ * HTTP 网络框架
+ *
+ * 基于 ky + idb-keyval，支持：
+ * - 内存 + 磁盘双层缓存
+ * - 6 种缓存模式
+ * - AsyncGenerator 流式响应
+ * - 类 Retrofit 的 API 定义方式
+ *
+ * @example
+ * ```ts
+ * import { ApiBuilder, CacheMode } from 'xxf_react/http'
+ *
+ * const userApi = ApiBuilder.create({
+ *   baseUrl: 'https://api.example.com',
+ * })
+ *   .get<User>('getUser', {
+ *     path: '/users/{id}',
+ *     cache: { mode: CacheMode.IfCache, ttl: 60000 },
+ *   })
+ *   .build()
+ *
+ * // 方式1: 简单 await
+ * const user = await userApi.getUser({ pathParams: { id: '123' } })
+ *
+ * // 方式2: for await 多次响应
+ * for await (const { data, fromCache } of userApi.getUser({ pathParams: { id: '123' } })) {
+ *   console.log(data, fromCache)
+ * }
+ *
+ * // 方式3: subscribe 安全消费
+ * await userApi.getUser({ pathParams: { id: '123' } }).subscribe({
+ *   onData: (data, fromCache) => console.log(data),
+ *   onError: (e) => console.error(e),
+ * })
+ * ```
+ */
+// ============================================================================
+// 枚举
+// ============================================================================
+export { CacheMode } from './types';
+// ============================================================================
+// 缓存拦截器实现
+// ============================================================================
+/** 默认缓存拦截器：检查 HTTP 200 + JSON + ApiResponse.code */
+export { defaultCacheInterceptor, createCacheInterceptor } from './interceptor';
+// ============================================================================
+// 缓存实现
+// ============================================================================
+/** 磁盘 LRU 缓存（从 cache 模块重导出） */
+export { DiskLruCache } from '../cache';
+/** HTTP 缓存（内存 + 磁盘双层） */
+export { HttpCache } from './cache';
+// ============================================================================
+// 客户端
+// ============================================================================
+export { HttpClient, ApiStream } from './client';
+// ============================================================================
+// API Builder
+// ============================================================================
+export { ApiBuilder } from './api';

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

@@ -0,0 +1,112 @@
+/**
+ * 缓存拦截器相关类型
+ *
+ * 用于根据响应内容动态决定是否缓存
+ */
+import type { CacheKeyRequest } from '../models/CacheConfig';
+/**
+ * 缓存拦截器上下文
+ *
+ * 包含响应的完整信息，供拦截器判断是否应该缓存
+ *
+ * @template T 响应数据类型
+ *
+ * @example
+ * ```ts
+ * cacheInterceptor: (ctx) => {
+ *   // 可以访问响应数据、HTTP 状态码、响应头等
+ *   console.log(ctx.data)      // 响应数据
+ *   console.log(ctx.status)    // HTTP 状态码
+ *   console.log(ctx.headers)   // 响应头
+ *   console.log(ctx.request)   // 请求信息
+ *   console.log(ctx.cacheKey)  // 缓存 key
+ * }
+ * ```
+ */
+export interface CacheInterceptorContext<T = unknown> {
+    /** 响应数据（已解析的 JSON） */
+    data: T;
+    /** HTTP 状态码 */
+    status: number;
+    /** 响应头 */
+    headers: Headers;
+    /** 请求信息（用于调试或高级判断） */
+    request: CacheKeyRequest;
+    /** 缓存 key（用于调试或高级判断） */
+    cacheKey: string;
+}
+/**
+ * 缓存拦截器返回结果
+ *
+ * 当需要更精细控制时使用对象形式返回
+ *
+ * @example
+ * ```ts
+ * // 简单返回 boolean
+ * cacheInterceptor: (ctx) => ctx.status === 200
+ *
+ * // 返回对象，可以覆盖 TTL
+ * cacheInterceptor: (ctx) => ({
+ *   shouldCache: true,
+ *   ttl: 10 * 60 * 1000,  // 覆盖为 10 分钟
+ * })
+ * ```
+ */
+export interface CacheInterceptorResult {
+    /** 是否允许缓存 */
+    shouldCache: boolean;
+    /**
+     * 可选：覆盖缓存 TTL (ms)
+     * 如果不指定，使用请求配置中的 ttl
+     */
+    ttl?: number;
+}
+/**
+ * 缓存拦截器
+ *
+ * 在响应返回后、写入缓存前调用，用于根据响应内容决定是否缓存。
+ *
+ * ## 常见场景
+ * - 只缓存 HTTP 200 响应
+ * - 只缓存业务 code 为成功的响应
+ * - 根据响应头决定是否缓存
+ * - 根据响应内容动态调整缓存时间
+ *
+ * ## 返回值
+ * - `true`：允许缓存
+ * - `false`：不缓存
+ * - `CacheInterceptorResult`：精细控制（是否缓存 + 可选覆盖 TTL）
+ * - `Promise<...>`：支持异步判断
+ *
+ * @template T 响应数据类型
+ * @param context 拦截器上下文，包含响应的完整信息
+ *
+ * @example
+ * ```ts
+ * // 示例 1：只缓存 HTTP 200
+ * cacheInterceptor: (ctx) => ctx.status === 200
+ *
+ * // 示例 2：检查业务 code
+ * cacheInterceptor: (ctx) => {
+ *   const res = ctx.data as { code?: number }
+ *   return res.code === 200
+ * }
+ *
+ * // 示例 3：检查响应头
+ * cacheInterceptor: (ctx) => {
+ *   return ctx.headers.get('X-Cacheable') !== 'false'
+ * }
+ *
+ * // 示例 4：动态 TTL
+ * cacheInterceptor: (ctx) => {
+ *   const res = ctx.data as { code?: number; cacheTtl?: number }
+ *   if (res.code !== 200) return false
+ *   return {
+ *     shouldCache: true,
+ *     ttl: res.cacheTtl ?? 5 * 60 * 1000,
+ *   }
+ * }
+ * ```
+ */
+export type CacheInterceptor<T = unknown> = (context: CacheInterceptorContext<T>) => boolean | CacheInterceptorResult | Promise<boolean | CacheInterceptorResult>;
+//# sourceMappingURL=CacheInterceptor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheInterceptor.d.ts","sourceRoot":"","sources":["../../../src/http/interceptor/CacheInterceptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC,GAAG,OAAO;IAChD,sBAAsB;IACtB,IAAI,EAAE,CAAC,CAAA;IACP,eAAe;IACf,MAAM,EAAE,MAAM,CAAA;IACd,UAAU;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,sBAAsB;IACtB,OAAO,EAAE,eAAe,CAAA;IACxB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,sBAAsB;IACnC,aAAa;IACb,WAAW,EAAE,OAAO,CAAA;IACpB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI,CACxC,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,KAClC,OAAO,GAAG,sBAAsB,GAAG,OAAO,CAAC,OAAO,GAAG,sBAAsB,CAAC,CAAA"}

package/dist/http/interceptor/CacheInterceptor.js

@@ -0,0 +1,6 @@
+/**
+ * 缓存拦截器相关类型
+ *
+ * 用于根据响应内容动态决定是否缓存
+ */
+export {};

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

@@ -0,0 +1,53 @@
+/**
+ * 全局缓存拦截器
+ * 用于 xxf_react/http 的 ApiBuilder
+ */
+import { CacheInterceptor } from './CacheInterceptor';
+/**
+ * 默认缓存拦截器
+ *
+ * 只有满足以下条件才缓存：
+ * - HTTP 状态码 = 200
+ * - Content-Type 包含 application/json（不区分大小写）
+ * - data 是有效对象或数组
+ * - ApiResponse.code 存在且为成功值（0 或 200）
+ *
+ * 特殊处理：
+ * - code 字段支持 number 或 string 类型
+ * - 所有检查都有异常保护，异常时默认不缓存
+ *
+ * @example
+ * ```ts
+ * ApiBuilder.create({
+ *     baseUrl: '...',
+ *     cacheInterceptor: defaultCacheInterceptor,
+ * })
+ * ```
+ */
+export declare const defaultCacheInterceptor: CacheInterceptor;
+/**
+ * 创建自定义缓存拦截器
+ *
+ * 在默认检查基础上添加自定义逻辑。
+ * 默认检查通过后才会执行自定义检查。
+ *
+ * @param customCheck 自定义检查函数，在默认检查通过后执行
+ * @returns 组合后的缓存拦截器
+ *
+ * @example
+ * ```ts
+ * // 额外检查：只缓存有 data 字段的响应
+ * const myInterceptor = createCacheInterceptor((ctx) => {
+ *     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;
+//# sourceMappingURL=DefaultCacheInterceptor.d.ts.map

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

@@ -0,0 +1 @@
+{"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"}