modern_treasury 0.1.0.pre.alpha.18 → 0.1.0.pre.alpha.20

data/lib/modern_treasury.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 # Standard libraries.
+# rubocop:disable Lint/RedundantRequireStatement
 require "English"
 require "cgi"
 require "date"
@@ -15,19 +16,11 @@ require "set"
 require "stringio"
 require "time"
 require "uri"
+# rubocop:enable Lint/RedundantRequireStatement
 
 # We already ship the preferred sorbet manifests in the package itself.
 # `tapioca` currently does not offer us a way to opt out of unnecessary compilation.
 if Object.const_defined?(:Tapioca) && caller.chain([$PROGRAM_NAME]).chain(ARGV).grep(/tapioca/)
-  Warning.warn(
-    <<~WARN
-      \n
-      ⚠️ skipped loading of "modern_treasury" gem under `tapioca`.
-
-      This message is normal and expected if you are running a `tapioca` command, and does not impact `.rbi` generation.
-      \n
-    WARN
-  )
   return
 end
 
@@ -40,7 +33,7 @@ require_relative "modern_treasury/internal/util"
 require_relative "modern_treasury/internal/type/converter"
 require_relative "modern_treasury/internal/type/unknown"
 require_relative "modern_treasury/internal/type/boolean"
-require_relative "modern_treasury/internal/type/io_like"
+require_relative "modern_treasury/internal/type/file_input"
 require_relative "modern_treasury/internal/type/enum"
 require_relative "modern_treasury/internal/type/union"
 require_relative "modern_treasury/internal/type/array_of"
@@ -50,6 +43,7 @@ require_relative "modern_treasury/internal/type/base_page"
 require_relative "modern_treasury/internal/type/request_parameters"
 require_relative "modern_treasury/internal"
 require_relative "modern_treasury/request_options"
+require_relative "modern_treasury/file_part"
 require_relative "modern_treasury/errors"
 require_relative "modern_treasury/internal/transport/base_client"
 require_relative "modern_treasury/internal/transport/pooled_net_requester"
@@ -224,6 +218,14 @@ require_relative "modern_treasury/models/line_item_update_params"
 require_relative "modern_treasury/models/paper_item"
 require_relative "modern_treasury/models/paper_item_list_params"
 require_relative "modern_treasury/models/paper_item_retrieve_params"
+require_relative "modern_treasury/models/payment_action_create_params"
+require_relative "modern_treasury/models/payment_action_create_response"
+require_relative "modern_treasury/models/payment_action_list_params"
+require_relative "modern_treasury/models/payment_action_list_response"
+require_relative "modern_treasury/models/payment_action_retrieve_params"
+require_relative "modern_treasury/models/payment_action_retrieve_response"
+require_relative "modern_treasury/models/payment_action_update_params"
+require_relative "modern_treasury/models/payment_action_update_response"
 require_relative "modern_treasury/models/payment_flow"
 require_relative "modern_treasury/models/payment_flow_create_params"
 require_relative "modern_treasury/models/payment_flow_list_params"
@@ -277,6 +279,7 @@ require_relative "modern_treasury/models/virtual_account_list_params"
 require_relative "modern_treasury/models/virtual_account_retrieve_params"
 require_relative "modern_treasury/models/virtual_account_update_params"
 require_relative "modern_treasury/models/wealth_and_employment_details"
+require_relative "modern_treasury/models"
 require_relative "modern_treasury/resources/account_collection_flows"
 require_relative "modern_treasury/resources/account_details"
 require_relative "modern_treasury/resources/bulk_requests"
@@ -310,6 +313,7 @@ require_relative "modern_treasury/resources/legal_entities"
 require_relative "modern_treasury/resources/legal_entity_associations"
 require_relative "modern_treasury/resources/line_items"
 require_relative "modern_treasury/resources/paper_items"
+require_relative "modern_treasury/resources/payment_actions"
 require_relative "modern_treasury/resources/payment_flows"
 require_relative "modern_treasury/resources/payment_orders"
 require_relative "modern_treasury/resources/payment_orders/reversals"

data/rbi/{lib/modern_treasury → modern_treasury}/client.rbi

@@ -127,19 +127,23 @@ module ModernTreasury
     sig { returns(ModernTreasury::Resources::LegalEntityAssociations) }
     attr_reader :legal_entity_associations
 
+    sig { returns(ModernTreasury::Resources::PaymentActions) }
+    attr_reader :payment_actions
+
     # A test endpoint often used to confirm credentials and headers are being passed
     # in correctly.
     sig do
-      params(
-        request_options: T.nilable(T.any(ModernTreasury::RequestOptions, ModernTreasury::Internal::AnyHash))
+      params(request_options: ModernTreasury::RequestOptions::OrHash).returns(
+        ModernTreasury::PingResponse
       )
-        .returns(ModernTreasury::Models::PingResponse)
     end
-    def ping(request_options: {}); end
+    def ping(request_options: {})
+    end
 
     # @api private
     sig { override.returns(T::Hash[String, String]) }
-    private def auth_headers; end
+    private def auth_headers
+    end
 
     # Creates and returns a new client for interacting with the API.
     sig do
@@ -152,8 +156,7 @@ module ModernTreasury
         initial_retry_delay: Float,
         max_retry_delay: Float,
         idempotency_header: String
-      )
-        .returns(T.attached_class)
+      ).returns(T.attached_class)
     end
     def self.new(
       # Defaults to `ENV["MODERN_TREASURY_API_KEY"]`
@@ -164,11 +167,12 @@ module ModernTreasury
       # `"https://api.example.com/v2/"`. Defaults to `ENV["MODERN_TREASURY_BASE_URL"]`
       base_url: ENV["MODERN_TREASURY_BASE_URL"],
       # Max number of retries to attempt after a failed retryable request.
-      max_retries: DEFAULT_MAX_RETRIES,
-      timeout: DEFAULT_TIMEOUT_IN_SECONDS,
-      initial_retry_delay: DEFAULT_INITIAL_RETRY_DELAY,
-      max_retry_delay: DEFAULT_MAX_RETRY_DELAY,
+      max_retries: ModernTreasury::Client::DEFAULT_MAX_RETRIES,
+      timeout: ModernTreasury::Client::DEFAULT_TIMEOUT_IN_SECONDS,
+      initial_retry_delay: ModernTreasury::Client::DEFAULT_INITIAL_RETRY_DELAY,
+      max_retry_delay: ModernTreasury::Client::DEFAULT_MAX_RETRY_DELAY,
       idempotency_header: "Idempotency-Key"
-    ); end
+    )
+    end
   end
 end

data/rbi/{lib/modern_treasury → modern_treasury}/errors.rbi

@@ -29,10 +29,17 @@ module ModernTreasury
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
-        )
-          .returns(T.attached_class)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        url:,
+        status: nil,
+        body: nil,
+        request: nil,
+        response: nil,
+        message: nil
+      )
       end
-      def self.new(url:, status: nil, body: nil, request: nil, response: nil, message: nil); end
     end
 
     class APIConnectionError < ModernTreasury::Errors::APIError
@@ -51,10 +58,16 @@ module ModernTreasury
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
-        )
-          .returns(T.attached_class)
+        ).returns(T.attached_class)
       end
-      def self.new(url:, status: nil, body: nil, request: nil, response: nil, message: "Connection error.")
+      def self.new(
+        url:,
+        status: nil,
+        body: nil,
+        request: nil,
+        response: nil,
+        message: "Connection error."
+      )
       end
     end
 
@@ -68,10 +81,16 @@ module ModernTreasury
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
-        )
-          .returns(T.attached_class)
+        ).returns(T.attached_class)
       end
-      def self.new(url:, status: nil, body: nil, request: nil, response: nil, message: "Request timed out.")
+      def self.new(
+        url:,
+        status: nil,
+        body: nil,
+        request: nil,
+        response: nil,
+        message: "Request timed out."
+      )
       end
     end
 
@@ -85,10 +104,10 @@ module ModernTreasury
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
-        )
-          .returns(T.attached_class)
+        ).returns(T.attached_class)
+      end
+      def self.for(url:, status:, body:, request:, response:, message: nil)
       end
-      def self.for(url:, status:, body:, request:, response:, message: nil); end
 
       sig { returns(Integer) }
       attr_accessor :status
@@ -102,10 +121,10 @@ module ModernTreasury
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
-        )
-          .returns(T.attached_class)
+        ).returns(T.attached_class)
+      end
+      def self.new(url:, status:, body:, request:, response:, message: nil)
       end
-      def self.new(url:, status:, body:, request:, response:, message: nil); end
     end
 
     class BadRequestError < ModernTreasury::Errors::APIStatusError

data/rbi/modern_treasury/file_part.rbi

@@ -0,0 +1,37 @@
+# typed: strong
+
+module ModernTreasury
+  class FilePart
+    sig { returns(T.any(Pathname, StringIO, IO, String)) }
+    attr_reader :content
+
+    sig { returns(T.nilable(String)) }
+    attr_reader :content_type
+
+    sig { returns(T.nilable(String)) }
+    attr_reader :filename
+
+    # @api private
+    sig { returns(String) }
+    private def read
+    end
+
+    sig { params(a: T.anything).returns(String) }
+    def to_json(*a)
+    end
+
+    sig { params(a: T.anything).returns(String) }
+    def to_yaml(*a)
+    end
+
+    sig do
+      params(
+        content: T.any(Pathname, StringIO, IO, String),
+        filename: T.nilable(String),
+        content_type: T.nilable(String)
+      ).returns(T.attached_class)
+    end
+    def self.new(content, filename: nil, content_type: nil)
+    end
+  end
+end

data/rbi/{lib/modern_treasury → modern_treasury}/internal/page.rbi

@@ -14,17 +14,21 @@ module ModernTreasury
       attr_accessor :after_cursor
 
       sig { override.returns(T::Boolean) }
-      def next_page?; end
+      def next_page?
+      end
 
       sig { override.returns(T.self_type) }
-      def next_page; end
+      def next_page
+      end
 
       sig { override.params(blk: T.proc.params(arg0: Elem).void).void }
-      def auto_paging_each(&blk); end
+      def auto_paging_each(&blk)
+      end
 
       # @api private
       sig { returns(String) }
-      def inspect; end
+      def inspect
+      end
     end
   end
 end

data/rbi/modern_treasury/internal/transport/base_client.rbi

@@ -0,0 +1,303 @@
+# typed: strong
+
+module ModernTreasury
+  module Internal
+    module Transport
+      # @api private
+      class BaseClient
+        extend ModernTreasury::Internal::Util::SorbetRuntimeSupport
+
+        abstract!
+
+        RequestComponents =
+          T.type_alias do
+            {
+              method: Symbol,
+              path: T.any(String, T::Array[String]),
+              query:
+                T.nilable(
+                  T::Hash[String, T.nilable(T.any(T::Array[String], String))]
+                ),
+              headers:
+                T.nilable(
+                  T::Hash[
+                    String,
+                    T.nilable(
+                      T.any(
+                        String,
+                        Integer,
+                        T::Array[T.nilable(T.any(String, Integer))]
+                      )
+                    )
+                  ]
+                ),
+              body: T.nilable(T.anything),
+              unwrap:
+                T.nilable(
+                  T.any(
+                    Symbol,
+                    Integer,
+                    T::Array[T.any(Symbol, Integer)],
+                    T.proc.params(arg0: T.anything).returns(T.anything)
+                  )
+                ),
+              page:
+                T.nilable(
+                  T::Class[
+                    ModernTreasury::Internal::Type::BasePage[
+                      ModernTreasury::Internal::Type::BaseModel
+                    ]
+                  ]
+                ),
+              stream: T.nilable(T::Class[T.anything]),
+              model:
+                T.nilable(ModernTreasury::Internal::Type::Converter::Input),
+              options: T.nilable(ModernTreasury::RequestOptions::OrHash)
+            }
+          end
+
+        RequestInput =
+          T.type_alias do
+            {
+              method: Symbol,
+              url: URI::Generic,
+              headers: T::Hash[String, String],
+              body: T.anything,
+              max_retries: Integer,
+              timeout: Float
+            }
+          end
+
+        # from whatwg fetch spec
+        MAX_REDIRECTS = 20
+
+        PLATFORM_HEADERS = T::Hash[String, String]
+
+        class << self
+          # @api private
+          sig do
+            params(
+              req:
+                ModernTreasury::Internal::Transport::BaseClient::RequestComponents
+            ).void
+          end
+          def validate!(req)
+          end
+
+          # @api private
+          sig do
+            params(
+              status: Integer,
+              headers: T.any(T::Hash[String, String], Net::HTTPHeader)
+            ).returns(T::Boolean)
+          end
+          def should_retry?(status, headers:)
+          end
+
+          # @api private
+          sig do
+            params(
+              request:
+                ModernTreasury::Internal::Transport::BaseClient::RequestInput,
+              status: Integer,
+              response_headers: T.any(T::Hash[String, String], Net::HTTPHeader)
+            ).returns(
+              ModernTreasury::Internal::Transport::BaseClient::RequestInput
+            )
+          end
+          def follow_redirect(request, status:, response_headers:)
+          end
+
+          # @api private
+          sig do
+            params(
+              status:
+                T.any(Integer, ModernTreasury::Errors::APIConnectionError),
+              stream: T.nilable(T::Enumerable[String])
+            ).void
+          end
+          def reap_connection!(status, stream:)
+          end
+        end
+
+        sig { returns(URI::Generic) }
+        attr_reader :base_url
+
+        sig { returns(Float) }
+        attr_reader :timeout
+
+        sig { returns(Integer) }
+        attr_reader :max_retries
+
+        sig { returns(Float) }
+        attr_reader :initial_retry_delay
+
+        sig { returns(Float) }
+        attr_reader :max_retry_delay
+
+        sig { returns(T::Hash[String, String]) }
+        attr_reader :headers
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :idempotency_header
+
+        # @api private
+        sig { returns(ModernTreasury::Internal::Transport::PooledNetRequester) }
+        attr_reader :requester
+
+        # @api private
+        sig do
+          params(
+            base_url: String,
+            timeout: Float,
+            max_retries: Integer,
+            initial_retry_delay: Float,
+            max_retry_delay: Float,
+            headers:
+              T::Hash[
+                String,
+                T.nilable(
+                  T.any(
+                    String,
+                    Integer,
+                    T::Array[T.nilable(T.any(String, Integer))]
+                  )
+                )
+              ],
+            idempotency_header: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          base_url:,
+          timeout: 0.0,
+          max_retries: 0,
+          initial_retry_delay: 0.0,
+          max_retry_delay: 0.0,
+          headers: {},
+          idempotency_header: nil
+        )
+        end
+
+        # @api private
+        sig { overridable.returns(T::Hash[String, String]) }
+        private def auth_headers
+        end
+
+        # @api private
+        sig { returns(String) }
+        private def generate_idempotency_key
+        end
+
+        # @api private
+        sig do
+          overridable
+            .params(
+              req:
+                ModernTreasury::Internal::Transport::BaseClient::RequestComponents,
+              opts: ModernTreasury::Internal::AnyHash
+            )
+            .returns(
+              ModernTreasury::Internal::Transport::BaseClient::RequestInput
+            )
+        end
+        private def build_request(req, opts)
+        end
+
+        # @api private
+        sig do
+          params(
+            headers: T::Hash[String, String],
+            retry_count: Integer
+          ).returns(Float)
+        end
+        private def retry_delay(headers, retry_count:)
+        end
+
+        # @api private
+        sig do
+          params(
+            request:
+              ModernTreasury::Internal::Transport::BaseClient::RequestInput,
+            redirect_count: Integer,
+            retry_count: Integer,
+            send_retry_header: T::Boolean
+          ).returns([Integer, Net::HTTPResponse, T::Enumerable[String]])
+        end
+        private def send_request(
+          request,
+          redirect_count:,
+          retry_count:,
+          send_retry_header:
+        )
+        end
+
+        # Execute the request specified by `req`. This is the method that all resource
+        # methods call into.
+        #
+        # @overload request(method, path, query: {}, headers: {}, body: nil, unwrap: nil, page: nil, stream: nil, model: ModernTreasury::Internal::Type::Unknown, options: {})
+        sig do
+          params(
+            method: Symbol,
+            path: T.any(String, T::Array[String]),
+            query:
+              T.nilable(
+                T::Hash[String, T.nilable(T.any(T::Array[String], String))]
+              ),
+            headers:
+              T.nilable(
+                T::Hash[
+                  String,
+                  T.nilable(
+                    T.any(
+                      String,
+                      Integer,
+                      T::Array[T.nilable(T.any(String, Integer))]
+                    )
+                  )
+                ]
+              ),
+            body: T.nilable(T.anything),
+            unwrap:
+              T.nilable(
+                T.any(
+                  Symbol,
+                  Integer,
+                  T::Array[T.any(Symbol, Integer)],
+                  T.proc.params(arg0: T.anything).returns(T.anything)
+                )
+              ),
+            page:
+              T.nilable(
+                T::Class[
+                  ModernTreasury::Internal::Type::BasePage[
+                    ModernTreasury::Internal::Type::BaseModel
+                  ]
+                ]
+              ),
+            stream: T.nilable(T::Class[T.anything]),
+            model: T.nilable(ModernTreasury::Internal::Type::Converter::Input),
+            options: T.nilable(ModernTreasury::RequestOptions::OrHash)
+          ).returns(T.anything)
+        end
+        def request(
+          method,
+          path,
+          query: {},
+          headers: {},
+          body: nil,
+          unwrap: nil,
+          page: nil,
+          stream: nil,
+          model: ModernTreasury::Internal::Type::Unknown,
+          options: {}
+        )
+        end
+
+        # @api private
+        sig { returns(String) }
+        def inspect
+        end
+      end
+    end
+  end
+end

data/rbi/modern_treasury/internal/transport/pooled_net_requester.rbi

@@ -0,0 +1,80 @@
+# typed: strong
+
+module ModernTreasury
+  module Internal
+    module Transport
+      # @api private
+      class PooledNetRequester
+        extend ModernTreasury::Internal::Util::SorbetRuntimeSupport
+
+        Request =
+          T.type_alias do
+            {
+              method: Symbol,
+              url: URI::Generic,
+              headers: T::Hash[String, String],
+              body: T.anything,
+              deadline: Float
+            }
+          end
+
+        # from the golang stdlib
+        # https://github.com/golang/go/blob/c8eced8580028328fde7c03cbfcb720ce15b2358/src/net/http/transport.go#L49
+        KEEP_ALIVE_TIMEOUT = 30
+
+        DEFAULT_MAX_CONNECTIONS = T.let(T.unsafe(nil), Integer)
+
+        class << self
+          # @api private
+          sig { params(url: URI::Generic).returns(Net::HTTP) }
+          def connect(url)
+          end
+
+          # @api private
+          sig { params(conn: Net::HTTP, deadline: Float).void }
+          def calibrate_socket_timeout(conn, deadline)
+          end
+
+          # @api private
+          sig do
+            params(
+              request:
+                ModernTreasury::Internal::Transport::PooledNetRequester::Request,
+              blk: T.proc.params(arg0: String).void
+            ).returns([Net::HTTPGenericRequest, T.proc.void])
+          end
+          def build_request(request, &blk)
+          end
+        end
+
+        # @api private
+        sig do
+          params(
+            url: URI::Generic,
+            deadline: Float,
+            blk: T.proc.params(arg0: Net::HTTP).void
+          ).void
+        end
+        private def with_pool(url, deadline:, &blk)
+        end
+
+        # @api private
+        sig do
+          params(
+            request:
+              ModernTreasury::Internal::Transport::PooledNetRequester::Request
+          ).returns([Integer, Net::HTTPResponse, T::Enumerable[String]])
+        end
+        def execute(request)
+        end
+
+        # @api private
+        sig { params(size: Integer).returns(T.attached_class) }
+        def self.new(
+          size: ModernTreasury::Internal::Transport::PooledNetRequester::DEFAULT_MAX_CONNECTIONS
+        )
+        end
+      end
+    end
+  end
+end