@xylabs/events 5.0.84 → 5.0.87

package/dist/neutral/index.mjs

@@ -43,8 +43,8 @@ var Events = class _Events extends Base {
     if (typeof globalThis.process?.env !== "object") {
       return _Events.isGlobalDebugEnabled;
     }
-    const { env } = globalThis.process;
-    return env.DEBUG === "events" || env.DEBUG === "*" || _Events.isGlobalDebugEnabled;
+    const env = globalThis.process?.env;
+    return env?.DEBUG === "events" || env?.DEBUG === "*" || _Events.isGlobalDebugEnabled;
   }
   static set isDebugEnabled(newValue) {
     this.isGlobalDebugEnabled = newValue;

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/BaseEmitter.ts","../../src/Events/Events.ts"],"sourcesContent":["import type { BaseParams } from '@xylabs/base'\nimport { Base } from '@xylabs/base'\nimport type { EmptyObject } from '@xylabs/object'\n\nimport { Events } from './Events/index.ts'\nimport type {\n  EventAnyListener, EventData, EventEmitter,\n  EventListener,\n} from './model/index.ts'\n\n/** Fields specific to BaseEmitter configuration parameters. */\nexport interface BaseEmitterParamsFields {}\n\n/** Parameters type for configuring a BaseEmitter instance. */\nexport type BaseEmitterParams<T extends EmptyObject = EmptyObject> = BaseParams<T & BaseEmitterParamsFields & T>\n\n/**\n * Base class that combines the Base utility class with typed event emission capabilities.\n * Delegates all event operations to an internal Events instance.\n */\nexport class BaseEmitter<TParams extends BaseParams = BaseParams, TEventData extends EventData = EventData>\n  extends Base<TParams> implements EventEmitter<TEventData> {\n  // just here to query types\n  eventData = {} as TEventData\n\n  private events: Events<TEventData>\n\n  constructor(params: BaseParams<TParams>) {\n    super(params)\n    this.events = new Events<TEventData>()\n  }\n\n  /**\n   * Removes all listeners for the specified event name(s).\n   * @param eventNames - One or more event names to clear listeners for.\n   * @returns This instance for chaining.\n   */\n  clearListeners(eventNames: keyof TEventData | (keyof TEventData)[]) {\n    this.events.clearListeners(eventNames)\n    return this\n  }\n\n  /**\n   * Emits an event, invoking all registered listeners concurrently.\n   * @param eventName - The event to emit.\n   * @param eventArgs - The data to pass to listeners.\n   */\n  emit<TEventName extends keyof TEventData = keyof TEventData, TEventArgs extends TEventData[TEventName] = TEventData[TEventName]>(\n    eventName: TEventName,\n    eventArgs: TEventArgs,\n  ) {\n    return this.events.emit(eventName, eventArgs)\n  }\n\n  /**\n   * Emits an event, invoking all registered listeners sequentially in order.\n   * @param eventName - The event to emit.\n   * @param eventArgs - The data to pass to listeners.\n   */\n  emitSerial<TEventName extends keyof TEventData = keyof TEventData, TEventArgs extends TEventData[TEventName] = TEventData[TEventName]>(\n    eventName: TEventName,\n    eventArgs: TEventArgs,\n  ) {\n    return this.events.emitSerial(eventName, eventArgs)\n  }\n\n  /**\n   * Returns the total number of listeners registered for the specified event name(s).\n   * @param eventNames - One or more event names to count listeners for.\n   * @returns The total listener count.\n   */\n  listenerCount(eventNames: keyof TEventData | (keyof TEventData)[]) {\n    return this.events.listenerCount(eventNames)\n  }\n\n  /**\n   * Removes a specific listener from the specified event name(s).\n   * @param eventNames - One or more event names to unsubscribe from.\n   * @param listener - The listener to remove.\n   */\n  off<TEventName extends keyof TEventData>(eventNames: TEventName | TEventName[], listener: EventListener<TEventData[TEventName]>) {\n    return this.events.off(eventNames, listener)\n  }\n\n  /**\n   * Removes a wildcard listener that was receiving all events.\n   * @param listener - The wildcard listener to remove.\n   */\n  offAny(listener: EventAnyListener) {\n    return this.events.offAny(listener)\n  }\n\n  /**\n   * Subscribes a listener to the specified event name(s).\n   * @param eventNames - One or more event names to listen for.\n   * @param listener - The callback to invoke when the event fires.\n   * @returns An unsubscribe function.\n   */\n  on<TEventName extends keyof TEventData>(eventNames: TEventName | TEventName[], listener: EventListener<TEventData[TEventName]>) {\n    return this.events.on(eventNames, listener)\n  }\n\n  /**\n   * Subscribes a wildcard listener that receives all events.\n   * @param listener - The callback to invoke for any event.\n   * @returns An unsubscribe function.\n   */\n  onAny(listener: EventAnyListener) {\n    return this.events.onAny(listener)\n  }\n\n  /**\n   * Subscribes a listener that will be invoked only once for the specified event, then automatically removed.\n   * @param eventName - The event to listen for.\n   * @param listener - The callback to invoke once.\n   * @returns An unsubscribe function.\n   */\n  once<TEventName extends keyof TEventData>(eventName: TEventName, listener: EventListener<TEventData[TEventName]>) {\n    return this.events.once(eventName, listener)\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport type { BaseParams } from '@xylabs/base'\nimport { Base } from '@xylabs/base'\nimport { handleError } from '@xylabs/error'\nimport { forget } from '@xylabs/forget'\nimport { isDefined } from '@xylabs/typeof'\n\nimport type {\n  EventAnyListener, EventArgs, EventData, EventEmitter, EventListener, EventName,\n} from '../model/index.ts'\n\n/**\nEmittery can collect and log debug information.\n\nTo enable this feature set the `DEBUG` environment variable to `emittery` or `*`. Additionally, you can set the static `isDebugEnabled` variable to true\non the Emittery class, or `myEmitter.debug.enabled` on an instance of it for debugging a single instance.\n\nSee API for more information on how debugging works.\n*/\nexport type DebugLogger = (type: string, debugName: string, eventName?: EventName, eventData?: EventArgs) => void\n\n/** Information about a registered event listener, including an optional filter for selective invocation. */\nexport type EventListenerInfo<TEventArgs extends EventArgs = EventArgs> = {\n  filter?: TEventArgs\n  listener: EventListener<TEventArgs>\n}\n\nconst NO_META_EVENT_ERROR_MESSAGE = '`eventName` cannot be meta event `listenerAdded` or `listenerRemoved`'\n\n/**\nConfigure debug options of an instance.\n*/\n/* v8 ignore next 5 */\nexport type DebugOptions = {\n  enabled?: boolean\n  logger?: DebugLogger\n  readonly name: string\n}\n\nconst resolvedPromise = Promise.resolve()\n\n/** Data shape for internal meta events that fire when listeners are added or removed. */\nexport type MetaEventData<TEventData extends EventData> = {\n  listenerAdded: {\n    eventName?: keyof TEventData\n    listener: EventListener<TEventData[keyof TEventData]> | EventAnyListener<TEventData[keyof TEventData]>\n  }\n  listenerRemoved: {\n    eventName?: keyof TEventData\n    listener: EventListener<TEventData[keyof TEventData]> | EventAnyListener<TEventData[keyof TEventData]>\n  }\n}\n\nconst isMetaEvent = (eventName: EventName) => eventName === 'listenerAdded' || eventName === 'listenerRemoved'\n\n/** Parameters for constructing an Events instance, with optional debug configuration. */\nexport type EventsParams = BaseParams<{ readonly debug?: DebugOptions }>\n\n/**\n * Core typed event emitter implementation supporting named events, wildcard listeners,\n * serial and concurrent emission, listener filtering, and debug logging.\n */\nexport class Events<TEventData extends EventData = EventData> extends Base<EventsParams> implements EventEmitter<TEventData> {\n  protected static anyMap = new WeakMap<object, Set<EventAnyListener>>()\n  protected static eventsMap = new WeakMap<object, Map<EventName, Set<EventListenerInfo>>>()\n\n  private static isGlobalDebugEnabled = false\n\n  // this is here to be able to query the type, not use\n  eventData = {} as TEventData\n\n  private _canEmitMetaEvents = false\n\n  constructor(params: EventsParams = {}) {\n    const mutatedParams = { ...params }\n    if (mutatedParams.debug) {\n      mutatedParams.debug.logger\n        = mutatedParams.debug.logger\n          ?? ((type: string, debugName: string, eventName?: EventName, eventData?: EventArgs) => {\n            let eventDataString: string\n            try {\n              eventDataString = JSON.stringify(eventData)\n            } catch {\n              eventDataString = `Object with the following keys failed to stringify: ${Object.keys(eventData ?? {}).join(',')}`\n            }\n\n            const eventNameString = typeof eventName === 'symbol' || typeof eventName === 'number' ? eventName.toString() : eventName\n\n            const currentTime = new Date()\n            const logTime = `${currentTime.getHours()}:${currentTime.getMinutes()}:${currentTime.getSeconds()}.${currentTime.getMilliseconds()}`\n            this.logger?.log(`[${logTime}][events:${type}][${debugName}] Event Name: ${eventNameString}\\n\\tdata: ${eventDataString}`)\n          })\n    }\n    super(mutatedParams)\n    Events.anyMap.set(this, new Set<EventAnyListener>())\n    Events.eventsMap.set(this, new Map<keyof TEventData, Set<EventListenerInfo>>())\n  }\n\n  /** Whether debug mode is enabled globally or via the DEBUG environment variable. */\n  static get isDebugEnabled() {\n    // In a browser environment, `globalThis.process` can potentially reference a DOM Element with a `#process` ID,\n    // so instead of just type checking `globalThis.process`, we need to make sure that `globalThis.process.env` exists.\n\n    if (typeof globalThis.process?.env !== 'object') {\n      return Events.isGlobalDebugEnabled\n    }\n\n    const { env } = globalThis.process\n    return env.DEBUG === 'events' || env.DEBUG === '*' || Events.isGlobalDebugEnabled\n  }\n\n  static set isDebugEnabled(newValue) {\n    this.isGlobalDebugEnabled = newValue\n  }\n\n  /** The debug configuration for this instance, if provided. */\n  get debug() {\n    return this.params.debug\n  }\n\n  /**\n   * Removes all listeners for the specified event name(s).\n   * @param eventNames - One or more event names to clear listeners for.\n   */\n  clearListeners(eventNames: keyof TEventData | (keyof TEventData)[]) {\n    const eventNamesArray = Array.isArray(eventNames) ? eventNames : [eventNames]\n\n    for (const eventName of eventNamesArray) {\n      this.logIfDebugEnabled('clear', eventName)\n\n      if (typeof eventName === 'string' || typeof eventName === 'symbol' || typeof eventName === 'number') {\n        const set = this.getListeners(eventName)\n        if (set) {\n          set.clear()\n        }\n      } else {\n        Events.anyMap.get(this)?.clear()\n\n        for (const [eventName, listeners] of assertEx(Events.eventsMap.get(this)).entries()) {\n          listeners.clear()\n          Events.eventsMap.get(this)?.delete(eventName)\n        }\n      }\n    }\n  }\n\n  /**\n   * Emits an event, invoking all registered listeners concurrently.\n   * @param eventName - The event to emit.\n   * @param eventArgs - The data to pass to listeners.\n   */\n  async emit<TEventName extends keyof TEventData>(eventName: TEventName, eventArgs: TEventData[TEventName]) {\n    return await this.emitInternal(eventName, eventArgs)\n  }\n\n  /**\n   * Emits an internal meta event (listenerAdded or listenerRemoved).\n   * @param eventName - The meta event name.\n   * @param eventArgs - The meta event data containing listener and event information.\n   * @returns True if the meta event was emitted successfully.\n   */\n  async emitMetaEvent<TEventName extends keyof MetaEventData<TEventData>>(eventName: TEventName, eventArgs: MetaEventData<TEventData>[TEventName]) {\n    if (isMetaEvent(eventName)) {\n      try {\n        this._canEmitMetaEvents = true\n        await this.emitMetaEventInternal(eventName, eventArgs)\n        return true\n      } finally {\n        this._canEmitMetaEvents = false\n        return false\n      }\n    }\n  }\n\n  /**\n   * Emits an event, invoking all registered listeners sequentially in order.\n   * @param eventName - The event to emit.\n   * @param eventArgs - The data to pass to listeners.\n   */\n  async emitSerial<TEventName extends keyof TEventData>(eventName: TEventName, eventArgs: TEventData[TEventName]) {\n    if (isMetaEvent(eventName) && !this._canEmitMetaEvents) {\n      throw new TypeError(NO_META_EVENT_ERROR_MESSAGE)\n    }\n\n    const filterMatch = (args: TEventData[TEventName], filter: TEventData[TEventName]) => {\n      switch (typeof filter) {\n        case 'object': {\n          // eslint-disable-next-line unicorn/no-array-reduce\n          return Object.entries(args).reduce((prev, [key, value]) => ((filter as Record<PropertyKey, unknown>)[key] === value ? true : prev), false)\n        }\n        default: {\n          return args === filter\n        }\n      }\n    }\n\n    this.logIfDebugEnabled('emitSerial', eventName, eventArgs)\n\n    const listeners = this.getListeners(eventName) ?? new Set()\n    const filteredListeners = [...listeners.values()]\n      .filter(value => (isDefined(value.filter) ? filterMatch(eventArgs, value.filter as TEventData[TEventName]) : true))\n      .map(info => info.listener)\n    const anyListeners = assertEx(Events.anyMap.get(this))\n    const staticListeners = [...filteredListeners]\n    const staticAnyListeners = [...anyListeners]\n\n    await resolvedPromise\n\n    for (const listener of staticListeners) {\n      await this.safeCallListener(eventName, eventArgs, listener)\n    }\n\n    for (const listener of staticAnyListeners) {\n      await this.safeCallAnyListener(eventName, eventArgs, listener)\n    }\n  }\n\n  /**\n   * Returns the total number of listeners registered for the specified event name(s).\n   * @param eventNames - One or more event names to count listeners for.\n   * @returns The total listener count.\n   */\n  // TODO: Make test for this\n  listenerCount(eventNames?: keyof TEventData | (keyof TEventData)[]) {\n    const eventNamesArray = Array.isArray(eventNames) ? eventNames : [eventNames]\n    let count = 0\n\n    for (const eventName of eventNamesArray) {\n      if (typeof eventName === 'string') {\n        count += assertEx(Events.anyMap.get(this)).size + (this.getListeners(eventName)?.size ?? 0)\n\n        continue\n      }\n\n      count += assertEx(Events.anyMap.get(this)).size\n\n      for (const value of assertEx(Events.eventsMap.get(this)).values()) {\n        count += value.size\n      }\n    }\n\n    return count\n  }\n\n  /**\n   * Logs debug information if debug mode is enabled.\n   * @param type - The type of operation being logged.\n   * @param eventName - The event name, if applicable.\n   * @param eventArgs - The event data, if applicable.\n   */\n  logIfDebugEnabled<TEventName extends EventName>(type: string, eventName?: TEventName, eventArgs?: EventArgs) {\n    if (Events.isDebugEnabled || this.debug?.enabled) {\n      this.debug?.logger?.(type, this.debug.name, eventName, eventArgs)\n    }\n  }\n\n  /**\n   * Removes a specific listener from the specified event name(s).\n   * @param eventNames - One or more event names to unsubscribe from.\n   * @param listener - The listener to remove.\n   */\n  off<TEventName extends keyof TEventData, TEventListener = EventListener<TEventData[TEventName]>>(\n    eventNames: TEventName | TEventName[],\n    listener: TEventListener,\n  ) {\n    const eventNamesArray = Array.isArray(eventNames) ? eventNames : [eventNames]\n    for (const eventName of eventNamesArray) {\n      const set = this.getListeners(eventName) as Set<TEventListener> | undefined\n      if (set) {\n        set.delete(listener)\n        if (set.size === 0) {\n          const events = Events.eventsMap.get(this)\n          events?.delete(eventName)\n        }\n      }\n\n      this.logIfDebugEnabled('unsubscribe', eventName)\n\n      /* v8 ignore next 3 -- meta events don't reach this path via public API */\n      if (!isMetaEvent(eventName)) {\n        forget(this.emitMetaEvent('listenerRemoved', { eventName, listener: listener as EventListener }))\n      }\n    }\n  }\n\n  /**\n   * Removes a wildcard listener that was receiving all events.\n   * @param listener - The wildcard listener to remove.\n   */\n  offAny(listener: EventAnyListener) {\n    this.logIfDebugEnabled('unsubscribeAny')\n\n    const typedMap = Events.anyMap.get(this) as Set<EventAnyListener<TEventData[keyof TEventData]>>\n    typedMap?.delete(listener)\n    forget(this.emitMetaEvent('listenerRemoved', { listener: listener as EventAnyListener }))\n  }\n\n  /**\n   * Subscribes a listener to the specified event name(s).\n   * @param eventNames - One or more event names to listen for.\n   * @param listener - The callback to invoke when the event fires.\n   * @param filter - Optional filter to selectively invoke the listener based on event data.\n   * @returns An unsubscribe function.\n   */\n  on<TEventName extends keyof TEventData = keyof TEventData>(\n    eventNames: TEventName | TEventName[],\n    listener: EventListener<TEventData[TEventName]>,\n    filter?: TEventData[TEventName],\n  ) {\n    const eventNamesArray = Array.isArray(eventNames) ? eventNames : [eventNames]\n    for (const eventName of eventNamesArray) {\n      let set = this.getListeners(eventName)\n      if (!set) {\n        set = new Set()\n        const events = Events.eventsMap.get(this)\n        events?.set(eventName, set)\n      }\n\n      set.add({ filter, listener: listener as EventListener })\n\n      this.logIfDebugEnabled('subscribe', eventName)\n\n      if (!isMetaEvent(eventName)) {\n        forget(this.emitMetaEvent('listenerAdded', { eventName, listener: listener as EventListener }))\n      }\n    }\n\n    return this.off.bind(this, eventNames, listener as EventListener)\n  }\n\n  /**\n   * Subscribes a wildcard listener that receives all events.\n   * @param listener - The callback to invoke for any event.\n   * @returns An unsubscribe function.\n   */\n  onAny(listener: EventAnyListener) {\n    this.logIfDebugEnabled('subscribeAny')\n\n    Events.anyMap.get(this)?.add(listener as EventAnyListener)\n    forget(this.emitMetaEvent('listenerAdded', { listener: listener as EventAnyListener }))\n    return this.offAny.bind(this, listener as EventAnyListener)\n  }\n\n  /**\n   * Subscribes a listener that will be invoked only once for the specified event, then automatically removed.\n   * @param eventName - The event to listen for.\n   * @param listener - The callback to invoke once.\n   * @returns An unsubscribe function.\n   */\n  once<TEventName extends keyof TEventData>(eventName: TEventName, listener: EventListener<TEventData[TEventName]>) {\n    const subListener = async (args: TEventData[TEventName]) => {\n      this.off(eventName, subListener)\n      await this.safeCallListener(eventName, args, listener)\n    }\n    this.on(eventName, subListener)\n    return this.off.bind(this, eventName, subListener as EventListener)\n  }\n\n  private async emitInternal<TEventName extends keyof TEventData, TEventArgs extends TEventData[TEventName]>(\n    eventName: TEventName,\n    eventArgs: TEventArgs,\n    filter?: TEventArgs,\n  ) {\n    if (isMetaEvent(eventName) && !this._canEmitMetaEvents) {\n      throw new TypeError(NO_META_EVENT_ERROR_MESSAGE)\n    }\n\n    this.logIfDebugEnabled('emit', eventName, eventArgs)\n\n    const listeners = this.getListeners(eventName) ?? new Set()\n    /* v8 ignore start -- filter parameter is reserved for future use; anyListeners.has is a race condition guard */\n    const filteredListeners = [...listeners.values()].filter(value => (isDefined(filter) ? isDefined(value.listener) : true)).map(info => info.listener)\n    const anyListeners = assertEx(Events.anyMap.get(this))\n    const staticListeners = [...filteredListeners]\n    const staticAnyListeners = isMetaEvent(eventName) ? [] : [...anyListeners]\n\n    await resolvedPromise\n    await Promise.all([\n      ...staticListeners.map(async (listener) => {\n        await this.safeCallListener(eventName, eventArgs, listener)\n      }),\n      ...staticAnyListeners.map(async (listener) => {\n        if (anyListeners.has(listener)) {\n          await this.safeCallAnyListener(eventName, eventArgs, listener)\n        }\n      }),\n    ])\n    /* v8 ignore stop */\n  }\n\n  private async emitMetaEventInternal<TEventName extends keyof MetaEventData<TEventData>>(\n    eventName: TEventName,\n    eventArgs: MetaEventData<TEventData>[TEventName],\n  ) {\n    if (isMetaEvent(eventName) && !this._canEmitMetaEvents) {\n      throw new TypeError('`eventName` cannot be meta event `listenerAdded` or `listenerRemoved`')\n    }\n\n    this.logIfDebugEnabled('emit', eventName, eventArgs)\n\n    const listeners = this.getListeners(eventName) ?? new Set()\n    const filteredListeners = [...listeners.values()].map(info => info.listener)\n    const anyListeners = assertEx(Events.anyMap.get(this))\n    const staticListeners = [...filteredListeners]\n    const staticAnyListeners = isMetaEvent(eventName) ? [] : [...anyListeners]\n\n    await resolvedPromise\n    await Promise.all([\n      ...staticListeners.map(async (listener) => {\n        await this.safeCallListener(eventName, eventArgs, listener)\n      }),\n      /* v8 ignore start -- race condition guard */\n      ...staticAnyListeners.map(async (listener) => {\n        if (anyListeners.has(listener)) {\n          await this.safeCallAnyListener(eventName, eventArgs, listener)\n        }\n      }),\n      /* v8 ignore stop */\n    ])\n    return true\n  }\n\n  private getListeners<TEventName extends keyof TEventData>(eventName: TEventName) {\n    const events = assertEx(Events.eventsMap.get(this))\n    if (!events.has(eventName)) {\n      return\n    }\n\n    return events.get(eventName)\n  }\n\n  private async safeCallAnyListener<TEventData extends EventData, TEventName extends keyof EventData>(\n    eventName: TEventName,\n    eventArgs: TEventData[TEventName],\n    listener: EventAnyListener<TEventData[TEventName]>,\n  ) {\n    try {\n      return await listener(eventName, eventArgs)\n    } catch (ex) {\n      handleError(ex, (error) => {\n        this.logger?.error(`Listener[${String(eventName)}] Excepted: ${error.message}`)\n      })\n    }\n  }\n\n  private async safeCallListener<TEventData extends EventData, TEventName extends keyof EventData>(\n    eventName: TEventName,\n    eventArgs: TEventData[TEventName],\n    listener: EventListener<TEventData[TEventName]>,\n  ) {\n    try {\n      return await listener(eventArgs)\n    } catch (ex) {\n      handleError(ex, (error) => {\n        this.logger?.error(`Listener[${String(eventName)}] Excepted: ${error.message}`)\n      })\n    }\n  }\n}\n"],"mappings":"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","names":["Base","eventName","Base"]}
+{"version":3,"sources":["../../src/BaseEmitter.ts","../../src/Events/Events.ts"],"sourcesContent":["import type { BaseParams } from '@xylabs/base'\nimport { Base } from '@xylabs/base'\nimport type { EmptyObject } from '@xylabs/object'\n\nimport { Events } from './Events/index.ts'\nimport type {\n  EventAnyListener, EventData, EventEmitter,\n  EventListener,\n} from './model/index.ts'\n\n/** Fields specific to BaseEmitter configuration parameters. */\nexport interface BaseEmitterParamsFields {}\n\n/** Parameters type for configuring a BaseEmitter instance. */\nexport type BaseEmitterParams<T extends EmptyObject = EmptyObject> = BaseParams<T & BaseEmitterParamsFields & T>\n\n/**\n * Base class that combines the Base utility class with typed event emission capabilities.\n * Delegates all event operations to an internal Events instance.\n */\nexport class BaseEmitter<TParams extends BaseParams = BaseParams, TEventData extends EventData = EventData>\n  extends Base<TParams> implements EventEmitter<TEventData> {\n  // just here to query types\n  eventData = {} as TEventData\n\n  private events: Events<TEventData>\n\n  constructor(params: BaseParams<TParams>) {\n    super(params)\n    this.events = new Events<TEventData>()\n  }\n\n  /**\n   * Removes all listeners for the specified event name(s).\n   * @param eventNames - One or more event names to clear listeners for.\n   * @returns This instance for chaining.\n   */\n  clearListeners(eventNames: keyof TEventData | (keyof TEventData)[]) {\n    this.events.clearListeners(eventNames)\n    return this\n  }\n\n  /**\n   * Emits an event, invoking all registered listeners concurrently.\n   * @param eventName - The event to emit.\n   * @param eventArgs - The data to pass to listeners.\n   */\n  emit<TEventName extends keyof TEventData = keyof TEventData, TEventArgs extends TEventData[TEventName] = TEventData[TEventName]>(\n    eventName: TEventName,\n    eventArgs: TEventArgs,\n  ) {\n    return this.events.emit(eventName, eventArgs)\n  }\n\n  /**\n   * Emits an event, invoking all registered listeners sequentially in order.\n   * @param eventName - The event to emit.\n   * @param eventArgs - The data to pass to listeners.\n   */\n  emitSerial<TEventName extends keyof TEventData = keyof TEventData, TEventArgs extends TEventData[TEventName] = TEventData[TEventName]>(\n    eventName: TEventName,\n    eventArgs: TEventArgs,\n  ) {\n    return this.events.emitSerial(eventName, eventArgs)\n  }\n\n  /**\n   * Returns the total number of listeners registered for the specified event name(s).\n   * @param eventNames - One or more event names to count listeners for.\n   * @returns The total listener count.\n   */\n  listenerCount(eventNames: keyof TEventData | (keyof TEventData)[]) {\n    return this.events.listenerCount(eventNames)\n  }\n\n  /**\n   * Removes a specific listener from the specified event name(s).\n   * @param eventNames - One or more event names to unsubscribe from.\n   * @param listener - The listener to remove.\n   */\n  off<TEventName extends keyof TEventData>(eventNames: TEventName | TEventName[], listener: EventListener<TEventData[TEventName]>) {\n    return this.events.off(eventNames, listener)\n  }\n\n  /**\n   * Removes a wildcard listener that was receiving all events.\n   * @param listener - The wildcard listener to remove.\n   */\n  offAny(listener: EventAnyListener) {\n    return this.events.offAny(listener)\n  }\n\n  /**\n   * Subscribes a listener to the specified event name(s).\n   * @param eventNames - One or more event names to listen for.\n   * @param listener - The callback to invoke when the event fires.\n   * @returns An unsubscribe function.\n   */\n  on<TEventName extends keyof TEventData>(eventNames: TEventName | TEventName[], listener: EventListener<TEventData[TEventName]>) {\n    return this.events.on(eventNames, listener)\n  }\n\n  /**\n   * Subscribes a wildcard listener that receives all events.\n   * @param listener - The callback to invoke for any event.\n   * @returns An unsubscribe function.\n   */\n  onAny(listener: EventAnyListener) {\n    return this.events.onAny(listener)\n  }\n\n  /**\n   * Subscribes a listener that will be invoked only once for the specified event, then automatically removed.\n   * @param eventName - The event to listen for.\n   * @param listener - The callback to invoke once.\n   * @returns An unsubscribe function.\n   */\n  once<TEventName extends keyof TEventData>(eventName: TEventName, listener: EventListener<TEventData[TEventName]>) {\n    return this.events.once(eventName, listener)\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport type { BaseParams } from '@xylabs/base'\nimport { Base } from '@xylabs/base'\nimport { handleError } from '@xylabs/error'\nimport { forget } from '@xylabs/forget'\nimport { isDefined } from '@xylabs/typeof'\n\nimport type {\n  EventAnyListener, EventArgs, EventData, EventEmitter, EventListener, EventName,\n} from '../model/index.ts'\n\n/**\nEmittery can collect and log debug information.\n\nTo enable this feature set the `DEBUG` environment variable to `emittery` or `*`. Additionally, you can set the static `isDebugEnabled` variable to true\non the Emittery class, or `myEmitter.debug.enabled` on an instance of it for debugging a single instance.\n\nSee API for more information on how debugging works.\n*/\nexport type DebugLogger = (type: string, debugName: string, eventName?: EventName, eventData?: EventArgs) => void\n\n/** Information about a registered event listener, including an optional filter for selective invocation. */\nexport type EventListenerInfo<TEventArgs extends EventArgs = EventArgs> = {\n  filter?: TEventArgs\n  listener: EventListener<TEventArgs>\n}\n\nconst NO_META_EVENT_ERROR_MESSAGE = '`eventName` cannot be meta event `listenerAdded` or `listenerRemoved`'\n\n/**\nConfigure debug options of an instance.\n*/\n/* v8 ignore next 5 */\nexport type DebugOptions = {\n  enabled?: boolean\n  logger?: DebugLogger\n  readonly name: string\n}\n\nconst resolvedPromise = Promise.resolve()\n\n/** Data shape for internal meta events that fire when listeners are added or removed. */\nexport type MetaEventData<TEventData extends EventData> = {\n  listenerAdded: {\n    eventName?: keyof TEventData\n    listener: EventListener<TEventData[keyof TEventData]> | EventAnyListener<TEventData[keyof TEventData]>\n  }\n  listenerRemoved: {\n    eventName?: keyof TEventData\n    listener: EventListener<TEventData[keyof TEventData]> | EventAnyListener<TEventData[keyof TEventData]>\n  }\n}\n\nconst isMetaEvent = (eventName: EventName) => eventName === 'listenerAdded' || eventName === 'listenerRemoved'\n\n/** Parameters for constructing an Events instance, with optional debug configuration. */\nexport type EventsParams = BaseParams<{ readonly debug?: DebugOptions }>\n\n/**\n * Core typed event emitter implementation supporting named events, wildcard listeners,\n * serial and concurrent emission, listener filtering, and debug logging.\n */\nexport class Events<TEventData extends EventData = EventData> extends Base<EventsParams> implements EventEmitter<TEventData> {\n  protected static anyMap = new WeakMap<object, Set<EventAnyListener>>()\n  protected static eventsMap = new WeakMap<object, Map<EventName, Set<EventListenerInfo>>>()\n\n  private static isGlobalDebugEnabled = false\n\n  // this is here to be able to query the type, not use\n  eventData = {} as TEventData\n\n  private _canEmitMetaEvents = false\n\n  constructor(params: EventsParams = {}) {\n    const mutatedParams = { ...params }\n    if (mutatedParams.debug) {\n      mutatedParams.debug.logger\n        = mutatedParams.debug.logger\n          ?? ((type: string, debugName: string, eventName?: EventName, eventData?: EventArgs) => {\n            let eventDataString: string\n            try {\n              eventDataString = JSON.stringify(eventData)\n            } catch {\n              eventDataString = `Object with the following keys failed to stringify: ${Object.keys(eventData ?? {}).join(',')}`\n            }\n\n            const eventNameString = typeof eventName === 'symbol' || typeof eventName === 'number' ? eventName.toString() : eventName\n\n            const currentTime = new Date()\n            const logTime = `${currentTime.getHours()}:${currentTime.getMinutes()}:${currentTime.getSeconds()}.${currentTime.getMilliseconds()}`\n            this.logger?.log(`[${logTime}][events:${type}][${debugName}] Event Name: ${eventNameString}\\n\\tdata: ${eventDataString}`)\n          })\n    }\n    super(mutatedParams)\n    Events.anyMap.set(this, new Set<EventAnyListener>())\n    Events.eventsMap.set(this, new Map<keyof TEventData, Set<EventListenerInfo>>())\n  }\n\n  /** Whether debug mode is enabled globally or via the DEBUG environment variable. */\n  static get isDebugEnabled() {\n    // In a browser environment, `globalThis.process` can potentially reference a DOM Element with a `#process` ID,\n    // so instead of just type checking `globalThis.process`, we need to make sure that `globalThis.process.env` exists.\n\n    if (typeof globalThis.process?.env !== 'object') {\n      return Events.isGlobalDebugEnabled\n    }\n\n    const env = globalThis.process?.env\n    return env?.DEBUG === 'events' || env?.DEBUG === '*' || Events.isGlobalDebugEnabled\n  }\n\n  static set isDebugEnabled(newValue) {\n    this.isGlobalDebugEnabled = newValue\n  }\n\n  /** The debug configuration for this instance, if provided. */\n  get debug() {\n    return this.params.debug\n  }\n\n  /**\n   * Removes all listeners for the specified event name(s).\n   * @param eventNames - One or more event names to clear listeners for.\n   */\n  clearListeners(eventNames: keyof TEventData | (keyof TEventData)[]) {\n    const eventNamesArray = Array.isArray(eventNames) ? eventNames : [eventNames]\n\n    for (const eventName of eventNamesArray) {\n      this.logIfDebugEnabled('clear', eventName)\n\n      if (typeof eventName === 'string' || typeof eventName === 'symbol' || typeof eventName === 'number') {\n        const set = this.getListeners(eventName)\n        if (set) {\n          set.clear()\n        }\n      } else {\n        Events.anyMap.get(this)?.clear()\n\n        for (const [eventName, listeners] of assertEx(Events.eventsMap.get(this)).entries()) {\n          listeners.clear()\n          Events.eventsMap.get(this)?.delete(eventName)\n        }\n      }\n    }\n  }\n\n  /**\n   * Emits an event, invoking all registered listeners concurrently.\n   * @param eventName - The event to emit.\n   * @param eventArgs - The data to pass to listeners.\n   */\n  async emit<TEventName extends keyof TEventData>(eventName: TEventName, eventArgs: TEventData[TEventName]) {\n    return await this.emitInternal(eventName, eventArgs)\n  }\n\n  /**\n   * Emits an internal meta event (listenerAdded or listenerRemoved).\n   * @param eventName - The meta event name.\n   * @param eventArgs - The meta event data containing listener and event information.\n   * @returns True if the meta event was emitted successfully.\n   */\n  async emitMetaEvent<TEventName extends keyof MetaEventData<TEventData>>(eventName: TEventName, eventArgs: MetaEventData<TEventData>[TEventName]) {\n    if (isMetaEvent(eventName)) {\n      try {\n        this._canEmitMetaEvents = true\n        await this.emitMetaEventInternal(eventName, eventArgs)\n        return true\n      } finally {\n        this._canEmitMetaEvents = false\n        return false\n      }\n    }\n  }\n\n  /**\n   * Emits an event, invoking all registered listeners sequentially in order.\n   * @param eventName - The event to emit.\n   * @param eventArgs - The data to pass to listeners.\n   */\n  async emitSerial<TEventName extends keyof TEventData>(eventName: TEventName, eventArgs: TEventData[TEventName]) {\n    if (isMetaEvent(eventName) && !this._canEmitMetaEvents) {\n      throw new TypeError(NO_META_EVENT_ERROR_MESSAGE)\n    }\n\n    const filterMatch = (args: TEventData[TEventName], filter: TEventData[TEventName]) => {\n      switch (typeof filter) {\n        case 'object': {\n          // eslint-disable-next-line unicorn/no-array-reduce\n          return Object.entries(args).reduce((prev, [key, value]) => ((filter as Record<PropertyKey, unknown>)[key] === value ? true : prev), false)\n        }\n        default: {\n          return args === filter\n        }\n      }\n    }\n\n    this.logIfDebugEnabled('emitSerial', eventName, eventArgs)\n\n    const listeners = this.getListeners(eventName) ?? new Set()\n    const filteredListeners = [...listeners.values()]\n      .filter(value => (isDefined(value.filter) ? filterMatch(eventArgs, value.filter as TEventData[TEventName]) : true))\n      .map(info => info.listener)\n    const anyListeners = assertEx(Events.anyMap.get(this))\n    const staticListeners = [...filteredListeners]\n    const staticAnyListeners = [...anyListeners]\n\n    await resolvedPromise\n\n    for (const listener of staticListeners) {\n      await this.safeCallListener(eventName, eventArgs, listener)\n    }\n\n    for (const listener of staticAnyListeners) {\n      await this.safeCallAnyListener(eventName, eventArgs, listener)\n    }\n  }\n\n  /**\n   * Returns the total number of listeners registered for the specified event name(s).\n   * @param eventNames - One or more event names to count listeners for.\n   * @returns The total listener count.\n   */\n  // TODO: Make test for this\n  listenerCount(eventNames?: keyof TEventData | (keyof TEventData)[]) {\n    const eventNamesArray = Array.isArray(eventNames) ? eventNames : [eventNames]\n    let count = 0\n\n    for (const eventName of eventNamesArray) {\n      if (typeof eventName === 'string') {\n        count += assertEx(Events.anyMap.get(this)).size + (this.getListeners(eventName)?.size ?? 0)\n\n        continue\n      }\n\n      count += assertEx(Events.anyMap.get(this)).size\n\n      for (const value of assertEx(Events.eventsMap.get(this)).values()) {\n        count += value.size\n      }\n    }\n\n    return count\n  }\n\n  /**\n   * Logs debug information if debug mode is enabled.\n   * @param type - The type of operation being logged.\n   * @param eventName - The event name, if applicable.\n   * @param eventArgs - The event data, if applicable.\n   */\n  logIfDebugEnabled<TEventName extends EventName>(type: string, eventName?: TEventName, eventArgs?: EventArgs) {\n    if (Events.isDebugEnabled || this.debug?.enabled) {\n      this.debug?.logger?.(type, this.debug.name, eventName, eventArgs)\n    }\n  }\n\n  /**\n   * Removes a specific listener from the specified event name(s).\n   * @param eventNames - One or more event names to unsubscribe from.\n   * @param listener - The listener to remove.\n   */\n  off<TEventName extends keyof TEventData, TEventListener = EventListener<TEventData[TEventName]>>(\n    eventNames: TEventName | TEventName[],\n    listener: TEventListener,\n  ) {\n    const eventNamesArray = Array.isArray(eventNames) ? eventNames : [eventNames]\n    for (const eventName of eventNamesArray) {\n      const set = this.getListeners(eventName) as Set<TEventListener> | undefined\n      if (set) {\n        set.delete(listener)\n        if (set.size === 0) {\n          const events = Events.eventsMap.get(this)\n          events?.delete(eventName)\n        }\n      }\n\n      this.logIfDebugEnabled('unsubscribe', eventName)\n\n      /* v8 ignore next 3 -- meta events don't reach this path via public API */\n      if (!isMetaEvent(eventName)) {\n        forget(this.emitMetaEvent('listenerRemoved', { eventName, listener: listener as EventListener }))\n      }\n    }\n  }\n\n  /**\n   * Removes a wildcard listener that was receiving all events.\n   * @param listener - The wildcard listener to remove.\n   */\n  offAny(listener: EventAnyListener) {\n    this.logIfDebugEnabled('unsubscribeAny')\n\n    const typedMap = Events.anyMap.get(this) as Set<EventAnyListener<TEventData[keyof TEventData]>>\n    typedMap?.delete(listener)\n    forget(this.emitMetaEvent('listenerRemoved', { listener: listener as EventAnyListener }))\n  }\n\n  /**\n   * Subscribes a listener to the specified event name(s).\n   * @param eventNames - One or more event names to listen for.\n   * @param listener - The callback to invoke when the event fires.\n   * @param filter - Optional filter to selectively invoke the listener based on event data.\n   * @returns An unsubscribe function.\n   */\n  on<TEventName extends keyof TEventData = keyof TEventData>(\n    eventNames: TEventName | TEventName[],\n    listener: EventListener<TEventData[TEventName]>,\n    filter?: TEventData[TEventName],\n  ) {\n    const eventNamesArray = Array.isArray(eventNames) ? eventNames : [eventNames]\n    for (const eventName of eventNamesArray) {\n      let set = this.getListeners(eventName)\n      if (!set) {\n        set = new Set()\n        const events = Events.eventsMap.get(this)\n        events?.set(eventName, set)\n      }\n\n      set.add({ filter, listener: listener as EventListener })\n\n      this.logIfDebugEnabled('subscribe', eventName)\n\n      if (!isMetaEvent(eventName)) {\n        forget(this.emitMetaEvent('listenerAdded', { eventName, listener: listener as EventListener }))\n      }\n    }\n\n    return this.off.bind(this, eventNames, listener as EventListener)\n  }\n\n  /**\n   * Subscribes a wildcard listener that receives all events.\n   * @param listener - The callback to invoke for any event.\n   * @returns An unsubscribe function.\n   */\n  onAny(listener: EventAnyListener) {\n    this.logIfDebugEnabled('subscribeAny')\n\n    Events.anyMap.get(this)?.add(listener as EventAnyListener)\n    forget(this.emitMetaEvent('listenerAdded', { listener: listener as EventAnyListener }))\n    return this.offAny.bind(this, listener as EventAnyListener)\n  }\n\n  /**\n   * Subscribes a listener that will be invoked only once for the specified event, then automatically removed.\n   * @param eventName - The event to listen for.\n   * @param listener - The callback to invoke once.\n   * @returns An unsubscribe function.\n   */\n  once<TEventName extends keyof TEventData>(eventName: TEventName, listener: EventListener<TEventData[TEventName]>) {\n    const subListener = async (args: TEventData[TEventName]) => {\n      this.off(eventName, subListener)\n      await this.safeCallListener(eventName, args, listener)\n    }\n    this.on(eventName, subListener)\n    return this.off.bind(this, eventName, subListener as EventListener)\n  }\n\n  private async emitInternal<TEventName extends keyof TEventData, TEventArgs extends TEventData[TEventName]>(\n    eventName: TEventName,\n    eventArgs: TEventArgs,\n    filter?: TEventArgs,\n  ) {\n    if (isMetaEvent(eventName) && !this._canEmitMetaEvents) {\n      throw new TypeError(NO_META_EVENT_ERROR_MESSAGE)\n    }\n\n    this.logIfDebugEnabled('emit', eventName, eventArgs)\n\n    const listeners = this.getListeners(eventName) ?? new Set()\n    /* v8 ignore start -- filter parameter is reserved for future use; anyListeners.has is a race condition guard */\n    const filteredListeners = [...listeners.values()].filter(value => (isDefined(filter) ? isDefined(value.listener) : true)).map(info => info.listener)\n    const anyListeners = assertEx(Events.anyMap.get(this))\n    const staticListeners = [...filteredListeners]\n    const staticAnyListeners = isMetaEvent(eventName) ? [] : [...anyListeners]\n\n    await resolvedPromise\n    await Promise.all([\n      ...staticListeners.map(async (listener) => {\n        await this.safeCallListener(eventName, eventArgs, listener)\n      }),\n      ...staticAnyListeners.map(async (listener) => {\n        if (anyListeners.has(listener)) {\n          await this.safeCallAnyListener(eventName, eventArgs, listener)\n        }\n      }),\n    ])\n    /* v8 ignore stop */\n  }\n\n  private async emitMetaEventInternal<TEventName extends keyof MetaEventData<TEventData>>(\n    eventName: TEventName,\n    eventArgs: MetaEventData<TEventData>[TEventName],\n  ) {\n    if (isMetaEvent(eventName) && !this._canEmitMetaEvents) {\n      throw new TypeError('`eventName` cannot be meta event `listenerAdded` or `listenerRemoved`')\n    }\n\n    this.logIfDebugEnabled('emit', eventName, eventArgs)\n\n    const listeners = this.getListeners(eventName) ?? new Set()\n    const filteredListeners = [...listeners.values()].map(info => info.listener)\n    const anyListeners = assertEx(Events.anyMap.get(this))\n    const staticListeners = [...filteredListeners]\n    const staticAnyListeners = isMetaEvent(eventName) ? [] : [...anyListeners]\n\n    await resolvedPromise\n    await Promise.all([\n      ...staticListeners.map(async (listener) => {\n        await this.safeCallListener(eventName, eventArgs, listener)\n      }),\n      /* v8 ignore start -- race condition guard */\n      ...staticAnyListeners.map(async (listener) => {\n        if (anyListeners.has(listener)) {\n          await this.safeCallAnyListener(eventName, eventArgs, listener)\n        }\n      }),\n      /* v8 ignore stop */\n    ])\n    return true\n  }\n\n  private getListeners<TEventName extends keyof TEventData>(eventName: TEventName) {\n    const events = assertEx(Events.eventsMap.get(this))\n    if (!events.has(eventName)) {\n      return\n    }\n\n    return events.get(eventName)\n  }\n\n  private async safeCallAnyListener<TEventData extends EventData, TEventName extends keyof EventData>(\n    eventName: TEventName,\n    eventArgs: TEventData[TEventName],\n    listener: EventAnyListener<TEventData[TEventName]>,\n  ) {\n    try {\n      return await listener(eventName, eventArgs)\n    } catch (ex) {\n      handleError(ex, (error) => {\n        this.logger?.error(`Listener[${String(eventName)}] Excepted: ${error.message}`)\n      })\n    }\n  }\n\n  private async safeCallListener<TEventData extends EventData, TEventName extends keyof EventData>(\n    eventName: TEventName,\n    eventArgs: TEventData[TEventName],\n    listener: EventListener<TEventData[TEventName]>,\n  ) {\n    try {\n      return await listener(eventArgs)\n    } catch (ex) {\n      handleError(ex, (error) => {\n        this.logger?.error(`Listener[${String(eventName)}] Excepted: ${error.message}`)\n      })\n    }\n  }\n}\n"],"mappings":"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","names":["Base","eventName","Base"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/events",
-  "version": "5.0.84",
+  "version": "5.0.87",
   "description": "Base functionality used throughout XY Labs TypeScript/JavaScript libraries",
   "homepage": "https://xyo.network",
   "bugs": {
@@ -35,21 +35,21 @@
     "!**/*.test.*"
   ],
   "dependencies": {
-    "@xylabs/assert": "~5.0.84",
-    "@xylabs/base": "~5.0.84",
-    "@xylabs/error": "~5.0.84",
-    "@xylabs/forget": "~5.0.84",
-    "@xylabs/object": "~5.0.84",
-    "@xylabs/promise": "~5.0.84",
-    "@xylabs/typeof": "~5.0.84"
+    "@xylabs/assert": "~5.0.87",
+    "@xylabs/base": "~5.0.87",
+    "@xylabs/error": "~5.0.87",
+    "@xylabs/forget": "~5.0.87",
+    "@xylabs/object": "~5.0.87",
+    "@xylabs/promise": "~5.0.87",
+    "@xylabs/typeof": "~5.0.87"
   },
   "devDependencies": {
-    "@xylabs/delay": "~5.0.84",
-    "@xylabs/ts-scripts-yarn3": "~7.4.13",
-    "@xylabs/tsconfig": "~7.4.13",
-    "@xylabs/vitest-extended": "~5.0.84",
+    "@xylabs/delay": "~5.0.87",
+    "@xylabs/ts-scripts-yarn3": "~7.4.24",
+    "@xylabs/tsconfig": "~7.4.24",
+    "@xylabs/vitest-extended": "~5.0.87",
     "typescript": "~5.9.3",
-    "vitest": "~4.0.18"
+    "vitest": "^4.1.0"
   },
   "publishConfig": {
     "access": "public"