yoti 1.6.1 → 1.7.1

data/lib/yoti/activity_details.rb

@@ -1,4 +1,5 @@
 require 'net/http'
+require 'time'
 
 module Yoti
   #

data/lib/yoti/client.rb

@@ -1,15 +1,17 @@
 module Yoti
   #
-  # Handles all the publicly accesible Yoti methods for
-  # geting data using an encrypted connect token
+  # Handles all the publicly accessible Yoti methods for
+  # getting data using an encrypted connect token
   #
   module Client
     #
     # Performs all the steps required to get the decrypted profile from an API request
     #
-    # @param encrypted_connect_token [String] token provided as a base 64 string
+    # @param [String] encrypted_connect_token
+    #   Token provided as a base 64 string
     #
-    # @return [Object] an ActivityDetails instance encapsulating the user profile
+    # @return [ActivityDetails]
+    #   An ActivityDetails instance encapsulating the user profile
     #
     def self.get_activity_details(encrypted_connect_token)
       receipt = Yoti::ProfileRequest.new(encrypted_connect_token).receipt
@@ -22,6 +24,13 @@ module Yoti
       ActivityDetails.new(receipt, user_profile, application_profile, extra_data)
     end
 
+    #
+    # Perform AML check
+    #
+    # @param [AmlProfile] aml_profile
+    #
+    # @return [<Hash>]
+    #
     def self.aml_check(aml_profile)
       Yoti::AmlCheckRequest.new(aml_profile).response
     end

data/lib/yoti/configuration.rb

@@ -3,7 +3,7 @@ module Yoti
     attr_accessor :client_sdk_id, :key_file_path, :key, :sdk_identifier,
                   :api_url, :api_port, :api_version
 
-    attr_writer :api_endpoint
+    attr_writer :api_endpoint, :doc_scan_api_endpoint
 
     # Set config variables by using a configuration block
     def initialize
@@ -18,7 +18,12 @@ module Yoti
 
     # @return [String] the API endpoint for the selected API version
     def api_endpoint
-      @api_endpoint ||= "#{@api_url}/api/#{@api_version}"
+      @api_endpoint ||= ENV['YOTI_API_URL'] || "#{@api_url}/api/#{@api_version}"
+    end
+
+    # @return [String] the Doc Scan API endpoint
+    def doc_scan_api_endpoint
+      @doc_scan_api_endpoint ||= ENV['YOTI_DOC_SCAN_API_URL'] || "#{@api_url}/idverify/#{@api_version}"
     end
 
     # Validates the configuration values set in instance variables

data/lib/yoti/data_type/age_verification.rb

@@ -37,7 +37,7 @@ module Yoti
     attr_reader :age
 
     #
-    # @param [Yoti::Attribute]
+    # @param [Yoti::Attribute] attribute
     #
     def initialize(attribute)
       raise(ArgumentError, "'#{attribute.name}' is not a valid age verification") unless /^[^:]+:(?!.*:)[0-9]+$/.match?(attribute.name)

data/lib/yoti/data_type/base_profile.rb

@@ -37,7 +37,7 @@ module Yoti
     #
     # @param [String] name
     #
-    # @returns [Array]
+    # @return [Array]
     #
     def find_attributes_starting_with(name)
       @attributes.select { |key| key.to_s.start_with?(name) }

data/lib/yoti/data_type/document_details.rb

@@ -1,10 +1,10 @@
 module Yoti
   class DocumentDetails
     #
-    # The values of the Document Details are in the format and order as defined in this pattern
-    # e.g PASS_CARD GBR 22719564893 - CITIZENCARD, the last two are optionals
+    # @deprecated 2.0.0 pattern is no longer used for validation.
     #
     VALIDATION_PATTERN = '^([A-Za-z_]*) ([A-Za-z]{3}) ([A-Za-z0-9]{1}).*$'
+
     TYPE_INDEX = 0
     COUNTRY_INDEX = 1
     NUMBER_INDEX = 2
@@ -51,28 +51,20 @@ module Yoti
     # @param [String] value
     #
     def initialize(value)
-      validate_value(value)
       parse_value(value)
     end
 
     private
 
-    #
-    # Asserts provided matches VALIDATION_PATTERN
-    #
-    # @param [String] value
-    #
-    def validate_value(value)
-      raise(ArgumentError, "Invalid value for #{self.class.name}") unless /#{VALIDATION_PATTERN}/.match?(value)
-    end
-
     #
     # Parses provided value into separate attributes
     #
     # @param [String] value
     #
     def parse_value(value)
-      attributes = value.split(' ')
+      attributes = value.split(/ /)
+      raise(ArgumentError, "Invalid value for #{self.class.name}") if attributes.length < 3 || attributes.include?('')
+
       @type = attributes[TYPE_INDEX]
       @issuing_country = attributes[COUNTRY_INDEX]
       @document_number = attributes[NUMBER_INDEX]

data/lib/yoti/data_type/image.rb

@@ -1,19 +1,11 @@
-require 'base64'
+# frozen_string_literal: true
 
 module Yoti
-  class Image
-    attr_reader :content
-    attr_reader :mime_type
-
+  class Image < Media
     def initialize(content, mime_type)
-      raise(TypeError, 'Image is an abstract class, so cannot be instantiated') if self.class == Yoti::Image
-
-      @content = content
-      @mime_type = mime_type
-    end
+      raise(TypeError, "#{self.class} is an abstract class, so cannot be instantiated") if self.class == Image
 
-    def base64_content
-      "data:#{mime_type};base64,#{Base64.strict_encode64(content)}"
+      super(content, mime_type)
     end
   end
 end

data/lib/yoti/data_type/image_jpeg.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Yoti
   class ImageJpeg < Image
     def initialize(content)

data/lib/yoti/data_type/image_png.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Yoti
   class ImagePng < Image
     def initialize(content)

data/lib/yoti/data_type/media.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require 'base64'
+
+module Yoti
+  class Media
+    attr_reader :content
+    attr_reader :mime_type
+
+    def initialize(content, mime_type)
+      @content = content
+      @mime_type = mime_type
+    end
+
+    def base64_content
+      "data:#{mime_type};base64,#{Base64.strict_encode64(content)}"
+    end
+  end
+end

data/lib/yoti/doc_scan/client.rb

@@ -0,0 +1,163 @@
+# frozen_string_literal: true
+
+module Yoti
+  module DocScan
+    class Client
+      class << self
+        #
+        # Creates a Doc Scan session using the supplied session specification
+        #
+        # @param [Yoti::DocScan::Session::Create::SessionSpecification] session_specification
+        #
+        # @return [Yoti::DocScan::Session::Create::CreateSessionResult]
+        #
+        def create_session(session_specification)
+          Validation.assert_is_a(
+            Yoti::DocScan::Session::Create::SessionSpecification,
+            session_specification,
+            'session_specification'
+          )
+
+          response = create_request
+                     .with_http_method('POST')
+                     .with_endpoint('sessions')
+                     .with_payload(session_specification)
+                     .with_query_param('sdkId', Yoti.configuration.client_sdk_id)
+                     .build
+                     .execute
+
+          Yoti::DocScan::Session::Create::CreateSessionResult.new(JSON.parse(response.body))
+        end
+
+        #
+        # Retrieves the state of a previously created Yoti Doc Scan session
+        #
+        # @param [String] session_id
+        #
+        # @return [Yoti::DocScan::Session::Retrieve::GetSessionResult]
+        #
+        def get_session(session_id)
+          Validation.assert_is_a(String, session_id, 'session_id')
+
+          response = create_request
+                     .with_http_method('GET')
+                     .with_endpoint(session_path(session_id))
+                     .with_query_param('sdkId', Yoti.configuration.client_sdk_id)
+                     .build
+                     .execute
+
+          Yoti::DocScan::Session::Retrieve::GetSessionResult.new(JSON.parse(response.body))
+        end
+
+        #
+        # Deletes a previously created Yoti Doc Scan session and all
+        # of its related resources
+        #
+        # @param [String] session_id
+        #
+        def delete_session(session_id)
+          Validation.assert_is_a(String, session_id, 'session_id')
+
+          create_request
+            .with_http_method('DELETE')
+            .with_endpoint(session_path(session_id))
+            .with_query_param('sdkId', Yoti.configuration.client_sdk_id)
+            .build
+            .execute
+        end
+
+        #
+        # Retrieves media related to a Yoti Doc Scan session based
+        # on the supplied media ID
+        #
+        # @param [String] session_id
+        # @param [String] media_id
+        #
+        # @return [Yoti::Media]
+        #
+        def get_media_content(session_id, media_id)
+          Validation.assert_is_a(String, session_id, 'session_id')
+          Validation.assert_is_a(String, media_id, 'media_id')
+
+          response = create_request
+                     .with_http_method('GET')
+                     .with_endpoint(media_path(session_id, media_id))
+                     .with_query_param('sdkId', Yoti.configuration.client_sdk_id)
+                     .build
+                     .execute
+
+          Yoti::Media.new(
+            response.body,
+            response.get_fields('content-type')[0]
+          )
+        end
+
+        #
+        # Deletes media related to a Yoti Doc Scan session based
+        # on the supplied media ID
+        #
+        # @param [String] session_id
+        # @param [String] media_id
+        #
+        def delete_media_content(session_id, media_id)
+          Validation.assert_is_a(String, session_id, 'session_id')
+          Validation.assert_is_a(String, media_id, 'media_id')
+
+          create_request
+            .with_http_method('DELETE')
+            .with_endpoint(media_path(session_id, media_id))
+            .with_query_param('sdkId', Yoti.configuration.client_sdk_id)
+            .build
+            .execute
+        end
+
+        #
+        # Gets a list of supported documents.
+        #
+        # @return [Yoti::DocScan::Support::SupportedDocumentsResponse]
+        #
+        def supported_documents
+          response = create_request
+                     .with_http_method('GET')
+                     .with_endpoint('supported-documents')
+                     .build
+                     .execute
+
+          Yoti::DocScan::Support::SupportedDocumentsResponse.new(JSON.parse(response.body))
+        end
+
+        private
+
+        #
+        # @param [String] session_id
+        #
+        # @return [String]
+        #
+        def session_path(session_id)
+          "sessions/#{session_id}"
+        end
+
+        #
+        # @param [String] session_id
+        # @param [String] media_id
+        #
+        # @return [String]
+        #
+        def media_path(session_id, media_id)
+          "#{session_path(session_id)}/media/#{media_id}/content"
+        end
+
+        #
+        # Create a base Doc Scan request
+        #
+        # @return [Yoti::Request]
+        #
+        def create_request
+          Yoti::Request
+            .builder
+            .with_base_url(Yoti.configuration.doc_scan_api_endpoint)
+        end
+      end
+    end
+  end
+end

data/lib/yoti/doc_scan/constants.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Yoti
+  module DocScan
+    class Constants
+      ID_DOCUMENT_AUTHENTICITY = 'ID_DOCUMENT_AUTHENTICITY'
+      ID_DOCUMENT_TEXT_DATA_CHECK = 'ID_DOCUMENT_TEXT_DATA_CHECK'
+      ID_DOCUMENT_FACE_MATCH = 'ID_DOCUMENT_FACE_MATCH'
+      LIVENESS = 'LIVENESS'
+      ID_DOCUMENT_TEXT_DATA_EXTRACTION = 'ID_DOCUMENT_TEXT_DATA_EXTRACTION'
+      ID_DOCUMENT = 'ID_DOCUMENT'
+      ORTHOGONAL_RESTRICTIONS = 'ORTHOGONAL_RESTRICTIONS'
+      DOCUMENT_RESTRICTIONS = 'DOCUMENT_RESTRICTIONS'
+      INCLUDE = 'WHITELIST'
+      EXCLUDE = 'BLACKLIST'
+      ALWAYS = 'ALWAYS'
+      FALLBACK = 'FALLBACK'
+      NEVER = 'NEVER'
+      ZOOM = 'ZOOM'
+      CAMERA = 'CAMERA'
+      CAMERA_AND_UPLOAD = 'CAMERA_AND_UPLOAD'
+      RESOURCE_UPDATE = 'RESOURCE_UPDATE'
+      TASK_COMPLETION = 'TASK_COMPLETION'
+      CHECK_COMPLETION = 'CHECK_COMPLETION'
+      SESSION_COMPLETION = 'SESSION_COMPLETION'
+    end
+  end
+end

data/lib/yoti/doc_scan/session/create/create_session_result.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Yoti
+  module DocScan
+    module Session
+      module Create
+        #
+        # The response to a successful CreateSession call
+        #
+        class CreateSessionResult
+          #
+          # Returns the time-to-live (TTL) for the client session
+          # token for the created session
+          #
+          # @return [Integer]
+          #
+          attr_reader :client_session_token_ttl
+
+          #
+          # Returns the client session token for the created session
+          #
+          # @return [String]
+          #
+          attr_reader :client_session_token
+
+          #
+          # Session ID of the created session
+          #
+          # @return [String]
+          #
+          attr_reader :session_id
+
+          #
+          # @param [Hash] response
+          #
+          def initialize(response)
+            Validation.assert_is_a(Integer, response['client_session_token_ttl'], 'client_session_token_ttl', true)
+            @client_session_token_ttl = response['client_session_token_ttl']
+
+            Validation.assert_is_a(String, response['client_session_token'], 'client_session_token', true)
+            @client_session_token = response['client_session_token']
+
+            Validation.assert_is_a(String, response['session_id'], 'session_id', true)
+            @session_id = response['session_id']
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yoti/doc_scan/session/create/document_filter.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Yoti
+  module DocScan
+    module Session
+      module Create
+        class DocumentFilter
+          #
+          # @param [String] type
+          #
+          def initialize(type)
+            raise(TypeError, "#{self.class} cannot be instantiated") if self.class == DocumentFilter
+
+            Validation.assert_is_a(String, type, 'type')
+            @type = type
+          end
+
+          def to_json(*_args)
+            as_json.to_json
+          end
+
+          def as_json(*_args)
+            {
+              type: @type
+            }
+          end
+        end
+      end
+    end
+  end
+end