@bernierllc/event-emitter 1.0.1

package/coverage/lcov.info

@@ -0,0 +1,149 @@
+TN:
+SF:src/event-emitter.ts
+FN:20,(anonymous_0)
+FN:42,(anonymous_1)
+FN:56,(anonymous_2)
+FN:78,(anonymous_3)
+FN:87,(anonymous_4)
+FN:112,(anonymous_5)
+FN:124,(anonymous_6)
+FN:153,(anonymous_7)
+FN:173,(anonymous_8)
+FN:183,(anonymous_9)
+FNF:10
+FNH:10
+FNDA:96,(anonymous_0)
+FNDA:212,(anonymous_1)
+FNDA:2,(anonymous_2)
+FNDA:9,(anonymous_3)
+FNDA:19,(anonymous_4)
+FNDA:56,(anonymous_5)
+FNDA:75,(anonymous_6)
+FNDA:6,(anonymous_7)
+FNDA:47,(anonymous_8)
+FNDA:3,(anonymous_9)
+DA:14,5
+DA:21,96
+DA:22,96
+DA:23,96
+DA:30,96
+DA:32,96
+DA:33,96
+DA:44,212
+DA:45,3
+DA:46,3
+DA:47,1
+DA:51,211
+DA:56,2
+DA:59,211
+DA:60,17
+DA:62,194
+DA:63,69
+DA:65,194
+DA:68,211
+DA:69,10
+DA:72,211
+DA:79,9
+DA:80,9
+DA:81,9
+DA:88,19
+DA:89,4
+DA:91,15
+DA:92,15
+DA:93,14
+DA:95,14
+DA:96,12
+DA:101,19
+DA:102,1
+DA:113,56
+DA:114,4
+DA:118,56
+DA:121,56
+DA:124,56
+DA:125,75
+DA:126,75
+DA:128,27
+DA:129,23
+DA:130,23
+DA:137,4
+DA:141,75
+DA:142,8
+DA:147,56
+DA:154,6
+DA:155,3
+DA:156,1
+DA:158,2
+DA:161,3
+DA:162,3
+DA:165,6
+DA:166,2
+DA:174,47
+DA:175,6
+DA:177,41
+DA:184,3
+DA:185,3
+DA:186,1
+DA:188,3
+LF:62
+LH:62
+BRDA:20,0,0,66
+BRDA:24,1,0,96
+BRDA:24,1,1,93
+BRDA:25,2,0,96
+BRDA:25,2,1,87
+BRDA:44,3,0,3
+BRDA:46,4,0,1
+BRDA:59,5,0,17
+BRDA:59,5,1,194
+BRDA:62,6,0,69
+BRDA:68,7,0,10
+BRDA:68,8,0,211
+BRDA:68,8,1,10
+BRDA:88,9,0,4
+BRDA:88,9,1,15
+BRDA:92,10,0,14
+BRDA:95,11,0,12
+BRDA:101,12,0,1
+BRDA:101,13,0,19
+BRDA:101,13,1,1
+BRDA:113,14,0,4
+BRDA:113,15,0,56
+BRDA:113,15,1,4
+BRDA:118,16,0,56
+BRDA:118,16,1,13
+BRDA:128,17,0,23
+BRDA:128,17,1,4
+BRDA:129,18,0,23
+BRDA:133,19,0,20
+BRDA:133,19,1,3
+BRDA:141,20,0,8
+BRDA:154,21,0,3
+BRDA:154,21,1,3
+BRDA:155,22,0,1
+BRDA:155,22,1,2
+BRDA:165,23,0,2
+BRDA:165,24,0,6
+BRDA:165,24,1,2
+BRDA:166,25,0,2
+BRDA:166,25,1,1
+BRDA:174,26,0,6
+BRDA:177,27,0,41
+BRDA:177,27,1,21
+BRDA:185,28,0,1
+BRF:44
+BRH:44
+end_of_record
+TN:
+SF:src/factory.ts
+FN:15,createEventEmitter
+FNF:1
+FNH:1
+FNDA:2,createEventEmitter
+DA:9,5
+DA:15,5
+DA:16,2
+LF:3
+LH:3
+BRF:0
+BRH:0
+end_of_record

package/dist/event-emitter.d.ts

@@ -0,0 +1,39 @@
+import { EventHandler, EventSubscription, EventEmitterOptions } from './types';
+/**
+ * Event bus for inter-package communication
+ */
+export declare class EventEmitter {
+    private listeners;
+    private wildcardListeners;
+    private options;
+    private logger?;
+    constructor(options?: EventEmitterOptions);
+    /**
+     * Subscribe to event
+     */
+    on<T = any>(eventType: string, handler: EventHandler<T>): EventSubscription;
+    /**
+     * Subscribe to event once
+     */
+    once<T = any>(eventType: string, handler: EventHandler<T>): EventSubscription;
+    /**
+     * Unsubscribe from event
+     */
+    off(subscription: EventSubscription): void;
+    /**
+     * Publish event
+     */
+    emit<T = any>(eventType: string, data: T): Promise<void>;
+    /**
+     * Remove all listeners for event type
+     */
+    removeAllListeners(eventType?: string): void;
+    /**
+     * Get listener count for event type
+     */
+    listenerCount(eventType: string): number;
+    /**
+     * Get all event types with listeners
+     */
+    eventNames(): string[];
+}

package/dist/event-emitter.js

@@ -0,0 +1,176 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventEmitter = void 0;
+/**
+ * Event bus for inter-package communication
+ */
+class EventEmitter {
+    constructor(options = {}) {
+        this.listeners = new Map();
+        this.wildcardListeners = new Set();
+        this.options = {
+            maxListeners: options.maxListeners || 0,
+            logEvents: options.logEvents || false,
+            captureErrors: options.captureErrors !== false // Default to true
+        };
+        // Try to load logger if available
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { createLogger } = require('@bernierllc/logger');
+            this.logger = createLogger({ level: 'debug' });
+        }
+        catch {
+            // Logger not available, continue without it
+        }
+    }
+    /**
+     * Subscribe to event
+     */
+    on(eventType, handler) {
+        // Check max listeners
+        if (this.options.maxListeners > 0) {
+            const currentCount = this.listenerCount(eventType);
+            if (currentCount >= this.options.maxListeners) {
+                throw new Error(`Max listeners (${this.options.maxListeners}) exceeded for event type: ${eventType}`);
+            }
+        }
+        const subscription = {
+            id: `${eventType}-${Date.now()}-${Math.random()}`,
+            eventType,
+            handler,
+            once: false,
+            unsubscribe: () => this.off(subscription)
+        };
+        if (eventType === '*') {
+            this.wildcardListeners.add(subscription);
+        }
+        else {
+            if (!this.listeners.has(eventType)) {
+                this.listeners.set(eventType, new Set());
+            }
+            this.listeners.get(eventType).add(subscription);
+        }
+        if (this.options.logEvents && this.logger) {
+            this.logger.debug('Event listener added', { eventType, subscriptionId: subscription.id });
+        }
+        return subscription;
+    }
+    /**
+     * Subscribe to event once
+     */
+    once(eventType, handler) {
+        const subscription = this.on(eventType, handler);
+        subscription.once = true;
+        return subscription;
+    }
+    /**
+     * Unsubscribe from event
+     */
+    off(subscription) {
+        if (subscription.eventType === '*') {
+            this.wildcardListeners.delete(subscription);
+        }
+        else {
+            const listeners = this.listeners.get(subscription.eventType);
+            if (listeners) {
+                listeners.delete(subscription);
+                // Clean up empty sets
+                if (listeners.size === 0) {
+                    this.listeners.delete(subscription.eventType);
+                }
+            }
+        }
+        if (this.options.logEvents && this.logger) {
+            this.logger.debug('Event listener removed', {
+                eventType: subscription.eventType,
+                subscriptionId: subscription.id
+            });
+        }
+    }
+    /**
+     * Publish event
+     */
+    async emit(eventType, data) {
+        if (this.options.logEvents && this.logger) {
+            this.logger.debug('Event emitted', { eventType, data });
+        }
+        // Get specific listeners
+        const specificListeners = this.listeners.get(eventType) || new Set();
+        // Combine with wildcard listeners
+        const allListeners = [...specificListeners, ...this.wildcardListeners];
+        // Execute handlers
+        const promises = allListeners.map(async (subscription) => {
+            try {
+                await subscription.handler(data);
+            }
+            catch (error) {
+                if (this.options.captureErrors) {
+                    if (this.logger) {
+                        this.logger.error('Event handler error', {
+                            eventType,
+                            subscriptionId: subscription.id,
+                            error: error instanceof Error ? error.message : String(error)
+                        });
+                    }
+                }
+                else {
+                    throw error;
+                }
+            }
+            finally {
+                // Remove if once subscription (always happens, even if error occurred)
+                if (subscription.once) {
+                    this.off(subscription);
+                }
+            }
+        });
+        await Promise.all(promises);
+    }
+    /**
+     * Remove all listeners for event type
+     */
+    removeAllListeners(eventType) {
+        if (eventType) {
+            if (eventType === '*') {
+                this.wildcardListeners.clear();
+            }
+            else {
+                this.listeners.delete(eventType);
+            }
+        }
+        else {
+            this.listeners.clear();
+            this.wildcardListeners.clear();
+        }
+        if (this.options.logEvents && this.logger) {
+            this.logger.debug('Listeners removed', { eventType: eventType || 'all' });
+        }
+    }
+    /**
+     * Get listener count for event type
+     */
+    listenerCount(eventType) {
+        if (eventType === '*') {
+            return this.wildcardListeners.size;
+        }
+        return this.listeners.get(eventType)?.size || 0;
+    }
+    /**
+     * Get all event types with listeners
+     */
+    eventNames() {
+        const names = Array.from(this.listeners.keys());
+        if (this.wildcardListeners.size > 0) {
+            names.push('*');
+        }
+        return names;
+    }
+}
+exports.EventEmitter = EventEmitter;

package/dist/factory.d.ts

@@ -0,0 +1,6 @@
+import { EventEmitter } from './event-emitter';
+import { EventEmitterOptions } from './types';
+/**
+ * Factory function for creating event emitters
+ */
+export declare function createEventEmitter(options?: EventEmitterOptions): EventEmitter;

package/dist/factory.js

@@ -0,0 +1,17 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEventEmitter = createEventEmitter;
+const event_emitter_1 = require("./event-emitter");
+/**
+ * Factory function for creating event emitters
+ */
+function createEventEmitter(options) {
+    return new event_emitter_1.EventEmitter(options);
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { EventEmitter } from './event-emitter';
+export { createEventEmitter } from './factory';
+export type { EventHandler, EventSubscription, EventEmitterOptions } from './types';

package/dist/index.js

@@ -0,0 +1,14 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEventEmitter = exports.EventEmitter = void 0;
+var event_emitter_1 = require("./event-emitter");
+Object.defineProperty(exports, "EventEmitter", { enumerable: true, get: function () { return event_emitter_1.EventEmitter; } });
+var factory_1 = require("./factory");
+Object.defineProperty(exports, "createEventEmitter", { enumerable: true, get: function () { return factory_1.createEventEmitter; } });

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Event handler function
+ */
+export type EventHandler<T = any> = (data: T) => void | Promise<void>;
+/**
+ * Event subscription
+ */
+export interface EventSubscription {
+    /** Unique subscription ID */
+    id: string;
+    /** Event type */
+    eventType: string;
+    /** Handler function */
+    handler: EventHandler;
+    /** Whether this is a one-time subscription */
+    once: boolean;
+    /** Unsubscribe function */
+    unsubscribe: () => void;
+}
+/**
+ * Event emitter options
+ */
+export interface EventEmitterOptions {
+    /** Maximum listeners per event (0 = unlimited) */
+    maxListeners?: number;
+    /** Whether to log events */
+    logEvents?: boolean;
+    /** Whether to capture errors */
+    captureErrors?: boolean;
+}

package/dist/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });

package/jest.config.cjs

@@ -0,0 +1,29 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/__tests__'],
+  testMatch: ['**/*.test.ts'],
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/index.ts'
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 90,
+      functions: 90,
+      lines: 90,
+      statements: 90
+    }
+  },
+  coverageDirectory: 'coverage',
+  verbose: true
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@bernierllc/event-emitter",
+  "version": "1.0.1",
+  "description": "Type-safe event bus for inter-package communication",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "event-emitter",
+    "event-bus",
+    "pubsub",
+    "messaging",
+    "events"
+  ],
+  "author": "Bernier LLC",
+  "license": "SEE LICENSE IN LICENSE",
+  "dependencies": {
+    "@bernierllc/logger": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.5.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.0"
+  },
+  "bernierllc": {
+    "integration": {
+      "logger": "integrated",
+      "docsIntegration": "ready",
+      "neverhub": "optional"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest --watch",
+    "test:run": "jest",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src __tests__ --ext .ts",
+    "clean": "rm -rf dist"
+  }
+}