modern_treasury 0.1.0.pre.alpha.17 → 0.1.0.pre.alpha.18

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

@@ -190,6 +190,7 @@ module ModernTreasury
           model: ModernTreasury::Internal::Type::Unknown,
           options: {}
         ); end
+        # @api private
         sig { returns(String) }
         def inspect; end
       end

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

@@ -35,7 +35,7 @@ module ModernTreasury
               request: ModernTreasury::Internal::Transport::PooledNetRequester::RequestShape,
               blk: T.proc.params(arg0: String).void
             )
-              .returns(Net::HTTPGenericRequest)
+              .returns([Net::HTTPGenericRequest, T.proc.void])
           end
           def build_request(request, &blk); end
         end

data/rbi/lib/modern_treasury/internal/type/array_of.rbi

@@ -10,11 +10,10 @@ module ModernTreasury
         include ModernTreasury::Internal::Type::Converter
 
         abstract!
-        final!
 
         Elem = type_member(:out)
 
-        sig(:final) do
+        sig do
           params(
             type_info: T.any(
               ModernTreasury::Internal::AnyHash,
@@ -27,41 +26,44 @@ module ModernTreasury
         end
         def self.[](type_info, spec = {}); end
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def ===(other); end
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def ==(other); end
 
         # @api private
-        sig(:final) do
+        sig do
           override
             .params(
               value: T.any(T::Array[T.anything], T.anything),
-              state: ModernTreasury::Internal::Type::Converter::State
+              state: ModernTreasury::Internal::Type::Converter::CoerceState
             )
             .returns(T.any(T::Array[T.anything], T.anything))
         end
         def coerce(value, state:); end
 
         # @api private
-        sig(:final) do
+        sig do
           override
-            .params(value: T.any(T::Array[T.anything], T.anything))
+            .params(
+              value: T.any(T::Array[T.anything], T.anything),
+              state: ModernTreasury::Internal::Type::Converter::DumpState
+            )
             .returns(T.any(T::Array[T.anything], T.anything))
         end
-        def dump(value); end
+        def dump(value, state:); end
 
         # @api private
-        sig(:final) { returns(Elem) }
+        sig { returns(Elem) }
         protected def item_type; end
 
         # @api private
-        sig(:final) { returns(T::Boolean) }
+        sig { returns(T::Boolean) }
         protected def nilable?; end
 
         # @api private
-        sig(:final) do
+        sig do
           params(
             type_info: T.any(
               ModernTreasury::Internal::AnyHash,
@@ -73,6 +75,10 @@ module ModernTreasury
             .void
         end
         def initialize(type_info, spec = {}); end
+
+        # @api private
+        sig { params(depth: Integer).returns(String) }
+        def inspect(depth: 0); end
       end
     end
   end

data/rbi/lib/modern_treasury/internal/type/base_model.rbi

@@ -126,7 +126,7 @@ module ModernTreasury
                   T::Hash[T.anything, T.anything],
                   T.anything
                 ),
-                state: ModernTreasury::Internal::Type::Converter::State
+                state: ModernTreasury::Internal::Type::Converter::CoerceState
               )
               .returns(T.any(T.attached_class, T.anything))
           end
@@ -135,10 +135,13 @@ module ModernTreasury
           # @api private
           sig do
             override
-              .params(value: T.any(T.attached_class, T.anything))
+              .params(
+                value: T.any(T.attached_class, T.anything),
+                state: ModernTreasury::Internal::Type::Converter::DumpState
+              )
               .returns(T.any(T::Hash[T.anything, T.anything], T.anything))
           end
-          def dump(value); end
+          def dump(value, state:); end
         end
 
         # Returns the raw value associated with the given key, if found. Otherwise, nil is
@@ -185,6 +188,13 @@ module ModernTreasury
         sig { params(data: T.any(T::Hash[Symbol, T.anything], T.self_type)).returns(T.attached_class) }
         def self.new(data = {}); end
 
+        class << self
+          # @api private
+          sig { params(depth: Integer).returns(String) }
+          def inspect(depth: 0); end
+        end
+
+        # @api private
         sig { returns(String) }
         def inspect; end
       end

data/rbi/lib/modern_treasury/internal/type/boolean.rbi

@@ -10,32 +10,36 @@ module ModernTreasury
         extend ModernTreasury::Internal::Type::Converter
 
         abstract!
-        final!
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def self.===(other); end
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def self.==(other); end
 
         class << self
           # @api private
-          sig(:final) do
+          sig do
             override
-              .params(value: T.any(
-                T::Boolean,
-                T.anything
-              ),
-                      state: ModernTreasury::Internal::Type::Converter::State)
+              .params(
+                value: T.any(T::Boolean, T.anything),
+                state: ModernTreasury::Internal::Type::Converter::CoerceState
+              )
               .returns(T.any(T::Boolean, T.anything))
           end
           def coerce(value, state:); end
 
           # @api private
-          sig(:final) do
-            override.params(value: T.any(T::Boolean, T.anything)).returns(T.any(T::Boolean, T.anything))
+          sig do
+            override
+              .params(value: T.any(
+                T::Boolean,
+                T.anything
+              ),
+                      state: ModernTreasury::Internal::Type::Converter::DumpState)
+              .returns(T.any(T::Boolean, T.anything))
           end
-          def dump(value); end
+          def dump(value, state:); end
         end
       end
     end

data/rbi/lib/modern_treasury/internal/type/converter.rbi

@@ -7,7 +7,7 @@ module ModernTreasury
       module Converter
         Input = T.type_alias { T.any(ModernTreasury::Internal::Type::Converter, T::Class[T.anything]) }
 
-        State =
+        CoerceState =
           T.type_alias do
             {
               strictness: T.any(T::Boolean, Symbol),
@@ -16,17 +16,27 @@ module ModernTreasury
             }
           end
 
+        DumpState = T.type_alias { {can_retry: T::Boolean} }
+
         # @api private
         sig do
           overridable
-            .params(value: T.anything, state: ModernTreasury::Internal::Type::Converter::State)
+            .params(value: T.anything, state: ModernTreasury::Internal::Type::Converter::CoerceState)
             .returns(T.anything)
         end
         def coerce(value, state:); end
 
         # @api private
-        sig { overridable.params(value: T.anything).returns(T.anything) }
-        def dump(value); end
+        sig do
+          overridable
+            .params(value: T.anything, state: ModernTreasury::Internal::Type::Converter::DumpState)
+            .returns(T.anything)
+        end
+        def dump(value, state:); end
+
+        # @api private
+        sig { params(depth: Integer).returns(String) }
+        def inspect(depth: 0); end
 
         class << self
           # @api private
@@ -61,7 +71,7 @@ module ModernTreasury
             params(
               target: ModernTreasury::Internal::Type::Converter::Input,
               value: T.anything,
-              state: ModernTreasury::Internal::Type::Converter::State
+              state: ModernTreasury::Internal::Type::Converter::CoerceState
             )
               .returns(T.anything)
           end
@@ -93,10 +103,16 @@ module ModernTreasury
           sig do
             params(
               target: ModernTreasury::Internal::Type::Converter::Input,
-              value: T.anything
-            ).returns(T.anything)
+              value: T.anything,
+              state: ModernTreasury::Internal::Type::Converter::DumpState
+            )
+              .returns(T.anything)
           end
-          def self.dump(target, value); end
+          def self.dump(target, value, state: {can_retry: true}); end
+
+          # @api private
+          sig { params(target: T.anything, depth: Integer).returns(String) }
+          def self.inspect(target, depth:); end
         end
       end
     end

data/rbi/lib/modern_treasury/internal/type/enum.rbi

@@ -38,21 +38,31 @@ module ModernTreasury
         #
         # Unlike with primitives, `Enum` additionally validates that the value is a member
         # of the enum.
+        sig do
+          override
+            .params(
+              value: T.any(String, Symbol, T.anything),
+              state: ModernTreasury::Internal::Type::Converter::CoerceState
+            )
+            .returns(T.any(Symbol, T.anything))
+        end
+        def coerce(value, state:); end
+
+        # @api private
         sig do
           override
             .params(value: T.any(
-              String,
               Symbol,
               T.anything
             ),
-                    state: ModernTreasury::Internal::Type::Converter::State)
+                    state: ModernTreasury::Internal::Type::Converter::DumpState)
             .returns(T.any(Symbol, T.anything))
         end
-        def coerce(value, state:); end
+        def dump(value, state:); end
 
         # @api private
-        sig { override.params(value: T.any(Symbol, T.anything)).returns(T.any(Symbol, T.anything)) }
-        def dump(value); end
+        sig { params(depth: Integer).returns(String) }
+        def inspect(depth: 0); end
       end
     end
   end

data/rbi/lib/modern_treasury/internal/type/hash_of.rbi

@@ -10,11 +10,10 @@ module ModernTreasury
         include ModernTreasury::Internal::Type::Converter
 
         abstract!
-        final!
 
         Elem = type_member(:out)
 
-        sig(:final) do
+        sig do
           params(
             type_info: T.any(
               ModernTreasury::Internal::AnyHash,
@@ -27,41 +26,44 @@ module ModernTreasury
         end
         def self.[](type_info, spec = {}); end
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def ===(other); end
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def ==(other); end
 
         # @api private
-        sig(:final) do
+        sig do
           override
             .params(
               value: T.any(T::Hash[T.anything, T.anything], T.anything),
-              state: ModernTreasury::Internal::Type::Converter::State
+              state: ModernTreasury::Internal::Type::Converter::CoerceState
             )
             .returns(T.any(ModernTreasury::Internal::AnyHash, T.anything))
         end
         def coerce(value, state:); end
 
         # @api private
-        sig(:final) do
+        sig do
           override
-            .params(value: T.any(T::Hash[T.anything, T.anything], T.anything))
+            .params(
+              value: T.any(T::Hash[T.anything, T.anything], T.anything),
+              state: ModernTreasury::Internal::Type::Converter::DumpState
+            )
             .returns(T.any(ModernTreasury::Internal::AnyHash, T.anything))
         end
-        def dump(value); end
+        def dump(value, state:); end
 
         # @api private
-        sig(:final) { returns(Elem) }
+        sig { returns(Elem) }
         protected def item_type; end
 
         # @api private
-        sig(:final) { returns(T::Boolean) }
+        sig { returns(T::Boolean) }
         protected def nilable?; end
 
         # @api private
-        sig(:final) do
+        sig do
           params(
             type_info: T.any(
               ModernTreasury::Internal::AnyHash,
@@ -73,6 +75,10 @@ module ModernTreasury
             .void
         end
         def initialize(type_info, spec = {}); end
+
+        # @api private
+        sig { params(depth: Integer).returns(String) }
+        def inspect(depth: 0); end
       end
     end
   end

data/rbi/lib/modern_treasury/internal/type/io_like.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module ModernTreasury
+  module Internal
+    module Type
+      # @api private
+      #
+      # Either `Pathname` or `StringIO`.
+      class IOLike
+        extend ModernTreasury::Internal::Type::Converter
+
+        abstract!
+
+        sig { params(other: T.anything).returns(T::Boolean) }
+        def self.===(other); end
+
+        sig { params(other: T.anything).returns(T::Boolean) }
+        def self.==(other); end
+
+        class << self
+          # @api private
+          sig do
+            override
+              .params(
+                value: T.any(StringIO, String, T.anything),
+                state: ModernTreasury::Internal::Type::Converter::CoerceState
+              )
+              .returns(T.any(StringIO, T.anything))
+          end
+          def coerce(value, state:); end
+
+          # @api private
+          sig do
+            override
+              .params(
+                value: T.any(Pathname, StringIO, IO, String, T.anything),
+                state: ModernTreasury::Internal::Type::Converter::DumpState
+              )
+              .returns(T.any(Pathname, StringIO, IO, String, T.anything))
+          end
+          def dump(value, state:); end
+        end
+      end
+    end
+  end
+end

data/rbi/lib/modern_treasury/internal/type/union.rbi

@@ -55,14 +55,22 @@ module ModernTreasury
         # @api private
         sig do
           override
-            .params(value: T.anything, state: ModernTreasury::Internal::Type::Converter::State)
+            .params(value: T.anything, state: ModernTreasury::Internal::Type::Converter::CoerceState)
             .returns(T.anything)
         end
         def coerce(value, state:); end
 
         # @api private
-        sig { override.params(value: T.anything).returns(T.anything) }
-        def dump(value); end
+        sig do
+          override
+            .params(value: T.anything, state: ModernTreasury::Internal::Type::Converter::DumpState)
+            .returns(T.anything)
+        end
+        def dump(value, state:); end
+
+        # @api private
+        sig { params(depth: Integer).returns(String) }
+        def inspect(depth: 0); end
       end
     end
   end

data/rbi/lib/modern_treasury/internal/type/unknown.rbi

@@ -10,26 +10,29 @@ module ModernTreasury
         extend ModernTreasury::Internal::Type::Converter
 
         abstract!
-        final!
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def self.===(other); end
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def self.==(other); end
 
         class << self
           # @api private
-          sig(:final) do
+          sig do
             override
-              .params(value: T.anything, state: ModernTreasury::Internal::Type::Converter::State)
+              .params(value: T.anything, state: ModernTreasury::Internal::Type::Converter::CoerceState)
               .returns(T.anything)
           end
           def coerce(value, state:); end
 
           # @api private
-          sig(:final) { override.params(value: T.anything).returns(T.anything) }
-          def dump(value); end
+          sig do
+            override
+              .params(value: T.anything, state: ModernTreasury::Internal::Type::Converter::DumpState)
+              .returns(T.anything)
+          end
+          def dump(value, state:); end
         end
       end
     end

data/rbi/lib/modern_treasury/internal/util.rbi

@@ -145,10 +145,34 @@ module ModernTreasury
         def normalized_headers(*headers); end
       end
 
+      # @api private
+      class SerializationAdapter
+        sig { returns(T.any(Pathname, IO)) }
+        attr_reader :inner
+
+        sig { params(a: T.anything).returns(String) }
+        def to_json(*a); end
+
+        sig { params(a: T.anything).returns(String) }
+        def to_yaml(*a); end
+
+        # @api private
+        sig { params(inner: T.any(Pathname, IO)).returns(T.attached_class) }
+        def self.new(inner); end
+      end
+
       # @api private
       #
       # An adapter that satisfies the IO interface required by `::IO.copy_stream`
       class ReadIOAdapter
+        # @api private
+        sig { returns(T.nilable(T::Boolean)) }
+        def close?; end
+
+        # @api private
+        sig { void }
+        def close; end
+
         # @api private
         sig { params(max_len: T.nilable(Integer)).returns(String) }
         private def read_enum(max_len); end
@@ -160,12 +184,12 @@ module ModernTreasury
         # @api private
         sig do
           params(
-            stream: T.any(String, IO, StringIO, T::Enumerable[String]),
+            src: T.any(String, Pathname, StringIO, T::Enumerable[String]),
             blk: T.proc.params(arg0: String).void
           )
             .returns(T.attached_class)
         end
-        def self.new(stream, &blk); end
+        def self.new(src, &blk); end
       end
 
       class << self
@@ -176,9 +200,16 @@ module ModernTreasury
       class << self
         # @api private
         sig do
-          params(y: Enumerator::Yielder, boundary: String, key: T.any(Symbol, String), val: T.anything).void
+          params(
+            y: Enumerator::Yielder,
+            boundary: String,
+            key: T.any(Symbol, String),
+            val: T.anything,
+            closing: T::Array[T.proc.void]
+          )
+            .void
         end
-        private def write_multipart_chunk(y, boundary:, key:, val:); end
+        private def write_multipart_chunk(y, boundary:, key:, val:, closing:); end
 
         # @api private
         sig { params(body: T.anything).returns([String, T::Enumerable[String]]) }
@@ -189,6 +220,14 @@ module ModernTreasury
         def encode_content(headers, body); end
 
         # @api private
+        #
+        # https://www.iana.org/assignments/character-sets/character-sets.xhtml
+        sig { params(content_type: String, text: String).void }
+        def force_charset!(content_type, text:); end
+
+        # @api private
+        #
+        # Assumes each chunk in stream has `Encoding::BINARY`.
         sig do
           params(
             headers: T.any(T::Hash[String, String], Net::HTTPHeader),
@@ -237,12 +276,19 @@ module ModernTreasury
 
       class << self
         # @api private
+        #
+        # Assumes Strings have been forced into having `Encoding::BINARY`.
+        #
+        # This decoder is responsible for reassembling lines split across multiple
+        # fragments.
         sig { params(enum: T::Enumerable[String]).returns(T::Enumerable[String]) }
         def decode_lines(enum); end
 
         # @api private
         #
         # https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream
+        #
+        # Assumes that `lines` has been decoded with `#decode_lines`.
         sig do
           params(lines: T::Enumerable[String])
             .returns(T::Enumerable[ModernTreasury::Internal::Util::ServerSentEvent])

data/rbi/lib/modern_treasury/internal.rbi

@@ -7,6 +7,6 @@ module ModernTreasury
     # this alias might be refined in the future.
     AnyHash = T.type_alias { T::Hash[Symbol, T.anything] }
 
-    OMIT = T.let(T.anything, T.anything)
+    OMIT = T.let(Object.new.freeze, T.anything)
   end
 end

data/rbi/lib/modern_treasury/models/document_create_params.rbi

@@ -13,7 +13,7 @@ module ModernTreasury
       sig { returns(ModernTreasury::Models::DocumentCreateParams::DocumentableType::OrSymbol) }
       attr_accessor :documentable_type
 
-      sig { returns(T.any(IO, StringIO)) }
+      sig { returns(T.any(Pathname, StringIO)) }
       attr_accessor :file
 
       # A category given to the document, can be `null`.
@@ -27,7 +27,7 @@ module ModernTreasury
         params(
           documentable_id: String,
           documentable_type: ModernTreasury::Models::DocumentCreateParams::DocumentableType::OrSymbol,
-          file: T.any(IO, StringIO),
+          file: T.any(Pathname, StringIO),
           document_type: String,
           request_options: T.any(ModernTreasury::RequestOptions, ModernTreasury::Internal::AnyHash)
         )
@@ -41,7 +41,7 @@ module ModernTreasury
             {
               documentable_id: String,
               documentable_type: ModernTreasury::Models::DocumentCreateParams::DocumentableType::OrSymbol,
-              file: T.any(IO, StringIO),
+              file: T.any(Pathname, StringIO),
               document_type: String,
               request_options: ModernTreasury::RequestOptions
             }

data/rbi/lib/modern_treasury/models/payment_order_create_params.rbi

@@ -473,7 +473,7 @@ module ModernTreasury
         sig { returns(ModernTreasury::Models::PaymentOrderCreateParams::Document::DocumentableType::OrSymbol) }
         attr_accessor :documentable_type
 
-        sig { returns(T.any(IO, StringIO)) }
+        sig { returns(T.any(Pathname, StringIO)) }
         attr_accessor :file
 
         # A category given to the document, can be `null`.
@@ -487,7 +487,7 @@ module ModernTreasury
           params(
             documentable_id: String,
             documentable_type: ModernTreasury::Models::PaymentOrderCreateParams::Document::DocumentableType::OrSymbol,
-            file: T.any(IO, StringIO),
+            file: T.any(Pathname, StringIO),
             document_type: String
           )
             .returns(T.attached_class)
@@ -500,7 +500,7 @@ module ModernTreasury
               {
                 documentable_id: String,
                 documentable_type: ModernTreasury::Models::PaymentOrderCreateParams::Document::DocumentableType::OrSymbol,
-                file: T.any(IO, StringIO),
+                file: T.any(Pathname, StringIO),
                 document_type: String
               }
             )

data/rbi/lib/modern_treasury/resources/documents.rbi

@@ -8,7 +8,7 @@ module ModernTreasury
         params(
           documentable_id: String,
           documentable_type: ModernTreasury::Models::DocumentCreateParams::DocumentableType::OrSymbol,
-          file: T.any(IO, StringIO),
+          file: T.any(Pathname, StringIO),
           document_type: String,
           request_options: T.nilable(T.any(ModernTreasury::RequestOptions, ModernTreasury::Internal::AnyHash))
         )

data/sig/modern_treasury/internal/transport/pooled_net_requester.rbs

@@ -21,7 +21,7 @@ module ModernTreasury
           ModernTreasury::Internal::Transport::PooledNetRequester::request request
         ) {
           (String arg0) -> void
-        } -> top
+        } -> [top, (^-> void)]
 
         private def with_pool: (
           URI::Generic url,