discorb 0.13.1 → 0.14.0

data/lib/discorb/channel.rb

@@ -174,7 +174,7 @@ module Discorb
     #
     def delete!(reason: nil)
       Async do
-        @client.http.delete(base_url.wait.to_s, audit_log_reason: reason).wait
+        @client.http.request(Route.new(base_url.wait.to_s, "//webhooks/:webhook_id/:token", :delete), audit_log_reason: reason).wait
         @deleted = true
         self
       end
@@ -201,7 +201,7 @@ module Discorb
         }
         payload[:lock_permissions] = lock_permissions
         payload[:parent_id] = parent&.id if parent != Discorb::Unset
-        @client.http.patch("/guilds/#{@guild_id}/channels", payload, audit_log_reason: reason).wait
+        @client.http.request(Route.new("/guilds/#{@guild_id}/channels", "//guilds/:guild_id/channels", :patch), payload, audit_log_reason: reason).wait
       end
     end
 
@@ -211,9 +211,9 @@ module Discorb
       @guild_id = data[:guild_id]
       @position = data[:position]
       @permission_overwrites = if data[:permission_overwrites]
-          data[:permission_overwrites].map do |ow|
+          data[:permission_overwrites].to_h do |ow|
             [(ow[:type] == 1 ? guild.roles : guild.members)[ow[:id]], PermissionOverwrite.new(ow[:allow], ow[:deny])]
-          end.to_h
+          end
         else
           {}
         end
@@ -292,7 +292,7 @@ module Discorb
         default_auto_archive_duration ||= archive_in
         payload[:default_auto_archive_duration] = default_auto_archive_duration if default_auto_archive_duration != Discorb::Unset
 
-        @client.http.patch("/channels/#{@id}", payload, audit_log_reason: reason).wait
+        @client.http.request(Route.new("/channels/#{@id}", "//channels/:channel_id", :patch), payload, audit_log_reason: reason).wait
         self
       end
     end
@@ -313,7 +313,7 @@ module Discorb
         payload = {}
         payload[:name] = name
         payload[:avatar] = avatar.to_s if avatar
-        _resp, data = @client.http.post("/channels/#{@id}/webhooks", payload).wait
+        _resp, data = @client.http.request(Route.new("/channels/#{@id}/webhooks", "//channels/:channel_id/webhooks", :post), payload).wait
         Webhook.new([@client, data])
       end
     end
@@ -326,7 +326,7 @@ module Discorb
     #
     def fetch_webhooks
       Async do
-        _resp, data = @client.http.get("/channels/#{@id}/webhooks").wait
+        _resp, data = @client.http.request(Route.new("/channels/#{@id}/webhooks", "//channels/:channel_id/webhooks", :get)).wait
         data.map { |webhook| Webhook.new([@client, webhook]) }
       end
     end
@@ -354,7 +354,7 @@ module Discorb
 
         message_ids = messages.map { |m| Discorb::Utils.try(m, :id).to_s }
 
-        @client.http.post("/channels/#{@id}/messages/bulk-delete", { messages: message_ids }).wait
+        @client.http.request(Route.new("/channels/#{@id}/messages/bulk-delete", "//channels/:channel_id/messages/bulk-delete", :post), { messages: message_ids }).wait
       end
     end
 
@@ -384,7 +384,7 @@ module Discorb
           deny: deny_value,
           type: target.is_a?(Member) ? 1 : 0,
         }
-        @client.http.put("/channels/#{@id}/permissions/#{target.id}", payload, audit_log_reason: reason).wait
+        @client.http.request(Route.new("/channels/#{@id}/permissions/#{target.id}", "//channels/:channel_id/permissions/:target_id", :put), payload, audit_log_reason: reason).wait
       end
     end
 
@@ -404,7 +404,7 @@ module Discorb
     #
     def delete_permissions(target, reason: nil)
       Async do
-        @client.http.delete("/channels/#{@id}/permissions/#{target.id}", audit_log_reason: reason).wait
+        @client.http.request(Route.new("/channels/#{@id}/permissions/#{target.id}", "//channels/:channel_id/permissions/:target_id", :delete), audit_log_reason: reason).wait
       end
     end
 
@@ -420,7 +420,7 @@ module Discorb
     #
     def fetch_invites
       Async do
-        _resp, data = @client.http.get("/channels/#{@id}/invites").wait
+        _resp, data = @client.http.request(Route.new("/channels/#{@id}/invites", "//channels/:channel_id/invites", :get)).wait
         data.map { |invite| Invite.new(@client, invite) }
       end
     end
@@ -440,7 +440,7 @@ module Discorb
     #
     def create_invite(max_age: nil, max_uses: nil, temporary: false, unique: false, reason: nil)
       Async do
-        _resp, data = @client.http.post("/channels/#{@id}/invites", {
+        _resp, data = @client.http.request(Route.new("/channels/#{@id}/invites", "//channels/:channel_id/invites", :post), {
           max_age: max_age,
           max_uses: max_uses,
           temporary: temporary,
@@ -461,7 +461,7 @@ module Discorb
     #
     def follow_from(target, reason: nil)
       Async do
-        @client.http.post("/channels/#{target.id}/followers", { webhook_channel_id: @id }, audit_log_reason: reason).wait
+        @client.http.request(Route.new("/channels/#{target.id}/followers", "//channels/:channel_id/followers", :post), { webhook_channel_id: @id }, audit_log_reason: reason).wait
       end
     end
 
@@ -476,7 +476,7 @@ module Discorb
     #
     def follow_to(target, reason: nil)
       Async do
-        @client.http.post("/channels/#{@id}/followers", { webhook_channel_id: target.id }, audit_log_reason: reason).wait
+        @client.http.request(Route.new("/channels/#{@id}/followers", "//channels/:channel_id/followers", :post), { webhook_channel_id: target.id }, audit_log_reason: reason).wait
       end
     end
 
@@ -497,17 +497,15 @@ module Discorb
     def start_thread(name, message: nil, auto_archive_duration: 1440, public: true, rate_limit_per_user: nil, slowmode: nil, reason: nil)
       Async do
         _resp, data = if message.nil?
-            @client.http.post(
-              "/channels/#{@id}/threads", {
-                name: name,
-                auto_archive_duration: auto_archive_duration,
-                type: public ? 11 : 10,
-                rate_limit_per_user: rate_limit_per_user || slowmode,
-              },
-              audit_log_reason: reason,
-            ).wait
+            @client.http.request(Route.new("/channels/#{@id}/threads", "//channels/:channel_id/threads", :post), {
+              name: name,
+              auto_archive_duration: auto_archive_duration,
+              type: public ? 11 : 10,
+              rate_limit_per_user: rate_limit_per_user || slowmode,
+            },
+                                 audit_log_reason: reason).wait
           else
-            @client.http.post("/channels/#{@id}/messages/#{Utils.try(message, :id)}/threads", {
+            @client.http.request(Route.new("/channels/#{@id}/messages/#{Utils.try(message, :id)}/threads", "//channels/:channel_id/messages/:message_id/threads", :post), {
               name: name, auto_archive_duration: auto_archive_duration,
             }, audit_log_reason: reason).wait
           end
@@ -525,7 +523,7 @@ module Discorb
     #
     def fetch_archived_public_threads
       Async do
-        _resp, data = @client.http.get("/channels/#{@id}/threads/archived/public").wait
+        _resp, data = @client.http.request(Route.new("/channels/#{@id}/threads/archived/public", "//channels/:channel_id/threads/archived/public", :get)).wait
         data.map { |thread| Channel.make_channel(@client, thread) }
       end
     end
@@ -538,7 +536,7 @@ module Discorb
     #
     def fetch_archived_private_threads
       Async do
-        _resp, data = @client.http.get("/channels/#{@id}/threads/archived/private").wait
+        _resp, data = @client.http.request(Route.new("/channels/#{@id}/threads/archived/private", "//channels/:channel_id/threads/archived/private", :get)).wait
         data.map { |thread| Channel.make_channel(@client, thread) }
       end
     end
@@ -558,7 +556,7 @@ module Discorb
           before = 0
           threads = []
           loop do
-            _resp, data = @client.http.get("/channels/#{@id}/users/@me/threads/archived/private?before=#{before}").wait
+            _resp, data = @client.http.request(Route.new("/channels/#{@id}/users/@me/threads/archived/private?before=#{before}", "//channels/:channel_id/users/@me/threads/archived/private", :get)).wait
             threads += data[:threads].map { |thread| Channel.make_channel(@client, thread) }
             before = data[:threads][-1][:id]
 
@@ -566,7 +564,7 @@ module Discorb
           end
           threads
         else
-          _resp, data = @client.http.get("/channels/#{@id}/users/@me/threads/archived/private?limit=#{limit}&before=#{before}").wait
+          _resp, data = @client.http.request(Route.new("/channels/#{@id}/users/@me/threads/archived/private?limit=#{limit}&before=#{before}", "//channels/:channel_id/users/@me/threads/archived/private", :get)).wait
           data.map { |thread| Channel.make_channel(@client, thread) }
         end
       end
@@ -603,6 +601,11 @@ module Discorb
     # @return [nil] If the user limit is not set.
     attr_reader :user_limit
 
+    # @!attribute [r] members
+    #   @return [Array<Discorb::Member>] The members in the voice channel.
+    # @!attribute [r] voice_states
+    #   @return [Array<Discorb::VoiceState>] The voice states associated with the voice channel.
+
     include Connectable
 
     @channel_type = 2
@@ -629,13 +632,21 @@ module Discorb
         payload[:user_limit] = user_limit if user_limit != Discorb::Unset
         payload[:rtc_region] = rtc_region if rtc_region != Discorb::Unset
 
-        @client.http.patch("/channels/#{@id}", payload, audit_log_reason: reason).wait
+        @client.http.request(Route.new("/channels/#{@id}", "//channels/:channel_id", :patch), payload, audit_log_reason: reason).wait
         self
       end
     end
 
     alias modify edit
 
+    def voice_states
+      guild.voice_states.select { |state| state.channel&.id == @id }
+    end
+
+    def members
+      voice_states.map(&:member)
+    end
+
     private
 
     def _set_data(data)
@@ -694,7 +705,7 @@ module Discorb
         payload[:position] = position if position != Discorb::Unset
         payload[:bitrate] = bitrate if bitrate != Discorb::Unset
         payload[:rtc_region] = rtc_region if rtc_region != Discorb::Unset
-        @client.http.patch("/channels/#{@id}", payload, audit_log_reason: reason).wait
+        @client.http.request(Route.new("/channels/#{@id}", "//channels/:channel_id", :patch), payload, audit_log_reason: reason).wait
         self
       end
     end
@@ -713,7 +724,7 @@ module Discorb
     #
     def start(topic, public: false, reason: nil)
       Async do
-        _resp, data = @client.http.post("/stage-instances", { channel_id: @id, topic: topic, public: public ? 2 : 1 }, audit_log_reason: reason).wait
+        _resp, data = @client.http.request(Route.new("/stage-instances", "//stage-instances", :post), { channel_id: @id, topic: topic, public: public ? 2 : 1 }, audit_log_reason: reason).wait
         StageInstance.new(@client, data)
       end
     end
@@ -727,7 +738,7 @@ module Discorb
     #
     def fetch_stage_instance
       Async do
-        _resp, data = @client.http.get("/stage-instances/#{@id}").wait
+        _resp, data = @client.http.request(Route.new("/stage-instances/#{@id}", "//stage-instances/:stage_instance_id", :get)).wait
       rescue Discorb::NotFoundError
         nil
       else
@@ -735,6 +746,22 @@ module Discorb
       end
     end
 
+    def voice_states
+      guild.voice_states.select { |state| state.channel&.id == @id }
+    end
+
+    def members
+      voice_states.map(&:member)
+    end
+
+    def speakers
+      voice_states.filter { |state| !state.suppress? }.map(&:member)
+    end
+
+    def audiences
+      voice_states.filter(&:suppress?).map(&:member)
+    end
+
     private
 
     def _set_data(data)
@@ -795,7 +822,6 @@ module Discorb
     #   @macro members_intent
     #   @return [Discorb::Member] The owner of the thread.
 
-
     include Messageable
     @channel_type = nil
 
@@ -835,7 +861,7 @@ module Discorb
         auto_archive_duration ||= archive_in
         payload[:auto_archive_duration] = auto_archive_duration if auto_archive_duration != Discorb::Unset
         payload[:locked] = locked if locked != Discorb::Unset
-        @client.http.patch("/channels/#{@id}", payload, audit_log_reason: reason).wait
+        @client.http.request(Route.new("/channels/#{@id}", "//channels/:channel_id", :patch), payload, audit_log_reason: reason).wait
         self
       end
     end
@@ -924,9 +950,9 @@ module Discorb
     def add_member(member = :me)
       Async do
         if member == :me
-          @client.http.post("/channels/#{@id}/thread-members/@me").wait
+          @client.http.request(Route.new("/channels/#{@id}/thread-members/@me", "//channels/:channel_id/thread-members/@me", :post)).wait
         else
-          @client.http.post("/channels/#{@id}/thread-members/#{Utils.try(member, :id)}").wait
+          @client.http.request(Route.new("/channels/#{@id}/thread-members/#{Utils.try(member, :id)}", "//channels/:channel_id/thread-members/:user_id", :post)).wait
         end
       end
     end
@@ -943,9 +969,9 @@ module Discorb
     def remove_member(member = :me)
       Async do
         if member == :me
-          @client.http.delete("/channels/#{@id}/thread-members/@me").wait
+          @client.http.request(Route.new("/channels/#{@id}/thread-members/@me", "//channels/:channel_id/thread-members/@me", :delete)).wait
         else
-          @client.http.delete("/channels/#{@id}/thread-members/#{Utils.try(member, :id)}").wait
+          @client.http.request(Route.new("/channels/#{@id}/thread-members/#{Utils.try(member, :id)}", "//channels/:channel_id/thread-members/:user_id", :delete)).wait
         end
       end
     end
@@ -959,19 +985,28 @@ module Discorb
     #
     def fetch_members
       Async do
-        _resp, data = @client.http.get("/channels/#{@id}/thread-members").wait
+        _resp, data = @client.http.request(Route.new("/channels/#{@id}/thread-members", "//channels/:channel_id/thread-members", :get)).wait
         data.map { |d| @members[d[:id]] = Member.new(@client, d) }
       end
     end
 
+    #
+    # Represents a thread in news channel(aka announcement channel).
+    #
     class News < ThreadChannel
       @channel_type = 10
     end
 
+    #
+    # Represents a public thread in text channel.
+    #
     class Public < ThreadChannel
       @channel_type = 11
     end
 
+    #
+    # Represents a private thread in text channel.
+    #
     class Private < ThreadChannel
       @channel_type = 12
     end
@@ -981,7 +1016,7 @@ module Discorb
     end
 
     #
-    # Repre
+    # Represents a member in a thread.
     #
     class Member < DiscordModel
       attr_reader :joined_at
@@ -1033,25 +1068,30 @@ module Discorb
     end
   end
 
+  #
+  # Represents a category in a guild.
+  #
   class CategoryChannel < GuildChannel
-    attr_reader :channels
-
     @channel_type = 4
 
+    def channels
+      @client.channels.values.filter { |channel| channel.parent == self }
+    end
+
     def text_channels
-      @channels.filter { |c| c.is_a? TextChannel }
+      channels.filter { |c| c.is_a? TextChannel }
     end
 
     def voice_channels
-      @channels.filter { |c| c.is_a? VoiceChannel }
+      channels.filter { |c| c.is_a? VoiceChannel }
     end
 
     def news_channel
-      @channels.filter { |c| c.is_a? NewsChannel }
+      channels.filter { |c| c.is_a? NewsChannel }
     end
 
     def stage_channels
-      @channels.filter { |c| c.is_a? StageChannel }
+      channels.filter { |c| c.is_a? StageChannel }
     end
 
     def create_text_channel(*args, **kwargs)
@@ -1069,15 +1109,11 @@ module Discorb
     def create_stage_channel(*args, **kwargs)
       guild.create_stage_channel(*args, parent: self, **kwargs)
     end
-
-    private
-
-    def _set_data(data)
-      @channels = @client.channels.values.filter { |channel| channel.parent == self }
-      super
-    end
   end
 
+  #
+  # Represents a DM channel.
+  #
   class DMChannel < Channel
     include Messageable
 

data/lib/discorb/client.rb

@@ -63,7 +63,7 @@ module Discorb
     # @param [Discorb::AllowedMentions] allowed_mentions The allowed mentions that the client is using.
     # @param [Discorb::Intents] intents The intents that the client is currently using.
     # @param [Integer] message_caches The number of messages to cache.
-    # @param [#puts] log The IO object to use for logging.
+    # @param [#write] log The IO object to use for logging.
     # @param [Boolean] colorize_log Whether to colorize the log.
     # @param [:debug, :info, :warn, :error, :critical] log_level The log level.
     # @param [Boolean] wait_until_ready Whether to delay event dispatch until ready.
@@ -186,10 +186,8 @@ module Discorb
         @log.debug "Dispatching event #{event_name}"
         events.each do |block|
           Async do
-            Async(annotation: "Discorb event: #{event_name}") do |task|
-              if block.is_a?(Discorb::EventHandler)
-                @events[event_name].delete(block) if block.metadata[:once]
-              end
+            Async(annotation: "Discorb event: #{event_name}") do |_task|
+              @events[event_name].delete(block) if block.is_a?(Discorb::EventHandler) && block.metadata[:once]
               block.call(*args)
               @log.debug "Dispatched proc with ID #{block.id.inspect}"
             rescue StandardError, ScriptError => e
@@ -212,7 +210,7 @@ module Discorb
     #
     def fetch_user(id)
       Async do
-        _resp, data = http.get("/users/#{id}").wait
+        _resp, data = @http.request(Route.new("/users/#{id}", "//users/:user_id", :get)).wait
         User.new(self, data)
       end
     end
@@ -229,7 +227,7 @@ module Discorb
     #
     def fetch_channel(id)
       Async do
-        _resp, data = http.get("/channels/#{id}").wait
+        _resp, data = @http.request(Route.new("/channels/#{id}", "//channels/:channel_id", :get)).wait
         Channel.make_channel(self, data)
       end
     end
@@ -246,7 +244,7 @@ module Discorb
     #
     def fetch_guild(id)
       Async do
-        _resp, data = http.get("/guilds/#{id}").wait
+        _resp, data = @http.request(Route.new("/guilds/#{id}", "//guilds/:guild_id", :get)).wait
         Guild.new(self, data, false)
       end
     end
@@ -261,9 +259,9 @@ module Discorb
     #
     # @return [Async::Task<Discorb::Invite>] The invite.
     #
-    def fetch_invite(code, with_count: false, with_expiration: false)
+    def fetch_invite(code, with_count: true, with_expiration: true)
       Async do
-        _resp, data = http.get("/invites/#{code}?with_count=#{with_count}&with_expiration=#{with_expiration}").wait
+        _resp, data = @http.request(Route.new("/invites/#{code}?with_count=#{with_count}&with_expiration=#{with_expiration}", "//invites/:code", :get)).wait
         Invite.new(self, data, false)
       end
     end
@@ -281,7 +279,7 @@ module Discorb
       Async do
         next @application if @application && !force
 
-        _resp, data = http.get("/oauth2/applications/@me").wait
+        _resp, data = @http.request(Route.new("/oauth2/applications/@me", "//oauth2/applications/@me", :get)).wait
         @application = Application.new(self, data)
         @application
       end
@@ -295,8 +293,8 @@ module Discorb
     #
     def fetch_nitro_sticker_packs
       Async do
-        _resp, data = http.get("/stickers-packs").wait
-        data.map { |pack| Sticker::Pack.new(self, pack) }
+        _resp, data = @http.request(Route.new("/sticker-packs", "//sticker-packs", :get)).wait
+        data[:sticker_packs].map { |pack| Sticker::Pack.new(self, pack) }
       end
     end
 
@@ -305,18 +303,14 @@ module Discorb
     #
     # @param [Discorb::Activity] activity The activity to update.
     # @param [:online, :idle, :dnd, :invisible] status The status to update.
-    # @param [String] afk Whether to set the client as AFK.
     #
-    def update_presence(activity = nil, status: nil, afk: false)
+    def update_presence(activity = nil, status: nil)
       payload = {
         activities: [],
         status: status,
-        afk: nil,
         since: nil,
       }
-      if !activity.nil?
-        payload[:activities] = [activity.to_hash]
-      end
+      payload[:activities] = [activity.to_hash] unless activity.nil?
       payload[:status] = status unless status.nil?
       if @connection
         Async do
@@ -374,10 +368,11 @@ module Discorb
     # @param [Object] ... The arguments to pass to the `ext#initialize`.
     #
     def load_extension(ext, ...)
-      if ext.is_a?(Class)
+      case ext
+      when Class
         raise ArgumentError, "#{ext} is not a extension" unless ext < Discorb::Extension
         ins = ext.new(self, ...)
-      elsif ext.is_a?(Discorb::Extension)
+      when Discorb::Extension
         ins = ext
       else
         raise ArgumentError, "#{ext} is not a extension"
@@ -398,12 +393,20 @@ module Discorb
       ins.class.commands.each do |cmd|
         cmd.define_singleton_method(:extension) { ins.class.name }
         cmd.replace_block(ins)
+        cmd.block.define_singleton_method(:self_replaced) { true }
         @commands << cmd
       end
 
       cls = ins.class
       cls.loaded(self, ...) if cls.respond_to? :loaded
-      @bottom_commands += ins.class.bottom_commands
+      ins.class.bottom_commands.each do |cmd|
+        unless cmd.respond_to? :self_replaced
+          cmd.define_singleton_method(:extension) { ins.class.name }
+          cmd.replace_block(ins)
+          cmd.block.define_singleton_method(:self_replaced) { true }
+        end
+        @bottom_commands << cmd
+      end
       @extensions[ins.class.name] = ins
       ins
     end
@@ -463,7 +466,7 @@ module Discorb
               ::File.open(options[:log_file], "a")
             end
           @log.level = options[:log_level].to_sym
-          @log.colorize_log = options[:log_color] == nil ? @log.out.isatty : options[:log_color]
+          @log.colorize_log = options[:log_color].nil? ? @log.out.isatty : options[:log_color]
         end
       end
     end
@@ -473,29 +476,29 @@ module Discorb
       if guilds = ENV["DISCORB_SETUP_GUILDS"]
         guild_ids = guilds.split(",")
       end
-      if guild_ids == ["global"]
-        guild_ids = false
-      end
+      guild_ids = false if guild_ids == ["global"]
       setup_commands(token, guild_ids: guild_ids).wait
-      @events[:setup]&.each do |event|
-        event.call
+      if ENV["DISCORB_SETUP_SCRIPT"] == "true"
+        @events[:setup]&.each do |event|
+          event.call
+        end
+        self.on_setup if respond_to? :on_setup
       end
-      self.on_setup if respond_to? :on_setup
     end
 
     def start_client(token)
-      Async do |task|
-        Signal.trap(:SIGINT) {
+      Async do |_task|
+        Signal.trap(:SIGINT) do
           @log.info "SIGINT received, closing..."
           Signal.trap(:SIGINT, "DEFAULT")
           close!
-        }
+        end
         @token = token.to_s
         @close_condition = Async::Condition.new
         @main_task = Async do
           @status = :running
           connect_gateway(false).wait
-        rescue
+        rescue StandardError
           @status = :stopped
           @close_condition.signal
           raise

data/lib/discorb/common.rb

@@ -4,9 +4,9 @@ module Discorb
   # @return [String] The API base URL.
   API_BASE_URL = "https://discord.com/api/v9"
   # @return [String] The version of discorb.
-  VERSION = "0.13.1"
+  VERSION = "0.14.0"
   # @return [String] The user agent for the bot.
-  USER_AGENT = "DiscordBot (https://discorb-lib.github.io #{VERSION}) Ruby/#{RUBY_VERSION}"
+  USER_AGENT = "DiscordBot (https://discorb-lib.github.io #{VERSION}) Ruby/#{RUBY_VERSION}".freeze
 
   #
   # @abstract
@@ -26,9 +26,6 @@ module Discorb
     end
 
     # @private
-    def inspect
-      super
-    end
 
     def hash
       @id.hash
@@ -111,32 +108,42 @@ module Discorb
     end
 
     def inspect
-      "#<#{self.class} #{to_s}>"
+      "#<#{self.class} #{self}>"
     end
 
     alias id to_s
   end
 
-  # @return [Object] Object that represents nil.
-  #   This is used as a default value for optional parameters.
-  Unset = Object.new
-  class << Unset
-    def method_missing(*)
-      self
+  #
+  # Represents an endpoint.
+  # @private
+  #
+  class Route
+    attr_reader :url, :key, :method
+
+    def initialize(url, key, method)
+      @url = url
+      @key = key
+      @method = method
     end
 
-    def or(other)
-      other
+    def hash
+      @url.hash
     end
-  end
 
-  module DefineOr
-    refine Object do
-      def or(other)
-        self
-      end
+    def identifier
+      "#{@method} #{@key}"
+    end
+
+    def major_param
+      param_type = @key.split("/").find { |k| k.start_with?(":") }
+      return "" unless param_type
+      param = url.gsub(API_BASE_URL, "").split("/")[@key.split("/").index(param_type) - 1]
+      %w[:channel_id :guild_id :webhook_id].include?(param_type) ? param : ""
     end
   end
 
-  using DefineOr
+  # @return [Object] Object that represents unspecified value.
+  #   This is used as a default value for optional parameters.
+  Unset = Object.new
 end