authsignal-ruby 4.1.0 → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c4fa986346960144f15616720f21828275ffabdf16a817e05cadb4ee3c33565
-  data.tar.gz: 0b748a47e76e7af70786179cfde9fa037188da9c6beee9d25194e47f61adf98e
+  metadata.gz: 75bf7679eabfb897458c92a7b284ff2cdd1ea7eb833275e14c1c01c47de3ea89
+  data.tar.gz: 4a94529da1d514caa69e4498f68d19006a3fd09be8d094be463aa33b9bc5e4d9
 SHA512:
-  metadata.gz: 6dfcbd7a4ef015d250e33eebf556f1c651d440de45df9155791748d77f9668e57a40d0e27fb5091290fe178130c3dd70c09cc8aa85829855e317ab263637c5af
-  data.tar.gz: 9ed3d53d1cd3772b2c6744dfacf1ff1471f09e743e1b9ba102f3d731b0c39e185533bad167ceb6f536c0b77c2be49b79094e46fafca8840542dc5b73fd1eb31d
+  metadata.gz: c12dd82892ca7c69bf2ec0e981a1ff5276e5f0fca37e6ae173ef385af63649a322b8cdc96d3e39b7d13eea7494bba97c15c234251838e092f816aed7ecaefd20
+  data.tar.gz: e263f4d2eaa242a23e3aafce95ea7b1db01011d33c51b45b9c655b5e184b39ddf51a4e29d2a8b5b0e6684bd2f2e8b87e110d3848819fc89dc09076bf8e4e2147

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    authsignal-ruby (4.1.0)
+    authsignal-ruby (5.0.0)
       faraday (>= 2)
       faraday-retry (~> 2.2)
 

data/README.md

@@ -32,22 +32,22 @@ end
 
 You can find your `api_secret_key` in the [Authsignal Portal](https://portal.authsignal.com/organisations/tenants/api).
 
-You must specify the correct `baseUrl` for your tenant's region.
+You must specify the correct `api_url` for your tenant's region.
 
-| Region      | Base URL                            |
+| Region      | API URL                             |
 | ----------- | ----------------------------------- |
 | US (Oregon) | https://signal.authsignal.com/v1    |
 | AU (Sydney) | https://au.signal.authsignal.com/v1 |
 | EU (Dublin) | https://eu.signal.authsignal.com/v1 |
 
-For example, to set the base URL to use our AU region:
+For example, to set the API URL to use our AU region:
 
 ```
 require 'authsignal'
 
 Authsignal.setup do |config|
     config.api_secret_key = ENV["AUTHSIGNAL_SECRET_KEY"]
-    config.base_uri = "https://au.signal.authsignal.com/v1"
+    config.api_url = "https://au.signal.authsignal.com/v1"
 
     # If you would like the Authsignal client to retry requests due to network issues
     config.retry = true # default value: false
@@ -92,8 +92,8 @@ Authsignal.enroll_verified_authenticator user_id: 'AS_001',
 # returns:
 # {
 #    success?: false,
-#    status: 400,
-#    error: 'invalid_request',
+#    status_code: 400,
+#    error_code: 'invalid_request',
 #    error_description: '/body/oobChannel must be equal to one of the allowed values'
 # }
 ```
@@ -109,7 +109,7 @@ Authsignal.enroll_verified_authenticator! user_id: 'AS_001',
                                          }
 
 # raise:
-# <Authsignal::ApiError: invalid_request status: 400, error: invalid_request, description: /body/oobChannel must be equal to one o...
+# <Authsignal::ApiError: AuthsignalError: 400 - /body/oobChannel must be equal to one of the allowed values. status_code: 401, error_code: invalid_request, error_description: /body/oobChannel must be equal to one of the allowed values.
 ```
 
 ## Development

data/lib/authsignal/api_error.rb

@@ -2,18 +2,30 @@
 
 module Authsignal
   class ApiError < StandardError
-    attr_reader :status, :error, :description
+    attr_reader :status_code, :error_code, :error_description
 
-    def initialize(message = "An unexpected API error occurred", status, error, description)
-      @status      = status || 500
-      @error       = error
-      @description = description
+    def initialize(status_code, error_code, error_description = nil)
+      message = format_message(status_code, error_code, error_description)
 
       super(message)
+
+      @status_code = status_code
+      @error_code = error_code
+      @error_description = error_description
     end
 
     def to_s
-      "#{super} status: #{status}, error: #{error}, description: #{description}"
+      "#{super} status_code: #{status_code}, error_code: #{error_code}, error_description: #{error_description}"
+    end
+
+    private
+
+    def format_message(status_code, error_code, error_description)
+      "AuthsignalError: #{status_code} - #{format_description(error_code, error_description)}"
+    end
+
+    def format_description(error_code, error_description)
+      error_description && error_description.length > 0 ? error_description : error_code
     end
   end
 end

data/lib/authsignal/client.rb

@@ -17,7 +17,7 @@ module Authsignal
             @api_key = require_api_key
 
             @client = Faraday.new do |builder|
-                builder.url_prefix = Authsignal.configuration.base_uri
+                builder.url_prefix = Authsignal.configuration.api_url
                 builder.adapter :net_http
                 builder.request :authorization, :basic, @api_key, nil
 
@@ -36,47 +36,50 @@ module Authsignal
             end
         end
 
-        def track(event)
-            user_id = url_encode(event[:user_id])
-            action = event[:action]
+        def get_user(user_id:)
+            path = "users/#{url_encode(user_id)}"
+            make_request(:get, path)
+        end
 
-            path = "users/#{user_id}/actions/#{action}"
-            body = event.except(:user_id)
+        def update_user(user_id:, attributes:)
+            make_request(:post, "users/#{url_encode(user_id)}", body: attributes)
+        end
 
-            make_request(:post, path, body: body)
+        def delete_user(user_id:)
+            make_request(:delete, "users/#{url_encode(user_id)}")
         end
 
-        def get_user(user_id:, redirect_url: nil)
-            if(redirect_url)
-                path = "users/#{url_encode(user_id)}?redirectUrl=#{redirect_url}"
-            else
-                path = "users/#{url_encode(user_id)}"
-            end
-            make_request(:get, path)
+        def get_authenticators(user_id:)
+            make_request(:get, "users/#{url_encode(user_id)}/authenticators")
         end
 
-        def update_user(user_id:, user:)
-            make_request(:post, "users/#{url_encode(user_id)}", body: user)
+        def enroll_verified_authenticator(user_id:, attributes:)
+            make_request(:post, "users/#{url_encode(user_id)}/authenticators", body: attributes)
         end
 
-        def delete_user(user_id:)
-            make_request(:delete, "users/#{url_encode(user_id)}")
+        def delete_authenticator(user_id:, user_authenticator_id:)
+            make_request(:delete, "users/#{url_encode(user_id)}/authenticators/#{url_encode(user_authenticator_id)}")
+        end
+
+        def track(user_id:, action:, attributes:)
+            path = "users/#{user_id}/actions/#{action}"
+
+            make_request(:post, path, body: attributes)
         end
 
-        def validate_challenge(user_id: nil, token:, action: nil)
+        def validate_challenge(token:, user_id: nil, action: nil)
             path = "validate"
             body = { user_id: user_id, token: token, action: action }
 
             make_request(:post, path, body: body)
         end
 
-        def get_action(user_id, action, idempotency_key)
+        def get_action(user_id:, action:, idempotency_key:)
             make_request(:get, "users/#{url_encode(user_id)}/actions/#{action}/#{url_encode(idempotency_key)}")
         end
 
-        def update_action_state(user_id:, action:, idempotency_key:, state:) 
-            body = { state: state }
-            make_request(:patch, "users/#{url_encode(user_id)}/actions/#{action}/#{url_encode(idempotency_key)}", body: body)
+        def update_action(user_id:, action:, idempotency_key:, attributes:) 
+            make_request(:patch, "users/#{url_encode(user_id)}/actions/#{action}/#{url_encode(idempotency_key)}", body: attributes)
         end
 
         ##
@@ -85,14 +88,6 @@ module Authsignal
             make_request(:post , "users/#{url_encode(user_id)}", body: user_payload)
         end
 
-        def enroll_verified_authenticator(user_id, authenticator)
-            make_request(:post, "users/#{url_encode(user_id)}/authenticators", body: authenticator)
-        end
-
-        def delete_authenticator(user_id:, user_authenticator_id:)
-            make_request(:delete, "users/#{url_encode(user_id)}/authenticators/#{url_encode(user_authenticator_id)}")
-        end
-
         private
 
         def url_encode(s)

data/lib/authsignal/configuration.rb

@@ -13,7 +13,7 @@ module Authsignal
         end
   
         config_option :api_secret_key
-        config_option :base_uri
+        config_option :api_url
         config_option :debug
         config_option :retry
 
@@ -22,7 +22,7 @@ module Authsignal
       
             # set default attribute values
             @defaults = OpenStruct.new({
-                base_uri: 'https://signal.authsignal.com/v1/',
+                api_url: 'https://signal.authsignal.com/v1/',
                 retry: false,
                 debug: false
             })

data/lib/authsignal/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Authsignal
-  VERSION = "4.1.0"
+  VERSION = "5.0.0"
 end

data/lib/authsignal.rb

@@ -25,14 +25,14 @@ module Authsignal
             configuration.defaults
         end
 
-        def get_user(user_id:, redirect_url: nil)
-            response = Client.new.get_user(user_id: user_id, redirect_url: redirect_url)
+        def get_user(user_id:)
+            response = Client.new.get_user(user_id: user_id)
 
             handle_response(response)
         end
 
-        def update_user(user_id:, user:)
-            response = Client.new.update_user(user_id: user_id, user: user)
+        def update_user(user_id:, attributes:)
+            response = Client.new.update_user(user_id: user_id, attributes: attributes)
 
             handle_response(response)
         end
@@ -43,42 +43,44 @@ module Authsignal
             handle_response(response)
         end
 
-        def get_action(user_id:, action:, idempotency_key:)
-            response = Client.new.get_action(user_id, action, idempotency_key)
+        def get_authenticators(user_id:)
+            response = Client.new.get_authenticators(user_id: user_id)
 
             handle_response(response)
         end
 
-        def update_action_state(user_id:, action:, idempotency_key:, state:)
-            # NOTE: Rely on API to respond when given invalid state
-            response = Client.new.update_action_state(user_id: user_id, action: action, idempotency_key: idempotency_key, state: state)
+        def enroll_verified_authenticator(user_id:, attributes:)
+            response = Client.new.enroll_verified_authenticator(user_id: user_id, attributes: attributes)
 
             handle_response(response)
         end
 
-        def enroll_verified_authenticator(user_id:, authenticator:)
-            response = Client.new.enroll_verified_authenticator(user_id, authenticator)
+        def delete_authenticator(user_id:, user_authenticator_id:)
+            response = Client.new.delete_authenticator(user_id: user_id, user_authenticator_id: user_authenticator_id)
 
             handle_response(response)
         end
 
-        def delete_authenticator(user_id:, user_authenticator_id: )
-            response = Client.new.delete_authenticator(user_id: user_id, user_authenticator_id: user_authenticator_id)
+        def track(user_id:, action:, attributes:)
+            response = Client.new.track(user_id: user_id, action: action, attributes: attributes)
+            handle_response(response)
+        end
 
+        def validate_challenge(token:, user_id: nil, action: nil)
+            response = Client.new.validate_challenge(token: token,user_id: user_id, action: action)
+            
             handle_response(response)
         end
 
-        def track(event, options={})
-            raise ArgumentError, "Action Code is required" unless event[:action].to_s.length > 0
-            raise ArgumentError, "User ID value" unless event[:user_id].to_s.length > 0
+        def get_action(user_id:, action:, idempotency_key:)
+            response = Client.new.get_action(user_id: user_id, action: action, idempotency_key: idempotency_key)
 
-            response = Client.new.track(event)
             handle_response(response)
         end
 
-        def validate_challenge(token:, user_id: nil, action: nil)
-            response = Client.new.validate_challenge(user_id: user_id, token: token, action: action)
-            
+        def update_action(user_id:, action:, idempotency_key:, attributes:)
+            response = Client.new.update_action(user_id: user_id, action: action, idempotency_key: idempotency_key, attributes: attributes)
+
             handle_response(response)
         end
 
@@ -93,15 +95,19 @@ module Authsignal
         end
 
         def handle_success_response(response)
-            response.body.merge(success?: true)
+            if response.body.is_a?(Array)
+                { success?: true, data: response.body }
+            else
+                response.body.merge(success?: true)
+            end
         end
 
         def handle_error_response(response)
             case response.body
             when Hash
-                response.body.merge(status: response.status, success?: false)
+                { status_code: response.status, success?: false, error_code: response.body[:error], error_description: response.body[:error_description] }
             else
-                { status: response&.status || 500, success?: false }
+                { status_code: response&.status || 500, success?: false }
             end
         end
     end
@@ -110,11 +116,11 @@ module Authsignal
     (methods - NON_API_METHODS).each do |method|
         define_singleton_method("#{method}!") do |*args, **kwargs|
             send(method, *args, **kwargs).tap do |response|
-                status = response[:status]
-                err = response[:error]
-                desc = response[:error_description]
+                status_code = response[:status_code]
+                error_code = response[:error_code]
+                error_description = response[:error_description]
 
-                raise ApiError.new(err, status, err, desc) unless response[:success?]
+                raise ApiError.new(status_code, error_code, error_description) unless response[:success?]
             end
         end
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: authsignal-ruby
 version: !ruby/object:Gem::Version
-  version: 4.1.0
+  version: 5.0.0
 platform: ruby
 authors:
 - justinsoong
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-05 00:00:00.000000000 Z
+date: 2024-11-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -127,7 +127,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: The Authsignal ruby server side signal API.