onyxcord 2.1.0 → 3.2.0

data/lib/onyxcord/rest/routes/server/roles.rb

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+module OnyxCord::REST::Server
+  module_function
+
+  # Get server roles
+  # https://discord.com/developers/docs/resources/guild#get-guild-roles
+  def roles(token, server_id)
+    OnyxCord::REST.request(
+      :guilds_sid_roles,
+      server_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/roles",
+      Authorization: token
+    )
+  end
+
+  # Get a single role
+  # https://discord.com/developers/docs/resources/guild#get-guild-role
+  def role(token, server_id, role_id)
+    OnyxCord::REST.request(
+      :guilds_sid_roles_rid,
+      server_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/roles/#{role_id}",
+      Authorization: token
+    )
+  end
+
+  # Create a role (parameters such as name and colour if not set can be set by update_role afterwards)
+  # Permissions are the Discord defaults; allowed: invite creation, reading/sending messages,
+  # sending TTS messages, embedding links, sending files, reading the history, mentioning everybody,
+  # connecting to voice, speaking and voice activity (push-to-talk isn't mandatory)
+  # https://discord.com/developers/docs/resources/guild#get-guild-roles
+  def create_role(token, server_id, name, colour, hoist, mentionable, packed_permissions, reason = nil, colours = nil, icon = nil, unicode_emoji = nil)
+    OnyxCord::REST.request(
+      :guilds_sid_roles,
+      server_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/roles",
+      { color: colour, name: name, hoist: hoist, mentionable: mentionable, permissions: packed_permissions, colors: colours, icon: icon, unicode_emoji: unicode_emoji }.compact.to_json,
+      Authorization: token,
+      content_type: :json,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Update a role
+  # Permissions are the Discord defaults; allowed: invite creation, reading/sending messages,
+  # sending TTS messages, embedding links, sending files, reading the history, mentioning everybody,
+  # connecting to voice, speaking and voice activity (push-to-talk isn't mandatory)
+  # https://discord.com/developers/docs/resources/guild#batch-modify-guild-role
+  # @param icon [:undef, File]
+  def update_role(token, server_id, role_id, name, colour, hoist = false, mentionable = false, packed_permissions = 104_324_161, reason = nil, icon = :undef, unicode_emoji = :undef, colours = :undef)
+    data = { color: colour, name: name, hoist: hoist, mentionable: mentionable, permissions: packed_permissions, colors: colours, unicode_emoji: unicode_emoji }
+
+    if icon != :undef && icon
+      data[:icon] = OnyxCord.encode64(icon)
+    elsif icon.nil?
+      data[:icon] = nil
+    end
+
+    OnyxCord::REST.request(
+      :guilds_sid_roles_rid,
+      server_id,
+      :patch,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/roles/#{role_id}",
+      data.reject { |_, value| value == :undef }.to_json,
+      Authorization: token,
+      content_type: :json,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Modify the properties of a role.
+  # https://docs.discord.com/developers/resources/guild#modify-guild-role
+  def update_role!(token, server_id, role_id, name: :undef, permissions: :undef, colors: :undef, hoist: :undef, icon: :undef, unicode_emoji: :undef, mentionable: :undef, reason: nil)
+    OnyxCord::REST.request(
+      :guilds_sid_roles_rid,
+      server_id,
+      :patch,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/roles/#{role_id}",
+      { name:, permissions:, colors:, hoist:, icon:, unicode_emoji:, mentionable: }.reject { |_, value| value == :undef }.to_json,
+      content_type: :json,
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Update role positions
+  # https://discord.com/developers/docs/resources/guild#modify-guild-role-positions
+  def update_role_positions(token, server_id, roles, reason = nil)
+    OnyxCord::REST.request(
+      :guilds_sid_roles,
+      server_id,
+      :patch,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/roles",
+      roles.to_json,
+      Authorization: token,
+      content_type: :json,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Delete a role
+  # https://discord.com/developers/docs/resources/guild#delete-guild-role
+  def delete_role(token, server_id, role_id, reason = nil)
+    OnyxCord::REST.request(
+      :guilds_sid_roles_rid,
+      server_id,
+      :delete,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/roles/#{role_id}",
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Adds a single role to a member
+  # https://discord.com/developers/docs/resources/guild#add-guild-member-role
+  def add_member_role(token, server_id, user_id, role_id, reason = nil)
+    OnyxCord::REST.request(
+      :guilds_sid_members_uid_roles_rid,
+      server_id,
+      :put,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/members/#{user_id}/roles/#{role_id}",
+      nil,
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Removes a single role from a member
+  # https://discord.com/developers/docs/resources/guild#remove-guild-member-role
+  def remove_member_role(token, server_id, user_id, role_id, reason = nil)
+    OnyxCord::REST.request(
+      :guilds_sid_members_uid_roles_rid,
+      server_id,
+      :delete,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/members/#{user_id}/roles/#{role_id}",
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Get the amount of members who have a role
+  # https://discord.com/developers/docs/resources/guild#get-guild-roles-members-count
+  def role_member_counts(token, server_id)
+    OnyxCord::REST.request(
+      :guilds_sid_roles_member_counts,
+      server_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/roles/member-counts",
+      Authorization: token
+    )
+  end
+end

data/lib/onyxcord/rest/routes/server/scheduled_events.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module OnyxCord::REST::Server
+  module_function
+
+  # Get a list of all of the active scheduled events in the server.
+  # https://discord.com/developers/docs/resources/guild-scheduled-event#list-scheduled-events-for-guild
+  def list_scheduled_events(token, server_id, with_user_count: false)
+    OnyxCord::REST.request(
+      :guilds_sid_scheduled_events,
+      server_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/scheduled-events?with_user_count=#{with_user_count}",
+      Authorization: token
+    )
+  end
+
+  # Get a single scheduled event in the server.
+  # https://discord.com/developers/docs/resources/guild-scheduled-event#get-guild-scheduled-event
+  def get_scheduled_event(token, server_id, scheduled_event_id, with_user_count: false)
+    OnyxCord::REST.request(
+      :guilds_sid_scheduled_events_seid,
+      server_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/scheduled-events/#{scheduled_event_id}?with_user_count=#{with_user_count}",
+      Authorization: token
+    )
+  end
+
+  # Get a list of subscribers for a scheduled event in the server.
+  # https://discord.com/developers/docs/resources/guild-scheduled-event#get-guild-scheduled-event-users
+  def get_scheduled_event_users(token, server_id, scheduled_event_id, limit: 100, with_member: false, before: nil, after: nil)
+    query = URI.encode_www_form({ limit:, with_member:, before:, after: }.compact)
+
+    OnyxCord::REST.request(
+      :guilds_sid_scheduled_events_seid_users,
+      server_id,
+      :get,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/scheduled-events/#{scheduled_event_id}/users?#{query}",
+      Authorization: token
+    )
+  end
+
+  # Create a scheduled event in the server.
+  # https://discord.com/developers/docs/resources/guild-scheduled-event#create-guild-scheduled-event
+  def create_scheduled_event(token, server_id, name:, privacy_level:, scheduled_start_time:, entity_type:, channel_id: nil, entity_metadata: nil, scheduled_end_time: nil, description: nil, image: nil, recurrence_rule: nil, reason: nil)
+    OnyxCord::REST.request(
+      :guilds_sid_scheduled_events,
+      server_id,
+      :post,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/scheduled-events",
+      { name:, privacy_level:, scheduled_start_time:, entity_type:, channel_id:, entity_metadata:, scheduled_end_time:, description:, image:, recurrence_rule: }.compact.to_json,
+      Authorization: token,
+      content_type: :json,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Update a scheduled event in the server.
+  # https://discord.com/developers/docs/resources/guild-scheduled-event#modify-guild-scheduled-event
+  def update_scheduled_event(token, server_id, scheduled_event_id, name: :undef, image: :undef, status: :undef, entity_type: :undef, privacy_level: :undef, scheduled_end_time: :undef, scheduled_start_time: :undef, channel_id: :undef, description: :undef, entity_metadata: :undef, recurrence_rule: :undef, reason: nil)
+    OnyxCord::REST.request(
+      :guilds_sid_scheduled_events_seid,
+      server_id,
+      :patch,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/scheduled-events/#{scheduled_event_id}",
+      { name:, image:, status:, entity_type:, privacy_level:, scheduled_end_time:, scheduled_start_time:, channel_id:, description:, entity_metadata:, recurrence_rule: }.reject { |_, value| value == :undef }.to_json,
+      Authorization: token,
+      content_type: :json,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+
+  # Delete a scheduled event in the server.
+  # https://discord.com/developers/docs/resources/guild-scheduled-event#delete-guild-scheduled-event
+  def delete_scheduled_event(token, server_id, scheduled_event_id, reason: nil)
+    OnyxCord::REST.request(
+      :guilds_sid_scheduled_events_seid,
+      server_id,
+      :delete,
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/scheduled-events/#{scheduled_event_id}",
+      Authorization: token,
+      'X-Audit-Log-Reason': reason
+    )
+  end
+end

data/lib/onyxcord/rest/routes/server.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'onyxcord/rest/routes/server/base'
+require 'onyxcord/rest/routes/server/channels'
+require 'onyxcord/rest/routes/server/members'
+require 'onyxcord/rest/routes/server/bans'
+require 'onyxcord/rest/routes/server/messages'
+require 'onyxcord/rest/routes/server/roles'
+require 'onyxcord/rest/routes/server/admin'
+require 'onyxcord/rest/routes/server/emoji'
+require 'onyxcord/rest/routes/server/assets'
+require 'onyxcord/rest/routes/server/scheduled_events'

data/lib/onyxcord/{api → rest/routes}/user.rb

@@ -1,17 +1,17 @@
 # frozen_string_literal: true
 
 # API calls for User object
-module OnyxCord::API::User
+module OnyxCord::REST::User
   module_function
 
   # Get user data
   # https://discord.com/developers/docs/resources/user#get-user
   def resolve(token, user_id)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :users_uid,
       nil,
       :get,
-      "#{OnyxCord::API.api_base}/users/#{user_id}",
+      "#{OnyxCord::REST.api_base}/users/#{user_id}",
       Authorization: token
     )
   end
@@ -19,23 +19,23 @@ module OnyxCord::API::User
   # Get profile data
   # https://discord.com/developers/docs/resources/user#get-current-user
   def profile(token)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :users_me,
       nil,
       :get,
-      "#{OnyxCord::API.api_base}/users/@me",
+      "#{OnyxCord::REST.api_base}/users/@me",
       Authorization: token
     )
   end
 
-  # @deprecated Please use {OnyxCord::API::Server.update_current_member} instead.
+  # @deprecated Please use {OnyxCord::REST::Server.update_current_member} instead.
   # https://discord.com/developers/docs/resources/user#modify-current-user-nick
   def change_own_nickname(token, server_id, nick, reason = nil)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :guilds_sid_members_me_nick,
       server_id, # This is technically a guild endpoint
       :patch,
-      "#{OnyxCord::API.api_base}/guilds/#{server_id}/members/@me/nick",
+      "#{OnyxCord::REST.api_base}/guilds/#{server_id}/members/@me/nick",
       { nick: nick }.to_json,
       Authorization: token,
       content_type: :json,
@@ -52,11 +52,11 @@ module OnyxCord::API::User
   # Update the properties of the user for the current bot.
   # https://discord.com/developers/docs/resources/user#modify-current-user
   def update_current_user(token, username = :undef, avatar = :undef, banner = :undef)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :users_me,
       nil,
       :patch,
-      "#{OnyxCord::API.api_base}/users/@me",
+      "#{OnyxCord::REST.api_base}/users/@me",
       { username: username, avatar: avatar, banner: banner }.reject { |_, value| value == :undef }.to_json,
       Authorization: token,
       content_type: :json
@@ -66,11 +66,11 @@ module OnyxCord::API::User
   # Get the servers a user is connected to
   # https://discord.com/developers/docs/resources/user#get-current-user-guilds
   def servers(token)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :users_me_guilds,
       nil,
       :get,
-      "#{OnyxCord::API.api_base}/users/@me/guilds",
+      "#{OnyxCord::REST.api_base}/users/@me/guilds",
       Authorization: token
     )
   end
@@ -78,11 +78,11 @@ module OnyxCord::API::User
   # Leave a server
   # https://discord.com/developers/docs/resources/user#leave-guild
   def leave_server(token, server_id)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :users_me_guilds_sid,
       nil,
       :delete,
-      "#{OnyxCord::API.api_base}/users/@me/guilds/#{server_id}",
+      "#{OnyxCord::REST.api_base}/users/@me/guilds/#{server_id}",
       Authorization: token
     )
   end
@@ -90,11 +90,11 @@ module OnyxCord::API::User
   # Get the DMs for the current user
   # https://discord.com/developers/docs/resources/user#get-user-dms
   def user_dms(token)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :users_me_channels,
       nil,
       :get,
-      "#{OnyxCord::API.api_base}/users/@me/channels",
+      "#{OnyxCord::REST.api_base}/users/@me/channels",
       Authorization: token
     )
   end
@@ -102,11 +102,11 @@ module OnyxCord::API::User
   # Create a DM to another user
   # https://discord.com/developers/docs/resources/user#create-dm
   def create_pm(token, recipient_id)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :users_me_channels,
       nil,
       :post,
-      "#{OnyxCord::API.api_base}/users/@me/channels",
+      "#{OnyxCord::REST.api_base}/users/@me/channels",
       { recipient_id: recipient_id }.to_json,
       Authorization: token,
       content_type: :json
@@ -116,11 +116,11 @@ module OnyxCord::API::User
   # Get information about a user's connections
   # https://discord.com/developers/docs/resources/user#get-users-connections
   def connections(token)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :users_me_connections,
       nil,
       :get,
-      "#{OnyxCord::API.api_base}/users/@me/connections",
+      "#{OnyxCord::REST.api_base}/users/@me/connections",
       Authorization: token
     )
   end
@@ -133,7 +133,7 @@ module OnyxCord::API::User
             else
               (discrim_id.to_i >> 22) % 5
             end
-    "#{OnyxCord::API.cdn_url}/embed/avatars/#{index}.png"
+    "#{OnyxCord::REST.cdn_url}/embed/avatars/#{index}.png"
   end
 
   # Make an avatar URL from the user and avatar IDs
@@ -143,7 +143,7 @@ module OnyxCord::API::User
                else
                  'webp'
                end
-    "#{OnyxCord::API.cdn_url}/avatars/#{user_id}/#{avatar_id}.#{format}"
+    "#{OnyxCord::REST.cdn_url}/avatars/#{user_id}/#{avatar_id}.#{format}"
   end
 
   # Make a banner URL from the user and banner IDs
@@ -153,6 +153,6 @@ module OnyxCord::API::User
                else
                  'png'
                end
-    "#{OnyxCord::API.cdn_url}/banners/#{user_id}/#{banner_id}.#{format}"
+    "#{OnyxCord::REST.cdn_url}/banners/#{user_id}/#{banner_id}.#{format}"
   end
 end

data/lib/onyxcord/{api → rest/routes}/webhook.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-require 'onyxcord/message_payload'
+require 'onyxcord/internal/message_payload'
 
 # API calls for Webhook object
-module OnyxCord::API::Webhook
+module OnyxCord::REST::Webhook
   module_function
 
   # Build attachment metadata payload for multipart uploads.
@@ -20,11 +20,11 @@ module OnyxCord::API::Webhook
   # Get a webhook
   # https://discord.com/developers/docs/resources/webhook#get-webhook
   def webhook(token, webhook_id)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :webhooks_wid,
       nil,
       :get,
-      "#{OnyxCord::API.api_base}/webhooks/#{webhook_id}",
+      "#{OnyxCord::REST.api_base}/webhooks/#{webhook_id}",
       Authorization: token
     )
   end
@@ -32,11 +32,11 @@ module OnyxCord::API::Webhook
   # Get a webhook via webhook token
   # https://discord.com/developers/docs/resources/webhook#get-webhook-with-token
   def token_webhook(webhook_token, webhook_id)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :webhooks_wid,
       nil,
       :get,
-      "#{OnyxCord::API.api_base}/webhooks/#{webhook_id}/#{webhook_token}"
+      "#{OnyxCord::REST.api_base}/webhooks/#{webhook_id}/#{webhook_token}"
     )
   end
 
@@ -62,11 +62,11 @@ module OnyxCord::API::Webhook
     with_components = components&.any? || nil
     query = URI.encode_www_form({ wait: wait, with_components: with_components }.compact)
 
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :webhooks_wid,
       webhook_id,
       :post,
-      "#{OnyxCord::API.api_base}/webhooks/#{webhook_id}/#{webhook_token}?#{query}",
+      "#{OnyxCord::REST.api_base}/webhooks/#{webhook_id}/#{webhook_token}?#{query}",
       body,
       headers
     )
@@ -75,11 +75,11 @@ module OnyxCord::API::Webhook
   # Update a webhook
   # https://discord.com/developers/docs/resources/webhook#modify-webhook
   def update_webhook(token, webhook_id, data, reason = nil)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :webhooks_wid,
       webhook_id,
       :patch,
-      "#{OnyxCord::API.api_base}/webhooks/#{webhook_id}",
+      "#{OnyxCord::REST.api_base}/webhooks/#{webhook_id}",
       data.to_json,
       Authorization: token,
       content_type: :json,
@@ -90,11 +90,11 @@ module OnyxCord::API::Webhook
   # Update a webhook via webhook token
   # https://discord.com/developers/docs/resources/webhook#modify-webhook-with-token
   def token_update_webhook(webhook_token, webhook_id, data, reason = nil)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :webhooks_wid,
       webhook_id,
       :patch,
-      "#{OnyxCord::API.api_base}/webhooks/#{webhook_id}/#{webhook_token}",
+      "#{OnyxCord::REST.api_base}/webhooks/#{webhook_id}/#{webhook_token}",
       data.to_json,
       content_type: :json,
       'X-Audit-Log-Reason': reason
@@ -104,11 +104,11 @@ module OnyxCord::API::Webhook
   # Deletes a webhook
   # https://discord.com/developers/docs/resources/webhook#delete-webhook
   def delete_webhook(token, webhook_id, reason = nil)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :webhooks_wid,
       webhook_id,
       :delete,
-      "#{OnyxCord::API.api_base}/webhooks/#{webhook_id}",
+      "#{OnyxCord::REST.api_base}/webhooks/#{webhook_id}",
       Authorization: token,
       'X-Audit-Log-Reason': reason
     )
@@ -117,11 +117,11 @@ module OnyxCord::API::Webhook
   # Deletes a webhook via webhook token
   # https://discord.com/developers/docs/resources/webhook#delete-webhook-with-token
   def token_delete_webhook(webhook_token, webhook_id, reason = nil)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :webhooks_wid,
       webhook_id,
       :delete,
-      "#{OnyxCord::API.api_base}/webhooks/#{webhook_id}/#{webhook_token}",
+      "#{OnyxCord::REST.api_base}/webhooks/#{webhook_id}/#{webhook_token}",
       'X-Audit-Log-Reason': reason
     )
   end
@@ -129,11 +129,11 @@ module OnyxCord::API::Webhook
   # Get a message that was created by the webhook corresponding to the provided token.
   # https://discord.com/developers/docs/resources/webhook#get-webhook-message
   def token_get_message(webhook_token, webhook_id, message_id)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :webhooks_wid_messages_mid,
       webhook_id,
       :get,
-      "#{OnyxCord::API.api_base}/webhooks/#{webhook_id}/#{webhook_token}/messages/#{message_id}"
+      "#{OnyxCord::REST.api_base}/webhooks/#{webhook_id}/#{webhook_token}/messages/#{message_id}"
     )
   end
 
@@ -153,11 +153,11 @@ module OnyxCord::API::Webhook
 
     headers = { content_type: :json } unless attachments
 
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :webhooks_wid_messages,
       webhook_id,
       :patch,
-      "#{OnyxCord::API.api_base}/webhooks/#{webhook_id}/#{webhook_token}/messages/#{message_id}",
+      "#{OnyxCord::REST.api_base}/webhooks/#{webhook_id}/#{webhook_token}/messages/#{message_id}",
       body,
       headers
     )
@@ -166,11 +166,11 @@ module OnyxCord::API::Webhook
   # Delete a webhook message via webhook token.
   # https://discord.com/developers/docs/resources/webhook#delete-webhook-message
   def token_delete_message(webhook_token, webhook_id, message_id)
-    OnyxCord::API.request(
+    OnyxCord::REST.request(
       :webhooks_wid_messages,
       webhook_id,
       :delete,
-      "#{OnyxCord::API.api_base}/webhooks/#{webhook_id}/#{webhook_token}/messages/#{message_id}"
+      "#{OnyxCord::REST.api_base}/webhooks/#{webhook_id}/#{webhook_token}/messages/#{message_id}"
     )
   end
 end

data/lib/onyxcord/{allowed_mentions.rb → utils/allowed_mentions.rb}

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require 'onyxcord/id_object'
+require 'onyxcord/utils/id_object'
 
 module OnyxCord
   # Builder class for `allowed_mentions` when sending messages.

data/lib/onyxcord/utils/timestamp.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module OnyxCord
+  # A timestamp referenced in a message via markdown.
+  class TimestampMarkdown
+    # Mapping of timestamp styles.
+    STYLES = {
+      short_time: 't', # 16:20
+      long_time: 'T', # 16:20:30
+      short_date: 'd', # 20/04/2021
+      long_date: 'D', # 20 April 2021
+      short_datetime: 'f', # 20 April 2021 16:20
+      long_datetime: 'F', # Tuesday, 20 April 2021 16:20
+      relative: 'R', # 2 months ago
+      simple_datetime: 's', # 20/04/2021, 16:20
+      medium_datetime: 'S' # 20/04/2021, 16:20:30
+    }.freeze
+
+    # @return [Time] the time that the timestamp is referencing.
+    attr_reader :time
+
+    # @!visibility private
+    def initialize(time, style)
+      @time = time
+      @style = style
+    end
+
+    # Get the specifier used to determine the style of the timestamp.
+    # @return [String] the formatting specifier used to display the timestamp.
+    def style
+      @style || 'f'
+    end
+
+    # Get a string that will allow you to display the time in the Discord client.
+    # @return [String] The timestamp serialized as a string for the Discord client.
+    def to_s
+      OnyxCord.timestamp(@time, @style)
+    end
+
+    # @!visibility private
+    def inspect
+      "<TimestampMarkdown time=#{@time.to_i} style=\"#{style}\">"
+    end
+
+    # @!method short_time?
+    #   @return [true, false] whether or not the timestamp is displayed in a format such as `16:20`.
+    # @!method long_time?
+    #   @return [true, false] whether or not the timestamp is displayed in a format such as `16:20:30`.
+    # @!method short_date?
+    #   @return [true, false] whether or not the timestamp is displayed in a format such as `20/04/2021`.
+    # @!method long_date?
+    #   @return [true, false] whether or not the timestamp is displayed in a format such as `20 April 2021`.
+    # @!method short_datetime?
+    #   @return [true, false] whether or not the timestamp is displayed in a format such as `20 April 2021 16:20`.
+    # @!method long_datetime?
+    #   @return [true, false] whether or not the timestamp is displayed in a format such as `Tuesday, 20 April 2021 16:20`.
+    # @!method relative?
+    #   @return [true, false] whether or not the timestamp is displayed in a format such as `2 months ago`.
+    # @!method simple_datetime?
+    #   @return [true, false] whether or not the timestamp is displayed in a format such as `20/04/2021, 16:20`.
+    # @!method medium_datetime?
+    #   @return [true, false] whether or not the timestamp is displayed in a format such as ` 20/04/2021, 16:20:30`.
+    STYLES.each do |name, value|
+      define_method("#{name}?") do
+        style == value
+      end
+    end
+  end
+end

data/lib/onyxcord/voice/{voice_bot.rb → client.rb}

@@ -3,7 +3,7 @@
 require 'onyxcord/voice/encoder'
 require 'onyxcord/voice/network'
 require 'onyxcord/voice/timer'
-require 'onyxcord/logger'
+require 'onyxcord/core/logger'
 require 'ffi'
 
 # Voice support
@@ -20,9 +20,9 @@ module OnyxCord::Voice
   #
   # onyxcord does latency adjustments every now and then to improve playback quality. I made sure to put useful
   # defaults for the adjustment parameters, but if the sound is patchy or too fast (or the speed varies a lot) you
-  # should check the parameters and adjust them to your connection: {VoiceBot#adjust_interval},
-  # {VoiceBot#adjust_offset}, and {VoiceBot#adjust_average}.
-  class VoiceBot
+  # should check the parameters and adjust them to your connection: {Client#adjust_interval},
+  # {Client#adjust_offset}, and {Client#adjust_average}.
+  class Client
     # @return [Channel] the current voice channel
     attr_reader :channel
 

data/lib/onyxcord/voice/encoder.rb

@@ -18,7 +18,7 @@ module OnyxCord::Voice
     # @return [true, false] whether avconv should be used instead of ffmpeg.
     attr_accessor :use_avconv
 
-    # @see VoiceBot#filter_volume=
+    # @see Client#filter_volume=
     # @return [Integer] the volume used as a filter to ffmpeg/avconv.
     attr_accessor :filter_volume