vome-core 0.3.58 → 0.3.60

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

@@ -1,8 +1,12 @@
 /**
- * 实体行缓存：只放 Redis Hash，进程不留副本。
- * 键 `vome:cache:{桶}`，字段是行 id，值是该行 JSON。
- * 取一条 HGET，取多条 HMGET，取整桶 HGETALL；写入用一次 HSET。
- * Hash 不存在才查库。空结果写占位字段，避免每次都打数据库。
+ * 实体行缓存：进程内 Map，不写 Redis。
+ * token / 验证码等短键仍走宿主 CacheStore（Redis）。
+ * 桶已加载才按 id 读写；桶不存在才执行 load 查库。
+ * 空桶单独标记，避免每次 miss 打库。
+ */
+/**
+ * 历史：宿主曾注入 Redis Hash。现已改为进程 Map，保留导出以免半截升级报错。
+ * @deprecated 无效果，可去掉调用
  */
 export type EntityCacheIo = {
     hget(key: string, field: string): Promise<string | null>;
@@ -13,18 +17,19 @@ export type EntityCacheIo = {
     del(key: string): Promise<void>;
     exists(key: string): Promise<boolean>;
 };
-export declare function registerEntityCacheStore(store: EntityCacheIo | null): void;
-/** 整桶。Hash 没有且提供了 load 才查库，并一次 HSET 写回 */
+/** @deprecated 实体缓存已改本地 Map，忽略 store */
+export declare function registerEntityCacheStore(_store: EntityCacheIo | null): void;
+/** 整桶。未加载且提供了 load 才查库 */
 export declare function entityCacheGet<T>(bucket: string, load?: () => Promise<T[]>): Promise<T[]>;
-/** 按 id 取一行。桶已存在但没有该字段则不再查库 */
+/** 按 id 取一行。桶已存在但没有该 id 则不再查库 */
 export declare function entityCacheGetById<T>(bucket: string, id: number | string, load?: () => Promise<T[]>): Promise<T | undefined>;
-/** 按一批 id 取。一次 HMGET，不拉整桶 */
+/** 按一批 id 取，不拉无关行 */
 export declare function entityCacheGetByIds<T>(bucket: string, ids: Array<number | string>, load?: () => Promise<T[]>): Promise<T[]>;
 /**
  * 写入。
- * 数组：删键后一次 HSET 整桶替换。
- * 单条：桶已存在才按 id HSET。桶还没有时不写残缺行。
+ * 数组：整桶替换。
+ * 单条：桶已存在才按 id 合并；桶还没有时不写残缺行。
  */
 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>;

package/dist/orm/service.d.ts

@@ -72,8 +72,9 @@ export declare abstract class BaseService {
         orderBy?: SQL[];
     } & CrudTrashQueryOptions): Promise<PageResult>;
     /**
-     * 行缓存。Redis Hash 有则直接用，没有才执行 load 查库并批量写入。
+     * 行缓存（进程内 Map）。桶已加载则直接用，没有才执行 load 查库并写入。
      * 省略 id 返回整桶；传入 id 只取那一行；传入 id 数组一次取这些行。
+     * token / 验证码等仍走 Redis CacheStore，与本方法无关。
      */
     cacheGet<T>(bucket: string, load: () => Promise<T[]>): Promise<T[]>;
     cacheGet<T>(bucket: string, id: number | string, load?: () => Promise<T[]>): Promise<T | undefined>;