commandkit 0.1.9 → 0.1.10

package/README.md

@@ -19,6 +19,7 @@ CommandKit is a library that makes it easy to handle commands and events in your
 - Multiple dev guilds, users, & roles support 🤝
 - Automatic command updates 🤖
 - REST registration behaviour 📍
+- Easy command line interface 🖥️
 - And much more! 🧪
 
 ## Documentation

package/bin/build.mjs

@@ -37,6 +37,7 @@ export async function bootstrapProductionBuild(config) {
             keepNames: true,
             outDir,
             silent: true,
+            watch: false,
             entry: [src, '!dist', '!.commandkit', `!${outDir}`],
         });
 

package/bin/development.mjs

@@ -61,10 +61,11 @@ export async function bootstrapDevelopmentServer(opts) {
             silent: true,
             entry: [src, '!dist', '!.commandkit', `!${outDir}`].filter(Boolean),
             watch: watchMode,
+            async onSuccess() {
+                return await injectShims('.commandkit', main, false, requirePolyfill);
+            },
         });
 
-        await injectShims('.commandkit', main, false, requirePolyfill);
-
         status.succeed(
             Colors.green(`Dev server started in ${(performance.now() - start).toFixed(2)}ms!\n`),
         );

package/dist/index.d.mts

@@ -257,7 +257,8 @@ declare class CommandKit {
  * The handler to run when a button is clicked. This handler is called with the interaction as the first argument.
  * If the first argument is null, it means that the interaction collector has been destroyed.
  */
-type CommandKitButtonBuilderInteractionCollectorDispatch = (interaction: ButtonInteraction | null) => Awaitable<void>;
+type CommandKitButtonBuilderInteractionCollectorDispatch = (interaction: ButtonInteraction) => Awaitable<void>;
+type CommandKitButtonBuilderOnEnd = () => Awaitable<void>;
 type CommandKitButtonBuilderInteractionCollectorDispatchContextData = {
     /**
      * The message to listen for button interactions on.
@@ -299,8 +300,8 @@ declare class ButtonKit extends ButtonBuilder {
      * button.onClick(null);
      * ```
      */
-    onClick(handler: null): this;
-    onClick(handler: CommandKitButtonBuilderInteractionCollectorDispatch, data: CommandKitButtonBuilderInteractionCollectorDispatchContextData): this;
+    onClick(handler: CommandKitButtonBuilderInteractionCollectorDispatch, data?: CommandKitButtonBuilderInteractionCollectorDispatchContextData): this;
+    onEnd(handler: CommandKitButtonBuilderOnEnd): this;
 }
 
 interface CommandKitConfig {
@@ -375,4 +376,4 @@ declare function createSignal<T = unknown>(value?: CommandKitSignalInitializer<T
  */
 declare function createEffect(callback: CommandKitEffectCallback): void;
 
-export { AutocompleteProps, ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitConfig, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, ContextMenuCommandProps, MessageContextMenuCommandProps, ReloadType, SlashCommandProps, UserContextMenuCommandProps, ValidationProps, createEffect, createSignal, defineConfig, getConfig };
+export { AutocompleteProps, ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitButtonBuilderOnEnd, CommandKitConfig, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, ContextMenuCommandProps, MessageContextMenuCommandProps, ReloadType, SlashCommandProps, UserContextMenuCommandProps, ValidationProps, createEffect, createSignal, defineConfig, getConfig };

package/dist/index.d.ts

@@ -257,7 +257,8 @@ declare class CommandKit {
  * The handler to run when a button is clicked. This handler is called with the interaction as the first argument.
  * If the first argument is null, it means that the interaction collector has been destroyed.
  */
-type CommandKitButtonBuilderInteractionCollectorDispatch = (interaction: ButtonInteraction | null) => Awaitable<void>;
+type CommandKitButtonBuilderInteractionCollectorDispatch = (interaction: ButtonInteraction) => Awaitable<void>;
+type CommandKitButtonBuilderOnEnd = () => Awaitable<void>;
 type CommandKitButtonBuilderInteractionCollectorDispatchContextData = {
     /**
      * The message to listen for button interactions on.
@@ -299,8 +300,8 @@ declare class ButtonKit extends ButtonBuilder {
      * button.onClick(null);
      * ```
      */
-    onClick(handler: null): this;
-    onClick(handler: CommandKitButtonBuilderInteractionCollectorDispatch, data: CommandKitButtonBuilderInteractionCollectorDispatchContextData): this;
+    onClick(handler: CommandKitButtonBuilderInteractionCollectorDispatch, data?: CommandKitButtonBuilderInteractionCollectorDispatchContextData): this;
+    onEnd(handler: CommandKitButtonBuilderOnEnd): this;
 }
 
 interface CommandKitConfig {
@@ -375,4 +376,4 @@ declare function createSignal<T = unknown>(value?: CommandKitSignalInitializer<T
  */
 declare function createEffect(callback: CommandKitEffectCallback): void;
 
-export { AutocompleteProps, ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitConfig, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, ContextMenuCommandProps, MessageContextMenuCommandProps, ReloadType, SlashCommandProps, UserContextMenuCommandProps, ValidationProps, createEffect, createSignal, defineConfig, getConfig };
+export { AutocompleteProps, ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitButtonBuilderOnEnd, CommandKitConfig, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, ContextMenuCommandProps, MessageContextMenuCommandProps, ReloadType, SlashCommandProps, UserContextMenuCommandProps, ValidationProps, createEffect, createSignal, defineConfig, getConfig };

package/dist/index.js

@@ -943,19 +943,55 @@ var CommandKit = class {
 var import_discord2 = require("discord.js");
 var ButtonKit = class extends import_discord2.ButtonBuilder {
   #onClickHandler = null;
+  #onEndHandler = null;
   #contextData = null;
   #collector = null;
+  /**
+   * Sets up an inline interaction collector for this button. This collector by default allows as many interactions as possible if it is actively used.
+   * If unused, this expires after 24 hours or custom time if specified.
+   * @param handler The handler to run when the button is clicked
+   * @param data The context data to use for the interaction collector
+   * @returns This button
+   * @example
+   * ```ts
+   * const button = new ButtonKit()
+   *   .setLabel('Click me')
+   *   .setStyle(ButtonStyle.Primary)
+   *   .setCustomId('click_me');
+   *
+   * const row = new ActionRowBuilder().addComponents(button);
+   *
+   * const message = await channel.send({ content: 'Click the button', components: [row] });
+   *
+   * button.onClick(async (interaction) => {
+   *   await interaction.reply('You clicked me!');
+   * }, { message });
+   *
+   * // Remove onClick handler and destroy the interaction collector
+   * button.onClick(null);
+   * ```
+   */
   onClick(handler, data) {
     if (this.data.style === import_discord2.ButtonStyle.Link) {
       throw new TypeError('Cannot setup "onClick" handler on link buttons.');
     }
+    if (!handler) {
+      throw new TypeError('Cannot setup "onClick" without a handler function parameter.');
+    }
     this.#destroyCollector();
     this.#onClickHandler = handler;
-    if (handler && data)
+    if (data)
       this.#contextData = data;
     this.#setupInteractionCollector();
     return this;
   }
+  onEnd(handler) {
+    if (!handler) {
+      throw new TypeError('Cannot setup "onEnd" without a handler function parameter.');
+    }
+    this.#onEndHandler = handler;
+    return this;
+  }
   #setupInteractionCollector() {
     if (!this.#contextData || !this.#onClickHandler)
       return;
@@ -992,10 +1028,10 @@ var ButtonKit = class extends import_discord2.ButtonBuilder {
     });
     this.#collector.on("end", () => {
       this.#destroyCollector();
+      this.#onEndHandler?.();
     });
   }
   #destroyCollector() {
-    this.#onClickHandler?.(null);
     this.#collector?.stop("end");
     this.#collector?.removeAllListeners();
     this.#collector = null;

package/dist/index.mjs

@@ -914,19 +914,55 @@ import {
 } from "discord.js";
 var ButtonKit = class extends ButtonBuilder {
   #onClickHandler = null;
+  #onEndHandler = null;
   #contextData = null;
   #collector = null;
+  /**
+   * Sets up an inline interaction collector for this button. This collector by default allows as many interactions as possible if it is actively used.
+   * If unused, this expires after 24 hours or custom time if specified.
+   * @param handler The handler to run when the button is clicked
+   * @param data The context data to use for the interaction collector
+   * @returns This button
+   * @example
+   * ```ts
+   * const button = new ButtonKit()
+   *   .setLabel('Click me')
+   *   .setStyle(ButtonStyle.Primary)
+   *   .setCustomId('click_me');
+   *
+   * const row = new ActionRowBuilder().addComponents(button);
+   *
+   * const message = await channel.send({ content: 'Click the button', components: [row] });
+   *
+   * button.onClick(async (interaction) => {
+   *   await interaction.reply('You clicked me!');
+   * }, { message });
+   *
+   * // Remove onClick handler and destroy the interaction collector
+   * button.onClick(null);
+   * ```
+   */
   onClick(handler, data) {
     if (this.data.style === ButtonStyle.Link) {
       throw new TypeError('Cannot setup "onClick" handler on link buttons.');
     }
+    if (!handler) {
+      throw new TypeError('Cannot setup "onClick" without a handler function parameter.');
+    }
     this.#destroyCollector();
     this.#onClickHandler = handler;
-    if (handler && data)
+    if (data)
       this.#contextData = data;
     this.#setupInteractionCollector();
     return this;
   }
+  onEnd(handler) {
+    if (!handler) {
+      throw new TypeError('Cannot setup "onEnd" without a handler function parameter.');
+    }
+    this.#onEndHandler = handler;
+    return this;
+  }
   #setupInteractionCollector() {
     if (!this.#contextData || !this.#onClickHandler)
       return;
@@ -963,10 +999,10 @@ var ButtonKit = class extends ButtonBuilder {
     });
     this.#collector.on("end", () => {
       this.#destroyCollector();
+      this.#onEndHandler?.();
     });
   }
   #destroyCollector() {
-    this.#onClickHandler?.(null);
     this.#collector?.stop("end");
     this.#collector?.removeAllListeners();
     this.#collector = null;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "commandkit",
     "description": "Beginner friendly command & event handler for Discord.js",
-    "version": "0.1.9",
+    "version": "0.1.10",
     "license": "MIT",
     "main": "./dist/index.js",
     "module": "./dist/index.mjs",