mcp-cnbs 1.2.0 → 1.3.1

package/dist/index.js

@@ -15,128 +15,75 @@ import axios from "axios";
 import https from "https";
 
 // src/services/cache.ts
-import fs from "fs";
-import path from "path";
-import { promisify } from "util";
-var writeFileAsync = promisify(fs.writeFile);
-var readFileAsync = promisify(fs.readFile);
-var mkdirAsync = promisify(fs.mkdir);
-var existsAsync = promisify(fs.exists);
 var CnbsLruCache = class {
   entryMap = /* @__PURE__ */ new Map();
   head = null;
   tail = null;
-  persistPath = null;
   capacity;
   defaultExpire;
   maxMemorySize;
   currentMemorySize = 0;
-  persistInterval;
   cleanupInterval;
-  compression;
-  // 统计信息
+  lastCleanupTime = 0;
   totalHits = 0;
   totalMisses = 0;
   evictionCount = 0;
   expirationCount = 0;
-  persistenceCount = 0;
-  // 定时器
-  persistTimer = null;
-  cleanupTimer = null;
-  // 并发控制
-  persistLock = false;
   constructor(options = {}) {
-    this.persistPath = options.persistPath || null;
-    this.capacity = options.capacity || 1e3;
-    this.defaultExpire = options.defaultExpire || 24 * 60 * 60 * 1e3;
-    this.maxMemorySize = options.maxMemorySize || 100 * 1024 * 1024;
-    this.persistInterval = options.persistInterval || 5 * 60 * 1e3;
-    this.cleanupInterval = options.cleanupInterval || 60 * 1e3;
-    this.compression = options.compression || false;
-    this.loadFromDisk();
-    this.startTimers();
-  }
-  // 启动定时器
-  startTimers() {
-    this.persistTimer = setInterval(() => {
-      this.saveToDiskAsync();
-    }, this.persistInterval);
-    this.cleanupTimer = setInterval(() => {
-      this.cleanupExpired();
-    }, this.cleanupInterval);
-  }
-  // 停止定时器
-  stopTimers() {
-    if (this.persistTimer) {
-      clearInterval(this.persistTimer);
-      this.persistTimer = null;
-    }
-    if (this.cleanupTimer) {
-      clearInterval(this.cleanupTimer);
-      this.cleanupTimer = null;
-    }
-  }
-  // 前置条目
+    this.capacity = options.capacity ?? 1e3;
+    this.defaultExpire = options.defaultExpire ?? 24 * 60 * 60 * 1e3;
+    this.maxMemorySize = options.maxMemorySize ?? 100 * 1024 * 1024;
+    this.cleanupInterval = options.cleanupInterval ?? 60 * 1e3;
+  }
+  // ─── 按需清理（替代 setInterval）────────────────────────────────────────────
+  maybeCleanup() {
+    const now = Date.now();
+    if (now - this.lastCleanupTime < this.cleanupInterval) return;
+    this.lastCleanupTime = now;
+    this.cleanupExpired();
+  }
+  cleanupExpired() {
+    const now = Date.now();
+    const expiredKeys = [];
+    this.entryMap.forEach((entry, key) => {
+      if (now > entry.expireAt) expiredKeys.push(key);
+    });
+    for (const key of expiredKeys) {
+      const entry = this.entryMap.get(key);
+      if (entry) {
+        this.removeEntryFromList(entry);
+        this.entryMap.delete(key);
+        this.expirationCount++;
+      }
+    }
+  }
+  // ─── 双向链表操作 ────────────────────────────────────────────────────────────
   prependEntry(entry) {
     entry.prev = null;
     entry.next = this.head;
-    if (this.head !== null) {
-      this.head.prev = entry;
-    }
+    if (this.head !== null) this.head.prev = entry;
     this.head = entry;
-    if (this.tail === null) {
-      this.tail = entry;
-    }
+    if (this.tail === null) this.tail = entry;
   }
-  // 删除条目
-  deleteEntry(entry) {
-    if (entry.prev !== null) {
-      entry.prev.next = entry.next;
-    } else {
-      this.head = entry.next;
-    }
-    if (entry.next !== null) {
-      entry.next.prev = entry.prev;
-    } else {
-      this.tail = entry.prev;
-    }
+  removeEntryFromList(entry) {
+    if (entry.prev !== null) entry.prev.next = entry.next;
+    else this.head = entry.next;
+    if (entry.next !== null) entry.next.prev = entry.prev;
+    else this.tail = entry.prev;
     this.currentMemorySize -= entry.size;
   }
-  // 提升条目
   promoteEntry(entry) {
-    this.deleteEntry(entry);
+    this.removeEntryFromList(entry);
     this.prependEntry(entry);
   }
-  // 删除尾部条目
   dropTail() {
     if (this.tail === null) return null;
     const tailEntry = this.tail;
-    this.deleteEntry(tailEntry);
+    this.removeEntryFromList(tailEntry);
     this.evictionCount++;
     return tailEntry;
   }
-  // 清理过期数据
-  cleanupExpired() {
-    const now = Date.now();
-    const expiredKeys = [];
-    this.entryMap.forEach((entry, key) => {
-      if (now > entry.expireAt) {
-        expiredKeys.push(key);
-      }
-    });
-    for (const key of expiredKeys) {
-      const entry = this.entryMap.get(key);
-      if (entry) {
-        this.deleteEntry(entry);
-        this.entryMap.delete(key);
-        this.expirationCount++;
-      }
-    }
-    if (expiredKeys.length > 0) {
-      console.info(`Cleaned up ${expiredKeys.length} expired cache entries`);
-    }
-  }
-  // 计算值的大小
+  // ─── 工具 ────────────────────────────────────────────────────────────────────
   calculateSize(value) {
     try {
       return JSON.stringify(value).length;
@@ -144,15 +91,16 @@ var CnbsLruCache = class {
       return 0;
     }
   }
-  // 获取缓存
+  // ─── 公开 API ────────────────────────────────────────────────────────────────
   fetch(key) {
+    this.maybeCleanup();
     const entry = this.entryMap.get(key);
     if (!entry) {
       this.totalMisses++;
       return null;
     }
     if (Date.now() > entry.expireAt) {
-      this.deleteEntry(entry);
+      this.removeEntryFromList(entry);
       this.entryMap.delete(key);
       this.expirationCount++;
       this.totalMisses++;
@@ -164,42 +112,34 @@ var CnbsLruCache = class {
     this.totalHits++;
     return entry.value;
   }
-  // 批量获取缓存
   fetchMultiple(keys) {
     const result = /* @__PURE__ */ new Map();
     for (const key of keys) {
       const value = this.fetch(key);
-      if (value !== null) {
-        result.set(key, value);
-      }
+      if (value !== null) result.set(key, value);
     }
     return result;
   }
-  // 存储缓存
   store(key, value, ttl = this.defaultExpire) {
     const size = this.calculateSize(value);
     while (this.currentMemorySize + size > this.maxMemorySize && this.entryMap.size > 0) {
-      const tailEntry = this.dropTail();
-      if (tailEntry) {
-        this.entryMap.delete(tailEntry.key);
-      }
-    }
-    const existingEntry = this.entryMap.get(key);
-    if (existingEntry) {
-      this.currentMemorySize -= existingEntry.size;
-      existingEntry.value = value;
-      existingEntry.size = size;
-      existingEntry.expireAt = Date.now() + ttl;
-      existingEntry.hitCount = 1;
-      existingEntry.lastHit = Date.now();
-      this.promoteEntry(existingEntry);
+      const tail = this.dropTail();
+      if (tail) this.entryMap.delete(tail.key);
+    }
+    const existing = this.entryMap.get(key);
+    if (existing) {
+      this.currentMemorySize -= existing.size;
+      existing.value = value;
+      existing.size = size;
+      existing.expireAt = Date.now() + ttl;
+      existing.hitCount = 1;
+      existing.lastHit = Date.now();
+      this.promoteEntry(existing);
       this.currentMemorySize += size;
     } else {
       if (this.entryMap.size >= this.capacity) {
-        const tailEntry = this.dropTail();
-        if (tailEntry) {
-          this.entryMap.delete(tailEntry.key);
-        }
+        const tail = this.dropTail();
+        if (tail) this.entryMap.delete(tail.key);
       }
       const newEntry = {
         key,
@@ -216,75 +156,40 @@ var CnbsLruCache = class {
       this.currentMemorySize += size;
     }
   }
-  // 批量存储缓存
   storeMultiple(items) {
-    for (const item of items) {
-      this.store(item.key, item.value, item.ttl);
-    }
+    for (const item of items) this.store(item.key, item.value, item.ttl);
   }
-  // 删除缓存
   remove(key) {
     const entry = this.entryMap.get(key);
     if (entry) {
-      this.deleteEntry(entry);
+      this.removeEntryFromList(entry);
       this.entryMap.delete(key);
     }
   }
-  // 批量删除缓存
   removeMultiple(keys) {
-    for (const key of keys) {
-      this.remove(key);
-    }
+    for (const key of keys) this.remove(key);
   }
-  // 清空缓存
   flush() {
     this.entryMap.clear();
     this.head = null;
     this.tail = null;
     this.currentMemorySize = 0;
-    this.saveToDisk();
   }
-  // 获取缓存数量
   count() {
     return this.entryMap.size;
   }
-  // 获取内存使用
   getMemorySize() {
     return this.currentMemorySize;
   }
-  // 获取统计信息
   getStats() {
-    if (this.entryMap.size === 0) {
-      return {
-        size: 0,
-        capacity: this.capacity,
-        memorySize: this.currentMemorySize,
-        maxMemorySize: this.maxMemorySize,
-        oldestEntry: null,
-        topHit: null,
-        hitRate: 0,
-        missRate: 0,
-        totalHits: this.totalHits,
-        totalMisses: this.totalMisses,
-        evictionCount: this.evictionCount,
-        expirationCount: this.expirationCount,
-        persistenceCount: this.persistenceCount
-      };
-    }
     let oldestEntry = null;
     let topHit = null;
     this.entryMap.forEach((item, key) => {
       const age = Date.now() - item.lastHit;
-      if (!oldestEntry || age > oldestEntry.age) {
-        oldestEntry = { key, age };
-      }
-      if (!topHit || item.hitCount > topHit.count) {
-        topHit = { key, count: item.hitCount };
-      }
+      if (!oldestEntry || age > oldestEntry.age) oldestEntry = { key, age };
+      if (!topHit || item.hitCount > topHit.count) topHit = { key, count: item.hitCount };
     });
-    const totalRequests = this.totalHits + this.totalMisses;
-    const hitRate = totalRequests > 0 ? this.totalHits / totalRequests : 0;
-    const missRate = totalRequests > 0 ? this.totalMisses / totalRequests : 0;
+    const total = this.totalHits + this.totalMisses;
     return {
       size: this.entryMap.size,
       capacity: this.capacity,
@@ -292,16 +197,16 @@ var CnbsLruCache = class {
       maxMemorySize: this.maxMemorySize,
       oldestEntry,
       topHit,
-      hitRate: parseFloat((hitRate * 100).toFixed(2)),
-      missRate: parseFloat((missRate * 100).toFixed(2)),
+      hitRate: total > 0 ? parseFloat((this.totalHits / total * 100).toFixed(2)) : 0,
+      missRate: total > 0 ? parseFloat((this.totalMisses / total * 100).toFixed(2)) : 0,
       totalHits: this.totalHits,
       totalMisses: this.totalMisses,
       evictionCount: this.evictionCount,
       expirationCount: this.expirationCount,
-      persistenceCount: this.persistenceCount
+      persistenceCount: 0
+      // Workers 环境无持久化
     };
   }
-  // 获取缓存信息
   getCacheInfo(key) {
     const entry = this.entryMap.get(key);
     if (!entry) return null;
@@ -312,96 +217,8 @@ var CnbsLruCache = class {
       hits: entry.hitCount
     };
   }
-  // 同步保存到磁盘
-  saveToDisk() {
-    if (!this.persistPath) return;
-    try {
-      const dir = path.dirname(this.persistPath);
-      if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true });
-      }
-      const dataToSave = [];
-      let current = this.head;
-      while (current !== null) {
-        dataToSave.push({
-          key: current.key,
-          value: current.value,
-          expireAt: current.expireAt,
-          hitCount: current.hitCount,
-          lastHit: current.lastHit,
-          size: current.size
-        });
-        current = current.next;
-      }
-      fs.writeFileSync(this.persistPath, JSON.stringify(dataToSave));
-      this.persistenceCount++;
-    } catch (error) {
-      console.error("Failed to save cache to disk:", error);
-    }
-  }
-  // 异步保存到磁盘
-  async saveToDiskAsync() {
-    if (!this.persistPath || this.persistLock) return;
-    this.persistLock = true;
-    try {
-      const dir = path.dirname(this.persistPath);
-      if (!await existsAsync(dir)) {
-        await mkdirAsync(dir, { recursive: true });
-      }
-      const dataToSave = [];
-      let current = this.head;
-      while (current !== null) {
-        dataToSave.push({
-          key: current.key,
-          value: current.value,
-          expireAt: current.expireAt,
-          hitCount: current.hitCount,
-          lastHit: current.lastHit,
-          size: current.size
-        });
-        current = current.next;
-      }
-      await writeFileAsync(this.persistPath, JSON.stringify(dataToSave));
-      this.persistenceCount++;
-    } catch (error) {
-      console.error("Failed to save cache to disk:", error);
-    } finally {
-      this.persistLock = false;
-    }
-  }
-  // 从磁盘加载
-  loadFromDisk() {
-    if (!this.persistPath || !fs.existsSync(this.persistPath)) return;
-    try {
-      const data = fs.readFileSync(this.persistPath, "utf8");
-      const cachedItems = JSON.parse(data);
-      const now = Date.now();
-      for (const item of cachedItems) {
-        if (item.expireAt > now) {
-          const newEntry = {
-            key: item.key,
-            value: item.value,
-            expireAt: item.expireAt,
-            hitCount: item.hitCount,
-            lastHit: item.lastHit,
-            prev: null,
-            next: null,
-            size: item.size
-          };
-          this.entryMap.set(item.key, newEntry);
-          this.prependEntry(newEntry);
-          this.currentMemorySize += item.size;
-        }
-      }
-      console.info(`Loaded ${this.entryMap.size} cache entries from disk`);
-    } catch (error) {
-      console.error("Failed to load cache from disk:", error);
-    }
-  }
-  // 关闭缓存
+  // close() 保留空实现，防止上层调用报错
   close() {
-    this.stopTimers();
-    this.saveToDisk();
   }
 };
 var CnbsCacheHub = class {
@@ -410,19 +227,14 @@ var CnbsCacheHub = class {
     capacity: 1e3,
     defaultExpire: 24 * 60 * 60 * 1e3,
     maxMemorySize: 100 * 1024 * 1024,
-    persistInterval: 5 * 60 * 1e3,
-    cleanupInterval: 60 * 1e3,
-    compression: false
+    cleanupInterval: 60 * 1e3
   };
-  // 获取缓存
   getCache(name, options = {}) {
     if (!this.caches.has(name)) {
-      const cacheOptions = { ...this.defaultOptions, ...options };
-      this.caches.set(name, new CnbsLruCache(cacheOptions));
+      this.caches.set(name, new CnbsLruCache({ ...this.defaultOptions, ...options }));
     }
     return this.caches.get(name);
   }
-  // 删除缓存
   removeCache(name) {
     const cache = this.caches.get(name);
     if (cache) {
@@ -430,11 +242,9 @@ var CnbsCacheHub = class {
       this.caches.delete(name);
     }
   }
-  // 清空所有缓存
   flushAll() {
     this.caches.forEach((cache) => cache.flush());
   }
-  // 获取所有缓存统计
   getAllStats() {
     const stats = {};
     this.caches.forEach((cache, name) => {
@@ -442,34 +252,37 @@ var CnbsCacheHub = class {
     });
     return stats;
   }
-  // 关闭所有缓存
   closeAll() {
     this.caches.forEach((cache) => cache.close());
     this.caches.clear();
   }
 };
-var cnbsCacheHub = new CnbsCacheHub();
+var _hub = null;
+function getCnbsCacheHub() {
+  if (!_hub) _hub = new CnbsCacheHub();
+  return _hub;
+}
+var cnbsCacheHub = new Proxy({}, {
+  get(_target, prop) {
+    return getCnbsCacheHub()[prop];
+  }
+});
 var CacheKeyGenerator = class {
-  // 生成搜索缓存键
   static generateSearchKey(keyword, pageNum = 1, pageSize = 10) {
     return `search_${keyword.toLowerCase()}_${pageNum}_${pageSize}`;
   }
-  // 生成节点缓存键
   static generateNodeKey(category, parentId) {
-    return `node_${category}_${parentId || "root"}`;
+    return `node_${category}_${parentId ?? "root"}`;
   }
-  // 生成指标缓存键
   static generateMetricKey(setId, name) {
-    return `metric_${setId}_${name || "all"}`;
+    return `metric_${setId}_${name ?? "all"}`;
   }
-  // 生成数据系列缓存键
   static generateSeriesKey(setId, metricIds, periods, areas) {
-    const metricKey = metricIds.sort().join("_");
-    const periodKey = periods.sort().join("_");
+    const metricKey = [...metricIds].sort().join("_");
+    const periodKey = [...periods].sort().join("_");
     const areaKey = areas ? areas.map((a) => a.code).sort().join("_") : "000000000000";
     return `series_${setId}_${metricKey}_${periodKey}_${areaKey}`;
   }
-  // 生成数据源缓存键
   static generateDataSourceKey(source, params) {
     const sortedParams = Object.keys(params).sort().map((key) => `${key}=${params[key]}`).join("&");
     return `datasource_${source}_${sortedParams}`;
@@ -827,11 +640,11 @@ var CnbsBoundaryHandler = class {
     return array[index];
   }
   // 检查对象属性
-  static safePropertyAccess(obj, path2, defaultValue) {
+  static safePropertyAccess(obj, path, defaultValue) {
     if (!obj) {
       return defaultValue;
     }
-    const parts = path2.split(".");
+    const parts = path.split(".");
     let current = obj;
     for (const part of parts) {
       if (current[part] === void 0) {