✨ Add persistent interaction routing support to commands (#80)

src/Commands/AbstractCommand.php

@@ -98,6 +98,14 @@ public static function make(Laracord $bot): self
         return new static($bot);
     }
 
+    /**
+     * The command interaction routes.
+     */
+    public function interactions(): array
+    {
+        return [];
+    }
+
     /**
      * Build an embed for use in a Discord message.
      *
@@ -106,7 +114,7 @@ public static function make(Laracord $bot): self
      */
     public function message($content = '')
     {
-        return $this->bot()->message($content);
+        return $this->bot()->message($content)->routePrefix($this->getName());
     }
 
     /**

src/Commands/Command.php

@@ -3,7 +3,6 @@
 namespace Laracord\Commands;
 
 use Laracord\Commands\Contracts\Command as CommandContract;
-use Laracord\Discord\Message;
 
 abstract class Command extends AbstractCommand implements CommandContract
 {

src/Console/Commands/stubs/command.stub

@@ -2,6 +2,7 @@
 
 namespace {{ namespace }};
 
+use Discord\Parts\Interactions\Interaction;
 use Laracord\Commands\Command;
 
 class {{ class }} extends Command
@@ -47,6 +48,17 @@ class {{ class }} extends Command
             ->message()
             ->title('{{ class }}')
             ->content('Hello world!')
+            ->button('👋', route: 'wave')
             ->send($message);
     }
+
+    /**
+     * The command interaction routes.
+     */
+    public function interactions(): array
+    {
+        return [
+            'wave' => fn (Interaction $interaction) => $this->message('👋')->reply($interaction), 
+        ];
+    }
 }

src/Console/Commands/stubs/slash-command.stub

@@ -2,6 +2,7 @@
 
 namespace {{ namespace }};
 
+use Discord\Parts\Interactions\Interaction;
 use Laracord\Commands\SlashCommand;
 
 class {{ class }} extends SlashCommand
@@ -61,7 +62,18 @@ class {{ class }} extends SlashCommand
               ->message()
               ->title('{{ class }}')
               ->content('Hello world!')
+              ->button('👋', route: 'wave')
               ->build()
         );
     }
+
+    /**
+     * The command interaction routes.
+     */
+    public function interactions(): array
+    {
+        return [
+            'wave' => fn (Interaction $interaction) => $this->message('👋')->reply($interaction), 
+        ];
+    }
 }

src/Discord/Message.php

@@ -7,6 +7,7 @@
 use Discord\Builders\MessageBuilder;
 use Discord\Parts\Channel\Channel;
 use Discord\Parts\Channel\Message as ChannelMessage;
+use Discord\Parts\Interactions\Interaction;
 use Discord\Parts\User\User;
 use Exception;
 use Illuminate\Support\Carbon;
@@ -138,6 +139,11 @@ class Message
         'info' => 3447003,
     ];
 
+    /**
+     * The interaction route prefix.
+     */
+    protected ?string $routePrefix = null;
+
     /**
      * Create a new Discord message instance.
      *
@@ -230,6 +236,18 @@ public function sendTo(mixed $user): ?ExtendedPromiseInterface
         return $user->sendMessage($this->build());
     }
 
+    /**
+     * Reply to a message or interaction.
+     */
+    public function reply(Interaction|ChannelMessage $message, bool $ephemeral = false): ExtendedPromiseInterface
+    {
+        if ($message instanceof Interaction) {
+            return $message->respondWithMessage($this->build(), ephemeral: $ephemeral);
+        }
+
+        return $message->reply($this->build());
+    }
+
     /**
      * Get the embed.
      */
@@ -630,7 +648,7 @@ public function components(array $components): self
     /**
      * Add a URL button to the message.
      */
-    public function button(string $label, mixed $value, mixed $emoji = null, ?string $style = null, bool $disabled = false, ?string $id = null, array $options = []): self
+    public function button(string $label, mixed $value = null, mixed $emoji = null, ?string $style = null, bool $disabled = false, ?string $id = null, ?string $route = null, array $options = []): self
     {
         $style = match ($style) {
             'link' => Button::STYLE_LINK,
@@ -652,6 +670,12 @@ public function button(string $label, mixed $value, mixed $emoji = null, ?string
             $button = $button->setCustomId($id);
         }
 
+        if ($route) {
+            $button = $this->getRoutePrefix()
+                ? $button->setCustomId("{$this->getRoutePrefix()}@{$route}")
+                : $button->setCustomId($route);
+        }
+
         if ($options) {
             foreach ($options as $key => $option) {
                 $key = Str::of($key)->camel()->ucfirst()->start('set')->toString();
@@ -668,9 +692,15 @@ public function button(string $label, mixed $value, mixed $emoji = null, ?string
 
         $button = match ($style) {
             Button::STYLE_LINK => $button->setUrl($value),
-            default => $button->setListener($value, $this->bot->discord()),
+            default => $value ? $button->setListener($value, $this->bot->discord()) : $button,
         };
 
+        if (! $value && ! $route && ! $id) {
+            throw new Exception('Message buttons must contain a valid `value`, `route`, or `id`.');
+
+            return $this;
+        }
+
         $this->buttons[] = $button;
 
         return $this;
@@ -701,4 +731,22 @@ public function clearButtons(): self
 
         return $this;
     }
+
+    /**
+     * Set the interaction route prefix.
+     */
+    public function routePrefix(?string $routePrefix): self
+    {
+        $this->routePrefix = Str::slug($routePrefix);
+
+        return $this;
+    }
+
+    /**
+     * Retrieve the interaction route prefix.
+     */
+    public function getRoutePrefix(): ?string
+    {
+        return $this->routePrefix;
+    }
 }