metronome-sdk 0.1.0.pre.alpha.3 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a645770b02b7440ae82c30bcd41b416cca3d0c02650fa028b80ad469ae2af33
-  data.tar.gz: 607059caf25c134bc90370fc6bcc86e64a78ca3b8bffde779e7df6f95c9184ff
+  metadata.gz: 8f4ff0f17b280b8084d27b79a761e6ab88ffe486ef89d0e6eb293ed03bd30c1a
+  data.tar.gz: a9dc39b1d257fc714c2a2cc523098fb84533ac07cfcddfc9b02d0ba28651e368
 SHA512:
-  metadata.gz: 557dd905500c38ad75d825d159a590f01172d300003fd53c79b48b618f4a5386e7cc521c36be80bd456664e85189bf50528dcf5733fc2adbfec4a3949ef0fe47
-  data.tar.gz: c6a62d5582657414e56451293aa6ccbf3727bc47816f1747e1aacee986f9ae79bb07397200bcf7076312f1fcc0a4e45dd39cfa41c079182e013ebc9fdd28b351
+  metadata.gz: 406759335a7c9a236c5743e7f3127de60773ea9e7984444d3e19fa2640f20355d6f82cffb86588ab691d0a66b537acb3ee003176c8d3400e0d8fc9a8b1a1b17b
+  data.tar.gz: f030ece1727f3e6742106c2d49c748ffe33285307ee54049f32eaab33d0926c7b3574b45487ecdf48ab4216070e1bfb36e0a774b9388c72ab8ac0a46411b0c2c

data/CHANGELOG.md

@@ -1,5 +1,61 @@
 # Changelog
 
+## 0.1.0 (2025-07-24)
+
+Full Changelog: [v0.1.0-alpha.4...v0.1.0](https://github.com/Metronome-Industries/metronome-ruby/compare/v0.1.0-alpha.4...v0.1.0)
+
+### Features
+
+* **api:** Allow for Pagination past empty pages ([b608e5e](https://github.com/Metronome-Industries/metronome-ruby/commit/b608e5e7b9109f7859371c4816d07b4ccd25e976))
+* **api:** api update ([44cce30](https://github.com/Metronome-Industries/metronome-ruby/commit/44cce30fe4d15233fe4bb0b42cd46ceda2faa0a7))
+* **api:** api update ([d205568](https://github.com/Metronome-Industries/metronome-ruby/commit/d2055689feba86efebd0e926cf2c18a8f6682080))
+* **api:** api update ([ead65db](https://github.com/Metronome-Industries/metronome-ruby/commit/ead65db988e30be27317d6e0dfc57fc8a58f8aad))
+
+
+### Chores
+
+* **internal:** version bump ([eabd459](https://github.com/Metronome-Industries/metronome-ruby/commit/eabd459fc04f484ee853a336b2f0d30f6b2382b1))
+
+## 0.1.0-alpha.4 (2025-07-18)
+
+Full Changelog: [v0.1.0-alpha.3...v0.1.0-alpha.4](https://github.com/Metronome-Industries/metronome-ruby/compare/v0.1.0-alpha.3...v0.1.0-alpha.4)
+
+### Features
+
+* **api:** Add Event Search API for finding events to match to customers and billable metrics ([26a0a0d](https://github.com/Metronome-Industries/metronome-ruby/commit/26a0a0d293496c532c635a9936dd2ba7c3f14683))
+* **api:** add previewEvents API for generating draft invoices with provided events ([e2e5795](https://github.com/Metronome-Industries/metronome-ruby/commit/e2e579573a289ce749608a9c08a97b074ead387d))
+* **api:** update v2 contracts list documentation to specify chronological order ([b322bbc](https://github.com/Metronome-Industries/metronome-ruby/commit/b322bbc373ac7b90fe771fa6a2a2bef1fdc504ff))
+* **api:** add support for Anrok and Precalculated tax types in payment gateway configuration ([ee0d2af](https://github.com/Metronome-Industries/metronome-ruby/commit/ee0d2af6cc3cb1fb2bbc321f619ccd941db06c44))
+* **api:** add hierarchy configuration to v1 contracts ([f076da2](https://github.com/Metronome-Industries/metronome-ruby/commit/f076da2387c85f5e4f94c2b9a5f0ab279a778c92))
+* **api:** improve Event Search API documentation and rate limiting details ([e8618a3](https://github.com/Metronome-Industries/metronome-ruby/commit/e8618a3b86ec4d9e19df9dd24f5381288071313e))
+* **api:** improve previewEvents API documentation and make custom_credit_type_id nullable ([12c5814](https://github.com/Metronome-Industries/metronome-ruby/commit/12c5814b48b6bf441c5b6b8a22adb683c185c007))
+* **api:** add custom credit type support to prepaid balance thresholds ([1b75766](https://github.com/Metronome-Industries/metronome-ruby/commit/1b75766b321ca146dd911c56c47bf286f928f550))
+* **api:** add Event Search API ([8065b4c](https://github.com/Metronome-Industries/metronome-ruby/commit/8065b4c8053818b19a40faf3dc99e17396d1f546))
+* **api:** remove Event Search API and add contract priority field ([ae63c04](https://github.com/Metronome-Industries/metronome-ruby/commit/ae63c045c280949ba69c636c9ed25ea5942822ad))
+* **api:** add shared type aliases for commit/credit types ([2f8a188](https://github.com/Metronome-Industries/metronome-ruby/commit/2f8a18824b0f5b6455dce126799de441be282a78))
+* **api:** remove shared type aliases for commit/credit types ([e86a139](https://github.com/Metronome-Industries/metronome-ruby/commit/e86a139fca3e4b1919d8de7e1fb5841eb4835e3b))
+* **api:** add contract hierarchy configuration to shared types ([4a31b46](https://github.com/Metronome-Industries/metronome-ruby/commit/4a31b4636526937656b65c265e74119c1944fb82))
+* **api:** change recurring commit/credit access amount quantity field from required to optional ([2403df6](https://github.com/Metronome-Industries/metronome-ruby/commit/2403df68d460ddbdac8d0e5ef51c64b9d95a3029))
+* **api:** add sort parameter to credit grant list entries API ([a56f5cb](https://github.com/Metronome-Industries/metronome-ruby/commit/a56f5cb1a04d956a282e21e520e25855b45807a6))
+* **client:** add debug log helper ([fbc9042](https://github.com/Metronome-Industries/metronome-ruby/commit/fbc904277c1a3e96f3a0a03f3b2f65863802be2d))
+
+
+### Bug Fixes
+
+* `to_sorbet_type` should not return branded types ([9fda15f](https://github.com/Metronome-Industries/metronome-ruby/commit/9fda15fbb91924034acacadd4e4b88ba49bb9e61))
+* **ci:** release-doctor — report correct token name ([ea3a4df](https://github.com/Metronome-Industries/metronome-ruby/commit/ea3a4dfc3c361601f10d7bf0bf9e8472404a413b))
+* default content-type for text in multi-part formdata uploads should be text/plain ([c566bfd](https://github.com/Metronome-Industries/metronome-ruby/commit/c566bfd18faba7624ccf41b9275ecfa2610c40ed))
+* issue where we cannot mutate arrays on base model derivatives ([8020ba8](https://github.com/Metronome-Industries/metronome-ruby/commit/8020ba8df6fbdb8362dd00223ad360a93acc0666))
+
+
+### Chores
+
+* **ci:** enable for pull requests ([0dbe09f](https://github.com/Metronome-Industries/metronome-ruby/commit/0dbe09f41e8b56a873bcf1151ab5dff3a39a2d30))
+* **ci:** link to correct github repo ([ca6bdf8](https://github.com/Metronome-Industries/metronome-ruby/commit/ca6bdf8a4edfe037c672b8e1fc4a800656391a49))
+* **ci:** only run for pushes and fork pull requests ([e21f43c](https://github.com/Metronome-Industries/metronome-ruby/commit/e21f43ca4d03f0246693dc04393c2f82391d617a))
+* **internal:** allow streams to also be unwrapped on a per-row basis ([b40d49a](https://github.com/Metronome-Industries/metronome-ruby/commit/b40d49a3e3915cc4bb47ebdcebac5e139ad7f07b))
+* **internal:** version bump ([c50a620](https://github.com/Metronome-Industries/metronome-ruby/commit/c50a620ff8154b422aeb80e827986f28eded7da5))
+
 ## 0.1.0-alpha.3 (2025-05-30)
 
 Full Changelog: [v0.1.0-alpha.2...v0.1.0-alpha.3](https://github.com/Metronome-Industries/metronome-ruby/compare/v0.1.0-alpha.2...v0.1.0-alpha.3)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "metronome-sdk", "~> 0.1.0.pre.alpha.3"
+gem "metronome-sdk", "~> 0.1.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/metronome_sdk/errors.rb

@@ -9,6 +9,28 @@ module MetronomeSDK
     end
 
     class ConversionError < MetronomeSDK::Errors::Error
+      # @return [StandardError, nil]
+      def cause = @cause.nil? ? super : @cause
+
+      # @api private
+      #
+      # @param on [Class<StandardError>]
+      # @param method [Symbol]
+      # @param target [Object]
+      # @param value [Object]
+      # @param cause [StandardError, nil]
+      def initialize(on:, method:, target:, value:, cause: nil)
+        cls = on.name.split("::").last
+
+        message = [
+          "Failed to parse #{cls}.#{method} from #{value.class} to #{target.inspect}.",
+          "To get the unparsed API response, use #{cls}[#{method.inspect}].",
+          cause && "Cause: #{cause.message}"
+        ].filter(&:itself).join(" ")
+
+        @cause = cause
+        super(message)
+      end
     end
 
     class APIError < MetronomeSDK::Errors::Error

data/lib/metronome_sdk/internal/cursor_page.rb

@@ -24,7 +24,7 @@ module MetronomeSDK
 
       # @return [Boolean]
       def next_page?
-        !data.to_a.empty? && !next_page_.to_s.empty?
+        !next_page_.to_s.empty?
       end
 
       # @raise [MetronomeSDK::HTTP::Error]

data/lib/metronome_sdk/internal/transport/base_client.rb

@@ -474,6 +474,7 @@ module MetronomeSDK
           self.class.validate!(req)
           model = req.fetch(:model) { MetronomeSDK::Internal::Type::Unknown }
           opts = req[:options].to_h
+          unwrap = req[:unwrap]
           MetronomeSDK::RequestOptions.validate!(opts)
           request = build_request(req.except(:options), opts)
           url = request.fetch(:url)
@@ -490,11 +491,18 @@ module MetronomeSDK
           decoded = MetronomeSDK::Internal::Util.decode_content(response, stream: stream)
           case req
           in {stream: Class => st}
-            st.new(model: model, url: url, status: status, response: response, stream: decoded)
+            st.new(
+              model: model,
+              url: url,
+              status: status,
+              response: response,
+              unwrap: unwrap,
+              stream: decoded
+            )
           in {page: Class => page}
             page.new(client: self, req: req, headers: response, page_data: decoded)
           else
-            unwrapped = MetronomeSDK::Internal::Util.dig(decoded, req[:unwrap])
+            unwrapped = MetronomeSDK::Internal::Util.dig(decoded, unwrap)
             MetronomeSDK::Internal::Type::Converter.coerce(model, unwrapped)
           end
         end

data/lib/metronome_sdk/internal/type/array_of.rb

@@ -62,10 +62,14 @@ module MetronomeSDK
         #
         # @param state [Hash{Symbol=>Object}] .
         #
-        #   @option state [Boolean, :strong] :strictness
+        #   @option state [Boolean] :translate_names
+        #
+        #   @option state [Boolean] :strictness
         #
         #   @option state [Hash{Symbol=>Object}] :exactness
         #
+        #   @option state [Class<StandardError>] :error
+        #
         #   @option state [Integer] :branched
         #
         # @return [Array<Object>, Object]
@@ -74,6 +78,7 @@ module MetronomeSDK
 
           unless value.is_a?(Array)
             exactness[:no] += 1
+            state[:error] = TypeError.new("#{value.class} can't be coerced into #{Array}")
             return value
           end
 

data/lib/metronome_sdk/internal/type/base_model.rb

@@ -60,7 +60,7 @@ module MetronomeSDK
                 [MetronomeSDK::Internal::Type::Converter.type_info(type_info), type_info]
               end
 
-            setter = "#{name_sym}="
+            setter = :"#{name_sym}="
             api_name = info.fetch(:api_name, name_sym)
             nilable = info.fetch(:nil?, false)
             const = if required && !nilable
@@ -84,28 +84,61 @@ module MetronomeSDK
                 type_fn: type_fn
               }
 
-            define_method(setter) { @data.store(name_sym, _1) }
+            define_method(setter) do |value|
+              target = type_fn.call
+              state = MetronomeSDK::Internal::Type::Converter.new_coerce_state(translate_names: false)
+              coerced = MetronomeSDK::Internal::Type::Converter.coerce(target, value, state: state)
+              status = @coerced.store(name_sym, state.fetch(:error) || true)
+              stored =
+                case [target, status]
+                in [MetronomeSDK::Internal::Type::Converter | Symbol, true]
+                  coerced
+                else
+                  value
+                end
+              @data.store(name_sym, stored)
+            end
 
+            # rubocop:disable Style/CaseEquality
+            # rubocop:disable Metrics/BlockLength
             define_method(name_sym) do
               target = type_fn.call
-              value = @data.fetch(name_sym) { const == MetronomeSDK::Internal::OMIT ? nil : const }
-              state = {strictness: :strong, exactness: {yes: 0, no: 0, maybe: 0}, branched: 0}
-              if (nilable || !required) && value.nil?
-                nil
-              else
-                MetronomeSDK::Internal::Type::Converter.coerce(
-                  target, value, state: state
+
+              case @coerced[name_sym]
+              in true | false if MetronomeSDK::Internal::Type::Converter === target
+                @data.fetch(name_sym)
+              in ::StandardError => e
+                raise MetronomeSDK::Errors::ConversionError.new(
+                  on: self.class,
+                  method: __method__,
+                  target: target,
+                  value: @data.fetch(name_sym),
+                  cause: e
                 )
+              else
+                Kernel.then do
+                  value = @data.fetch(name_sym) { const == MetronomeSDK::Internal::OMIT ? nil : const }
+                  state = MetronomeSDK::Internal::Type::Converter.new_coerce_state(translate_names: false)
+                  if (nilable || !required) && value.nil?
+                    nil
+                  else
+                    MetronomeSDK::Internal::Type::Converter.coerce(
+                      target, value, state: state
+                    )
+                  end
+                rescue StandardError => e
+                  raise MetronomeSDK::Errors::ConversionError.new(
+                    on: self.class,
+                    method: __method__,
+                    target: target,
+                    value: value,
+                    cause: e
+                  )
+                end
               end
-            rescue StandardError => e
-              cls = self.class.name.split("::").last
-              message = [
-                "Failed to parse #{cls}.#{__method__} from #{value.class} to #{target.inspect}.",
-                "To get the unparsed API response, use #{cls}[#{__method__.inspect}].",
-                "Cause: #{e.message}"
-              ].join(" ")
-              raise MetronomeSDK::Errors::ConversionError.new(message)
             end
+            # rubocop:enable Metrics/BlockLength
+            # rubocop:enable Style/CaseEquality
           end
 
           # @api private
@@ -205,23 +238,28 @@ module MetronomeSDK
           #
           # @param state [Hash{Symbol=>Object}] .
           #
-          #   @option state [Boolean, :strong] :strictness
+          #   @option state [Boolean] :translate_names
+          #
+          #   @option state [Boolean] :strictness
           #
           #   @option state [Hash{Symbol=>Object}] :exactness
           #
+          #   @option state [Class<StandardError>] :error
+          #
           #   @option state [Integer] :branched
           #
           # @return [self, Object]
           def coerce(value, state:)
             exactness = state.fetch(:exactness)
 
-            if value.is_a?(self.class)
+            if value.is_a?(self)
               exactness[:yes] += 1
               return value
             end
 
             unless (val = MetronomeSDK::Internal::Util.coerce_hash(value)).is_a?(Hash)
               exactness[:no] += 1
+              state[:error] = TypeError.new("#{value.class} can't be coerced into #{Hash}")
               return value
             end
             exactness[:yes] += 1
@@ -229,13 +267,15 @@ module MetronomeSDK
             keys = val.keys.to_set
             instance = new
             data = instance.to_h
+            status = instance.instance_variable_get(:@coerced)
 
             # rubocop:disable Metrics/BlockLength
             fields.each do |name, field|
               mode, required, target = field.fetch_values(:mode, :required, :type)
               api_name, nilable, const = field.fetch_values(:api_name, :nilable, :const)
+              src_name = state.fetch(:translate_names) ? api_name : name
 
-              unless val.key?(api_name)
+              unless val.key?(src_name)
                 if required && mode != :dump && const == MetronomeSDK::Internal::OMIT
                   exactness[nilable ? :maybe : :no] += 1
                 else
@@ -244,9 +284,10 @@ module MetronomeSDK
                 next
               end
 
-              item = val.fetch(api_name)
-              keys.delete(api_name)
+              item = val.fetch(src_name)
+              keys.delete(src_name)
 
+              state[:error] = nil
               converted =
                 if item.nil? && (nilable || !required)
                   exactness[nilable ? :yes : :maybe] += 1
@@ -260,6 +301,8 @@ module MetronomeSDK
                     item
                   end
                 end
+
+              status.store(name, state.fetch(:error) || true)
               data.store(name, converted)
             end
             # rubocop:enable Metrics/BlockLength
@@ -400,9 +443,11 @@ module MetronomeSDK
         # @return [Hash{Symbol=>Object}]
         #
         # @example
-        #   # `contract_retrieve_response` is a `MetronomeSDK::Models::V2::ContractRetrieveResponse`
-        #   contract_retrieve_response => {
-        #     data: data
+        #   # `base_usage_filter` is a `MetronomeSDK::BaseUsageFilter`
+        #   base_usage_filter => {
+        #     group_key: group_key,
+        #     group_values: group_values,
+        #     starting_at: starting_at
         #   }
         def deconstruct_keys(keys)
           (keys || self.class.known_fields.keys)
@@ -433,7 +478,18 @@ module MetronomeSDK
         # Create a new instance of a model.
         #
         # @param data [Hash{Symbol=>Object}, self]
-        def initialize(data = {}) = (@data = MetronomeSDK::Internal::Util.coerce_hash!(data).to_h)
+        def initialize(data = {})
+          @data = {}
+          @coerced = {}
+          MetronomeSDK::Internal::Util.coerce_hash!(data).each do
+            if self.class.known_fields.key?(_1)
+              public_send(:"#{_1}=", _2)
+            else
+              @data.store(_1, _2)
+              @coerced.store(_1, false)
+            end
+          end
+        end
 
         class << self
           # @api private

data/lib/metronome_sdk/internal/type/boolean.rb

@@ -31,14 +31,20 @@ module MetronomeSDK
         class << self
           # @api private
           #
+          # Coerce value to Boolean if possible, otherwise return the original value.
+          #
           # @param value [Boolean, Object]
           #
           # @param state [Hash{Symbol=>Object}] .
           #
-          #   @option state [Boolean, :strong] :strictness
+          #   @option state [Boolean] :translate_names
+          #
+          #   @option state [Boolean] :strictness
           #
           #   @option state [Hash{Symbol=>Object}] :exactness
           #
+          #   @option state [Class<StandardError>] :error
+          #
           #   @option state [Integer] :branched
           #
           # @return [Boolean, Object]

data/lib/metronome_sdk/internal/type/converter.rb

@@ -15,10 +15,14 @@ module MetronomeSDK
         #
         # @param state [Hash{Symbol=>Object}] .
         #
-        #   @option state [Boolean, :strong] :strictness
+        #   @option state [Boolean] :translate_names
+        #
+        #   @option state [Boolean] :strictness
         #
         #   @option state [Hash{Symbol=>Object}] :exactness
         #
+        #   @option state [Class<StandardError>] :error
+        #
         #   @option state [Integer] :branched
         #
         # @return [Object]
@@ -94,6 +98,21 @@ module MetronomeSDK
             end
           end
 
+          # @api private
+          #
+          # @param translate_names [Boolean]
+          #
+          # @return [Hash{Symbol=>Object}]
+          def new_coerce_state(translate_names: true)
+            {
+              translate_names: translate_names,
+              strictness: true,
+              exactness: {yes: 0, no: 0, maybe: 0},
+              error: nil,
+              branched: 0
+            }
+          end
+
           # @api private
           #
           # Based on `target`, transform `value` into `target`, to the extent possible:
@@ -110,14 +129,11 @@ module MetronomeSDK
           #
           # @param value [Object]
           #
-          # @param state [Hash{Symbol=>Object}] The `strictness` is one of `true`, `false`, or `:strong`. This informs the
-          # coercion strategy when we have to decide between multiple possible conversion
-          # targets:
+          # @param state [Hash{Symbol=>Object}] 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
@@ -130,21 +146,20 @@ module MetronomeSDK
           #
           # See implementation below for more details.
           #
-          #   @option state [Boolean, :strong] :strictness
+          #   @option state [Boolean] :translate_names
+          #
+          #   @option state [Boolean] :strictness
           #
           #   @option state [Hash{Symbol=>Object}] :exactness
           #
+          #   @option state [Class<StandardError>] :error
+          #
           #   @option state [Integer] :branched
           #
           # @return [Object]
-          def coerce(
-            target,
-            value,
-            state: {strictness: true, exactness: {yes: 0, no: 0, maybe: 0}, branched: 0}
-          )
-            # rubocop:disable Lint/SuppressedException
+          def coerce(target, value, state: MetronomeSDK::Internal::Type::Converter.new_coerce_state)
             # rubocop:disable Metrics/BlockNesting
-            strictness, exactness = state.fetch_values(:strictness, :exactness)
+            exactness = state.fetch(:exactness)
 
             case target
             in MetronomeSDK::Internal::Type::Converter
@@ -160,29 +175,26 @@ module MetronomeSDK
                 exactness[value.nil? ? :yes : :maybe] += 1
                 return nil
               in -> { _1 <= Integer }
-                if value.is_a?(Integer)
+                case value
+                in Integer
                   exactness[:yes] += 1
                   return value
-                elsif strictness == :strong && Integer(value, exception: false) != value
-                  message = "no implicit conversion of #{value.class} into #{target.inspect}"
-                  raise value.is_a?(Numeric) ? ArgumentError.new(message) : TypeError.new(message)
                 else
                   Kernel.then do
                     return Integer(value).tap { exactness[:maybe] += 1 }
-                  rescue ArgumentError, TypeError
+                  rescue ArgumentError, TypeError => e
+                    state[:error] = e
                   end
                 end
               in -> { _1 <= Float }
                 if value.is_a?(Numeric)
                   exactness[:yes] += 1
                   return Float(value)
-                elsif strictness == :strong
-                  message = "no implicit conversion of #{value.class} into #{target.inspect}"
-                  raise TypeError.new(message)
                 else
                   Kernel.then do
                     return Float(value).tap { exactness[:maybe] += 1 }
-                  rescue ArgumentError, TypeError
+                  rescue ArgumentError, TypeError => e
+                    state[:error] = e
                   end
                 end
               in -> { _1 <= String }
@@ -194,16 +206,13 @@ module MetronomeSDK
                   exactness[:yes] += 1
                   return value.string
                 else
-                  if strictness == :strong
-                    message = "no implicit conversion of #{value.class} into #{target.inspect}"
-                    raise TypeError.new(message)
-                  end
+                  state[:error] = TypeError.new("#{value.class} can't be coerced into #{String}")
                 end
               in -> { _1 <= Date || _1 <= Time }
                 Kernel.then do
                   return target.parse(value).tap { exactness[:yes] += 1 }
                 rescue ArgumentError, TypeError => e
-                  raise e if strictness == :strong
+                  state[:error] = e
                 end
               in -> { _1 <= StringIO } if value.is_a?(String)
                 exactness[:yes] += 1
@@ -221,10 +230,8 @@ module MetronomeSDK
                   return value
                 end
               else
-                if strictness == :strong
-                  message = "cannot convert non-matching #{value.class} into #{target.inspect}"
-                  raise ArgumentError.new(message)
-                end
+                message = "cannot convert non-matching #{value.class} into #{target.inspect}"
+                state[:error] = ArgumentError.new(message)
               end
             else
             end
@@ -232,7 +239,6 @@ module MetronomeSDK
             exactness[:no] += 1
             value
             # rubocop:enable Metrics/BlockNesting
-            # rubocop:enable Lint/SuppressedException
           end
 
           # @api private
@@ -277,8 +283,10 @@ module MetronomeSDK
         define_sorbet_constant!(:CoerceState) do
           T.type_alias do
             {
-              strictness: T.any(T::Boolean, Symbol),
+              translate_names: T::Boolean,
+              strictness: T::Boolean,
               exactness: {yes: Integer, no: Integer, maybe: Integer},
+              error: T::Class[StandardError],
               branched: Integer
             }
           end

data/lib/metronome_sdk/internal/type/enum.rb

@@ -56,10 +56,14 @@ module MetronomeSDK
         #
         # @param state [Hash{Symbol=>Object}] .
         #
-        #   @option state [Boolean, :strong] :strictness
+        #   @option state [Boolean] :translate_names
+        #
+        #   @option state [Boolean] :strictness
         #
         #   @option state [Hash{Symbol=>Object}] :exactness
         #
+        #   @option state [Class<StandardError>] :error
+        #
         #   @option state [Integer] :branched
         #
         # @return [Symbol, Object]
@@ -70,8 +74,12 @@ module MetronomeSDK
           if values.include?(val)
             exactness[:yes] += 1
             val
+          elsif values.first&.class == val.class
+            exactness[:maybe] += 1
+            value
           else
-            exactness[values.first&.class == val.class ? :maybe : :no] += 1
+            exactness[:no] += 1
+            state[:error] = TypeError.new("#{value.class} can't be coerced into #{self}")
             value
           end
         end
@@ -91,11 +99,14 @@ module MetronomeSDK
         #
         # @return [Object]
         def to_sorbet_type
-          case values
+          types = values.map { MetronomeSDK::Internal::Util::SorbetRuntimeSupport.to_sorbet_type(_1) }.uniq
+          case types
           in []
             T.noreturn
-          in [value, *_]
-            T.all(MetronomeSDK::Internal::Util::SorbetRuntimeSupport.to_sorbet_type(value), self)
+          in [type]
+            type
+          else
+            T.any(*types)
           end
         end
 

data/lib/metronome_sdk/internal/type/file_input.rb

@@ -45,10 +45,14 @@ module MetronomeSDK
           #
           # @param state [Hash{Symbol=>Object}] .
           #
-          #   @option state [Boolean, :strong] :strictness
+          #   @option state [Boolean] :translate_names
+          #
+          #   @option state [Boolean] :strictness
           #
           #   @option state [Hash{Symbol=>Object}] :exactness
           #
+          #   @option state [Class<StandardError>] :error
+          #
           #   @option state [Integer] :branched
           #
           # @return [StringIO, Object]
@@ -62,6 +66,7 @@ module MetronomeSDK
               exactness[:yes] += 1
               value
             else
+              state[:error] = TypeError.new("#{value.class} can't be coerced into #{StringIO}")
               exactness[:no] += 1
               value
             end

data/lib/metronome_sdk/internal/type/hash_of.rb

@@ -77,10 +77,14 @@ module MetronomeSDK
         #
         # @param state [Hash{Symbol=>Object}] .
         #
-        #   @option state [Boolean, :strong] :strictness
+        #   @option state [Boolean] :translate_names
+        #
+        #   @option state [Boolean] :strictness
         #
         #   @option state [Hash{Symbol=>Object}] :exactness
         #
+        #   @option state [Class<StandardError>] :error
+        #
         #   @option state [Integer] :branched
         #
         # @return [Hash{Symbol=>Object}, Object]
@@ -89,6 +93,7 @@ module MetronomeSDK
 
           unless value.is_a?(Hash)
             exactness[:no] += 1
+            state[:error] = TypeError.new("#{value.class} can't be coerced into #{Hash}")
             return value
           end