@homer0/events-hub 6.0.2 → 6.0.5

package/dist/index.js

@@ -1,2 +1,2 @@
-var d=class{events={};onceWrappers={};getSubscribers(e){return this.events[e]||(this.events[e]=[]),this.events[e]}on(e,r){return(Array.isArray(e)?e:[e]).forEach(a=>{let n=this.getSubscribers(a);n.includes(r)||n.push(r)}),()=>this.off(e,r)}once(e,r){let o=Array.isArray(e)?e:[e],a=o.reduce((n,s)=>{if(n)return n;let t=this.onceWrappers[s];if(Array.isArray(t)){let i=t.find(F=>F.original===r);return i?i.wrapper:null}return this.onceWrappers[s]=[],null},null);if(!a){let n=(...s)=>r(...s);n.once=!0,a=n,o.forEach(s=>{this.onceWrappers[s].push({wrapper:a,original:r})})}return this.on(e,a)}off(e,r){let o=Array.isArray(e),n=(o?e:[e]).map(s=>{let t=this.getSubscribers(s),i=this.onceWrappers[s],F=!1,c=t.indexOf(r);if(c>-1){if(F=!0,"once"in r&&i){let l=i.findIndex(p=>p.wrapper===r);i.splice(l,1)}t.splice(c,1)}else if(i&&(c=i.findIndex(l=>l.original===r),c>-1)){F=!0;let l=t.indexOf(i[c].original);t.splice(l,1),i.splice(c,1)}return F});return o?n:n[0]}emit(e,...r){let o=[];(Array.isArray(e)?e:[e]).forEach(n=>{this.getSubscribers(n).forEach(s=>{s(...r),"once"in s&&o.push({event:n,listener:s})})}),o.forEach(n=>this.off(n.event,n.listener))}async reduce(e,r,...o){let a=Array.isArray(e)?e:[e],n=[],s=await a.reduce((t,i)=>t.then(F=>this.getSubscribers(i).reduce((l,p)=>l.then(g=>{let f;Array.isArray(g)?f=g.slice():typeof g=="object"?f={...g}:f=g;let u=p(f,...o);return"once"in p&&n.push({event:i,listener:p}),u}),Promise.resolve(F))),Promise.resolve(r));return n.forEach(t=>this.off(t.event,t.listener)),s}reduceSync(e,r,...o){let a=Array.isArray(e)?e:[e],n=[],s=a.reduce((t,i)=>this.getSubscribers(i).reduce((c,l)=>{let p;Array.isArray(c)?p=c.slice():typeof c=="object"?p={...c}:p=c;let g=l(p,...o);return"once"in l&&n.push({event:i,listener:l}),g},t),r);return n.forEach(t=>this.off(t.event,t.listener)),s}},h=()=>new d;export{d as EventsHub,h as eventsHub};
+var e=class{events={};onceWrappers={};getSubscribers(e){return this.events[e]||(this.events[e]=[]),this.events[e]}on(e,t){return(Array.isArray(e)?e:[e]).forEach(e=>{let n=this.getSubscribers(e);n.includes(t)||n.push(t)}),()=>this.off(e,t)}once(e,t){let n=Array.isArray(e)?e:[e],r=n.reduce((e,n)=>{if(e)return e;let r=this.onceWrappers[n];if(Array.isArray(r)){let e=r.find(e=>e.original===t);return e?e.wrapper:null}return this.onceWrappers[n]=[],null},null);if(!r){let e=(...e)=>t(...e);e.once=!0,r=e,n.forEach(e=>{this.onceWrappers[e].push({wrapper:r,original:t})})}return this.on(e,r)}off(e,t){let n=Array.isArray(e),r=(n?e:[e]).map(e=>{let n=this.getSubscribers(e),r=this.onceWrappers[e],i=!1,a=n.indexOf(t);if(a>-1){if(i=!0,`once`in t&&r){let e=r.findIndex(e=>e.wrapper===t);r.splice(e,1)}n.splice(a,1)}else if(r&&(a=r.findIndex(e=>e.original===t),a>-1)){i=!0;let e=n.indexOf(r[a].original);n.splice(e,1),r.splice(a,1)}return i});return n?r:r[0]}emit(e,...t){let n=[];(Array.isArray(e)?e:[e]).forEach(e=>{this.getSubscribers(e).forEach(r=>{r(...t),`once`in r&&n.push({event:e,listener:r})})}),n.forEach(e=>this.off(e.event,e.listener))}async reduce(e,t,...n){let r=Array.isArray(e)?e:[e],i=[],a=await r.reduce((e,t)=>e.then(e=>this.getSubscribers(t).reduce((e,r)=>e.then(e=>{let a;a=Array.isArray(e)?e.slice():typeof e==`object`?{...e}:e;let o=r(a,...n);return`once`in r&&i.push({event:t,listener:r}),o}),Promise.resolve(e))),Promise.resolve(t));return i.forEach(e=>this.off(e.event,e.listener)),a}reduceSync(e,t,...n){let r=Array.isArray(e)?e:[e],i=[],a=r.reduce((e,t)=>this.getSubscribers(t).reduce((e,r)=>{let a;a=Array.isArray(e)?e.slice():typeof e==`object`?{...e}:e;let o=r(a,...n);return`once`in r&&i.push({event:t,listener:r}),o},e),t);return i.forEach(e=>this.off(e.event,e.listener)),a}};const t=()=>new e;export{e as EventsHub,t as eventsHub};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// oxlint-disable-next-line typescript/no-explicit-any -- Generic function arguments and return type must remain any for listener inference.\ntype GenericFn = (...args: any[]) => any;\ntype GenericParams = Parameters<GenericFn>;\ntype OnceWrapperFn = GenericFn & {\n  once: boolean;\n};\n/**\n * When the service receives a \"once subscription\", it needs to track the listener so it\n * gets removed after being called once, and to avoid modifying the original function, it\n * creates a wrapper function that has the \"once\" property set to true. The wrapper and\n * the original function are stored in case `off` is called before the wrapper gets\n * triggered; it will receive the original function, not the wrapper, so the class needs a\n * way to map them together.\n */\ntype OnceWrapper = {\n  /**\n   * A simple wrapper for the original listener, with the difference that it has a `once`\n   * property set to `true`.\n   */\n  wrapper: OnceWrapperFn;\n  /**\n   * The original listener that will be called once.\n   */\n  original: GenericFn;\n};\n/**\n * A minimal implementation of an events handler service.\n */\nexport class EventsHub {\n  /**\n   * A dictionary of the events and their listeners.\n   */\n  protected events: Record<string, GenericFn[]> = {};\n  /**\n   * A dictionary of wrappers that were created for \"one time subscriptions\". This is\n   * used by the {@link EventsHub.off}: if it doesn't find the subscriber as it is, it\n   * will look for a wrapper and remove it.\n   */\n  protected onceWrappers: Record<string, OnceWrapper[]> = {};\n  /**\n   * Gets all the listeners for a specific event.\n   * The list is returned by reference, so it can be modified once obtained.\n   *\n   * @param event  The name of the event.\n   */\n  protected getSubscribers(event: string): (GenericFn | OnceWrapperFn)[] {\n    if (!this.events[event]) {\n      this.events[event] = [];\n    }\n\n    return this.events[event]!;\n  }\n  on<ListenerFn extends GenericFn = GenericFn>(\n    event: string,\n    listener: ListenerFn,\n  ): () => boolean;\n  on<ListenerFn extends GenericFn = GenericFn>(\n    event: string[],\n    listener: ListenerFn,\n  ): () => boolean[];\n  on<ListenerFn extends GenericFn = GenericFn>(\n    event: string | string[],\n    listener: ListenerFn,\n  ): () => boolean | boolean[];\n  /**\n   * Adds a new event listener.\n   *\n   * @param event     An event name or a list of them.\n   * @param listener  The listener function.\n   * @returns An unsubscribe function to remove the listene(s).\n   * @template ListenerFn  The type of the listener function.\n   * @example\n   *\n   *   const events = new EventsHub();\n   *   type Listener = (arg0: string) => void;\n   *   const unsubscribe = events.on<Listener>('event', (arg0) => {\n   *     console.log(`Event received: ${arg0}`);\n   *   });\n   *\n   */\n  on<ListenerFn extends GenericFn = GenericFn>(\n    event: string | string[],\n    listener: ListenerFn,\n  ): () => boolean | boolean[] {\n    const events = Array.isArray(event) ? event : [event];\n    events.forEach((name) => {\n      const subscribers = this.getSubscribers(name);\n      if (!subscribers.includes(listener)) {\n        subscribers.push(listener);\n      }\n    });\n\n    return () => this.off<ListenerFn>(event, listener);\n  }\n  once<ListenerFn extends GenericFn = GenericFn>(\n    event: string,\n    listener: ListenerFn,\n  ): () => boolean;\n  once<ListenerFn extends GenericFn = GenericFn>(\n    event: string[],\n    listener: ListenerFn,\n  ): () => boolean[];\n  once<ListenerFn extends GenericFn = GenericFn>(\n    event: string | string[],\n    listener: ListenerFn,\n  ): () => boolean | boolean[];\n  /**\n   * Adds an event listener that will only be executed once.\n   *\n   * @param event     An event name or a list of them.\n   * @param listener  The listener function.\n   * @returns An unsubscribe function to remove the listener(s).\n   * @template ListenerFn  The type of the listener function.\n   * @example\n   *\n   *   const events = new EventsHub();\n   *   type Listener = (arg0: string) => void;\n   *   const unsubscribe = events.once<Listener>('event', (arg0) => {\n   *     console.log(`Event received: ${arg0}`);\n   *   });\n   *\n   */\n  once<ListenerFn extends GenericFn = GenericFn>(\n    event: string | string[],\n    listener: ListenerFn,\n  ): () => boolean | boolean[] {\n    const events = Array.isArray(event) ? event : [event];\n    // Try to find an existing wrapper.\n    let wrapper = events.reduce<OnceWrapperFn | null>((acc, name) => {\n      // A previous iteration found a wrapper, so `continue`.\n      if (acc) return acc;\n\n      // A list of wrappers exists for the event, so, let's try an find one for this function.\n      const onceWrapper = this.onceWrappers[name];\n      if (Array.isArray(onceWrapper)) {\n        const existing = onceWrapper.find((item) => item.original === listener);\n        if (existing) {\n          return existing.wrapper;\n        }\n\n        return null;\n      }\n\n      // The list didn't even exists, let's at least create it.\n      this.onceWrappers[name] = [];\n      return null;\n    }, null);\n\n    if (!wrapper) {\n      // oxlint-disable-next-line typescript/no-explicit-any -- The wrapper must retain any arguments for listener inference.\n      const newWrapper = (...args: any[]) => listener(...args);\n      newWrapper.once = true;\n      wrapper = newWrapper;\n      events.forEach((name) => {\n        this.onceWrappers[name]!.push({\n          wrapper: wrapper!,\n          original: listener,\n        });\n      });\n    }\n\n    return this.on(event, wrapper);\n  }\n  off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(\n    event: string[],\n    listener: ListenerFn,\n  ): boolean[];\n  off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(\n    event: string,\n    listener: ListenerFn,\n  ): boolean;\n  off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(\n    event: string | string[],\n    listener: ListenerFn,\n  ): boolean | boolean[];\n  /**\n   * Removes an event listener.\n   *\n   * @param event     An event name or a list of them.\n   * @param listener  The listener function.\n   * @returns If `event` was a `string`, it will return whether or not the listener\n   *          was found and removed; but if `event`\n   *          was an `Array`, it will return a list of boolean values.\n   * @template ListenerFn  The type of the listener function.\n   * @example\n   *\n   *   const events = new EventsHub();\n   *   const listener = (arg0) => {\n   *     console.log(`Event received: ${arg0}`);\n   *   };\n   *   events.on('event', listener); // subscribe.\n   *   events.off('event', listener); // manually unsubscribe.\n   *\n   */\n  off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(\n    event: string | string[],\n    listener: ListenerFn,\n  ): boolean | boolean[] {\n    const isArray = Array.isArray(event);\n    const events = isArray ? event : [event];\n    const result = events.map((name) => {\n      const subscribers = this.getSubscribers(name);\n      const onceSubscribers = this.onceWrappers[name];\n      let found = false;\n      let index = subscribers.indexOf(listener);\n      if (index > -1) {\n        found = true;\n        /**\n         * If the listener had the `once` flag, then it's a wrapper, so it needs to remove\n         * it from the wrappers list too.\n         */\n        if ('once' in listener && onceSubscribers) {\n          const wrapperIndex = onceSubscribers.findIndex(\n            (item) => item.wrapper === listener,\n          );\n          onceSubscribers.splice(wrapperIndex, 1);\n        }\n        subscribers.splice(index, 1);\n      } else if (onceSubscribers) {\n        /**\n         * If it couldn't found the subscriber, maybe it's because it's the original\n         * listener of a wrapper.\n         */\n        index = onceSubscribers.findIndex((item) => item.original === listener);\n        if (index > -1) {\n          found = true;\n          const originalIndex = subscribers.indexOf(onceSubscribers[index]!.original);\n          subscribers.splice(originalIndex, 1);\n          onceSubscribers.splice(index, 1);\n        }\n      }\n\n      return found;\n    });\n\n    return isArray ? result : result[0]!;\n  }\n  /**\n   * Emits an event and call all its listeners.\n   *\n   * @param event  An event name or a list of them.\n   * @param args   A list of parameters to send to the listeners.\n   * @template Args  The type of the parameters to send to the listeners.\n   * @example\n   *\n   *   const events = new EventsHub();\n   *   events.on('event', (arg0) => {\n   *     console.log(`Event received: ${arg0}`);\n   *   });\n   *   events.emit('event', 'Hello'); // prints \"Event received: Hello\"\n   *\n   */\n  emit<Args extends GenericParams>(event: string | string[], ...args: Args): void {\n    const toClean: { event: string; listener: GenericFn }[] = [];\n    const events = Array.isArray(event) ? event : [event];\n    events.forEach((name) => {\n      this.getSubscribers(name).forEach((subscriber) => {\n        subscriber(...args);\n        if ('once' in subscriber) {\n          toClean.push({\n            event: name,\n            listener: subscriber,\n          });\n        }\n      });\n    });\n\n    toClean.forEach((info) => this.off(info.event, info.listener));\n  }\n  /**\n   * Asynchronously reduces a target using an event. It's like emit, but the events\n   * listener return a modified (or not) version of the `target`.\n   *\n   * @param event   An event name or a list of them.\n   * @param target  The variable to reduce with the reducers/listeners.\n   * @param args    A list of parameters to send to the reducers/listeners.\n   * @returns A version of the `target` processed by the listeners.\n   * @template Target  The type of the target.\n   * @template Args    The type of the parameters to send to the reducers/listeners.\n   * @example\n   *\n   *   const events = new EventsHub();\n   *   events.on('event', async (target, arg0) => {\n   *     const data = await fetch(`https://api.example.com/${arg0}`);\n   *     target.push(data);\n   *     return target;\n   *   });\n   *   const result = await events.reduce('event', [], 'Hello');\n   *   // result would be a list of data fetched from the API.\n   *\n   */\n  async reduce<Target, Args extends GenericParams>(\n    event: string | string[],\n    target: Target,\n    ...args: Args\n  ): Promise<Target> {\n    const events = Array.isArray(event) ? event : [event];\n    const toClean: { event: string; listener: GenericFn }[] = [];\n    const result = await events.reduce<Promise<Target>>(\n      (eventAcc, name) =>\n        eventAcc.then((eventCurrent) => {\n          const subscribers = this.getSubscribers(name);\n          return subscribers.reduce(\n            (subAcc, subscriber) =>\n              subAcc.then((subCurrent) => {\n                let useCurrent;\n                if (Array.isArray(subCurrent)) {\n                  useCurrent = subCurrent.slice();\n                } else if (typeof subCurrent === 'object') {\n                  useCurrent = { ...subCurrent };\n                } else {\n                  useCurrent = subCurrent;\n                }\n\n                const nextStep = subscriber(...[useCurrent, ...args]);\n                if ('once' in subscriber) {\n                  toClean.push({\n                    event: name,\n                    listener: subscriber,\n                  });\n                }\n\n                return nextStep;\n              }),\n            Promise.resolve(eventCurrent),\n          );\n        }),\n      Promise.resolve(target),\n    );\n\n    toClean.forEach((info) => this.off(info.event, info.listener));\n\n    return result;\n  }\n  /**\n   * Synchronously reduces a target using an event. It's like emit, but the events\n   * listener return a modified (or not) version of the `target`.\n   *\n   * @param event   An event name or a list of them.\n   * @param target  The variable to reduce with the reducers/listeners.\n   * @param args    A list of parameters to send to the reducers/listeners.\n   * @returns A version of the `target` processed by the listeners.\n   * @template Target  The type of the target.\n   * @template Args    The type of the parameters to send to the reducers/listeners.\n   * @example\n   *\n   *   const events = new EventsHub();\n   *   events.on('event', (target, arg0) => {\n   *     target.push(arg0);\n   *     return target;\n   *   });\n   *   events.reduce('event', [], 'Hello'); // returns ['Hello']\n   *\n   */\n  reduceSync<Target, ReducerArgs extends GenericParams>(\n    event: string | string[],\n    target: Target,\n    ...args: ReducerArgs\n  ): Target {\n    const events = Array.isArray(event) ? event : [event];\n    const toClean: { event: string; listener: GenericFn }[] = [];\n    const result = events.reduce((eventAcc, name) => {\n      const subscribers = this.getSubscribers(name);\n      return subscribers.reduce((subAcc, subscriber) => {\n        let useCurrent;\n        if (Array.isArray(subAcc)) {\n          useCurrent = subAcc.slice();\n        } else if (typeof subAcc === 'object') {\n          useCurrent = { ...subAcc };\n        } else {\n          useCurrent = subAcc;\n        }\n\n        const nextStep = subscriber(...[useCurrent, ...args]);\n        if ('once' in subscriber) {\n          toClean.push({\n            event: name,\n            listener: subscriber,\n          });\n        }\n\n        return nextStep;\n      }, eventAcc);\n    }, target);\n\n    toClean.forEach((info) => this.off(info.event, info.listener));\n    return result;\n  }\n}\n/**\n * Shorthand for `new EventsHub()`.\n *\n * @returns A new instance of {@link EventsHub}.\n */\nexport const eventsHub = () => new EventsHub();\n"],"mappings":"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","names":["EventsHub","event","listener","name","subscribers","events","wrapper","acc","onceWrapper","existing","item","newWrapper","args","isArray","result","onceSubscribers","found","index","wrapperIndex","originalIndex","toClean","subscriber","info","target","eventAcc","eventCurrent","subAcc","subCurrent","useCurrent","nextStep","eventsHub"]}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["// oxlint-disable-next-line typescript/no-explicit-any -- Generic function arguments and return type must remain any for listener inference.\ntype GenericFn = (...args: any[]) => any;\ntype GenericParams = Parameters<GenericFn>;\ntype OnceWrapperFn = GenericFn & {\n  once: boolean;\n};\n/**\n * When the service receives a \"once subscription\", it needs to track the listener so it\n * gets removed after being called once, and to avoid modifying the original function, it\n * creates a wrapper function that has the \"once\" property set to true. The wrapper and\n * the original function are stored in case `off` is called before the wrapper gets\n * triggered; it will receive the original function, not the wrapper, so the class needs a\n * way to map them together.\n */\ntype OnceWrapper = {\n  /**\n   * A simple wrapper for the original listener, with the difference that it has a `once`\n   * property set to `true`.\n   */\n  wrapper: OnceWrapperFn;\n  /** The original listener that will be called once. */\n  original: GenericFn;\n};\n/** A minimal implementation of an events handler service. */\nexport class EventsHub {\n  /** A dictionary of the events and their listeners. */\n  protected events: Record<string, GenericFn[]> = {};\n  /**\n   * A dictionary of wrappers that were created for \"one time subscriptions\". This is used\n   * by the {@link EventsHub.off}: if it doesn't find the subscriber as it is, it will look\n   * for a wrapper and remove it.\n   */\n  protected onceWrappers: Record<string, OnceWrapper[]> = {};\n  /**\n   * Gets all the listeners for a specific event. The list is returned by reference, so it\n   * can be modified once obtained.\n   *\n   * @param event The name of the event.\n   */\n  protected getSubscribers(event: string): (GenericFn | OnceWrapperFn)[] {\n    if (!this.events[event]) {\n      this.events[event] = [];\n    }\n\n    return this.events[event]!;\n  }\n  on<ListenerFn extends GenericFn = GenericFn>(\n    event: string,\n    listener: ListenerFn,\n  ): () => boolean;\n  on<ListenerFn extends GenericFn = GenericFn>(\n    event: string[],\n    listener: ListenerFn,\n  ): () => boolean[];\n  on<ListenerFn extends GenericFn = GenericFn>(\n    event: string | string[],\n    listener: ListenerFn,\n  ): () => boolean | boolean[];\n  /**\n   * Adds a new event listener.\n   *\n   * @example\n   *   const events = new EventsHub();\n   *   type Listener = (arg0: string) => void;\n   *   const unsubscribe = events.on<Listener>('event', (arg0) => {\n   *     console.log(`Event received: ${arg0}`);\n   *   });\n   *\n   * @template ListenerFn The type of the listener function.\n   * @param event An event name or a list of them.\n   * @param listener The listener function.\n   * @returns An unsubscribe function to remove the listene(s).\n   */\n  on<ListenerFn extends GenericFn = GenericFn>(\n    event: string | string[],\n    listener: ListenerFn,\n  ): () => boolean | boolean[] {\n    const events = Array.isArray(event) ? event : [event];\n    events.forEach((name) => {\n      const subscribers = this.getSubscribers(name);\n      if (!subscribers.includes(listener)) {\n        subscribers.push(listener);\n      }\n    });\n\n    return () => this.off<ListenerFn>(event, listener);\n  }\n  once<ListenerFn extends GenericFn = GenericFn>(\n    event: string,\n    listener: ListenerFn,\n  ): () => boolean;\n  once<ListenerFn extends GenericFn = GenericFn>(\n    event: string[],\n    listener: ListenerFn,\n  ): () => boolean[];\n  once<ListenerFn extends GenericFn = GenericFn>(\n    event: string | string[],\n    listener: ListenerFn,\n  ): () => boolean | boolean[];\n  /**\n   * Adds an event listener that will only be executed once.\n   *\n   * @example\n   *   const events = new EventsHub();\n   *   type Listener = (arg0: string) => void;\n   *   const unsubscribe = events.once<Listener>('event', (arg0) => {\n   *     console.log(`Event received: ${arg0}`);\n   *   });\n   *\n   * @template ListenerFn The type of the listener function.\n   * @param event An event name or a list of them.\n   * @param listener The listener function.\n   * @returns An unsubscribe function to remove the listener(s).\n   */\n  once<ListenerFn extends GenericFn = GenericFn>(\n    event: string | string[],\n    listener: ListenerFn,\n  ): () => boolean | boolean[] {\n    const events = Array.isArray(event) ? event : [event];\n    // Try to find an existing wrapper.\n    let wrapper = events.reduce<OnceWrapperFn | null>((acc, name) => {\n      // A previous iteration found a wrapper, so `continue`.\n      if (acc) return acc;\n\n      // A list of wrappers exists for the event, so, let's try an find one for this function.\n      const onceWrapper = this.onceWrappers[name];\n      if (Array.isArray(onceWrapper)) {\n        const existing = onceWrapper.find((item) => item.original === listener);\n        if (existing) {\n          return existing.wrapper;\n        }\n\n        return null;\n      }\n\n      // The list didn't even exists, let's at least create it.\n      this.onceWrappers[name] = [];\n      return null;\n    }, null);\n\n    if (!wrapper) {\n      // oxlint-disable-next-line typescript/no-explicit-any -- The wrapper must retain any arguments for listener inference.\n      const newWrapper = (...args: any[]) => listener(...args);\n      newWrapper.once = true;\n      wrapper = newWrapper;\n      events.forEach((name) => {\n        this.onceWrappers[name]!.push({\n          wrapper: wrapper!,\n          original: listener,\n        });\n      });\n    }\n\n    return this.on(event, wrapper);\n  }\n  off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(\n    event: string[],\n    listener: ListenerFn,\n  ): boolean[];\n  off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(\n    event: string,\n    listener: ListenerFn,\n  ): boolean;\n  off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(\n    event: string | string[],\n    listener: ListenerFn,\n  ): boolean | boolean[];\n  /**\n   * Removes an event listener.\n   *\n   * @example\n   *   const events = new EventsHub();\n   *   const listener = (arg0) => {\n   *     console.log(`Event received: ${arg0}`);\n   *   };\n   *   events.on('event', listener); // subscribe.\n   *   events.off('event', listener); // manually unsubscribe.\n   *\n   * @template ListenerFn The type of the listener function.\n   * @param event An event name or a list of them.\n   * @param listener The listener function.\n   * @returns If `event` was a `string`, it will return whether or not the listener was\n   *   found and removed; but if `event` was an `Array`, it will return a list of boolean\n   *   values.\n   */\n  off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(\n    event: string | string[],\n    listener: ListenerFn,\n  ): boolean | boolean[] {\n    const isArray = Array.isArray(event);\n    const events = isArray ? event : [event];\n    const result = events.map((name) => {\n      const subscribers = this.getSubscribers(name);\n      const onceSubscribers = this.onceWrappers[name];\n      let found = false;\n      let index = subscribers.indexOf(listener);\n      if (index > -1) {\n        found = true;\n        /**\n         * If the listener had the `once` flag, then it's a wrapper, so it needs to remove\n         * it from the wrappers list too.\n         */\n        if ('once' in listener && onceSubscribers) {\n          const wrapperIndex = onceSubscribers.findIndex(\n            (item) => item.wrapper === listener,\n          );\n          onceSubscribers.splice(wrapperIndex, 1);\n        }\n        subscribers.splice(index, 1);\n      } else if (onceSubscribers) {\n        /**\n         * If it couldn't found the subscriber, maybe it's because it's the original\n         * listener of a wrapper.\n         */\n        index = onceSubscribers.findIndex((item) => item.original === listener);\n        if (index > -1) {\n          found = true;\n          const originalIndex = subscribers.indexOf(onceSubscribers[index]!.original);\n          subscribers.splice(originalIndex, 1);\n          onceSubscribers.splice(index, 1);\n        }\n      }\n\n      return found;\n    });\n\n    return isArray ? result : result[0]!;\n  }\n  /**\n   * Emits an event and call all its listeners.\n   *\n   * @example\n   *   const events = new EventsHub();\n   *   events.on('event', (arg0) => {\n   *     console.log(`Event received: ${arg0}`);\n   *   });\n   *   events.emit('event', 'Hello'); // prints \"Event received: Hello\"\n   *\n   * @template Args The type of the parameters to send to the listeners.\n   * @param event An event name or a list of them.\n   * @param args A list of parameters to send to the listeners.\n   */\n  emit<Args extends GenericParams>(event: string | string[], ...args: Args): void {\n    const toClean: { event: string; listener: GenericFn }[] = [];\n    const events = Array.isArray(event) ? event : [event];\n    events.forEach((name) => {\n      this.getSubscribers(name).forEach((subscriber) => {\n        subscriber(...args);\n        if ('once' in subscriber) {\n          toClean.push({\n            event: name,\n            listener: subscriber,\n          });\n        }\n      });\n    });\n\n    toClean.forEach((info) => this.off(info.event, info.listener));\n  }\n  /**\n   * Asynchronously reduces a target using an event. It's like emit, but the events\n   * listener return a modified (or not) version of the `target`.\n   *\n   * @example\n   *   const events = new EventsHub();\n   *   events.on('event', async (target, arg0) => {\n   *     const data = await fetch(`https://api.example.com/${arg0}`);\n   *     target.push(data);\n   *     return target;\n   *   });\n   *   const result = await events.reduce('event', [], 'Hello');\n   *   // result would be a list of data fetched from the API.\n   *\n   * @template Target The type of the target.\n   * @template Args The type of the parameters to send to the reducers/listeners.\n   * @param event An event name or a list of them.\n   * @param target The variable to reduce with the reducers/listeners.\n   * @param args A list of parameters to send to the reducers/listeners.\n   * @returns A version of the `target` processed by the listeners.\n   */\n  async reduce<Target, Args extends GenericParams>(\n    event: string | string[],\n    target: Target,\n    ...args: Args\n  ): Promise<Target> {\n    const events = Array.isArray(event) ? event : [event];\n    const toClean: { event: string; listener: GenericFn }[] = [];\n    const result = await events.reduce<Promise<Target>>(\n      (eventAcc, name) =>\n        eventAcc.then((eventCurrent) => {\n          const subscribers = this.getSubscribers(name);\n          return subscribers.reduce(\n            (subAcc, subscriber) =>\n              subAcc.then((subCurrent) => {\n                let useCurrent;\n                if (Array.isArray(subCurrent)) {\n                  useCurrent = subCurrent.slice();\n                } else if (typeof subCurrent === 'object') {\n                  useCurrent = { ...subCurrent };\n                } else {\n                  useCurrent = subCurrent;\n                }\n\n                const nextStep = subscriber(...[useCurrent, ...args]);\n                if ('once' in subscriber) {\n                  toClean.push({\n                    event: name,\n                    listener: subscriber,\n                  });\n                }\n\n                return nextStep;\n              }),\n            Promise.resolve(eventCurrent),\n          );\n        }),\n      Promise.resolve(target),\n    );\n\n    toClean.forEach((info) => this.off(info.event, info.listener));\n\n    return result;\n  }\n  /**\n   * Synchronously reduces a target using an event. It's like emit, but the events\n   * listener return a modified (or not) version of the `target`.\n   *\n   * @example\n   *   const events = new EventsHub();\n   *   events.on('event', (target, arg0) => {\n   *     target.push(arg0);\n   *     return target;\n   *   });\n   *   events.reduce('event', [], 'Hello'); // returns ['Hello']\n   *\n   * @template Target The type of the target.\n   * @template Args The type of the parameters to send to the reducers/listeners.\n   * @param event An event name or a list of them.\n   * @param target The variable to reduce with the reducers/listeners.\n   * @param args A list of parameters to send to the reducers/listeners.\n   * @returns A version of the `target` processed by the listeners.\n   */\n  reduceSync<Target, ReducerArgs extends GenericParams>(\n    event: string | string[],\n    target: Target,\n    ...args: ReducerArgs\n  ): Target {\n    const events = Array.isArray(event) ? event : [event];\n    const toClean: { event: string; listener: GenericFn }[] = [];\n    const result = events.reduce((eventAcc, name) => {\n      const subscribers = this.getSubscribers(name);\n      return subscribers.reduce((subAcc, subscriber) => {\n        let useCurrent;\n        if (Array.isArray(subAcc)) {\n          useCurrent = subAcc.slice();\n        } else if (typeof subAcc === 'object') {\n          useCurrent = { ...subAcc };\n        } else {\n          useCurrent = subAcc;\n        }\n\n        const nextStep = subscriber(...[useCurrent, ...args]);\n        if ('once' in subscriber) {\n          toClean.push({\n            event: name,\n            listener: subscriber,\n          });\n        }\n\n        return nextStep;\n      }, eventAcc);\n    }, target);\n\n    toClean.forEach((info) => this.off(info.event, info.listener));\n    return result;\n  }\n}\n/**\n * Shorthand for `new EventsHub()`.\n *\n * @returns A new instance of {@link EventsHub}.\n */\nexport const eventsHub = () => new EventsHub();\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@homer0/events-hub",
   "description": "A simple implementation of a pubsub service for handling events",
-  "version": "6.0.2",
+  "version": "6.0.5",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/homer0/packages.git",
@@ -35,11 +35,11 @@
     "src/"
   ],
   "devDependencies": {
-    "@homer0/oxlint-config": "0.3.0",
-    "@homer0/tsconfig": "5.0.0",
+    "@homer0/oxlint-config": "1.0.3",
+    "@homer0/tsconfig": "5.0.1",
     "@vitest/coverage-v8": "catalog:",
     "oxlint": "catalog:",
-    "tsup": "catalog:",
+    "tsdown": "catalog:",
     "typescript": "catalog:",
     "unplugin-swc": "catalog:",
     "vitest": "catalog:"
@@ -53,8 +53,8 @@
     "lint:file": "oxlint $@",
     "test": "vitest run $@",
     "types:check": "tsc --noEmit && tsc --noEmit --project ./tests/tsconfig.json",
-    "build": "tsup",
+    "build": "tsdown",
     "prepublishOnly": "pnpm run build"
   },
-  "gitHead": "07328e8a7b1f1b73c46837692c8821a7badca190"
+  "gitHead": "27e773cc888ac2ffe26fabd5976a45ea7fdfaae8"
 }

package/src/index.ts

@@ -18,30 +18,24 @@ type OnceWrapper = {
    * property set to `true`.
    */
   wrapper: OnceWrapperFn;
-  /**
-   * The original listener that will be called once.
-   */
+  /** The original listener that will be called once. */
   original: GenericFn;
 };
-/**
- * A minimal implementation of an events handler service.
- */
+/** A minimal implementation of an events handler service. */
 export class EventsHub {
-  /**
-   * A dictionary of the events and their listeners.
-   */
+  /** A dictionary of the events and their listeners. */
   protected events: Record<string, GenericFn[]> = {};
   /**
-   * A dictionary of wrappers that were created for "one time subscriptions". This is
-   * used by the {@link EventsHub.off}: if it doesn't find the subscriber as it is, it
-   * will look for a wrapper and remove it.
+   * A dictionary of wrappers that were created for "one time subscriptions". This is used
+   * by the {@link EventsHub.off}: if it doesn't find the subscriber as it is, it will look
+   * for a wrapper and remove it.
    */
   protected onceWrappers: Record<string, OnceWrapper[]> = {};
   /**
-   * Gets all the listeners for a specific event.
-   * The list is returned by reference, so it can be modified once obtained.
+   * Gets all the listeners for a specific event. The list is returned by reference, so it
+   * can be modified once obtained.
    *
-   * @param event  The name of the event.
+   * @param event The name of the event.
    */
   protected getSubscribers(event: string): (GenericFn | OnceWrapperFn)[] {
     if (!this.events[event]) {
@@ -65,18 +59,17 @@ export class EventsHub {
   /**
    * Adds a new event listener.
    *
-   * @param event     An event name or a list of them.
-   * @param listener  The listener function.
-   * @returns An unsubscribe function to remove the listene(s).
-   * @template ListenerFn  The type of the listener function.
    * @example
-   *
    *   const events = new EventsHub();
    *   type Listener = (arg0: string) => void;
    *   const unsubscribe = events.on<Listener>('event', (arg0) => {
    *     console.log(`Event received: ${arg0}`);
    *   });
    *
+   * @template ListenerFn The type of the listener function.
+   * @param event An event name or a list of them.
+   * @param listener The listener function.
+   * @returns An unsubscribe function to remove the listene(s).
    */
   on<ListenerFn extends GenericFn = GenericFn>(
     event: string | string[],
@@ -107,18 +100,17 @@ export class EventsHub {
   /**
    * Adds an event listener that will only be executed once.
    *
-   * @param event     An event name or a list of them.
-   * @param listener  The listener function.
-   * @returns An unsubscribe function to remove the listener(s).
-   * @template ListenerFn  The type of the listener function.
    * @example
-   *
    *   const events = new EventsHub();
    *   type Listener = (arg0: string) => void;
    *   const unsubscribe = events.once<Listener>('event', (arg0) => {
    *     console.log(`Event received: ${arg0}`);
    *   });
    *
+   * @template ListenerFn The type of the listener function.
+   * @param event An event name or a list of them.
+   * @param listener The listener function.
+   * @returns An unsubscribe function to remove the listener(s).
    */
   once<ListenerFn extends GenericFn = GenericFn>(
     event: string | string[],
@@ -176,14 +168,7 @@ export class EventsHub {
   /**
    * Removes an event listener.
    *
-   * @param event     An event name or a list of them.
-   * @param listener  The listener function.
-   * @returns If `event` was a `string`, it will return whether or not the listener
-   *          was found and removed; but if `event`
-   *          was an `Array`, it will return a list of boolean values.
-   * @template ListenerFn  The type of the listener function.
    * @example
-   *
    *   const events = new EventsHub();
    *   const listener = (arg0) => {
    *     console.log(`Event received: ${arg0}`);
@@ -191,6 +176,12 @@ export class EventsHub {
    *   events.on('event', listener); // subscribe.
    *   events.off('event', listener); // manually unsubscribe.
    *
+   * @template ListenerFn The type of the listener function.
+   * @param event An event name or a list of them.
+   * @param listener The listener function.
+   * @returns If `event` was a `string`, it will return whether or not the listener was
+   *   found and removed; but if `event` was an `Array`, it will return a list of boolean
+   *   values.
    */
   off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(
     event: string | string[],
@@ -238,17 +229,16 @@ export class EventsHub {
   /**
    * Emits an event and call all its listeners.
    *
-   * @param event  An event name or a list of them.
-   * @param args   A list of parameters to send to the listeners.
-   * @template Args  The type of the parameters to send to the listeners.
    * @example
-   *
    *   const events = new EventsHub();
    *   events.on('event', (arg0) => {
    *     console.log(`Event received: ${arg0}`);
    *   });
    *   events.emit('event', 'Hello'); // prints "Event received: Hello"
    *
+   * @template Args The type of the parameters to send to the listeners.
+   * @param event An event name or a list of them.
+   * @param args A list of parameters to send to the listeners.
    */
   emit<Args extends GenericParams>(event: string | string[], ...args: Args): void {
     const toClean: { event: string; listener: GenericFn }[] = [];
@@ -271,14 +261,7 @@ export class EventsHub {
    * Asynchronously reduces a target using an event. It's like emit, but the events
    * listener return a modified (or not) version of the `target`.
    *
-   * @param event   An event name or a list of them.
-   * @param target  The variable to reduce with the reducers/listeners.
-   * @param args    A list of parameters to send to the reducers/listeners.
-   * @returns A version of the `target` processed by the listeners.
-   * @template Target  The type of the target.
-   * @template Args    The type of the parameters to send to the reducers/listeners.
    * @example
-   *
    *   const events = new EventsHub();
    *   events.on('event', async (target, arg0) => {
    *     const data = await fetch(`https://api.example.com/${arg0}`);
@@ -288,6 +271,12 @@ export class EventsHub {
    *   const result = await events.reduce('event', [], 'Hello');
    *   // result would be a list of data fetched from the API.
    *
+   * @template Target The type of the target.
+   * @template Args The type of the parameters to send to the reducers/listeners.
+   * @param event An event name or a list of them.
+   * @param target The variable to reduce with the reducers/listeners.
+   * @param args A list of parameters to send to the reducers/listeners.
+   * @returns A version of the `target` processed by the listeners.
    */
   async reduce<Target, Args extends GenericParams>(
     event: string | string[],
@@ -336,14 +325,7 @@ export class EventsHub {
    * Synchronously reduces a target using an event. It's like emit, but the events
    * listener return a modified (or not) version of the `target`.
    *
-   * @param event   An event name or a list of them.
-   * @param target  The variable to reduce with the reducers/listeners.
-   * @param args    A list of parameters to send to the reducers/listeners.
-   * @returns A version of the `target` processed by the listeners.
-   * @template Target  The type of the target.
-   * @template Args    The type of the parameters to send to the reducers/listeners.
    * @example
-   *
    *   const events = new EventsHub();
    *   events.on('event', (target, arg0) => {
    *     target.push(arg0);
@@ -351,6 +333,12 @@ export class EventsHub {
    *   });
    *   events.reduce('event', [], 'Hello'); // returns ['Hello']
    *
+   * @template Target The type of the target.
+   * @template Args The type of the parameters to send to the reducers/listeners.
+   * @param event An event name or a list of them.
+   * @param target The variable to reduce with the reducers/listeners.
+   * @param args A list of parameters to send to the reducers/listeners.
+   * @returns A version of the `target` processed by the listeners.
    */
   reduceSync<Target, ReducerArgs extends GenericParams>(
     event: string | string[],