dodopayments 1.22.0 → 1.49.0

data/rbi/dodopayments/internal/type/converter.rbi

@@ -5,56 +5,159 @@ module Dodopayments
     module Type
       # @api private
       module Converter
-        Input = T.type_alias { T.any(Dodopayments::Internal::Type::Converter, T::Class[T.anything]) }
+        extend Dodopayments::Internal::Util::SorbetRuntimeSupport
+
+        Input =
+          T.type_alias do
+            T.any(Dodopayments::Internal::Type::Converter, T::Class[T.anything])
+          end
 
         CoerceState =
           T.type_alias do
             {
-              strictness: T.any(T::Boolean, Symbol),
-              exactness: {yes: Integer, no: Integer, maybe: Integer},
+              translate_names: T::Boolean,
+              strictness: T::Boolean,
+              exactness: {
+                yes: Integer,
+                no: Integer,
+                maybe: Integer
+              },
+              error: T::Class[StandardError],
               branched: Integer
             }
           end
 
-        DumpState = T.type_alias { {can_retry: T::Boolean} }
+        DumpState = T.type_alias { { can_retry: T::Boolean } }
 
         # @api private
         sig do
           overridable
-            .params(value: T.anything, state: Dodopayments::Internal::Type::Converter::CoerceState)
+            .params(
+              value: T.anything,
+              state: Dodopayments::Internal::Type::Converter::CoerceState
+            )
             .returns(T.anything)
         end
-        def coerce(value, state:); end
+        def coerce(value, state:)
+        end
 
         # @api private
         sig do
           overridable
-            .params(value: T.anything, state: Dodopayments::Internal::Type::Converter::DumpState)
+            .params(
+              value: T.anything,
+              state: Dodopayments::Internal::Type::Converter::DumpState
+            )
             .returns(T.anything)
         end
-        def dump(value, state:); end
+        def dump(value, state:)
+        end
 
         # @api private
         sig { params(depth: Integer).returns(String) }
-        def inspect(depth: 0); end
+        def inspect(depth: 0)
+        end
 
         class << self
           # @api private
           sig do
             params(
-              spec: T.any(
-                {
-                  const: T.nilable(T.any(NilClass, T::Boolean, Integer, Float, Symbol)),
-                  enum: T.nilable(T.proc.returns(Dodopayments::Internal::Type::Converter::Input)),
-                  union: T.nilable(T.proc.returns(Dodopayments::Internal::Type::Converter::Input))
-                },
-                T.proc.returns(Dodopayments::Internal::Type::Converter::Input),
-                Dodopayments::Internal::Type::Converter::Input
-              )
+              spec:
+                T.any(
+                  {
+                    const:
+                      T.nilable(
+                        T.any(NilClass, T::Boolean, Integer, Float, Symbol)
+                      ),
+                    enum:
+                      T.nilable(
+                        T.proc.returns(
+                          Dodopayments::Internal::Type::Converter::Input
+                        )
+                      ),
+                    union:
+                      T.nilable(
+                        T.proc.returns(
+                          Dodopayments::Internal::Type::Converter::Input
+                        )
+                      )
+                  },
+                  T.proc.returns(
+                    Dodopayments::Internal::Type::Converter::Input
+                  ),
+                  Dodopayments::Internal::Type::Converter::Input
+                )
+            ).returns(T.proc.returns(T.anything))
+          end
+          def self.type_info(spec)
+          end
+
+          # @api private
+          sig do
+            params(
+              type_info:
+                T.any(
+                  {
+                    const:
+                      T.nilable(
+                        T.any(NilClass, T::Boolean, Integer, Float, Symbol)
+                      ),
+                    enum:
+                      T.nilable(
+                        T.proc.returns(
+                          Dodopayments::Internal::Type::Converter::Input
+                        )
+                      ),
+                    union:
+                      T.nilable(
+                        T.proc.returns(
+                          Dodopayments::Internal::Type::Converter::Input
+                        )
+                      )
+                  },
+                  T.proc.returns(
+                    Dodopayments::Internal::Type::Converter::Input
+                  ),
+                  Dodopayments::Internal::Type::Converter::Input
+                ),
+              spec:
+                T.any(
+                  {
+                    const:
+                      T.nilable(
+                        T.any(NilClass, T::Boolean, Integer, Float, Symbol)
+                      ),
+                    enum:
+                      T.nilable(
+                        T.proc.returns(
+                          Dodopayments::Internal::Type::Converter::Input
+                        )
+                      ),
+                    union:
+                      T.nilable(
+                        T.proc.returns(
+                          Dodopayments::Internal::Type::Converter::Input
+                        )
+                      )
+                  },
+                  T.proc.returns(
+                    Dodopayments::Internal::Type::Converter::Input
+                  ),
+                  Dodopayments::Internal::Type::Converter::Input
+                )
+            ).returns(Dodopayments::Internal::AnyHash)
+          end
+          def self.meta_info(type_info, spec)
+          end
+
+          # @api private
+          sig do
+            params(translate_names: T::Boolean).returns(
+              Dodopayments::Internal::Type::Converter::CoerceState
             )
-              .returns(T.proc.returns(T.anything))
           end
-          def self.type_info(spec); end
+          def self.new_coerce_state(translate_names: true)
+          end
 
           # @api private
           #
@@ -72,20 +175,16 @@ module Dodopayments
               target: Dodopayments::Internal::Type::Converter::Input,
               value: T.anything,
               state: Dodopayments::Internal::Type::Converter::CoerceState
-            )
-              .returns(T.anything)
+            ).returns(T.anything)
           end
           def self.coerce(
             target,
             value,
-            # The `strictness` is one of `true`, `false`, or `:strong`. This informs the
-            # coercion strategy when we have to decide between multiple possible conversion
-            # targets:
+            # The `strictness` is one of `true`, `false`. This informs the coercion strategy
+            # when we have to decide between multiple possible conversion targets:
             #
             # - `true`: the conversion must be exact, with minimum coercion.
             # - `false`: the conversion can be approximate, with some coercion.
-            # - `:strong`: the conversion must be exact, with no coercion, and raise an error
-            #   if not possible.
             #
             # The `exactness` is `Hash` with keys being one of `yes`, `no`, or `maybe`. For
             # any given conversion attempt, the exactness will be updated based on how closely
@@ -97,22 +196,25 @@ module Dodopayments
             # - `no`: the value cannot be converted to the target type.
             #
             # See implementation below for more details.
-            state: {strictness: true, exactness: {yes: 0, no: 0, maybe: 0}, branched: 0}
-          ); end
+            state: Dodopayments::Internal::Type::Converter.new_coerce_state
+          )
+          end
+
           # @api private
           sig do
             params(
               target: Dodopayments::Internal::Type::Converter::Input,
               value: T.anything,
               state: Dodopayments::Internal::Type::Converter::DumpState
-            )
-              .returns(T.anything)
+            ).returns(T.anything)
+          end
+          def self.dump(target, value, state: { can_retry: true })
           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
+          def self.inspect(target, depth:)
+          end
         end
       end
     end

data/rbi/dodopayments/internal/type/enum.rbi

@@ -17,19 +17,28 @@ module Dodopayments
       # values safely.
       module Enum
         include Dodopayments::Internal::Type::Converter
+        include Dodopayments::Internal::Util::SorbetRuntimeSupport
 
         # All of the valid Symbol values for this enum.
-        sig { overridable.returns(T::Array[T.any(NilClass, T::Boolean, Integer, Float, Symbol)]) }
-        def values; end
+        sig do
+          overridable.returns(
+            T::Array[T.any(NilClass, T::Boolean, Integer, Float, Symbol)]
+          )
+        end
+        def values
+        end
 
         sig { params(other: T.anything).returns(T::Boolean) }
-        def ===(other); end
+        def ===(other)
+        end
 
         sig { params(other: T.anything).returns(T::Boolean) }
-        def ==(other); end
+        def ==(other)
+        end
 
         sig { returns(Integer) }
-        def hash; end
+        def hash
+        end
 
         # @api private
         #
@@ -43,23 +52,30 @@ module Dodopayments
             )
             .returns(T.any(Symbol, T.anything))
         end
-        def coerce(value, state:); end
+        def coerce(value, state:)
+        end
 
         # @api private
         sig do
           override
-            .params(value: T.any(
-              Symbol,
-              T.anything
-            ),
-                    state: Dodopayments::Internal::Type::Converter::DumpState)
+            .params(
+              value: T.any(Symbol, T.anything),
+              state: Dodopayments::Internal::Type::Converter::DumpState
+            )
             .returns(T.any(Symbol, T.anything))
         end
-        def dump(value, state:); end
+        def dump(value, state:)
+        end
+
+        # @api private
+        sig { returns(T.anything) }
+        def to_sorbet_type
+        end
 
         # @api private
         sig { params(depth: Integer).returns(String) }
-        def inspect(depth: 0); end
+        def inspect(depth: 0)
+        end
       end
     end
   end

data/rbi/dodopayments/internal/type/file_input.rbi

@@ -16,10 +16,12 @@ module Dodopayments
         abstract!
 
         sig { params(other: T.anything).returns(T::Boolean) }
-        def self.===(other); end
+        def self.===(other)
+        end
 
         sig { params(other: T.anything).returns(T::Boolean) }
-        def self.==(other); end
+        def self.==(other)
+        end
 
         class << self
           # @api private
@@ -31,7 +33,8 @@ module Dodopayments
               )
               .returns(T.any(StringIO, T.anything))
           end
-          def coerce(value, state:); end
+          def coerce(value, state:)
+          end
 
           # @api private
           sig do
@@ -42,7 +45,13 @@ module Dodopayments
               )
               .returns(T.any(Pathname, StringIO, IO, String, T.anything))
           end
-          def dump(value, state:); end
+          def dump(value, state:)
+          end
+
+          # @api private
+          sig { returns(T.anything) }
+          def to_sorbet_type
+          end
         end
       end
     end

data/rbi/dodopayments/internal/type/hash_of.rbi

@@ -8,6 +8,7 @@ module Dodopayments
       # Hash of items of a given type.
       class HashOf
         include Dodopayments::Internal::Type::Converter
+        include Dodopayments::Internal::Util::SorbetRuntimeSupport
 
         abstract!
 
@@ -15,25 +16,29 @@ module Dodopayments
 
         sig do
           params(
-            type_info: T.any(
-              Dodopayments::Internal::AnyHash,
-              T.proc.returns(Dodopayments::Internal::Type::Converter::Input),
-              Dodopayments::Internal::Type::Converter::Input
-            ),
+            type_info:
+              T.any(
+                Dodopayments::Internal::AnyHash,
+                T.proc.returns(Dodopayments::Internal::Type::Converter::Input),
+                Dodopayments::Internal::Type::Converter::Input
+              ),
             spec: Dodopayments::Internal::AnyHash
-          )
-            .returns(T.attached_class)
+          ).returns(T.attached_class)
+        end
+        def self.[](type_info, spec = {})
         end
-        def self.[](type_info, spec = {}); end
 
         sig { params(other: T.anything).returns(T::Boolean) }
-        def ===(other); end
+        def ===(other)
+        end
 
         sig { params(other: T.anything).returns(T::Boolean) }
-        def ==(other); end
+        def ==(other)
+        end
 
         sig { returns(Integer) }
-        def hash; end
+        def hash
+        end
 
         # @api private
         sig do
@@ -44,7 +49,8 @@ module Dodopayments
             )
             .returns(T.any(Dodopayments::Internal::AnyHash, T.anything))
         end
-        def coerce(value, state:); end
+        def coerce(value, state:)
+        end
 
         # @api private
         sig do
@@ -55,33 +61,43 @@ module Dodopayments
             )
             .returns(T.any(Dodopayments::Internal::AnyHash, T.anything))
         end
-        def dump(value, state:); end
+        def dump(value, state:)
+        end
+
+        # @api private
+        sig { returns(T.anything) }
+        def to_sorbet_type
+        end
 
         # @api private
         sig { returns(Elem) }
-        protected def item_type; end
+        protected def item_type
+        end
 
         # @api private
         sig { returns(T::Boolean) }
-        protected def nilable?; end
+        protected def nilable?
+        end
 
         # @api private
         sig do
           params(
-            type_info: T.any(
-              Dodopayments::Internal::AnyHash,
-              T.proc.returns(Dodopayments::Internal::Type::Converter::Input),
-              Dodopayments::Internal::Type::Converter::Input
-            ),
+            type_info:
+              T.any(
+                Dodopayments::Internal::AnyHash,
+                T.proc.returns(Dodopayments::Internal::Type::Converter::Input),
+                Dodopayments::Internal::Type::Converter::Input
+              ),
             spec: Dodopayments::Internal::AnyHash
-          )
-            .void
+          ).void
+        end
+        def initialize(type_info, spec = {})
         end
-        def initialize(type_info, spec = {}); end
 
         # @api private
         sig { params(depth: Integer).returns(String) }
-        def inspect(depth: 0); end
+        def inspect(depth: 0)
+        end
       end
     end
   end

data/rbi/dodopayments/internal/type/request_parameters.rbi

@@ -6,14 +6,24 @@ module Dodopayments
       # @api private
       module RequestParameters
         # Options to specify HTTP behaviour for this request.
-        sig { returns(Dodopayments::RequestOpts) }
-        attr_accessor :request_options
+        sig { returns(Dodopayments::RequestOptions) }
+        attr_reader :request_options
+
+        sig do
+          params(request_options: Dodopayments::RequestOptions::OrHash).void
+        end
+        attr_writer :request_options
 
         # @api private
         module Converter
           # @api private
-          sig { params(params: T.anything).returns([T.anything, Dodopayments::Internal::AnyHash]) }
-          def dump_request(params); end
+          sig do
+            params(params: T.anything).returns(
+              [T.anything, Dodopayments::Internal::AnyHash]
+            )
+          end
+          def dump_request(params)
+          end
         end
       end
     end

data/rbi/dodopayments/internal/type/union.rbi

@@ -6,74 +6,122 @@ module Dodopayments
       # @api private
       module Union
         include Dodopayments::Internal::Type::Converter
+        include Dodopayments::Internal::Util::SorbetRuntimeSupport
 
         # @api private
         #
         # All of the specified variant info for this union.
         sig do
           returns(
-            T::Array[[
-              T.nilable(Symbol),
-              T.proc.returns(Dodopayments::Internal::Type::Converter::Input)
-            ]]
+            T::Array[
+              [
+                T.nilable(Symbol),
+                T.proc.returns(Dodopayments::Internal::Type::Converter::Input),
+                Dodopayments::Internal::AnyHash
+              ]
+            ]
           )
         end
-        private def known_variants; end
+        private def known_variants
+        end
 
         # @api private
-        sig { returns(T::Array[[T.nilable(Symbol), T.anything]]) }
-        protected def derefed_variants; end
+        sig do
+          returns(
+            T::Array[
+              [T.nilable(Symbol), T.anything, Dodopayments::Internal::AnyHash]
+            ]
+          )
+        end
+        protected def derefed_variants
+        end
 
         # All of the specified variants for this union.
         sig { overridable.returns(T::Array[T.anything]) }
-        def variants; end
+        def variants
+        end
 
         # @api private
         sig { params(property: Symbol).void }
-        private def discriminator(property); end
+        private def discriminator(property)
+        end
 
         # @api private
         sig do
           params(
-            key: T.any(Symbol, Dodopayments::Internal::AnyHash, T.proc.returns(T.anything), T.anything),
-            spec: T.any(Dodopayments::Internal::AnyHash, T.proc.returns(T.anything), T.anything)
-          )
-            .void
+            key:
+              T.any(
+                Symbol,
+                Dodopayments::Internal::AnyHash,
+                T.proc.returns(T.anything),
+                T.anything
+              ),
+            spec:
+              T.any(
+                Dodopayments::Internal::AnyHash,
+                T.proc.returns(T.anything),
+                T.anything
+              )
+          ).void
+        end
+        private def variant(key, spec = nil)
         end
-        private def variant(key, spec = nil); end
 
         # @api private
         sig { params(value: T.anything).returns(T.nilable(T.anything)) }
-        private def resolve_variant(value); end
+        private def resolve_variant(value)
+        end
 
         sig { params(other: T.anything).returns(T::Boolean) }
-        def ===(other); end
+        def ===(other)
+        end
 
         sig { params(other: T.anything).returns(T::Boolean) }
-        def ==(other); end
+        def ==(other)
+        end
 
         sig { returns(Integer) }
-        def hash; end
+        def hash
+        end
 
         # @api private
+        #
+        # Tries to efficiently coerce the given value to one of the known variants.
+        #
+        # If the value cannot match any of the known variants, the coercion is considered
+        # non-viable and returns the original value.
         sig do
           override
-            .params(value: T.anything, state: Dodopayments::Internal::Type::Converter::CoerceState)
+            .params(
+              value: T.anything,
+              state: Dodopayments::Internal::Type::Converter::CoerceState
+            )
             .returns(T.anything)
         end
-        def coerce(value, state:); end
+        def coerce(value, state:)
+        end
 
         # @api private
         sig do
           override
-            .params(value: T.anything, state: Dodopayments::Internal::Type::Converter::DumpState)
+            .params(
+              value: T.anything,
+              state: Dodopayments::Internal::Type::Converter::DumpState
+            )
             .returns(T.anything)
         end
-        def dump(value, state:); end
+        def dump(value, state:)
+        end
+
+        # @api private
+        sig { returns(T.anything) }
+        def to_sorbet_type
+        end
 
         # @api private
         sig { params(depth: Integer).returns(String) }
-        def inspect(depth: 0); end
+        def inspect(depth: 0)
+        end
       end
     end
   end

data/rbi/dodopayments/internal/type/unknown.rbi

@@ -8,31 +8,49 @@ module Dodopayments
       # When we don't know what to expect for the value.
       class Unknown
         extend Dodopayments::Internal::Type::Converter
+        extend Dodopayments::Internal::Util::SorbetRuntimeSupport
 
         abstract!
 
         sig { params(other: T.anything).returns(T::Boolean) }
-        def self.===(other); end
+        def self.===(other)
+        end
 
         sig { params(other: T.anything).returns(T::Boolean) }
-        def self.==(other); end
+        def self.==(other)
+        end
 
         class << self
           # @api private
+          #
+          # No coercion needed for Unknown type.
           sig do
             override
-              .params(value: T.anything, state: Dodopayments::Internal::Type::Converter::CoerceState)
+              .params(
+                value: T.anything,
+                state: Dodopayments::Internal::Type::Converter::CoerceState
+              )
               .returns(T.anything)
           end
-          def coerce(value, state:); end
+          def coerce(value, state:)
+          end
 
           # @api private
           sig do
             override
-              .params(value: T.anything, state: Dodopayments::Internal::Type::Converter::DumpState)
+              .params(
+                value: T.anything,
+                state: Dodopayments::Internal::Type::Converter::DumpState
+              )
               .returns(T.anything)
           end
-          def dump(value, state:); end
+          def dump(value, state:)
+          end
+
+          # @api private
+          sig { returns(T.anything) }
+          def to_sorbet_type
+          end
         end
       end
     end