sockudo 2.0.1 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a69c1173084795c41b60abf8ebce95fe00d5cb6d550a960be09ec5a4b683723c
-  data.tar.gz: 111fa3673255c2e094fccf7817f63f4f11a8d1710289a7090d8860b9a737df50
+  metadata.gz: 8cf03c803da80499345944846d538cf7adfd04b9738e965b4fdeda1236897b87
+  data.tar.gz: a6683ad145370135456319a6c1855119f086d9ee62521db6bb1a71f7cc23c09e
 SHA512:
-  metadata.gz: bc5d7704e10cc78efac6c5d23d1cb9335f8363bd0a43e88ac74ac0668d97ab3563d8a77cb5b211b60244c8def5799a3607e2873ce46bbc1d31ffc1597233ccaa
-  data.tar.gz: ffe8ce27b66c03cbd2c1369c4a5fe9813a6b0e6f3a88a695ede5809421babb89277a8bb3b779eec19d10e6fd9ec06fbd194d92408874acb66c1ac3b0288cdf82
+  metadata.gz: cfb7a47418538e78cd7fcb0b68edd077fe74c74bfe65208a7c216bdde1c3e6dab364bfc27ddf8f12a34b393b5b76985fc89dac4bb43de347fc28185afda301a0
+  data.tar.gz: 5d1a1ce9d2438c61b2d0721d87c0144259f2ede7b51de07193b3bb39029fe3d4d9dfa9735b04df2ece2629c4621e36c82c989aa737f3fbcffd54964a6f5e7731

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 2.2.0 - 2026-08-17
+
+* [ADDED] Add `terminate_user_connections` and `force_reconnect_user` helpers.
+* [ADDED] Add request coverage and usage documentation for user connection management.
+
+## 2.1.0 - 2026-06-27
+
+* [ADDED] Forward-compatibility coverage for future webhook event names and nested payload fields.
+
 ## 2.0.1
 
 * [FIXED] multi_json deprecation warning.

data/README.md

@@ -163,6 +163,24 @@ auth = sockudo.authenticate(
 auth = sockudo.authenticate_user(params[:socket_id], { id: 'user-123', name: 'Jane Doe' })
 ```
 
+## User Connection Management
+
+### Terminate User Connections
+
+Disconnect every active socket for a user:
+
+```ruby
+sockudo.terminate_user_connections("user-123")
+```
+
+### Force Reconnect User
+
+Close all active connections for a user with code `4200`, prompting clients to reconnect:
+
+```ruby
+sockudo.force_reconnect_user("user-123")
+```
+
 ## Webhooks
 
 Create a webhook object from a `Rack::Request` (available as `request` in Rails controllers and Sinatra handlers):

data/lib/sockudo/client.rb

@@ -373,6 +373,36 @@ module Sockudo
       get("/channels/#{channel_name}/users", params)
     end
 
+    # Terminate all active connections for a user
+    #
+    # POST /apps/[id]/users/[user_id]/terminate_connections
+    #
+    # @param user_id [String] The user ID whose connections should be terminated
+    #
+    # @return [Hash] See Sockudo API docs
+    #
+    # @raise [Sockudo::Error] Unsuccessful response - see the error message
+    # @raise [Sockudo::HTTPError] Error raised inside http client. The original error is wrapped in error.original_error
+    #
+    def terminate_user_connections(user_id)
+      post("/users/#{user_id}/terminate_connections")
+    end
+
+    # Force reconnect all active connections for a user
+    #
+    # POST /apps/[id]/users/[user_id]/force_reconnect
+    #
+    # @param user_id [String] The user ID whose connections should be force-reconnected
+    #
+    # @return [Hash] See Sockudo API docs
+    #
+    # @raise [Sockudo::Error] Unsuccessful response - see the error message
+    # @raise [Sockudo::HTTPError] Error raised inside http client. The original error is wrapped in error.original_error
+    #
+    def force_reconnect_user(user_id)
+      post("/users/#{user_id}/force_reconnect")
+    end
+
     # Activate or create a push device registration with admin scope
     def activate_device(device, options = {})
       post(push_path('/deviceRegistrations'), device,

data/lib/sockudo/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sockudo
-  VERSION = '2.0.1'
+  VERSION = '2.2.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sockudo
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.2.0
 platform: ruby
 authors:
 - Sockudo