@vlian/framework 1.1.0 → 1.1.1

package/dist/request/utils/RequestQueueManager.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 请求队列管理器
+ *
+ * 用于管理待执行的请求队列，支持请求拦截、暂停、恢复等功能
+ */
+import type { RequestOptions, Response } from '../types';
+/**
+ * 请求队列管理器
+ */
+declare class RequestQueueManager {
+    private static instance;
+    /**
+     * 待执行的请求队列
+     */
+    private queue;
+    /**
+     * 队列状态
+     */
+    private state;
+    /**
+     * 当前正在执行的回调 Promise
+     */
+    private processingPromise;
+    /**
+     * 获取单例实例
+     */
+    static getInstance(): RequestQueueManager;
+    /**
+     * 检查队列是否处于暂停状态
+     */
+    isPaused(): boolean;
+    /**
+     * 暂停队列，后续请求会被放入队列
+     */
+    pause(): void;
+    /**
+     * 恢复队列，执行队列中的所有请求
+     */
+    resume(): Promise<void>;
+    /**
+     * 执行回调并等待完成，然后恢复队列
+     *
+     * @param callback - 回调函数
+     */
+    processAndResume(callback: () => Promise<void> | void): Promise<void>;
+    /**
+     * 将请求添加到队列
+     *
+     * @template TResponse - 响应数据类型
+     * @param options - 请求配置
+     * @param execute - 请求执行函数
+     * @returns Promise 解析为响应对象
+     */
+    enqueue<TResponse = unknown>(options: RequestOptions<TResponse>, execute: () => Promise<Response<TResponse>>): Promise<Response<TResponse>>;
+    /**
+     * 获取队列长度
+     */
+    getQueueLength(): number;
+    /**
+     * 清空队列
+     *
+     * @param reason - 清空原因（用于错误信息）
+     */
+    clear(reason?: string): void;
+    /**
+     * 销毁管理器
+     */
+    destroy(): void;
+}
+/**
+ * 获取请求队列管理器实例
+ */
+export declare function getRequestQueueManager(): RequestQueueManager;
+export {};
+//# sourceMappingURL=RequestQueueManager.d.ts.map

package/dist/request/utils/RequestQueueManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestQueueManager.d.ts","sourceRoot":"","sources":["../../../src/request/utils/RequestQueueManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAoDzD;;GAEG;AACH,cAAM,mBAAmB;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoC;IAE3D;;OAEG;IACH,OAAO,CAAC,KAAK,CAAuB;IAEpC;;OAEG;IACH,OAAO,CAAC,KAAK,CAA+B;IAE5C;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAA8B;IAEvD;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,mBAAmB;IAOzC;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB7B;;;;OAIG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB3E;;;;;;;OAOG;IACG,OAAO,CAAC,SAAS,GAAG,OAAO,EAC/B,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,EAClC,OAAO,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,GAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAY/B;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAiB5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAE5D"}

package/dist/request/utils/RequestQueueManager.js

@@ -0,0 +1,160 @@
+/**
+ * 请求队列管理器
+ * 
+ * 用于管理待执行的请求队列，支持请求拦截、暂停、恢复等功能
+ */ 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;
+}
+/**
+ * 队列状态
+ */ var QueueState = /*#__PURE__*/ function(QueueState) {
+    /**
+   * 正常状态，请求可以正常执行
+   */ QueueState["IDLE"] = "idle";
+    /**
+   * 暂停状态，请求会被放入队列
+   */ QueueState["PAUSED"] = "paused";
+    /**
+   * 处理中状态，正在执行回调
+   */ QueueState["PROCESSING"] = "processing";
+    return QueueState;
+}(QueueState || {});
+/**
+ * 请求队列管理器
+ */ let RequestQueueManager = class RequestQueueManager {
+    /**
+   * 获取单例实例
+   */ static getInstance() {
+        if (!RequestQueueManager.instance) {
+            RequestQueueManager.instance = new RequestQueueManager();
+        }
+        return RequestQueueManager.instance;
+    }
+    /**
+   * 检查队列是否处于暂停状态
+   */ isPaused() {
+        return this.state === "paused" || this.state === "processing";
+    }
+    /**
+   * 暂停队列，后续请求会被放入队列
+   */ pause() {
+        if (this.state === "idle") {
+            this.state = "paused";
+        }
+    }
+    /**
+   * 恢复队列，执行队列中的所有请求
+   */ async resume() {
+        if (this.state === "idle") {
+            return;
+        }
+        this.state = "idle";
+        // 执行队列中的所有请求
+        const requests = [
+            ...this.queue
+        ];
+        this.queue = [];
+        // 并行执行所有请求
+        await Promise.allSettled(requests.map((item)=>{
+            return item.execute().then(item.resolve).catch(item.reject);
+        }));
+    }
+    /**
+   * 执行回调并等待完成，然后恢复队列
+   * 
+   * @param callback - 回调函数
+   */ async processAndResume(callback) {
+        if (this.state === "processing") {
+            // 如果已经在处理中，等待当前处理完成
+            if (this.processingPromise) {
+                await this.processingPromise;
+            }
+            return;
+        }
+        this.state = "processing";
+        try {
+            // 执行回调
+            this.processingPromise = Promise.resolve(callback());
+            await this.processingPromise;
+        } finally{
+            this.processingPromise = null;
+            // 恢复队列
+            await this.resume();
+        }
+    }
+    /**
+   * 将请求添加到队列
+   * 
+   * @template TResponse - 响应数据类型
+   * @param options - 请求配置
+   * @param execute - 请求执行函数
+   * @returns Promise 解析为响应对象
+   */ async enqueue(options, execute) {
+        return new Promise((resolve, reject)=>{
+            this.queue.push({
+                options: options,
+                execute: execute,
+                resolve: resolve,
+                reject,
+                timestamp: Date.now()
+            });
+        });
+    }
+    /**
+   * 获取队列长度
+   */ getQueueLength() {
+        return this.queue.length;
+    }
+    /**
+   * 清空队列
+   * 
+   * @param reason - 清空原因（用于错误信息）
+   */ clear(reason) {
+        const requests = [
+            ...this.queue
+        ];
+        this.queue = [];
+        // 拒绝所有待执行的请求
+        const error = reason ? new Error(`请求队列已清空: ${reason}`) : new Error('请求队列已清空');
+        requests.forEach((item)=>{
+            item.reject(error);
+        });
+        this.state = "idle";
+        this.processingPromise = null;
+    }
+    /**
+   * 销毁管理器
+   */ destroy() {
+        this.clear('管理器已销毁');
+        RequestQueueManager.instance = null;
+    }
+    constructor(){
+        /**
+   * 待执行的请求队列
+   */ _define_property(this, "queue", []);
+        /**
+   * 队列状态
+   */ _define_property(this, "state", "idle");
+        /**
+   * 当前正在执行的回调 Promise
+   */ _define_property(this, "processingPromise", null);
+    }
+};
+_define_property(RequestQueueManager, "instance", null);
+/**
+ * 获取请求队列管理器实例
+ */ export function getRequestQueueManager() {
+    return RequestQueueManager.getInstance();
+}
+
+//# sourceMappingURL=RequestQueueManager.js.map

package/dist/request/utils/RequestQueueManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/request/utils/RequestQueueManager.ts"],"sourcesContent":["/**\n * 请求队列管理器\n * \n * 用于管理待执行的请求队列，支持请求拦截、暂停、恢复等功能\n */\n\nimport type { RequestOptions, Response } from '../types';\n\n/**\n * 待执行的请求项\n */\ninterface QueuedRequest {\n  /**\n   * 请求配置\n   */\n  options: RequestOptions<unknown>;\n  \n  /**\n   * 请求执行函数\n   */\n  execute: () => Promise<Response<unknown>>;\n  \n  /**\n   * Promise resolve 函数\n   */\n  resolve: (response: Response<unknown>) => void;\n  \n  /**\n   * Promise reject 函数\n   */\n  reject: (error: unknown) => void;\n  \n  /**\n   * 请求时间戳\n   */\n  timestamp: number;\n}\n\n/**\n * 队列状态\n */\nenum QueueState {\n  /**\n   * 正常状态，请求可以正常执行\n   */\n  IDLE = 'idle',\n  \n  /**\n   * 暂停状态，请求会被放入队列\n   */\n  PAUSED = 'paused',\n  \n  /**\n   * 处理中状态，正在执行回调\n   */\n  PROCESSING = 'processing',\n}\n\n/**\n * 请求队列管理器\n */\nclass RequestQueueManager {\n  private static instance: RequestQueueManager | null = null;\n  \n  /**\n   * 待执行的请求队列\n   */\n  private queue: QueuedRequest[] = [];\n  \n  /**\n   * 队列状态\n   */\n  private state: QueueState = QueueState.IDLE;\n  \n  /**\n   * 当前正在执行的回调 Promise\n   */\n  private processingPromise: Promise<void> | null = null;\n  \n  /**\n   * 获取单例实例\n   */\n  static getInstance(): RequestQueueManager {\n    if (!RequestQueueManager.instance) {\n      RequestQueueManager.instance = new RequestQueueManager();\n    }\n    return RequestQueueManager.instance;\n  }\n  \n  /**\n   * 检查队列是否处于暂停状态\n   */\n  isPaused(): boolean {\n    return this.state === QueueState.PAUSED || this.state === QueueState.PROCESSING;\n  }\n  \n  /**\n   * 暂停队列，后续请求会被放入队列\n   */\n  pause(): void {\n    if (this.state === QueueState.IDLE) {\n      this.state = QueueState.PAUSED;\n    }\n  }\n  \n  /**\n   * 恢复队列，执行队列中的所有请求\n   */\n  async resume(): Promise<void> {\n    if (this.state === QueueState.IDLE) {\n      return;\n    }\n    \n    this.state = QueueState.IDLE;\n    \n    // 执行队列中的所有请求\n    const requests = [...this.queue];\n    this.queue = [];\n    \n    // 并行执行所有请求\n    await Promise.allSettled(\n      requests.map((item) => {\n        return item\n          .execute()\n          .then(item.resolve)\n          .catch(item.reject);\n      })\n    );\n  }\n  \n  /**\n   * 执行回调并等待完成，然后恢复队列\n   * \n   * @param callback - 回调函数\n   */\n  async processAndResume(callback: () => Promise<void> | void): Promise<void> {\n    if (this.state === QueueState.PROCESSING) {\n      // 如果已经在处理中，等待当前处理完成\n      if (this.processingPromise) {\n        await this.processingPromise;\n      }\n      return;\n    }\n    \n    this.state = QueueState.PROCESSING;\n    \n    try {\n      // 执行回调\n      this.processingPromise = Promise.resolve(callback());\n      await this.processingPromise;\n    } finally {\n      this.processingPromise = null;\n      // 恢复队列\n      await this.resume();\n    }\n  }\n  \n  /**\n   * 将请求添加到队列\n   * \n   * @template TResponse - 响应数据类型\n   * @param options - 请求配置\n   * @param execute - 请求执行函数\n   * @returns Promise 解析为响应对象\n   */\n  async enqueue<TResponse = unknown>(\n    options: RequestOptions<TResponse>,\n    execute: () => Promise<Response<TResponse>>\n  ): Promise<Response<TResponse>> {\n    return new Promise<Response<TResponse>>((resolve, reject) => {\n      this.queue.push({\n        options: options as RequestOptions<unknown>,\n        execute: execute as () => Promise<Response<unknown>>,\n        resolve: resolve as (response: Response<unknown>) => void,\n        reject,\n        timestamp: Date.now(),\n      });\n    });\n  }\n  \n  /**\n   * 获取队列长度\n   */\n  getQueueLength(): number {\n    return this.queue.length;\n  }\n  \n  /**\n   * 清空队列\n   * \n   * @param reason - 清空原因（用于错误信息）\n   */\n  clear(reason?: string): void {\n    const requests = [...this.queue];\n    this.queue = [];\n    \n    // 拒绝所有待执行的请求\n    const error = reason\n      ? new Error(`请求队列已清空: ${reason}`)\n      : new Error('请求队列已清空');\n    \n    requests.forEach((item) => {\n      item.reject(error);\n    });\n    \n    this.state = QueueState.IDLE;\n    this.processingPromise = null;\n  }\n  \n  /**\n   * 销毁管理器\n   */\n  destroy(): void {\n    this.clear('管理器已销毁');\n    RequestQueueManager.instance = null;\n  }\n}\n\n/**\n * 获取请求队列管理器实例\n */\nexport function getRequestQueueManager(): RequestQueueManager {\n  return RequestQueueManager.getInstance();\n}\n"],"names":["QueueState","RequestQueueManager","getInstance","instance","isPaused","state","pause","resume","requests","queue","Promise","allSettled","map","item","execute","then","resolve","catch","reject","processAndResume","callback","processingPromise","enqueue","options","push","timestamp","Date","now","getQueueLength","length","clear","reason","error","Error","forEach","destroy","getRequestQueueManager"],"mappings":"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"}

package/dist/request/utils/index.cjs

@@ -17,10 +17,14 @@ _export(exports, {
     get createDependencyError () {
         return _dependencyCheck.createDependencyError;
     },
+    get getRequestQueueManager () {
+        return _RequestQueueManager.getRequestQueueManager;
+    },
     get requireDependency () {
         return _dependencyCheck.requireDependency;
     }
 });
 const _dependencyCheck = require("./dependencyCheck");
+const _RequestQueueManager = require("./RequestQueueManager");
 
 //# sourceMappingURL=index.js.map

package/dist/request/utils/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/request/utils/index.ts"],"sourcesContent":["/**\n * 请求库工具函数\n */\n\nexport {\n  checkDependency,\n  createDependencyError,\n  requireDependency,\n  type DependencyInfo,\n} from './dependencyCheck';\n"],"names":["checkDependency","createDependencyError","requireDependency"],"mappings":"AAAA;;CAEC;;;;;;;;;;;QAGCA;eAAAA,gCAAe;;QACfC;eAAAA,sCAAqB;;QACrBC;eAAAA,kCAAiB;;;iCAEZ"}
+{"version":3,"sources":["../../../src/request/utils/index.ts"],"sourcesContent":["/**\n * 请求库工具函数\n */\n\nexport {\n  checkDependency,\n  createDependencyError,\n  requireDependency,\n  type DependencyInfo,\n} from './dependencyCheck';\n\nexport { getRequestQueueManager } from './RequestQueueManager';\n"],"names":["checkDependency","createDependencyError","getRequestQueueManager","requireDependency"],"mappings":"AAAA;;CAEC;;;;;;;;;;;QAGCA;eAAAA,gCAAe;;QACfC;eAAAA,sCAAqB;;QAKdC;eAAAA,2CAAsB;;QAJ7BC;eAAAA,kCAAiB;;;iCAEZ;qCAEgC"}

package/dist/request/utils/index.d.ts

@@ -2,4 +2,5 @@
  * 请求库工具函数
  */
 export { checkDependency, createDependencyError, requireDependency, type DependencyInfo, } from './dependencyCheck';
+export { getRequestQueueManager } from './RequestQueueManager';
 //# sourceMappingURL=index.d.ts.map

package/dist/request/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/request/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/request/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/request/utils/index.js

@@ -1,5 +1,6 @@
 /**
  * 请求库工具函数
  */ export { checkDependency, createDependencyError, requireDependency } from "./dependencyCheck";
+export { getRequestQueueManager } from "./RequestQueueManager";
 
 //# sourceMappingURL=index.js.map

package/dist/request/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/request/utils/index.ts"],"sourcesContent":["/**\n * 请求库工具函数\n */\n\nexport {\n  checkDependency,\n  createDependencyError,\n  requireDependency,\n  type DependencyInfo,\n} from './dependencyCheck';\n"],"names":["checkDependency","createDependencyError","requireDependency"],"mappings":"AAAA;;CAEC,GAED,SACEA,eAAe,EACfC,qBAAqB,EACrBC,iBAAiB,QAEZ,oBAAoB"}
+{"version":3,"sources":["../../../src/request/utils/index.ts"],"sourcesContent":["/**\n * 请求库工具函数\n */\n\nexport {\n  checkDependency,\n  createDependencyError,\n  requireDependency,\n  type DependencyInfo,\n} from './dependencyCheck';\n\nexport { getRequestQueueManager } from './RequestQueueManager';\n"],"names":["checkDependency","createDependencyError","requireDependency","getRequestQueueManager"],"mappings":"AAAA;;CAEC,GAED,SACEA,eAAe,EACfC,qBAAqB,EACrBC,iBAAiB,QAEZ,oBAAoB;AAE3B,SAASC,sBAAsB,QAAQ,wBAAwB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vlian/framework",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "private": false,
   "packageManager": "pnpm@10.27.0",
   "description": "Secra Framework - 一个现代化的低代码框架",