Class: OnyxCord::ApplicationCommand

Inherits:
Object
  • Object
show all
Defined in:
lib/onyxcord/interactions/internal/application_command.rb

Overview

An ApplicationCommand for slash commands.

Defined Under Namespace

Classes: Permission

Constant Summary collapse

TYPES =

Command types. chat_input is a command that appears in the text input field. user and message types appear as context menus for the respective resource.

{
  chat_input: 1,
  user: 2,
  message: 3,
  primary_entry_point: 4
}.freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#application_id ⇒ Integer (readonly)

Returns:



16
17
18
 
# File 'lib/onyxcord/interactions/internal/application_command.rb', line 16

def application_id
  @application_id
end

#contexts ⇒ Array<Integer> (readonly)

Returns:



40
41
42
 
# File 'lib/onyxcord/interactions/internal/application_command.rb', line 40

def contexts
  @contexts
end

#default_permission ⇒ true, false (readonly)

Returns:

  • (true, false) 


28
29
30
 
# File 'lib/onyxcord/interactions/internal/application_command.rb', line 28

def default_permission
  @default_permission
end

#description ⇒ String (readonly)

Returns:



25
26
27
 
# File 'lib/onyxcord/interactions/internal/application_command.rb', line 25

def description
  @description
end

#id ⇒ Integer (readonly)

Returns:



34
35
36
 
# File 'lib/onyxcord/interactions/internal/application_command.rb', line 34

def id
  @id
end

#integration_types ⇒ Array<Integer> (readonly)

Returns:



43
44
45
 
# File 'lib/onyxcord/interactions/internal/application_command.rb', line 43

def integration_types
  @integration_types
end

#name ⇒ String (readonly)

Returns:



22
23
24
 
# File 'lib/onyxcord/interactions/internal/application_command.rb', line 22

def name
  @name
end

#nsfw ⇒ true, false (readonly)

Returns:

  • (true, false) 


37
38
39
 
# File 'lib/onyxcord/interactions/internal/application_command.rb', line 37

def nsfw
  @nsfw
end

#options ⇒ Hash (readonly)

Returns:

  • (Hash) 


31
32
33
 
# File 'lib/onyxcord/interactions/internal/application_command.rb', line 31

def options
  @options
end

#server_id ⇒ Integer? (readonly)

Returns:



19
20
21
 
# File 'lib/onyxcord/interactions/internal/application_command.rb', line 19

def server_id
  @server_id
end

Instance Method Details

#delete ⇒ Object

Delete this application command.



90
91
92
 
# File 'lib/onyxcord/interactions/internal/application_command.rb', line 90

def delete
  @bot.delete_application_command(@id, server_id: @server_id)
end

#edit(name: nil, description: nil, default_permission: nil, nsfw: nil, &block) ⇒ Object

Parameters:

  • name (String) (defaults to: nil) —

    The name to use for this command.

  • description (String) (defaults to: nil) —

    The description of this command.

  • default_permission (true, false) (defaults to: nil) —

    Whether this command is available with default permissions.

  • nsfw (true, false) (defaults to: nil) —

    Whether this command should be marked as age-restricted.



84
85
86
 
# File 'lib/onyxcord/interactions/internal/application_command.rb', line 84

def edit(name: nil, description: nil, default_permission: nil, nsfw: nil, &block)
  @bot.edit_application_command(@id, server_id: @server_id, name: name, description: description, default_permission: default_permission, nsfw: nsfw, &block)
end

#mention(subcommand_group: nil, subcommand: nil) ⇒ String Also known as: to_s

Returns the layout to mention it in a message.

Parameters:

  • subcommand (String, nil) (defaults to: nil) —

    The subcommand to mention.

  • subcommand_group (String, nil) (defaults to: nil) —

    The subcommand group to mention.

Returns:

  • (String) —

    the layout to mention it in a message



64
65
66
67
68
69
70
71
72
73
74
 
# File 'lib/onyxcord/interactions/internal/application_command.rb', line 64

def mention(subcommand_group: nil, subcommand: nil)
  if subcommand_group && subcommand
    "</#{name} #{subcommand_group} #{subcommand}:#{id}>"
  elsif subcommand_group
    "</#{name} #{subcommand_group}:#{id}>"
  elsif subcommand
    "</#{name} #{subcommand}:#{id}>"
  else
    "</#{name}:#{id}>"
  end
end

#permissions(server_id: nil) ⇒ Array<Permission>

Get the permission configuration for this application command in a specific server.

Parameters:

  • server_id (Integer, String, nil) (defaults to: nil) —

    The ID of the server to fetch command permissions for.

Returns:

  • (Array<Permission>) —

    the permissions for this application command in the given server.



97
98
99
100
101
102
103
104
105
 
# File 'lib/onyxcord/interactions/internal/application_command.rb', line 97

def permissions(server_id: nil)
  raise ArgumentError, 'A server ID must be provided for global application commands' if @server_id.nil? && server_id.nil?

  response = OnyxCord::Internal::JSON.parse(REST::Application.get_application_command_permissions(@bot.token, @bot.profile.id, @server_id || server_id&.resolve_id, @id))
  response['permissions'].map { |permission| Permission.new(permission, response, @bot) }
rescue OnyxCord::Errors::UnknownError
  # If there aren't any explicit overwrites configured for the command, the response is a 400.
  []
end