disrb 0.1.2.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65d508f2f29da21da961a646ad0eb6920d5d26fd3b7ad833b1c3dd391c5df495
-  data.tar.gz: 7cd5482b028e9ef689fb8952cf9e8f6c4fc34ee95c7ea43fb999caf17b1d2174
+  metadata.gz: 755465c33626010b7a97992a3afbcee4459e9feae3249870900531ce315ae4f5
+  data.tar.gz: dec666a3607d7d21b3a526f6435a291122239ab66ad908d6d3a2626c1fd7ea45
 SHA512:
-  metadata.gz: c923c3f794126970b909adbf71621b57f3cba24b29eaae333f60878b5b81089822441b7345063cb5b177283c9792a551171ad4b99a5e6c6fd449eb1d4288a55a
-  data.tar.gz: 9337da2c386247cce3b904308474ff187d60086ec8d1988d5b438065c0a13e8ff646ae34f82ef6c939312d4f9fef214e1dd8da7f53699d69e22a71ee42337fae
+  metadata.gz: 1120cf0957b7e7ab2c7fdbf011b27816cb9085cb957f8c3eee37813a1a3627a4649adcb2ca001052740fca0fa7db50e6a0731b87d0ad73b46d0771f1b6fad764
+  data.tar.gz: d554f6fe8e41c6846d5ed186cc27988e050dc57af37a041203fa5c887414185238dce3c282c88b3c3a14c4e7f3f528eb7c6257b5fdd92e16b167fdd06b86b4df

data/CHANGELOG.md

@@ -0,0 +1,101 @@
+# v0.1.4 (2026-04-05)
+
+- Add support for file uploading
+- Fix bug where HTTP handlers would continue executing even after an error
+- Add missing User-Agent header in requests to the HTTP API (it can be changed from the default)
+- Fix bug where functions may run `body` and `status` functions on a nil object
+- Change 200 server limit notice from a warning to an info message in `get_current_user_guilds`
+- Slight modifications in `README.md` and `LICENSE`
+
+## Breaking changes
+
+- Any project using `DiscordApi`'s `get`, `post`, `delete`, `put` and `patch` functions will not work, as they have been made private (only functions inside the same class can call them), in order to add functionality for customizing the User-Agent header included in requests to the HTTP API.
+
+# 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/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2025-until the sun explodes hoovad
+Copyright (c) 2025-2026 hoovad
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

data/README.md

@@ -2,16 +2,38 @@
 
 [![Licensed under the MIT license](https://img.shields.io/github/license/hoovad/discord.rb)](LICENSE)
 [![Gem Version](https://img.shields.io/gem/v/disrb?logo=ruby&color=green)](https://rubygems.org/gems/disrb)
-![project status: active](https://img.shields.io/badge/project_status-active-active)
+![project status: active](https://img.shields.io/badge/project_status-active-green)
 [![main](https://github.com/hoovad/discord.rb/actions/workflows/main.yml/badge.svg)](https://github.com/hoovad/discord.rb/actions/workflows/main.yml)
 
-[Changelog](CHANGELOG.md) | [Documentation](https://www.rubydoc.info/gems/disrb/) (currently in development)
+[Changelog](CHANGELOG.md) | [Documentation](https://www.rubydoc.info/gems/disrb/) | [Contributing](CONTRIBUTING.md)
+
+> [!IMPORTANT]
+> This is project is still in early development. Expect changes that might break your code at any time. If your code suddenly doesn't work but it did on a previous version, check the [Changelog](CHANGELOG.md) for any breaking changes.
 
 W.I.P. Discord API wrapper written in Ruby for fun.
 
-The test.rb file creates two commands "test" and "test2", that return "Hi" and "Hello World!" respectively, sets the bot's current activity to 'Watching if i work', and sets the presence to online since the program was started provided you provide the required data in `env.rb.template` and rename it to `env.rb`.
+> [!NOTE]
+> This is not a full-featured Discord API handler. This gem lets you interact with the Discord API directly without all the baggage. If you want to make a bot extremely easily, this is not what you are looking for.
+
+If you wanted to use this project, but found that something is missing, doesn't work, don't be afraid to open an issue! Read the [Contributing](CONTRIBUTING.md) page.
+
+## Demonstration
+
+The test.rb file creates two commands "test" and "test2", that return "Hi" and "Hello World!" respectively, sets the bot's current activity to 'Watching if i work', and sets the presence to online since the program was started.
+
+> [!NOTE]
+> You will need to fill out the required data in `env.rb.template` and rename it to `env.rb` before running `test.rb`.
+
+## 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)` (with `require 'json'` of course).
 
-!DISCLAIMER! This is project is in development. Expect changes that might break your code at any time.
+> [!TIP]
+> 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)
@@ -23,12 +45,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 +58,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)
+    - [ ] Return classes instead of `Faraday::Response` objects
     - [ ] Bugfixes, consistency and improvements

data/lib/disrb/application_commands.rb

@@ -0,0 +1,409 @@
+# 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 = post(url, data, headers)
+    return response if response.is_a?(Faraday::Response) && (response.status == 201 || response.status == 200)
+
+    @logger.error("Failed to create guild application command in guild with ID #{guild_id}." \
+                  " Response: #{response_error_body(response)}")
+    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 = post(url, data, headers)
+    return response if response.is_a?(Faraday::Response) && (response.status == 201 || response.status == 200)
+
+    @logger.error("Failed to create global application command. Response: #{response_error_body(response)}")
+    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 = patch(url, data, headers)
+    return response if response.is_a?(Faraday::Response) && response.status == 200
+
+    @logger.error("Failed to edit global application command with ID #{command_id}." \
+                  " Response: #{response_error_body(response)}")
+    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 = patch(url, data, headers)
+    return response if response.is_a?(Faraday::Response) && response.status == 200
+
+    @logger.error("Failed to edit guild application command with ID #{command_id}." \
+                  " Response: #{response_error_body(response)}")
+    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 = delete(url, headers)
+    return response if response.is_a?(Faraday::Response) && response.status == 204
+
+    @logger.error("Failed to delete global application command with ID #{command_id}." \
+                  "Response: #{response_error_body(response)}")
+    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 = delete(url, headers)
+    return response if response.is_a?(Faraday::Response) && response.status == 204
+
+    @logger.error("Failed to delete guild application command with ID #{command_id} in guild with ID #{guild_id}. " \
+                  "Response: #{response_error_body(response)}")
+    response
+  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 = get(url, headers)
+    return response if response.is_a?(Faraday::Response) && response.status == 200
+
+    @logger.error("Failed to get guild application commands for guild with ID #{guild_id}." \
+                  " Response: #{response_error_body(response)}")
+    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 = get(url, headers)
+    return response if response.is_a?(Faraday::Response) && response.status == 200
+
+    @logger.error("Failed to get global application commands. Response: #{response_error_body(response)}")
+    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 = get(url, headers)
+    return response if response.is_a?(Faraday::Response) && response.status == 200
+
+    @logger.error("Failed to get global application command with ID #{command_id}." \
+                  " Response: #{response_error_body(response)}")
+    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 = get(url, headers)
+    return response if response.is_a?(Faraday::Response) && response.status == 200
+
+    @logger.error("Failed to get guild application command with ID #{command_id}." \
+                  " Response: #{response_error_body(response)}")
+    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 = put(url, data, headers)
+    return response if response.is_a?(Faraday::Response) && response.status == 200
+
+    @logger.error("Failed to bulk overwrite global application commands. Response: #{response_error_body(response)}")
+    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 = put(url, data, headers)
+    return response if response.is_a?(Faraday::Response) && response.status == 200
+
+    @logger.error("Failed to bulk overwrite guild application commands in guild with ID #{guild_id}. " \
+                    "Response: #{response_error_body(response)}")
+    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 = get(url, headers)
+    return response if response.is_a?(Faraday::Response) && response.status == 200
+
+    @logger.error("Failed to get guild application command permissions for guild with ID #{guild_id}. " \
+                    "Response: #{response_error_body(response)}")
+    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 = get(url, headers)
+    return response if response.is_a?(Faraday::Response) && 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_error_body(response)}")
+    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 = put(url, data, headers)
+    return response if response.is_a?(Faraday::Response) && 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_error_body(response)}")
+    response
+  end
+end