@net-vert/core 0.5.0 → 1.0.0

package/dist/index.js

@@ -1,335 +1,469 @@
-import E from "localforage";
-import { TaskQueue as j } from "id-queue";
-const k = {
-  get: (t, e) => ({
-    url: t,
-    method: "get",
-    ...e,
-    params: e == null ? void 0 : e.params
-  }),
-  post: (t, e, r) => ({
-    url: t,
-    method: "post",
-    data: e,
-    headers: { "Content-Type": "application/json", ...r == null ? void 0 : r.headers },
-    ...r
-  }),
-  delete: (t, e) => ({
-    url: t,
-    method: "delete",
-    ...e
-  }),
-  put: (t, e, r) => ({
-    url: t,
-    method: "put",
-    data: e,
-    headers: { "Content-Type": "application/json", ...r == null ? void 0 : r.headers },
-    ...r
-  }),
-  request: (t) => t
+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 = {
+  retries: 3,
+  delay: 0,
+  retryCondition: () => !0
+}, V = (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 u = {
+          config: s,
+          lastResponse: a,
+          attempt: o
+        };
+        if (!e.retryCondition(u))
+          throw a;
+        o++;
+        const d = typeof e.delay == "function" ? e.delay(u) : e.delay;
+        d > 0 && await new Promise((h) => setTimeout(h, d));
+      }
+    throw i;
+  }, { __middlewareType: f.RETRY });
+}, j = () => {
+  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);
+    if (a)
+      return a;
+    const u = o();
+    return t.setPromise(i, u), u;
+  }, {
+    __middlewareType: f.IDEMPOTENT,
+    promiseCache: t
+  });
 };
-function T(t) {
-  const e = {};
-  return Object.keys(k).forEach(
-    (r) => {
-      e[r] = (...n) => {
-        const o = k[r](...n);
-        return t(o);
-      };
+class z {
+  constructor(e = 4) {
+    c(this, "parallelCount");
+    c(this, "tasks");
+    c(this, "runningCount");
+    this.parallelCount = e, this.tasks = new O(), 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);
     }
-  ), e;
+  }
 }
-const M = "default", z = () => `${Date.now()}_${Math.random().toString().slice(2, 8)}`, I = /* @__PURE__ */ new Map(), Z = (t, e = M) => {
-  I.set(e, T(t));
-}, v = (t = M) => {
-  const e = I.get(t);
-  if (!e) throw new Error(`Requestor实例 ${t} 未注册`);
-  return e;
+let _ = 0;
+const $ = {
+  parallelCount: 4,
+  createId: () => _++
+}, J = (r) => {
+  const { parallelCount: e, createId: t } = { ...$, ...r }, s = new z(e);
+  return Object.assign(({ config: o, next: i }) => {
+    const a = t({ config: o });
+    return s.add(a, () => i());
+  }, { __middlewareType: f.CONCURRENT, pool: s });
 };
-class O {
-  has(e) {
-    return !!this.get(e);
+class v {
+  constructor() {
+    c(this, "store", /* @__PURE__ */ new Map());
   }
-  // 获取缓存
-  get(e) {
-    const r = localStorage.getItem(e);
-    if (r)
+  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 p = typeof window < "u" ? window.localStorage : {};
+class k {
+  constructor() {
+  }
+  getItem(e) {
+    const t = String(e), s = p.getItem(t);
+    if (s !== null)
       try {
-        return JSON.parse(r);
+        return JSON.parse(s);
       } catch (n) {
-        console.error("Error parsing cached data", n);
+        console.error(`Failed to parse value for key: ${t}`, n);
         return;
       }
   }
-  // 设置缓存
-  set(e, r) {
+  setItem(e, t) {
+    const s = String(e);
     try {
-      const n = JSON.stringify(r);
-      localStorage.setItem(e, n);
+      p.setItem(s, JSON.stringify(t));
     } catch (n) {
-      console.error("Error saving data to localStorage", n);
+      throw console.error(`Failed to set value for key: ${s}`, n), n;
     }
-    return r;
+    return t;
   }
-  // 删除缓存
-  remove(e) {
-    localStorage.removeItem(e);
+  removeItem(e) {
+    const t = String(e);
+    p.removeItem(t);
   }
-  // 清空所有缓存
   clear() {
-    localStorage.clear();
+    p.clear();
   }
-}
-const H = new O(), U = ({ persist: t, name: e, sync: r }) => {
-  if (t && r)
-    return H;
-  if (t) {
-    const n = E.createInstance({
-      name: e
-      // driver: sync
-      // ?undefined
-      // :localforage.LOCALSTORAGE,
+  length() {
+    return p.length;
+  }
+  keys() {
+    const e = [];
+    for (let t = 0; t < p.length; t++) {
+      const s = p.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);
     });
-    return {
-      has: (o) => n.keys().then((s) => s.includes(o)),
-      get: (o) => n.getItem(o),
-      set: (o, s) => n.setItem(o, s),
-      remove: (o) => n.removeItem(o),
-      clear: () => n.clear()
-    };
-  } else {
-    const n = /* @__PURE__ */ new Map();
-    return {
-      has: (o) => n.has(o),
-      get: (o) => n.get(o),
-      set: (o, s) => n.set(o, s),
-      remove: (o) => n.delete(o),
-      clear: () => n.clear()
-    };
   }
-}, _ = () => {
-  const t = /* @__PURE__ */ new Map();
+}
+function w(r, e) {
   return {
-    getPromise: (s) => t.get(s),
-    setPromise: (s, u) => {
-      t.set(s, u);
-    },
-    delPromise: (s) => {
-      t.delete(s);
-    },
-    clearCache: () => {
-      t.clear();
-    }
+    value: r,
+    expireAt: Date.now() + e
   };
-}, A = (t, e) => ({
-  value: t,
-  expiresAt: Date.now() + e
-}), x = (t) => t.expiresAt > Date.now(), J = {
-  key: (t) => t.url,
-  persist: !1,
-  duration: 1 / 0,
-  sync: !1
-}, S = (t) => {
-  const e = { ...J, ...t }, { name: r, persist: n, sync: o } = e, s = U({ persist: n, name: r, sync: o }), { getPromise: u, setPromise: P, delPromise: g } = _();
-  function l(a, h) {
-    const { isValid: i } = e, y = s.get(a);
-    let C = !1;
-    if (y && x(y)) {
-      try {
-        C = (i == null ? void 0 : i({
-          key: a,
-          config: h,
-          cachedData: y
-        })) ?? !0;
-      } catch (c) {
-        console.error(`校验异常 ${a}`, c);
+}
+function m(r, e = Date.now()) {
+  return r.expireAt <= e;
+}
+function g(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, x = 24 * 60 * 60 * 1e3, G = {
+  key: A,
+  duration: x,
+  isValid: F,
+  persist: !1
+  // 默认不持久化，使用内存存储
+};
+class l {
+  // ============ 扩展方法（自动处理过期和封装）============
+  /**
+   * 获取缓存值（自动处理过期检查和解包）
+   * @param key 缓存键
+   * @returns 缓存的原始值，如果不存在或已过期返回 undefined
+   */
+  get(e) {
+    const t = this.getItem(e);
+    if (t) {
+      if (m(t)) {
+        this.removeItem(e);
+        return;
       }
-      !C && s.remove(a);
+      return g(t);
     }
-    return { shouldUseCache: C, cachedData: y };
   }
-  async function d(a, h) {
-    const { isValid: i } = e, y = await s.get(a);
-    let C = !1;
-    if (y && x(y)) {
-      try {
-        C = await (i == null ? void 0 : i({
-          key: a,
-          config: h,
-          cachedData: y
-        })) ?? !0;
-      } catch (c) {
-        console.error(`校验异常 ${a}`, c);
-      }
-      !C && s.remove(a);
-    }
-    return { shouldUseCache: C, cachedData: y };
+  /**
+   * 设置缓存值（自动包装为 ExpirableValue）
+   * @param key 缓存键
+   * @param value 要缓存的值
+   * @param duration 有效期（毫秒），默认 24 小时
+   */
+  set(e, t, s = x) {
+    const n = w(t, s);
+    this.setItem(e, n);
   }
-  const p = {
-    get(a, h) {
-      function i(c, f, ...m) {
-        const q = Reflect.apply(a[h], a, m).then(async (w) => {
-          const R = typeof e.duration == "number" ? e.duration : e.duration({
-            key: c,
-            config: f,
-            response: w
-          });
-          return s.set(c, A(w, R)), w;
-        }).finally(() => {
-          g(c);
-        });
-        return P(c, q), q;
-      }
-      return o ? (...c) => {
-        const f = k[h](...c), m = e.key(f), q = u(m);
-        if (q)
-          return q;
-        const { shouldUseCache: w, cachedData: R } = l(m, f);
-        return w ? R.value : i(m, f, ...c);
-      } : (...c) => {
-        const f = k[h](...c), m = e.key(f), q = u(m);
-        if (q)
-          return q;
-        const w = (async () => {
-          try {
-            const { shouldUseCache: R, cachedData: D } = await d(m, f);
-            return R ? D.value : await i(m, f, ...c);
-          } finally {
-            g(m);
-          }
-        })();
-        return P(m, w), w;
-      };
-    }
-  };
-  return {
-    requestor: new Proxy(v(), p),
-    store: s
-  };
-}, N = (t) => {
-  const { method: e, url: r, params: n, data: o } = t;
-  return [e, r, JSON.stringify(n), JSON.stringify(o)].join("|");
-}, b = {
-  key: N
-}, F = (t) => {
-  const e = { ...b, ...t }, {
-    requestor: r
-  } = S({
-    key: e.key,
-    persist: !1
-  });
-  return {
-    requestor: r
-  };
-}, L = {
-  retries: 3,
-  delay: 0,
-  retryCondition: () => !0
-}, $ = (t) => {
-  const { retries: e, delay: r, retryCondition: n } = { ...L, ...t }, o = {
-    get(s, u) {
-      return (...g) => {
-        let l = 0;
-        const d = () => Reflect.apply(s[u], s, g).catch((p) => {
-          if (l < e && n(p)) {
-            l++;
-            const a = typeof r == "function" ? r(l) : r;
-            return new Promise((h) => {
-              setTimeout(() => h(d()), a);
-            });
-          }
-          return Promise.reject(p);
-        });
-        return d();
-      };
-    }
-  };
-  return {
-    requestor: new Proxy(v(), o)
-  };
-};
-class Q {
-  constructor(e = 4) {
-    this.parallelCount = e, this.tasks = new j(), this.runningCount = 0;
+  /**
+   * 删除指定缓存（别名方法，等同于 removeItem）
+   * @param key 缓存键
+   */
+  delete(e) {
+    this.removeItem(e);
   }
-  // 加入
-  add(e, r) {
-    return new Promise((n, o) => {
-      this.tasks.enqueue(e, {
-        task: r,
-        resolve: n,
-        reject: o
-      }), this._run();
-    });
+  /**
+   * 检查缓存是否存在且未过期
+   * @param key 缓存键
+   */
+  has(e) {
+    const t = this.getItem(e);
+    return t ? m(t) ? (this.removeItem(e), !1) : !0 : !1;
   }
-  // 删除
-  remove(e) {
-    this.tasks.remove(e);
+  /**
+   * 获取缓存数量（别名方法，等同于 length）
+   */
+  size() {
+    return this.length();
   }
-  execute(e) {
-    const { task: r, resolve: n, reject: o } = e;
-    return r().then(n).catch(o).finally(() => {
-      this.runningCount--, this._run();
+  /**
+   * 遍历所有有效的缓存（自动跳过已过期的，并解包值）
+   * @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++;
+      }
     });
   }
-  _run() {
-    for (; this.runningCount < this.parallelCount && this.tasks.size > 0; ) {
-      const e = this.tasks.dequeue();
-      this.runningCount++, this.execute(e);
-    }
+  /**
+   * 清理所有过期的缓存
+   * @returns 清理的缓存数量
+   */
+  clearExpired() {
+    let e = 0;
+    return this.keys().forEach((s) => {
+      const n = this.getItem(s);
+      n && m(n) && (this.removeItem(s), e++);
+    }), e;
+  }
+  /**
+   * 更新缓存的过期时间（不改变值）
+   * @param key 缓存键
+   * @param duration 新的有效期（毫秒）
+   * @returns 是否更新成功
+   */
+  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;
   }
 }
-const W = {
-  parallelCount: 4,
-  retries: 0,
-  createId: () => z()
-}, Y = (t) => {
-  const e = { ...W, ...t }, { parallelCount: r, createId: n, ...o } = e, s = new Q(r), { requestor: u = null } = o.retries > 0 ? $(o) : {}, P = {
-    get(g, l) {
-      return (...p) => {
-        const a = k[l](...p), h = n(a), i = () => u ? Reflect.apply(u[l], u, p) : Reflect.apply(g[l], g, p);
-        return s.add(h, i);
-      };
+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);
+  }
+}
+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 = {
+  suspense: !0,
+  key: L,
+  duration: 24 * 60 * 60 * 1e3,
+  isValid: () => !0,
+  persist: !1
+};
+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;
+  return Object.assign(({ config: o, next: i }) => {
+    const a = e.key({ config: o }), u = t.getItem(a);
+    if (u) {
+      if (!m(u) && e.isValid({
+        key: a,
+        config: o,
+        cachedData: u
+      }))
+        return g(u);
+      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;
+      });
+    return i().then((d) => {
+      const h = s({ key: a, config: o, cachedData: u, response: d });
+      return t.setItem(a, w(d, h)), d;
+    });
+  }, { __middlewareType: f.SYNC });
+}
+const S = /* @__PURE__ */ new Map(), re = (r, e = I) => {
+  S.set(e, r);
+}, Y = (r = I) => {
+  const e = S.get(r);
+  if (!e) throw new Error(`Requestor实例 ${String(r)} 未注册`);
+  return e;
+}, E = {
+  get: (r, e) => ({
+    url: r,
+    method: y.GET,
+    ...e,
+    params: e == null ? void 0 : 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
+}, X = Object.keys(E);
+function Z(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 {
-    requestor: new Proxy(v(), P),
-    concurrentPool: s
-  };
-}, B = {
-  persist: !1,
-  sync: !0
-}, G = (t) => {
-  const e = { ...B, ...t }, { ...r } = e, {
-    requestor: n,
-    store: o
-  } = S(r), s = {
-    get(u, P) {
-      return (...l) => {
-        try {
-          const d = Reflect.apply(u[P], u, l);
-          if (d instanceof Promise)
-            throw d;
-          return d;
-        } catch (d) {
-          throw d;
-        }
+  return n(0);
+}
+function H(r, e) {
+  const t = {}, s = e ?? [];
+  return X.forEach(
+    (n) => {
+      t[n] = (...o) => {
+        const i = E[n](...o);
+        return Z(
+          i,
+          s,
+          r
+        );
       };
     }
-  };
-  return {
-    requestor: new Proxy(n, s),
-    store: o
-  };
-}, K = {
-  cacheRequestor: S,
-  idempotencyRequestor: F,
-  retryRequestor: $,
-  concurrentPoolRequestor: Y,
-  syncRequestor: G
-};
+  ), t;
+}
+function P(r) {
+  const { extensions: e, instanceKey: t } = r ?? {}, s = Y(t);
+  return H(
+    s,
+    e
+  );
+}
+function se(r) {
+  const { instanceKey: e, key: t, duration: s, isValid: n, persist: o, ...i } = r;
+  return P({
+    instanceKey: e,
+    extensions: [
+      b(i),
+      B({ key: t, duration: s, isValid: n, persist: o })
+    ]
+  });
+}
+function ne(r) {
+  const { instanceKey: e, parallelCount: t, createId: s, retries: n, delay: o, retryCondition: i } = r;
+  return P({
+    instanceKey: e,
+    extensions: [
+      J({ parallelCount: t, createId: s }),
+      V({ retries: n, delay: o, retryCondition: i })
+    ]
+  });
+}
 export {
-  Z as inject,
-  K as requestExtender,
-  v as useRequestor
+  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
 };