@jayfong/x-server 2.110.0 → 2.111.0

package/lib/_cjs/services/cache.js

@@ -4,24 +4,46 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 exports.__esModule = true;
 exports.CacheService = void 0;
 var _cuid = _interopRequireDefault(require("cuid"));
+var _superjson = _interopRequireDefault(require("superjson"));
 var _vtils = require("vtils");
 var _x = require("../x");
+const nativeJsonSerializer = {
+  stringify: JSON.stringify,
+  parse: JSON.parse
+};
+const superJsonSerializer = {
+  stringify: _superjson.default.stringify,
+  parse: _superjson.default.parse
+};
 class CacheService {
   constructor(options) {
     this.options = options;
     this.serviceName = 'cache';
     this.prefix = void 0;
+    this.hasMemoryCache = false;
+    this.hasMemoryCacheOnly = false;
     this.memoryCache = void 0;
+    this.serializer = void 0;
     this.prefix = `${_x.x.appId}:`;
-    this.memoryCache = !options.memory ? undefined : new Map();
+    this.hasMemoryCache = !!options.memory;
+    this.hasMemoryCacheOnly = options.memory === 'only';
+    this.serializer = options.serializer == null || options.serializer === 'nativeJson' ? nativeJsonSerializer : options.serializer === 'superJson' ? superJsonSerializer : options.serializer;
+    this.memoryCache = !this.hasMemoryCache ? undefined : new Map();
   }
   toRedisKey(key) {
     return `${this.prefix}${Array.isArray(key) ? key.join('_') : String(key)}`;
   }
+  serialize(value) {
+    return this.serializer.stringify(value);
+  }
+  deserialize(value) {
+    return this.serializer.parse(value);
+  }
 
   /**
    * 设置缓存内容。对象类内容尽量避免使用，以免造成问题。
    *
+   * @memory 支持
    * @param key 键
    * @param value 值
    * @param ttlOrOptions 缓存时间或选项
@@ -35,11 +57,13 @@ class CacheService {
       // Redis 的 TTL 不能小于等于 0
       if (redisTtlMs > 0) {
         const redisKey = this.toRedisKey(key);
-        const redisValue = JSON.stringify(value);
-        await _x.x.redis.set(redisKey, redisValue,
-        // 毫秒
-        'PX', redisTtlMs);
-        if (this.options.memory) {
+        if (!this.hasMemoryCacheOnly) {
+          const redisValue = this.serialize(value);
+          await _x.x.redis.set(redisKey, redisValue,
+          // 毫秒
+          'PX', redisTtlMs);
+        }
+        if (this.hasMemoryCache) {
           this.memoryCache.set(redisKey, value);
         }
       }
@@ -50,6 +74,7 @@ class CacheService {
   /**
    * 存储值然后返回其对应的键，该键 URL 友好。
    *
+   * @memory 支持
    * @param value 值
    * @param ttl 存活时间
    */
@@ -62,20 +87,25 @@ class CacheService {
   /**
    * 获取缓存内容。
    *
+   * @memory 支持
    * @param key 键
    * @param options 选项
    * @returns 返回获取到的缓存内容
    */
   async get(key) {
     const redisKey = this.toRedisKey(key);
-    if (this.options.memory && this.memoryCache.has(redisKey)) {
-      return this.memoryCache.get(redisKey);
+    if (this.hasMemoryCache) {
+      if (this.memoryCache.has(redisKey)) {
+        return this.memoryCache.get(redisKey);
+      } else if (this.hasMemoryCacheOnly) {
+        return null;
+      }
     }
     const gotValue = await _x.x.redis.get(redisKey);
     if (gotValue) {
       try {
-        const parsedValue = JSON.parse(gotValue);
-        if (this.options.memory) {
+        const parsedValue = this.deserialize(gotValue);
+        if (this.hasMemoryCache) {
           this.memoryCache.set(redisKey, parsedValue);
         }
         return parsedValue;
@@ -87,17 +117,47 @@ class CacheService {
   /**
    * 获取多个缓存内容。
    *
+   * @memory 支持
    * @param keys 键
    * @returns 返回获取到的缓存内容
    */
   async getMany(...keys) {
     const redisKeys = keys.map(key => this.toRedisKey(key));
     if (!redisKeys.length) return [];
+    if (this.hasMemoryCacheOnly) {
+      return redisKeys.map(redisKey => this.memoryCache.has(redisKey) ? this.memoryCache.get(redisKey) : null);
+    }
+    if (this.hasMemoryCache) {
+      const result = new Array(keys.length).fill(null);
+      const missIndexes = [];
+      const missRedisKeys = [];
+      for (let i = 0; i < redisKeys.length; i++) {
+        if (this.memoryCache.has(redisKeys[i])) {
+          result[i] = this.memoryCache.get(redisKeys[i]);
+        } else {
+          missIndexes.push(i);
+          missRedisKeys.push(redisKeys[i]);
+        }
+      }
+      if (missRedisKeys.length) {
+        const gotValues = await _x.x.redis.mget(...missRedisKeys);
+        gotValues.forEach((value, idx) => {
+          if (value != null) {
+            try {
+              const parsed = this.deserialize(value);
+              this.memoryCache.set(missRedisKeys[idx], parsed);
+              result[missIndexes[idx]] = parsed;
+            } catch {}
+          }
+        });
+      }
+      return result;
+    }
     const gotValues = await _x.x.redis.mget(...redisKeys);
     return gotValues.map(value => {
       if (value == null) return null;
       try {
-        return JSON.parse(value);
+        return this.deserialize(value);
       } catch {
         return null;
       }
@@ -106,11 +166,16 @@ class CacheService {
 
   /**
    * 获取距离过期时间的毫秒数（未设置过期时间返回-1，键不存在返回-2）。
+   * memory=only 模式下内存缓存无 TTL 概念，始终返回-1。
    *
+   * @memory 支持
    * @param key 键
    * @returns 返回距离过期时间的毫秒数
    */
   async ttl(key) {
+    if (this.hasMemoryCacheOnly) {
+      return -1;
+    }
     const redisKey = this.toRedisKey(key);
     return _x.x.redis.pttl(redisKey);
   }
@@ -118,6 +183,7 @@ class CacheService {
   /**
    * 缓存内容。
    *
+   * @memory 支持
    * @param key 键
    * @param action 获取缓存内容的操作
    * @param ttlOrOptions 缓存时间或选项
@@ -153,17 +219,29 @@ class CacheService {
   /**
    * 自增。
    *
+   * @memory 支持
    * @param key 键
    * @param increment 增量
    */
   async increase(key, increment = 1) {
     const redisKey = this.toRedisKey(key);
-    return _x.x.redis.incrby(redisKey, increment);
+    if (this.hasMemoryCacheOnly) {
+      const current = this.memoryCache.get(redisKey) ?? 0;
+      const next = current + increment;
+      this.memoryCache.set(redisKey, next);
+      return next;
+    }
+    const result = await _x.x.redis.incrby(redisKey, increment);
+    if (this.hasMemoryCache) {
+      this.memoryCache.delete(redisKey);
+    }
+    return result;
   }
 
   /**
    * 自减。
    *
+   * @memory 支持
    * @param key 键
    * @param decrement 减量
    */
@@ -174,37 +252,63 @@ class CacheService {
   /**
    * 新增元素。
    *
+   * @memory 支持
    * @param key 键
    * @param values 元素列表
    */
   async push(key, ...values) {
     const redisKey = this.toRedisKey(key);
-    return _x.x.redis.rpush(redisKey, ...values.map(value => JSON.stringify(value)));
+    if (this.hasMemoryCacheOnly) {
+      const arr = this.memoryCache.get(redisKey) ?? [];
+      arr.push(...values);
+      this.memoryCache.set(redisKey, arr);
+      return arr.length;
+    }
+    const result = await _x.x.redis.rpush(redisKey, ...values.map(value => this.serialize(value)));
+    if (this.hasMemoryCache) {
+      this.memoryCache.delete(redisKey);
+    }
+    return result;
   }
 
   /**
    * 从头部弹出元素并返回。
    *
+   * @memory 支持
    * @param key 键
    * @param count 弹出元素个数
    */
   async shift(key, count = 1) {
     const redisKey = this.toRedisKey(key);
+    if (this.hasMemoryCacheOnly) {
+      const arr = this.memoryCache.get(redisKey) ?? [];
+      const res = arr.splice(0, count);
+      if (arr.length) {
+        this.memoryCache.set(redisKey, arr);
+      } else {
+        this.memoryCache.delete(redisKey);
+      }
+      return res;
+    }
     const res = [];
     for (let i = 0; i < count; i++) {
       const item = await _x.x.redis.lpop(redisKey);
       if (item) {
-        res.push(JSON.parse(item));
+        res.push(this.deserialize(item));
       } else {
         break;
       }
     }
+    if (this.hasMemoryCache && res.length) {
+      this.memoryCache.delete(redisKey);
+    }
     return res;
   }
 
   /**
    * 删除缓存。
    *
+   * @memory 支持
    * @param keys 键列表
    */
   async remove(...keys) {
@@ -212,42 +316,73 @@ class CacheService {
       return 0;
     }
     const redisKeys = keys.map(key => this.toRedisKey(key));
-    const count = await _x.x.redis.del(...redisKeys);
-    if (this.options.memory) {
+    let count = 0;
+    if (!this.hasMemoryCacheOnly) {
+      count = await _x.x.redis.del(...redisKeys);
+    }
+    if (this.hasMemoryCache) {
+      let deletedCount = 0;
       redisKeys.forEach(redisKey => {
-        this.memoryCache.delete(redisKey);
+        const isDeleted = this.memoryCache.delete(redisKey);
+        if (isDeleted) {
+          deletedCount++;
+        }
       });
+      if (this.hasMemoryCacheOnly) {
+        count = deletedCount;
+      }
     }
     return count;
   }
 
   /**
    * 清空全部缓存。
+   *
+   * @memory 支持
    */
   async clearAll() {
-    const keys = await _x.x.redis.keys(`${this.prefix}*`);
-    const count = keys.length ? await _x.x.redis.del(...keys) : 0;
-    if (this.options.memory) {
+    let count = 0;
+    if (!this.hasMemoryCacheOnly) {
+      const keys = await _x.x.redis.keys(`${this.prefix}*`);
+      count = keys.length ? await _x.x.redis.del(...keys) : 0;
+    }
+    if (this.hasMemoryCache) {
+      const memoryCacheSize = this.memoryCache.size;
       this.memoryCache.clear();
+      if (this.hasMemoryCacheOnly) {
+        count = memoryCacheSize;
+      }
     }
     return count;
   }
 
   /**
    * 清空指定前缀的缓存。
+   *
+   * @memory 支持
    */
   async clear(...prefixes) {
     if (!prefixes.length) {
       return 0;
     }
-    const keys = (await Promise.all(prefixes.map(prefix => _x.x.redis.keys(`${this.toRedisKey(prefix)}*`)))).flat();
-    const count = keys.length ? await _x.x.redis.del(...keys) : 0;
+    let count = 0;
+    if (!this.hasMemoryCacheOnly) {
+      const keys = (await Promise.all(prefixes.map(prefix => _x.x.redis.keys(`${this.toRedisKey(prefix)}*`)))).flat();
+      count = keys.length ? await _x.x.redis.del(...keys) : 0;
+    }
     if (this.options.memory) {
+      let deletedCount = 0;
       this.memoryCache.forEach((_v, k) => {
         if (prefixes.some(prefix => k.startsWith(this.toRedisKey(prefix)))) {
-          this.memoryCache.delete(k);
+          const isDeleted = this.memoryCache.delete(k);
+          if (isDeleted) {
+            deletedCount++;
+          }
         }
       });
+      if (this.hasMemoryCacheOnly) {
+        count = deletedCount;
+      }
     }
     return count;
   }

package/lib/_cjs/services/db_value.js

@@ -67,9 +67,9 @@ class DbValueService {
           return !value || !(0, _vtils.isPlainObject)(value) ? undefined : JSON.stringify(value);
         };
         this.options = options;
-        this.hasTransformAdd = !!options.transform?.add;
-        this.hasTransformGet = !!options.transform?.get;
-        this.hasTransformUpdate = !!options.transform?.update;
+        this.hasTransformAdd = !!options?.transform?.add;
+        this.hasTransformGet = !!options?.transform?.get;
+        this.hasTransformUpdate = !!options?.transform?.update;
       }
     };
   }

package/lib/services/cache.d.ts

@@ -1,11 +1,28 @@
 import { type MsValue } from 'vtils';
 import type { AsyncOrSync, IsEmptyArray } from 'vtils/types';
 import type { BaseService } from './base';
+export interface CacheSerializer {
+    stringify(value: unknown): string;
+    parse<T>(value: string): T;
+}
 export interface CacheServiceOptions {
     /** 默认过期时间 */
     ttl: MsValue;
-    /** 启用内存缓存，仅 get, set, remove, remember, clear, clearAll 支持 */
-    memory?: boolean;
+    /**
+     * 启用内存缓存
+     *
+     * - `true` 表示启用内存缓存
+     * - `'only'` 表示仅使用内存缓存，不使用 Redis
+     */
+    memory?: boolean | 'only';
+    /**
+     * 序列化工具
+     *
+     * - `'nativeJson'` 使用原生 JSON 进行序列化和反序列化（默认）
+     * - `'superJson'` 使用 SuperJson 进行序列化和反序列化，支持更多数据类型（比如Date、RegExp等）但性能较原生 JSON 略差
+     * - 也可直接传入自定义 `{ stringify, parse }`
+     */
+    serializer?: 'nativeJson' | 'superJson' | CacheSerializer;
 }
 type Data = {
     [K in string]: (...args: any[]) => any;
@@ -29,12 +46,18 @@ export declare class CacheService<TData extends Data = Data, TKey extends Key<TD
     options: CacheServiceOptions;
     serviceName: string;
     private prefix;
+    private hasMemoryCache;
+    private hasMemoryCacheOnly;
     private memoryCache;
+    private serializer;
     constructor(options: CacheServiceOptions);
     private toRedisKey;
+    private serialize;
+    private deserialize;
     /**
      * 设置缓存内容。对象类内容尽量避免使用，以免造成问题。
      *
+     * @memory 支持
      * @param key 键
      * @param value 值
      * @param ttlOrOptions 缓存时间或选项
@@ -44,6 +67,7 @@ export declare class CacheService<TData extends Data = Data, TKey extends Key<TD
     /**
      * 存储值然后返回其对应的键，该键 URL 友好。
      *
+     * @memory 支持
      * @param value 值
      * @param ttl 存活时间
      */
@@ -51,6 +75,7 @@ export declare class CacheService<TData extends Data = Data, TKey extends Key<TD
     /**
      * 获取缓存内容。
      *
+     * @memory 支持
      * @param key 键
      * @param options 选项
      * @returns 返回获取到的缓存内容
@@ -59,13 +84,16 @@ export declare class CacheService<TData extends Data = Data, TKey extends Key<TD
     /**
      * 获取多个缓存内容。
      *
+     * @memory 支持
      * @param keys 键
      * @returns 返回获取到的缓存内容
      */
     getMany<K extends TKeyPath, V extends Value<TData, K>>(...keys: K[]): Promise<Array<V | null>>;
     /**
      * 获取距离过期时间的毫秒数（未设置过期时间返回-1，键不存在返回-2）。
+     * memory=only 模式下内存缓存无 TTL 概念，始终返回-1。
      *
+     * @memory 支持
      * @param key 键
      * @returns 返回距离过期时间的毫秒数
      */
@@ -73,6 +101,7 @@ export declare class CacheService<TData extends Data = Data, TKey extends Key<TD
     /**
      * 缓存内容。
      *
+     * @memory 支持
      * @param key 键
      * @param action 获取缓存内容的操作
      * @param ttlOrOptions 缓存时间或选项
@@ -83,6 +112,7 @@ export declare class CacheService<TData extends Data = Data, TKey extends Key<TD
     /**
      * 自增。
      *
+     * @memory 支持
      * @param key 键
      * @param increment 增量
      */
@@ -90,6 +120,7 @@ export declare class CacheService<TData extends Data = Data, TKey extends Key<TD
     /**
      * 自减。
      *
+     * @memory 支持
      * @param key 键
      * @param decrement 减量
      */
@@ -97,6 +128,7 @@ export declare class CacheService<TData extends Data = Data, TKey extends Key<TD
     /**
      * 新增元素。
      *
+     * @memory 支持
      * @param key 键
      * @param values 元素列表
      */
@@ -104,6 +136,7 @@ export declare class CacheService<TData extends Data = Data, TKey extends Key<TD
     /**
      * 从头部弹出元素并返回。
      *
+     * @memory 支持
      * @param key 键
      * @param count 弹出元素个数
      */
@@ -111,15 +144,20 @@ export declare class CacheService<TData extends Data = Data, TKey extends Key<TD
     /**
      * 删除缓存。
      *
+     * @memory 支持
      * @param keys 键列表
      */
     remove<K extends TKeyPath>(...keys: K[]): Promise<number>;
     /**
      * 清空全部缓存。
+     *
+     * @memory 支持
      */
     clearAll(): Promise<number>;
     /**
      * 清空指定前缀的缓存。
+     *
+     * @memory 支持
      */
     clear(...prefixes: Array<TKey | TKeyPartialPath>): Promise<number>;
     /**

package/lib/services/cache.js

@@ -1,22 +1,44 @@
 import cuid from 'cuid';
+import superjson from 'superjson';
 import { ms } from 'vtils';
 import { x } from "../x";
+const nativeJsonSerializer = {
+  stringify: JSON.stringify,
+  parse: JSON.parse
+};
+const superJsonSerializer = {
+  stringify: superjson.stringify,
+  parse: superjson.parse
+};
 export class CacheService {
   constructor(options) {
     this.options = options;
     this.serviceName = 'cache';
     this.prefix = void 0;
+    this.hasMemoryCache = false;
+    this.hasMemoryCacheOnly = false;
     this.memoryCache = void 0;
+    this.serializer = void 0;
     this.prefix = `${x.appId}:`;
-    this.memoryCache = !options.memory ? undefined : new Map();
+    this.hasMemoryCache = !!options.memory;
+    this.hasMemoryCacheOnly = options.memory === 'only';
+    this.serializer = options.serializer == null || options.serializer === 'nativeJson' ? nativeJsonSerializer : options.serializer === 'superJson' ? superJsonSerializer : options.serializer;
+    this.memoryCache = !this.hasMemoryCache ? undefined : new Map();
   }
   toRedisKey(key) {
     return `${this.prefix}${Array.isArray(key) ? key.join('_') : String(key)}`;
   }
+  serialize(value) {
+    return this.serializer.stringify(value);
+  }
+  deserialize(value) {
+    return this.serializer.parse(value);
+  }
 
   /**
    * 设置缓存内容。对象类内容尽量避免使用，以免造成问题。
    *
+   * @memory 支持
    * @param key 键
    * @param value 值
    * @param ttlOrOptions 缓存时间或选项
@@ -30,11 +52,13 @@ export class CacheService {
       // Redis 的 TTL 不能小于等于 0
       if (redisTtlMs > 0) {
         const redisKey = this.toRedisKey(key);
-        const redisValue = JSON.stringify(value);
-        await x.redis.set(redisKey, redisValue,
-        // 毫秒
-        'PX', redisTtlMs);
-        if (this.options.memory) {
+        if (!this.hasMemoryCacheOnly) {
+          const redisValue = this.serialize(value);
+          await x.redis.set(redisKey, redisValue,
+          // 毫秒
+          'PX', redisTtlMs);
+        }
+        if (this.hasMemoryCache) {
           this.memoryCache.set(redisKey, value);
         }
       }
@@ -45,6 +69,7 @@ export class CacheService {
   /**
    * 存储值然后返回其对应的键，该键 URL 友好。
    *
+   * @memory 支持
    * @param value 值
    * @param ttl 存活时间
    */
@@ -57,20 +82,25 @@ export class CacheService {
   /**
    * 获取缓存内容。
    *
+   * @memory 支持
    * @param key 键
    * @param options 选项
    * @returns 返回获取到的缓存内容
    */
   async get(key) {
     const redisKey = this.toRedisKey(key);
-    if (this.options.memory && this.memoryCache.has(redisKey)) {
-      return this.memoryCache.get(redisKey);
+    if (this.hasMemoryCache) {
+      if (this.memoryCache.has(redisKey)) {
+        return this.memoryCache.get(redisKey);
+      } else if (this.hasMemoryCacheOnly) {
+        return null;
+      }
     }
     const gotValue = await x.redis.get(redisKey);
     if (gotValue) {
       try {
-        const parsedValue = JSON.parse(gotValue);
-        if (this.options.memory) {
+        const parsedValue = this.deserialize(gotValue);
+        if (this.hasMemoryCache) {
           this.memoryCache.set(redisKey, parsedValue);
         }
         return parsedValue;
@@ -82,17 +112,47 @@ export class CacheService {
   /**
    * 获取多个缓存内容。
    *
+   * @memory 支持
    * @param keys 键
    * @returns 返回获取到的缓存内容
    */
   async getMany(...keys) {
     const redisKeys = keys.map(key => this.toRedisKey(key));
     if (!redisKeys.length) return [];
+    if (this.hasMemoryCacheOnly) {
+      return redisKeys.map(redisKey => this.memoryCache.has(redisKey) ? this.memoryCache.get(redisKey) : null);
+    }
+    if (this.hasMemoryCache) {
+      const result = new Array(keys.length).fill(null);
+      const missIndexes = [];
+      const missRedisKeys = [];
+      for (let i = 0; i < redisKeys.length; i++) {
+        if (this.memoryCache.has(redisKeys[i])) {
+          result[i] = this.memoryCache.get(redisKeys[i]);
+        } else {
+          missIndexes.push(i);
+          missRedisKeys.push(redisKeys[i]);
+        }
+      }
+      if (missRedisKeys.length) {
+        const gotValues = await x.redis.mget(...missRedisKeys);
+        gotValues.forEach((value, idx) => {
+          if (value != null) {
+            try {
+              const parsed = this.deserialize(value);
+              this.memoryCache.set(missRedisKeys[idx], parsed);
+              result[missIndexes[idx]] = parsed;
+            } catch {}
+          }
+        });
+      }
+      return result;
+    }
     const gotValues = await x.redis.mget(...redisKeys);
     return gotValues.map(value => {
       if (value == null) return null;
       try {
-        return JSON.parse(value);
+        return this.deserialize(value);
       } catch {
         return null;
       }
@@ -101,11 +161,16 @@ export class CacheService {
 
   /**
    * 获取距离过期时间的毫秒数（未设置过期时间返回-1，键不存在返回-2）。
+   * memory=only 模式下内存缓存无 TTL 概念，始终返回-1。
    *
+   * @memory 支持
    * @param key 键
    * @returns 返回距离过期时间的毫秒数
    */
   async ttl(key) {
+    if (this.hasMemoryCacheOnly) {
+      return -1;
+    }
     const redisKey = this.toRedisKey(key);
     return x.redis.pttl(redisKey);
   }
@@ -113,6 +178,7 @@ export class CacheService {
   /**
    * 缓存内容。
    *
+   * @memory 支持
    * @param key 键
    * @param action 获取缓存内容的操作
    * @param ttlOrOptions 缓存时间或选项
@@ -148,17 +214,29 @@ export class CacheService {
   /**
    * 自增。
    *
+   * @memory 支持
    * @param key 键
    * @param increment 增量
    */
   async increase(key, increment = 1) {
     const redisKey = this.toRedisKey(key);
-    return x.redis.incrby(redisKey, increment);
+    if (this.hasMemoryCacheOnly) {
+      const current = this.memoryCache.get(redisKey) ?? 0;
+      const next = current + increment;
+      this.memoryCache.set(redisKey, next);
+      return next;
+    }
+    const result = await x.redis.incrby(redisKey, increment);
+    if (this.hasMemoryCache) {
+      this.memoryCache.delete(redisKey);
+    }
+    return result;
   }
 
   /**
    * 自减。
    *
+   * @memory 支持
    * @param key 键
    * @param decrement 减量
    */
@@ -169,37 +247,63 @@ export class CacheService {
   /**
    * 新增元素。
    *
+   * @memory 支持
    * @param key 键
    * @param values 元素列表
    */
   async push(key, ...values) {
     const redisKey = this.toRedisKey(key);
-    return x.redis.rpush(redisKey, ...values.map(value => JSON.stringify(value)));
+    if (this.hasMemoryCacheOnly) {
+      const arr = this.memoryCache.get(redisKey) ?? [];
+      arr.push(...values);
+      this.memoryCache.set(redisKey, arr);
+      return arr.length;
+    }
+    const result = await x.redis.rpush(redisKey, ...values.map(value => this.serialize(value)));
+    if (this.hasMemoryCache) {
+      this.memoryCache.delete(redisKey);
+    }
+    return result;
   }
 
   /**
    * 从头部弹出元素并返回。
    *
+   * @memory 支持
    * @param key 键
    * @param count 弹出元素个数
    */
   async shift(key, count = 1) {
     const redisKey = this.toRedisKey(key);
+    if (this.hasMemoryCacheOnly) {
+      const arr = this.memoryCache.get(redisKey) ?? [];
+      const res = arr.splice(0, count);
+      if (arr.length) {
+        this.memoryCache.set(redisKey, arr);
+      } else {
+        this.memoryCache.delete(redisKey);
+      }
+      return res;
+    }
     const res = [];
     for (let i = 0; i < count; i++) {
       const item = await x.redis.lpop(redisKey);
       if (item) {
-        res.push(JSON.parse(item));
+        res.push(this.deserialize(item));
       } else {
         break;
       }
     }
+    if (this.hasMemoryCache && res.length) {
+      this.memoryCache.delete(redisKey);
+    }
     return res;
   }
 
   /**
    * 删除缓存。
    *
+   * @memory 支持
    * @param keys 键列表
    */
   async remove(...keys) {
@@ -207,42 +311,73 @@ export class CacheService {
       return 0;
     }
     const redisKeys = keys.map(key => this.toRedisKey(key));
-    const count = await x.redis.del(...redisKeys);
-    if (this.options.memory) {
+    let count = 0;
+    if (!this.hasMemoryCacheOnly) {
+      count = await x.redis.del(...redisKeys);
+    }
+    if (this.hasMemoryCache) {
+      let deletedCount = 0;
       redisKeys.forEach(redisKey => {
-        this.memoryCache.delete(redisKey);
+        const isDeleted = this.memoryCache.delete(redisKey);
+        if (isDeleted) {
+          deletedCount++;
+        }
       });
+      if (this.hasMemoryCacheOnly) {
+        count = deletedCount;
+      }
     }
     return count;
   }
 
   /**
    * 清空全部缓存。
+   *
+   * @memory 支持
    */
   async clearAll() {
-    const keys = await x.redis.keys(`${this.prefix}*`);
-    const count = keys.length ? await x.redis.del(...keys) : 0;
-    if (this.options.memory) {
+    let count = 0;
+    if (!this.hasMemoryCacheOnly) {
+      const keys = await x.redis.keys(`${this.prefix}*`);
+      count = keys.length ? await x.redis.del(...keys) : 0;
+    }
+    if (this.hasMemoryCache) {
+      const memoryCacheSize = this.memoryCache.size;
       this.memoryCache.clear();
+      if (this.hasMemoryCacheOnly) {
+        count = memoryCacheSize;
+      }
     }
     return count;
   }
 
   /**
    * 清空指定前缀的缓存。
+   *
+   * @memory 支持
    */
   async clear(...prefixes) {
     if (!prefixes.length) {
       return 0;
     }
-    const keys = (await Promise.all(prefixes.map(prefix => x.redis.keys(`${this.toRedisKey(prefix)}*`)))).flat();
-    const count = keys.length ? await x.redis.del(...keys) : 0;
+    let count = 0;
+    if (!this.hasMemoryCacheOnly) {
+      const keys = (await Promise.all(prefixes.map(prefix => x.redis.keys(`${this.toRedisKey(prefix)}*`)))).flat();
+      count = keys.length ? await x.redis.del(...keys) : 0;
+    }
     if (this.options.memory) {
+      let deletedCount = 0;
       this.memoryCache.forEach((_v, k) => {
         if (prefixes.some(prefix => k.startsWith(this.toRedisKey(prefix)))) {
-          this.memoryCache.delete(k);
+          const isDeleted = this.memoryCache.delete(k);
+          if (isDeleted) {
+            deletedCount++;
+          }
         }
       });
+      if (this.hasMemoryCacheOnly) {
+        count = deletedCount;
+      }
     }
     return count;
   }

package/lib/services/db_value.d.ts

@@ -42,8 +42,8 @@ export declare class DbValueService implements BaseService {
         };
     };
     JsonObject: {
-        new <T>(options: DbValueServiceJsonObjectOptions<T>): {
-            options: DbValueServiceJsonObjectOptions<T>;
+        new <T>(options?: DbValueServiceJsonObjectOptions<T>): {
+            options?: DbValueServiceJsonObjectOptions<T>;
             hasTransformAdd: boolean;
             hasTransformGet: boolean;
             hasTransformUpdate: boolean;

package/lib/services/db_value.js

@@ -63,9 +63,9 @@ export class DbValueService {
           return !value || !isPlainObject(value) ? undefined : JSON.stringify(value);
         };
         this.options = options;
-        this.hasTransformAdd = !!options.transform?.add;
-        this.hasTransformGet = !!options.transform?.get;
-        this.hasTransformUpdate = !!options.transform?.update;
+        this.hasTransformAdd = !!options?.transform?.add;
+        this.hasTransformGet = !!options?.transform?.get;
+        this.hasTransformUpdate = !!options?.transform?.update;
       }
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jayfong/x-server",
-  "version": "2.110.0",
+  "version": "2.111.0",
   "license": "ISC",
   "sideEffects": false,
   "main": "lib/_cjs/index.js",
@@ -70,6 +70,7 @@
     "prisma": "^7.2.0",
     "randomstring": "^1.3.1",
     "select-run": "^1.1.2",
+    "superjson": "^2.2.6",
     "supports-color": "^8",
     "svg-captcha": "^1.4.0",
     "tencentcloud-sdk-nodejs-sms": "^4.0.681",