chiisai-event-emitter 0.0.0-development → 1.0.1

package/README.md

@@ -1,6 +1,6 @@
 # Chiisai Event Emitter
 
-A minimal event emitter library for Node.JS.
+A minimal and performant event emitter library for Node.JS.
 
 ---
 
@@ -14,8 +14,6 @@ A minimal event emitter library for Node.JS.
 [![Commitizen Friendly][commitizen-img]][commitizen-url]
 [![Semantic Release][semantic-release-img]][semantic-release-url]
 
-> My awesome module
-
 ## Install
 
 ```bash
@@ -25,43 +23,28 @@ npm install chiisai-event-emitter
 ## Usage
 
 ```ts
-import { myPackage } from 'chiisai-event-emitter';
-
-myPackage('hello');
-//=> 'hello from my package'
-```
-
-## API
-
-### myPackage(input, options?)
-
-#### input
+import { EventEmitter } from 'chiisai-event-emitter';
 
-Type: `string`
+const eventEmitter = new EventEmitter();
 
-Lorem ipsum.
+eventEmitter.subscribe('test-event', () => console.log('test-event handler called!'));
+eventEmitter.subscribe('test-event', () => console.log('another test-event handler called!'))
 
-#### options
-
-Type: `object`
-
-##### postfix
-
-Type: `string`
-Default: `rainbows`
-
-Lorem ipsum.
+eventEmitter.emit('test-event')
+// test-event handler called!
+// another test-event handler called!
+```
 
-[build-img]:https://github.com/ryansonshine/chiisai-event-emitter/actions/workflows/release.yml/badge.svg
-[build-url]:https://github.com/ryansonshine/chiisai-event-emitter/actions/workflows/release.yml
+[build-img]:https://github.com/bencelaszlo/chiisai-event-emitter/actions/workflows/release.yml/badge.svg
+[build-url]:https://github.com/bencelaszlo/chiisai-event-emitter/actions/workflows/release.yml
 [downloads-img]:https://img.shields.io/npm/dt/chiisai-event-emitter
 [downloads-url]:https://www.npmtrends.com/chiisai-event-emitter
 [npm-img]:https://img.shields.io/npm/v/chiisai-event-emitter
 [npm-url]:https://www.npmjs.com/package/chiisai-event-emitter
-[issues-img]:https://img.shields.io/github/issues/ryansonshine/chiisai-event-emitter
-[issues-url]:https://github.com/ryansonshine/chiisai-event-emitter/issues
-[codecov-img]:https://codecov.io/gh/ryansonshine/chiisai-event-emitter/branch/main/graph/badge.svg
-[codecov-url]:https://codecov.io/gh/ryansonshine/chiisai-event-emitter
+[issues-img]:https://img.shields.io/github/issues/bencelaszlo/chiisai-event-emitter
+[issues-url]:https://github.com/bencelaszlo/chiisai-event-emitter/issues
+[codecov-img]:https://codecov.io/gh/bencelaszlo/chiisai-event-emitter/branch/main/graph/badge.svg
+[codecov-url]:https://codecov.io/gh/bencelaszlo/chiisai-event-emitter
 [semantic-release-img]:https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg
 [semantic-release-url]:https://github.com/semantic-release/semantic-release
 [commitizen-img]:https://img.shields.io/badge/commitizen-friendly-brightgreen.svg

package/lib/EventEmitter.d.ts

@@ -0,0 +1,23 @@
+export declare type EventCallback<T = void> = (...args: Array<any>) => T;
+export declare type Subscriptions = Map<string, Array<{
+    id: symbol;
+    callback: EventCallback;
+}>>;
+export declare type Unsubscribe = {
+    unsubscribe: () => void;
+};
+export declare class EventEmitter {
+    subscriptions: Subscriptions;
+    constructor();
+    /**
+     * @param {string} eventName
+     * @param {EventCallback} callback
+     * @return {Unsubscribe}
+     */
+    subscribe(eventName: string, callback: EventCallback): Unsubscribe;
+    /**
+     * @param {string} eventName
+     * @param {Array<any>} args
+     */
+    emit(eventName: string, ...args: Array<any>): void;
+}

package/lib/EventEmitter.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventEmitter = void 0;
+class EventEmitter {
+    constructor() {
+        this.subscriptions = new Map();
+    }
+    /**
+     * @param {string} eventName
+     * @param {EventCallback} callback
+     * @return {Unsubscribe}
+     */
+    subscribe(eventName, callback) {
+        const id = Symbol(callback.toString());
+        this.subscriptions.set(eventName, this.subscriptions.has(eventName)
+            ? [...(this.subscriptions.get(eventName) || []), { id, callback }]
+            : [{ id, callback }]);
+        return {
+            unsubscribe: () => this.subscriptions.set(eventName, (this.subscriptions.get(eventName) || []).filter(({ id: subscriptionId }) => subscriptionId !== id)),
+        };
+    }
+    /**
+     * @param {string} eventName
+     * @param {Array<any>} args
+     */
+    emit(eventName, ...args) {
+        (this.subscriptions.get(eventName) || []).forEach(({ callback }) => callback(...args));
+    }
+}
+exports.EventEmitter = EventEmitter;

package/lib/index.d.ts

@@ -0,0 +1 @@
+export * from './EventEmitter';

package/lib/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./EventEmitter"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chiisai-event-emitter",
-  "version": "0.0.0-development",
+  "version": "1.0.1",
   "description": "A minimal event emitter.",
   "main": "./lib/index.js",
   "files": [
@@ -115,4 +115,4 @@
       "@semantic-release/github"
     ]
   }
-}
+}