feat: add CommandDeployer#setCommands()

packages/core/src/features/command/deploy/CommandDeployer.ts

@@ -29,13 +29,20 @@ import type { TopLevelCommand } from '../commands/TopLevelCommand';
 
 export interface CommandDeployer extends IterableIterator<ApplicationCommand> {
   /**
-   * Deploys the commands.
+   * Deploys pending commands, or all of them it the deployer hasn't started.
    *
    * @throws {IllegalStateError} If the deployer has already started.
    * @throws {Error} If there was an error while deploying the commands.
    */
   deploy(): Awaitable<ReadonlyCollection<string, ApplicationCommand>>;
 
+  /**
+   * Sets this deployer's commands, or the pending ones if it hasn't started.
+   *
+   * @throws {Error} If there was an error while deploying the commands.
+   */
+  setCommands(...commands: TopLevelCommand[]): Awaitable<this>;
+
   /**
    * Registers commands on Discord if the deployer has started, otherwise
    * saves them for later.

packages/core/src/features/command/deploy/ReadonlyCommandDeployer.ts

@@ -26,5 +26,5 @@ import type { CommandDeployer } from './CommandDeployer';
 
 export type ReadonlyCommandDeployer = Omit<
   CommandDeployer,
-  'addCommands' | 'removeCommands' | 'start' | 'editCommands'
+  'addCommands' | 'removeCommands' | 'start' | 'editCommands' | 'setCommands'
 >;

packages/framework/src/features/command/deploy/DefaultCommandDeployer.ts

@@ -59,6 +59,18 @@ export class DefaultCommandDeployer implements CommandDeployer {
     return this.mappings;
   }
 
+  public async setCommands(...commands: TopLevelCommand[]): Promise<this> {
+    if (this.pendingAdd === null) {
+      this.mappings.clear();
+      await this.deployOnly(...commands);
+
+      return this;
+    }
+
+    this.pendingAdd = commands;
+    return this;
+  }
+
   public async deployCommands(...commands: TopLevelCommand[]): Promise<this> {
     if (this.pendingAdd === null) {
       await this.deployOnly(...commands);