wesley-key-sdk 3.0.6 → 4.0.0

data/lib/{cypress_test_api → webhooks_and_callbacks_api}/configuration.rb

@@ -1,9 +1,9 @@
-# cypress_test_api
+# webhooks_and_callbacks_api
 #
-# This file was automatically generated by APIMATIC v3.0
-# ( https://www.apimatic.io ).
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
 
-module CypressTestApi
+module WebhooksAndCallbacksApi
   # An enum for SDK environments.
   class Environment
     ENVIRONMENT = [
@@ -14,7 +14,7 @@ module CypressTestApi
     def self.from_value(value, default_value = PRODUCTION)
       return default_value if value.nil?
 
-      default_value
+      default_value
     end
   end
 
@@ -28,7 +28,7 @@ module CypressTestApi
     def self.from_value(value, default_value = DEFAULT)
       return default_value if value.nil?
 
-      default_value
+      default_value
     end
   end
 
@@ -36,31 +36,37 @@ module CypressTestApi
   # are configured in this class.
   class Configuration < CoreLibrary::HttpClientConfiguration
     # The attribute readers for properties.
-    attr_reader :environment, :default_host
+    attr_reader :environment, :api_key_credentials, :bearer_auth_credentials
 
     class << self
       attr_reader :environments
     end
 
     def initialize(
-      connection: nil, adapter: :net_http_persistent, timeout: 60,
+      connection: nil, adapter: :net_http_persistent, timeout: 50,
       max_retries: 0, retry_interval: 1, backoff_factor: 2,
-      retry_statuses: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
-      retry_methods: %i[get put], http_callback: nil, proxy_settings: nil,
-      environment: Environment::PRODUCTION, default_host: 'www.example.com'
-    )
+      retry_statuses: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524, 408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
+      retry_methods: %i[get put get put], http_callback: nil,
+      proxy_settings: nil, logging_configuration: nil,
+      environment: Environment::PRODUCTION, api_key_credentials: nil,
+      bearer_auth_credentials: nil
+    )
       super connection: connection, adapter: adapter, timeout: timeout,
             max_retries: max_retries, retry_interval: retry_interval,
             backoff_factor: backoff_factor, retry_statuses: retry_statuses,
             retry_methods: retry_methods, http_callback: http_callback,
-            proxy_settings: proxy_settings
-
+            proxy_settings: proxy_settings,
+            logging_configuration: logging_configuration
+
       # Current API environment
       @environment = String(environment)
-
-      # defaultHost value
-      @default_host = default_host
-
+
+      # The object holding Custom Header Signature credentials
+      @api_key_credentials = api_key_credentials
+
+      # The object holding OAuth 2 Bearer token credentials
+      @bearer_auth_credentials = bearer_auth_credentials
+
       # The Http Client to use for making requests.
       set_http_client CoreLibrary::FaradayClient.new(self)
     end
@@ -68,20 +74,24 @@ module CypressTestApi
     def clone_with(connection: nil, adapter: nil, timeout: nil,
                    max_retries: nil, retry_interval: nil, backoff_factor: nil,
                    retry_statuses: nil, retry_methods: nil, http_callback: nil,
-                   proxy_settings: nil, environment: nil, default_host: nil)
-      connection ||= self.connection
-      adapter ||= self.adapter
-      timeout ||= self.timeout
-      max_retries ||= self.max_retries
-      retry_interval ||= self.retry_interval
-      backoff_factor ||= self.backoff_factor
-      retry_statuses ||= self.retry_statuses
-      retry_methods ||= self.retry_methods
-      http_callback ||= self.http_callback
-      proxy_settings ||= self.proxy_settings
-      environment ||= self.environment
-      default_host ||= self.default_host
-
+                   proxy_settings: nil, logging_configuration: nil,
+                   environment: nil, api_key_credentials: nil,
+                   bearer_auth_credentials: nil)
+      connection ||= self.connection
+      adapter ||= self.adapter
+      timeout ||= self.timeout
+      max_retries ||= self.max_retries
+      retry_interval ||= self.retry_interval
+      backoff_factor ||= self.backoff_factor
+      retry_statuses ||= self.retry_statuses
+      retry_methods ||= self.retry_methods
+      http_callback ||= self.http_callback
+      proxy_settings ||= self.proxy_settings
+      logging_configuration ||= self.logging_configuration
+      environment ||= self.environment
+      api_key_credentials ||= self.api_key_credentials
+      bearer_auth_credentials ||= self.bearer_auth_credentials
+
       Configuration.new(connection: connection, adapter: adapter,
                         timeout: timeout, max_retries: max_retries,
                         retry_interval: retry_interval,
@@ -90,14 +100,17 @@ module CypressTestApi
                         retry_methods: retry_methods,
                         http_callback: http_callback,
                         proxy_settings: proxy_settings,
-                        environment: environment, default_host: default_host)
+                        logging_configuration: logging_configuration,
+                        environment: environment,
+                        api_key_credentials: api_key_credentials,
+                        bearer_auth_credentials: bearer_auth_credentials)
     end
 
 
     # All the environments the SDK can run in.
     ENVIRONMENTS = {
       Environment::PRODUCTION => {
-        Server::DEFAULT => 'https://{defaultHost}'
+        Server::DEFAULT => 'http://localhost:3000/callbacks'
       }
     }.freeze
 
@@ -106,50 +119,52 @@ module CypressTestApi
     # required.
     # @return [String] The base URI.
     def get_base_uri(server = Server::DEFAULT)
-      parameters = {
-        'defaultHost' => { 'value' => default_host, 'encode' => false }
-      }
-      APIHelper.append_url_with_template_parameters(
-        ENVIRONMENTS[environment][server], parameters
-      )
+      ENVIRONMENTS[environment][server].clone
     end
 
     # Builds a Configuration instance using environment variables.
     def self.build_default_config_from_env
       # === Core environment ===
       environment = Environment.from_value(ENV.fetch('ENVIRONMENT', 'production'))
-      default_host = ENV.fetch('DEFAULT_HOST', 'www.example.com')
-      timeout = (ENV['TIMEOUT'] || 60).to_f
+      timeout = (ENV['TIMEOUT'] || 50).to_f
       max_retries = (ENV['MAX_RETRIES'] || 0).to_i
       retry_interval = (ENV['RETRY_INTERVAL'] || 1).to_f
       backoff_factor = (ENV['BACKOFF_FACTOR'] || 2).to_f
       retry_statuses = ENV.fetch('RETRY_STATUSES',
-                                 '[408, 413, 429, 500, 502, 503, 504, 521, 522, 524]').gsub(/[\[\]]/, '')
+                                 '[408, 413, 429, 500, 502, 503, 504, 521, 522, 524, 408, 413, 429, 500, 502, 503, 504, 521, 522, 524]').gsub(/[\[\]]/, '')
                                           .split(',')
                                           .map(&:strip)
                                           .map do |item|
                                             item.match?(/\A\d+\z/) ? item.to_i : item.downcase
                                           end
-      retry_methods = ENV.fetch('RETRY_METHODS', '%i[get put]').gsub(/[\[\]]/, '')
+      retry_methods = ENV.fetch('RETRY_METHODS', '%i[get put get put]').gsub(/[\[\]]/, '')
                                           .split(',')
                                           .map(&:strip)
                                           .map do |item|
                                             item.match?(/\A\d+\z/) ? item.to_i : item.downcase
                                           end
 
+      # === Authentication credentials ===
+      api_key_credentials = ApiKeyCredentials.from_env
+      bearer_auth_credentials = BearerAuthCredentials.from_env
+
       # === Proxy settings ===
       proxy_settings = ProxySettings.from_env
+      # === Logging Configuration ===
+      logging_configuration = LoggingConfiguration.from_env if LoggingConfiguration.any_logging_configured?
 
       Configuration.new(
         environment: environment,
-        default_host: default_host,
         timeout: timeout,
         max_retries: max_retries,
         retry_interval: retry_interval,
         backoff_factor: backoff_factor,
         retry_statuses: retry_statuses,
         retry_methods: retry_methods,
-        proxy_settings: proxy_settings
+        api_key_credentials: api_key_credentials,
+        bearer_auth_credentials: bearer_auth_credentials,
+        proxy_settings: proxy_settings,
+        logging_configuration: logging_configuration
       )
     end
   end

data/lib/webhooks_and_callbacks_api/events/callbacks/callbacks_a_handler.rb

@@ -0,0 +1,66 @@
+# webhooks_and_callbacks_api
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module WebhooksAndCallbacksApi
+  # CallbacksAHandler is responsible for verifying request signatures
+  # and parsing incoming callbacksA events into strongly typed objects.
+  class CallbacksAHandler
+    include CoreLibrary
+    # Creates a new instance of the CallbacksAHandler.
+    # Initializes the handler.
+    # @param [String] secret_key
+    # The secret used to generate and validate HMAC signatures for verifying request authenticity.
+    # @raise [ArgumentError] If the secret_key is not provided.
+    def initialize(secret_key)
+      raise ArgumentError, 'secret_key must be provided for signature verification.' unless secret_key
+
+      @verifier = HmacSignatureVerifier.new(
+        secret_key: secret_key,
+        signature_header: 'X-Signature',
+        hash_algorithm: 'sha256',
+        encoder: HexEncoder.new
+      )
+    end
+
+    # Perform signature verification and return the result.
+    #
+    # @param [Rack::Request] request The incoming HTTP request to verify.
+    # @return [SignatureVerificationResult] The result of the signature verification.
+    def verify(request)
+      @verifier.verify(request)
+    end
+
+    # Verify the request signature and parse the event.
+    #
+    # @param [Rack::Request] request The incoming HTTP request containing the event payload.
+    # @return[PaymentCallback, FulfillmentCallback,
+    # SignatureVerificationFailure, UnknownEvent]
+    # PaymentCallback, FulfillmentCallback for successful parsing;
+    #
+    # SignatureVerificationFailure when signature fails;
+    # UnknownEvent for
+    # unknown events.
+    def verify_and_parse_event(request)
+      unless request.respond_to?(:env) && request.env.is_a?(Hash)
+        return SignatureVerificationFailure.new(['Invalid request env.'])
+      end
+
+      raw_body = RackRequestHelper.read_raw_body(request)
+      return SignatureVerificationFailure.new(['Invalid request body.']) if raw_body.nil? || raw_body.empty?
+
+      verification_result = verify(request)
+      return SignatureVerificationFailure.new(verification_result.errors) unless verification_result.ok
+
+      # Deserialize payload
+      begin
+        union = UnionTypeLookUp.get(:CallbacksA)
+        raw = RackRequestHelper.read_raw_body(request)
+        APIHelper.deserialize_union_type(union, raw, false, true)
+      rescue StandardError => e
+        UnknownEvent.new(['Deserialization failed.', e.message])
+      end
+    end
+  end
+end

data/lib/webhooks_and_callbacks_api/events/callbacks/callbacks_b_handler.rb

@@ -0,0 +1,78 @@
+# webhooks_and_callbacks_api
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module WebhooksAndCallbacksApi
+  # CallbacksBHandler is responsible for verifying request signatures
+  # and parsing incoming callbacksB events into strongly typed objects.
+  class CallbacksBHandler
+    include CoreLibrary
+    # Creates a new instance of the CallbacksBHandler.
+    # Initializes the handler.
+    # @param [String] secret_key
+    # The secret used to generate and validate HMAC signatures for verifying request authenticity.
+    # @raise [ArgumentError] If the secret_key is not provided.
+    def initialize(secret_key)
+      raise ArgumentError, 'secret_key must be provided for signature verification.' unless secret_key
+
+      @verifier = HmacSignatureVerifier.new(
+        secret_key: secret_key,
+        signature_header: 'X-Signature',
+        hash_algorithm: 'sha256',
+        encoder: HexEncoder.new,
+        canonical_message_builder: method(:_canonical_message_builder)
+      )
+    end
+
+    # Perform signature verification and return the result.
+    #
+    # @param [Rack::Request] request The incoming HTTP request to verify.
+    # @return [SignatureVerificationResult] The result of the signature verification.
+    def verify(request)
+      @verifier.verify(request)
+    end
+
+    # Verify the request signature and parse the event.
+    #
+    # @param [Rack::Request] request The incoming HTTP request containing the event payload.
+    # @return[NotificationCallback, SignatureVerificationFailure, UnknownEvent]
+    # NotificationCallback for successful parsing;
+    #
+    # SignatureVerificationFailure when signature fails;
+    # UnknownEvent for
+    # unknown events.
+    def verify_and_parse_event(request)
+      unless request.respond_to?(:env) && request.env.is_a?(Hash)
+        return SignatureVerificationFailure.new(['Invalid request env.'])
+      end
+
+      raw_body = RackRequestHelper.read_raw_body(request)
+      return SignatureVerificationFailure.new(['Invalid request body.']) if raw_body.nil? || raw_body.empty?
+
+      verification_result = verify(request)
+      return SignatureVerificationFailure.new(verification_result.errors) unless verification_result.ok
+
+      # Deserialize payload
+      begin
+        union = UnionTypeLookUp.get(:CallbacksB)
+        raw = RackRequestHelper.read_raw_body(request)
+        APIHelper.deserialize_union_type(union, raw, false, true)
+      rescue StandardError => e
+        UnknownEvent.new(['Deserialization failed.', e.message])
+      end
+    end
+
+    # Builds the canonical message from the request for the signature verification.
+    #
+    # @param [Rack::Request] request The incoming HTTP request.
+    # @return [String, nil] The canonical message as a string, or nil if it could not be constructed.
+    def _canonical_message_builder(request)
+      payload = RackRequestHelper.read_raw_body(request)
+      notification_type = JsonPointerHelper.get_value_by_json_pointer(
+        APIHelper.json_deserialize(payload), 'notificationType'
+      )
+      notification_type.to_s
+    end
+  end
+end

data/lib/webhooks_and_callbacks_api/events/signature_verification_failure.rb

@@ -0,0 +1,33 @@
+# webhooks_and_callbacks_api
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module WebhooksAndCallbacksApi
+  # Represents a signature verification failure.
+  # @param errors [Array<String>] List of error messages describing why verification failed.
+  class SignatureVerificationFailure
+    # @return [Array<String>]
+    attr_reader :errors
+
+    # Initialize with the list of errors.
+    # @param errors [Array<String>] Error messages that caused the failure.
+    def initialize(errors)
+      @errors = errors
+    end
+
+    # Provides a user-friendly string representation of the failure.
+    # @return [String]
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} errors: #{@errors}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    # @return [String]
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} errors: #{@errors.inspect}>"
+    end
+  end
+end

data/lib/webhooks_and_callbacks_api/events/signature_verification_result.rb

@@ -0,0 +1,14 @@
+# webhooks_and_callbacks_api
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module WebhooksAndCallbacksApi
+  # Outcome of signature verification.
+  # @!attribute [r] ok
+  #   @return [Boolean] True if the signature verification passed.
+  # @!attribute [r] errors
+  #   @return [Array<String>, nil] Optional list of errors raised by the verifier. None when ok=true.
+  class SignatureVerificationResult < CoreLibrary::SignatureVerificationResult
+  end
+end

data/lib/webhooks_and_callbacks_api/events/unknown_event.rb

@@ -0,0 +1,32 @@
+# webhooks_and_callbacks_api
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module WebhooksAndCallbacksApi
+  # Represents an unrecognized or unsupported event during processing.
+  class UnknownEvent
+    # @return [Array<String>]
+    attr_reader :errors
+
+    # Initialize with the errors that caused the failure.
+    # @param errors [Array<String>] A list of error messages describing the reasons for verification failure.
+    def initialize(errors)
+      @errors = errors
+    end
+
+    # Provides a user-friendly string representation of the failure.
+    # @return [String]
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} errors: #{@errors}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    # @return [String]
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} errors: #{@errors.inspect}>"
+    end
+  end
+end

data/lib/webhooks_and_callbacks_api/events/webhooks/webhooks_a_handler.rb

@@ -0,0 +1,67 @@
+# webhooks_and_callbacks_api
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module WebhooksAndCallbacksApi
+  # WebhooksAHandler is responsible for verifying request signatures
+  # and parsing incoming webhooksA events into strongly typed objects.
+  class WebhooksAHandler
+    include CoreLibrary
+    # Creates a new instance of the WebhooksAHandler.
+    # Initializes the handler.
+    # @param [String] secret_key
+    # The secret used to generate and validate HMAC signatures for verifying request authenticity.
+    # @raise [ArgumentError] If the secret_key is not provided.
+    def initialize(secret_key)
+      raise ArgumentError, 'secret_key must be provided for signature verification.' unless secret_key
+
+      @verifier = HmacSignatureVerifier.new(
+        secret_key: secret_key,
+        signature_header: 'X-Signature',
+        hash_algorithm: 'sha256',
+        encoder: HexEncoder.new,
+        signature_value_template: 'sha256={digest}'
+      )
+    end
+
+    # Perform signature verification and return the result.
+    #
+    # @param [Rack::Request] request The incoming HTTP request to verify.
+    # @return [SignatureVerificationResult] The result of the signature verification.
+    def verify(request)
+      @verifier.verify(request)
+    end
+
+    # Verify the request signature and parse the event.
+    #
+    # @param [Rack::Request] request The incoming HTTP request containing the event payload.
+    # @return[PaymentStatusUpdatedEvent, PaymentStatusCreatedEvent,
+    # SignatureVerificationFailure, UnknownEvent]
+    # PaymentStatusUpdatedEvent, PaymentStatusCreatedEvent for successful
+    # parsing;
+    # SignatureVerificationFailure when signature fails;
+    #
+    # UnknownEvent for unknown events.
+    def verify_and_parse_event(request)
+      unless request.respond_to?(:env) && request.env.is_a?(Hash)
+        return SignatureVerificationFailure.new(['Invalid request env.'])
+      end
+
+      raw_body = RackRequestHelper.read_raw_body(request)
+      return SignatureVerificationFailure.new(['Invalid request body.']) if raw_body.nil? || raw_body.empty?
+
+      verification_result = verify(request)
+      return SignatureVerificationFailure.new(verification_result.errors) unless verification_result.ok
+
+      # Deserialize payload
+      begin
+        union = UnionTypeLookUp.get(:WebhooksA)
+        raw = RackRequestHelper.read_raw_body(request)
+        APIHelper.deserialize_union_type(union, raw, false, true)
+      rescue StandardError => e
+        UnknownEvent.new(['Deserialization failed.', e.message])
+      end
+    end
+  end
+end

data/lib/webhooks_and_callbacks_api/events/webhooks/webhooks_b_handler.rb

@@ -0,0 +1,86 @@
+# webhooks_and_callbacks_api
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module WebhooksAndCallbacksApi
+  # WebhooksBHandler is responsible for verifying request signatures
+  # and parsing incoming webhooksB events into strongly typed objects.
+  class WebhooksBHandler
+    include CoreLibrary
+    # Creates a new instance of the WebhooksBHandler.
+    # Initializes the handler.
+    # @param [String] secret_key
+    # The secret used to generate and validate HMAC signatures for verifying request authenticity.
+    # @raise [ArgumentError] If the secret_key is not provided.
+    def initialize(secret_key)
+      raise ArgumentError, 'secret_key must be provided for signature verification.' unless secret_key
+
+      @verifier = HmacSignatureVerifier.new(
+        secret_key: secret_key,
+        signature_header: 'X-Webhook-Signature',
+        hash_algorithm: 'sha512',
+        encoder: Base64Encoder.new,
+        signature_value_template: 'v1={digest}',
+        canonical_message_builder: method(:_canonical_message_builder)
+      )
+    end
+
+    # Perform signature verification and return the result.
+    #
+    # @param [Rack::Request] request The incoming HTTP request to verify.
+    # @return [SignatureVerificationResult] The result of the signature verification.
+    def verify(request)
+      @verifier.verify(request)
+    end
+
+    # Verify the request signature and parse the event.
+    #
+    # @param [Rack::Request] request The incoming HTTP request containing the event payload.
+    # @return[UserActionNotificationEvent, UserStatusNotificationEvent,
+    # UserPreferenceNotificationEvent, SystemAlertNotificationEvent,
+    # SystemMaintenanceNotificationEvent, SystemPerformanceNotificationEvent,
+    # InventoryStockIncreaseEvent, InventoryStockDecreaseEvent,
+    # InventoryStockDepletedEvent, SignatureVerificationFailure, UnknownEvent]
+    # UserActionNotificationEvent, UserStatusNotificationEvent,
+    # UserPreferenceNotificationEvent, SystemAlertNotificationEvent,
+    # SystemMaintenanceNotificationEvent, SystemPerformanceNotificationEvent,
+    # InventoryStockIncreaseEvent, InventoryStockDecreaseEvent,
+    # InventoryStockDepletedEvent for successful parsing;
+    #
+    # SignatureVerificationFailure when signature fails;
+    # UnknownEvent for
+    # unknown events.
+    def verify_and_parse_event(request)
+      unless request.respond_to?(:env) && request.env.is_a?(Hash)
+        return SignatureVerificationFailure.new(['Invalid request env.'])
+      end
+
+      raw_body = RackRequestHelper.read_raw_body(request)
+      return SignatureVerificationFailure.new(['Invalid request body.']) if raw_body.nil? || raw_body.empty?
+
+      verification_result = verify(request)
+      return SignatureVerificationFailure.new(verification_result.errors) unless verification_result.ok
+
+      # Deserialize payload
+      begin
+        union = UnionTypeLookUp.get(:WebhooksB)
+        raw = RackRequestHelper.read_raw_body(request)
+        APIHelper.deserialize_union_type(union, raw, false, true)
+      rescue StandardError => e
+        UnknownEvent.new(['Deserialization failed.', e.message])
+      end
+    end
+
+    # Builds the canonical message from the request for the signature verification.
+    #
+    # @param [Rack::Request] request The incoming HTTP request.
+    # @return [String, nil] The canonical message as a string, or nil if it could not be constructed.
+    def _canonical_message_builder(request)
+      payload = RackRequestHelper.read_raw_body(request)
+      method = request.request_method
+      x_timestamp = request.get_header(RackRequestHelper.prepend_header('X-Timestamp'))
+      "#{method}|#{x_timestamp}|#{payload}"
+    end
+  end
+end

data/lib/webhooks_and_callbacks_api/events/webhooks/webhooks_c_handler.rb

@@ -0,0 +1,79 @@
+# webhooks_and_callbacks_api
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module WebhooksAndCallbacksApi
+  # WebhooksCHandler is responsible for verifying request signatures
+  # and parsing incoming webhooksC events into strongly typed objects.
+  class WebhooksCHandler
+    include CoreLibrary
+    # Creates a new instance of the WebhooksCHandler.
+    # Initializes the handler.
+    # @param [String] secret_key
+    # The secret used to generate and validate HMAC signatures for verifying request authenticity.
+    # @raise [ArgumentError] If the secret_key is not provided.
+    def initialize(secret_key)
+      raise ArgumentError, 'secret_key must be provided for signature verification.' unless secret_key
+
+      @verifier = HmacSignatureVerifier.new(
+        secret_key: secret_key,
+        signature_header: 'X-Webhook-Signature',
+        hash_algorithm: 'sha512',
+        encoder: Base64UrlEncoder.new,
+        signature_value_template: 'v1={digest}',
+        canonical_message_builder: method(:_canonical_message_builder)
+      )
+    end
+
+    # Perform signature verification and return the result.
+    #
+    # @param [Rack::Request] request The incoming HTTP request to verify.
+    # @return [SignatureVerificationResult] The result of the signature verification.
+    def verify(request)
+      @verifier.verify(request)
+    end
+
+    # Verify the request signature and parse the event.
+    #
+    # @param [Rack::Request] request The incoming HTTP request containing the event payload.
+    # @return[String, Integer, Array<Float>, Hash[String, String],
+    # SignatureVerificationFailure, UnknownEvent]
+    # String, Integer, Array[Float], Hash[String, String] for successful
+    # parsing;
+    # SignatureVerificationFailure when signature fails;
+    #
+    # UnknownEvent for unknown events.
+    def verify_and_parse_event(request)
+      unless request.respond_to?(:env) && request.env.is_a?(Hash)
+        return SignatureVerificationFailure.new(['Invalid request env.'])
+      end
+
+      raw_body = RackRequestHelper.read_raw_body(request)
+      return SignatureVerificationFailure.new(['Invalid request body.']) if raw_body.nil? || raw_body.empty?
+
+      verification_result = verify(request)
+      return SignatureVerificationFailure.new(verification_result.errors) unless verification_result.ok
+
+      # Deserialize payload
+      begin
+        union = UnionTypeLookUp.get(:WebhooksC)
+        raw = RackRequestHelper.read_raw_body(request)
+        APIHelper.deserialize_union_type(union, raw, false, true)
+      rescue StandardError => e
+        UnknownEvent.new(['Deserialization failed.', e.message])
+      end
+    end
+
+    # Builds the canonical message from the request for the signature verification.
+    #
+    # @param [Rack::Request] request The incoming HTTP request.
+    # @return [String, nil] The canonical message as a string, or nil if it could not be constructed.
+    def _canonical_message_builder(request)
+      payload = RackRequestHelper.read_raw_body(request)
+      method = request.request_method
+      x_timestamp = request.get_header(RackRequestHelper.prepend_header('X-Timestamp'))
+      "#{method}|#{x_timestamp}|#{payload}"
+    end
+  end
+end