@ad-execute-manager/event 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 singcl
+
+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,351 @@
+# @ad-execute-manager/event
+
+A collection of event-related utilities for JavaScript applications including EventEmitter and PubSub implementations.
+
+## Installation
+
+```bash
+npm install @ad-execute-manager/event
+```
+
+## Features
+
+- **EventEmitter**: A powerful event emitter with support for once events, max listeners, and event queuing
+- **PubSub**: A simple publish-subscribe pattern implementation with automatic unsubscribe function
+- **Event Queuing**: Automatically queue events when no listeners are present
+- **Listener Limits**: Set maximum listeners per event to prevent memory leaks
+- **Once Events**: Support for events that only fire once
+- **Error Handling**: Built-in error handling for event listeners
+- **TypeScript Support**: Includes TypeScript type definitions
+- **Singleton Support**: EventEmitter includes static getInstance method for singleton pattern
+
+## Usage
+
+### EventEmitter
+
+```javascript
+import { EventEmitter } from '@ad-execute-manager/event';
+
+// Create an event emitter instance
+const emitter = new EventEmitter({
+  maxListeners: 10,
+  maxQueueSize: 5,
+  maxOnceEvents: 5
+});
+
+// Register event listener
+emitter.on('userLoggedIn', (userData) => {
+  console.log('User logged in:', userData);
+});
+
+// Register once event listener
+emitter.once('appStarted', (appData) => {
+  console.log('App started:', appData);
+  // This listener will be automatically removed after first execution
+});
+
+// Emit events
+emitter.emit('userLoggedIn', { id: 1, name: 'John' });
+emitter.emit('appStarted', { version: '1.0.0' });
+
+// Remove event listener
+function onDataReceived(data) {
+  console.log('Data received:', data);
+}
+
+emitter.on('dataReceived', onDataReceived);
+emitter.off('dataReceived', onDataReceived);
+
+// Remove all listeners for an event
+emitter.removeAllListeners('userLoggedIn');
+
+// Remove all listeners
+// emitter.removeAllListeners();
+
+// Using singleton pattern
+const singletonEmitter = EventEmitter.getInstance({
+  maxListeners: 15
+});
+```
+
+### PubSub
+
+```javascript
+import { PubSub } from '@ad-execute-manager/event';
+
+// Create a PubSub instance
+const pubsub = new PubSub();
+
+// Subscribe to an event
+const unsubscribe = pubsub.on('message', (data) => {
+  console.log('Message received:', data);
+});
+
+// Publish an event
+pubsub.emit('message', { text: 'Hello, world!' });
+
+// Unsubscribe using the returned function
+unsubscribe();
+
+// Subscribe to an event only once
+pubsub.once('notification', (notification) => {
+  console.log('Notification:', notification);
+  // This listener will be automatically removed after first execution
+});
+
+// Publish the notification event
+pubsub.emit('notification', { title: 'New Message', body: 'You have a new message' });
+
+// Check listener count
+const listenerCount = pubsub.listenerCount('message');
+console.log('Message listeners:', listenerCount);
+
+// Remove all listeners
+// pubsub.removeAllListeners();
+```
+
+## API
+
+### EventEmitter
+
+#### Constructor
+
+```javascript
+new EventEmitter(options)
+```
+
+- **options** (Object): Configuration options
+  - **maxListeners** (Number): Maximum listeners per event, default 5
+  - **maxQueueSize** (Number): Maximum queue size for events with no listeners, default 1
+  - **maxOnceEvents** (Number): Maximum once events per event, default 5
+
+#### Methods
+
+- **on(event, listener)**: Register an event listener
+  - **event** (String): Event name
+  - **listener** (Function): Event listener function
+
+- **once(event, listener)**: Register a one-time event listener
+  - **event** (String): Event name
+  - **listener** (Function): Event listener function
+
+- **emit(event, ...args)**: Emit an event
+  - **event** (String): Event name
+  - **...args** (Any): Arguments to pass to listeners
+
+- **off(event, listenerToRemove)**: Remove an event listener
+  - **event** (String): Event name
+  - **listenerToRemove** (Function): Listener function to remove
+
+- **removeAllListeners(event)**: Remove all listeners for an event
+  - **event** (String, optional): Event name, omit to remove all listeners
+
+- **static getInstance(args)**: Get singleton instance
+  - **args** (Object): Constructor options
+  - **returns** (EventEmitter): Singleton instance
+
+### PubSub
+
+#### Constructor
+
+```javascript
+new PubSub()
+```
+
+#### Methods
+
+- **on(eventName, callback)**: Subscribe to an event
+  - **eventName** (String): Event name
+  - **callback** (Function): Event callback function
+  - **returns** (Function): Unsubscribe function
+
+- **off(eventName, callback)**: Unsubscribe from an event
+  - **eventName** (String): Event name
+  - **callback** (Function): Callback function to remove
+
+- **emit(eventName, ...args)**: Publish an event
+  - **eventName** (String): Event name
+  - **...args** (Any): Arguments to pass to callbacks
+
+- **once(eventName, callback)**: Subscribe to an event once
+  - **eventName** (String): Event name
+  - **callback** (Function): Event callback function
+
+- **listenerCount(eventName)**: Get listener count for an event
+  - **eventName** (String): Event name
+  - **returns** (Number): Listener count
+
+- **removeAllListeners()**: Remove all listeners
+
+## Examples
+
+### Example 1: Application Event Bus
+
+```javascript
+import { EventEmitter } from '@ad-execute-manager/event';
+
+// Create global event bus
+const eventBus = EventEmitter.getInstance({
+  maxListeners: 20
+});
+
+// User service
+function loginUser(userData) {
+  // Login logic
+  console.log('Logging in user:', userData.username);
+  
+  // Emit login event
+  eventBus.emit('userLoggedIn', {
+    user: userData,
+    timestamp: new Date().toISOString()
+  });
+}
+
+// Notification service
+function setupNotifications() {
+  eventBus.on('userLoggedIn', (loginData) => {
+    console.log('Sending welcome notification to:', loginData.user.username);
+    // Send welcome notification
+  });
+  
+  eventBus.on('userLoggedOut', (logoutData) => {
+    console.log('Updating user status to offline:', logoutData.userId);
+    // Update user status
+  });
+}
+
+// Analytics service
+function setupAnalytics() {
+  eventBus.once('appStarted', (appData) => {
+    console.log('Recording app start event:', appData.version);
+    // Record app start analytics
+  });
+  
+  eventBus.on('userLoggedIn', (loginData) => {
+    console.log('Recording login event:', loginData.user.username);
+    // Record login analytics
+  });
+}
+
+// Setup services
+setupNotifications();
+setupAnalytics();
+
+// Start app
+eventBus.emit('appStarted', { version: '1.0.0' });
+
+// Login user
+loginUser({ id: 1, username: 'john_doe', email: 'john@example.com' });
+```
+
+### Example 2: Component Communication
+
+```javascript
+import { PubSub } from '@ad-execute-manager/event';
+
+// Create pubsub instance for component communication
+const componentBus = new PubSub();
+
+// Header component
+function Header() {
+  // Subscribe to user changes
+  const unsubscribe = componentBus.on('userChanged', (user) => {
+    console.log('Header: Updating user display:', user.name);
+    // Update header with user info
+  });
+  
+  // Subscribe to theme changes
+  componentBus.on('themeChanged', (theme) => {
+    console.log('Header: Updating theme:', theme);
+    // Update header theme
+  });
+  
+  // Cleanup function
+  return () => {
+    unsubscribe();
+    console.log('Header: Unsubscribed from events');
+  };
+}
+
+// User profile component
+function UserProfile() {
+  // Subscribe to user changes
+  const unsubscribe = componentBus.on('userChanged', (user) => {
+    console.log('UserProfile: Updating user profile:', user.name);
+    // Update user profile
+  });
+  
+  // Cleanup function
+  return () => {
+    unsubscribe();
+    console.log('UserProfile: Unsubscribed from events');
+  };
+}
+
+// Settings component
+function Settings() {
+  // Update user
+  function updateUser(userData) {
+    console.log('Settings: Updating user');
+    componentBus.emit('userChanged', userData);
+  }
+  
+  // Change theme
+  function changeTheme(theme) {
+    console.log('Settings: Changing theme to:', theme);
+    componentBus.emit('themeChanged', theme);
+  }
+  
+  return {
+    updateUser,
+    changeTheme
+  };
+}
+
+// Initialize components
+const cleanupHeader = Header();
+const cleanupUserProfile = UserProfile();
+const settings = Settings();
+
+// Simulate user update
+settings.updateUser({ id: 1, name: 'John Doe', email: 'john@example.com' });
+
+// Simulate theme change
+settings.changeTheme('dark');
+
+// Cleanup components
+// cleanupHeader();
+// cleanupUserProfile();
+```
+
+### Example 3: Event Queueing
+
+```javascript
+import { EventEmitter } from '@ad-execute-manager/event';
+
+// Create event emitter with queueing
+const emitter = new EventEmitter({
+  maxQueueSize: 10
+});
+
+// Emit events before listeners are registered
+console.log('Emitting events before listeners...');
+emitter.emit('data', { value: 1 });
+emitter.emit('data', { value: 2 });
+emitter.emit('data', { value: 3 });
+
+// Register listener - will receive queued events
+console.log('Registering listener...');
+emitter.on('data', (data) => {
+  console.log('Received data:', data);
+});
+
+// Emit more events
+console.log('Emitting more events...');
+emitter.emit('data', { value: 4 });
+emitter.emit('data', { value: 5 });
+```
+
+## License
+
+MIT

package/dist/EventEmitter.d.ts

@@ -0,0 +1,15 @@
+export class EventEmitter {
+    static geInstance(args: any): EventEmitter;
+    constructor(options?: {});
+    events: {};
+    queues: {};
+    onceEvents: {};
+    maxListeners: any;
+    maxQueueSize: any;
+    maxOnceEvents: any;
+    on(event: any, listener: any): void;
+    once(event: any, listener: any): void;
+    emit(event: any, ...args: any[]): void;
+    off(event: any, listenerToRemove: any): void;
+    removeAllListeners(event: any): void;
+}

package/dist/PubSub.d.ts

@@ -0,0 +1,9 @@
+export default class PubSub {
+    events: {};
+    on(eventName: any, callback: any): () => void;
+    off(eventName: any, callback: any): void;
+    emit(eventName: any, ...args: any[]): void;
+    once(eventName: any, callback: any): void;
+    listenerCount(eventName: any): any;
+    removeAllListeners(): void;
+}

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";const __rslib_import_meta_url__="u"<typeof document?new(require("url".replace("",""))).URL("file:"+__filename).href:document.currentScript&&document.currentScript.src||new URL("main.js",document.baseURI).href;var __webpack_require__={};__webpack_require__.d=(e,t)=>{for(var s in t)__webpack_require__.o(t,s)&&!__webpack_require__.o(e,s)&&Object.defineProperty(e,s,{enumerable:!0,get:t[s]})},__webpack_require__.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),__webpack_require__.r=e=>{"u">typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var __webpack_exports__={};__webpack_require__.r(__webpack_exports__),__webpack_require__.d(__webpack_exports__,{PubSub:()=>PubSub,EventEmitter:()=>EventEmitter});class EventEmitter{constructor(e={}){this.events={},this.queues={},this.onceEvents={},this.maxListeners=e.maxListeners||5,this.maxQueueSize=e.maxQueueSize||1,this.maxOnceEvents=e.maxOnceEvents||5}on(e,t){(this.events[e]||(this.events[e]=[]),this.events[e].length>=this.maxListeners)?console.warn(`EventEmitter: Maximum listeners (${this.maxListeners}) reached for event "${e}". Listener not added.`):(this.events[e].push(t),this.queues[e]&&this.queues[e].length>0&&(this.queues[e].forEach(e=>{t(...e)}),this.queues[e]=[]))}once(e,t){let s=(...n)=>{t(...n),this.off(e,s)};(this.onceEvents[e]||(this.onceEvents[e]=new Set),this.onceEvents[e].size>=this.maxOnceEvents)?console.warn(`EventEmitter: Maximum once events (${this.maxOnceEvents}) reached for event "${e}". Once listener not added.`):(this.onceEvents[e].add(s),this.on(e,s))}emit(e,...t){this.events[e]&&this.events[e].length>0?[...this.events[e]].forEach(e=>{e(...t)}):(this.queues[e]||(this.queues[e]=[]),this.queues[e].length>=this.maxQueueSize&&(console.warn(`EventEmitter: Maximum queue size (${this.maxQueueSize}) reached for event "${e}". Oldest event removed.`),this.queues[e].shift()),this.queues[e].push(t))}off(e,t){if(!t){this.events[e]=[],this.onceEvents[e]=new Set;return}this.events[e]=this.events[e].filter(e=>e!==t),this.onceEvents[e]&&this.onceEvents[e].delete(t)}removeAllListeners(e){e?(delete this.events[e],delete this.queues[e],delete this.onceEvents[e]):(this.events={},this.queues={},this.onceEvents={})}static geInstance(e){return this._instance||(this._instance=new EventEmitter(e)),this._instance}}class PubSub{constructor(){this.events={}}on(e,t){return this.events[e]||(this.events[e]=[]),this.events[e].push(t),()=>{this.off(e,t)}}off(e,t){if(this.events[e]){if(!t){this.events[e]=[];return}this.events[e]=this.events[e].filter(e=>e!==t)}}emit(e,...t){this.events[e]&&this.events[e].forEach(s=>{try{s(...t)}catch(t){console.error(`Error in event listener for ${e}:`,t)}})}once(e,t){let s=(...n)=>{t(...n),this.off(e,s)};this.on(e,s)}listenerCount(e){return this.events[e]?this.events[e].length:0}removeAllListeners(){this.events={}}}for(var __rspack_i in exports.EventEmitter=__webpack_exports__.EventEmitter,exports.PubSub=__webpack_exports__.PubSub,__webpack_exports__)-1===["EventEmitter","PubSub"].indexOf(__rspack_i)&&(exports[__rspack_i]=__webpack_exports__[__rspack_i]);Object.defineProperty(exports,"__esModule",{value:!0});

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { EventEmitter } from "./EventEmitter.js";
+export { default as PubSub } from "./PubSub.js";

package/dist/index.js

@@ -0,0 +1 @@
+class e{constructor(e={}){this.events={},this.queues={},this.onceEvents={},this.maxListeners=e.maxListeners||5,this.maxQueueSize=e.maxQueueSize||1,this.maxOnceEvents=e.maxOnceEvents||5}on(e,t){(this.events[e]||(this.events[e]=[]),this.events[e].length>=this.maxListeners)?console.warn(`EventEmitter: Maximum listeners (${this.maxListeners}) reached for event "${e}". Listener not added.`):(this.events[e].push(t),this.queues[e]&&this.queues[e].length>0&&(this.queues[e].forEach(e=>{t(...e)}),this.queues[e]=[]))}once(e,t){let s=(...n)=>{t(...n),this.off(e,s)};(this.onceEvents[e]||(this.onceEvents[e]=new Set),this.onceEvents[e].size>=this.maxOnceEvents)?console.warn(`EventEmitter: Maximum once events (${this.maxOnceEvents}) reached for event "${e}". Once listener not added.`):(this.onceEvents[e].add(s),this.on(e,s))}emit(e,...t){this.events[e]&&this.events[e].length>0?[...this.events[e]].forEach(e=>{e(...t)}):(this.queues[e]||(this.queues[e]=[]),this.queues[e].length>=this.maxQueueSize&&(console.warn(`EventEmitter: Maximum queue size (${this.maxQueueSize}) reached for event "${e}". Oldest event removed.`),this.queues[e].shift()),this.queues[e].push(t))}off(e,t){if(!t){this.events[e]=[],this.onceEvents[e]=new Set;return}this.events[e]=this.events[e].filter(e=>e!==t),this.onceEvents[e]&&this.onceEvents[e].delete(t)}removeAllListeners(e){e?(delete this.events[e],delete this.queues[e],delete this.onceEvents[e]):(this.events={},this.queues={},this.onceEvents={})}static geInstance(t){return this._instance||(this._instance=new e(t)),this._instance}}class t{constructor(){this.events={}}on(e,t){return this.events[e]||(this.events[e]=[]),this.events[e].push(t),()=>{this.off(e,t)}}off(e,t){if(this.events[e]){if(!t){this.events[e]=[];return}this.events[e]=this.events[e].filter(e=>e!==t)}}emit(e,...t){this.events[e]&&this.events[e].forEach(s=>{try{s(...t)}catch(t){console.error(`Error in event listener for ${e}:`,t)}})}once(e,t){let s=(...n)=>{t(...n),this.off(e,s)};this.on(e,s)}listenerCount(e){return this.events[e]?this.events[e].length:0}removeAllListeners(){this.events={}}}export{e as EventEmitter,t as PubSub};

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@ad-execute-manager/event",
+  "version": "2.0.1",
+  "description": "A collection of event-related utilities for JavaScript applications including EventEmitter and PubSub implementations.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "author": {
+    "name": "singcl",
+    "email": "iambabyer@gmail.com",
+    "url": "https://github.com/singcl"
+  },
+  "license": "MIT",
+  "homepage": "https://npmjs.com/package/@ad-execute-manager/event",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/singcl/ad-execute-manager.git",
+    "directory": "packages/evnet"
+  },
+  "bugs": {
+    "url": "https://github.com/singcl/ad-execute-manager/issues"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "keywords": [
+    "event-emitter",
+    "pubsub",
+    "events",
+    "event-bus",
+    "javascript",
+    "nodejs",
+    "typescript",
+    "event-queue",
+    "listener",
+    "singleton"
+  ],
+  "scripts": {
+    "build": "rslib build && tsc",
+    "dev": "rslib build --watch",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "test": "rstest",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@babel/eslint-parser": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
+    "@eslint/js": "^9.39.1",
+    "@rslib/core": "^0.18.5",
+    "@rstest/core": "^0.7.2",
+    "eslint": "^9.39.2",
+    "eslint-plugin-import": "^2.32.0",
+    "globals": "^16.5.0",
+    "prettier": "^3.7.3",
+    "typescript": "^5.9.3"
+  }
+}