onyxcord 2.0.13 → 3.2.0

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,36 +1,30 @@
 # frozen_string_literal: true
 
-require 'onyxcord/message_components'
+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.
   # Returns an array of { id:, filename: } hashes.
   def attachment_payload(attachments)
-    Array(attachments).map.with_index do |attachment, index|
-      { id: index, filename: File.basename(attachment.path) }
-    end
+    OnyxCord::MessagePayload.attachment_payload(attachments)
   end
 
   # Build multipart body with named file fields and JSON payload.
   def multipart_body(body, attachments)
-    files = Array(attachments).map.with_index.to_h do |attachment, index|
-      ["files[#{index}]", attachment]
-    end
-
-    { **files, payload_json: body.to_json }
+    OnyxCord::MessagePayload.multipart_body(body, attachments)
   end
 
   # 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
@@ -38,20 +32,23 @@ 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
 
   # Execute a webhook via token.
   # https://discord.com/developers/docs/resources/webhook#execute-webhook
   def token_execute_webhook(webhook_token, webhook_id, wait = false, content = nil, username = nil, avatar_url = nil, tts = nil, file = nil, embeds = nil, allowed_mentions = nil, flags = nil, components = nil, attachments = nil, poll = nil)
+    raise ArgumentError, 'cannot mix file and attachments' if file && attachments
+
     components = OnyxCord::MessageComponents.payload(components) unless components.nil?
     flags = OnyxCord::MessageComponents.apply_v2_flag(flags, components)
-    body = { content: content, username: username, avatar_url: avatar_url, tts: tts, embeds: embeds&.map(&:to_hash), allowed_mentions: allowed_mentions, flags: flags, components: components, attachments: attachments ? attachment_payload(attachments) : nil, poll: poll }.compact
+    OnyxCord::MessagePayload.validate!(content: content, embeds: embeds, components: components, flags: flags, attachments: attachments, poll: poll)
+    body = { content: content, username: username, avatar_url: avatar_url, tts: tts == true ? true : nil, embeds: embeds&.map(&:to_hash), allowed_mentions: allowed_mentions, flags: flags, components: components&.any? ? components : nil, attachments: attachments ? attachment_payload(attachments) : nil, poll: poll }.compact
 
     body = if file
              { file: file, payload_json: body.to_json }
@@ -65,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
     )
@@ -78,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,
@@ -93,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
@@ -107,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
     )
@@ -120,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
@@ -132,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
 
@@ -145,7 +142,8 @@ module OnyxCord::API::Webhook
   def token_edit_message(webhook_token, webhook_id, message_id, content = nil, embeds = nil, allowed_mentions = nil, components = nil, attachments = nil, flags = nil, poll = nil)
     components = OnyxCord::MessageComponents.payload(components) unless components.nil?
     flags = OnyxCord::MessageComponents.apply_v2_flag(flags, components)
-    body = { content: content, embeds: embeds, allowed_mentions: allowed_mentions, components: components, attachments: attachments ? attachment_payload(attachments) : nil, flags: flags, poll: poll }.compact
+    OnyxCord::MessagePayload.validate!(content: content, embeds: embeds, components: components, flags: flags, attachments: attachments, poll: poll)
+    body = OnyxCord::MessagePayload.edit_body(content, embeds).merge({ allowed_mentions: allowed_mentions, components: components, attachments: attachments ? attachment_payload(attachments) : nil, flags: flags, poll: poll }.compact)
 
     body = if attachments
              multipart_body(body, attachments)
@@ -155,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
     )
@@ -168,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.
@@ -30,6 +30,14 @@ module OnyxCord
       @replied_user = replied_user
     end
 
+    def self.none
+      new(parse: [], users: [], roles: [], replied_user: false)
+    end
+
+    def self.all
+      new(parse: %w[users roles everyone], replied_user: true)
+    end
+
     # @!visibility private
     def to_hash
       {

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
 

data/lib/onyxcord/voice/network/udp.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+module OnyxCord::Voice
+  class VoiceUDP
+    # @return [true, false] whether or not UDP communications are encrypted.
+    # @deprecated Discord no longer supports unencrypted voice communication.
+    attr_accessor :encrypted
+    alias_method :encrypted?, :encrypted
+
+    # Sets the secret key used for encryption
+    attr_writer :secret_key
+
+    # The UDP encryption mode
+    attr_reader :mode
+
+    # @!visibility private
+    attr_writer :mode
+
+    # Creates a new UDP connection. Only creates a socket as the discovery reply may come before the data is
+    # initialized.
+    def initialize
+      @socket = UDPSocket.new
+      @encrypted = true
+    end
+
+    # Initializes the UDP socket with data obtained from opcode 2.
+    # @param ip [String] The IP address to connect to.
+    # @param port [Integer] The port to connect to.
+    # @param ssrc [Integer] The Super Secret Relay Code (SSRC). Discord uses this to identify different voice users
+    #   on the same endpoint.
+    def connect(ip, port, ssrc)
+      @ip = ip
+      @port = port
+      @ssrc = ssrc
+    end
+
+    # Waits for a UDP discovery reply, and returns the sent data.
+    # @return [Array(String, Integer)] the IP and port received from the discovery reply.
+    def receive_discovery_reply
+      # Wait for a UDP message
+      message = @socket.recv(74)
+      ip = message[8..-3].delete("\0")
+      port = message[-2..].unpack1('n')
+      [ip, port]
+    end
+
+    # Makes an audio packet from a buffer and sends it to Discord.
+    # @param buf [String] The audio data to send, must be exactly one Opus frame
+    # @param sequence [Integer] The packet sequence number, incremented by one for subsequent packets
+    # @param time [Integer] When this packet should be played back, in no particular unit (essentially just the
+    #   sequence number multiplied by 960)
+    def send_audio(buf, sequence, time)
+      # Header of the audio packet
+      header = generate_header(sequence, time)
+
+      nonce = generate_nonce
+      buf = encrypt_audio(buf, header, nonce)
+      data = header + buf + nonce.byteslice(0, 4)
+
+      send_packet(data)
+    end
+
+    # Sends the UDP discovery packet with the internally stored SSRC. Discord will send a reply afterwards which can
+    # be received using {#receive_discovery_reply}
+    def send_discovery
+      # Create empty packet
+      discovery_packet = ''
+
+      # Add Type request (0x1 = request, 0x2 = response)
+      discovery_packet += [0x1].pack('n')
+
+      # Add Length (excluding Type and itself = 70)
+      discovery_packet += [70].pack('n')
+
+      # Add SSRC
+      discovery_packet += [@ssrc].pack('N')
+
+      # Add 66 zeroes so the packet is 74 bytes long
+      discovery_packet += "\0" * 66
+
+      send_packet(discovery_packet)
+    end
+
+    def close
+      @socket.close unless @socket.closed?
+    end
+
+    private
+
+    # Encrypts audio data using libsodium
+    # @param buf [String] The encoded audio data to be encrypted
+    # @param header [String] The RTP header of the packet, used as associated data
+    # @param nonce [String] The nonce to be used to encrypt the data
+    # @return [String] the audio data, encrypted
+    def encrypt_audio(buf, header, nonce)
+      raise 'No secret key found, despite encryption being enabled!' unless @secret_key
+
+      case @mode
+      when 'aead_xchacha20_poly1305_rtpsize'
+        OnyxCord::Voice::XChaCha20AEAD.encrypt(buf, header, nonce, @secret_key)
+      else
+        raise "`#{@mode}' is not a supported encryption mode"
+      end
+    end
+
+    def send_packet(packet)
+      @socket.send(packet, 0, @ip, @port)
+    end
+
+    # @return [String]
+    def generate_nonce
+      case @mode
+      when 'aead_xchacha20_poly1305_rtpsize'
+        case @incremental_nonce
+        when nil, 0xff_ff_ff_ff
+          @incremental_nonce = 0
+        else
+          @incremental_nonce += 1
+        end
+        [@incremental_nonce].pack('N').ljust(24, "\0")
+      else
+        raise "`#{@mode}' is not a supported encryption mode"
+      end
+    end
+
+    # @return [String]
+    def generate_header(sequence, time)
+      [0x80, 0x78, sequence, time, @ssrc].pack('CCnNN')
+    end
+  end
+
+  # Represents a websocket client connection to the voice server. The websocket connection (sometimes called vWS) is
+  # used to manage general data about the connection, such as sending the speaking packet, which determines the green
+  # circle around users on Discord, and obtaining UDP connection info.
+end