servicestack 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 991af3e1951fbd5467476753e01f05db5992e7399cb0ac3ca0acfaf909056b8e
-  data.tar.gz: 0e2dcc59cb68a58911ba105d82ff245aff0001a5e41870324c5c2cd12d31e2f9
+  metadata.gz: 422e88b02d244852ff3d8941817d5fc6c22c58c2a7698458b4d2d96df75af2bf
+  data.tar.gz: 9b2941734b9154d258de44f156e2e66b600f6042825535b017cf81699bcaf6da
 SHA512:
-  metadata.gz: f4c822aad83ce16504e03018f13112a36b3c3added39d5f3d52c3dd5234c9d20bcadf03e8dad3eb8f65c671359c5b7d50e53277ae46304ac8fb68f186bd08c7a
-  data.tar.gz: 84eadaa862a26af3237499a7d07682243b61ed5b97314ed3f498002e94c2360c938186ff90b423e7a6b4e3dbf404b5cf1323b5b4e318804e7fbdc48f7ac29b0d
+  metadata.gz: '09d3557ceda3563802cedbdcf7feddcadb4ccf5251994c00ecdadefa5417fab664429502b7a94379c53e4136f76e2337075d76f07a22cb015c990cbffb59ea7d'
+  data.tar.gz: 8abcf83d19d0530c7873a4a6993fc11390305379657f8db395e7a60a07e2faede986dc807e585a68bfd399aeb2b4b6829bbcfa08b42347568ecd304e14a19c43

data/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.2]
+
+### Added
+
+- `on_authentication_required` callback for re-authenticating a client before
+  automatically retrying a Request that returned 401 Unauthorized
+
 ## [0.1.1]
 
 ### Added
@@ -26,5 +33,6 @@ All notable changes to this project will be documented in this file.
 - Built-in ServiceStack DTOs referenced by generated DTOs (`ResponseStatus`,
   `QueryBase`, `QueryResponse`, `Authenticate`, ...)
 
+[0.1.2]: https://github.com/ServiceStack/servicestack-ruby/releases/tag/v0.1.2
 [0.1.1]: https://github.com/ServiceStack/servicestack-ruby/releases/tag/v0.1.1
 [0.1.0]: https://github.com/ServiceStack/servicestack-ruby/releases/tag/v0.1.0

data/README.md

@@ -162,6 +162,25 @@ refreshed and the failed Request retried:
 client.set_refresh_token(refresh_token)
 ```
 
+### Transparently handle 401 Unauthorized Responses
+
+If the Server returns a 401 Unauthorized Response either because the client was
+unauthenticated or its Bearer Token or API Key had expired, use the
+`on_authentication_required` callback to re-configure the client before the
+original Request is automatically retried:
+
+```ruby
+client.on_authentication_required = lambda { |c|
+  c.authenticate(user_name, password)
+}
+
+# Automatically retries Requests returning 401 Responses
+res = client.send(Secured.new)
+```
+
+A configured Refresh Token takes precedence over the callback, which is only
+used when no Refresh Token is set or refreshing it failed.
+
 ### Batched Requests
 
 ```ruby

data/lib/servicestack/json_service_client.rb

@@ -71,7 +71,7 @@ module ServiceStack
     attr_accessor :base_url, :reply_base_url, :oneway_base_url, :headers,
                   :bearer_token, :refresh_token, :refresh_token_uri,
                   :user_name, :password, :request_filter, :response_filter,
-                  :timeout, :cookies
+                  :timeout, :cookies, :on_authentication_required
 
     class << self
       # Filters applied to every Request and Response of all clients.
@@ -309,7 +309,7 @@ module ServiceStack
       capture_cookies(response)
 
       status_code = response.code.to_i
-      if status_code == 401 && retry_on_auth_failure && refresh_access_token
+      if status_code == 401 && retry_on_auth_failure && handle_authentication_required
         return execute(method, url, body, retry_on_auth_failure: false, content_type: content_type)
       end
 
@@ -375,6 +375,26 @@ module ServiceStack
       end
     end
 
+    # Re-authenticates the client after a Request returned 401 Unauthorized,
+    # returning whether the Request should be retried.
+    #
+    # Uses the Refresh Token when configured, otherwise the
+    # `on_authentication_required` callback.
+    def handle_authentication_required
+      return true if refresh_access_token
+      return false if @on_authentication_required.nil?
+
+      if @on_authentication_required.arity.zero?
+        @on_authentication_required.call
+      else
+        @on_authentication_required.call(self)
+      end
+      true
+    rescue StandardError
+      # Re-authenticating failed, return the original 401 Response
+      false
+    end
+
     def refresh_access_token
       return false if @refresh_token.to_s.empty?
 

data/lib/servicestack/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ServiceStack
-  VERSION = '0.1.1'
+  VERSION = '0.1.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: servicestack
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - ServiceStack