disrb 0.1.2.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65d508f2f29da21da961a646ad0eb6920d5d26fd3b7ad833b1c3dd391c5df495
-  data.tar.gz: 7cd5482b028e9ef689fb8952cf9e8f6c4fc34ee95c7ea43fb999caf17b1d2174
+  metadata.gz: c6deda52f746ca6b5a0288842930d00b6a88ae807968faf1247e9d13ca5f6156
+  data.tar.gz: 95ca41d74b765546a14dc658671c0da64ef7bf25be9bdc9a434812836d2b1355
 SHA512:
-  metadata.gz: c923c3f794126970b909adbf71621b57f3cba24b29eaae333f60878b5b81089822441b7345063cb5b177283c9792a551171ad4b99a5e6c6fd449eb1d4288a55a
-  data.tar.gz: 9337da2c386247cce3b904308474ff187d60086ec8d1988d5b438065c0a13e8ff646ae34f82ef6c939312d4f9fef214e1dd8da7f53699d69e22a71ee42337fae
+  metadata.gz: 35fa13cc8b978785309b19566b7daa932237afcc9125835bd75863fe456a26c7adc30b1a2d3507bcd6c4c459e17d22d1313cde56dc4a8c92e065773a8bb5e227
+  data.tar.gz: 71511d399e5ad53222a6253f63da1562abdee97a9dc1e0b6339650bc4a94e094d1dc00fa27155c039c9b8d675014c5c8077ee6aa8a4a13cf47fa9d067245ad88

data/CHANGELOG.md

@@ -0,0 +1,88 @@
+# v0.1.3 (2025-11-15)
+
+- Add documentation
+- Lots of bugfixes and improvements
+- Add replacement/deprecation warnings to parameters in create_guild_application_command and create_global_application_command
+- Fix some formatting issues in the README.md with YARD
+- Add .yardoc and doc folders to .gitignore
+- Add a missing parameter in create_global_application_command
+- Remove unnecessary double-empty check in DiscordApi#modify_current_user
+- Fix bug where an Array in a String has been treated like an Array in DiscordApi#get_current_user_guilds, and also make sure that the response code is 200 before trying to parse the response
+- Add missing implementation for https://discord.com/developers/docs/resources/user#get-current-user-guild-member
+- Add information on how to use Faraday::Response objects and notice to read linked Discord documentation in the README.md
+- Trim down and make logger.rb code more modular
+- The payload_json parameter in DiscordApi#edit_message is only to be included in multipart/form-data requests, not JSON, so we remove it
+- Rework the gateway connection reconnect code a bit
+- Rework test.rb for the new code and also fix some bugs
+- Add file and line information to Logger2 (shows where the logger was called)
+- Fix a bug where all Logger2 class functions couldn't find Logger2#base
+- Fix a bug, setting communication_disabled_until to false in DiscordApi#modify_guild_member would remove the timeout by sending nil to the Discord API, as specified in the documentation
+- Add CHANGELOG.md to files in gemspec
+- Add missing parameters in DiscordApi#modify_current_member
+- Make nick in DiscordApi#modify_current_user_nick required because its the only modification
+- Add support for some other opcodes in DiscordApi#connect_gateway
+- Create new class function DiscordApi#bitwise_permission_flags that returns a hash with the key as the permission name (as a symbol) and the value as the bitwise permission flag, and make DiscordApi#calculate_permissions_integer and DiscordApi#reverse_permissions_integer use it to trim down some lines of code
+- Move functions related to Application Commands from lib/disrb.rb to a separate file in lib/disrb/application_commands.rb
+
+## Breaking changes
+
+- Rename emoji_id parameters to emoji in all functions related to the Message resource
+- Description is a required parameter in create_guild_application_command and create_global_application_command
+- Call the block in DiscordApi#connect_gateway on every payload, not just when an interaction is created
+  (stop always expecting an interaction when the block is called)
+- Fixes where single splat operators didn't play nicely with keyword arguments (in DiscordApi#create_guild_application_commands, DiscordApi#create_global_application_commands)
+- In mass-create application command functions, make it so that it returns the response of each request as an array, not just the last request's response
+- Move DiscordApi.handle_snowflake to a separate class and slightly change usage for better documentation
+- Comment out files/_files parameter in the relevant functions due to uploading files not being implemented yet
+  (also skip the relevant functions if only the files parameter is provided)
+- Fix implementation of DiscordApi#modify_guild_role_positions, the required parameters are now different
+- Apps can no longer create guilds, thus DiscordApi#create_guild has been removed
+
+# Version 0.1.2.2 (2025-08-17)
+
+- Fix a bug where the function wouldn't return even if the status code was the expected one for success
+- (and disable Style/MultipleComparison in .rubocop.yml)
+
+# Version 0.1.2.1 (2025-08-17)
+
+- Fix a bug where connecting to the gateway would always fail
+
+# Version 0.1.2 (2025-07-25)
+
+- Change homepage in gemspec to point to the GitHub repository
+- Add full support for the messages resource
+- Bump Rubocop CI version to 0.0.4
+
+# Version 0.1.1.3 (2025-07-24)
+
+- Add rubocop to development dependencies (in gemspec)
+
+# Version 0.1.1.2 (2025-07-24)
+
+- Fix some problems with rubocop
+- Make the CI ignore rubocop failures so that the CI can still create a release
+- Add rubocop to development dependencies (in gemfile)
+
+# Version 0.1.1.1 (2025-07-24)
+
+- Bugfixes
+- Make some functions use HandleQueryString where applicable
+- Changed "if var" to "unless var.nil?" for consistency
+- Functions where all options are optional, check if atleast one is provided
+  (keyword arguments over positional arguments if there are more than 1 optional arguments was already done)
+- add Gemfile.lock to .gitignore
+- since file structure changed, update require path in test.rb
+- add link to changelog and license in README.md
+
+# Version 0.1.1 (2025-07-23)
+
+- Fully migrate from Net::HTTP to Faraday for HTTP requests
+- Bugfixes
+- Add roadmap to README
+- Create CHANGELOG.md
+- Only build and push the gem when a new tag is created
+- Make the CI automatically create a new release with the gem in the attachments
+
+# Version 0.1.0 (2025-07-23)
+
+- Initial discord.rb release as a gem (indev release)

data/README.md

@@ -13,6 +13,16 @@ The test.rb file creates two commands "test" and "test2", that return "Hi" and "
 
 !DISCLAIMER! This is project is in development. Expect changes that might break your code at any time.
 
+## How to use this project
+
+The documentation will contain information about the functions implemented in this project. Check it out [here](https://www.rubydoc.info/gems/disrb/).
+
+Most functions in this library return a `Faraday::Response` object. Check the [Faraday documentation](https://www.rubydoc.info/github/lostisland/faraday) for info on how to use that object. 
+
+If you want to get the contents of the response, use the `body` instance method (example: `[Faraday::Response object here].body`). The contents will most likely be JSON. To convert it to a Ruby object, use `JSON.parse([Faraday::Response object here].body)`.
+
+When reading the documentation, there most likely will be a link to the relevant Discord Developer Documentation page. Please read that page as well, it will contain information that may help you.
+
 ## Roadmap
 - [x] Indev release (v0.1.0)
     - [x] Basic Discord API wrapper
@@ -23,12 +33,12 @@ The test.rb file creates two commands "test" and "test2", that return "Hi" and "
     - [x] Basic gateway support
     - [x] RubyGem building and publishing
 - [ ] Alpha release (v0.2.0)
-    - [ ] Add support for all Discord API endpoints
-    - [ ] Add support for all Discord Gateway events and properly handle the connection
-    - [ ] Documentation (v0.1.3)
+    - [ ] Add support for all Discord API endpoints (v0.2.0)
+    - [ ] Add support for all Discord Gateway events and properly handle the connection (v0.1.5)
+    - [ ] Add support for uploading files (v0.1.4)
+    - [x] Documentation (v0.1.3)
+    - [x] Full message resource support (v0.1.2)
     - [x] Transition to Faraday for HTTP requests (v0.1.1)
-    - [x] Functions where all options are optional, check if atleast one is provided (v0.1.1.1)
-    - [x] Prefer to use keyword arguments over positional arguments if there are more than 1 optional arguments (v0.1.1.1)
 - [ ] Beta release (v0.3.0)
     - [ ] Component support and builder
     - [ ] Sharding support
@@ -36,4 +46,5 @@ The test.rb file creates two commands "test" and "test2", that return "Hi" and "
     - [ ] Voice support
     - [ ] Add parameter validation
 - [ ] Stable release (v1.0.0)
+    - [ ] Class-ification update (instead of returning the raw HTTP response, make them into classes to make responses easier to use)
     - [ ] Bugfixes, consistency and improvements

data/lib/disrb/application_commands.rb

@@ -0,0 +1,401 @@
+# frozen_string_literal: true
+
+# Class that contains functions that allow interacting with the Discord API.
+class DiscordApi
+  # Creates an application command specifically for one guild.
+  # See https://discord.com/developers/docs/interactions/application-commands#create-guild-application-command
+  # @param guild_id [Integer] The ID of the guild where the command will be created.
+  # @param name [String] The name of the command.
+  # @param name_localizations [Hash, nil] Localized names for the command.
+  # @param description [String, nil] The description of the command.
+  # @param description_localizations [Hash, nil] Localized descriptions for the command.
+  # @param options [Array, nil] Options for the command.
+  # @param default_member_permissions [String, nil] Sets the default permission(s) that members need to run the command.
+  #   (must be set to a bitwise permission flag as a string)
+  # @param default_permission [TrueClass, FalseClass, nil] (replaced by default_member_permissions) Whether the command
+  #   is enabled by default when the app is added to a guild.
+  # @param type [Integer, nil] The type of the command.
+  # @param nsfw [TrueClass, FalseClass, nil] Whether the command is NSFW.
+  # @return [Faraday::Response] The response from the Discord API as a Faraday::Response object.
+  def create_guild_application_command(guild_id, name, description, name_localizations: nil,
+                                       description_localizations: nil, options: nil, default_member_permissions: nil,
+                                       default_permission: nil, type: nil, nsfw: nil)
+    output = {}
+    output[:name] = name
+    output[:description] = description
+    output[:name_localizations] = name_localizations unless name_localizations.nil?
+    output[:description_localizations] = description_localizations unless description_localizations.nil?
+    output[:options] = options unless options.nil?
+    unless default_permission.nil?
+      @logger.warn('The "default_permission" parameter has been replaced by "default_member_permissions" ' \
+                     'and will be deprecated in the future.')
+      output[:default_permission] = default_permission
+    end
+    output[:type] = type unless type.nil?
+    output[:nsfw] = nsfw unless nsfw.nil?
+    output[:default_member_permissions] = default_member_permissions unless default_member_permissions.nil?
+    url = "#{@base_url}/applications/#{@application_id}/guilds/#{guild_id}/commands"
+    data = JSON.generate(output)
+    headers = { 'Authorization': @authorization_header, 'Content-Type': 'application/json' }
+    response = DiscordApi.post(url, data, headers)
+    return response if response.status == 201 || response.status == 200
+
+    @logger.error("Failed to create guild application command in guild with ID #{guild_id}. Response: #{response.body}")
+    response
+  end
+
+  # Mass-creates application commands for guild(s).
+  # @param application_commands_array [Array] An array of arrays, where the first three elements (of the inner array)
+  #   are the values for for the first three parameters (which are required) in the create_guild_application_command
+  #   method in order. The fourth element is a Hash that contains the rest of the parameters for the command, the key
+  #   must be the name of  the parameter as a symbol (e.g. :description, :options, etc.) and the value must be the value
+  #    for that parameter.
+  # @return [Array] An array of Faraday::Response objects, one for each command creation request.
+  def create_guild_application_commands(application_commands_array)
+    response = []
+    if application_commands_array.is_a?(Array)
+      application_commands_array.each do |parameter_array|
+        if parameter_array.is_a?(Array)
+          response << create_guild_application_command(*parameter_array[0..2], **parameter_array[3] || {})
+        else
+          @logger.error("Invalid parameter array: #{parameter_array}. Expected an array of parameters.")
+        end
+      end
+    else
+      @logger.error("Invalid application commands array: #{application_commands_array}. Expected an array of arrays.")
+    end
+    response
+  end
+
+  # Creates an application command globally.
+  # See https://discord.com/developers/docs/interactions/application-commands#create-global-application-command
+  # @param name [String] The name of the command.
+  # @param description [String] The description of the command.
+  # @param name_localizations [Hash, nil] Localized names for the command.
+  # @param description_localizations [Hash, nil] Localized descriptions for the command.
+  # @param options [Array, nil] Options for the command.
+  # @param default_member_permissions [String, nil] Sets the default permission(s) that members need to run the command.
+  #   (must be set to a bitwise permission flag as a string)
+  # @param dm_permission [TrueClass, FalseClass, nil] (deprecated, use contexts instead) Whether the command is
+  #   available in DMs.
+  # @param default_permission [TrueClass, FalseClass, nil] (replaced by default_member_permissions) Whether the command
+  #   is enabled by default when the app is added to a guild.
+  # @param integration_types [Array, nil] Installation context(s) where the command is available.
+  # @param contexts [Array, nil] Interaction context(s) where the command can be used
+  # @param type [Integer, nil] The type of the command.
+  # @param nsfw [TrueClass, FalseClass, nil] Whether the command is NSFW.
+  # @return [Faraday::Response] The response from the Discord API as a Faraday::Response object.
+  def create_global_application_command(name, description, name_localizations: nil,
+                                        description_localizations: nil, options: nil,
+                                        default_member_permissions: nil, dm_permission: nil, default_permission: nil,
+                                        integration_types: nil, contexts: nil, type: nil, nsfw: nil)
+    output = {}
+    output[:name] = name
+    output[:description] = description
+    output[:name_localizations] = name_localizations unless name_localizations.nil?
+    output[:description_localizations] = description_localizations unless description_localizations.nil?
+    output[:options] = options unless options.nil?
+    output[:type] = type unless type.nil?
+    output[:nsfw] = nsfw unless nsfw.nil?
+    output[:default_member_permissions] = default_member_permissions unless default_member_permissions.nil?
+    unless dm_permission.nil?
+      @logger.warn('The "dm_permission" parameter has been deprecated and "contexts" should be used instead!')
+      output[:dm_permission] = dm_permission
+    end
+    unless default_permission.nil?
+      @logger.warn('The "default_permission" parameter has been replaced by "default_member_permissions" ' \
+                     'and will be deprecated in the future.')
+      output[:default_permission] = default_permission
+    end
+    output[:integration_types] = integration_types unless integration_types.nil?
+    output[:contexts] = contexts unless contexts.nil?
+    url = "#{@base_url}/applications/#{@application_id}/commands"
+    data = JSON.generate(output)
+    headers = { 'Authorization': @authorization_header, 'Content-Type': 'application/json' }
+    response = DiscordApi.post(url, data, headers)
+    return response if response.status == 201 || response.status == 200
+
+    @logger.error("Failed to create global application command. Response: #{response.body}")
+    response
+  end
+
+  # Mass-creates application commands globally.
+  # @param application_commands_array [Array] An array of arrays, where the first two elements (of the inner array)
+  #   are the values for for the first two parameters (which are required) in the create_global_application_command
+  #   method in order. The third element is a Hash that contains the rest of the parameters for the command, the key
+  #   must be the name of  the parameter as a symbol (e.g. :description, :options, etc.) and the value must be the value
+  #    for that parameter.
+  # @return [Array] An array of Faraday::Response objects, one for each command creation request.
+  def create_global_application_commands(application_commands_array)
+    response = []
+    if application_commands_array.is_a?(Array)
+      application_commands_array.each do |parameter_array|
+        if parameter_array.is_a?(Array)
+          response << create_global_application_command(*parameter_array[0..1], **parameter_array[2] || {})
+        else
+          @logger.error("Invalid parameter array: #{parameter_array}. Expected an array of parameters.")
+        end
+      end
+    else
+      @logger.error("Invalid application commands array: #{application_commands_array}. Expected an array of arrays.")
+    end
+    response
+  end
+
+  # Edits a global application command. Returns 200 OK with the updated command object on success.
+  # If none of the optional parameters are specified (modifications), the function logs a warning and returns nil.
+  # See https://discord.com/developers/docs/interactions/application-commands#edit-global-application-command
+  # @param command_id [String] The ID of the global command to edit.
+  # @param name [String, nil] New name of the command.
+  # @param name_localizations [Hash, nil] Localized names for the command.
+  # @param description [String, nil] New description of the command.
+  # @param description_localizations [Hash, nil] Localized descriptions for the command.
+  # @param options [Array, nil] New options for the command.
+  # @param default_member_permissions [String, nil] New default permissions bitwise string for the command.
+  # @param default_permission [TrueClass, FalseClass, nil] (deprecated) Whether the command is enabled by default.
+  # @param integration_types [Array, nil] Installation context(s) where the command is available.
+  # @param contexts [Array, nil] Interaction context(s) where the command can be used.
+  # @param nsfw [TrueClass, FalseClass, nil] Whether the command is NSFW.
+  # @return [Faraday::Response, nil] The response from the Discord API, or nil if no modifications were provided.
+  def edit_global_application_command(command_id, name: nil, name_localizations: nil, description: nil,
+                                      description_localizations: nil, options: nil, default_member_permissions: nil,
+                                      default_permission: nil, integration_types: nil, contexts: nil, nsfw: nil)
+    if args[1..].all?(&:nil?)
+      @logger.warn("No modifications provided for global application command with ID #{command_id}. Skipping.")
+      return nil
+    end
+    output = {}
+    output[:name] = name
+    output[:name_localizations] = name_localizations unless name_localizations.nil?
+    output[:description] = description unless description.nil?
+    output[:description_localizations] = description_localizations unless description_localizations.nil?
+    output[:options] = options unless options.nil?
+    output[:default_permission] = default_permission unless default_permission.nil?
+    output[:nsfw] = nsfw unless nsfw.nil?
+    output[:default_member_permissions] = default_member_permissions unless default_member_permissions.nil?
+    output[:integration_types] = integration_types unless integration_types.nil?
+    output[:contexts] = contexts unless contexts.nil?
+    url = "#{@base_url}/applications/#{@application_id}/commands/#{command_id}"
+    data = JSON.generate(output)
+    headers = { 'Authorization': @authorization_header, 'Content-Type': 'application/json' }
+    response = DiscordApi.patch(url, data, headers)
+    return response if response.status == 200
+
+    @logger.error("Failed to edit global application command with ID #{command_id}. Response: #{response.body}")
+    response
+  end
+
+  # Edits a guild application command. Returns 200 OK with the updated command object on success.
+  # If none of the optional parameters are specified (modifications), the function logs a warning and returns nil.
+  # See https://discord.com/developers/docs/interactions/application-commands#edit-guild-application-command
+  # @param guild_id [String] The ID of the guild containing the command.
+  # @param command_id [String] The ID of the guild command to edit.
+  # @param name [String, nil] New name of the command.
+  # @param name_localizations [Hash, nil] Localized names for the command.
+  # @param description [String, nil] New description of the command.
+  # @param description_localizations [Hash, nil] Localized descriptions for the command.
+  # @param options [Array, nil] New options for the command.
+  # @param default_member_permissions [String, nil] New default permissions bitwise string for the command.
+  # @param default_permission [TrueClass, FalseClass, nil] (deprecated) Whether the command is enabled by default.
+  # @param nsfw [TrueClass, FalseClass, nil] Whether the command is NSFW.
+  # @return [Faraday::Response, nil] The response from the Discord API, or nil if no modifications were provided.
+  def edit_guild_application_command(guild_id, command_id, name: nil, name_localizations: nil, description: nil,
+                                     description_localizations: nil, options: nil, default_member_permissions: nil,
+                                     default_permission: nil, nsfw: nil)
+    if args[2..].all?(&:nil?)
+      @logger.warn("No modifications provided for guild application command with command ID #{command_id}. Skipping.")
+      return nil
+    end
+    output = {}
+    output[:name] = name
+    output[:name_localizations] = name_localizations unless name_localizations.nil?
+    output[:description] = description unless description.nil?
+    output[:description_localizations] = description_localizations unless description_localizations.nil?
+    output[:options] = options unless options.nil?
+    output[:default_permission] = default_permission unless default_permission.nil?
+    output[:nsfw] = nsfw unless nsfw.nil?
+    output[:default_member_permissions] = default_member_permissions unless default_member_permissions.nil?
+    url = "#{@base_url}/applications/#{@application_id}/guilds/#{guild_id}/commands/#{command_id}"
+    data = JSON.generate(output)
+    headers = { 'Authorization': @authorization_header, 'Content-Type': 'application/json' }
+    response = DiscordApi.patch(url, data, headers)
+    return response if response.status == 200
+
+    @logger.error("Failed to edit guild application command with ID #{command_id}. Response: #{response.body}")
+    response
+  end
+
+  # Deletes a global application command. Returns 204 No Content on success.
+  # See https://discord.com/developers/docs/interactions/application-commands#delete-global-application-command
+  # @param command_id [String] The ID of the global command to delete.
+  # @return [Faraday::Response] The response from the Discord API.
+  def delete_global_application_command(command_id)
+    url = "#{@base_url}/applications/#{@application_id}/commands/#{command_id}"
+    headers = { 'Authorization': @authorization_header }
+    response = DiscordApi.delete(url, headers)
+    return response if response.status == 204
+
+    @logger.error("Failed to delete global application command with ID #{command_id}. Response: #{response.body}")
+    response
+  end
+
+  # Deletes a guild application command. Returns 204 No Content on success.
+  # See https://discord.com/developers/docs/interactions/application-commands#delete-guild-application-command
+  # @param guild_id [String] The ID of the guild containing the command.
+  # @param command_id [String] The ID of the guild command to delete.
+  # @return [Faraday::Response] The response from the Discord API.
+  def delete_guild_application_command(guild_id, command_id)
+    url = "#{@base_url}/applications/#{@application_id}/guilds/#{guild_id}/commands/#{command_id}"
+    headers = { 'Authorization': @authorization_header }
+    response = DiscordApi.delete(url, headers)
+    return response if response.status == 204
+
+    @logger.error("Failed to delete guild application command with ID #{command_id} in guild with ID #{guild_id}. " \
+                  "Response: #{response.body}")
+  end
+
+  # Returns a list of application commands for a guild. Returns 200 OK with an array of command objects.
+  # See https://discord.com/developers/docs/interactions/application-commands#get-guild-application-commands
+  # @param guild_id [String] The ID of the guild to list commands for.
+  # @param with_localizations [TrueClass, FalseClass, nil] Whether to include full localization dictionaries.
+  # @return [Faraday::Response] The response from the Discord API.
+  def get_guild_application_commands(guild_id, with_localizations: nil)
+    query_string_hash = {}
+    query_string_hash[:with_localizations] = with_localizations unless with_localizations.nil?
+    query_string = DiscordApi.handle_query_strings(query_string_hash)
+    url = "#{@base_url}/applications/#{@application_id}/guilds/#{guild_id}/commands#{query_string}"
+    headers = { 'Authorization': @authorization_header }
+    response = DiscordApi.get(url, headers)
+    return response if response.status == 200
+
+    @logger.error("Failed to get guild application commands for guild with ID #{guild_id}. Response: #{response.body}")
+    response
+  end
+
+  # Returns a list of global application commands for the current application. Returns 200 OK on success.
+  # See https://discord.com/developers/docs/interactions/application-commands#get-global-application-commands
+  # @param with_localizations [TrueClass, FalseClass, nil] Whether to include full localization dictionaries.
+  # @return [Faraday::Response] The response from the Discord API.
+  def get_global_application_commands(with_localizations: false)
+    query_string_hash = {}
+    query_string_hash[:with_localizations] = with_localizations unless with_localizations.nil?
+    query_string = DiscordApi.handle_query_strings(query_string_hash)
+    url = "#{@base_url}/applications/#{@application_id}/commands#{query_string}"
+    headers = { 'Authorization': @authorization_header }
+    response = DiscordApi.get(url, headers)
+    return response if response.status == 200
+
+    @logger.error("Failed to get global application commands. Response: #{response.body}")
+    response
+  end
+
+  # Returns a single global application command by ID. Returns 200 OK with the command object.
+  # See https://discord.com/developers/docs/interactions/application-commands#get-global-application-command
+  # @param command_id [String] The ID of the global command to retrieve.
+  # @return [Faraday::Response] The response from the Discord API.
+  def get_global_application_command(command_id)
+    url = "#{@base_url}/applications/#{@application_id}/commands/#{command_id}"
+    headers = { 'Authorization': @authorization_header }
+    response = DiscordApi.get(url, headers)
+    return response if response.status == 200
+
+    @logger.error("Failed to get global application command with ID #{command_id}. Response: #{response.body}")
+    response
+  end
+
+  # Returns a single guild application command by ID. Returns 200 OK with the command object.
+  # See https://discord.com/developers/docs/interactions/application-commands#get-guild-application-command
+  # @param guild_id [String] The ID of the guild containing the command.
+  # @param command_id [String] The ID of the guild command to retrieve.
+  # @return [Faraday::Response] The response from the Discord API.
+  def get_guild_application_command(guild_id, command_id)
+    url = "#{@base_url}/applications/#{@application_id}/guilds/#{guild_id}/commands/#{command_id}"
+    headers = { 'Authorization': @authorization_header }
+    response = DiscordApi.get(url, headers)
+    return response if response.status == 200
+
+    @logger.error("Failed to get guild application command with ID #{command_id}. Response: #{response.body}")
+    response
+  end
+
+  # Overwrites all global application commands. Returns 200 OK with an array of the new command objects.
+  # See https://discord.com/developers/docs/interactions/application-commands#bulk-overwrite-global-application-commands
+  # @param commands [Array] Array of command objects (hashes) to set globally.
+  # @return [Faraday::Response] The response from the Discord API.
+  def bulk_overwrite_global_application_commands(commands)
+    url = "#{@base_url}/applications/#{@application_id}/commands"
+    data = JSON.generate(commands)
+    headers = { 'Authorization': @authorization_header, 'Content-Type': 'application/json' }
+    response = DiscordApi.put(url, data, headers)
+    return response if response.status == 200
+
+    @logger.error("Failed to bulk overwrite global application commands. Response: #{response.body}")
+    response
+  end
+
+  # Overwrites all guild application commands in a guild. Returns 200 OK with an array of the new command objects.
+  # See https://discord.com/developers/docs/interactions/application-commands#bulk-overwrite-guild-application-commands
+  # @param guild_id [String] The ID of the guild to overwrite commands for.
+  # @param commands [Array] Array of command objects (hashes) to set for the guild.
+  # @return [Faraday::Response] The response from the Discord API.
+  def bulk_overwrite_guild_application_commands(guild_id, commands)
+    url = "#{@base_url}/applications/#{@application_id}/guilds/#{guild_id}/commands"
+    data = JSON.generate(commands)
+    headers = { 'Authorization': @authorization_header, 'Content-Type': 'application/json' }
+    response = DiscordApi.put(url, data, headers)
+    return response if response.status == 200
+
+    @logger.error("Failed to bulk overwrite guild application commands in guild with ID #{guild_id}. " \
+                    "Response: #{response.body}")
+    response
+  end
+
+  # Returns all application command permissions for a guild. Returns 200 OK with an array of permissions.
+  # See https://discord.com/developers/docs/interactions/application-commands#get-guild-application-command-permissions
+  # @param guild_id [String] The ID of the guild to get command permissions for.
+  # @return [Faraday::Response] The response from the Discord API.
+  def get_guild_application_command_permissions(guild_id)
+    url = "#{@base_url}/applications/#{@application_id}/guilds/#{guild_id}/commands/permissions"
+    headers = { 'Authorization': @authorization_header }
+    response = DiscordApi.get(url, headers)
+    return response if response.status == 200
+
+    @logger.error("Failed to get guild application command permissions for guild with ID #{guild_id}. " \
+                    "Response: #{response.body}")
+    response
+  end
+
+  # Returns command permissions for a specific guild command. Returns 200 OK with the permission object.
+  # See https://discord.com/developers/docs/interactions/application-commands#get-application-command-permissions
+  # @param guild_id [String] The ID of the guild containing the command.
+  # @param command_id [String] The ID of the command to get permissions for.
+  # @return [Faraday::Response] The response from the Discord API.
+  def get_application_command_permissions(guild_id, command_id)
+    url = "#{@base_url}/applications/#{@application_id}/guilds/#{guild_id}/commands/#{command_id}/permissions"
+    headers = { 'Authorization': @authorization_header }
+    response = DiscordApi.get(url, headers)
+    return response if response.status == 200
+
+    @logger.error("Failed to get appliaction command permissions for command with ID #{command_id} in guild with ID " \
+                    "#{guild_id}. Response: #{response.body}")
+    response
+  end
+
+  # Edits command permissions for a specific guild command. Returns 200 OK with the updated permissions.
+  # See https://discord.com/developers/docs/interactions/application-commands#edit-application-command-permissions
+  # @param guild_id [String] The ID of the guild containing the command.
+  # @param command_id [String] The ID of the command to edit permissions for.
+  # @param permissions [Hash] The permissions payload to set.
+  # @return [Faraday::Response] The response from the Discord API.
+  def edit_application_command_permissions(guild_id, command_id, permissions)
+    url = "#{@base_url}/applications/#{@application_id}/guilds/#{guild_id}/commands/#{command_id}/permissions"
+    data = JSON.generate(permissions)
+    headers = { 'Authorization': @authorization_header, 'Content-Type': 'application/json' }
+    response = DiscordApi.put(url, data, headers)
+    return response if response.status == 200
+
+    @logger.error("Failed to edit application command permissions for command with ID #{command_id} in guild with ID " \
+                    "#{guild_id}. Response: #{response.body}")
+    response
+  end
+end