baja-lite 1.8.6 → 1.8.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baja-lite",
-  "version": "1.8.6",
+  "version": "1.8.8",
   "description": "some util for self",
   "homepage": "https://github.com/void-soul/baja-lite",
   "repository": {
@@ -26,12 +26,9 @@
   "scripts": {
     "dist": "node ./ci.js",
     "mysql": "bun --inspect ./src/test-mysql.ts",
-    "mysql2": "node inspect ./dist/cjs/test-mysql.js",
     "postgres": "bun --inspect ./src/test-postgresql.ts",
-    "postgres2": "node inspect ./dist/cjs/test-postgresql.js",
-    "sqlite": "node inspect ./dist/cjs/test-sqlite.js",
+    "sqlite": "bun --inspect ./src/test-sqlite.ts",
     "test": "bun --inspect ./src/test.ts",
-    "test2": "node inspect ./dist/cjs/tes.js",
     "xml": "bun --inspect ./src/test-xml.ts"
   },
   "dependencies": {
@@ -43,7 +40,7 @@
     "pino": "10.3.1",
     "pino-pretty": "13.1.3",
     "reflect-metadata": "0.2.2",
-    "sql-formatter": "15.8.1",
+    "sql-formatter": "15.8.2",
     "sqlstring": "2.3.3",
     "tslib": "2.8.1"
   },

package/sql.d.ts

@@ -2093,9 +2093,6 @@ declare class StreamQuery<T extends object> {
  ```
  */
 export declare function getRedisDB<T = any>(db?: string): T;
-/**
- redlock
- */
 export declare function GetRedisLock(key: string, lockMaxActive?: number): Promise<boolean>;
 /** 对FN加锁、缓存执行 */
 export declare function excuteWithLock<T>(config: {
@@ -2114,7 +2111,12 @@ export declare function excuteWithLock<T>(config: {
     /** 单个锁多少【毫秒】后自动释放?默认：60*1000MS  */
     lockMaxTime?: number;
 }, fn__: () => Promise<T>): Promise<T>;
-/** 与缓存共用时，需要在缓存之前:有缓存则返回缓存,否则加锁执行并缓存,后续队列全部返回缓存,跳过执行 */
+/**
+ * 方法加锁装饰器。
+ * 与 `MethodCache` 组合时，**不要**手工叠装饰器——`MethodCache` 内部已经实现了
+ * "先查缓存 → miss 才加锁 → 锁内二次检查 → 仍 miss 才执行" 的 single-flight 语义，
+ * 直接给方法加 `@MethodCache` 即可。`@MethodLock` 单独使用时仅做并发互斥，不感知缓存。
+ */
 export declare function MethodLock<T = any>(config: {
     /** 返回缓存key,参数=方法的参数[注意：必须和主方法的参数数量、完全一致，同时会追加一个当前用户对象]+当前用户对象，可以用来清空缓存。 */
     key: ((this: T, ...args: any[]) => string) | string;
@@ -2135,7 +2137,8 @@ export declare function MethodLock<T = any>(config: {
 export declare function clearMethodCache(key: string): Promise<void>;
 /**
  * 执行一个方法fn，
- * 如果有缓存，则返回缓存，否则执行方法并缓存
+ * 如果有缓存，则返回缓存，否则【加锁、二次检查】后执行方法并缓存，防止缓存击穿。
+ * 可选 `cacheNullValue=true` 开启负缓存，防穿透；负缓存默认沿用 autoClearTime，可单独用 nullCacheTime 设短。
  */
 export declare function excuteWithCache<T>(config: {
     /** 返回缓存key,参数=方法的参数+当前用户对象，可以用来清空缓存。 */
@@ -2144,10 +2147,18 @@ export declare function excuteWithCache<T>(config: {
     clearKey?: string[];
     /** 自动清空缓存的时间，单位分钟 */
     autoClearTime?: number;
+    /** 是否缓存 null / undefined（负缓存防穿透），默认 false。 */
+    cacheNullValue?: boolean;
+    /** 负缓存 TTL（分钟），默认沿用 autoClearTime。 */
+    nullCacheTime?: number;
     /** 随着当前用户sesion的清空而一起清空 */
     clearWithSession?: boolean;
 }, fn: () => Promise<T>): Promise<T>;
-/** 缓存注解 */
+/**
+ * 缓存注解：先查缓存 → miss 才加锁 → 锁内再查一次 → 仍 miss 才执行原方法。
+ * 已内置 single-flight，不需要再叠 `@MethodLock`。
+ * 可选 `cacheNullValue=true` 开启负缓存，防穿透。
+ */
 export declare function MethodCache<T = any>(config: {
     /** 返回缓存key,参数=方法的参数[注意：必须和主方法的参数数量、完全一致，同时会追加一个当前用户对象]+当前用户对象，可以用来清空缓存。 */
     key: ((this: T, ...args: any[]) => string) | string;
@@ -2155,9 +2166,13 @@ export declare function MethodCache<T = any>(config: {
     clearKey?: ((this: T, ...args: any[]) => string[]) | string[];
     /** 自动清空缓存的时间，单位分钟 */
     autoClearTime?: number;
+    /** 是否缓存 null / undefined（负缓存防穿透），默认 false。 */
+    cacheNullValue?: boolean;
+    /** 负缓存 TTL（分钟），默认沿用 autoClearTime。 */
+    nullCacheTime?: number;
     /** 随着当前用户sesion的清空而一起清空 */
     clearWithSession?: boolean;
-}): (target: T, _propertyKey: string, descriptor: PropertyDescriptor) => void;
+}): (_target: T, _propertyKey: string, descriptor: PropertyDescriptor) => void;
 export declare const LOG_LEVELS: ["verbose", "debug", "info", "log", "warn", "error", "fatal"];
 export type LogLevel = (typeof LOG_LEVELS)[number];
 export interface LoggerService {