feat: add CommandCustomIdCodec#getNameTreeFromId() and deserializeToN…

…ameTree()

This should help hide the specific implementation of CommandCustomIdCodec

packages/core/src/features/command/customId/CommandCustomIdCodec.ts

@@ -71,6 +71,15 @@ export interface CommandCustomIdCodec
    */
   createIteratorFromCustomId(commandCustomId: string): StringIterator | null;
 
-  /** Returns the separator used to serialize names in command customIds. */
-  getNamesSeparator(): string;
+  /** Returns a name tree given the passed command id, extracted with {@link deserializeToObjectId}. */
+  getNameTreeFromId(id: string): [string, ...string[]];
+
+  /** Returns a name tree from a command customId.
+   * Alias of:
+   * ```ts
+   * const id = codec.deserializeToObjectId(interaction.customId);
+   * const nameTree = codec.getNameTreeFromId(id);
+   * ```
+   */
+  deserializeToNameTree(customId: string): [string, ...string[]] | null;
 }

packages/framework/src/features/command/DefaultCommandManager.ts

@@ -304,12 +304,9 @@ export class DefaultCommandManager implements CommandManager {
     } else {
       const { customId } = interaction;
 
-      const commandName = this.customIdCodec.deserializeToObjectId(customId);
-      if (!commandName) return false;
+      const names = this.customIdCodec.deserializeToNameTree(customId);
+      if (!names) return false;
 
-      const names = commandName.split(
-        this.customIdCodec.getNamesSeparator(),
-      ) as [string, ...string[]];
       const found = this.repository.locateByNameTree(...names);
       if (!found || found.isParent() || found.isSubCommandGroup()) {
         return false;

packages/framework/src/features/command/customId/DefaultCommandCustomIdCodec.ts

@@ -54,8 +54,15 @@ export class DefaultCommandCustomIdCodec
     return new DefaultCommandCustomIdCodec();
   }
 
-  public getNamesSeparator(): string {
-    return this.namesSeparator;
+  public getNameTreeFromId(id: string): [string, ...string[]] {
+    return id.split(this.namesSeparator) as [string, ...string[]];
+  }
+
+  public deserializeToNameTree(customId: string): [string, ...string[]] | null {
+    const id = this.deserializeToObjectId(customId);
+    if (!id) return null;
+
+    return this.getNameTreeFromId(id);
   }
 
   /** @inheritDoc */