@vlian/framework 1.0.0

package/dist/request/plugin/RequestPlugin.d.ts

@@ -0,0 +1,171 @@
+/**
+ * 请求插件系统
+ *
+ * 插件系统提供生命周期钩子，允许扩展请求能力
+ */
+import type { RequestOptions, Response, RequestContext } from '../types';
+/**
+ * 插件生命周期阶段
+ */
+export declare enum PluginLifecycleStage {
+    /**
+     * 初始化阶段
+     */
+    INIT = "init",
+    /**
+     * 请求前阶段
+     */
+    BEFORE_REQUEST = "beforeRequest",
+    /**
+     * 请求后阶段（成功）
+     */
+    AFTER_REQUEST = "afterRequest",
+    /**
+     * 错误处理阶段
+     */
+    ON_ERROR = "onError",
+    /**
+     * 最终阶段（无论成功或失败）
+     */
+    FINALLY = "finally"
+}
+/**
+ * 插件优先级
+ */
+export declare enum PluginPriority {
+    /**
+     * 最高优先级（如：认证、签名）
+     */
+    HIGHEST = 0,
+    /**
+     * 高优先级（如：请求转换、参数验证）
+     */
+    HIGH = 25,
+    /**
+     * 默认优先级
+     */
+    NORMAL = 50,
+    /**
+     * 低优先级（如：日志、监控）
+     */
+    LOW = 75,
+    /**
+     * 最低优先级（如：缓存、重试）
+     */
+    LOWEST = 100
+}
+/**
+ * 请求插件接口
+ *
+ * @template TRequestMeta - 请求元数据类型
+ * @template TResponseMeta - 响应元数据类型
+ * @template TContextMeta - 上下文元数据类型
+ */
+export interface RequestPlugin<TContextMeta = Record<string, unknown>> {
+    /**
+     * 插件名称
+     */
+    readonly name: string;
+    /**
+     * 插件版本
+     */
+    readonly version?: string;
+    /**
+     * 插件优先级（数字越小优先级越高）
+     */
+    readonly priority?: number;
+    /**
+     * 插件依赖列表（插件名称数组）
+     */
+    readonly dependencies?: string[];
+    /**
+     * 初始化钩子
+     *
+     * @param context - 请求上下文
+     */
+    onInit?(context: RequestContext<RequestOptions, Response, TContextMeta>): void | Promise<void>;
+    /**
+     * 请求前钩子
+     *
+     * 可以修改请求配置、添加请求头、验证参数等
+     *
+     * @param context - 请求上下文
+     * @returns 修改后的请求配置（可选）
+     */
+    onBeforeRequest?(context: RequestContext<RequestOptions, Response, TContextMeta>): RequestOptions | void | Promise<RequestOptions | void>;
+    /**
+     * 请求后钩子（成功）
+     *
+     * 可以修改响应数据、添加响应元数据等
+     *
+     * @param context - 请求上下文
+     * @returns 修改后的响应（可选）
+     */
+    onAfterRequest?(context: RequestContext<RequestOptions, Response, TContextMeta>): Response | void | Promise<Response | void>;
+    /**
+     * 错误处理钩子
+     *
+     * 可以处理错误、重试、降级等
+     *
+     * @param context - 请求上下文
+     * @returns 是否已处理错误（如果返回 true，错误不会继续传播）
+     */
+    onError?(context: RequestContext<RequestOptions, Response, TContextMeta>): boolean | void | Promise<boolean | void>;
+    /**
+     * 最终钩子（无论成功或失败）
+     *
+     * 可以清理资源、记录日志等
+     *
+     * @param context - 请求上下文
+     */
+    onFinally?(context: RequestContext<RequestOptions, Response, TContextMeta>): void | Promise<void>;
+}
+/**
+ * 插件管理器
+ */
+export declare class PluginManager {
+    private plugins;
+    private pluginOrder;
+    /**
+     * 注册插件
+     *
+     * @param plugin - 请求插件
+     */
+    register(plugin: RequestPlugin): void;
+    /**
+     * 注销插件
+     *
+     * @param name - 插件名称
+     */
+    unregister(name: string): void;
+    /**
+     * 获取插件
+     *
+     * @param name - 插件名称
+     * @returns 插件实例
+     */
+    get(name: string): RequestPlugin | undefined;
+    /**
+     * 获取所有插件
+     *
+     * @returns 插件数组
+     */
+    getAll(): RequestPlugin[];
+    /**
+     * 更新插件执行顺序（考虑依赖和优先级）
+     */
+    private updatePluginOrder;
+    /**
+     * 执行插件钩子
+     *
+     * @param stage - 生命周期阶段
+     * @param context - 请求上下文
+     * @returns 处理结果
+     */
+    executeHook<TContext extends RequestContext>(stage: PluginLifecycleStage, context: TContext): Promise<RequestOptions | Response | boolean | void>;
+    /**
+     * 清除所有插件
+     */
+    clear(): void;
+}
+//# sourceMappingURL=RequestPlugin.d.ts.map

package/dist/request/plugin/RequestPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestPlugin.d.ts","sourceRoot":"","sources":["../../../src/request/plugin/RequestPlugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAGzE;;GAEG;AACH,oBAAY,oBAAoB;IAC9B;;OAEG;IACH,IAAI,SAAS;IAEb;;OAEG;IACH,cAAc,kBAAkB;IAEhC;;OAEG;IACH,aAAa,iBAAiB;IAE9B;;OAEG;IACH,QAAQ,YAAY;IAEpB;;OAEG;IACH,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB;;OAEG;IACH,OAAO,IAAI;IAEX;;OAEG;IACH,IAAI,KAAK;IAET;;OAEG;IACH,MAAM,KAAK;IAEX;;OAEG;IACH,GAAG,KAAK;IAER;;OAEG;IACH,MAAM,MAAM;CACb;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa,CAAC,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjC;;;;OAIG;IACH,MAAM,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,cAAc,EAAE,QAAQ,EAAE,YAAY,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/F;;;;;;;OAOG;IACH,eAAe,CAAC,CACd,OAAO,EAAE,cAAc,CAAC,cAAc,EAAE,QAAQ,EAAE,YAAY,CAAC,GAC9D,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAE1D;;;;;;;OAOG;IACH,cAAc,CAAC,CACb,OAAO,EAAE,cAAc,CAAC,cAAc,EAAE,QAAQ,EAAE,YAAY,CAAC,GAC9D,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAE9C;;;;;;;OAOG;IACH,OAAO,CAAC,CACN,OAAO,EAAE,cAAc,CAAC,cAAc,EAAE,QAAQ,EAAE,YAAY,CAAC,GAC9D,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE5C;;;;;;OAMG;IACH,SAAS,CAAC,CACR,OAAO,EAAE,cAAc,CAAC,cAAc,EAAE,QAAQ,EAAE,YAAY,CAAC,GAC9D,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,WAAW,CAAgB;IAEnC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IASrC;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI5C;;;;OAIG;IACH,MAAM,IAAI,aAAa,EAAE;IAIzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkDzB;;;;;;OAMG;IACG,WAAW,CAAC,QAAQ,SAAS,cAAc,EAC/C,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,cAAc,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;IAmDtD;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/request/plugin/RequestPlugin.js

@@ -0,0 +1,203 @@
+/**
+ * 请求插件系统
+ * 
+ * 插件系统提供生命周期钩子，允许扩展请求能力
+ */ function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+import { logger } from "../../utils/logger";
+/**
+ * 插件生命周期阶段
+ */ export var PluginLifecycleStage = /*#__PURE__*/ function(PluginLifecycleStage) {
+    /**
+   * 初始化阶段
+   */ PluginLifecycleStage["INIT"] = "init";
+    /**
+   * 请求前阶段
+   */ PluginLifecycleStage["BEFORE_REQUEST"] = "beforeRequest";
+    /**
+   * 请求后阶段（成功）
+   */ PluginLifecycleStage["AFTER_REQUEST"] = "afterRequest";
+    /**
+   * 错误处理阶段
+   */ PluginLifecycleStage["ON_ERROR"] = "onError";
+    /**
+   * 最终阶段（无论成功或失败）
+   */ PluginLifecycleStage["FINALLY"] = "finally";
+    return PluginLifecycleStage;
+}({});
+/**
+ * 插件优先级
+ */ export var PluginPriority = /*#__PURE__*/ function(PluginPriority) {
+    /**
+   * 最高优先级（如：认证、签名）
+   */ PluginPriority[PluginPriority["HIGHEST"] = 0] = "HIGHEST";
+    /**
+   * 高优先级（如：请求转换、参数验证）
+   */ PluginPriority[PluginPriority["HIGH"] = 25] = "HIGH";
+    /**
+   * 默认优先级
+   */ PluginPriority[PluginPriority["NORMAL"] = 50] = "NORMAL";
+    /**
+   * 低优先级（如：日志、监控）
+   */ PluginPriority[PluginPriority["LOW"] = 75] = "LOW";
+    /**
+   * 最低优先级（如：缓存、重试）
+   */ PluginPriority[PluginPriority["LOWEST"] = 100] = "LOWEST";
+    return PluginPriority;
+}({});
+/**
+ * 插件管理器
+ */ export class PluginManager {
+    /**
+   * 注册插件
+   * 
+   * @param plugin - 请求插件
+   */ register(plugin) {
+        if (this.plugins.has(plugin.name)) {
+            logger.warn(`插件 ${plugin.name} 已存在，将被覆盖`);
+        }
+        this.plugins.set(plugin.name, plugin);
+        this.updatePluginOrder();
+    }
+    /**
+   * 注销插件
+   * 
+   * @param name - 插件名称
+   */ unregister(name) {
+        this.plugins.delete(name);
+        this.updatePluginOrder();
+    }
+    /**
+   * 获取插件
+   * 
+   * @param name - 插件名称
+   * @returns 插件实例
+   */ get(name) {
+        return this.plugins.get(name);
+    }
+    /**
+   * 获取所有插件
+   * 
+   * @returns 插件数组
+   */ getAll() {
+        return this.pluginOrder.map((name)=>this.plugins.get(name)).filter(Boolean);
+    }
+    /**
+   * 更新插件执行顺序（考虑依赖和优先级）
+   */ updatePluginOrder() {
+        const plugins = Array.from(this.plugins.values());
+        // 构建依赖图
+        const dependencyGraph = new Map();
+        const priorities = new Map();
+        for (const plugin of plugins){
+            dependencyGraph.set(plugin.name, plugin.dependencies || []);
+            priorities.set(plugin.name, plugin.priority ?? 50);
+        }
+        // 拓扑排序
+        const visited = new Set();
+        const visiting = new Set();
+        const result = [];
+        const visit = (pluginName)=>{
+            if (visiting.has(pluginName)) {
+                logger.warn(`检测到循环依赖，涉及插件: ${pluginName}`);
+                return;
+            }
+            if (visited.has(pluginName)) {
+                return;
+            }
+            visiting.add(pluginName);
+            const deps = dependencyGraph.get(pluginName) || [];
+            for (const dep of deps){
+                visit(dep);
+            }
+            visiting.delete(pluginName);
+            visited.add(pluginName);
+            result.push(pluginName);
+        };
+        // 按优先级排序后拓扑排序
+        const sortedPlugins = plugins.sort((a, b)=>{
+            const priorityA = priorities.get(a.name) ?? 50;
+            const priorityB = priorities.get(b.name) ?? 50;
+            return priorityA - priorityB;
+        });
+        for (const plugin of sortedPlugins){
+            visit(plugin.name);
+        }
+        this.pluginOrder = result;
+    }
+    /**
+   * 执行插件钩子
+   * 
+   * @param stage - 生命周期阶段
+   * @param context - 请求上下文
+   * @returns 处理结果
+   */ async executeHook(stage, context) {
+        const plugins = this.getAll();
+        for (const plugin of plugins){
+            // 检查是否跳过此插件
+            if (context.request.skipPlugins?.includes(plugin.name)) {
+                continue;
+            }
+            try {
+                let result = undefined;
+                switch(stage){
+                    case "init":
+                        result = await plugin.onInit?.(context);
+                        break;
+                    case "beforeRequest":
+                        result = await plugin.onBeforeRequest?.(context);
+                        if (result && typeof result === 'object' && 'url' in result) {
+                            context.request = result;
+                            // 如果返回了修改后的请求配置，立即返回
+                            return result;
+                        }
+                        break;
+                    case "afterRequest":
+                        result = await plugin.onAfterRequest?.(context);
+                        if (result && typeof result === 'object' && 'data' in result) {
+                            context.response = result;
+                            // 如果返回了修改后的响应，立即返回
+                            return result;
+                        }
+                        break;
+                    case "onError":
+                        result = await plugin.onError?.(context);
+                        if (result === true) {
+                            return true; // 错误已处理，停止传播
+                        }
+                        break;
+                    case "finally":
+                        await plugin.onFinally?.(context);
+                        break;
+                }
+            } catch (error) {
+                logger.error(`插件 ${plugin.name} 的 ${stage} 钩子执行失败:`, error);
+            // 继续执行其他插件
+            }
+        }
+        return undefined;
+    }
+    /**
+   * 清除所有插件
+   */ clear() {
+        this.plugins.clear();
+        this.pluginOrder = [];
+    }
+    constructor(){
+        _define_property(this, "plugins", new Map());
+        _define_property(this, "pluginOrder", []);
+    }
+}
+
+//# sourceMappingURL=RequestPlugin.js.map

package/dist/request/plugin/RequestPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/request/plugin/RequestPlugin.ts"],"sourcesContent":["/**\n * 请求插件系统\n * \n * 插件系统提供生命周期钩子，允许扩展请求能力\n */\n\nimport type { RequestOptions, Response, RequestContext } from '../types';\nimport { logger } from '../../utils/logger';\n\n/**\n * 插件生命周期阶段\n */\nexport enum PluginLifecycleStage {\n  /**\n   * 初始化阶段\n   */\n  INIT = 'init',\n\n  /**\n   * 请求前阶段\n   */\n  BEFORE_REQUEST = 'beforeRequest',\n\n  /**\n   * 请求后阶段（成功）\n   */\n  AFTER_REQUEST = 'afterRequest',\n\n  /**\n   * 错误处理阶段\n   */\n  ON_ERROR = 'onError',\n\n  /**\n   * 最终阶段（无论成功或失败）\n   */\n  FINALLY = 'finally',\n}\n\n/**\n * 插件优先级\n */\nexport enum PluginPriority {\n  /**\n   * 最高优先级（如：认证、签名）\n   */\n  HIGHEST = 0,\n\n  /**\n   * 高优先级（如：请求转换、参数验证）\n   */\n  HIGH = 25,\n\n  /**\n   * 默认优先级\n   */\n  NORMAL = 50,\n\n  /**\n   * 低优先级（如：日志、监控）\n   */\n  LOW = 75,\n\n  /**\n   * 最低优先级（如：缓存、重试）\n   */\n  LOWEST = 100,\n}\n\n/**\n * 请求插件接口\n * \n * @template TRequestMeta - 请求元数据类型\n * @template TResponseMeta - 响应元数据类型\n * @template TContextMeta - 上下文元数据类型\n */\nexport interface RequestPlugin<TContextMeta = Record<string, unknown>> {\n  /**\n   * 插件名称\n   */\n  readonly name: string;\n\n  /**\n   * 插件版本\n   */\n  readonly version?: string;\n\n  /**\n   * 插件优先级（数字越小优先级越高）\n   */\n  readonly priority?: number;\n\n  /**\n   * 插件依赖列表（插件名称数组）\n   */\n  readonly dependencies?: string[];\n\n  /**\n   * 初始化钩子\n   * \n   * @param context - 请求上下文\n   */\n  onInit?(context: RequestContext<RequestOptions, Response, TContextMeta>): void | Promise<void>;\n\n  /**\n   * 请求前钩子\n   * \n   * 可以修改请求配置、添加请求头、验证参数等\n   * \n   * @param context - 请求上下文\n   * @returns 修改后的请求配置（可选）\n   */\n  onBeforeRequest?(\n    context: RequestContext<RequestOptions, Response, TContextMeta>\n  ): RequestOptions | void | Promise<RequestOptions | void>;\n\n  /**\n   * 请求后钩子（成功）\n   * \n   * 可以修改响应数据、添加响应元数据等\n   * \n   * @param context - 请求上下文\n   * @returns 修改后的响应（可选）\n   */\n  onAfterRequest?(\n    context: RequestContext<RequestOptions, Response, TContextMeta>\n  ): Response | void | Promise<Response | void>;\n\n  /**\n   * 错误处理钩子\n   * \n   * 可以处理错误、重试、降级等\n   * \n   * @param context - 请求上下文\n   * @returns 是否已处理错误（如果返回 true，错误不会继续传播）\n   */\n  onError?(\n    context: RequestContext<RequestOptions, Response, TContextMeta>\n  ): boolean | void | Promise<boolean | void>;\n\n  /**\n   * 最终钩子（无论成功或失败）\n   * \n   * 可以清理资源、记录日志等\n   * \n   * @param context - 请求上下文\n   */\n  onFinally?(\n    context: RequestContext<RequestOptions, Response, TContextMeta>\n  ): void | Promise<void>;\n}\n\n/**\n * 插件管理器\n */\nexport class PluginManager {\n  private plugins: Map<string, RequestPlugin> = new Map();\n  private pluginOrder: string[] = [];\n\n  /**\n   * 注册插件\n   * \n   * @param plugin - 请求插件\n   */\n  register(plugin: RequestPlugin): void {\n    if (this.plugins.has(plugin.name)) {\n      logger.warn(`插件 ${plugin.name} 已存在，将被覆盖`);\n    }\n\n    this.plugins.set(plugin.name, plugin);\n    this.updatePluginOrder();\n  }\n\n  /**\n   * 注销插件\n   * \n   * @param name - 插件名称\n   */\n  unregister(name: string): void {\n    this.plugins.delete(name);\n    this.updatePluginOrder();\n  }\n\n  /**\n   * 获取插件\n   * \n   * @param name - 插件名称\n   * @returns 插件实例\n   */\n  get(name: string): RequestPlugin | undefined {\n    return this.plugins.get(name);\n  }\n\n  /**\n   * 获取所有插件\n   * \n   * @returns 插件数组\n   */\n  getAll(): RequestPlugin[] {\n    return this.pluginOrder.map((name) => this.plugins.get(name)!).filter(Boolean);\n  }\n\n  /**\n   * 更新插件执行顺序（考虑依赖和优先级）\n   */\n  private updatePluginOrder(): void {\n    const plugins = Array.from(this.plugins.values());\n\n    // 构建依赖图\n    const dependencyGraph = new Map<string, string[]>();\n    const priorities = new Map<string, number>();\n\n    for (const plugin of plugins) {\n      dependencyGraph.set(plugin.name, plugin.dependencies || []);\n      priorities.set(plugin.name, plugin.priority ?? PluginPriority.NORMAL);\n    }\n\n    // 拓扑排序\n    const visited = new Set<string>();\n    const visiting = new Set<string>();\n    const result: string[] = [];\n\n    const visit = (pluginName: string): void => {\n      if (visiting.has(pluginName)) {\n        logger.warn(`检测到循环依赖，涉及插件: ${pluginName}`);\n        return;\n      }\n      if (visited.has(pluginName)) {\n        return;\n      }\n\n      visiting.add(pluginName);\n      const deps = dependencyGraph.get(pluginName) || [];\n      for (const dep of deps) {\n        visit(dep);\n      }\n      visiting.delete(pluginName);\n      visited.add(pluginName);\n      result.push(pluginName);\n    };\n\n    // 按优先级排序后拓扑排序\n    const sortedPlugins = plugins.sort((a, b) => {\n      const priorityA = priorities.get(a.name) ?? PluginPriority.NORMAL;\n      const priorityB = priorities.get(b.name) ?? PluginPriority.NORMAL;\n      return priorityA - priorityB;\n    });\n\n    for (const plugin of sortedPlugins) {\n      visit(plugin.name);\n    }\n\n    this.pluginOrder = result;\n  }\n\n  /**\n   * 执行插件钩子\n   * \n   * @param stage - 生命周期阶段\n   * @param context - 请求上下文\n   * @returns 处理结果\n   */\n  async executeHook<TContext extends RequestContext>(\n    stage: PluginLifecycleStage,\n    context: TContext\n  ): Promise<RequestOptions | Response | boolean | void> {\n    const plugins = this.getAll();\n\n    for (const plugin of plugins) {\n      // 检查是否跳过此插件\n      if (context.request.skipPlugins?.includes(plugin.name)) {\n        continue;\n      }\n\n      try {\n        let result: RequestOptions | Response | boolean | void = undefined;\n\n        switch (stage) {\n          case PluginLifecycleStage.INIT:\n            result = await plugin.onInit?.(context);\n            break;\n          case PluginLifecycleStage.BEFORE_REQUEST:\n            result = await plugin.onBeforeRequest?.(context);\n            if (result && typeof result === 'object' && 'url' in result) {\n              context.request = result as RequestOptions;\n              // 如果返回了修改后的请求配置，立即返回\n              return result as RequestOptions;\n            }\n            break;\n          case PluginLifecycleStage.AFTER_REQUEST:\n            result = await plugin.onAfterRequest?.(context);\n            if (result && typeof result === 'object' && 'data' in result) {\n              context.response = result as Response;\n              // 如果返回了修改后的响应，立即返回\n              return result as Response;\n            }\n            break;\n          case PluginLifecycleStage.ON_ERROR:\n            result = await plugin.onError?.(context);\n            if (result === true) {\n              return true; // 错误已处理，停止传播\n            }\n            break;\n          case PluginLifecycleStage.FINALLY:\n            await plugin.onFinally?.(context);\n            break;\n        }\n      } catch (error) {\n        logger.error(`插件 ${plugin.name} 的 ${stage} 钩子执行失败:`, error);\n        // 继续执行其他插件\n      }\n    }\n\n    return undefined;\n  }\n\n  /**\n   * 清除所有插件\n   */\n  clear(): void {\n    this.plugins.clear();\n    this.pluginOrder = [];\n  }\n}\n"],"names":["logger","PluginLifecycleStage","PluginPriority","PluginManager","register","plugin","plugins","has","name","warn","set","updatePluginOrder","unregister","delete","get","getAll","pluginOrder","map","filter","Boolean","Array","from","values","dependencyGraph","Map","priorities","dependencies","priority","visited","Set","visiting","result","visit","pluginName","add","deps","dep","push","sortedPlugins","sort","a","b","priorityA","priorityB","executeHook","stage","context","request","skipPlugins","includes","undefined","onInit","onBeforeRequest","onAfterRequest","response","onError","onFinally","error","clear"],"mappings":"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"}

package/dist/request/plugin/cache.cjs

@@ -0,0 +1,269 @@
+/**
+ * 缓存插件
+ * 
+ * 提供请求缓存能力，支持内存、localStorage、sessionStorage 存储
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "createCachePlugin", {
+    enumerable: true,
+    get: function() {
+        return createCachePlugin;
+    }
+});
+const _RequestPlugin = require("./RequestPlugin");
+const _logger = require("../../utils/logger");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * 内存缓存存储实现
+ */ let MemoryCacheStorage = class MemoryCacheStorage {
+    async get(key) {
+        const item = this.cache.get(key);
+        if (!item) {
+            return null;
+        }
+        if (Date.now() > item.expires) {
+            this.cache.delete(key);
+            return null;
+        }
+        return item.value;
+    }
+    async set(key, value, ttl) {
+        const expires = Date.now() + ttl;
+        this.cache.set(key, {
+            value,
+            expires
+        });
+    }
+    async delete(key) {
+        this.cache.delete(key);
+    }
+    async clear() {
+        this.cache.clear();
+    }
+    constructor(){
+        _define_property(this, "cache", new Map());
+    }
+};
+/**
+ * LocalStorage 缓存存储实现
+ */ let LocalStorageCacheStorage = class LocalStorageCacheStorage {
+    async get(key) {
+        if (typeof localStorage === 'undefined') {
+            return null;
+        }
+        try {
+            const item = localStorage.getItem(this.prefix + key);
+            if (!item) {
+                return null;
+            }
+            const { value, expires } = JSON.parse(item);
+            if (Date.now() > expires) {
+                localStorage.removeItem(this.prefix + key);
+                return null;
+            }
+            return value;
+        } catch  {
+            return null;
+        }
+    }
+    async set(key, value, ttl) {
+        if (typeof localStorage === 'undefined') {
+            return;
+        }
+        try {
+            const expires = Date.now() + ttl;
+            localStorage.setItem(this.prefix + key, JSON.stringify({
+                value,
+                expires
+            }));
+        } catch (error) {
+            // 存储失败（可能是存储空间不足）
+            _logger.logger.warn('缓存存储失败:', error);
+        }
+    }
+    async delete(key) {
+        if (typeof localStorage === 'undefined') {
+            return;
+        }
+        localStorage.removeItem(this.prefix + key);
+    }
+    async clear() {
+        if (typeof localStorage === 'undefined') {
+            return;
+        }
+        const keys = Object.keys(localStorage);
+        for (const key of keys){
+            if (key.startsWith(this.prefix)) {
+                localStorage.removeItem(key);
+            }
+        }
+    }
+    constructor(){
+        _define_property(this, "prefix", 'request_cache_');
+    }
+};
+/**
+ * SessionStorage 缓存存储实现
+ */ let SessionStorageCacheStorage = class SessionStorageCacheStorage {
+    async get(key) {
+        if (typeof sessionStorage === 'undefined') {
+            return null;
+        }
+        try {
+            const item = sessionStorage.getItem(this.prefix + key);
+            if (!item) {
+                return null;
+            }
+            const { value, expires } = JSON.parse(item);
+            if (Date.now() > expires) {
+                sessionStorage.removeItem(this.prefix + key);
+                return null;
+            }
+            return value;
+        } catch  {
+            return null;
+        }
+    }
+    async set(key, value, ttl) {
+        if (typeof sessionStorage === 'undefined') {
+            return;
+        }
+        try {
+            const expires = Date.now() + ttl;
+            sessionStorage.setItem(this.prefix + key, JSON.stringify({
+                value,
+                expires
+            }));
+        } catch (error) {
+            _logger.logger.warn('缓存存储失败:', error);
+        }
+    }
+    async delete(key) {
+        if (typeof sessionStorage === 'undefined') {
+            return;
+        }
+        sessionStorage.removeItem(this.prefix + key);
+    }
+    async clear() {
+        if (typeof sessionStorage === 'undefined') {
+            return;
+        }
+        const keys = Object.keys(sessionStorage);
+        for (const key of keys){
+            if (key.startsWith(this.prefix)) {
+                sessionStorage.removeItem(key);
+            }
+        }
+    }
+    constructor(){
+        _define_property(this, "prefix", 'request_cache_');
+    }
+};
+/**
+ * 获取缓存存储实例
+ */ function getCacheStorage(storage = 'memory') {
+    switch(storage){
+        case 'localStorage':
+            return new LocalStorageCacheStorage();
+        case 'sessionStorage':
+            return new SessionStorageCacheStorage();
+        case 'memory':
+        default:
+            return new MemoryCacheStorage();
+    }
+}
+/**
+ * 生成缓存键
+ */ function generateCacheKey(request) {
+    const { url, method = 'GET', query, body } = request;
+    const cacheKey = request.cache?.key || `${method}:${url}`;
+    // 包含查询参数和请求体（如果存在）
+    const keyParts = [
+        cacheKey
+    ];
+    if (query) {
+        keyParts.push(JSON.stringify(query));
+    }
+    if (body && typeof body === 'object') {
+        keyParts.push(JSON.stringify(body));
+    }
+    return keyParts.join('|');
+}
+function createCachePlugin(config = {}) {
+    const { defaultTTL = 5 * 60 * 1000, defaultStorage = 'memory', enabled = true } = config;
+    return {
+        name: 'cache',
+        priority: _RequestPlugin.PluginPriority.LOWEST,
+        async onBeforeRequest (context) {
+            if (!enabled) {
+                return;
+            }
+            const cacheConfig = context.request.cache;
+            if (!cacheConfig) {
+                // 如果没有配置缓存，跳过
+                return;
+            }
+            // 如果强制刷新，跳过缓存
+            if (cacheConfig.forceRefresh) {
+                return;
+            }
+            // 只缓存 GET 请求
+            if (context.request.method && context.request.method !== 'GET') {
+                return;
+            }
+            const storage = getCacheStorage(cacheConfig.storage || defaultStorage);
+            const cacheKey = generateCacheKey(context.request);
+            // 尝试从缓存获取
+            const cachedResponse = await storage.get(cacheKey);
+            if (cachedResponse) {
+                // 缓存命中，标记并设置缓存的响应
+                context.meta.hit = true;
+                context.response = cachedResponse;
+                // 标记请求已取消，避免实际发送请求
+                context.cancelled = true;
+                return;
+            }
+            // 缓存未命中
+            context.meta.hit = false;
+        },
+        async onAfterRequest (context) {
+            if (!enabled || !context.response) {
+                return;
+            }
+            const cacheConfig = context.request.cache;
+            if (!cacheConfig) {
+                return;
+            }
+            // 检查是否应该缓存
+            const shouldCache = cacheConfig.shouldCache ? cacheConfig.shouldCache(context.response) : context.response.status >= 200 && context.response.status < 300;
+            if (!shouldCache) {
+                return;
+            }
+            // 只缓存 GET 请求
+            if (context.request.method && context.request.method !== 'GET') {
+                return;
+            }
+            const storage = getCacheStorage(cacheConfig.storage || defaultStorage);
+            const cacheKey = generateCacheKey(context.request);
+            const ttl = cacheConfig.ttl || defaultTTL;
+            // 存储到缓存
+            await storage.set(cacheKey, context.response, ttl);
+        }
+    };
+}
+
+//# sourceMappingURL=cache.js.map