commandkit 1.0.0-dev.20250610125321 → 1.0.0-dev.20250611125312

package/dist/{CompilerPluginRuntime-C9wmPMQf.js → CompilerPluginRuntime-CgVU_gU0.js}

@@ -2,25 +2,49 @@ const require_chunk = require('./chunk-nOFOJqeH.js');
 const node_async_hooks = require_chunk.__toESM(require("node:async_hooks"));
 
 //#region src/plugins/plugin-runtime/CompilerPluginRuntime.ts
+/**
+* Enum representing the execution mode of a plugin.
+* It can be either 'activate' or 'deactivate'.
+* @private
+*/
 var PluginExecutionMode = /* @__PURE__ */ function(PluginExecutionMode$1) {
 	PluginExecutionMode$1["Activate"] = "activate";
 	PluginExecutionMode$1["Deactivate"] = "deactivate";
 	return PluginExecutionMode$1;
 }(PluginExecutionMode || {});
+/**
+* CompilerPluginRuntime is a runtime for managing compiler plugins in CommandKit.
+*/
 var CompilerPluginRuntime = class {
 	name = "CompilerPluginRuntime";
 	initialized = false;
 	templates = /* @__PURE__ */ new Map();
 	#pluginContext = new node_async_hooks.AsyncLocalStorage();
+	/**
+	* Creates a new instance of CompilerPluginRuntime.
+	* @param plugins An array of compiler plugins to be managed by this runtime.
+	*/
 	constructor(plugins) {
 		this.plugins = plugins;
 	}
+	/**
+	* Returns the plugins managed by this runtime.
+	*/
 	getPlugins() {
 		return this.plugins;
 	}
+	/**
+	* Checks if there are no plugins registered in this runtime.
+	*/
 	isEmpty() {
 		return !this.plugins.length;
 	}
+	/**
+	* Registers a template handler for a given name.
+	* This method must be called inside the activate() method of a plugin.
+	* @param name - The name of the template to register.
+	* @param handler - The handler function for the template.
+	*/
 	registerTemplate(name, handler) {
 		const ctx = this.#pluginContext.getStore();
 		if (!ctx || ctx.mode !== PluginExecutionMode.Activate) throw new Error("registerTemplate() must be called inside activate() method");
@@ -30,6 +54,11 @@ var CompilerPluginRuntime = class {
 			plugin: ctx.plugin
 		});
 	}
+	/**
+	* Unregisters a template handler for a given name.
+	* This method must be called inside the deactivate() method of a plugin.
+	* @param name - The name of the template to unregister.
+	*/
 	unregisterTemplate(name) {
 		const ctx = this.#pluginContext.getStore();
 		if (!ctx || ctx.mode !== PluginExecutionMode.Deactivate) throw new Error("unregisterTemplate() must be called inside deactivate() method");
@@ -38,13 +67,29 @@ var CompilerPluginRuntime = class {
 		if (template.plugin !== ctx.plugin) throw new Error(`Template "${name}" is owned by plugin "${template.plugin.name}" and cannot be unregistered by "${ctx.plugin.name}"`);
 		this.templates.delete(name);
 	}
+	/**
+	* Retrieves a template handler by its name.
+	* @param name - The name of the template to retrieve.
+	* @returns The template handler if found, otherwise undefined.
+	*/
 	getTemplate(name) {
 		var _this$templates$get;
 		return (_this$templates$get = this.templates.get(name)) === null || _this$templates$get === void 0 ? void 0 : _this$templates$get.handler;
 	}
+	/**
+	* Returns a map of all registered templates with their handlers.
+	* The keys are the template names and the values are the template handlers.
+	*/
 	getTemplates() {
 		return new Map(Array.from(this.templates.entries()).map(([name, entry]) => [name, entry.handler]));
 	}
+	/**
+	* Transforms the given code using all registered plugins.
+	* Each plugin's transform method is called in sequence, allowing them to modify the code.
+	* @param code - The code to be transformed.
+	* @param id - The identifier for the code being transformed (e.g., filename).
+	* @returns An object containing the transformed code and an optional source map.
+	*/
 	async transform(code, id) {
 		let map = null;
 		for (const plugin of this.plugins) try {
@@ -65,6 +110,10 @@ var CompilerPluginRuntime = class {
 			map
 		};
 	}
+	/**
+	* Initializes the plugin runtime by activating all registered plugins.
+	* This method should be called once to set up the plugins.
+	*/
 	async init() {
 		if (this.initialized) return;
 		for (const plugin of this.plugins) try {
@@ -80,6 +129,10 @@ var CompilerPluginRuntime = class {
 		}
 		this.initialized = true;
 	}
+	/**
+	* Destroys the plugin runtime by deactivating all registered plugins.
+	* This method should be called when the runtime is no longer needed.
+	*/
 	async destroy() {
 		if (!this.initialized) return;
 		for (const plugin of this.plugins) try {
@@ -95,6 +148,11 @@ var CompilerPluginRuntime = class {
 		}
 		this.initialized = false;
 	}
+	/**
+	* Converts the plugin runtime to a JSON representation.
+	* This is useful for serialization or debugging purposes.
+	* @returns An object containing the name of the runtime and the transform method.
+	*/
 	toJSON() {
 		return {
 			name: this.name,
@@ -110,4 +168,4 @@ Object.defineProperty(exports, 'CompilerPluginRuntime', {
     return CompilerPluginRuntime;
   }
 });
-//# sourceMappingURL=CompilerPluginRuntime-C9wmPMQf.js.map
+//# sourceMappingURL=CompilerPluginRuntime-CgVU_gU0.js.map

package/dist/CompilerPluginRuntime-CgVU_gU0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompilerPluginRuntime-CgVU_gU0.js","names":[],"sources":["../src/plugins/plugin-runtime/CompilerPluginRuntime.ts"],"sourcesContent":["import {\n  CompilerPlugin,\n  MaybeFalsey,\n  TransformedResult,\n  TemplateHandler,\n} from '..';\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\n/**\n * Interface representing a template entry in the plugin runtime.\n * It contains a handler function for the template and the plugin that owns it.\n * @private\n */\ninterface TemplateEntry {\n  handler: TemplateHandler;\n  plugin: CompilerPlugin;\n}\n\n/**\n * Enum representing the execution mode of a plugin.\n * It can be either 'activate' or 'deactivate'.\n * @private\n */\nenum PluginExecutionMode {\n  Activate = 'activate',\n  Deactivate = 'deactivate',\n}\n\n/**\n * Context for the plugin execution, containing the plugin and its execution mode.\n * This is used to manage the state of the plugin during activation and deactivation.\n * @private\n */\ntype PluginContext = {\n  plugin: CompilerPlugin;\n  mode: PluginExecutionMode;\n};\n\n/**\n * CompilerPluginRuntime is a runtime for managing compiler plugins in CommandKit.\n */\nexport class CompilerPluginRuntime {\n  public readonly name = 'CompilerPluginRuntime';\n  private initialized = false;\n  private templates = new Map<string, TemplateEntry>();\n  #pluginContext = new AsyncLocalStorage<PluginContext>();\n\n  /**\n   * Creates a new instance of CompilerPluginRuntime.\n   * @param plugins An array of compiler plugins to be managed by this runtime.\n   */\n  public constructor(private readonly plugins: CompilerPlugin[]) {}\n\n  /**\n   * Returns the plugins managed by this runtime.\n   */\n  public getPlugins() {\n    return this.plugins;\n  }\n\n  /**\n   * Checks if there are no plugins registered in this runtime.\n   */\n  public isEmpty() {\n    return !this.plugins.length;\n  }\n\n  /**\n   * Registers a template handler for a given name.\n   * This method must be called inside the activate() method of a plugin.\n   * @param name - The name of the template to register.\n   * @param handler - The handler function for the template.\n   */\n  public registerTemplate(name: string, handler: TemplateHandler) {\n    const ctx = this.#pluginContext.getStore();\n\n    if (!ctx || ctx.mode !== PluginExecutionMode.Activate) {\n      throw new Error(\n        'registerTemplate() must be called inside activate() method',\n      );\n    }\n\n    if (this.templates.has(name)) {\n      throw new Error(`Template \"${name}\" already exists`);\n    }\n\n    this.templates.set(name, { handler, plugin: ctx.plugin });\n  }\n\n  /**\n   * Unregisters a template handler for a given name.\n   * This method must be called inside the deactivate() method of a plugin.\n   * @param name - The name of the template to unregister.\n   */\n  public unregisterTemplate(name: string) {\n    const ctx = this.#pluginContext.getStore();\n\n    if (!ctx || ctx.mode !== PluginExecutionMode.Deactivate) {\n      throw new Error(\n        'unregisterTemplate() must be called inside deactivate() method',\n      );\n    }\n\n    const template = this.templates.get(name);\n    if (!template) {\n      throw new Error(`Template \"${name}\" does not exist`);\n    }\n\n    if (template.plugin !== ctx.plugin) {\n      throw new Error(\n        `Template \"${name}\" is owned by plugin \"${template.plugin.name}\" and cannot be unregistered by \"${ctx.plugin.name}\"`,\n      );\n    }\n\n    this.templates.delete(name);\n  }\n\n  /**\n   * Retrieves a template handler by its name.\n   * @param name - The name of the template to retrieve.\n   * @returns The template handler if found, otherwise undefined.\n   */\n  public getTemplate(name: string): TemplateHandler | undefined {\n    return this.templates.get(name)?.handler;\n  }\n\n  /**\n   * Returns a map of all registered templates with their handlers.\n   * The keys are the template names and the values are the template handlers.\n   */\n  public getTemplates(): Map<string, TemplateHandler> {\n    return new Map(\n      Array.from(this.templates.entries()).map(([name, entry]) => [\n        name,\n        entry.handler,\n      ]),\n    );\n  }\n\n  /**\n   * Transforms the given code using all registered plugins.\n   * Each plugin's transform method is called in sequence, allowing them to modify the code.\n   * @param code - The code to be transformed.\n   * @param id - The identifier for the code being transformed (e.g., filename).\n   * @returns An object containing the transformed code and an optional source map.\n   */\n  public async transform(\n    code: string,\n    id: string,\n  ): Promise<{ code: string; map: string | null }> {\n    let map: string | null = null;\n    for (const plugin of this.plugins) {\n      try {\n        const res: MaybeFalsey<TransformedResult> = await plugin.transform?.({\n          code,\n          id,\n        });\n\n        if (!res) continue;\n\n        if (res.code) {\n          code = res.code;\n        }\n\n        if (res.map) {\n          map = res.map;\n        }\n      } catch (e: any) {\n        const err = e instanceof Error ? e : new Error(e);\n        throw new Error(\n          `Plugin ${plugin.name} failed to transform: ${err.message}`,\n        );\n      }\n    }\n\n    return {\n      code,\n      map,\n    };\n  }\n\n  /**\n   * Initializes the plugin runtime by activating all registered plugins.\n   * This method should be called once to set up the plugins.\n   */\n  public async init() {\n    if (this.initialized) return;\n\n    for (const plugin of this.plugins) {\n      try {\n        await this.#pluginContext.run(\n          {\n            plugin,\n            mode: PluginExecutionMode.Activate,\n          },\n          async () => {\n            await plugin.activate?.(this);\n          },\n        );\n      } catch (e: any) {\n        console.error(\n          `Plugin ${plugin.name} failed to activate with ${e?.stack || e}`,\n        );\n      }\n    }\n\n    this.initialized = true;\n  }\n\n  /**\n   * Destroys the plugin runtime by deactivating all registered plugins.\n   * This method should be called when the runtime is no longer needed.\n   */\n  public async destroy() {\n    if (!this.initialized) return;\n\n    for (const plugin of this.plugins) {\n      try {\n        await this.#pluginContext.run(\n          {\n            plugin,\n            mode: PluginExecutionMode.Deactivate,\n          },\n          async () => {\n            await plugin.deactivate?.(this);\n          },\n        );\n      } catch (e: any) {\n        console.error(\n          `Plugin ${plugin.name} failed to deactivate with ${e?.stack || e}`,\n        );\n      }\n    }\n\n    this.initialized = false;\n  }\n\n  /**\n   * Converts the plugin runtime to a JSON representation.\n   * This is useful for serialization or debugging purposes.\n   * @returns An object containing the name of the runtime and the transform method.\n   */\n  public toJSON() {\n    return {\n      name: this.name,\n      transform: this.transform.bind(this),\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/DefaultLogger-pWzrSxMd.d.ts

@@ -0,0 +1,60 @@
+import { ILogger } from "./ILogger-Cs5SFzqd.js";
+
+//#region src/logger/DefaultLogger.d.ts
+
+/**
+ * Default logger implementation that logs messages to the console.
+ * It formats the log messages with timestamps, log levels, and context information.
+ */
+declare class DefaultLogger implements ILogger {
+  stdout: NodeJS.WriteStream & {
+    fd: 1;
+  };
+  stderr: NodeJS.WriteStream & {
+    fd: 2;
+  };
+  private logger;
+  /**
+   * Creates a new instance of DefaultLogger.
+   * @param stdout The output stream for standard messages (default: process.stdout).
+   * @param stderr The output stream for error messages (default: process.stderr).
+   */
+  constructor(stdout?: NodeJS.WriteStream & {
+    fd: 1;
+  }, stderr?: NodeJS.WriteStream & {
+    fd: 2;
+  });
+  private _formatTime;
+  private _getContext;
+  private _getLevelLabel;
+  private _getPrefix;
+  private _log;
+  /**
+   * Logs a debug message.
+   * @param args The message arguments to log.
+   */
+  debug(...args: any[]): void;
+  /**
+   * Logs an error message.
+   * @param args The message arguments to log.
+   */
+  error(...args: any[]): void;
+  /**
+   * Logs a default message.
+   * @param args The message arguments to log.
+   */
+  log(...args: any[]): void;
+  /**
+   * Logs an info message.
+   * @param args The message arguments to log.
+   */
+  info(...args: any[]): void;
+  /**
+   * Logs a warning message.
+   * @param args The message arguments to log.
+   */
+  warn(...args: any[]): void;
+}
+//#endregion
+export { DefaultLogger };
+//# sourceMappingURL=DefaultLogger-pWzrSxMd.d.ts.map

package/dist/{EventInterceptor-Bvh05z7n.js → EventInterceptor-DWCHCGRh.js}

@@ -1,5 +1,9 @@
 
 //#region src/components/common/EventInterceptor.ts
+/**
+* The event interceptor class that allows subscribing to events and handling them with custom logic.
+* It also supports automatic cleanup of expired subscriptions.
+*/
 var EventInterceptor = class {
 	subscribers = /* @__PURE__ */ new Map();
 	globalHandlers = /* @__PURE__ */ new Map();
@@ -137,4 +141,4 @@ Object.defineProperty(exports, 'EventInterceptor', {
     return EventInterceptor;
   }
 });
-//# sourceMappingURL=EventInterceptor-Bvh05z7n.js.map
+//# sourceMappingURL=EventInterceptor-DWCHCGRh.js.map

package/dist/EventInterceptor-DWCHCGRh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventInterceptor-DWCHCGRh.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\n/**\n * The error handler for the event interceptor.\n */\nexport type EventInterceptorErrorHandler = (error: Error) => Awaitable<void>;\n\n/**\n * The event interceptor class that allows subscribing to events and handling them with custom logic.\n * It also supports automatic cleanup of expired subscriptions.\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/{EventInterceptor-D_oEWSnF.d.ts → EventInterceptor-x-R2qshQ.d.ts}

@@ -27,7 +27,14 @@ interface EventInterceptorContextData<E extends keyof ClientEvents> {
    */
   onError?: EventInterceptorErrorHandler;
 }
+/**
+ * The error handler for the event interceptor.
+ */
 type EventInterceptorErrorHandler = (error: Error) => Awaitable<void>;
+/**
+ * The event interceptor class that allows subscribing to events and handling them with custom logic.
+ * It also supports automatic cleanup of expired subscriptions.
+ */
 declare class EventInterceptor {
   #private;
   readonly client: Client;
@@ -81,4 +88,4 @@ declare class EventInterceptor {
 }
 //#endregion
 export { EventInterceptor, EventInterceptorContextData, EventInterceptorErrorHandler };
-//# sourceMappingURL=EventInterceptor-D_oEWSnF.d.ts.map
+//# sourceMappingURL=EventInterceptor-x-R2qshQ.d.ts.map

package/dist/{EventWorkerContext-BYXamZ_4.d.ts → EventWorkerContext-DoFZMT8u.d.ts}

@@ -1,8 +1,12 @@
-import { CommandKit } from "./CommandKit-B-mjdP5x.js";
+import { CommandKit } from "./CommandKit-BkMUDbou.js";
 import { ParsedEvent } from "./EventsRouter-BacqK6z3.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 
 //#region src/app/events/EventWorkerContext.d.ts
+
+/**
+ * Context object containing information about the currently executing event.
+ */
 interface EventWorkerContext {
   event: string;
   namespace: string | null;
@@ -11,10 +15,29 @@ interface EventWorkerContext {
   arguments: any[];
   variables: Map<string, any>;
 }
+/**
+ * Async local storage for event worker context.
+ */
 declare const eventWorkerContext: AsyncLocalStorage<EventWorkerContext>;
+/**
+ * Runs a callback within an event worker context.
+ * @param context - The event worker context
+ * @param callback - The callback to execute
+ * @returns The result of the callback
+ */
 declare function runInEventWorkerContext<T>(context: EventWorkerContext, callback: () => T): T;
+/**
+ * Gets the current event worker context.
+ * @returns The current event worker context
+ * @throws Error if no context is found
+ */
 declare function getEventWorkerContext(): EventWorkerContext;
+/**
+ * Type guard to check if an object is an event worker context.
+ * @param worker - The object to check
+ * @returns True if the object is an event worker context
+ */
 declare function isEventWorkerContext(worker: any): worker is EventWorkerContext;
 //#endregion
 export { EventWorkerContext, eventWorkerContext, getEventWorkerContext, isEventWorkerContext, runInEventWorkerContext };
-//# sourceMappingURL=EventWorkerContext-BYXamZ_4.d.ts.map
+//# sourceMappingURL=EventWorkerContext-DoFZMT8u.d.ts.map

package/dist/{EventWorkerContext-BAKiTqJz.js → EventWorkerContext-DxfS_0fJ.js}

@@ -2,17 +2,40 @@ const require_chunk = require('./chunk-nOFOJqeH.js');
 const node_async_hooks = require_chunk.__toESM(require("node:async_hooks"));
 
 //#region src/app/events/EventWorkerContext.ts
+/**
+* @private
+* @internal
+*/
 const kEventWorker = Symbol("commandkitEventWorker");
+/**
+* Async local storage for event worker context.
+*/
 const eventWorkerContext = new node_async_hooks.AsyncLocalStorage();
+/**
+* Runs a callback within an event worker context.
+* @param context - The event worker context
+* @param callback - The callback to execute
+* @returns The result of the callback
+*/
 function runInEventWorkerContext(context, callback) {
 	Reflect.set(context, kEventWorker, true);
 	return eventWorkerContext.run(context, callback);
 }
+/**
+* Gets the current event worker context.
+* @returns The current event worker context
+* @throws Error if no context is found
+*/
 function getEventWorkerContext() {
 	const context = eventWorkerContext.getStore();
 	if (!context) throw new Error("Event worker context not found");
 	return context;
 }
+/**
+* Type guard to check if an object is an event worker context.
+* @param worker - The object to check
+* @returns True if the object is an event worker context
+*/
 function isEventWorkerContext(worker) {
 	return worker && Reflect.get(worker, kEventWorker) === true;
 }
@@ -42,4 +65,4 @@ Object.defineProperty(exports, 'runInEventWorkerContext', {
     return runInEventWorkerContext;
   }
 });
-//# sourceMappingURL=EventWorkerContext-BAKiTqJz.js.map
+//# sourceMappingURL=EventWorkerContext-DxfS_0fJ.js.map

package/dist/EventWorkerContext-DxfS_0fJ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventWorkerContext-DxfS_0fJ.js","names":[],"sources":["../src/app/events/EventWorkerContext.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport { ParsedEvent } from '../router';\nimport { CommandKit } from '../../CommandKit';\n\n/**\n * Context object containing information about the currently executing event.\n */\nexport interface EventWorkerContext {\n  event: string;\n  namespace: string | null;\n  data: ParsedEvent;\n  commandkit: CommandKit;\n  arguments: any[];\n  variables: Map<string, any>;\n}\n\n/**\n * @private\n * @internal\n */\nconst kEventWorker = Symbol('commandkitEventWorker');\n\n/**\n * Async local storage for event worker context.\n */\nexport const eventWorkerContext = new AsyncLocalStorage<EventWorkerContext>();\n\n/**\n * Runs a callback within an event worker context.\n * @param context - The event worker context\n * @param callback - The callback to execute\n * @returns The result of the callback\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\n/**\n * Gets the current event worker context.\n * @returns The current event worker context\n * @throws Error if no context is found\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\n/**\n * Type guard to check if an object is an event worker context.\n * @param worker - The object to check\n * @returns True if the object is an event worker context\n */\nexport function isEventWorkerContext(\n  worker: any,\n): worker is EventWorkerContext {\n  return worker && Reflect.get(worker, kEventWorker) === true;\n}\n"],"mappings":";;;;;;;;AAoBA,MAAM,eAAe,OAAO,wBAAwB;;;;AAKpD,MAAa,qBAAqB,IAAI;;;;;;;AAQtC,SAAgB,wBAChB,SACA,UACI;AACF,SAAQ,IAAI,SAAS,cAAc,KAAK;AAExC,QAAO,mBAAmB,IAAI,SAAS,SAAS;AAClD;;;;;;AAOA,SAAgB,wBAA4C;CAC1D,MAAM,UAAU,mBAAmB,UAAU;AAE7C,MAAK,QACH,OAAM,IAAI,MAAM;AAGlB,QAAO;AACT;;;;;;AAOA,SAAgB,qBAChB,QAC+B;AAC7B,QAAO,UAAU,QAAQ,IAAI,QAAQ,aAAa,KAAK;AACzD"}

package/dist/ILogger-Cs5SFzqd.d.ts

@@ -0,0 +1,34 @@
+//#region src/logger/ILogger.d.ts
+/**
+ * ILogger interface for logging functionality.
+ */
+interface ILogger {
+  /**
+   * Logs a message with the default log level.
+   * @param args The message to log.
+   */
+  log(...args: any[]): void;
+  /**
+   * Logs an error message.
+   * @param args The error message to log.
+   */
+  error(...args: any[]): void;
+  /**
+   * Logs a warning message.
+   * @param args The warning message to log.
+   */
+  warn(...args: any[]): void;
+  /**
+   * Logs an informational message.
+   * @param args The informational message to log.
+   */
+  info(...args: any[]): void;
+  /**
+   * Logs a debug message.
+   * @param args The debug message to log.
+   */
+  debug(...args: any[]): void;
+}
+//#endregion
+export { ILogger };
+//# sourceMappingURL=ILogger-Cs5SFzqd.d.ts.map

package/dist/Logger-5ew_YS4P.d.ts

@@ -0,0 +1,37 @@
+import { ILogger } from "./ILogger-Cs5SFzqd.js";
+
+//#region src/logger/Logger.d.ts
+
+/**
+ * Options for configuring the CommandKit logger.
+ */
+interface CommandKitLoggerOptions {
+  /**
+   * The logger provider to use.
+   */
+  provider: ILogger;
+}
+/**
+ * Logger implementation for CommandKit.
+ */
+interface LoggerImpl extends ILogger {
+  /**
+   * Configures the logger with the specified options.
+   * @param options The logger options to apply.
+   */
+  configure(options: CommandKitLoggerOptions): void;
+}
+/**
+ * Creates a new logger instance with the specified options.
+ * @param options The options for configuring the logger.
+ * @returns A new logger instance.
+ */
+declare function createLogger(options: CommandKitLoggerOptions): LoggerImpl;
+/**
+ * Default logger instance for CommandKit. This logger uses the DefaultLogger as its provider.
+ * The provider can be replaced with a custom logger implementation using the `configure` method.
+ */
+declare const Logger: LoggerImpl;
+//#endregion
+export { CommandKitLoggerOptions, Logger, LoggerImpl, createLogger };
+//# sourceMappingURL=Logger-5ew_YS4P.d.ts.map

package/dist/{MentionableSelectMenuKit-BiUSKUtZ.d.ts → MentionableSelectMenuKit-CPTKqx-O.d.ts}

@@ -1,9 +1,17 @@
-import { EventInterceptorErrorHandler } from "./EventInterceptor-D_oEWSnF.js";
-import { CommandKitSelectMenuBuilderInteractionCollectorDispatch, CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, CommandKitSelectMenuBuilderOnEnd, OnSelectMenuKitSubmit, SelectMenuKitPredicate } from "./common-pvPJVTfe.js";
+import { EventInterceptorErrorHandler } from "./EventInterceptor-x-R2qshQ.js";
+import { CommandKitSelectMenuBuilderInteractionCollectorDispatch, CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, CommandKitSelectMenuBuilderOnEnd, OnSelectMenuKitSubmit, SelectMenuKitPredicate } from "./common-DOCvOVC4.js";
 import { MentionableSelectMenuBuilder, MentionableSelectMenuInteraction } from "discord.js";
 
 //#region src/components/v1/select-menu/MentionableSelectMenuKit.d.ts
+
+/**
+ * Type for the handler function that is called when the mentionable select menu is submitted.
+ */
 type OnMentionableSelectMenuKitSubmit = OnSelectMenuKitSubmit<MentionableSelectMenuInteraction, MentionableSelectMenuKit>;
+/**
+ * Type for the predicate function that filters mentionable select menu interactions.
+ * It receives a MentionableSelectMenuInteraction and returns a boolean or a Promise that resolves to a boolean.
+ */
 type MentionableSelectMenuKitPredicate = SelectMenuKitPredicate<MentionableSelectMenuInteraction>;
 declare class MentionableSelectMenuKit extends MentionableSelectMenuBuilder {
   #private;
@@ -44,8 +52,11 @@ declare class MentionableSelectMenuKit extends MentionableSelectMenuBuilder {
    */
   filter(predicate: SelectMenuKitPredicate<MentionableSelectMenuInteraction>): this;
   private get customId();
+  /**
+   * Disposes of the mentionable select menu kit, cleaning up any resources used by the interaction collector.
+   */
   dispose(): this;
 }
 //#endregion
 export { MentionableSelectMenuKit, MentionableSelectMenuKitPredicate, OnMentionableSelectMenuKitSubmit };
-//# sourceMappingURL=MentionableSelectMenuKit-BiUSKUtZ.d.ts.map
+//# sourceMappingURL=MentionableSelectMenuKit-CPTKqx-O.d.ts.map

package/dist/{MessageCommandParser-D02-wpZN.js → MessageCommandParser-Cz-3I-wL.js}

@@ -1,41 +1,94 @@
 const require_chunk = require('./chunk-nOFOJqeH.js');
-const require_error_codes = require('./error-codes-C_UO39jz.js');
+const require_error_codes = require('./error-codes-CxlUBdF6.js');
 const discord_js = require_chunk.__toESM(require("discord.js"));
 
 //#region src/app/commands/MessageCommandParser.ts
+/**
+* Parses message content into structured command data with options and subcommands.
+*/
 var MessageCommandParser = class {
+	/**
+	* @private
+	* @internal
+	*/
 	#parsed = null;
+	/**
+	* @private
+	* @internal
+	*/
 	#options = null;
+	/**
+	* @private
+	* @internal
+	*/
 	#args = [];
+	/**
+	* Creates a new message command parser.
+	* @param message - The Discord message to parse
+	* @param prefix - Array of valid command prefixes
+	* @param schema - Function that returns the options schema for a command
+	*/
 	constructor(message, prefix, schema) {
 		this.message = message;
 		this.prefix = prefix;
 		this.schema = schema;
 	}
+	/**
+	* Gets the parsed command arguments.
+	* @returns Array of command arguments
+	*/
 	getArgs() {
 		this.parse();
 		return this.#args;
 	}
+	/**
+	* Gets the message command options object for easy access to typed option values.
+	*/
 	get options() {
 		if (!this.#options) this.#options = new MessageCommandOptions(this);
 		return this.#options;
 	}
+	/**
+	* Gets a specific option value by name.
+	* @param name - The option name
+	* @returns The option value or undefined if not found
+	*/
 	getOption(name) {
 		var _this$parse$options$f;
 		return (_this$parse$options$f = this.parse().options.find((o) => o.name === name)) === null || _this$parse$options$f === void 0 ? void 0 : _this$parse$options$f.value;
 	}
+	/**
+	* Gets the main command name.
+	* @returns The command name
+	*/
 	getCommand() {
 		return this.parse().command;
 	}
+	/**
+	* Gets the subcommand name if present.
+	* @returns The subcommand name or undefined
+	*/
 	getSubcommand() {
 		return this.parse().subcommand;
 	}
+	/**
+	* Gets the subcommand group name if present.
+	* @returns The subcommand group name or undefined
+	*/
 	getSubcommandGroup() {
 		return this.parse().subcommandGroup;
 	}
+	/**
+	* Gets the prefix used in the message.
+	* @returns The matched prefix or undefined
+	*/
 	getPrefix() {
 		for (const p of this.prefix) if (this.message.content.startsWith(p)) return p;
 	}
+	/**
+	* Gets the full command including subcommand group and subcommand.
+	* @returns The complete command string
+	*/
 	getFullCommand() {
 		return [
 			this.getCommand(),
@@ -43,6 +96,10 @@ var MessageCommandParser = class {
 			this.getSubcommand()
 		].filter((v) => v).join(" ");
 	}
+	/**
+	* Parses the message content into structured command data.
+	* @returns The parsed command data
+	*/
 	parse() {
 		if (this.#parsed) return this.#parsed;
 		const content = this.message.content;
@@ -126,10 +183,21 @@ var MessageCommandParser = class {
 		return this.#parsed;
 	}
 };
+/**
+* Provides typed access to message command options with methods similar to Discord.js interaction options.
+*/
 var MessageCommandOptions = class {
+	/**
+	* Creates a new message command options instance.
+	* @param parser - The message command parser instance
+	*/
 	constructor(parser) {
 		this.parser = parser;
 	}
+	/**
+	* @private
+	* @internal
+	*/
 	assertOption(name, required = false) {
 		const option = this.parser.getOption(name);
 		if (required && option === void 0) throw new Error(`Option "${name}" is required.`);
@@ -197,4 +265,4 @@ Object.defineProperty(exports, 'MessageCommandParser', {
     return MessageCommandParser;
   }
 });
-//# sourceMappingURL=MessageCommandParser-D02-wpZN.js.map
+//# sourceMappingURL=MessageCommandParser-Cz-3I-wL.js.map

package/dist/MessageCommandParser-Cz-3I-wL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageCommandParser-Cz-3I-wL.js","names":[],"sources":["../src/app/commands/MessageCommandParser.ts"],"sourcesContent":["import { Channel } from 'diagnostics_channel';\nimport {\n  Message,\n  ApplicationCommandOptionType,\n  GuildMember,\n  Attachment,\n  User,\n  Role,\n  CommandInteractionOption,\n} from 'discord.js';\nimport {\n  CommandKitErrorCodes,\n  createCommandKitError,\n} from '../../utils/error-codes';\n\n/**\n * Represents a parsed message command with its components.\n */\nexport interface ParsedMessageCommand {\n  command: string;\n  options: { name: string; value: unknown }[];\n  subcommand?: string;\n  subcommandGroup?: string;\n}\n\n/**\n * Schema defining the types of options for a message command.\n */\nexport type MessageCommandOptionsSchema = Record<\n  string,\n  ApplicationCommandOptionType\n>;\n\n/**\n * Parses message content into structured command data with options and subcommands.\n */\nexport class MessageCommandParser {\n  /**\n   * @private\n   * @internal\n   */\n  #parsed: ParsedMessageCommand | null = null;\n\n  /**\n   * @private\n   * @internal\n   */\n  #options: MessageCommandOptions | null = null;\n\n  /**\n   * @private\n   * @internal\n   */\n  #args: string[] = [];\n\n  /**\n   * Creates a new message command parser.\n   * @param message - The Discord message to parse\n   * @param prefix - Array of valid command prefixes\n   * @param schema - Function that returns the options schema for a command\n   */\n  public constructor(\n    public message: Message,\n    private prefix: string[],\n    private schema: (command: string) => MessageCommandOptionsSchema,\n  ) {}\n\n  /**\n   * Gets the parsed command arguments.\n   * @returns Array of command arguments\n   */\n  public getArgs() {\n    void this.parse();\n    return this.#args;\n  }\n\n  /**\n   * Gets the message command options object for easy access to typed option values.\n   */\n  public get options() {\n    if (!this.#options) {\n      this.#options = new MessageCommandOptions(this);\n    }\n\n    return this.#options;\n  }\n\n  /**\n   * Gets a specific option value by name.\n   * @param name - The option name\n   * @returns The option value or undefined if not found\n   */\n  public getOption<T>(name: string): T | undefined {\n    return this.parse().options.find((o) => o.name === name)?.value as T;\n  }\n\n  /**\n   * Gets the main command name.\n   * @returns The command name\n   */\n  public getCommand(): string {\n    return this.parse().command;\n  }\n\n  /**\n   * Gets the subcommand name if present.\n   * @returns The subcommand name or undefined\n   */\n  public getSubcommand(): string | undefined {\n    return this.parse().subcommand;\n  }\n\n  /**\n   * Gets the subcommand group name if present.\n   * @returns The subcommand group name or undefined\n   */\n  public getSubcommandGroup(): string | undefined {\n    return this.parse().subcommandGroup;\n  }\n\n  /**\n   * Gets the prefix used in the message.\n   * @returns The matched prefix or undefined\n   */\n  public getPrefix() {\n    for (const p of this.prefix) {\n      if (this.message.content.startsWith(p)) {\n        return p;\n      }\n    }\n  }\n\n  /**\n   * Gets the full command including subcommand group and subcommand.\n   * @returns The complete command string\n   */\n  public getFullCommand() {\n    return [this.getCommand(), this.getSubcommandGroup(), this.getSubcommand()]\n      .filter((v) => v)\n      .join(' ');\n  }\n\n  /**\n   * Parses the message content into structured command data.\n   * @returns The parsed command data\n   */\n  public parse(): ParsedMessageCommand {\n    if (this.#parsed) {\n      return this.#parsed;\n    }\n\n    const content = this.message.content;\n\n    const prefix = this.getPrefix();\n\n    if (!prefix) {\n      throw createCommandKitError(CommandKitErrorCodes.InvalidCommandPrefix);\n    }\n\n    const parts = content.slice(prefix.length).trim().split(' ');\n    const command = parts.shift();\n\n    this.#args = parts;\n\n    let subcommandGroup: string | undefined;\n    let subcommand: string | undefined;\n\n    if (command?.includes(':')) {\n      const [, group, cmd] = command.split(':');\n\n      if (!cmd && group) {\n        subcommand = group;\n      } else if (cmd && group) {\n        subcommandGroup = group;\n        subcommand = cmd;\n      }\n    }\n\n    const schema = this.schema(\n      [command, subcommandGroup, subcommand].filter(Boolean).join(' ').trim(),\n    );\n\n    const options = parts\n      .map((part) => {\n        try {\n          const [name, value] = part.split(':');\n\n          if (!(name in schema)) return null;\n\n          switch (schema[name]) {\n            case ApplicationCommandOptionType.Boolean:\n              return { name, value: value === 'true' };\n            case ApplicationCommandOptionType.Integer:\n              return { name, value: parseInt(value, 10) };\n            case ApplicationCommandOptionType.Number:\n              return { name, value: parseFloat(value) };\n            case ApplicationCommandOptionType.String:\n              return { name, value };\n            case ApplicationCommandOptionType.User:\n              return {\n                name,\n                value: this.message.mentions.users.find((u) => {\n                  return u.id === value.replace(/[<@!>]/g, '');\n                }),\n              };\n            case ApplicationCommandOptionType.Channel:\n              return {\n                name,\n                value: this.message.mentions.channels.find((c) => {\n                  return c.id === value.replace(/[<#>]/g, '');\n                }),\n              };\n            case ApplicationCommandOptionType.Role:\n              return {\n                name,\n                value: this.message.mentions.roles.find((r) => {\n                  return r.id === value.replace(/[<@&>]/g, '');\n                }),\n              };\n            case ApplicationCommandOptionType.Attachment:\n              return {\n                name,\n                value: this.message.attachments.find((a) => {\n                  return a.name === value;\n                }),\n              };\n            default:\n              return null;\n          }\n        } catch {\n          // Invalid option\n          return null;\n        }\n      })\n      .filter((v) => v !== null);\n\n    this.#parsed = {\n      command: command!,\n      options,\n      subcommand,\n      subcommandGroup,\n    };\n\n    return this.#parsed;\n  }\n}\n\n/**\n * Provides typed access to message command options with methods similar to Discord.js interaction options.\n */\nexport class MessageCommandOptions {\n  /**\n   * Creates a new message command options instance.\n   * @param parser - The message command parser instance\n   */\n  public constructor(private parser: MessageCommandParser) {}\n\n  /**\n   * @private\n   * @internal\n   */\n  private assertOption<T>(name: string, required = false) {\n    const option = this.parser.getOption<T>(name);\n\n    if (required && option === undefined) {\n      throw new Error(`Option \"${name}\" is required.`);\n    }\n\n    return option ?? null;\n  }\n\n  /**\n   * Gets a guild member from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The guild member or null if not found\n   */\n  getMember(name: string): GuildMember | null;\n  getMember(name: string, required: true): GuildMember;\n  getMember(name: string, required = false) {\n    const user = this.assertOption<User>(name, required);\n    const member = this.parser.message.guild?.members.cache.get(user?.id!);\n\n    if (required && !member) {\n      throw new Error(`Member \"${name}\" is required.`);\n    }\n\n    return member ?? null;\n  }\n\n  /**\n   * Gets an attachment from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The attachment or null if not found\n   */\n  getAttachment(name: string): Attachment | null;\n  getAttachment(name: string, required: true): Attachment;\n  getAttachment(name: string, required = false) {\n    return this.assertOption<Attachment>(name, required);\n  }\n\n  /**\n   * Gets a boolean value from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The boolean value or null if not found\n   */\n  getBoolean(name: string): boolean | null;\n  getBoolean(name: string, required: true): boolean;\n  getBoolean(name: string, required = false) {\n    return this.assertOption<boolean>(name, required);\n  }\n\n  /**\n   * Gets a number value from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The number value or null if not found\n   */\n  getNumber(name: string): number | null;\n  getNumber(name: string, required: true): number;\n  getNumber(name: string, required = false) {\n    return this.assertOption<number>(name, required);\n  }\n\n  /**\n   * Gets a string value from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The string value or null if not found\n   */\n  getString(name: string): string | null;\n  getString(name: string, required: true): string;\n  getString(name: string, required = false) {\n    return this.assertOption<string>(name, required);\n  }\n\n  /**\n   * Gets an integer value from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The integer value or null if not found\n   */\n  getInteger(name: string): number | null;\n  getInteger(name: string, required: true): number;\n  getInteger(name: string, required = false) {\n    return this.assertOption<number>(name, required);\n  }\n\n  /**\n   * Gets a user from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The user or null if not found\n   */\n  getUser(name: string): User | null;\n  getUser(name: string, required: true): User;\n  getUser(name: string, required = false) {\n    return this.assertOption<User>(name, required);\n  }\n\n  /**\n   * Gets a channel from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The channel or null if not found\n   */\n  getChannel(name: string): Channel | null;\n  getChannel(name: string, required: true): Channel;\n  getChannel(name: string, required = false) {\n    return this.assertOption<Channel>(name, required);\n  }\n\n  /**\n   * Gets a role from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The role or null if not found\n   */\n  getRole(name: string): Role | null;\n  getRole(name: string, required: true): Role;\n  getRole(name: string, required = false) {\n    return this.assertOption<Role>(name, required);\n  }\n\n  /**\n   * Gets a mentionable (user, member, or role) from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The mentionable or null if not found\n   */\n  getMentionable(\n    name: string,\n  ): NonNullable<CommandInteractionOption['member' | 'role' | 'user']> | null;\n  getMentionable(\n    name: string,\n    required: true,\n  ): NonNullable<CommandInteractionOption['member' | 'role' | 'user']>;\n  getMentionable(\n    name: string,\n    required = false,\n  ): NonNullable<CommandInteractionOption['member' | 'role' | 'user']> | null {\n    const target = this.assertOption(name, required);\n\n    if (\n      target instanceof GuildMember ||\n      target instanceof User ||\n      target instanceof Role\n    ) {\n      return target;\n    }\n\n    if (required) {\n      throw new Error(`Mentionable \"${name}\" is required.`);\n    }\n\n    return null;\n  }\n\n  /**\n   * Gets the subcommand name from the command.\n   * @param required - Whether the subcommand is required\n   * @returns The subcommand name or null if not found\n   */\n  getSubcommand(): string | null;\n  getSubcommand(required: true): string;\n  getSubcommand(required = false) {\n    const sub = this.parser.getSubcommand();\n\n    if (required && sub === undefined) {\n      throw new Error('Subcommand is required.');\n    }\n\n    return sub ?? null;\n  }\n\n  /**\n   * Gets the subcommand group name from the command.\n   * @param required - Whether the subcommand group is required\n   * @returns The subcommand group name or null if not found\n   */\n  getSubcommandGroup(): string | null;\n  getSubcommandGroup(required: true): string;\n  getSubcommandGroup(required = false) {\n    const sub = this.parser.getSubcommandGroup();\n\n    if (required && sub === undefined) {\n      throw new Error('Subcommand group is required.');\n    }\n\n    return sub ?? null;\n  }\n}\n"],"mappings":";;;;;;;;AAoCA,IAAa,uBAAb,MAAkC;;;;;CAKhC,UAAuC;;;;;CAMvC,WAAyC;;;;;CAMzC,QAAkB,CAAE;;;;;;;CAQpB,AAAO,YACA,SACC,QACA,QACR;EAHO;EACC;EACA;CACN;;;;;CAMF,AAAO,UAAU;AACf,EAAK,KAAK,OAAO;AACjB,SAAO,KAAK;CACd;;;;CAKA,IAAW,UAAU;AACnB,OAAK,KAAK,SACR,MAAK,WAAW,IAAI,sBAAsB;AAG5C,SAAO,KAAK;CACd;;;;;;CAOA,AAAO,UAAa,MAA6B;;AAC/C,kCAAO,KAAK,OAAO,CAAC,QAAQ,KAAK,CAAC,MAAM,EAAE,SAAS,KAAK,gFAAE;CAC5D;;;;;CAMA,AAAO,aAAqB;AAC1B,SAAO,KAAK,OAAO,CAAC;CACtB;;;;;CAMA,AAAO,gBAAoC;AACzC,SAAO,KAAK,OAAO,CAAC;CACtB;;;;;CAMA,AAAO,qBAAyC;AAC9C,SAAO,KAAK,OAAO,CAAC;CACtB;;;;;CAMA,AAAO,YAAY;AACjB,OAAK,MAAM,KAAK,KAAK,OACnB,KAAI,KAAK,QAAQ,QAAQ,WAAW,EAAE,CACpC,QAAO;CAGb;;;;;CAMA,AAAO,iBAAiB;AACtB,SAAO;GAAC,KAAK,YAAY;GAAE,KAAK,oBAAoB;GAAE,KAAK,eAAe;EAAA,EAC1E,OAAO,CAAC,MAAM,EAAE,CAChB,KAAK,IAAI;CACX;;;;;CAMA,AAAO,QAA8B;AACnC,MAAI,KAAK,QACP,QAAO,KAAK;EAGd,MAAM,UAAU,KAAK,QAAQ;EAE7B,MAAM,SAAS,KAAK,WAAW;AAE/B,OAAK,OACH,OAAM,0CAAsB,yCAAqB,qBAAqB;EAGxE,MAAM,QAAQ,QAAQ,MAAM,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI;EAC5D,MAAM,UAAU,MAAM,OAAO;AAE7B,OAAK,QAAQ;EAEb,IAAI;EACJ,IAAI;AAEJ,wDAAI,QAAS,SAAS,IAAI,EAAE;GAC1B,MAAM,GAAG,OAAO,IAAI,GAAG,QAAQ,MAAM,IAAI;AAEzC,QAAK,OAAO,MACV,cAAa;YACJ,OAAO,OAAO;AACvB,sBAAkB;AAClB,iBAAa;GACf;EACF;EAEA,MAAM,SAAS,KAAK,OAClB;GAAC;GAAS;GAAiB;EAAW,EAAC,OAAO,QAAQ,CAAC,KAAK,IAAI,CAAC,MAAM,CACxE;EAED,MAAM,UAAU,MAChB,IAAI,CAAC,SAAS;AACZ,OAAI;IACF,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,MAAM,IAAI;AAErC,UAAM,QAAQ,QAAS,QAAO;AAE9B,YAAQ,OAAO,OAAf;KACE,KAAK,wCAA6B,QAChC,QAAO;MAAE;MAAM,OAAO,UAAU;KAAQ;KAC1C,KAAK,wCAA6B,QAChC,QAAO;MAAE;MAAM,OAAO,SAAS,OAAO,GAAG;KAAE;KAC7C,KAAK,wCAA6B,OAChC,QAAO;MAAE;MAAM,OAAO,WAAW,MAAM;KAAE;KAC3C,KAAK,wCAA6B,OAChC,QAAO;MAAE;MAAM;KAAO;KACxB,KAAK,wCAA6B,KAChC,QAAO;MACL;MACA,OAAO,KAAK,QAAQ,SAAS,MAAM,KAAK,CAAC,MAAM;AAC7C,cAAO,EAAE,OAAO,MAAM,QAAQ,WAAW,GAAG;MAC7C,EAAC;KACH;KACH,KAAK,wCAA6B,QAChC,QAAO;MACL;MACA,OAAO,KAAK,QAAQ,SAAS,SAAS,KAAK,CAAC,MAAM;AAChD,cAAO,EAAE,OAAO,MAAM,QAAQ,UAAU,GAAG;MAC5C,EAAC;KACH;KACH,KAAK,wCAA6B,KAChC,QAAO;MACL;MACA,OAAO,KAAK,QAAQ,SAAS,MAAM,KAAK,CAAC,MAAM;AAC7C,cAAO,EAAE,OAAO,MAAM,QAAQ,WAAW,GAAG;MAC7C,EAAC;KACH;KACH,KAAK,wCAA6B,WAChC,QAAO;MACL;MACA,OAAO,KAAK,QAAQ,YAAY,KAAK,CAAC,MAAM;AAC1C,cAAO,EAAE,SAAS;MACnB,EAAC;KACH;KACH,QACE,QAAO;IACV;GACF,QAAO;AAEN,WAAO;GACR;EACF,EAAC,CACF,OAAO,CAAC,MAAM,MAAM,KAAK;AAEzB,OAAK,UAAU;GACJ;GACT;GACA;GACA;EACD;AAED,SAAO,KAAK;CACd;AACF;;;;AAKA,IAAa,wBAAb,MAAmC;;;;;CAKjC,AAAO,YAAoB,QAA8B;EAA9B;CAA+B;;;;;CAM1D,AAAQ,aAAgB,MAAc,WAAW,OAAO;EACtD,MAAM,SAAS,KAAK,OAAO,UAAa,KAAK;AAE7C,MAAI,YAAY,kBACd,OAAM,IAAI,OAAO,UAAU,KAAK;AAGlC,SAAO,UAAU;CACnB;CAUA,UAAU,MAAc,WAAW,OAAO;;EACxC,MAAM,OAAO,KAAK,aAAmB,MAAM,SAAS;EACpD,MAAM,kCAAS,KAAK,OAAO,QAAQ,+DAApB,sBAA2B,QAAQ,MAAM,gDAAI,KAAM,GAAI;AAEtE,MAAI,aAAa,OACf,OAAM,IAAI,OAAO,UAAU,KAAK;AAGlC,SAAO,UAAU;CACnB;CAUA,cAAc,MAAc,WAAW,OAAO;AAC5C,SAAO,KAAK,aAAyB,MAAM,SAAS;CACtD;CAUA,WAAW,MAAc,WAAW,OAAO;AACzC,SAAO,KAAK,aAAsB,MAAM,SAAS;CACnD;CAUA,UAAU,MAAc,WAAW,OAAO;AACxC,SAAO,KAAK,aAAqB,MAAM,SAAS;CAClD;CAUA,UAAU,MAAc,WAAW,OAAO;AACxC,SAAO,KAAK,aAAqB,MAAM,SAAS;CAClD;CAUA,WAAW,MAAc,WAAW,OAAO;AACzC,SAAO,KAAK,aAAqB,MAAM,SAAS;CAClD;CAUA,QAAQ,MAAc,WAAW,OAAO;AACtC,SAAO,KAAK,aAAmB,MAAM,SAAS;CAChD;CAUA,WAAW,MAAc,WAAW,OAAO;AACzC,SAAO,KAAK,aAAsB,MAAM,SAAS;CACnD;CAUA,QAAQ,MAAc,WAAW,OAAO;AACtC,SAAO,KAAK,aAAmB,MAAM,SAAS;CAChD;CAeA,eACA,MACA,WAAW,OACgE;EACzE,MAAM,SAAS,KAAK,aAAa,MAAM,SAAS;AAEhD,MACA,kBAAkB,0BAClB,kBAAkB,mBAClB,kBAAkB,gBAEhB,QAAO;AAGT,MAAI,SACF,OAAM,IAAI,OAAO,eAAe,KAAK;AAGvC,SAAO;CACT;CASA,cAAc,WAAW,OAAO;EAC9B,MAAM,MAAM,KAAK,OAAO,eAAe;AAEvC,MAAI,YAAY,eACd,OAAM,IAAI,MAAM;AAGlB,SAAO,OAAO;CAChB;CASA,mBAAmB,WAAW,OAAO;EACnC,MAAM,MAAM,KAAK,OAAO,oBAAoB;AAE5C,MAAI,YAAY,eACd,OAAM,IAAI,MAAM;AAGlB,SAAO,OAAO;CAChB;AACF"}