@bernierllc/event-emitter 1.4.0 → 1.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bernierllc/event-emitter",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Type-safe event bus for inter-package communication",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,7 +19,7 @@
   "author": "Bernier LLC",
   "license": "SEE LICENSE IN LICENSE",
   "dependencies": {
-    "@bernierllc/logger": "1.7.0"
+    "@bernierllc/logger": "2.0.0"
   },
   "devDependencies": {
     "@types/jest": "^29.5.0",

package/dist/errors.d.ts

@@ -1,16 +0,0 @@
-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

@@ -1,28 +0,0 @@
-"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.d.ts

@@ -1,39 +0,0 @@
-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

@@ -1,184 +0,0 @@
-"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;
-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();
-        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 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 = {
-            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

@@ -1,6 +0,0 @@
-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

@@ -1,17 +0,0 @@
-"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

@@ -1,5 +0,0 @@
-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

@@ -1,16 +0,0 @@
-"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 = 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/dist/types.d.ts

@@ -1,30 +0,0 @@
-/**
- * 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

@@ -1,9 +0,0 @@
-"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 });