koatty_store 1.7.0 → 1.8.0

package/dist/index.js

@@ -1,6 +1,6 @@
 /*!
 * @Author: richen
-* @Date: 2024-11-07 14:38:56
+* @Date: 2025-06-09 12:32:48
 * @License: BSD (3-Clause)
 * @Copyright (c) - <richenlin(at)gmail.com>
 * @HomePage: https://koatty.org/
@@ -10,6 +10,7 @@
 var lodash = require('lodash');
 var helper = require('koatty_lib');
 var events = require('events');
+var lruCache = require('lru-cache');
 var koatty_logger = require('koatty_logger');
 var ioredis = require('ioredis');
 var genericPool = require('generic-pool');
@@ -70,7 +71,7 @@ var messages;
     messages["mutuallyExclusiveNXXX"] = "ERR XX and NX options at the same time are not compatible";
 })(messages || (messages = {}));
 class MemoryCache extends events.EventEmitter {
-    databases = Object.create({});
+    databases = new Map();
     options;
     currentDBIndex;
     connected;
@@ -78,18 +79,89 @@ class MemoryCache extends events.EventEmitter {
     multiMode;
     cache;
     responseMessages;
+    ttlCheckTimer = null;
     /**
      * Creates an instance of MemoryCache.
-     * @param {*} options
+     * @param {MemoryCacheOptions} options
      * @memberof MemoryCache
      */
     constructor(options) {
         super();
-        this.options = { ...{ database: "0" }, ...options };
-        this.currentDBIndex = 0;
+        this.options = {
+            database: 0,
+            maxKeys: 1000,
+            evictionPolicy: 'lru',
+            ttlCheckInterval: 60000, // 1分钟检查一次过期键
+            maxAge: 1000 * 60 * 60, // 默认1小时过期
+            ...options
+        };
+        this.currentDBIndex = options.database || 0;
         this.connected = false;
         this.lastSave = Date.now();
         this.multiMode = false;
+        this.responseMessages = [];
+        // 初始化数据库和缓存
+        if (!this.databases.has(this.currentDBIndex)) {
+            this.databases.set(this.currentDBIndex, this.createLRUCache());
+        }
+        this.cache = this.databases.get(this.currentDBIndex);
+        // 启动TTL检查定时器
+        this.startTTLCheck();
+    }
+    /**
+     * 创建LRU缓存实例
+     */
+    createLRUCache() {
+        return new lruCache.LRUCache({
+            max: this.options.maxKeys || 1000,
+            ttl: this.options.maxAge || 1000 * 60 * 60, // 1小时默认
+            updateAgeOnGet: true, // 访问时更新age
+            dispose: (value, key, reason) => {
+                // 键被淘汰时的回调 - 直接使用lru-cache的事件机制
+                this.emit('evict', key, value, reason);
+            },
+            onInsert: (value, key) => {
+                // 键被插入时的回调
+                this.emit('insert', key, value);
+            }
+        });
+    }
+    /**
+     * 启动TTL检查定时器
+     */
+    startTTLCheck() {
+        if (this.ttlCheckTimer) {
+            clearInterval(this.ttlCheckTimer);
+        }
+        this.ttlCheckTimer = setInterval(() => {
+            this.cleanExpiredKeys();
+        }, this.options.ttlCheckInterval || 60000);
+    }
+    /**
+     * 清理过期键
+     */
+    cleanExpiredKeys() {
+        for (const [_dbIndex, cache] of this.databases) {
+            const keysToDelete = [];
+            cache.forEach((item, key) => {
+                if (item.timeout && item.timeout <= Date.now()) {
+                    keysToDelete.push(key);
+                }
+            });
+            keysToDelete.forEach(key => {
+                cache.delete(key);
+                this.emit('expire', key);
+            });
+        }
+    }
+    /**
+     * 停止TTL检查
+     */
+    stopTTLCheck() {
+        if (this.ttlCheckTimer) {
+            clearInterval(this.ttlCheckTimer);
+            this.ttlCheckTimer = null;
+        }
     }
     /**
      *
@@ -98,8 +170,10 @@ class MemoryCache extends events.EventEmitter {
      * @memberof MemoryCache
      */
     createClient() {
-        this.databases[this.options.database] = Object.create({});
-        this.cache = this.databases[this.options.database];
+        if (!this.databases.has(this.options.database)) {
+            this.databases.set(this.options.database, this.createLRUCache());
+        }
+        this.cache = this.databases.get(this.options.database);
         this.connected = true;
         // exit multi mode if we are in it
         this.discard(null, true);
@@ -115,6 +189,7 @@ class MemoryCache extends events.EventEmitter {
      */
     quit() {
         this.connected = false;
+        this.stopTTLCheck();
         // exit multi mode if we are in it
         this.discard(null, true);
         this.emit('end');
@@ -129,6 +204,40 @@ class MemoryCache extends events.EventEmitter {
     end() {
         return this.quit();
     }
+    /**
+     * 获取缓存统计信息
+     */
+    info() {
+        const stats = {
+            databases: this.databases.size,
+            currentDB: this.currentDBIndex,
+            keys: this.cache ? this.cache.length : 0,
+            maxKeys: this.options.maxKeys,
+            hits: 0,
+            misses: 0,
+            memory: this.getMemoryUsage()
+        };
+        // 如果缓存支持统计信息
+        if (this.cache && typeof this.cache.dump === 'function') {
+            const dump = this.cache.dump();
+            stats.keys = dump.length;
+        }
+        return stats;
+    }
+    /**
+     * 估算内存使用量
+     */
+    getMemoryUsage() {
+        let totalSize = 0;
+        for (const [, cache] of this.databases) {
+            cache.forEach((item, key) => {
+                // 粗略估算：key长度 + JSON序列化后的大小
+                totalSize += key.length * 2; // Unicode字符占2字节
+                totalSize += JSON.stringify(item).length * 2;
+            });
+        }
+        return totalSize;
+    }
     /**
      *
      *
@@ -175,12 +284,12 @@ class MemoryCache extends events.EventEmitter {
         if (!helper__namespace.isNumber(dbIndex)) {
             return this._handleCallback(callback, null, messages.invalidDBIndex);
         }
-        if (!this.databases.hasOwnProperty(dbIndex)) {
-            this.databases[dbIndex] = Object.create({});
+        if (!this.databases.has(dbIndex)) {
+            this.databases.set(dbIndex, this.createLRUCache());
         }
         this.multiMode = false;
         this.currentDBIndex = dbIndex;
-        this.cache = this.databases[dbIndex];
+        this.cache = this.databases.get(dbIndex);
         return this._handleCallback(callback, messages.ok);
     }
     // ---------------------------------------
@@ -259,7 +368,7 @@ class MemoryCache extends events.EventEmitter {
         else if (onlyexist) {
             return this._handleCallback(callback, retVal);
         }
-        this.cache[key] = this._makeKey(value.toString(), 'string', pttl);
+        this.cache.set(key, this._makeKey(value.toString(), 'string', pttl));
         return this._handleCallback(callback, messages.ok);
     }
     /**
@@ -289,7 +398,8 @@ class MemoryCache extends events.EventEmitter {
     expire(key, seconds, callback) {
         let retVal = 0;
         if (this._hasKey(key)) {
-            this.cache[key].timeout = Date.now() + seconds * 1000;
+            const pttl = seconds * 1000;
+            this.cache.set(key, { ...this.cache.get(key), timeout: Date.now() + pttl });
             retVal = 1;
         }
         return this._handleCallback(callback, retVal);
@@ -309,7 +419,7 @@ class MemoryCache extends events.EventEmitter {
         for (let itr = 0; itr < keys.length; itr++) {
             const key = keys[itr];
             if (this._hasKey(key)) {
-                delete this.cache[key];
+                this.cache.delete(key);
                 retVal++;
             }
         }
@@ -400,7 +510,7 @@ class MemoryCache extends events.EventEmitter {
     decrby(key, amount, callback) {
         let retVal = null;
         try {
-            retVal = this._addToKey(key, -amount);
+            retVal = this._addToKey(key, 0 - amount);
         }
         catch (err) {
             return this._handleCallback(callback, null, err);
@@ -416,7 +526,7 @@ class MemoryCache extends events.EventEmitter {
             this._testType(key, 'hash', true, callback);
         }
         else {
-            this.cache[key] = this._makeKey({}, 'hash');
+            this.cache.set(key, this._makeKey({}, 'hash'));
         }
         if (!this._hasField(key, field)) {
             retVal = 1;
@@ -479,7 +589,7 @@ class MemoryCache extends events.EventEmitter {
             for (let itr = 0; itr < fields.length; itr++) {
                 const field = fields[itr];
                 if (this._hasField(key, field)) {
-                    delete this.cache[key].value[field];
+                    delete this.cache.get(key).value[field];
                     retVal++;
                 }
             }
@@ -600,22 +710,18 @@ class MemoryCache extends events.EventEmitter {
             this._testType(key, 'list', true, callback);
         }
         else {
-            this.cache[key] = this._makeKey([], 'list');
+            this.cache.set(key, this._makeKey([], 'list'));
         }
-        const val = this._getKey(key);
-        val.push(value);
-        this._setKey(key, val);
-        retVal = val.length;
+        this._getKey(key).push(value.toString());
+        retVal = this._getKey(key).length;
+        this.persist(key);
         return this._handleCallback(callback, retVal);
     }
     /**
-     *
-     *
-     * @param {string} key
-     * @param {(string | number)} value
-     * @param {Function} [callback]
-     * @returns {*}
-     * @memberof MemoryCache
+     * List：从左侧推入
+     * @param key
+     * @param value
+     * @param callback
      */
     lpush(key, value, callback) {
         let retVal = 0;
@@ -623,14 +729,31 @@ class MemoryCache extends events.EventEmitter {
             this._testType(key, 'list', true, callback);
         }
         else {
-            this.cache[key] = this._makeKey([], 'list');
+            this.cache.set(key, this._makeKey([], 'list'));
         }
-        const val = this._getKey(key);
-        val.splice(0, 0, value);
-        this._setKey(key, val);
-        retVal = val.length;
+        const list = this._getKey(key);
+        retVal = list.unshift(value);
+        this._setKey(key, list);
         return this._handleCallback(callback, retVal);
     }
+    /**
+     * List：获取指定索引的元素
+     * @param key
+     * @param index
+     * @param callback
+     */
+    lindex(key, index, callback) {
+        if (!this._hasKey(key)) {
+            return this._handleCallback(callback, null);
+        }
+        this._testType(key, 'list', true, callback);
+        const list = this._getKey(key);
+        if (index < 0) {
+            index = list.length + index;
+        }
+        const value = index >= 0 && index < list.length ? list[index] : null;
+        return this._handleCallback(callback, value);
+    }
     /**
      *
      *
@@ -643,9 +766,11 @@ class MemoryCache extends events.EventEmitter {
         let retVal = null;
         if (this._hasKey(key)) {
             this._testType(key, 'list', true, callback);
-            const val = this._getKey(key);
-            retVal = val.shift();
-            this._setKey(key, val);
+            const list = this._getKey(key);
+            if (list.length > 0) {
+                retVal = list.shift();
+                this.persist(key);
+            }
         }
         return this._handleCallback(callback, retVal);
     }
@@ -661,9 +786,11 @@ class MemoryCache extends events.EventEmitter {
         let retVal = null;
         if (this._hasKey(key)) {
             this._testType(key, 'list', true, callback);
-            const val = this._getKey(key);
-            retVal = val.pop();
-            this._setKey(key, val);
+            const list = this._getKey(key);
+            if (list.length > 0) {
+                retVal = list.pop();
+                this.persist(key);
+            }
         }
         return this._handleCallback(callback, retVal);
     }
@@ -681,8 +808,8 @@ class MemoryCache extends events.EventEmitter {
         const retVal = [];
         if (this._hasKey(key)) {
             this._testType(key, 'list', true, callback);
-            const val = this._getKey(key);
-            const length = val.length;
+            const list = this._getKey(key);
+            const length = list.length;
             if (stop < 0) {
                 stop = length + stop;
             }
@@ -698,7 +825,7 @@ class MemoryCache extends events.EventEmitter {
             if (stop >= 0 && stop >= start) {
                 const size = stop - start + 1;
                 for (let itr = start; itr < size; itr++) {
-                    retVal.push(val[itr]);
+                    retVal.push(list[itr]);
                 }
             }
         }
@@ -722,7 +849,7 @@ class MemoryCache extends events.EventEmitter {
             this._testType(key, 'set', true, callback);
         }
         else {
-            this.cache[key] = this._makeKey([], 'set');
+            this.cache.set(key, this._makeKey([], 'set'));
         }
         const val = this._getKey(key);
         const length = val.length;
@@ -794,19 +921,29 @@ class MemoryCache extends events.EventEmitter {
      * @memberof MemoryCache
      */
     spop(key, count, callback) {
-        let retVal = null;
+        let retVal = [];
         count = count || 1;
-        if (isNaN(count)) {
-            return this._handleCallback(callback, null, messages.noint);
+        if (typeof count === 'function') {
+            callback = count;
+            count = 1;
         }
         if (this._hasKey(key)) {
-            retVal = [];
             this._testType(key, 'set', true, callback);
             const val = this._getKey(key);
-            const length = val.length;
-            count = count > length ? length : count;
-            for (let itr = 0; itr < count; itr++) {
-                retVal.push(val.pop());
+            const keys = Object.keys(val);
+            const keysLength = keys.length;
+            if (keysLength) {
+                if (count >= keysLength) {
+                    retVal = keys;
+                    this.del(key);
+                }
+                else {
+                    for (let itr = 0; itr < count; itr++) {
+                        const randomNum = Math.floor(Math.random() * keys.length);
+                        retVal.push(keys[randomNum]);
+                        this.srem(key, keys[randomNum]);
+                    }
+                }
             }
         }
         return this._handleCallback(callback, retVal);
@@ -873,14 +1010,14 @@ class MemoryCache extends events.EventEmitter {
     discard(callback, silent) {
         // Clear the queue mode, drain the queue, empty the watch list
         if (this.multiMode) {
-            this.cache = this.databases[this.currentDBIndex];
+            this.cache = this.databases.get(this.currentDBIndex);
             this.multiMode = false;
             this.responseMessages = [];
         }
-        else if (!silent) {
-            return this._handleCallback(callback, null, messages.nomultidiscard);
+        if (!silent) {
+            return this._handleCallback(callback, messages.ok);
         }
-        return this._handleCallback(callback, messages.ok);
+        return null;
     }
     // ---------------------------------------
     // ## Internal - Key ##
@@ -893,11 +1030,11 @@ class MemoryCache extends events.EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    pttl(key, callback) {
+    pttl(key, _callback) {
         let retVal = -2;
         if (this._hasKey(key)) {
-            if (!lodash.isNil(this.cache[key].timeout)) {
-                retVal = this.cache[key].timeout - Date.now();
+            if (!lodash.isNil(this.cache.get(key)?.timeout)) {
+                retVal = this.cache.get(key).timeout - Date.now();
                 // Prevent unexpected errors if the actual ttl just happens to be -2 or -1
                 if (retVal < 0 && retVal > -3) {
                     retVal = -3;
@@ -907,7 +1044,7 @@ class MemoryCache extends events.EventEmitter {
                 retVal = -1;
             }
         }
-        return this._handleCallback(callback, retVal);
+        return retVal;
     }
     /**
      *
@@ -922,7 +1059,7 @@ class MemoryCache extends events.EventEmitter {
         let retVal = 0;
         if (this._hasKey(key)) {
             if (!lodash.isNil(this._key(key).timeout)) {
-                this._key(key).timeout = null;
+                this.cache.set(key, { ...this.cache.get(key), timeout: null });
                 retVal = 1;
             }
         }
@@ -937,7 +1074,7 @@ class MemoryCache extends events.EventEmitter {
      * @memberof MemoryCache
      */
     _hasKey(key) {
-        return this.cache.hasOwnProperty(key);
+        return this.cache.has(key);
     }
     /**
      *
@@ -961,8 +1098,8 @@ class MemoryCache extends events.EventEmitter {
      * @memberof MemoryCache
      */
     _key(key) {
-        this.cache[key].lastAccess = Date.now();
-        return this.cache[key];
+        this.cache.get(key).lastAccess = Date.now();
+        return this.cache.get(key);
     }
     /**
      *
@@ -987,7 +1124,7 @@ class MemoryCache extends events.EventEmitter {
             }
         }
         else {
-            this.cache[key] = this._makeKey('0', 'string');
+            this.cache.set(key, this._makeKey('0', 'string'));
         }
         const val = keyValue + amount;
         this._setKey(key, val.toString());
@@ -1040,8 +1177,7 @@ class MemoryCache extends events.EventEmitter {
      * @memberof MemoryCache
      */
     _setKey(key, value) {
-        this.cache[key].value = value;
-        this.cache[key].lastAccess = Date.now();
+        this.cache.set(key, { ...this.cache.get(key), value: value, lastAccess: Date.now() });
     }
     /**
      *
@@ -1069,7 +1205,7 @@ class MemoryCache extends events.EventEmitter {
             }
         }
         else {
-            this.cache[key] = this._makeKey({}, 'hash');
+            this.cache.set(key, this._makeKey({}, 'hash'));
         }
         fieldValue = useFloat ? parseFloat(`${value}`) : parseInt(`${value}`);
         amount = useFloat ? parseFloat(`${amount}`) : parseInt(`${amount}`);
@@ -1178,6 +1314,333 @@ class MemoryCache extends events.EventEmitter {
         }
         return;
     }
+    /**
+     * 字符串追加操作
+     * @param key
+     * @param value
+     * @param callback
+     */
+    append(key, value, callback) {
+        let retVal = 0;
+        if (this._hasKey(key)) {
+            this._testType(key, 'string', true, callback);
+            const existingValue = this._getKey(key);
+            const newValue = existingValue + value;
+            this._setKey(key, newValue);
+            retVal = newValue.length;
+        }
+        else {
+            this.cache.set(key, this._makeKey(value, 'string'));
+            retVal = value.length;
+        }
+        return this._handleCallback(callback, retVal);
+    }
+    /**
+     * 获取字符串长度
+     * @param key
+     * @param callback
+     */
+    strlen(key, callback) {
+        let retVal = 0;
+        if (this._hasKey(key)) {
+            this._testType(key, 'string', true, callback);
+            retVal = this._getKey(key).length;
+        }
+        return this._handleCallback(callback, retVal);
+    }
+    /**
+     * 获取子字符串
+     * @param key
+     * @param start
+     * @param end
+     * @param callback
+     */
+    getrange(key, start, end, callback) {
+        let retVal = '';
+        if (this._hasKey(key)) {
+            this._testType(key, 'string', true, callback);
+            const value = this._getKey(key);
+            retVal = value.substring(start, end + 1);
+        }
+        return this._handleCallback(callback, retVal);
+    }
+    /**
+     * 设置子字符串
+     * @param key
+     * @param offset
+     * @param value
+     * @param callback
+     */
+    setrange(key, offset, value, callback) {
+        let retVal = 0;
+        if (this._hasKey(key)) {
+            this._testType(key, 'string', true, callback);
+            const existingValue = this._getKey(key);
+            const newValue = existingValue.substring(0, offset) + value + existingValue.substring(offset + value.length);
+            this._setKey(key, newValue);
+            retVal = newValue.length;
+        }
+        else {
+            // 如果键不存在，创建一个足够长的字符串
+            const newValue = ''.padEnd(offset, '\0') + value;
+            this.cache.set(key, this._makeKey(newValue, 'string'));
+            retVal = newValue.length;
+        }
+        return this._handleCallback(callback, retVal);
+    }
+    /**
+     * 批量获取
+     * @param keys
+     * @param callback
+     */
+    mget(...keys) {
+        const callback = this._retrieveCallback(keys);
+        const retVal = [];
+        for (const key of keys) {
+            if (this._hasKey(key)) {
+                this._testType(key, 'string', false, callback);
+                retVal.push(this._getKey(key));
+            }
+            else {
+                retVal.push(null);
+            }
+        }
+        return this._handleCallback(callback, retVal);
+    }
+    /**
+     * 批量设置
+     * @param keyValuePairs
+     * @param callback
+     */
+    mset(...keyValuePairs) {
+        const callback = this._retrieveCallback(keyValuePairs);
+        // 确保参数是偶数个
+        if (keyValuePairs.length % 2 !== 0) {
+            return this._handleCallback(callback, null, messages.wrongArgCount.replace('%0', 'mset'));
+        }
+        for (let i = 0; i < keyValuePairs.length; i += 2) {
+            const key = keyValuePairs[i];
+            const value = keyValuePairs[i + 1];
+            this.cache.set(key, this._makeKey(value.toString(), 'string'));
+        }
+        return this._handleCallback(callback, messages.ok);
+    }
+    /**
+     * 获取所有键
+     * @param pattern
+     * @param callback
+     */
+    keys(pattern = '*', callback) {
+        const retVal = [];
+        this.cache.forEach((_item, key) => {
+            if (pattern === '*' || this.matchPattern(key, pattern)) {
+                retVal.push(key);
+            }
+        });
+        return this._handleCallback(callback, retVal);
+    }
+    /**
+     * 简单的模式匹配
+     * @param key
+     * @param pattern
+     */
+    matchPattern(key, pattern) {
+        if (pattern === '*')
+            return true;
+        // 转换glob模式为正则表达式
+        const regexPattern = pattern
+            .replace(/\*/g, '.*')
+            .replace(/\?/g, '.')
+            .replace(/\[([^\]]*)\]/g, '[$1]');
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(key);
+    }
+    /**
+     * 获取随机键
+     * @param callback
+     */
+    randomkey(callback) {
+        const keys = [];
+        this.cache.forEach((_item, key) => {
+            keys.push(key);
+        });
+        if (keys.length === 0) {
+            return this._handleCallback(callback, null);
+        }
+        const randomIndex = Math.floor(Math.random() * keys.length);
+        return this._handleCallback(callback, keys[randomIndex]);
+    }
+    /**
+     * 重命名键
+     * @param oldKey
+     * @param newKey
+     * @param callback
+     */
+    rename(oldKey, newKey, callback) {
+        if (!this._hasKey(oldKey)) {
+            return this._handleCallback(callback, null, messages.nokey);
+        }
+        const value = this.cache.get(oldKey);
+        this.cache.set(newKey, value);
+        this.cache.delete(oldKey);
+        return this._handleCallback(callback, messages.ok);
+    }
+    /**
+     * 安全重命名键（目标键不存在时才重命名）
+     * @param oldKey
+     * @param newKey
+     * @param callback
+     */
+    renamenx(oldKey, newKey, callback) {
+        if (!this._hasKey(oldKey)) {
+            return this._handleCallback(callback, null, messages.nokey);
+        }
+        if (this._hasKey(newKey)) {
+            return this._handleCallback(callback, 0);
+        }
+        const value = this.cache.get(oldKey);
+        this.cache.set(newKey, value);
+        this.cache.delete(oldKey);
+        return this._handleCallback(callback, 1);
+    }
+    /**
+     * 获取键的类型
+     * @param key
+     * @param callback
+     */
+    type(key, callback) {
+        if (!this._hasKey(key)) {
+            return this._handleCallback(callback, 'none');
+        }
+        const item = this.cache.get(key);
+        return this._handleCallback(callback, item.type);
+    }
+    /**
+     * 清空当前数据库
+     * @param callback
+     */
+    flushdb(callback) {
+        this.cache.clear();
+        return this._handleCallback(callback, messages.ok);
+    }
+    /**
+     * 清空所有数据库
+     * @param callback
+     */
+    flushall(callback) {
+        this.databases.clear();
+        this.cache = this.createLRUCache();
+        this.databases.set(this.currentDBIndex, this.cache);
+        return this._handleCallback(callback, messages.ok);
+    }
+    /**
+     * 获取数据库大小
+     * @param callback
+     */
+    dbsize(callback) {
+        const size = this.cache.size || 0;
+        return this._handleCallback(callback, size);
+    }
+    /**
+     * Sorted Set基础实现 - 添加成员
+     * @param key
+     * @param score
+     * @param member
+     * @param callback
+     */
+    zadd(key, score, member, callback) {
+        let retVal = 0;
+        if (this._hasKey(key)) {
+            this._testType(key, 'zset', true, callback);
+        }
+        else {
+            this.cache.set(key, this._makeKey([], 'zset'));
+        }
+        const zset = this._getKey(key);
+        const existing = zset.find((item) => item.member === member);
+        if (existing) {
+            existing.score = score;
+        }
+        else {
+            zset.push({ score, member });
+            retVal = 1;
+        }
+        // 按分数排序
+        zset.sort((a, b) => a.score - b.score);
+        this._setKey(key, zset);
+        return this._handleCallback(callback, retVal);
+    }
+    /**
+     * Sorted Set - 获取成员分数
+     * @param key
+     * @param member
+     * @param callback
+     */
+    zscore(key, member, callback) {
+        if (!this._hasKey(key)) {
+            return this._handleCallback(callback, null);
+        }
+        this._testType(key, 'zset', true, callback);
+        const zset = this._getKey(key);
+        const item = zset.find((item) => item.member === member);
+        return this._handleCallback(callback, item ? item.score : null);
+    }
+    /**
+     * Sorted Set - 获取范围内的成员
+     * @param key
+     * @param start
+     * @param stop
+     * @param callback
+     */
+    zrange(key, start, stop, callback) {
+        if (!this._hasKey(key)) {
+            return this._handleCallback(callback, []);
+        }
+        this._testType(key, 'zset', true, callback);
+        const zset = this._getKey(key);
+        const length = zset.length;
+        if (stop < 0) {
+            stop = length + stop;
+        }
+        if (start < 0) {
+            start = length + start;
+        }
+        const retVal = zset.slice(start, stop + 1).map((item) => item.member);
+        return this._handleCallback(callback, retVal);
+    }
+    /**
+     * Sorted Set - 获取成员数量
+     * @param key
+     * @param callback
+     */
+    zcard(key, callback) {
+        if (!this._hasKey(key)) {
+            return this._handleCallback(callback, 0);
+        }
+        this._testType(key, 'zset', true, callback);
+        const zset = this._getKey(key);
+        return this._handleCallback(callback, zset.length);
+    }
+    /**
+     * Sorted Set - 删除成员
+     * @param key
+     * @param member
+     * @param callback
+     */
+    zrem(key, member, callback) {
+        let retVal = 0;
+        if (this._hasKey(key)) {
+            this._testType(key, 'zset', true, callback);
+            const zset = this._getKey(key);
+            const index = zset.findIndex((item) => item.member === member);
+            if (index !== -1) {
+                zset.splice(index, 1);
+                retVal = 1;
+                this._setKey(key, zset);
+            }
+        }
+        return this._handleCallback(callback, retVal);
+    }
 }
 
 /*
@@ -1197,7 +1660,12 @@ class MemoryStore {
      * @memberof MemoryStore
      */
     constructor(options) {
-        this.options = options;
+        this.options = {
+            maxKeys: 1000,
+            evictionPolicy: 'lru',
+            ttlCheckInterval: 60000, // 1分钟
+            ...options
+        };
         this.client = null;
     }
     /**
@@ -1209,7 +1677,11 @@ class MemoryStore {
     getConnection() {
         if (!this.pool) {
             this.pool = new MemoryCache({
-                database: this.options.db
+                database: this.options.db || 0,
+                maxKeys: this.options.maxKeys,
+                maxMemory: this.options.maxMemory,
+                evictionPolicy: this.options.evictionPolicy,
+                ttlCheckInterval: this.options.ttlCheckInterval
             });
         }
         if (!this.client) {
@@ -1225,8 +1697,10 @@ class MemoryStore {
      * @memberof MemoryStore
      */
     async close() {
-        this.client.end();
-        this.client = null;
+        if (this.client) {
+            this.client.end();
+            this.client = null;
+        }
     }
     /**
      * release
@@ -1269,6 +1743,20 @@ class MemoryStore {
             return -1;
         }
     }
+    /**
+     * 获取缓存统计信息
+     */
+    getStats() {
+        if (this.client) {
+            return this.client.info();
+        }
+        return {
+            keys: 0,
+            memory: 0,
+            hits: 0,
+            misses: 0
+        };
+    }
 }
 
 /*
@@ -1289,6 +1777,9 @@ class RedisStore {
     options;
     pool;
     client;
+    reconnectAttempts = 0;
+    maxReconnectAttempts = 5;
+    reconnectDelay = 1000; // 初始重连延迟1秒
     /**
      * Creates an instance of RedisStore.
      * @param {RedisStoreOpt} options
@@ -1348,7 +1839,7 @@ class RedisStore {
         return opt;
     }
     /**
-     * create connection by native
+     * create connection by native with improved error handling
      *
      * @param {number} [connNum=0]
      * @returns {*}  {Promise<Redis | Cluster>}
@@ -1360,32 +1851,77 @@ class RedisStore {
         }
         const defer = helper__namespace.getDefer();
         let connection;
-        if (!helper__namespace.isEmpty(this.options.clusters)) {
-            connection = new ioredis.Cluster([...this.options.clusters], { redisOptions: this.options });
-        }
-        else {
-            connection = new ioredis.Redis(this.options);
-        }
-        // 去除prefix, 防止重复
-        this.options.keyPrefix = "";
-        connection.on('end', () => {
-            if (connNum < 3) {
-                connNum++;
-                defer.resolve(this.connect(connNum));
+        try {
+            if (!helper__namespace.isEmpty(this.options.clusters)) {
+                connection = new ioredis.Cluster([...this.options.clusters], {
+                    redisOptions: this.options,
+                    enableOfflineQueue: false,
+                    retryDelayOnFailover: 100
+                });
             }
             else {
-                this.close();
-                defer.reject('redis connection end');
+                connection = new ioredis.Redis({
+                    ...this.options,
+                    enableOfflineQueue: false,
+                    retryDelayOnFailover: 100,
+                    lazyConnect: true
+                });
             }
-        });
-        connection.on('ready', () => {
-            this.client = connection;
-            defer.resolve(connection);
-        });
+            // 去除prefix, 防止重复
+            this.options.keyPrefix = "";
+            connection.on('error', (err) => {
+                koatty_logger.DefaultLogger.Error(`Redis connection error: ${err.message}`);
+                if (this.reconnectAttempts < this.maxReconnectAttempts) {
+                    this.scheduleReconnect(connNum);
+                }
+                else {
+                    defer.reject(new Error(`Redis connection failed after ${this.maxReconnectAttempts} attempts`));
+                }
+            });
+            connection.on('end', () => {
+                koatty_logger.DefaultLogger.Warn('Redis connection ended');
+                if (connNum < 3) {
+                    this.scheduleReconnect(connNum + 1);
+                }
+                else {
+                    this.close();
+                    defer.reject(new Error('Redis connection end after 3 attempts'));
+                }
+            });
+            connection.on('ready', () => {
+                koatty_logger.DefaultLogger.Info('Redis connection ready');
+                this.client = connection;
+                this.reconnectAttempts = 0; // 重置重连计数
+                defer.resolve(connection);
+            });
+            // 主动连接
+            if (connection instanceof ioredis.Redis) {
+                await connection.connect();
+            }
+        }
+        catch (error) {
+            koatty_logger.DefaultLogger.Error(`Failed to create Redis connection: ${error.message}`);
+            defer.reject(error);
+        }
         return defer.promise;
     }
     /**
-     * get connection from pool
+     * 计划重连，使用指数退避策略
+     * @private
+     * @param {number} connNum
+     */
+    scheduleReconnect(connNum) {
+        this.reconnectAttempts++;
+        const delay = this.reconnectDelay * Math.pow(2, this.reconnectAttempts - 1);
+        koatty_logger.DefaultLogger.Info(`Scheduling Redis reconnect attempt ${this.reconnectAttempts} in ${delay}ms`);
+        setTimeout(() => {
+            this.connect(connNum).catch(err => {
+                koatty_logger.DefaultLogger.Error(`Reconnect attempt ${this.reconnectAttempts} failed: ${err.message}`);
+            });
+        }, delay);
+    }
+    /**
+     * get connection from pool with improved configuration
      *
      * @returns {*}
      * @memberof RedisStore
@@ -1396,38 +1932,57 @@ class RedisStore {
                 create: () => {
                     return this.connect();
                 },
-                destroy: () => {
-                    return this.close();
+                destroy: (resource) => {
+                    if (resource && typeof resource.disconnect === 'function') {
+                        resource.disconnect();
+                    }
+                    return Promise.resolve();
                 },
                 validate: (resource) => {
-                    return Promise.resolve(resource.status === 'ready');
+                    return Promise.resolve(resource && resource.status === 'ready');
                 }
             };
             this.pool = genericPool.createPool(factory, {
                 max: this.options.poolSize || 10, // maximum size of the pool
-                min: 2 // minimum size of the pool
+                min: Math.min(2, this.options.poolSize || 2), // minimum size of the pool
+                acquireTimeoutMillis: 30000, // 30秒获取连接超时
+                testOnBorrow: true, // 借用时测试连接
+                evictionRunIntervalMillis: 30000, // 30秒检查一次空闲连接
+                idleTimeoutMillis: 300000, // 5分钟空闲超时
+                softIdleTimeoutMillis: 180000 // 3分钟软空闲超时
             });
             this.pool.on('factoryCreateError', function (err) {
-                koatty_logger.DefaultLogger.Error(err);
+                koatty_logger.DefaultLogger.Error(`Redis pool create error: ${err.message}`);
             });
             this.pool.on('factoryDestroyError', function (err) {
-                koatty_logger.DefaultLogger.Error(err);
+                koatty_logger.DefaultLogger.Error(`Redis pool destroy error: ${err.message}`);
             });
         }
         return this.pool.acquire();
     }
     /**
-     * close connection
+     * close connection with proper cleanup
      *
      * @returns {*}
      * @memberof RedisStore
      */
     async close() {
-        this.client.disconnect();
-        this.client = null;
-        this.pool.destroy(this.client);
-        this.pool = null;
-        return;
+        try {
+            if (this.pool) {
+                await this.pool.drain();
+                await this.pool.clear();
+                this.pool = null;
+            }
+            if (this.client) {
+                if (typeof this.client.disconnect === 'function') {
+                    this.client.disconnect();
+                }
+                this.client = null;
+            }
+        }
+        catch (error) {
+            koatty_logger.DefaultLogger.Error(`Error closing Redis connection: ${error.message}`);
+        }
     }
     /**
      *
@@ -1470,16 +2025,16 @@ class RedisStore {
         try {
             conn = await this.defineCommand("getCompare", {
                 numberOfKeys: 1,
-                lua: `
-                    local remote_value = redis.call("get",KEYS[1])
-                    
-                    if (not remote_value) then
-                        return 0
-                    elseif (remote_value == ARGV[1]) then
-                        return redis.call("del",KEYS[1])
-                    else
-                        return -1
-                    end
+                lua: `
+                    local remote_value = redis.call("get",KEYS[1])
+                    
+                    if (not remote_value) then
+                        return 0
+                    elseif (remote_value == ARGV[1]) then
+                        return redis.call("del",KEYS[1])
+                    else
+                        return -1
+                    end
             `
             });
             return conn.getCompare(name, value);
@@ -1519,7 +2074,7 @@ const defaultOptions = {
 class CacheStore {
     client;
     options;
-    static instance;
+    static instances = new Map();
     /**
      * Creates an instance of CacheStore.
      * @param {StoreOptions} options
@@ -1539,17 +2094,70 @@ class CacheStore {
         }
     }
     /**
-     *
-     *
+     * 获取单例实例，支持多配置实例管理
      * @static
-     * @returns
+     * @param {StoreOptions} [options]
+     * @param {string} [instanceKey='default'] 实例键名，用于区分不同配置的实例
+     * @returns {CacheStore}
+     */
+    static getInstance(options, instanceKey = 'default') {
+        // 生成配置哈希作为实例键的一部分
+        const configHash = options ? this.generateConfigHash(options) : 'default';
+        const fullKey = `${instanceKey}_${configHash}`;
+        if (this.instances.has(fullKey)) {
+            return this.instances.get(fullKey);
+        }
+        const instance = new CacheStore(options);
+        this.instances.set(fullKey, instance);
+        return instance;
+    }
+    /**
+     * 生成配置哈希
+     * @private
+     * @static
+     * @param {StoreOptions} options
+     * @returns {string}
      */
-    static getInstance(options) {
-        if (this.instance) {
-            return this.instance;
+    static generateConfigHash(options) {
+        const configStr = JSON.stringify({
+            type: options.type,
+            host: options.host,
+            port: options.port,
+            db: options.db,
+            keyPrefix: options.keyPrefix
+        });
+        // 简单哈希函数
+        let hash = 0;
+        for (let i = 0; i < configStr.length; i++) {
+            const char = configStr.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash; // 转换为32位整数
         }
-        this.instance = new CacheStore(options);
-        return this.instance;
+        return Math.abs(hash).toString(36);
+    }
+    /**
+     * 清理指定实例
+     * @static
+     * @param {string} [instanceKey='default']
+     */
+    static async clearInstance(instanceKey = 'default') {
+        const keysToRemove = Array.from(this.instances.keys()).filter(key => key.startsWith(`${instanceKey}_`));
+        for (const key of keysToRemove) {
+            const instance = this.instances.get(key);
+            if (instance) {
+                await instance.close();
+                this.instances.delete(key);
+            }
+        }
+    }
+    /**
+     * 清理所有实例
+     * @static
+     */
+    static async clearAllInstances() {
+        const promises = Array.from(this.instances.values()).map(instance => instance.close());
+        await Promise.all(promises);
+        this.instances.clear();
     }
     getConnection() {
         return this.client.getConnection();
@@ -1560,11 +2168,13 @@ class CacheStore {
     release(conn) {
         return this.client.release(conn);
     }
-    defineCommand(name, scripts) {
-        return this.client.defineCommand(name, scripts);
-    }
-    getCompare(name, value) {
-        return this.client.getCompare(name, value);
+    /**
+     * 获取底层实现客户端，用于访问特定实现的功能
+     * 例如：Redis的defineCommand, getCompare等
+     * @returns {MemoryStore | RedisStore}
+     */
+    getRawClient() {
+        return this.client;
     }
     /**
      * handler for native client
@@ -1624,13 +2234,6 @@ class CacheStore {
     expire(name, timeout) {
         return this.wrap('expire', [`${this.options.keyPrefix || ""}${name}`, timeout]);
     }
-    /**
-     * 删除key
-     * @param name
-     */
-    rm(name) {
-        return this.wrap('del', [`${this.options.keyPrefix || ""}${name}`]);
-    }
     /**
      *
      *
@@ -1668,8 +2271,8 @@ class CacheStore {
      * @param incr
      * @returns {*}
      */
-    incrby(name, incr = 1) {
-        return this.wrap('incrby', [`${this.options.keyPrefix || ""}${name}`, incr]);
+    incrby(name, increment) {
+        return this.wrap('incrby', [`${this.options.keyPrefix || ""}${name}`, increment]);
     }
     /**
      * 将 key 所储存的值减去减量
@@ -1677,8 +2280,8 @@ class CacheStore {
      * @param {any} name
      * @param {any} decr
      */
-    decrby(name, decr = 1) {
-        return this.wrap('decrby', [`${this.options.keyPrefix || ""}${name}`, decr]);
+    decrby(name, decrement) {
+        return this.wrap('decrby', [`${this.options.keyPrefix || ""}${name}`, decrement]);
     }
     /**
      * 哈希写入
@@ -1687,13 +2290,16 @@ class CacheStore {
      * @param value
      * @param timeout
      */
-    hset(name, key, value, timeout) {
-        const setP = [this.wrap('hset', [`${this.options.keyPrefix || ""}${name}`, key, value])];
-        if (typeof timeout !== 'number') {
-            timeout = this.options.timeout;
+    async hset(name, key, value, timeout) {
+        const result = await this.wrap('hset', [`${this.options.keyPrefix || ""}${name}`, key, value]);
+        if (typeof timeout === 'number') {
+            await this.set(`${name}:${key}_ex`, 1, timeout);
         }
-        setP.push(this.set(`${name}:${key}_ex`, 1, timeout));
-        return Promise.all(setP);
+        else {
+            // 如果没有指定timeout，设置一个永久标记，避免hget时误删
+            await this.set(`${name}:${key}_ex`, 1);
+        }
+        return result;
     }
     /**
      * 哈希获取
@@ -1726,7 +2332,7 @@ class CacheStore {
                 this.hdel(name, key);
                 return 0;
             }
-            return dataArr[1] || 0;
+            return Number(dataArr[1]) || 0;
         });
     }
     /**
@@ -1735,10 +2341,10 @@ class CacheStore {
      * @param key
      * @returns {*}
      */
-    hdel(name, key) {
-        const setP = [this.del(`${name}:${key}_ex`)];
-        setP.push(this.wrap('hdel', [`${this.options.keyPrefix || ""}${name}`, key]));
-        return Promise.all(setP);
+    async hdel(name, key) {
+        await this.del(`${name}:${key}_ex`);
+        const result = await this.wrap('hdel', [`${this.options.keyPrefix || ""}${name}`, key]);
+        return result;
     }
     /**
      * 返回哈希表 key 中域的数量
@@ -1752,11 +2358,11 @@ class CacheStore {
      * 给哈希表指定key，增加increment
      * @param name
      * @param key
-     * @param incr
+     * @param increment
      * @returns {*}
      */
-    hincrby(name, key, incr = 1) {
-        return this.wrap('hincrby', [`${this.options.keyPrefix || ""}${name}`, key, incr]);
+    hincrby(name, key, increment) {
+        return this.wrap('hincrby', [`${this.options.keyPrefix || ""}${name}`, key, increment]);
     }
     /**
      * 返回哈希表所有key-value
@@ -1845,12 +2451,12 @@ class CacheStore {
      * @param timeout
      * @returns {*}
      */
-    sadd(name, value, timeout) {
-        const setP = [this.wrap('sadd', [`${this.options.keyPrefix || ""}${name}`, value])];
-        if (typeof timeout !== 'number') {
-            setP.push(this.wrap('expire', [`${this.options.keyPrefix || ""}${name}`, timeout]));
+    async sadd(name, value, timeout) {
+        const result = await this.wrap('sadd', [`${this.options.keyPrefix || ""}${name}`, value]);
+        if (typeof timeout === 'number') {
+            await this.wrap('expire', [`${this.options.keyPrefix || ""}${name}`, timeout]);
         }
-        return Promise.all(setP);
+        return result;
     }
     /**
      * 返回集合的基数(集合中元素的数量)
@@ -1902,7 +2508,7 @@ class CacheStore {
      * @returns {*}
      */
     smove(source, destination, member) {
-        return this.wrap('smove', [`${this.options.keyPrefix || ""}${source}`, `${this.options.keyPrefix}${destination}`, member]);
+        return this.wrap('smove', [`${this.options.keyPrefix || ""}${source}`, `${this.options.keyPrefix || ""}${destination}`, member]);
     }
 }