node-karin 1.11.1 → 1.11.2

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 更新日志
 
+## [1.11.2](https://github.com/KarinJS/Karin/compare/core-v1.11.1...core-v1.11.2) (2025-10-07)
+
+
+### 🐛 Bug Fixes
+
+* 修复 Redis Mock 客户端缺少 setEx 等常用方法的问题 ([#543](https://github.com/KarinJS/Karin/issues/543)) ([3797b4f](https://github.com/KarinJS/Karin/commit/3797b4f7721df1428f0f5b068fb77fda017a3792))
+
 ## [1.11.1](https://github.com/KarinJS/Karin/compare/core-v1.11.0...core-v1.11.1) (2025-10-02)
 
 

package/dist/index.mjs

@@ -20497,6 +20497,83 @@ var init_mock = __esm({
           return this.#str[key].toString();
         }
       }
+      /**
+       * @description 设置键值对并指定过期时间（秒）
+       * @param key 键
+       * @param seconds 过期时间（秒）
+       * @param value 值
+       */
+      async setEx(key, seconds, value) {
+        return await this.set(key, value, { EX: seconds });
+      }
+      /**
+       * @description 设置键值对并指定过期时间（毫秒）
+       * @param key 键
+       * @param milliseconds 过期时间（毫秒）
+       * @param value 值
+       */
+      async pSetEx(key, milliseconds, value) {
+        return await this.set(key, value, { PX: milliseconds });
+      }
+      /**
+       * @description 仅当键不存在时设置键值对
+       * @param key 键
+       * @param value 值
+       */
+      async setNX(key, value) {
+        if (this.store[key] && !this.checkExpire(key)) {
+          return false;
+        }
+        await this.set(key, value, { NX: true });
+        return true;
+      }
+      /**
+       * @description 获取键值并设置过期时间
+       * @param key 键
+       * @param options 过期时间选项（EX: 秒, PX: 毫秒, EXAT: 秒级时间戳, PXAT: 毫秒级时间戳）
+       */
+      async getEx(key, options) {
+        const value = await this.get(key);
+        if (value === null) return null;
+        if (options?.PERSIST) {
+          if (this.store[key]) {
+            this.store[key].expire = -1;
+            const { type } = this.store[key];
+            const currentValue = this.getValueStringByKey(key);
+            this.#sqlite.set(key, currentValue, type, -1);
+          }
+        } else if (options?.EX !== void 0) {
+          await this.expire(key, options.EX);
+        } else if (options?.PX !== void 0) {
+          const expire = moment().add(options.PX, "milliseconds").valueOf();
+          this.store[key].expire = expire;
+          const { type } = this.store[key];
+          const currentValue = this.getValueStringByKey(key);
+          this.#sqlite.set(key, currentValue, type, expire);
+        } else if (options?.EXAT !== void 0) {
+          this.store[key].expire = options.EXAT * 1e3;
+          const { type } = this.store[key];
+          const currentValue = this.getValueStringByKey(key);
+          this.#sqlite.set(key, currentValue, type, options.EXAT * 1e3);
+        } else if (options?.PXAT !== void 0) {
+          this.store[key].expire = options.PXAT;
+          const { type } = this.store[key];
+          const currentValue = this.getValueStringByKey(key);
+          this.#sqlite.set(key, currentValue, type, options.PXAT);
+        }
+        return value;
+      }
+      /**
+       * @description 获取键值并删除键
+       * @param key 键
+       */
+      async getDel(key) {
+        const value = await this.get(key);
+        if (value !== null) {
+          await this.del(key);
+        }
+        return value;
+      }
       /**
        * @description 删除键
        * @param key 键
@@ -20527,6 +20604,53 @@ var init_mock = __esm({
         this.#sqlite.expire(key, expire);
         return 1;
       }
+      /**
+       * @description 设置键的过期时间戳（秒）
+       * @param key 键
+       * @param timestamp 过期时间戳（秒）
+       */
+      async expireAt(key, timestamp) {
+        if (!this.store[key]) return 0;
+        this.store[key].expire = timestamp * 1e3;
+        this.#sqlite.expire(key, timestamp * 1e3);
+        return 1;
+      }
+      /**
+       * @description 设置键的过期时间（毫秒）
+       * @param key 键
+       * @param milliseconds 过期时间（毫秒）
+       */
+      async pExpire(key, milliseconds) {
+        if (!this.store[key]) return 0;
+        const expire = moment().add(milliseconds, "milliseconds").valueOf();
+        this.store[key].expire = expire;
+        this.#sqlite.expire(key, expire);
+        return 1;
+      }
+      /**
+       * @description 设置键的过期时间戳（毫秒）
+       * @param key 键
+       * @param timestamp 过期时间戳（毫秒）
+       */
+      async pExpireAt(key, timestamp) {
+        if (!this.store[key]) return 0;
+        this.store[key].expire = timestamp;
+        this.#sqlite.expire(key, timestamp);
+        return 1;
+      }
+      /**
+       * @description 移除键的过期时间
+       * @param key 键
+       */
+      async persist(key) {
+        if (!this.store[key]) return 0;
+        if (this.store[key].expire === -1) return 0;
+        this.store[key].expire = -1;
+        const { type } = this.store[key];
+        const currentValue = this.getValueStringByKey(key);
+        this.#sqlite.set(key, currentValue, type, -1);
+        return 1;
+      }
       /**
        * @description 获取键的过期时间
        * @param key 键
@@ -20537,6 +20661,100 @@ var init_mock = __esm({
         if (this.checkExpire(key)) return -2;
         return moment(this.store[key].expire).diff(moment(), "seconds");
       }
+      /**
+       * @description 获取键的过期时间（毫秒）
+       * @param key 键
+       */
+      async pTTL(key) {
+        if (!this.store[key]) return -2;
+        if (this.store[key].expire === -1) return -1;
+        if (this.checkExpire(key)) return -2;
+        return moment(this.store[key].expire).diff(moment(), "milliseconds");
+      }
+      /**
+       * @description 获取字符串长度
+       * @param key 键
+       */
+      async strLen(key) {
+        if (!this.store[key]) return 0;
+        if (this.checkExpire(key)) return 0;
+        const { type } = this.store[key];
+        if (type === "str" /* STR */) {
+          return this.#str[key].length;
+        }
+        return 0;
+      }
+      /**
+       * @description 重命名键
+       * @param key 原键名
+       * @param newKey 新键名
+       */
+      async rename(key, newKey) {
+        if (!this.store[key]) throw new Error("no such key");
+        const { type, expire } = this.store[key];
+        const value = this.getValueStringByKey(key);
+        this.#del(key);
+        this.store[newKey] = { type, expire };
+        switch (type) {
+          case "str" /* STR */:
+            this.#str[newKey] = value;
+            break;
+          case "num" /* NUM */:
+            this.#num[newKey] = Number(value);
+            break;
+          case "hash" /* HASH */:
+            this.#hash[newKey] = JSON.parse(value);
+            break;
+          case "list" /* LIST */:
+            this.#list[newKey] = JSON.parse(value);
+            break;
+          case "set" /* SET */:
+            this.#set[newKey] = new Set(JSON.parse(value));
+            break;
+          case "zset" /* ZSET */:
+            this.#zset[newKey] = JSON.parse(value);
+            break;
+          case "pf" /* PF */:
+            this.#pf[newKey] = new Set(JSON.parse(value));
+            break;
+          case "bit" /* BIT */:
+            this.#bit[newKey] = Buffer.from(value, "base64");
+            break;
+        }
+        this.#sqlite.set(newKey, value, type, expire);
+        return "OK";
+      }
+      /**
+       * @description 仅当新键不存在时重命名键
+       * @param key 原键名
+       * @param newKey 新键名
+       */
+      async renameNX(key, newKey) {
+        if (!this.store[key]) return 0;
+        if (this.store[newKey] && !this.checkExpire(newKey)) return 0;
+        await this.rename(key, newKey);
+        return 1;
+      }
+      /**
+       * @description 返回数据库中键的数量
+       */
+      async dbSize() {
+        const keys = Object.keys(this.store);
+        keys.forEach((key) => this.checkExpire(key));
+        return Object.keys(this.store).length;
+      }
+      /**
+       * @description 从数据库中随机返回一个键
+       */
+      async randomKey() {
+        const keys = Object.keys(this.store);
+        if (keys.length === 0) return null;
+        keys.forEach((key) => this.checkExpire(key));
+        const validKeys = Object.keys(this.store);
+        if (validKeys.length === 0) return null;
+        const randomIndex = Math.floor(Math.random() * validKeys.length);
+        return validKeys[randomIndex];
+      }
       /**
        * @description 获取所有键
        * @param pattern 匹配规则
@@ -20584,6 +20802,40 @@ var init_mock = __esm({
         this.#sqlite.set(key, String(this.#num[key]), "num" /* NUM */, this.store[key].expire);
         return this.#num[key];
       }
+      /**
+       * @description 自增指定值
+       * @param key 键
+       * @param increment 增量
+       */
+      async incrBy(key, increment) {
+        if (!this.#num[key]) {
+          this.#num[key] = 0;
+          this.store[key] = { type: "num" /* NUM */, expire: -1 };
+        } else if (this.checkExpire(key, false)) {
+          this.store[key].expire = -1;
+          this.#num[key] = 0;
+        }
+        this.#num[key] += increment;
+        this.#sqlite.set(key, String(this.#num[key]), "num" /* NUM */, this.store[key].expire);
+        return this.#num[key];
+      }
+      /**
+       * @description 自增指定浮点值
+       * @param key 键
+       * @param increment 增量（浮点数）
+       */
+      async incrByFloat(key, increment) {
+        if (!this.#num[key]) {
+          this.#num[key] = 0;
+          this.store[key] = { type: "num" /* NUM */, expire: -1 };
+        } else if (this.checkExpire(key, false)) {
+          this.store[key].expire = -1;
+          this.#num[key] = 0;
+        }
+        this.#num[key] += increment;
+        this.#sqlite.set(key, String(this.#num[key]), "num" /* NUM */, this.store[key].expire);
+        return this.#num[key];
+      }
       /**
        * @description 自减
        * @param key 键
@@ -20600,6 +20852,23 @@ var init_mock = __esm({
         this.#sqlite.set(key, String(this.#num[key]), "num" /* NUM */, this.store[key].expire);
         return this.#num[key];
       }
+      /**
+       * @description 自减指定值
+       * @param key 键
+       * @param decrement 减量
+       */
+      async decrBy(key, decrement) {
+        if (!this.#num[key]) {
+          this.#num[key] = 0;
+          this.store[key] = { type: "num" /* NUM */, expire: -1 };
+        } else if (this.checkExpire(key, false)) {
+          this.store[key].expire = -1;
+          this.#num[key] = 0;
+        }
+        this.#num[key] -= decrement;
+        this.#sqlite.set(key, String(this.#num[key]), "num" /* NUM */, this.store[key].expire);
+        return this.#num[key];
+      }
       /**
        * @description 追加字符串
        * @param key 键
@@ -20909,46 +21178,6 @@ var init_mock = __esm({
         if (this.checkExpire(key)) return 0;
         return this.#pf[key].size;
       }
-      /**
-       * 合并多个 HyperLogLog
-       * @param destKey 目标 HyperLogLog 的键
-       * @param sourceKeys 源 HyperLogLog 的键
-       * @returns 返回 1 表示合并成功，0 表示合并失败
-       */
-      async pExpire(key, seconds) {
-        if (!this.#pf[key]) return false;
-        this.store[key].expire = moment().add(seconds, "seconds").valueOf();
-        this.#sqlite.set(key, JSON.stringify(this.#pf[key]), "pf" /* PF */, this.store[key].expire);
-        return true;
-      }
-      /**
-       * 设置 HyperLogLog 的过期时间
-       * @param key HyperLogLog 的键
-       * @param seconds 过期时间（秒）
-       * @returns 返回 1 表示设置成功，0 表示设置失败
-       */
-      async pTTL(key) {
-        if (!this.#pf[key]) return -2;
-        if (this.store[key].expire === -1) return -1;
-        if (this.checkExpire(key)) return -2;
-        const ttl = moment(this.store[key].expire).diff(moment(), "seconds");
-        this.store[key].expire = ttl;
-        this.#sqlite.set(key, JSON.stringify(this.#pf[key]), "pf" /* PF */, this.store[key].expire);
-        return ttl;
-      }
-      /**
-       * 为键设置到某个特定时间点的过期时间
-       * @param key HyperLogLog 的键
-       * @param seconds 过期时间（毫秒）
-       * @returns 返回布尔值
-       */
-      async pExpireAt(key, timestamp) {
-        if (!this.#pf[key]) return false;
-        if (this.checkExpire(key)) return false;
-        this.store[key].expire = timestamp;
-        this.#sqlite.set(key, JSON.stringify(this.#pf[key]), "pf" /* PF */, this.store[key].expire);
-        return true;
-      }
       /**
        * @description 发布消息到频道
        * @param channel 频道

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-karin",
-  "version": "1.11.1",
+  "version": "1.11.2",
   "description": "Lightweight, efficient, concise, and stable robot framework.",
   "keywords": [
     "node",