@yukiakai/events-async 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Yuki Akai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,132 @@
+# @yukiakai/events-async
+
+[![NPM Version][npm-version-image]][npm-url]
+[![NPM Downloads][npm-downloads-image]][npm-downloads-url]
+
+[![Build Status][github-build-url]][github-url]
+[![codecov][codecov-image]][codecov-url]
+
+Drop-in replacement for Node.js `EventEmitter` with **async listener support**.  
+Supports **`emitAsync`** (parallel) and **`emitSeries`** (sequential) execution of listeners, and is fully type-safe in TypeScript.  
+Works with both **string** and **symbol** event names.
+
+---
+
+## Features
+
+- Fully TypeScript type-safe (`on`, `off`)
+- Async listeners supported
+- `emitAsync`: run all listeners in parallel
+- `emitSeries`: run listeners sequentially
+- Supports **string** and **symbol** keys for events
+- Compatible with Node.js `EventEmitter` API
+
+---
+
+## Installation
+
+```bash
+npm install @yukiakai/events-async
+# or
+yarn add @yukiakai/events-async
+````
+
+---
+
+## Usage
+
+```ts
+import { EventEmitterAsync } from '@yukiakai/events-async';
+
+const SYMBOL_EVENT = Symbol('symbolEvent');
+
+interface MyEvents {
+  hello: (name: string) => void | Promise<void>;
+  count: (n: number) => void | Promise<void>;
+  [SYMBOL_EVENT]: (msg: string) => void | Promise<void>;
+}
+
+const ee = new EventEmitterAsync<MyEvents>();
+
+// Type-safe listener
+ee.on('hello', async (name) => {
+  console.log('Hello', name);
+});
+
+ee.on(SYMBOL_EVENT, (msg) => {
+  console.log('Symbol event:', msg);
+});
+
+// Emit asynchronously (parallel)
+await ee.emitAsync('hello', 'world');
+await ee.emitAsync(SYMBOL_EVENT, 'ok');
+
+// Emit sequentially (in order)
+await ee.emitSeries('hello', 'world');
+```
+
+---
+
+## API
+
+See docs: [API Docs][api-docs-url]
+
+### `on(event, listener)`
+
+Register a listener with type safety.
+`event` can be `string` or `symbol`.
+
+### `off(event, listener)`
+
+Remove a listener (type-safe).
+
+### `emitAsync(event, ...args)`
+
+Run all listeners in parallel, await completion.
+
+### `emitSeries(event, ...args)`
+
+Run listeners **in order**, await completion.
+
+---
+
+### Notes
+
+* Supports both **sync** and **async** listeners.
+* `string | symbol` keys fully supported.
+
+---
+
+## Development
+
+```bash
+npm install
+npm run build
+npm run test
+npm run lint
+```
+
+---
+
+## Changelog
+
+See full release notes in [CHANGELOG.md][changelog-url]
+
+---
+
+## License
+
+MIT © [Yuki Akai](https://github.com/yukiakai212)
+
+---
+
+[npm-downloads-image]: https://badgen.net/npm/dm/@yukiakai/events-async
+[npm-downloads-url]: https://www.npmjs.com/package/@yukiakai/events-async
+[npm-url]: https://www.npmjs.com/package/@yukiakai/events-async
+[npm-version-image]: https://badgen.net/npm/v/@yukiakai/events-async
+[github-build-url]: https://github.com/yukiakai212/events-async/actions/workflows/build.yml/badge.svg
+[github-url]: https://github.com/yukiakai212/events-async/
+[codecov-image]: https://codecov.io/gh/yukiakai212/events-async/branch/main/graph/badge.svg
+[codecov-url]: https://codecov.io/gh/yukiakai212/events-async
+[changelog-url]: https://github.com/yukiakai212/events-async/blob/main/CHANGELOG.md
+[api-docs-url]: https://yukiakai212.github.io/events-async/

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var o=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var K=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var d=(t,s)=>{for(var e in s)o(t,e,{get:s[e],enumerable:!0})},l=(t,s,e,n)=>{if(s&&typeof s=="object"||typeof s=="function")for(let r of K(s))!y.call(t,r)&&r!==e&&o(t,r,{get:()=>s[r],enumerable:!(n=m(s,r))||n.enumerable});return t};var E=t=>l(o({},"__esModule",{value:!0}),t);var f={};d(f,{EventEmitterAsync:()=>i});module.exports=E(f);var a=require("events"),i=class extends a.EventEmitter{async emitAsync(s,...e){let n=this.listeners(s);await Promise.all(n.map(r=>r(...e)))}async emitSeries(s,...e){let n=this.listeners(s);for(let r of n)await r(...e)}on(s,e){return super.on(s,e)}addListener(s,e){return super.addListener(s,e)}off(s,e){return super.off(s,e)}removeListener(s,e){return super.removeListener(s,e)}};0&&(module.exports={EventEmitterAsync});

package/dist/index.d.cts

@@ -0,0 +1,12 @@
+import { EventEmitter } from 'node:events';
+
+declare class EventEmitterAsync<E extends Record<string | symbol, (...args: unknown[]) => unknown> = Record<string | symbol, (...args: any[]) => any>> extends EventEmitter {
+    emitAsync<K extends keyof E>(event: K, ...args: Parameters<E[K]>): Promise<void>;
+    emitSeries<K extends keyof E>(event: K, ...args: Parameters<E[K]>): Promise<void>;
+    on<K extends keyof E>(event: K, listener: E[K]): this;
+    addListener<K extends keyof E>(event: K, listener: E[K]): this;
+    off<K extends keyof E>(event: K, listener: E[K]): this;
+    removeListener<K extends keyof E>(event: K, listener: E[K]): this;
+}
+
+export { EventEmitterAsync };

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { EventEmitter } from 'node:events';
+
+declare class EventEmitterAsync<E extends Record<string | symbol, (...args: unknown[]) => unknown> = Record<string | symbol, (...args: any[]) => any>> extends EventEmitter {
+    emitAsync<K extends keyof E>(event: K, ...args: Parameters<E[K]>): Promise<void>;
+    emitSeries<K extends keyof E>(event: K, ...args: Parameters<E[K]>): Promise<void>;
+    on<K extends keyof E>(event: K, listener: E[K]): this;
+    addListener<K extends keyof E>(event: K, listener: E[K]): this;
+    off<K extends keyof E>(event: K, listener: E[K]): this;
+    removeListener<K extends keyof E>(event: K, listener: E[K]): this;
+}
+
+export { EventEmitterAsync };

package/dist/index.js

@@ -0,0 +1 @@
+import{EventEmitter as o}from"events";var n=class extends o{async emitAsync(s,...e){let r=this.listeners(s);await Promise.all(r.map(t=>t(...e)))}async emitSeries(s,...e){let r=this.listeners(s);for(let t of r)await t(...e)}on(s,e){return super.on(s,e)}addListener(s,e){return super.addListener(s,e)}off(s,e){return super.off(s,e)}removeListener(s,e){return super.removeListener(s,e)}};export{n as EventEmitterAsync};

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@yukiakai/events-async",
+  "version": "1.0.0",
+  "description": "Drop-in replacement for Node.js EventEmitter with async listener support (emitAsync).",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "types": "./dist/index.d.ts",
+    "import": "./dist/index.js",
+    "require": "./dist/index.cjs"
+  },
+  "scripts": {
+    "test": "npm run build && npx vitest run --reporter verbose --coverage",
+    "format": "prettier --write **/*.{js,ts}",
+    "format:check": "prettier --check **/*.{js,ts}",
+    "lint": "eslint src/**/*.ts",
+    "build": "npx tsup",
+    "docs": "npx typedoc"
+  },
+  "files": [
+    "dist/*",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "eventemitter",
+    "async",
+    "typescript",
+    "events",
+    "emit-async",
+    "emit-series",
+    "await"
+  ],
+  "author": "Yuki_akai",
+  "homepage": "https://github.com/yukiakai212/events-async",
+  "engines": {
+    "node": ">= 16"
+  },
+  "maintainers": [
+    {
+      "name": "Yuki_akai",
+      "homepage": "https://github.com/yukiakai212"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yukiakai212/events-async.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yukiakai212/events-async/issues"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@changesets/cli": "^2.29.5",
+    "@eslint/js": "^9.30.1",
+    "@types/node": "^24.0.10",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^9.30.0",
+    "prettier": "^3.6.2",
+    "tsup": "^8.5.0",
+    "tsx": "^4.20.3",
+    "typedoc": "^0.28.9",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.35.1",
+    "vitest": "^3.2.4"
+  }
+}