feat(update_user): deprecate update in favor of upsert (#91)

Author: peterdeme

README.md

@@ -67,7 +67,7 @@ client.create_token('bob-1')
 ### Create/Update users
 
 ```ruby
-client.update_user({
+client.upsert_user({
     :id => 'bob-1',
     :role => 'admin',
     :name => 'Robert Tables'
@@ -76,7 +76,7 @@ client.update_user({
 # Batch update is also supported
 jane = {:id => 'jane-1'}
 june = {:id => 'june-1'}
-client.update_users([jane, june])
+client.upsert_users([jane, june])
 ```
 
 ### Channel types

lib/stream-chat/client.rb

@@ -179,8 +179,22 @@ def search(filter_conditions, query, sort: nil, **options)
       get('search', params: { payload: options.merge(to_merge).to_json })
     end
 
+    # <b>DEPRECATED:</b> Please use <tt>upsert_users</tt> instead.
     sig { params(users: T::Array[StringKeyHash]).returns(StreamChat::StreamResponse) }
     def update_users(users)
+      warn '[DEPRECATION] `update_users` is deprecated.  Please use `upsert_users` instead.'
+      upsert_users(users)
+    end
+
+    # <b>DEPRECATED:</b> Please use <tt>upsert_user</tt> instead.
+    sig { params(user: StringKeyHash).returns(StreamChat::StreamResponse) }
+    def update_user(user)
+      warn '[DEPRECATION] `update_user` is deprecated.  Please use `upsert_user` instead.'
+      upsert_user(user)
+    end
+
+    sig { params(users: T::Array[StringKeyHash]).returns(StreamChat::StreamResponse) }
+    def upsert_users(users)
       payload = {}
       users.each do |user|
         id = user[:id] || user['id']
@@ -192,8 +206,8 @@ def update_users(users)
     end
 
     sig { params(user: StringKeyHash).returns(StreamChat::StreamResponse) }
-    def update_user(user)
-      update_users([user])
+    def upsert_user(user)
+      upsert_users([user])
     end
 
     sig { params(updates: T::Array[StringKeyHash]).returns(StreamChat::StreamResponse) }