stream-chat-ruby 3.14.0 → 3.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ce82f07f493c594768abcbac19ec25fcabbd52c0f2b88815be6dc93b200e5bc
-  data.tar.gz: 23ea3b56424f00274dc8ce74d3e9e0354d3ea741e1d103986611a7c437ad7d4b
+  metadata.gz: abe37f40d0bab27e95a353d06e16746c6bf581d6b17e007963572cabac0e1ad3
+  data.tar.gz: 2c0e8cd83b7a9d30982469efe54612526d7ea83c3c71d8a8b3ac76748b8be988
 SHA512:
-  metadata.gz: 5606b930dfb30305f3bf34460431c89212d8ac13b4b38011d811caf2f0be88535ffba0eb5bafa922481f32563d18aaee17823c5be5319b7152518f4020784192
-  data.tar.gz: d1e8a09dd1206e33c75aa0a0d316d047aca2429b1d7aacf8ef4f8684efdba9bd37ddd895e9e16e2630ca204a127169342df87593fdf04efcccb0e5011f2f1365
+  metadata.gz: 8151d017630003390f49c4b067b941e31ff4cd95190f934f8c4b51b05392d01b687b6129b2c7a45d30eb4f1196bd3c729a95ef0a912f00f8aa579c7b22a508da
+  data.tar.gz: 492cbf78fc3b4eebb89771d9ff5a3a45160e05bdfbaf7fe72ea2e97d04db0ffd7d426499883d089e14fa1f475b414a68a211d1c9a9343e723c33c54ddc2d85e8

data/.rubocop.yml

@@ -35,3 +35,5 @@ Style/FrozenStringLiteralComment:
 
 Gemspec/RequireMFA:
   Enabled: false
+Naming/PredicateMethod:
+  Enabled: false

data/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [3.16.0](https://github.com/GetStream/stream-chat-ruby/compare/v3.15.0...v3.16.0) (2025-06-18)
+
+## [3.15.0](https://github.com/GetStream/stream-chat-ruby/compare/v3.14.0...v3.15.0) (2025-06-06)
+
 ## [3.14.0](https://github.com/GetStream/stream-chat-ruby/compare/v3.13.0...v3.14.0) (2025-04-07)
 
 ## [3.13.0](https://github.com/GetStream/stream-chat-ruby/compare/v3.12.0...v3.13.0) (2025-04-04)
@@ -348,4 +352,4 @@ before continuing with v3.0.0 of this library.
 - Added `client.search`
 - Added `client.update_users_partial`
 - Added `client.update_user_partial`
-- Added `client.reactivate_user`
+- Added `client.reactivate_user`

data/CONTRIBUTING.md

@@ -1,4 +1,3 @@
-
 # :recycle: Contributing
 
 We welcome code changes that improve this library or fix a problem, please make sure to follow all best practices and add tests if applicable before submitting a Pull Request on Github. We are very happy to merge your code in the official repository. Make sure to sign our [Contributor License Agreement (CLA)](https://docs.google.com/forms/d/e/1FAIpQLScFKsKkAJI7mhCr7K9rEIOpqIDThrWxuvxnwUq2XkHyG154vQ/viewform) first. See our license file for more details.
@@ -63,6 +62,34 @@ Recommended settings:
 }
 ```
 
+For Docker-based development, you can use:
+
+```shell
+$ make lint_with_docker      # Run linters in Docker
+$ make lint-fix_with_docker  # Fix linting issues in Docker
+$ make test_with_docker      # Run tests in Docker
+$ make check_with_docker     # Run both linters and tests in Docker
+$ make sorbet_with_docker    # Run Sorbet type checker in Docker
+```
+
+You can customize the Ruby version used in Docker by setting the RUBY_VERSION variable:
+
+```shell
+$ RUBY_VERSION=3.1 make test_with_docker
+```
+
+By default, the API client connects to the production Stream Chat API. You can override this by setting the STREAM_CHAT_URL environment variable:
+
+```shell
+$ STREAM_CHAT_URL=http://localhost:3030 make test
+```
+
+When running tests in Docker, the `test_with_docker` command automatically sets up networking to allow the Docker container to access services running on your host machine via `host.docker.internal`. This is particularly useful for connecting to a local Stream Chat server:
+
+```shell
+$ STREAM_CHAT_URL=http://host.docker.internal:3030 make test_with_docker
+```
+
 ### Commit message convention
 
 This repository follows a commit message convention in order to automatically generate the [CHANGELOG](./CHANGELOG.md). Make sure you follow the rules of [conventional commits](https://www.conventionalcommits.org/) when opening a pull request.

data/Makefile

@@ -0,0 +1,50 @@
+STREAM_KEY ?= NOT_EXIST
+STREAM_SECRET ?= NOT_EXIST
+RUBY_VERSION ?= 3.0
+STREAM_CHAT_URL ?= https://chat.stream-io-api.com
+
+# These targets are not files
+.PHONY: help check test lint lint-fix test_with_docker lint_with_docker lint-fix_with_docker
+
+help: ## Display this help message
+	@echo "Please use \`make <target>\` where <target> is one of"
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; \
+	{printf "\033[36m%-40s\033[0m %s\n", $$1, $$2}'
+
+lint: ## Run linters
+	bundle exec rubocop
+
+lint-fix: ## Fix linting issues
+	bundle exec rubocop -a
+
+test: ## Run tests
+	STREAM_KEY=$(STREAM_KEY) STREAM_SECRET=$(STREAM_SECRET) bundle exec rspec
+
+check: lint test ## Run linters + tests
+
+console: ## Start a console with the gem loaded
+	bundle exec rake console
+
+lint_with_docker: ## Run linters in Docker (set RUBY_VERSION to change Ruby version)
+	docker run -t -i -w /code -v $(PWD):/code ruby:$(RUBY_VERSION) sh -c "gem install bundler && bundle install && bundle exec rubocop"
+
+lint-fix_with_docker: ## Fix linting issues in Docker (set RUBY_VERSION to change Ruby version)
+	docker run -t -i -w /code -v $(PWD):/code ruby:$(RUBY_VERSION) sh -c "gem install bundler && bundle install && bundle exec rubocop -a"
+
+test_with_docker: ## Run tests in Docker (set RUBY_VERSION to change Ruby version)
+	docker run -t -i -w /code -v $(PWD):/code --add-host=host.docker.internal:host-gateway -e STREAM_KEY=$(STREAM_KEY) -e STREAM_SECRET=$(STREAM_SECRET) -e "STREAM_CHAT_URL=http://host.docker.internal:3030" ruby:$(RUBY_VERSION) sh -c "gem install bundler && bundle install && bundle exec rspec"
+
+check_with_docker: lint_with_docker test_with_docker ## Run linters + tests in Docker (set RUBY_VERSION to change Ruby version)
+
+sorbet: ## Run Sorbet type checker
+	bundle exec srb tc
+
+sorbet_with_docker: ## Run Sorbet type checker in Docker (set RUBY_VERSION to change Ruby version)
+	docker run -t -i -w /code -v $(PWD):/code ruby:$(RUBY_VERSION) sh -c "gem install bundler && bundle install && bundle exec srb tc"
+
+coverage: ## Generate test coverage report
+	COVERAGE=true bundle exec rspec
+	@echo "Coverage report available at ./coverage/index.html"
+
+reviewdog: ## Run reviewdog for CI
+	bundle exec rubocop --format json | reviewdog -f=rubocop -name=rubocop -reporter=github-pr-review 

data/README.md

@@ -132,6 +132,29 @@ deleted_message = client.delete_message(m1['message']['id'])
 
 ```
 
+### Reminders
+
+```ruby
+# Create a reminder for a message
+reminder = client.create_reminder(m1['message']['id'], 'bob-1', DateTime.now + 1)
+
+# Create a reminder without a notification time (just mark for later)
+reminder = client.create_reminder(m1['message']['id'], 'bob-1')
+
+# Update a reminder
+updated_reminder = client.update_reminder(m1['message']['id'], 'bob-1', DateTime.now + 2)
+
+# Delete a reminder
+client.delete_reminder(m1['message']['id'], 'bob-1')
+
+# Query reminders for a user
+reminders = client.query_reminders('bob-1')
+
+# Query reminders with filters
+filter = { 'channel_cid' => 'messaging:bob-and-jane' }
+reminders = client.query_reminders('bob-1', filter)
+```
+
 ### Devices
 
 ```ruby

data/lib/stream-chat/client.rb

@@ -7,6 +7,7 @@ require 'faraday/multipart'
 require 'faraday/net_http_persistent'
 require 'jwt'
 require 'time'
+require 'date'
 require 'sorbet-runtime'
 require 'stream-chat/channel'
 require 'stream-chat/errors'
@@ -688,7 +689,7 @@ module StreamChat
     # Revoke tokens for an application issued since the given date.
     sig { params(before: T.any(DateTime, String)).returns(StreamChat::StreamResponse) }
     def revoke_tokens(before)
-      before = T.cast(before, DateTime).rfc3339 if before.instance_of?(DateTime)
+      before = before.rfc3339 if before.instance_of?(DateTime)
       update_app_settings({ 'revoke_tokens_issued_before' => before })
     end
 
@@ -701,7 +702,7 @@ module StreamChat
     # Revoke tokens for users issued since.
     sig { params(user_ids: T::Array[String], before: T.any(DateTime, String)).returns(StreamChat::StreamResponse) }
     def revoke_users_token(user_ids, before)
-      before = T.cast(before, DateTime).rfc3339 if before.instance_of?(DateTime)
+      before = before.rfc3339 if before.instance_of?(DateTime)
 
       updates = []
       user_ids.map do |user_id|
@@ -929,6 +930,65 @@ module StreamChat
       get('imports', params: options)
     end
 
+    sig { params(filter: StringKeyHash, sort: T.nilable(T::Hash[String, Integer]), options: T.untyped).returns(StreamChat::StreamResponse) }
+    def query_threads(filter, sort: nil, **options)
+      params = {}.merge(options).merge({
+                                         filter: filter,
+                                         sort: StreamChat.get_sort_fields(sort)
+                                       })
+
+      post('threads', data: params)
+    end
+
+    # Creates a reminder for a message.
+    # @param message_id [String] The ID of the message to create a reminder for
+    # @param user_id [String] The ID of the user creating the reminder
+    # @param remind_at [DateTime, nil] When to remind the user (optional)
+    # @return [StreamChat::StreamResponse] API response
+    sig { params(message_id: String, user_id: String, remind_at: T.nilable(DateTime)).returns(StreamChat::StreamResponse) }
+    def create_reminder(message_id, user_id, remind_at = nil)
+      data = { user_id: user_id }
+      data[:remind_at] = remind_at.rfc3339 if remind_at.instance_of?(DateTime)
+      post("messages/#{message_id}/reminders", data: data)
+    end
+
+    # Updates a reminder for a message.
+    # @param message_id [String] The ID of the message with the reminder
+    # @param user_id [String] The ID of the user who owns the reminder
+    # @param remind_at [DateTime, nil] When to remind the user (optional)
+    # @return [StreamChat::StreamResponse] API response
+    sig { params(message_id: String, user_id: String, remind_at: T.nilable(DateTime)).returns(StreamChat::StreamResponse) }
+    def update_reminder(message_id, user_id, remind_at = nil)
+      data = { user_id: user_id }
+      data[:remind_at] = remind_at.rfc3339 if remind_at
+      patch("messages/#{message_id}/reminders", data: data)
+    end
+
+    # Deletes a reminder for a message.
+    # @param message_id [String] The ID of the message with the reminder
+    # @param user_id [String] The ID of the user who owns the reminder
+    # @return [StreamChat::StreamResponse] API response
+    sig { params(message_id: String, user_id: String).returns(StreamChat::StreamResponse) }
+    def delete_reminder(message_id, user_id)
+      delete("messages/#{message_id}/reminders", params: { user_id: user_id })
+    end
+
+    # Queries reminders based on filter conditions.
+    # @param user_id [String] The ID of the user whose reminders to query
+    # @param filter_conditions [Hash] Conditions to filter reminders
+    # @param sort [Array<Hash>, nil] Sort parameters (default: [{ field: 'remind_at', direction: 1 }])
+    # @param options [Hash] Additional query options like limit, offset
+    # @return [StreamChat::StreamResponse] API response with reminders
+    sig { params(user_id: String, filter_conditions: T::Hash[T.untyped, T.untyped], sort: T.nilable(T::Array[T::Hash[T.untyped, T.untyped]]), options: T.untyped).returns(StreamChat::StreamResponse) }
+    def query_reminders(user_id, filter_conditions = {}, sort: nil, **options)
+      params = options.merge({
+                               filter_conditions: filter_conditions,
+                               sort: sort || [{ field: 'remind_at', direction: 1 }],
+                               user_id: user_id
+                             })
+      post('reminders/query', data: params)
+    end
+
     private
 
     sig { returns(T::Hash[String, String]) }

data/lib/stream-chat/moderation.rb

@@ -14,7 +14,8 @@ module StreamChat
     MODERATION_ENTITY_TYPES = T.let(
       {
         user: 'stream:user',
-        message: 'stream:chat:v1:message'
+        message: 'stream:chat:v1:message',
+        userprofile: 'stream:v1:user_profile'
       }.freeze,
       T::Hash[Symbol, String]
     )
@@ -24,6 +25,48 @@ module StreamChat
       @client = client
     end
 
+    # Experimental: Check user profile
+    #
+    # Warning: This is an experimental feature and the API is subject to change.
+    #
+    # This function is used to check a user profile for moderation.
+    # This will not create any review queue items for the user profile.
+    # You can just use this to check whether to allow a certain user profile to be created or not.
+    #
+    # @param [string] user_id User ID to be checked
+    # @param [Hash] profile Profile data to be checked
+    # @option profile [String] :username Username to be checked
+    # @option profile [String] :image Image URL to be checked
+    # @return [StreamChat::StreamResponse]
+    #
+    # example:
+    # client.moderation.check_user_profile('user-id', {username: 'bad_username', image: 'https://example.com/profile.jpg'})
+    sig do
+      params(
+        user_id: String,
+        profile: T::Hash[Symbol, T.nilable(String)]
+      ).returns(StreamChat::StreamResponse)
+    end
+    def check_user_profile(user_id, profile)
+      raise ArgumentError, 'Either username or image must be provided' if profile[:username].nil? && profile[:image].nil?
+
+      moderation_payload = {}
+      moderation_payload[:texts] = [profile[:username]] if profile[:username]
+      moderation_payload[:images] = [profile[:image]] if profile[:image]
+
+      check(
+        T.must(MODERATION_ENTITY_TYPES[:userprofile]),
+        user_id,
+        moderation_payload,
+        'user_profile:default',
+        entity_creator_id: user_id,
+        options: {
+          force_sync: true,
+          test_mode: true
+        }
+      )
+    end
+
     # Flags a user with a reason
     #
     # @param [string] flagged_user_id User ID to be flagged

data/lib/stream-chat/version.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 module StreamChat
-  VERSION = '3.14.0'
+  VERSION = '3.16.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stream-chat-ruby
 version: !ruby/object:Gem::Version
-  version: 3.14.0
+  version: 3.16.0
 platform: ruby
 authors:
 - getstream.io
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-07 00:00:00.000000000 Z
+date: 2025-06-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -107,6 +107,7 @@ files:
 - CONTRIBUTING.md
 - Gemfile
 - LICENSE
+- Makefile
 - PULL_REQUEST_TEMPLATE.md
 - README.md
 - Rakefile