fastevent 2.1.2 → 2.1.5

package/dist/eventbus/index.d.mts

@@ -1,33 +1,49 @@
-type FastListenerExecutor = (listeners: FastListenerMeta[], message: FastEventMessage, args: FastEventListenerArgs, execute: (listener: FastEventListener, message: FastEventMessage, args: FastEventListenerArgs, catchErrors?: boolean) => Promise<any> | any) => Promise<any[]> | any[];
+type FastListenerExecutor = (listeners: FastListenerMeta[], message: TypedFastEventMessage, args: FastEventListenerArgs, execute: (listener: TypedFastEventListener, message: TypedFastEventMessage, args: FastEventListenerArgs, catchErrors?: boolean) => Promise<any> | any) => Promise<any[]> | any[];
 
-type FastListenerPipe = (listener: FastEventListener) => FastEventListener;
+type FastListenerPipe = (listener: TypedFastEventListener) => TypedFastEventListener;
 
-interface FaseEventMessageExtends {
-}
 interface FastEventMeta {
 }
-type FastEventMessage<Events extends Record<string, any> = Record<string, any>, M = any> = ({
+interface FastEventMessageExtends {
+}
+type FastEventMessage<P = any, M extends Record<string, any> = Record<string, any>, T extends string = string> = {
+    type: T;
+    payload: P;
+    meta?: M & Partial<FastEventMeta>;
+} & FastEventMessageExtends;
+type TypedFastEventMessage<Events extends Record<string, any> = Record<string, any>, M = any> = ({
     [K in keyof Events]: {
         type: Exclude<K, number | symbol>;
         payload: Events[K];
         meta: FastEventMeta & M & Record<string, any>;
     };
-}[Exclude<keyof Events, number | symbol>]) & FaseEventMessageExtends;
+}[Exclude<keyof Events, number | symbol>]) & FastEventMessageExtends;
+type TypedFastEventMessageOptional<Events extends Record<string, any> = Record<string, any>, M = any> = ({
+    [K in keyof Events]: {
+        type: Exclude<K, number | symbol>;
+        payload: Events[K];
+        meta?: DeepPartial<FastEventMeta & M & Record<string, any>>;
+    };
+}[Exclude<keyof Events, number | symbol>]) & FastEventMessageExtends;
 type FastEventEmitMessage<Events extends Record<string, any> = Record<string, any>, M = any> = ({
     [K in keyof Events]: {
         type: Exclude<K, number | symbol>;
         payload?: Events[K];
-        meta?: Partial<FastEventMeta> & M & Record<string, any>;
+        meta?: DeepPartial<FastEventMeta & M & Record<string, any>>;
     };
-}[Exclude<keyof Events, number | symbol>]) & FaseEventMessageExtends;
-type FastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: FastEventMessage<{
+}[Exclude<keyof Events, number | symbol>]) & FastEventMessageExtends;
+type TypedFastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: TypedFastEventMessage<{
     [K in T]: P;
 }, M>, args: FastEventListenerArgs<M>) => any | Promise<any>;
-type FastEventAnyListener<Events extends Record<string, any> = Record<string, any>, Meta = never, Context = any> = (this: Context, message: FastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => any | Promise<any>;
+type TypedFastEventAnyListener<Events extends Record<string, any> = Record<string, any>, Meta = never, Context = any> = (this: Context, message: TypedFastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => any | Promise<any>;
+type FastEventListeners<Events extends Record<string, any> = Record<string, any>, M = any, C = any> = ({
+    [K in keyof Events]: TypedFastEventListener<Exclude<K, number | symbol>, Events[K], M, C>;
+});
+type FastEventListener<P = any, M extends Record<string, any> = Record<string, any>, T extends string = string> = (message: FastEventMessage<P, M, T>, args: FastEventListenerArgs<M>) => any | Promise<any>;
 /**
  * [监听器函数引用，需要执行多少次，实际执行的次数(用于负载均衡时记录)]
  */
-type FastListenerMeta = [FastEventListener<any, any>, number, number];
+type FastListenerMeta = [TypedFastEventListener<any, any>, number, number];
 type FastListenerNode = {
     __listeners: FastListenerMeta[];
 } & {
@@ -63,7 +79,7 @@ type FastEventSubscriber = {
      *  scope.off(subscriber.listener) // 生效
      *
      */
-    listener: FastEventListener<any, any, any>;
+    listener: TypedFastEventListener<any, any, any>;
 };
 type FastListeners = FastListenerNode;
 type FastEventOptions<Meta = Record<string, any>, Context = never> = {
@@ -73,17 +89,17 @@ type FastEventOptions<Meta = Record<string, any>, Context = never> = {
     context: Context;
     ignoreErrors: boolean;
     meta: Meta;
-    onAddListener?: (type: string, listener: FastEventListener, options: FastEventListenOptions<Record<string, any>, Meta>) => boolean | FastEventSubscriber | void;
-    onRemoveListener?: (type: string, listener: FastEventListener) => void;
+    onAddListener?: (type: string, listener: TypedFastEventListener, options: FastEventListenOptions<Record<string, any>, Meta>) => boolean | FastEventSubscriber | void;
+    onRemoveListener?: (type: string, listener: TypedFastEventListener) => void;
     onClearListeners?: () => void;
-    onListenerError?: ((error: Error, listener: FastEventListener, message: FastEventMessage<any, Meta>, args: FastEventListenerArgs<Meta> | undefined) => void);
-    onBeforeExecuteListener?: (message: FastEventMessage<any, Meta>, args: FastEventListenerArgs<Meta>) => boolean | void | any[];
-    onAfterExecuteListener?: (message: FastEventMessage<any, Meta>, returns: any[], listeners: FastListenerNode[]) => void;
+    onListenerError?: ((error: Error, listener: TypedFastEventListener, message: TypedFastEventMessage<any, Meta>, args: FastEventListenerArgs<Meta> | undefined) => void);
+    onBeforeExecuteListener?: (message: TypedFastEventMessage<any, Meta>, args: FastEventListenerArgs<Meta>) => boolean | void | any[];
+    onAfterExecuteListener?: (message: TypedFastEventMessage<any, Meta>, returns: any[], listeners: FastListenerNode[]) => void;
     /**
      * 全局执行器
      */
     executor?: FastListenerExecutor;
-    onMessage?: FastEventListener;
+    onMessage?: TypedFastEventListener;
     expandEmitResults?: boolean;
 };
 interface FastEvents {
@@ -95,13 +111,13 @@ type ScopeEvents<T extends Record<string, any>, Prefix extends string> = PickSco
 type FastEventListenOptions<Events extends Record<string, any> = Record<string, any>, Meta = any> = {
     count?: number;
     prepend?: boolean;
-    filter?: (message: FastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => boolean;
-    off?: (message: FastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => boolean;
+    filter?: (message: TypedFastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => boolean;
+    off?: (message: TypedFastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => boolean;
     pipes?: FastListenerPipe[];
 };
 type FastEventListenerArgs<M = Record<string, any>> = {
     retain?: boolean;
-    meta?: Partial<M> & Record<string, any>;
+    meta?: DeepPartial<M> & Record<string, any>;
     abortSignal?: AbortSignal;
     /**
      *
@@ -114,7 +130,7 @@ type FastEventListenerArgs<M = Record<string, any>> = {
     /**
      * 当emit参数解析完成后的回调，用于修改emit参数
      */
-    parseArgs?: (message: FastEventMessage, args: FastEventListenerArgs) => void;
+    parseArgs?: (message: TypedFastEventMessage, args: FastEventListenerArgs) => void;
 };
 type Merge<T extends object, U extends object> = {
     [K in keyof T | keyof U]: K extends keyof U ? U[K] : K extends keyof T ? T[K] : never;
@@ -265,11 +281,11 @@ type FastEventScopeOptions<Meta = Record<string, any>, Context = never> = {
     meta: FastEventScopeMeta & FastEventMeta & Meta;
     context: Context;
     executor?: FastListenerExecutor;
-    onMessage?: FastEventListener;
+    onMessage?: TypedFastEventListener;
 };
-type FastEventScopeMeta = {
+interface FastEventScopeMeta {
     scope: string;
-};
+}
 declare class FastEventScope<Events extends Record<string, any> = Record<string, any>, Meta extends Record<string, any> = Record<string, any>, Context = never, Types extends keyof Events = keyof Events, FinalMeta extends Record<string, any> = FastEventMeta & FastEventScopeMeta & Meta> {
     __FastEventScope__: boolean;
     private _options;
@@ -277,6 +293,9 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
         events: Events;
         meta: FinalMeta;
         context: Fallback<Context, typeof this>;
+        message: TypedFastEventMessageOptional<Events, FinalMeta>;
+        listeners: FastEventListeners<Events, FinalMeta>;
+        anyListener: TypedFastEventAnyListener<Events, FinalMeta, Fallback<Context, typeof this>>;
     };
     prefix: string;
     emitter: FastEvent<Events>;
@@ -306,20 +325,20 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
     on<T extends Types = Types>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
     on<T extends string>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
     on(type: '**', options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
-    on<T extends Types = Types>(type: T, listener: FastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
-    on<T extends string>(type: T, listener: FastEventListener<string, any, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
-    on(type: '**', listener: FastEventAnyListener<Events, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    on<T extends Types = Types>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    on<T extends string>(type: T, listener: TypedFastEventListener<string, any, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    on(type: '**', listener: TypedFastEventAnyListener<Events, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
     once<T extends Types = Types>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
     once<T extends string>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
-    once<T extends Types = Types>(type: T, listener: FastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
-    once<T extends string>(type: T, listener: FastEventListener<string, any, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    once<T extends Types = Types>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    once<T extends string>(type: T, listener: TypedFastEventListener<string, any, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
     onAny(options?: Pick<FastEventListenOptions, 'prepend'>): FastEventSubscriber;
-    onAny<P = any>(listener: FastEventAnyListener<{
+    onAny<P = any>(listener: TypedFastEventAnyListener<{
         [K: string]: P;
     }, FinalMeta, Fallback<Context, typeof this>>, options?: Pick<FastEventListenOptions, 'prepend'>): FastEventSubscriber;
-    off(listener: FastEventListener<any, any, any>): void;
-    off(type: string, listener: FastEventListener<any, any, any>): void;
-    off(type: Types, listener: FastEventListener<any, any, any>): void;
+    off(listener: TypedFastEventListener<any, any, any>): void;
+    off(type: string, listener: TypedFastEventListener<any, any, any>): void;
+    off(type: Types, listener: TypedFastEventListener<any, any, any>): void;
     off(type: string): void;
     off(type: Types): void;
     offAll(): void;
@@ -334,14 +353,14 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
     }, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): R[];
     emitAsync<R = any>(type: string, payload?: any, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
     emitAsync<R = any>(type: Types, payload?: Events[Types], options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
-    emitAsync<R = any>(message: FastEventMessage<Events, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
-    waitFor<T extends Types>(type: T, timeout?: number): Promise<FastEventMessage<{
+    emitAsync<R = any>(message: TypedFastEventMessage<Events, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
+    waitFor<T extends Types>(type: T, timeout?: number): Promise<TypedFastEventMessage<{
         [key in T]: Events[T];
     }, FinalMeta>>;
-    waitFor(type: string, timeout?: number): Promise<FastEventMessage<{
+    waitFor(type: string, timeout?: number): Promise<TypedFastEventMessage<{
         [key: string]: any;
     }, FinalMeta>>;
-    waitFor<P = any>(type: string, timeout?: number): Promise<FastEventMessage<{
+    waitFor<P = any>(type: string, timeout?: number): Promise<TypedFastEventMessage<{
         [key: string]: P;
     }, FinalMeta>>;
     /**
@@ -382,7 +401,7 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
      * 当on/once/onAny未指定监听器时,此为默认监听器
      * @param message
      */
-    onMessage(message: FastEventMessage<Events, FinalMeta>, args: FastEventListenerArgs<FinalMeta>): void;
+    onMessage(message: TypedFastEventMessage<Events, FinalMeta>, args: FastEventListenerArgs<FinalMeta>): void;
 }
 
 /**
@@ -410,6 +429,9 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
         events: AllEvents;
         meta: Expand<FastEventMeta & Meta & Record<string, any>>;
         context: Expand<Fallback<Context, typeof this>>;
+        message: TypedFastEventMessageOptional<AllEvents, Expand<FastEventMeta & Meta & Record<string, any>>>;
+        listeners: FastEventListeners<AllEvents, Expand<FastEventMeta & Meta & Record<string, any>>>;
+        anyListener: TypedFastEventAnyListener<AllEvents, Expand<FastEventMeta & Meta & Record<string, any>>, Expand<Fallback<Context, typeof this>>>;
     };
     /**
      * 创建FastEvent实例
@@ -495,9 +517,9 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
     on<T extends Types = Types>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     on<T extends string>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     on(type: '**', options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    on<T extends Types = Types>(type: T, listener: FastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    on<T extends string>(type: T, listener: FastEventAnyListener<AllEvents, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    on(type: '**', listener: FastEventAnyListener<Record<string, any>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    on<T extends Types = Types>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    on<T extends string>(type: T, listener: TypedFastEventAnyListener<AllEvents, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    on(type: '**', listener: TypedFastEventAnyListener<Record<string, any>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     /**
      * 注册一次性事件监听器
      * @param type - 事件类型，支持与on方法相同的格式：
@@ -521,8 +543,8 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      */
     once<T extends Types = Types>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     once<T extends string>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    once<T extends Types = Types>(type: T, listener: FastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    once<T extends string>(type: T, listener: FastEventAnyListener<AllEvents, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    once<T extends Types = Types>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    once<T extends string>(type: T, listener: TypedFastEventAnyListener<AllEvents, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     /**
      * 注册一个监听器，用于监听所有事件
      * @param listener 事件监听器函数，可以接收任意类型的事件数据
@@ -538,7 +560,7 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * ```listener: FastEventAnyListener<AllEvents, Meta, Fallback<Context, typeof this>>): FastEventSubscriber
      */
     onAny(options?: Omit<FastEventListenOptions<AllEvents, Meta>, 'count'>): FastEventSubscriber;
-    onAny<P = any>(listener: FastEventAnyListener<Record<string, P>, Meta, Fallback<Context, typeof this>>, options?: Omit<FastEventListenOptions<AllEvents, Meta>, 'count'>): FastEventSubscriber;
+    onAny<P = any>(listener: TypedFastEventAnyListener<Record<string, P>, Meta, Fallback<Context, typeof this>>, options?: Omit<FastEventListenOptions<AllEvents, Meta>, 'count'>): FastEventSubscriber;
     /**
      *
      * 当调用on/once/onAny时如果没有指定监听器，则调用此方法
@@ -546,10 +568,10 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * 此方法供子类继承
      *
      */
-    onMessage(message: FastEventMessage<AllEvents, Meta>, args: FastEventListenerArgs<Meta>): void;
-    off(listener: FastEventListener<any, any, any>): void;
-    off(type: string, listener: FastEventListener<any, any, any>): void;
-    off(type: Types, listener: FastEventListener<any, any, any>): void;
+    onMessage(message: TypedFastEventMessage<AllEvents, Meta>, args: FastEventListenerArgs<Meta>): void;
+    off(listener: TypedFastEventListener<any, any, any>): void;
+    off(type: string, listener: TypedFastEventListener<any, any, any>): void;
+    off(type: Types, listener: TypedFastEventListener<any, any, any>): void;
     off(type: string): void;
     off(type: Types): void;
     /**
@@ -791,11 +813,11 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * console.log('服务器就绪');
      * ```
      */
-    waitFor<T extends Types>(type: T, timeout?: number): Promise<FastEventMessage<{
+    waitFor<T extends Types>(type: T, timeout?: number): Promise<TypedFastEventMessage<{
         [key in T]: AllEvents[T];
     }, Meta>>;
-    waitFor(type: string, timeout?: number): Promise<FastEventMessage<AllEvents, Meta>>;
-    waitFor<P = any>(type: string, timeout?: number): Promise<FastEventMessage<{
+    waitFor(type: string, timeout?: number): Promise<TypedFastEventMessage<AllEvents, Meta>>;
+    waitFor<P = any>(type: string, timeout?: number): Promise<TypedFastEventMessage<{
         [key: string]: P;
     }, Meta>>;
     /**
@@ -1020,4 +1042,4 @@ declare const FastEventDirectives: {
     clearRetain: symbol;
 };
 
-export { AbortError, BroadcastEvent, CancelError, type ChangeFieldType, type DeepPartial, type Dict, type Expand, type Fallback, type FaseEventMessageExtends, FastEvent, type FastEventAnyListener, FastEventBus, type FastEventBusEventTypes, type FastEventBusEvents, type FastEventBusMessage, FastEventBusNode, type FastEventBusNodeIds, type FastEventBusNodeOptions, type FastEventBusNodes, type FastEventBusOptions, FastEventDirectives, type FastEventEmitMessage, FastEventError, type FastEventListenOptions, type FastEventListener, type FastEventListenerArgs, type FastEventMessage, type FastEventMeta, type FastEventOptions, FastEventScope, type FastEventScopeMeta, type FastEventScopeOptions, type FastEventSubscriber, type FastEvents, type FastListenerMeta, type FastListenerNode, type FastListeners, type Merge, NamespaceDelimiter, NodeDataEvent, type ObjectKeys, type OptionalItems, type Overloads, type OverrideOptions, type PickScopeEvents, QueueOverflowError, type RequiredItems, type ScopeEvents, TimeoutError, UnboundError, type Unique, __FastEventScope__, __FastEvent__ };
+export { AbortError, BroadcastEvent, CancelError, type ChangeFieldType, type DeepPartial, type Dict, type Expand, type Fallback, FastEvent, FastEventBus, type FastEventBusEventTypes, type FastEventBusEvents, type FastEventBusMessage, FastEventBusNode, type FastEventBusNodeIds, type FastEventBusNodeOptions, type FastEventBusNodes, type FastEventBusOptions, FastEventDirectives, type FastEventEmitMessage, FastEventError, type FastEventListenOptions, type FastEventListener, type FastEventListenerArgs, type FastEventListeners, type FastEventMessage, type FastEventMessageExtends, type FastEventMeta, type FastEventOptions, FastEventScope, type FastEventScopeMeta, type FastEventScopeOptions, type FastEventSubscriber, type FastEvents, type FastListenerMeta, type FastListenerNode, type FastListeners, type Merge, NamespaceDelimiter, NodeDataEvent, type ObjectKeys, type OptionalItems, type Overloads, type OverrideOptions, type PickScopeEvents, QueueOverflowError, type RequiredItems, type ScopeEvents, TimeoutError, type TypedFastEventAnyListener, type TypedFastEventListener, type TypedFastEventMessage, type TypedFastEventMessageOptional, UnboundError, type Unique, __FastEventScope__, __FastEvent__ };

package/dist/eventbus/index.d.ts

@@ -1,33 +1,49 @@
-type FastListenerExecutor = (listeners: FastListenerMeta[], message: FastEventMessage, args: FastEventListenerArgs, execute: (listener: FastEventListener, message: FastEventMessage, args: FastEventListenerArgs, catchErrors?: boolean) => Promise<any> | any) => Promise<any[]> | any[];
+type FastListenerExecutor = (listeners: FastListenerMeta[], message: TypedFastEventMessage, args: FastEventListenerArgs, execute: (listener: TypedFastEventListener, message: TypedFastEventMessage, args: FastEventListenerArgs, catchErrors?: boolean) => Promise<any> | any) => Promise<any[]> | any[];
 
-type FastListenerPipe = (listener: FastEventListener) => FastEventListener;
+type FastListenerPipe = (listener: TypedFastEventListener) => TypedFastEventListener;
 
-interface FaseEventMessageExtends {
-}
 interface FastEventMeta {
 }
-type FastEventMessage<Events extends Record<string, any> = Record<string, any>, M = any> = ({
+interface FastEventMessageExtends {
+}
+type FastEventMessage<P = any, M extends Record<string, any> = Record<string, any>, T extends string = string> = {
+    type: T;
+    payload: P;
+    meta?: M & Partial<FastEventMeta>;
+} & FastEventMessageExtends;
+type TypedFastEventMessage<Events extends Record<string, any> = Record<string, any>, M = any> = ({
     [K in keyof Events]: {
         type: Exclude<K, number | symbol>;
         payload: Events[K];
         meta: FastEventMeta & M & Record<string, any>;
     };
-}[Exclude<keyof Events, number | symbol>]) & FaseEventMessageExtends;
+}[Exclude<keyof Events, number | symbol>]) & FastEventMessageExtends;
+type TypedFastEventMessageOptional<Events extends Record<string, any> = Record<string, any>, M = any> = ({
+    [K in keyof Events]: {
+        type: Exclude<K, number | symbol>;
+        payload: Events[K];
+        meta?: DeepPartial<FastEventMeta & M & Record<string, any>>;
+    };
+}[Exclude<keyof Events, number | symbol>]) & FastEventMessageExtends;
 type FastEventEmitMessage<Events extends Record<string, any> = Record<string, any>, M = any> = ({
     [K in keyof Events]: {
         type: Exclude<K, number | symbol>;
         payload?: Events[K];
-        meta?: Partial<FastEventMeta> & M & Record<string, any>;
+        meta?: DeepPartial<FastEventMeta & M & Record<string, any>>;
     };
-}[Exclude<keyof Events, number | symbol>]) & FaseEventMessageExtends;
-type FastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: FastEventMessage<{
+}[Exclude<keyof Events, number | symbol>]) & FastEventMessageExtends;
+type TypedFastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: TypedFastEventMessage<{
     [K in T]: P;
 }, M>, args: FastEventListenerArgs<M>) => any | Promise<any>;
-type FastEventAnyListener<Events extends Record<string, any> = Record<string, any>, Meta = never, Context = any> = (this: Context, message: FastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => any | Promise<any>;
+type TypedFastEventAnyListener<Events extends Record<string, any> = Record<string, any>, Meta = never, Context = any> = (this: Context, message: TypedFastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => any | Promise<any>;
+type FastEventListeners<Events extends Record<string, any> = Record<string, any>, M = any, C = any> = ({
+    [K in keyof Events]: TypedFastEventListener<Exclude<K, number | symbol>, Events[K], M, C>;
+});
+type FastEventListener<P = any, M extends Record<string, any> = Record<string, any>, T extends string = string> = (message: FastEventMessage<P, M, T>, args: FastEventListenerArgs<M>) => any | Promise<any>;
 /**
  * [监听器函数引用，需要执行多少次，实际执行的次数(用于负载均衡时记录)]
  */
-type FastListenerMeta = [FastEventListener<any, any>, number, number];
+type FastListenerMeta = [TypedFastEventListener<any, any>, number, number];
 type FastListenerNode = {
     __listeners: FastListenerMeta[];
 } & {
@@ -63,7 +79,7 @@ type FastEventSubscriber = {
      *  scope.off(subscriber.listener) // 生效
      *
      */
-    listener: FastEventListener<any, any, any>;
+    listener: TypedFastEventListener<any, any, any>;
 };
 type FastListeners = FastListenerNode;
 type FastEventOptions<Meta = Record<string, any>, Context = never> = {
@@ -73,17 +89,17 @@ type FastEventOptions<Meta = Record<string, any>, Context = never> = {
     context: Context;
     ignoreErrors: boolean;
     meta: Meta;
-    onAddListener?: (type: string, listener: FastEventListener, options: FastEventListenOptions<Record<string, any>, Meta>) => boolean | FastEventSubscriber | void;
-    onRemoveListener?: (type: string, listener: FastEventListener) => void;
+    onAddListener?: (type: string, listener: TypedFastEventListener, options: FastEventListenOptions<Record<string, any>, Meta>) => boolean | FastEventSubscriber | void;
+    onRemoveListener?: (type: string, listener: TypedFastEventListener) => void;
     onClearListeners?: () => void;
-    onListenerError?: ((error: Error, listener: FastEventListener, message: FastEventMessage<any, Meta>, args: FastEventListenerArgs<Meta> | undefined) => void);
-    onBeforeExecuteListener?: (message: FastEventMessage<any, Meta>, args: FastEventListenerArgs<Meta>) => boolean | void | any[];
-    onAfterExecuteListener?: (message: FastEventMessage<any, Meta>, returns: any[], listeners: FastListenerNode[]) => void;
+    onListenerError?: ((error: Error, listener: TypedFastEventListener, message: TypedFastEventMessage<any, Meta>, args: FastEventListenerArgs<Meta> | undefined) => void);
+    onBeforeExecuteListener?: (message: TypedFastEventMessage<any, Meta>, args: FastEventListenerArgs<Meta>) => boolean | void | any[];
+    onAfterExecuteListener?: (message: TypedFastEventMessage<any, Meta>, returns: any[], listeners: FastListenerNode[]) => void;
     /**
      * 全局执行器
      */
     executor?: FastListenerExecutor;
-    onMessage?: FastEventListener;
+    onMessage?: TypedFastEventListener;
     expandEmitResults?: boolean;
 };
 interface FastEvents {
@@ -95,13 +111,13 @@ type ScopeEvents<T extends Record<string, any>, Prefix extends string> = PickSco
 type FastEventListenOptions<Events extends Record<string, any> = Record<string, any>, Meta = any> = {
     count?: number;
     prepend?: boolean;
-    filter?: (message: FastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => boolean;
-    off?: (message: FastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => boolean;
+    filter?: (message: TypedFastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => boolean;
+    off?: (message: TypedFastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => boolean;
     pipes?: FastListenerPipe[];
 };
 type FastEventListenerArgs<M = Record<string, any>> = {
     retain?: boolean;
-    meta?: Partial<M> & Record<string, any>;
+    meta?: DeepPartial<M> & Record<string, any>;
     abortSignal?: AbortSignal;
     /**
      *
@@ -114,7 +130,7 @@ type FastEventListenerArgs<M = Record<string, any>> = {
     /**
      * 当emit参数解析完成后的回调，用于修改emit参数
      */
-    parseArgs?: (message: FastEventMessage, args: FastEventListenerArgs) => void;
+    parseArgs?: (message: TypedFastEventMessage, args: FastEventListenerArgs) => void;
 };
 type Merge<T extends object, U extends object> = {
     [K in keyof T | keyof U]: K extends keyof U ? U[K] : K extends keyof T ? T[K] : never;
@@ -265,11 +281,11 @@ type FastEventScopeOptions<Meta = Record<string, any>, Context = never> = {
     meta: FastEventScopeMeta & FastEventMeta & Meta;
     context: Context;
     executor?: FastListenerExecutor;
-    onMessage?: FastEventListener;
+    onMessage?: TypedFastEventListener;
 };
-type FastEventScopeMeta = {
+interface FastEventScopeMeta {
     scope: string;
-};
+}
 declare class FastEventScope<Events extends Record<string, any> = Record<string, any>, Meta extends Record<string, any> = Record<string, any>, Context = never, Types extends keyof Events = keyof Events, FinalMeta extends Record<string, any> = FastEventMeta & FastEventScopeMeta & Meta> {
     __FastEventScope__: boolean;
     private _options;
@@ -277,6 +293,9 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
         events: Events;
         meta: FinalMeta;
         context: Fallback<Context, typeof this>;
+        message: TypedFastEventMessageOptional<Events, FinalMeta>;
+        listeners: FastEventListeners<Events, FinalMeta>;
+        anyListener: TypedFastEventAnyListener<Events, FinalMeta, Fallback<Context, typeof this>>;
     };
     prefix: string;
     emitter: FastEvent<Events>;
@@ -306,20 +325,20 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
     on<T extends Types = Types>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
     on<T extends string>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
     on(type: '**', options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
-    on<T extends Types = Types>(type: T, listener: FastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
-    on<T extends string>(type: T, listener: FastEventListener<string, any, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
-    on(type: '**', listener: FastEventAnyListener<Events, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    on<T extends Types = Types>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    on<T extends string>(type: T, listener: TypedFastEventListener<string, any, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    on(type: '**', listener: TypedFastEventAnyListener<Events, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
     once<T extends Types = Types>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
     once<T extends string>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
-    once<T extends Types = Types>(type: T, listener: FastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
-    once<T extends string>(type: T, listener: FastEventListener<string, any, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    once<T extends Types = Types>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    once<T extends string>(type: T, listener: TypedFastEventListener<string, any, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
     onAny(options?: Pick<FastEventListenOptions, 'prepend'>): FastEventSubscriber;
-    onAny<P = any>(listener: FastEventAnyListener<{
+    onAny<P = any>(listener: TypedFastEventAnyListener<{
         [K: string]: P;
     }, FinalMeta, Fallback<Context, typeof this>>, options?: Pick<FastEventListenOptions, 'prepend'>): FastEventSubscriber;
-    off(listener: FastEventListener<any, any, any>): void;
-    off(type: string, listener: FastEventListener<any, any, any>): void;
-    off(type: Types, listener: FastEventListener<any, any, any>): void;
+    off(listener: TypedFastEventListener<any, any, any>): void;
+    off(type: string, listener: TypedFastEventListener<any, any, any>): void;
+    off(type: Types, listener: TypedFastEventListener<any, any, any>): void;
     off(type: string): void;
     off(type: Types): void;
     offAll(): void;
@@ -334,14 +353,14 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
     }, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): R[];
     emitAsync<R = any>(type: string, payload?: any, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
     emitAsync<R = any>(type: Types, payload?: Events[Types], options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
-    emitAsync<R = any>(message: FastEventMessage<Events, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
-    waitFor<T extends Types>(type: T, timeout?: number): Promise<FastEventMessage<{
+    emitAsync<R = any>(message: TypedFastEventMessage<Events, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
+    waitFor<T extends Types>(type: T, timeout?: number): Promise<TypedFastEventMessage<{
         [key in T]: Events[T];
     }, FinalMeta>>;
-    waitFor(type: string, timeout?: number): Promise<FastEventMessage<{
+    waitFor(type: string, timeout?: number): Promise<TypedFastEventMessage<{
         [key: string]: any;
     }, FinalMeta>>;
-    waitFor<P = any>(type: string, timeout?: number): Promise<FastEventMessage<{
+    waitFor<P = any>(type: string, timeout?: number): Promise<TypedFastEventMessage<{
         [key: string]: P;
     }, FinalMeta>>;
     /**
@@ -382,7 +401,7 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
      * 当on/once/onAny未指定监听器时,此为默认监听器
      * @param message
      */
-    onMessage(message: FastEventMessage<Events, FinalMeta>, args: FastEventListenerArgs<FinalMeta>): void;
+    onMessage(message: TypedFastEventMessage<Events, FinalMeta>, args: FastEventListenerArgs<FinalMeta>): void;
 }
 
 /**
@@ -410,6 +429,9 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
         events: AllEvents;
         meta: Expand<FastEventMeta & Meta & Record<string, any>>;
         context: Expand<Fallback<Context, typeof this>>;
+        message: TypedFastEventMessageOptional<AllEvents, Expand<FastEventMeta & Meta & Record<string, any>>>;
+        listeners: FastEventListeners<AllEvents, Expand<FastEventMeta & Meta & Record<string, any>>>;
+        anyListener: TypedFastEventAnyListener<AllEvents, Expand<FastEventMeta & Meta & Record<string, any>>, Expand<Fallback<Context, typeof this>>>;
     };
     /**
      * 创建FastEvent实例
@@ -495,9 +517,9 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
     on<T extends Types = Types>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     on<T extends string>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     on(type: '**', options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    on<T extends Types = Types>(type: T, listener: FastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    on<T extends string>(type: T, listener: FastEventAnyListener<AllEvents, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    on(type: '**', listener: FastEventAnyListener<Record<string, any>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    on<T extends Types = Types>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    on<T extends string>(type: T, listener: TypedFastEventAnyListener<AllEvents, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    on(type: '**', listener: TypedFastEventAnyListener<Record<string, any>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     /**
      * 注册一次性事件监听器
      * @param type - 事件类型，支持与on方法相同的格式：
@@ -521,8 +543,8 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      */
     once<T extends Types = Types>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     once<T extends string>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    once<T extends Types = Types>(type: T, listener: FastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    once<T extends string>(type: T, listener: FastEventAnyListener<AllEvents, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    once<T extends Types = Types>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    once<T extends string>(type: T, listener: TypedFastEventAnyListener<AllEvents, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     /**
      * 注册一个监听器，用于监听所有事件
      * @param listener 事件监听器函数，可以接收任意类型的事件数据
@@ -538,7 +560,7 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * ```listener: FastEventAnyListener<AllEvents, Meta, Fallback<Context, typeof this>>): FastEventSubscriber
      */
     onAny(options?: Omit<FastEventListenOptions<AllEvents, Meta>, 'count'>): FastEventSubscriber;
-    onAny<P = any>(listener: FastEventAnyListener<Record<string, P>, Meta, Fallback<Context, typeof this>>, options?: Omit<FastEventListenOptions<AllEvents, Meta>, 'count'>): FastEventSubscriber;
+    onAny<P = any>(listener: TypedFastEventAnyListener<Record<string, P>, Meta, Fallback<Context, typeof this>>, options?: Omit<FastEventListenOptions<AllEvents, Meta>, 'count'>): FastEventSubscriber;
     /**
      *
      * 当调用on/once/onAny时如果没有指定监听器，则调用此方法
@@ -546,10 +568,10 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * 此方法供子类继承
      *
      */
-    onMessage(message: FastEventMessage<AllEvents, Meta>, args: FastEventListenerArgs<Meta>): void;
-    off(listener: FastEventListener<any, any, any>): void;
-    off(type: string, listener: FastEventListener<any, any, any>): void;
-    off(type: Types, listener: FastEventListener<any, any, any>): void;
+    onMessage(message: TypedFastEventMessage<AllEvents, Meta>, args: FastEventListenerArgs<Meta>): void;
+    off(listener: TypedFastEventListener<any, any, any>): void;
+    off(type: string, listener: TypedFastEventListener<any, any, any>): void;
+    off(type: Types, listener: TypedFastEventListener<any, any, any>): void;
     off(type: string): void;
     off(type: Types): void;
     /**
@@ -791,11 +813,11 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * console.log('服务器就绪');
      * ```
      */
-    waitFor<T extends Types>(type: T, timeout?: number): Promise<FastEventMessage<{
+    waitFor<T extends Types>(type: T, timeout?: number): Promise<TypedFastEventMessage<{
         [key in T]: AllEvents[T];
     }, Meta>>;
-    waitFor(type: string, timeout?: number): Promise<FastEventMessage<AllEvents, Meta>>;
-    waitFor<P = any>(type: string, timeout?: number): Promise<FastEventMessage<{
+    waitFor(type: string, timeout?: number): Promise<TypedFastEventMessage<AllEvents, Meta>>;
+    waitFor<P = any>(type: string, timeout?: number): Promise<TypedFastEventMessage<{
         [key: string]: P;
     }, Meta>>;
     /**
@@ -1020,4 +1042,4 @@ declare const FastEventDirectives: {
     clearRetain: symbol;
 };
 
-export { AbortError, BroadcastEvent, CancelError, type ChangeFieldType, type DeepPartial, type Dict, type Expand, type Fallback, type FaseEventMessageExtends, FastEvent, type FastEventAnyListener, FastEventBus, type FastEventBusEventTypes, type FastEventBusEvents, type FastEventBusMessage, FastEventBusNode, type FastEventBusNodeIds, type FastEventBusNodeOptions, type FastEventBusNodes, type FastEventBusOptions, FastEventDirectives, type FastEventEmitMessage, FastEventError, type FastEventListenOptions, type FastEventListener, type FastEventListenerArgs, type FastEventMessage, type FastEventMeta, type FastEventOptions, FastEventScope, type FastEventScopeMeta, type FastEventScopeOptions, type FastEventSubscriber, type FastEvents, type FastListenerMeta, type FastListenerNode, type FastListeners, type Merge, NamespaceDelimiter, NodeDataEvent, type ObjectKeys, type OptionalItems, type Overloads, type OverrideOptions, type PickScopeEvents, QueueOverflowError, type RequiredItems, type ScopeEvents, TimeoutError, UnboundError, type Unique, __FastEventScope__, __FastEvent__ };
+export { AbortError, BroadcastEvent, CancelError, type ChangeFieldType, type DeepPartial, type Dict, type Expand, type Fallback, FastEvent, FastEventBus, type FastEventBusEventTypes, type FastEventBusEvents, type FastEventBusMessage, FastEventBusNode, type FastEventBusNodeIds, type FastEventBusNodeOptions, type FastEventBusNodes, type FastEventBusOptions, FastEventDirectives, type FastEventEmitMessage, FastEventError, type FastEventListenOptions, type FastEventListener, type FastEventListenerArgs, type FastEventListeners, type FastEventMessage, type FastEventMessageExtends, type FastEventMeta, type FastEventOptions, FastEventScope, type FastEventScopeMeta, type FastEventScopeOptions, type FastEventSubscriber, type FastEvents, type FastListenerMeta, type FastListenerNode, type FastListeners, type Merge, NamespaceDelimiter, NodeDataEvent, type ObjectKeys, type OptionalItems, type Overloads, type OverrideOptions, type PickScopeEvents, QueueOverflowError, type RequiredItems, type ScopeEvents, TimeoutError, type TypedFastEventAnyListener, type TypedFastEventListener, type TypedFastEventMessage, type TypedFastEventMessageOptional, UnboundError, type Unique, __FastEventScope__, __FastEvent__ };