koatty_store 1.7.0 → 1.8.0

package/dist/index.d.ts

@@ -1,16 +1,13 @@
 /*!
 * @Author: richen
-* @Date: 2024-11-07 14:39:13
+* @Date: 2025-06-09 12:32:53
 * @License: BSD (3-Clause)
 * @Copyright (c) - <richenlin(at)gmail.com>
 * @HomePage: https://koatty.org/
 */
-/// <reference types="node" />
-
 import { Cluster } from 'ioredis';
 import { ClusterOptions } from 'ioredis';
-import { default as default_2 } from 'ioredis/built/cluster';
-import { default as default_3 } from 'ioredis/built/Redis';
+import { default as default_2 } from 'ioredis';
 import { EventEmitter } from 'events';
 import genericPool from 'generic-pool';
 import { Redis } from 'ioredis';
@@ -22,7 +19,7 @@ import { RedisOptions } from 'ioredis';
  * @export
  * @class Store
  */
-export declare class CacheStore {
+export declare class CacheStore implements CacheStoreInterface {
     client: MemoryStore | RedisStore;
     options: StoreOptions;
     /**
@@ -32,17 +29,40 @@ export declare class CacheStore {
      */
     constructor(options?: StoreOptions);
     /**
-     *
-     *
+     * 获取单例实例，支持多配置实例管理
+     * @static
+     * @param {StoreOptions} [options]
+     * @param {string} [instanceKey='default'] 实例键名，用于区分不同配置的实例
+     * @returns {CacheStore}
+     */
+    static getInstance(options?: StoreOptions, instanceKey?: string): CacheStore;
+    /**
+     * 生成配置哈希
+     * @private
+     * @static
+     * @param {StoreOptions} options
+     * @returns {string}
+     */
+    /**
+     * 清理指定实例
+     * @static
+     * @param {string} [instanceKey='default']
+     */
+    static clearInstance(instanceKey?: string): Promise<void>;
+    /**
+     * 清理所有实例
      * @static
-     * @returns
      */
-    static getInstance(options?: StoreOptions): CacheStore;
-    getConnection(): MemoryCache | Promise<default_2 | default_3>;
+    static clearAllInstances(): Promise<void>;
+    getConnection(): MemoryCache | Promise<Cluster | default_2>;
     close(): Promise<void>;
     release(conn: any): Promise<void>;
-    defineCommand(name: string, scripts: any): Promise<any>;
-    getCompare(name: string, value: string | number): Promise<any>;
+    /**
+     * 获取底层实现客户端，用于访问特定实现的功能
+     * 例如：Redis的defineCommand, getCompare等
+     * @returns {MemoryStore | RedisStore}
+     */
+    getRawClient(): MemoryStore | RedisStore;
     /**
      * handler for native client
      *
@@ -55,7 +75,7 @@ export declare class CacheStore {
      * 字符串获取
      * @param name
      */
-    get(name: string): Promise<any>;
+    get(name: string): Promise<string | null>;
     /**
      * 字符串写入
      * @param name
@@ -63,61 +83,56 @@ export declare class CacheStore {
      * @param timeout
      * @returns {Promise}
      */
-    set(name: string, value: string | number, timeout?: number): Promise<any>;
+    set(name: string, value: string | number, timeout?: number): Promise<string>;
     /**
      * 以秒为单位，返回给定 key 的剩余生存时间
      * @param name
      * @returns {*}
      */
-    ttl(name: string): Promise<any>;
+    ttl(name: string): Promise<number>;
     /**
      * 设置key超时属性
      * @param name
      * @param timeout
      */
-    expire(name: string, timeout?: number): Promise<any>;
-    /**
-     * 删除key
-     * @param name
-     */
-    rm(name: string): Promise<any>;
+    expire(name: string, timeout: number): Promise<number>;
     /**
      *
      *
      * @param {*} name
      * @returns
      */
-    del(name: string): Promise<any>;
+    del(name: string): Promise<number>;
     /**
      * 判断key是否存在
      * @param name
      */
-    exists(name: string): Promise<any>;
+    exists(name: string): Promise<number>;
     /**
      * 自增
      * @param name
      */
-    incr(name: string): Promise<any>;
+    incr(name: string): Promise<number>;
     /**
      * 自减
      * @param name
      * @returns {*}
      */
-    decr(name: string): Promise<any>;
+    decr(name: string): Promise<number>;
     /**
      * 将 key 所储存的值增加增量
      * @param name
      * @param incr
      * @returns {*}
      */
-    incrby(name: string, incr?: number): Promise<any>;
+    incrby(name: string, increment: number): Promise<number>;
     /**
      * 将 key 所储存的值减去减量
      *
      * @param {any} name
      * @param {any} decr
      */
-    decrby(name: string, decr?: number): Promise<any>;
+    decrby(name: string, decrement: number): Promise<number>;
     /**
      * 哈希写入
      * @param name
@@ -125,42 +140,42 @@ export declare class CacheStore {
      * @param value
      * @param timeout
      */
-    hset(name: string, key: string, value: string | number, timeout?: number): Promise<any[]>;
+    hset(name: string, key: string, value: string | number, timeout?: number): Promise<number>;
     /**
      * 哈希获取
      * @param name
      * @param key
      * @returns {*}
      */
-    hget(name: string, key: string): Promise<any>;
+    hget(name: string, key: string): Promise<string | null>;
     /**
      * 查看哈希表 hashKey 中，给定域 key 是否存在
      * @param name
      * @param key
      * @returns {*}
      */
-    hexists(name: string, key: string): Promise<any>;
+    hexists(name: string, key: string): Promise<number>;
     /**
      * 哈希删除
      * @param name
      * @param key
      * @returns {*}
      */
-    hdel(name: string, key: string): Promise<any[]>;
+    hdel(name: string, key: string): Promise<number>;
     /**
      * 返回哈希表 key 中域的数量
      * @param name
      * @returns {*}
      */
-    hlen(name: string): Promise<any>;
+    hlen(name: string): Promise<number>;
     /**
      * 给哈希表指定key，增加increment
      * @param name
      * @param key
-     * @param incr
+     * @param increment
      * @returns {*}
      */
-    hincrby(name: string, key: string, incr?: number): Promise<any>;
+    hincrby(name: string, key: string, increment: number): Promise<number>;
     /**
      * 返回哈希表所有key-value
      * @param name
@@ -172,26 +187,26 @@ export declare class CacheStore {
      * @param name
      * @returns {*}
      */
-    hkeys(name: string): Promise<any>;
+    hkeys(name: string): Promise<string[]>;
     /**
      * 返回哈希表所有value
      * @param name
      * @returns {*}
      */
-    hvals(name: string): Promise<any>;
+    hvals(name: string): Promise<any[]>;
     /**
      * 判断列表长度，若不存在则表示为空
      * @param name
      * @returns {*}
      */
-    llen(name: string): Promise<any>;
+    llen(name: string): Promise<number>;
     /**
      * 将值插入列表表尾
      * @param name
      * @param value
      * @returns {*}
      */
-    rpush(name: string, value: string | number): Promise<any>;
+    rpush(name: string, value: string | number): Promise<number>;
     /**
      *
      *
@@ -200,13 +215,13 @@ export declare class CacheStore {
      * @returns {*}
      * @memberof RedisStore
      */
-    lpush(name: string, value: string | number): Promise<any>;
+    lpush(name: string, value: string | number): Promise<number>;
     /**
      * 将列表表头取出，并去除
      * @param name
      * @returns {*}
      */
-    lpop(name: string): Promise<any>;
+    lpop(name: string): Promise<string | null>;
     /**
      *
      *
@@ -214,7 +229,7 @@ export declare class CacheStore {
      * @returns {*}
      * @memberof RedisStore
      */
-    rpop(name: string): Promise<any>;
+    rpop(name: string): Promise<string | null>;
     /**
      * 返回列表 key 中指定区间内的元素，区间以偏移量 start 和 stop 指定
      * @param name
@@ -222,7 +237,7 @@ export declare class CacheStore {
      * @param stop
      * @returns {*}
      */
-    lrange(name: string, start: number, stop: number): Promise<any>;
+    lrange(name: string, start: number, stop: number): Promise<any[]>;
     /**
      * 集合新增
      * @param name
@@ -230,26 +245,26 @@ export declare class CacheStore {
      * @param timeout
      * @returns {*}
      */
-    sadd(name: string, value: string | number, timeout?: number): Promise<any[]>;
+    sadd(name: string, value: string | number, timeout?: number): Promise<number>;
     /**
      * 返回集合的基数(集合中元素的数量)
      * @param name
      * @returns {*}
      */
-    scard(name: string): Promise<any>;
+    scard(name: string): Promise<number>;
     /**
      * 判断 member 元素是否集合的成员
      * @param name
      * @param key
      * @returns {*}
      */
-    sismember(name: string, key: string): Promise<any>;
+    sismember(name: string, key: string): Promise<number>;
     /**
      * 返回集合中的所有成员
      * @param name
      * @returns {*}
      */
-    smembers(name: string): Promise<any>;
+    smembers(name: string): Promise<any[]>;
     /**
      * 移除并返回集合中的一个随机元素
      * @param name
@@ -262,7 +277,7 @@ export declare class CacheStore {
      * @param key
      * @returns {*}
      */
-    srem(name: string, key: string): Promise<any>;
+    srem(name: string, key: string): Promise<number>;
     /**
      * 将 member 元素从 source 集合移动到 destination 集合
      * @param source
@@ -270,17 +285,49 @@ export declare class CacheStore {
      * @param member
      * @returns {*}
      */
-    smove(source: string, destination: string, member: string): Promise<any>;
+    smove(source: string, destination: string, member: string): Promise<number>;
 }
 
 declare interface CacheStoreInterface {
-    getConnection(): void;
+    getConnection(): any;
     close(): Promise<void>;
     release(conn: any): Promise<void>;
-    defineCommand(name: string, scripts: any): void;
-    getCompare(name: string, value: string | number): Promise<any>;
+    get?(name: string): Promise<string | null>;
+    set?(name: string, value: string | number, timeout?: number): Promise<string>;
+    del?(name: string): Promise<number>;
+    exists?(name: string): Promise<number>;
+    ttl?(name: string): Promise<number>;
+    expire?(name: string, timeout: number): Promise<number>;
+    incr?(name: string): Promise<number>;
+    decr?(name: string): Promise<number>;
+    incrby?(name: string, increment: number): Promise<number>;
+    decrby?(name: string, decrement: number): Promise<number>;
+    hset?(name: string, key: string, value: string | number, timeout?: number): Promise<number>;
+    hget?(name: string, key: string): Promise<string | null>;
+    hdel?(name: string, key: string): Promise<number>;
+    hexists?(name: string, key: string): Promise<number>;
+    hgetall?(name: string): Promise<any>;
+    hkeys?(name: string): Promise<string[]>;
+    hvals?(name: string): Promise<any[]>;
+    hlen?(name: string): Promise<number>;
+    hincrby?(name: string, key: string, increment: number): Promise<number>;
+    lpush?(name: string, value: string | number): Promise<number>;
+    rpush?(name: string, value: string | number): Promise<number>;
+    lpop?(name: string): Promise<string | null>;
+    rpop?(name: string): Promise<string | null>;
+    llen?(name: string): Promise<number>;
+    lrange?(name: string, start: number, stop: number): Promise<any[]>;
+    sadd?(name: string, value: string | number, timeout?: number): Promise<number>;
+    srem?(name: string, key: string): Promise<number>;
+    scard?(name: string): Promise<number>;
+    sismember?(name: string, key: string): Promise<number>;
+    smembers?(name: string): Promise<any[]>;
+    spop?(name: string): Promise<any>;
+    smove?(source: string, destination: string, member: string): Promise<number>;
 }
 
+declare type CallbackFunction<T = any> = (err: Error | null, result?: T) => void;
+
 declare class MemoryCache extends EventEmitter {
     options: MemoryCacheOptions;
     currentDBIndex: number;
@@ -289,10 +336,22 @@ declare class MemoryCache extends EventEmitter {
     multiMode: boolean;
     /**
      * Creates an instance of MemoryCache.
-     * @param {*} options
+     * @param {MemoryCacheOptions} options
      * @memberof MemoryCache
      */
     constructor(options: MemoryCacheOptions);
+    /**
+     * 创建LRU缓存实例
+     */
+    /**
+     * 启动TTL检查定时器
+     */
+    /**
+     * 清理过期键
+     */
+    /**
+     * 停止TTL检查
+     */
     /**
      *
      *
@@ -314,6 +373,13 @@ declare class MemoryCache extends EventEmitter {
      * @memberof MemoryCache
      */
     end(): this;
+    /**
+     * 获取缓存统计信息
+     */
+    info(): any;
+    /**
+     * 估算内存使用量
+     */
     /**
      *
      *
@@ -322,7 +388,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    echo(message: string, callback?: Function): any;
+    echo(message: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -331,7 +397,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    ping(message: string, callback?: Function): any;
+    ping(message: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -340,7 +406,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    auth(password: string, callback?: Function): any;
+    auth(password: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -349,8 +415,8 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    select(dbIndex: number, callback?: Function): any;
-    get(key: string, callback?: Function): any;
+    select(dbIndex: number, callback?: CallbackFunction): any;
+    get(key: string, callback?: CallbackFunction): any;
     /**
      * set(key, value, ttl, pttl, notexist, onlyexist, callback)
      *
@@ -369,7 +435,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    ttl(key: string, callback?: Function): any;
+    ttl(key: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -379,7 +445,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    expire(key: string, seconds: number, callback?: Function): any;
+    expire(key: string, seconds: number, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -404,7 +470,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    incr(key: string, callback?: Function): any;
+    incr(key: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -414,7 +480,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    incrby(key: string, amount: number, callback?: Function): any;
+    incrby(key: string, amount: number, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -423,7 +489,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    decr(key: string, callback?: Function): any;
+    decr(key: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -433,8 +499,8 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    decrby(key: string, amount: number, callback?: Function): any;
-    hset(key: string, field: string, value: string | number, callback?: Function): any;
+    decrby(key: string, amount: number, callback?: CallbackFunction): any;
+    hset(key: string, field: string, value: string | number, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -444,7 +510,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    hget(key: string, field: string, callback?: Function): any;
+    hget(key: string, field: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -454,7 +520,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    hexists(key: string, field: string, callback?: Function): any;
+    hexists(key: string, field: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -472,7 +538,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    hlen(key: string, callback?: Function): any;
+    hlen(key: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -483,7 +549,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    hincrby(key: string, field: string, value: any, callback?: Function): any;
+    hincrby(key: string, field: string, value: any, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -492,7 +558,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    hgetall(key: string, callback?: Function): any;
+    hgetall(key: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -501,7 +567,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    hkeys(key: string, callback?: Function): any;
+    hkeys(key: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -510,7 +576,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    hvals(key: string, callback?: Function): any;
+    hvals(key: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -519,7 +585,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    llen(key: string, callback?: Function): any;
+    llen(key: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -529,17 +595,21 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    rpush(key: string, value: string | number, callback?: Function): any;
+    rpush(key: string, value: string | number, callback?: CallbackFunction): any;
     /**
-     *
-     *
-     * @param {string} key
-     * @param {(string | number)} value
-     * @param {Function} [callback]
-     * @returns {*}
-     * @memberof MemoryCache
+     * List：从左侧推入
+     * @param key
+     * @param value
+     * @param callback
      */
-    lpush(key: string, value: string | number, callback?: Function): any;
+    lpush(key: string, value: any, callback?: CallbackFunction): any;
+    /**
+     * List：获取指定索引的元素
+     * @param key
+     * @param index
+     * @param callback
+     */
+    lindex(key: string, index: number, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -548,7 +618,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    lpop(key: string, callback?: Function): any;
+    lpop(key: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -557,7 +627,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    rpop(key: string, callback?: Function): any;
+    rpop(key: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -568,7 +638,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    lrange(key: string, start: number, stop: number, callback?: Function): any;
+    lrange(key: string, start: number, stop: number, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -586,7 +656,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    scard(key: string, callback?: Function): any;
+    scard(key: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -596,7 +666,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    sismember(key: string, member: string, callback?: Function): any;
+    sismember(key: string, member: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -605,7 +675,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    smembers(key: string, callback?: Function): any;
+    smembers(key: string, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -615,7 +685,7 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    spop(key: string, count?: number, callback?: Function): any;
+    spop(key: string, count?: number, callback?: CallbackFunction): any;
     /**
      *
      *
@@ -635,8 +705,8 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
-    smove(sourcekey: string, destkey: string, member: string, callback?: Function): any;
-    discard(callback?: Function, silent?: boolean): any;
+    smove(sourcekey: string, destkey: string, member: string, callback?: CallbackFunction): any;
+    discard(callback?: CallbackFunction, silent?: boolean): any;
     /**
      *
      *
@@ -775,6 +845,134 @@ declare class MemoryCache extends EventEmitter {
      * @returns {*}
      * @memberof MemoryCache
      */
+    /**
+     * 字符串追加操作
+     * @param key
+     * @param value
+     * @param callback
+     */
+    append(key: string, value: string, callback?: CallbackFunction): any;
+    /**
+     * 获取字符串长度
+     * @param key
+     * @param callback
+     */
+    strlen(key: string, callback?: CallbackFunction): any;
+    /**
+     * 获取子字符串
+     * @param key
+     * @param start
+     * @param end
+     * @param callback
+     */
+    getrange(key: string, start: number, end: number, callback?: CallbackFunction): any;
+    /**
+     * 设置子字符串
+     * @param key
+     * @param offset
+     * @param value
+     * @param callback
+     */
+    setrange(key: string, offset: number, value: string, callback?: CallbackFunction): any;
+    /**
+     * 批量获取
+     * @param keys
+     * @param callback
+     */
+    mget(...keys: any[]): any;
+    /**
+     * 批量设置
+     * @param keyValuePairs
+     * @param callback
+     */
+    mset(...keyValuePairs: any[]): any;
+    /**
+     * 获取所有键
+     * @param pattern
+     * @param callback
+     */
+    keys(pattern?: string, callback?: CallbackFunction): any;
+    /**
+     * 简单的模式匹配
+     * @param key
+     * @param pattern
+     */
+    /**
+     * 获取随机键
+     * @param callback
+     */
+    randomkey(callback?: CallbackFunction): any;
+    /**
+     * 重命名键
+     * @param oldKey
+     * @param newKey
+     * @param callback
+     */
+    rename(oldKey: string, newKey: string, callback?: CallbackFunction): any;
+    /**
+     * 安全重命名键（目标键不存在时才重命名）
+     * @param oldKey
+     * @param newKey
+     * @param callback
+     */
+    renamenx(oldKey: string, newKey: string, callback?: CallbackFunction): any;
+    /**
+     * 获取键的类型
+     * @param key
+     * @param callback
+     */
+    type(key: string, callback?: CallbackFunction): any;
+    /**
+     * 清空当前数据库
+     * @param callback
+     */
+    flushdb(callback?: CallbackFunction): any;
+    /**
+     * 清空所有数据库
+     * @param callback
+     */
+    flushall(callback?: CallbackFunction): any;
+    /**
+     * 获取数据库大小
+     * @param callback
+     */
+    dbsize(callback?: CallbackFunction): any;
+    /**
+     * Sorted Set基础实现 - 添加成员
+     * @param key
+     * @param score
+     * @param member
+     * @param callback
+     */
+    zadd(key: string, score: number, member: string, callback?: CallbackFunction): any;
+    /**
+     * Sorted Set - 获取成员分数
+     * @param key
+     * @param member
+     * @param callback
+     */
+    zscore(key: string, member: string, callback?: CallbackFunction): any;
+    /**
+     * Sorted Set - 获取范围内的成员
+     * @param key
+     * @param start
+     * @param stop
+     * @param callback
+     */
+    zrange(key: string, start: number, stop: number, callback?: CallbackFunction): any;
+    /**
+     * Sorted Set - 获取成员数量
+     * @param key
+     * @param callback
+     */
+    zcard(key: string, callback?: CallbackFunction): any;
+    /**
+     * Sorted Set - 删除成员
+     * @param key
+     * @param member
+     * @param callback
+     */
+    zrem(key: string, member: string, callback?: CallbackFunction): any;
 }
 
 /**
@@ -784,6 +982,11 @@ declare class MemoryCache extends EventEmitter {
  */
 declare interface MemoryCacheOptions {
     database: number;
+    maxKeys?: number;
+    maxMemory?: number;
+    evictionPolicy?: 'lru' | 'lfu' | 'random';
+    ttlCheckInterval?: number;
+    maxAge?: number;
 }
 
 declare class MemoryStore implements CacheStoreInterface {
@@ -835,6 +1038,10 @@ declare class MemoryStore implements CacheStoreInterface {
      * @memberof MemoryStore
      */
     getCompare(name: string, value: string | number): Promise<any>;
+    /**
+     * 获取缓存统计信息
+     */
+    getStats(): any;
 }
 
 declare interface MemoryStoreOpt {
@@ -842,6 +1049,10 @@ declare interface MemoryStoreOpt {
     keyPrefix?: string;
     db?: number;
     timeout?: number;
+    maxKeys?: number;
+    maxMemory?: number;
+    evictionPolicy?: 'lru' | 'lfu' | 'random';
+    ttlCheckInterval?: number;
 }
 
 /**
@@ -861,21 +1072,26 @@ declare class RedisStore implements CacheStoreInterface {
      */
     constructor(options: RedisStoreOpt);
     /**
-     * create connection by native
+     * create connection by native with improved error handling
      *
      * @param {number} [connNum=0]
      * @returns {*}  {Promise<Redis | Cluster>}
      * @memberof RedisStore
      */
     /**
-     * get connection from pool
+     * 计划重连，使用指数退避策略
+     * @private
+     * @param {number} connNum
+     */
+    /**
+     * get connection from pool with improved configuration
      *
      * @returns {*}
      * @memberof RedisStore
      */
     getConnection(): Promise<Cluster | Redis>;
     /**
-     * close connection
+     * close connection with proper cleanup
      *
      * @returns {*}
      * @memberof RedisStore