wesley-key-sdk 4.2.0 → 4.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f22b22395a8452f239db0c529bcd4bd9c4d209bc42dece0aa51ccda0794bf274
-  data.tar.gz: 646a929e08b140f97c9ff50c7aa9e052d087e5880f5b13b0f045d84dfa6a4bb4
+  metadata.gz: 652b3d8c0bcd744134cd8fd75b9f16e6b8a8839fcaf4157bac5cb623cbb0920d
+  data.tar.gz: 8766ff7d24d3165448c491b1ef34683d1eed1bfcb5d30badc45e9f5f56b6b1d4
 SHA512:
-  metadata.gz: 8b841fcc3575323415331051808a172ab7b2f10380c9292190d122a6912b6e68ab655654905faa41949e252c2b1aa9ba9923146dab8c32bb85eb24b8cee1d241
-  data.tar.gz: e7865b424ea16c05604c1ed249dcc4665279c35b890ea60736597b6c0476889121b9a662e67f40956192fc8e372c496fe1920e43ddf75cf1e0101462a53783bd
+  metadata.gz: 310f1ef0edc523114ee0c04fe3bce8ef3d6cbcfaf3dba7a20211d8d58fce1b7e7e7a4c10cb8b634d0a055e7516a5464e1b0620b2e3385d48b9919db98e6a2824
+  data.tar.gz: c20f2ee17ab64d19ce313cfcf50f110461c4cc619638d0c433ff1d8f152da3abe0dc82dc6c8509bf6ead3ab33be2da7048bef3efc55f25b8d8f92797d9dcdac2

data/README.md

@@ -1,35 +1,33 @@
 
-# Getting Started with Swagger Petstore - OpenAPI 3.0
+# Getting Started with Webhooks and Callbacks API
 
 ## Introduction
 
-This is a sample Pet Store Server based on the OpenAPI 3.0 specification.  You can find out more about
-Swagger at [https://swagger.io](https://swagger.io). In the third iteration of the pet store, we've switched to the design first approach!
-You can now help us improve the API whether it's by making changes to the definition itself or to the code.
-That way, with time, we can improve the API in general, and expose some of the new features in OAS3.
+A comprehensive API demonstrating webhooks and callbacks patterns.
 
-Some useful links:
+### Webhooks
 
-- [The Pet Store repository](https://github.com/swagger-api/swagger-petstore)
-- [The source API definition for the Pet Store](https://github.com/swagger-api/swagger-petstore/blob/master/src/main/resources/openapi.yaml)
+Webhooks allow your application to receive real-time notifications when certain events occur.
 
-Find out more about Swagger: [https://swagger.io](https://swagger.io)
+### Callbacks
+
+Callbacks are used for asynchronous operations where the API will call back to your provided URL when the operation completes.
 
 ## Install the Package
 
 Install the gem from the command line:
 
 ```bash
-gem install wesley-key-sdk -v 4.2.0
+gem install wesley-key-sdk -v 4.3.1
 ```
 
 Or add the gem to your Gemfile and run `bundle`:
 
 ```ruby
-gem 'wesley-key-sdk', '4.2.0'
+gem 'wesley-key-sdk', '4.3.1'
 ```
 
-For additional gem details, see the [RubyGems page for the wesley-key-sdk gem](https://rubygems.org/gems/wesley-key-sdk/versions/4.2.0).
+For additional gem details, see the [RubyGems page for the wesley-key-sdk gem](https://rubygems.org/gems/wesley-key-sdk/versions/4.3.1).
 
 ## IRB Console Usage
 
@@ -46,8 +44,8 @@ irb
 Now you can load the SDK in the IRB
 
 ```ruby
-require 'swagger_petstore_open_api30'
-include SwaggerPetstoreOpenApi30
+require 'webhooks_and_callbacks_api'
+include WebhooksAndCallbacksApi
 ```
 
 ### 2. Use IRB within SDK
@@ -55,7 +53,7 @@ include SwaggerPetstoreOpenApi30
 Open your system terminal (Command Prompt, Git Bash or macOS Terminal) and navigate to the root folder of SDK.
 
 ```
-cd path/to/swagger_petstore_open_api30
+cd path/to/webhooks_and_callbacks_api
 ```
 
 Now you can start the preconfigured irb console by running the following command
@@ -74,10 +72,9 @@ The following parameters are configurable for the API Client:
 
 | Parameter | Type | Description |
 |  --- | --- | --- |
-| environment | [`Environment`](README.md#environments) | The API environment. <br> **Default: `Environment.PRODUCTION`** |
 | connection | `Faraday::Connection` | The Faraday connection object passed by the SDK user for making requests |
 | adapter | `Faraday::Adapter` | The Faraday adapter object passed by the SDK user for performing http requests |
-| timeout | `Float` | The value to use for connection timeout. <br> **Default: 30** |
+| timeout | `Float` | The value to use for connection timeout. <br> **Default: 50** |
 | max_retries | `Integer` | The number of times to retry an endpoint call if it fails. <br> **Default: 0** |
 | retry_interval | `Float` | Pause in seconds between retries. <br> **Default: 1** |
 | backoff_factor | `Float` | The amount to multiply each successive retry's interval amount by in order to provide backoff. <br> **Default: 2** |
@@ -86,30 +83,24 @@ The following parameters are configurable for the API Client:
 | http_callback | `HttpCallBack` | The Http CallBack allows defining callables for pre and post API calls. |
 | proxy_settings | [`ProxySettings`](doc/proxy-settings.md) | Optional proxy configuration to route HTTP requests through a proxy server. |
 | logging_configuration | [`LoggingConfiguration`](doc/logging-configuration.md) | The SDK logging configuration for API calls |
-| petstore_auth_credentials | [`PetstoreAuthCredentials`](doc/auth/oauth-2-implicit-grant.md) | The credential object for OAuth 2 Implicit Grant |
 | api_key_credentials | [`ApiKeyCredentials`](doc/auth/custom-header-signature.md) | The credential object for Custom Header Signature |
+| bearer_auth_credentials | [`BearerAuthCredentials`](doc/auth/oauth-2-bearer-token.md) | The credential object for OAuth 2 Bearer token |
 
 The API client can be initialized as follows:
 
 ### Code-Based Client Initialization
 
 ```ruby
-require 'swagger_petstore_open_api30'
-include SwaggerPetstoreOpenApi30
+require 'webhooks_and_callbacks_api'
+include WebhooksAndCallbacksApi
 
 client = Client.new(
-  petstore_auth_credentials: PetstoreAuthCredentials.new(
-    oauth_client_id: 'OAuthClientId',
-    oauth_redirect_uri: 'OAuthRedirectUri',
-    oauth_scopes: [
-      OauthScopePetstoreAuth::WRITEPETS,
-      OauthScopePetstoreAuth::READPETS
-    ]
-  ),
   api_key_credentials: ApiKeyCredentials.new(
-    api_key: 'api_key'
+    x_api_key: 'X-API-Key'
+  ),
+  bearer_auth_credentials: BearerAuthCredentials.new(
+    access_token: 'AccessToken'
   ),
-  environment: Environment::PRODUCTION,
   logging_configuration: LoggingConfiguration.new(
     log_level: Logger::INFO,
     request_logging_config: RequestLoggingConfiguration.new(
@@ -125,8 +116,8 @@ client = Client.new(
 ### Environment-Based Client Initialization
 
 ```ruby
-require 'swagger_petstore_open_api30'
-include SwaggerPetstoreOpenApi30
+require 'webhooks_and_callbacks_api'
+include WebhooksAndCallbacksApi
 
 # Create client from environment
 client = Client.from_env
@@ -134,28 +125,24 @@ client = Client.from_env
 
 See the [`Environment-Based Client Initialization`](doc/environment-based-client-initialization.md) section for details.
 
-## Environments
-
-The SDK can be configured to use a different environment for making API calls. Available environments are:
-
-### Fields
-
-| Name | Description |
-|  --- | --- |
-| PRODUCTION | **Default** |
-
 ## Authorization
 
 This API uses the following authentication schemes.
 
-* [`petstore_auth (OAuth 2 Implicit Grant)`](doc/auth/oauth-2-implicit-grant.md)
-* [`api_key (Custom Header Signature)`](doc/auth/custom-header-signature.md)
+* [`ApiKey (Custom Header Signature)`](doc/auth/custom-header-signature.md)
+* [`BearerAuth (OAuth 2 Bearer token)`](doc/auth/oauth-2-bearer-token.md)
 
 ## List of APIs
 
-* [Pet](doc/controllers/pet.md)
-* [Store](doc/controllers/store.md)
-* [User](doc/controllers/user.md)
+* [Orders](doc/controllers/orders.md)
+
+## Webhooks
+
+* [Webhooks](doc/events/webhooks/webhooks-handler.md)
+* [Webhooks A](doc/events/webhooks/webhooks-a-handler.md)
+* [Webhooks B](doc/events/webhooks/webhooks-b-handler.md)
+* [Webhooks C](doc/events/webhooks/webhooks-c-handler.md)
+* [Webhooks No Verification](doc/events/webhooks/webhooks-no-verification-handler.md)
 
 ## SDK Infrastructure
 

data/bin/console

@@ -4,11 +4,11 @@
 $LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
 
 # Require the gem
-require 'swagger_petstore_open_api30'
+require 'webhooks_and_callbacks_api'
 
-puts 'SwaggerPetstoreOpenApi30 SDK loaded!'
-puts 'You can now create a client with: client = SwaggerPetstoreOpenApi30::Client.new'
-puts 'Or use from_env: client = SwaggerPetstoreOpenApi30::Client.from_env'
+puts 'WebhooksAndCallbacksApi SDK loaded!'
+puts 'You can now create a client with: client = WebhooksAndCallbacksApi::Client.new'
+puts 'Or use from_env: client = WebhooksAndCallbacksApi::Client.from_env'
 
 # Start an interactive IRB session
 require 'irb'

data/lib/{swagger_petstore_open_api30 → webhooks_and_callbacks_api}/api_helper.rb

@@ -1,9 +1,9 @@
-# swagger_petstore_open_api30
+# webhooks_and_callbacks_api
 #
 # This file was automatically generated by
 # APIMATIC v3.0 ( https://www.apimatic.io ).
 
-module SwaggerPetstoreOpenApi30
+module WebhooksAndCallbacksApi
   # API utility class
   class APIHelper < CoreLibrary::ApiHelper
   end

data/lib/{swagger_petstore_open_api30 → webhooks_and_callbacks_api}/apis/base_api.rb

@@ -1,16 +1,16 @@
-# swagger_petstore_open_api30
+# webhooks_and_callbacks_api
 #
 # This file was automatically generated by
 # APIMATIC v3.0 ( https://www.apimatic.io ).
 
-module SwaggerPetstoreOpenApi30
+module WebhooksAndCallbacksApi
   # BaseApi.
   class BaseApi
     include CoreLibrary
     attr_accessor :config, :http_call_back
 
     def self.user_agent
-      'Ruby-SDK/4.2.0 (OS: {os-info}, Engine: {engine}/{engine-version})'
+      'Ruby-SDK/4.3.1 (OS: {os-info}, Engine: {engine}/{engine-version})'
     end
 
     def self.user_agent_parameters

data/lib/webhooks_and_callbacks_api/apis/orders_api.rb

@@ -0,0 +1,34 @@
+# webhooks_and_callbacks_api
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module WebhooksAndCallbacksApi
+  # OrdersApi
+  class OrdersApi < BaseApi
+    # Creates a new order and triggers callbacks for payment processing
+    # @param [CreateOrderRequest] body Required parameter: TODO: type
+    # description here
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def create_order(body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/orders',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body)
+                                .is_required(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Or.new('ApiKey', 'BearerAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(Order.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Invalid request',
+                                 ErrorException))
+        .execute
+    end
+  end
+end

data/lib/{swagger_petstore_open_api30 → webhooks_and_callbacks_api}/client.rb

@@ -1,10 +1,10 @@
-# swagger_petstore_open_api30
+# webhooks_and_callbacks_api
 #
 # This file was automatically generated by
 # APIMATIC v3.0 ( https://www.apimatic.io ).
 
-module SwaggerPetstoreOpenApi30
-  #  swagger_petstore_open_api30 client class.
+module WebhooksAndCallbacksApi
+  #  webhooks_and_callbacks_api client class.
   class Client
     include CoreLibrary
     attr_reader :config, :auth_managers
@@ -12,38 +12,21 @@ module SwaggerPetstoreOpenApi30
     def user_agent_detail
       config.user_agent_detail
     end
-
-    # Returns the configured authentication petstore_auth instance.
-    def petstore_auth
-      @auth_managers['petstore_auth']
-    end
-
-    # Access to pet controller.
-    # @return [PetApi] Returns the controller instance.
-    def pet
-      @pet ||= PetApi.new @global_configuration
-    end
-
-    # Access to store controller.
-    # @return [StoreApi] Returns the controller instance.
-    def store
-      @store ||= StoreApi.new @global_configuration
-    end
 
-    # Access to user controller.
-    # @return [UserApi] Returns the controller instance.
-    def user
-      @user ||= UserApi.new @global_configuration
+    # Access to orders controller.
+    # @return [OrdersApi] Returns the controller instance.
+    def orders
+      @orders ||= OrdersApi.new @global_configuration
     end
 
     def initialize(
-      connection: nil, adapter: :net_http_persistent, timeout: 30,
+      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, 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, petstore_auth_credentials: nil,
-      api_key_credentials: nil, config: nil
+      environment: Environment::PRODUCTION, api_key_credentials: nil,
+      bearer_auth_credentials: nil, config: nil
     )
       @config = if config.nil?
                   Configuration.new(
@@ -55,8 +38,8 @@ module SwaggerPetstoreOpenApi30
                     proxy_settings: proxy_settings,
                     logging_configuration: logging_configuration,
                     environment: environment,
-                    petstore_auth_credentials: petstore_auth_credentials,
-                    api_key_credentials: api_key_credentials
+                    api_key_credentials: api_key_credentials,
+                    bearer_auth_credentials: bearer_auth_credentials
                   )
                 else
                   config
@@ -78,11 +61,9 @@ module SwaggerPetstoreOpenApi30
     def initialize_auth_managers(global_config)
       @auth_managers = {}
       http_client_config = global_config.client_configuration
-      %w[petstore_auth api_key].each { |auth| @auth_managers[auth] = nil }
-      @auth_managers['petstore_auth'] = PetstoreAuth.new(
-        http_client_config.petstore_auth_credentials, global_config
-      )
-      @auth_managers['api_key'] = ApiKey.new(http_client_config.api_key_credentials)
+      %w[ApiKey BearerAuth].each { |auth| @auth_managers[auth] = nil }
+      @auth_managers['ApiKey'] = ApiKey.new(http_client_config.api_key_credentials)
+      @auth_managers['BearerAuth'] = BearerAuth.new(http_client_config.bearer_auth_credentials)
     end
 
     # Creates a client directly from environment variables.

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

@@ -1,9 +1,9 @@
-# swagger_petstore_open_api30
+# webhooks_and_callbacks_api
 #
 # This file was automatically generated by
 # APIMATIC v3.0 ( https://www.apimatic.io ).
 
-module SwaggerPetstoreOpenApi30
+module WebhooksAndCallbacksApi
   # An enum for SDK environments.
   class Environment
     ENVIRONMENT = [
@@ -21,23 +21,14 @@ module SwaggerPetstoreOpenApi30
   # An enum for API servers.
   class Server
     SERVER = [
-      DEFAULT = 'default'.freeze,
-      AUTH_SERVER = 'auth server'.freeze
+      DEFAULT = 'default'.freeze
     ].freeze
 
     # Converts a string or symbol into a valid Server constant.
     def self.from_value(value, default_value = DEFAULT)
       return default_value if value.nil?
 
-      str = value.to_s.strip.downcase
-      case str
-      when 'default' then DEFAULT
-      when 'auth_server' then AUTH_SERVER
-
-      else
-        warn "[Server] Unknown server '#{value}', falling back to #{default_value} "
-        default_value
-      end
+      default_value
     end
   end
 
@@ -45,20 +36,20 @@ module SwaggerPetstoreOpenApi30
   # are configured in this class.
   class Configuration < CoreLibrary::HttpClientConfiguration
     # The attribute readers for properties.
-    attr_reader :environment, :petstore_auth_credentials, :api_key_credentials
+    attr_reader :environment, :api_key_credentials, :bearer_auth_credentials
 
     class << self
       attr_reader :environments
     end
 
     def initialize(
-      connection: nil, adapter: :net_http_persistent, timeout: 30,
+      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, 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, petstore_auth_credentials: nil,
-      api_key_credentials: 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,
@@ -70,12 +61,12 @@ module SwaggerPetstoreOpenApi30
       # Current API environment
       @environment = String(environment)
 
-      # The object holding OAuth 2 Implicit Grant credentials
-      @petstore_auth_credentials = petstore_auth_credentials
-
       # 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
@@ -84,8 +75,8 @@ module SwaggerPetstoreOpenApi30
                    max_retries: nil, retry_interval: nil, backoff_factor: nil,
                    retry_statuses: nil, retry_methods: nil, http_callback: nil,
                    proxy_settings: nil, logging_configuration: nil,
-                   environment: nil, petstore_auth_credentials: nil,
-                   api_key_credentials: nil)
+                   environment: nil, api_key_credentials: nil,
+                   bearer_auth_credentials: nil)
       connection ||= self.connection
       adapter ||= self.adapter
       timeout ||= self.timeout
@@ -98,8 +89,8 @@ module SwaggerPetstoreOpenApi30
       proxy_settings ||= self.proxy_settings
       logging_configuration ||= self.logging_configuration
       environment ||= self.environment
-      petstore_auth_credentials ||= self.petstore_auth_credentials
       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,
@@ -111,16 +102,15 @@ module SwaggerPetstoreOpenApi30
                         proxy_settings: proxy_settings,
                         logging_configuration: logging_configuration,
                         environment: environment,
-                        petstore_auth_credentials: petstore_auth_credentials,
-                        api_key_credentials: api_key_credentials)
+                        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://petstore3.swagger.io/api/v3',
-        Server::AUTH_SERVER => 'https://petstore3.swagger.io/oauth'
+        Server::DEFAULT => 'http://localhost:3000/callbacks'
       }
     }.freeze
 
@@ -136,7 +126,7 @@ module SwaggerPetstoreOpenApi30
     def self.build_default_config_from_env
       # === Core environment ===
       environment = Environment.from_value(ENV.fetch('ENVIRONMENT', 'production'))
-      timeout = (ENV['TIMEOUT'] || 30).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
@@ -155,8 +145,8 @@ module SwaggerPetstoreOpenApi30
                                           end
 
       # === Authentication credentials ===
-      petstore_auth_credentials = PetstoreAuthCredentials.from_env
       api_key_credentials = ApiKeyCredentials.from_env
+      bearer_auth_credentials = BearerAuthCredentials.from_env
 
       # === Proxy settings ===
       proxy_settings = ProxySettings.from_env
@@ -171,8 +161,8 @@ module SwaggerPetstoreOpenApi30
         backoff_factor: backoff_factor,
         retry_statuses: retry_statuses,
         retry_methods: retry_methods,
-        petstore_auth_credentials: petstore_auth_credentials,
         api_key_credentials: api_key_credentials,
+        bearer_auth_credentials: bearer_auth_credentials,
         proxy_settings: proxy_settings,
         logging_configuration: logging_configuration
       )

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