metronome-sdk 0.1.0.pre.alpha.1 → 0.1.0.pre.alpha.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a881fed2cf5ff5c2eabfc23eb2d229ec29288933edd7d3cbb2267d61e27096b
-  data.tar.gz: 28ce7dc9da20e9cb577dff3380d16bc071eb4bd2789ae5e3a67274fca31e8e0a
+  metadata.gz: b49fbb83290c83ee3d66cd3b2e5ae7e8055f745b97f8d1ab14ece932b89a23e0
+  data.tar.gz: 526a11304c8b163141bd09f107dc6a2e32c9c992549b5b521cad8c3229407a14
 SHA512:
-  metadata.gz: 4b557ed8d9c7de4e7a764937bedfeb25e5a26c6d9f6b68610b133bebab463cf0d943f8f5d37018e296415208c85bae92002244b7e6f3943e64b162f05c7c33fe
-  data.tar.gz: 3a2b97a7b75f283fc5f1468fb3bcbfbbf1a3d530f13105fcb9b80e37950c5b473946fd877e7a8801d476521c4c0ad2e567a2c4c2d8854f20fc73cef9161185a4
+  metadata.gz: fb6e5add40c34fc28319a79a8cf445a2e770a8d523bbeebdd89e7047fcb683658dcaa3775a52e94c5dc00032594e3ca254e077b3164fad2669691123c4944ab4
+  data.tar.gz: aacf5f90cddbb3756686efb8873d992f6df59fc6012bfcb2d770f0297eec754adaddfc82ef1960e948a93e594fda30f228e78caada919724f9f0774fd2bb371a

data/CHANGELOG.md

@@ -1,5 +1,57 @@
 # Changelog
 
+## 0.1.0-alpha.2 (2025-05-14)
+
+Full Changelog: [v0.1.0-alpha.1...v0.1.0-alpha.2](https://github.com/Metronome-Industries/metronome-ruby/compare/v0.1.0-alpha.1...v0.1.0-alpha.2)
+
+### Features
+
+* **api:** api update ([a4f836d](https://github.com/Metronome-Industries/metronome-ruby/commit/a4f836d0ae211f507a54922859668ff35f94ce8e))
+* **api:** api update ([688aade](https://github.com/Metronome-Industries/metronome-ruby/commit/688aade989f1758a41c10b7f7fe7e45a58f698bd))
+* **api:** api update ([5ab431c](https://github.com/Metronome-Industries/metronome-ruby/commit/5ab431c2dc27ce3534f7d3afc3b4f5279438039d))
+* **api:** api update ([b2a6fc9](https://github.com/Metronome-Industries/metronome-ruby/commit/b2a6fc947c7b844733d8064ec0e69997aeee34ce))
+* **api:** api update ([01b3764](https://github.com/Metronome-Industries/metronome-ruby/commit/01b3764c3dcf27595b55098c751e1c2a93e5cfe5))
+* **api:** api update ([6046a6d](https://github.com/Metronome-Industries/metronome-ruby/commit/6046a6db516552be6164f54f3e810461a9c18bd1))
+* **api:** api update ([1aa390e](https://github.com/Metronome-Industries/metronome-ruby/commit/1aa390e7a464b8668e96574cf429b590ecc52914))
+* **api:** api update ([c03bee8](https://github.com/Metronome-Industries/metronome-ruby/commit/c03bee8d5f7c5b9db872275edf5b69f912be7e13))
+* **api:** api update ([9d59ec2](https://github.com/Metronome-Industries/metronome-ruby/commit/9d59ec25eed7f832cf734545fa50b3a5bd8c2bec))
+* **api:** api update ([2650244](https://github.com/Metronome-Industries/metronome-ruby/commit/26502443fad8129531a2a74dcd69593a1fa64823))
+* expose base client options as read only attributes ([4f569b2](https://github.com/Metronome-Industries/metronome-ruby/commit/4f569b2a9eee829bf49214da8f478f8588c600bb))
+* expose recursive `#to_h` conversion ([d780fc3](https://github.com/Metronome-Industries/metronome-ruby/commit/d780fc3aa31b3d1b9418d86626ca8366f9e9a6ce))
+* support sorbet aliases at the runtime ([9f251f3](https://github.com/Metronome-Industries/metronome-ruby/commit/9f251f3d72fe0032aa22feeed55417ac3ea87315))
+
+
+### Bug Fixes
+
+* **internal:** ensure formatting always uses c.utf-8 locale ([47ab8ad](https://github.com/Metronome-Industries/metronome-ruby/commit/47ab8ad4e70b382911b002a5d06c637ebb63e9f2))
+* **internal:** fix formatting script for macos ([cd28a47](https://github.com/Metronome-Industries/metronome-ruby/commit/cd28a47d72d6e2c0ca42348bb0851ce5d10a7c5b))
+* **internal:** update gemspec name ([1e9d5b2](https://github.com/Metronome-Industries/metronome-ruby/commit/1e9d5b242fb7a15182ce0908bc7dd2ce141f67e0))
+
+
+### Chores
+
+* accept all nd-json mimetype variants ([c8cc15c](https://github.com/Metronome-Industries/metronome-ruby/commit/c8cc15c35825ca171c9f831924d854bcf29a71f0))
+* always check if current page is empty in `next_page?` ([af6bc25](https://github.com/Metronome-Industries/metronome-ruby/commit/af6bc253a97f594f109516027a76fb3ae143a529))
+* fix misc linting / minor issues ([afd7f7c](https://github.com/Metronome-Industries/metronome-ruby/commit/afd7f7c2cd1ced12d750a19bb97c1789160d329b))
+* **internal:** codegen related update ([4c6b071](https://github.com/Metronome-Industries/metronome-ruby/commit/4c6b071f35043f8f449a489fb893f83103933afa))
+* **internal:** codegen related update ([ce299e2](https://github.com/Metronome-Industries/metronome-ruby/commit/ce299e225e9d43e7e7e55bfd057ffaa32d958368))
+* **internal:** codegen related update ([f5b8a2b](https://github.com/Metronome-Industries/metronome-ruby/commit/f5b8a2b7e65c01e6bffd12f2c505bf175309b197))
+* **internal:** codegen related update ([4e241c7](https://github.com/Metronome-Industries/metronome-ruby/commit/4e241c7c11c917708bca0abea5e9723922b3dc09))
+* loosen rubocop rules that don't always make sense ([f69c36b](https://github.com/Metronome-Industries/metronome-ruby/commit/f69c36bb3fac830b3142cfceab8bb190c3c47c4f))
+* migrate away from deprecated `JSON#fast_generate` ([8b10970](https://github.com/Metronome-Industries/metronome-ruby/commit/8b109703a565463d836b639dc1bd8770dfd4d650))
+* re-export top level models under library namespace ([2498d75](https://github.com/Metronome-Industries/metronome-ruby/commit/2498d75c53a4aa16a05dd1776d2d1d2ca8c14815))
+* remove Gemfile.lock during bootstrap ([459e324](https://github.com/Metronome-Industries/metronome-ruby/commit/459e324ac0108b3bc68e8c0a173e36dcd0242019))
+* reorganize type aliases ([bc60bc8](https://github.com/Metronome-Industries/metronome-ruby/commit/bc60bc83989da9809c45477034015c6e993e5827))
+* revert ignoring Gemfile.lock ([51f355e](https://github.com/Metronome-Industries/metronome-ruby/commit/51f355ec8087755200d92f1c499ee694d187288d))
+* validate request option coercion correctness ([940e426](https://github.com/Metronome-Industries/metronome-ruby/commit/940e4261d5730dc65821703c5bb64971331f4be4))
+
+
+### Documentation
+
+* illustrate environmental defaults for auth variables ([731c295](https://github.com/Metronome-Industries/metronome-ruby/commit/731c2954a9fa2c3b60f6243a02b0afdefaf738c4))
+* **readme:** fix typo ([c88281b](https://github.com/Metronome-Industries/metronome-ruby/commit/c88281b645e5f0c4cd1ec042cb8a4db0f83c156c))
+* remove or fix invalid readme examples ([780d102](https://github.com/Metronome-Industries/metronome-ruby/commit/780d10248cd977d4d7cb6c5d99f3e60db5716ef0))
+
 ## 0.1.0-alpha.1 (2025-04-28)
 
 Full Changelog: [v0.0.1-alpha.0...v0.1.0-alpha.1](https://github.com/Metronome-Industries/metronome-ruby/compare/v0.0.1-alpha.0...v0.1.0-alpha.1)

data/README.md

@@ -1,6 +1,6 @@
 # Metronome Ruby API library
 
-The Metronome Ruby library provides convenient access to the Metronome REST API from any Ruby 3.1.0+ application.
+The Metronome Ruby library provides convenient access to the Metronome REST API from any Ruby 3.2.0+ application.
 
 It is generated with [Stainless](https://www.stainless.com/).
 
@@ -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.1"
+gem "metronome-sdk", "~> 0.1.0.pre.alpha.2"
 ```
 
 <!-- x-release-please-end -->
@@ -29,7 +29,7 @@ require "bundler/setup"
 require "metronome_sdk"
 
 metronome = MetronomeSDK::Client.new(
-  bearer_token: "My Bearer Token" # defaults to ENV["METRONOME_BEARER_TOKEN"]
+  bearer_token: ENV["METRONOME_BEARER_TOKEN"] # This is the default and can be omitted
 )
 
 result = metronome.v1.usage.ingest(
@@ -56,7 +56,7 @@ When using sorbet, it is recommended to use model classes as below. This provide
 ```ruby
 metronome.v1.usage.ingest(
   usage: [
-    MetronomeSDK::Models::V1::UsageIngestParams::Usage.new(
+    MetronomeSDK::V1::UsageIngestParams::Usage.new(
       transaction_id: "90e9401f-0f8c-4cd3-9a9f-d6beb56d8d72",
       customer_id: "team@example.com",
       event_type: "heartbeat",
@@ -92,13 +92,16 @@ When the library is unable to connect to the API, or if the API returns a non-su
 
 ```ruby
 begin
-  contract = metronome.v1.contracts.create
+  contract = metronome.v1.contracts.create(
+    customer_id: "13117714-3f05-48e5-a6e9-a66093f13b4d",
+    starting_at: "2020-01-01T00:00:00.000Z"
+  )
 rescue MetronomeSDK::Errors::APIError => e
   puts(e.status) # 400
 end
 ```
 
-Error codes are as followed:
+Error codes are as follows:
 
 | Cause            | Error Type                 |
 | ---------------- | -------------------------- |
@@ -129,7 +132,11 @@ metronome = MetronomeSDK::Client.new(
 )
 
 # Or, configure per-request:
-metronome.v1.contracts.create(request_options: {max_retries: 5})
+metronome.v1.contracts.create(
+  customer_id: "13117714-3f05-48e5-a6e9-a66093f13b4d",
+  starting_at: "2020-01-01T00:00:00.000Z",
+  request_options: {max_retries: 5}
+)
 ```
 
 ### Timeouts
@@ -147,7 +154,11 @@ metronome = MetronomeSDK::Client.new(
 )
 
 # Or, configure per-request:
-metronome.v1.contracts.create(request_options: {timeout: 5})
+metronome.v1.contracts.create(
+  customer_id: "13117714-3f05-48e5-a6e9-a66093f13b4d",
+  starting_at: "2020-01-01T00:00:00.000Z",
+  request_options: {timeout: 5}
+)
 ```
 
 ## Model DSL
@@ -162,7 +173,7 @@ In all places where a `BaseModel` type is specified, vanilla Ruby `Hash` can als
 # This has tooling readability, for auto-completion, static analysis, and goto definition with supported language services
 params = MetronomeSDK::Models::V1::UsageIngestParams.new(
   usage: [
-    MetronomeSDK::Models::V1::UsageIngestParams::Usage.new(
+    MetronomeSDK::V1::UsageIngestParams::Usage.new(
       transaction_id: "90e9401f-0f8c-4cd3-9a9f-d6beb56d8d72",
       customer_id: "team@example.com",
       event_type: "heartbeat",
@@ -231,7 +242,7 @@ It is possible to pass a compatible model / parameter class to a method that exp
 ```ruby
 params = MetronomeSDK::Models::V1::UsageIngestParams.new(
   usage: [
-    MetronomeSDK::Models::V1::UsageIngestParams::Usage.new(
+    MetronomeSDK::V1::UsageIngestParams::Usage.new(
       transaction_id: "90e9401f-0f8c-4cd3-9a9f-d6beb56d8d72",
       customer_id: "team@example.com",
       event_type: "heartbeat",
@@ -251,7 +262,7 @@ This package considers improvements to the (non-runtime) `*.rbi` and `*.rbs` typ
 
 ## Requirements
 
-Ruby 3.1.0 or higher.
+Ruby 3.2.0 or higher.
 
 ## Contributing
 

data/lib/metronome_sdk/errors.rb

@@ -99,7 +99,7 @@ module MetronomeSDK
       # @param response [nil]
       # @param message [String, nil]
       #
-      # @return [MetronomeSDK::Errors::APIStatusError]
+      # @return [self]
       def self.for(url:, status:, body:, request:, response:, message: nil)
         kwargs = {
           url: url,

data/lib/metronome_sdk/file_part.rb

@@ -45,9 +45,9 @@ module MetronomeSDK
       @filename =
         case content
         in Pathname
-          filename.nil? ? content.basename.to_path : File.basename(filename)
+          filename.nil? ? content.basename.to_path : ::File.basename(filename)
         else
-          filename.nil? ? nil : File.basename(filename)
+          filename.nil? ? nil : ::File.basename(filename)
         end
       @content_type = content_type
     end

data/lib/metronome_sdk/internal/cursor_page.rb

@@ -24,7 +24,7 @@ module MetronomeSDK
 
       # @return [Boolean]
       def next_page?
-        !next_page_.nil?
+        !data.to_a.empty? && !next_page_.to_s.empty?
       end
 
       # @raise [MetronomeSDK::HTTP::Error]
@@ -67,8 +67,8 @@ module MetronomeSDK
 
         @next_page_ = page_data[:next_page]
         case page_data
-        in {data: Array | nil => data}
-          @data = data&.map { MetronomeSDK::Internal::Type::Converter.coerce(@model, _1) }
+        in {data: Array => data}
+          @data = data.map { MetronomeSDK::Internal::Type::Converter.coerce(@model, _1) }
         else
         end
       end

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

@@ -7,6 +7,8 @@ module MetronomeSDK
       #
       # @abstract
       class BaseClient
+        extend MetronomeSDK::Internal::Util::SorbetRuntimeSupport
+
         # from whatwg fetch spec
         MAX_REDIRECTS = 20
 
@@ -151,6 +153,27 @@ module MetronomeSDK
           end
         end
 
+        # @return [URI::Generic]
+        attr_reader :base_url
+
+        # @return [Float]
+        attr_reader :timeout
+
+        # @return [Integer]
+        attr_reader :max_retries
+
+        # @return [Float]
+        attr_reader :initial_retry_delay
+
+        # @return [Float]
+        attr_reader :max_retry_delay
+
+        # @return [Hash{String=>String}]
+        attr_reader :headers
+
+        # @return [String, nil]
+        attr_reader :idempotency_header
+
         # @api private
         # @return [MetronomeSDK::Internal::Transport::PooledNetRequester]
         attr_reader :requester
@@ -182,10 +205,11 @@ module MetronomeSDK
             },
             headers
           )
-          @base_url = MetronomeSDK::Internal::Util.parse_uri(base_url)
+          @base_url_components = MetronomeSDK::Internal::Util.parse_uri(base_url)
+          @base_url = MetronomeSDK::Internal::Util.unparse_uri(@base_url_components)
           @idempotency_header = idempotency_header&.to_s&.downcase
-          @max_retries = max_retries
           @timeout = timeout
+          @max_retries = max_retries
           @initial_retry_delay = initial_retry_delay
           @max_retry_delay = max_retry_delay
         end
@@ -261,7 +285,7 @@ module MetronomeSDK
             headers["x-stainless-retry-count"] = "0"
           end
 
-          timeout = opts.fetch(:timeout, @timeout).to_f.clamp((0..))
+          timeout = opts.fetch(:timeout, @timeout).to_f.clamp(0..)
           unless headers.key?("x-stainless-timeout") || timeout.zero?
             headers["x-stainless-timeout"] = timeout.to_s
           end
@@ -276,10 +300,14 @@ module MetronomeSDK
               MetronomeSDK::Internal::Util.deep_merge(*[req[:body], opts[:extra_body]].compact)
             end
 
+          url = MetronomeSDK::Internal::Util.join_parsed_uri(
+            @base_url_components,
+            {**req, path: path, query: query}
+          )
           headers, encoded = MetronomeSDK::Internal::Util.encode_content(headers, body)
           {
             method: method,
-            url: MetronomeSDK::Internal::Util.join_parsed_uri(@base_url, {**req, path: path, query: query}),
+            url: url,
             headers: headers,
             body: encoded,
             max_retries: opts.fetch(:max_retries, @max_retries),
@@ -461,9 +489,9 @@ module MetronomeSDK
 
           decoded = MetronomeSDK::Internal::Util.decode_content(response, stream: stream)
           case req
-          in { stream: Class => st }
+          in {stream: Class => st}
             st.new(model: model, url: url, status: status, response: response, stream: decoded)
-          in { page: Class => page }
+          in {page: Class => page}
             page.new(client: self, req: req, headers: response, page_data: decoded)
           else
             unwrapped = MetronomeSDK::Internal::Util.dig(decoded, req[:unwrap])
@@ -476,10 +504,54 @@ module MetronomeSDK
         # @return [String]
         def inspect
           # rubocop:disable Layout/LineLength
-          base_url = MetronomeSDK::Internal::Util.unparse_uri(@base_url)
-          "#<#{self.class.name}:0x#{object_id.to_s(16)} base_url=#{base_url} max_retries=#{@max_retries} timeout=#{@timeout}>"
+          "#<#{self.class.name}:0x#{object_id.to_s(16)} base_url=#{@base_url} max_retries=#{@max_retries} timeout=#{@timeout}>"
           # rubocop:enable Layout/LineLength
         end
+
+        define_sorbet_constant!(:RequestComponents) do
+          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[MetronomeSDK::Internal::Type::BasePage[MetronomeSDK::Internal::Type::BaseModel]]),
+              stream: T.nilable(T::Class[T.anything]),
+              model: T.nilable(MetronomeSDK::Internal::Type::Converter::Input),
+              options: T.nilable(MetronomeSDK::RequestOptions::OrHash)
+            }
+          end
+        end
+        define_sorbet_constant!(:RequestInput) do
+          T.type_alias do
+            {
+              method: Symbol,
+              url: URI::Generic,
+              headers: T::Hash[String, String],
+              body: T.anything,
+              max_retries: Integer,
+              timeout: Float
+            }
+          end
+        end
       end
     end
   end

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

@@ -5,6 +5,8 @@ module MetronomeSDK
     module Transport
       # @api private
       class PooledNetRequester
+        extend MetronomeSDK::Internal::Util::SorbetRuntimeSupport
+
         # from the golang stdlib
         # https://github.com/golang/go/blob/c8eced8580028328fde7c03cbfcb720ce15b2358/src/net/http/transport.go#L49
         KEEP_ALIVE_TIMEOUT = 30
@@ -187,6 +189,18 @@ module MetronomeSDK
           @size = size
           @pools = {}
         end
+
+        define_sorbet_constant!(:Request) do
+          T.type_alias do
+            {
+              method: Symbol,
+              url: URI::Generic,
+              headers: T::Hash[String, String],
+              body: T.anything,
+              deadline: Float
+            }
+          end
+        end
       end
     end
   end

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

@@ -29,7 +29,7 @@ module MetronomeSDK
         #
         #   @option spec [Boolean] :"nil?"
         #
-        # @return [MetronomeSDK::Internal::Type::ArrayOf]
+        # @return [self]
         def self.[](...) = new(...)
 
         # @api public

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

@@ -6,6 +6,7 @@ module MetronomeSDK
       # @abstract
       class BaseModel
         extend MetronomeSDK::Internal::Type::Converter
+        extend MetronomeSDK::Internal::Util::SorbetRuntimeSupport
 
         class << self
           # @api private
@@ -13,11 +14,17 @@ module MetronomeSDK
           # Assumes superclass fields are totally defined before fields are accessed /
           # defined on subclasses.
           #
-          # @return [Hash{Symbol=>Hash{Symbol=>Object}}]
-          def known_fields
-            @known_fields ||= (self < MetronomeSDK::Internal::Type::BaseModel ? superclass.known_fields.dup : {})
+          # @param child [Class<MetronomeSDK::Internal::Type::BaseModel>]
+          def inherited(child)
+            super
+            child.known_fields.replace(known_fields.dup)
           end
 
+          # @api private
+          #
+          # @return [Hash{Symbol=>Hash{Symbol=>Object}}]
+          def known_fields = @known_fields ||= {}
+
           # @api private
           #
           # @return [Hash{Symbol=>Hash{Symbol=>Object}}]
@@ -204,7 +211,7 @@ module MetronomeSDK
           #
           #   @option state [Integer] :branched
           #
-          # @return [MetronomeSDK::Internal::Type::BaseModel, Object]
+          # @return [self, Object]
           def coerce(value, state:)
             exactness = state.fetch(:exactness)
 
@@ -263,7 +270,7 @@ module MetronomeSDK
 
           # @api private
           #
-          # @param value [MetronomeSDK::Internal::Type::BaseModel, Object]
+          # @param value [self, Object]
           #
           # @param state [Hash{Symbol=>Object}] .
           #
@@ -304,6 +311,39 @@ module MetronomeSDK
           end
         end
 
+        class << self
+          # @api private
+          #
+          # @param model [MetronomeSDK::Internal::Type::BaseModel]
+          # @param convert [Boolean]
+          #
+          # @return [Hash{Symbol=>Object}]
+          def recursively_to_h(model, convert:)
+            rec = ->(x) do
+              case x
+              in MetronomeSDK::Internal::Type::BaseModel
+                if convert
+                  fields = x.class.known_fields
+                  x.to_h.to_h do |key, val|
+                    [key, rec.call(fields.key?(key) ? x.public_send(key) : val)]
+                  rescue MetronomeSDK::Errors::ConversionError
+                    [key, rec.call(val)]
+                  end
+                else
+                  rec.call(x.to_h)
+                end
+              in Hash
+                x.transform_values(&rec)
+              in Array
+                x.map(&rec)
+              else
+                x
+              end
+            end
+            rec.call(model)
+          end
+        end
+
         # @api public
         #
         # Returns the raw value associated with the given key, if found. Otherwise, nil is
@@ -340,6 +380,14 @@ module MetronomeSDK
 
         alias_method :to_hash, :to_h
 
+        # @api public
+        #
+        # In addition to the behaviour of `#to_h`, this method will recursively call
+        # `#to_h` on nested models.
+        #
+        # @return [Hash{Symbol=>Object}]
+        def deep_to_h = self.class.recursively_to_h(@data, convert: false)
+
         # @param keys [Array<Symbol>, nil]
         #
         # @return [Hash{Symbol=>Object}]
@@ -355,29 +403,6 @@ module MetronomeSDK
             .to_h
         end
 
-        class << self
-          # @api private
-          #
-          # @param model [MetronomeSDK::Internal::Type::BaseModel]
-          #
-          # @return [Hash{Symbol=>Object}]
-          def walk(model)
-            walk = ->(x) do
-              case x
-              in MetronomeSDK::Internal::Type::BaseModel
-                walk.call(x.to_h)
-              in Hash
-                x.transform_values(&walk)
-              in Array
-                x.map(&walk)
-              else
-                x
-              end
-            end
-            walk.call(model)
-          end
-        end
-
         # @api public
         #
         # @param a [Object]
@@ -395,15 +420,7 @@ module MetronomeSDK
         # Create a new instance of a model.
         #
         # @param data [Hash{Symbol=>Object}, self]
-        def initialize(data = {})
-          case MetronomeSDK::Internal::Util.coerce_hash(data)
-          in Hash => coerced
-            @data = coerced
-          else
-            message = "Expected a #{Hash} or #{MetronomeSDK::Internal::Type::BaseModel}, got #{data.inspect}"
-            raise ArgumentError.new(message)
-          end
-        end
+        def initialize(data = {}) = (@data = MetronomeSDK::Internal::Util.coerce_hash!(data).to_h)
 
         class << self
           # @api private
@@ -431,12 +448,19 @@ module MetronomeSDK
         # @api public
         #
         # @return [String]
-        def to_s = self.class.walk(@data).to_s
+        def to_s = deep_to_h.to_s
 
         # @api private
         #
         # @return [String]
-        def inspect = "#<#{self.class}:0x#{object_id.to_s(16)} #{self}>"
+        def inspect
+          converted = self.class.recursively_to_h(self, convert: true)
+          "#<#{self.class}:0x#{object_id.to_s(16)} #{converted}>"
+        end
+
+        define_sorbet_constant!(:KnownField) do
+          T.type_alias { {mode: T.nilable(Symbol), required: T::Boolean, nilable: T::Boolean} }
+        end
       end
     end
   end

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

@@ -5,6 +5,8 @@ module MetronomeSDK
     module Type
       # @api private
       module Converter
+        extend MetronomeSDK::Internal::Util::SorbetRuntimeSupport
+
         # rubocop:disable Lint/UnusedMethodArgument
 
         # @api private
@@ -268,6 +270,22 @@ module MetronomeSDK
             end
           end
         end
+
+        define_sorbet_constant!(:Input) do
+          T.type_alias { T.any(MetronomeSDK::Internal::Type::Converter, T::Class[T.anything]) }
+        end
+        define_sorbet_constant!(:CoerceState) do
+          T.type_alias do
+            {
+              strictness: T.any(T::Boolean, Symbol),
+              exactness: {yes: Integer, no: Integer, maybe: Integer},
+              branched: Integer
+            }
+          end
+        end
+        define_sorbet_constant!(:DumpState) do
+          T.type_alias { {can_retry: T::Boolean} }
+        end
       end
     end
   end

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

@@ -17,6 +17,7 @@ module MetronomeSDK
       # values safely.
       module Enum
         include MetronomeSDK::Internal::Type::Converter
+        include MetronomeSDK::Internal::Util::SorbetRuntimeSupport
 
         # All of the valid Symbol values for this enum.
         #

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

@@ -29,7 +29,7 @@ module MetronomeSDK
         #
         #   @option spec [Boolean] :"nil?"
         #
-        # @return [MetronomeSDK::Internal::Type::HashOf]
+        # @return [self]
         def self.[](...) = new(...)
 
         # @api public

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

@@ -5,10 +5,10 @@ module MetronomeSDK
     module Type
       # @api private
       module RequestParameters
-        # @!parse
-        #   # Options to specify HTTP behaviour for this request.
-        #   # @return [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}]
-        #   attr_accessor :request_options
+        # @!attribute request_options
+        # Options to specify HTTP behaviour for this request.
+        #
+        #   @return [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}]
 
         # @param mod [Module]
         def self.included(mod)
@@ -28,14 +28,8 @@ module MetronomeSDK
             state = {can_retry: true}
             case (dumped = dump(params, state: state))
             in Hash
-              options = MetronomeSDK::Internal::Util.coerce_hash(dumped[:request_options])
-              request_options =
-                case [options, state.fetch(:can_retry)]
-                in [Hash | nil, false]
-                  {**options.to_h, max_retries: 0}
-                else
-                  options
-                end
+              options = MetronomeSDK::Internal::Util.coerce_hash!(dumped[:request_options]).to_h
+              request_options = state.fetch(:can_retry) ? options : {**options, max_retries: 0}
               [dumped.except(:request_options), request_options]
             else
               [dumped, nil]

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

@@ -6,6 +6,7 @@ module MetronomeSDK
       # @api private
       module Union
         include MetronomeSDK::Internal::Type::Converter
+        include MetronomeSDK::Internal::Util::SorbetRuntimeSupport
 
         # @api private
         #