@yh-ui/request 0.1.21

package/dist/interceptors/debug.mjs

@@ -0,0 +1,130 @@
+export 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;
+    }
+  };
+}
+export 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);
+  }
+}
+export const debugLogger = new DebugLogger();

package/dist/interceptors/index.cjs

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _progress = require("./progress.cjs");
+Object.keys(_progress).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _progress[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _progress[key];
+    }
+  });
+});
+var _security = require("./security.cjs");
+Object.keys(_security).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _security[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _security[key];
+    }
+  });
+});
+var _debug = require("./debug.cjs");
+Object.keys(_debug).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _debug[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _debug[key];
+    }
+  });
+});

package/dist/interceptors/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 拦截器系统导出
+ */
+export * from './progress';
+export * from './security';
+export * from './debug';

package/dist/interceptors/index.mjs

@@ -0,0 +1,3 @@
+export * from "./progress.mjs";
+export * from "./security.mjs";
+export * from "./debug.mjs";

package/dist/interceptors/progress.cjs

@@ -0,0 +1,185 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.XHRProgressHandler = exports.FetchProgressHandler = void 0;
+exports.createProgressInterceptor = createProgressInterceptor;
+function createProgressInterceptor(options) {
+  const {
+    onUploadProgress,
+    onDownloadProgress
+  } = options;
+  let uploadStartTime = 0;
+  let downloadStartTime = 0;
+  const calculateRate = (loaded, startTime) => {
+    const elapsed = (Date.now() - startTime) / 1e3;
+    return elapsed > 0 ? loaded / elapsed : 0;
+  };
+  const calculateEstimated = (loaded, total, rate) => {
+    if (rate <= 0 || total <= 0) return void 0;
+    const remaining = total - loaded;
+    return remaining > 0 ? remaining / rate * 1e3 : 0;
+  };
+  const createProgressHandler = isUpload => {
+    return event => {
+      const startTime = isUpload ? uploadStartTime : downloadStartTime;
+      const rate = calculateRate(event.loaded, startTime);
+      const estimated = calculateEstimated(event.loaded, event.total, rate);
+      const progressEvent = {
+        ...event,
+        rate,
+        estimated
+      };
+      if (isUpload) {
+        onUploadProgress?.(progressEvent);
+      } else {
+        onDownloadProgress?.(progressEvent);
+      }
+    };
+  };
+  return {
+    /**
+     * 请求拦截 - 初始化上传进度
+     */
+    onRequest: config => {
+      uploadStartTime = Date.now();
+      return config;
+    },
+    /**
+     * 响应拦截 - 初始化下载进度
+     */
+    onResponse: response => {
+      downloadStartTime = Date.now();
+      return response;
+    },
+    /**
+     * 获取上传进度处理器
+     */
+    getUploadHandler: createProgressHandler(true),
+    /**
+     * 获取下载进度处理器
+     */
+    getDownloadHandler: createProgressHandler(false)
+  };
+}
+class XHRProgressHandler {
+  xhr = null;
+  onUploadProgress;
+  onDownloadProgress;
+  uploadStartTime = 0;
+  downloadStartTime = 0;
+  constructor(options) {
+    this.onUploadProgress = options.onUploadProgress;
+    this.onDownloadProgress = options.onDownloadProgress;
+  }
+  /**
+   * 绑定 XHR 事件
+   */
+  bind(xhr) {
+    this.xhr = xhr;
+    if (this.onUploadProgress) {
+      xhr.upload.addEventListener("progress", event => {
+        if (event.lengthComputable) {
+          this.handleUploadProgress(event);
+        }
+      });
+    }
+    if (this.onDownloadProgress) {
+      xhr.addEventListener("progress", event => {
+        if (event.lengthComputable) {
+          this.handleDownloadProgress(event);
+        }
+      });
+    }
+  }
+  handleUploadProgress(event) {
+    if (!this.onUploadProgress) return;
+    const now = Date.now();
+    const elapsed = (now - this.uploadStartTime) / 1e3;
+    const rate = elapsed > 0 ? event.loaded / elapsed : 0;
+    const estimated = rate > 0 ? (event.total - event.loaded) / rate * 1e3 : void 0;
+    this.onUploadProgress({
+      loaded: event.loaded,
+      total: event.total,
+      percent: event.loaded / event.total * 100,
+      rate,
+      estimated
+    });
+  }
+  handleDownloadProgress(event) {
+    if (!this.onDownloadProgress) return;
+    const now = Date.now();
+    const elapsed = (now - this.downloadStartTime) / 1e3;
+    const rate = elapsed > 0 ? event.loaded / elapsed : 0;
+    const estimated = rate > 0 ? (event.total - event.loaded) / rate * 1e3 : void 0;
+    this.onDownloadProgress({
+      loaded: event.loaded,
+      total: event.total,
+      percent: event.loaded / event.total * 100,
+      rate,
+      estimated
+    });
+  }
+  /**
+   * 开始上传
+   */
+  startUpload() {
+    this.uploadStartTime = Date.now();
+  }
+  /**
+   * 开始下载
+   */
+  startDownload() {
+    this.downloadStartTime = Date.now();
+  }
+}
+exports.XHRProgressHandler = XHRProgressHandler;
+class FetchProgressHandler {
+  onDownloadProgress;
+  downloadStartTime = 0;
+  downloadedBytes = 0;
+  totalBytes = 0;
+  constructor(options) {
+    this.onDownloadProgress = options.onDownloadProgress;
+  }
+  /**
+   * 获取读取处理器
+   */
+  getReaderHandler() {
+    return (chunk, total) => {
+      this.downloadedBytes += chunk.length;
+      if (total !== void 0) {
+        this.totalBytes = total;
+      }
+      if (this.onDownloadProgress) {
+        const now = Date.now();
+        const elapsed = (now - this.downloadStartTime) / 1e3;
+        const rate = elapsed > 0 ? this.downloadedBytes / elapsed : 0;
+        const estimated = rate > 0 && this.totalBytes > 0 ? (this.totalBytes - this.downloadedBytes) / rate * 1e3 : void 0;
+        this.onDownloadProgress({
+          loaded: this.downloadedBytes,
+          total: this.totalBytes,
+          percent: this.totalBytes > 0 ? this.downloadedBytes / this.totalBytes * 100 : 0,
+          rate,
+          estimated
+        });
+      }
+    };
+  }
+  /**
+   * 开始下载
+   */
+  startDownload() {
+    this.downloadStartTime = Date.now();
+    this.downloadedBytes = 0;
+    this.totalBytes = 0;
+  }
+  /**
+   * 设置总字节数
+   */
+  setTotal(total) {
+    this.totalBytes = total;
+  }
+}
+exports.FetchProgressHandler = FetchProgressHandler;

package/dist/interceptors/progress.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 进度监听拦截器
+ * 支持上传和下载进度
+ */
+import type { InternalRequestOptions, RequestResponse } from '../types';
+/** 进度事件 */
+export interface ProgressEvent {
+    /** 已传输字节 */
+    loaded: number;
+    /** 总字节 */
+    total: number;
+    /** 进度百分比 (0-100) */
+    percent: number;
+    /** 传输速率 (bytes/s) */
+    rate?: number;
+    /** 预计剩余时间 (ms) */
+    estimated?: number;
+}
+/** 进度回调函数 */
+export type ProgressCallback = (event: ProgressEvent) => void;
+/** 进度拦截器配置 */
+export interface ProgressInterceptorOptions {
+    /** 上传进度回调 */
+    onUploadProgress?: ProgressCallback;
+    /** 下载进度回调 */
+    onDownloadProgress?: ProgressCallback;
+}
+/**
+ * 创建进度拦截器
+ */
+export declare function createProgressInterceptor(options: ProgressInterceptorOptions): {
+    /**
+     * 请求拦截 - 初始化上传进度
+     */
+    onRequest: (config: InternalRequestOptions) => InternalRequestOptions;
+    /**
+     * 响应拦截 - 初始化下载进度
+     */
+    onResponse: <T>(response: RequestResponse<T>) => RequestResponse<T>;
+    /**
+     * 获取上传进度处理器
+     */
+    getUploadHandler: (event: ProgressEvent) => void;
+    /**
+     * 获取下载进度处理器
+     */
+    getDownloadHandler: (event: ProgressEvent) => void;
+};
+/**
+ * XHR 进度处理器
+ * 用于传统浏览器的 XMLHttpRequest
+ */
+export declare class XHRProgressHandler {
+    private xhr;
+    private onUploadProgress?;
+    private onDownloadProgress?;
+    private uploadStartTime;
+    private downloadStartTime;
+    constructor(options: ProgressInterceptorOptions);
+    /**
+     * 绑定 XHR 事件
+     */
+    bind(xhr: XMLHttpRequest): void;
+    private handleUploadProgress;
+    private handleDownloadProgress;
+    /**
+     * 开始上传
+     */
+    startUpload(): void;
+    /**
+     * 开始下载
+     */
+    startDownload(): void;
+}
+/**
+ * Fetch 流式进度处理器
+ * 用于 Fetch API 的响应体流式读取
+ */
+export declare class FetchProgressHandler {
+    private onDownloadProgress?;
+    private downloadStartTime;
+    private downloadedBytes;
+    private totalBytes;
+    constructor(options: ProgressInterceptorOptions);
+    /**
+     * 获取读取处理器
+     */
+    getReaderHandler(): (chunk: Uint8Array, total?: number) => void;
+    /**
+     * 开始下载
+     */
+    startDownload(): void;
+    /**
+     * 设置总字节数
+     */
+    setTotal(total: number): void;
+}

package/dist/interceptors/progress.mjs

@@ -0,0 +1,177 @@
+export function createProgressInterceptor(options) {
+  const { onUploadProgress, onDownloadProgress } = options;
+  let uploadStartTime = 0;
+  let downloadStartTime = 0;
+  const calculateRate = (loaded, startTime) => {
+    const elapsed = (Date.now() - startTime) / 1e3;
+    return elapsed > 0 ? loaded / elapsed : 0;
+  };
+  const calculateEstimated = (loaded, total, rate) => {
+    if (rate <= 0 || total <= 0) return void 0;
+    const remaining = total - loaded;
+    return remaining > 0 ? remaining / rate * 1e3 : 0;
+  };
+  const createProgressHandler = (isUpload) => {
+    return (event) => {
+      const startTime = isUpload ? uploadStartTime : downloadStartTime;
+      const rate = calculateRate(event.loaded, startTime);
+      const estimated = calculateEstimated(event.loaded, event.total, rate);
+      const progressEvent = {
+        ...event,
+        rate,
+        estimated
+      };
+      if (isUpload) {
+        onUploadProgress?.(progressEvent);
+      } else {
+        onDownloadProgress?.(progressEvent);
+      }
+    };
+  };
+  return {
+    /**
+     * 请求拦截 - 初始化上传进度
+     */
+    onRequest: (config) => {
+      uploadStartTime = Date.now();
+      return config;
+    },
+    /**
+     * 响应拦截 - 初始化下载进度
+     */
+    onResponse: (response) => {
+      downloadStartTime = Date.now();
+      return response;
+    },
+    /**
+     * 获取上传进度处理器
+     */
+    getUploadHandler: createProgressHandler(true),
+    /**
+     * 获取下载进度处理器
+     */
+    getDownloadHandler: createProgressHandler(false)
+  };
+}
+export class XHRProgressHandler {
+  xhr = null;
+  onUploadProgress;
+  onDownloadProgress;
+  uploadStartTime = 0;
+  downloadStartTime = 0;
+  constructor(options) {
+    this.onUploadProgress = options.onUploadProgress;
+    this.onDownloadProgress = options.onDownloadProgress;
+  }
+  /**
+   * 绑定 XHR 事件
+   */
+  bind(xhr) {
+    this.xhr = xhr;
+    if (this.onUploadProgress) {
+      xhr.upload.addEventListener("progress", (event) => {
+        if (event.lengthComputable) {
+          this.handleUploadProgress(
+            event
+          );
+        }
+      });
+    }
+    if (this.onDownloadProgress) {
+      xhr.addEventListener("progress", (event) => {
+        if (event.lengthComputable) {
+          this.handleDownloadProgress(
+            event
+          );
+        }
+      });
+    }
+  }
+  handleUploadProgress(event) {
+    if (!this.onUploadProgress) return;
+    const now = Date.now();
+    const elapsed = (now - this.uploadStartTime) / 1e3;
+    const rate = elapsed > 0 ? event.loaded / elapsed : 0;
+    const estimated = rate > 0 ? (event.total - event.loaded) / rate * 1e3 : void 0;
+    this.onUploadProgress({
+      loaded: event.loaded,
+      total: event.total,
+      percent: event.loaded / event.total * 100,
+      rate,
+      estimated
+    });
+  }
+  handleDownloadProgress(event) {
+    if (!this.onDownloadProgress) return;
+    const now = Date.now();
+    const elapsed = (now - this.downloadStartTime) / 1e3;
+    const rate = elapsed > 0 ? event.loaded / elapsed : 0;
+    const estimated = rate > 0 ? (event.total - event.loaded) / rate * 1e3 : void 0;
+    this.onDownloadProgress({
+      loaded: event.loaded,
+      total: event.total,
+      percent: event.loaded / event.total * 100,
+      rate,
+      estimated
+    });
+  }
+  /**
+   * 开始上传
+   */
+  startUpload() {
+    this.uploadStartTime = Date.now();
+  }
+  /**
+   * 开始下载
+   */
+  startDownload() {
+    this.downloadStartTime = Date.now();
+  }
+}
+export class FetchProgressHandler {
+  onDownloadProgress;
+  downloadStartTime = 0;
+  downloadedBytes = 0;
+  totalBytes = 0;
+  constructor(options) {
+    this.onDownloadProgress = options.onDownloadProgress;
+  }
+  /**
+   * 获取读取处理器
+   */
+  getReaderHandler() {
+    return (chunk, total) => {
+      this.downloadedBytes += chunk.length;
+      if (total !== void 0) {
+        this.totalBytes = total;
+      }
+      if (this.onDownloadProgress) {
+        const now = Date.now();
+        const elapsed = (now - this.downloadStartTime) / 1e3;
+        const rate = elapsed > 0 ? this.downloadedBytes / elapsed : 0;
+        const estimated = rate > 0 && this.totalBytes > 0 ? (this.totalBytes - this.downloadedBytes) / rate * 1e3 : void 0;
+        this.onDownloadProgress({
+          loaded: this.downloadedBytes,
+          total: this.totalBytes,
+          percent: this.totalBytes > 0 ? this.downloadedBytes / this.totalBytes * 100 : 0,
+          rate,
+          estimated
+        });
+      }
+    };
+  }
+  /**
+   * 开始下载
+   */
+  startDownload() {
+    this.downloadStartTime = Date.now();
+    this.downloadedBytes = 0;
+    this.totalBytes = 0;
+  }
+  /**
+   * 设置总字节数
+   */
+  setTotal(total) {
+    this.totalBytes = total;
+  }
+}