Functionseedcordv0.10.6Decorator

Confirmable

Wraps a repliable handler method with an interactive confirmation flow.

Displays a prompt, waits for a follow-up component interaction, and conditionally executes the original method based on the user's decision. The decorator supports both classic action rows + embed/content and ComponentV2 containers.

Confirmable<TComponent>(
    question: ConfirmableQuestionInput,
    options: ConfirmableOptions<TComponent>
): <TArgs extends unknown[]>(
    _target: RepliableInteractionHandler,
    _propertyKey: string,
    descriptor: TypedPropertyDescriptor<
        (...args: TArgs) => Promise<void>
    >
) => TypedPropertyDescriptor<
    (...args: TArgs) => Promise<void>
>

Confirmable<TComponent>(
    question: ConfirmableQuestionInput,
    options: ConfirmableOptions<TComponent>
): <TArgs extends unknown[]>(
    _target: RepliableInteractionHandler,
    _propertyKey: string,
    descriptor: TypedPropertyDescriptor<
        (...args: TArgs) => Promise<void>
    >
) => TypedPropertyDescriptor<
    (...args: TArgs) => Promise<void>
>

### Classic Mode (Buttons)


class BanHandler extends InteractionHandler {
  \@Confirmable('Are you sure you want to ban this user?', {
     mode: 'classic',
     decision: { kind: 'customIds', confirm: ['confirm_ban'], cancel: ['cancel_ban'] },
     rows: rowFactory, // Returns ActionRow or button factory
     prompt: 'Please confirm this action.',
     ephemeral: true
  })
  public async execute() {
    // Only runs if confirmed
    await this.target.ban();
  }
}

### Classic Mode (Buttons)


class BanHandler extends InteractionHandler {
  \@Confirmable('Are you sure you want to ban this user?', {
     mode: 'classic',
     decision: { kind: 'customIds', confirm: ['confirm_ban'], cancel: ['cancel_ban'] },
     rows: rowFactory, // Returns ActionRow or button factory
     prompt: 'Please confirm this action.',
     ephemeral: true
  })
  public async execute() {
    // Only runs if confirmed
    await this.target.ban();
  }
}

### Classic Mode (Select Menu with Resolver)


class RoleHandler extends InteractionHandler {
  \@Confirmable('Choose a role to assign', {
     mode: 'classic',
     // Use a custom resolver function instead of ID matching
     decision: {
         kind: 'resolver',
         componentType: ComponentType.StringSelect,
         resolve: async (i) => i.values[0] === 'admin_role'
     },
     rows: selectMenuRowFactory,
     prompt: 'Select a role below:'
  })
  public async execute() {
    // Executed if resolver returned true
  }
}

### Classic Mode (Select Menu with Resolver)


class RoleHandler extends InteractionHandler {
  \@Confirmable('Choose a role to assign', {
     mode: 'classic',
     // Use a custom resolver function instead of ID matching
     decision: {
         kind: 'resolver',
         componentType: ComponentType.StringSelect,
         resolve: async (i) => i.values[0] === 'admin_role'
     },
     rows: selectMenuRowFactory,
     prompt: 'Select a role below:'
  })
  public async execute() {
    // Executed if resolver returned true
  }
}

### V2 Mode (Container)


class SettingsHandler extends InteractionHandler {
  \@Confirmable(async () => `Update settings for ${this.user.username}?`, {
     mode: 'v2',
     container: containerFactory, // Returns ContainerBuilder
     decision: { kind: 'customIds', confirm: ['save_settings'] }
  })
  public async execute() {
    // Save settings
  }
}

### V2 Mode (Container)


class SettingsHandler extends InteractionHandler {
  \@Confirmable(async () => `Update settings for ${this.user.username}?`, {
     mode: 'v2',
     container: containerFactory, // Returns ContainerBuilder
     decision: { kind: 'customIds', confirm: ['save_settings'] }
  })
  public async execute() {
    // Save settings
  }
}

TComponent

Message component type that should resolve the confirmation.

TComponent

TComponent

Message component type that should resolve the confirmation.

question

question: ConfirmableQuestionInput

question: ConfirmableQuestionInput

Static string or lazy factory that resolves the prompt question.

options

options: ConfirmableOptions<TComponent>

options: ConfirmableOptions<TComponent>

Confirmation flow configuration.

Confirmable

Wraps a repliable handler method with an interactive confirmation flow.

Confirmable<TComponent>( question: ConfirmableQuestionInput, options: ConfirmableOptions<TComponent> ): <TArgs extends unknown[]>( _target: RepliableInteractionHandler, _propertyKey: string, descriptor: TypedPropertyDescriptor< (...args: TArgs) => Promise<void> > ) => TypedPropertyDescriptor< (...args: TArgs) => Promise<void> >

### Classic Mode (Buttons) class BanHandler extends InteractionHandler { \@Confirmable('Are you sure you want to ban this user?', { mode: 'classic', decision: { kind: 'customIds', confirm: ['confirm_ban'], cancel: ['cancel_ban'] }, rows: rowFactory, // Returns ActionRow or button factory prompt: 'Please confirm this action.', ephemeral: true }) public async execute() { // Only runs if confirmed await this.target.ban(); } }

### Classic Mode (Select Menu with Resolver) class RoleHandler extends InteractionHandler { \@Confirmable('Choose a role to assign', { mode: 'classic', // Use a custom resolver function instead of ID matching decision: { kind: 'resolver', componentType: ComponentType.StringSelect, resolve: async (i) => i.values[0] === 'admin_role' }, rows: selectMenuRowFactory, prompt: 'Select a role below:' }) public async execute() { // Executed if resolver returned true } }

### V2 Mode (Container) class SettingsHandler extends InteractionHandler { \@Confirmable(async () => `Update settings for ${this.user.username}?`, { mode: 'v2', container: containerFactory, // Returns ContainerBuilder decision: { kind: 'customIds', confirm: ['save_settings'] } }) public async execute() { // Save settings } }