ukrsib_api 0.0.1

data/lib/ukrsib_api/models/balance.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+# typed: true
+
+module UkrsibAPI
+  module Models
+    # balance model, see api docs for more info (readme)
+    class Balance < BaseStruct
+      attribute :account,             Types::String
+      attribute :currency,            Types::String
+      attribute :counterparty_branch, Types::String
+      attribute :account_branch,      Types::String
+      attribute :account_name,        Types::String
+      attribute :state,               Types::String
+      attribute :account_type,        Types::String
+      attribute :location,            Types::String
+
+      # Decimal (monetary) attributes: using coercible decimals to convert string values
+      attribute :balance_in,          Types::Coercible::Decimal
+      attribute :balance_in_uah,      Types::Coercible::Decimal
+      attribute :balance_out,         Types::Coercible::Decimal
+      attribute :balance_out_uah,     Types::Coercible::Decimal
+      attribute :turnover_debt,       Types::Coercible::Decimal
+      attribute :turnover_debt_uah,   Types::Coercible::Decimal
+      attribute :turnover_cred,       Types::Coercible::Decimal
+      attribute :turnover_cred_uah,   Types::Coercible::Decimal
+
+      # DateTime attributes: using Params coercion for strings formatted as dates
+      attribute :last_operation_date_time, Types::Params::DateTime
+      attribute :open_account_reg_date_time, Types::Params::DateTime
+      attribute :open_account_sys_date_time, Types::Params::DateTime
+      attribute :close_account_date_time,    Types::Params::DateTime
+
+      # Boolean attribute
+      attribute :final_balance, Types::Bool
+
+      # @!method balance_in_money
+      #   @return [Money] Returns a Money object for balance_in using the model's currency.
+      #
+      # @!method balance_in_uah_money
+      #   @return [Money] Returns a Money object for balance_in_uah using "UAH" as currency.
+      #
+      # @!method balance_out_money
+      #   @return [Money] Returns a Money object for balance_out using the model's currency.
+      #
+      # @!method balance_out_uah_money
+      #   @return [Money] Returns a Money object for balance_out_uah using "UAH" as currency.
+      #
+      # @!method turnover_debt_money
+      #   @return [Money] Returns a Money object for turnover_debt using the model's currency.
+      #
+      # @!method turnover_debt_uah_money
+      #   @return [Money] Returns a Money object for turnover_debt_uah using "UAH" as currency.
+      #
+      # @!method turnover_cred_money
+      #   @return [Money] Returns a Money object for turnover_cred using the model's currency.
+      #
+      # @!method turnover_cred_uah_money
+      #   @return [Money] Returns a Money object for turnover_cred_uah using "UAH" as currency.
+
+      # List of monetary attribute names.
+      MONEY_FIELDS = %i[
+        balance_in balance_in_uah
+        balance_out balance_out_uah
+        turnover_debt turnover_debt_uah
+        turnover_cred turnover_cred_uah
+      ].freeze
+
+      # For each monetary field, define a method that returns a Money object.
+      MONEY_FIELDS.each do |field|
+        define_method("#{field}_money") do
+          # Choose the currency based on the field name: if it ends with _uah, use "UAH",
+          # otherwise use the model's currency.
+          currency_to_use = field.to_s.end_with?("_uah") ? "UAH" : currency
+          Money.from_amount(public_send(field), currency_to_use)
+        end
+      end
+    end
+  end
+end

data/lib/ukrsib_api/models/base_struct.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module UkrsibAPI
+  module Models
+    # BaseStruct is a parent class for all models that require a transformer.
+    # It dynamically infers the transformer class based on the name of the child class.
+    #
+    # Example:
+    #   class Balance < BaseStruct; end
+    #   Balance.transformer # Returns UkrsibAPI::Transformers::BalanceTransformer.new
+    #
+    #   class Transaction < BaseStruct; end
+    #   Transaction.transformer # Returns UkrsibAPI::Transformers::TransactionTransformer.new
+    #
+    # This ensures that all subclasses of BaseStruct automatically have a transformer method
+    # without needing to redefine it in each subclass.
+    class BaseStruct < Dry::Struct
+      # Returns an instance of the transformer class inferred from the child class name.
+      # Example:
+      #   class Balance < BaseStruct; end
+      #   Balance.transformer # Returns UkrsibAPI::Transformers::BalanceTransformer.new
+      def self.transformer
+        short_name = name.split("::").last
+        transformer_class_name = "#{short_name}Transformer"
+        transformer_class = UkrsibAPI::Transformers.const_get(transformer_class_name)
+        transformer_class.new
+      end
+    end
+  end
+end

data/lib/ukrsib_api/models/statement_party_details.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module UkrsibAPI
+  module Models
+    # PartyDetails model
+    #
+    # Represents details of a party, used for both actual payer and actual recipient.
+    class StatementPartyDetails < BaseStruct
+      # Номер квартиры / Apartment number
+      attribute :apartment_number, Types::String.optional
+
+      # Область / Area
+      attribute :area, Types::String.optional
+
+      # Город / City
+      attribute :city, Types::String
+
+      # Код страны (ISO 3166-1) / Country code
+      attribute :country_code, Types::String
+
+      # Номер дома / House number
+      attribute :house_number, Types::String.optional
+
+      # Почтовый индекс / Postcode
+      attribute :postcode, Types::String.optional
+
+      # Улица / Street
+      attribute :street, Types::String
+
+      # Детали юридического лица / Legal entity details
+      attribute :legal_details, Types::Hash.optional
+    end
+  end
+end

data/lib/ukrsib_api/models/statement_v3.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module UkrsibAPI
+  module Models
+    # Statement model
+    #
+    # Represents a financial statement transaction.
+    class StatementV3 < BaseStruct
+      # Банк клиента / Client bank name
+      attribute :client_bank_name, Types::String
+
+      # ЄДРПОУ клиента / Client code
+      attribute :client_code, Types::String
+
+      # IBAN клиента / Client IBAN
+      attribute :client_iban, Types::String
+
+      # МФО банка корреспондента / Correspondent bank MFO
+      attribute :correspondent_bank_mfo, Types::String
+
+      # Название банка корреспондента / Correspondent bank name
+      attribute :correspondent_bank_name, Types::String
+
+      # ЄДРПОУ корреспондента / Correspondent code
+      attribute :correspondent_code, Types::String
+
+      # IBAN корреспондента / Correspondent IBAN
+      attribute :correspondent_iban, Types::String
+
+      # Название корреспондента / Correspondent name
+      attribute :correspondent_name, Types::String
+
+      # Сумма кредита / Credit amount
+      attribute :credit_amount, Types::CoercibleDecimal
+
+      # Валюта / Currency
+      attribute :currency, Types::String
+
+      # Дата валютирования / Valuation date
+      attribute :valuation_date, Types::UnixTimestampWithMilliseconds.optional
+
+      # Сумма дебета / Debit amount
+      attribute :debit_amount, Types::CoercibleDecimal
+
+      # Дата документа / Document date
+      attribute :document_date, Types::UnixTimestampWithMilliseconds
+
+      # Номер документа / Document number
+      attribute :document_number, Types::String
+
+      # Назначение платежа / Payment purpose
+      attribute :payment_purpose, Types::String.optional
+
+      # Дата обработки / Processing date
+      attribute :processing_date, Types::UnixTimestampWithMilliseconds
+
+      # Уникальный идентификатор транзакции / Transaction reference
+      attribute :reference, Types::String
+
+      # Фактический плательщик / Actual payer
+      attribute :actual_payer, Types::Hash.optional
+
+      # Фактический получатель / Actual recipient
+      attribute :actual_recipient, Types::Hash.optional
+
+      attribute :budget_payment_purposes, Types::Array.of(Types::Hash).optional
+    end
+  end
+end

data/lib/ukrsib_api/models/types.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module UkrsibAPI::Models
+  # best practices
+  module Types
+    include Dry.Types()
+
+    UnixTimestampWithMilliseconds = Types::Coercible::Integer.constructor do |value|
+      # Convert Unix timestamp (milliseconds) to Time object
+      ::Time.at(value / 1000).utc if value
+    end
+    CoercibleDecimal = Types::Nominal::Decimal.constructor do |value|
+      case value
+      when Float
+        BigDecimal(value.to_s, 2) # Convert float to string first
+      else
+        begin
+          BigDecimal(value)
+        rescue StandardError
+          nil
+        end # Fallback for other cases
+      end
+    end
+  end
+end

data/lib/ukrsib_api/pagination_helper.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module UkrsibAPI
+  # PaginationHelper provides pagination functionality by yielding individual items
+  # from paginated HTTP responses.
+  # @example
+  # Example of usage:
+  #   class BalanceResource < UkrsibAPI::Resource
+  #     def common(uri, key, start_date, account, end_date)
+  #       params_hash = form_query(start_date, account, end_date, nil, 20)
+  #       # Pass a block to handle the HTTP request using your resource's get_request method.
+  #       UkrsibAPI::PaginationHelper
+  #         .load(uri: uri, params_hash: params_hash, key: "balances", type: UkrsibAPI::Models::Balance) do |uri, params|
+  #         get_request(uri, params: params)
+  #       end
+  #     end
+  #   end
+  class PaginationHelper < Dry::Struct
+    # @!attribute [r] data
+    #   @return [Array] Array of transformed models.
+    attribute :data, Models::Types::Array.of(Models::Types::Any)
+    # @!attribute [r] next_page_exists
+    #   @return [Boolean] Indicates if the next page exists.
+    attribute :next_page_exists, Models::Types::Bool
+    # @!attribute [r] next_page_id
+    #   @return [Any, nil] The identifier for the next page.
+    attribute :next_page_start, Models::Types::Any.optional
+
+    # Loads paginated data and yields individual items.
+    #
+    # See example of usage in the class description.
+    #
+    # @param params_hash [Hash] Query parameters for the HTTP request.
+    # @param key [String, Symbol] The key to extract data from the response body.
+    # @param type [Class] A Dry::Struct model class used for transforming each item.
+    # @yield [params] Must perform the HTTP request and return a response object.
+    # @yieldreturn [Array] The HTTP response with a 'body' method containing a hash.
+    # @return [Enumerator] An enumerator yielding individual items.
+    def self.paginate(params_hash:, key:, type:)
+      params_hash[:maxResult] ||= 100
+      params_hash[:firstResult] ||= 0
+      Enumerator.new do |yielder|
+        loop do
+          response = yield(params_hash)
+          processed = from_response(response_body: response.body, key: key, type: type)
+          processed.data.each { |item| yielder << item }
+          break unless processed.next_page_exists
+
+          params_hash[:firstResult] = params_hash[:firstResult] + params_hash[:maxResult]
+        end
+      end
+    end
+
+    # Transforms the HTTP response and returns a new instance of PaginationHelper.
+    #
+    # @param response_body [Hash] The parsed HTTP response body.
+    # @param key [String, Symbol] The key that holds the array of items.
+    # @param type [Class] A Dry::Struct model class used to encapsulate each item.
+    # @return [PaginationHelper] An instance containing the transformed data and pagination flags.
+    def self.from_response(response_body:, key:, type:)
+      body = response_body
+      transformer = type.transformer
+      transformed = transformer.call(body[key])
+      new(
+        data: transformed.map { |hash| type.new(hash) },
+        next_page_exists: body["total"].to_i > (body["firstResult"].to_i + body["maxResult"].to_i),
+        # TODO: possible bug, >= if it is all zero based
+        next_page_start: body["firstResult"].to_i + body["maxResult"].to_i
+      )
+    end
+  end
+end

data/lib/ukrsib_api/request_id_middleware.rb

@@ -0,0 +1,8 @@
+module UkrsibAPI
+  class RequestIDMiddleware < Faraday::Middleware
+    def call(env)
+      env.request_headers["X-Request-ID"] = SecureRandom.uuid
+      @app.call(env)
+    end
+  end
+end

data/lib/ukrsib_api/resource.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+# typed: true
+
+module UkrsibAPI
+  # internal
+  class Resource
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    ##
+    # Builds the query parameters hash for API requests.
+    #
+    # This method generates a hash of query parameters based on the provided options.
+    # It is designed to work with multiple endpoints:
+    #
+    # 1. **Date Interval Endpoints** (e.g., balances or transactions):
+    #    - Requires :start_date (formatted as DD-MM-YYYY)
+    #    - Optionally includes :end_date (formatted as DD-MM-YYYY)
+    #    - :acc (account IBAN) is optional; if omitted, data for all active accounts are returned.
+    #
+    # 2. **Interim/Final Endpoints** (for getting partial or final data):
+    #    - Date parameters are omitted.
+    #    - Only :acc, :follow_id, and :limit are used.
+    #
+    # Additionally, if the API response contains:
+    # - "exist_next_page" as true, then the "next_page_id" value should be passed in subsequent requests
+    #   using the :follow_id parameter.
+    #
+    # @param start_date [Date, nil] the starting date (required for date interval endpoints)
+    # @param end_date [Date, nil] the ending date (optional)
+    # @param account [String, nil] the account number (IBAN); mapped to :acc in the query
+    # @param follow_id [String, nil] identifier for the next page of results (pagination)
+    # @param limit [Integer] number of records per page (default: 20, maximum recommended: 100)
+    #
+    # @return [Hash] the query parameters hash to be appended to the request URL
+    def form_query(date_from:, date_to:, accounts:, first_result: 0, max_result: 100)
+      params = {}
+      # For date interval endpoints, only add date parameters if provided.
+      params[:dateFrom] = date_from.to_time.to_i * 1000 if date_from
+      params[:dateTo]   = date_to.to_time.to_i * 1000 if date_to
+      # Account number is expected under the key :acc by the API.
+      params[:accounts] = accounts.join(",") if accounts.any?
+
+      # Set limit for results per page.
+      params[:firstResult] = first_result
+      params[:maxResult] = max_result
+      params
+    end
+
+    private
+
+    def get_request(url, params: {}, headers: {})
+      handle_response client.connection.get(url, params, headers)
+    end
+
+    def post_request(url, body:, headers: {}, sign_fields: [])
+      sign_payload = sign_fields.map { |field| body[field] }.join("|")
+      headers["Sign"] = @client.auth.generate_signature(sign_payload)
+      handle_response client.connection.post(url, body, headers)
+    end
+
+    def handle_response(response)
+      case response.status
+      when 400
+        raise Error, "Your request was malformed. #{response.body["message"]}"
+      when 401
+        raise Error, "You did not supply valid authentication credentials. #{response.body["message"]}"
+      when 403
+        raise Error, "You are not allowed to perform that action. #{response.body["message"]}"
+      when 404
+        raise Error, "No results were found for your request. #{response.body["message"]}"
+      when 429
+        raise Error, "Your request exceeded the API rate limit. #{response.body["message"]}"
+      when 500
+        raise Error, "We were unable to perform the request due to server-side problems. #{response.body["message"]}"
+      else
+        raise Error, response.body["message"] unless response.status == 200
+      end
+
+      response
+    end
+  end
+end

data/lib/ukrsib_api/resources/balance_resource.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+# typed: true
+
+module UkrsibAPI
+  module Resources
+    # see api docs
+    class BalanceResource < UkrsibAPI::Resource
+      def common(uri, _key, start_date, account, end_date)
+        params_hash = form_query(start_date:, account:, end_date:)
+        # Pass a block to handle the HTTP request using your resource's get_request method.
+
+        UkrsibAPI::PaginationHelper
+          .paginate(params_hash:, key: "balances", type: UkrsibAPI::Models::Balance) do |params|
+            get_request(uri, params: params)
+          end
+      end
+
+      # Get balance(s)
+      # start_date required
+      # account(iban string) and end_date optional
+      def list(start_date, account = nil, end_date = nil)
+        common("statements/balance", "balances", start_date, account, end_date)
+      end
+
+      # Get interim balance(s)
+      #
+      # @param start_date [String] the start date for the balance query (required)
+      # @param account [String, nil] the account IBAN (optional)
+      # @return [Array<UkrsibAPI::Models::Balance>] an array of Balance models
+      def list_interim(start_date, account = nil, end_date = nil)
+        common("statements/balance/interim", "balances", start_date, account, end_date)
+      end
+
+      # account = string iban, optional
+      def list_final(account = nil)
+        common("statements/balance/final", "balances", start_date, account, end_date)
+      end
+    end
+  end
+end

data/lib/ukrsib_api/resources/statements_v3_resource.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+# typed: true
+
+module UkrsibAPI
+  module Resources
+    ##
+    # TransactionResource is responsible for fetching transaction data from the API.
+    # It supports three endpoints:
+    #
+    # 1. Standard transactions endpoint (with a date interval).
+    # 2. Interim transactions endpoint (for data from the last day up to today).
+    # 3. Final transactions endpoint (for final transactions on the last day).
+    #
+    # Each endpoint is paginated. The methods in this class return an Enumerator that
+    # lazily fetches and yields transactions page by page.
+    class StatementsV3Resource < UkrsibAPI::Resource
+      BASE_URI = "v3/statements"
+      SIGN_FIELD_FORMULA = %i[accounts dateFrom dateTo firstResult maxResult].freeze
+
+      def common(uri:, query_params:)
+        UkrsibAPI::PaginationHelper
+          .paginate(params_hash: query_params, key: "data", type: UkrsibAPI::Models::StatementV3) do |params|
+          post_request(uri, body: params, sign_fields: SIGN_FIELD_FORMULA)
+        end
+      end
+
+      def list(accounts:, date_from:, date_to:, first_result: 0, max_result: 100)
+        query_params = form_query(
+          date_from:, date_to:, accounts:, first_result:, max_result:
+        )
+        common(uri: BASE_URI, query_params: query_params)
+      end
+    end
+  end
+end

data/lib/ukrsib_api/transformers/balance_transformer.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module UkrsibAPI
+  module Transformers
+    # balance field name mappings
+    class BalanceTransformer < UkrsibAPI::BaseTransformer
+      # Define the mapping for keys that need renaming
+      KEY_MAPPING = {
+        "acc" => :account,
+        "atp" => :account_type,
+        "currency" => :currency,
+        "flmn" => :location,
+        "state" => :state,
+        "balanceIn" => :balance_in,
+        "balanceInEq" => :balance_in_uah,
+        "balanceOut" => :balance_out,
+        "balanceOutEq" => :balance_out_uah,
+        "turnoverDebt" => :turnover_debt,
+        "turnoverDebtEq" => :turnover_debt_uah,
+        "turnoverCred" => :turnover_cred,
+        "turnoverCredEq" => :turnover_cred_uah,
+        "bgfIBrnm" => :counterparty_branch,
+        "brnm" => :account_branch,
+        "dpd" => :last_operation_date_time,
+        "nameACC" => :account_name,
+        "date_open_acc_reg" => :open_account_reg_date_time,
+        "date_open_acc_sys" => :open_account_sys_date_time,
+        "date_close_acc" => :close_account_date_time,
+        "is_final_bal" => :final_balance
+      }.freeze
+
+      build_pipeline(KEY_MAPPING)
+    end
+  end
+end

data/lib/ukrsib_api/transformers/statement_party_details_transformer.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module UkrsibAPI
+  module Transformers
+    # Transformer for party details (actual payer and recipient)
+    # rubocop:disable Layout/HashAlignment
+    class StatementPartyDetailsTransformer < UkrsibAPI::BaseTransformer
+      KEY_MAPPING = {
+        "addressApartmentNumber" => :apartment_number,
+        "addressArea"            => :area,
+        "addressCity"            => :city,
+        "addressCountryCode"      => :country_code,
+        "addressHouseNumber"      => :house_number,
+        "addressPostcode"         => :postcode,
+        "addressStreet"           => :street,
+        "legal"                   => :legal_details
+      }.freeze
+
+      build_pipeline(KEY_MAPPING)
+    end
+    # rubocop:enable Layout/HashAlignment
+  end
+end

data/lib/ukrsib_api/transformers/statement_v3_transformer.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module UkrsibAPI
+  module Transformers
+    # Statement field name mappings
+    class StatementV3Transformer < UkrsibAPI::BaseTransformer
+      # Define the mapping for keys that need renaming
+      # rubocop:disable Layout/HashAlignment
+      KEY_MAPPING = {
+        "clientBankName"         => :client_bank_name,
+        "clientCode"             => :client_code,
+        "clientIBAN"             => :client_iban,
+        "correspondentBankMFO"   => :correspondent_bank_mfo,
+        "correspondentBankName"  => :correspondent_bank_name,
+        "correspondentCode"      => :correspondent_code,
+        "correspondentIBAN"      => :correspondent_iban,
+        "correspondentName"      => :correspondent_name,
+        "credit"                 => :credit_amount,
+        "currency"               => :currency,
+        "dateValue"              => :valuation_date,
+        "debit"                  => :debit_amount,
+        "docDate"                => :document_date,
+        "docNumber"              => :document_number,
+        "paymentPurpose"         => :payment_purpose,
+        "provDate"               => :processing_date,
+        "reference"              => :reference,
+        "actualPayer"            => :actual_payer,
+        "actualRecipient"        => :actual_recipient,
+        "budgetPaymentPurposes"  => :budget_payment_purposes
+      }.freeze
+      # rubocop:enable Layout/HashAlignment
+
+      build_pipeline(KEY_MAPPING)
+    end
+  end
+end

data/lib/ukrsib_api/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module UkrsibAPI
+  VERSION = "0.0.1"
+end

data/lib/ukrsib_api.rb

@@ -0,0 +1,39 @@
+# typed: true
+# frozen_string_literal: true
+
+require "faraday"
+require "faraday_middleware"
+require "dry-types"
+require "dry-struct"
+require "dry-transformer"
+require "money"
+require "securerandom"
+
+require_relative "ukrsib_api/models/types"
+require_relative "ukrsib_api/resource"
+require_relative "ukrsib_api/request_id_middleware"
+require_relative "ukrsib_api/authentication"
+require_relative "ukrsib_api/client"
+require_relative "ukrsib_api/base_transformer"
+require_relative "ukrsib_api/models/base_struct"
+require_relative "ukrsib_api/pagination_helper"
+
+require_relative "ukrsib_api/resources/balance_resource"
+require_relative "ukrsib_api/transformers/balance_transformer"
+require_relative "ukrsib_api/models/balance"
+
+require_relative "ukrsib_api/resources/statements_v3_resource"
+require_relative "ukrsib_api/transformers/statement_v3_transformer"
+require_relative "ukrsib_api/transformers/statement_party_details_transformer"
+require_relative "ukrsib_api/models/statement_party_details"
+require_relative "ukrsib_api/models/statement_v3"
+
+# Main entry point for the gem, use client = UkrsibAPI::Client.new(api_token: "token") to start using the API.
+module UkrsibAPI
+  class Error < StandardError; end
+  class NotAuthorizedError < Error; end
+
+  def self.logger
+    @@logger ||= defined?(Rails) ? Rails.logger : Logger.new($stdout, progname: "UkrsibAPI") # rubocop:disable Style/ClassVars
+  end
+end

data/sig/ukrsib_api.rbs

@@ -0,0 +1,4 @@
+module UkrsibAPI
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

data/sorbet/config

@@ -0,0 +1,4 @@
+--dir
+.
+--ignore=tmp/
+--ignore=vendor/

data/sorbet/rbi/annotations/.gitattributes

@@ -0,0 +1 @@
+**/*.rbi linguist-vendored=true

data/sorbet/rbi/annotations/faraday.rbi

@@ -0,0 +1,17 @@
+# typed: true
+
+# DO NOT EDIT MANUALLY
+# This file was pulled from a central RBI files repository.
+# Please run `bin/tapioca annotations` to update it.
+
+module Faraday
+  class << self
+    sig { params(url: T.untyped, options: T::Hash[Symbol, T.untyped], block: T.nilable(T.proc.params(connection: Faraday::Connection).void)).returns(Faraday::Connection) }
+    def new(url = nil, options = {}, &block); end
+  end
+end
+
+class Faraday::Response
+  sig { returns(T::Boolean) }
+  def success?; end
+end