@yh-ui/request 0.1.21

package/dist/http-cache.mjs

@@ -0,0 +1,233 @@
+export class HttpCache {
+  cache = /* @__PURE__ */ new Map();
+  options;
+  constructor(options = {}) {
+    this.options = {
+      enabled: options.enabled ?? true,
+      etagHeader: options.etagHeader ?? "ETag",
+      lastModifiedHeader: options.lastModifiedHeader ?? "Last-Modified",
+      maxAge: options.maxAge ?? 5 * 60 * 1e3,
+      // 5 分钟
+      staleWhileRevalidate: options.staleWhileRevalidate ?? false,
+      staleTime: options.staleTime ?? 60 * 1e3
+      // 1 分钟
+    };
+  }
+  /**
+   * 从响应中提取缓存信息
+   */
+  extractCacheInfo(response) {
+    const etag = response.headers.get(this.options.etagHeader) || void 0;
+    const lastModified = response.headers.get(this.options.lastModifiedHeader) || void 0;
+    return { etag, lastModified };
+  }
+  /**
+   * 生成缓存键
+   */
+  getCacheKey(config) {
+    return `${config.method}:${config.fullPath || config.url}`;
+  }
+  /**
+   * 获取缓存
+   */
+  get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return void 0;
+    const now = Date.now();
+    if (entry.expireTime && now > entry.expireTime) {
+      this.cache.delete(key);
+      return void 0;
+    }
+    return entry;
+  }
+  /**
+   * 设置缓存
+   */
+  set(key, data, response) {
+    const { etag, lastModified } = this.extractCacheInfo(response);
+    const now = Date.now();
+    const cacheControl = response.headers.get("Cache-Control");
+    let maxAge = this.options.maxAge;
+    if (cacheControl) {
+      const maxAgeMatch = cacheControl.match(/max-age=(\d+)/);
+      if (maxAgeMatch) {
+        maxAge = parseInt(maxAgeMatch[1], 10) * 1e3;
+      }
+      if (cacheControl.includes("no-cache")) {
+        maxAge = 0;
+      }
+    }
+    const entry = {
+      etag,
+      lastModified,
+      data,
+      expireTime: maxAge > 0 ? now + maxAge : now,
+      createTime: now
+    };
+    this.cache.set(key, entry);
+  }
+  /**
+   * 构建条件请求头
+   */
+  buildConditionalHeaders(config) {
+    const key = this.getCacheKey(config);
+    const entry = this.get(key);
+    const headers = {};
+    if (entry) {
+      if (entry.etag) {
+        headers["If-None-Match"] = entry.etag;
+      }
+      if (entry.lastModified) {
+        headers["If-Modified-Since"] = entry.lastModified;
+      }
+    }
+    return headers;
+  }
+  /**
+   * 处理条件响应
+   */
+  handleConditionalResponse(config, response, data) {
+    const key = this.getCacheKey(config);
+    const entry = this.get(key);
+    if (response.status === 304) {
+      if (entry) {
+        return {
+          isModified: false,
+          data: entry.data,
+          entry
+        };
+      }
+    }
+    this.set(key, data, response);
+    return {
+      isModified: true,
+      data
+    };
+  }
+  /**
+   * 获取缓存数据（可能返回过期数据用于 stale-while-revalidate）
+   */
+  getWithFallback(key) {
+    const entry = this.get(key);
+    if (!entry) return void 0;
+    const now = Date.now();
+    const isStale = !!(entry.expireTime && now > entry.expireTime);
+    return {
+      data: entry.data,
+      isStale
+    };
+  }
+  /**
+   * 删除缓存
+   */
+  delete(key) {
+    return this.cache.delete(key);
+  }
+  /**
+   * 清空缓存
+   */
+  clear() {
+    this.cache.clear();
+  }
+  /**
+   * 获取缓存大小
+   */
+  size() {
+    return this.cache.size;
+  }
+  /**
+   * 清理过期缓存
+   */
+  cleanup() {
+    const now = Date.now();
+    for (const [key, entry] of this.cache.entries()) {
+      if (entry.expireTime && now > entry.expireTime) {
+        this.cache.delete(key);
+      }
+    }
+  }
+}
+export function createHttpCacheInterceptor(options = {}) {
+  const cache = new HttpCache(options);
+  return {
+    /**
+     * 请求拦截 - 添加条件请求头
+     */
+    onRequest: (config) => {
+      if (!options.enabled) return config;
+      if (config.method !== "GET") return config;
+      const conditionalHeaders = cache.buildConditionalHeaders(config);
+      return {
+        ...config,
+        headers: {
+          ...config.headers,
+          ...conditionalHeaders
+        }
+      };
+    },
+    /**
+     * 响应拦截 - 处理条件响应
+     */
+    onResponse: (response) => {
+      if (!options.enabled) return response;
+      if (response.config.method !== "GET") return response;
+      if (response.response.status === 304) {
+        const key = `${response.config.method}:${response.config.fullPath || response.config.url}`;
+        const entry = cache.get(key);
+        if (entry) {
+          return {
+            ...response,
+            data: entry.data
+          };
+        }
+      }
+      cache.set(
+        `${response.config.method}:${response.config.fullPath || response.config.url}`,
+        response.data,
+        response.response
+      );
+      return response;
+    },
+    /**
+     * 获取缓存实例
+     */
+    getCache: () => cache
+  };
+}
+export const httpCache = new HttpCache();
+export function createConditionalRequestInterceptor(options = {}) {
+  return createHttpCacheInterceptor({ ...options });
+}
+export function parseCacheControl(header) {
+  if (!header)
+    return {
+      noCache: false,
+      noStore: false,
+      mustRevalidate: false,
+      isPublic: false,
+      isPrivate: false
+    };
+  const result = {
+    noCache: false,
+    noStore: false,
+    mustRevalidate: false,
+    isPublic: false,
+    isPrivate: false
+  };
+  const maxAgeMatch = header.match(/max-age=(\d+)/);
+  if (maxAgeMatch) {
+    result.maxAge = parseInt(maxAgeMatch[1], 10);
+  }
+  if (header.includes("no-cache")) result.noCache = true;
+  if (header.includes("no-store")) result.noStore = true;
+  if (header.includes("must-revalidate")) result.mustRevalidate = true;
+  if (header.includes("public")) result.isPublic = true;
+  if (header.includes("private")) result.isPrivate = true;
+  return result;
+}
+export function isResponseCacheable(response) {
+  const cacheControl = parseCacheControl(response.headers.get("Cache-Control"));
+  if (cacheControl.noStore) return false;
+  if (cacheControl.isPublic || cacheControl.isPrivate) return true;
+  return response.ok;
+}

package/dist/index.cjs

@@ -0,0 +1,181 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _request = require("./request.cjs");
+Object.keys(_request).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _request[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _request[key];
+    }
+  });
+});
+var _types = require("./types.cjs");
+Object.keys(_types).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _types[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _types[key];
+    }
+  });
+});
+var _useRequest = require("./useRequest.cjs");
+Object.keys(_useRequest).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useRequest[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useRequest[key];
+    }
+  });
+});
+var _useSSE = require("./useSSE.cjs");
+Object.keys(_useSSE).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useSSE[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useSSE[key];
+    }
+  });
+});
+var _useAIStream = require("./useAIStream.cjs");
+Object.keys(_useAIStream).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useAIStream[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useAIStream[key];
+    }
+  });
+});
+var _usePagination = require("./usePagination.cjs");
+Object.keys(_usePagination).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _usePagination[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _usePagination[key];
+    }
+  });
+});
+var _useLoadMore = require("./useLoadMore.cjs");
+Object.keys(_useLoadMore).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useLoadMore[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useLoadMore[key];
+    }
+  });
+});
+var _useQueue = require("./useQueue.cjs");
+Object.keys(_useQueue).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useQueue[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useQueue[key];
+    }
+  });
+});
+var _useRequestQueue = require("./useRequestQueue.cjs");
+Object.keys(_useRequestQueue).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useRequestQueue[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useRequestQueue[key];
+    }
+  });
+});
+var _plugin = require("./plugin.cjs");
+Object.keys(_plugin).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _plugin[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _plugin[key];
+    }
+  });
+});
+var _adapters = require("./adapters/index.cjs");
+Object.keys(_adapters).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _adapters[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _adapters[key];
+    }
+  });
+});
+var _cache = require("./cache/index.cjs");
+Object.keys(_cache).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _cache[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _cache[key];
+    }
+  });
+});
+var _interceptors = require("./interceptors/index.cjs");
+Object.keys(_interceptors).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _interceptors[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _interceptors[key];
+    }
+  });
+});
+var _graphql = require("./graphql.cjs");
+Object.keys(_graphql).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _graphql[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _graphql[key];
+    }
+  });
+});
+var _websocket = require("./websocket.cjs");
+Object.keys(_websocket).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _websocket[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _websocket[key];
+    }
+  });
+});
+var _httpCache = require("./http-cache.cjs");
+Object.keys(_httpCache).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _httpCache[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _httpCache[key];
+    }
+  });
+});

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * YH-UI Request Hooks
+ *
+ * Enterprise-grade HTTP request hooks for Vue 3
+ *
+ * @package @yh-ui/request
+ */
+export * from './request';
+export * from './types';
+export * from './useRequest';
+export * from './useSSE';
+export * from './useAIStream';
+export * from './usePagination';
+export * from './useLoadMore';
+export * from './useQueue';
+export * from './useRequestQueue';
+export * from './plugin';
+export * from './adapters';
+export * from './cache';
+export * from './interceptors';
+export * from './graphql';
+export * from './websocket';
+export * from './http-cache';

package/dist/index.mjs

@@ -0,0 +1,16 @@
+export * from "./request.mjs";
+export * from "./types.mjs";
+export * from "./useRequest.mjs";
+export * from "./useSSE.mjs";
+export * from "./useAIStream.mjs";
+export * from "./usePagination.mjs";
+export * from "./useLoadMore.mjs";
+export * from "./useQueue.mjs";
+export * from "./useRequestQueue.mjs";
+export * from "./plugin.mjs";
+export * from "./adapters/index.mjs";
+export * from "./cache/index.mjs";
+export * from "./interceptors/index.mjs";
+export * from "./graphql.mjs";
+export * from "./websocket.mjs";
+export * from "./http-cache.mjs";

package/dist/interceptors/debug.cjs

@@ -0,0 +1,139 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DebugLogger = void 0;
+exports.createDebugInterceptor = createDebugInterceptor;
+exports.debugLogger = void 0;
+function createDebugInterceptor(options = {}) {
+  const {
+    enabled = false,
+    level = "log",
+    logRequestBody = true,
+    logResponseBody = true,
+    sanitize,
+    logger
+  } = options;
+  const loggers = {
+    log: console.log,
+    warn: console.warn,
+    error: console.error
+  };
+  const log = logger || loggers[level];
+  const createDebugInfo = (config, response, error) => {
+    const info = {
+      requestId: config.requestId || "",
+      url: config.fullPath || config.url || "",
+      method: config.method || "GET",
+      timestamp: Date.now()
+    };
+    if (logRequestBody) {
+      info.headers = config.headers;
+      info.data = config.data;
+    }
+    if (response) {
+      info.status = response.response.status;
+      info.duration = response.duration;
+      if (logResponseBody) {
+        info.response = response.data;
+      }
+    }
+    if (error) {
+      info.error = error.message;
+      info.status = error.response?.status;
+    }
+    return info;
+  };
+  const printDebug = info => {
+    if (!enabled) return;
+    const sanitizedInfo = sanitize ? sanitize(info) : info;
+    const prefix = `[YH-Request] ${sanitizedInfo.method} ${sanitizedInfo.requestId}`;
+    const status = sanitizedInfo.status ? ` [${sanitizedInfo.status}]` : "";
+    const duration = sanitizedInfo.duration ? ` (${sanitizedInfo.duration}ms)` : "";
+    if (sanitizedInfo.error) {
+      log({
+        ...sanitizedInfo,
+        message: `${prefix}${status}${duration} - ${sanitizedInfo.error}`
+      });
+    } else {
+      log({
+        ...sanitizedInfo,
+        message: `${prefix}${status}${duration}`
+      });
+    }
+  };
+  return {
+    /**
+     * 请求拦截
+     */
+    onRequest: config => {
+      if (!enabled) return config;
+      const info = createDebugInfo(config);
+      printDebug({
+        ...info,
+        message: `[YH-Request] \u2192 ${info.method} ${info.url}`
+      });
+      return config;
+    },
+    /**
+     * 响应拦截
+     */
+    onResponse: response => {
+      if (!enabled) return response;
+      const info = createDebugInfo(response.config, response);
+      const duration = Date.now() - info.timestamp;
+      info.duration = duration;
+      printDebug(info);
+      return response;
+    },
+    /**
+     * 错误拦截
+     */
+    onError: error => {
+      if (!enabled) return error;
+      const info = createDebugInfo(error.config || {}, void 0, error);
+      printDebug(info);
+      return error;
+    }
+  };
+}
+class DebugLogger {
+  logs = [];
+  maxLogs = 100;
+  /**
+   * 添加日志
+   */
+  addLog(info) {
+    this.logs.push(info);
+    if (this.logs.length > this.maxLogs) {
+      this.logs.shift();
+    }
+  }
+  /**
+   * 获取所有日志
+   */
+  getLogs() {
+    return [...this.logs];
+  }
+  /**
+   * 清除日志
+   */
+  clear() {
+    this.logs = [];
+  }
+  /**
+   * 根据请求 ID 查找日志
+   */
+  findByRequestId(requestId) {
+    return this.logs.filter(log => log.requestId === requestId);
+  }
+  /**
+   * 导出日志
+   */
+  export() {
+    return JSON.stringify(this.logs, null, 2);
+  }
+}
+exports.DebugLogger = DebugLogger;
+const debugLogger = exports.debugLogger = new DebugLogger();

package/dist/interceptors/debug.d.ts

@@ -0,0 +1,92 @@
+/**
+ * 调试拦截器
+ * 提供请求/响应的调试信息
+ */
+import type { InternalRequestOptions, RequestResponse, RequestError } from '../types';
+/** 调试日志级别 */
+export type DebugLevel = 'log' | 'warn' | 'error';
+/** 调试信息 */
+export interface DebugInfo {
+    /** 请求 ID */
+    requestId: string;
+    /** 请求 URL */
+    url: string;
+    /** 请求方法 */
+    method: string;
+    /** 请求头 */
+    headers?: Record<string, string>;
+    /** 请求体 */
+    data?: unknown;
+    /** 响应数据 */
+    response?: unknown;
+    /** 响应状态 */
+    status?: number;
+    /** 耗时 (ms) */
+    duration?: number;
+    /** 错误信息 */
+    error?: string;
+    /** 时间戳 */
+    timestamp: number;
+    /** 日志消息 */
+    message?: string;
+}
+/** 调试配置 */
+export interface DebugInterceptorOptions {
+    /** 是否启用调试 */
+    enabled?: boolean;
+    /** 日志级别 */
+    level?: DebugLevel;
+    /** 是否打印请求体 */
+    logRequestBody?: boolean;
+    /** 是否打印响应体 */
+    logResponseBody?: boolean;
+    /** 脱敏处理 */
+    sanitize?: (info: DebugInfo) => DebugInfo;
+    /** 自定义日志输出 */
+    logger?: (info: DebugInfo) => void;
+}
+/**
+ * 创建调试拦截器
+ */
+export declare function createDebugInterceptor(options?: DebugInterceptorOptions): {
+    /**
+     * 请求拦截
+     */
+    onRequest: (config: InternalRequestOptions) => InternalRequestOptions;
+    /**
+     * 响应拦截
+     */
+    onResponse: <T>(response: RequestResponse<T>) => RequestResponse<T>;
+    /**
+     * 错误拦截
+     */
+    onError: (error: RequestError) => RequestError;
+};
+/**
+ * 调试日志工具
+ */
+export declare class DebugLogger {
+    private logs;
+    private maxLogs;
+    /**
+     * 添加日志
+     */
+    addLog(info: DebugInfo): void;
+    /**
+     * 获取所有日志
+     */
+    getLogs(): DebugInfo[];
+    /**
+     * 清除日志
+     */
+    clear(): void;
+    /**
+     * 根据请求 ID 查找日志
+     */
+    findByRequestId(requestId: string): DebugInfo[];
+    /**
+     * 导出日志
+     */
+    export(): string;
+}
+export declare const debugLogger: DebugLogger;