baja-lite 1.8.14 → 1.8.16

package/event.d.ts

@@ -53,7 +53,8 @@ export declare function on(event: string, listener: (...args: any[]) => void, op
 /**
  * 移除事件监听器。
  *
- * @param listener - 必须与注册时的引用完全一致
+ * - 传入 `listener` → 移除指定监听器（必须与注册时引用一致）
+ * - 不传 `listener` → 移除该事件下的全部监听器
  *
  * @example
  * ```ts
@@ -61,10 +62,15 @@ export declare function on(event: string, listener: (...args: any[]) => void, op
  *
  * const handler = (uid: string) => console.log(uid);
  * on('user-login', handler);
+ *
+ * // 移除指定监听器
  * off('user-login', handler);
+ *
+ * // 移除该事件下所有监听器
+ * off('user-login');
  * ```
  */
-export declare function off(event: string, listener: (...args: any[]) => void): void;
+export declare function off(event: string, listener?: (...args: any[]) => void): void;
 /**
  * 触发事件。
  *

package/event.js

@@ -78,23 +78,28 @@ function packPayload(args) {
  */
 export function on(event, listener, opts) {
     const bus = getEventBus();
-    if (opts?.unique && bus.listenerCount(event) > 0)
+    if (opts?.unique && bus.listenerCount(event) > 0) {
+        eventLog(`event ${event} already has listener, skip register`);
         return;
+    }
     if (opts?.once) {
         const wrapper = (...args) => {
             bus.off(event, wrapper);
             listener(...args);
         };
         bus.on(event, wrapper);
+        eventLog(`event ${event} registered as once`);
     }
     else {
         bus.on(event, listener);
+        eventLog(`event ${event} registered`);
     }
 }
 /**
  * 移除事件监听器。
  *
- * @param listener - 必须与注册时的引用完全一致
+ * - 传入 `listener` → 移除指定监听器（必须与注册时引用一致）
+ * - 不传 `listener` → 移除该事件下的全部监听器
  *
  * @example
  * ```ts
@@ -102,11 +107,24 @@ export function on(event, listener, opts) {
  *
  * const handler = (uid: string) => console.log(uid);
  * on('user-login', handler);
+ *
+ * // 移除指定监听器
  * off('user-login', handler);
+ *
+ * // 移除该事件下所有监听器
+ * off('user-login');
  * ```
  */
 export function off(event, listener) {
-    getEventBus().off(event, listener);
+    const bus = getEventBus();
+    if (listener) {
+        bus.off(event, listener);
+        eventLog(`event ${event} listener removed`);
+    }
+    else {
+        bus.removeAllListeners(event);
+        eventLog(`event ${event} all listeners removed`);
+    }
 }
 /**
  * 触发事件。
@@ -151,9 +169,14 @@ export function trigger(event, args, opts) {
             redis.publish(`${CHANNEL_PREFIX}${event}`, packPayload(a)).catch((err) => {
                 getLogger()?.warn?.(`event publish "${event}" failed: ${err?.message ?? err}`);
             });
+            eventLog(`event ${event} published to remote`);
+        }
+        else {
+            eventLog(`event ${event} can't publish because redis is not configured`);
         }
     }
     if (local) {
+        eventLog(`event ${event} emitted to local`);
         return getEventBus().emit(event, ...a);
     }
     return false;
@@ -185,7 +208,7 @@ export async function initEventSubscriber() {
     _subscriberReady = true;
     const redis = getRedis();
     if (!redis) {
-        getLogger()?.debug?.('event subscriber: Redis not configured, skip');
+        getLogger()?.error?.('event subscriber: Redis not configured, skip');
         return;
     }
     try {
@@ -208,10 +231,16 @@ export async function initEventSubscriber() {
             }
         });
         await sub.psubscribe(SUBSCRIBE_PATTERN);
-        getLogger()?.debug?.('event subscriber: Redis bridge ready');
+        getLogger()?.info?.('event subscriber: Redis bridge ready');
     }
     catch (err) {
-        getLogger()?.warn?.(`event subscriber init failed: ${err?.message ?? err}`);
+        getLogger()?.error?.(`event subscriber init failed: ${err?.message ?? err}`);
         _subscriberReady = false; // 允许重试
     }
 }
+/** @internal 输出缓存分类日志（仅当 setLogLevels 包含 'cache' 时生效） */
+function eventLog(message, ...params) {
+    const logger = globalThis[_LoggerService];
+    // pino-pretty 的 messageFormat 会根据 level=24 自动添加 [CACHE] 前缀
+    logger.debugCategory?.('event', message, ...params);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baja-lite",
-  "version": "1.8.14",
+  "version": "1.8.16",
   "description": "some util for self",
   "homepage": "https://github.com/void-soul/baja-lite",
   "repository": {