stream-chat-ruby 2.0.0 → 2.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c7a819d41561a5fe8bf986b1ddcdc093a985a6de19bd256071a88efb4d790d58
-  data.tar.gz: e5cdc6e77fa5e453afbbbdf482c61f791a6896c47fe903f56acdca9794f662a6
+  metadata.gz: cff8888b576ad92ca17c3275504e585b1490e3935e7d86595aad795dfea67a7d
+  data.tar.gz: 8aa309ce84be59f966edee13e0e8957f863f59c535bc8df9d41d90484e8b1cb5
 SHA512:
-  metadata.gz: 97fce2a3420903a2b9a88e7197a58683a5e3d0d54139350aec0d7c5029fd657352e2102be57fb398f5e389f5d97a500c5a88fce744f19ae2ffab2c5410ce297e
-  data.tar.gz: c9c2c76a61e874e43778b6181e1a2f68191aec1e0444272f043f6086f83f9151ae5a29d7c1255a60bf695520cdbe6e09bc5f87becda1dac93c461468a8b50539
+  metadata.gz: 9ca7b965ba2ca2fdffcb3ff667d93a1081e5aa15f40d3aeb9a167c945f26e54d3e773e826ca583c445c0da02acb5f67f3c450d7fc3fce98fcb958acd7e9077cf
+  data.tar.gz: 98b040deb4906b952d393244fb228843e77d669481104fa0ca75512cdcaacfccd75d8733c9ade31854366ab066ff6c58a54d2ff3c89e6c590d5a8c9fdc17c888

data/.github/workflows/ci.yml

@@ -0,0 +1,26 @@
+name: build
+
+on: [pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby: [ '2.5', '2.6', '2.7' ]
+    name: Ruby ${{ matrix.ruby }} sample
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+
+      - env:
+          STREAM_CHAT_API_KEY: ${{ secrets.STREAM_CHAT_API_KEY }}
+          STREAM_CHAT_API_SECRET: ${{ secrets.STREAM_CHAT_API_SECRET }}
+          BLOCKLIST: ${{ matrix.ruby == '2.7' }}
+        run: |
+          gem install bundler
+          bundle install --jobs 4 --retry 3
+          bundle exec rake rubocop
+          bundle exec rake test

data/CHANGELOG.md

@@ -1,3 +1,26 @@
+## 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
+- Fix issues from the latest version of rubocop
+- 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
@@ -12,13 +35,11 @@
 - 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,6 +1,6 @@
 # stream-chat-ruby
 
-[![Build Status](https://travis-ci.com/GetStream/stream-chat-ruby.svg?branch=master)](https://travis-ci.com/GetStream/stream-chat-ruby) [![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.
 
@@ -14,7 +14,7 @@ Android SDK libraries (https://getstream.io/chat/).
 
 stream-chat-ruby supports:
 
-- Ruby (2.6, 2.5, 2.4, 2.3)
+- Ruby (2.7, 2.6, 2.5)
 
 #### Install
 
@@ -28,15 +28,16 @@ gem install stream-chat-ruby
 
 ### Supported features
 
-- Chat channels
+- Chat channel type, channels and members
 - Messages
-- Chat channel types
 - User management
 - Moderation API
 - Push configuration
 - User devices
 - User search
 - Channel search
+- Blocklists
+- Export channels
 
 ### Import
 
@@ -129,6 +130,17 @@ 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'}}, sort: {last_created_at: -1}, offset: 5, limit: 5)
 ```
 
 ### Messages
@@ -152,6 +164,31 @@ client.get_devices('jane-77')
 client.remove_device(jane_phone['id'], jane_phone['user_id'])
 ```
 
+### Blocklists
+```ruby
+# Create a blocklist
+client.create_blocklist('my_blocker', %w[fudge cream sugar])
+
+# Enable it on messaging channel type
+client.update_channel_type('messaging', blocklist: 'my_blocker', blocklist_behavior: 'block')
+
+# Get the details of the blocklist
+client.get_blocklist('my_blocker')
+
+# Delete the blocklist
+client.delete_blocklist('my_blocker')
+```
+
+### Export Channels
+```ruby
+# Register an export
+response = client.export_channels({type: 'messaging', id: 'jane'})
+
+# Check completion
+status_response = client.get_export_channel_status(response['task_id'])
+# status_response['status'] == 'pending', 'completed'
+```
+
 ### 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

@@ -1,12 +1,14 @@
 # frozen_string_literal: true
 
 require 'stream-chat/errors'
+require 'stream-chat/util'
 
 module StreamChat
   class Channel # rubocop:todo Metrics/ClassLength # rubocop:todo Style/Documentation
     attr_reader :id
     attr_reader :channel_type
     attr_reader :custom_data
+    attr_reader :members
 
     def initialize(client, channel_type, channel_id = nil, custom_data = nil)
       @channel_type = channel_type
@@ -23,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
 
@@ -33,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?
 
@@ -59,11 +61,36 @@ module StreamChat
       state
     end
 
+    def query_members(filter_conditions = {}, sort: nil, **options)
+      params = {}.merge(options).merge({
+                                         id: @id,
+                                         type: @channel_type,
+                                         filter_conditions: filter_conditions,
+                                         sort: get_sort_fields(sort)
+                                       })
+
+      if @id == '' && @members.length.positive?
+        params['members'] = []
+        @members&.each do |m|
+          params['members'] << m['user'].nil? ? m['user_id'] : m['user']['id']
+        end
+      end
+
+      @client.get('members', params: { payload: params.to_json })
+    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
@@ -73,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)
@@ -130,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

@@ -7,8 +7,11 @@ require 'jwt'
 require 'stream-chat/channel'
 require 'stream-chat/errors'
 require 'stream-chat/version'
+require 'stream-chat/util'
 
 module StreamChat
+  DEFAULT_BLOCKLIST = 'profanity_en_2020_v1'
+
   class Client
     BASE_URL = 'https://chat-us-east-1.stream-io-api.com'
 
@@ -57,22 +60,22 @@ 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 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
 
@@ -82,11 +85,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)
@@ -97,7 +100,7 @@ module StreamChat
 
         payload[id] = user
       end
-      post('users', data: { 'users': payload })
+      post('users', data: { users: payload })
     end
 
     def update_user(user)
@@ -105,7 +108,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)
@@ -129,34 +132,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)
@@ -164,28 +167,20 @@ module StreamChat
     end
 
     def query_users(filter_conditions, sort: nil, **options)
-      sort_fields = []
-      sort&.each do |k, v|
-        sort_fields << { "field": k, "direction": v }
-      end
       params = options.merge({
-                               "filter_conditions": filter_conditions,
-                               "sort": sort_fields
+                               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)
-      params = { "state": true, "watch": false, "presence": false }
-      sort_fields = []
-      sort&.each do |k, v|
-        sort_fields << { "field": k, "direction": v }
-      end
-      params = params.merge(options).merge({
-                                             "filter_conditions": filter_conditions,
-                                             "sort": sort_fields
-                                           })
-      get('channels', params: { "payload": params.to_json })
+      data = { state: true, watch: false, presence: false }
+      data = data.merge(options).merge({
+                                         filter_conditions: filter_conditions,
+                                         sort: get_sort_fields(sort)
+                                       })
+      post('channels', data: data)
     end
 
     def create_channel_type(data)
@@ -202,7 +197,7 @@ module StreamChat
     end
 
     def update_channel_type(channel_type, **options)
-      put("channeltypes/#{channel_type}", **options)
+      put("channeltypes/#{channel_type}", data: options)
     end
 
     def delete_channel_type(channel_type)
@@ -223,18 +218,18 @@ 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 verify_webhook(request_body, x_signature)
@@ -242,6 +237,34 @@ module StreamChat
       signature == x_signature
     end
 
+    def list_blocklists
+      get('blocklists')
+    end
+
+    def get_blocklist(name)
+      get("blocklists/#{name}")
+    end
+
+    def create_blocklist(name, words)
+      post('blocklists', data: { name: name, words: words })
+    end
+
+    def update_blocklist(name, words)
+      put("blocklists/#{name}", data: { words: words })
+    end
+
+    def delete_blocklist(name)
+      delete("blocklists/#{name}")
+    end
+
+    def export_channels(*channels)
+      post('export_channels', data: { channels: channels })
+    end
+
+    def get_export_channel_status(task_id)
+      get("export_channels/#{task_id}")
+    end
+
     def put(relative_url, params: nil, data: nil)
       make_http_request(:put, relative_url, params: params, data: data)
     end
@@ -281,6 +304,10 @@ module StreamChat
       parse_response(response)
     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 })
+    end
+
     private
 
     def get_default_params
@@ -314,7 +341,7 @@ module StreamChat
       headers['Authorization'] = @auth_token
       headers['stream-auth-type'] = 'jwt'
       url = [@base_url, relative_url].join('/')
-      params = !params.nil? ? params : {}
+      params = params.nil? ? {} : params
       params = Hash[get_default_params.merge(params).sort_by { |k, _v| k.to_s }]
       url = "#{url}?#{URI.encode_www_form(params)}"
 

data/lib/stream-chat/errors.rb

@@ -26,5 +26,6 @@ module StreamChat
       end
     end
   end
+
   class StreamChannelException < StandardError; end
 end

data/lib/stream-chat/util.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+# lib/util.rb
+
+def get_sort_fields(sort)
+  sort_fields = []
+  sort&.each do |k, v|
+    sort_fields << { field: k, direction: v }
+  end
+  sort_fields
+end

data/lib/stream-chat/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stream-chat-ruby
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.5.0
 platform: ruby
 authors:
 - Mircea Cosbuc
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-10-05 00:00:00.000000000 Z
+date: 2021-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -86,9 +86,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rubocop.yml"
-- ".travis.yml"
 - CHANGELOG.md
 - Gemfile
 - LICENSE
@@ -99,6 +99,7 @@ files:
 - lib/stream-chat/channel.rb
 - lib/stream-chat/client.rb
 - lib/stream-chat/errors.rb
+- lib/stream-chat/util.rb
 - lib/stream-chat/version.rb
 - stream-chat.gemspec
 homepage: http://github.com/GetStream/stream-chat-ruby

data/.travis.yml

@@ -1,10 +0,0 @@
-language: ruby
-before_install:
-  - gem update bundler
-rvm:
-  - 2.5
-  - 2.6
-  - 2.7
-script:
-  - bundle exec rake rubocop
-  - bundle exec rake test