rubycord 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 89d357064b36d980f45709bddaed645f5b770ec7bdc603705a97396d5d8c443c
+  data.tar.gz: de9a916f7c8f269ef312d919e13970b7e96859efcac227095fb7b2cf45588c76
+SHA512:
+  metadata.gz: bbb5843ba99c0c809a1f4537b3a11554345c3cd524dff4f83ec048ed7b769de3a961219aaf3ba96f6bb7b536a8f9af4ba990b3f8d78c0ba26201d775b52a745a
+  data.tar.gz: 2a7acdfa98d2624473d1a3c8e30b65c9c0c4f40b31d31858fbcd7d87bab5c42b40158057bad15d2328eb61e3186daef4593a1fc1a3aae19a57e06a103302420e

data/lib/rubycord/allowed_mentions.rb

@@ -0,0 +1,34 @@
+require "rubycord/id_object"
+
+module Rubycord
+  # Builder class for `allowed_mentions` when sending messages.
+  class AllowedMentions
+    # @return [Array<"users", "roles", "everyone">, nil]
+    attr_accessor :parse
+
+    # @return [Array<String, Integer>, nil]
+    attr_accessor :users
+
+    # @return [Array<String, Integer>, nil]
+    attr_accessor :roles
+
+    # @param parse [Array<"users", "roles", "everyone">] Mention types that can be inferred from the message.
+    #   `users` and `roles` allow for all mentions of the respective type to ping. `everyone` allows usage of `@everyone` and `@here`
+    # @param users [Array<User, String, Integer>] Users or user IDs that can be pinged. Cannot be used in conjunction with `"users"` in `parse`
+    # @param roles [Array<Role, String, Integer>] Roles or role IDs that can be pinged. Cannot be used in conjunction with `"roles"` in `parse`
+    def initialize(parse: nil, users: nil, roles: nil)
+      @parse = parse
+      @users = users
+      @roles = roles
+    end
+
+    # @!visibility private
+    def to_hash
+      {
+        parse: @parse,
+        users: @users&.map { |user| user.is_a?(IDObject) ? user.id : user },
+        roles: @roles&.map { |role| role.is_a?(IDObject) ? role.id : role }
+      }.compact
+    end
+  end
+end

data/lib/rubycord/api/application.rb

@@ -0,0 +1,200 @@
+# API calls for slash commands.
+module Rubycord::API::Application
+  module_function
+
+  # Get a list of global application commands.
+  # https://discord.com/developers/docs/interactions/slash-commands#get-global-application-commands
+  def get_global_commands(token, application_id)
+    Rubycord::API.request(
+      :applications_aid_commands,
+      nil,
+      :get,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/commands",
+      Authorization: token
+    )
+  end
+
+  # Get a global application command by ID.
+  # https://discord.com/developers/docs/interactions/slash-commands#get-global-application-command
+  def get_global_command(token, application_id, command_id)
+    Rubycord::API.request(
+      :applications_aid_commands_cid,
+      nil,
+      :get,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/commands/#{command_id}",
+      Authorization: token
+    )
+  end
+
+  # Create a global application command.
+  # https://discord.com/developers/docs/interactions/slash-commands#create-global-application-command
+  def create_global_command(token, application_id, name, description, options = [], default_permission = nil, type = 1)
+    Rubycord::API.request(
+      :applications_aid_commands,
+      nil,
+      :post,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/commands",
+      {name: name, description: description, options: options, default_permission: default_permission, type: type}.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Edit a global application command.
+  # https://discord.com/developers/docs/interactions/slash-commands#edit-global-application-command
+  def edit_global_command(token, application_id, command_id, name = nil, description = nil, options = nil, default_permission = nil, type = 1)
+    Rubycord::API.request(
+      :applications_aid_commands_cid,
+      nil,
+      :patch,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/commands/#{command_id}",
+      {name: name, description: description, options: options, default_permission: default_permission, type: type}.compact.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Delete a global application command.
+  # https://discord.com/developers/docs/interactions/slash-commands#delete-global-application-command
+  def delete_global_command(token, application_id, command_id)
+    Rubycord::API.request(
+      :applications_aid_commands_cid,
+      nil,
+      :delete,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/commands/#{command_id}",
+      Authorization: token
+    )
+  end
+
+  # Set global application commands in bulk.
+  # https://discord.com/developers/docs/interactions/slash-commands#bulk-overwrite-global-application-commands
+  def bulk_overwrite_global_commands(token, application_id, commands)
+    Rubycord::API.request(
+      :applications_aid_commands,
+      nil,
+      :put,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/commands",
+      commands.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Get a guild's commands for an application.
+  # https://discord.com/developers/docs/interactions/slash-commands#get-guild-application-commands
+  def get_guild_commands(token, application_id, guild_id)
+    Rubycord::API.request(
+      :applications_aid_guilds_gid_commands,
+      guild_id,
+      :get,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/guilds/#{guild_id}/commands",
+      Authorization: token
+    )
+  end
+
+  # Get a guild command by ID.
+  # https://discord.com/developers/docs/interactions/slash-commands#get-guild-application-command
+  def get_guild_command(token, application_id, guild_id, command_id)
+    Rubycord::API.request(
+      :applications_aid_guilds_gid_commands_cid,
+      guild_id,
+      :get,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/guilds/#{guild_id}/commands/#{command_id}",
+      Authorization: token
+    )
+  end
+
+  # Create an application command for a guild.
+  # https://discord.com/developers/docs/interactions/slash-commands#create-guild-application-command
+  def create_guild_command(token, application_id, guild_id, name, description, options = nil, default_permission = nil, type = 1)
+    Rubycord::API.request(
+      :applications_aid_guilds_gid_commands,
+      guild_id,
+      :post,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/guilds/#{guild_id}/commands",
+      {name: name, description: description, options: options, default_permission: default_permission, type: type}.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Edit an application command for a guild.
+  # https://discord.com/developers/docs/interactions/slash-commands#edit-guild-application-command
+  def edit_guild_command(token, application_id, guild_id, command_id, name = nil, description = nil, options = nil, default_permission = nil, type = 1)
+    Rubycord::API.request(
+      :applications_aid_guilds_gid_commands_cid,
+      guild_id,
+      :patch,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/guilds/#{guild_id}/commands/#{command_id}",
+      {name: name, description: description, options: options, default_permission: default_permission, type: type}.compact.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Delete an application command for a guild.
+  # https://discord.com/developers/docs/interactions/slash-commands#delete-guild-application-command
+  def delete_guild_command(token, application_id, guild_id, command_id)
+    Rubycord::API.request(
+      :applications_aid_guilds_gid_commands_cid,
+      guild_id,
+      :delete,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/guilds/#{guild_id}/commands/#{command_id}",
+      Authorization: token
+    )
+  end
+
+  # Set guild commands in bulk.
+  # https://discord.com/developers/docs/interactions/slash-commands#bulk-overwrite-guild-application-commands
+  def bulk_overwrite_guild_commands(token, application_id, guild_id, commands)
+    Rubycord::API.request(
+      :applications_aid_guilds_gid_commands,
+      guild_id,
+      :put,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/guilds/#{guild_id}/commands",
+      commands.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Get the permissions for a specific guild command.
+  # https://discord.com/developers/docs/interactions/slash-commands#get-application-command-permissions
+  def get_guild_command_permissions(token, application_id, guild_id)
+    Rubycord::API.request(
+      :applications_aid_guilds_gid_commands_permissions,
+      guild_id,
+      :get,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/guilds/#{guild_id}/commands/permissions",
+      Authorization: token
+    )
+  end
+
+  # Edit the permissions for a specific guild command.
+  # https://discord.com/developers/docs/interactions/slash-commands#edit-application-command-permissions
+  def edit_guild_command_permissions(token, application_id, guild_id, command_id, permissions)
+    Rubycord::API.request(
+      :applications_aid_guilds_gid_commands_cid_permissions,
+      guild_id,
+      :put,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/guilds/#{guild_id}/commands/#{command_id}/permissions",
+      {permissions: permissions}.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Edit permissions for all commands in a guild.
+  # https://discord.com/developers/docs/interactions/slash-commands#batch-edit-application-command-permissions
+  def batch_edit_command_permissions(token, application_id, guild_id, permissions)
+    Rubycord::API.request(
+      :applications_aid_guilds_gid_commands_cid_permissions,
+      guild_id,
+      :put,
+      "#{Rubycord::API.api_base}/applications/#{application_id}/guilds/#{guild_id}/commands/permissions",
+      permissions.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+end