@bernierllc/event-emitter 1.0.8 → 1.2.0

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+export type EventEmitterErrorCode = 'EVENT_EMITTER_ERROR' | 'EVENT_MAX_LISTENERS_EXCEEDED';
+/**
+ * Error thrown by event-emitter when invariants are violated (e.g. exceeding
+ * the configured max-listeners ceiling). Uses ES2022 `Error.cause` so upstream
+ * failures from handler execution can be wrapped and inspected via
+ * `getErrorChain` from `@bernierllc/logger`.
+ */
+export declare class EventEmitterError extends Error {
+    readonly code: EventEmitterErrorCode | string;
+    readonly context: Record<string, unknown> | undefined;
+    constructor(message: string, options?: {
+        cause?: Error | undefined;
+        code?: EventEmitterErrorCode | string | undefined;
+        context?: Record<string, unknown> | undefined;
+    });
+}

package/dist/errors.js

@@ -0,0 +1,28 @@
+"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.EventEmitterError = void 0;
+/**
+ * Error thrown by event-emitter when invariants are violated (e.g. exceeding
+ * the configured max-listeners ceiling). Uses ES2022 `Error.cause` so upstream
+ * failures from handler execution can be wrapped and inspected via
+ * `getErrorChain` from `@bernierllc/logger`.
+ */
+class EventEmitterError extends Error {
+    code;
+    context;
+    constructor(message, options) {
+        super(message, options?.cause ? { cause: options.cause } : undefined);
+        this.name = 'EventEmitterError';
+        this.code = options?.code ?? 'EVENT_EMITTER_ERROR';
+        this.context = options?.context;
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+}
+exports.EventEmitterError = EventEmitterError;

package/dist/event-emitter.js

@@ -8,10 +8,15 @@ Redistribution or use in other products or commercial offerings is not permitted
 */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventEmitter = void 0;
+const errors_1 = require("./errors");
 /**
  * Event bus for inter-package communication
  */
 class EventEmitter {
+    listeners;
+    wildcardListeners;
+    options;
+    logger;
     constructor(options = {}) {
         this.listeners = new Map();
         this.wildcardListeners = new Set();
@@ -38,7 +43,10 @@ class EventEmitter {
         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}`);
+                throw new errors_1.EventEmitterError(`Max listeners (${this.options.maxListeners}) exceeded for event type: ${eventType}`, {
+                    code: 'EVENT_MAX_LISTENERS_EXCEEDED',
+                    context: { eventType, maxListeners: this.options.maxListeners, currentCount },
+                });
             }
         }
         const subscription = {

package/dist/index.d.ts

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

package/dist/index.js

@@ -7,8 +7,10 @@ The client may use and modify this code *only within the scope of the project it
 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;
+exports.EventEmitterError = 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; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "EventEmitterError", { enumerable: true, get: function () { return errors_1.EventEmitterError; } });

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@bernierllc/event-emitter",
-  "version": "1.0.8",
+  "version": "1.2.0",
   "description": "Type-safe event bus for inter-package communication",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "keywords": [
     "event-emitter",
     "event-bus",
@@ -14,7 +19,7 @@
   "author": "Bernier LLC",
   "license": "SEE LICENSE IN LICENSE",
   "dependencies": {
-    "@bernierllc/logger": "1.4.0"
+    "@bernierllc/logger": "1.4.3"
   },
   "devDependencies": {
     "@types/jest": "^29.5.0",

package/.eslintrc.js

@@ -1,29 +0,0 @@
-/*
-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 = {
-  parser: '@typescript-eslint/parser',
-  parserOptions: {
-    ecmaVersion: 2020,
-    sourceType: 'module'
-  },
-  extends: [
-    'eslint:recommended',
-    'plugin:@typescript-eslint/recommended'
-  ],
-  plugins: ['@typescript-eslint'],
-  env: {
-    node: true,
-    jest: true
-  },
-  rules: {
-    '@typescript-eslint/explicit-function-return-type': 'warn',
-    '@typescript-eslint/no-explicit-any': 'off',
-    '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }]
-  }
-};

package/CHANGELOG.md

@@ -1,73 +0,0 @@
-# Change Log
-
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-## [1.0.8](https://github.com/bernierllc/tools/compare/@bernierllc/event-emitter@1.0.7...@bernierllc/event-emitter@1.0.8) (2026-03-30)
-
-**Note:** Version bump only for package @bernierllc/event-emitter
-
-
-
-
-
-## [1.0.7](https://github.com/bernierllc/tools/compare/@bernierllc/event-emitter@1.0.6...@bernierllc/event-emitter@1.0.7) (2026-03-09)
-
-**Note:** Version bump only for package @bernierllc/event-emitter
-
-
-
-
-
-## [1.0.6](https://github.com/bernierllc/tools/compare/@bernierllc/event-emitter@1.0.5...@bernierllc/event-emitter@1.0.6) (2026-03-03)
-
-**Note:** Version bump only for package @bernierllc/event-emitter
-
-
-
-
-
-## 1.0.5 (2025-12-25)
-
-
-### Bug Fixes
-
-* **ci:** add lerna version step before publish ([3d20300](https://github.com/bernierllc/tools/commit/3d203002143bf353fffafe4f8a78a99009567347))
-* **ci:** correct jest testEnvironment paths for CI ([c47144c](https://github.com/bernierllc/tools/commit/c47144c3d78aec2be1e1454066c235c2227823fd))
-* **ci:** fix release workflow + convert internal deps to workspace:* ([01c078b](https://github.com/bernierllc/tools/commit/01c078b49d6025f7eef750f79207a1c71c8d85dc))
-* **jest:** resolve Node.js v25+ localStorage SecurityError ([8ffc512](https://github.com/bernierllc/tools/commit/8ffc512805519bc5ba523bdbcd1c457e84998c9e))
-* update neverhub-adapter deps to workspace:* and publish 0.1.2 ([f0e3d04](https://github.com/bernierllc/tools/commit/f0e3d04d8d4f094e3bb899ddf81e93243d16e2c2))
-
-
-
-
-
-## 1.0.4 (2025-12-25)
-
-
-### Bug Fixes
-
-* **ci:** correct jest testEnvironment paths for CI ([c47144c](https://github.com/bernierllc/tools/commit/c47144c3d78aec2be1e1454066c235c2227823fd))
-* **ci:** fix release workflow + convert internal deps to workspace:* ([01c078b](https://github.com/bernierllc/tools/commit/01c078b49d6025f7eef750f79207a1c71c8d85dc))
-* **jest:** resolve Node.js v25+ localStorage SecurityError ([8ffc512](https://github.com/bernierllc/tools/commit/8ffc512805519bc5ba523bdbcd1c457e84998c9e))
-* update neverhub-adapter deps to workspace:* and publish 0.1.2 ([f0e3d04](https://github.com/bernierllc/tools/commit/f0e3d04d8d4f094e3bb899ddf81e93243d16e2c2))
-
-
-
-
-
-# @bernierllc/event-emitter
-
-## 1.0.3
-
-### Patch Changes
-
-- Updated dependencies [[`73c1d1e`](https://github.com/bernierllc/tools/commit/73c1d1e46114cf2ccfd5b74b83743361247f4502)]:
-  - @bernierllc/logger@1.1.0
-
-## 1.0.2
-
-### Patch Changes
-
-- Updated dependencies [[`24899fa`](https://github.com/bernierllc/tools/commit/24899fa4eaf80ae329f7bd74483cf97a132f5d4c)]:
-  - @bernierllc/logger@1.0.4

package/__tests__/async-handlers.test.ts

@@ -1,260 +0,0 @@
-/*
-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.
-*/
-
-import { EventEmitter } from '../src';
-
-describe('EventEmitter - Async Handlers', () => {
-  let emitter: EventEmitter;
-
-  beforeEach(() => {
-    emitter = new EventEmitter();
-  });
-
-  describe('async handler support', () => {
-    it('should handle async handlers', async () => {
-      const results: string[] = [];
-
-      const asyncHandler = async (data: { message: string }) => {
-        await new Promise(resolve => setTimeout(resolve, 10));
-        results.push(data.message);
-      };
-
-      emitter.on('test', asyncHandler);
-      await emitter.emit('test', { message: 'hello' });
-
-      expect(results).toEqual(['hello']);
-    });
-
-    it('should wait for all async handlers to complete', async () => {
-      const results: number[] = [];
-
-      const handler1 = async () => {
-        await new Promise(resolve => setTimeout(resolve, 30));
-        results.push(1);
-      };
-
-      const handler2 = async () => {
-        await new Promise(resolve => setTimeout(resolve, 20));
-        results.push(2);
-      };
-
-      const handler3 = async () => {
-        await new Promise(resolve => setTimeout(resolve, 10));
-        results.push(3);
-      };
-
-      emitter.on('test', handler1);
-      emitter.on('test', handler2);
-      emitter.on('test', handler3);
-
-      await emitter.emit('test', {});
-
-      // All handlers should have completed
-      expect(results).toHaveLength(3);
-      expect(results).toContain(1);
-      expect(results).toContain(2);
-      expect(results).toContain(3);
-    });
-
-    it('should handle mix of sync and async handlers', async () => {
-      const results: string[] = [];
-
-      const syncHandler = (data: { type: string }) => {
-        results.push(`sync-${data.type}`);
-      };
-
-      const asyncHandler = async (data: { type: string }) => {
-        await new Promise(resolve => setTimeout(resolve, 10));
-        results.push(`async-${data.type}`);
-      };
-
-      emitter.on('test', syncHandler);
-      emitter.on('test', asyncHandler);
-
-      await emitter.emit('test', { type: 'mixed' });
-
-      expect(results).toHaveLength(2);
-      expect(results).toContain('sync-mixed');
-      expect(results).toContain('async-mixed');
-    });
-
-    it('should handle async once listeners', async () => {
-      const handler = jest.fn(async () => {
-        await new Promise(resolve => setTimeout(resolve, 10));
-      });
-
-      emitter.once('test', handler);
-
-      await emitter.emit('test', { data: 'first' });
-      await emitter.emit('test', { data: 'second' });
-
-      expect(handler).toHaveBeenCalledTimes(1);
-      expect(emitter.listenerCount('test')).toBe(0);
-    });
-
-    it('should handle async wildcard listeners', async () => {
-      const results: string[] = [];
-
-      const asyncWildcard = async (data: { event: string }) => {
-        await new Promise(resolve => setTimeout(resolve, 10));
-        results.push(data.event);
-      };
-
-      emitter.on('*', asyncWildcard);
-
-      await emitter.emit('event1', { event: 'one' });
-      await emitter.emit('event2', { event: 'two' });
-
-      expect(results).toEqual(['one', 'two']);
-    });
-  });
-
-  describe('async handler execution order', () => {
-    it('should execute async handlers in parallel', async () => {
-      const startTime = Date.now();
-      const delays = [50, 50, 50];
-      let completedCount = 0;
-
-      delays.forEach(delay => {
-        emitter.on('test', async () => {
-          await new Promise(resolve => setTimeout(resolve, delay));
-          completedCount++;
-        });
-      });
-
-      await emitter.emit('test', {});
-
-      const duration = Date.now() - startTime;
-
-      // If executed in parallel, total time should be ~50ms (the max delay)
-      // If executed sequentially, total time would be ~150ms
-      expect(duration).toBeLessThan(100); // Allow some buffer
-      expect(completedCount).toBe(3);
-    });
-
-    it('should handle async handlers that resolve at different times', async () => {
-      const order: number[] = [];
-
-      emitter.on('test', async () => {
-        await new Promise(resolve => setTimeout(resolve, 30));
-        order.push(1);
-      });
-
-      emitter.on('test', async () => {
-        await new Promise(resolve => setTimeout(resolve, 10));
-        order.push(2);
-      });
-
-      emitter.on('test', async () => {
-        await new Promise(resolve => setTimeout(resolve, 20));
-        order.push(3);
-      });
-
-      await emitter.emit('test', {});
-
-      // Handlers complete in order of their delays, not registration order
-      expect(order).toEqual([2, 3, 1]);
-    });
-  });
-
-  describe('async handler data flow', () => {
-    it('should pass data to async handlers correctly', async () => {
-      const receivedData: any[] = [];
-
-      const handler = async (data: any) => {
-        await new Promise(resolve => setTimeout(resolve, 10));
-        receivedData.push(data);
-      };
-
-      emitter.on('test', handler);
-
-      const testData = { id: 123, message: 'test', nested: { value: true } };
-      await emitter.emit('test', testData);
-
-      expect(receivedData).toHaveLength(1);
-      expect(receivedData[0]).toEqual(testData);
-    });
-
-    it('should handle async handlers with complex data types', async () => {
-      interface ComplexData {
-        users: Array<{ id: number; name: string }>;
-        metadata: Record<string, any>;
-        timestamp: Date;
-      }
-
-      let receivedData: ComplexData | null = null;
-
-      const handler = async (data: ComplexData) => {
-        await new Promise(resolve => setTimeout(resolve, 10));
-        receivedData = data;
-      };
-
-      emitter.on('test', handler);
-
-      const complexData: ComplexData = {
-        users: [
-          { id: 1, name: 'Alice' },
-          { id: 2, name: 'Bob' }
-        ],
-        metadata: { source: 'api', version: 2 },
-        timestamp: new Date()
-      };
-
-      await emitter.emit('test', complexData);
-
-      expect(receivedData).toEqual(complexData);
-    });
-  });
-
-  describe('async handler cleanup', () => {
-    it('should handle unsubscribe during async handler execution', async () => {
-      let handlerStarted = false;
-      let handlerCompleted = false;
-
-      const handler = async () => {
-        handlerStarted = true;
-        await new Promise(resolve => setTimeout(resolve, 50));
-        handlerCompleted = true;
-      };
-
-      const subscription = emitter.on('test', handler);
-
-      // Start emission
-      const emitPromise = emitter.emit('test', {});
-
-      // Unsubscribe immediately (while handler is still running)
-      await new Promise(resolve => setTimeout(resolve, 10));
-      subscription.unsubscribe();
-
-      // Wait for emission to complete
-      await emitPromise;
-
-      // Handler should have started and completed despite unsubscribe
-      expect(handlerStarted).toBe(true);
-      expect(handlerCompleted).toBe(true);
-
-      // But listener should be removed for future events
-      expect(emitter.listenerCount('test')).toBe(0);
-    });
-
-    it('should handle async once listeners cleanup', async () => {
-      const handler = jest.fn(async () => {
-        await new Promise(resolve => setTimeout(resolve, 10));
-      });
-
-      emitter.once('test', handler);
-
-      expect(emitter.listenerCount('test')).toBe(1);
-
-      await emitter.emit('test', {});
-
-      expect(emitter.listenerCount('test')).toBe(0);
-      expect(handler).toHaveBeenCalledTimes(1);
-    });
-  });
-});