@net-vert/core 1.0.0 → 1.2.0

package/dist/index.d.ts

@@ -1,67 +1,11 @@
+import { AnyRecord } from 'store-vert';
+import { EnhancedStore } from 'store-vert';
+import { Key as Key_2 } from 'store-vert';
+import { Store } from 'store-vert';
+import { StoreFactory } from 'store-vert';
+import { StoreKey } from 'store-vert';
 import { TaskQueue } from 'id-queue';
 
-declare type AnyRecord = Record<string | number | symbol, any>;
-
-declare type AnyRecord_2 = Record<string, any>;
-
-/**
- * 缓存存储基类
- * 提供针对缓存场景的快捷方法，自动处理 ExpirableValue 的封装和解封
- */
-declare abstract class BaseCacheStorage<K extends string | number | symbol, R> {
-    abstract getItem(key: K): ExpirableValue<R> | undefined;
-    abstract setItem(key: K, value: ExpirableValue<R>): ExpirableValue<R>;
-    abstract removeItem(key: K): void;
-    abstract clear(): void;
-    abstract length(): number;
-    abstract keys(): K[];
-    abstract iterate(iteratee: (value: ExpirableValue<R>, key: K, iterationNumber: number) => void): void;
-    /**
-     * 获取缓存值（自动处理过期检查和解包）
-     * @param key 缓存键
-     * @returns 缓存的原始值，如果不存在或已过期返回 undefined
-     */
-    get(key: K): R | undefined;
-    /**
-     * 设置缓存值（自动包装为 ExpirableValue）
-     * @param key 缓存键
-     * @param value 要缓存的值
-     * @param duration 有效期（毫秒），默认 24 小时
-     */
-    set(key: K, value: R, duration?: number): void;
-    /**
-     * 删除指定缓存（别名方法，等同于 removeItem）
-     * @param key 缓存键
-     */
-    delete(key: K): void;
-    /**
-     * 检查缓存是否存在且未过期
-     * @param key 缓存键
-     */
-    has(key: K): boolean;
-    /**
-     * 获取缓存数量（别名方法，等同于 length）
-     */
-    size(): number;
-    /**
-     * 遍历所有有效的缓存（自动跳过已过期的，并解包值）
-     * @param callback 回调函数，接收解包后的值、键和索引
-     */
-    forEach(callback: (value: R, key: K, index: number) => void): void;
-    /**
-     * 清理所有过期的缓存
-     * @returns 清理的缓存数量
-     */
-    clearExpired(): number;
-    /**
-     * 更新缓存的过期时间（不改变值）
-     * @param key 缓存键
-     * @param duration 新的有效期（毫秒）
-     * @returns 是否更新成功
-     */
-    touch(key: K, duration: number): boolean;
-}
-
 export declare type BaseRequestor = (config: RequestConfig<any>) => any;
 
 /**
@@ -70,7 +14,7 @@ export declare type BaseRequestor = (config: RequestConfig<any>) => any;
  * - 自定义缓存 key 生成
  * - 自定义缓存有效期（固定时长或动态计算）
  * - 自定义缓存有效性校验
- * - 持久化存储（LocalStorage）或内存存储
+ * - 自定义存储介质
  */
 export declare const cache: <D = any, R = any>(options?: Partial<CacheOptions<D, R>>) => CacheMiddleware<D, R>;
 
@@ -78,7 +22,7 @@ export declare const cache: <D = any, R = any>(options?: Partial<CacheOptions<D,
 declare interface CacheCheckContext<D = any, R = any> {
     key: CacheKey;
     config: RequestConfig<D>;
-    cachedData?: ExpirableValue<R>;
+    cachedData?: R;
 }
 
 /**
@@ -90,46 +34,16 @@ IdempotencyOptions<D>
 ]>;
 
 /** 缓存 key 类型 */
-declare type CacheKey = string | number | symbol;
+export declare type CacheKey = string | number | symbol;
 
 /** 请求前上下文：生成缓存 key */
 declare interface CacheKeyContext<D = any> {
     config: RequestConfig<D>;
 }
 
-/**
- * 基于 LocalStorage 的缓存存储
- * 继承 LocalStorage 并扩展缓存快捷方法
- */
-declare class CacheLocalStorage<K extends string | number | symbol = string, R = any> extends LocalStorage<Record<K, ExpirableValue<R>>> implements BaseCacheStorage<K, R> {
-    get: (key: any) => any;
-    set: (key: any, value: any, duration?: number) => void;
-    delete: (key: any) => void;
-    has: (key: any) => boolean;
-    size: () => number;
-    forEach: (callback: (value: any, key: any, index: number) => void) => void;
-    clearExpired: () => number;
-    touch: (key: any, duration: number) => boolean;
-}
-
-/**
- * 基于内存的缓存存储
- * 继承 MemoryStorage 并扩展缓存快捷方法
- */
-declare class CacheMemoryStorage<K extends string | number | symbol = string, R = any> extends MemoryStorage<Record<K, ExpirableValue<R>>> implements BaseCacheStorage<K, R> {
-    get: (key: any) => any;
-    set: (key: any, value: any, duration?: number) => void;
-    delete: (key: any) => void;
-    has: (key: any) => boolean;
-    size: () => number;
-    forEach: (callback: (value: any, key: any, index: number) => void) => void;
-    clearExpired: () => number;
-    touch: (key: any, duration: number) => boolean;
-}
-
 /** 缓存中间件类型（带 storage 实例）*/
 declare type CacheMiddleware<D = any, R = any> = TypedMiddleware<MIDDLEWARE_TYPE.CACHE, false, D, R> & {
-    storage: CacheStorage_2<CacheKey, R>;
+    storage: CacheStorageInstance<R>;
 };
 
 /** 缓存模块配置 */
@@ -151,21 +65,19 @@ declare interface CacheOptions<D = any, R = any> {
      * - 返回 boolean 或 Promise<boolean>
      */
     isValid: (ctx: CacheCheckContext<D, R>) => boolean | Promise<boolean>;
-    /** 缓存介质, 待开发, 目前只支持内存和持久化 */
-    persist: boolean;
+    /** 缓存介质 */
+    store: StoreDescriptor;
 }
 
-/**
- * CacheStorage 类型别名
- * 可以是 CacheMemoryStorage 或 CacheLocalStorage
- */
-declare type CacheStorage_2<K extends string | number | symbol = string, R = any> = CacheMemoryStorage<K, R> | CacheLocalStorage<K, R>;
+declare type CacheSchema<R> = Record<CacheKey, R>;
+
+declare type CacheStorageInstance<R = any> = ExpirableCacheStorage<R> & EnhancedStore<ExpirableSchema<CacheSchema<R>>>;
 
 /** 请求后上下文：更新缓存 */
 declare interface CacheUpdateContext<D = any, R = any> {
     key: CacheKey;
     config: RequestConfig<D>;
-    cachedData?: ExpirableValue<R>;
+    cachedData?: R;
     response: R;
 }
 
@@ -235,6 +147,38 @@ export declare interface CreateRequestorConfig<Extensions extends readonly Middl
     instanceKey?: Key;
 }
 
+declare class ExpirableCacheStorage<R = any> {
+    store: EnhancedStore<ExpirableSchema<CacheSchema<R>>>;
+    constructor(store: StoreDescriptor);
+    /**
+     * 设置缓存（自动包装成 ExpirableValue）
+     * @param key 缓存 key
+     * @param value 要缓存的值
+     * @param duration 过期时长（毫秒），默认 24 小时
+     */
+    setCache(key: CacheKey, value: R, duration?: number): void;
+    /**
+     * 获取缓存值（检查过期，如果过期返回 undefined）
+     * @param key 缓存 key
+     * @returns 未过期返回值，已过期返回 undefined
+     */
+    getCache(key: CacheKey): Promise<R | undefined>;
+    /**
+     * 检查是否有有效的缓存（未过期）
+     * @param key 缓存 key
+     * @returns true 表示有有效缓存，false 表示无缓存或已过期
+     */
+    hasValidCache(key: CacheKey): Promise<boolean>;
+}
+
+/**
+ * 将 Schema 的所有值类型映射为 ExpirableValue 包装的版本
+ * 用于缓存存储的类型转换
+ */
+export declare type ExpirableSchema<Schema extends AnyRecord> = {
+    [K in keyof Schema]: ExpirableValue<Schema[K]>;
+};
+
 /**
  * 带过期时间的值类型（通用型）
  * 可用于缓存、幂等、同步等需要时间控制的场景
@@ -288,71 +232,10 @@ declare type IdempotentMiddleware<D = any, R = any> = TypedMiddleware<MIDDLEWARE
 
 export declare const inject: (requestor: BaseRequestor, instanceKey?: string) => void;
 
-/**
- * Storage 接口
- * 定义存储器的基本操作
- */
-export declare interface IStorage<Schema extends Record<string, any> = Record<string, any>> {
-    /**
-     * 获取存储项
-     */
-    getItem<K extends keyof Schema>(key: K): Schema[K] | undefined;
-    /**
-     * 设置存储项
-     */
-    setItem<K extends keyof Schema>(key: K, value: Schema[K]): Schema[K];
-    /**
-     * 删除存储项
-     */
-    removeItem<K extends keyof Schema>(key: K): void;
-    /**
-     * 清空所有存储项
-     */
-    clear(): void;
-    /**
-     * 获取存储项数量
-     */
-    length(): number;
-    /**
-     * 获取所有 key
-     */
-    keys(): (keyof Schema)[];
-    /**
-     * 遍历所有存储项
-     */
-    iterate(iteratee: <K extends keyof Schema>(value: Schema[K], key: K, iterationNumber: number) => void): void;
-}
-
 export declare type Key = string | symbol | number;
 
-/**
- * LocalStorage 存储类
- * 基于浏览器的 localStorage 实现
- */
-declare class LocalStorage<Schema extends AnyRecord_2 = AnyRecord_2> implements IStorage<Schema> {
-    constructor();
-    getItem<K extends keyof Schema>(key: K): Schema[K] | undefined;
-    setItem<K extends keyof Schema>(key: K, value: Schema[K]): Schema[K];
-    removeItem<K extends keyof Schema>(key: K): void;
-    clear(): void;
-    length(): number;
-    keys(): (keyof Schema)[];
-    iterate(iteratee: <K extends keyof Schema>(value: Schema[K], key: K, iterationNumber: number) => void): void;
-}
-
 export declare type MaybePromise<IsSync, R> = IsSync extends true ? R : IsSync extends false ? Promise<R> : R | Promise<R>;
 
-declare class MemoryStorage<Schema extends AnyRecord = AnyRecord> implements IStorage<Schema> {
-    private store;
-    getItem<K extends keyof Schema>(key: K): Schema[K] | undefined;
-    setItem<K extends keyof Schema>(key: K, value: Schema[K]): Schema[K];
-    removeItem<K extends keyof Schema>(key: K): void;
-    clear(): void;
-    length(): number;
-    keys(): (keyof Schema)[];
-    iterate(iteratee: <K extends keyof Schema>(value: Schema[K], key: K, iterationNumber: number) => void): void;
-}
-
 export declare type Middleware<IsSync extends boolean = false, D = any, R = any> = (context: {
     config: RequestConfig<D>;
     next: () => MaybePromise<IsSync, R>;
@@ -413,6 +296,11 @@ declare type RetryOptions<D = any> = {
 
 declare type SafeKey = string | number | symbol;
 
+export declare type StoreDescriptor = StoreKey | {
+    key: Key_2;
+    factory: StoreFactory<Store<AnyRecord>, any[]>;
+};
+
 /**
  * 缓存中有数据则直接返回。
  * suspense 为 true 时，会抛出一个 Promise（而不是普通错误），Promise resolve 后得到数据。

package/dist/index.js

@@ -1,72 +1,72 @@
-var T = Object.defineProperty;
-var q = (r, e, t) => e in r ? T(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
-var c = (r, e, t) => q(r, typeof e != "symbol" ? e + "" : e, t);
-import { TaskQueue as O } from "id-queue";
-var y = /* @__PURE__ */ ((r) => (r.GET = "get", r.POST = "post", r.PUT = "put", r.DELETE = "delete", r))(y || {}), f = /* @__PURE__ */ ((r) => (r.CACHE = "cache", r.RETRY = "retry", r.IDEMPOTENT = "idempotent", r.CONCURRENT = "concurrent", r.SYNC = "sync", r))(f || {});
-const I = "default", N = {
+var D = Object.defineProperty;
+var F = (r, e, t) => e in r ? D(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
+var l = (r, e, t) => F(r, typeof e != "symbol" ? e + "" : e, t);
+import { TaskQueue as $ } from "id-queue";
+var w = /* @__PURE__ */ ((r) => (r.GET = "get", r.POST = "post", r.PUT = "put", r.DELETE = "delete", r))(w || {}), y = /* @__PURE__ */ ((r) => (r.CACHE = "cache", r.RETRY = "retry", r.IDEMPOTENT = "idempotent", r.CONCURRENT = "concurrent", r.SYNC = "sync", r))(y || {});
+const v = "default", E = {
   retries: 3,
   delay: 0,
   retryCondition: () => !0
-}, V = (r) => {
-  const e = { ...N, ...r };
-  return Object.assign(async ({ config: s, next: n }) => {
+}, T = (r) => {
+  const e = { ...E, ...r };
+  return Object.assign(async ({ config: n, next: s }) => {
     let o = 0, i;
     for (; o <= e.retries; )
       try {
-        return await n();
+        return await s();
       } catch (a) {
         if (i = a, o === e.retries)
           throw a;
-        const u = {
-          config: s,
+        const c = {
+          config: n,
           lastResponse: a,
           attempt: o
         };
-        if (!e.retryCondition(u))
+        if (!e.retryCondition(c))
           throw a;
         o++;
-        const d = typeof e.delay == "function" ? e.delay(u) : e.delay;
-        d > 0 && await new Promise((h) => setTimeout(h, d));
+        const u = typeof e.delay == "function" ? e.delay(c) : e.delay;
+        u > 0 && await new Promise((h) => setTimeout(h, u));
       }
     throw i;
-  }, { __middlewareType: f.RETRY });
-}, j = () => {
+  }, { __middlewareType: y.RETRY });
+}, q = () => {
   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() };
-}, K = (r) => {
-  const { config: e } = r, { method: t, url: s, data: n } = e;
-  return [t, s, JSON.stringify(n)].join("|");
-}, R = {
-  key: K
-}, b = (r) => {
-  const e = { ...R, ...r }, t = j();
-  return Object.assign(({ config: n, next: o }) => {
-    const i = e.key({ config: n }), a = t.getPromise(i);
+}, R = (r) => {
+  const { config: e } = r, { method: t, url: n, data: s } = e;
+  return [t, n, JSON.stringify(s)].join("|");
+}, B = {
+  key: R
+}, _ = (r) => {
+  const e = { ...B, ...r }, t = q();
+  return Object.assign(({ config: s, next: o }) => {
+    const i = e.key({ config: s }), a = t.getPromise(i);
     if (a)
       return a;
-    const u = o();
-    return t.setPromise(i, u), u;
+    const c = o();
+    return t.setPromise(i, c), c;
   }, {
-    __middlewareType: f.IDEMPOTENT,
+    __middlewareType: y.IDEMPOTENT,
     promiseCache: t
   });
 };
-class z {
+class K {
   constructor(e = 4) {
-    c(this, "parallelCount");
-    c(this, "tasks");
-    c(this, "runningCount");
-    this.parallelCount = e, this.tasks = new O(), this.runningCount = 0;
+    l(this, "parallelCount");
+    l(this, "tasks");
+    l(this, "runningCount");
+    this.parallelCount = e, this.tasks = new $(), this.runningCount = 0;
   }
   // 加入
   add(e, t) {
-    return new Promise((s, n) => {
+    return new Promise((n, s) => {
       this.tasks.enqueue(e, {
         task: t,
-        resolve: s,
-        reject: n
+        resolve: n,
+        reject: s
       }), this._run();
     });
   }
@@ -75,8 +75,8 @@ class z {
     this.tasks.remove(e);
   }
   execute(e) {
-    const { task: t, resolve: s, reject: n } = e;
-    return t().then(s).catch(n).finally(() => {
+    const { task: t, resolve: n, reject: s } = e;
+    return t().then(n).catch(s).finally(() => {
       this.runningCount--, this._run();
     });
   }
@@ -87,20 +87,28 @@ class z {
     }
   }
 }
-let _ = 0;
-const $ = {
+let A = 0;
+const J = {
   parallelCount: 4,
-  createId: () => _++
-}, J = (r) => {
-  const { parallelCount: e, createId: t } = { ...$, ...r }, s = new z(e);
+  createId: () => A++
+}, z = (r) => {
+  const { parallelCount: e, createId: t } = { ...J, ...r }, n = new K(e);
   return Object.assign(({ config: o, next: i }) => {
     const a = t({ config: o });
-    return s.add(a, () => i());
-  }, { __middlewareType: f.CONCURRENT, pool: s });
+    return n.add(a, () => i());
+  }, { __middlewareType: y.CONCURRENT, pool: n });
+}, b = /* @__PURE__ */ new Map(), g = (r, e) => {
+  b.set(e, r);
 };
-class v {
+function G(r) {
+  const e = b.get(r);
+  if (!e)
+    throw new Error(`Store实例 ${String(r)} 未注册`);
+  return e;
+}
+class U {
   constructor() {
-    c(this, "store", /* @__PURE__ */ new Map());
+    l(this, "store", /* @__PURE__ */ new Map());
   }
   getItem(e) {
     return this.store.get(e);
@@ -117,353 +125,574 @@ class v {
   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 [s, n] of this.store.entries())
-      e(n, s, t), t++;
+    for (const [n, s] of this.store.entries())
+      e(s, n, t), t++;
   }
 }
-const p = typeof window < "u" ? window.localStorage : {};
-class k {
+const Y = (r) => !!r && (typeof r == "object" || typeof r == "function") && typeof r.then == "function", N = (r) => typeof window < "u" ? r() : {
+  getItem() {
+    return null;
+  },
+  setItem() {
+  },
+  removeItem() {
+  },
+  clear() {
+  },
+  key() {
+    return null;
+  },
+  get length() {
+    return 0;
+  }
+}, d = N(() => window.localStorage);
+class M {
   constructor() {
   }
   getItem(e) {
-    const t = String(e), s = p.getItem(t);
-    if (s !== null)
+    const t = String(e), n = d.getItem(t);
+    if (n !== null)
       try {
-        return JSON.parse(s);
-      } catch (n) {
-        console.error(`Failed to parse value for key: ${t}`, n);
+        return JSON.parse(n);
+      } catch (s) {
+        console.error(`Failed to parse value for key: ${t}`, s);
         return;
       }
   }
   setItem(e, t) {
-    const s = String(e);
+    const n = String(e);
     try {
-      p.setItem(s, JSON.stringify(t));
-    } catch (n) {
-      throw console.error(`Failed to set value for key: ${s}`, n), n;
+      d.setItem(n, JSON.stringify(t));
+    } catch (s) {
+      throw console.error(`Failed to set value for key: ${n}`, s), s;
     }
     return t;
   }
   removeItem(e) {
     const t = String(e);
-    p.removeItem(t);
+    d.removeItem(t);
   }
   clear() {
-    p.clear();
+    d.clear();
   }
   length() {
-    return p.length;
+    return d.length;
+  }
+  key(e) {
+    return d.key(e);
   }
   keys() {
     const e = [];
-    for (let t = 0; t < p.length; t++) {
-      const s = p.key(t);
-      s && e.push(s);
+    for (let t = 0; t < d.length; t++) {
+      const n = d.key(t);
+      n && e.push(n);
     }
     return e;
   }
   iterate(e) {
-    this.keys().forEach((s, n) => {
-      const o = this.getItem(s);
-      o !== void 0 && e(o, s, n);
+    this.keys().forEach((t, n) => {
+      const s = this.getItem(t);
+      s !== void 0 && e(s, t, n);
     });
   }
 }
-function w(r, e) {
+const m = N(() => window.sessionStorage);
+class X {
+  constructor() {
+  }
+  getItem(e) {
+    const t = String(e), n = m.getItem(t);
+    if (n !== null)
+      try {
+        return JSON.parse(n);
+      } catch (s) {
+        console.error(`Failed to parse value for key: ${t}`, s);
+        return;
+      }
+  }
+  setItem(e, t) {
+    const n = String(e);
+    try {
+      m.setItem(n, JSON.stringify(t));
+    } catch (s) {
+      throw console.error(`Failed to set value for key: ${n}`, s), s;
+    }
+    return t;
+  }
+  removeItem(e) {
+    const t = String(e);
+    m.removeItem(t);
+  }
+  clear() {
+    m.clear();
+  }
+  length() {
+    return m.length;
+  }
+  key(e) {
+    return m.key(e);
+  }
+  keys() {
+    const e = [];
+    for (let t = 0; t < m.length; t++) {
+      const n = m.key(t);
+      n && e.push(n);
+    }
+    return e;
+  }
+  iterate(e) {
+    this.keys().forEach((t, n) => {
+      const s = this.getItem(t);
+      s !== void 0 && e(s, t, n);
+    });
+  }
+}
+class Z {
+  constructor(e, t) {
+    l(this, "dbName");
+    l(this, "storeName");
+    l(this, "dbPromise", null);
+    l(this, "DB_VERSION", 1);
+    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 = (s) => {
+        const o = s.target.result;
+        o.objectStoreNames.contains(this.storeName) || o.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((s, o) => {
+      const i = n.transaction([this.storeName], e).objectStore(this.storeName), a = t(i);
+      a.onsuccess = () => {
+        s(a.result);
+      }, a.onerror = () => {
+        o(a.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, s) => {
+        let o = 0;
+        t.onsuccess = (i) => {
+          const a = i.target.result;
+          if (a) {
+            const c = a.key, u = a.value;
+            e(u, c, o), o++, a.continue();
+          } else
+            n();
+        }, t.onerror = () => {
+          s(t.error);
+        };
+      });
+    } catch (t) {
+      console.error("Failed to iterate storage", t);
+    }
+  }
+}
+const f = {
+  memory: "memory",
+  local: "local",
+  session: "session",
+  indexeddb: "indexeddb"
+};
+function x(r, e) {
+  Object.assign(r, e);
+}
+function H(r) {
+  return x(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 L(r) {
+  return x(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 Q(r) {
+  const e = r.getItem("");
+  return Y(e) ? H(r) : L(r);
+}
+function p(r, ...e) {
+  const t = G(r);
+  let n;
+  try {
+    n = new t(...e);
+  } catch {
+    n = t(...e);
+  }
+  return Q(n);
+}
+g(U, f.memory);
+g(M, f.local);
+g(X, f.session);
+g(Z, f.indexeddb);
+function I(r, e) {
   return {
     value: r,
     expireAt: Date.now() + e
   };
 }
-function m(r, e = Date.now()) {
+function k(r, e = Date.now()) {
   return r.expireAt <= e;
 }
-function g(r) {
-  return r.value;
+function P(r, e = Date.now()) {
+  return k(r, e) ? void 0 : r.value;
 }
-const A = (r) => {
-  const { config: e } = r, { method: t, url: s, data: n } = e;
-  return [t, s, JSON.stringify(n)].join("|");
-}, F = () => !0, x = 24 * 60 * 60 * 1e3, G = {
-  key: A,
-  duration: x,
-  isValid: F,
-  persist: !1
+const W = (r) => {
+  const { config: e } = r, { method: t, url: n, data: s } = e;
+  return [t, n, JSON.stringify(s)].join("|");
+}, ee = () => !0, S = 24 * 60 * 60 * 1e3, te = {
+  key: W,
+  duration: S,
+  isValid: ee,
+  store: f.memory
   // 默认不持久化，使用内存存储
 };
-class l {
-  // ============ 扩展方法（自动处理过期和封装）============
-  /**
-   * 获取缓存值（自动处理过期检查和解包）
-   * @param key 缓存键
-   * @returns 缓存的原始值，如果不存在或已过期返回 undefined
-   */
-  get(e) {
-    const t = this.getItem(e);
-    if (t) {
-      if (m(t)) {
-        this.removeItem(e);
-        return;
+let re = class {
+  constructor(e) {
+    l(this, "store");
+    return typeof e == "string" ? this.store = p(e) : (g(e.factory, e.key), this.store = p(e.key)), new Proxy(this, {
+      get(t, n) {
+        if (n in t)
+          return t[n];
+        const s = t.store[n];
+        return typeof s == "function" ? s.bind(t.store) : s;
       }
-      return g(t);
-    }
+    });
   }
   /**
-   * 设置缓存值（自动包装为 ExpirableValue）
-   * @param key 缓存键
+   * 设置缓存（自动包装成 ExpirableValue）
+   * @param key 缓存 key
    * @param value 要缓存的值
-   * @param duration 有效期（毫秒），默认 24 小时
-   */
-  set(e, t, s = x) {
-    const n = w(t, s);
-    this.setItem(e, n);
-  }
-  /**
-   * 删除指定缓存（别名方法，等同于 removeItem）
-   * @param key 缓存键
+   * @param duration 过期时长（毫秒），默认 24 小时
    */
-  delete(e) {
-    this.removeItem(e);
+  setCache(e, t, n = S) {
+    const s = I(t, n);
+    this.store.setItem(e, s);
   }
   /**
-   * 检查缓存是否存在且未过期
-   * @param key 缓存键
+   * 获取缓存值（检查过期，如果过期返回 undefined）
+   * @param key 缓存 key
+   * @returns 未过期返回值，已过期返回 undefined
    */
-  has(e) {
-    const t = this.getItem(e);
-    return t ? m(t) ? (this.removeItem(e), !1) : !0 : !1;
+  async getCache(e) {
+    const t = await this.store.getItem(e);
+    if (t)
+      return P(t);
   }
   /**
-   * 获取缓存数量（别名方法，等同于 length）
+   * 检查是否有有效的缓存（未过期）
+   * @param key 缓存 key
+   * @returns true 表示有有效缓存，false 表示无缓存或已过期
    */
-  size() {
-    return this.length();
+  async hasValidCache(e) {
+    const t = await this.store.getItem(e);
+    return t ? !k(t) : !1;
   }
-  /**
-   * 遍历所有有效的缓存（自动跳过已过期的，并解包值）
-   * @param callback 回调函数，接收解包后的值、键和索引
-   */
-  forEach(e) {
-    let t = 0;
-    this.iterate((s, n, o) => {
-      if (m(s))
-        this.removeItem(n);
-      else {
-        const i = g(s);
-        e(i, n, t), t++;
+};
+const ne = re, se = (r) => {
+  const e = { ...te, ...r }, t = new ne(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) {
+      if (await e.isValid({
+        key: a,
+        config: o,
+        cachedData: c
+      })) return c;
+      t.removeItem(a);
+    }
+    const u = await i(), h = n({ key: a, config: o, cachedData: c, response: u }), C = I(u, h);
+    return t.setItem(a, C), u;
+  }, {
+    __middlewareType: y.CACHE,
+    storage: t
+  });
+};
+class oe {
+  constructor(e) {
+    l(this, "store");
+    return typeof e == "string" ? this.store = p(e) : (g(e.factory, e.key), this.store = p(e.key)), new Proxy(this, {
+      get(t, n) {
+        if (n in t)
+          return t[n];
+        const s = t.store[n];
+        return typeof s == "function" ? s.bind(t.store) : s;
       }
     });
   }
   /**
-   * 清理所有过期的缓存
-   * @returns 清理的缓存数量
+   * 设置缓存（自动包装成 ExpirableValue）
+   * @param key 缓存 key
+   * @param value 要缓存的值
+   * @param duration 过期时长（毫秒），默认 24 小时
    */
-  clearExpired() {
-    let e = 0;
-    return this.keys().forEach((s) => {
-      const n = this.getItem(s);
-      n && m(n) && (this.removeItem(s), e++);
-    }), e;
+  setCache(e, t, n = S) {
+    const s = I(t, n);
+    this.store.setItem(e, s);
   }
   /**
-   * 更新缓存的过期时间（不改变值）
-   * @param key 缓存键
-   * @param duration 新的有效期（毫秒）
-   * @returns 是否更新成功
+   * 获取缓存值（检查过期，如果过期返回 undefined）
+   * @param key 缓存 key
+   * @returns 未过期返回值，已过期返回 undefined
    */
-  touch(e, t) {
-    const s = this.getItem(e);
-    if (!s) return !1;
-    if (m(s))
-      return this.removeItem(e), !1;
-    const n = g(s);
-    return this.set(e, n, t), !0;
+  getCache(e) {
+    const t = this.store.getItem(e);
+    if (t)
+      return P(t);
   }
-}
-class D extends v {
-  constructor() {
-    super(...arguments);
-    // 继承 MemoryStorage 的所有方法：getItem, setItem, removeItem, clear, length, keys, iterate
-    // 从 BaseCacheStorage 继承扩展方法
-    c(this, "get", l.prototype.get);
-    c(this, "set", l.prototype.set);
-    c(this, "delete", l.prototype.delete);
-    c(this, "has", l.prototype.has);
-    c(this, "size", l.prototype.size);
-    c(this, "forEach", l.prototype.forEach);
-    c(this, "clearExpired", l.prototype.clearExpired);
-    c(this, "touch", l.prototype.touch);
-  }
-}
-class U extends k {
-  constructor() {
-    super(...arguments);
-    // 继承 LocalStorage 的所有方法：getItem, setItem, removeItem, clear, length, keys, iterate
-    // 从 BaseCacheStorage 继承扩展方法
-    c(this, "get", l.prototype.get);
-    c(this, "set", l.prototype.set);
-    c(this, "delete", l.prototype.delete);
-    c(this, "has", l.prototype.has);
-    c(this, "size", l.prototype.size);
-    c(this, "forEach", l.prototype.forEach);
-    c(this, "clearExpired", l.prototype.clearExpired);
-    c(this, "touch", l.prototype.touch);
+  /**
+   * 检查是否有有效的缓存（未过期）
+   * @param key 缓存 key
+   * @returns true 表示有有效缓存，false 表示无缓存或已过期
+   */
+  hasValidCache(e) {
+    const t = this.store.getItem(e);
+    return t ? !k(t) : !1;
   }
 }
-const B = (r) => {
-  const e = { ...G, ...r }, t = e.persist ? new U() : new D(), s = (o) => typeof e.duration == "function" ? e.duration(o) : e.duration;
-  return Object.assign(async ({ config: o, next: i }) => {
-    const a = e.key({ config: o }), u = t.getItem(a);
-    if (u) {
-      if (!m(u) && await e.isValid({
-        key: a,
-        config: o,
-        cachedData: u
-      }))
-        return g(u);
-      t.removeItem(a);
-    }
-    const d = await i(), h = s({ key: a, config: o, cachedData: u, response: d }), C = w(d, h);
-    return t.setItem(a, C), d;
-  }, {
-    __middlewareType: f.CACHE,
-    storage: t
-  });
-}, L = (r) => {
-  const { config: e } = r, { method: t, url: s } = e;
-  return [t, s].join("|");
-}, M = {
+const ae = oe, ie = (r) => {
+  const { config: e } = r, { method: t, url: n } = e;
+  return [t, n].join("|");
+}, ce = {
   suspense: !0,
-  key: L,
+  key: ie,
   duration: 24 * 60 * 60 * 1e3,
   isValid: () => !0,
-  persist: !1
+  store: f.memory
 };
-function te(r) {
-  const e = { ...M, ...r }, t = e.persist ? new k() : new v(), s = (o) => typeof e.duration == "function" ? e.duration(o) : e.duration;
+function we(r) {
+  const e = { ...ce, ...r }, t = new ae(e.store), n = (o) => typeof e.duration == "function" ? e.duration(o) : e.duration;
   return Object.assign(({ config: o, next: i }) => {
-    const a = e.key({ config: o }), u = t.getItem(a);
-    if (u) {
-      if (!m(u) && e.isValid({
+    const a = e.key({ config: o }), c = t.getCache(a);
+    if (c) {
+      if (e.isValid({
         key: a,
         config: o,
-        cachedData: u
-      }))
-        return g(u);
+        cachedData: c
+      })) return c;
       t.removeItem(a);
     }
     if (e.suspense)
       throw (e.wrapSuspense ? e.wrapSuspense({ key: a, config: o, p: i() }) : i()).then((h) => {
-        const C = s({ key: a, config: o, cachedData: u, response: h });
-        return t.setItem(a, w(h, C)), h;
+        const C = n({ key: a, config: o, cachedData: c, response: h });
+        return t.setCache(a, h, C), h;
       });
-    return i().then((d) => {
-      const h = s({ key: a, config: o, cachedData: u, response: d });
-      return t.setItem(a, w(d, h)), d;
+    return i().then((u) => {
+      const h = n({ key: a, config: o, cachedData: c, response: u });
+      return t.setCache(a, u, h), u;
     });
-  }, { __middlewareType: f.SYNC });
+  }, { __middlewareType: y.SYNC });
 }
-const S = /* @__PURE__ */ new Map(), re = (r, e = I) => {
-  S.set(e, r);
-}, Y = (r = I) => {
-  const e = S.get(r);
+const V = /* @__PURE__ */ new Map(), pe = (r, e = v) => {
+  V.set(e, r);
+}, ue = (r = v) => {
+  const e = V.get(r);
   if (!e) throw new Error(`Requestor实例 ${String(r)} 未注册`);
   return e;
-}, E = {
+}, O = {
   get: (r, e) => ({
     url: r,
-    method: y.GET,
+    method: w.GET,
     ...e,
     params: e == null ? void 0 : e.params
   }),
   post: (r, e, t) => ({
     url: r,
-    method: y.POST,
+    method: w.POST,
     data: e,
     ...t
   }),
   delete: (r, e) => ({
     url: r,
-    method: y.DELETE,
+    method: w.DELETE,
     ...e
   }),
   put: (r, e, t) => ({
     url: r,
-    method: y.PUT,
+    method: w.PUT,
     data: e,
     ...t
   }),
   request: (r) => r
-}, X = Object.keys(E);
-function Z(r, e, t) {
-  const s = {}, n = (o) => {
+}, le = Object.keys(O);
+function he(r, e, t) {
+  const n = {}, s = (o) => {
     if (o === e.length)
       return t(r);
     const i = e[o];
     return i({
       config: r,
-      ctx: s,
-      next: () => n(o + 1)
+      ctx: n,
+      next: () => s(o + 1)
     });
   };
-  return n(0);
+  return s(0);
 }
-function H(r, e) {
-  const t = {}, s = e ?? [];
-  return X.forEach(
-    (n) => {
-      t[n] = (...o) => {
-        const i = E[n](...o);
-        return Z(
+function de(r, e) {
+  const t = {}, n = e ?? [];
+  return le.forEach(
+    (s) => {
+      t[s] = (...o) => {
+        const i = O[s](...o);
+        return he(
           i,
-          s,
+          n,
           r
         );
       };
     }
   ), t;
 }
-function P(r) {
-  const { extensions: e, instanceKey: t } = r ?? {}, s = Y(t);
-  return H(
-    s,
+function j(r) {
+  const { extensions: e, instanceKey: t } = r ?? {}, n = ue(t);
+  return de(
+    n,
     e
   );
 }
-function se(r) {
-  const { instanceKey: e, key: t, duration: s, isValid: n, persist: o, ...i } = r;
-  return P({
+function Ce(r) {
+  const { instanceKey: e, key: t, duration: n, isValid: s, store: o, ...i } = r;
+  return j({
     instanceKey: e,
     extensions: [
-      b(i),
-      B({ key: t, duration: s, isValid: n, persist: o })
+      _(i),
+      se({ key: t, duration: n, isValid: s, store: o })
     ]
   });
 }
-function ne(r) {
-  const { instanceKey: e, parallelCount: t, createId: s, retries: n, delay: o, retryCondition: i } = r;
-  return P({
+function Ie(r) {
+  const { instanceKey: e, parallelCount: t, createId: n, retries: s, delay: o, retryCondition: i } = r;
+  return j({
     instanceKey: e,
     extensions: [
-      J({ parallelCount: t, createId: s }),
-      V({ retries: n, delay: o, retryCondition: i })
+      z({ parallelCount: t, createId: n }),
+      T({ retries: s, delay: o, retryCondition: i })
     ]
   });
 }
 export {
-  B as cache,
-  J as concurrent,
-  se as createCachedIdempotentRequestor,
-  ne as createConcurrentRetryRequestor,
-  P as createRequestor,
-  b as idempotent,
-  re as inject,
-  V as retry,
-  te as sync,
-  Y as useRequestor
+  se as cache,
+  z as concurrent,
+  Ce as createCachedIdempotentRequestor,
+  Ie as createConcurrentRetryRequestor,
+  j as createRequestor,
+  _ as idempotent,
+  pe as inject,
+  T as retry,
+  we as sync,
+  ue as useRequestor
 };

package/dist/index.umd.cjs

@@ -1 +1 @@
-(function(c,h){typeof exports=="object"&&typeof module<"u"?h(exports,require("id-queue")):typeof define=="function"&&define.amd?define(["exports","id-queue"],h):(c=typeof globalThis<"u"?globalThis:c||self,h(c.netVertCore={},c.idQueue))})(this,function(c,h){"use strict";var W=Object.defineProperty;var ee=(c,h,p)=>h in c?W(c,h,{enumerable:!0,configurable:!0,writable:!0,value:p}):c[h]=p;var u=(c,h,p)=>ee(c,typeof h!="symbol"?h+"":h,p);var p=(r=>(r.GET="get",r.POST="post",r.PUT="put",r.DELETE="delete",r))(p||{}),w=(r=>(r.CACHE="cache",r.RETRY="retry",r.IDEMPOTENT="idempotent",r.CONCURRENT="concurrent",r.SYNC="sync",r))(w||{});const q="default",N={retries:3,delay:0,retryCondition:()=>!0},S=r=>{const e={...N,...r};return Object.assign(async({config:s,next:n})=>{let o=0,i;for(;o<=e.retries;)try{return await n()}catch(a){if(i=a,o===e.retries)throw a;const l={config:s,lastResponse:a,attempt:o};if(!e.retryCondition(l))throw a;o++;const m=typeof e.delay=="function"?e.delay(l):e.delay;m>0&&await new Promise(f=>setTimeout(f,m))}throw i},{__middlewareType:w.RETRY})},b=()=>{const r=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()}},z={key:r=>{const{config:e}=r,{method:t,url:s,data:n}=e;return[t,s,JSON.stringify(n)].join("|")}},T=r=>{const e={...z,...r},t=b();return Object.assign(({config:n,next:o})=>{const i=e.key({config:n}),a=t.getPromise(i);if(a)return a;const l=o();return t.setPromise(i,l),l},{__middlewareType:w.IDEMPOTENT,promiseCache:t})};class _{constructor(e=4){u(this,"parallelCount");u(this,"tasks");u(this,"runningCount");this.parallelCount=e,this.tasks=new h.TaskQueue,this.runningCount=0}add(e,t){return new Promise((s,n)=>{this.tasks.enqueue(e,{task:t,resolve:s,reject:n}),this._run()})}remove(e){this.tasks.remove(e)}execute(e){const{task:t,resolve:s,reject:n}=e;return t().then(s).catch(n).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 $=0;const J={parallelCount:4,createId:()=>$++},R=r=>{const{parallelCount:e,createId:t}={...J,...r},s=new _(e);return Object.assign(({config:o,next:i})=>{const a=t({config:o});return s.add(a,()=>i())},{__middlewareType:w.CONCURRENT,pool:s})};class E{constructor(){u(this,"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}keys(){return Array.from(this.store.keys())}iterate(e){let t=0;for(const[s,n]of this.store.entries())e(n,s,t),t++}}const y=typeof window<"u"?window.localStorage:{};class P{constructor(){}getItem(e){const t=String(e),s=y.getItem(t);if(s!==null)try{return JSON.parse(s)}catch(n){console.error(`Failed to parse value for key: ${t}`,n);return}}setItem(e,t){const s=String(e);try{y.setItem(s,JSON.stringify(t))}catch(n){throw console.error(`Failed to set value for key: ${s}`,n),n}return t}removeItem(e){const t=String(e);y.removeItem(t)}clear(){y.clear()}length(){return y.length}keys(){const e=[];for(let t=0;t<y.length;t++){const s=y.key(t);s&&e.push(s)}return e}iterate(e){this.keys().forEach((s,n)=>{const o=this.getItem(s);o!==void 0&&e(o,s,n)})}}function I(r,e){return{value:r,expireAt:Date.now()+e}}function g(r,e=Date.now()){return r.expireAt<=e}function C(r){return r.value}const A=r=>{const{config:e}=r,{method:t,url:s,data:n}=e;return[t,s,JSON.stringify(n)].join("|")},F=()=>!0,j=24*60*60*1e3,G={key:A,duration:j,isValid:F,persist:!1};class d{get(e){const t=this.getItem(e);if(t){if(g(t)){this.removeItem(e);return}return C(t)}}set(e,t,s=j){const n=I(t,s);this.setItem(e,n)}delete(e){this.removeItem(e)}has(e){const t=this.getItem(e);return t?g(t)?(this.removeItem(e),!1):!0:!1}size(){return this.length()}forEach(e){let t=0;this.iterate((s,n,o)=>{if(g(s))this.removeItem(n);else{const i=C(s);e(i,n,t),t++}})}clearExpired(){let e=0;return this.keys().forEach(s=>{const n=this.getItem(s);n&&g(n)&&(this.removeItem(s),e++)}),e}touch(e,t){const s=this.getItem(e);if(!s)return!1;if(g(s))return this.removeItem(e),!1;const n=C(s);return this.set(e,n,t),!0}}class D extends E{constructor(){super(...arguments);u(this,"get",d.prototype.get);u(this,"set",d.prototype.set);u(this,"delete",d.prototype.delete);u(this,"has",d.prototype.has);u(this,"size",d.prototype.size);u(this,"forEach",d.prototype.forEach);u(this,"clearExpired",d.prototype.clearExpired);u(this,"touch",d.prototype.touch)}}class M extends P{constructor(){super(...arguments);u(this,"get",d.prototype.get);u(this,"set",d.prototype.set);u(this,"delete",d.prototype.delete);u(this,"has",d.prototype.has);u(this,"size",d.prototype.size);u(this,"forEach",d.prototype.forEach);u(this,"clearExpired",d.prototype.clearExpired);u(this,"touch",d.prototype.touch)}}const O=r=>{const e={...G,...r},t=e.persist?new M:new D,s=o=>typeof e.duration=="function"?e.duration(o):e.duration;return Object.assign(async({config:o,next:i})=>{const a=e.key({config:o}),l=t.getItem(a);if(l){if(!g(l)&&await e.isValid({key:a,config:o,cachedData:l}))return C(l);t.removeItem(a)}const m=await i(),f=s({key:a,config:o,cachedData:l,response:m}),k=I(m,f);return t.setItem(a,k),m},{__middlewareType:w.CACHE,storage:t})},U={suspense:!0,key:r=>{const{config:e}=r,{method:t,url:s}=e;return[t,s].join("|")},duration:24*60*60*1e3,isValid:()=>!0,persist:!1};function B(r){const e={...U,...r},t=e.persist?new P:new E,s=o=>typeof e.duration=="function"?e.duration(o):e.duration;return Object.assign(({config:o,next:i})=>{const a=e.key({config:o}),l=t.getItem(a);if(l){if(!g(l)&&e.isValid({key:a,config:o,cachedData:l}))return C(l);t.removeItem(a)}if(e.suspense)throw(e.wrapSuspense?e.wrapSuspense({key:a,config:o,p:i()}):i()).then(f=>{const k=s({key:a,config:o,cachedData:l,response:f});return t.setItem(a,I(f,k)),f});return i().then(m=>{const f=s({key:a,config:o,cachedData:l,response:m});return t.setItem(a,I(m,f)),m})},{__middlewareType:w.SYNC})}const x=new Map,L=(r,e=q)=>{x.set(e,r)},V=(r=q)=>{const e=x.get(r);if(!e)throw new Error(`Requestor实例 ${String(r)} 未注册`);return e},K={get:(r,e)=>({url:r,method:p.GET,...e,params:e==null?void 0: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},Y=Object.keys(K);function X(r,e,t){const s={},n=o=>{if(o===e.length)return t(r);const i=e[o];return i({config:r,ctx:s,next:()=>n(o+1)})};return n(0)}function Z(r,e){const t={},s=e??[];return Y.forEach(n=>{t[n]=(...o)=>{const i=K[n](...o);return X(i,s,r)}}),t}function v(r){const{extensions:e,instanceKey:t}=r??{},s=V(t);return Z(s,e)}function H(r){const{instanceKey:e,key:t,duration:s,isValid:n,persist:o,...i}=r;return v({instanceKey:e,extensions:[T(i),O({key:t,duration:s,isValid:n,persist:o})]})}function Q(r){const{instanceKey:e,parallelCount:t,createId:s,retries:n,delay:o,retryCondition:i}=r;return v({instanceKey:e,extensions:[R({parallelCount:t,createId:s}),S({retries:n,delay:o,retryCondition:i})]})}c.cache=O,c.concurrent=R,c.createCachedIdempotentRequestor=H,c.createConcurrentRetryRequestor=Q,c.createRequestor=v,c.idempotent=T,c.inject=L,c.retry=S,c.sync=B,c.useRequestor=V,Object.defineProperty(c,Symbol.toStringTag,{value:"Module"})});
+(function(c,d){typeof exports=="object"&&typeof module<"u"?d(exports,require("id-queue")):typeof define=="function"&&define.amd?define(["exports","id-queue"],d):(c=typeof globalThis<"u"?globalThis:c||self,d(c.netVertCore={},c.idQueue))})(this,function(c,d){"use strict";var me=Object.defineProperty;var ye=(c,d,m)=>d in c?me(c,d,{enumerable:!0,configurable:!0,writable:!0,value:m}):c[d]=m;var h=(c,d,m)=>ye(c,typeof d!="symbol"?d+"":d,m);var m=(r=>(r.GET="get",r.POST="post",r.PUT="put",r.DELETE="delete",r))(m||{}),w=(r=>(r.CACHE="cache",r.RETRY="retry",r.IDEMPOTENT="idempotent",r.CONCURRENT="concurrent",r.SYNC="sync",r))(w||{});const P="default",B={retries:3,delay:0,retryCondition:()=>!0},V=r=>{const e={...B,...r};return Object.assign(async({config:n,next:s})=>{let o=0,a;for(;o<=e.retries;)try{return await s()}catch(i){if(a=i,o===e.retries)throw i;const u={config:n,lastResponse:i,attempt:o};if(!e.retryCondition(u))throw i;o++;const l=typeof e.delay=="function"?e.delay(u):e.delay;l>0&&await new Promise(y=>setTimeout(y,l))}throw a},{__middlewareType:w.RETRY})},K=()=>{const r=new Map;return{getPromise:o=>r.get(o),setPromise:(o,a)=>{r.set(o,a),a.finally(()=>r.delete(o))},delPromise:o=>r.delete(o),clearCache:()=>r.clear()}},_={key:r=>{const{config:e}=r,{method:t,url:n,data:s}=e;return[t,n,JSON.stringify(s)].join("|")}},x=r=>{const e={..._,...r},t=K();return Object.assign(({config:s,next:o})=>{const a=e.key({config:s}),i=t.getPromise(a);if(i)return i;const u=o();return t.setPromise(a,u),u},{__middlewareType:w.IDEMPOTENT,promiseCache:t})};class A{constructor(e=4){h(this,"parallelCount");h(this,"tasks");h(this,"runningCount");this.parallelCount=e,this.tasks=new d.TaskQueue,this.runningCount=0}add(e,t){return new Promise((n,s)=>{this.tasks.enqueue(e,{task:t,resolve:n,reject:s}),this._run()})}remove(e){this.tasks.remove(e)}execute(e){const{task:t,resolve:n,reject:s}=e;return t().then(n).catch(s).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 J=0;const z={parallelCount:4,createId:()=>J++},O=r=>{const{parallelCount:e,createId:t}={...z,...r},n=new A(e);return Object.assign(({config:o,next:a})=>{const i=t({config:o});return n.add(i,()=>a())},{__middlewareType:w.CONCURRENT,pool:n})},q=new Map,p=(r,e)=>{q.set(e,r)};function G(r){const e=q.get(r);if(!e)throw new Error(`Store实例 ${String(r)} 未注册`);return e}class U{constructor(){h(this,"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,s]of this.store.entries())e(s,n,t),t++}}const M=r=>!!r&&(typeof r=="object"||typeof r=="function")&&typeof r.then=="function",j=r=>typeof window<"u"?r():{getItem(){return null},setItem(){},removeItem(){},clear(){},key(){return null},get length(){return 0}},f=j(()=>window.localStorage);class Y{constructor(){}getItem(e){const t=String(e),n=f.getItem(t);if(n!==null)try{return JSON.parse(n)}catch(s){console.error(`Failed to parse value for key: ${t}`,s);return}}setItem(e,t){const n=String(e);try{f.setItem(n,JSON.stringify(t))}catch(s){throw console.error(`Failed to set value for key: ${n}`,s),s}return t}removeItem(e){const t=String(e);f.removeItem(t)}clear(){f.clear()}length(){return f.length}key(e){return f.key(e)}keys(){const e=[];for(let t=0;t<f.length;t++){const n=f.key(t);n&&e.push(n)}return e}iterate(e){this.keys().forEach((t,n)=>{const s=this.getItem(t);s!==void 0&&e(s,t,n)})}}const g=j(()=>window.sessionStorage);class X{constructor(){}getItem(e){const t=String(e),n=g.getItem(t);if(n!==null)try{return JSON.parse(n)}catch(s){console.error(`Failed to parse value for key: ${t}`,s);return}}setItem(e,t){const n=String(e);try{g.setItem(n,JSON.stringify(t))}catch(s){throw console.error(`Failed to set value for key: ${n}`,s),s}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 s=this.getItem(t);s!==void 0&&e(s,t,n)})}}class Z{constructor(e,t){h(this,"dbName");h(this,"storeName");h(this,"dbPromise",null);h(this,"DB_VERSION",1);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=s=>{const o=s.target.result;o.objectStoreNames.contains(this.storeName)||o.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((s,o)=>{const a=n.transaction([this.storeName],e).objectStore(this.storeName),i=t(a);i.onsuccess=()=>{s(i.result)},i.onerror=()=>{o(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,s)=>{let o=0;t.onsuccess=a=>{const i=a.target.result;if(i){const u=i.key,l=i.value;e(l,u,o),o++,i.continue()}else n()},t.onerror=()=>{s(t.error)}})}catch(t){console.error("Failed to iterate storage",t)}}}const C={memory:"memory",local:"local",session:"session",indexeddb:"indexeddb"};function R(r,e){Object.assign(r,e)}function H(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 L(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 Q(r){const e=r.getItem("");return M(e)?H(r):L(r)}function I(r,...e){const t=G(r);let n;try{n=new t(...e)}catch{n=t(...e)}return Q(n)}p(U,C.memory),p(Y,C.local),p(X,C.session),p(Z,C.indexeddb);function k(r,e){return{value:r,expireAt:Date.now()+e}}function S(r,e=Date.now()){return r.expireAt<=e}function T(r,e=Date.now()){return S(r,e)?void 0:r.value}const W=r=>{const{config:e}=r,{method:t,url:n,data:s}=e;return[t,n,JSON.stringify(s)].join("|")},ee=()=>!0,b=24*60*60*1e3,te={key:W,duration:b,isValid:ee,store:C.memory},re=class{constructor(e){h(this,"store");return typeof e=="string"?this.store=I(e):(p(e.factory,e.key),this.store=I(e.key)),new Proxy(this,{get(t,n){if(n in t)return t[n];const s=t.store[n];return typeof s=="function"?s.bind(t.store):s}})}setCache(e,t,n=b){const s=k(t,n);this.store.setItem(e,s)}async getCache(e){const t=await this.store.getItem(e);if(t)return T(t)}async hasValidCache(e){const t=await this.store.getItem(e);return t?!S(t):!1}},D=r=>{const e={...te,...r},t=new re(e.store),n=o=>typeof e.duration=="function"?e.duration(o):e.duration;return Object.assign(async({config:o,next:a})=>{const i=e.key({config:o}),u=await t.getCache(i);if(u){if(await e.isValid({key:i,config:o,cachedData:u}))return u;t.removeItem(i)}const l=await a(),y=n({key:i,config:o,cachedData:u,response:l}),N=k(l,y);return t.setItem(i,N),l},{__middlewareType:w.CACHE,storage:t})};class ne{constructor(e){h(this,"store");return typeof e=="string"?this.store=I(e):(p(e.factory,e.key),this.store=I(e.key)),new Proxy(this,{get(t,n){if(n in t)return t[n];const s=t.store[n];return typeof s=="function"?s.bind(t.store):s}})}setCache(e,t,n=b){const s=k(t,n);this.store.setItem(e,s)}getCache(e){const t=this.store.getItem(e);if(t)return T(t)}hasValidCache(e){const t=this.store.getItem(e);return t?!S(t):!1}}const se=ne,oe={suspense:!0,key:r=>{const{config:e}=r,{method:t,url:n}=e;return[t,n].join("|")},duration:24*60*60*1e3,isValid:()=>!0,store:C.memory};function ie(r){const e={...oe,...r},t=new se(e.store),n=o=>typeof e.duration=="function"?e.duration(o):e.duration;return Object.assign(({config:o,next:a})=>{const i=e.key({config:o}),u=t.getCache(i);if(u){if(e.isValid({key:i,config:o,cachedData:u}))return u;t.removeItem(i)}if(e.suspense)throw(e.wrapSuspense?e.wrapSuspense({key:i,config:o,p:a()}):a()).then(y=>{const N=n({key:i,config:o,cachedData:u,response:y});return t.setCache(i,y,N),y});return a().then(l=>{const y=n({key:i,config:o,cachedData:u,response:l});return t.setCache(i,l,y),l})},{__middlewareType:w.SYNC})}const F=new Map,ae=(r,e=P)=>{F.set(e,r)},$=(r=P)=>{const e=F.get(r);if(!e)throw new Error(`Requestor实例 ${String(r)} 未注册`);return e},E={get:(r,e)=>({url:r,method:m.GET,...e,params:e==null?void 0:e.params}),post:(r,e,t)=>({url:r,method:m.POST,data:e,...t}),delete:(r,e)=>({url:r,method:m.DELETE,...e}),put:(r,e,t)=>({url:r,method:m.PUT,data:e,...t}),request:r=>r},ce=Object.keys(E);function ue(r,e,t){const n={},s=o=>{if(o===e.length)return t(r);const a=e[o];return a({config:r,ctx:n,next:()=>s(o+1)})};return s(0)}function le(r,e){const t={},n=e??[];return ce.forEach(s=>{t[s]=(...o)=>{const a=E[s](...o);return ue(a,n,r)}}),t}function v(r){const{extensions:e,instanceKey:t}=r??{},n=$(t);return le(n,e)}function de(r){const{instanceKey:e,key:t,duration:n,isValid:s,store:o,...a}=r;return v({instanceKey:e,extensions:[x(a),D({key:t,duration:n,isValid:s,store:o})]})}function he(r){const{instanceKey:e,parallelCount:t,createId:n,retries:s,delay:o,retryCondition:a}=r;return v({instanceKey:e,extensions:[O({parallelCount:t,createId:n}),V({retries:s,delay:o,retryCondition:a})]})}c.cache=D,c.concurrent=O,c.createCachedIdempotentRequestor=de,c.createConcurrentRetryRequestor=he,c.createRequestor=v,c.idempotent=x,c.inject=ae,c.retry=V,c.sync=ie,c.useRequestor=$,Object.defineProperty(c,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@net-vert/core",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Dependency Inversion Network Library with Type-Safe Injection.",
   "main": "dist/index",
   "type": "module",
@@ -11,9 +11,6 @@
     "build-only": "vite build",
     "type-check": "tsc --noEmit"
   },
-  "devDependencies": {
-    "typescript": "^5.9.3"
-  },
   "files": [
     "dist"
   ],
@@ -34,6 +31,6 @@
   },
   "dependencies": {
     "id-queue": "^1.1.1",
-    "localforage": "^1.10.0"
+    "store-vert": "^0.1.2"
   }
 }