commandkit 1.0.0-dev.20250529020123 → 1.0.0-dev.20250530015910

package/dist/EventInterceptor-D_oEWSnF.d.ts

@@ -0,0 +1,84 @@
+import { Awaitable, Client, ClientEvents } from "discord.js";
+
+//#region src/components/common/EventInterceptor.d.ts
+interface EventInterceptorContextData<E extends keyof ClientEvents> {
+  /**
+   * The filter to use for the collector.
+   */
+  filter?: (...args: ClientEvents[E]) => Awaitable<boolean>;
+  /**
+   * The duration (in ms) that the collector should run for.
+   */
+  time?: number;
+  /**
+   * If the collector should automatically reset the timer when a button is clicked.
+   */
+  autoReset?: boolean;
+  /**
+   * Whether the collector should run only once.
+   */
+  once?: boolean;
+  /**
+   * The handler to run when the collector ends.
+   */
+  onEnd?: (reason: string) => Awaitable<void>;
+  /**
+   * The handler to run upon an error.
+   */
+  onError?: EventInterceptorErrorHandler;
+}
+type EventInterceptorErrorHandler = (error: Error) => Awaitable<void>;
+declare class EventInterceptor {
+  #private;
+  readonly client: Client;
+  private subscribers;
+  private globalHandlers;
+  private cleanupTimer;
+  /**
+   * Creates the event interceptor.
+   */
+  constructor(client: Client);
+  /**
+   * Destroys the event interceptor.
+   */
+  destroy(): void;
+  /**
+   * Whether the event has subscribers.
+   * @param event The event to check.
+   */
+  hasSubscribers(event: keyof ClientEvents): boolean;
+  /**
+   * Returns the number of subscribers for the event.
+   * @param event The event to check.
+   */
+  getSubscriberCount(event: keyof ClientEvents): number;
+  /**
+   * Whether the event has global handlers.
+   */
+  hasGlobalHandlers(): boolean;
+  /**
+   * Returns the number of global handlers.
+   */
+  getGlobalHandlersCount(): number;
+  /**
+   * Subscribes to an event.
+   * @param event The event to subscribe to.
+   * @param listener The listener to call when the event is emitted.
+   * @returns A function to unsubscribe from the event.
+   */
+  subscribe<Event extends keyof ClientEvents>(event: Event, listener: (...args: ClientEvents[Event]) => void, options?: EventInterceptorContextData<Event>): () => void;
+  /**
+   * Unsubscribes from an event.
+   * @param event The event to unsubscribe from.
+   */
+  unsubscribe<Event extends keyof ClientEvents>(event: Event, listener: (...args: ClientEvents[Event]) => void, reason?: string): void;
+  /**
+   * Creates a global handler for the event.
+   * @param event The event to create a global handler for.
+   * @returns The global handler.
+   */
+  private createGlobalHandler;
+}
+//#endregion
+export { EventInterceptor, EventInterceptorContextData, EventInterceptorErrorHandler };
+//# sourceMappingURL=EventInterceptor-D_oEWSnF.d.ts.map

package/dist/EventInterceptor-DtRINyTP.js

@@ -0,0 +1,140 @@
+
+//#region src/components/common/EventInterceptor.ts
+var EventInterceptor = class {
+	subscribers = new Map();
+	globalHandlers = new Map();
+	cleanupTimer = null;
+	/**
+	* Creates the event interceptor.
+	*/
+	constructor(client) {
+		this.client = client;
+		this.#cleanupLoop();
+	}
+	#cleanupLoop() {
+		if (this.cleanupTimer) clearInterval(this.cleanupTimer);
+		this.cleanupTimer = setInterval(() => {
+			for (const [event, handlers] of this.subscribers) for (const handler of handlers) {
+				const options = Reflect.get(handler, "options");
+				const isExpired = options.time && Date.now() - options.registeredAt > options.time;
+				if (isExpired) this.unsubscribe(event, handler, "time");
+			}
+		}, 6e4).unref();
+	}
+	/**
+	* Destroys the event interceptor.
+	*/
+	destroy() {
+		if (this.cleanupTimer) {
+			clearInterval(this.cleanupTimer);
+			this.cleanupTimer = null;
+		}
+		for (const [event, handlers] of this.subscribers) for (const handler of handlers) this.unsubscribe(event, handler, "destroy");
+		this.subscribers.clear();
+		this.globalHandlers.clear();
+	}
+	/**
+	* Whether the event has subscribers.
+	* @param event The event to check.
+	*/
+	hasSubscribers(event) {
+		return this.subscribers.has(event);
+	}
+	/**
+	* Returns the number of subscribers for the event.
+	* @param event The event to check.
+	*/
+	getSubscriberCount(event) {
+		const handlers = this.subscribers.get(event);
+		return (handlers === null || handlers === void 0 ? void 0 : handlers.size) ?? 0;
+	}
+	/**
+	* Whether the event has global handlers.
+	*/
+	hasGlobalHandlers() {
+		return this.globalHandlers.size > 0;
+	}
+	/**
+	* Returns the number of global handlers.
+	*/
+	getGlobalHandlersCount() {
+		return this.subscribers.size;
+	}
+	/**
+	* Subscribes to an event.
+	* @param event The event to subscribe to.
+	* @param listener The listener to call when the event is emitted.
+	* @returns A function to unsubscribe from the event.
+	*/
+	subscribe(event, listener, options) {
+		if (!this.subscribers.has(event)) {
+			this.subscribers.set(event, new Set());
+			this.client.on(event, this.createGlobalHandler(event));
+			this.client.setMaxListeners(this.client.getMaxListeners() + 1);
+		}
+		options ??= {};
+		options.registeredAt = Date.now();
+		Reflect.set(listener, "options", options);
+		this.subscribers.get(event).add(listener);
+		return () => {
+			this.unsubscribe(event, listener);
+		};
+	}
+	/**
+	* Unsubscribes from an event.
+	* @param event The event to unsubscribe from.
+	*/
+	unsubscribe(event, listener, reason) {
+		var _Reflect$get$onEnd, _Reflect$get;
+		const handlers = this.subscribers.get(event);
+		if (!handlers) return;
+		handlers.delete(listener);
+		if (handlers.size < 1) {
+			this.subscribers.delete(event);
+			this.client.removeListener(event, this.globalHandlers.get(event));
+			this.globalHandlers.delete(event);
+			this.client.setMaxListeners(Math.max(this.client.getMaxListeners() - 1, 0));
+		}
+		(_Reflect$get$onEnd = (_Reflect$get = Reflect.get(listener, "options")).onEnd) === null || _Reflect$get$onEnd === void 0 || _Reflect$get$onEnd.call(_Reflect$get, reason ?? "unsubscribe");
+	}
+	/**
+	* Creates a global handler for the event.
+	* @param event The event to create a global handler for.
+	* @returns The global handler.
+	*/
+	createGlobalHandler(event) {
+		if (this.globalHandlers.has(event)) return this.globalHandlers.get(event);
+		const handler = async (...args) => {
+			const subscribers = this.subscribers.get(event);
+			if (subscribers && subscribers.size > 0) for (const subscriber of subscribers) {
+				const options = Reflect.get(subscriber, "options");
+				const isExpired = options.time && Date.now() - options.registeredAt > options.time;
+				if (isExpired) {
+					this.unsubscribe(event, subscriber, "time");
+					continue;
+				}
+				if (options.autoReset) options.registeredAt = Date.now();
+				if (options.filter && !await options.filter(...args)) continue;
+				try {
+					await subscriber(...args);
+				} catch (e) {
+					if (options.onError) await options.onError(e);
+					else throw e;
+				} finally {
+					if (options.once) this.unsubscribe(event, subscriber, "once");
+				}
+			}
+		};
+		this.globalHandlers.set(event, handler);
+		return handler;
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'EventInterceptor', {
+  enumerable: true,
+  get: function () {
+    return EventInterceptor;
+  }
+});
+//# sourceMappingURL=EventInterceptor-DtRINyTP.js.map

package/dist/EventInterceptor-DtRINyTP.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventInterceptor-DtRINyTP.js","names":[],"sources":["../src/components/common/EventInterceptor.ts"],"sourcesContent":["import { Awaitable, Client, ClientEvents, Events } from 'discord.js';\n\nexport interface EventInterceptorContextData<E extends keyof ClientEvents> {\n  /**\n   * The filter to use for the collector.\n   */\n  filter?: (...args: ClientEvents[E]) => Awaitable<boolean>;\n  /**\n   * The duration (in ms) that the collector should run for.\n   */\n  time?: number;\n  /**\n   * If the collector should automatically reset the timer when a button is clicked.\n   */\n  autoReset?: boolean;\n  /**\n   * Whether the collector should run only once.\n   */\n  once?: boolean;\n  /**\n   * The handler to run when the collector ends.\n   */\n  onEnd?: (reason: string) => Awaitable<void>;\n  /**\n   * The handler to run upon an error.\n   */\n  onError?: EventInterceptorErrorHandler;\n}\n\nexport type EventInterceptorErrorHandler = (error: Error) => Awaitable<void>;\n\nexport class EventInterceptor {\n  private subscribers = new Map<\n    keyof ClientEvents,\n    Set<(...args: any[]) => void>\n  >();\n  private globalHandlers = new Map<\n    keyof ClientEvents,\n    (...args: any[]) => void\n  >();\n  private cleanupTimer: NodeJS.Timeout | null = null;\n\n  /**\n   * Creates the event interceptor.\n   */\n  public constructor(public readonly client: Client) {\n    this.#cleanupLoop();\n  }\n\n  #cleanupLoop() {\n    if (this.cleanupTimer) clearInterval(this.cleanupTimer);\n\n    this.cleanupTimer = setInterval(() => {\n      for (const [event, handlers] of this.subscribers) {\n        for (const handler of handlers) {\n          const options = Reflect.get(\n            handler,\n            'options',\n          ) as EventInterceptorContextData<keyof ClientEvents> & {\n            registeredAt: number;\n          };\n\n          const isExpired =\n            options.time && Date.now() - options.registeredAt > options.time;\n\n          if (isExpired) {\n            this.unsubscribe(event, handler, 'time');\n          }\n        }\n      }\n    }, 60_000).unref();\n  }\n\n  /**\n   * Destroys the event interceptor.\n   */\n  public destroy(): void {\n    if (this.cleanupTimer) {\n      clearInterval(this.cleanupTimer);\n      this.cleanupTimer = null;\n    }\n\n    for (const [event, handlers] of this.subscribers) {\n      for (const handler of handlers) {\n        this.unsubscribe(event, handler, 'destroy');\n      }\n    }\n\n    this.subscribers.clear();\n    this.globalHandlers.clear();\n  }\n\n  /**\n   * Whether the event has subscribers.\n   * @param event The event to check.\n   */\n  public hasSubscribers(event: keyof ClientEvents): boolean {\n    return this.subscribers.has(event);\n  }\n\n  /**\n   * Returns the number of subscribers for the event.\n   * @param event The event to check.\n   */\n  public getSubscriberCount(event: keyof ClientEvents): number {\n    const handlers = this.subscribers.get(event);\n    return handlers?.size ?? 0;\n  }\n\n  /**\n   * Whether the event has global handlers.\n   */\n  public hasGlobalHandlers(): boolean {\n    return this.globalHandlers.size > 0;\n  }\n\n  /**\n   * Returns the number of global handlers.\n   */\n  public getGlobalHandlersCount(): number {\n    return this.subscribers.size;\n  }\n\n  /**\n   * Subscribes to an event.\n   * @param event The event to subscribe to.\n   * @param listener The listener to call when the event is emitted.\n   * @returns A function to unsubscribe from the event.\n   */\n  public subscribe<Event extends keyof ClientEvents>(\n    event: Event,\n    listener: (...args: ClientEvents[Event]) => void,\n    options?: EventInterceptorContextData<Event>,\n  ): () => void {\n    if (!this.subscribers.has(event)) {\n      this.subscribers.set(event, new Set());\n      this.client.on(event, this.createGlobalHandler(event));\n      this.client.setMaxListeners(this.client.getMaxListeners() + 1);\n    }\n\n    options ??= {};\n\n    // @ts-ignore\n    options.registeredAt = Date.now();\n\n    Reflect.set(listener, 'options', options);\n\n    this.subscribers.get(event)!.add(listener);\n\n    return () => {\n      this.unsubscribe(event, listener);\n    };\n  }\n\n  /**\n   * Unsubscribes from an event.\n   * @param event The event to unsubscribe from.\n   */\n  public unsubscribe<Event extends keyof ClientEvents>(\n    event: Event,\n    listener: (...args: ClientEvents[Event]) => void,\n    reason?: string,\n  ): void {\n    const handlers = this.subscribers.get(event);\n    if (!handlers) return;\n\n    handlers.delete(listener);\n\n    if (handlers.size < 1) {\n      this.subscribers.delete(event);\n      this.client.removeListener(event, this.globalHandlers.get(event)!);\n      this.globalHandlers.delete(event);\n      this.client.setMaxListeners(\n        Math.max(this.client.getMaxListeners() - 1, 0),\n      );\n    }\n\n    Reflect.get(listener, 'options').onEnd?.(reason ?? 'unsubscribe');\n  }\n\n  /**\n   * Creates a global handler for the event.\n   * @param event The event to create a global handler for.\n   * @returns The global handler.\n   */\n  private createGlobalHandler<Event extends keyof ClientEvents>(\n    event: Event,\n  ): (...args: ClientEvents[Event]) => void {\n    if (this.globalHandlers.has(event)) {\n      return this.globalHandlers.get(event)!;\n    }\n\n    const handler = async (...args: ClientEvents[Event]) => {\n      const subscribers = this.subscribers.get(event);\n      if (subscribers && subscribers.size > 0) {\n        for (const subscriber of subscribers) {\n          const options = Reflect.get(\n            subscriber,\n            'options',\n          ) as EventInterceptorContextData<Event> & { registeredAt: number };\n\n          const isExpired =\n            options.time && Date.now() - options.registeredAt > options.time;\n\n          if (isExpired) {\n            this.unsubscribe(event, subscriber, 'time');\n            continue;\n          }\n\n          if (options.autoReset) {\n            options.registeredAt = Date.now();\n          }\n\n          if (options.filter && !(await options.filter(...args))) {\n            continue;\n          }\n\n          try {\n            await subscriber(...args);\n          } catch (e) {\n            if (options.onError) {\n              await options.onError(<Error>e);\n            } else {\n              throw e;\n            }\n          } finally {\n            if (options.once) {\n              this.unsubscribe(event, subscriber, 'once');\n            }\n          }\n        }\n      }\n    };\n\n    this.globalHandlers.set(event, handler);\n\n    return handler;\n  }\n}\n"],"mappings":"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"}

package/dist/EventWorkerContext-C0e23GNY.d.ts

@@ -0,0 +1,19 @@
+import { CommandKit } from "./CommandKit-CDlCsGCx.js";
+import { ParsedEvent } from "./EventsRouter-BacqK6z3.js";
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/app/events/EventWorkerContext.d.ts
+interface EventWorkerContext {
+  event: string;
+  namespace: string | null;
+  data: ParsedEvent;
+  commandkit: CommandKit;
+  arguments: any[];
+}
+declare const eventWorkerContext: AsyncLocalStorage<EventWorkerContext>;
+declare function runInEventWorkerContext<T>(context: EventWorkerContext, callback: () => T): T;
+declare function getEventWorkerContext(): EventWorkerContext;
+declare function isEventWorkerContext(worker: any): worker is EventWorkerContext;
+//#endregion
+export { EventWorkerContext, eventWorkerContext, getEventWorkerContext, isEventWorkerContext, runInEventWorkerContext };
+//# sourceMappingURL=EventWorkerContext-C0e23GNY.d.ts.map

package/dist/EventWorkerContext-XZGSHn5F.js

@@ -0,0 +1,45 @@
+const require_chunk = require('./chunk-nOFOJqeH.js');
+const node_async_hooks = require_chunk.__toESM(require("node:async_hooks"));
+
+//#region src/app/events/EventWorkerContext.ts
+const kEventWorker = Symbol("commandkitEventWorker");
+const eventWorkerContext = new node_async_hooks.AsyncLocalStorage();
+function runInEventWorkerContext(context, callback) {
+	Reflect.set(context, kEventWorker, true);
+	return eventWorkerContext.run(context, callback);
+}
+function getEventWorkerContext() {
+	const context = eventWorkerContext.getStore();
+	if (!context) throw new Error("Event worker context not found");
+	return context;
+}
+function isEventWorkerContext(worker) {
+	return worker && Reflect.get(worker, kEventWorker) === true;
+}
+
+//#endregion
+Object.defineProperty(exports, 'eventWorkerContext', {
+  enumerable: true,
+  get: function () {
+    return eventWorkerContext;
+  }
+});
+Object.defineProperty(exports, 'getEventWorkerContext', {
+  enumerable: true,
+  get: function () {
+    return getEventWorkerContext;
+  }
+});
+Object.defineProperty(exports, 'isEventWorkerContext', {
+  enumerable: true,
+  get: function () {
+    return isEventWorkerContext;
+  }
+});
+Object.defineProperty(exports, 'runInEventWorkerContext', {
+  enumerable: true,
+  get: function () {
+    return runInEventWorkerContext;
+  }
+});
+//# sourceMappingURL=EventWorkerContext-XZGSHn5F.js.map

package/dist/EventWorkerContext-XZGSHn5F.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventWorkerContext-XZGSHn5F.js","names":[],"sources":["../src/app/events/EventWorkerContext.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport { ParsedEvent } from '../router';\nimport { CommandKit } from '../../CommandKit';\n\nexport interface EventWorkerContext {\n  event: string;\n  namespace: string | null;\n  data: ParsedEvent;\n  commandkit: CommandKit;\n  arguments: any[];\n}\n\nconst kEventWorker = Symbol('commandkitEventWorker');\n\nexport const eventWorkerContext = new AsyncLocalStorage<EventWorkerContext>();\n\nexport function runInEventWorkerContext<T>(\n  context: EventWorkerContext,\n  callback: () => T,\n): T {\n  Reflect.set(context, kEventWorker, true);\n\n  return eventWorkerContext.run(context, callback);\n}\n\nexport function getEventWorkerContext(): EventWorkerContext {\n  const context = eventWorkerContext.getStore();\n\n  if (!context) {\n    throw new Error('Event worker context not found');\n  }\n\n  return context;\n}\n\nexport function isEventWorkerContext(\n  worker: any,\n): worker is EventWorkerContext {\n  return worker && Reflect.get(worker, kEventWorker) === true;\n}\n"],"mappings":";;;;AAYA,MAAM,eAAe,OAAO,wBAAwB;AAEpD,MAAa,qBAAqB,IAAI;AAEtC,SAAgB,wBAChB,SACA,UACI;AACF,SAAQ,IAAI,SAAS,cAAc,KAAK;AAExC,QAAO,mBAAmB,IAAI,SAAS,SAAS;AAClD;AAEA,SAAgB,wBAA4C;CAC1D,MAAM,UAAU,mBAAmB,UAAU;AAE7C,MAAK,QACH,OAAM,IAAI,MAAM;AAGlB,QAAO;AACT;AAEA,SAAgB,qBAChB,QAC+B;AAC7B,QAAO,UAAU,QAAQ,IAAI,QAAQ,aAAa,KAAK;AACzD"}

package/dist/EventsRouter-BacqK6z3.d.ts

@@ -0,0 +1,90 @@
+//#region src/app/router/EventsRouter.d.ts
+/**
+ * Configuration options for the EventsRouter
+ * @interface EventsRouterOptions
+ */
+interface EventsRouterOptions {
+  /** Root directory path where event handlers are located */
+  entrypoints: string[];
+}
+/**
+ * Represents a parsed event with its handlers
+ * @interface ParsedEvent
+ */
+interface ParsedEvent {
+  /** Name of the event derived from directory name */
+  event: string;
+  /** Absolute path to the event directory */
+  path: string;
+  /** Array of file paths to event listener handlers */
+  listeners: string[];
+  /** Namespace of the event */
+  namespace: string | null;
+}
+/** Collection of event names to their parsed metadata */
+type EventsTree = Record<string, ParsedEvent>;
+/**
+ * Router for discovering and managing event handler files in a directory structure.
+ * Events are represented by directories, and handlers are files within those directories.
+ */
+declare class EventsRouter {
+  private options;
+  /** Internal storage of parsed events */
+  private events;
+  /**
+   * Creates a new EventsRouter instance
+   * @param options - Configuration options for the router
+   * @throws Error if entrypoint is not provided
+   */
+  constructor(options: EventsRouterOptions);
+  /**
+   * Adds new entrypoints to the router
+   * @param entrypoints - Array of new entrypoint paths
+   */
+  addEntrypoints(entrypoints: string[]): void;
+  /**
+   * Find a parsed event by its name
+   * @param event - Name of the event to find
+   * @returns Parsed event metadata or null if not found
+   */
+  match(event: string): ParsedEvent | null;
+  /**
+   * Get the entrypoint directory path
+   * @returns Entrypoint directory path
+   */
+  get entrypoints(): string[];
+  /**
+   * Checks if the entrypoint path is valid
+   */
+  isValidPath(): boolean;
+  /**
+   * Clear all parsed events
+   */
+  clear(): void;
+  /**
+   * Reload and re-scan the entrypoint directory for events
+   * @returns Promise resolving to the updated events tree
+   */
+  reload(): Promise<EventsTree>;
+  /**
+   * Scan the entrypoint directory for events and their handlers
+   * @returns Promise resolving to the events tree
+   */
+  scan(): Promise<EventsTree>;
+  /**
+   * Convert the internal events Collection to a plain object
+   * @returns Events tree as a plain object
+   */
+  toJSON(): EventsTree;
+  /**
+   * Recursively scan a directory for event handlers
+   * @param event - Name of the event
+   * @param path - Path to the event directory
+   * @param listeners - Array to collect listener file paths
+   * @returns Promise resolving to the parsed event metadata
+   */
+  private scanEvent;
+}
+//#endregion
+export { EventsRouter, EventsRouterOptions, EventsTree, ParsedEvent };
+//# sourceMappingURL=EventsRouter-BacqK6z3.d.ts.map

package/dist/EventsRouter-CqnrlbjN.js

@@ -0,0 +1,133 @@
+const require_chunk = require('./chunk-nOFOJqeH.js');
+const discord_js = require_chunk.__toESM(require("discord.js"));
+const node_fs = require_chunk.__toESM(require("node:fs"));
+const node_path = require_chunk.__toESM(require("node:path"));
+const node_fs_promises = require_chunk.__toESM(require("node:fs/promises"));
+
+//#region src/app/router/EventsRouter.ts
+/**
+* Router for discovering and managing event handler files in a directory structure.
+* Events are represented by directories, and handlers are files within those directories.
+*/
+var EventsRouter = class {
+	/** Internal storage of parsed events */
+	events = new discord_js.Collection();
+	/**
+	* Creates a new EventsRouter instance
+	* @param options - Configuration options for the router
+	* @throws Error if entrypoint is not provided
+	*/
+	constructor(options) {
+		var _options$entrypoints;
+		this.options = options;
+		if (options.entrypoints) options.entrypoints = Array.from(new Set(options.entrypoints));
+		if (!((_options$entrypoints = options.entrypoints) === null || _options$entrypoints === void 0 ? void 0 : _options$entrypoints.length)) throw new Error("Entrypoint directory must be provided");
+	}
+	/**
+	* Adds new entrypoints to the router
+	* @param entrypoints - Array of new entrypoint paths
+	*/
+	addEntrypoints(entrypoints) {
+		this.options.entrypoints = Array.from(new Set([...this.options.entrypoints, ...entrypoints]));
+	}
+	/**
+	* Find a parsed event by its name
+	* @param event - Name of the event to find
+	* @returns Parsed event metadata or null if not found
+	*/
+	match(event) {
+		return this.events.get(event) ?? null;
+	}
+	/**
+	* Get the entrypoint directory path
+	* @returns Entrypoint directory path
+	*/
+	get entrypoints() {
+		return this.options.entrypoints;
+	}
+	/**
+	* Checks if the entrypoint path is valid
+	*/
+	isValidPath() {
+		return this.entrypoints.every((entrypoint) => (0, node_fs.existsSync)(entrypoint));
+	}
+	/**
+	* Clear all parsed events
+	*/
+	clear() {
+		this.events.clear();
+	}
+	/**
+	* Reload and re-scan the entrypoint directory for events
+	* @returns Promise resolving to the updated events tree
+	*/
+	async reload() {
+		this.clear();
+		return this.scan();
+	}
+	/**
+	* Scan the entrypoint directory for events and their handlers
+	* @returns Promise resolving to the events tree
+	*/
+	async scan() {
+		for (const entrypoint of this.entrypoints) {
+			const dirs = await (0, node_fs_promises.readdir)(entrypoint, { withFileTypes: true });
+			for (const dir of dirs) if (dir.isDirectory()) {
+				const path = (0, node_path.join)(entrypoint, dir.name);
+				await this.scanEvent(dir.name, path, null, [], true);
+			}
+		}
+		return Object.fromEntries(this.events);
+	}
+	/**
+	* Convert the internal events Collection to a plain object
+	* @returns Events tree as a plain object
+	*/
+	toJSON() {
+		return Object.fromEntries(this.events);
+	}
+	/**
+	* Recursively scan a directory for event handlers
+	* @param event - Name of the event
+	* @param path - Path to the event directory
+	* @param listeners - Array to collect listener file paths
+	* @returns Promise resolving to the parsed event metadata
+	*/
+	async scanEvent(event, path, _namespace = null, listeners = [], isRoot = false) {
+		const files = await (0, node_fs_promises.readdir)(path, { withFileTypes: true });
+		const isNamespace = isRoot && /^\(.+\)$/.test(event);
+		const namespace = isNamespace ? event.slice(1, -1) : _namespace ?? null;
+		files.sort((a, b) => a.name.localeCompare(b.name));
+		for (const file of files) {
+			if (file.name.startsWith("_")) continue;
+			if (file.isDirectory()) {
+				const nextPath = (0, node_path.join)(path, file.name);
+				await this.scanEvent(file.name, nextPath, namespace, listeners);
+				continue;
+			}
+			if (file.isFile() && /\.(m|c)?(j|t)sx?$/.test(file.name)) listeners.push((0, node_path.join)(file.parentPath, file.name));
+		}
+		if (!isNamespace) {
+			const existing = this.events.get(event);
+			if (existing) {
+				existing.listeners = Array.from(new Set([...existing.listeners, ...listeners]));
+				return;
+			}
+			this.events.set(event, {
+				event,
+				path,
+				listeners,
+				namespace
+			});
+		}
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'EventsRouter', {
+  enumerable: true,
+  get: function () {
+    return EventsRouter;
+  }
+});
+//# sourceMappingURL=EventsRouter-CqnrlbjN.js.map

package/dist/EventsRouter-CqnrlbjN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventsRouter-CqnrlbjN.js","names":[],"sources":["../src/app/router/EventsRouter.ts"],"sourcesContent":["import { Collection } from 'discord.js';\nimport { existsSync } from 'node:fs';\nimport { readdir } from 'node:fs/promises';\nimport { join } from 'node:path';\n\n/**\n * Configuration options for the EventsRouter\n * @interface EventsRouterOptions\n */\nexport interface EventsRouterOptions {\n  /** Root directory path where event handlers are located */\n  entrypoints: string[];\n}\n\n/**\n * Represents a parsed event with its handlers\n * @interface ParsedEvent\n */\nexport interface ParsedEvent {\n  /** Name of the event derived from directory name */\n  event: string;\n  /** Absolute path to the event directory */\n  path: string;\n  /** Array of file paths to event listener handlers */\n  listeners: string[];\n  /** Namespace of the event */\n  namespace: string | null;\n}\n\n/** Collection of event names to their parsed metadata */\nexport type EventsTree = Record<string, ParsedEvent>;\n\n/**\n * Router for discovering and managing event handler files in a directory structure.\n * Events are represented by directories, and handlers are files within those directories.\n */\nexport class EventsRouter {\n  /** Internal storage of parsed events */\n  private events = new Collection<string, ParsedEvent>();\n\n  /**\n   * Creates a new EventsRouter instance\n   * @param options - Configuration options for the router\n   * @throws Error if entrypoint is not provided\n   */\n  public constructor(private options: EventsRouterOptions) {\n    if (options.entrypoints) {\n      options.entrypoints = Array.from(new Set(options.entrypoints));\n    }\n\n    if (!options.entrypoints?.length) {\n      throw new Error('Entrypoint directory must be provided');\n    }\n  }\n\n  /**\n   * Adds new entrypoints to the router\n   * @param entrypoints - Array of new entrypoint paths\n   */\n  public addEntrypoints(entrypoints: string[]) {\n    this.options.entrypoints = Array.from(\n      new Set([...this.options.entrypoints, ...entrypoints]),\n    );\n  }\n\n  /**\n   * Find a parsed event by its name\n   * @param event - Name of the event to find\n   * @returns Parsed event metadata or null if not found\n   */\n  public match(event: string): ParsedEvent | null {\n    return this.events.get(event) ?? null;\n  }\n\n  /**\n   * Get the entrypoint directory path\n   * @returns Entrypoint directory path\n   */\n  public get entrypoints(): string[] {\n    return this.options.entrypoints;\n  }\n\n  /**\n   * Checks if the entrypoint path is valid\n   */\n  public isValidPath() {\n    return this.entrypoints.every((entrypoint) => existsSync(entrypoint));\n  }\n\n  /**\n   * Clear all parsed events\n   */\n  public clear() {\n    this.events.clear();\n  }\n\n  /**\n   * Reload and re-scan the entrypoint directory for events\n   * @returns Promise resolving to the updated events tree\n   */\n  public async reload() {\n    this.clear();\n    return this.scan();\n  }\n\n  /**\n   * Scan the entrypoint directory for events and their handlers\n   * @returns Promise resolving to the events tree\n   */\n  public async scan(): Promise<EventsTree> {\n    for (const entrypoint of this.entrypoints) {\n      const dirs = await readdir(entrypoint, { withFileTypes: true });\n\n      for (const dir of dirs) {\n        if (dir.isDirectory()) {\n          const path = join(entrypoint, dir.name);\n          await this.scanEvent(dir.name, path, null, [], true);\n        }\n      }\n    }\n\n    return Object.fromEntries(this.events);\n  }\n\n  /**\n   * Convert the internal events Collection to a plain object\n   * @returns Events tree as a plain object\n   */\n  public toJSON(): EventsTree {\n    return Object.fromEntries(this.events);\n  }\n\n  /**\n   * Recursively scan a directory for event handlers\n   * @param event - Name of the event\n   * @param path - Path to the event directory\n   * @param listeners - Array to collect listener file paths\n   * @returns Promise resolving to the parsed event metadata\n   */\n  private async scanEvent(\n    event: string,\n    path: string,\n    _namespace: string | null = null,\n    listeners: string[] = [],\n    isRoot = false,\n  ): Promise<void> {\n    const files = await readdir(path, { withFileTypes: true });\n    const isNamespace = isRoot && /^\\(.+\\)$/.test(event);\n\n    // if event = (something) pattern then namespace is something\n    const namespace = isNamespace ? event.slice(1, -1) : (_namespace ?? null);\n\n    files.sort((a, b) => a.name.localeCompare(b.name));\n\n    for (const file of files) {\n      if (file.name.startsWith('_')) continue;\n\n      if (file.isDirectory()) {\n        const nextPath = join(path, file.name);\n        await this.scanEvent(file.name, nextPath, namespace, listeners);\n        continue;\n      }\n\n      if (file.isFile() && /\\.(m|c)?(j|t)sx?$/.test(file.name)) {\n        listeners.push(join(file.parentPath, file.name));\n      }\n    }\n\n    if (!isNamespace) {\n      const existing = this.events.get(event);\n\n      if (existing) {\n        existing.listeners = Array.from(\n          new Set([...existing.listeners, ...listeners]),\n        );\n\n        return;\n      }\n\n      this.events.set(event, { event, path, listeners, namespace });\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;AAoCA,IAAa,eAAb,MAA0B;;CAExB,AAAQ,SAAS,IAAI;;;;;;CAOrB,AAAO,YAAoB,SAA8B;;EAA9B;AACzB,MAAI,QAAQ,YACV,SAAQ,cAAc,MAAM,KAAK,IAAI,IAAI,QAAQ,aAAa;AAGhE,gCAAK,QAAQ,yFAAa,QACxB,OAAM,IAAI,MAAM;CAEpB;;;;;CAMA,AAAO,eAAe,aAAuB;AAC3C,OAAK,QAAQ,cAAc,MAAM,KAC/B,IAAI,IAAI,CAAC,GAAG,KAAK,QAAQ,aAAa,GAAG,WAAY,GACtD;CACH;;;;;;CAOA,AAAO,MAAM,OAAmC;AAC9C,SAAO,KAAK,OAAO,IAAI,MAAM,IAAI;CACnC;;;;;CAMA,IAAW,cAAwB;AACjC,SAAO,KAAK,QAAQ;CACtB;;;;CAKA,AAAO,cAAc;AACnB,SAAO,KAAK,YAAY,MAAM,CAAC,eAAe,wBAAW,WAAW,CAAC;CACvE;;;;CAKA,AAAO,QAAQ;AACb,OAAK,OAAO,OAAO;CACrB;;;;;CAMA,MAAa,SAAS;AACpB,OAAK,OAAO;AACZ,SAAO,KAAK,MAAM;CACpB;;;;;CAMA,MAAa,OAA4B;AACvC,OAAK,MAAM,cAAc,KAAK,aAAa;GACzC,MAAM,OAAO,MAAM,8BAAQ,YAAY,EAAE,eAAe,KAAM,EAAC;AAE/D,QAAK,MAAM,OAAO,KAChB,KAAI,IAAI,aAAa,EAAE;IACrB,MAAM,OAAO,oBAAK,YAAY,IAAI,KAAK;AACvC,UAAM,KAAK,UAAU,IAAI,MAAM,MAAM,MAAM,CAAE,GAAE,KAAK;GACtD;EAEJ;AAEA,SAAO,OAAO,YAAY,KAAK,OAAO;CACxC;;;;;CAMA,AAAO,SAAqB;AAC1B,SAAO,OAAO,YAAY,KAAK,OAAO;CACxC;;;;;;;;CASA,MAAc,UACd,OACA,MACA,aAA4B,MAC5B,YAAsB,CAAE,GACxB,SAAS,OACO;EACd,MAAM,QAAQ,MAAM,8BAAQ,MAAM,EAAE,eAAe,KAAM,EAAC;EAC1D,MAAM,cAAc,UAAU,WAAW,KAAK,MAAM;EAGpD,MAAM,YAAY,cAAc,MAAM,MAAM,GAAG,GAAG,GAAG,cAAc;AAEnE,QAAM,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,CAAC;AAElD,OAAK,MAAM,QAAQ,OAAO;AACxB,OAAI,KAAK,KAAK,WAAW,IAAI,CAAE;AAE/B,OAAI,KAAK,aAAa,EAAE;IACtB,MAAM,WAAW,oBAAK,MAAM,KAAK,KAAK;AACtC,UAAM,KAAK,UAAU,KAAK,MAAM,UAAU,WAAW,UAAU;AAC/D;GACF;AAEA,OAAI,KAAK,QAAQ,IAAI,oBAAoB,KAAK,KAAK,KAAK,CACtD,WAAU,KAAK,oBAAK,KAAK,YAAY,KAAK,KAAK,CAAC;EAEpD;AAEA,OAAK,aAAa;GAChB,MAAM,WAAW,KAAK,OAAO,IAAI,MAAM;AAEvC,OAAI,UAAU;AACZ,aAAS,YAAY,MAAM,KACzB,IAAI,IAAI,CAAC,GAAG,SAAS,WAAW,GAAG,SAAU,GAC9C;AAED;GACF;AAEA,QAAK,OAAO,IAAI,OAAO;IAAE;IAAO;IAAM;IAAW;GAAW,EAAC;EAC/D;CACF;AACF"}

package/dist/ILogger-BTMQuall.d.ts

@@ -0,0 +1,11 @@
+//#region src/logger/ILogger.d.ts
+interface ILogger {
+  log(...args: any[]): void;
+  error(...args: any[]): void;
+  warn(...args: any[]): void;
+  info(...args: any[]): void;
+  debug(...args: any[]): void;
+}
+//#endregion
+export { ILogger };
+//# sourceMappingURL=ILogger-BTMQuall.d.ts.map

package/dist/Logger-A3wjB7L1.d.ts

@@ -0,0 +1,17 @@
+import { ILogger } from "./ILogger-BTMQuall.js";
+
+//#region src/logger/Logger.d.ts
+interface CommandKitLoggerOptions {
+  /**
+   * The logger provider to use.
+   */
+  provider: ILogger;
+}
+interface LoggerImpl extends ILogger {
+  configure(options: CommandKitLoggerOptions): void;
+}
+declare function createLogger(options: CommandKitLoggerOptions): LoggerImpl;
+declare const Logger: LoggerImpl;
+//#endregion
+export { CommandKitLoggerOptions, Logger, LoggerImpl, createLogger };
+//# sourceMappingURL=Logger-A3wjB7L1.d.ts.map

package/dist/MentionableSelectMenuKit-BiUSKUtZ.d.ts

@@ -0,0 +1,51 @@
+import { EventInterceptorErrorHandler } from "./EventInterceptor-D_oEWSnF.js";
+import { CommandKitSelectMenuBuilderInteractionCollectorDispatch, CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, CommandKitSelectMenuBuilderOnEnd, OnSelectMenuKitSubmit, SelectMenuKitPredicate } from "./common-pvPJVTfe.js";
+import { MentionableSelectMenuBuilder, MentionableSelectMenuInteraction } from "discord.js";
+
+//#region src/components/v1/select-menu/MentionableSelectMenuKit.d.ts
+type OnMentionableSelectMenuKitSubmit = OnSelectMenuKitSubmit<MentionableSelectMenuInteraction, MentionableSelectMenuKit>;
+type MentionableSelectMenuKitPredicate = SelectMenuKitPredicate<MentionableSelectMenuInteraction>;
+declare class MentionableSelectMenuKit extends MentionableSelectMenuBuilder {
+  #private;
+  /**
+   * Sets the handler to run when the modal is submitted.
+   * @param handler - The handler to run when the modal is submitted.
+   * @param data - The context data for the interaction collector.
+   * @returns This instance of the modal builder.
+   * @example
+   * ```ts
+   * const modal = new MentionableSelectMenuKit()
+   *  .setTitle('My Modal')
+   *  .setCustomId('my-modal')
+   *  .filter((interaction) => interaction.Mentionable.id === '1234567890')
+   *  .onSelect(async (interaction) => {
+   *     await interaction.reply('You submitted the modal!');
+   *   })
+   *   .addComponents(actionRow1, actionRow2);
+   * ```
+   */
+  onSelect(handler: CommandKitSelectMenuBuilderInteractionCollectorDispatch<MentionableSelectMenuInteraction, MentionableSelectMenuKit>, data?: CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData): this;
+  /**
+   * Sets the handler to run when the interaction collector ends.
+   * @param handler - The handler to run when the interaction collector ends.
+   * @returns This instance of the modal builder.
+   */
+  onEnd(handler: CommandKitSelectMenuBuilderOnEnd): this;
+  /**
+   * Sets the handler to run when the interaction collector ends.
+   * @param handler - The handler to run when the interaction collector ends.
+   * @returns This instance of the modal builder.
+   */
+  onError(handler: EventInterceptorErrorHandler): this;
+  /**
+   * Sets a filter for the interaction collector.
+   * @param predicate - The filter to use for the interaction collector.
+   * @returns This instance of the modal builder.
+   */
+  filter(predicate: SelectMenuKitPredicate<MentionableSelectMenuInteraction>): this;
+  private get customId();
+  dispose(): this;
+}
+//#endregion
+export { MentionableSelectMenuKit, MentionableSelectMenuKitPredicate, OnMentionableSelectMenuKitSubmit };
+//# sourceMappingURL=MentionableSelectMenuKit-BiUSKUtZ.d.ts.map