@abtnode/util 1.17.8-beta-20260109-075740-5f484e08 → 1.17.8-beta-20260113-015027-32a1cec4

package/lib/blocklet-cache.js

@@ -0,0 +1,85 @@
+const { DBCache, getAbtNodeRedisAndSQLiteUrl } = require('@abtnode/db-cache');
+const { BLOCKLET_CACHE_TTL } = require('@abtnode/constant');
+
+const BLOCKLET_INFO_SHORT_CACHE_TTL = 1000 * 60 * 30; // 30 minutes
+const logger = console;
+
+/**
+ * Blocklet Info 缓存, 用于 blocklet.js 请求，快速返回数据
+ *
+ * 注意：
+ * - Redis Adapter 不使用 LRU cache（Redis 本身已经是内存数据库）
+ * - SQLite Adapter 会使用 LRU cache 作为 L1 缓存层
+ */
+const blockletInfoShortCache = new DBCache(() => ({
+  prefix: 'blocklet-info-short-cache',
+  ttl: BLOCKLET_INFO_SHORT_CACHE_TTL, // 30 minutes
+  enableLruCache: true, // 仅对 SQLite 生效
+  ...getAbtNodeRedisAndSQLiteUrl(),
+}));
+
+/**
+ * @param {string} did: blockletDid
+ * @param {string} componentId: componentDid 的格式为 did/children.did
+ * @param {string} type: json or js
+ * @returns {string}
+ */
+const getBlockletInfoCachePrefixKey = (did) => {
+  return `blocklet-info-${did}`;
+};
+
+/**
+ * 删除 Blocklet Info 缓存 (包括内存缓存和 DBCache)
+ *
+ * CLUSTER MODE NOTE:
+ * - Memory cache: Cleared via delByPrefix with cluster sync.
+ * - DBCache: Cleared once (Redis/SQLite handles multi-process access).
+ *
+ * @param {string} did: blockletDid
+ */
+const clearBlockletInfoCache = async (did) => {
+  try {
+    // 由于 cacheKey 包含动态参数（pathPrefix 等），无法枚举所有可能的 key
+    // 所以使用前缀匹配删除所有与该 DID 相关的缓存
+    const prefix = getBlockletInfoCachePrefixKey(did);
+    // DBCache 也使用前缀删除（del 方法会删除该 key 及其 group 下的所有 key）
+    await blockletInfoShortCache.del(prefix);
+    logger.info('Cleared blocklet info cache', { did, prefix });
+  } catch (error) {
+    logger.error('Clear blocklet info cache failed', { did, error });
+  }
+};
+
+/**
+ * Blocklet state 缓存, 用于内部数据获取，避免重复查询数据库
+ */
+const blockletCache = new DBCache(() => ({
+  prefix: 'blocklet-state',
+  ttl: BLOCKLET_CACHE_TTL,
+  enableLruCache: false, // 明确禁用 LRU cache
+  ...getAbtNodeRedisAndSQLiteUrl(),
+}));
+
+/**
+ * 删除 Blocklet state 缓存
+ * @param {string} did: blockletDid
+ */
+const deleteBlockletCache = async (did) => {
+  try {
+    await blockletCache.del(did);
+    logger.info('Deleted blocklet cache', { did });
+  } catch (error) {
+    logger.error('deleteBlockletCache failed', { did, error });
+  }
+};
+
+module.exports = {
+  // Blocklet state cache
+  blockletCache,
+  deleteBlockletCache,
+
+  // Blocklet info cache
+  blockletInfoShortCache,
+  getBlockletInfoCachePrefixKey,
+  clearBlockletInfoCache,
+};

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.17.8-beta-20260109-075740-5f484e08",
+  "version": "1.17.8-beta-20260113-015027-32a1cec4",
   "description": "ArcBlock's JavaScript utility",
   "main": "lib/index.js",
   "files": [
@@ -18,14 +18,14 @@
   "author": "polunzh <polunzh@gmail.com> (http://github.com/polunzh)",
   "license": "Apache-2.0",
   "dependencies": {
-    "@abtnode/constant": "1.17.8-beta-20260109-075740-5f484e08",
-    "@abtnode/db-cache": "1.17.8-beta-20260109-075740-5f484e08",
+    "@abtnode/constant": "1.17.8-beta-20260113-015027-32a1cec4",
+    "@abtnode/db-cache": "1.17.8-beta-20260113-015027-32a1cec4",
     "@arcblock/did": "^1.28.4",
     "@arcblock/event-hub": "^1.28.4",
     "@arcblock/pm2": "^6.0.12",
-    "@blocklet/constant": "1.17.8-beta-20260109-075740-5f484e08",
+    "@blocklet/constant": "1.17.8-beta-20260113-015027-32a1cec4",
     "@blocklet/error": "^0.3.5",
-    "@blocklet/meta": "1.17.8-beta-20260109-075740-5f484e08",
+    "@blocklet/meta": "1.17.8-beta-20260113-015027-32a1cec4",
     "@blocklet/xss": "^0.3.16",
     "@ocap/client": "^1.28.4",
     "@ocap/mcrypto": "^1.28.4",
@@ -90,5 +90,5 @@
     "express": "^4.18.2",
     "fs-extra": "^11.2.0"
   },
-  "gitHead": "14240868d6efc2e698a804c6ee48deb8a7d10ee1"
+  "gitHead": "a2bdf6146c5c94d7348fc87d5ebd2e95e548df07"
 }