@net-vert/core 1.3.1 → 1.3.4

package/dist/index.d.ts

@@ -244,7 +244,7 @@ declare enum MIDDLEWARE_TYPE {
     RETRY = "retry",
     IDEMPOTENT = "idempotent",
     CONCURRENT = "concurrent",
-    SYNC = "sync"
+    THROTTLE = "throttle"
 }
 
 export declare interface MiddlewareContext extends Record<string, any> {
@@ -308,6 +308,94 @@ declare type TaskItem<T> = {
 
 declare type TaskItemList<T> = TaskQueue<TaskItem<T>>;
 
+/**
+ * 节流中间件
+ *
+ * 确保所有请求按照最小间隔时间排队执行
+ *
+ * @example
+ * ```typescript
+ * // 创建节流中间件，每次请求最少间隔 1 秒
+ * const throttleMiddleware = throttle({ interval: 1000 })
+ *
+ * // 带超时控制，超过 5 秒丢弃请求
+ * const throttleMiddleware = throttle({
+ *   interval: 1000,
+ *   timeout: 5000
+ * })
+ *
+ * // 所有使用该中间件的请求共享同一个节流器
+ * const api1 = createRequest(config1, [throttleMiddleware])
+ * const api2 = createRequest(config2, [throttleMiddleware])
+ *
+ * // 组合使用
+ * const api3 = createRequest(config3, [
+ *   cache({ duration: 5000 }),     // 优先走缓存
+ *   idempotent(),                  // 去重相同请求
+ *   throttle({ interval: 1000 }),  // 限制请求速率
+ *   retry({ retries: 3 })          // 失败重试
+ * ])
+ *
+ * // 查看节流器状态
+ * throttleMiddleware.throttler.getStatus()
+ * ```
+ */
+export declare const throttle: <D = any, R = any>(options?: Partial<ThrottleOptions>) => ThrottleMiddleware<D, R>;
+
+/**
+ * 节流中间件类型
+ */
+declare type ThrottleMiddleware<D = any, R = any> = Middleware<D, R> & {
+    __middlewareType: MIDDLEWARE_TYPE.THROTTLE;
+    throttler: Throttler;
+};
+
+/**
+ * 节流中间件配置
+ */
+declare interface ThrottleOptions {
+    /**
+     * 最小请求间隔（毫秒）
+     * @default 1000
+     */
+    interval: number;
+    /**
+     * 队列超时时间（毫秒）
+     * 如果请求在队列中等待超过此时间，将被拒绝并抛出 ThrottleTimeoutError
+     * - 不设置（undefined）：永不超时，所有请求都会执行
+     * - 设为 0：立即超时，直接拒绝排队的请求
+     * - 设为正数：等待指定时间后超时
+     * @default undefined
+     */
+    timeout?: number;
+}
+
+/**
+ * 节流器接口
+ */
+declare interface Throttler {
+    /** 添加任务到队列 */
+    add: <T>(task: () => Promise<T>) => Promise<T>;
+    /** 获取节流器状态 */
+    getStatus: () => ThrottlerStatus;
+    /** 清空队列（慎用） */
+    clear: () => void;
+}
+
+/**
+ * 节流器状态
+ */
+declare interface ThrottlerStatus {
+    /** 当前队列长度 */
+    queueLength: number;
+    /** 上次执行时间戳 */
+    lastExecutionTime: number;
+    /** 是否正在处理队列 */
+    isProcessing: boolean;
+    /** 预计下次执行时间 */
+    nextExecutionTime: number | null;
+}
+
 export declare type TypedMiddleware<Type extends MiddlewareType, D = any, R = any> = Middleware<D, R> & {
     __middlewareType: Type;
 };

package/dist/index.js

@@ -1,38 +1,38 @@
-import { TaskQueue as F } from "id-queue";
-var h = /* @__PURE__ */ ((r) => (r.GET = "get", r.POST = "post", r.PUT = "put", r.DELETE = "delete", r))(h || {}), m = /* @__PURE__ */ ((r) => (r.CACHE = "cache", r.RETRY = "retry", r.IDEMPOTENT = "idempotent", r.CONCURRENT = "concurrent", r.SYNC = "sync", r))(m || {});
-const p = "default", I = /* @__PURE__ */ new Map(), ce = (r, e = p) => {
-  I.set(e, r);
-}, j = (r = p) => {
-  const e = I.get(r);
+import { TaskQueue as j } from "id-queue";
+var f = /* @__PURE__ */ ((r) => (r.GET = "get", r.POST = "post", r.PUT = "put", r.DELETE = "delete", r))(f || {}), g = /* @__PURE__ */ ((r) => (r.CACHE = "cache", r.RETRY = "retry", r.IDEMPOTENT = "idempotent", r.CONCURRENT = "concurrent", r.THROTTLE = "throttle", r))(g || {});
+const k = "default", S = /* @__PURE__ */ new Map(), me = (r, e = k) => {
+  S.set(e, r);
+}, q = (r = k) => {
+  const e = S.get(r);
   if (!e) throw new Error(`Requestor实例 ${String(r)} 未注册`);
   return e;
-}, C = {
+}, v = {
   get: (r, e) => ({
     url: r,
-    method: h.GET,
+    method: f.GET,
     ...e,
     params: e?.params
   }),
   post: (r, e, t) => ({
     url: r,
-    method: h.POST,
+    method: f.POST,
     data: e,
     ...t
   }),
   delete: (r, e) => ({
     url: r,
-    method: h.DELETE,
+    method: f.DELETE,
     ...e
   }),
   put: (r, e, t) => ({
     url: r,
-    method: h.PUT,
+    method: f.PUT,
     data: e,
     ...t
   }),
   request: (r) => r
-}, D = Object.keys(C);
-function T(r, e, t) {
+}, F = Object.keys(v);
+function $(r, e, t) {
   const n = {}, s = (o) => {
     if (o === e.length)
       return t(r);
@@ -45,13 +45,13 @@ function T(r, e, t) {
   };
   return s(0);
 }
-function V(r, e) {
+function R(r, e) {
   const t = {}, n = e ?? [];
-  return D.forEach(
+  return F.forEach(
     (s) => {
       t[s] = (...o) => {
-        const i = C[s](...o);
-        return T(
+        const i = v[s](...o);
+        return $(
           i,
           n,
           r
@@ -60,19 +60,19 @@ function V(r, e) {
     }
   ), t;
 }
-function k(r) {
-  const { extensions: e, instanceKey: t } = r ?? {}, n = j(t);
-  return V(
+function b(r) {
+  const { extensions: e, instanceKey: t } = r ?? {}, n = q(t);
+  return R(
     n,
     e
   );
 }
-const q = {
+const V = {
   retries: 3,
   delay: 0,
   retryCondition: () => !0
-}, E = (r) => {
-  const e = { ...q, ...r };
+}, B = (r) => {
+  const e = { ...V, ...r };
   return Object.assign(async ({ config: n, next: s }) => {
     let o = 0, i;
     for (; o <= e.retries; )
@@ -89,23 +89,23 @@ const q = {
         if (!e.retryCondition(c))
           throw a;
         o++;
-        const u = typeof e.delay == "function" ? e.delay(c) : e.delay;
-        u > 0 && await new Promise((w) => setTimeout(w, u));
+        const h = typeof e.delay == "function" ? e.delay(c) : e.delay;
+        h > 0 && await new Promise((I) => setTimeout(I, h));
       }
     throw i;
-  }, { __middlewareType: m.RETRY });
-}, R = () => {
+  }, { __middlewareType: g.RETRY });
+}, _ = () => {
   const r = /* @__PURE__ */ new Map();
   return { getPromise: (o) => r.get(o), setPromise: (o, i) => {
     r.set(o, i), i.finally(() => r.delete(o));
   }, delPromise: (o) => r.delete(o), clearCache: () => r.clear() };
-}, $ = (r) => {
+}, K = (r) => {
   const { config: e } = r, { method: t, url: n, data: s } = e;
   return [t, n, JSON.stringify(s)].join("|");
-}, B = {
-  key: $
-}, K = (r) => {
-  const e = { ...B, ...r }, t = R();
+}, A = {
+  key: K
+}, J = (r) => {
+  const e = { ...A, ...r }, t = _();
   return Object.assign(({ config: s, next: o }) => {
     const i = e.key({ config: s }), a = t.getPromise(i);
     if (a)
@@ -113,16 +113,16 @@ const q = {
     const c = o();
     return t.setPromise(i, c), c;
   }, {
-    __middlewareType: m.IDEMPOTENT,
+    __middlewareType: g.IDEMPOTENT,
     promiseCache: t
   });
 };
-class _ {
+class z {
   parallelCount;
   tasks;
   runningCount;
   constructor(e = 4) {
-    this.parallelCount = e, this.tasks = new F(), this.runningCount = 0;
+    this.parallelCount = e, this.tasks = new j(), this.runningCount = 0;
   }
   // 加入
   add(e, t) {
@@ -151,26 +151,26 @@ class _ {
     }
   }
 }
-let A = 0;
-const J = {
+let G = 0;
+const H = {
   parallelCount: 4,
-  createId: () => A++
-}, z = (r) => {
-  const { parallelCount: e, createId: t } = { ...J, ...r }, n = new _(e);
+  createId: () => G++
+}, L = (r) => {
+  const { parallelCount: e, createId: t } = { ...H, ...r }, n = new z(e);
   return Object.assign(({ config: o, next: i }) => {
     const a = t({ config: o });
     return n.add(a, () => i());
-  }, { __middlewareType: m.CONCURRENT, pool: n });
-}, S = /* @__PURE__ */ new Map(), y = (r, e) => {
-  S.set(e, r);
+  }, { __middlewareType: g.CONCURRENT, pool: n });
+}, T = /* @__PURE__ */ new Map(), w = (r, e) => {
+  T.set(e, r);
 };
-function G(r) {
-  const e = S.get(r);
+function U(r) {
+  const e = T.get(r);
   if (!e)
     throw new Error(`Store实例 ${String(r)} 未注册`);
   return e;
 }
-class U {
+class M {
   store = /* @__PURE__ */ new Map();
   getItem(e) {
     return this.store.get(e);
@@ -199,7 +199,7 @@ class U {
       e(s, n, t), t++;
   }
 }
-const M = (r) => !!r && (typeof r == "object" || typeof r == "function") && typeof r.then == "function", v = (r) => typeof window < "u" ? r() : {
+const X = (r) => !!r && (typeof r == "object" || typeof r == "function") && typeof r.then == "function", x = (r) => typeof window < "u" ? r() : {
   getItem() {
     return null;
   },
@@ -215,12 +215,12 @@ const M = (r) => !!r && (typeof r == "object" || typeof r == "function") && type
   get length() {
     return 0;
   }
-}, l = v(() => window.localStorage);
-class X {
+}, m = x(() => window.localStorage);
+class Z {
   constructor() {
   }
   getItem(e) {
-    const t = String(e), n = l.getItem(t);
+    const t = String(e), n = m.getItem(t);
     if (n !== null)
       try {
         return JSON.parse(n);
@@ -232,7 +232,7 @@ class X {
   setItem(e, t) {
     const n = String(e);
     try {
-      l.setItem(n, JSON.stringify(t));
+      m.setItem(n, JSON.stringify(t));
     } catch (s) {
       throw console.error(`Failed to set value for key: ${n}`, s), s;
     }
@@ -240,21 +240,21 @@ class X {
   }
   removeItem(e) {
     const t = String(e);
-    l.removeItem(t);
+    m.removeItem(t);
   }
   clear() {
-    l.clear();
+    m.clear();
   }
   length() {
-    return l.length;
+    return m.length;
   }
   key(e) {
-    return l.key(e);
+    return m.key(e);
   }
   keys() {
     const e = [];
-    for (let t = 0; t < l.length; t++) {
-      const n = l.key(t);
+    for (let t = 0; t < m.length; t++) {
+      const n = m.key(t);
       n && e.push(n);
     }
     return e;
@@ -266,12 +266,12 @@ class X {
     });
   }
 }
-const d = v(() => window.sessionStorage);
-class Y {
+const y = x(() => window.sessionStorage);
+class Q {
   constructor() {
   }
   getItem(e) {
-    const t = String(e), n = d.getItem(t);
+    const t = String(e), n = y.getItem(t);
     if (n !== null)
       try {
         return JSON.parse(n);
@@ -283,7 +283,7 @@ class Y {
   setItem(e, t) {
     const n = String(e);
     try {
-      d.setItem(n, JSON.stringify(t));
+      y.setItem(n, JSON.stringify(t));
     } catch (s) {
       throw console.error(`Failed to set value for key: ${n}`, s), s;
     }
@@ -291,21 +291,21 @@ class Y {
   }
   removeItem(e) {
     const t = String(e);
-    d.removeItem(t);
+    y.removeItem(t);
   }
   clear() {
-    d.clear();
+    y.clear();
   }
   length() {
-    return d.length;
+    return y.length;
   }
   key(e) {
-    return d.key(e);
+    return y.key(e);
   }
   keys() {
     const e = [];
-    for (let t = 0; t < d.length; t++) {
-      const n = d.key(t);
+    for (let t = 0; t < y.length; t++) {
+      const n = y.key(t);
       n && e.push(n);
     }
     return e;
@@ -317,7 +317,7 @@ class Y {
     });
   }
 }
-class Z {
+class Y {
   dbName;
   storeName;
   dbPromise = null;
@@ -427,8 +427,8 @@ class Z {
         t.onsuccess = (i) => {
           const a = i.target.result;
           if (a) {
-            const c = a.key, u = a.value;
-            e(u, c, o), o++, a.continue();
+            const c = a.key, h = a.value;
+            e(h, c, o), o++, a.continue();
           } else
             n();
         }, t.onerror = () => {
@@ -440,17 +440,17 @@ class Z {
     }
   }
 }
-const g = {
+const p = {
   memory: "memory",
   local: "local",
   session: "session",
   indexeddb: "indexeddb"
 };
-function b(r, e) {
+function P(r, e) {
   Object.assign(r, e);
 }
-function H(r) {
-  return b(r, {
+function W(r) {
+  return P(r, {
     async getItemOrDefault(e, t) {
       const n = await this.getItem(e);
       return n !== null ? n : t;
@@ -466,8 +466,8 @@ function H(r) {
     }
   }), r;
 }
-function L(r) {
-  return b(r, {
+function ee(r) {
+  return P(r, {
     getItemOrDefault(e, t) {
       const n = this.getItem(e);
       return n !== null ? n : t;
@@ -483,50 +483,50 @@ function L(r) {
     }
   }), r;
 }
-function Q(r) {
+function te(r) {
   const e = r.getItem("");
-  return M(e) ? H(r) : L(r);
+  return X(e) ? W(r) : ee(r);
 }
-function f(r, ...e) {
-  const t = G(r);
+function C(r, ...e) {
+  const t = U(r);
   let n;
   try {
     n = new t(...e);
   } catch {
     n = t(...e);
   }
-  return Q(n);
+  return te(n);
 }
-y(U, g.memory);
-y(X, g.local);
-y(Y, g.session);
-y(Z, g.indexeddb);
+w(M, p.memory);
+w(Z, p.local);
+w(Q, p.session);
+w(Y, p.indexeddb);
 function N(r, e) {
   return {
     value: r,
     expireAt: Date.now() + e
   };
 }
-function P(r, e = Date.now()) {
+function O(r, e = Date.now()) {
   return r.expireAt <= e;
 }
-function W(r, e = Date.now()) {
-  return P(r, e) ? void 0 : r.value;
+function re(r, e = Date.now()) {
+  return O(r, e) ? void 0 : r.value;
 }
-const ee = (r) => {
+const ne = (r) => {
   const { config: e } = r, { method: t, url: n, data: s } = e;
   return [t, n, JSON.stringify(s)].join("|");
-}, te = () => !0, x = 24 * 60 * 60 * 1e3, re = {
-  key: ee,
-  duration: x,
-  isValid: te,
-  store: g.memory
+}, se = () => !0, E = 24 * 60 * 60 * 1e3, oe = {
+  key: ne,
+  duration: E,
+  isValid: se,
+  store: p.memory
   // 默认不持久化，使用内存存储
 };
-class ne {
+class ae {
   store;
   constructor(e) {
-    return typeof e == "string" ? this.store = f(e) : (y(e.factory, e.key), this.store = f(e.key)), new Proxy(this, {
+    return typeof e == "string" ? this.store = C(e) : (w(e.factory, e.key), this.store = C(e.key)), new Proxy(this, {
       get(t, n) {
         if (n in t)
           return t[n];
@@ -541,7 +541,7 @@ class ne {
    * @param value 要缓存的值
    * @param duration 过期时长（毫秒），默认 24 小时
    */
-  setCache(e, t, n = x) {
+  setCache(e, t, n = E) {
     const s = N(t, n);
     this.store.setItem(e, s);
   }
@@ -553,7 +553,7 @@ class ne {
   async getCache(e) {
     const t = await this.store.getItem(e);
     if (t)
-      return W(t);
+      return re(t);
   }
   /**
    * 检查是否有有效的缓存（未过期）
@@ -562,11 +562,11 @@ class ne {
    */
   async hasValidCache(e) {
     const t = await this.store.getItem(e);
-    return t ? !P(t) : !1;
+    return t ? !O(t) : !1;
   }
 }
-const se = ne, oe = (r) => {
-  const e = { ...re, ...r }, t = new se(e.store), n = (o) => typeof e.duration == "function" ? e.duration(o) : e.duration;
+const ie = ae, ce = (r) => {
+  const e = { ...oe, ...r }, t = new ie(e.store), n = (o) => typeof e.duration == "function" ? e.duration(o) : e.duration;
   return Object.assign(async ({ config: o, next: i }) => {
     const a = e.key({ config: o }), c = await t.getCache(a);
     if (c) {
@@ -577,41 +577,106 @@ const se = ne, oe = (r) => {
       })) return c;
       t.removeItem(a);
     }
-    const u = await i(), w = n({ key: a, config: o, cachedData: c, response: u }), O = N(u, w);
-    return t.setItem(a, O), u;
+    const h = await i(), I = n({ key: a, config: o, cachedData: c, response: h }), u = N(h, I);
+    return t.setItem(a, u), h;
   }, {
-    __middlewareType: m.CACHE,
+    __middlewareType: g.CACHE,
     storage: t
   });
 };
-function ue(r) {
+class ue extends Error {
+  constructor(e, t) {
+    super(`请求在节流队列中等待超时：配置超时 ${e}ms，实际等待 ${t}ms`), this.name = "ThrottleTimeoutError";
+  }
+}
+function le(r, e) {
+  const t = [];
+  let n = 0, s = !1;
+  const o = (u) => new Promise((l) => setTimeout(l, u)), i = () => {
+    if (e === void 0 || t.length === 0)
+      return !1;
+    const u = Date.now(), l = t[0], d = u - l.timestamp;
+    return d >= e ? (t.shift(), l.reject(new ue(e, d)), !0) : !1;
+  }, a = async () => {
+    if (!(s || t.length === 0)) {
+      for (s = !0; t.length > 0; ) {
+        if (e !== void 0 && i())
+          continue;
+        if (t.length === 0)
+          break;
+        const l = Date.now() - n;
+        if (n > 0 && l < r) {
+          const D = r - l;
+          await o(D);
+        }
+        const d = t.shift();
+        d && (n = Date.now(), d.task().then(d.resolve).catch(d.reject));
+      }
+      s = !1;
+    }
+  };
+  return {
+    add: (u) => new Promise((l, d) => {
+      t.push({
+        task: u,
+        resolve: l,
+        reject: d,
+        timestamp: Date.now()
+      }), a();
+    }),
+    getStatus: () => {
+      const u = t.length > 0 ? n + r : null;
+      return {
+        queueLength: t.length,
+        lastExecutionTime: n,
+        isProcessing: s,
+        nextExecutionTime: u
+      };
+    },
+    clear: () => {
+      t.length = 0;
+    }
+  };
+}
+const he = {
+  interval: 1e3
+  // timeout 默认 undefined，永不超时
+}, ye = (r) => {
+  const e = { ...he, ...r }, t = le(e.interval, e.timeout);
+  return Object.assign(async ({ config: s, next: o }) => t.add(o), {
+    __middlewareType: g.THROTTLE,
+    throttler: t
+  });
+};
+function ge(r) {
   const { instanceKey: e, key: t, duration: n, isValid: s, store: o, ...i } = r;
-  return k({
+  return b({
     instanceKey: e,
     extensions: [
-      K(i),
-      oe({ key: t, duration: n, isValid: s, store: o })
+      J(i),
+      ce({ key: t, duration: n, isValid: s, store: o })
     ]
   });
 }
-function le(r) {
+function fe(r) {
   const { instanceKey: e, parallelCount: t, createId: n, retries: s, delay: o, retryCondition: i } = r;
-  return k({
+  return b({
     instanceKey: e,
     extensions: [
-      z({ parallelCount: t, createId: n }),
-      E({ retries: s, delay: o, retryCondition: i })
+      L({ parallelCount: t, createId: n }),
+      B({ retries: s, delay: o, retryCondition: i })
     ]
   });
 }
 export {
-  oe as cache,
-  z as concurrent,
-  ue as createCachedIdempotentRequestor,
-  le as createConcurrentRetryRequestor,
-  k as createRequestor,
-  K as idempotent,
-  ce as inject,
-  E as retry,
-  j as useRequestor
+  ce as cache,
+  L as concurrent,
+  ge as createCachedIdempotentRequestor,
+  fe as createConcurrentRetryRequestor,
+  b as createRequestor,
+  J as idempotent,
+  me as inject,
+  B as retry,
+  ye as throttle,
+  q as useRequestor
 };

package/dist/index.umd.cjs

@@ -1 +1 @@
-(function(c,m){typeof exports=="object"&&typeof module<"u"?m(exports,require("id-queue")):typeof define=="function"&&define.amd?define(["exports","id-queue"],m):(c=typeof globalThis<"u"?globalThis:c||self,m(c.netVertCore={},c.idQueue))})(this,function(c,m){"use strict";var y=(r=>(r.GET="get",r.POST="post",r.PUT="put",r.DELETE="delete",r))(y||{}),g=(r=>(r.CACHE="cache",r.RETRY="retry",r.IDEMPOTENT="idempotent",r.CONCURRENT="concurrent",r.SYNC="sync",r))(g||{});const C="default",k=new Map,V=(r,e=C)=>{k.set(e,r)},S=(r=C)=>{const e=k.get(r);if(!e)throw new Error(`Requestor实例 ${String(r)} 未注册`);return e},v={get:(r,e)=>({url:r,method:y.GET,...e,params:e?.params}),post:(r,e,t)=>({url:r,method:y.POST,data:e,...t}),delete:(r,e)=>({url:r,method:y.DELETE,...e}),put:(r,e,t)=>({url:r,method:y.PUT,data:e,...t}),request:r=>r},E=Object.keys(v);function $(r,e,t){const n={},o=s=>{if(s===e.length)return t(r);const a=e[s];return a({config:r,ctx:n,next:()=>o(s+1)})};return o(0)}function B(r,e){const t={},n=e??[];return E.forEach(o=>{t[o]=(...s)=>{const a=v[o](...s);return $(a,n,r)}}),t}function p(r){const{extensions:e,instanceKey:t}=r??{},n=S(t);return B(n,e)}const K={retries:3,delay:0,retryCondition:()=>!0},b=r=>{const e={...K,...r};return Object.assign(async({config:n,next:o})=>{let s=0,a;for(;s<=e.retries;)try{return await o()}catch(i){if(a=i,s===e.retries)throw i;const u={config:n,lastResponse:i,attempt:s};if(!e.retryCondition(u))throw i;s++;const h=typeof e.delay=="function"?e.delay(u):e.delay;h>0&&await new Promise(I=>setTimeout(I,h))}throw a},{__middlewareType:g.RETRY})},_=()=>{const r=new Map;return{getPromise:s=>r.get(s),setPromise:(s,a)=>{r.set(s,a),a.finally(()=>r.delete(s))},delPromise:s=>r.delete(s),clearCache:()=>r.clear()}},A={key:r=>{const{config:e}=r,{method:t,url:n,data:o}=e;return[t,n,JSON.stringify(o)].join("|")}},N=r=>{const e={...A,...r},t=_();return Object.assign(({config:o,next:s})=>{const a=e.key({config:o}),i=t.getPromise(a);if(i)return i;const u=s();return t.setPromise(a,u),u},{__middlewareType:g.IDEMPOTENT,promiseCache:t})};class J{parallelCount;tasks;runningCount;constructor(e=4){this.parallelCount=e,this.tasks=new m.TaskQueue,this.runningCount=0}add(e,t){return new Promise((n,o)=>{this.tasks.enqueue(e,{task:t,resolve:n,reject:o}),this._run()})}remove(e){this.tasks.remove(e)}execute(e){const{task:t,resolve:n,reject:o}=e;return t().then(n).catch(o).finally(()=>{this.runningCount--,this._run()})}_run(){for(;this.runningCount<this.parallelCount&&this.tasks.size>0;){const e=this.tasks.dequeue();this.runningCount++,this.execute(e)}}}let z=0;const G={parallelCount:4,createId:()=>z++},P=r=>{const{parallelCount:e,createId:t}={...G,...r},n=new J(e);return Object.assign(({config:s,next:a})=>{const i=t({config:s});return n.add(i,()=>a())},{__middlewareType:g.CONCURRENT,pool:n})},q=new Map,f=(r,e)=>{q.set(e,r)};function U(r){const e=q.get(r);if(!e)throw new Error(`Store实例 ${String(r)} 未注册`);return e}class M{store=new Map;getItem(e){return this.store.get(e)}setItem(e,t){return this.store.set(e,t),t}removeItem(e){this.store.delete(e)}clear(){this.store.clear()}length(){return this.store.size}key(e){return Array.from(this.store.keys())[e]}keys(){return Array.from(this.store.keys())}iterate(e){let t=0;for(const[n,o]of this.store.entries())e(o,n,t),t++}}const X=r=>!!r&&(typeof r=="object"||typeof r=="function")&&typeof r.then=="function",O=r=>typeof window<"u"?r():{getItem(){return null},setItem(){},removeItem(){},clear(){},key(){return null},get length(){return 0}},l=O(()=>window.localStorage);class Y{constructor(){}getItem(e){const t=String(e),n=l.getItem(t);if(n!==null)try{return JSON.parse(n)}catch(o){console.error(`Failed to parse value for key: ${t}`,o);return}}setItem(e,t){const n=String(e);try{l.setItem(n,JSON.stringify(t))}catch(o){throw console.error(`Failed to set value for key: ${n}`,o),o}return t}removeItem(e){const t=String(e);l.removeItem(t)}clear(){l.clear()}length(){return l.length}key(e){return l.key(e)}keys(){const e=[];for(let t=0;t<l.length;t++){const n=l.key(t);n&&e.push(n)}return e}iterate(e){this.keys().forEach((t,n)=>{const o=this.getItem(t);o!==void 0&&e(o,t,n)})}}const d=O(()=>window.sessionStorage);class Z{constructor(){}getItem(e){const t=String(e),n=d.getItem(t);if(n!==null)try{return JSON.parse(n)}catch(o){console.error(`Failed to parse value for key: ${t}`,o);return}}setItem(e,t){const n=String(e);try{d.setItem(n,JSON.stringify(t))}catch(o){throw console.error(`Failed to set value for key: ${n}`,o),o}return t}removeItem(e){const t=String(e);d.removeItem(t)}clear(){d.clear()}length(){return d.length}key(e){return d.key(e)}keys(){const e=[];for(let t=0;t<d.length;t++){const n=d.key(t);n&&e.push(n)}return e}iterate(e){this.keys().forEach((t,n)=>{const o=this.getItem(t);o!==void 0&&e(o,t,n)})}}class H{dbName;storeName;dbPromise=null;DB_VERSION=1;constructor(e,t){this.dbName=e,this.storeName=t,this.initDB()}initDB(){if(typeof window>"u"||!window.indexedDB){console.warn("IndexedDB is not available");return}this.dbPromise=new Promise((e,t)=>{const n=indexedDB.open(this.dbName,this.DB_VERSION);n.onerror=()=>{t(new Error(`Failed to open database: ${this.dbName}`))},n.onsuccess=()=>{e(n.result)},n.onupgradeneeded=o=>{const s=o.target.result;s.objectStoreNames.contains(this.storeName)||s.createObjectStore(this.storeName)}})}async getDB(){if(!this.dbPromise)throw new Error("IndexedDB is not initialized");return this.dbPromise}async withStore(e,t){const n=await this.getDB();return new Promise((o,s)=>{const a=n.transaction([this.storeName],e).objectStore(this.storeName),i=t(a);i.onsuccess=()=>{o(i.result)},i.onerror=()=>{s(i.error)}})}async getItem(e){try{const t=await this.withStore("readonly",n=>n.get(String(e)));return t===void 0?void 0:t}catch(t){console.error(`Failed to get value for key: ${String(e)}`,t);return}}async setItem(e,t){try{return await this.withStore("readwrite",n=>n.put(t,String(e))),t}catch(n){throw console.error(`Failed to set value for key: ${String(e)}`,n),n}}async removeItem(e){try{await this.withStore("readwrite",t=>t.delete(String(e)))}catch(t){throw console.error(`Failed to remove value for key: ${String(e)}`,t),t}}async clear(){try{await this.withStore("readwrite",e=>e.clear())}catch(e){throw console.error("Failed to clear storage",e),e}}async length(){try{return await this.withStore("readonly",e=>e.count())}catch(e){return console.error("Failed to get storage length",e),0}}async key(e){try{return(await this.withStore("readonly",t=>t.getAllKeys()))[e]}catch(t){console.error("Failed to get key",t);return}}async keys(){try{return await this.withStore("readonly",e=>e.getAllKeys())}catch(e){return console.error("Failed to get all keys",e),[]}}async iterate(e){try{const t=(await this.getDB()).transaction([this.storeName],"readonly").objectStore(this.storeName).openCursor();return new Promise((n,o)=>{let s=0;t.onsuccess=a=>{const i=a.target.result;if(i){const u=i.key,h=i.value;e(h,u,s),s++,i.continue()}else n()},t.onerror=()=>{o(t.error)}})}catch(t){console.error("Failed to iterate storage",t)}}}const w={memory:"memory",local:"local",session:"session",indexeddb:"indexeddb"};function R(r,e){Object.assign(r,e)}function L(r){return R(r,{async getItemOrDefault(e,t){const n=await this.getItem(e);return n!==null?n:t},async hasItem(e){return await this.getItem(e)!==null},async removeItems(e){await Promise.all(e.map(t=>this.removeItem(t)))},async getItems(e){return await Promise.all(e.map(t=>this.getItem(t)))}}),r}function Q(r){return R(r,{getItemOrDefault(e,t){const n=this.getItem(e);return n!==null?n:t},hasItem(e){return this.getItem(e)!==null},removeItems(e){e.forEach(t=>this.removeItem(t))},getItems(e){return e.map(t=>this.getItem(t))}}),r}function W(r){const e=r.getItem("");return X(e)?L(r):Q(r)}function j(r,...e){const t=U(r);let n;try{n=new t(...e)}catch{n=t(...e)}return W(n)}f(M,w.memory),f(Y,w.local),f(Z,w.session),f(H,w.indexeddb);function x(r,e){return{value:r,expireAt:Date.now()+e}}function T(r,e=Date.now()){return r.expireAt<=e}function ee(r,e=Date.now()){return T(r,e)?void 0:r.value}const te=r=>{const{config:e}=r,{method:t,url:n,data:o}=e;return[t,n,JSON.stringify(o)].join("|")},re=()=>!0,F=24*60*60*1e3,ne={key:te,duration:F,isValid:re,store:w.memory};class oe{store;constructor(e){return typeof e=="string"?this.store=j(e):(f(e.factory,e.key),this.store=j(e.key)),new Proxy(this,{get(t,n){if(n in t)return t[n];const o=t.store[n];return typeof o=="function"?o.bind(t.store):o}})}setCache(e,t,n=F){const o=x(t,n);this.store.setItem(e,o)}async getCache(e){const t=await this.store.getItem(e);if(t)return ee(t)}async hasValidCache(e){const t=await this.store.getItem(e);return t?!T(t):!1}}const se=oe,D=r=>{const e={...ne,...r},t=new se(e.store),n=s=>typeof e.duration=="function"?e.duration(s):e.duration;return Object.assign(async({config:s,next:a})=>{const i=e.key({config:s}),u=await t.getCache(i);if(u){if(await e.isValid({key:i,config:s,cachedData:u}))return u;t.removeItem(i)}const h=await a(),I=n({key:i,config:s,cachedData:u,response:h}),ce=x(h,I);return t.setItem(i,ce),h},{__middlewareType:g.CACHE,storage:t})};function ie(r){const{instanceKey:e,key:t,duration:n,isValid:o,store:s,...a}=r;return p({instanceKey:e,extensions:[N(a),D({key:t,duration:n,isValid:o,store:s})]})}function ae(r){const{instanceKey:e,parallelCount:t,createId:n,retries:o,delay:s,retryCondition:a}=r;return p({instanceKey:e,extensions:[P({parallelCount:t,createId:n}),b({retries:o,delay:s,retryCondition:a})]})}c.cache=D,c.concurrent=P,c.createCachedIdempotentRequestor=ie,c.createConcurrentRetryRequestor=ae,c.createRequestor=p,c.idempotent=N,c.inject=V,c.retry=b,c.useRequestor=S,Object.defineProperty(c,Symbol.toStringTag,{value:"Module"})});
+(function(c,w){typeof exports=="object"&&typeof module<"u"?w(exports,require("id-queue")):typeof define=="function"&&define.amd?define(["exports","id-queue"],w):(c=typeof globalThis<"u"?globalThis:c||self,w(c.netVertCore={},c.idQueue))})(this,function(c,w){"use strict";var p=(r=>(r.GET="get",r.POST="post",r.PUT="put",r.DELETE="delete",r))(p||{}),f=(r=>(r.CACHE="cache",r.RETRY="retry",r.IDEMPOTENT="idempotent",r.CONCURRENT="concurrent",r.THROTTLE="throttle",r))(f||{});const v="default",b=new Map,B=(r,e=v)=>{b.set(e,r)},T=(r=v)=>{const e=b.get(r);if(!e)throw new Error(`Requestor实例 ${String(r)} 未注册`);return e},P={get:(r,e)=>({url:r,method:p.GET,...e,params:e?.params}),post:(r,e,t)=>({url:r,method:p.POST,data:e,...t}),delete:(r,e)=>({url:r,method:p.DELETE,...e}),put:(r,e,t)=>({url:r,method:p.PUT,data:e,...t}),request:r=>r},_=Object.keys(P);function K(r,e,t){const n={},o=s=>{if(s===e.length)return t(r);const a=e[s];return a({config:r,ctx:n,next:()=>o(s+1)})};return o(0)}function A(r,e){const t={},n=e??[];return _.forEach(o=>{t[o]=(...s)=>{const a=P[o](...s);return K(a,n,r)}}),t}function S(r){const{extensions:e,instanceKey:t}=r??{},n=T(t);return A(n,e)}const J={retries:3,delay:0,retryCondition:()=>!0},N=r=>{const e={...J,...r};return Object.assign(async({config:n,next:o})=>{let s=0,a;for(;s<=e.retries;)try{return await o()}catch(i){if(a=i,s===e.retries)throw i;const u={config:n,lastResponse:i,attempt:s};if(!e.retryCondition(u))throw i;s++;const h=typeof e.delay=="function"?e.delay(u):e.delay;h>0&&await new Promise(k=>setTimeout(k,h))}throw a},{__middlewareType:f.RETRY})},z=()=>{const r=new Map;return{getPromise:s=>r.get(s),setPromise:(s,a)=>{r.set(s,a),a.finally(()=>r.delete(s))},delPromise:s=>r.delete(s),clearCache:()=>r.clear()}},G={key:r=>{const{config:e}=r,{method:t,url:n,data:o}=e;return[t,n,JSON.stringify(o)].join("|")}},q=r=>{const e={...G,...r},t=z();return Object.assign(({config:o,next:s})=>{const a=e.key({config:o}),i=t.getPromise(a);if(i)return i;const u=s();return t.setPromise(a,u),u},{__middlewareType:f.IDEMPOTENT,promiseCache:t})};class H{parallelCount;tasks;runningCount;constructor(e=4){this.parallelCount=e,this.tasks=new w.TaskQueue,this.runningCount=0}add(e,t){return new Promise((n,o)=>{this.tasks.enqueue(e,{task:t,resolve:n,reject:o}),this._run()})}remove(e){this.tasks.remove(e)}execute(e){const{task:t,resolve:n,reject:o}=e;return t().then(n).catch(o).finally(()=>{this.runningCount--,this._run()})}_run(){for(;this.runningCount<this.parallelCount&&this.tasks.size>0;){const e=this.tasks.dequeue();this.runningCount++,this.execute(e)}}}let L=0;const U={parallelCount:4,createId:()=>L++},O=r=>{const{parallelCount:e,createId:t}={...U,...r},n=new H(e);return Object.assign(({config:s,next:a})=>{const i=t({config:s});return n.add(i,()=>a())},{__middlewareType:f.CONCURRENT,pool:n})},j=new Map,C=(r,e)=>{j.set(e,r)};function M(r){const e=j.get(r);if(!e)throw new Error(`Store实例 ${String(r)} 未注册`);return e}class Q{store=new Map;getItem(e){return this.store.get(e)}setItem(e,t){return this.store.set(e,t),t}removeItem(e){this.store.delete(e)}clear(){this.store.clear()}length(){return this.store.size}key(e){return Array.from(this.store.keys())[e]}keys(){return Array.from(this.store.keys())}iterate(e){let t=0;for(const[n,o]of this.store.entries())e(o,n,t),t++}}const X=r=>!!r&&(typeof r=="object"||typeof r=="function")&&typeof r.then=="function",x=r=>typeof window<"u"?r():{getItem(){return null},setItem(){},removeItem(){},clear(){},key(){return null},get length(){return 0}},y=x(()=>window.localStorage);class Z{constructor(){}getItem(e){const t=String(e),n=y.getItem(t);if(n!==null)try{return JSON.parse(n)}catch(o){console.error(`Failed to parse value for key: ${t}`,o);return}}setItem(e,t){const n=String(e);try{y.setItem(n,JSON.stringify(t))}catch(o){throw console.error(`Failed to set value for key: ${n}`,o),o}return t}removeItem(e){const t=String(e);y.removeItem(t)}clear(){y.clear()}length(){return y.length}key(e){return y.key(e)}keys(){const e=[];for(let t=0;t<y.length;t++){const n=y.key(t);n&&e.push(n)}return e}iterate(e){this.keys().forEach((t,n)=>{const o=this.getItem(t);o!==void 0&&e(o,t,n)})}}const g=x(()=>window.sessionStorage);class Y{constructor(){}getItem(e){const t=String(e),n=g.getItem(t);if(n!==null)try{return JSON.parse(n)}catch(o){console.error(`Failed to parse value for key: ${t}`,o);return}}setItem(e,t){const n=String(e);try{g.setItem(n,JSON.stringify(t))}catch(o){throw console.error(`Failed to set value for key: ${n}`,o),o}return t}removeItem(e){const t=String(e);g.removeItem(t)}clear(){g.clear()}length(){return g.length}key(e){return g.key(e)}keys(){const e=[];for(let t=0;t<g.length;t++){const n=g.key(t);n&&e.push(n)}return e}iterate(e){this.keys().forEach((t,n)=>{const o=this.getItem(t);o!==void 0&&e(o,t,n)})}}class W{dbName;storeName;dbPromise=null;DB_VERSION=1;constructor(e,t){this.dbName=e,this.storeName=t,this.initDB()}initDB(){if(typeof window>"u"||!window.indexedDB){console.warn("IndexedDB is not available");return}this.dbPromise=new Promise((e,t)=>{const n=indexedDB.open(this.dbName,this.DB_VERSION);n.onerror=()=>{t(new Error(`Failed to open database: ${this.dbName}`))},n.onsuccess=()=>{e(n.result)},n.onupgradeneeded=o=>{const s=o.target.result;s.objectStoreNames.contains(this.storeName)||s.createObjectStore(this.storeName)}})}async getDB(){if(!this.dbPromise)throw new Error("IndexedDB is not initialized");return this.dbPromise}async withStore(e,t){const n=await this.getDB();return new Promise((o,s)=>{const a=n.transaction([this.storeName],e).objectStore(this.storeName),i=t(a);i.onsuccess=()=>{o(i.result)},i.onerror=()=>{s(i.error)}})}async getItem(e){try{const t=await this.withStore("readonly",n=>n.get(String(e)));return t===void 0?void 0:t}catch(t){console.error(`Failed to get value for key: ${String(e)}`,t);return}}async setItem(e,t){try{return await this.withStore("readwrite",n=>n.put(t,String(e))),t}catch(n){throw console.error(`Failed to set value for key: ${String(e)}`,n),n}}async removeItem(e){try{await this.withStore("readwrite",t=>t.delete(String(e)))}catch(t){throw console.error(`Failed to remove value for key: ${String(e)}`,t),t}}async clear(){try{await this.withStore("readwrite",e=>e.clear())}catch(e){throw console.error("Failed to clear storage",e),e}}async length(){try{return await this.withStore("readonly",e=>e.count())}catch(e){return console.error("Failed to get storage length",e),0}}async key(e){try{return(await this.withStore("readonly",t=>t.getAllKeys()))[e]}catch(t){console.error("Failed to get key",t);return}}async keys(){try{return await this.withStore("readonly",e=>e.getAllKeys())}catch(e){return console.error("Failed to get all keys",e),[]}}async iterate(e){try{const t=(await this.getDB()).transaction([this.storeName],"readonly").objectStore(this.storeName).openCursor();return new Promise((n,o)=>{let s=0;t.onsuccess=a=>{const i=a.target.result;if(i){const u=i.key,h=i.value;e(h,u,s),s++,i.continue()}else n()},t.onerror=()=>{o(t.error)}})}catch(t){console.error("Failed to iterate storage",t)}}}const I={memory:"memory",local:"local",session:"session",indexeddb:"indexeddb"};function R(r,e){Object.assign(r,e)}function ee(r){return R(r,{async getItemOrDefault(e,t){const n=await this.getItem(e);return n!==null?n:t},async hasItem(e){return await this.getItem(e)!==null},async removeItems(e){await Promise.all(e.map(t=>this.removeItem(t)))},async getItems(e){return await Promise.all(e.map(t=>this.getItem(t)))}}),r}function te(r){return R(r,{getItemOrDefault(e,t){const n=this.getItem(e);return n!==null?n:t},hasItem(e){return this.getItem(e)!==null},removeItems(e){e.forEach(t=>this.removeItem(t))},getItems(e){return e.map(t=>this.getItem(t))}}),r}function re(r){const e=r.getItem("");return X(e)?ee(r):te(r)}function E(r,...e){const t=M(r);let n;try{n=new t(...e)}catch{n=t(...e)}return re(n)}C(Q,I.memory),C(Z,I.local),C(Y,I.session),C(W,I.indexeddb);function D(r,e){return{value:r,expireAt:Date.now()+e}}function F(r,e=Date.now()){return r.expireAt<=e}function ne(r,e=Date.now()){return F(r,e)?void 0:r.value}const oe=r=>{const{config:e}=r,{method:t,url:n,data:o}=e;return[t,n,JSON.stringify(o)].join("|")},se=()=>!0,$=24*60*60*1e3,ie={key:oe,duration:$,isValid:se,store:I.memory};class ae{store;constructor(e){return typeof e=="string"?this.store=E(e):(C(e.factory,e.key),this.store=E(e.key)),new Proxy(this,{get(t,n){if(n in t)return t[n];const o=t.store[n];return typeof o=="function"?o.bind(t.store):o}})}setCache(e,t,n=$){const o=D(t,n);this.store.setItem(e,o)}async getCache(e){const t=await this.store.getItem(e);if(t)return ne(t)}async hasValidCache(e){const t=await this.store.getItem(e);return t?!F(t):!1}}const ce=ae,V=r=>{const e={...ie,...r},t=new ce(e.store),n=s=>typeof e.duration=="function"?e.duration(s):e.duration;return Object.assign(async({config:s,next:a})=>{const i=e.key({config:s}),u=await t.getCache(i);if(u){if(await e.isValid({key:i,config:s,cachedData:u}))return u;t.removeItem(i)}const h=await a(),k=n({key:i,config:s,cachedData:u,response:h}),l=D(h,k);return t.setItem(i,l),h},{__middlewareType:f.CACHE,storage:t})};class ue extends Error{constructor(e,t){super(`请求在节流队列中等待超时：配置超时 ${e}ms，实际等待 ${t}ms`),this.name="ThrottleTimeoutError"}}function le(r,e){const t=[];let n=0,o=!1;const s=l=>new Promise(d=>setTimeout(d,l)),a=()=>{if(e===void 0||t.length===0)return!1;const l=Date.now(),d=t[0],m=l-d.timestamp;return m>=e?(t.shift(),d.reject(new ue(e,m)),!0):!1},i=async()=>{if(!(o||t.length===0)){for(o=!0;t.length>0;){if(e!==void 0&&a())continue;if(t.length===0)break;const d=Date.now()-n;if(n>0&&d<r){const ge=r-d;await s(ge)}const m=t.shift();m&&(n=Date.now(),m.task().then(m.resolve).catch(m.reject))}o=!1}};return{add:l=>new Promise((d,m)=>{t.push({task:l,resolve:d,reject:m,timestamp:Date.now()}),i()}),getStatus:()=>{const l=t.length>0?n+r:null;return{queueLength:t.length,lastExecutionTime:n,isProcessing:o,nextExecutionTime:l}},clear:()=>{t.length=0}}}const de={interval:1e3},he=r=>{const e={...de,...r},t=le(e.interval,e.timeout);return Object.assign(async({config:o,next:s})=>t.add(s),{__middlewareType:f.THROTTLE,throttler:t})};function me(r){const{instanceKey:e,key:t,duration:n,isValid:o,store:s,...a}=r;return S({instanceKey:e,extensions:[q(a),V({key:t,duration:n,isValid:o,store:s})]})}function ye(r){const{instanceKey:e,parallelCount:t,createId:n,retries:o,delay:s,retryCondition:a}=r;return S({instanceKey:e,extensions:[O({parallelCount:t,createId:n}),N({retries:o,delay:s,retryCondition:a})]})}c.cache=V,c.concurrent=O,c.createCachedIdempotentRequestor=me,c.createConcurrentRetryRequestor=ye,c.createRequestor=S,c.idempotent=q,c.inject=B,c.retry=N,c.throttle=he,c.useRequestor=T,Object.defineProperty(c,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,36 +1,36 @@
 {
-  "name": "@net-vert/core",
-  "version": "1.3.1",
-  "description": "Dependency Inversion Network Library with Type-Safe Injection.",
-  "main": "dist/index",
-  "type": "module",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "sideEffects": false,
-  "keywords": [
-    "dependency-injection",
-    "di",
-    "network-library",
-    "adapter-pattern",
-    "extensible",
-    "http-client",
-    "lightweight"
-  ],
-  "author": "yuzinan <1589937631@qq.com>",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "id-queue": "^1.1.1",
-    "store-vert": "^0.2.0"
-  },
-  "scripts": {
-    "test": "vitest run",
-    "build": "run-p type-check build-only",
-    "build-only": "vite build",
-    "type-check": "tsc --noEmit"
-  }
-}
+    "name": "@net-vert/core",
+    "version": "1.3.4",
+    "description": "Dependency Inversion Network Library with Type-Safe Injection.",
+    "main": "dist/index",
+    "type": "module",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "test": "vitest run",
+        "build": "run-p type-check build-only",
+        "build-only": "vite build",
+        "type-check": "tsc --noEmit"
+    },
+    "files": [
+        "dist"
+    ],
+    "sideEffects": false,
+    "keywords": [
+        "dependency-injection",
+        "di",
+        "network-library",
+        "adapter-pattern",
+        "extensible",
+        "http-client",
+        "lightweight"
+    ],
+    "author": "yuzinan <1589937631@qq.com>",
+    "license": "MIT",
+    "publishConfig": {
+        "access": "public"
+    },
+    "dependencies": {
+        "id-queue": "^1.1.1",
+        "store-vert": "^0.2.0"
+    }
+}