fastevent 2.1.1 → 2.1.4

package/dist/executors/index.d.mts

@@ -1,15 +1,15 @@
-interface FaseEventMessageExtends {
-}
 interface FastEventMeta {
 }
-type FastEventMessage<Events extends Record<string, any> = Record<string, any>, M = any> = ({
+interface 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;
-type FastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: FastEventMessage<{
+}[Exclude<keyof Events, number | symbol>]) & DeepPartial<FastEventMessageExtends>;
+type FastEventListener<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>;
 /**
@@ -18,7 +18,7 @@ type FastEventListener<T extends string = string, P = any, M = any, C = any> = (
 type FastListenerMeta = [FastEventListener<any, any>, number, number];
 type FastEventListenerArgs<M = Record<string, any>> = {
     retain?: boolean;
-    meta?: Partial<M> & Record<string, any>;
+    meta?: DeepPartial<M> & Record<string, any>;
     abortSignal?: AbortSignal;
     /**
      *
@@ -31,10 +31,13 @@ type FastEventListenerArgs<M = Record<string, any>> = {
     /**
      * 当emit参数解析完成后的回调，用于修改emit参数
      */
-    parseArgs?: (message: FastEventMessage, args: FastEventListenerArgs) => void;
+    parseArgs?: (message: TypedFastEventMessage, args: FastEventListenerArgs) => void;
+};
+type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
 };
 
-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: FastEventListener, message: TypedFastEventMessage, args: FastEventListenerArgs, catchErrors?: boolean) => Promise<any> | any) => Promise<any[]> | any[];
 type FastListenerExecutorBuilder<T extends Record<string, any>> = (options?: T) => FastListenerExecutor;
 
 /**
@@ -120,8 +123,8 @@ type SeriesExecutorOptions = {
      * })
      */
     onReturns?: (results: any, cur: any) => any;
-    onNext?: (index: number, previous: any, message: FastEventMessage, args: FastEventListenerArgs, results: any) => boolean;
-    onError?: 'skip' | 'abort' | 'error' | ((e: any, message: FastEventMessage, args: FastEventListenerArgs) => void | 'skip' | 'abort' | 'error');
+    onNext?: (index: number, previous: any, message: TypedFastEventMessage, args: FastEventListenerArgs, results: any) => boolean;
+    onError?: 'skip' | 'abort' | 'error' | ((e: any, message: TypedFastEventMessage, args: FastEventListenerArgs) => void | 'skip' | 'abort' | 'error');
 };
 declare const series: (options?: SeriesExecutorOptions) => FastListenerExecutor;
 

package/dist/executors/index.d.ts

@@ -1,15 +1,15 @@
-interface FaseEventMessageExtends {
-}
 interface FastEventMeta {
 }
-type FastEventMessage<Events extends Record<string, any> = Record<string, any>, M = any> = ({
+interface 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;
-type FastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: FastEventMessage<{
+}[Exclude<keyof Events, number | symbol>]) & DeepPartial<FastEventMessageExtends>;
+type FastEventListener<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>;
 /**
@@ -18,7 +18,7 @@ type FastEventListener<T extends string = string, P = any, M = any, C = any> = (
 type FastListenerMeta = [FastEventListener<any, any>, number, number];
 type FastEventListenerArgs<M = Record<string, any>> = {
     retain?: boolean;
-    meta?: Partial<M> & Record<string, any>;
+    meta?: DeepPartial<M> & Record<string, any>;
     abortSignal?: AbortSignal;
     /**
      *
@@ -31,10 +31,13 @@ type FastEventListenerArgs<M = Record<string, any>> = {
     /**
      * 当emit参数解析完成后的回调，用于修改emit参数
      */
-    parseArgs?: (message: FastEventMessage, args: FastEventListenerArgs) => void;
+    parseArgs?: (message: TypedFastEventMessage, args: FastEventListenerArgs) => void;
+};
+type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
 };
 
-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: FastEventListener, message: TypedFastEventMessage, args: FastEventListenerArgs, catchErrors?: boolean) => Promise<any> | any) => Promise<any[]> | any[];
 type FastListenerExecutorBuilder<T extends Record<string, any>> = (options?: T) => FastListenerExecutor;
 
 /**
@@ -120,8 +123,8 @@ type SeriesExecutorOptions = {
      * })
      */
     onReturns?: (results: any, cur: any) => any;
-    onNext?: (index: number, previous: any, message: FastEventMessage, args: FastEventListenerArgs, results: any) => boolean;
-    onError?: 'skip' | 'abort' | 'error' | ((e: any, message: FastEventMessage, args: FastEventListenerArgs) => void | 'skip' | 'abort' | 'error');
+    onNext?: (index: number, previous: any, message: TypedFastEventMessage, args: FastEventListenerArgs, results: any) => boolean;
+    onError?: 'skip' | 'abort' | 'error' | ((e: any, message: TypedFastEventMessage, args: FastEventListenerArgs) => void | 'skip' | 'abort' | 'error');
 };
 declare const series: (options?: SeriesExecutorOptions) => FastListenerExecutor;
 

package/dist/executors/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/executors/first.ts","../../src/executors/last.ts","../../src/executors/race.ts","../../src/executors/random.ts","../../src/executors/balance.ts","../../src/utils/isFunction.ts","../../src/utils/isString.ts","../../src/utils/expandable.ts","../../src/executors/series.ts","../../src/executors/waterfall.ts","../../src/executors/parallel.ts"],"names":["first","__name","listeners","message","args","execute","forEach","listener","last","length","race","winner","abortController","abortSignal","AbortController","signal","Promise","map","resolve","then","result","abort","random","index","Math","floor","balance","count","i","undefined","isFunction","fn","isString","str","series","options","reverse","onNext","onReturns","onError","Object","assign","_","cur","results","stepResult","item","e","behavior","waterfall","previous","payload","parallel"],"mappings":"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","file":"index.js","sourcesContent":["import { FastListenerExecutor } from \"./types\"\n\n/**\n * 执行第一个监听器的执行器函数\n * \n * @param listeners - 监听器数组，每个元素是一个包含监听器函数的元组\n * @param message - 要传递给监听器的消息对象\n * @param args - 要传递给监听器的额外参数\n * @param execute - 执行监听器的函数\n * @returns 返回一个数组，包含第一个监听器的执行结果\n */\nexport const first = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        listeners.forEach(listener => listener[2]--)\n        listeners[0][2]++\n        return [\n            execute(listeners[0][0], message, args)\n        ]\n    }\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n * 执行监听器列表中的最后一个监听器\n * @param listeners - 监听器数组\n * @param message - 事件消息\n * @param args - 事件参数\n * @param execute - 执行器函数\n * @returns 返回包含最后一个监听器执行结果的数组\n */\nexport const last = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        listeners.forEach(listener => listener[2]--)\n        listeners[listeners.length - 1][2]++\n        return [\n            execute(listeners[listeners.length - 1][0], message, args)\n        ]\n    }\n}","import { FastListenerMeta } from \"../types\"\nimport { FastListenerExecutor } from \"./types\"\n\n/**\n * 竞态执行器 - 同时执行多个监听器,只返回最快完成的结果\n * \n * @param listeners - 监听器元数据列表\n * @param message - 要处理的消息\n * @param args - 执行参数\n * @param execute - 执行函数\n * @returns 包含最快完成监听器结果的数组\n * \n * @description\n * - 只有第一个完成的监听器结果会被返回\n * - 其他未完成的监听器会被中止\n * - 如果没有提供中止信号,会自动创建一个\n * - 胜出的监听器计数会被恢复\n */\nexport const race = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        let winner: FastListenerMeta | undefined\n        let abortController: AbortController | undefined\n        if (!args || (args && !args.abortSignal)) {\n            abortController = new AbortController()\n            if (!args) args = {}\n            args.abortSignal = abortController.signal\n        }\n        const result = Promise.race(listeners.map(listener => {\n            listener[2]--\n            return Promise.resolve(execute(listener[0], message, args)).then((result: any) => {\n                if (!winner) {\n                    winner = listener\n                    listener[2]++\n                }\n                abortController?.abort()\n                return result\n            })\n        }))\n        return [\n            result\n        ]\n    }\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n * 随机执行器 - 从监听器列表中随机选择一个监听器执行\n * \n * @param listeners - 监听器列表，每个元素为 [监听器函数, 优先级, 执行次数] 的元组\n * @param message - 要处理的消息对象\n * @param args - 传递给监听器的额外参数\n * @param execute - 执行监听器的函数\n * @returns 返回包含执行结果的数组\n * \n * @remarks\n * - 随机选择一个监听器执行\n * - 所有监听器的执行次数计数减1\n * - 被选中执行的监听器执行次数加1\n */\nexport const random = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        const index = Math.floor(Math.random() * listeners.length)\n        listeners.forEach(listener => listener[2]--)\n        listeners[index][2]++\n        return [\n            execute(listeners[index][0], message, args)\n        ]\n    }\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n * 负载均衡执行器，用于在多个监听器中选择执行次数最少的进行调用\n * @param listeners 监听器列表\n * @param message 消息对象\n * @param args 参数列表\n * @param execute 执行函数\n * @returns 返回包含单个执行结果的数组\n * \n * 执行策略:\n * 1. 遍历所有监听器,找出执行次数最少的监听器\n * 2. 由于监听器执行后会自动+1,因此先对所有监听器执行次数-1,以抵消后续的+1\n * 3. 只执行选中的监听器,其他监听器不执行\n */\nexport const balance = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        // 找出listeners里面所有执行器的执行次数最少的项\n        let count: number\n        let index: number = 0\n        listeners.forEach((listener, i) => {\n            // 为什么所有监听器的执行次数均减1？\n            // 因为监听器执行完毕后会自动+1，但是在balance执行器中，只有一个会监听器会执行，因此在此先减一用来抵消后续的+1\n            listener[2]--\n            if (count === undefined || count > listener[2]) {\n                count = listener[2]\n                index = i\n            }\n        })\n        listeners[index][2]++\n        return [execute(listeners[index][0], message, args)]\n    }\n}","export function isFunction(fn: any): fn is Function {\n    return fn && typeof (fn) == \"function\"\n}","export function isString(str: any): str is string {\n    return str && typeof (str) === \"string\"\n}","/**\n * \n * \n * 用于包括输入值为可展开的对象\n * \n * \n * 用在emit事件\n * \n * emitter1 = new FastEvent()\n * emitter2 = new FastEvent()\n * \n * emitter1.on(\"xxx\",(message)=>{\n *      return emitter2.emit(message)\n * })\n * \n * emitter2.on(\"xxx\",()=>1)\n * emitter2.on(\"xxx\",()=>2)\n * \n * const results = emitter1.emit(\"xxx\")\n * // results == [[1,2]] 而不 [1,2]，因为emitter2.emit返回的是一个[]\n * \n * expandable的作用就是对emit结果进行包括，当isExpandable时，在emit内部进行展开\n * \n * \n * \n * \n * emitter1.on(\"xxx\",(message)=>{\n *      // 告诉emitter2.emit返回的是一个expandable对象\n *      // 然后在内部就展开此对象\n *      return emitter2.emit(message)\n * })\n * \n*  const results = emitter1.emit(\"xxx\")\n * // results ==  [1,2]\n * \n * 为了实现对结果数据的展开处理，在emit内部需要对监听器的执行结果进行依次检查\n * 这多了一个迭代操作，为了不影响性能，可以关闭此特性\n * options.expandEmitResults = false\n * \n * \n */\n\nexport const __expandable__ = Symbol.for('__expandable__')\n\nexport function expandable(value: any) {\n    value[__expandable__] = true\n    return value\n}\n\nexport function isExpandable(value: any) {\n    return value && value[__expandable__]\n}","import { FastEventListener, FastEventListenerArgs, FastEventMessage } from \"../types\"\nimport { isString } from \"../utils\"\nimport { isFunction } from \"../utils/isFunction\"\nimport { FastListenerExecutor } from \"./types\"\n\n\nexport type SeriesExecutorOptions = {\n    reverse?: boolean    // 反向执行监听器\n    /**\n     * 控制监听器如何返回结果\n     * \n     * 提供一个reduce函数对所有监听器返回结果进行reduce操作\n     * series({\n     *    onReturns: (result, cur)=>{\n     *      if(!result) result = []\n     *      return result.push(cur)\n     *    }\n     * })\n     */\n    onReturns?: (results: any, cur: any) => any\n    // 当调用下一个监听器前执行,返回false或触发错误均不再执行后续的监听器\n    // 可以在此修改message\n    onNext?: (index: number, previous: any, message: FastEventMessage, args: FastEventListenerArgs, results: any) => boolean\n    // 当执行监听器出错时的回调，返回false中止后续执行\n    onError?: 'skip' | 'abort' | 'error' | ((e: any, message: FastEventMessage, args: FastEventListenerArgs) => void | 'skip' | 'abort' | 'error')\n}\n\nexport const series = (options?: SeriesExecutorOptions): FastListenerExecutor => {\n    const { reverse, onNext, onReturns, onError } = Object.assign({\n        reverse: false,\n        onError: () => { },\n        onNext: () => true,\n        onReturns: (_: any, cur: any) => cur\n    }, options) as SeriesExecutorOptions\n    return async (listeners, message, args, execute) => {\n        let results: any = undefined\n        let stepResult: any = undefined\n        let index: number = 0\n        // 全部执行次数-1\n        listeners.forEach(listener => listener[2]--)\n        for (let i = 0; i < listeners.length; i++) {\n            const item = listeners[reverse ? listeners.length - 1 - i : i]\n            const listener = item[0] as FastEventListener<any, any, any>\n            try {\n                if (isFunction(onNext) && onNext(++index, stepResult, message, args, results) === false) {\n                    break\n                }\n                stepResult = await execute(listener, message, args, false)\n                if (isFunction(onReturns)) {\n                    results = onReturns(results, stepResult)\n                } else {\n                    results = stepResult\n                }\n                // 实际执行次数+1\n                item[2]++\n            } catch (e: any) {\n                try {\n                    const behavior = isString(onError) ? onError : isFunction(onError) && onError!(e, message, args)\n                    if (behavior === 'skip') {\n                        continue\n                    } else if (behavior === 'error') {\n                        results = e\n                        break\n                    } else if (behavior === 'abort') {\n                        break\n                    }\n                } catch { }\n            }\n        }\n        return results\n    }\n\n}","import { FastEventMessage } from \"../types\"\nimport { series, SeriesExecutorOptions } from \"./series\"\nimport { FastListenerExecutor } from \"./types\"\n\nexport type WaterfallExecutorOptions = Omit<SeriesExecutorOptions, 'onError' | 'onReturns' | 'onStep'>\n\n\n/**\n * 创建一个瀑布流执行器，用于按顺序执行监听器，并将前一个监听器的结果传递给下一个监听器\n * 如果出错就不再执行后续的监听器\n * \n * @param options - 执行器配置选项\n * @returns 返回一个 FastListener 执行器实例\n * \n * @remarks\n * - 当任一监听器执行出错时，会中断后续监听器的执行\n * - 每个监听器的执行结果会作为下一个监听器的 payload 参数\n */\nexport const waterfall = (options?: WaterfallExecutorOptions): FastListenerExecutor => {\n    return series(Object.assign({}, options, {\n        // 出错时不再执行后续的监听器\n        onError: 'abort',\n        // 将结果作为payload传给下一个监听器\n        onNext: (index: number, previous: any, message: FastEventMessage) => {\n            message.payload = previous\n        }\n    }) as unknown as SeriesExecutorOptions)\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n *  \n */\nexport const parallel = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        return listeners.map(listener => execute(listener[0], message, args, true))\n    }\n}"]}
+{"version":3,"sources":["../../src/executors/first.ts","../../src/executors/last.ts","../../src/executors/race.ts","../../src/executors/random.ts","../../src/executors/balance.ts","../../src/utils/isFunction.ts","../../src/utils/isString.ts","../../src/utils/expandable.ts","../../src/executors/series.ts","../../src/executors/waterfall.ts","../../src/executors/parallel.ts"],"names":["first","__name","listeners","message","args","execute","forEach","listener","last","length","race","winner","abortController","abortSignal","AbortController","signal","Promise","map","resolve","then","result","abort","random","index","Math","floor","balance","count","i","undefined","isFunction","fn","isString","str","series","options","reverse","onNext","onReturns","onError","Object","assign","_","cur","results","stepResult","item","e","behavior","waterfall","previous","payload","parallel"],"mappings":"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","file":"index.js","sourcesContent":["import { FastListenerExecutor } from \"./types\"\n\n/**\n * 执行第一个监听器的执行器函数\n * \n * @param listeners - 监听器数组，每个元素是一个包含监听器函数的元组\n * @param message - 要传递给监听器的消息对象\n * @param args - 要传递给监听器的额外参数\n * @param execute - 执行监听器的函数\n * @returns 返回一个数组，包含第一个监听器的执行结果\n */\nexport const first = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        listeners.forEach(listener => listener[2]--)\n        listeners[0][2]++\n        return [\n            execute(listeners[0][0], message, args)\n        ]\n    }\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n * 执行监听器列表中的最后一个监听器\n * @param listeners - 监听器数组\n * @param message - 事件消息\n * @param args - 事件参数\n * @param execute - 执行器函数\n * @returns 返回包含最后一个监听器执行结果的数组\n */\nexport const last = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        listeners.forEach(listener => listener[2]--)\n        listeners[listeners.length - 1][2]++\n        return [\n            execute(listeners[listeners.length - 1][0], message, args)\n        ]\n    }\n}","import { FastListenerMeta } from \"../types\"\nimport { FastListenerExecutor } from \"./types\"\n\n/**\n * 竞态执行器 - 同时执行多个监听器,只返回最快完成的结果\n * \n * @param listeners - 监听器元数据列表\n * @param message - 要处理的消息\n * @param args - 执行参数\n * @param execute - 执行函数\n * @returns 包含最快完成监听器结果的数组\n * \n * @description\n * - 只有第一个完成的监听器结果会被返回\n * - 其他未完成的监听器会被中止\n * - 如果没有提供中止信号,会自动创建一个\n * - 胜出的监听器计数会被恢复\n */\nexport const race = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        let winner: FastListenerMeta | undefined\n        let abortController: AbortController | undefined\n        if (!args || (args && !args.abortSignal)) {\n            abortController = new AbortController()\n            if (!args) args = {}\n            args.abortSignal = abortController.signal\n        }\n        const result = Promise.race(listeners.map(listener => {\n            listener[2]--\n            return Promise.resolve(execute(listener[0], message, args)).then((result: any) => {\n                if (!winner) {\n                    winner = listener\n                    listener[2]++\n                }\n                abortController?.abort()\n                return result\n            })\n        }))\n        return [\n            result\n        ]\n    }\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n * 随机执行器 - 从监听器列表中随机选择一个监听器执行\n * \n * @param listeners - 监听器列表，每个元素为 [监听器函数, 优先级, 执行次数] 的元组\n * @param message - 要处理的消息对象\n * @param args - 传递给监听器的额外参数\n * @param execute - 执行监听器的函数\n * @returns 返回包含执行结果的数组\n * \n * @remarks\n * - 随机选择一个监听器执行\n * - 所有监听器的执行次数计数减1\n * - 被选中执行的监听器执行次数加1\n */\nexport const random = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        const index = Math.floor(Math.random() * listeners.length)\n        listeners.forEach(listener => listener[2]--)\n        listeners[index][2]++\n        return [\n            execute(listeners[index][0], message, args)\n        ]\n    }\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n * 负载均衡执行器，用于在多个监听器中选择执行次数最少的进行调用\n * @param listeners 监听器列表\n * @param message 消息对象\n * @param args 参数列表\n * @param execute 执行函数\n * @returns 返回包含单个执行结果的数组\n * \n * 执行策略:\n * 1. 遍历所有监听器,找出执行次数最少的监听器\n * 2. 由于监听器执行后会自动+1,因此先对所有监听器执行次数-1,以抵消后续的+1\n * 3. 只执行选中的监听器,其他监听器不执行\n */\nexport const balance = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        // 找出listeners里面所有执行器的执行次数最少的项\n        let count: number\n        let index: number = 0\n        listeners.forEach((listener, i) => {\n            // 为什么所有监听器的执行次数均减1？\n            // 因为监听器执行完毕后会自动+1，但是在balance执行器中，只有一个会监听器会执行，因此在此先减一用来抵消后续的+1\n            listener[2]--\n            if (count === undefined || count > listener[2]) {\n                count = listener[2]\n                index = i\n            }\n        })\n        listeners[index][2]++\n        return [execute(listeners[index][0], message, args)]\n    }\n}","export function isFunction(fn: any): fn is Function {\n    return fn && typeof (fn) == \"function\"\n}","export function isString(str: any): str is string {\n    return str && typeof (str) === \"string\"\n}","/**\n * \n * \n * 用于包括输入值为可展开的对象\n * \n * \n * 用在emit事件\n * \n * emitter1 = new FastEvent()\n * emitter2 = new FastEvent()\n * \n * emitter1.on(\"xxx\",(message)=>{\n *      return emitter2.emit(message)\n * })\n * \n * emitter2.on(\"xxx\",()=>1)\n * emitter2.on(\"xxx\",()=>2)\n * \n * const results = emitter1.emit(\"xxx\")\n * // results == [[1,2]] 而不 [1,2]，因为emitter2.emit返回的是一个[]\n * \n * expandable的作用就是对emit结果进行包括，当isExpandable时，在emit内部进行展开\n * \n * \n * \n * \n * emitter1.on(\"xxx\",(message)=>{\n *      // 告诉emitter2.emit返回的是一个expandable对象\n *      // 然后在内部就展开此对象\n *      return emitter2.emit(message)\n * })\n * \n*  const results = emitter1.emit(\"xxx\")\n * // results ==  [1,2]\n * \n * 为了实现对结果数据的展开处理，在emit内部需要对监听器的执行结果进行依次检查\n * 这多了一个迭代操作，为了不影响性能，可以关闭此特性\n * options.expandEmitResults = false\n * \n * \n */\n\nexport const __expandable__ = Symbol.for('__expandable__')\n\nexport function expandable(value: any) {\n    value[__expandable__] = true\n    return value\n}\n\nexport function isExpandable(value: any) {\n    return value && value[__expandable__]\n}","import { FastEventListener, FastEventListenerArgs, TypedFastEventMessage } from \"../types\"\nimport { isString } from \"../utils\"\nimport { isFunction } from \"../utils/isFunction\"\nimport { FastListenerExecutor } from \"./types\"\n\n\nexport type SeriesExecutorOptions = {\n    reverse?: boolean    // 反向执行监听器\n    /**\n     * 控制监听器如何返回结果\n     * \n     * 提供一个reduce函数对所有监听器返回结果进行reduce操作\n     * series({\n     *    onReturns: (result, cur)=>{\n     *      if(!result) result = []\n     *      return result.push(cur)\n     *    }\n     * })\n     */\n    onReturns?: (results: any, cur: any) => any\n    // 当调用下一个监听器前执行,返回false或触发错误均不再执行后续的监听器\n    // 可以在此修改message\n    onNext?: (index: number, previous: any, message: TypedFastEventMessage, args: FastEventListenerArgs, results: any) => boolean\n    // 当执行监听器出错时的回调，返回false中止后续执行\n    onError?: 'skip' | 'abort' | 'error' | ((e: any, message: TypedFastEventMessage, args: FastEventListenerArgs) => void | 'skip' | 'abort' | 'error')\n}\n\nexport const series = (options?: SeriesExecutorOptions): FastListenerExecutor => {\n    const { reverse, onNext, onReturns, onError } = Object.assign({\n        reverse: false,\n        onError: () => { },\n        onNext: () => true,\n        onReturns: (_: any, cur: any) => cur\n    }, options) as SeriesExecutorOptions\n    return async (listeners, message, args, execute) => {\n        let results: any = undefined\n        let stepResult: any = undefined\n        let index: number = 0\n        // 全部执行次数-1\n        listeners.forEach(listener => listener[2]--)\n        for (let i = 0; i < listeners.length; i++) {\n            const item = listeners[reverse ? listeners.length - 1 - i : i]\n            const listener = item[0] as FastEventListener<any, any, any>\n            try {\n                if (isFunction(onNext) && onNext(++index, stepResult, message, args, results) === false) {\n                    break\n                }\n                stepResult = await execute(listener, message, args, false)\n                if (isFunction(onReturns)) {\n                    results = onReturns(results, stepResult)\n                } else {\n                    results = stepResult\n                }\n                // 实际执行次数+1\n                item[2]++\n            } catch (e: any) {\n                try {\n                    const behavior = isString(onError) ? onError : isFunction(onError) && onError!(e, message, args)\n                    if (behavior === 'skip') {\n                        continue\n                    } else if (behavior === 'error') {\n                        results = e\n                        break\n                    } else if (behavior === 'abort') {\n                        break\n                    }\n                } catch { }\n            }\n        }\n        return results\n    }\n\n}","import { TypedFastEventMessage } from \"../types\"\nimport { series, SeriesExecutorOptions } from \"./series\"\nimport { FastListenerExecutor } from \"./types\"\n\nexport type WaterfallExecutorOptions = Omit<SeriesExecutorOptions, 'onError' | 'onReturns' | 'onStep'>\n\n\n/**\n * 创建一个瀑布流执行器，用于按顺序执行监听器，并将前一个监听器的结果传递给下一个监听器\n * 如果出错就不再执行后续的监听器\n * \n * @param options - 执行器配置选项\n * @returns 返回一个 FastListener 执行器实例\n * \n * @remarks\n * - 当任一监听器执行出错时，会中断后续监听器的执行\n * - 每个监听器的执行结果会作为下一个监听器的 payload 参数\n */\nexport const waterfall = (options?: WaterfallExecutorOptions): FastListenerExecutor => {\n    return series(Object.assign({}, options, {\n        // 出错时不再执行后续的监听器\n        onError: 'abort',\n        // 将结果作为payload传给下一个监听器\n        onNext: (index: number, previous: any, message: TypedFastEventMessage) => {\n            message.payload = previous\n        }\n    }) as unknown as SeriesExecutorOptions)\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n *  \n */\nexport const parallel = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        return listeners.map(listener => execute(listener[0], message, args, true))\n    }\n}"]}

package/dist/executors/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/executors/first.ts","../../src/executors/last.ts","../../src/executors/race.ts","../../src/executors/random.ts","../../src/executors/balance.ts","../../src/utils/isFunction.ts","../../src/utils/isString.ts","../../src/utils/expandable.ts","../../src/executors/series.ts","../../src/executors/waterfall.ts","../../src/executors/parallel.ts"],"names":["first","__name","listeners","message","args","execute","forEach","listener","last","length","race","winner","abortController","abortSignal","AbortController","signal","Promise","map","resolve","then","result","abort","random","index","Math","floor","balance","count","i","undefined","isFunction","fn","isString","str","series","options","reverse","onNext","onReturns","onError","Object","assign","_","cur","results","stepResult","item","e","behavior","waterfall","previous","payload","parallel"],"mappings":"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","file":"index.mjs","sourcesContent":["import { FastListenerExecutor } from \"./types\"\n\n/**\n * 执行第一个监听器的执行器函数\n * \n * @param listeners - 监听器数组，每个元素是一个包含监听器函数的元组\n * @param message - 要传递给监听器的消息对象\n * @param args - 要传递给监听器的额外参数\n * @param execute - 执行监听器的函数\n * @returns 返回一个数组，包含第一个监听器的执行结果\n */\nexport const first = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        listeners.forEach(listener => listener[2]--)\n        listeners[0][2]++\n        return [\n            execute(listeners[0][0], message, args)\n        ]\n    }\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n * 执行监听器列表中的最后一个监听器\n * @param listeners - 监听器数组\n * @param message - 事件消息\n * @param args - 事件参数\n * @param execute - 执行器函数\n * @returns 返回包含最后一个监听器执行结果的数组\n */\nexport const last = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        listeners.forEach(listener => listener[2]--)\n        listeners[listeners.length - 1][2]++\n        return [\n            execute(listeners[listeners.length - 1][0], message, args)\n        ]\n    }\n}","import { FastListenerMeta } from \"../types\"\nimport { FastListenerExecutor } from \"./types\"\n\n/**\n * 竞态执行器 - 同时执行多个监听器,只返回最快完成的结果\n * \n * @param listeners - 监听器元数据列表\n * @param message - 要处理的消息\n * @param args - 执行参数\n * @param execute - 执行函数\n * @returns 包含最快完成监听器结果的数组\n * \n * @description\n * - 只有第一个完成的监听器结果会被返回\n * - 其他未完成的监听器会被中止\n * - 如果没有提供中止信号,会自动创建一个\n * - 胜出的监听器计数会被恢复\n */\nexport const race = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        let winner: FastListenerMeta | undefined\n        let abortController: AbortController | undefined\n        if (!args || (args && !args.abortSignal)) {\n            abortController = new AbortController()\n            if (!args) args = {}\n            args.abortSignal = abortController.signal\n        }\n        const result = Promise.race(listeners.map(listener => {\n            listener[2]--\n            return Promise.resolve(execute(listener[0], message, args)).then((result: any) => {\n                if (!winner) {\n                    winner = listener\n                    listener[2]++\n                }\n                abortController?.abort()\n                return result\n            })\n        }))\n        return [\n            result\n        ]\n    }\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n * 随机执行器 - 从监听器列表中随机选择一个监听器执行\n * \n * @param listeners - 监听器列表，每个元素为 [监听器函数, 优先级, 执行次数] 的元组\n * @param message - 要处理的消息对象\n * @param args - 传递给监听器的额外参数\n * @param execute - 执行监听器的函数\n * @returns 返回包含执行结果的数组\n * \n * @remarks\n * - 随机选择一个监听器执行\n * - 所有监听器的执行次数计数减1\n * - 被选中执行的监听器执行次数加1\n */\nexport const random = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        const index = Math.floor(Math.random() * listeners.length)\n        listeners.forEach(listener => listener[2]--)\n        listeners[index][2]++\n        return [\n            execute(listeners[index][0], message, args)\n        ]\n    }\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n * 负载均衡执行器，用于在多个监听器中选择执行次数最少的进行调用\n * @param listeners 监听器列表\n * @param message 消息对象\n * @param args 参数列表\n * @param execute 执行函数\n * @returns 返回包含单个执行结果的数组\n * \n * 执行策略:\n * 1. 遍历所有监听器,找出执行次数最少的监听器\n * 2. 由于监听器执行后会自动+1,因此先对所有监听器执行次数-1,以抵消后续的+1\n * 3. 只执行选中的监听器,其他监听器不执行\n */\nexport const balance = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        // 找出listeners里面所有执行器的执行次数最少的项\n        let count: number\n        let index: number = 0\n        listeners.forEach((listener, i) => {\n            // 为什么所有监听器的执行次数均减1？\n            // 因为监听器执行完毕后会自动+1，但是在balance执行器中，只有一个会监听器会执行，因此在此先减一用来抵消后续的+1\n            listener[2]--\n            if (count === undefined || count > listener[2]) {\n                count = listener[2]\n                index = i\n            }\n        })\n        listeners[index][2]++\n        return [execute(listeners[index][0], message, args)]\n    }\n}","export function isFunction(fn: any): fn is Function {\n    return fn && typeof (fn) == \"function\"\n}","export function isString(str: any): str is string {\n    return str && typeof (str) === \"string\"\n}","/**\n * \n * \n * 用于包括输入值为可展开的对象\n * \n * \n * 用在emit事件\n * \n * emitter1 = new FastEvent()\n * emitter2 = new FastEvent()\n * \n * emitter1.on(\"xxx\",(message)=>{\n *      return emitter2.emit(message)\n * })\n * \n * emitter2.on(\"xxx\",()=>1)\n * emitter2.on(\"xxx\",()=>2)\n * \n * const results = emitter1.emit(\"xxx\")\n * // results == [[1,2]] 而不 [1,2]，因为emitter2.emit返回的是一个[]\n * \n * expandable的作用就是对emit结果进行包括，当isExpandable时，在emit内部进行展开\n * \n * \n * \n * \n * emitter1.on(\"xxx\",(message)=>{\n *      // 告诉emitter2.emit返回的是一个expandable对象\n *      // 然后在内部就展开此对象\n *      return emitter2.emit(message)\n * })\n * \n*  const results = emitter1.emit(\"xxx\")\n * // results ==  [1,2]\n * \n * 为了实现对结果数据的展开处理，在emit内部需要对监听器的执行结果进行依次检查\n * 这多了一个迭代操作，为了不影响性能，可以关闭此特性\n * options.expandEmitResults = false\n * \n * \n */\n\nexport const __expandable__ = Symbol.for('__expandable__')\n\nexport function expandable(value: any) {\n    value[__expandable__] = true\n    return value\n}\n\nexport function isExpandable(value: any) {\n    return value && value[__expandable__]\n}","import { FastEventListener, FastEventListenerArgs, FastEventMessage } from \"../types\"\nimport { isString } from \"../utils\"\nimport { isFunction } from \"../utils/isFunction\"\nimport { FastListenerExecutor } from \"./types\"\n\n\nexport type SeriesExecutorOptions = {\n    reverse?: boolean    // 反向执行监听器\n    /**\n     * 控制监听器如何返回结果\n     * \n     * 提供一个reduce函数对所有监听器返回结果进行reduce操作\n     * series({\n     *    onReturns: (result, cur)=>{\n     *      if(!result) result = []\n     *      return result.push(cur)\n     *    }\n     * })\n     */\n    onReturns?: (results: any, cur: any) => any\n    // 当调用下一个监听器前执行,返回false或触发错误均不再执行后续的监听器\n    // 可以在此修改message\n    onNext?: (index: number, previous: any, message: FastEventMessage, args: FastEventListenerArgs, results: any) => boolean\n    // 当执行监听器出错时的回调，返回false中止后续执行\n    onError?: 'skip' | 'abort' | 'error' | ((e: any, message: FastEventMessage, args: FastEventListenerArgs) => void | 'skip' | 'abort' | 'error')\n}\n\nexport const series = (options?: SeriesExecutorOptions): FastListenerExecutor => {\n    const { reverse, onNext, onReturns, onError } = Object.assign({\n        reverse: false,\n        onError: () => { },\n        onNext: () => true,\n        onReturns: (_: any, cur: any) => cur\n    }, options) as SeriesExecutorOptions\n    return async (listeners, message, args, execute) => {\n        let results: any = undefined\n        let stepResult: any = undefined\n        let index: number = 0\n        // 全部执行次数-1\n        listeners.forEach(listener => listener[2]--)\n        for (let i = 0; i < listeners.length; i++) {\n            const item = listeners[reverse ? listeners.length - 1 - i : i]\n            const listener = item[0] as FastEventListener<any, any, any>\n            try {\n                if (isFunction(onNext) && onNext(++index, stepResult, message, args, results) === false) {\n                    break\n                }\n                stepResult = await execute(listener, message, args, false)\n                if (isFunction(onReturns)) {\n                    results = onReturns(results, stepResult)\n                } else {\n                    results = stepResult\n                }\n                // 实际执行次数+1\n                item[2]++\n            } catch (e: any) {\n                try {\n                    const behavior = isString(onError) ? onError : isFunction(onError) && onError!(e, message, args)\n                    if (behavior === 'skip') {\n                        continue\n                    } else if (behavior === 'error') {\n                        results = e\n                        break\n                    } else if (behavior === 'abort') {\n                        break\n                    }\n                } catch { }\n            }\n        }\n        return results\n    }\n\n}","import { FastEventMessage } from \"../types\"\nimport { series, SeriesExecutorOptions } from \"./series\"\nimport { FastListenerExecutor } from \"./types\"\n\nexport type WaterfallExecutorOptions = Omit<SeriesExecutorOptions, 'onError' | 'onReturns' | 'onStep'>\n\n\n/**\n * 创建一个瀑布流执行器，用于按顺序执行监听器，并将前一个监听器的结果传递给下一个监听器\n * 如果出错就不再执行后续的监听器\n * \n * @param options - 执行器配置选项\n * @returns 返回一个 FastListener 执行器实例\n * \n * @remarks\n * - 当任一监听器执行出错时，会中断后续监听器的执行\n * - 每个监听器的执行结果会作为下一个监听器的 payload 参数\n */\nexport const waterfall = (options?: WaterfallExecutorOptions): FastListenerExecutor => {\n    return series(Object.assign({}, options, {\n        // 出错时不再执行后续的监听器\n        onError: 'abort',\n        // 将结果作为payload传给下一个监听器\n        onNext: (index: number, previous: any, message: FastEventMessage) => {\n            message.payload = previous\n        }\n    }) as unknown as SeriesExecutorOptions)\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n *  \n */\nexport const parallel = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        return listeners.map(listener => execute(listener[0], message, args, true))\n    }\n}"]}
+{"version":3,"sources":["../../src/executors/first.ts","../../src/executors/last.ts","../../src/executors/race.ts","../../src/executors/random.ts","../../src/executors/balance.ts","../../src/utils/isFunction.ts","../../src/utils/isString.ts","../../src/utils/expandable.ts","../../src/executors/series.ts","../../src/executors/waterfall.ts","../../src/executors/parallel.ts"],"names":["first","__name","listeners","message","args","execute","forEach","listener","last","length","race","winner","abortController","abortSignal","AbortController","signal","Promise","map","resolve","then","result","abort","random","index","Math","floor","balance","count","i","undefined","isFunction","fn","isString","str","series","options","reverse","onNext","onReturns","onError","Object","assign","_","cur","results","stepResult","item","e","behavior","waterfall","previous","payload","parallel"],"mappings":"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","file":"index.mjs","sourcesContent":["import { FastListenerExecutor } from \"./types\"\n\n/**\n * 执行第一个监听器的执行器函数\n * \n * @param listeners - 监听器数组，每个元素是一个包含监听器函数的元组\n * @param message - 要传递给监听器的消息对象\n * @param args - 要传递给监听器的额外参数\n * @param execute - 执行监听器的函数\n * @returns 返回一个数组，包含第一个监听器的执行结果\n */\nexport const first = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        listeners.forEach(listener => listener[2]--)\n        listeners[0][2]++\n        return [\n            execute(listeners[0][0], message, args)\n        ]\n    }\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n * 执行监听器列表中的最后一个监听器\n * @param listeners - 监听器数组\n * @param message - 事件消息\n * @param args - 事件参数\n * @param execute - 执行器函数\n * @returns 返回包含最后一个监听器执行结果的数组\n */\nexport const last = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        listeners.forEach(listener => listener[2]--)\n        listeners[listeners.length - 1][2]++\n        return [\n            execute(listeners[listeners.length - 1][0], message, args)\n        ]\n    }\n}","import { FastListenerMeta } from \"../types\"\nimport { FastListenerExecutor } from \"./types\"\n\n/**\n * 竞态执行器 - 同时执行多个监听器,只返回最快完成的结果\n * \n * @param listeners - 监听器元数据列表\n * @param message - 要处理的消息\n * @param args - 执行参数\n * @param execute - 执行函数\n * @returns 包含最快完成监听器结果的数组\n * \n * @description\n * - 只有第一个完成的监听器结果会被返回\n * - 其他未完成的监听器会被中止\n * - 如果没有提供中止信号,会自动创建一个\n * - 胜出的监听器计数会被恢复\n */\nexport const race = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        let winner: FastListenerMeta | undefined\n        let abortController: AbortController | undefined\n        if (!args || (args && !args.abortSignal)) {\n            abortController = new AbortController()\n            if (!args) args = {}\n            args.abortSignal = abortController.signal\n        }\n        const result = Promise.race(listeners.map(listener => {\n            listener[2]--\n            return Promise.resolve(execute(listener[0], message, args)).then((result: any) => {\n                if (!winner) {\n                    winner = listener\n                    listener[2]++\n                }\n                abortController?.abort()\n                return result\n            })\n        }))\n        return [\n            result\n        ]\n    }\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n * 随机执行器 - 从监听器列表中随机选择一个监听器执行\n * \n * @param listeners - 监听器列表，每个元素为 [监听器函数, 优先级, 执行次数] 的元组\n * @param message - 要处理的消息对象\n * @param args - 传递给监听器的额外参数\n * @param execute - 执行监听器的函数\n * @returns 返回包含执行结果的数组\n * \n * @remarks\n * - 随机选择一个监听器执行\n * - 所有监听器的执行次数计数减1\n * - 被选中执行的监听器执行次数加1\n */\nexport const random = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        const index = Math.floor(Math.random() * listeners.length)\n        listeners.forEach(listener => listener[2]--)\n        listeners[index][2]++\n        return [\n            execute(listeners[index][0], message, args)\n        ]\n    }\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n * 负载均衡执行器，用于在多个监听器中选择执行次数最少的进行调用\n * @param listeners 监听器列表\n * @param message 消息对象\n * @param args 参数列表\n * @param execute 执行函数\n * @returns 返回包含单个执行结果的数组\n * \n * 执行策略:\n * 1. 遍历所有监听器,找出执行次数最少的监听器\n * 2. 由于监听器执行后会自动+1,因此先对所有监听器执行次数-1,以抵消后续的+1\n * 3. 只执行选中的监听器,其他监听器不执行\n */\nexport const balance = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        // 找出listeners里面所有执行器的执行次数最少的项\n        let count: number\n        let index: number = 0\n        listeners.forEach((listener, i) => {\n            // 为什么所有监听器的执行次数均减1？\n            // 因为监听器执行完毕后会自动+1，但是在balance执行器中，只有一个会监听器会执行，因此在此先减一用来抵消后续的+1\n            listener[2]--\n            if (count === undefined || count > listener[2]) {\n                count = listener[2]\n                index = i\n            }\n        })\n        listeners[index][2]++\n        return [execute(listeners[index][0], message, args)]\n    }\n}","export function isFunction(fn: any): fn is Function {\n    return fn && typeof (fn) == \"function\"\n}","export function isString(str: any): str is string {\n    return str && typeof (str) === \"string\"\n}","/**\n * \n * \n * 用于包括输入值为可展开的对象\n * \n * \n * 用在emit事件\n * \n * emitter1 = new FastEvent()\n * emitter2 = new FastEvent()\n * \n * emitter1.on(\"xxx\",(message)=>{\n *      return emitter2.emit(message)\n * })\n * \n * emitter2.on(\"xxx\",()=>1)\n * emitter2.on(\"xxx\",()=>2)\n * \n * const results = emitter1.emit(\"xxx\")\n * // results == [[1,2]] 而不 [1,2]，因为emitter2.emit返回的是一个[]\n * \n * expandable的作用就是对emit结果进行包括，当isExpandable时，在emit内部进行展开\n * \n * \n * \n * \n * emitter1.on(\"xxx\",(message)=>{\n *      // 告诉emitter2.emit返回的是一个expandable对象\n *      // 然后在内部就展开此对象\n *      return emitter2.emit(message)\n * })\n * \n*  const results = emitter1.emit(\"xxx\")\n * // results ==  [1,2]\n * \n * 为了实现对结果数据的展开处理，在emit内部需要对监听器的执行结果进行依次检查\n * 这多了一个迭代操作，为了不影响性能，可以关闭此特性\n * options.expandEmitResults = false\n * \n * \n */\n\nexport const __expandable__ = Symbol.for('__expandable__')\n\nexport function expandable(value: any) {\n    value[__expandable__] = true\n    return value\n}\n\nexport function isExpandable(value: any) {\n    return value && value[__expandable__]\n}","import { FastEventListener, FastEventListenerArgs, TypedFastEventMessage } from \"../types\"\nimport { isString } from \"../utils\"\nimport { isFunction } from \"../utils/isFunction\"\nimport { FastListenerExecutor } from \"./types\"\n\n\nexport type SeriesExecutorOptions = {\n    reverse?: boolean    // 反向执行监听器\n    /**\n     * 控制监听器如何返回结果\n     * \n     * 提供一个reduce函数对所有监听器返回结果进行reduce操作\n     * series({\n     *    onReturns: (result, cur)=>{\n     *      if(!result) result = []\n     *      return result.push(cur)\n     *    }\n     * })\n     */\n    onReturns?: (results: any, cur: any) => any\n    // 当调用下一个监听器前执行,返回false或触发错误均不再执行后续的监听器\n    // 可以在此修改message\n    onNext?: (index: number, previous: any, message: TypedFastEventMessage, args: FastEventListenerArgs, results: any) => boolean\n    // 当执行监听器出错时的回调，返回false中止后续执行\n    onError?: 'skip' | 'abort' | 'error' | ((e: any, message: TypedFastEventMessage, args: FastEventListenerArgs) => void | 'skip' | 'abort' | 'error')\n}\n\nexport const series = (options?: SeriesExecutorOptions): FastListenerExecutor => {\n    const { reverse, onNext, onReturns, onError } = Object.assign({\n        reverse: false,\n        onError: () => { },\n        onNext: () => true,\n        onReturns: (_: any, cur: any) => cur\n    }, options) as SeriesExecutorOptions\n    return async (listeners, message, args, execute) => {\n        let results: any = undefined\n        let stepResult: any = undefined\n        let index: number = 0\n        // 全部执行次数-1\n        listeners.forEach(listener => listener[2]--)\n        for (let i = 0; i < listeners.length; i++) {\n            const item = listeners[reverse ? listeners.length - 1 - i : i]\n            const listener = item[0] as FastEventListener<any, any, any>\n            try {\n                if (isFunction(onNext) && onNext(++index, stepResult, message, args, results) === false) {\n                    break\n                }\n                stepResult = await execute(listener, message, args, false)\n                if (isFunction(onReturns)) {\n                    results = onReturns(results, stepResult)\n                } else {\n                    results = stepResult\n                }\n                // 实际执行次数+1\n                item[2]++\n            } catch (e: any) {\n                try {\n                    const behavior = isString(onError) ? onError : isFunction(onError) && onError!(e, message, args)\n                    if (behavior === 'skip') {\n                        continue\n                    } else if (behavior === 'error') {\n                        results = e\n                        break\n                    } else if (behavior === 'abort') {\n                        break\n                    }\n                } catch { }\n            }\n        }\n        return results\n    }\n\n}","import { TypedFastEventMessage } from \"../types\"\nimport { series, SeriesExecutorOptions } from \"./series\"\nimport { FastListenerExecutor } from \"./types\"\n\nexport type WaterfallExecutorOptions = Omit<SeriesExecutorOptions, 'onError' | 'onReturns' | 'onStep'>\n\n\n/**\n * 创建一个瀑布流执行器，用于按顺序执行监听器，并将前一个监听器的结果传递给下一个监听器\n * 如果出错就不再执行后续的监听器\n * \n * @param options - 执行器配置选项\n * @returns 返回一个 FastListener 执行器实例\n * \n * @remarks\n * - 当任一监听器执行出错时，会中断后续监听器的执行\n * - 每个监听器的执行结果会作为下一个监听器的 payload 参数\n */\nexport const waterfall = (options?: WaterfallExecutorOptions): FastListenerExecutor => {\n    return series(Object.assign({}, options, {\n        // 出错时不再执行后续的监听器\n        onError: 'abort',\n        // 将结果作为payload传给下一个监听器\n        onNext: (index: number, previous: any, message: TypedFastEventMessage) => {\n            message.payload = previous\n        }\n    }) as unknown as SeriesExecutorOptions)\n}","import { FastListenerExecutor } from \"./types\"\n\n/**\n *  \n */\nexport const parallel = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        return listeners.map(listener => execute(listener[0], message, args, true))\n    }\n}"]}

package/dist/index.d.mts

@@ -1,27 +1,39 @@
 type FastListenerPipe = (listener: FastEventListener) => FastEventListener;
 
-interface FaseEventMessageExtends {
-}
 interface FastEventMeta {
 }
-type FastEventMessage<Events extends Record<string, any> = Record<string, any>, M = any> = ({
+interface FastEventMessageExtends {
+}
+type FastEventMessage = {
+    type: string;
+    payload: any;
+    meta?: Record<string, any>;
+};
+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>]) & DeepPartial<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>]) & DeepPartial<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>]) & DeepPartial<FastEventMessageExtends>;
+type FastEventListener<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 FastEventAnyListener<Events extends Record<string, any> = Record<string, any>, Meta = never, Context = any> = (this: Context, message: TypedFastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => any | Promise<any>;
 /**
  * [监听器函数引用，需要执行多少次，实际执行的次数(用于负载均衡时记录)]
  */
@@ -64,7 +76,7 @@ type FastEventSubscriber = {
     listener: FastEventListener<any, any, any>;
 };
 type FastListeners = FastListenerNode;
-type FastEventOptions<Meta = Record<string, any>, Context = any> = {
+type FastEventOptions<Meta = Record<string, any>, Context = never> = {
     id: string;
     debug: boolean;
     delimiter: string;
@@ -74,9 +86,9 @@ type FastEventOptions<Meta = Record<string, any>, Context = any> = {
     onAddListener?: (type: string, listener: FastEventListener, options: FastEventListenOptions<Record<string, any>, Meta>) => boolean | FastEventSubscriber | void;
     onRemoveListener?: (type: string, listener: FastEventListener) => 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: FastEventListener, 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;
     /**
      * 全局执行器
      */
@@ -93,13 +105,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;
     /**
      *
@@ -112,7 +124,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;
@@ -244,9 +256,9 @@ type Overloads<T> = Unique<T extends {
 ]>;
 type Dict<V = any> = Record<Exclude<string, number | symbol>, V>;
 
-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: FastEventListener, message: TypedFastEventMessage, args: FastEventListenerArgs, catchErrors?: boolean) => Promise<any> | any) => Promise<any[]> | any[];
 
-type FastEventScopeOptions<Meta = Record<string, any>, Context = any> = {
+type FastEventScopeOptions<Meta = Record<string, any>, Context = never> = {
     meta: FastEventScopeMeta & FastEventMeta & Meta;
     context: Context;
     executor?: FastListenerExecutor;
@@ -262,6 +274,7 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
         events: Events;
         meta: FinalMeta;
         context: Fallback<Context, typeof this>;
+        message: TypedFastEventMessageOptional<Events, FinalMeta>;
     };
     prefix: string;
     emitter: FastEvent<Events>;
@@ -269,6 +282,15 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
     get context(): Fallback<Context, typeof this>;
     get options(): FastEventScopeOptions<FinalMeta, Context>;
     bind(emitter: FastEvent<any>, prefix: string, options?: DeepPartial<FastEventScopeOptions<FinalMeta, Context>>): void;
+    /**
+     * 初始化选项
+     *
+     * 本方法主要供子类重载
+     *
+     * @param initial - 可选的初始字典对象
+     * @returns 返回传入的初始字典对象
+     */
+    _initOptions(initial: Dict | undefined): Dict | undefined;
     /**
      * 获取作用域监听器
      * 当启用作用域时,对原始监听器进行包装,添加作用域前缀处理逻辑
@@ -310,14 +332,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>>;
     /**
@@ -358,7 +380,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;
 }
 
 /**
@@ -386,6 +408,7 @@ 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>>>;
     };
     /**
      * 创建FastEvent实例
@@ -405,6 +428,15 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
     get meta(): Meta;
     /** 获取事件发射器的唯一标识符 */
     get id(): string;
+    /**
+     * 初始化选项
+     *
+     * 本方法主要供子类重载
+     *
+     * @param initial - 可选的初始字典对象
+     * @returns 返回传入的初始字典对象
+     */
+    _initOptions(initial?: Partial<FastEventOptions<Meta, Context>>): Partial<FastEventOptions<Meta, Context>> | undefined;
     /**
      * 添加事件监听器到事件树中
      * @param parts - 事件路径数组
@@ -513,7 +545,7 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * 此方法供子类继承
      *
      */
-    onMessage(message: FastEventMessage<AllEvents, Meta>, args: FastEventListenerArgs<Meta>): void;
+    onMessage(message: TypedFastEventMessage<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;
@@ -758,11 +790,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>>;
     /**
@@ -828,4 +860,4 @@ declare const FastEventDirectives: {
     clearRetain: symbol;
 };
 
-export { AbortError, CancelError, type ChangeFieldType, type DeepPartial, type Dict, type Expand, type Fallback, type FaseEventMessageExtends, FastEvent, type FastEventAnyListener, 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, type ObjectKeys, type OptionalItems, type Overloads, type OverrideOptions, type PickScopeEvents, QueueOverflowError, type RequiredItems, type ScopeEvents, TimeoutError, UnboundError, type Unique, __FastEventScope__, __FastEvent__ };
+export { AbortError, CancelError, type ChangeFieldType, type DeepPartial, type Dict, type Expand, type Fallback, FastEvent, type FastEventAnyListener, FastEventDirectives, type FastEventEmitMessage, FastEventError, type FastEventListenOptions, type FastEventListener, type FastEventListenerArgs, 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, type ObjectKeys, type OptionalItems, type Overloads, type OverrideOptions, type PickScopeEvents, QueueOverflowError, type RequiredItems, type ScopeEvents, TimeoutError, type TypedFastEventMessage, type TypedFastEventMessageOptional, UnboundError, type Unique, __FastEventScope__, __FastEvent__ };