@xylabs/events 7.0.2 → 7.0.4

package/README.md

@@ -1,3 +1,5 @@
+> **Deprecated.** Use [`@ariestools/sdk`](../../ariestools-sdk/README.md) instead. This package is a backward-compatibility re-export shim.
+
 [![logo][]](https://xylabs.com)
 
 # @xylabs/events
@@ -12,25 +14,25 @@
 Using npm:
 
 ```sh
-npm install {{name}}
+npm install @xylabs/events
 ```
 
 Using yarn:
 
 ```sh
-yarn add {{name}}
+yarn add @xylabs/events
 ```
 
 Using pnpm:
 
 ```sh
-pnpm add {{name}}
+pnpm add @xylabs/events
 ```
 
 Using bun:
 
 ```sh
-bun add {{name}}
+bun add @xylabs/events
 ```
 
 

package/dist/neutral/index.d.ts

@@ -1,4 +1,2 @@
-export * from './BaseEmitter.ts';
-export * from './Events/index.ts';
-export * from './model/index.ts';
+export * from '@ariestools/sdk/events';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA"}

package/dist/neutral/index.mjs

@@ -1,415 +1,3 @@
-// src/BaseEmitter.ts
-import { Base as Base2 } from "@xylabs/base";
-
-// src/Events/Events.ts
-import { assertEx } from "@xylabs/assert";
-import { Base } from "@xylabs/base";
-import { handleError } from "@xylabs/error";
-import { forget } from "@xylabs/forget";
-import { isDefined } from "@xylabs/typeof";
-var NO_META_EVENT_ERROR_MESSAGE = "`eventName` cannot be meta event `listenerAdded` or `listenerRemoved`";
-var processGlobal = globalThis;
-var resolvedPromise = Promise.resolve();
-var isMetaEvent = (eventName) => eventName === "listenerAdded" || eventName === "listenerRemoved";
-var Events = class _Events extends Base {
-  static anyMap = /* @__PURE__ */ new WeakMap();
-  static eventsMap = /* @__PURE__ */ new WeakMap();
-  static isGlobalDebugEnabled = false;
-  // this is here to be able to query the type, not use
-  eventData = {};
-  _canEmitMetaEvents = false;
-  constructor(params = {}) {
-    const mutatedParams = { ...params };
-    if (mutatedParams.debug) {
-      mutatedParams.debug.logger ??= (type, debugName, eventName, eventData) => {
-        let eventDataString;
-        try {
-          eventDataString = JSON.stringify(eventData);
-        } catch {
-          eventDataString = `Object with the following keys failed to stringify: ${Object.keys(eventData ?? {}).join(",")}`;
-        }
-        const eventNameString = typeof eventName === "symbol" || typeof eventName === "number" ? eventName.toString() : eventName;
-        const currentTime = /* @__PURE__ */ new Date();
-        const logTime = `${currentTime.getHours()}:${currentTime.getMinutes()}:${currentTime.getSeconds()}.${currentTime.getMilliseconds()}`;
-        this.logger?.log(`[${logTime}][events:${type}][${debugName}] Event Name: ${eventNameString}
-	data: ${eventDataString}`);
-      };
-    }
-    super(mutatedParams);
-    _Events.anyMap.set(this, /* @__PURE__ */ new Set());
-    _Events.eventsMap.set(this, /* @__PURE__ */ new Map());
-  }
-  /** Whether debug mode is enabled globally or via the DEBUG environment variable. */
-  static get isDebugEnabled() {
-    if (typeof processGlobal.process?.env !== "object") {
-      return this.isGlobalDebugEnabled;
-    }
-    const env = processGlobal.process?.env;
-    return env?.DEBUG === "events" || env?.DEBUG === "*" || this.isGlobalDebugEnabled;
-  }
-  static set isDebugEnabled(newValue) {
-    this.isGlobalDebugEnabled = newValue;
-  }
-  /** The debug configuration for this instance, if provided. */
-  get debug() {
-    return this.params.debug;
-  }
-  /**
-   * Removes all listeners for the specified event name(s).
-   * @param eventNames - One or more event names to clear listeners for.
-   */
-  clearListeners(eventNames) {
-    const eventNamesArray = Array.isArray(eventNames) ? eventNames : [eventNames];
-    for (const eventName of eventNamesArray) {
-      this.logIfDebugEnabled("clear", eventName);
-      if (typeof eventName === "string" || typeof eventName === "symbol" || typeof eventName === "number") {
-        const set = this.getListeners(eventName);
-        if (set) {
-          set.clear();
-        }
-      } else {
-        _Events.anyMap.get(this)?.clear();
-        const eventEntries = assertEx(_Events.eventsMap.get(this));
-        for (const [eventName2, listeners] of eventEntries) {
-          listeners.clear();
-          _Events.eventsMap.get(this)?.delete(eventName2);
-        }
-      }
-    }
-  }
-  /**
-   * Emits an event, invoking all registered listeners concurrently.
-   * @param eventName - The event to emit.
-   * @param eventArgs - The data to pass to listeners.
-   */
-  async emit(eventName, eventArgs) {
-    return await this.emitInternal(eventName, eventArgs);
-  }
-  /**
-   * Emits an internal meta event (listenerAdded or listenerRemoved).
-   * @param eventName - The meta event name.
-   * @param eventArgs - The meta event data containing listener and event information.
-   * @returns True if the meta event was emitted successfully.
-   */
-  async emitMetaEvent(eventName, eventArgs) {
-    if (isMetaEvent(eventName)) {
-      try {
-        this._canEmitMetaEvents = true;
-        await this.emitMetaEventInternal(eventName, eventArgs);
-        return true;
-      } finally {
-        this._canEmitMetaEvents = false;
-      }
-    }
-  }
-  /**
-   * Emits an event, invoking all registered listeners sequentially in order.
-   * @param eventName - The event to emit.
-   * @param eventArgs - The data to pass to listeners.
-   */
-  async emitSerial(eventName, eventArgs) {
-    if (isMetaEvent(eventName) && !this._canEmitMetaEvents) {
-      throw new TypeError(NO_META_EVENT_ERROR_MESSAGE);
-    }
-    const filterMatch = (args, filter) => {
-      switch (typeof filter) {
-        case "object": {
-          if (filter === null || args === null || typeof args !== "object") return args === filter;
-          return Object.entries(args).reduce((prev, [key, value]) => filter[key] === value ? true : prev, false);
-        }
-        default: {
-          return args === filter;
-        }
-      }
-    };
-    this.logIfDebugEnabled("emitSerial", eventName, eventArgs);
-    const listeners = this.getListeners(eventName) ?? /* @__PURE__ */ new Set();
-    const filteredListeners = [...listeners].filter((value) => isDefined(value.filter) ? filterMatch(eventArgs, value.filter) : true).map((info) => info.listener);
-    const anyListeners = assertEx(_Events.anyMap.get(this));
-    const staticListeners = [...filteredListeners];
-    const staticAnyListeners = [...anyListeners];
-    await resolvedPromise;
-    for (const listener of staticListeners) {
-      await this.safeCallListener(eventName, eventArgs, listener);
-    }
-    for (const listener of staticAnyListeners) {
-      await this.safeCallAnyListener(eventName, eventArgs, listener);
-    }
-  }
-  /**
-   * Returns the total number of listeners registered for the specified event name(s).
-   * @param eventNames - One or more event names to count listeners for.
-   * @returns The total listener count.
-   */
-  // TODO: Make test for this
-  listenerCount(eventNames) {
-    const eventNamesArray = Array.isArray(eventNames) ? eventNames : [eventNames];
-    let count = 0;
-    for (const eventName of eventNamesArray) {
-      if (typeof eventName === "string") {
-        count += assertEx(_Events.anyMap.get(this)).size + (this.getListeners(eventName)?.size ?? 0);
-        continue;
-      }
-      count += assertEx(_Events.anyMap.get(this)).size;
-      const eventListeners = assertEx(_Events.eventsMap.get(this)).values();
-      for (const value of eventListeners) {
-        count += value.size;
-      }
-    }
-    return count;
-  }
-  /**
-   * Logs debug information if debug mode is enabled.
-   * @param type - The type of operation being logged.
-   * @param eventName - The event name, if applicable.
-   * @param eventArgs - The event data, if applicable.
-   */
-  logIfDebugEnabled(type, eventName, eventArgs) {
-    if (_Events.isDebugEnabled || this.debug?.enabled === true) {
-      this.debug?.logger?.(type, this.debug.name, eventName, eventArgs);
-    }
-  }
-  /**
-   * Removes a specific listener from the specified event name(s).
-   * @param eventNames - One or more event names to unsubscribe from.
-   * @param listener - The listener to remove.
-   */
-  off(eventNames, listener) {
-    const eventNamesArray = Array.isArray(eventNames) ? eventNames : [eventNames];
-    for (const eventName of eventNamesArray) {
-      const set = this.getListeners(eventName);
-      if (set) {
-        set.delete(listener);
-        if (set.size === 0) {
-          const events = _Events.eventsMap.get(this);
-          events?.delete(eventName);
-        }
-      }
-      this.logIfDebugEnabled("unsubscribe", eventName);
-      if (!isMetaEvent(eventName)) {
-        forget(this.emitMetaEvent("listenerRemoved", { eventName, listener }));
-      }
-    }
-  }
-  /**
-   * Removes a wildcard listener that was receiving all events.
-   * @param listener - The wildcard listener to remove.
-   */
-  offAny(listener) {
-    this.logIfDebugEnabled("unsubscribeAny");
-    const typedMap = _Events.anyMap.get(this);
-    typedMap?.delete(listener);
-    forget(this.emitMetaEvent("listenerRemoved", { listener }));
-  }
-  /**
-   * Subscribes a listener to the specified event name(s).
-   * @param eventNames - One or more event names to listen for.
-   * @param listener - The callback to invoke when the event fires.
-   * @param filter - Optional filter to selectively invoke the listener based on event data.
-   * @returns An unsubscribe function.
-   */
-  on(eventNames, listener, filter) {
-    const eventNamesArray = Array.isArray(eventNames) ? eventNames : [eventNames];
-    for (const eventName of eventNamesArray) {
-      let set = this.getListeners(eventName);
-      if (!set) {
-        set = /* @__PURE__ */ new Set();
-        const events = _Events.eventsMap.get(this);
-        events?.set(eventName, set);
-      }
-      set.add({ filter, listener });
-      this.logIfDebugEnabled("subscribe", eventName);
-      if (!isMetaEvent(eventName)) {
-        forget(this.emitMetaEvent("listenerAdded", { eventName, listener }));
-      }
-    }
-    return this.off.bind(this, eventNames, listener);
-  }
-  /**
-   * Subscribes a wildcard listener that receives all events.
-   * @param listener - The callback to invoke for any event.
-   * @returns An unsubscribe function.
-   */
-  onAny(listener) {
-    this.logIfDebugEnabled("subscribeAny");
-    _Events.anyMap.get(this)?.add(listener);
-    forget(this.emitMetaEvent("listenerAdded", { listener }));
-    return this.offAny.bind(this, listener);
-  }
-  /**
-   * Subscribes a listener that will be invoked only once for the specified event, then automatically removed.
-   * @param eventName - The event to listen for.
-   * @param listener - The callback to invoke once.
-   * @returns An unsubscribe function.
-   */
-  once(eventName, listener) {
-    const subListener = async (args) => {
-      this.off(eventName, subListener);
-      await this.safeCallListener(eventName, args, listener);
-    };
-    this.on(eventName, subListener);
-    return this.off.bind(this, eventName, subListener);
-  }
-  async emitInternal(eventName, eventArgs, filter) {
-    if (isMetaEvent(eventName) && !this._canEmitMetaEvents) {
-      throw new TypeError(NO_META_EVENT_ERROR_MESSAGE);
-    }
-    this.logIfDebugEnabled("emit", eventName, eventArgs);
-    const listeners = this.getListeners(eventName) ?? /* @__PURE__ */ new Set();
-    const filteredListeners = [...listeners].filter((value) => isDefined(filter) ? isDefined(value.listener) : true).map((info) => info.listener);
-    const anyListeners = assertEx(_Events.anyMap.get(this));
-    const staticListeners = [...filteredListeners];
-    const staticAnyListeners = isMetaEvent(eventName) ? [] : [...anyListeners];
-    await resolvedPromise;
-    await Promise.all([
-      ...staticListeners.map(async (listener) => {
-        await this.safeCallListener(eventName, eventArgs, listener);
-      }),
-      ...staticAnyListeners.map(async (listener) => {
-        if (anyListeners.has(listener)) {
-          await this.safeCallAnyListener(eventName, eventArgs, listener);
-        }
-      })
-    ]);
-  }
-  async emitMetaEventInternal(eventName, eventArgs) {
-    if (isMetaEvent(eventName) && !this._canEmitMetaEvents) {
-      throw new TypeError("`eventName` cannot be meta event `listenerAdded` or `listenerRemoved`");
-    }
-    this.logIfDebugEnabled("emit", eventName, eventArgs);
-    const listeners = this.getListeners(eventName) ?? /* @__PURE__ */ new Set();
-    const filteredListeners = [...listeners].map((info) => info.listener);
-    const anyListeners = assertEx(_Events.anyMap.get(this));
-    const staticListeners = [...filteredListeners];
-    const staticAnyListeners = isMetaEvent(eventName) ? [] : [...anyListeners];
-    await resolvedPromise;
-    await Promise.all([
-      ...staticListeners.map(async (listener) => {
-        await this.safeCallListener(eventName, eventArgs, listener);
-      }),
-      /* v8 ignore start -- race condition guard */
-      ...staticAnyListeners.map(async (listener) => {
-        if (anyListeners.has(listener)) {
-          await this.safeCallAnyListener(eventName, eventArgs, listener);
-        }
-      })
-      /* v8 ignore stop */
-    ]);
-    return true;
-  }
-  getListeners(eventName) {
-    const events = assertEx(_Events.eventsMap.get(this));
-    if (!events.has(eventName)) {
-      return;
-    }
-    return events.get(eventName);
-  }
-  async safeCallAnyListener(eventName, eventArgs, listener) {
-    try {
-      return await listener(eventName, eventArgs);
-    } catch (ex) {
-      handleError(ex, (error) => {
-        this.logger?.error(`Listener[${String(eventName)}] Excepted: ${error.message}`);
-      });
-    }
-  }
-  async safeCallListener(eventName, eventArgs, listener) {
-    try {
-      return await listener(eventArgs);
-    } catch (ex) {
-      handleError(ex, (error) => {
-        this.logger?.error(`Listener[${String(eventName)}] Excepted: ${error.message}`);
-      });
-    }
-  }
-};
-
-// src/BaseEmitter.ts
-var BaseEmitter = class extends Base2 {
-  // just here to query types
-  eventData = {};
-  events;
-  constructor(params) {
-    super(params);
-    this.events = new Events();
-  }
-  /**
-   * Removes all listeners for the specified event name(s).
-   * @param eventNames - One or more event names to clear listeners for.
-   * @returns This instance for chaining.
-   */
-  clearListeners(eventNames) {
-    this.events.clearListeners(eventNames);
-    return this;
-  }
-  /**
-   * Emits an event, invoking all registered listeners concurrently.
-   * @param eventName - The event to emit.
-   * @param eventArgs - The data to pass to listeners.
-   */
-  emit(eventName, eventArgs) {
-    return this.events.emit(eventName, eventArgs);
-  }
-  /**
-   * Emits an event, invoking all registered listeners sequentially in order.
-   * @param eventName - The event to emit.
-   * @param eventArgs - The data to pass to listeners.
-   */
-  emitSerial(eventName, eventArgs) {
-    return this.events.emitSerial(eventName, eventArgs);
-  }
-  /**
-   * Returns the total number of listeners registered for the specified event name(s).
-   * @param eventNames - One or more event names to count listeners for.
-   * @returns The total listener count.
-   */
-  listenerCount(eventNames) {
-    return this.events.listenerCount(eventNames);
-  }
-  /**
-   * Removes a specific listener from the specified event name(s).
-   * @param eventNames - One or more event names to unsubscribe from.
-   * @param listener - The listener to remove.
-   */
-  off(eventNames, listener) {
-    return this.events.off(eventNames, listener);
-  }
-  /**
-   * Removes a wildcard listener that was receiving all events.
-   * @param listener - The wildcard listener to remove.
-   */
-  offAny(listener) {
-    return this.events.offAny(listener);
-  }
-  /**
-   * Subscribes a listener to the specified event name(s).
-   * @param eventNames - One or more event names to listen for.
-   * @param listener - The callback to invoke when the event fires.
-   * @returns An unsubscribe function.
-   */
-  on(eventNames, listener) {
-    return this.events.on(eventNames, listener);
-  }
-  /**
-   * Subscribes a wildcard listener that receives all events.
-   * @param listener - The callback to invoke for any event.
-   * @returns An unsubscribe function.
-   */
-  onAny(listener) {
-    return this.events.onAny(listener);
-  }
-  /**
-   * Subscribes a listener that will be invoked only once for the specified event, then automatically removed.
-   * @param eventName - The event to listen for.
-   * @param listener - The callback to invoke once.
-   * @returns An unsubscribe function.
-   */
-  once(eventName, listener) {
-    return this.events.once(eventName, listener);
-  }
-};
-export {
-  BaseEmitter,
-  Events
-};
+// src/index.ts
+export * from "@ariestools/sdk/events";
 //# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "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>\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 interface 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\ninterface ProcessGlobal {\n  process?: {\n    env?: {\n      DEBUG?: string\n    }\n  }\n}\n\nconst processGlobal = globalThis as ProcessGlobal\n\n/**\nConfigure debug options of an instance.\n*/\n/* v8 ignore next 5 */\nexport interface 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 interface 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        ??= (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 processGlobal.process?.env !== 'object') {\n      return this.isGlobalDebugEnabled\n    }\n\n    const env = processGlobal.process?.env\n    return env?.DEBUG === 'events' || env?.DEBUG === '*' || this.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        const eventEntries = assertEx(Events.eventsMap.get(this))\n        for (const [eventName, listeners] of eventEntries) {\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      }\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          if (filter === null || args === null || typeof args !== 'object') return args === filter\n          // eslint-disable-next-line unicorn/no-array-reduce\n          return Object.entries(args as Record<string, unknown>).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]\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      const eventListeners = assertEx(Events.eventsMap.get(this)).values()\n      for (const value of eventListeners) {\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 === true) {\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 }))\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)\n    forget(this.emitMetaEvent('listenerAdded', { listener: listener }))\n    return this.offAny.bind(this, 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    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].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].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(eventName: EventName) {\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<TEventArgs extends EventArgs>(\n    eventName: EventName,\n    eventArgs: TEventArgs,\n    listener: EventAnyListener<TEventArgs>,\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<TEventArgs extends EventArgs>(\n    eventName: EventName,\n    eventArgs: TEventArgs,\n    listener: EventListener<TEventArgs>,\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"]
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": ["export * from '@ariestools/sdk/events'\n"],
+  "mappings": ";AAAA,cAAc;",
+  "names": []
 }

package/dist/neutral/model.d.ts

@@ -1,3 +1,2 @@
-export type { BaseEmitterParams, BaseEmitterParamsFields, } from './BaseEmitter.ts';
-export type * from './model/index.ts';
+export type * from '@ariestools/sdk/events/model';
 //# sourceMappingURL=model.d.ts.map

package/dist/neutral/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,kBAAkB,CAAA;AACzB,mBAAmB,kBAAkB,CAAA"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AAAA,mBAAmB,8BAA8B,CAAA"}

package/package.json

@@ -1,21 +1,27 @@
 {
   "name": "@xylabs/events",
-  "version": "7.0.2",
-  "description": "Base functionality used throughout XY Labs TypeScript/JavaScript libraries",
-  "homepage": "https://xyo.network",
+  "version": "7.0.4",
+  "description": "DEPRECATED — use @ariestools/sdk/events. Backward-compatibility re-export shim.",
+  "keywords": [
+    "xylabs",
+    "utility",
+    "typescript",
+    "esm"
+  ],
+  "homepage": "https://xylabs.com",
   "bugs": {
-    "url": "git+https://github.com/XYOracleNetwork/sdk-xyo-client-js/issues",
-    "email": "support@xyo.network"
+    "url": "git+https://github.com/xylabs/sdk-js/issues",
+    "email": "support@xylabs.com"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/XYOracleNetwork/sdk-xyo-client-js.git"
+    "url": "git+https://github.com/xylabs/sdk-js.git"
   },
   "license": "LGPL-3.0-only",
   "author": {
-    "name": "XYO Development Team",
-    "email": "support@xyo.network",
-    "url": "https://xyo.network"
+    "name": "XY Labs Development Team",
+    "email": "support@xylabs.com",
+    "url": "https://xylabs.com"
   },
   "sideEffects": false,
   "type": "module",
@@ -24,11 +30,11 @@
       "types": "./dist/neutral/index.d.ts",
       "default": "./dist/neutral/index.mjs"
     },
+    "./package.json": "./package.json",
     "./model": {
       "types": "./dist/neutral/model.d.ts",
       "default": "./dist/neutral/model.mjs"
-    },
-    "./package.json": "./package.json"
+    }
   },
   "files": [
     "dist",
@@ -38,31 +44,24 @@
     "README.md"
   ],
   "dependencies": {
-    "@xylabs/assert": "~7.0.2",
-    "@xylabs/base": "~7.0.2",
-    "@xylabs/error": "~7.0.2",
-    "@xylabs/forget": "~7.0.2",
-    "@xylabs/object": "~7.0.2",
-    "@xylabs/promise": "~7.0.2",
-    "@xylabs/typeof": "~7.0.2"
+    "@ariestools/sdk": "~7.0.4"
   },
   "devDependencies": {
     "@opentelemetry/api": "^1.9.1",
-    "@types/node": "^26.0.1",
-    "@xylabs/toolchain": "^8.5.3",
-    "@xylabs/tsconfig": "^8.5.3",
+    "@opentelemetry/sdk-trace-base": "^2.8.0",
+    "@xylabs/toolchain": "^8.5.11",
+    "@xylabs/tsconfig": "^8.5.11",
+    "async-mutex": "^0.5.0",
     "browserslist": "4.28.4",
     "eslint": "^10.6.0",
     "eslint-import-resolver-typescript": "^4.4.5",
     "typescript": "^6.0.3",
-    "vite": "^8.1.0",
-    "vitest": "^4.1.9",
-    "zod": "^4.4.3",
-    "@xylabs/delay": "~7.0.2",
-    "@xylabs/vitest-extended": "~7.0.2"
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
     "@opentelemetry/api": "^1.9",
+    "@opentelemetry/sdk-trace-base": "^2.7",
+    "async-mutex": "^0.5",
     "zod": "^4.4"
   },
   "engines": {
@@ -70,5 +69,6 @@
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "deprecated": "Use @ariestools/sdk/events instead. @xylabs/events is a compatibility shim only and will not receive further updates."
 }

package/dist/neutral/BaseEmitter.d.ts

@@ -1,74 +0,0 @@
-import type { BaseParams } from '@xylabs/base';
-import { Base } from '@xylabs/base';
-import type { EmptyObject } from '@xylabs/object';
-import type { EventAnyListener, EventData, EventEmitter, EventListener } from './model/index.ts';
-/** Fields specific to BaseEmitter configuration parameters. */
-export interface BaseEmitterParamsFields {
-}
-/** Parameters type for configuring a BaseEmitter instance. */
-export type BaseEmitterParams<T extends EmptyObject = EmptyObject> = BaseParams<T & BaseEmitterParamsFields>;
-/**
- * Base class that combines the Base utility class with typed event emission capabilities.
- * Delegates all event operations to an internal Events instance.
- */
-export declare class BaseEmitter<TParams extends BaseParams = BaseParams, TEventData extends EventData = EventData> extends Base<TParams> implements EventEmitter<TEventData> {
-    eventData: TEventData;
-    private events;
-    constructor(params: BaseParams<TParams>);
-    /**
-     * Removes all listeners for the specified event name(s).
-     * @param eventNames - One or more event names to clear listeners for.
-     * @returns This instance for chaining.
-     */
-    clearListeners(eventNames: keyof TEventData | (keyof TEventData)[]): this;
-    /**
-     * Emits an event, invoking all registered listeners concurrently.
-     * @param eventName - The event to emit.
-     * @param eventArgs - The data to pass to listeners.
-     */
-    emit<TEventName extends keyof TEventData = keyof TEventData, TEventArgs extends TEventData[TEventName] = TEventData[TEventName]>(eventName: TEventName, eventArgs: TEventArgs): Promise<void>;
-    /**
-     * Emits an event, invoking all registered listeners sequentially in order.
-     * @param eventName - The event to emit.
-     * @param eventArgs - The data to pass to listeners.
-     */
-    emitSerial<TEventName extends keyof TEventData = keyof TEventData, TEventArgs extends TEventData[TEventName] = TEventData[TEventName]>(eventName: TEventName, eventArgs: TEventArgs): Promise<void>;
-    /**
-     * Returns the total number of listeners registered for the specified event name(s).
-     * @param eventNames - One or more event names to count listeners for.
-     * @returns The total listener count.
-     */
-    listenerCount(eventNames: keyof TEventData | (keyof TEventData)[]): number;
-    /**
-     * Removes a specific listener from the specified event name(s).
-     * @param eventNames - One or more event names to unsubscribe from.
-     * @param listener - The listener to remove.
-     */
-    off<TEventName extends keyof TEventData>(eventNames: TEventName | TEventName[], listener: EventListener<TEventData[TEventName]>): void;
-    /**
-     * Removes a wildcard listener that was receiving all events.
-     * @param listener - The wildcard listener to remove.
-     */
-    offAny(listener: EventAnyListener): void;
-    /**
-     * Subscribes a listener to the specified event name(s).
-     * @param eventNames - One or more event names to listen for.
-     * @param listener - The callback to invoke when the event fires.
-     * @returns An unsubscribe function.
-     */
-    on<TEventName extends keyof TEventData>(eventNames: TEventName | TEventName[], listener: EventListener<TEventData[TEventName]>): () => void;
-    /**
-     * Subscribes a wildcard listener that receives all events.
-     * @param listener - The callback to invoke for any event.
-     * @returns An unsubscribe function.
-     */
-    onAny(listener: EventAnyListener): () => void;
-    /**
-     * Subscribes a listener that will be invoked only once for the specified event, then automatically removed.
-     * @param eventName - The event to listen for.
-     * @param listener - The callback to invoke once.
-     * @returns An unsubscribe function.
-     */
-    once<TEventName extends keyof TEventData>(eventName: TEventName, listener: EventListener<TEventData[TEventName]>): () => void;
-}
-//# sourceMappingURL=BaseEmitter.d.ts.map

package/dist/neutral/BaseEmitter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"BaseEmitter.d.ts","sourceRoot":"","sources":["../../src/BaseEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAGjD,OAAO,KAAK,EACV,gBAAgB,EAAE,SAAS,EAAE,YAAY,EACzC,aAAa,EACd,MAAM,kBAAkB,CAAA;AAEzB,+DAA+D;AAC/D,MAAM,WAAW,uBAAuB;CAAG;AAE3C,8DAA8D;AAC9D,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,UAAU,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAA;AAE5G;;;GAGG;AACH,qBAAa,WAAW,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU,EAAE,UAAU,SAAS,SAAS,GAAG,SAAS,CACxG,SAAQ,IAAI,CAAC,OAAO,CAAE,YAAW,YAAY,CAAC,UAAU,CAAC;IAEzD,SAAS,EAAS,UAAU,CAAA;IAE5B,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC;IAKvC;;;;OAIG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,UAAU,GAAG,CAAC,MAAM,UAAU,CAAC,EAAE;IAKlE;;;;OAIG;IACH,IAAI,CAAC,UAAU,SAAS,MAAM,UAAU,GAAG,MAAM,UAAU,EAAE,UAAU,SAAS,UAAU,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,EAC7H,SAAS,EAAE,UAAU,EACrB,SAAS,EAAE,UAAU;IAKvB;;;;OAIG;IACH,UAAU,CAAC,UAAU,SAAS,MAAM,UAAU,GAAG,MAAM,UAAU,EAAE,UAAU,SAAS,UAAU,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,EACnI,SAAS,EAAE,UAAU,EACrB,SAAS,EAAE,UAAU;IAKvB;;;;OAIG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,UAAU,GAAG,CAAC,MAAM,UAAU,CAAC,EAAE;IAIjE;;;;OAIG;IACH,GAAG,CAAC,UAAU,SAAS,MAAM,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,UAAU,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAI/H;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,gBAAgB;IAIjC;;;;;OAKG;IACH,EAAE,CAAC,UAAU,SAAS,MAAM,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,UAAU,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAI9H;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,gBAAgB;IAIhC;;;;;OAKG;IACH,IAAI,CAAC,UAAU,SAAS,MAAM,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;CAGjH"}

package/dist/neutral/Events/Events.d.ts

@@ -1,132 +0,0 @@
-import type { BaseParams } from '@xylabs/base';
-import { Base } from '@xylabs/base';
-import type { EventAnyListener, EventArgs, EventData, EventEmitter, EventListener, EventName } from '../model/index.ts';
-/**
-Emittery can collect and log debug information.
-
-To enable this feature set the `DEBUG` environment variable to `emittery` or `*`. Additionally, you can set the static `isDebugEnabled` variable to true
-on the Emittery class, or `myEmitter.debug.enabled` on an instance of it for debugging a single instance.
-
-See API for more information on how debugging works.
-*/
-export type DebugLogger = (type: string, debugName: string, eventName?: EventName, eventData?: EventArgs) => void;
-/** Information about a registered event listener, including an optional filter for selective invocation. */
-export interface EventListenerInfo<TEventArgs extends EventArgs = EventArgs> {
-    filter?: TEventArgs;
-    listener: EventListener<TEventArgs>;
-}
-/**
-Configure debug options of an instance.
-*/
-export interface DebugOptions {
-    enabled?: boolean;
-    logger?: DebugLogger;
-    readonly name: string;
-}
-/** Data shape for internal meta events that fire when listeners are added or removed. */
-export interface MetaEventData<TEventData extends EventData> {
-    listenerAdded: {
-        eventName?: keyof TEventData;
-        listener: EventListener<TEventData[keyof TEventData]> | EventAnyListener<TEventData[keyof TEventData]>;
-    };
-    listenerRemoved: {
-        eventName?: keyof TEventData;
-        listener: EventListener<TEventData[keyof TEventData]> | EventAnyListener<TEventData[keyof TEventData]>;
-    };
-}
-/** Parameters for constructing an Events instance, with optional debug configuration. */
-export type EventsParams = BaseParams<{
-    readonly debug?: DebugOptions;
-}>;
-/**
- * Core typed event emitter implementation supporting named events, wildcard listeners,
- * serial and concurrent emission, listener filtering, and debug logging.
- */
-export declare class Events<TEventData extends EventData = EventData> extends Base<EventsParams> implements EventEmitter<TEventData> {
-    protected static anyMap: WeakMap<object, Set<EventAnyListener>>;
-    protected static eventsMap: WeakMap<object, Map<PropertyKey, Set<EventListenerInfo<unknown>>>>;
-    private static isGlobalDebugEnabled;
-    eventData: TEventData;
-    private _canEmitMetaEvents;
-    constructor(params?: EventsParams);
-    /** Whether debug mode is enabled globally or via the DEBUG environment variable. */
-    static get isDebugEnabled(): boolean;
-    static set isDebugEnabled(newValue: boolean);
-    /** The debug configuration for this instance, if provided. */
-    get debug(): DebugOptions | undefined;
-    /**
-     * Removes all listeners for the specified event name(s).
-     * @param eventNames - One or more event names to clear listeners for.
-     */
-    clearListeners(eventNames: keyof TEventData | (keyof TEventData)[]): void;
-    /**
-     * Emits an event, invoking all registered listeners concurrently.
-     * @param eventName - The event to emit.
-     * @param eventArgs - The data to pass to listeners.
-     */
-    emit<TEventName extends keyof TEventData>(eventName: TEventName, eventArgs: TEventData[TEventName]): Promise<void>;
-    /**
-     * Emits an internal meta event (listenerAdded or listenerRemoved).
-     * @param eventName - The meta event name.
-     * @param eventArgs - The meta event data containing listener and event information.
-     * @returns True if the meta event was emitted successfully.
-     */
-    emitMetaEvent<TEventName extends keyof MetaEventData<TEventData>>(eventName: TEventName, eventArgs: MetaEventData<TEventData>[TEventName]): Promise<true | undefined>;
-    /**
-     * Emits an event, invoking all registered listeners sequentially in order.
-     * @param eventName - The event to emit.
-     * @param eventArgs - The data to pass to listeners.
-     */
-    emitSerial<TEventName extends keyof TEventData>(eventName: TEventName, eventArgs: TEventData[TEventName]): Promise<void>;
-    /**
-     * Returns the total number of listeners registered for the specified event name(s).
-     * @param eventNames - One or more event names to count listeners for.
-     * @returns The total listener count.
-     */
-    listenerCount(eventNames?: keyof TEventData | (keyof TEventData)[]): number;
-    /**
-     * Logs debug information if debug mode is enabled.
-     * @param type - The type of operation being logged.
-     * @param eventName - The event name, if applicable.
-     * @param eventArgs - The event data, if applicable.
-     */
-    logIfDebugEnabled<TEventName extends EventName>(type: string, eventName?: TEventName, eventArgs?: EventArgs): void;
-    /**
-     * Removes a specific listener from the specified event name(s).
-     * @param eventNames - One or more event names to unsubscribe from.
-     * @param listener - The listener to remove.
-     */
-    off<TEventName extends keyof TEventData, TEventListener = EventListener<TEventData[TEventName]>>(eventNames: TEventName | TEventName[], listener: TEventListener): void;
-    /**
-     * Removes a wildcard listener that was receiving all events.
-     * @param listener - The wildcard listener to remove.
-     */
-    offAny(listener: EventAnyListener): void;
-    /**
-     * Subscribes a listener to the specified event name(s).
-     * @param eventNames - One or more event names to listen for.
-     * @param listener - The callback to invoke when the event fires.
-     * @param filter - Optional filter to selectively invoke the listener based on event data.
-     * @returns An unsubscribe function.
-     */
-    on<TEventName extends keyof TEventData = keyof TEventData>(eventNames: TEventName | TEventName[], listener: EventListener<TEventData[TEventName]>, filter?: TEventData[TEventName]): () => void;
-    /**
-     * Subscribes a wildcard listener that receives all events.
-     * @param listener - The callback to invoke for any event.
-     * @returns An unsubscribe function.
-     */
-    onAny(listener: EventAnyListener): () => void;
-    /**
-     * Subscribes a listener that will be invoked only once for the specified event, then automatically removed.
-     * @param eventName - The event to listen for.
-     * @param listener - The callback to invoke once.
-     * @returns An unsubscribe function.
-     */
-    once<TEventName extends keyof TEventData>(eventName: TEventName, listener: EventListener<TEventData[TEventName]>): () => void;
-    private emitInternal;
-    private emitMetaEventInternal;
-    private getListeners;
-    private safeCallAnyListener;
-    private safeCallListener;
-}
-//# sourceMappingURL=Events.d.ts.map

package/dist/neutral/Events/Events.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Events.d.ts","sourceRoot":"","sources":["../../../src/Events/Events.ts"],"names":[],"mappings":"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"}

package/dist/neutral/Events/index.d.ts

@@ -1,2 +0,0 @@
-export * from './Events.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/neutral/Events/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Events/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA"}

package/dist/neutral/model/Event.d.ts

@@ -1,21 +0,0 @@
-import type { Promisable } from '@xylabs/promise';
-/** A valid event name, which can be any property key (string, number, or symbol). */
-export type EventName = PropertyKey;
-/** The allowed type for event argument payloads. */
-export type EventArgs = unknown;
-/** A mapping of event names to their corresponding event argument types. */
-export type EventData = object;
-/** A function returned by event subscription methods that unsubscribes the listener when called. */
-export type EventUnsubscribeFunction = () => void;
-/**
- * A listener that receives all events regardless of name.
- * @param eventName - The name of the emitted event.
- * @param eventData - The data associated with the event.
- */
-export type EventAnyListener<TEventArgs extends EventArgs = EventArgs> = (eventName: EventName, eventData: TEventArgs) => Promisable<void>;
-/**
- * A listener for a specific event type.
- * @param eventData - The data associated with the event.
- */
-export type EventListener<TEventArgs extends EventArgs = EventArgs> = (eventData: TEventArgs) => Promisable<void>;
-//# sourceMappingURL=Event.d.ts.map

package/dist/neutral/model/Event.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Event.d.ts","sourceRoot":"","sources":["../../../src/model/Event.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,qFAAqF;AACrF,MAAM,MAAM,SAAS,GAAG,WAAW,CAAA;AAEnC,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,OAAO,CAAA;AAE/B,4EAA4E;AAC5E,MAAM,MAAM,SAAS,GAAG,MAAM,CAAA;AAE9B,oGAAoG;AACpG,MAAM,MAAM,wBAAwB,GAAG,MAAM,IAAI,CAAA;AAEjD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,UAAU,SAAS,SAAS,GAAG,SAAS,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,KAAK,UAAU,CAAC,IAAI,CAAC,CAAA;AAE1I;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,UAAU,SAAS,SAAS,GAAG,SAAS,IAAI,CAAC,SAAS,EAAE,UAAU,KAAK,UAAU,CAAC,IAAI,CAAC,CAAA"}

package/dist/neutral/model/EventEmitter.d.ts

@@ -1,25 +0,0 @@
-import type { EventAnyListener, EventData, EventListener, EventUnsubscribeFunction } from './Event.ts';
-/** Interface for a typed event emitter that supports subscribing, unsubscribing, and emitting events. */
-export interface EventEmitter<T extends EventData> {
-    /** Type-level reference to the event data shape for external type queries. */
-    eventData: T;
-    /** Removes all listeners for the specified event name(s). */
-    clearListeners(eventNames: keyof T | (keyof T)[]): void;
-    /** Emits an event, invoking all registered listeners concurrently. */
-    emit<TEventName extends keyof T>(eventName: TEventName, eventArgs: T[TEventName]): Promise<void>;
-    /** Emits an event, invoking all registered listeners sequentially in order. */
-    emitSerial<TEventName extends keyof T>(eventName: TEventName, eventArgs: T[TEventName]): Promise<void>;
-    /** Returns the total number of listeners registered for the specified event name(s). */
-    listenerCount(eventNames: keyof T | (keyof T)[]): number;
-    /** Removes a specific listener from the specified event name(s). */
-    off<TEventName extends keyof T>(eventNames: TEventName | TEventName[], listener: EventListener<T[TEventName]>): void;
-    /** Removes a wildcard listener that was receiving all events. */
-    offAny(listener: EventAnyListener | Promise<void>): void;
-    /** Subscribes a listener to the specified event name(s) and returns an unsubscribe function. */
-    on<TEventName extends keyof T>(eventNames: TEventName | TEventName[], listener: EventListener<T[TEventName]>): EventUnsubscribeFunction;
-    /** Subscribes a wildcard listener that receives all events and returns an unsubscribe function. */
-    onAny(listener: EventAnyListener): EventUnsubscribeFunction;
-    /** Subscribes a listener that will be invoked only once for the specified event, then automatically removed. */
-    once<TEventName extends keyof T>(eventName: TEventName, listener: EventListener<T[TEventName]>): EventUnsubscribeFunction;
-}
-//# sourceMappingURL=EventEmitter.d.ts.map

package/dist/neutral/model/EventEmitter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../../src/model/EventEmitter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,wBAAwB,EACrE,MAAM,YAAY,CAAA;AAEnB,yGAAyG;AACzG,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,SAAS;IAC/C,8EAA8E;IAC9E,SAAS,EAAE,CAAC,CAAA;IACZ,6DAA6D;IAC7D,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI,CAAA;IACvD,sEAAsE;IACtE,IAAI,CAAC,UAAU,SAAS,MAAM,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChG,+EAA+E;IAC/E,UAAU,CAAC,UAAU,SAAS,MAAM,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtG,wFAAwF;IACxF,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,MAAM,CAAA;IACxD,oEAAoE;IACpE,GAAG,CAAC,UAAU,SAAS,MAAM,CAAC,EAAE,UAAU,EAAE,UAAU,GAAG,UAAU,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAA;IACpH,iEAAiE;IACjE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACxD,gGAAgG;IAChG,EAAE,CAAC,UAAU,SAAS,MAAM,CAAC,EAC3B,UAAU,EAAE,UAAU,GAAG,UAAU,EAAE,EACrC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GACrC,wBAAwB,CAAA;IAC3B,mGAAmG;IACnG,KAAK,CAAC,QAAQ,EAAE,gBAAgB,GAAG,wBAAwB,CAAA;IAC3D,gHAAgH;IAChH,IAAI,CAAC,UAAU,SAAS,MAAM,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,wBAAwB,CAAA;CAC1H"}

package/dist/neutral/model/index.d.ts

@@ -1,3 +0,0 @@
-export * from './Event.ts';
-export * from './EventEmitter.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/neutral/model/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/model/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA"}