matrix_sdk 1.5.0 → 2.0.0

data/lib/matrix_sdk/extensions.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module URI
+  # A mxc:// Matrix content URL
   class MATRIX < Generic
     def full_path
       select(:host, :port, :path, :query, :fragment)

data/lib/matrix_sdk/mxid.rb

@@ -17,9 +17,31 @@ module MatrixSdk
       raise ArgumentError, 'Identifier is not a valid MXID' unless valid?
     end
 
-    def to_s
+    # Gets the homeserver part of the ID
+    #
+    # @example A simple MXID
+    #   id = MXID.new('@alice:example.org')
+    #   id.homeserver
+    #   # => 'example.org'
+    #
+    # @example A fully qualified MXID
+    #   id = MXID.new('@user:some.direct.domain:443')
+    #   id.homeserver
+    #   # => 'some.direct.domain:443'
+    #
+    # @return [String]
+    def homeserver
       port_s = port ? ':' + port.to_s : ''
-      "#{sigil}#{localpart}#{domain ? ':' + domain + port_s : ''}"
+      domain ? domain + port_s : ''
+    end
+
+    # Gets the homserver part of the ID as a suffix (':homeserver')
+    def homeserver_suffix
+      ':' + homeserver if domain
+    end
+
+    def to_s
+      "#{sigil}#{localpart}#{homeserver_suffix}"
     end
 
     # Returns the type of the ID

data/lib/matrix_sdk/protocols/cs.rb

@@ -9,7 +9,7 @@ module MatrixSdk::Protocols::CS
   #   api.client_api_versions
   #   # => [ 'r0.1.0', 'r0.2.0', ...
   #   api.client_api_versions.latest
-  #   # => 'r0.5.0'
+  #   # => 'latest'
   def client_api_versions
     (@client_api_versions ||= request(:get, :client, '/versions')).versions.tap do |vers|
       vers.instance_eval <<-'CODE', __FILE__, __LINE__ + 1
@@ -53,7 +53,7 @@ module MatrixSdk::Protocols::CS
   # @option params [Boolean] :full_state Should the sync include the full state
   # @option params [Boolean] :set_presence Should the sync set the user status to online
   # @return [Response]
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#get-matrix-client-r0-sync
+  # @see https://matrix.org/docs/spec/client_server/latest.html#get-matrix-client-r0-sync
   #      For more information on the parameters and what they mean
   def sync(timeout: 30.0, **params)
     query = params.select do |k, _v|
@@ -80,7 +80,7 @@ module MatrixSdk::Protocols::CS
   # @option params [Boolean] :store_token (true) Should the resulting access token be stored for the API
   # @option params [Boolean] :store_device_id (store_token value) Should the resulting device ID be stored for the API
   # @return [Response]
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#post-matrix-client-r0-register
+  # @see https://matrix.org/docs/spec/client_server/latest.html#post-matrix-client-r0-register
   #      For options that are permitted in this call
   def register(kind: 'user', **params)
     query = {}
@@ -96,6 +96,48 @@ module MatrixSdk::Protocols::CS
     end
   end
 
+  # Requests to register an email address to the current account
+  #
+  # @param secret [String] A random string containing only the characters `[0-9a-zA-Z.=_-]`
+  # @param email [String] The email address to register
+  # @param attempt [Integer] The current attempt count to register the email+secret combo, increase to send another verification email
+  # @param next_link [String,URI] An URL to redirect to after verification is finished
+  # @return [Response] A hash containing the :sid id for the current request
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-register-email-requesttoken
+  #      For options that are permitted in this call
+  def register_email_request(secret, email, attempt: 1, next_link: nil)
+    body = {
+      client_secret: secret,
+      email: email,
+      send_attempt: attempt,
+      next_link: next_link
+    }.compact
+
+    request(:post, :client_r0, '/register/email/requestToken', body: body)
+  end
+
+  # Requests to register a phone number to the current account
+  #
+  # @param secret [String] A random string containing only the characters `[0-9a-zA-Z.=_-]`
+  # @param country [String] The two-letter ISO-3166-1 country identifier of the destination country of the number
+  # @param number [String] The phone number itself
+  # @param attempt [Integer] The current attempt count to register the email+secret combo, increase to send another verification email
+  # @param next_link [String,URI] An URL to redirect to after verification is finished
+  # @return [Response] A hash containing the :sid id for the current request
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-register-email-requesttoken
+  #      For options that are permitted in this call
+  def register_msisdn_request(secret, country, number, attempt: 1, next_link: nil)
+    body = {
+      client_secret: secret,
+      country: country,
+      phone_number: number,
+      send_attempt: attempt,
+      next_link: next_link
+    }.compact
+
+    request(:post, :client_r0, '/register/msisdn/requestToken', body: body)
+  end
+
   # Checks if a given username is available and valid for registering
   #
   # @example Verifying a username
@@ -132,7 +174,7 @@ module MatrixSdk::Protocols::CS
   # @option params [String] :initial_device_display_name (USER_AGENT) The device display name to specify for this login attempt
   # @option params [String] :device_id The device ID to set on the login
   # @return [Response] A response hash with the parameters :user_id, :access_token, :home_server, and :device_id.
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#post-matrix-client-r0-login
+  # @see https://matrix.org/docs/spec/client_server/latest.html#post-matrix-client-r0-login
   #      The Matrix Spec, for more information about the call and response
   def login(login_type: 'm.login.password', **params)
     query = {}
@@ -154,9 +196,9 @@ module MatrixSdk::Protocols::CS
     end
   end
 
-  # Logs out the currently logged in user
+  # Logs out the currently logged in device for the current user
   # @return [Response] An empty response if the logout was successful
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#post-matrix-client-r0-logout
+  # @see https://matrix.org/docs/spec/client_server/latest.html#post-matrix-client-r0-logout
   #      The Matrix Spec, for more information about the call and response
   def logout(**params)
     query = {}
@@ -165,6 +207,176 @@ module MatrixSdk::Protocols::CS
     request(:post, :client_r0, '/logout', query: query)
   end
 
+  # Logs out the currently logged in user
+  # @return [Response] An empty response if the logout was successful
+  # @see https://matrix.org/docs/spec/client_server/latest.html#post-matrix-client-r0-logout-all
+  #      The Matrix Spec, for more information about the call and response
+  def logout_all(**params)
+    query = {}
+    query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
+
+    request(:post, :client_r0, '/logout/all', query: query)
+  end
+
+  # Changes the users password
+  # @param new_password [String] The new password
+  # @param auth [Hash] An auth object returned from an interactive auth query
+  # @return [Response] An empty response if the password change was successful
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-account-password
+  #      The Matrix Spec, for more information about the call and response
+  def change_password(new_password, auth:, **params)
+    query = {}
+    query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
+
+    # raise Error unless auth.is_a?(Hash) && auth.key? :type
+
+    body = {
+      new_password: new_password,
+      auth: auth
+    }
+
+    request(:post, :client_r0, '/account/password', body: body, query: query)
+  end
+
+  # Requests an authentication token based on an email address
+  #
+  # @param secret [String] A random string containing only the characters `[0-9a-zA-Z.=_-]`
+  # @param email [String] The email address to register
+  # @param attempt [Integer] The current attempt count to register the email+secret combo, increase to send another verification email
+  # @param next_link [String,URI] An URL to redirect to after verification is finished
+  # @return [Response] A hash containing the :sid id for the current request
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-account-password-email-requesttoken
+  #      For options that are permitted in this call
+  def request_email_login_token(secret, email, attempt: 1, next_link: nil)
+    body = {
+      client_secret: secret,
+      email: email,
+      send_attempt: attempt,
+      next_link: next_link
+    }.compact
+
+    request(:post, :client_r0, '/account/password/email/requestToken', body: body)
+  end
+
+  # Requests an authentication token based on a phone number
+  #
+  # @param secret [String] A random string containing only the characters `[0-9a-zA-Z.=_-]`
+  # @param country [String] The two-letter ISO-3166-1 country identifier of the destination country of the number
+  # @param number [String] The phone number itself
+  # @param attempt [Integer] The current attempt count to register the email+secret combo, increase to send another verification email
+  # @param next_link [String,URI] An URL to redirect to after verification is finished
+  # @return [Response] A hash containing the :sid id for the current request
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-account-password-msisdn-requesttoken
+  #      For options that are permitted in this call
+  def request_msisdn_login_token(secret, country, number, attempt: 1, next_link: nil)
+    body = {
+      client_secret: secret,
+      country: country,
+      phone_number: number,
+      send_attempt: attempt,
+      next_link: next_link
+    }.compact
+
+    request(:post, :client_r0, '/account/password/msisdn/requestToken', body: body)
+  end
+
+  # Deactivates the current account, logging out all connected devices and preventing future logins
+  #
+  # @param auth_data [Hash] Interactive authentication data to verify the request
+  # @param id_server [String] Override the ID server to unbind all 3PIDs from
+  # @return [Response]
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-account-deactivate
+  #      For options that are permitted in this call
+  def deactivate_account(auth_data, id_server: nil)
+    body = {
+      auth: auth_data,
+      id_server: id_server
+    }.compact
+
+    request(:post, :client_r0, '/account/deactivate', body: body)
+  end
+
+  def get_3pids(**params)
+    query = {}
+    query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
+
+    request(:get, :client_r0, '/account/3pid', query: query)
+  end
+
+  # Finishes a 3PID addition to the current user
+  #
+  # @param secret [String] The shared secret with the HS
+  # @param session [String] The session ID to finish the request for
+  # @param auth_data [Hash] Interactive authentication data to verify the request
+  # @return [Response]
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-account-3pid-add
+  #      For options that are permitted in this call
+  def complete_3pid_add(secret:, session:, auth_data: nil)
+    body = {
+      sid: session,
+      client_secret: secret,
+      auth: auth_data
+    }.compact
+
+    request(:post, :client_r0, '/account/3pid/add', body: body)
+  end
+
+  # Finishes binding a 3PID to the current user
+  #
+  # @param secret [String] The shared secret with the identity server
+  # @param id_server [String] The identity server being acted against
+  # @param id_server_token [String] A previous identity server token
+  # @param session [String] The session ID to finish the bind for
+  # @return [Response]
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-account-3pid-bind
+  #      For options that are permitted in this call
+  def bind_3pid(secret:, id_server:, id_server_token:, session:)
+    body = {
+      client_secret: secret,
+      id_server: id_server,
+      id_server_token: id_server_token,
+      sid: session
+    }
+
+    request(:post, :client_r0, '/account/3pid/bind', body: body)
+  end
+
+  # Deletes a 3PID from the current user, this method might not unbind it from the identity server
+  #
+  # @param medium [:email,:msisdn] The medium of 3PID being removed
+  # @param address [String] The address that is to be removed
+  # @param id_server [String] The identity server being acted against
+  # @return [Response]
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-account-3pid-delete
+  #      For options that are permitted in this call
+  def delete_3pid(medium, address, id_server:)
+    body = {
+      address: address,
+      id_server: id_server,
+      medium: medium
+    }
+
+    request(:post, :client_r0, '/account/3pid/delete', body: body)
+  end
+
+  # Unbinds a 3PID from the current user
+  #
+  # @param medium [:email,:msisdn] The medium of 3PID being removed
+  # @param address [String] The address that is to be removed
+  # @param id_server [String] The identity server being acted against
+  # @return [Response]
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-account-3pid-unbind
+  #      For options that are permitted in this call
+  def unbind_3pid(medium, address, id_server:)
+    body = {
+      address: address,
+      id_server: id_server,
+      medium: medium
+    }
+
+    request(:post, :client_r0, '/account/3pid/unbind', body: body)
+  end
+
   # Gets the list of rooms joined by the current user
   #
   # @return [Response] An array of room IDs under the key :joined_rooms
@@ -215,7 +427,7 @@ module MatrixSdk::Protocols::CS
   # @option params [String] :room_alias A room alias to apply on creation
   # @option params [Boolean] :invite Should the room be created invite-only
   # @return [Response] A response hash with ...
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#post-matrix-client-r0-createroom
+  # @see https://matrix.org/docs/spec/client_server/latest.html#post-matrix-client-r0-createroom
   #      The Matrix Spec, for more information about the call and response
   def create_room(visibility: :public, **params)
     query = {}
@@ -236,7 +448,7 @@ module MatrixSdk::Protocols::CS
   # @param params [Hash] Extra room join options
   # @option params [String[]] :server_name A list of servers to perform the join through
   # @return [Response] A response hash with the parameter :room_id
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#post-matrix-client-r0-join-roomidoralias
+  # @see https://matrix.org/docs/spec/client_server/latest.html#post-matrix-client-r0-join-roomidoralias
   #      The Matrix Spec, for more information about the call and response
   # @todo Add support for 3rd-party signed objects
   def join_room(id_or_alias, **params)
@@ -259,8 +471,8 @@ module MatrixSdk::Protocols::CS
   # @param params [Hash] Options for the request
   # @option params [String] :state_key The state key of the event, if there is one
   # @return [Response] A response hash with the parameter :event_id
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#put-matrix-client-r0-rooms-roomid-state-eventtype-statekey
-  #      https://matrix.org/docs/spec/client_server/r0.5.0.html#put-matrix-client-r0-rooms-roomid-state-eventtype
+  # @see https://matrix.org/docs/spec/client_server/latest.html#put-matrix-client-r0-rooms-roomid-state-eventtype-statekey
+  #      https://matrix.org/docs/spec/client_server/latest.html#put-matrix-client-r0-rooms-roomid-state-eventtype
   #      The Matrix Spec, for more information about the call and response
   def send_state_event(room_id, event_type, content, **params)
     query = {}
@@ -280,7 +492,7 @@ module MatrixSdk::Protocols::CS
   # @param params [Hash] Options for the request
   # @option params [Integer] :txn_id The ID of the transaction, or automatically generated
   # @return [Response] A response hash with the parameter :event_id
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#put-matrix-client-r0-rooms-roomid-send-eventtype-txnid
+  # @see https://matrix.org/docs/spec/client_server/latest.html#put-matrix-client-r0-rooms-roomid-send-eventtype-txnid
   #      The Matrix Spec, for more information about the call and response
   def send_message_event(room_id, event_type, content, **params)
     query = {}
@@ -303,7 +515,7 @@ module MatrixSdk::Protocols::CS
   # @option params [String] :reason The reason for the redaction
   # @option params [Integer] :txn_id The ID of the transaction, or automatically generated
   # @return [Response] A response hash with the parameter :event_id
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#put-matrix-client-r0-rooms-roomid-redact-eventid-txnid
+  # @see https://matrix.org/docs/spec/client_server/latest.html#put-matrix-client-r0-rooms-roomid-redact-eventid-txnid
   #      The Matrix Spec, for more information about the call and response
   def redact_event(room_id, event_id, **params)
     query = {}
@@ -358,10 +570,10 @@ module MatrixSdk::Protocols::CS
   # @option params [Hash] :extra_content Extra data to insert into the content hash
   # @return [Response] A response hash with the parameter :event_id
   # @see send_message_event For more information on the underlying call
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-image
-  #      https://matrix.org/docs/spec/client_server/r0.5.0.html#m-file
-  #      https://matrix.org/docs/spec/client_server/r0.5.0.html#m-video
-  #      https://matrix.org/docs/spec/client_server/r0.5.0.html#m-audio
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-image
+  #      https://matrix.org/docs/spec/client_server/latest.html#m-file
+  #      https://matrix.org/docs/spec/client_server/latest.html#m-video
+  #      https://matrix.org/docs/spec/client_server/latest.html#m-audio
   #      The Matrix Spec, for more information about the call and response
   def send_content(room_id, url, name, msg_type, **params)
     content = {
@@ -386,7 +598,7 @@ module MatrixSdk::Protocols::CS
   # @option params [Hash] :thumbnail_info Image information about the location thumbnail
   # @return [Response] A response hash with the parameter :event_id
   # @see send_message_event For more information on the underlying call
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-location
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-location
   #      The Matrix Spec, for more information about the call and response
   def send_location(room_id, geo_uri, name, **params)
     content = {
@@ -409,7 +621,7 @@ module MatrixSdk::Protocols::CS
   # @option params [String] :msg_type ('m.text') The message type to send
   # @return [Response] A response hash with the parameter :event_id
   # @see send_message_event For more information on the underlying call
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-text
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-text
   #      The Matrix Spec, for more information about the call and response
   def send_message(room_id, message, **params)
     content = {
@@ -427,7 +639,7 @@ module MatrixSdk::Protocols::CS
   # @option params [String] :msg_type ('m.emote') The message type to send
   # @return [Response] A response hash with the parameter :event_id
   # @see send_message_event For more information on the underlying call
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-emote
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-emote
   #      The Matrix Spec, for more information about the call and response
   def send_emote(room_id, emote, **params)
     content = {
@@ -445,7 +657,7 @@ module MatrixSdk::Protocols::CS
   # @option params [String] :msg_type ('m.notice') The message type to send
   # @return [Response] A response hash with the parameter :event_id
   # @see send_message_event For more information on the underlying call
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-notice
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-notice
   #      The Matrix Spec, for more information about the call and response
   def send_notice(room_id, notice, **params)
     content = {
@@ -455,6 +667,29 @@ module MatrixSdk::Protocols::CS
     send_message_event(room_id, 'm.room.message', content, params)
   end
 
+  # Report an event in a room
+  #
+  # @param room_id [MXID,String] The room ID in which the event occurred
+  # @param room_id [MXID,String] The event ID to report
+  # @param score [Integer] The severity of the report, range between -100 - 0
+  # @param reason [String] The reason for the report
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-rooms-roomid-report-eventid
+  #      The Matrix Spec, for more information about the call and response
+  def report_event(room_id, event_id, score:, reason:, **params)
+    query = {}
+    query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
+
+    body = {
+      score: score,
+      reason: reason
+    }
+
+    room_id = ERB::Util.url_encode room_id.to_s
+    event_id = ERB::Util.url_encode event_id.to_s
+
+    request(:post, :client_r0, "/rooms/#{room_id}/report/#{event_id}", body: body, query: query)
+  end
+
   # Retrieve additional messages in a room
   #
   # @param room_id [MXID,String] The room ID to retrieve messages for
@@ -465,7 +700,7 @@ module MatrixSdk::Protocols::CS
   # @option params [String] :to A token to limit retrieval to
   # @option params [String] :filter A filter to limit the retrieval to
   # @return [Response] A response hash with the message information containing :start, :end, and :chunk fields
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#get-matrix-client-r0-rooms-roomid-messages
+  # @see https://matrix.org/docs/spec/client_server/latest.html#get-matrix-client-r0-rooms-roomid-messages
   #      The Matrix Spec, for more information about the call and response
   def get_room_messages(room_id, token, direction, limit: 10, **params)
     query = {
@@ -482,14 +717,31 @@ module MatrixSdk::Protocols::CS
     request(:get, :client_r0, "/rooms/#{room_id}/messages", query: query)
   end
 
+  # Gets a specific event from a room
+  #
+  # @param room_id [MXID,String] The room ID to read from
+  # @param event_id [MXID,String] The event ID to retrieve
+  # @return [Response] A response hash with the contents of the event
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-rooms-roomid-event-eventid
+  #      The Matrix Spec, for more information about the call and response
+  def get_room_event(room_id, event_id, **params)
+    query = {}
+    query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
+
+    room_id = ERB::Util.url_encode room_id.to_s
+    event_id = ERB::Util.url_encode event_id.to_s
+
+    request(:get, :client_r0, "/rooms/#{room_id}/event/#{event_id}", query: query)
+  end
+
   # Reads the latest instance of a room state event
   #
   # @param room_id [MXID,String] The room ID to read from
   # @param state_type [String] The state type to read
   # @return [Response] A response hash with the contents of the state event
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#get-matrix-client-r0-rooms-roomid-state-eventtype
+  # @see https://matrix.org/docs/spec/client_server/latest.html#get-matrix-client-r0-rooms-roomid-state-eventtype
   #      The Matrix Spec, for more information about the call and response
-  def get_room_state(room_id, state_type = nil, key: nil, **params)
+  def get_room_state(room_id, state_type, key: nil, **params)
     query = {}
     query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
 
@@ -497,7 +749,22 @@ module MatrixSdk::Protocols::CS
     state_type = ERB::Util.url_encode state_type.to_s
     key = ERB::Util.url_encode key.to_s
 
-    request(:get, :client_r0, "/rooms/#{room_id}/state#{state_type.empty? ? nil : "/#{state_type}"}#{key.empty? ? nil : "/#{key}"}", query: query)
+    request(:get, :client_r0, "/rooms/#{room_id}/state/#{state_type}#{key.empty? ? nil : "/#{key}"}", query: query)
+  end
+
+  # Retrieves all current state objects from a room
+  #
+  # @param room_id [MXID,String] The room ID to read from
+  # @return [Response] A response hash with the contents of all state events
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-rooms-roomid-event-eventid
+  #      The Matrix Spec, for more information about the call and response
+  def get_room_state_all(room_id, **params)
+    query = {}
+    query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
+
+    room_id = ERB::Util.url_encode room_id.to_s
+
+    request(:get, :client_r0, "/rooms/#{room_id}/state", query: query)
   end
 
   ## Specialized getters for specced state
@@ -510,7 +777,7 @@ module MatrixSdk::Protocols::CS
   # @return [Response] A response hash with the parameter :name
   # @raise [MatrixNotFoundError] Raised if no name has been set on the room
   # @see get_room_state
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-name
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-name
   #      The Matrix Spec, for more information about the event and data
   def get_room_name(room_id, **params)
     get_room_state(room_id, 'm.room.name', params)
@@ -522,7 +789,7 @@ module MatrixSdk::Protocols::CS
   # @param [String] name The new name of the room
   # @param [Hash] params Extra options to set on the request, see #send_state_event
   # @return [Response] The resulting state event
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-name
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-name
   #      The Matrix Spec, for more information about the event and data
   def set_room_name(room_id, name, **params)
     content = {
@@ -538,7 +805,7 @@ module MatrixSdk::Protocols::CS
   # @return [Response] A response hash with the parameter :topic
   # @raise [MatrixNotFoundError] Raised if no topic has been set on the room
   # @see get_room_state
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-topic
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-topic
   #      The Matrix Spec, for more information about the event and data
   def get_room_topic(room_id, **params)
     get_room_state(room_id, 'm.room.topic', params)
@@ -550,7 +817,7 @@ module MatrixSdk::Protocols::CS
   # @param [String] topic The new topic of the room
   # @param [Hash] params Extra options to set on the request, see #send_state_event
   # @return [Response] The resulting state event
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-topic
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-topic
   #      The Matrix Spec, for more information about the event and data
   def set_room_topic(room_id, topic, **params)
     content = {
@@ -566,7 +833,7 @@ module MatrixSdk::Protocols::CS
   # @return [Response] A response hash with the parameters :url and (optionally) :info
   # @raise [MatrixNotFoundError] Raised if no avatar has been set on the room
   # @see get_room_state
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-avatar
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-avatar
   #      The Matrix Spec, for more information about the event and data
   def get_room_avatar(room_id, **params)
     get_room_state(room_id, 'm.room.avatar', params)
@@ -578,7 +845,7 @@ module MatrixSdk::Protocols::CS
   # @param [String,URI] url The new avatar URL for the room
   # @param [Hash] params Extra options to set on the request, see #send_state_event
   # @return [Response] The resulting state event
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-avatar
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-avatar
   #      The Matrix Spec, for more information about the event and data
   def set_room_avatar(room_id, url, **params)
     content = {
@@ -594,7 +861,7 @@ module MatrixSdk::Protocols::CS
   # @return [Response] A response hash with the array :aliases
   # @raise [MatrixNotFoundError] Raised if no aliases has been set on the room by the specified HS
   # @see get_room_state
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-avatar
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-avatar
   #      The Matrix Spec, for more information about the event and data
   # @example Looking up aliases for a room
   #   api.get_room_aliases('!QtykxKocfZaZOUrTwp:matrix.org')
@@ -621,7 +888,7 @@ module MatrixSdk::Protocols::CS
   # @return [Response] A response hash with the array :pinned
   # @raise [MatrixNotFoundError] Raised if no aliases has been set on the room by the specified HS
   # @see get_room_state
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-pinned-events
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-pinned-events
   #      The Matrix Spec, for more information about the event and data
   def get_room_pinned_events(room_id, **params)
     get_room_state(room_id, 'm.room.pinned_events', params)
@@ -633,7 +900,7 @@ module MatrixSdk::Protocols::CS
   # @param [Array[String]] events The new list of events to set as pinned
   # @param [Hash] params Extra options to set on the request, see #send_state_event
   # @return [Response] The resulting state event
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-pinned-events
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-pinned-events
   #      The Matrix Spec, for more information about the event and data
   def set_room_pinned_events(room_id, events, **params)
     content = {
@@ -648,7 +915,7 @@ module MatrixSdk::Protocols::CS
   # @param [Hash] params Extra options to provide to the request, see #get_room_state
   # @return [Response] A response hash with power level information
   # @see get_room_state
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-power-levels
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-power-levels
   #      The Matrix Spec, for more information about the event and data
   def get_room_power_levels(room_id, **params)
     get_room_state(room_id, 'm.room.power_levels', params)
@@ -661,7 +928,7 @@ module MatrixSdk::Protocols::CS
   # @param [Hash] content The new power level configuration
   # @param [Hash] params Extra options to set on the request, see #send_state_event
   # @return [Response] The resulting state event
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-power-levels
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-power-levels
   #      The Matrix Spec, for more information about the event and data
   def set_room_power_levels(room_id, content, **params)
     content[:events] = {} unless content.key? :events
@@ -675,7 +942,7 @@ module MatrixSdk::Protocols::CS
   # @param [Hash] params Extra options to provide to the request, see #get_room_state
   # @return [Response] A response hash with the key :join_rule
   # @see get_room_state
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-join-rules
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-join-rules
   #      The Matrix Spec, for more information about the event and data
   def get_room_join_rules(room_id, **params)
     get_room_state(room_id, 'm.room.join_rules', params)
@@ -687,7 +954,7 @@ module MatrixSdk::Protocols::CS
   # @param [String,Symbol] join_rule The new join rule setting (Currently only public and invite are implemented)
   # @param [Hash] params Extra options to set on the request, see #send_state_event
   # @return [Response] The resulting state event
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-join-rules
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-join-rules
   #      The Matrix Spec, for more information about the event and data
   def set_room_join_rules(room_id, join_rule, **params)
     content = {
@@ -703,7 +970,7 @@ module MatrixSdk::Protocols::CS
   # @param [Hash] params Extra options to provide to the request, see #get_room_state
   # @return [Response] A response hash with the key :guest_acces, either :can_join or :forbidden
   # @see get_room_state
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-guest-access
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-guest-access
   #      The Matrix Spec, for more information about the event and data
   def get_room_guest_access(room_id, **params)
     get_room_state(room_id, 'm.room.guest_access', params)
@@ -715,7 +982,7 @@ module MatrixSdk::Protocols::CS
   # @param [:can_join, :forbidden] guest_access The new guest access setting for the room
   # @param [Hash] params Extra options to set on the request, see #send_state_event
   # @return [Response] The resulting state event
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-guest-access
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-guest-access
   #      The Matrix Spec, for more information about the event and data
   def set_room_guest_access(room_id, guest_access, **params)
     content = {
@@ -731,7 +998,7 @@ module MatrixSdk::Protocols::CS
   # @param [Hash] params Extra options to provide to the request, see #get_room_state
   # @return [Response] A response hash with the configuration the room was created for
   # @see get_room_state
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-create
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-create
   #      The Matrix Spec, for more information about the event and data
   def get_room_creation_info(room_id, **params)
     get_room_state(room_id, 'm.room.create', params)
@@ -743,7 +1010,7 @@ module MatrixSdk::Protocols::CS
   # @param [Hash] params Extra options to provide to the request, see #get_room_state
   # @return [Response] A response hash with the configuration the room was created for
   # @see get_room_state
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-encryption
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-encryption
   #      The Matrix Spec, for more information about the event and data
   def get_room_encryption_settings(room_id, **params)
     get_room_state(room_id, 'm.room.encryption', params)
@@ -757,7 +1024,7 @@ module MatrixSdk::Protocols::CS
   # @param [Integer] rotation_period_msgs The interval between key rotation in messages
   # @param [Hash] params Extra options to set on the request, see #send_state_event
   # @return [Response] The resulting state event
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-guest-encryption
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-guest-encryption
   #      The Matrix Spec, for more information about the event and data
   def set_room_encryption_settings(room_id, algorithm: 'm.megolm.v1.aes-sha2', rotation_period_ms: 1 * 7 * 24 * 60 * 60 * 1000, rotation_period_msgs: 100, **params)
     content = {
@@ -774,7 +1041,7 @@ module MatrixSdk::Protocols::CS
   # @param [Hash] params Extra options to provide to the request, see #get_room_state
   # @return [Response] A response hash with the key :history_visibility
   # @see get_room_state
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-history-visibility
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-history-visibility
   #      The Matrix Spec, for more information about the event and data
   def get_room_history_visibility(room_id, **params)
     get_room_state(room_id, 'm.room.history_visibility', params)
@@ -786,7 +1053,7 @@ module MatrixSdk::Protocols::CS
   # @param [:invited, :joined, :shared, :world_readable] visibility The new history visibility level
   # @param [Hash] params Extra options to set on the request, see #send_state_event
   # @return [Response] The resulting state event
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-guest-history-visibility
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-guest-history-visibility
   #      The Matrix Spec, for more information about the event and data
   def set_room_history_visibility(room_id, visibility, **params)
     content = {
@@ -802,7 +1069,7 @@ module MatrixSdk::Protocols::CS
   # @param [Hash] params Extra options to provide to the request, see #get_room_state
   # @return [Response] A response hash with server ACL information
   # @see get_room_state
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-server-acl
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-server-acl
   #      The Matrix Spec, for more information about the event and data
   def get_room_server_acl(room_id, **params)
     get_room_state(room_id, 'm.room.server_acl', params)
@@ -816,7 +1083,7 @@ module MatrixSdk::Protocols::CS
   # @param [Array[String]] deny A list of HS wildcards that are denied from communicating with the room
   # @param [Hash] params Extra options to set on the request, see #send_state_event
   # @return [Response] The resulting state event
-  # @see https://matrix.org/docs/spec/client_server/r0.5.0.html#m-room-guest-server-acl
+  # @see https://matrix.org/docs/spec/client_server/latest.html#m-room-guest-server-acl
   #      The Matrix Spec, for more information about the event and data
   def set_room_server_acl(room_id, allow_ip_literals: false, allow:, deny:, **params)
     content = {
@@ -846,6 +1113,26 @@ module MatrixSdk::Protocols::CS
     request(:post, :client_r0, "/rooms/#{room_id}/forget", query: query)
   end
 
+  # Directly joins a room by ID
+  #
+  # @param room_id [MXID,String] The room ID to join
+  # @param third_party_signed [Hash] The 3PID signature allowing the user to join
+  # @return [Response] A response hash with the parameter :room_id
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-rooms-roomid-join
+  #      The Matrix Spec, for more information about the call and response
+  def join_room_id(room_id, third_party_signed: nil, **params)
+    query = {}
+    query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
+
+    body = {
+      third_party_signed: third_party_signed
+    }.compact
+
+    room_id = ERB::Util.url_encode room_id.to_s
+
+    request(:post, :client_r0, "/rooms/#{room_id}/join", body: body, query: query)
+  end
+
   def invite_user(room_id, user_id, **params)
     query = {}
     query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
@@ -918,6 +1205,41 @@ module MatrixSdk::Protocols::CS
     request(:post, :client_r0, "/rooms/#{room_id}/unban", body: content, query: query)
   end
 
+  # Gets the room directory visibility status for a room
+  #
+  # @param [MXID,String] room_id The room ID to look up
+  # @return [Response] A response hash with a :visibility key
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-directory-list-room-roomid
+  #      The Matrix Spec, for more information about the event and data
+  def get_room_directory_visibility(room_id, **params)
+    query = {}
+    query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
+
+    room_id = ERB::Util.url_encode room_id.to_s
+
+    request(:get, :client_r0, "/directory/list/room/#{room_id}", query: query)
+  end
+
+  # Sets the room directory visibility status for a room
+  #
+  # @param [MXID,String] room_id The room ID to change visibility for
+  # @param [:public,:private] visibility The new visibility status
+  # @return [Response] An empty response hash if the visibilty change succeeded
+  # @see https://matrix.org/docs/spec/client_server/latest#put-matrix-client-r0-directory-list-room-roomid
+  #      The Matrix Spec, for more information about the event and data
+  def set_room_directory_visibility(room_id, visibility, **params)
+    query = {}
+    query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
+
+    body = {
+      visibility: visibility
+    }
+
+    room_id = ERB::Util.url_encode room_id.to_s
+
+    request(:put, :client_r0, "/directory/list/room/#{room_id}", body: body, query: query)
+  end
+
   def get_user_tags(user_id, room_id, **params)
     query = {}
     query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
@@ -999,6 +1321,18 @@ module MatrixSdk::Protocols::CS
     request(:put, :client_r0, "/user/#{user_id}/rooms/#{room_id}/account_data/#{type_key}", body: account_data, query: query)
   end
 
+  # Retrieve user information
+  #
+  # @param [String] user_id The MXID to look up
+  # @return [Response] A response hash containing the requested user's information
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-admin-whois-userid
+  #      The Matrix Spec, for more information about the parameters and data
+  def whois(user_id)
+    user_id = ERB::Util.url_encode user_id.to_s
+
+    request(:get, :client_r0, "/admin/whois/#{user_id}")
+  end
+
   def get_filter(user_id, filter_id, **params)
     query = {}
     query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
@@ -1060,6 +1394,27 @@ module MatrixSdk::Protocols::CS
     request(:get, :client_r0, "/profile/#{user_id}/avatar_url", query: query)
   end
 
+  # Sets the avatar URL for a user
+  #
+  # @example Reuploading a gravatar as an avatar
+  #   require 'digest/md5'
+  #
+  #   # Get a 256x256 gravatar of user@example.com, returning 404 if one doesn't exist
+  #   email = 'user@example.com'
+  #   url = "https://www.gravatar.com/avatar/#{Digest::MD5.hexdigest email.striprim.downcase}?d=404&s=256"
+  #
+  #   data = Net::HTTP.get_response(URI(url))
+  #   data.value
+  #
+  #   # Reupload the gravatar to your connected HS before setting the resulting MXC URL as the new avatar
+  #   mxc = api.media_upload(data.body, data.content_type)[:content_uri]
+  #   api.set_avatar_url(api.whoami?[:user_id], mxc)
+  #
+  # @param [String,MXID] user_id The ID of the user to set the avatar for
+  # @param [String,URI::MATRIX] url The new avatar URL, should be a mxc:// URL
+  # @return [Response] An empty response hash if the change was successful
+  # @see https://matrix.org/docs/spec/client_server/latest#put-matrix-client-r0-profile-userid-avatar-url
+  #      The Matrix Spec, for more information about the event and data
   def set_avatar_url(user_id, url, **params)
     query = {}
     query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
@@ -1090,6 +1445,68 @@ module MatrixSdk::Protocols::CS
     request(:get, :client_r0, "/profile/#{user_id}", query: query)
   end
 
+  # Gets TURN server connection information and credentials
+  #
+  # @return [Response] A response hash according to the spec
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-voip-turnserver
+  #      The Matrix Spec, for more information about the event and data
+  def get_turn_server
+    request(:get, :client_r0, '/voip/turnServer')
+  end
+
+  # Sets the typing status for a user
+  #
+  # @param [String,MXID] room_id The ID of the room to set the typing status in
+  # @param [String,MXID] user_id The ID of the user to set the typing status for
+  # @param [Boolean] typing Is the user typing or not
+  # @param [Numeric] timeout The timeout in seconds for how long the typing status should be valid
+  # @return [Response] An empty response hash if the typing change was successful
+  # @see https://matrix.org/docs/spec/client_server/latest#put-matrix-client-r0-rooms-roomid-typing-userid
+  #      The Matrix Spec, for more information about the event and data
+  def set_typing(room_id, user_id, typing: true, timeout: nil)
+    room_id = ERB::Util.url_encode room_id.to_s
+    user_id = ERB::Util.url_encode user_id.to_s
+
+    body = {
+      typing: typing,
+      timeout: timeout ? timeout * 1000 : nil
+    }.compact
+
+    request(:put, :client_r0, "/rooms/#{room_id}/typing/#{user_id}", body: body)
+  end
+
+  # Gets the presence status of a user
+  #
+  # @param [String,MXID] user_id The User ID to read the status for
+  # @return [Response] A response hash containing the current user presence status
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-presence-userid-status
+  #      The Matrix Spec, for more information about the event and data
+  def get_presence_status(user_id)
+    user_id = ERB::Util.url_encode user_id.to_s
+
+    request(:get, :client_r0, "/presence/#{user_id}/status")
+  end
+
+  # Sets the presence status of a user
+  #
+  # @param [String,MXID] user_id The User ID to set the status for
+  # @param [:online,:offline,:unavailable] status The status to set
+  # @param [String] messge The status message to store for the new status
+  # @return [Response] An empty response hash if the status update succeeded
+  # @note The specified user_id should be of the local user unless used for AS purposes
+  # @see https://matrix.org/docs/spec/client_server/latest#put-matrix-client-r0-presence-userid-status
+  #      The Matrix Spec, for more information about the event and data
+  def set_presence_status(user_id, status, message: nil)
+    user_id = ERB::Util.url_encode user_id.to_s
+
+    body = {
+      presence: status,
+      status_msg: message
+    }.compact
+
+    request(:put, :client_r0, "/presence/#{user_id}/status", body: body)
+  end
+
   # Converts a Matrix content URL (mxc://) to a media download URL
   # @param [String,URI] mxcurl The Matrix content URL to convert
   # @param [String,URI] source A source HS to use for the convertion, defaults to the connected HS
@@ -1118,6 +1535,55 @@ module MatrixSdk::Protocols::CS
     end
   end
 
+  # Gets a preview of the given URL
+  #
+  # @param [String,URI] url The URL to retrieve a preview for
+  # @return [Response] A response hash containing OpenGraph data for the URL
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-media-r0-preview-url
+  #      The Matrix Spec, for more information about the data
+  def get_url_preview(url, timestamp: nil)
+    ts = (timestamp.to_i * 1000) if timestamp.is_a? Time
+    ts = timestamp if timestamp.is_a? Integer
+
+    query = {
+      url: url,
+      ts: ts
+    }.compact
+
+    request(:get, :media_r0, '/preview_url', query: query)
+  end
+
+  # Gets the media configuration of the current server
+  #
+  # @return [Response] A response hash containing media configuration informtion
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-media-r0-config
+  #      The Matrix Spec, for more information about the data
+  def get_media_config
+    request(:get, :media_r0, '/config')
+  end
+
+  # Sends events directly to the specified devices
+  #
+  # @param [String] event_type The type of event to send
+  # @param [Hash] messages The hash of events to send and devices to send them to
+  # @param [Hash] params Additional parameters
+  # @option params [Integer] :txn_id The ID of the transaction, automatically generated if not specified
+  # @see https://matrix.org/docs/spec/client_server/latest#put-matrix-client-r0-sendtodevice-eventtype-txnid
+  #      The Matrix Spec, for more information about the data
+  def send_to_device(event_type, messages:, **params)
+    txn_id = transaction_id
+    txn_id = params.fetch(:txn_id, "#{txn_id}#{Time.now.to_i}")
+
+    event_type = ERB::Util.url_encode event_type.to_s
+    txn_id = ERB::Util.url_encode txn_id.to_s
+
+    body = {
+      messages: messages
+    }.compact
+
+    request(:put, :client_r0, "/sendToDevice/#{event_type}/#{txn_id}", body: body)
+  end
+
   # Gets the room ID for an alias
   # @param [String,MXID] room_alias The room alias to look up
   # @return [Response] An object containing the :room_id key and a key of :servers that know of the room
@@ -1163,7 +1629,7 @@ module MatrixSdk::Protocols::CS
   # Gets a list of all the members in a room
   # @param [String,MXID] room_id The ID of the room
   # @return [Response] A chunked object
-  # @see https://matrix.org/docs/spec/client_server/r0.4.0#get-matrix-client-r0-rooms-roomid-members
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-rooms-roomid-members
   #      The Matrix Spec, for more information about the data
   def get_room_members(room_id, **params)
     query = {}
@@ -1174,9 +1640,24 @@ module MatrixSdk::Protocols::CS
     request(:get, :client_r0, "/rooms/#{room_id}/members", query: query)
   end
 
+  # Gets a list of the joined members in a room
+  #
+  # @param [String,MXID] room_id The ID of the room
+  # @return [Response] A chunked object
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-rooms-roomid-joined-members
+  #      The Matrix Spec, for more information about the data
+  def get_room_joined_members(room_id, **params)
+    query = {}
+    query[:user_id] = params.delete(:user_id) if protocol?(:AS) && params.key?(:user_id)
+
+    room_id = ERB::Util.url_encode room_id.to_s
+
+    request(:get, :client_r0, "/rooms/#{room_id}/joined_members", query: query)
+  end
+
   # Gets a list of the current users registered devices
   # @return [Response] An object including all information about the users devices.
-  # @see https://matrix.org/docs/spec/client_server/r0.4.0#get-matrix-client-r0-devices
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-devices
   #      The Matrix Spec, for more information about the data
   def get_devices
     request(:get, :client_r0, '/devices')
@@ -1185,7 +1666,7 @@ module MatrixSdk::Protocols::CS
   # Gets the information about a certain client device
   # @param [String] device_id The ID of the device to look up
   # @return [Response] An object containing all available device information
-  # @see https://matrix.org/docs/spec/client_server/r0.4.0#get-matrix-client-r0-devices-deviceid
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-devices-deviceid
   #      The Matrix Spec, for more information about the data
   def get_device(device_id)
     device_id = ERB::Util.url_encode device_id.to_s
@@ -1196,7 +1677,7 @@ module MatrixSdk::Protocols::CS
   # Sets the metadata for a device
   # @param [String] device_id The ID of the device to modify
   # @param [String] display_name The new display name to set for the device
-  # @see https://matrix.org/docs/spec/client_server/r0.4.0#put-matrix-client-r0-devices-deviceid
+  # @see https://matrix.org/docs/spec/client_server/latest#put-matrix-client-r0-devices-deviceid
   #      The Matrix Spec, for more information about the data
   def set_device(device_id, display_name:)
     device_id = ERB::Util.url_encode device_id.to_s
@@ -1209,7 +1690,7 @@ module MatrixSdk::Protocols::CS
   # @param [Hash] auth Authentication data for the removal request
   # @raise [MatrixNotAuthorizeedError] The request did not contain enough authentication information,
   #        the data in this error will include the necessary information to perform interactive auth
-  # @see https://matrix.org/docs/spec/client_server/r0.4.0#delete-matrix-client-r0-devices-deviceid
+  # @see https://matrix.org/docs/spec/client_server/latest#delete-matrix-client-r0-devices-deviceid
   #      The Matrix Spec, for more information about the data
   def delete_device(device_id, auth:)
     device_id = ERB::Util.url_encode device_id.to_s
@@ -1229,7 +1710,7 @@ module MatrixSdk::Protocols::CS
   # @example Looking up a specific device for a user
   #   api.keys_query(device_keys: { '@alice:example.com': ['ABCDEFGHIJ'] })
   #   # => { :device_keys => { :'@alice:example.com' => { :ABCDEFGHIJ => { ...
-  # @see https://matrix.org/docs/spec/client_server/r0.4.0#post-matrix-client-r0-keys-query
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-keys-query
   #      The Matrix Spec, for more information about the parameters and data
   def keys_query(timeout: nil, device_keys:, token: nil, **params)
     body = {
@@ -1242,6 +1723,201 @@ module MatrixSdk::Protocols::CS
     request(:post, :client_r0, '/keys/query', body: body)
   end
 
+  # Claim one-time keys for pre-key messaging
+  #
+  # @param [Hash] one_time_keys Hash mapping user IDs to hashes of device IDs and key types
+  # @param [Numeric] timeout (10) The timeout - in seconds - for the request
+  # @return [Response] A response hash containing one-time keys for the requested users and devices
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-keys-claim
+  #      The Matrix Spec, for more information about the parameters and data
+  def claim_one_time_keys(one_time_keys, timeout: 10)
+    body = {
+      one_time_keys: one_time_keys,
+      timeout: timeout * 1000
+    }
+    request(:post, :client_r0, '/keys/claim', body: body)
+  end
+
+  # Retrieve device key changes between two sync requests
+  #
+  # @param [String] from The sync token denoting the start of the range
+  # @param [String] to The sync token denoting the end of the range
+  # @return [Response] The users with device key changes during the specified range
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-keys-changes
+  #      The Matrix Spec, for more information about the parameters and data
+  def get_key_changes(from:, to:)
+    query = {
+      from: from,
+      to: to
+    }
+
+    request(:get, :client_r0, '/keys/changes', query: query)
+  end
+
+  # Gets the list of registered pushers for the current user
+  #
+  # @return [Response] A response hash containing all the currently registered pushers for the current user
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-pushers
+  #      The Matrix Spec, for more information about the parameters and data
+  def get_pushers
+    request(:get, :client_r0, '/pushers')
+  end
+
+  # rubocop:disable Metrics/ParameterLists
+
+  # Sets a pusher on the current user
+  #
+  # @param [String] key The pushkey for the pusher, used for routing purposes and for unique identification in coordination with app_id
+  # @param [String] kind The kind of pusher, should be either 'http' or 'email'
+  # @param [String] app_id The ID of the application to push to
+  # @param [String] app_name The user-visible name of the application to push to
+  # @param [String] device_name The user-visible name of the device to push to
+  # @param [String] lang The language that pushes should be sent in
+  # @param [Hash] data Pusher configuration data, depends on the kind parameter
+  # @param [Hash] params Additional optional parameters
+  # @option params [String] profile_tag Specifies which device rules to use
+  # @option params [Boolean] append Specifies if the pusher should replace or be appended to the pusher list based on uniqueness
+  # @return [Response] An empty response hash if the pusher was added/replaced correctly
+  # @see https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-pushers
+  #      The Matrix Spec, for more information about the parameters and data
+  def set_pusher(key, kind:, app_id:, app_name:, device_name:, lang:, data:, **params)
+    body = {
+      pushkey: key,
+      kind: kind,
+      app_id: app_id,
+      app_display_name: app_name,
+      device_display_name: device_name,
+      profile_tag: params[:profile_tag],
+      lang: lang,
+      data: data,
+      append: params[:append]
+    }.compact
+
+    request(:post, :client_r0, '/pushers/set', body: body)
+  end
+  # rubocop:enable Metrics/ParameterLists
+
+  # Enumerates the list of notifies that the current user has/should have received.
+  #
+  # @param [String] from The pagination token to continue reading events from
+  # @param [Integer] limit The maximum number of event to return
+  # @param [String] only A filter string that is to be applied to the notification events
+  # @return [Response] A response hash containing notifications for the current user
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-notifications
+  #      The Matrix Spec, for more information about the parameters and data
+  def get_notifications(from: nil, limit: nil, only: nil)
+    raise ArgumentError, 'Limit must be an integer' unless limit.nil? || limit.is_a?(Integer)
+
+    query = {
+      from: from,
+      limit: limit,
+      only: only
+    }.compact
+
+    request(:get, :client_r0, '/notifications', query: query)
+  end
+
+  # Retrieves the full list of registered push rules for the current user
+  #
+  # @return [Response] A response hash containing the current list of push rules for the current user
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-pushrules
+  #      The Matrix Spec, for more information about the parameters and data
+  def get_pushrules
+    request(:get, :client_r0, '/pushrules')
+  end
+
+  # Retrieves a single registered push rule for the current user
+  #
+  # @param [String] scope ('global') The scope to look up push rules from
+  # @param [:override,:underride,:sender,:room,:content] kind The kind of push rule to look up
+  # @param [String] id The ID of the rule that's being retrieved
+  # @return [Response] A response hash containing the full data of the requested push rule
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-pushrules-scope-kind-ruleid
+  #      The Matrix Spec, for more information about the parameters and data
+  def get_pushrule(scope: 'global', kind:, id:)
+    scope = ERB::Util.url_encode scope.to_s
+    kind = ERB::Util.url_encode kind.to_s
+    id = ERB::Util.url_encode id.to_s
+
+    request(:get, :client_r0, "/pushrules/#{scope}/#{kind}/#{id}")
+  end
+
+  # Checks if a push rule for the current user is enabled
+  #
+  # @param [String] scope ('global') The scope to look up push rules from
+  # @param [:override,:underride,:sender,:room,:content] kind The kind of push rule to look up
+  # @param [String] id The ID of the rule that's being retrieved
+  # @return [Response] A response hash containing an :enabled key for if the rule is enabled or not
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-pushrules-scope-kind-ruleid-enabled
+  #      The Matrix Spec, for more information about the parameters and data
+  def get_pushrule_enabled(scope: 'global', kind:, id:)
+    scope = ERB::Util.url_encode scope.to_s
+    kind = ERB::Util.url_encode kind.to_s
+    id = ERB::Util.url_encode id.to_s
+
+    request(:get, :client_r0, "/pushrules/#{scope}/#{kind}/#{id}/enabled")
+  end
+
+  # Enabled/Disables a specific push rule for the current user
+  #
+  # @param [Boolean] enabled Should the push rule be enabled or not
+  # @param [String] scope ('global') The scope to look up push rules from
+  # @param [:override,:underride,:sender,:room,:content] kind The kind of push rule to look up
+  # @param [String] id The ID of the rule that's being retrieved
+  # @return [Response] An empty response hash if the push rule was enabled/disabled successfully
+  # @see https://matrix.org/docs/spec/client_server/latest#put-matrix-client-r0-pushrules-scope-kind-ruleid-enabled
+  #      The Matrix Spec, for more information about the parameters and data
+  def set_pushrule_enabled(enabled, scope: 'global', kind:, id:)
+    scope = ERB::Util.url_encode scope.to_s
+    kind = ERB::Util.url_encode kind.to_s
+    id = ERB::Util.url_encode id.to_s
+
+    body = {
+      enabled: enabled
+    }
+
+    request(:put, :client_r0, "/pushrules/#{scope}/#{kind}/#{id}/enabled", body: body)
+  end
+
+  # Gets the current list of actions for a specific push rule for the current user
+  #
+  # @param [String] scope ('global') The scope to look up push rules from
+  # @param [:override,:underride,:sender,:room,:content] kind The kind of push rule to look up
+  # @param [String] id The ID of the rule that's being retrieved
+  # @return [Response] A response hash containing an :enabled key for if the rule is enabled or not
+  # @see https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-pushrules-scope-kind-ruleid-actions
+  #      The Matrix Spec, for more information about the parameters and data
+  def get_pushrule_actions(scope: 'global', kind:, id:)
+    scope = ERB::Util.url_encode scope.to_s
+    kind = ERB::Util.url_encode kind.to_s
+    id = ERB::Util.url_encode id.to_s
+
+    request(:get, :client_r0, "/pushrules/#{scope}/#{kind}/#{id}/actions")
+  end
+
+  # Replaces the list of actions for a push rule for the current user
+  #
+  # @param [String,Array[String]] actions The list of actions to apply on the push rule
+  # @param [String] scope ('global') The scope to look up push rules from
+  # @param [:override,:underride,:sender,:room,:content] kind The kind of push rule to look up
+  # @param [String] id The ID of the rule that's being retrieved
+  # @return [Response] An empty response hash if the push rule actions were modified successfully
+  # @see https://matrix.org/docs/spec/client_server/latest#put-matrix-client-r0-pushrules-scope-kind-ruleid-actions
+  #      The Matrix Spec, for more information about the parameters and data
+  def set_pushrule_actions(actions, scope: 'global', kind:, id:)
+    scope = ERB::Util.url_encode scope.to_s
+    kind = ERB::Util.url_encode kind.to_s
+    id = ERB::Util.url_encode id.to_s
+
+    actions = [actions] unless actions.is_a? Array
+
+    body = {
+      actions: actions
+    }
+
+    request(:put, :client_r0, "/pushrules/#{scope}/#{kind}/#{id}/actions", body: body)
+  end
+
   # Gets the MXID of the currently logged-in user
   # @return [Response] An object containing the key :user_id
   def whoami?(**params)