vome-core 0.3.57 → 0.3.59

package/dist/orm/entity-cache.d.ts

@@ -1,23 +1,30 @@
 /**
- * 实体行缓存：Redis 为重启后的来源，进程内再留一份，热路径不打 Redis。
- * 只有 Redis 和进程都没有时，才由调用方查库并写入。
+ * 实体行缓存：只放 Redis Hash，进程不留副本。
+ * 键 `vome:cache:{桶}`，字段是行 id，值是该行 JSON。
+ * 取一条 HGET，取多条 HMGET，取整桶 HGETALL；写入用一次 HSET。
+ * Hash 不存在才查库。空结果写占位字段，避免每次都打数据库。
  */
-type EntityCacheIo = {
-    get(key: string): Promise<string | null>;
-    set(key: string, value: string): Promise<void>;
+export type EntityCacheIo = {
+    hget(key: string, field: string): Promise<string | null>;
+    hmget(key: string, fields: string[]): Promise<Array<string | null>>;
+    hgetall(key: string): Promise<Record<string, string>>;
+    hset(key: string, fields: Record<string, string>): Promise<void>;
+    hdel(key: string, fields: string[]): Promise<void>;
     del(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
 };
 export declare function registerEntityCacheStore(store: EntityCacheIo | null): void;
-/** 全部行；Redis 没有且提供了 load 才查库 */
+/** 整桶。Hash 没有且提供了 load 才查库，并一次 HSET 写回 */
 export declare function entityCacheGet<T>(bucket: string, load?: () => Promise<T[]>): Promise<T[]>;
-/** 按 id 取一行。缓存未建立时先走 get（可查库） */
+/** 按 id 取一行。桶已存在但没有该字段则不再查库 */
 export declare function entityCacheGetById<T>(bucket: string, id: number | string, load?: () => Promise<T[]>): Promise<T | undefined>;
+/** 按一批 id 取。一次 HMGET，不拉整桶 */
+export declare function entityCacheGetByIds<T>(bucket: string, ids: Array<number | string>, load?: () => Promise<T[]>): Promise<T[]>;
 /**
  * 写入。
- * 数组：整桶替换。
- * 单条：按 id 合并进已有缓存。缓存还没有时不写残缺行，等下次 get 从库装全量。
+ * 数组：删键后一次 HSET 整桶替换。
+ * 单条：桶已存在才按 id HSET。桶还没有时不写残缺行。
  */
 export declare function entityCacheSet(bucket: string, data: unknown): Promise<void>;
-/** 删整桶，或按 id 删行 */
+/** 删整桶，或按 id 删字段 */
 export declare function entityCacheDel(bucket: string, id?: number | string | Array<number | string>): Promise<void>;
-export {};

package/dist/orm/service.d.ts

@@ -72,13 +72,14 @@ export declare abstract class BaseService {
         orderBy?: SQL[];
     } & CrudTrashQueryOptions): Promise<PageResult>;
     /**
-     * 行缓存。Redis 有则直接用，没有才执行 load 查库并写入。
-     * 省略 id 返回全部；传入 id 只取那一行。
+     * 行缓存。Redis Hash 有则直接用，没有才执行 load 查库并批量写入。
+     * 省略 id 返回整桶；传入 id 只取那一行；传入 id 数组一次取这些行。
      */
     cacheGet<T>(bucket: string, load: () => Promise<T[]>): Promise<T[]>;
     cacheGet<T>(bucket: string, id: number | string, load?: () => Promise<T[]>): Promise<T | undefined>;
+    cacheGet<T>(bucket: string, ids: Array<number | string>, load?: () => Promise<T[]>): Promise<T[]>;
     /**
-     * 写入缓存。数组整桶替换；单条对象按 id 合并更新。
+     * 写入缓存。数组整桶替换（一次批量写入）；单条对象按 id 更新。
      */
     cacheSet(bucket: string, data: unknown): Promise<void>;
     /** 删除整桶，或按 id 删除 */