stream-chat-ruby 2.4.0 → 2.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea550365bc302aeb9097c2f2819a0dd6c5ead1fd1064a7c12842de4670e871d4
-  data.tar.gz: b01a528a334338edfd9f05e8f3aa40e682cabd3de40e6356b162f9f0cc791e64
+  metadata.gz: e9f49f20f526f3ddd42becd925d877020fea2b4afdca80327a1d31beeafcdd76
+  data.tar.gz: d38e3c3390338c96f30ff692459aebd0c54addab98071130e089b9aed9a5ec13
 SHA512:
-  metadata.gz: 3f12aa7bec1853b9a91e3b9a63a6f296aca373bb8f24a719a0728959e68cbe10e4b440bc7056d730bfa36f3e2a0c5c1b4db1b566cc51159a09bad3eac4694747
-  data.tar.gz: 9982645b54641b15fd7d8deae0049d90aca66defcaba509e19be7f0c27dfd42fec8bba5221b0ca961251fc8c084c61a1793fcc689df853ae09a570b0358ac605
+  metadata.gz: a58994964df76b94ef804b25372acdf6cfe2d142f32fdfed54be0bcff81d5203ec5d8e38e5c0a0f216e43b2ba4713a35e722fa8eff92204f95e458a5ce3644a7
+  data.tar.gz: 721e797d9968d088e90578548794457812e483c50ff12d138fbbbda37af3f5328d7290fb97103ea82b164462182a45a18bb64185c1d0df27e06cd3e6064befdf

data/.github/workflows/ci.yml

@@ -6,9 +6,10 @@ jobs:
   build:
     runs-on: ubuntu-latest
     strategy:
+      max-parallel: 1
       matrix:
-        ruby: [ '2.5', '2.6', '2.7' ]
-    name: Ruby ${{ matrix.ruby }} sample
+        ruby: ['2.5', '2.6', '2.7', '3.0']
+    name: Ruby ${{ matrix.ruby }}
     steps:
       - uses: actions/checkout@v2
       - uses: actions/setup-ruby@v1

data/.gitignore

@@ -48,3 +48,4 @@ Gemfile.lock
 
 # unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
 .rvmrc
+.envrc

data/CHANGELOG.md

@@ -1,12 +1,42 @@
+## June 4th, 2021 - 2.10.0
+
+- Add custom command CRUD support
+
+## May 31st, 2021 - 2.9.0
+
+- Add support for app and user level token revoke
+
+## May 21st, 2021 - 2.8.0
+
+- Add query message flags support
+
+## March 17th, 2021 - 2.7.0
+
+- Add Ruby 3.x support
+- Update CI to run all tests for all versions
+
+## March 9th, 2021 - 2.6.0
+
+- Add get_rate_limits endpoint
+
+## February 3rd, 2021 - 2.5.0
+
+- Add channel partial update
+- Increase convenience in query members
+- Improve internal symbol conversions
+
 ## January 20th, 2021 - 2.4.0
+
 - Add query_members to channel
 - Use post endpoint for query channels instead of get
 - Extract common code for sorting into a helper for query calls
 
 ## January 5th, 2021 - 2.3.0
+
 - Add check SQS helper
 
 ## January 4th, 2021 - 2.2.0
+
 - Add support for export channels
 - Improve readme for blocklist and export channels
 - Improve running tests for multiple versions of ruby
@@ -14,27 +44,34 @@
 - Move to GitHub Actions
 
 ## October 5th, 2020 - 2.1.0
+
 - Add support for blocklist
 
 ## October 2nd, 2020 - 2.0.0
+
 - Drop EOL Ruby versions: 2.3 && 2.4
 - Setup Rubocop and mark string literals as frozen
 
 ## August 3rd, 2020 - 1.1.3
+
 - Fixed Argument Error on delete_user
 
 ## April 23th, 2020 - 1.1.2
+
 - Fixed ArgumentError when no users was passed
 
 ## March 30th, 2020 - 1.1.1
+
 - Fixed few minor issues
 
 ## Oct 27th, 2019 - 1.1.0
+
 - Mark gems use for testing as development dependencies
 - Added `send_file`, `send_image`, `delete_file`, `delete_image`
 - Added `invite_members`
 
 ## Oct 19th, 2019 - 1.0.0
+
 - Added `channel.hide` and `channel.show`
 - Added `client.flag_message` and `client.unflag_message`
 - Added `client.flag_user` and `client.unflag_user`

data/README.md

@@ -1,20 +1,20 @@
 # stream-chat-ruby
 
- [![build](https://github.com/GetStream/stream-chat-ruby/workflows/build/badge.svg)](https://github.com/GetStream/stream-chat-ruby/actions) [![Gem Version](https://badge.fury.io/rb/stream-chat-ruby.svg)](http://badge.fury.io/rb/stream-chat-ruby)
+[![build](https://github.com/GetStream/stream-chat-ruby/workflows/build/badge.svg)](https://github.com/GetStream/stream-chat-ruby/actions) [![Gem Version](https://badge.fury.io/rb/stream-chat-ruby.svg)](http://badge.fury.io/rb/stream-chat-ruby)
 
 stream-chat-ruby is the official Ruby client for [Stream chat](https://getstream.io/chat/) a service for building chat applications.
 
 You can sign up for a Stream account at https://getstream.io/chat/get_started/.
 
 You can use this library to access chat API endpoints server-side. For the
-client-side integrations (web and mobile) have a look at the Javascript, iOS and
+client-side integrations (web and mobile) have a look at the JavaScript, iOS and
 Android SDK libraries (https://getstream.io/chat/).
 
 ### Installation
 
 stream-chat-ruby supports:
 
-- Ruby (2.7, 2.6, 2.5)
+- Ruby (3.0, 2.7, 2.6, 2.5)
 
 #### Install
 
@@ -131,8 +131,16 @@ chan.unban_user('bob-1')
 # Query channel state
 chan.query({'messages' => { 'limit' => 10, 'id_lte' => m1['id']}})
 
+# Update metadata (overwrite)
+chan.update({'motd' => 'one apple a day....'})
+
+# Update partial
+# 1. key-value pairs to set
+# 2. keys to unset (remove)
+chan.update_partial({color: 'blue', age: 30}, ['motd'])
+
 # Query channel members
-chan.query_members({name: {'$autocomplete': 'test'}}, {last_created_at: -1}, offset: 5, limit: 5)
+chan.query_members({name: {'$autocomplete': 'test'}}, sort: {last_created_at: -1}, offset: 5, limit: 5)
 ```
 
 ### Messages
@@ -157,6 +165,7 @@ client.remove_device(jane_phone['id'], jane_phone['user_id'])
 ```
 
 ### Blocklists
+
 ```ruby
 # Create a blocklist
 client.create_blocklist('my_blocker', %w[fudge cream sugar])
@@ -172,6 +181,7 @@ client.delete_blocklist('my_blocker')
 ```
 
 ### Export Channels
+
 ```ruby
 # Register an export
 response = client.export_channels({type: 'messaging', id: 'jane'})
@@ -181,6 +191,19 @@ status_response = client.get_export_channel_status(response['task_id'])
 # status_response['status'] == 'pending', 'completed'
 ```
 
+### Rate limits
+
+```ruby
+# Get all rate limits
+limits = client.get_rate_limits
+
+# Get rate limits for specific platform(s)
+limits = client.get_rate_limits(server_side: true)
+
+# Get rate limits for specific platforms and endpoints
+limits = client.get_rate_limits(android: true, ios: true, endpoints: ['QueryChannels', 'SendMessage'])
+```
+
 ### Example Rails application
 
 See [an example rails application using the Ruby SDK](https://github.com/GetStream/rails-chat-example).

data/lib/stream-chat/channel.rb

@@ -25,7 +25,7 @@ module StreamChat
     end
 
     def send_message(message, user_id)
-      payload = { "message": add_user_id(message, user_id) }
+      payload = { message: add_user_id(message, user_id) }
       @client.post("#{url}/message", data: payload)
     end
 
@@ -35,24 +35,24 @@ module StreamChat
     end
 
     def send_reaction(message_id, reaction, user_id)
-      payload = { "reaction": add_user_id(reaction, user_id) }
+      payload = { reaction: add_user_id(reaction, user_id) }
       @client.post("messages/#{message_id}/reaction", data: payload)
     end
 
     def delete_reaction(message_id, reaction_type, user_id)
       @client.delete(
         "messages/#{message_id}/reaction/#{reaction_type}",
-        params: { "user_id": user_id }
+        params: { user_id: user_id }
       )
     end
 
     def create(user_id)
-      @custom_data['created_by'] = { "id": user_id }
+      @custom_data['created_by'] = { id: user_id }
       query(watch: false, state: false, presence: false)
     end
 
     def query(**options)
-      payload = { "state": true, "data": @custom_data }.merge(options)
+      payload = { state: true, data: @custom_data }.merge(options)
       url = "channels/#{@channel_type}"
       url = "#{url}/#{@id}" unless @id.nil?
 
@@ -61,7 +61,7 @@ module StreamChat
       state
     end
 
-    def query_members(filter_conditions: {}, sort: nil, **options)
+    def query_members(filter_conditions = {}, sort: nil, **options)
       params = {}.merge(options).merge({
                                          id: @id,
                                          type: @channel_type,
@@ -80,10 +80,17 @@ module StreamChat
     end
 
     def update(channel_data, update_message = nil)
-      payload = { "data": channel_data, "message": update_message }
+      payload = { data: channel_data, message: update_message }
       @client.post(url, data: payload)
     end
 
+    def update_partial(set = nil, unset = nil)
+      raise StreamChannelException 'set or unset is needed' if set.nil? && unset.nil?
+
+      payload = { set: set, unset: unset }
+      @client.patch(url, data: payload)
+    end
+
     def delete
       @client.delete(url)
     end
@@ -93,23 +100,23 @@ module StreamChat
     end
 
     def add_members(user_ids)
-      @client.post(url, data: { "add_members": user_ids })
+      @client.post(url, data: { add_members: user_ids })
     end
 
     def invite_members(user_ids)
-      @client.post(url, data: { "invites": user_ids })
+      @client.post(url, data: { invites: user_ids })
     end
 
     def add_moderators(user_ids)
-      @client.post(url, data: { "add_moderators": user_ids })
+      @client.post(url, data: { add_moderators: user_ids })
     end
 
     def remove_members(user_ids)
-      @client.post(url, data: { "remove_members": user_ids })
+      @client.post(url, data: { remove_members: user_ids })
     end
 
     def demote_moderators(user_ids)
-      @client.post(url, data: { "demote_moderators": user_ids })
+      @client.post(url, data: { demote_moderators: user_ids })
     end
 
     def mark_read(user_id, **options)
@@ -150,17 +157,17 @@ module StreamChat
     end
 
     def delete_file(url)
-      @client.delete("#{self.url}/file", params: { "url": url })
+      @client.delete("#{self.url}/file", params: { url: url })
     end
 
     def delete_image(url)
-      @client.delete("#{self.url}/image", params: { "url": url })
+      @client.delete("#{self.url}/image", params: { url: url })
     end
 
     private
 
     def add_user_id(payload, user_id)
-      payload.merge({ "user": { "id": user_id } })
+      payload.merge({ user: { id: user_id } })
     end
   end
 end

data/lib/stream-chat/client.rb

@@ -4,6 +4,7 @@
 require 'open-uri'
 require 'faraday'
 require 'jwt'
+require 'time'
 require 'stream-chat/channel'
 require 'stream-chat/errors'
 require 'stream-chat/version'
@@ -45,9 +46,10 @@ module StreamChat
       end
     end
 
-    def create_token(user_id, exp = nil)
+    def create_token(user_id, exp = nil, iat = nil)
       payload = { user_id: user_id }
       payload['exp'] = exp unless exp.nil?
+      payload['iat'] = iat unless iat.nil?
       JWT.encode(payload, @api_secret, 'HS256')
     end
 
@@ -60,22 +62,29 @@ module StreamChat
     end
 
     def flag_message(id, **options)
-      payload = { 'target_message_id': id }.merge(options)
+      payload = { target_message_id: id }.merge(options)
       post('moderation/flag', data: payload)
     end
 
     def unflag_message(id, **options)
-      payload = { 'target_message_id': id }.merge(options)
+      payload = { target_message_id: id }.merge(options)
       post('moderation/unflag', data: payload)
     end
 
+    def query_message_flags(filter_conditions, **options)
+      params = options.merge({
+                               filter_conditions: filter_conditions
+                             })
+      get('moderation/flags/message', params: { payload: params.to_json })
+    end
+
     def flag_user(id, **options)
-      payload = { 'target_user_id': id }.merge(options)
+      payload = { target_user_id: id }.merge(options)
       post('moderation/flag', data: payload)
     end
 
     def unflag_user(id, **options)
-      payload = { 'target_user_id': id }.merge(options)
+      payload = { target_user_id: id }.merge(options)
       post('moderation/unflag', data: payload)
     end
 
@@ -85,11 +94,11 @@ module StreamChat
 
     def search(filter_conditions, query, **options)
       params = options.merge({
-                               "filter_conditions": filter_conditions,
-                               "query": query
+                               filter_conditions: filter_conditions,
+                               query: query
                              })
 
-      get('search', params: { "payload": params.to_json })
+      get('search', params: { payload: params.to_json })
     end
 
     def update_users(users)
@@ -100,7 +109,7 @@ module StreamChat
 
         payload[id] = user
       end
-      post('users', data: { 'users': payload })
+      post('users', data: { users: payload })
     end
 
     def update_user(user)
@@ -108,7 +117,7 @@ module StreamChat
     end
 
     def update_users_partial(updates)
-      patch('users', data: { 'users': updates })
+      patch('users', data: { users: updates })
     end
 
     def update_user_partial(update)
@@ -132,34 +141,34 @@ module StreamChat
     end
 
     def ban_user(target_id, **options)
-      payload = { 'target_user_id': target_id }.merge(options)
+      payload = { target_user_id: target_id }.merge(options)
       post('moderation/ban', data: payload)
     end
 
     def unban_user(target_id, **options)
-      params = { 'target_user_id': target_id }.merge(options)
+      params = { target_user_id: target_id }.merge(options)
       delete('moderation/ban', params: params)
     end
 
     def mute_user(target_id, user_id)
-      payload = { 'target_id': target_id, 'user_id': user_id }
+      payload = { target_id: target_id, user_id: user_id }
       post('moderation/mute', data: payload)
     end
 
     def unmute_user(target_id, user_id)
-      payload = { 'target_id': target_id, 'user_id': user_id }
+      payload = { target_id: target_id, user_id: user_id }
       post('moderation/unmute', data: payload)
     end
 
     def mark_all_read(user_id)
-      payload = { 'user': { 'id': user_id } }
+      payload = { user: { id: user_id } }
       post('channels/read', data: payload)
     end
 
     def update_message(message)
       raise ArgumentError 'message must have an id' unless message.key? 'id'
 
-      post("messages/#{message['id']}", data: { 'message': message })
+      post("messages/#{message['id']}", data: { message: message })
     end
 
     def delete_message(message_id)
@@ -168,14 +177,14 @@ module StreamChat
 
     def query_users(filter_conditions, sort: nil, **options)
       params = options.merge({
-                               "filter_conditions": filter_conditions,
-                               "sort": get_sort_fields(sort)
+                               filter_conditions: filter_conditions,
+                               sort: get_sort_fields(sort)
                              })
-      get('users', params: { "payload": params.to_json })
+      get('users', params: { payload: params.to_json })
     end
 
     def query_channels(filter_conditions, sort: nil, **options)
-      data = { "state": true, "watch": false, "presence": false }
+      data = { state: true, watch: false, presence: false }
       data = data.merge(options).merge({
                                          filter_conditions: filter_conditions,
                                          sort: get_sort_fields(sort)
@@ -218,18 +227,29 @@ module StreamChat
 
     def add_device(device_id, push_provider, user_id)
       post('devices', data: {
-             "id": device_id,
-             "push_provider": push_provider,
-             "user_id": user_id
+             id: device_id,
+             push_provider: push_provider,
+             user_id: user_id
            })
     end
 
     def delete_device(device_id, user_id)
-      delete('devices', params: { "id": device_id, "user_id": user_id })
+      delete('devices', params: { id: device_id, user_id: user_id })
     end
 
     def get_devices(user_id)
-      get('devices', params: { "user_id": user_id })
+      get('devices', params: { user_id: user_id })
+    end
+
+    def get_rate_limits(server_side: false, android: false, ios: false, web: false, endpoints: [])
+      params = {}
+      params['server_side'] = server_side if server_side
+      params['android'] = android if android
+      params['ios'] = ios if ios
+      params['web'] = web if web
+      params['endpoints'] = endpoints.join(',') unless endpoints.empty?
+
+      get('rate_limits', params: params)
     end
 
     def verify_webhook(request_body, x_signature)
@@ -246,11 +266,11 @@ module StreamChat
     end
 
     def create_blocklist(name, words)
-      post('blocklists', data: { "name": name, "words": words })
+      post('blocklists', data: { name: name, words: words })
     end
 
     def update_blocklist(name, words)
-      put("blocklists/#{name}", data: { "words": words })
+      put("blocklists/#{name}", data: { words: words })
     end
 
     def delete_blocklist(name)
@@ -258,13 +278,37 @@ module StreamChat
     end
 
     def export_channels(*channels)
-      post('export_channels', data: { "channels": channels })
+      post('export_channels', data: { channels: channels })
     end
 
     def get_export_channel_status(task_id)
       get("export_channels/#{task_id}")
     end
 
+    def revoke_tokens(before)
+      before = before.rfc3339 if before.instance_of?(DateTime)
+      update_app_settings({ 'revoke_tokens_issued_before' => before })
+    end
+
+    def revoke_user_token(user_id, before)
+      revoke_users_token([user_id], before)
+    end
+
+    def revoke_users_token(user_ids, before)
+      before = before.rfc3339 if before.instance_of?(DateTime)
+
+      updates = []
+      user_ids.each do |user_id|
+        updates.push({
+                       'id' => user_id,
+                       'set' => {
+                         'revoke_tokens_issued_before' => before
+                       }
+                     })
+      end
+      update_users_partial(updates)
+    end
+
     def put(relative_url, params: nil, data: nil)
       make_http_request(:put, relative_url, params: params, data: data)
     end
@@ -305,7 +349,27 @@ module StreamChat
     end
 
     def check_sqs(sqs_key = nil, sqs_secret = nil, sqs_url = nil)
-      post('check_sqs', data: { "sqs_key": sqs_key, "sqs_secret": sqs_secret, "sqs_url": sqs_url })
+      post('check_sqs', data: { sqs_key: sqs_key, sqs_secret: sqs_secret, sqs_url: sqs_url })
+    end
+
+    def create_command(command)
+      post('commands', data: command)
+    end
+
+    def get_command(name)
+      get("commands/#{name}")
+    end
+
+    def update_command(name, command)
+      put("commands/#{name}", data: command)
+    end
+
+    def delete_command(name)
+      delete("commands/#{name}")
+    end
+
+    def list_commands
+      get('commands')
     end
 
     private
@@ -320,8 +384,8 @@ module StreamChat
 
     def get_default_headers
       {
-        "Content-Type": 'application/json',
-        "X-Stream-Client": get_user_agent
+        'Content-Type': 'application/json',
+        'X-Stream-Client': get_user_agent
       }
     end
 
@@ -342,7 +406,7 @@ module StreamChat
       headers['stream-auth-type'] = 'jwt'
       url = [@base_url, relative_url].join('/')
       params = params.nil? ? {} : params
-      params = Hash[get_default_params.merge(params).sort_by { |k, _v| k.to_s }]
+      params = (get_default_params.merge(params).sort_by { |k, _v| k.to_s }).to_h
       url = "#{url}?#{URI.encode_www_form(params)}"
 
       body = data.to_json if %w[patch post put].include? method.to_s

data/lib/stream-chat/version.rb

@@ -3,5 +3,5 @@
 # lib/version.rb
 
 module StreamChat
-  VERSION = '2.4.0'
+  VERSION = '2.10.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stream-chat-ruby
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 2.10.0
 platform: ruby
 authors:
 - Mircea Cosbuc
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-01-20 00:00:00.000000000 Z
+date: 2021-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday