fastevent 2.4.1 → 2.5.1

package/dist/executors/index.d.mts

@@ -88,11 +88,12 @@ type FastEventListenerArgs<M = Record<string, any>> = {
 type TypedFastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: TypedFastEventMessage<Record<T, P>, M>, args: FastEventListenerArgs<M>) => any | Promise<any>;
 /**
  * [
- *      监听器函数引用，
- *      需要执行多少次，                     =0代表不限
- *      实际执行的次数(用于负载均衡时记录)
- *      标签            用于调试一般可以标识监听器类型或任意信息
- *      标识
+ *      0: 监听器函数引用，
+ *      1: 需要执行多少次，                     =0代表不限
+ *      2: 实际执行的次数(用于负载均衡时记录)
+ *      3: 标签            用于调试一般可以标识监听器类型或任意信息
+ *      4: 标识,
+ *      5: 监听器最后一次执行结果，仅仅在debug时启用，如果结果是对象则是一个WeakRef
  * ]
  */
 type FastEventListenerMeta = [
@@ -100,10 +101,11 @@ type FastEventListenerMeta = [
     number,
     number,
     string,
-    number
+    number,
+    any?
 ];
 
-type FastListenerExecutor = (listeners: FastEventListenerMeta[], message: TypedFastEventMessage, args: FastEventListenerArgs, execute: (listener: TypedFastEventListener, message: TypedFastEventMessage, args: FastEventListenerArgs, catchErrors?: boolean) => Promise<any> | any) => Promise<any[]> | any[];
+type FastListenerExecutor = (listeners: FastEventListenerMeta[], message: TypedFastEventMessage, args: FastEventListenerArgs, execute: (this: FastEventListenerMeta, listener: FastEventListenerMeta, message: TypedFastEventMessage, args: FastEventListenerArgs, catchErrors?: boolean) => Promise<any> | any) => Promise<any[]> | any[];
 type FastListenerExecutorBuilder<T extends Record<string, any>> = (options?: T) => FastListenerExecutor;
 
 /**

package/dist/executors/index.d.ts

@@ -88,11 +88,12 @@ type FastEventListenerArgs<M = Record<string, any>> = {
 type TypedFastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: TypedFastEventMessage<Record<T, P>, M>, args: FastEventListenerArgs<M>) => any | Promise<any>;
 /**
  * [
- *      监听器函数引用，
- *      需要执行多少次，                     =0代表不限
- *      实际执行的次数(用于负载均衡时记录)
- *      标签            用于调试一般可以标识监听器类型或任意信息
- *      标识
+ *      0: 监听器函数引用，
+ *      1: 需要执行多少次，                     =0代表不限
+ *      2: 实际执行的次数(用于负载均衡时记录)
+ *      3: 标签            用于调试一般可以标识监听器类型或任意信息
+ *      4: 标识,
+ *      5: 监听器最后一次执行结果，仅仅在debug时启用，如果结果是对象则是一个WeakRef
  * ]
  */
 type FastEventListenerMeta = [
@@ -100,10 +101,11 @@ type FastEventListenerMeta = [
     number,
     number,
     string,
-    number
+    number,
+    any?
 ];
 
-type FastListenerExecutor = (listeners: FastEventListenerMeta[], message: TypedFastEventMessage, args: FastEventListenerArgs, execute: (listener: TypedFastEventListener, message: TypedFastEventMessage, args: FastEventListenerArgs, catchErrors?: boolean) => Promise<any> | any) => Promise<any[]> | any[];
+type FastListenerExecutor = (listeners: FastEventListenerMeta[], message: TypedFastEventMessage, args: FastEventListenerArgs, execute: (this: FastEventListenerMeta, listener: FastEventListenerMeta, message: TypedFastEventMessage, args: FastEventListenerArgs, catchErrors?: boolean) => Promise<any> | any) => Promise<any[]> | any[];
 type FastListenerExecutorBuilder<T extends Record<string, any>> = (options?: T) => FastListenerExecutor;
 
 /**

package/dist/executors/index.js

@@ -1,2 +1,2 @@
-'use strict';var S=Object.defineProperty;var t=(r,n)=>S(r,"name",{value:n,configurable:true});var j=t(()=>(r,n,o,f)=>(r.forEach(e=>e[2]--),r[0][2]++,[f(r[0][0],n,o)]),"first");var w=t(()=>(r,n,o,f)=>(r.forEach(e=>e[2]--),r[r.length-1][2]++,[f(r[r.length-1][0],n,o)]),"last");var N=t(()=>(r,n,o,f)=>{let e,i;return (!o||o&&!o.abortSignal)&&(i=new AbortController,o||(o={}),o.abortSignal=i.signal),[Promise.race(r.map(c=>(c[2]--,Promise.resolve(f(c[0],n,o)).then(l=>(e||(e=c,c[2]++),i?.abort(),l)))))]},"race");var L=t(()=>(r,n,o,f)=>{let e=Math.floor(Math.random()*r.length);return r.forEach(i=>i[2]--),r[e][2]++,[f(r[e][0],n,o)]},"random");var W=t(()=>(r,n,o,f)=>{let e,i=0;return r.forEach((u,c)=>{u[2]--,(e===void 0||e>u[2])&&(e=u[2],i=c);}),r[i][2]++,[f(r[i][0],n,o)]},"balance");function s(r){return r&&typeof r=="function"}t(s,"isFunction");function d(r){return r&&typeof r=="string"}t(d,"isString");var _=t(r=>{let{reverse:n,onNext:o,onReturns:f,onError:e}=Object.assign({reverse:false,onError:t(()=>{},"onError"),onNext:t(()=>true,"onNext"),onReturns:t((i,u)=>u,"onReturns")},r);return async(i,u,c,l)=>{let p,a,y=0;i.forEach(x=>x[2]--);for(let x=0;x<i.length;x++){let b=i[n?i.length-1-x:x],E=b[0];try{if(s(o)&&o(++y,a,u,c,p)===!1)break;a=await l(E,u,c,!1),s(f)?p=f(p,a):p=a,b[2]++;}catch(h){try{let m=d(e)?e:s(e)&&e(h,u,c);if(m==="skip")continue;if(m==="error"){p=h;break}else if(m==="abort")break}catch{}}}return p}},"series");var dr=t(r=>_(Object.assign({},r,{onError:"abort",onNext:t((n,o,f)=>{f.payload=o;},"onNext")})),"waterfall");var Er=t(()=>(r,n,o,f)=>r.map(e=>f(e[0],n,o,true)),"parallel");exports.balance=W;exports.first=j;exports.last=w;exports.parallel=Er;exports.race=N;exports.random=L;exports.series=_;exports.waterfall=dr;//# sourceMappingURL=index.js.map
+'use strict';var L=()=>(t,a,r,n)=>(t.forEach(e=>e[2]--),t[0][2]++,[n.call(t[0],t[0],a,r)]);var g=()=>(t,a,r,n)=>(t.forEach(e=>e[2]--),t[t.length-1][2]++,[n.call(t[t.length-1],t[t.length-1],a,r)]);var M=()=>(t,a,r,n)=>{let e,o;return (!r||r&&!r.abortSignal)&&(o=new AbortController,r||(r={}),r.abortSignal=o.signal),[Promise.race(t.map(s=>(s[2]--,Promise.resolve(n.call(s,s,a,r)).then(m=>(e||(e=s,s[2]++),o?.abort(),m)))))]};var S=()=>(t,a,r,n)=>{let e=Math.floor(Math.random()*t.length);return t.forEach(o=>o[2]--),t[e][2]++,[n.call(t[e],t[e],a,r)]};var w=()=>(t,a,r,n)=>{let e,o=0;return t.forEach((i,s)=>{i[2]--,(e===void 0||e>i[2])&&(e=i[2],o=s);}),t[o][2]++,[n.call(t[o],t[o],a,r)]};function f(t){return t&&typeof t=="function"}function y(t){return t&&typeof t=="string"}var d=t=>{let{reverse:a,onNext:r,onReturns:n,onError:e}=Object.assign({reverse:false,onError:()=>{},onNext:()=>true,onReturns:(o,i)=>i},t);return async(o,i,s,m)=>{let u,p,b=0;o.forEach(c=>c[2]--);for(let c=0;c<o.length;c++){let E=o[a?o.length-1-c:c],l=E;try{if(f(r)&&r(++b,p,i,s,u)===!1)break;p=await m.call(l,l,i,s,!1),f(n)?u=n(u,p):u=p,E[2]++;}catch(F){try{let x=y(e)?e:f(e)&&e(F,i,s);if(x==="skip")continue;if(x==="error"){u=F;break}else if(x==="abort")break}catch{}}}return u}};var _=t=>d(Object.assign({},t,{onError:"abort",onNext:(a,r,n)=>{n.payload=r;}}));var z=()=>(t,a,r,n)=>t.map((e,o)=>n.call(t[o],e,a,r,true));exports.balance=w;exports.first=L;exports.last=g;exports.parallel=z;exports.race=M;exports.random=S;exports.series=d;exports.waterfall=_;//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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/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":"8FAWaA,IAAAA,CAAAA,CAAQC,CAAA,CAAA,IACV,CAACC,CAAAA,CAAWC,EAASC,CAAMC,CAAAA,CAAAA,IAC9BH,CAAUI,CAAAA,OAAAA,CAAQC,CAAYA,EAAAA,CAAAA,CAAS,CAAA,CAAE,EAAA,CAAA,CACzCL,CAAU,CAAA,CAAA,CAAG,CAAA,CAAA,CACN,EAAA,CAAA,CACHG,CAAQH,CAAAA,CAAAA,CAAU,CAAA,CAAA,CAAG,CAAA,CAAA,CAAIC,EAASC,CAAAA,CAAAA,CAAAA,CAAAA,CALzB,OCDd,EAAA,IAAMI,CAAOP,CAAAA,CAAAA,CAAA,IACT,CAACC,CAAWC,CAAAA,CAAAA,CAASC,CAAMC,CAAAA,CAAAA,IAC9BH,CAAUI,CAAAA,OAAAA,CAAQC,GAAYA,CAAS,CAAA,CAAA,CAAE,EAAA,CAAA,CACzCL,CAAUA,CAAAA,CAAAA,CAAUO,MAAS,CAAA,CAAA,CAAG,CAAA,CAAA,CACzB,EAAA,CAAA,CACHJ,CAAQH,CAAAA,CAAAA,CAAUA,EAAUO,MAAS,CAAA,CAAA,CAAG,CAAA,CAAA,CAAIN,CAAAA,CAAAA,CAASC,CAAAA,CAAAA,CAAAA,CAAAA,CAL7C,MCQb,EAAA,IAAMM,CAAOT,CAAAA,CAAAA,CAAA,IACT,CAACC,EAAWC,CAASC,CAAAA,CAAAA,CAAMC,CAAAA,GAAAA,CAC9B,IAAIM,CAAAA,CACAC,CACJ,CAAA,OAAA,CAAI,CAACR,CAAAA,EAASA,CAAQ,EAAA,CAACA,CAAKS,CAAAA,WAAAA,IACxBD,EAAkB,IAAIE,eAAAA,CACjBV,CAAMA,GAAAA,CAAAA,CAAO,EAAC,CAAA,CACnBA,CAAKS,CAAAA,WAAAA,CAAcD,CAAgBG,CAAAA,MAAAA,CAAAA,CAehC,CAbQC,OAAAA,CAAQN,IACnBR,CAAAA,CAAAA,CAAUe,IAAKV,CACXA,GAAAA,CAAAA,CAAS,CAAA,CAAA,EAAA,CACFS,OAAQE,CAAAA,OAAAA,CAAQb,CAAQE,CAAAA,CAAAA,CAAS,CAAA,CAAA,CAAIJ,CAASC,CAAAA,CAAAA,CAAAA,CAAAA,CAAOe,KAAMC,CACzDT,GAAAA,CAAAA,GACDA,CAASJ,CAAAA,CAAAA,CACTA,CAAS,CAAA,CAAA,KAEbK,CAAiBS,EAAAA,KAAAA,EACVD,CAAAA,CAAAA,CACX,CACJ,CAAA,CAAA,EAGR,CAvBgB,CAAA,MAAA,ECFPE,IAAAA,CAAAA,CAASrB,CAAA,CAAA,IACX,CAACC,CAAAA,CAAWC,CAASC,CAAAA,CAAAA,CAAMC,CAAAA,GAAAA,CAC9B,IAAMkB,CAAAA,CAAQC,KAAKC,KAAMD,CAAAA,IAAAA,CAAKF,MAAM,EAAA,CAAKpB,CAAUO,CAAAA,MAAM,CACzDP,CAAAA,OAAAA,CAAUI,CAAAA,OAAAA,CAAQC,CAAYA,EAAAA,CAAAA,CAAS,CAAA,CAAA,EAAE,EACzCL,CAAUqB,CAAAA,CAAAA,CAAO,CAAA,CAAA,CACV,EAAA,CAAA,CACHlB,CAAQH,CAAAA,CAAAA,CAAUqB,CAAAA,CAAAA,CAAO,CAAA,CAAA,CAAIpB,CAASC,CAAAA,CAAAA,EAE9C,CARkB,CAAA,QAAA,ECDTsB,IAAAA,CAAAA,CAAUzB,CAAA,CAAA,IACZ,CAACC,CAAAA,CAAWC,CAASC,CAAAA,CAAAA,CAAMC,CAAAA,GAAAA,CAE9B,IAAIsB,CAAAA,CACAJ,EAAgB,CACpBrB,CAAAA,OAAAA,CAAUI,CAAAA,OAAAA,CAAQ,CAACC,CAAAA,CAAUqB,CAAAA,GAAAA,CAGzBrB,CAAS,CAAA,CAAA,CACLoB,EAAAA,CAAAA,CAAAA,CAAAA,GAAUE,MAAaF,EAAAA,CAAAA,CAAQpB,EAAS,CAAA,CAAA,IACxCoB,CAAQpB,CAAAA,CAAAA,CAAS,CAAA,CAAA,CACjBgB,CAAQK,CAAAA,CAAAA,EAEhB,CAAA,CAAA,CACA1B,CAAUqB,CAAAA,CAAAA,CAAO,CAAA,CAAA,IACV,CAAClB,CAAAA,CAAQH,CAAUqB,CAAAA,CAAAA,CAAO,CAAA,CAAA,CAAIpB,CAAAA,CAAAA,CAASC,CAAAA,CAAAA,CAClD,CAhBmB,CAAA,SAAA,ECfhB,SAAS0B,CAAAA,CAAWC,EAAO,CAC9B,OAAOA,CAAM,EAAA,OAAQA,CAAO,EAAA,UAChC,CAFgBD,CAAAA,CAAAA,CAAAA,CAAAA,YCAT,CAAA,CAAA,SAASE,CAASC,CAAAA,CAAAA,CAAQ,CAC7B,OAAOA,CAAAA,EAAO,OAAQA,CAAAA,EAAS,QACnC,CAFgBD,CAAAA,CAAAA,CAAAA,CAAAA,UC0CT,CAAA,CAAA,IAAME,CAASjC,CAAAA,CAAAA,CAACkC,CAAAA,EAAAA,CACnB,GAAM,CAAEC,OAAAA,CAAAA,CAASC,CAAAA,MAAAA,CAAAA,CAAQC,CAAAA,SAAAA,CAAAA,CAAWC,CAAAA,OAAAA,CAAAA,CAAO,CAAA,CAAKC,MAAOC,CAAAA,MAAAA,CACnD,CACIL,OAAAA,CAAS,MACTG,OAAStC,CAAAA,CAAAA,CAAA,IAAA,EAAA,CAAA,SAAA,CAAA,CACToC,MAAQpC,CAAAA,CAAAA,CAAA,IAAM,IAAA,CAAN,QACRqC,CAAAA,CAAAA,SAAAA,CAAWrC,CAAA,CAAA,CAACyC,EAAQC,CAAaA,GAAAA,CAAAA,CAAtB,WACf,CAAA,CAAA,CACAR,CAAAA,CAAAA,CAEJ,OAAO,MAAOjC,CAAWC,CAAAA,CAAAA,CAASC,CAAMC,CAAAA,CAAAA,GAAAA,CACpC,IAAIuC,EACAC,CACAtB,CAAAA,CAAAA,CAAgB,CAEpBrB,CAAAA,CAAAA,CAAUI,OAASC,CAAAA,CAAAA,EAAaA,CAAS,CAAA,CAAA,CAAE,EAAA,CAAA,CAC3C,IAASqB,IAAAA,CAAAA,CAAI,CAAGA,CAAAA,CAAAA,CAAI1B,EAAUO,MAAQmB,CAAAA,CAAAA,EAAAA,CAAK,CACvC,IAAMkB,CAAO5C,CAAAA,CAAAA,CAAUkC,CAAUlC,CAAAA,CAAAA,CAAUO,MAAS,CAAA,CAAA,CAAImB,CAAIA,CAAAA,CAAAA,CACtDrB,CAAAA,CAAAA,CAAWuC,EAAK,CAAA,CAAA,CACtB,GAAI,CACA,GACIhB,CAAAA,CAAWO,CAAAA,CAAAA,EACXA,CAAO,CAAA,EAAEd,CAAOsB,CAAAA,CAAAA,CAAY1C,CAASC,CAAAA,CAAAA,CAAMwC,CAAAA,CAAa,GAAA,CAAA,CAAA,CAExD,MAEJC,CAAAA,CAAa,MAAMxC,CAAAA,CAAQE,CAAUJ,CAAAA,CAAAA,CAASC,CAAM,CAAA,CAAA,CAAA,CAChD0B,CAAAA,CAAAA,CAAWQ,CAAAA,CAAAA,CACXM,EAAUN,CAAUM,CAAAA,CAAAA,CAASC,CAAAA,CAAAA,CAE7BD,CAAUC,CAAAA,CAAAA,CAGdC,CAAK,CAAA,CAAA,CACT,GAAA,CAAA,MAASC,CAAQ,CAAA,CACb,GAAI,CACA,IAAMC,CAAWhB,CAAAA,CAAAA,CAASO,CAAAA,CAAAA,CACpBA,CACAT,CAAAA,CAAAA,CAAWS,CAAAA,CAAAA,EAAYA,CAASQ,CAAAA,CAAAA,CAAG5C,CAASC,CAAAA,CAAAA,CAClD,CAAA,GAAI4C,IAAa,MACb,CAAA,SACG,GAAIA,CAAAA,GAAa,OAAS,CAAA,CAC7BJ,CAAUG,CAAAA,CAAAA,CACV,KACJ,CAAA,KAAA,GAAWC,CAAa,GAAA,OAAA,CACpB,KAER,CAAA,KAAQ,EACZ,CACJ,CACA,OAAOJ,CACX,CACJ,CApDsB,CAAA,QAAA,ECtBTK,IAAAA,EAAAA,CAAYhD,CAACkC,CAAAA,CAAAA,EACfD,CACHM,CAAAA,MAAAA,CAAOC,OAAO,EAAC,CAAGN,CAAS,CAAA,CAEvBI,OAAS,CAAA,OAAA,CAETF,MAAQpC,CAAAA,CAAAA,CAAA,CAACsB,CAAAA,CAAe2B,CAAe/C,CAAAA,CAAAA,GAAAA,CACnCA,CAAAA,CAAQgD,QAAUD,EACtB,CAAA,CAFQ,QAGZ,CAAA,CAAA,CAAA,CAAA,CATiB,WCflB,EAAA,IAAME,EAAWnD,CAAAA,CAAAA,CAAA,IACb,CAACC,CAAWC,CAAAA,CAAAA,CAASC,EAAMC,CACvBH,GAAAA,CAAAA,CAAUe,GAAIV,CAAAA,CAAAA,EAAYF,CAAQE,CAAAA,CAAAA,CAAS,CAAA,CAAA,CAAIJ,CAASC,CAAAA,CAAAA,CAAM,IAAA,CAAA,CAFrD,CAAA,UAAA","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 { FastEventListenerMeta } from \"../types/FastEventListeners\";\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: FastEventListenerMeta | 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(\n            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        );\n        return [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}","import { TypedFastEventMessage } from \"../types/FastEventMessages\";\nimport { TypedFastEventListener } from \"../types/FastEventListeners\";\nimport { FastEventListenerArgs } from \"../types/FastEvents\";\nimport { isString } from \"../utils\";\nimport { isFunction } from \"../utils/isFunction\";\nimport { FastListenerExecutor } from \"./types\";\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?: (\n        index: number,\n        previous: any,\n        message: TypedFastEventMessage,\n        args: FastEventListenerArgs,\n        results: any,\n    ) => boolean;\n    // 当执行监听器出错时的回调，返回false中止后续执行\n    onError?:\n        | \"skip\"\n        | \"abort\"\n        | \"error\"\n        | ((\n              e: any,\n              message: TypedFastEventMessage,\n              args: FastEventListenerArgs,\n          ) => void | \"skip\" | \"abort\" | \"error\");\n};\n\nexport const series = (options?: SeriesExecutorOptions): FastListenerExecutor => {\n    const { reverse, onNext, onReturns, onError } = Object.assign(\n        {\n            reverse: false,\n            onError: () => {},\n            onNext: () => true,\n            onReturns: (_: any, cur: any) => cur,\n        },\n        options,\n    ) 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 TypedFastEventListener<any, any, any>;\n            try {\n                if (\n                    isFunction(onNext) &&\n                    onNext(++index, stepResult, message, args, results) === false\n                ) {\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)\n                        ? onError\n                        : 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/FastEventMessages\";\nimport { series, SeriesExecutorOptions } from \"./series\";\nimport { FastListenerExecutor } from \"./types\";\n\nexport type WaterfallExecutorOptions = Omit<\n    SeriesExecutorOptions,\n    \"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(\n        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    );\n};\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/executors/series.ts","../../src/executors/waterfall.ts","../../src/executors/parallel.ts"],"names":["first","listeners","message","args","execute","listener","last","race","winner","abortController","result","random","index","balance","count","i","isFunction","fn","isString","str","series","options","reverse","onNext","onReturns","onError","_","cur","results","stepResult","item","e","behavior","waterfall","previous","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 [execute.call(listeners[0], listeners[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.call(\n                listeners[listeners.length - 1],\n                listeners[listeners.length - 1],\n                message,\n                args,\n            ),\n        ];\n    };\n};\n","import { FastEventListenerMeta } from \"../types/FastEventListeners\";\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: FastEventListenerMeta | 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(\n            listeners.map((listener) => {\n                listener[2]--;\n                return Promise.resolve(execute.call(listener, listener, message, args)).then(\n                    (result: any) => {\n                        if (!winner) {\n                            winner = listener;\n                            listener[2]++;\n                        }\n                        abortController?.abort();\n                        return result;\n                    },\n                );\n            }),\n        );\n        return [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 [execute.call(listeners[index], listeners[index], 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.call(listeners[index], listeners[index], message, args)];\n    };\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}","import { TypedFastEventMessage } from \"../types/FastEventMessages\";\nimport { FastEventListenerMeta, TypedFastEventListener } from \"../types/FastEventListeners\";\nimport { FastEventListenerArgs } from \"../types/FastEvents\";\nimport { isString } from \"../utils\";\nimport { isFunction } from \"../utils/isFunction\";\nimport { FastListenerExecutor } from \"./types\";\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?: (\n        index: number,\n        previous: any,\n        message: TypedFastEventMessage,\n        args: FastEventListenerArgs,\n        results: any,\n    ) => boolean;\n    // 当执行监听器出错时的回调，返回false中止后续执行\n    onError?:\n        | \"skip\"\n        | \"abort\"\n        | \"error\"\n        | ((\n              e: any,\n              message: TypedFastEventMessage,\n              args: FastEventListenerArgs,\n          ) => void | \"skip\" | \"abort\" | \"error\");\n};\n\nexport const series = (options?: SeriesExecutorOptions): FastListenerExecutor => {\n    const { reverse, onNext, onReturns, onError } = Object.assign(\n        {\n            reverse: false,\n            onError: () => {},\n            onNext: () => true,\n            onReturns: (_: any, cur: any) => cur,\n        },\n        options,\n    ) 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 as unknown as FastEventListenerMeta;\n            try {\n                if (\n                    isFunction(onNext) &&\n                    onNext(++index, stepResult, message, args, results) === false\n                ) {\n                    break;\n                }\n                stepResult = await execute.call(listener, 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)\n                        ? onError\n                        : 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/FastEventMessages\";\nimport { series, SeriesExecutorOptions } from \"./series\";\nimport { FastListenerExecutor } from \"./types\";\n\nexport type WaterfallExecutorOptions = Omit<\n    SeriesExecutorOptions,\n    \"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(\n        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    );\n};\n","import { FastListenerExecutor } from \"./types\";\n\n/**\n *\n */\nexport const parallel = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        return listeners.map((listener, i) =>\n            execute.call(listeners[i], listener, message, args, true),\n        );\n    };\n};\n"]}

package/dist/executors/index.mjs

@@ -1,2 +1,2 @@
-var S=Object.defineProperty;var t=(r,n)=>S(r,"name",{value:n,configurable:true});var j=t(()=>(r,n,o,f)=>(r.forEach(e=>e[2]--),r[0][2]++,[f(r[0][0],n,o)]),"first");var w=t(()=>(r,n,o,f)=>(r.forEach(e=>e[2]--),r[r.length-1][2]++,[f(r[r.length-1][0],n,o)]),"last");var N=t(()=>(r,n,o,f)=>{let e,i;return (!o||o&&!o.abortSignal)&&(i=new AbortController,o||(o={}),o.abortSignal=i.signal),[Promise.race(r.map(c=>(c[2]--,Promise.resolve(f(c[0],n,o)).then(l=>(e||(e=c,c[2]++),i?.abort(),l)))))]},"race");var L=t(()=>(r,n,o,f)=>{let e=Math.floor(Math.random()*r.length);return r.forEach(i=>i[2]--),r[e][2]++,[f(r[e][0],n,o)]},"random");var W=t(()=>(r,n,o,f)=>{let e,i=0;return r.forEach((u,c)=>{u[2]--,(e===void 0||e>u[2])&&(e=u[2],i=c);}),r[i][2]++,[f(r[i][0],n,o)]},"balance");function s(r){return r&&typeof r=="function"}t(s,"isFunction");function d(r){return r&&typeof r=="string"}t(d,"isString");var _=t(r=>{let{reverse:n,onNext:o,onReturns:f,onError:e}=Object.assign({reverse:false,onError:t(()=>{},"onError"),onNext:t(()=>true,"onNext"),onReturns:t((i,u)=>u,"onReturns")},r);return async(i,u,c,l)=>{let p,a,y=0;i.forEach(x=>x[2]--);for(let x=0;x<i.length;x++){let b=i[n?i.length-1-x:x],E=b[0];try{if(s(o)&&o(++y,a,u,c,p)===!1)break;a=await l(E,u,c,!1),s(f)?p=f(p,a):p=a,b[2]++;}catch(h){try{let m=d(e)?e:s(e)&&e(h,u,c);if(m==="skip")continue;if(m==="error"){p=h;break}else if(m==="abort")break}catch{}}}return p}},"series");var dr=t(r=>_(Object.assign({},r,{onError:"abort",onNext:t((n,o,f)=>{f.payload=o;},"onNext")})),"waterfall");var Er=t(()=>(r,n,o,f)=>r.map(e=>f(e[0],n,o,true)),"parallel");export{W as balance,j as first,w as last,Er as parallel,N as race,L as random,_ as series,dr as waterfall};//# sourceMappingURL=index.mjs.map
+var L=()=>(t,a,r,n)=>(t.forEach(e=>e[2]--),t[0][2]++,[n.call(t[0],t[0],a,r)]);var g=()=>(t,a,r,n)=>(t.forEach(e=>e[2]--),t[t.length-1][2]++,[n.call(t[t.length-1],t[t.length-1],a,r)]);var M=()=>(t,a,r,n)=>{let e,o;return (!r||r&&!r.abortSignal)&&(o=new AbortController,r||(r={}),r.abortSignal=o.signal),[Promise.race(t.map(s=>(s[2]--,Promise.resolve(n.call(s,s,a,r)).then(m=>(e||(e=s,s[2]++),o?.abort(),m)))))]};var S=()=>(t,a,r,n)=>{let e=Math.floor(Math.random()*t.length);return t.forEach(o=>o[2]--),t[e][2]++,[n.call(t[e],t[e],a,r)]};var w=()=>(t,a,r,n)=>{let e,o=0;return t.forEach((i,s)=>{i[2]--,(e===void 0||e>i[2])&&(e=i[2],o=s);}),t[o][2]++,[n.call(t[o],t[o],a,r)]};function f(t){return t&&typeof t=="function"}function y(t){return t&&typeof t=="string"}var d=t=>{let{reverse:a,onNext:r,onReturns:n,onError:e}=Object.assign({reverse:false,onError:()=>{},onNext:()=>true,onReturns:(o,i)=>i},t);return async(o,i,s,m)=>{let u,p,b=0;o.forEach(c=>c[2]--);for(let c=0;c<o.length;c++){let E=o[a?o.length-1-c:c],l=E;try{if(f(r)&&r(++b,p,i,s,u)===!1)break;p=await m.call(l,l,i,s,!1),f(n)?u=n(u,p):u=p,E[2]++;}catch(F){try{let x=y(e)?e:f(e)&&e(F,i,s);if(x==="skip")continue;if(x==="error"){u=F;break}else if(x==="abort")break}catch{}}}return u}};var _=t=>d(Object.assign({},t,{onError:"abort",onNext:(a,r,n)=>{n.payload=r;}}));var z=()=>(t,a,r,n)=>t.map((e,o)=>n.call(t[o],e,a,r,true));export{w as balance,L as first,g as last,z as parallel,M as race,S as random,d as series,_ as waterfall};//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

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/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 { FastEventListenerMeta } from \"../types/FastEventListeners\";\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: FastEventListenerMeta | 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(\n            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        );\n        return [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}","import { TypedFastEventMessage } from \"../types/FastEventMessages\";\nimport { TypedFastEventListener } from \"../types/FastEventListeners\";\nimport { FastEventListenerArgs } from \"../types/FastEvents\";\nimport { isString } from \"../utils\";\nimport { isFunction } from \"../utils/isFunction\";\nimport { FastListenerExecutor } from \"./types\";\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?: (\n        index: number,\n        previous: any,\n        message: TypedFastEventMessage,\n        args: FastEventListenerArgs,\n        results: any,\n    ) => boolean;\n    // 当执行监听器出错时的回调，返回false中止后续执行\n    onError?:\n        | \"skip\"\n        | \"abort\"\n        | \"error\"\n        | ((\n              e: any,\n              message: TypedFastEventMessage,\n              args: FastEventListenerArgs,\n          ) => void | \"skip\" | \"abort\" | \"error\");\n};\n\nexport const series = (options?: SeriesExecutorOptions): FastListenerExecutor => {\n    const { reverse, onNext, onReturns, onError } = Object.assign(\n        {\n            reverse: false,\n            onError: () => {},\n            onNext: () => true,\n            onReturns: (_: any, cur: any) => cur,\n        },\n        options,\n    ) 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 TypedFastEventListener<any, any, any>;\n            try {\n                if (\n                    isFunction(onNext) &&\n                    onNext(++index, stepResult, message, args, results) === false\n                ) {\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)\n                        ? onError\n                        : 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/FastEventMessages\";\nimport { series, SeriesExecutorOptions } from \"./series\";\nimport { FastListenerExecutor } from \"./types\";\n\nexport type WaterfallExecutorOptions = Omit<\n    SeriesExecutorOptions,\n    \"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(\n        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    );\n};\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/executors/series.ts","../../src/executors/waterfall.ts","../../src/executors/parallel.ts"],"names":["first","listeners","message","args","execute","listener","last","race","winner","abortController","result","random","index","balance","count","i","isFunction","fn","isString","str","series","options","reverse","onNext","onReturns","onError","_","cur","results","stepResult","item","e","behavior","waterfall","previous","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 [execute.call(listeners[0], listeners[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.call(\n                listeners[listeners.length - 1],\n                listeners[listeners.length - 1],\n                message,\n                args,\n            ),\n        ];\n    };\n};\n","import { FastEventListenerMeta } from \"../types/FastEventListeners\";\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: FastEventListenerMeta | 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(\n            listeners.map((listener) => {\n                listener[2]--;\n                return Promise.resolve(execute.call(listener, listener, message, args)).then(\n                    (result: any) => {\n                        if (!winner) {\n                            winner = listener;\n                            listener[2]++;\n                        }\n                        abortController?.abort();\n                        return result;\n                    },\n                );\n            }),\n        );\n        return [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 [execute.call(listeners[index], listeners[index], 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.call(listeners[index], listeners[index], message, args)];\n    };\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}","import { TypedFastEventMessage } from \"../types/FastEventMessages\";\nimport { FastEventListenerMeta, TypedFastEventListener } from \"../types/FastEventListeners\";\nimport { FastEventListenerArgs } from \"../types/FastEvents\";\nimport { isString } from \"../utils\";\nimport { isFunction } from \"../utils/isFunction\";\nimport { FastListenerExecutor } from \"./types\";\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?: (\n        index: number,\n        previous: any,\n        message: TypedFastEventMessage,\n        args: FastEventListenerArgs,\n        results: any,\n    ) => boolean;\n    // 当执行监听器出错时的回调，返回false中止后续执行\n    onError?:\n        | \"skip\"\n        | \"abort\"\n        | \"error\"\n        | ((\n              e: any,\n              message: TypedFastEventMessage,\n              args: FastEventListenerArgs,\n          ) => void | \"skip\" | \"abort\" | \"error\");\n};\n\nexport const series = (options?: SeriesExecutorOptions): FastListenerExecutor => {\n    const { reverse, onNext, onReturns, onError } = Object.assign(\n        {\n            reverse: false,\n            onError: () => {},\n            onNext: () => true,\n            onReturns: (_: any, cur: any) => cur,\n        },\n        options,\n    ) 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 as unknown as FastEventListenerMeta;\n            try {\n                if (\n                    isFunction(onNext) &&\n                    onNext(++index, stepResult, message, args, results) === false\n                ) {\n                    break;\n                }\n                stepResult = await execute.call(listener, 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)\n                        ? onError\n                        : 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/FastEventMessages\";\nimport { series, SeriesExecutorOptions } from \"./series\";\nimport { FastListenerExecutor } from \"./types\";\n\nexport type WaterfallExecutorOptions = Omit<\n    SeriesExecutorOptions,\n    \"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(\n        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    );\n};\n","import { FastListenerExecutor } from \"./types\";\n\n/**\n *\n */\nexport const parallel = (): FastListenerExecutor => {\n    return (listeners, message, args, execute) => {\n        return listeners.map((listener, i) =>\n            execute.call(listeners[i], listener, message, args, true),\n        );\n    };\n};\n"]}

package/dist/index.d.mts

@@ -806,6 +806,24 @@ type MutableMessage<Events extends Record<string, any>, Meta extends Record<stri
     } & FastEventMessageExtends;
 }[KeyOf<Events>];
 
+/**
+ * 返回最匹配的事件元组
+ *
+ * [事件名称，事件负载]
+ *
+ * type Events = {
+  *   "users/* /login": string;
+    "users/* /logout": number;
+    "users/* /*": { name: string };
+};
+ 
+type Result =GetClosestEventTuple<Events,"users/fisher/login">
+type Result = ["users/* /login", string]
+
+ *
+ */
+type GetClosestMessage<Events extends Record<string, any>, T extends string, Meta extends Record<string, any> = never> = FastEventMessage<ContainsWildcard<T> extends true ? ReplaceWildcard<Exclude<ExpandRecord<GetClosestEvents<Events, T>>[0], number | symbol>> : T, ExpandRecord<GetClosestEvents<Events, T>>[1], Meta>;
+
 /**
  * 事件消息相关
  */
@@ -998,7 +1016,7 @@ type FastEventSubscriber = {
     _close?: () => void;
 };
 
-type FastListenerExecutor = (listeners: FastEventListenerMeta[], message: TypedFastEventMessage, args: FastEventListenerArgs, execute: (listener: TypedFastEventListener, message: TypedFastEventMessage, args: FastEventListenerArgs, catchErrors?: boolean) => Promise<any> | any) => Promise<any[]> | any[];
+type FastListenerExecutor = (listeners: FastEventListenerMeta[], message: TypedFastEventMessage, args: FastEventListenerArgs, execute: (this: FastEventListenerMeta, listener: FastEventListenerMeta, message: TypedFastEventMessage, args: FastEventListenerArgs, catchErrors?: boolean) => Promise<any> | any) => Promise<any[]> | any[];
 
 type FastListenerPipe = (listener: TypedFastEventListener) => TypedFastEventListener;
 
@@ -1030,14 +1048,28 @@ interface FastEventIteratorOptions<T = FastEventMessage> {
     /** 信号，用于取消迭代 */
     signal?: AbortSignal;
 }
+/**
+ * 方法装饰器类型定义（TypeScript 5.0+ 新标准）
+ *
+ * 新装饰器标准使用上下文对象和值，而不是传统的 (target, propertyKey, descriptor)
+ */
+/**
+ * 可作为装饰器使用的迭代器
+ *
+ * 关键设计：通过交叉类型实现多态
+ * - 装饰器工厂：emitter.on("event", options)
+ * - 方法装饰器：@emitter.on("event")
+ * - 异步迭代器：for await (const msg of emitter.on("event"))
+ */
+type WithListenerDecorator<T extends FastEventIterator> = T & ListenerDecorator;
+type ListenerDecorator = (value: (...args: any[]) => any, context: ClassMethodDecoratorContext) => void;
+type IListenerDecoratorBuilder = (type: string, options?: FastEventListenOptions) => ListenerDecorator;
 declare class FastEventIterator<T = any> implements AsyncIterableIterator<T> {
     private eventEmitter;
     private eventName;
-    private buffer;
     private resolvers;
     private errorResolvers;
     private isStopped;
-    private error;
     private options;
     private currentSize;
     private hasNewMessage;
@@ -1045,6 +1077,8 @@ declare class FastEventIterator<T = any> implements AsyncIterableIterator<T> {
     private _ready;
     private _listenOptions?;
     private _cleanups;
+    error: Error | null;
+    buffer: [T, number][];
     constructor(eventEmitter: FastEvent<any> | FastEventScope<any, any, any>, eventName: string, options?: FastEventIteratorOptions<T>);
     get listener(): FastEventListener;
     get ready(): boolean;
@@ -1111,13 +1145,15 @@ declare function createAsyncEventIterator<T = any>(eventEmitter: FastEvent<any>
 
 type FastEventOptions<Meta = Record<string, any>, Context = never> = {
     id: string;
+    title: string;
     debug: boolean;
     delimiter: string;
     context: Context;
     ignoreErrors: boolean;
     meta: Meta;
-    onAddListener?: (type: string, listener: TypedFastEventListener, options: FastEventListenOptions<Record<string, any>, Meta>) => boolean | FastEventSubscriber | void;
-    onRemoveListener?: (type: string, listener: TypedFastEventListener) => void;
+    onAddBeforeListener?: (type: string, listener: TypedFastEventListener, options: FastEventListenOptions<Record<string, any>, Meta>) => boolean | FastEventSubscriber | void;
+    onAddAfterListener?: (type: string, node: FastEventListenerNode) => void;
+    onRemoveListener?: (type: string, listener: TypedFastEventListener, node: FastEventListenerNode) => void;
     onClearListeners?: () => 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[];
@@ -1202,36 +1238,6 @@ type FastEventListenerArgs<M = Record<string, any>> = {
     rawEventType?: string;
 };
 
-type TypedFastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: TypedFastEventMessage<Record<T, P>, M>, args: FastEventListenerArgs<M>) => 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<T extends string = string, P = any, M extends Record<string, any> = Record<string, any>> = (message: FastEventMessage<T, P, M>, args: FastEventListenerArgs<M>) => any | Promise<any>;
-type FastEventCommonListener<Message = FastEventMessage, Meta extends Record<string, any> = Record<string, any>, Context = any> = (this: Context, message: Message, args: FastEventListenerArgs<Meta>) => any | Promise<any>;
-/**
- * [
- *      监听器函数引用，
- *      需要执行多少次，                     =0代表不限
- *      实际执行的次数(用于负载均衡时记录)
- *      标签            用于调试一般可以标识监听器类型或任意信息
- *      标识
- * ]
- */
-type FastEventListenerMeta = [
-    TypedFastEventListener<any, any>,
-    number,
-    number,
-    string,
-    number
-];
-type FastEventListenerNode = {
-    __listeners: FastEventListenerMeta[];
-} & {
-    [key: string]: FastEventListenerNode;
-};
-type FastListeners = FastEventListenerNode;
-
 /**
  * 获取指定事件名称的负载类型
  */
@@ -1286,23 +1292,54 @@ type UnTransformedEvents<Events extends Record<string, any>> = {
     [K in keyof Events]: Events[K] extends FastMessagePayload<infer P> ? P : Events[K];
 };
 
+type TypedFastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: TypedFastEventMessage<Record<T, P>, M>, args: FastEventListenerArgs<M>) => any | Promise<any>;
+type TypedFastEventAnyListener<Events extends Record<string, any> = Record<string, any>, Meta extends Record<string, any> = Record<string, any>, Context = any> = (this: Context, message: MutableMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => any | Promise<any>;
+type FastEventListeners<Events extends Record<string, any> = Record<string, any>, Meta extends Record<string, any> = Record<string, any>, Context = any> = {
+    [K in KeyOf<Events>]: FastEventCommonListener<K extends IsTransformedEvent<Events, K> ? PickPayload<ValueOf<GetClosestEvents<Events, K>>> : K extends "**" ? MutableMessage<Events> : GetClosestMessage<Events, K, Meta>, Meta, Context>;
+};
+type FastEventListener<T extends string = string, P = any, M extends Record<string, any> = Record<string, any>> = (message: FastEventMessage<T, P, M>, args: FastEventListenerArgs<M>) => any | Promise<any>;
+type FastEventCommonListener<Message = FastEventMessage, Meta extends Record<string, any> = Record<string, any>, Context = any> = (this: Context, message: Message, args: FastEventListenerArgs<Meta>) => any | Promise<any>;
 /**
- * 返回最匹配的事件元组
- *
- * [事件名称，事件负载]
- *
- * type Events = {
-  *   "users/* /login": string;
-    "users/* /logout": number;
-    "users/* /*": { name: string };
+ * [
+ *      0: 监听器函数引用，
+ *      1: 需要执行多少次，                     =0代表不限
+ *      2: 实际执行的次数(用于负载均衡时记录)
+ *      3: 标签            用于调试一般可以标识监听器类型或任意信息
+ *      4: 标识,
+ *      5: 监听器最后一次执行结果，仅仅在debug时启用，如果结果是对象则是一个WeakRef
+ * ]
+ */
+type FastEventListenerMeta = [
+    TypedFastEventListener<any, any>,
+    number,
+    number,
+    string,
+    number,
+    any?
+];
+type FastEventListenerNode = {
+    __listeners: FastEventListenerMeta[];
+} & {
+    [key: string]: FastEventListenerNode;
 };
- 
-type Result =GetClosestEventTuple<Events,"users/fisher/login">
-type Result = ["users/* /login", string]
+type FastListeners = FastEventListenerNode;
 
- *
- */
-type GetClosestMessage<Events extends Record<string, any>, T extends string, Meta extends Record<string, any> = never> = FastEventMessage<ContainsWildcard<T> extends true ? ReplaceWildcard<Exclude<ExpandRecord<GetClosestEvents<Events, T>>[0], number | symbol>> : T, ExpandRecord<GetClosestEvents<Events, T>>[1], Meta>;
+type AddBeforeListenerHook = (type: string, listener: TypedFastEventListener, options: FastEventListenOptions<Record<string, any>, any>) => boolean | FastEventSubscriber | void;
+type AddAfterListenerHook = (type: string, node: FastEventListenerNode) => void;
+type RemoveListenerHook = (type: string, listener: TypedFastEventListener, node: FastEventListenerNode) => void;
+type ClearListenersHook = () => void;
+type ListenerErrorHook = (error: Error, listener: TypedFastEventListener, message: TypedFastEventMessage<any, any>, args: FastEventListenerArgs<any> | undefined) => void;
+type BeforeExecuteListenerHook = (message: TypedFastEventMessage<any, any>, args: FastEventListenerArgs<any>) => boolean | void | any[];
+type AfterExecuteListenerHook = (message: TypedFastEventMessage<any, any>, returns: any[], listeners: FastEventListenerNode[]) => void;
+type FastEventHooks = {
+    AddBeforeListener: AddBeforeListenerHook[];
+    AddAfterListener: AddAfterListenerHook[];
+    RemoveListener: RemoveListenerHook[];
+    ClearListeners: ClearListenersHook[];
+    ListenerError: ListenerErrorHook[];
+    BeforeExecuteListener: BeforeExecuteListenerHook[];
+    AfterExecuteListener: AfterExecuteListenerHook[];
+};
 
 type InMatchedEvent<Events extends Record<string, any>, T> = T extends KeyOf<Events> | ReplaceWildcard<KeyOf<Events>> ? true : false;
 
@@ -1342,6 +1379,9 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
         messages: MutableMessage<Events, FinalMeta>;
         rawEvents: Events;
         meta: FinalMeta;
+        listeners: FastEventListeners<Events, Expand<FastEventMeta & Meta & Record<string, any>>>;
+        anyListener: TypedFastEventAnyListener<Events, Expand<FastEventMeta & Meta & Record<string, any>>>;
+        listener: FastEventCommonListener<FastEventMessage, Expand<FastEventMeta & Meta & Record<string, any>>>;
     };
     prefix: string;
     emitter: FastEvent<any>;
@@ -1473,6 +1513,7 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
     private _delimiter;
     /** 事件监听器执行时的上下文对象 */
     private _context;
+    private _hooks?;
     /** 保留的事件消息映射，Key是事件名称，Value是保留的事件消息 */
     retainedMessages: Map<string, any>;
     /** 当前注册的监听器总数 */
@@ -1486,6 +1527,7 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
         message: MutableMessage<AllEvents, Meta>;
         listeners: FastEventListeners<AllEvents, Expand<FastEventMeta & Meta & Record<string, any>>>;
         anyListener: TypedFastEventAnyListener<AllEvents, Expand<FastEventMeta & Meta & Record<string, any>>>;
+        listener: FastEventCommonListener<FastEventMessage, Expand<FastEventMeta & Meta & Record<string, any>>>;
     };
     /**
      * 创建FastEvent实例
@@ -1505,6 +1547,26 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
     get meta(): Meta;
     /** 获取事件发射器的唯一标识符 */
     get id(): string;
+    /** 获取事件发射器的唯一标识符 */
+    get title(): string;
+    get hooks(): FastEventHooks;
+    private _execAfterExecuteListener;
+    /**
+     * 执行Hook
+     *
+     * AfterExecuteListener为什么需要特别处理？
+     *
+     * 因为AfterExecuteListener是在监听器执行完成后调用
+     * 并且将监听器的结果传入，但是监听器有可能返回Promise
+     * 因为需要等等Promise resolve，再调用AfterExecuteListener
+     *
+     *
+     * @param hookName
+     * @param args
+     * @param onlyAsyncHook 只运行异步HOOK
+     * @returns
+     */
+    private _executeHooks;
     /**
      * 初始化选项
      *
@@ -1525,7 +1587,6 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * @private
      */
     private _addListener;
-    private _enableDevTools;
     /**
      *
      * 根据parts路径遍历监听器树，并在最后的节点上执行回调函数
@@ -1544,13 +1605,12 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      */
     private _removeListener;
     /**
-     * 调用onAddListener HOOK
+     * 创建异步迭代监听器
      * @param type
-     * @param listener
      * @param options
      * @returns
      */
-    private _onAddListener;
+    private _createAyncIteratorListener;
     /**
      * 注册事件监听器
      * @param type - 事件类型，支持以下格式：
@@ -1575,7 +1635,7 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * emitter.on('event', handler, { count: 3 });
      * ```
      */
-    on<T extends string = KeyOf<Events> | "**">(type: T, options?: FastEventListenOptions<AllEvents, Meta>): T extends IsTransformedEvent<AllEvents, T> ? FastEventIterator<T extends "**" ? IsAllTransformed<Events> extends true ? PayloadValues<AllEvents> : any : PickPayload<ValueOf<GetClosestEvents<AllEvents, T>>>> : FastEventIterator<T extends "**" ? MutableMessage<AllEvents> : GetClosestMessage<Events, T, Meta>>;
+    on<T extends string = KeyOf<Events> | "**">(type: T, options?: FastEventListenOptions<AllEvents, Meta>): T extends IsTransformedEvent<AllEvents, T> ? WithListenerDecorator<FastEventIterator<T extends "**" ? IsAllTransformed<Events> extends true ? PayloadValues<AllEvents> : any : PickPayload<ValueOf<GetClosestEvents<AllEvents, T>>>>> : WithListenerDecorator<FastEventIterator<T extends "**" ? MutableMessage<AllEvents> : GetClosestMessage<Events, T, Meta>>>;
     on<T extends string = KeyOf<Events> | "**">(type: T, listener: FastEventCommonListener<T extends IsTransformedEvent<AllEvents, T> ? PickPayload<ValueOf<GetClosestEvents<Events, T>>> : T extends "**" ? MutableMessage<Events> : GetClosestMessage<Events, T, Meta>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
     /**
      * 注册一次性事件监听器
@@ -1683,7 +1743,6 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
     private _traverseToPath;
     private _traverseListeners;
     private _onListenerError;
-    private _setListenerFlags;
     /**
      * 执行单个监听器函数
      * @param listener - 要执行的监听器函数或包装过的监听器对象
@@ -2028,4 +2087,13 @@ declare function isClass(target: unknown): target is new (...args: any[]) => any
 
 declare function isFastEvent(target: any): target is FastEvent;
 
-export { AbortError, type Add, type AllowCall, type ApplyWildcardEvents, type AssertFastMessage, type AssertRecord, type AssertString, type AtPayloads, CancelError, type ChangeFieldType, type Class, type ClosestMatch, type ContainsWildcard, type Decrement, type DeepPartial, type Dict, type Equal, type Expand, type ExpandRecord, type ExpandWildcard, type ExtendWildcardEvents, type Fallback, FastEvent, type FastEventCommonListener, type FastEventCommonMessage, type FastEventEmitMessage, FastEventError, FastEventIterator, type FastEventIteratorOptions, type FastEventListenOptions, type FastEventListener, type FastEventListenerArgs, FastEventListenerFlags, type FastEventListenerMeta, type FastEventListenerNode, type FastEventListeners, type FastEventMessage, type FastEventMessageExtends, type FastEventMeta, type FastEventOptions, FastEventScope, type FastEventScopeMeta, type FastEventScopeOptions, type FastEventSubscriber, type FastEvents, type FastListeners, type FastMessagePayload, type FastQueueOverflows, type FirstObjectItem, type FirstOfUnion, type GetClosestEventName, type GetClosestEventNameTuple, type GetClosestEventPayload, type GetClosestEventTuple, type GetClosestEvents, type GetFixedPartCount, type GetMatchedEventNames, type GetPartCount, type GetPartCountAcc, type GetPayload, type GetWildcardCount, type GetWildcardEventList, type IFastEventScope, type IfNever, type IndexOfMax, type IndexOfMin, type IsAllTransformed, type IsAny, type IsAnyRecord, type IsFullWildcard, type IsMatchEventName, type IsMultiWildcard, type IsNever, type IsSemiWildcard, type IsTransformedEvent, type IsWildcardPart, type Join, type KeyOf, type Keys, type Max, type Merge, type MergeStrings, type MergeUnion, type Min, type MutableMessage, type MutableRecord, type NormalEvents, type NotEqual, type NotPayload, type ObjectKeys, type OmitTransformedEvents, type OptionalKeys, type Overloads, type OverrideOptions, type PayloadValues, type PickEqualRecord, type PickInlcudeDelimiterRecord, type PickNotEqualRecord, type PickNotInlcudeDelimiterRecord, type PickPayload, type PickTransformedEvents, type PrefixNumber, type ProcessSegments, QueueOverflowError, type RemoveEmptyObject, type ReplaceWildcard, type RequiredItems, type RequiredKeys, type ScopeEvents, type Slice, type Split, type SplitPath, type StrictEqual, TimeoutError, type ToFixedCounts, type ToKeyPrioritys, type ToWildcardMessage, type TransformedEvents, type Tuple, type TypedFastEventAnyListener, type TypedFastEventListener, type TypedFastEventMessage, type TypedFastEventMessageOptional, type UnTransformedEvents, UnboundError, type Union, type UnionToIntersection, type Unique, type ValueOf, type WildcardEvents, type WildcardKeyToObject, type WildcardKeys, type WildcardStyle, __FastEventScope__, __FastEvent__, __expandable__, createAsyncEventIterator, expandable, isClass, type isEmpty, isExpandable, isFastEvent, isFastEventMessage, isFastEventScope, isFunction, isPathMatched, isString, isSubsctiber };
+/**
+ * 判断是否为可异步迭代对象（AsyncIterable）
+ * 即具有 Symbol.asyncIterator 方法的对象
+ *
+ * @param value - 要检查的值
+ * @returns 如果是可异步迭代对象返回 true
+ */
+declare function isAsyncIterable<T = any>(value: unknown): value is AsyncIterable<T>;
+
+export { AbortError, type Add, type AddAfterListenerHook, type AddBeforeListenerHook, type AfterExecuteListenerHook, type AllowCall, type ApplyWildcardEvents, type AssertFastMessage, type AssertRecord, type AssertString, type AtPayloads, type BeforeExecuteListenerHook, CancelError, type ChangeFieldType, type Class, type ClearListenersHook, type ClosestMatch, type ContainsWildcard, type Decrement, type DeepPartial, type Dict, type Equal, type Expand, type ExpandRecord, type ExpandWildcard, type ExtendWildcardEvents, type Fallback, FastEvent, type FastEventCommonListener, type FastEventCommonMessage, type FastEventEmitMessage, FastEventError, type FastEventHooks, FastEventIterator, type FastEventIteratorOptions, type FastEventListenOptions, type FastEventListener, type FastEventListenerArgs, FastEventListenerFlags, type FastEventListenerMeta, type FastEventListenerNode, type FastEventListeners, type FastEventMessage, type FastEventMessageExtends, type FastEventMeta, type FastEventOptions, FastEventScope, type FastEventScopeMeta, type FastEventScopeOptions, type FastEventSubscriber, type FastEvents, type FastListeners, type FastMessagePayload, type FastQueueOverflows, type FirstObjectItem, type FirstOfUnion, type GetClosestEventName, type GetClosestEventNameTuple, type GetClosestEventPayload, type GetClosestEventTuple, type GetClosestEvents, type GetFixedPartCount, type GetMatchedEventNames, type GetPartCount, type GetPartCountAcc, type GetPayload, type GetWildcardCount, type GetWildcardEventList, type IFastEventScope, type IListenerDecoratorBuilder, type IfNever, type IndexOfMax, type IndexOfMin, type IsAllTransformed, type IsAny, type IsAnyRecord, type IsFullWildcard, type IsMatchEventName, type IsMultiWildcard, type IsNever, type IsSemiWildcard, type IsTransformedEvent, type IsWildcardPart, type Join, type KeyOf, type Keys, type ListenerDecorator, type ListenerErrorHook, type Max, type Merge, type MergeStrings, type MergeUnion, type Min, type MutableMessage, type MutableRecord, type NormalEvents, type NotEqual, type NotPayload, type ObjectKeys, type OmitTransformedEvents, type OptionalKeys, type Overloads, type OverrideOptions, type PayloadValues, type PickEqualRecord, type PickInlcudeDelimiterRecord, type PickNotEqualRecord, type PickNotInlcudeDelimiterRecord, type PickPayload, type PickTransformedEvents, type PrefixNumber, type ProcessSegments, QueueOverflowError, type RemoveEmptyObject, type RemoveListenerHook, type ReplaceWildcard, type RequiredItems, type RequiredKeys, type ScopeEvents, type Slice, type Split, type SplitPath, type StrictEqual, TimeoutError, type ToFixedCounts, type ToKeyPrioritys, type ToWildcardMessage, type TransformedEvents, type Tuple, type TypedFastEventAnyListener, type TypedFastEventListener, type TypedFastEventMessage, type TypedFastEventMessageOptional, type UnTransformedEvents, UnboundError, type Union, type UnionToIntersection, type Unique, type ValueOf, type WildcardEvents, type WildcardKeyToObject, type WildcardKeys, type WildcardStyle, type WithListenerDecorator, __FastEventScope__, __FastEvent__, __expandable__, createAsyncEventIterator, expandable, isAsyncIterable, isClass, type isEmpty, isExpandable, isFastEvent, isFastEventMessage, isFastEventScope, isFunction, isPathMatched, isString, isSubsctiber };