npm - @homer0/events-hub - Versions diffs - 3.0.14 → 5.0.0 - Mend

@homer0/events-hub 3.0.14 → 5.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.js +1 -308
package/dist/index.js.map +1 -1
package/package.json +26 -14
package/{dist/esm/index.js → src/index.ts} +177 -65
package/dist/esm/index.js.map +0 -1
package/dist/index.d.mts +0 -123
package/dist/index.d.ts +0 -123

package/dist/index.js CHANGED Viewed

@@ -1,309 +1,2 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  EventsHub: () => EventsHub,
-  eventsHub: () => eventsHub
-});
-module.exports = __toCommonJS(index_exports);
-var EventsHub = class {
-  /**
-   * A dictionary of the events and their listeners.
-   */
-  events = {};
-  /**
-   * 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.
-   */
-  onceWrappers = {};
-  /**
-   * 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.
-   */
-  getSubscribers(event) {
-    if (!this.events[event]) {
-      this.events[event] = [];
-    }
-    return this.events[event];
-  }
-  /**
-   * 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}`);
-   *   });
-   *
-   */
-  on(event, listener) {
-    const events = Array.isArray(event) ? event : [event];
-    events.forEach((name) => {
-      const subscribers = this.getSubscribers(name);
-      if (!subscribers.includes(listener)) {
-        subscribers.push(listener);
-      }
-    });
-    return () => this.off(event, listener);
-  }
-  /**
-   * 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}`);
-   *   });
-   *
-   */
-  once(event, listener) {
-    const events = Array.isArray(event) ? event : [event];
-    let wrapper = events.reduce((acc, name) => {
-      if (acc) return acc;
-      const onceWrapper = this.onceWrappers[name];
-      if (Array.isArray(onceWrapper)) {
-        const existing = onceWrapper.find((item) => item.original === listener);
-        if (existing) {
-          return existing.wrapper;
-        }
-        return null;
-      }
-      this.onceWrappers[name] = [];
-      return null;
-    }, null);
-    if (!wrapper) {
-      const newWrapper = (...args) => listener(...args);
-      newWrapper.once = true;
-      wrapper = newWrapper;
-      events.forEach((name) => {
-        this.onceWrappers[name].push({
-          wrapper,
-          original: listener
-        });
-      });
-    }
-    return this.on(event, wrapper);
-  }
-  /**
-   * 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}`);
-   *   };
-   *   events.on('event', listener); // subscribe.
-   *   events.off('event', listener); // manually unsubscribe.
-   *
-   */
-  off(event, listener) {
-    const isArray = Array.isArray(event);
-    const events = isArray ? event : [event];
-    const result = events.map((name) => {
-      const subscribers = this.getSubscribers(name);
-      const onceSubscribers = this.onceWrappers[name];
-      let found = false;
-      let index = subscribers.indexOf(listener);
-      if (index > -1) {
-        found = true;
-        if ("once" in listener && onceSubscribers) {
-          const wrapperIndex = onceSubscribers.findIndex(
-            (item) => item.wrapper === listener
-          );
-          onceSubscribers.splice(wrapperIndex, 1);
-        }
-        subscribers.splice(index, 1);
-      } else if (onceSubscribers) {
-        index = onceSubscribers.findIndex((item) => item.original === listener);
-        if (index > -1) {
-          found = true;
-          const originalIndex = subscribers.indexOf(onceSubscribers[index].original);
-          subscribers.splice(originalIndex, 1);
-          onceSubscribers.splice(index, 1);
-        }
-      }
-      return found;
-    });
-    return isArray ? result : result[0];
-  }
-  /**
-   * 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"
-   *
-   */
-  emit(event, ...args) {
-    const toClean = [];
-    const events = Array.isArray(event) ? event : [event];
-    events.forEach((name) => {
-      this.getSubscribers(name).forEach((subscriber) => {
-        subscriber(...args);
-        if ("once" in subscriber) {
-          toClean.push({
-            event: name,
-            listener: subscriber
-          });
-        }
-      });
-    });
-    toClean.forEach((info) => this.off(info.event, info.listener));
-  }
-  /**
-   * 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}`);
-   *     target.push(data);
-   *     return target;
-   *   });
-   *   const result = await events.reduce('event', [], 'Hello');
-   *   // result would be a list of data fetched from the API.
-   *
-   */
-  async reduce(event, target, ...args) {
-    const events = Array.isArray(event) ? event : [event];
-    const toClean = [];
-    const result = await events.reduce(
-      (eventAcc, name) => eventAcc.then((eventCurrent) => {
-        const subscribers = this.getSubscribers(name);
-        return subscribers.reduce(
-          (subAcc, subscriber) => subAcc.then((subCurrent) => {
-            let useCurrent;
-            if (Array.isArray(subCurrent)) {
-              useCurrent = subCurrent.slice();
-            } else if (typeof subCurrent === "object") {
-              useCurrent = { ...subCurrent };
-            } else {
-              useCurrent = subCurrent;
-            }
-            const nextStep = subscriber(...[useCurrent, ...args]);
-            if ("once" in subscriber) {
-              toClean.push({
-                event: name,
-                listener: subscriber
-              });
-            }
-            return nextStep;
-          }),
-          Promise.resolve(eventCurrent)
-        );
-      }),
-      Promise.resolve(target)
-    );
-    toClean.forEach((info) => this.off(info.event, info.listener));
-    return result;
-  }
-  /**
-   * 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);
-   *     return target;
-   *   });
-   *   events.reduce('event', [], 'Hello'); // returns ['Hello']
-   *
-   */
-  reduceSync(event, target, ...args) {
-    const events = Array.isArray(event) ? event : [event];
-    const toClean = [];
-    const result = events.reduce((eventAcc, name) => {
-      const subscribers = this.getSubscribers(name);
-      return subscribers.reduce((subAcc, subscriber) => {
-        let useCurrent;
-        if (Array.isArray(subAcc)) {
-          useCurrent = subAcc.slice();
-        } else if (typeof subAcc === "object") {
-          useCurrent = { ...subAcc };
-        } else {
-          useCurrent = subAcc;
-        }
-        const nextStep = subscriber(...[useCurrent, ...args]);
-        if ("once" in subscriber) {
-          toClean.push({
-            event: name,
-            listener: subscriber
-          });
-        }
-        return nextStep;
-      }, eventAcc);
-    }, target);
-    toClean.forEach((info) => this.off(info.event, info.listener));
-    return result;
-  }
-};
-var eventsHub = () => new EventsHub();
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  EventsHub,
-  eventsHub
-});
+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};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.ts"],"sourcesContent":["// eslint-disable-next-line @typescript-eslint/no-explicit-any -- It's a generic function.\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 // eslint-disable-next-line @typescript-eslint/no-explicit-any -- It's a generic function.\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 was\n * 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":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4BO,IAAM,YAAN,MAAgB;AAAA;AAAA;AAAA;AAAA,EAIX,SAAsC,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMvC,eAA8C,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO/C,eAAe,OAA8C;AACrE,QAAI,CAAC,KAAK,OAAO,KAAK,GAAG;AACvB,WAAK,OAAO,KAAK,IAAI,CAAC;AAAA,IACxB;AAEA,WAAO,KAAK,OAAO,KAAK;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BA,GACE,OACA,UAC2B;AAC3B,UAAM,SAAS,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AACpD,WAAO,QAAQ,CAAC,SAAS;AACvB,YAAM,cAAc,KAAK,eAAe,IAAI;AAC5C,UAAI,CAAC,YAAY,SAAS,QAAQ,GAAG;AACnC,oBAAY,KAAK,QAAQ;AAAA,MAC3B;AAAA,IACF,CAAC;AAED,WAAO,MAAM,KAAK,IAAgB,OAAO,QAAQ;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BA,KACE,OACA,UAC2B;AAC3B,UAAM,SAAS,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AAEpD,QAAI,UAAU,OAAO,OAA6B,CAAC,KAAK,SAAS;AAE/D,UAAI,IAAK,QAAO;AAGhB,YAAM,cAAc,KAAK,aAAa,IAAI;AAC1C,UAAI,MAAM,QAAQ,WAAW,GAAG;AAC9B,cAAM,WAAW,YAAY,KAAK,CAAC,SAAS,KAAK,aAAa,QAAQ;AACtE,YAAI,UAAU;AACZ,iBAAO,SAAS;AAAA,QAClB;AAEA,eAAO;AAAA,MACT;AAGA,WAAK,aAAa,IAAI,IAAI,CAAC;AAC3B,aAAO;AAAA,IACT,GAAG,IAAI;AAEP,QAAI,CAAC,SAAS;AAEZ,YAAM,aAAa,IAAI,SAAgB,SAAS,GAAG,IAAI;AACvD,iBAAW,OAAO;AAClB,gBAAU;AACV,aAAO,QAAQ,CAAC,SAAS;AACvB,aAAK,aAAa,IAAI,EAAG,KAAK;AAAA,UAC5B;AAAA,UACA,UAAU;AAAA,QACZ,CAAC;AAAA,MACH,CAAC;AAAA,IACH;AAEA,WAAO,KAAK,GAAG,OAAO,OAAO;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgCA,IACE,OACA,UACqB;AACrB,UAAM,UAAU,MAAM,QAAQ,KAAK;AACnC,UAAM,SAAS,UAAU,QAAQ,CAAC,KAAK;AACvC,UAAM,SAAS,OAAO,IAAI,CAAC,SAAS;AAClC,YAAM,cAAc,KAAK,eAAe,IAAI;AAC5C,YAAM,kBAAkB,KAAK,aAAa,IAAI;AAC9C,UAAI,QAAQ;AACZ,UAAI,QAAQ,YAAY,QAAQ,QAAQ;AACxC,UAAI,QAAQ,IAAI;AACd,gBAAQ;AAKR,YAAI,UAAU,YAAY,iBAAiB;AACzC,gBAAM,eAAe,gBAAgB;AAAA,YACnC,CAAC,SAAS,KAAK,YAAY;AAAA,UAC7B;AACA,0BAAgB,OAAO,cAAc,CAAC;AAAA,QACxC;AACA,oBAAY,OAAO,OAAO,CAAC;AAAA,MAC7B,WAAW,iBAAiB;AAK1B,gBAAQ,gBAAgB,UAAU,CAAC,SAAS,KAAK,aAAa,QAAQ;AACtE,YAAI,QAAQ,IAAI;AACd,kBAAQ;AACR,gBAAM,gBAAgB,YAAY,QAAQ,gBAAgB,KAAK,EAAG,QAAQ;AAC1E,sBAAY,OAAO,eAAe,CAAC;AACnC,0BAAgB,OAAO,OAAO,CAAC;AAAA,QACjC;AAAA,MACF;AAEA,aAAO;AAAA,IACT,CAAC;AAED,WAAO,UAAU,SAAS,OAAO,CAAC;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,KAAiC,UAA6B,MAAkB;AAC9E,UAAM,UAAoD,CAAC;AAC3D,UAAM,SAAS,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AACpD,WAAO,QAAQ,CAAC,SAAS;AACvB,WAAK,eAAe,IAAI,EAAE,QAAQ,CAAC,eAAe;AAChD,mBAAW,GAAG,IAAI;AAClB,YAAI,UAAU,YAAY;AACxB,kBAAQ,KAAK;AAAA,YACX,OAAO;AAAA,YACP,UAAU;AAAA,UACZ,CAAC;AAAA,QACH;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAED,YAAQ,QAAQ,CAAC,SAAS,KAAK,IAAI,KAAK,OAAO,KAAK,QAAQ,CAAC;AAAA,EAC/D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBA,MAAM,OACJ,OACA,WACG,MACc;AACjB,UAAM,SAAS,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AACpD,UAAM,UAAoD,CAAC;AAC3D,UAAM,SAAS,MAAM,OAAO;AAAA,MAC1B,CAAC,UAAU,SACT,SAAS,KAAK,CAAC,iBAAiB;AAC9B,cAAM,cAAc,KAAK,eAAe,IAAI;AAC5C,eAAO,YAAY;AAAA,UACjB,CAAC,QAAQ,eACP,OAAO,KAAK,CAAC,eAAe;AAC1B,gBAAI;AACJ,gBAAI,MAAM,QAAQ,UAAU,GAAG;AAC7B,2BAAa,WAAW,MAAM;AAAA,YAChC,WAAW,OAAO,eAAe,UAAU;AACzC,2BAAa,EAAE,GAAG,WAAW;AAAA,YAC/B,OAAO;AACL,2BAAa;AAAA,YACf;AAEA,kBAAM,WAAW,WAAW,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC;AACpD,gBAAI,UAAU,YAAY;AACxB,sBAAQ,KAAK;AAAA,gBACX,OAAO;AAAA,gBACP,UAAU;AAAA,cACZ,CAAC;AAAA,YACH;AAEA,mBAAO;AAAA,UACT,CAAC;AAAA,UACH,QAAQ,QAAQ,YAAY;AAAA,QAC9B;AAAA,MACF,CAAC;AAAA,MACH,QAAQ,QAAQ,MAAM;AAAA,IACxB;AAEA,YAAQ,QAAQ,CAAC,SAAS,KAAK,IAAI,KAAK,OAAO,KAAK,QAAQ,CAAC;AAE7D,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,WACE,OACA,WACG,MACK;AACR,UAAM,SAAS,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AACpD,UAAM,UAAoD,CAAC;AAC3D,UAAM,SAAS,OAAO,OAAO,CAAC,UAAU,SAAS;AAC/C,YAAM,cAAc,KAAK,eAAe,IAAI;AAC5C,aAAO,YAAY,OAAO,CAAC,QAAQ,eAAe;AAChD,YAAI;AACJ,YAAI,MAAM,QAAQ,MAAM,GAAG;AACzB,uBAAa,OAAO,MAAM;AAAA,QAC5B,WAAW,OAAO,WAAW,UAAU;AACrC,uBAAa,EAAE,GAAG,OAAO;AAAA,QAC3B,OAAO;AACL,uBAAa;AAAA,QACf;AAEA,cAAM,WAAW,WAAW,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC;AACpD,YAAI,UAAU,YAAY;AACxB,kBAAQ,KAAK;AAAA,YACX,OAAO;AAAA,YACP,UAAU;AAAA,UACZ,CAAC;AAAA,QACH;AAEA,eAAO;AAAA,MACT,GAAG,QAAQ;AAAA,IACb,GAAG,MAAM;AAET,YAAQ,QAAQ,CAAC,SAAS,KAAK,IAAI,KAAK,OAAO,KAAK,QAAQ,CAAC;AAC7D,WAAO;AAAA,EACT;AACF;AAMO,IAAM,YAAY,MAAM,IAAI,UAAU;","names":[]}
1	+ {"version":3,"sources":["../src/index.ts"],"sourcesContent":["// eslint-disable-next-line @typescript-eslint/no-explicit-any -- It's a generic function.\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 // eslint-disable-next-line @typescript-eslint/no-explicit-any -- It's a generic function.\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"]}

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@homer0/events-hub",
   "description": "A simple implementation of a pubsub service for handling events",
-  "version": "3.0.14",
+  "version": "5.0.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/homer0/packages.git",
@@ -19,30 +19,42 @@
   "publishConfig": {
     "access": "public"
   },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./src/index.ts"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
-    "dist/"
+    "dist/",
+    "src/"
   ],
   "devDependencies": {
-    "@homer0/eslint-plugin": "12.0.13",
-    "@homer0/tsconfig": "2.0.2",
-    "jest": "catalog:",
-    "ts-jest": "catalog:",
+    "@homer0/eslint-plugin": "14.0.0",
+    "@homer0/tsconfig": "4.0.0",
+    "@vitest/coverage-v8": "catalog:",
+    "eslint": "catalog:",
     "tsup": "catalog:",
-    "typescript": "catalog:"
+    "typescript": "catalog:",
+    "unplugin-swc": "catalog:",
+    "vite-tsconfig-paths": "catalog:",
+    "vitest": "catalog:"
   },
   "engine-strict": true,
   "engines": {
-    "node": ">=18 <23"
+    "node": ">=20 <23"
   },
-  "main": "./dist/index.js",
-  "module": "./dist/esm/index.js",
-  "types": "./dist/index.d.ts",
   "scripts": {
     "lint": "eslint .",
-    "test": "jest -c ./.jestrc.js",
+    "lint:file": "eslint $@",
+    "test": "vitest run $@",
     "types:check": "tsc --noEmit && tsc --noEmit --project ./tests/tsconfig.json",
-    "build": "tsup src/index.ts",
+    "build": "tsup",
     "prepublishOnly": "pnpm run build"
   },
-  "gitHead": "9e804863e566d60148217835a2d5f7556bb57a45"
+  "gitHead": "fece630639760a2ea3b9f191ff203ac33bb88a09"
 }

package/{dist/esm/index.js → src/index.ts} RENAMED Viewed

@@ -1,27 +1,67 @@
-// src/index.ts
-var EventsHub = class {
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- It's a generic function.
+type GenericFn = (...args: any[]) => any;
+type GenericParams = Parameters<GenericFn>;
+type OnceWrapperFn = GenericFn & {
+  once: boolean;
+};
+/**
+ * When the service receives a "once subscription", it needs to track the listener so it
+ * gets removed after being called once, and to avoid modifying the original function, it
+ * creates a wrapper function that has the "once" property set to true. The wrapper and
+ * the original function are stored in case `off` is called before the wrapper gets
+ * triggered; it will receive the original function, not the wrapper, so the class needs a
+ * way to map them together.
+ */
+type OnceWrapper = {
+  /**
+   * A simple wrapper for the original listener, with the difference that it has a `once`
+   * property set to `true`.
+   */
+  wrapper: OnceWrapperFn;
+  /**
+   * The original listener that will be called once.
+   */
+  original: GenericFn;
+};
+/**
+ * A minimal implementation of an events handler service.
+ */
+export class EventsHub {
   /**
    * A dictionary of the events and their listeners.
    */
-  events = {};
+  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.
    */
-  onceWrappers = {};
+  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.
    *
    * @param event  The name of the event.
    */
-  getSubscribers(event) {
+  protected getSubscribers(event: string): (GenericFn | OnceWrapperFn)[] {
     if (!this.events[event]) {
       this.events[event] = [];
     }
-    return this.events[event];
+    return this.events[event]!;
   }
+  on<ListenerFn extends GenericFn = GenericFn>(
+    event: string,
+    listener: ListenerFn,
+  ): () => boolean;
+  on<ListenerFn extends GenericFn = GenericFn>(
+    event: string[],
+    listener: ListenerFn,
+  ): () => boolean[];
+  on<ListenerFn extends GenericFn = GenericFn>(
+    event: string | string[],
+    listener: ListenerFn,
+  ): () => boolean | boolean[];
   /**
    * Adds a new event listener.
    *
@@ -38,7 +78,10 @@ var EventsHub = class {
    *   });
    *
    */
-  on(event, listener) {
+  on<ListenerFn extends GenericFn = GenericFn>(
+    event: string | string[],
+    listener: ListenerFn,
+  ): () => boolean | boolean[] {
     const events = Array.isArray(event) ? event : [event];
     events.forEach((name) => {
       const subscribers = this.getSubscribers(name);
@@ -46,8 +89,21 @@ var EventsHub = class {
         subscribers.push(listener);
       }
     });
-    return () => this.off(event, listener);
+    return () => this.off<ListenerFn>(event, listener);
   }
+  once<ListenerFn extends GenericFn = GenericFn>(
+    event: string,
+    listener: ListenerFn,
+  ): () => boolean;
+  once<ListenerFn extends GenericFn = GenericFn>(
+    event: string[],
+    listener: ListenerFn,
+  ): () => boolean[];
+  once<ListenerFn extends GenericFn = GenericFn>(
+    event: string | string[],
+    listener: ListenerFn,
+  ): () => boolean | boolean[];
   /**
    * Adds an event listener that will only be executed once.
    *
@@ -64,41 +120,66 @@ var EventsHub = class {
    *   });
    *
    */
-  once(event, listener) {
+  once<ListenerFn extends GenericFn = GenericFn>(
+    event: string | string[],
+    listener: ListenerFn,
+  ): () => boolean | boolean[] {
     const events = Array.isArray(event) ? event : [event];
-    let wrapper = events.reduce((acc, name) => {
+    // Try to find an existing wrapper.
+    let wrapper = events.reduce<OnceWrapperFn | null>((acc, name) => {
+      // A previous iteration found a wrapper, so `continue`.
       if (acc) return acc;
+      // A list of wrappers exists for the event, so, let's try an find one for this function.
       const onceWrapper = this.onceWrappers[name];
       if (Array.isArray(onceWrapper)) {
         const existing = onceWrapper.find((item) => item.original === listener);
         if (existing) {
           return existing.wrapper;
         }
         return null;
       }
+      // The list didn't even exists, let's at least create it.
       this.onceWrappers[name] = [];
       return null;
     }, null);
     if (!wrapper) {
-      const newWrapper = (...args) => listener(...args);
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any -- It's a generic function.
+      const newWrapper = (...args: any[]) => listener(...args);
       newWrapper.once = true;
       wrapper = newWrapper;
       events.forEach((name) => {
-        this.onceWrappers[name].push({
-          wrapper,
-          original: listener
+        this.onceWrappers[name]!.push({
+          wrapper: wrapper!,
+          original: listener,
         });
       });
     }
     return this.on(event, wrapper);
   }
+  off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(
+    event: string[],
+    listener: ListenerFn,
+  ): boolean[];
+  off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(
+    event: string,
+    listener: ListenerFn,
+  ): boolean;
+  off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(
+    event: string | string[],
+    listener: ListenerFn,
+  ): boolean | boolean[];
   /**
    * 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`
+   * @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
@@ -111,7 +192,10 @@ var EventsHub = class {
    *   events.off('event', listener); // manually unsubscribe.
    *
    */
-  off(event, listener) {
+  off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(
+    event: string | string[],
+    listener: ListenerFn,
+  ): boolean | boolean[] {
     const isArray = Array.isArray(event);
     const events = isArray ? event : [event];
     const result = events.map((name) => {
@@ -121,25 +205,35 @@ var EventsHub = class {
       let index = subscribers.indexOf(listener);
       if (index > -1) {
         found = true;
-        if ("once" in listener && onceSubscribers) {
+        /**
+         * If the listener had the `once` flag, then it's a wrapper, so it needs to remove
+         * it from the wrappers list too.
+         */
+        if ('once' in listener && onceSubscribers) {
           const wrapperIndex = onceSubscribers.findIndex(
-            (item) => item.wrapper === listener
+            (item) => item.wrapper === listener,
           );
           onceSubscribers.splice(wrapperIndex, 1);
         }
         subscribers.splice(index, 1);
       } else if (onceSubscribers) {
+        /**
+         * If it couldn't found the subscriber, maybe it's because it's the original
+         * listener of a wrapper.
+         */
         index = onceSubscribers.findIndex((item) => item.original === listener);
         if (index > -1) {
           found = true;
-          const originalIndex = subscribers.indexOf(onceSubscribers[index].original);
+          const originalIndex = subscribers.indexOf(onceSubscribers[index]!.original);
           subscribers.splice(originalIndex, 1);
           onceSubscribers.splice(index, 1);
         }
       }
       return found;
     });
-    return isArray ? result : result[0];
+    return isArray ? result : result[0]!;
   }
   /**
    * Emits an event and call all its listeners.
@@ -156,20 +250,21 @@ var EventsHub = class {
    *   events.emit('event', 'Hello'); // prints "Event received: Hello"
    *
    */
-  emit(event, ...args) {
-    const toClean = [];
+  emit<Args extends GenericParams>(event: string | string[], ...args: Args): void {
+    const toClean: { event: string; listener: GenericFn }[] = [];
     const events = Array.isArray(event) ? event : [event];
     events.forEach((name) => {
       this.getSubscribers(name).forEach((subscriber) => {
         subscriber(...args);
-        if ("once" in subscriber) {
+        if ('once' in subscriber) {
           toClean.push({
             event: name,
-            listener: subscriber
+            listener: subscriber,
           });
         }
       });
     });
     toClean.forEach((info) => this.off(info.event, info.listener));
   }
   /**
@@ -194,37 +289,47 @@ var EventsHub = class {
    *   // result would be a list of data fetched from the API.
    *
    */
-  async reduce(event, target, ...args) {
+  async reduce<Target, Args extends GenericParams>(
+    event: string | string[],
+    target: Target,
+    ...args: Args
+  ): Promise<Target> {
     const events = Array.isArray(event) ? event : [event];
-    const toClean = [];
-    const result = await events.reduce(
-      (eventAcc, name) => eventAcc.then((eventCurrent) => {
-        const subscribers = this.getSubscribers(name);
-        return subscribers.reduce(
-          (subAcc, subscriber) => subAcc.then((subCurrent) => {
-            let useCurrent;
-            if (Array.isArray(subCurrent)) {
-              useCurrent = subCurrent.slice();
-            } else if (typeof subCurrent === "object") {
-              useCurrent = { ...subCurrent };
-            } else {
-              useCurrent = subCurrent;
-            }
-            const nextStep = subscriber(...[useCurrent, ...args]);
-            if ("once" in subscriber) {
-              toClean.push({
-                event: name,
-                listener: subscriber
-              });
-            }
-            return nextStep;
-          }),
-          Promise.resolve(eventCurrent)
-        );
-      }),
-      Promise.resolve(target)
+    const toClean: { event: string; listener: GenericFn }[] = [];
+    const result = await events.reduce<Promise<Target>>(
+      (eventAcc, name) =>
+        eventAcc.then((eventCurrent) => {
+          const subscribers = this.getSubscribers(name);
+          return subscribers.reduce(
+            (subAcc, subscriber) =>
+              subAcc.then((subCurrent) => {
+                let useCurrent;
+                if (Array.isArray(subCurrent)) {
+                  useCurrent = subCurrent.slice();
+                } else if (typeof subCurrent === 'object') {
+                  useCurrent = { ...subCurrent };
+                } else {
+                  useCurrent = subCurrent;
+                }
+                const nextStep = subscriber(...[useCurrent, ...args]);
+                if ('once' in subscriber) {
+                  toClean.push({
+                    event: name,
+                    listener: subscriber,
+                  });
+                }
+                return nextStep;
+              }),
+            Promise.resolve(eventCurrent),
+          );
+        }),
+      Promise.resolve(target),
     );
     toClean.forEach((info) => this.off(info.event, info.listener));
     return result;
   }
   /**
@@ -247,37 +352,44 @@ var EventsHub = class {
    *   events.reduce('event', [], 'Hello'); // returns ['Hello']
    *
    */
-  reduceSync(event, target, ...args) {
+  reduceSync<Target, ReducerArgs extends GenericParams>(
+    event: string | string[],
+    target: Target,
+    ...args: ReducerArgs
+  ): Target {
     const events = Array.isArray(event) ? event : [event];
-    const toClean = [];
+    const toClean: { event: string; listener: GenericFn }[] = [];
     const result = events.reduce((eventAcc, name) => {
       const subscribers = this.getSubscribers(name);
       return subscribers.reduce((subAcc, subscriber) => {
         let useCurrent;
         if (Array.isArray(subAcc)) {
           useCurrent = subAcc.slice();
-        } else if (typeof subAcc === "object") {
+        } else if (typeof subAcc === 'object') {
           useCurrent = { ...subAcc };
         } else {
           useCurrent = subAcc;
         }
         const nextStep = subscriber(...[useCurrent, ...args]);
-        if ("once" in subscriber) {
+        if ('once' in subscriber) {
           toClean.push({
             event: name,
-            listener: subscriber
+            listener: subscriber,
           });
         }
         return nextStep;
       }, eventAcc);
     }, target);
     toClean.forEach((info) => this.off(info.event, info.listener));
     return result;
   }
-};
-var eventsHub = () => new EventsHub();
-export {
-  EventsHub,
-  eventsHub
-};
-//# sourceMappingURL=index.js.map
+}
+/**
+ * Shorthand for `new EventsHub()`.
+ *
+ * @returns A new instance of {@link EventsHub}.
+ */
+export const eventsHub = () => new EventsHub();

package/dist/esm/index.js.map DELETED Viewed

@@ -1 +0,0 @@

- {"version":3,"sources":["../../src/index.ts"],"sourcesContent":["// eslint-disable-next-line @typescript-eslint/no-explicit-any -- It's a generic function.\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 // eslint-disable-next-line @typescript-eslint/no-explicit-any -- It's a generic function.\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 was\n * 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":[]}

package/dist/index.d.mts DELETED Viewed

@@ -1,123 +0,0 @@
-type GenericFn = (...args: any[]) => any;
-type GenericParams = Parameters<GenericFn>;
-type OnceWrapperFn = GenericFn & {
-    once: boolean;
-};
-/**
- * When the service receives a "once subscription", it needs to track the listener so it
- * gets removed after being called once, and to avoid modifying the original function, it
- * creates a wrapper function that has the "once" property set to true. The wrapper and
- * the original function are stored in case `off` is called before the wrapper gets
- * triggered; it will receive the original function, not the wrapper, so the class needs a
- * way to map them together.
- */
-type OnceWrapper = {
-    /**
-     * A simple wrapper for the original listener, with the difference that it has a `once`
-     * property set to `true`.
-     */
-    wrapper: OnceWrapperFn;
-    /**
-     * The original listener that will be called once.
-     */
-    original: GenericFn;
-};
-/**
- * A minimal implementation of an events handler service.
- */
-declare class EventsHub {
-    /**
-     * 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.
-     */
-    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.
-     *
-     * @param event  The name of the event.
-     */
-    protected getSubscribers(event: string): (GenericFn | OnceWrapperFn)[];
-    on<ListenerFn extends GenericFn = GenericFn>(event: string, listener: ListenerFn): () => boolean;
-    on<ListenerFn extends GenericFn = GenericFn>(event: string[], listener: ListenerFn): () => boolean[];
-    on<ListenerFn extends GenericFn = GenericFn>(event: string | string[], listener: ListenerFn): () => boolean | boolean[];
-    once<ListenerFn extends GenericFn = GenericFn>(event: string, listener: ListenerFn): () => boolean;
-    once<ListenerFn extends GenericFn = GenericFn>(event: string[], listener: ListenerFn): () => boolean[];
-    once<ListenerFn extends GenericFn = GenericFn>(event: string | string[], listener: ListenerFn): () => boolean | boolean[];
-    off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(event: string[], listener: ListenerFn): boolean[];
-    off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(event: string, listener: ListenerFn): boolean;
-    off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(event: string | string[], listener: ListenerFn): boolean | boolean[];
-    /**
-     * 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"
-     *
-     */
-    emit<Args extends GenericParams>(event: string | string[], ...args: Args): void;
-    /**
-     * 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}`);
-     *     target.push(data);
-     *     return target;
-     *   });
-     *   const result = await events.reduce('event', [], 'Hello');
-     *   // result would be a list of data fetched from the API.
-     *
-     */
-    reduce<Target, Args extends GenericParams>(event: string | string[], target: Target, ...args: Args): Promise<Target>;
-    /**
-     * 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);
-     *     return target;
-     *   });
-     *   events.reduce('event', [], 'Hello'); // returns ['Hello']
-     *
-     */
-    reduceSync<Target, ReducerArgs extends GenericParams>(event: string | string[], target: Target, ...args: ReducerArgs): Target;
-}
-/**
- * Shorthand for `new EventsHub()`.
- *
- * @returns A new instance of {@link EventsHub}.
- */
-declare const eventsHub: () => EventsHub;
-export { EventsHub, eventsHub };

package/dist/index.d.ts DELETED Viewed

@@ -1,123 +0,0 @@
-type GenericFn = (...args: any[]) => any;
-type GenericParams = Parameters<GenericFn>;
-type OnceWrapperFn = GenericFn & {
-    once: boolean;
-};
-/**
- * When the service receives a "once subscription", it needs to track the listener so it
- * gets removed after being called once, and to avoid modifying the original function, it
- * creates a wrapper function that has the "once" property set to true. The wrapper and
- * the original function are stored in case `off` is called before the wrapper gets
- * triggered; it will receive the original function, not the wrapper, so the class needs a
- * way to map them together.
- */
-type OnceWrapper = {
-    /**
-     * A simple wrapper for the original listener, with the difference that it has a `once`
-     * property set to `true`.
-     */
-    wrapper: OnceWrapperFn;
-    /**
-     * The original listener that will be called once.
-     */
-    original: GenericFn;
-};
-/**
- * A minimal implementation of an events handler service.
- */
-declare class EventsHub {
-    /**
-     * 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.
-     */
-    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.
-     *
-     * @param event  The name of the event.
-     */
-    protected getSubscribers(event: string): (GenericFn | OnceWrapperFn)[];
-    on<ListenerFn extends GenericFn = GenericFn>(event: string, listener: ListenerFn): () => boolean;
-    on<ListenerFn extends GenericFn = GenericFn>(event: string[], listener: ListenerFn): () => boolean[];
-    on<ListenerFn extends GenericFn = GenericFn>(event: string | string[], listener: ListenerFn): () => boolean | boolean[];
-    once<ListenerFn extends GenericFn = GenericFn>(event: string, listener: ListenerFn): () => boolean;
-    once<ListenerFn extends GenericFn = GenericFn>(event: string[], listener: ListenerFn): () => boolean[];
-    once<ListenerFn extends GenericFn = GenericFn>(event: string | string[], listener: ListenerFn): () => boolean | boolean[];
-    off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(event: string[], listener: ListenerFn): boolean[];
-    off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(event: string, listener: ListenerFn): boolean;
-    off<ListenerFn extends GenericFn | OnceWrapperFn = GenericFn>(event: string | string[], listener: ListenerFn): boolean | boolean[];
-    /**
-     * 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"
-     *
-     */
-    emit<Args extends GenericParams>(event: string | string[], ...args: Args): void;
-    /**
-     * 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}`);
-     *     target.push(data);
-     *     return target;
-     *   });
-     *   const result = await events.reduce('event', [], 'Hello');
-     *   // result would be a list of data fetched from the API.
-     *
-     */
-    reduce<Target, Args extends GenericParams>(event: string | string[], target: Target, ...args: Args): Promise<Target>;
-    /**
-     * 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);
-     *     return target;
-     *   });
-     *   events.reduce('event', [], 'Hello'); // returns ['Hello']
-     *
-     */
-    reduceSync<Target, ReducerArgs extends GenericParams>(event: string | string[], target: Target, ...args: ReducerArgs): Target;
-}
-/**
- * Shorthand for `new EventsHub()`.
- *
- * @returns A new instance of {@link EventsHub}.
- */
-declare const eventsHub: () => EventsHub;
-export { EventsHub, eventsHub };