@d1g1tal/subscribr 2.0.2 → 3.0.1

package/README.md

@@ -3,27 +3,59 @@ JavaScript Publish/Subscribe
 
 This simple class enables you to subscribe and publish events using the Observer pattern.
 
+Basically, you subscribe your event handler using the `Subscribr` instance and are returned a `Subscription` instance.
+
+When the event is published, your event handler will be called.
+
 ### Installation:
 ```bash
 npm install @d1g1tal/subscribr --save
 ```
+Or Script tags from downloaded script or from a NPM CDN like jsDelivr
+
+```html
+<!-- Load as global script -->
+<script src="/app/js/subscribr.min.js"></script>
+
+<!-- Load from CDN -->
+<script src="https://cdn.jsdelivr.net/npm/@d1g1tal/subscribr@2/dist/browser/subscribr.min.js"></script>
+```
 
 ### Usage:
 ```javascript
+// ES Module
+import Subscribr from '@d1g1tal/subscribr';
+
 const subscribr = new Subscribr();
 const eventName = 'myEvent';
-const eventHandler = (event) => console.log(`Event: '${event.type}' published`);
 
 // Subscribr.prototype.subscribe returns a Subscription object.
-const subscription = subscribr.subscribe(eventName, eventHandler);
+const mySubscription = subscribr.subscribe(eventName, (event, data) => console.log(`Event: '${event.type}' published with data: ${data}`));
+
+// Publish the event with just the name and a CustomEvent will be created with the eventName. All handlers that have subscribed are called
+subscribr.publish(eventName, { foo: 'bar', zip: 'fizz' }); // Event: 'myEvent' published with data: { foo: 'bar', zip: 'fizz' }
+
+// Is the event subscribed?
+const isSubscribed = subscribr.isSubscribed(mySubscription); // true
+
+const isUnsubscribed = subscribr.unsubscribe(mySubscription); // true
+
+const isSubscribed = subscribr.isSubscribed(mySubscription); // false
+
+
+// Subscribe to a DOM event
+const eventTargetSubscription = subsribr.subscribe('eventTargetChanged', (event, data) => console.log(`Event target changed with data: ${data}`));
 
-// Publish the event and all handlers that have subscribed are called
-subscribr.publish(eventName, new Event(eventName)); // Event: 'myEvent' published
+// Add some event to an event target (DOMElement)
+new EventTarget().addEventListener('change', function(event) {
+	// Publish the event and all handlers that have subscribed are called
+	subscribr.publish('eventTargetChanged', event, { value: this.value }); // Event target changed with data: {value: 'new value'}
+});
 
 // Is the event subscribed?
-const isSubscribed = subscribr.isSubscribed(subscription); // true
+const isSubscribed = subscribr.isSubscribed(eventTargetSubscription); // true
 
-const isUnsubscribed = subscription.unsubscribe(); // true
+const isUnsubscribed = subscribr.unsubscribe(eventTargetSubscription); // true
 
-const isSubscribed = subscribr.isSubscribed(subscription); // false
+const isSubscribed = subscribr.isSubscribed(eventTargetSubscription); // false
 ```

package/dist/browser/subscribr.js

@@ -23,120 +23,15 @@ var Subscribr = (() => {
     default: () => Subscribr
   });
 
-  // node_modules/@d1g1tal/collections/src/list.js
-  var List = class {
-    #array;
-    constructor(iterable = []) {
-      this.#array = Array.of(...iterable);
-    }
-    static from(iterable, mapper, context) {
-      return new List(Array.from(iterable, mapper, context));
-    }
-    static withSize(size) {
-      return new List(new Array(size));
-    }
-    add(element) {
-      this.#array.push(element);
-      return this;
-    }
-    addAll(iterable) {
-      this.#array.push(...iterable);
-      return this;
-    }
-    clear() {
-      this.#array.length = 0;
-    }
-    concat(elements) {
-      return this(this.#array.concat(...elements));
-    }
-    every(predicate) {
-      return this.#array.every((element, index) => predicate(element, index, this));
-    }
-    some(predicate) {
-      return this.#array.some((element, index) => predicate(element, index, this));
-    }
-    filter(predicate) {
-      return new List(this.#array.filter((element, index) => predicate(element, index, this)));
-    }
-    find(predicate, context) {
-      return this.#array.find((element, index) => predicate(element, index, this), context);
-    }
-    findIndex(predicate, context) {
-      return this.#array.findIndex((element, index) => predicate(element, index, this), context);
-    }
-    map(mapper) {
-      return new List(this.#array.map((element, index) => mapper(element, index, this)));
-    }
-    reduce(reducer, initialValue) {
-      return this.#array.reduce(reducer, initialValue);
-    }
-    sort(comparator) {
-      this.#array.sort(comparator);
-      return this;
-    }
-    forEach(consumer) {
-      this.#array.forEach((element, index) => consumer(element, index, this));
-    }
-    get(element, fromIndex = 0) {
-      return this.#array.at(this.#array.indexOf(element, fromIndex));
-    }
-    has(element) {
-      return this.#array.includes(element);
-    }
-    insert(index, element) {
-      this.#array.splice(index, 0, element);
-    }
-    delete(element) {
-      return this.#array.splice(this.#array.indexOf(element), 1).length == 1;
-    }
-    deleteAt(index) {
-      return this.#array.splice(index, 1).length == 1;
-    }
-    keys() {
-      return this.#array.keys();
-    }
-    values() {
-      return this[Symbol.iterator]();
-    }
-    entries() {
-      return this.#array.entries();
-    }
-    isEmpty() {
-      return this.#array.length === 0;
-    }
-    toArray() {
-      return [...this.#array];
-    }
-    toString() {
-      return this.#array.toString();
-    }
-    valueOf() {
-      return this.#array.valueOf();
-    }
-    get size() {
-      return this.#array.length;
-    }
-    [Symbol.iterator]() {
-      return this.#array[Symbol.iterator]();
-    }
-    get [Symbol.toStringTag]() {
-      return "List";
-    }
-  };
-
-  // node_modules/@d1g1tal/collections/src/multi-map.js
-  var MultiMap = class extends Map {
-    set(key, value) {
-      super.set(key, (this.get(key) ?? new List()).add(value));
-      return this;
-    }
-    [Symbol.toStringTag]() {
-      return "MultiMap";
-    }
-  };
-
   // node_modules/@d1g1tal/collections/src/set-multi-map.js
   var SetMultiMap = class extends Map {
+    /**
+     * Adds a new element with a specified key and value to the SetMultiMap. If an element with the same key already exists, the value will be added to the underlying {@link Set}.
+     *
+     * @param {*} key The key to set.
+     * @param {*} value The value to add to the SetMultiMap
+     * @returns {SetMultiMap} The SetMultiMap with the updated key and value.
+     */
     set(key, value) {
       super.set(key, (super.get(key) ?? /* @__PURE__ */ new Set()).add(value));
       return this;
@@ -146,49 +41,26 @@ var Subscribr = (() => {
     }
   };
 
-  // node_modules/@d1g1tal/collections/src/node.js
-  var Node = class {
-    #value;
-    #next;
-    constructor(value) {
-      this.#value = value;
-      this.#next = null;
-    }
-    get value() {
-      return this.#value;
-    }
-    get next() {
-      return this.#next;
-    }
-    get [Symbol.toStringTag]() {
-      return "Node";
-    }
-  };
-
-  // node_modules/@d1g1tal/collections/src/weak-set-multi-map.js
-  var WeakSetMultiMap = class extends Map {
-    set(key, value) {
-      super.set(key, (super.get(key) ?? /* @__PURE__ */ new WeakSet()).add(value));
-      return this;
-    }
-    [Symbol.toStringTag]() {
-      return "WeakSetMultiMap";
-    }
-  };
-
   // src/context-event-handler.js
   var ContextEventHandler = class {
     #context;
     #eventHandler;
+    /**
+     * @param {*} context The context to bind to the event handler.
+     * @param {function(*): void} eventHandler The event handler to call when the event is published.
+     */
     constructor(context, eventHandler) {
       this.#context = context;
       this.#eventHandler = eventHandler;
     }
-    get context() {
-      return this.#context;
-    }
-    get eventHandler() {
-      return this.#eventHandler;
+    /**
+     * Call the event handler for the provided event.
+     *
+     * @param {Event} event The event to handle
+     * @param {*} [data] The value to be passed to the event handler as a parameter.
+     */
+    handle(event, data) {
+      this.#eventHandler.call(this.#context, event, data);
     }
     get [Symbol.toStringTag]() {
       return "ContextEventHandler";
@@ -199,47 +71,64 @@ var Subscribr = (() => {
   var Subscription = class {
     #eventName;
     #contextEventHandler;
-    #unsubscribe;
-    constructor(eventName, contextEventHandler, unsubscribe) {
+    /**
+     * @param {string} eventName The event name.
+     * @param {ContextEventHandler} contextEventHandler Then context event handler.
+     */
+    constructor(eventName, contextEventHandler) {
       this.#eventName = eventName;
       this.#contextEventHandler = contextEventHandler;
-      this.#unsubscribe = unsubscribe;
     }
+    /**
+     * Gets the event name for the subscription.
+     *
+     * @returns {string} The event name.
+     */
     get eventName() {
       return this.#eventName;
     }
-    get context() {
-      return this.#contextEventHandler.context;
-    }
-    get eventHandler() {
-      return this.#contextEventHandler.eventHandler;
+    /**
+     * Gets the context event handler.
+     *
+     * @returns {ContextEventHandler} The context event handler
+     */
+    get contextEventHandler() {
+      return this.#contextEventHandler;
     }
-    unsubscribe() {
-      return this.#unsubscribe();
+    get [Symbol.toStringTag]() {
+      return "Subscription";
     }
   };
 
   // src/subscribr.js
   var Subscribr = class {
+    /** @type {SetMultiMap<string, ContextEventHandler>} */
     #subscribers;
     constructor() {
-      this.#subscribers = new MultiMap();
-    }
-    subscribe(eventName, eventHandler, context) {
+      this.#subscribers = new SetMultiMap();
+    }
+    /**
+     * Subscribe to an event
+     *
+     * @param {string} eventName The event name to subscribe to.
+     * @param {function(Event, *): void} eventHandler The event handler to call when the event is published.
+     * @param {*} [context] The context to bind to the event handler.
+     * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.
+     */
+    subscribe(eventName, eventHandler, context = eventHandler) {
       const contextEventHandler = new ContextEventHandler(context, eventHandler);
       this.#subscribers.set(eventName, contextEventHandler);
-      return new Subscription(eventName, contextEventHandler, () => this.#unsubscribe(eventName, contextEventHandler));
-    }
-    publish(eventName, data) {
-      this.#subscribers.get(eventName)?.forEach(({ context, eventHandler }) => eventHandler.call(context, data));
-    }
-    isSubscribed({ eventName, eventHandler: handler }) {
-      return this.#subscribers.get(eventName)?.some(({ eventHandler }) => eventHandler === handler);
-    }
-    get [Symbol.toStringTag]() {
-      return "Subscribr";
-    }
-    #unsubscribe(eventName, contextEventHandler) {
+      return new Subscription(eventName, contextEventHandler);
+    }
+    /**
+     * Unsubscribe from the event
+     *
+     * @param {Subscription} subscription The subscription to unsubscribe.
+     * @param {string} subscription.eventName The event name to subscribe to.
+     * @param {ContextEventHandler} subscription.contextEventHandler The event handler to call when the event is published.
+     * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.
+     */
+    unsubscribe({ eventName, contextEventHandler }) {
       const contextEventHandlers = this.#subscribers.get(eventName);
       const removed = contextEventHandlers?.delete(contextEventHandler);
       if (removed && contextEventHandlers.size == 0) {
@@ -247,6 +136,33 @@ var Subscribr = (() => {
       }
       return removed;
     }
+    /**
+     * Publish an event
+     *
+     * @param {string} eventName The name of the event.
+     * @param {Event} event The event to be handled.
+     * @param {*} [data] The value to be passed to the event handler as a parameter.
+     */
+    publish(eventName, event = new CustomEvent(eventName), data) {
+      if (data == null && !(event instanceof Event)) {
+        [data, event] = [event, new CustomEvent(eventName)];
+      }
+      this.#subscribers.get(eventName)?.forEach((contextEventHandler) => contextEventHandler.handle(event, data));
+    }
+    /**
+     * Check if the event and handler are subscribed.
+     *
+     * @param {Subscription} subscription The subscription object.
+     * @param {string} subscription.eventName The name of the event to check.
+     * @param {ContextEventHandler} subscription.contextEventHandler The event handler to check.
+     * @returns {boolean} true if the event name and handler are subscribed, false otherwise.
+     */
+    isSubscribed({ eventName, contextEventHandler }) {
+      return this.#subscribers.get(eventName)?.has(contextEventHandler);
+    }
+    get [Symbol.toStringTag]() {
+      return "Subscribr";
+    }
   };
   return __toCommonJS(subscribr_exports);
 })();

package/dist/browser/subscribr.min.js

@@ -1,3 +1,3 @@
-var Subscribr=(()=>{var f=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var x=(n,t)=>{for(var e in t)f(n,e,{get:t[e],enumerable:!0})},S=(n,t,e,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of g(t))!m.call(n,s)&&s!==e&&f(n,s,{get:()=>t[s],enumerable:!(r=p(t,s))||r.enumerable});return n};var b=n=>S(f({},"__esModule",{value:!0}),n);var v={};x(v,{default:()=>d});var i=class{#t;constructor(t=[]){this.#t=Array.of(...t)}static from(t,e,r){return new i(Array.from(t,e,r))}static withSize(t){return new i(new Array(t))}add(t){return this.#t.push(t),this}addAll(t){return this.#t.push(...t),this}clear(){this.#t.length=0}concat(t){return this(this.#t.concat(...t))}every(t){return this.#t.every((e,r)=>t(e,r,this))}some(t){return this.#t.some((e,r)=>t(e,r,this))}filter(t){return new i(this.#t.filter((e,r)=>t(e,r,this)))}find(t,e){return this.#t.find((r,s)=>t(r,s,this),e)}findIndex(t,e){return this.#t.findIndex((r,s)=>t(r,s,this),e)}map(t){return new i(this.#t.map((e,r)=>t(e,r,this)))}reduce(t,e){return this.#t.reduce(t,e)}sort(t){return this.#t.sort(t),this}forEach(t){this.#t.forEach((e,r)=>t(e,r,this))}get(t,e=0){return this.#t.at(this.#t.indexOf(t,e))}has(t){return this.#t.includes(t)}insert(t,e){this.#t.splice(t,0,e)}delete(t){return this.#t.splice(this.#t.indexOf(t),1).length==1}deleteAt(t){return this.#t.splice(t,1).length==1}keys(){return this.#t.keys()}values(){return this[Symbol.iterator]()}entries(){return this.#t.entries()}isEmpty(){return this.#t.length===0}toArray(){return[...this.#t]}toString(){return this.#t.toString()}valueOf(){return this.#t.valueOf()}get size(){return this.#t.length}[Symbol.iterator](){return this.#t[Symbol.iterator]()}get[Symbol.toStringTag](){return"List"}};var u=class extends Map{set(t,e){return super.set(t,(this.get(t)??new i).add(e)),this}[Symbol.toStringTag](){return"MultiMap"}};var a=class extends Map{set(t,e){return super.set(t,(super.get(t)??new Set).add(e)),this}[Symbol.toStringTag](){return"SetMultiMap"}};var l=class{#t;#e;constructor(t){this.#t=t,this.#e=null}get value(){return this.#t}get next(){return this.#e}get[Symbol.toStringTag](){return"Node"}};var c=class extends Map{set(t,e){return super.set(t,(super.get(t)??new WeakSet).add(e)),this}[Symbol.toStringTag](){return"WeakSetMultiMap"}};var h=class{#t;#e;constructor(t,e){this.#t=t,this.#e=e}get context(){return this.#t}get eventHandler(){return this.#e}get[Symbol.toStringTag](){return"ContextEventHandler"}};var o=class{#t;#e;#r;constructor(t,e,r){this.#t=t,this.#e=e,this.#r=r}get eventName(){return this.#t}get context(){return this.#e.context}get eventHandler(){return this.#e.eventHandler}unsubscribe(){return this.#r()}};var d=class{#t;constructor(){this.#t=new u}subscribe(t,e,r){let s=new h(r,e);return this.#t.set(t,s),new o(t,s,()=>this.#e(t,s))}publish(t,e){this.#t.get(t)?.forEach(({context:r,eventHandler:s})=>s.call(r,e))}isSubscribed({eventName:t,eventHandler:e}){return this.#t.get(t)?.some(({eventHandler:r})=>r===e)}get[Symbol.toStringTag](){return"Subscribr"}#e(t,e){let r=this.#t.get(t),s=r?.delete(e);return s&&r.size==0&&this.#t.delete(t),s}};return b(v);})();
+var Subscribr=(()=>{var c=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var d=(s,t)=>{for(var e in t)c(s,e,{get:t[e],enumerable:!0})},b=(s,t,e,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of h(t))!g.call(s,r)&&r!==e&&c(s,r,{get:()=>t[r],enumerable:!(n=a(t,r))||n.enumerable});return s};var p=s=>b(c({},"__esModule",{value:!0}),s);var S={};d(S,{default:()=>l});var o=class extends Map{set(t,e){return super.set(t,(super.get(t)??new Set).add(e)),this}[Symbol.toStringTag](){return"SetMultiMap"}};var i=class{#t;#e;constructor(t,e){this.#t=t,this.#e=e}handle(t,e){this.#e.call(this.#t,t,e)}get[Symbol.toStringTag](){return"ContextEventHandler"}};var u=class{#t;#e;constructor(t,e){this.#t=t,this.#e=e}get eventName(){return this.#t}get contextEventHandler(){return this.#e}get[Symbol.toStringTag](){return"Subscription"}};var l=class{#t;constructor(){this.#t=new o}subscribe(t,e,n=e){let r=new i(n,e);return this.#t.set(t,r),new u(t,r)}unsubscribe({eventName:t,contextEventHandler:e}){let n=this.#t.get(t),r=n?.delete(e);return r&&n.size==0&&this.#t.delete(t),r}publish(t,e=new CustomEvent(t),n){n==null&&!(e instanceof Event)&&([n,e]=[e,new CustomEvent(t)]),this.#t.get(t)?.forEach(r=>r.handle(e,n))}isSubscribed({eventName:t,contextEventHandler:e}){return this.#t.get(t)?.has(e)}get[Symbol.toStringTag](){return"Subscribr"}};return p(S);})();
 window.Subscribr = Subscribr.default;
 //# sourceMappingURL=subscribr.min.js.map

package/dist/browser/subscribr.min.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/subscribr.js", "../../node_modules/@d1g1tal/collections/src/list.js", "../../node_modules/@d1g1tal/collections/src/multi-map.js", "../../node_modules/@d1g1tal/collections/src/set-multi-map.js", "../../node_modules/@d1g1tal/collections/src/node.js", "../../node_modules/@d1g1tal/collections/src/weak-set-multi-map.js", "../../src/context-event-handler.js", "../../src/subscription.js"],
-  "sourcesContent": ["import { MultiMap } from '@d1g1tal/collections';\nimport ContextEventHandler from './context-event-handler.js';\nimport Subscription from './subscription.js';\n\nexport default class Subscribr {\n\t/** @type {MultiMap<string, ContextEventHandler>} */\n\t#subscribers;\n\n\tconstructor() {\n\t\tthis.#subscribers = new MultiMap();\n\t}\n\n\t/**\n\t * Subscribe to an event\n\t *\n\t * @param {string} eventName The event name to subscribe to.\n\t * @param {function(*): void} eventHandler The event handler to call when the event is published.\n\t * @param {*} [context] The context to bind to the event handler.\n\t * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.\n\t */\n\tsubscribe(eventName, eventHandler, context) {\n\t\tconst contextEventHandler = new ContextEventHandler(context, eventHandler);\n\t\tthis.#subscribers.set(eventName, contextEventHandler);\n\n\t\treturn new Subscription(eventName, contextEventHandler, () => this.#unsubscribe(eventName, contextEventHandler));\n\t}\n\n\t/**\n\t * Publish an event\n\t *\n\t * @param {string} eventName The name of the event.\n\t * @param {*} [data] The value to be passed to the event handler as a parameter.\n\t */\n\tpublish(eventName, data) {\n\t\tthis.#subscribers.get(eventName)?.forEach(({context, eventHandler}) => eventHandler.call(context, data));\n\t}\n\n\t/**\n\t * Check if the event and handler are subscribed.\n\t *\n\t * @param {Subscription} subscription The subscription object.\n\t * @param {string} subscription.eventName The name of the event to check.\n\t * @param {function(*)} subscription.eventHandler The event handler to check.\n\t * @returns {boolean} true if the event name and handler are subscribed, false otherwise.\n\t */\n\tisSubscribed({ eventName, eventHandler: handler}) {\n\t\treturn this.#subscribers.get(eventName)?.some(({ eventHandler }) => eventHandler === handler);\n\t}\n\n\tget [Symbol.toStringTag]() {\n\t\treturn 'Subscribr';\n\t}\n\n\t/**\n\t * Unsubscribe from the event\n\t *\n\t * @param {string} eventName The event name to subscribe to.\n\t * @param {ContextEventHandler} contextEventHandler The event handler to call when the event is published.\n\t * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.\n\t */\n\t#unsubscribe(eventName, contextEventHandler) {\n\t\tconst contextEventHandlers = this.#subscribers.get(eventName);\n\t\tconst removed = contextEventHandlers?.delete(contextEventHandler);\n\n\t\tif (removed && contextEventHandlers.size == 0) {\n\t\t\tthis.#subscribers.delete(eventName);\n\t\t}\n\n\t\treturn removed;\n\t}\n}", "\n/**\n *\n * @template E\n * @typedef {Iterable<E>} List<E>\n */\n\n/**\n * @template E\n * @type {List<E>}\n */\nexport default class List {\n\t/** @type {Array<E>} */\n\t#array;\n\n\t/**\n\t *\n\t * @param {Iterable<E>} [iterable]\n\t */\n\tconstructor(iterable = []) {\n\t\tthis.#array = Array.of(...iterable);\n\t}\n\n\t/**\n\t *\n\t * @param {Iterable<E>} iterable\n\t * @param {function(E, number?)} mapper\n\t * @param {*} context\n\t * @returns {List<E>}\n\t */\n\tstatic from(iterable, mapper, context) {\n\t\treturn new List(Array.from(iterable, mapper, context));\n\t}\n\n\tstatic withSize(size) {\n\t\treturn new List(new Array(size));\n\t}\n\n\t/**\n\t *\n\t * @param {E} element\n\t * @returns {List<E>} The updated list\n\t */\n\tadd(element) {\n\t\tthis.#array.push(element);\n\n\t\treturn this;\n\t}\n\n\t/**\n\t *\n\t * @param {Iterable<E>} iterable\n\t * @returns {List<E>} The updated list\n\t */\n\taddAll(iterable) {\n\t\tthis.#array.push(...iterable);\n\n\t\treturn this;\n\t}\n\n\tclear() {\n\t\tthis.#array.length = 0;\n\t}\n\n\t/**\n\t *\n\t * @param {E} elements\n\t * @returns {List<E>}\n\t */\n\tconcat(elements) {\n\t\treturn this(this.#array.concat(...elements));\n\t}\n\n\t/**\n\t *\n\t * @param {function(E, number?, List<E>?): boolean} predicate\n\t * @returns {boolean}\n\t */\n\tevery(predicate) {\n\t\treturn this.#array.every((element, index) => predicate(element, index, this));\n\t}\n\n\t/**\n\t *\n\t * @param {function(E, number?, List<E>?): boolean} predicate\n\t * @returns {boolean}\n\t */\n\tsome(predicate) {\n\t\treturn this.#array.some((element, index) => predicate(element, index, this));\n\t}\n\n\t/**\n\t *\n\t * @param {function(E, number?, List<E>?): boolean} predicate\n\t * @returns {List<E>}\n\t */\n\tfilter(predicate) {\n\t\treturn new List(this.#array.filter((element, index) => predicate(element, index, this)));\n\t}\n\n\t/**\n\t *\n\t * @param {function(E, number?, List<E>?): boolean} predicate\n\t * @param {*} [context] Optional object to use as this when calling the predicate function\n\t * @returns {E}\n\t */\n\tfind(predicate, context) {\n\t\treturn this.#array.find((element, index) => predicate(element, index, this), context);\n\t}\n\n\t/**\n\t *\n\t * @param {function(E, number?, List<E>?): boolean} predicate\n\t * @param {*} [context] Optional object to use as this when calling the predicate function\n\t * @returns {number}\n\t */\n\tfindIndex(predicate, context) {\n\t\treturn this.#array.findIndex((element, index) => predicate(element, index, this), context);\n\t}\n\n\t/**\n\t *\n\t * @param {function(E, number?, List<E>?)} mapper\n\t * @returns {List<E>}\n\t */\n\tmap(mapper) {\n\t\treturn new List(this.#array.map((element, index) => mapper(element, index, this)));\n\t}\n\n\t/**\n\t * Executes a user-supplied \"reducer\" callback function on each element of the list, in order,\n\t * passing in the return value from the calculation on the preceding element. The final result\n\t * of running the reducer across all elements of the array is a single value.\n\t *\n\t * @param {function(E, E, *)} reducer\n\t * @param {*} [initialValue]\n\t * @returns {*}\n\t */\n\treduce(reducer, initialValue) {\n\t\treturn this.#array.reduce(reducer, initialValue);\n\t}\n\n\t/**\n\t * Sorts the elements of a list in place and returns the reference to the same list, now sorted.\n\t * The default sort order is ascending, built upon converting the elements into strings,\n\t * then comparing their sequences of UTF-16 code units values.\n\t *\n\t * The sort() method preserves empty slots. If the source list is sparse, the empty slots are moved to the end of the list, and always come after all the undefined values.\n\t *\n\t * @example\n\t * // returns\n\t * new List([50, 3, 20, 33, 9, 1]).sort();\n\t * @param {function(E, E): number} [comparator] A function that defines the sort order. If omitted, the list elements are converted to strings, then sorted according to each character's Unicode code point value.\n\t * @returns {List<E>} The reference to the original list, now sorted. Note that the list is sorted in place, and no copy is made.\n\t */\n\tsort(comparator) {\n\t\tthis.#array.sort(comparator);\n\n\t\treturn this;\n\t}\n\n\t/**\n\t *\n\t * @param {function(E, number?, List<E>?): boolean} consumer\n\t */\n\tforEach(consumer) {\n\t\tthis.#array.forEach((element, index) => consumer(element, index, this));\n\t}\n\n\t/**\n\t *\n\t * @param {E} element\n\t * @param {number} [fromIndex]\n\t * @returns {E}\n\t */\n\tget(element, fromIndex = 0) {\n\t\treturn this.#array.at(this.#array.indexOf(element, fromIndex));\n\t}\n\n\t/**\n\t *\n\t * @param {E} element\n\t * @returns {boolean}\n\t */\n\thas(element) {\n\t\treturn this.#array.includes(element);\n\t}\n\n\t/**\n\t * Inserts the entry in a sorted list in the correct position.\n\t * The list must be sorted in ascending order to work.\n\t *\n\t * @param {number} index\n\t * @param {E} element The entry to add to the list.\n\t */\n\tinsert(index, element) {\n\t\tthis.#array.splice(index, 0, element);\n\t}\n\n\t/**\n\t * Removes the element associated to the value and returns a boolean asserting whether an element was successfully removed or not.\n\t *\n\t * @param {E} element The element to remove\n\t * @returns {boolean} true if element was already in {@link List}; otherwise false.\n\t */\n\tdelete(element) {\n\t\treturn this.#array.splice(this.#array.indexOf(element), 1).length == 1;\n\t}\n\n\t/**\n\t * Removes the element at the specified index and returns a boolean asserting whether an element was successfully removed or not.\n\t *\n\t * @param {number} index The element to remove\n\t * @returns {boolean} true if element was already in {@link List}; otherwise false.\n\t */\n\tdeleteAt(index) {\n\t\treturn this.#array.splice(index, 1).length == 1;\n\t}\n\n\tkeys() {\n\t\treturn this.#array.keys();\n\t}\n\n\t/**\n\t *\n\t * @returns {IterableIterator<E>}\n\t */\n\tvalues() {\n\t\treturn this[Symbol.iterator]();\n\t}\n\n\t/**\n\t *\n\t * @returns {IterableIterator<number, E>}\n\t */\n\tentries() {\n\t\treturn this.#array.entries();\n\t}\n\n\t/**\n\t * Checks to see if the list is empty\n\t *\n\t * @returns {boolean} true if the list is empty, false otherwise.\n\t */\n\tisEmpty() {\n\t\treturn this.#array.length === 0;\n\t}\n\n\ttoArray() {\n\t\treturn [...this.#array];\n\t}\n\n\ttoString() {\n\t\treturn this.#array.toString();\n\t}\n\n\tvalueOf() {\n\t\treturn this.#array.valueOf();\n\t}\n\n\tget size() {\n\t\treturn this.#array.length;\n\t}\n\n\t[Symbol.iterator]() {\n\t\treturn this.#array[Symbol.iterator]();\n\t}\n\n\tget [Symbol.toStringTag]() {\n\t\treturn 'List';\n\t}\n}", "import List from './list.js';\n\n/**\n *\n * @template K\n * @template V\n * @typedef {Map<K, V>} MultiMap\n * @extends Map\n */\nexport default class MultiMap extends Map {\n\t/**\n\t * Adds a new element with a specified key and value to the MultiMap.\n\t * If an element with the same key already exists, the value will be added to the underlying {@link List}.\n\t *\n\t * @override\n\t * @template K\n\t * @template V\n\t * @param {K} key The key to set.\n\t * @param {V} value The value to add to the MultiMap\n\t * @returns {MultiMap<K, V>} The MultiMap with the updated key and value.\n\t */\n\tset(key, value) {\n\t\tsuper.set(key, (this.get(key) ?? new List()).add(value));\n\n\t\treturn this;\n\t}\n\n\t[Symbol.toStringTag]() {\n\t\treturn 'MultiMap';\n\t}\n}", "/**\n *\n * @typedef {Map<*, *>} MultiMap\n * @extends Map\n */\nexport default class SetMultiMap extends Map {\n\t/**\n\t * Adds a new element with a specified key and value to the MultiMap. If an element with the same key already exists, the value will be added to the underlying {@link Set}.\n\t *\n\t * @param {*} key The key to set.\n\t * @param {*} value The value to add to the MultiMap\n\t * @returns {MultiMap} The MultiMap with the updated key and value.\n\t */\n\tset(key, value) {\n\t\tsuper.set(key, (super.get(key) ?? new Set()).add(value));\n\n\t\treturn this;\n\t}\n\n\t[Symbol.toStringTag]() {\n\t\treturn 'SetMultiMap';\n\t}\n}", "export default class Node {\n\t#value;\n\t#next;\n\n\tconstructor(value) {\n\t\tthis.#value = value;\n\t\tthis.#next = null;\n\t}\n\n\tget value() {\n\t\treturn this.#value;\n\t}\n\n\tget next() {\n\t\treturn this.#next;\n\t}\n\n\tget [Symbol.toStringTag]() {\n\t\treturn 'Node';\n\t}\n}", "/**\n *\n * @typedef {Map<*, *>} MultiMap\n * @extends Map\n */\nexport default class WeakSetMultiMap extends Map {\n\t/**\n\t * Adds a new element with a specified key and value to the MultiMap. If an element with the same key already exists, the value will be added to the underlying {@link Set}.\n\t *\n\t * @param {*} key The key to set.\n\t * @param {*} value The value to add to the MultiMap\n\t * @returns {MultiMap} The MultiMap with the updated key and value.\n\t */\n\tset(key, value) {\n\t\tsuper.set(key, (super.get(key) ?? new WeakSet()).add(value));\n\n\t\treturn this;\n\t}\n\n\t[Symbol.toStringTag]() {\n\t\treturn 'WeakSetMultiMap';\n\t}\n}", "export default class ContextEventHandler {\n\t#context;\n\t#eventHandler;\n\n\t/**\n\t *\n\t * @param {*} context The context to bind to the event handler.\n\t * @param {function(*): void} eventHandler The event handler to call when the event is published.\n\t */\n\tconstructor(context, eventHandler) {\n\t\tthis.#context = context;\n\t\tthis.#eventHandler = eventHandler;\n\t}\n\n\tget context() {\n\t\treturn this.#context;\n\t}\n\n\tget eventHandler() {\n\t\treturn this.#eventHandler;\n\t}\n\n\tget [Symbol.toStringTag]() {\n\t\treturn 'ContextEventHandler';\n\t}\n}", "export default class Subscription {\n\t#eventName;\n\t#contextEventHandler;\n\t#unsubscribe;\n\n\t/**\n\t *\n\t * @param {string} eventName\n\t * @param {import('./context-event-handler.js').default} contextEventHandler\n\t * @param {function(string, function(*): void): boolean} unsubscribe\n\t */\n\tconstructor(eventName, contextEventHandler, unsubscribe) {\n\t\tthis.#eventName = eventName;\n\t\tthis.#contextEventHandler = contextEventHandler;\n\t\tthis.#unsubscribe = unsubscribe;\n\t}\n\n\t/**\n\t * Gets the event name for the subscription.\n\t *\n\t * @returns {string} The event name.\n\t */\n\tget eventName() {\n\t\treturn this.#eventName;\n\t}\n\n\t/**\n\t * Gets the context which will be bound to the event handler when it is called.\n\t *\n\t * @returns {*} The event handler context.\n\t */\n\tget context() {\n\t\treturn this.#contextEventHandler.context;\n\t}\n\n\t/**\n\t * Gets the event handler for the subscription.\n\t *\n\t * @returns {function(*): void} The event handler.\n\t */\n\tget eventHandler() {\n\t\treturn this.#contextEventHandler.eventHandler;\n\t}\n\n\t/**\n\t * Unsubscribes from the event.\n\t *\n\t * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.\n\t */\n\tunsubscribe() {\n\t\treturn this.#unsubscribe();\n\t}\n}"],
-  "mappings": "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",
-  "names": ["subscribr_exports", "__export", "Subscribr", "List", "#array", "iterable", "mapper", "context", "size", "element", "elements", "predicate", "index", "reducer", "initialValue", "comparator", "consumer", "fromIndex", "MultiMap", "key", "value", "List", "SetMultiMap", "key", "value", "Node", "#value", "#next", "value", "WeakSetMultiMap", "key", "value", "ContextEventHandler", "#context", "#eventHandler", "context", "eventHandler", "Subscription", "#eventName", "#contextEventHandler", "#unsubscribe", "eventName", "contextEventHandler", "unsubscribe", "Subscribr", "#subscribers", "MultiMap", "eventName", "eventHandler", "context", "contextEventHandler", "ContextEventHandler", "Subscription", "#unsubscribe", "data", "handler", "contextEventHandlers", "removed"]
+  "sources": ["../../src/subscribr.js", "../../node_modules/@d1g1tal/collections/src/set-multi-map.js", "../../src/context-event-handler.js", "../../src/subscription.js"],
+  "sourcesContent": ["import SetMultiMap from '@d1g1tal/collections/set-multi-map.js';\nimport ContextEventHandler from './context-event-handler.js';\nimport Subscription from './subscription.js';\n\nexport default class Subscribr {\n\t/** @type {SetMultiMap<string, ContextEventHandler>} */\n\t#subscribers;\n\n\tconstructor() {\n\t\tthis.#subscribers = new SetMultiMap();\n\t}\n\n\t/**\n\t * Subscribe to an event\n\t *\n\t * @param {string} eventName The event name to subscribe to.\n\t * @param {function(Event, *): void} eventHandler The event handler to call when the event is published.\n\t * @param {*} [context] The context to bind to the event handler.\n\t * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.\n\t */\n\tsubscribe(eventName, eventHandler, context = eventHandler) {\n\t\tconst contextEventHandler = new ContextEventHandler(context, eventHandler);\n\t\tthis.#subscribers.set(eventName, contextEventHandler);\n\n\t\treturn new Subscription(eventName, contextEventHandler);\n\t}\n\n\t/**\n\t * Unsubscribe from the event\n\t *\n\t * @param {Subscription} subscription The subscription to unsubscribe.\n\t * @param {string} subscription.eventName The event name to subscribe to.\n\t * @param {ContextEventHandler} subscription.contextEventHandler The event handler to call when the event is published.\n\t * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.\n\t */\n\tunsubscribe({ eventName, contextEventHandler }) {\n\t\tconst contextEventHandlers = this.#subscribers.get(eventName);\n\t\tconst removed = contextEventHandlers?.delete(contextEventHandler);\n\n\t\tif (removed && contextEventHandlers.size == 0) {\n\t\t\tthis.#subscribers.delete(eventName);\n\t\t}\n\n\t\treturn removed;\n\t}\n\n\t/**\n\t * Publish an event\n\t *\n\t * @param {string} eventName The name of the event.\n\t * @param {Event} event The event to be handled.\n\t * @param {*} [data] The value to be passed to the event handler as a parameter.\n\t */\n\tpublish(eventName, event = new CustomEvent(eventName), data) {\n\t\tif (data == null && !(event instanceof Event)) {\n\t\t\t// Swap the event and data parameters because only data was passed without an event object\n\t\t\t[data, event] = [event, new CustomEvent(eventName)];\n\t\t}\n\t\tthis.#subscribers.get(eventName)?.forEach((contextEventHandler) => contextEventHandler.handle(event, data));\n\t}\n\n\t/**\n\t * Check if the event and handler are subscribed.\n\t *\n\t * @param {Subscription} subscription The subscription object.\n\t * @param {string} subscription.eventName The name of the event to check.\n\t * @param {ContextEventHandler} subscription.contextEventHandler The event handler to check.\n\t * @returns {boolean} true if the event name and handler are subscribed, false otherwise.\n\t */\n\tisSubscribed({ eventName, contextEventHandler }) {\n\t\treturn this.#subscribers.get(eventName)?.has(contextEventHandler);\n\t}\n\n\tget [Symbol.toStringTag]() {\n\t\treturn 'Subscribr';\n\t}\n}", "/**\n *\n * @typedef {Map<*, *>} SetMultiMap\n * @extends Map\n */\nexport default class SetMultiMap extends Map {\n\t/**\n\t * Adds a new element with a specified key and value to the SetMultiMap. If an element with the same key already exists, the value will be added to the underlying {@link Set}.\n\t *\n\t * @param {*} key The key to set.\n\t * @param {*} value The value to add to the SetMultiMap\n\t * @returns {SetMultiMap} The SetMultiMap with the updated key and value.\n\t */\n\tset(key, value) {\n\t\tsuper.set(key, (super.get(key) ?? new Set()).add(value));\n\n\t\treturn this;\n\t}\n\n\t[Symbol.toStringTag]() {\n\t\treturn 'SetMultiMap';\n\t}\n}", "export default class ContextEventHandler {\n\t#context;\n\t#eventHandler;\n\n\t/**\n\t * @param {*} context The context to bind to the event handler.\n\t * @param {function(*): void} eventHandler The event handler to call when the event is published.\n\t */\n\tconstructor(context, eventHandler) {\n\t\tthis.#context = context;\n\t\tthis.#eventHandler = eventHandler;\n\t}\n\n\t/**\n\t * Call the event handler for the provided event.\n\t *\n\t * @param {Event} event The event to handle\n\t * @param {*} [data] The value to be passed to the event handler as a parameter.\n\t */\n\thandle(event, data) {\n\t\tthis.#eventHandler.call(this.#context, event, data);\n\t}\n\n\tget [Symbol.toStringTag]() {\n\t\treturn 'ContextEventHandler';\n\t}\n}", "/** @typedef { import('./context-event-handler.js').default } ContextEventHandler */\n\nexport default class Subscription {\n\t#eventName;\n\t#contextEventHandler;\n\n\t/**\n\t * @param {string} eventName The event name.\n\t * @param {ContextEventHandler} contextEventHandler Then context event handler.\n\t */\n\tconstructor(eventName, contextEventHandler) {\n\t\tthis.#eventName = eventName;\n\t\tthis.#contextEventHandler = contextEventHandler;\n\t}\n\n\t/**\n\t * Gets the event name for the subscription.\n\t *\n\t * @returns {string} The event name.\n\t */\n\tget eventName() {\n\t\treturn this.#eventName;\n\t}\n\n\t/**\n\t * Gets the context event handler.\n\t *\n\t * @returns {ContextEventHandler} The context event handler\n\t */\n\tget contextEventHandler() {\n\t\treturn this.#contextEventHandler;\n\t}\n\n\tget [Symbol.toStringTag]() {\n\t\treturn 'Subscription';\n\t}\n}"],
+  "mappings": "gbAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,ICKA,IAAqBC,EAArB,cAAyC,GAAI,CAQ5C,IAAIC,EAAKC,EAAO,CACf,aAAM,IAAID,GAAM,MAAM,IAAIA,CAAG,GAAK,IAAI,KAAO,IAAIC,CAAK,CAAC,EAEhD,IACR,CAEA,CAAC,OAAO,WAAW,GAAI,CACtB,MAAO,aACR,CACD,ECtBA,IAAqBC,EAArB,KAAyC,CACxCC,GACAC,GAMA,YAAYC,EAASC,EAAc,CAClC,KAAKH,GAAWE,EAChB,KAAKD,GAAgBE,CACtB,CAQA,OAAOC,EAAOC,EAAM,CACnB,KAAKJ,GAAc,KAAK,KAAKD,GAAUI,EAAOC,CAAI,CACnD,CAEA,IAAK,OAAO,WAAW,GAAI,CAC1B,MAAO,qBACR,CACD,ECxBA,IAAqBC,EAArB,KAAkC,CACjCC,GACAC,GAMA,YAAYC,EAAWC,EAAqB,CAC3C,KAAKH,GAAaE,EAClB,KAAKD,GAAuBE,CAC7B,CAOA,IAAI,WAAY,CACf,OAAO,KAAKH,EACb,CAOA,IAAI,qBAAsB,CACzB,OAAO,KAAKC,EACb,CAEA,IAAK,OAAO,WAAW,GAAI,CAC1B,MAAO,cACR,CACD,EHhCA,IAAqBG,EAArB,KAA+B,CAE9BC,GAEA,aAAc,CACb,KAAKA,GAAe,IAAIC,CACzB,CAUA,UAAUC,EAAWC,EAAcC,EAAUD,EAAc,CAC1D,IAAME,EAAsB,IAAIC,EAAoBF,EAASD,CAAY,EACzE,YAAKH,GAAa,IAAIE,EAAWG,CAAmB,EAE7C,IAAIE,EAAaL,EAAWG,CAAmB,CACvD,CAUA,YAAY,CAAE,UAAAH,EAAW,oBAAAG,CAAoB,EAAG,CAC/C,IAAMG,EAAuB,KAAKR,GAAa,IAAIE,CAAS,EACtDO,EAAUD,GAAsB,OAAOH,CAAmB,EAEhE,OAAII,GAAWD,EAAqB,MAAQ,GAC3C,KAAKR,GAAa,OAAOE,CAAS,EAG5BO,CACR,CASA,QAAQP,EAAWQ,EAAQ,IAAI,YAAYR,CAAS,EAAGS,EAAM,CACxDA,GAAQ,MAAQ,EAAED,aAAiB,SAEtC,CAACC,EAAMD,CAAK,EAAI,CAACA,EAAO,IAAI,YAAYR,CAAS,CAAC,GAEnD,KAAKF,GAAa,IAAIE,CAAS,GAAG,QAASG,GAAwBA,EAAoB,OAAOK,EAAOC,CAAI,CAAC,CAC3G,CAUA,aAAa,CAAE,UAAAT,EAAW,oBAAAG,CAAoB,EAAG,CAChD,OAAO,KAAKL,GAAa,IAAIE,CAAS,GAAG,IAAIG,CAAmB,CACjE,CAEA,IAAK,OAAO,WAAW,GAAI,CAC1B,MAAO,WACR,CACD",
+  "names": ["subscribr_exports", "__export", "Subscribr", "SetMultiMap", "key", "value", "ContextEventHandler", "#context", "#eventHandler", "context", "eventHandler", "event", "data", "Subscription", "#eventName", "#contextEventHandler", "eventName", "contextEventHandler", "Subscribr", "#subscribers", "SetMultiMap", "eventName", "eventHandler", "context", "contextEventHandler", "ContextEventHandler", "Subscription", "contextEventHandlers", "removed", "event", "data"]
 }

package/dist/esm/subscribr.js

@@ -1,117 +1,12 @@
-// node_modules/@d1g1tal/collections/src/list.js
-var List = class {
-  #array;
-  constructor(iterable = []) {
-    this.#array = Array.of(...iterable);
-  }
-  static from(iterable, mapper, context) {
-    return new List(Array.from(iterable, mapper, context));
-  }
-  static withSize(size) {
-    return new List(new Array(size));
-  }
-  add(element) {
-    this.#array.push(element);
-    return this;
-  }
-  addAll(iterable) {
-    this.#array.push(...iterable);
-    return this;
-  }
-  clear() {
-    this.#array.length = 0;
-  }
-  concat(elements) {
-    return this(this.#array.concat(...elements));
-  }
-  every(predicate) {
-    return this.#array.every((element, index) => predicate(element, index, this));
-  }
-  some(predicate) {
-    return this.#array.some((element, index) => predicate(element, index, this));
-  }
-  filter(predicate) {
-    return new List(this.#array.filter((element, index) => predicate(element, index, this)));
-  }
-  find(predicate, context) {
-    return this.#array.find((element, index) => predicate(element, index, this), context);
-  }
-  findIndex(predicate, context) {
-    return this.#array.findIndex((element, index) => predicate(element, index, this), context);
-  }
-  map(mapper) {
-    return new List(this.#array.map((element, index) => mapper(element, index, this)));
-  }
-  reduce(reducer, initialValue) {
-    return this.#array.reduce(reducer, initialValue);
-  }
-  sort(comparator) {
-    this.#array.sort(comparator);
-    return this;
-  }
-  forEach(consumer) {
-    this.#array.forEach((element, index) => consumer(element, index, this));
-  }
-  get(element, fromIndex = 0) {
-    return this.#array.at(this.#array.indexOf(element, fromIndex));
-  }
-  has(element) {
-    return this.#array.includes(element);
-  }
-  insert(index, element) {
-    this.#array.splice(index, 0, element);
-  }
-  delete(element) {
-    return this.#array.splice(this.#array.indexOf(element), 1).length == 1;
-  }
-  deleteAt(index) {
-    return this.#array.splice(index, 1).length == 1;
-  }
-  keys() {
-    return this.#array.keys();
-  }
-  values() {
-    return this[Symbol.iterator]();
-  }
-  entries() {
-    return this.#array.entries();
-  }
-  isEmpty() {
-    return this.#array.length === 0;
-  }
-  toArray() {
-    return [...this.#array];
-  }
-  toString() {
-    return this.#array.toString();
-  }
-  valueOf() {
-    return this.#array.valueOf();
-  }
-  get size() {
-    return this.#array.length;
-  }
-  [Symbol.iterator]() {
-    return this.#array[Symbol.iterator]();
-  }
-  get [Symbol.toStringTag]() {
-    return "List";
-  }
-};
-
-// node_modules/@d1g1tal/collections/src/multi-map.js
-var MultiMap = class extends Map {
-  set(key, value) {
-    super.set(key, (this.get(key) ?? new List()).add(value));
-    return this;
-  }
-  [Symbol.toStringTag]() {
-    return "MultiMap";
-  }
-};
-
 // node_modules/@d1g1tal/collections/src/set-multi-map.js
 var SetMultiMap = class extends Map {
+  /**
+   * Adds a new element with a specified key and value to the SetMultiMap. If an element with the same key already exists, the value will be added to the underlying {@link Set}.
+   *
+   * @param {*} key The key to set.
+   * @param {*} value The value to add to the SetMultiMap
+   * @returns {SetMultiMap} The SetMultiMap with the updated key and value.
+   */
   set(key, value) {
     super.set(key, (super.get(key) ?? /* @__PURE__ */ new Set()).add(value));
     return this;
@@ -121,49 +16,26 @@ var SetMultiMap = class extends Map {
   }
 };
 
-// node_modules/@d1g1tal/collections/src/node.js
-var Node = class {
-  #value;
-  #next;
-  constructor(value) {
-    this.#value = value;
-    this.#next = null;
-  }
-  get value() {
-    return this.#value;
-  }
-  get next() {
-    return this.#next;
-  }
-  get [Symbol.toStringTag]() {
-    return "Node";
-  }
-};
-
-// node_modules/@d1g1tal/collections/src/weak-set-multi-map.js
-var WeakSetMultiMap = class extends Map {
-  set(key, value) {
-    super.set(key, (super.get(key) ?? /* @__PURE__ */ new WeakSet()).add(value));
-    return this;
-  }
-  [Symbol.toStringTag]() {
-    return "WeakSetMultiMap";
-  }
-};
-
 // src/context-event-handler.js
 var ContextEventHandler = class {
   #context;
   #eventHandler;
+  /**
+   * @param {*} context The context to bind to the event handler.
+   * @param {function(*): void} eventHandler The event handler to call when the event is published.
+   */
   constructor(context, eventHandler) {
     this.#context = context;
     this.#eventHandler = eventHandler;
   }
-  get context() {
-    return this.#context;
-  }
-  get eventHandler() {
-    return this.#eventHandler;
+  /**
+   * Call the event handler for the provided event.
+   *
+   * @param {Event} event The event to handle
+   * @param {*} [data] The value to be passed to the event handler as a parameter.
+   */
+  handle(event, data) {
+    this.#eventHandler.call(this.#context, event, data);
   }
   get [Symbol.toStringTag]() {
     return "ContextEventHandler";
@@ -174,47 +46,64 @@ var ContextEventHandler = class {
 var Subscription = class {
   #eventName;
   #contextEventHandler;
-  #unsubscribe;
-  constructor(eventName, contextEventHandler, unsubscribe) {
+  /**
+   * @param {string} eventName The event name.
+   * @param {ContextEventHandler} contextEventHandler Then context event handler.
+   */
+  constructor(eventName, contextEventHandler) {
     this.#eventName = eventName;
     this.#contextEventHandler = contextEventHandler;
-    this.#unsubscribe = unsubscribe;
   }
+  /**
+   * Gets the event name for the subscription.
+   *
+   * @returns {string} The event name.
+   */
   get eventName() {
     return this.#eventName;
   }
-  get context() {
-    return this.#contextEventHandler.context;
-  }
-  get eventHandler() {
-    return this.#contextEventHandler.eventHandler;
+  /**
+   * Gets the context event handler.
+   *
+   * @returns {ContextEventHandler} The context event handler
+   */
+  get contextEventHandler() {
+    return this.#contextEventHandler;
   }
-  unsubscribe() {
-    return this.#unsubscribe();
+  get [Symbol.toStringTag]() {
+    return "Subscription";
   }
 };
 
 // src/subscribr.js
 var Subscribr = class {
+  /** @type {SetMultiMap<string, ContextEventHandler>} */
   #subscribers;
   constructor() {
-    this.#subscribers = new MultiMap();
-  }
-  subscribe(eventName, eventHandler, context) {
+    this.#subscribers = new SetMultiMap();
+  }
+  /**
+   * Subscribe to an event
+   *
+   * @param {string} eventName The event name to subscribe to.
+   * @param {function(Event, *): void} eventHandler The event handler to call when the event is published.
+   * @param {*} [context] The context to bind to the event handler.
+   * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.
+   */
+  subscribe(eventName, eventHandler, context = eventHandler) {
     const contextEventHandler = new ContextEventHandler(context, eventHandler);
     this.#subscribers.set(eventName, contextEventHandler);
-    return new Subscription(eventName, contextEventHandler, () => this.#unsubscribe(eventName, contextEventHandler));
-  }
-  publish(eventName, data) {
-    this.#subscribers.get(eventName)?.forEach(({ context, eventHandler }) => eventHandler.call(context, data));
-  }
-  isSubscribed({ eventName, eventHandler: handler }) {
-    return this.#subscribers.get(eventName)?.some(({ eventHandler }) => eventHandler === handler);
-  }
-  get [Symbol.toStringTag]() {
-    return "Subscribr";
-  }
-  #unsubscribe(eventName, contextEventHandler) {
+    return new Subscription(eventName, contextEventHandler);
+  }
+  /**
+   * Unsubscribe from the event
+   *
+   * @param {Subscription} subscription The subscription to unsubscribe.
+   * @param {string} subscription.eventName The event name to subscribe to.
+   * @param {ContextEventHandler} subscription.contextEventHandler The event handler to call when the event is published.
+   * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.
+   */
+  unsubscribe({ eventName, contextEventHandler }) {
     const contextEventHandlers = this.#subscribers.get(eventName);
     const removed = contextEventHandlers?.delete(contextEventHandler);
     if (removed && contextEventHandlers.size == 0) {
@@ -222,6 +111,33 @@ var Subscribr = class {
     }
     return removed;
   }
+  /**
+   * Publish an event
+   *
+   * @param {string} eventName The name of the event.
+   * @param {Event} event The event to be handled.
+   * @param {*} [data] The value to be passed to the event handler as a parameter.
+   */
+  publish(eventName, event = new CustomEvent(eventName), data) {
+    if (data == null && !(event instanceof Event)) {
+      [data, event] = [event, new CustomEvent(eventName)];
+    }
+    this.#subscribers.get(eventName)?.forEach((contextEventHandler) => contextEventHandler.handle(event, data));
+  }
+  /**
+   * Check if the event and handler are subscribed.
+   *
+   * @param {Subscription} subscription The subscription object.
+   * @param {string} subscription.eventName The name of the event to check.
+   * @param {ContextEventHandler} subscription.contextEventHandler The event handler to check.
+   * @returns {boolean} true if the event name and handler are subscribed, false otherwise.
+   */
+  isSubscribed({ eventName, contextEventHandler }) {
+    return this.#subscribers.get(eventName)?.has(contextEventHandler);
+  }
+  get [Symbol.toStringTag]() {
+    return "Subscribr";
+  }
 };
 export {
   Subscribr as default

package/dist/esm/subscribr.min.js

@@ -1,2 +1,2 @@
-var n=class{#t;constructor(t=[]){this.#t=Array.of(...t)}static from(t,e,r){return new n(Array.from(t,e,r))}static withSize(t){return new n(new Array(t))}add(t){return this.#t.push(t),this}addAll(t){return this.#t.push(...t),this}clear(){this.#t.length=0}concat(t){return this(this.#t.concat(...t))}every(t){return this.#t.every((e,r)=>t(e,r,this))}some(t){return this.#t.some((e,r)=>t(e,r,this))}filter(t){return new n(this.#t.filter((e,r)=>t(e,r,this)))}find(t,e){return this.#t.find((r,s)=>t(r,s,this),e)}findIndex(t,e){return this.#t.findIndex((r,s)=>t(r,s,this),e)}map(t){return new n(this.#t.map((e,r)=>t(e,r,this)))}reduce(t,e){return this.#t.reduce(t,e)}sort(t){return this.#t.sort(t),this}forEach(t){this.#t.forEach((e,r)=>t(e,r,this))}get(t,e=0){return this.#t.at(this.#t.indexOf(t,e))}has(t){return this.#t.includes(t)}insert(t,e){this.#t.splice(t,0,e)}delete(t){return this.#t.splice(this.#t.indexOf(t),1).length==1}deleteAt(t){return this.#t.splice(t,1).length==1}keys(){return this.#t.keys()}values(){return this[Symbol.iterator]()}entries(){return this.#t.entries()}isEmpty(){return this.#t.length===0}toArray(){return[...this.#t]}toString(){return this.#t.toString()}valueOf(){return this.#t.valueOf()}get size(){return this.#t.length}[Symbol.iterator](){return this.#t[Symbol.iterator]()}get[Symbol.toStringTag](){return"List"}};var u=class extends Map{set(t,e){return super.set(t,(this.get(t)??new n).add(e)),this}[Symbol.toStringTag](){return"MultiMap"}};var a=class extends Map{set(t,e){return super.set(t,(super.get(t)??new Set).add(e)),this}[Symbol.toStringTag](){return"SetMultiMap"}};var l=class{#t;#e;constructor(t){this.#t=t,this.#e=null}get value(){return this.#t}get next(){return this.#e}get[Symbol.toStringTag](){return"Node"}};var c=class extends Map{set(t,e){return super.set(t,(super.get(t)??new WeakSet).add(e)),this}[Symbol.toStringTag](){return"WeakSetMultiMap"}};var h=class{#t;#e;constructor(t,e){this.#t=t,this.#e=e}get context(){return this.#t}get eventHandler(){return this.#e}get[Symbol.toStringTag](){return"ContextEventHandler"}};var o=class{#t;#e;#r;constructor(t,e,r){this.#t=t,this.#e=e,this.#r=r}get eventName(){return this.#t}get context(){return this.#e.context}get eventHandler(){return this.#e.eventHandler}unsubscribe(){return this.#r()}};var d=class{#t;constructor(){this.#t=new u}subscribe(t,e,r){let s=new h(r,e);return this.#t.set(t,s),new o(t,s,()=>this.#e(t,s))}publish(t,e){this.#t.get(t)?.forEach(({context:r,eventHandler:s})=>s.call(r,e))}isSubscribed({eventName:t,eventHandler:e}){return this.#t.get(t)?.some(({eventHandler:r})=>r===e)}get[Symbol.toStringTag](){return"Subscribr"}#e(t,e){let r=this.#t.get(t),s=r?.delete(e);return s&&r.size==0&&this.#t.delete(t),s}};export{d as default};
+var n=class extends Map{set(t,e){return super.set(t,(super.get(t)??new Set).add(e)),this}[Symbol.toStringTag](){return"SetMultiMap"}};var o=class{#t;#e;constructor(t,e){this.#t=t,this.#e=e}handle(t,e){this.#e.call(this.#t,t,e)}get[Symbol.toStringTag](){return"ContextEventHandler"}};var i=class{#t;#e;constructor(t,e){this.#t=t,this.#e=e}get eventName(){return this.#t}get contextEventHandler(){return this.#e}get[Symbol.toStringTag](){return"Subscription"}};var l=class{#t;constructor(){this.#t=new n}subscribe(t,e,r=e){let s=new o(r,e);return this.#t.set(t,s),new i(t,s)}unsubscribe({eventName:t,contextEventHandler:e}){let r=this.#t.get(t),s=r?.delete(e);return s&&r.size==0&&this.#t.delete(t),s}publish(t,e=new CustomEvent(t),r){r==null&&!(e instanceof Event)&&([r,e]=[e,new CustomEvent(t)]),this.#t.get(t)?.forEach(s=>s.handle(e,r))}isSubscribed({eventName:t,contextEventHandler:e}){return this.#t.get(t)?.has(e)}get[Symbol.toStringTag](){return"Subscribr"}};export{l as default};
 //# sourceMappingURL=subscribr.min.js.map

package/dist/esm/subscribr.min.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../node_modules/@d1g1tal/collections/src/list.js", "../../node_modules/@d1g1tal/collections/src/multi-map.js", "../../node_modules/@d1g1tal/collections/src/set-multi-map.js", "../../node_modules/@d1g1tal/collections/src/node.js", "../../node_modules/@d1g1tal/collections/src/weak-set-multi-map.js", "../../src/context-event-handler.js", "../../src/subscription.js", "../../src/subscribr.js"],
-  "sourcesContent": ["\n/**\n *\n * @template E\n * @typedef {Iterable<E>} List<E>\n */\n\n/**\n * @template E\n * @type {List<E>}\n */\nexport default class List {\n\t/** @type {Array<E>} */\n\t#array;\n\n\t/**\n\t *\n\t * @param {Iterable<E>} [iterable]\n\t */\n\tconstructor(iterable = []) {\n\t\tthis.#array = Array.of(...iterable);\n\t}\n\n\t/**\n\t *\n\t * @param {Iterable<E>} iterable\n\t * @param {function(E, number?)} mapper\n\t * @param {*} context\n\t * @returns {List<E>}\n\t */\n\tstatic from(iterable, mapper, context) {\n\t\treturn new List(Array.from(iterable, mapper, context));\n\t}\n\n\tstatic withSize(size) {\n\t\treturn new List(new Array(size));\n\t}\n\n\t/**\n\t *\n\t * @param {E} element\n\t * @returns {List<E>} The updated list\n\t */\n\tadd(element) {\n\t\tthis.#array.push(element);\n\n\t\treturn this;\n\t}\n\n\t/**\n\t *\n\t * @param {Iterable<E>} iterable\n\t * @returns {List<E>} The updated list\n\t */\n\taddAll(iterable) {\n\t\tthis.#array.push(...iterable);\n\n\t\treturn this;\n\t}\n\n\tclear() {\n\t\tthis.#array.length = 0;\n\t}\n\n\t/**\n\t *\n\t * @param {E} elements\n\t * @returns {List<E>}\n\t */\n\tconcat(elements) {\n\t\treturn this(this.#array.concat(...elements));\n\t}\n\n\t/**\n\t *\n\t * @param {function(E, number?, List<E>?): boolean} predicate\n\t * @returns {boolean}\n\t */\n\tevery(predicate) {\n\t\treturn this.#array.every((element, index) => predicate(element, index, this));\n\t}\n\n\t/**\n\t *\n\t * @param {function(E, number?, List<E>?): boolean} predicate\n\t * @returns {boolean}\n\t */\n\tsome(predicate) {\n\t\treturn this.#array.some((element, index) => predicate(element, index, this));\n\t}\n\n\t/**\n\t *\n\t * @param {function(E, number?, List<E>?): boolean} predicate\n\t * @returns {List<E>}\n\t */\n\tfilter(predicate) {\n\t\treturn new List(this.#array.filter((element, index) => predicate(element, index, this)));\n\t}\n\n\t/**\n\t *\n\t * @param {function(E, number?, List<E>?): boolean} predicate\n\t * @param {*} [context] Optional object to use as this when calling the predicate function\n\t * @returns {E}\n\t */\n\tfind(predicate, context) {\n\t\treturn this.#array.find((element, index) => predicate(element, index, this), context);\n\t}\n\n\t/**\n\t *\n\t * @param {function(E, number?, List<E>?): boolean} predicate\n\t * @param {*} [context] Optional object to use as this when calling the predicate function\n\t * @returns {number}\n\t */\n\tfindIndex(predicate, context) {\n\t\treturn this.#array.findIndex((element, index) => predicate(element, index, this), context);\n\t}\n\n\t/**\n\t *\n\t * @param {function(E, number?, List<E>?)} mapper\n\t * @returns {List<E>}\n\t */\n\tmap(mapper) {\n\t\treturn new List(this.#array.map((element, index) => mapper(element, index, this)));\n\t}\n\n\t/**\n\t * Executes a user-supplied \"reducer\" callback function on each element of the list, in order,\n\t * passing in the return value from the calculation on the preceding element. The final result\n\t * of running the reducer across all elements of the array is a single value.\n\t *\n\t * @param {function(E, E, *)} reducer\n\t * @param {*} [initialValue]\n\t * @returns {*}\n\t */\n\treduce(reducer, initialValue) {\n\t\treturn this.#array.reduce(reducer, initialValue);\n\t}\n\n\t/**\n\t * Sorts the elements of a list in place and returns the reference to the same list, now sorted.\n\t * The default sort order is ascending, built upon converting the elements into strings,\n\t * then comparing their sequences of UTF-16 code units values.\n\t *\n\t * The sort() method preserves empty slots. If the source list is sparse, the empty slots are moved to the end of the list, and always come after all the undefined values.\n\t *\n\t * @example\n\t * // returns\n\t * new List([50, 3, 20, 33, 9, 1]).sort();\n\t * @param {function(E, E): number} [comparator] A function that defines the sort order. If omitted, the list elements are converted to strings, then sorted according to each character's Unicode code point value.\n\t * @returns {List<E>} The reference to the original list, now sorted. Note that the list is sorted in place, and no copy is made.\n\t */\n\tsort(comparator) {\n\t\tthis.#array.sort(comparator);\n\n\t\treturn this;\n\t}\n\n\t/**\n\t *\n\t * @param {function(E, number?, List<E>?): boolean} consumer\n\t */\n\tforEach(consumer) {\n\t\tthis.#array.forEach((element, index) => consumer(element, index, this));\n\t}\n\n\t/**\n\t *\n\t * @param {E} element\n\t * @param {number} [fromIndex]\n\t * @returns {E}\n\t */\n\tget(element, fromIndex = 0) {\n\t\treturn this.#array.at(this.#array.indexOf(element, fromIndex));\n\t}\n\n\t/**\n\t *\n\t * @param {E} element\n\t * @returns {boolean}\n\t */\n\thas(element) {\n\t\treturn this.#array.includes(element);\n\t}\n\n\t/**\n\t * Inserts the entry in a sorted list in the correct position.\n\t * The list must be sorted in ascending order to work.\n\t *\n\t * @param {number} index\n\t * @param {E} element The entry to add to the list.\n\t */\n\tinsert(index, element) {\n\t\tthis.#array.splice(index, 0, element);\n\t}\n\n\t/**\n\t * Removes the element associated to the value and returns a boolean asserting whether an element was successfully removed or not.\n\t *\n\t * @param {E} element The element to remove\n\t * @returns {boolean} true if element was already in {@link List}; otherwise false.\n\t */\n\tdelete(element) {\n\t\treturn this.#array.splice(this.#array.indexOf(element), 1).length == 1;\n\t}\n\n\t/**\n\t * Removes the element at the specified index and returns a boolean asserting whether an element was successfully removed or not.\n\t *\n\t * @param {number} index The element to remove\n\t * @returns {boolean} true if element was already in {@link List}; otherwise false.\n\t */\n\tdeleteAt(index) {\n\t\treturn this.#array.splice(index, 1).length == 1;\n\t}\n\n\tkeys() {\n\t\treturn this.#array.keys();\n\t}\n\n\t/**\n\t *\n\t * @returns {IterableIterator<E>}\n\t */\n\tvalues() {\n\t\treturn this[Symbol.iterator]();\n\t}\n\n\t/**\n\t *\n\t * @returns {IterableIterator<number, E>}\n\t */\n\tentries() {\n\t\treturn this.#array.entries();\n\t}\n\n\t/**\n\t * Checks to see if the list is empty\n\t *\n\t * @returns {boolean} true if the list is empty, false otherwise.\n\t */\n\tisEmpty() {\n\t\treturn this.#array.length === 0;\n\t}\n\n\ttoArray() {\n\t\treturn [...this.#array];\n\t}\n\n\ttoString() {\n\t\treturn this.#array.toString();\n\t}\n\n\tvalueOf() {\n\t\treturn this.#array.valueOf();\n\t}\n\n\tget size() {\n\t\treturn this.#array.length;\n\t}\n\n\t[Symbol.iterator]() {\n\t\treturn this.#array[Symbol.iterator]();\n\t}\n\n\tget [Symbol.toStringTag]() {\n\t\treturn 'List';\n\t}\n}", "import List from './list.js';\n\n/**\n *\n * @template K\n * @template V\n * @typedef {Map<K, V>} MultiMap\n * @extends Map\n */\nexport default class MultiMap extends Map {\n\t/**\n\t * Adds a new element with a specified key and value to the MultiMap.\n\t * If an element with the same key already exists, the value will be added to the underlying {@link List}.\n\t *\n\t * @override\n\t * @template K\n\t * @template V\n\t * @param {K} key The key to set.\n\t * @param {V} value The value to add to the MultiMap\n\t * @returns {MultiMap<K, V>} The MultiMap with the updated key and value.\n\t */\n\tset(key, value) {\n\t\tsuper.set(key, (this.get(key) ?? new List()).add(value));\n\n\t\treturn this;\n\t}\n\n\t[Symbol.toStringTag]() {\n\t\treturn 'MultiMap';\n\t}\n}", "/**\n *\n * @typedef {Map<*, *>} MultiMap\n * @extends Map\n */\nexport default class SetMultiMap extends Map {\n\t/**\n\t * Adds a new element with a specified key and value to the MultiMap. If an element with the same key already exists, the value will be added to the underlying {@link Set}.\n\t *\n\t * @param {*} key The key to set.\n\t * @param {*} value The value to add to the MultiMap\n\t * @returns {MultiMap} The MultiMap with the updated key and value.\n\t */\n\tset(key, value) {\n\t\tsuper.set(key, (super.get(key) ?? new Set()).add(value));\n\n\t\treturn this;\n\t}\n\n\t[Symbol.toStringTag]() {\n\t\treturn 'SetMultiMap';\n\t}\n}", "export default class Node {\n\t#value;\n\t#next;\n\n\tconstructor(value) {\n\t\tthis.#value = value;\n\t\tthis.#next = null;\n\t}\n\n\tget value() {\n\t\treturn this.#value;\n\t}\n\n\tget next() {\n\t\treturn this.#next;\n\t}\n\n\tget [Symbol.toStringTag]() {\n\t\treturn 'Node';\n\t}\n}", "/**\n *\n * @typedef {Map<*, *>} MultiMap\n * @extends Map\n */\nexport default class WeakSetMultiMap extends Map {\n\t/**\n\t * Adds a new element with a specified key and value to the MultiMap. If an element with the same key already exists, the value will be added to the underlying {@link Set}.\n\t *\n\t * @param {*} key The key to set.\n\t * @param {*} value The value to add to the MultiMap\n\t * @returns {MultiMap} The MultiMap with the updated key and value.\n\t */\n\tset(key, value) {\n\t\tsuper.set(key, (super.get(key) ?? new WeakSet()).add(value));\n\n\t\treturn this;\n\t}\n\n\t[Symbol.toStringTag]() {\n\t\treturn 'WeakSetMultiMap';\n\t}\n}", "export default class ContextEventHandler {\n\t#context;\n\t#eventHandler;\n\n\t/**\n\t *\n\t * @param {*} context The context to bind to the event handler.\n\t * @param {function(*): void} eventHandler The event handler to call when the event is published.\n\t */\n\tconstructor(context, eventHandler) {\n\t\tthis.#context = context;\n\t\tthis.#eventHandler = eventHandler;\n\t}\n\n\tget context() {\n\t\treturn this.#context;\n\t}\n\n\tget eventHandler() {\n\t\treturn this.#eventHandler;\n\t}\n\n\tget [Symbol.toStringTag]() {\n\t\treturn 'ContextEventHandler';\n\t}\n}", "export default class Subscription {\n\t#eventName;\n\t#contextEventHandler;\n\t#unsubscribe;\n\n\t/**\n\t *\n\t * @param {string} eventName\n\t * @param {import('./context-event-handler.js').default} contextEventHandler\n\t * @param {function(string, function(*): void): boolean} unsubscribe\n\t */\n\tconstructor(eventName, contextEventHandler, unsubscribe) {\n\t\tthis.#eventName = eventName;\n\t\tthis.#contextEventHandler = contextEventHandler;\n\t\tthis.#unsubscribe = unsubscribe;\n\t}\n\n\t/**\n\t * Gets the event name for the subscription.\n\t *\n\t * @returns {string} The event name.\n\t */\n\tget eventName() {\n\t\treturn this.#eventName;\n\t}\n\n\t/**\n\t * Gets the context which will be bound to the event handler when it is called.\n\t *\n\t * @returns {*} The event handler context.\n\t */\n\tget context() {\n\t\treturn this.#contextEventHandler.context;\n\t}\n\n\t/**\n\t * Gets the event handler for the subscription.\n\t *\n\t * @returns {function(*): void} The event handler.\n\t */\n\tget eventHandler() {\n\t\treturn this.#contextEventHandler.eventHandler;\n\t}\n\n\t/**\n\t * Unsubscribes from the event.\n\t *\n\t * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.\n\t */\n\tunsubscribe() {\n\t\treturn this.#unsubscribe();\n\t}\n}", "import { MultiMap } from '@d1g1tal/collections';\nimport ContextEventHandler from './context-event-handler.js';\nimport Subscription from './subscription.js';\n\nexport default class Subscribr {\n\t/** @type {MultiMap<string, ContextEventHandler>} */\n\t#subscribers;\n\n\tconstructor() {\n\t\tthis.#subscribers = new MultiMap();\n\t}\n\n\t/**\n\t * Subscribe to an event\n\t *\n\t * @param {string} eventName The event name to subscribe to.\n\t * @param {function(*): void} eventHandler The event handler to call when the event is published.\n\t * @param {*} [context] The context to bind to the event handler.\n\t * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.\n\t */\n\tsubscribe(eventName, eventHandler, context) {\n\t\tconst contextEventHandler = new ContextEventHandler(context, eventHandler);\n\t\tthis.#subscribers.set(eventName, contextEventHandler);\n\n\t\treturn new Subscription(eventName, contextEventHandler, () => this.#unsubscribe(eventName, contextEventHandler));\n\t}\n\n\t/**\n\t * Publish an event\n\t *\n\t * @param {string} eventName The name of the event.\n\t * @param {*} [data] The value to be passed to the event handler as a parameter.\n\t */\n\tpublish(eventName, data) {\n\t\tthis.#subscribers.get(eventName)?.forEach(({context, eventHandler}) => eventHandler.call(context, data));\n\t}\n\n\t/**\n\t * Check if the event and handler are subscribed.\n\t *\n\t * @param {Subscription} subscription The subscription object.\n\t * @param {string} subscription.eventName The name of the event to check.\n\t * @param {function(*)} subscription.eventHandler The event handler to check.\n\t * @returns {boolean} true if the event name and handler are subscribed, false otherwise.\n\t */\n\tisSubscribed({ eventName, eventHandler: handler}) {\n\t\treturn this.#subscribers.get(eventName)?.some(({ eventHandler }) => eventHandler === handler);\n\t}\n\n\tget [Symbol.toStringTag]() {\n\t\treturn 'Subscribr';\n\t}\n\n\t/**\n\t * Unsubscribe from the event\n\t *\n\t * @param {string} eventName The event name to subscribe to.\n\t * @param {ContextEventHandler} contextEventHandler The event handler to call when the event is published.\n\t * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.\n\t */\n\t#unsubscribe(eventName, contextEventHandler) {\n\t\tconst contextEventHandlers = this.#subscribers.get(eventName);\n\t\tconst removed = contextEventHandlers?.delete(contextEventHandler);\n\n\t\tif (removed && contextEventHandlers.size == 0) {\n\t\t\tthis.#subscribers.delete(eventName);\n\t\t}\n\n\t\treturn removed;\n\t}\n}"],
-  "mappings": "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",
-  "names": ["List", "#array", "iterable", "mapper", "context", "size", "element", "elements", "predicate", "index", "reducer", "initialValue", "comparator", "consumer", "fromIndex", "MultiMap", "key", "value", "List", "SetMultiMap", "key", "value", "Node", "#value", "#next", "value", "WeakSetMultiMap", "key", "value", "ContextEventHandler", "#context", "#eventHandler", "context", "eventHandler", "Subscription", "#eventName", "#contextEventHandler", "#unsubscribe", "eventName", "contextEventHandler", "unsubscribe", "Subscribr", "#subscribers", "MultiMap", "eventName", "eventHandler", "context", "contextEventHandler", "ContextEventHandler", "Subscription", "#unsubscribe", "data", "handler", "contextEventHandlers", "removed"]
+  "sources": ["../../node_modules/@d1g1tal/collections/src/set-multi-map.js", "../../src/context-event-handler.js", "../../src/subscription.js", "../../src/subscribr.js"],
+  "sourcesContent": ["/**\n *\n * @typedef {Map<*, *>} SetMultiMap\n * @extends Map\n */\nexport default class SetMultiMap extends Map {\n\t/**\n\t * Adds a new element with a specified key and value to the SetMultiMap. If an element with the same key already exists, the value will be added to the underlying {@link Set}.\n\t *\n\t * @param {*} key The key to set.\n\t * @param {*} value The value to add to the SetMultiMap\n\t * @returns {SetMultiMap} The SetMultiMap with the updated key and value.\n\t */\n\tset(key, value) {\n\t\tsuper.set(key, (super.get(key) ?? new Set()).add(value));\n\n\t\treturn this;\n\t}\n\n\t[Symbol.toStringTag]() {\n\t\treturn 'SetMultiMap';\n\t}\n}", "export default class ContextEventHandler {\n\t#context;\n\t#eventHandler;\n\n\t/**\n\t * @param {*} context The context to bind to the event handler.\n\t * @param {function(*): void} eventHandler The event handler to call when the event is published.\n\t */\n\tconstructor(context, eventHandler) {\n\t\tthis.#context = context;\n\t\tthis.#eventHandler = eventHandler;\n\t}\n\n\t/**\n\t * Call the event handler for the provided event.\n\t *\n\t * @param {Event} event The event to handle\n\t * @param {*} [data] The value to be passed to the event handler as a parameter.\n\t */\n\thandle(event, data) {\n\t\tthis.#eventHandler.call(this.#context, event, data);\n\t}\n\n\tget [Symbol.toStringTag]() {\n\t\treturn 'ContextEventHandler';\n\t}\n}", "/** @typedef { import('./context-event-handler.js').default } ContextEventHandler */\n\nexport default class Subscription {\n\t#eventName;\n\t#contextEventHandler;\n\n\t/**\n\t * @param {string} eventName The event name.\n\t * @param {ContextEventHandler} contextEventHandler Then context event handler.\n\t */\n\tconstructor(eventName, contextEventHandler) {\n\t\tthis.#eventName = eventName;\n\t\tthis.#contextEventHandler = contextEventHandler;\n\t}\n\n\t/**\n\t * Gets the event name for the subscription.\n\t *\n\t * @returns {string} The event name.\n\t */\n\tget eventName() {\n\t\treturn this.#eventName;\n\t}\n\n\t/**\n\t * Gets the context event handler.\n\t *\n\t * @returns {ContextEventHandler} The context event handler\n\t */\n\tget contextEventHandler() {\n\t\treturn this.#contextEventHandler;\n\t}\n\n\tget [Symbol.toStringTag]() {\n\t\treturn 'Subscription';\n\t}\n}", "import SetMultiMap from '@d1g1tal/collections/set-multi-map.js';\nimport ContextEventHandler from './context-event-handler.js';\nimport Subscription from './subscription.js';\n\nexport default class Subscribr {\n\t/** @type {SetMultiMap<string, ContextEventHandler>} */\n\t#subscribers;\n\n\tconstructor() {\n\t\tthis.#subscribers = new SetMultiMap();\n\t}\n\n\t/**\n\t * Subscribe to an event\n\t *\n\t * @param {string} eventName The event name to subscribe to.\n\t * @param {function(Event, *): void} eventHandler The event handler to call when the event is published.\n\t * @param {*} [context] The context to bind to the event handler.\n\t * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.\n\t */\n\tsubscribe(eventName, eventHandler, context = eventHandler) {\n\t\tconst contextEventHandler = new ContextEventHandler(context, eventHandler);\n\t\tthis.#subscribers.set(eventName, contextEventHandler);\n\n\t\treturn new Subscription(eventName, contextEventHandler);\n\t}\n\n\t/**\n\t * Unsubscribe from the event\n\t *\n\t * @param {Subscription} subscription The subscription to unsubscribe.\n\t * @param {string} subscription.eventName The event name to subscribe to.\n\t * @param {ContextEventHandler} subscription.contextEventHandler The event handler to call when the event is published.\n\t * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.\n\t */\n\tunsubscribe({ eventName, contextEventHandler }) {\n\t\tconst contextEventHandlers = this.#subscribers.get(eventName);\n\t\tconst removed = contextEventHandlers?.delete(contextEventHandler);\n\n\t\tif (removed && contextEventHandlers.size == 0) {\n\t\t\tthis.#subscribers.delete(eventName);\n\t\t}\n\n\t\treturn removed;\n\t}\n\n\t/**\n\t * Publish an event\n\t *\n\t * @param {string} eventName The name of the event.\n\t * @param {Event} event The event to be handled.\n\t * @param {*} [data] The value to be passed to the event handler as a parameter.\n\t */\n\tpublish(eventName, event = new CustomEvent(eventName), data) {\n\t\tif (data == null && !(event instanceof Event)) {\n\t\t\t// Swap the event and data parameters because only data was passed without an event object\n\t\t\t[data, event] = [event, new CustomEvent(eventName)];\n\t\t}\n\t\tthis.#subscribers.get(eventName)?.forEach((contextEventHandler) => contextEventHandler.handle(event, data));\n\t}\n\n\t/**\n\t * Check if the event and handler are subscribed.\n\t *\n\t * @param {Subscription} subscription The subscription object.\n\t * @param {string} subscription.eventName The name of the event to check.\n\t * @param {ContextEventHandler} subscription.contextEventHandler The event handler to check.\n\t * @returns {boolean} true if the event name and handler are subscribed, false otherwise.\n\t */\n\tisSubscribed({ eventName, contextEventHandler }) {\n\t\treturn this.#subscribers.get(eventName)?.has(contextEventHandler);\n\t}\n\n\tget [Symbol.toStringTag]() {\n\t\treturn 'Subscribr';\n\t}\n}"],
+  "mappings": "AAKA,IAAqBA,EAArB,cAAyC,GAAI,CAQ5C,IAAIC,EAAKC,EAAO,CACf,aAAM,IAAID,GAAM,MAAM,IAAIA,CAAG,GAAK,IAAI,KAAO,IAAIC,CAAK,CAAC,EAEhD,IACR,CAEA,CAAC,OAAO,WAAW,GAAI,CACtB,MAAO,aACR,CACD,ECtBA,IAAqBC,EAArB,KAAyC,CACxCC,GACAC,GAMA,YAAYC,EAASC,EAAc,CAClC,KAAKH,GAAWE,EAChB,KAAKD,GAAgBE,CACtB,CAQA,OAAOC,EAAOC,EAAM,CACnB,KAAKJ,GAAc,KAAK,KAAKD,GAAUI,EAAOC,CAAI,CACnD,CAEA,IAAK,OAAO,WAAW,GAAI,CAC1B,MAAO,qBACR,CACD,ECxBA,IAAqBC,EAArB,KAAkC,CACjCC,GACAC,GAMA,YAAYC,EAAWC,EAAqB,CAC3C,KAAKH,GAAaE,EAClB,KAAKD,GAAuBE,CAC7B,CAOA,IAAI,WAAY,CACf,OAAO,KAAKH,EACb,CAOA,IAAI,qBAAsB,CACzB,OAAO,KAAKC,EACb,CAEA,IAAK,OAAO,WAAW,GAAI,CAC1B,MAAO,cACR,CACD,EChCA,IAAqBG,EAArB,KAA+B,CAE9BC,GAEA,aAAc,CACb,KAAKA,GAAe,IAAIC,CACzB,CAUA,UAAUC,EAAWC,EAAcC,EAAUD,EAAc,CAC1D,IAAME,EAAsB,IAAIC,EAAoBF,EAASD,CAAY,EACzE,YAAKH,GAAa,IAAIE,EAAWG,CAAmB,EAE7C,IAAIE,EAAaL,EAAWG,CAAmB,CACvD,CAUA,YAAY,CAAE,UAAAH,EAAW,oBAAAG,CAAoB,EAAG,CAC/C,IAAMG,EAAuB,KAAKR,GAAa,IAAIE,CAAS,EACtDO,EAAUD,GAAsB,OAAOH,CAAmB,EAEhE,OAAII,GAAWD,EAAqB,MAAQ,GAC3C,KAAKR,GAAa,OAAOE,CAAS,EAG5BO,CACR,CASA,QAAQP,EAAWQ,EAAQ,IAAI,YAAYR,CAAS,EAAGS,EAAM,CACxDA,GAAQ,MAAQ,EAAED,aAAiB,SAEtC,CAACC,EAAMD,CAAK,EAAI,CAACA,EAAO,IAAI,YAAYR,CAAS,CAAC,GAEnD,KAAKF,GAAa,IAAIE,CAAS,GAAG,QAASG,GAAwBA,EAAoB,OAAOK,EAAOC,CAAI,CAAC,CAC3G,CAUA,aAAa,CAAE,UAAAT,EAAW,oBAAAG,CAAoB,EAAG,CAChD,OAAO,KAAKL,GAAa,IAAIE,CAAS,GAAG,IAAIG,CAAmB,CACjE,CAEA,IAAK,OAAO,WAAW,GAAI,CAC1B,MAAO,WACR,CACD",
+  "names": ["SetMultiMap", "key", "value", "ContextEventHandler", "#context", "#eventHandler", "context", "eventHandler", "event", "data", "Subscription", "#eventName", "#contextEventHandler", "eventName", "contextEventHandler", "Subscribr", "#subscribers", "SetMultiMap", "eventName", "eventHandler", "context", "contextEventHandler", "ContextEventHandler", "Subscription", "contextEventHandlers", "removed", "event", "data"]
 }

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@d1g1tal/subscribr",
-  "version": "2.0.2",
+  "version": "3.0.1",
   "description": "JavaScript Publish/Subscribe Library",
   "type": "module",
+  "types": "index.d.js",
   "exports": {
     ".": {
       "import": "./src/subscribr.js",
       "default": "./dist/browser/subscribr.min.js"
     }
   },
-  "types": "index.d.js",
   "publishConfig": {
     "access": "public"
   },
@@ -24,6 +24,7 @@
     "build:esm": "rimraf dist/esm && esbuild src/subscribr.js --bundle --target=es2022 --format=esm --outfile=dist/esm/subscribr.js && esbuild src/subscribr.js --bundle --sourcemap --minify --target=es2022 --format=esm --outfile=dist/esm/subscribr.min.js",
     "build:browser": "rimraf dist/browser && esbuild src/subscribr.js --bundle --target=es2022 --platform=browser --global-name=Subscribr --footer:js='window.Subscribr = Subscribr.default;' --outfile=dist/browser/subscribr.js && esbuild src/subscribr.js --bundle --sourcemap --minify --target=es2022 --platform=browser --global-name=Subscribr --footer:js='window.Subscribr = Subscribr.default;' --outfile=dist/browser/subscribr.min.js",
     "lint": "eslint --ext .js --fix --ignore-path .gitignore .",
+    "d.ts": "tsc --allowJs -declaration --emitDeclarationOnly  --skipLibCheck --lib esnext index.js",
     "test": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js"
   },
   "repository": {
@@ -42,14 +43,14 @@
   },
   "homepage": "https://github.com/D1g1talEntr0py/subscribr#readme",
   "devDependencies": {
-    "@d1g1tal/chrysalis": "^1.1.7",
+    "@d1g1tal/chrysalis": "^1.2.3",
     "@skypack/package-check": "^0.2.2",
-    "esbuild": "^0.15.11",
-    "eslint": "^8.25.0",
-    "eslint-plugin-compat": "^4.0.2",
-    "eslint-plugin-jsdoc": "^39.3.6",
-    "jest": "^29.2.0",
-    "rimraf": "^3.0.2"
+    "esbuild": "^0.17.18",
+    "eslint": "^8.39.0",
+    "eslint-plugin-compat": "^4.1.4",
+    "eslint-plugin-jsdoc": "^43.1.1",
+    "jest": "^29.5.0",
+    "rimraf": "^5.0.0"
   },
   "jest": {
     "verbose": true,
@@ -64,9 +65,11 @@
     ]
   },
   "browserslist": [
-    "defaults"
+    "defaults",
+    "not ios_saf < 15",
+    "not op_mini all"
   ],
   "dependencies": {
-    "@d1g1tal/collections": "^0.0.3"
+    "@d1g1tal/collections": "^0.0.4"
   }
 }

package/src/context-event-handler.d.ts

@@ -1,12 +1,22 @@
-export default class ContextEventHandler {
-    /**
-     *
-     * @param {*} context The context to bind to the event handler.
-     * @param {function(*): void} eventHandler The event handler to call when the event is published.
-     */
-    constructor(context: any, eventHandler: (arg0: any) => void);
-    get context(): any;
-    get eventHandler(): (arg0: any) => void;
-    get [Symbol.toStringTag](): string;
-    #private;
-}
+export default class ContextEventHandler {
+    /**
+     * @param {*} context The context to bind to the event handler.
+     * @param {function(*): void} eventHandler The event handler to call when the event is published.
+     */
+    constructor(context: any, eventHandler: (arg0: any) => void);
+    /**
+     * Call the event handler for the provided event.
+     *
+     * @param {Event} event The event to handle
+     * @param {*} [data] The value to be passed to the event handler as a parameter.
+     */
+    handle(event: Event, data?: any): void;
+    /**
+     * Get the event handler
+     *
+     * @returns {function(*)} The event handler
+     */
+    get eventHandler(): (arg0: any) => any;
+    get [Symbol.toStringTag](): string;
+    #private;
+}

package/src/context-event-handler.js

@@ -3,7 +3,6 @@ export default class ContextEventHandler {
 	#eventHandler;
 
 	/**
-	 *
 	 * @param {*} context The context to bind to the event handler.
 	 * @param {function(*): void} eventHandler The event handler to call when the event is published.
 	 */
@@ -12,12 +11,14 @@ export default class ContextEventHandler {
 		this.#eventHandler = eventHandler;
 	}
 
-	get context() {
-		return this.#context;
-	}
-
-	get eventHandler() {
-		return this.#eventHandler;
+	/**
+	 * Call the event handler for the provided event.
+	 *
+	 * @param {Event} event The event to handle
+	 * @param {*} [data] The value to be passed to the event handler as a parameter.
+	 */
+	handle(event, data) {
+		this.#eventHandler.call(this.#context, event, data);
 	}
 
 	get [Symbol.toStringTag]() {

package/src/subscribr.d.ts

@@ -3,27 +3,37 @@ export default class Subscribr {
      * Subscribe to an event
      *
      * @param {string} eventName The event name to subscribe to.
-     * @param {function(*): void} eventHandler The event handler to call when the event is published.
+     * @param {function(Event, *): void} eventHandler The event handler to call when the event is published.
      * @param {*} [context] The context to bind to the event handler.
      * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.
      */
-    subscribe(eventName: string, eventHandler: (arg0: any) => void, context?: any): Subscription;
+    subscribe(eventName: string, eventHandler: (arg0: Event, arg1: any) => void, context?: any): Subscription;
+    /**
+     * Unsubscribe from the event
+     *
+     * @param {Subscription} subscription The subscription to unsubscribe.
+     * @param {string} subscription.eventName The event name to subscribe to.
+     * @param {ContextEventHandler} subscription.contextEventHandler The event handler to call when the event is published.
+     * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.
+     */
+    unsubscribe({ eventName, contextEventHandler }: Subscription): boolean;
     /**
      * Publish an event
      *
      * @param {string} eventName The name of the event.
+     * @param {Event} event The event to be handled.
      * @param {*} [data] The value to be passed to the event handler as a parameter.
      */
-    publish(eventName: string, data?: any): void;
+    publish(eventName: string, event?: Event, data?: any): void;
     /**
      * Check if the event and handler are subscribed.
      *
      * @param {Subscription} subscription The subscription object.
      * @param {string} subscription.eventName The name of the event to check.
-     * @param {function(*)} subscription.eventHandler The event handler to check.
+     * @param {ContextEventHandler} subscription.contextEventHandler The event handler to check.
      * @returns {boolean} true if the event name and handler are subscribed, false otherwise.
      */
-    isSubscribed({ eventName, eventHandler: handler }: Subscription): boolean;
+    isSubscribed({ eventName, contextEventHandler }: Subscription): boolean;
     get [Symbol.toStringTag](): string;
     #private;
 }

package/src/subscribr.js

@@ -1,4 +1,4 @@
-import { SetMultiMap } from '@d1g1tal/collections';
+import SetMultiMap from '@d1g1tal/collections/set-multi-map.js';
 import ContextEventHandler from './context-event-handler.js';
 import Subscription from './subscription.js';
 
@@ -14,25 +14,49 @@ export default class Subscribr {
 	 * Subscribe to an event
 	 *
 	 * @param {string} eventName The event name to subscribe to.
-	 * @param {function(*): void} eventHandler The event handler to call when the event is published.
+	 * @param {function(Event, *): void} eventHandler The event handler to call when the event is published.
 	 * @param {*} [context] The context to bind to the event handler.
 	 * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.
 	 */
-	subscribe(eventName, eventHandler, context) {
+	subscribe(eventName, eventHandler, context = eventHandler) {
 		const contextEventHandler = new ContextEventHandler(context, eventHandler);
 		this.#subscribers.set(eventName, contextEventHandler);
 
-		return new Subscription(eventName, contextEventHandler, () => this.#unsubscribe(eventName, contextEventHandler));
+		return new Subscription(eventName, contextEventHandler);
+	}
+
+	/**
+	 * Unsubscribe from the event
+	 *
+	 * @param {Subscription} subscription The subscription to unsubscribe.
+	 * @param {string} subscription.eventName The event name to subscribe to.
+	 * @param {ContextEventHandler} subscription.contextEventHandler The event handler to call when the event is published.
+	 * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.
+	 */
+	unsubscribe({ eventName, contextEventHandler }) {
+		const contextEventHandlers = this.#subscribers.get(eventName);
+		const removed = contextEventHandlers?.delete(contextEventHandler);
+
+		if (removed && contextEventHandlers.size == 0) {
+			this.#subscribers.delete(eventName);
+		}
+
+		return removed;
 	}
 
 	/**
 	 * Publish an event
 	 *
 	 * @param {string} eventName The name of the event.
+	 * @param {Event} event The event to be handled.
 	 * @param {*} [data] The value to be passed to the event handler as a parameter.
 	 */
-	publish(eventName, data) {
-		this.#subscribers.get(eventName)?.forEach(({context, eventHandler}) => eventHandler.call(context, data));
+	publish(eventName, event = new CustomEvent(eventName), data) {
+		if (data == null && !(event instanceof Event)) {
+			// Swap the event and data parameters because only data was passed without an event object
+			[data, event] = [event, new CustomEvent(eventName)];
+		}
+		this.#subscribers.get(eventName)?.forEach((contextEventHandler) => contextEventHandler.handle(event, data));
 	}
 
 	/**
@@ -40,32 +64,14 @@ export default class Subscribr {
 	 *
 	 * @param {Subscription} subscription The subscription object.
 	 * @param {string} subscription.eventName The name of the event to check.
-	 * @param {function(*)} subscription.eventHandler The event handler to check.
+	 * @param {ContextEventHandler} subscription.contextEventHandler The event handler to check.
 	 * @returns {boolean} true if the event name and handler are subscribed, false otherwise.
 	 */
-	isSubscribed({ eventName, eventHandler: handler}) {
-		return Array.from(this.#subscribers.get(eventName))?.some(({ eventHandler }) => eventHandler === handler);
+	isSubscribed({ eventName, contextEventHandler }) {
+		return this.#subscribers.get(eventName)?.has(contextEventHandler);
 	}
 
 	get [Symbol.toStringTag]() {
 		return 'Subscribr';
 	}
-
-	/**
-	 * Unsubscribe from the event
-	 *
-	 * @param {string} eventName The event name to subscribe to.
-	 * @param {ContextEventHandler} contextEventHandler The event handler to call when the event is published.
-	 * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.
-	 */
-	#unsubscribe(eventName, contextEventHandler) {
-		const contextEventHandlers = this.#subscribers.get(eventName);
-		const removed = contextEventHandlers?.delete(contextEventHandler);
-
-		if (removed && contextEventHandlers.size == 0) {
-			this.#subscribers.delete(eventName);
-		}
-
-		return removed;
-	}
 }

package/src/subscription.d.ts

@@ -1,11 +1,10 @@
+/** @typedef {import('./context-event-handler.js').default} ContextEventHandler */
 export default class Subscription {
     /**
-     *
-     * @param {string} eventName
-     * @param {import('./context-event-handler.js').default} contextEventHandler
-     * @param {function(string, function(*): void): boolean} unsubscribe
+     * @param {string} eventName The event name.
+     * @param {ContextEventHandler} contextEventHandler Then context event handler.
      */
-    constructor(eventName: string, contextEventHandler: import('./context-event-handler.js').default, unsubscribe: (arg0: string, arg1: (arg0: any) => void) => boolean);
+    constructor(eventName: string, contextEventHandler: ContextEventHandler);
     /**
      * Gets the event name for the subscription.
      *
@@ -13,22 +12,12 @@ export default class Subscription {
      */
     get eventName(): string;
     /**
-     * Gets the context which will be bound to the event handler when it is called.
-     *
-     * @returns {*} The event handler context.
-     */
-    get context(): any;
-    /**
-     * Gets the event handler for the subscription.
-     *
-     * @returns {function(*): void} The event handler.
-     */
-    get eventHandler(): (arg0: any) => void;
-    /**
-     * Unsubscribes from the event.
+     * Gets the context event handler.
      *
-     * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.
+     * @returns {ContextEventHandler} The context event handler
      */
-    unsubscribe(): boolean;
+    get contextEventHandler(): import("./context-event-handler.js").default;
+    get [Symbol.toStringTag](): string;
     #private;
 }
+export type ContextEventHandler = import('./context-event-handler.js').default;

package/src/subscription.js

@@ -1,18 +1,16 @@
+/** @typedef { import('./context-event-handler.js').default } ContextEventHandler */
+
 export default class Subscription {
 	#eventName;
 	#contextEventHandler;
-	#unsubscribe;
 
 	/**
-	 *
-	 * @param {string} eventName
-	 * @param {import('./context-event-handler.js').default} contextEventHandler
-	 * @param {function(string, function(*): void): boolean} unsubscribe
+	 * @param {string} eventName The event name.
+	 * @param {ContextEventHandler} contextEventHandler Then context event handler.
 	 */
-	constructor(eventName, contextEventHandler, unsubscribe) {
+	constructor(eventName, contextEventHandler) {
 		this.#eventName = eventName;
 		this.#contextEventHandler = contextEventHandler;
-		this.#unsubscribe = unsubscribe;
 	}
 
 	/**
@@ -25,29 +23,15 @@ export default class Subscription {
 	}
 
 	/**
-	 * Gets the context which will be bound to the event handler when it is called.
-	 *
-	 * @returns {*} The event handler context.
-	 */
-	get context() {
-		return this.#contextEventHandler.context;
-	}
-
-	/**
-	 * Gets the event handler for the subscription.
+	 * Gets the context event handler.
 	 *
-	 * @returns {function(*): void} The event handler.
+	 * @returns {ContextEventHandler} The context event handler
 	 */
-	get eventHandler() {
-		return this.#contextEventHandler.eventHandler;
+	get contextEventHandler() {
+		return this.#contextEventHandler;
 	}
 
-	/**
-	 * Unsubscribes from the event.
-	 *
-	 * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.
-	 */
-	unsubscribe() {
-		return this.#unsubscribe();
+	get [Symbol.toStringTag]() {
+		return 'Subscription';
 	}
 }