modern_treasury 0.1.0.pre.alpha.19 → 0.1.0.pre.alpha.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6adbdcc70b1ca7abcb20e29b504195c29d0367e3cc1f06b45a92078d8ee0d2df
-  data.tar.gz: 56381f0bd27eeac0802ea845012bb837b243a33105e8f38e82c91f5ef24c1308
+  metadata.gz: bd1003cb64621e98061d4ea560dfbbae6f3a45716922765fcca9e3041ac78f90
+  data.tar.gz: a1991e3bf60a3ac44bcd607c4777dafbdef7d6ecb3368f1808abd420bbf547c6
 SHA512:
-  metadata.gz: 4ceeabfe3d023fc8d86b90a64fc101007e8be2446455cc14c248a482ddfe8cbb7b3908896b6eb18fea08c48745fca6fa321425ff7286dc44c8213412da7588ff
-  data.tar.gz: 21958f8b0ff40115fe0df67c6e2d5524c76cb9c891194f07a347b3b25f17983e7c22aadcd2178fb4ca411cdafd1baa909d347c46d644b4664274e4b710b464f9
+  metadata.gz: 9864551a559538d8ea3e34bea4057e64f4d68d775458b822cfdaa5a696c08b1747a3e03e78be226b8d4019568a03356286aa569e432ae39808c3b7b05c06a2c9
+  data.tar.gz: 82eb2cbb206557691cf3aafc61e0fd69ade2801145f8e9d0300292c7abbe92ec44f70421d0f244a75df8350381254f80e0f46be8943474b5f1438adbe2d3ca6f

data/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 0.1.0-alpha.20 (2025-05-23)
+
+Full Changelog: [v0.1.0-alpha.19...v0.1.0-alpha.20](https://github.com/Modern-Treasury/modern-treasury-ruby/compare/v0.1.0-alpha.19...v0.1.0-alpha.20)
+
+### Features
+
+* **api:** api update ([51f2558](https://github.com/Modern-Treasury/modern-treasury-ruby/commit/51f2558e2bc2a89aa925e1e3f1dc64d5e3c5c162))
+* **api:** manual updates ([452bb1c](https://github.com/Modern-Treasury/modern-treasury-ruby/commit/452bb1cbf073c0763b7b5e542042a320ab88c817))
+* bump default connection pool size limit to minimum of 99 ([f9b80ac](https://github.com/Modern-Treasury/modern-treasury-ruby/commit/f9b80ace0577c91d113b36f8c02906cd2df41495))
+
+
+### Bug Fixes
+
+* correctly instantiate sorbet type aliases for enums and unions ([c2c4dba](https://github.com/Modern-Treasury/modern-treasury-ruby/commit/c2c4dba8a02c3c7bf84fed51cc8d9d06dd94d7a6))
+* prevent rubocop from mangling `===` to `is_a?` check ([18009bb](https://github.com/Modern-Treasury/modern-treasury-ruby/commit/18009bbd0286587025edead104ea029abaa71278))
+
+
+### Chores
+
+* **docs:** grammar improvements ([e533b50](https://github.com/Modern-Treasury/modern-treasury-ruby/commit/e533b5028d204cc9537f17a88167b8c2f40e9d6c))
+* force utf-8 locale via `RUBYOPT` when formatting ([cf86688](https://github.com/Modern-Treasury/modern-treasury-ruby/commit/cf866885c2f426bc3f129f12e7320c62d9a9e2c0))
+* refine Yard and Sorbet types and ensure linting is turned on for examples ([601bc22](https://github.com/Modern-Treasury/modern-treasury-ruby/commit/601bc22d020b65bc19362566685aabc295d0598d))
+* use fully qualified names for yard annotations and rbs aliases ([621ed43](https://github.com/Modern-Treasury/modern-treasury-ruby/commit/621ed43f77f526d2623989a48f3f1e9149ff800a))
+* use sorbet union aliases where available ([6701427](https://github.com/Modern-Treasury/modern-treasury-ruby/commit/6701427854edd85ae958c7c53c8177af7fa68ec5))
+* whitespaces ([45f3cea](https://github.com/Modern-Treasury/modern-treasury-ruby/commit/45f3cea94c88bb71356d502cce7f4fceb033f613))
+
+
+### Documentation
+
+* rewrite much of README.md for readability ([e426334](https://github.com/Modern-Treasury/modern-treasury-ruby/commit/e426334cca1f4df82faa6675a909601f3480c186))
+
 ## 0.1.0-alpha.19 (2025-05-13)
 
 Full Changelog: [v0.1.0-alpha.18...v0.1.0-alpha.19](https://github.com/Modern-Treasury/modern-treasury-ruby/compare/v0.1.0-alpha.18...v0.1.0-alpha.19)

data/README.md

@@ -1,6 +1,6 @@
 # Modern Treasury Ruby API library
 
-The Modern Treasury Ruby library provides convenient access to the Modern Treasury REST API from any Ruby 3.2.0+ application.
+The Modern Treasury Ruby library provides convenient access to the Modern Treasury REST API from any Ruby 3.2.0+ application. It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](https://github.com/Modern-Treasury/modern-treasury-ruby#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
 
 ## Documentation
 
@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "modern_treasury", "~> 0.1.0.pre.alpha.19"
+gem "modern_treasury", "~> 0.1.0.pre.alpha.20"
 ```
 
 <!-- x-release-please-end -->
@@ -36,16 +36,6 @@ counterparty = modern_treasury.counterparties.create(name: "my first counterpart
 puts(counterparty.id)
 ```
 
-## Sorbet
-
-This library is written with [Sorbet type definitions](https://sorbet.org/docs/rbi). However, there is no runtime dependency on the `sorbet-runtime`.
-
-When using sorbet, it is recommended to use model classes as below. This provides stronger type checking and tooling integration.
-
-```ruby
-modern_treasury.counterparties.create(name: "my first counterparty")
-```
-
 ### Pagination
 
 List methods in the Modern Treasury API are paginated.
@@ -65,40 +55,64 @@ page.auto_paging_each do |counterparty|
 end
 ```
 
+Alternatively, you can use the `#next_page?` and `#next_page` methods for more granular control working with pages.
+
+```ruby
+if page.next_page?
+  new_page = page.next_page
+  puts(new_page.items[0].id)
+end
+```
+
 ### File uploads
 
-Request parameters that correspond to file uploads can be passed as `StringIO`, or a [`Pathname`](https://rubyapi.org/3.2/o/pathname) instance.
+Request parameters that correspond to file uploads can be passed as raw contents, a [`Pathname`](https://rubyapi.org/3.2/o/pathname) instance, [`StringIO`](https://rubyapi.org/3.2/o/stringio), or more.
 
 ```ruby
 require "pathname"
 
-# using `Pathname`, the file will be lazily read, without reading everything in to memory
+# Use `Pathname` to send the filename and/or avoid paging a large file into memory:
 document = modern_treasury.documents.create(
   documentable_id: "24c6b7a3-02...",
   documentable_type: "counterparties",
   file: Pathname("my/file.txt")
 )
 
-file = File.read("my/file.txt")
-# using `StringIO`, useful if you already have the data in memory
+# Alternatively, pass file contents or a `StringIO` directly:
 document = modern_treasury.documents.create(
   documentable_id: "24c6b7a3-02...",
   documentable_type: "counterparties",
-  file: StringIO.new(file)
+  file: File.read("my/file.txt")
+)
+
+# Or, to control the filename and/or content type:
+file = ModernTreasury::FilePart.new(File.read("my/file.txt"), filename: "my/file.txt", content_type: "…")
+document = modern_treasury.documents.create(
+  documentable_id: "24c6b7a3-02...",
+  documentable_type: "counterparties",
+  file: file
 )
 
 puts(document.id)
 ```
 
-### Errors
+Note that you can also pass a raw `IO` descriptor, but this disables retries, as the library can't be sure if the descriptor is a file or pipe (which cannot be rewound).
+
+### Handling errors
 
 When the library is unable to connect to the API, or if the API returns a non-success status code (i.e., 4xx or 5xx response), a subclass of `ModernTreasury::Errors::APIError` will be thrown:
 
 ```ruby
 begin
   external_account = modern_treasury.external_accounts.create(counterparty_id: "missing")
-rescue ModernTreasury::Errors::APIError => e
-  puts(e.status) # 400
+rescue ModernTreasury::Errors::APIConnectionError => e
+  puts("The server could not be reached")
+  puts(e.cause)  # an underlying Exception, likely raised within `net/http`
+rescue ModernTreasury::Errors::RateLimitError => e
+  puts("A 429 status code was received; we should back off a bit.")
+rescue ModernTreasury::Errors::APIStatusError => e
+  puts("Another non-200-range status code was received")
+  puts(e.status)
 end
 ```
 
@@ -138,11 +152,7 @@ modern_treasury.counterparties.create(name: "my first counterparty", request_opt
 
 ### Timeouts
 
-By default, requests will time out after 60 seconds.
-
-Timeouts are applied separately to the initial connection and the overall request time, so in some cases a request could wait 2\*timeout seconds before it fails.
-
-You can use the `timeout` option to configure or disable this:
+By default, requests will time out after 60 seconds. You can use the timeout option to configure or disable this:
 
 ```ruby
 # Configure the default for all requests:
@@ -154,39 +164,53 @@ modern_treasury = ModernTreasury::Client.new(
 modern_treasury.counterparties.create(name: "my first counterparty", request_options: {timeout: 5})
 ```
 
-## Model DSL
+On timeout, `ModernTreasury::Errors::APITimeoutError` is raised.
 
-This library uses a simple DSL to represent request parameters and response shapes in `lib/modern_treasury/models`.
+Note that requests that time out are retried by default.
 
-With the right [editor plugins](https://shopify.github.io/ruby-lsp), you can ctrl-click on elements of the DSL to navigate around and explore the library.
+## Advanced concepts
 
-In all places where a `BaseModel` type is specified, vanilla Ruby `Hash` can also be used. For example, the following are interchangeable as arguments:
+### BaseModel
 
-```ruby
-# This has tooling readability, for auto-completion, static analysis, and goto definition with supported language services
-params = ModernTreasury::Models::CounterpartyCreateParams.new(name: "my first counterparty")
+All parameter and response objects inherit from `ModernTreasury::Internal::Type::BaseModel`, which provides several conveniences, including:
 
-# This also works
-params = {
-  name: "my first counterparty"
-}
-```
+1. All fields, including unknown ones, are accessible with `obj[:prop]` syntax, and can be destructured with `obj => {prop: prop}` or pattern-matching syntax.
 
-## Editor support
+2. Structural equivalence for equality; if two API calls return the same values, comparing the responses with == will return true.
 
-A combination of [Shopify LSP](https://shopify.github.io/ruby-lsp) and [Solargraph](https://solargraph.org/) is recommended for non-[Sorbet](https://sorbet.org) users. The former is especially good at go to definition, while the latter has much better auto-completion support.
+3. Both instances and the classes themselves can be pretty-printed.
 
-## Advanced concepts
+4. Helpers such as `#to_h`, `#deep_to_h`, `#to_json`, and `#to_yaml`.
 
-### Making custom/undocumented requests
+### Making custom or undocumented requests
+
+#### Undocumented properties
+
+You can send undocumented parameters to any endpoint, and read undocumented response properties, like so:
+
+Note: the `extra_` parameters of the same name overrides the documented parameters.
+
+```ruby
+counterparty =
+  modern_treasury.counterparties.create(
+    name: "my first counterparty",
+    request_options: {
+      extra_query: {my_query_parameter: value},
+      extra_body: {my_body_parameter: value},
+      extra_headers: {"my-header": value}
+    }
+  )
+
+puts(counterparty[:my_undocumented_property])
+```
 
 #### Undocumented request params
 
-If you want to explicitly send an extra param, you can do so with the `extra_query`, `extra_body`, and `extra_headers` under the `request_options:` parameter when making a requests as seen in examples above.
+If you want to explicitly send an extra param, you can do so with the `extra_query`, `extra_body`, and `extra_headers` under the `request_options:` parameter when making a request, as seen in the examples above.
 
 #### Undocumented endpoints
 
-To make requests to undocumented endpoints, you can make requests using `client.request`. Options on the client will be respected (such as retries) when making this request.
+To make requests to undocumented endpoints while retaining the benefit of auth, retries, and so on, you can make requests using `client.request`, like so:
 
 ```ruby
 response = client.request(
@@ -194,42 +218,67 @@ response = client.request(
   path: '/undocumented/endpoint',
   query: {"dog": "woof"},
   headers: {"useful-header": "interesting-value"},
-  body: {"he": "llo"},
+  body: {"hello": "world"}
 )
 ```
 
 ### Concurrency & connection pooling
 
-The `ModernTreasury::Client` instances are thread-safe, and should be re-used across multiple threads. By default, each `Client` have their own HTTP connection pool, with a maximum number of connections equal to thread count.
+The `ModernTreasury::Client` instances are threadsafe, but are only are fork-safe when there are no in-flight HTTP requests.
 
-When the maximum number of connections has been checked out from the connection pool, the `Client` will wait for an in use connection to become available. The queue time for this mechanism is accounted for by the per-request timeout.
+Each instance of `ModernTreasury::Client` has its own HTTP connection pool with a default size of 99. As such, we recommend instantiating the client once per application in most settings.
+
+When all available connections from the pool are checked out, requests wait for a new connection to become available, with queue time counting towards the request timeout.
 
 Unless otherwise specified, other classes in the SDK do not have locks protecting their underlying data structure.
 
-Currently, `ModernTreasury::Client` instances are only fork-safe if there are no in-flight HTTP requests.
+## Sorbet
 
-### Sorbet
+This library provides comprehensive [RBI](https://sorbet.org/docs/rbi) definitions, and has no dependency on sorbet-runtime.
 
-#### Enums
+You can provide typesafe request parameters like so:
 
-Sorbet's typed enums require sub-classing of the [`T::Enum` class](https://sorbet.org/docs/tenum) from the `sorbet-runtime` gem.
+```ruby
+modern_treasury.counterparties.create(name: "my first counterparty")
+```
 
-Since this library does not depend on `sorbet-runtime`, it uses a [`T.all` intersection type](https://sorbet.org/docs/intersection-types) with a ruby primitive type to construct a "tagged alias" instead.
+Or, equivalently:
 
 ```ruby
-module ModernTreasury::AccountsType
-  # This alias aids language service driven navigation.
-  TaggedSymbol = T.type_alias { T.all(Symbol, ModernTreasury::AccountsType) }
-end
+# Hashes work, but are not typesafe:
+modern_treasury.counterparties.create(name: "my first counterparty")
+
+# You can also splat a full Params class:
+params = ModernTreasury::CounterpartyCreateParams.new(name: "my first counterparty")
+modern_treasury.counterparties.create(**params)
 ```
 
-#### Argument passing trick
+### Enums
 
-It is possible to pass a compatible model / parameter class to a method that expects keyword arguments by using the `**` splat operator.
+Since this library does not depend on `sorbet-runtime`, it cannot provide [`T::Enum`](https://sorbet.org/docs/tenum) instances. Instead, we provide "tagged symbols" instead, which is always a primitive at runtime:
 
 ```ruby
-params = ModernTreasury::Models::CounterpartyCreateParams.new(name: "my first counterparty")
-modern_treasury.counterparties.create(**params)
+# :denied
+puts(ModernTreasury::CounterpartyCreateParams::VerificationStatus::DENIED)
+
+# Revealed type: `T.all(ModernTreasury::CounterpartyCreateParams::VerificationStatus, Symbol)`
+T.reveal_type(ModernTreasury::CounterpartyCreateParams::VerificationStatus::DENIED)
+```
+
+Enum parameters have a "relaxed" type, so you can either pass in enum constants or their literal value:
+
+```ruby
+# Using the enum constants preserves the tagged type information:
+modern_treasury.counterparties.create(
+  verification_status: ModernTreasury::CounterpartyCreateParams::VerificationStatus::DENIED,
+  # …
+)
+
+# Literal values are also permissible:
+modern_treasury.counterparties.create(
+  verification_status: :denied,
+  # …
+)
 ```
 
 ## Versioning

data/SECURITY.md

@@ -16,11 +16,11 @@ before making any information public.
 ## Reporting Non-SDK Related Security Issues
 
 If you encounter security issues that are not directly related to SDKs but pertain to the services
-or products provided by Modern Treasury please follow the respective company's security reporting guidelines.
+or products provided by Modern Treasury, please follow the respective company's security reporting guidelines.
 
 ### Modern Treasury Terms and Policies
 
-Please contact sdk-feedback@moderntreasury.com for any questions or concerns regarding security of our services.
+Please contact sdk-feedback@moderntreasury.com for any questions or concerns regarding the security of our services.
 
 ---
 

data/lib/modern_treasury/client.rb

@@ -132,6 +132,9 @@ module ModernTreasury
     # @return [ModernTreasury::Resources::LegalEntityAssociations]
     attr_reader :legal_entity_associations
 
+    # @return [ModernTreasury::Resources::PaymentActions]
+    attr_reader :payment_actions
+
     # A test endpoint often used to confirm credentials and headers are being passed
     # in correctly.
     #
@@ -139,7 +142,7 @@ module ModernTreasury
     #
     # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
     #
-    # @return [ModernTreasury::PingResponse]
+    # @return [ModernTreasury::Models::PingResponse]
     #
     # @see ModernTreasury::Models::ClientPingParams
     def ping(params = {})
@@ -183,10 +186,10 @@ module ModernTreasury
       api_key: ENV["MODERN_TREASURY_API_KEY"],
       organization_id: ENV["MODERN_TREASURY_ORGANIZATION_ID"],
       base_url: ENV["MODERN_TREASURY_BASE_URL"],
-      max_retries: ModernTreasury::Client::DEFAULT_MAX_RETRIES,
-      timeout: ModernTreasury::Client::DEFAULT_TIMEOUT_IN_SECONDS,
-      initial_retry_delay: ModernTreasury::Client::DEFAULT_INITIAL_RETRY_DELAY,
-      max_retry_delay: ModernTreasury::Client::DEFAULT_MAX_RETRY_DELAY,
+      max_retries: self.class::DEFAULT_MAX_RETRIES,
+      timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
+      initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY,
+      max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY,
       idempotency_header: "Idempotency-Key"
     )
       base_url ||= "https://app.moderntreasury.com"
@@ -248,6 +251,7 @@ module ModernTreasury
       @connection_legal_entities = ModernTreasury::Resources::ConnectionLegalEntities.new(client: self)
       @legal_entities = ModernTreasury::Resources::LegalEntities.new(client: self)
       @legal_entity_associations = ModernTreasury::Resources::LegalEntityAssociations.new(client: self)
+      @payment_actions = ModernTreasury::Resources::PaymentActions.new(client: self)
     end
   end
 end

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

@@ -11,6 +11,8 @@ module ModernTreasury
         # https://github.com/golang/go/blob/c8eced8580028328fde7c03cbfcb720ce15b2358/src/net/http/transport.go#L49
         KEEP_ALIVE_TIMEOUT = 30
 
+        DEFAULT_MAX_CONNECTIONS = [Etc.nprocessors, 99].max
+
         class << self
           # @api private
           #
@@ -184,7 +186,7 @@ module ModernTreasury
         # @api private
         #
         # @param size [Integer]
-        def initialize(size: Etc.nprocessors)
+        def initialize(size: self.class::DEFAULT_MAX_CONNECTIONS)
           @mutex = Mutex.new
           @size = size
           @pools = {}

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

@@ -12,6 +12,7 @@ module ModernTreasury
       # Array of items of a given type.
       class ArrayOf
         include ModernTreasury::Internal::Type::Converter
+        include ModernTreasury::Internal::Util::SorbetRuntimeSupport
 
         private_class_method :new
 
@@ -110,6 +111,13 @@ module ModernTreasury
           end
         end
 
+        # @api private
+        #
+        # @return [Object]
+        def to_sorbet_type
+          T::Array[ModernTreasury::Internal::Util::SorbetRuntimeSupport.to_sorbet_type(item_type)]
+        end
+
         # @api private
         #
         # @return [generic<Elem>]

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

@@ -312,6 +312,13 @@ module ModernTreasury
 
             acc
           end
+
+          # @api private
+          #
+          # @return [Object]
+          def to_sorbet_type
+            self
+          end
         end
 
         class << self
@@ -394,6 +401,13 @@ module ModernTreasury
         # @param keys [Array<Symbol>, nil]
         #
         # @return [Hash{Symbol=>Object}]
+        #
+        # @example
+        #   # `async_response` is a `ModernTreasury::AsyncResponse`
+        #   async_response => {
+        #     id: id,
+        #     object: object
+        #   }
         def deconstruct_keys(keys)
           (keys || self.class.known_fields.keys)
             .filter_map do |k|

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

@@ -10,6 +10,7 @@ module ModernTreasury
       # Ruby has no Boolean class; this is something for models to refer to.
       class Boolean
         extend ModernTreasury::Internal::Type::Converter
+        extend ModernTreasury::Internal::Util::SorbetRuntimeSupport
 
         private_class_method :new
 
@@ -56,6 +57,13 @@ module ModernTreasury
           #     @option state [Boolean] :can_retry
           #
           #   @return [Boolean, Object]
+
+          # @api private
+          #
+          # @return [Object]
+          def to_sorbet_type
+            T::Boolean
+          end
         end
       end
     end

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

@@ -108,6 +108,18 @@ module ModernTreasury
         #
         #   @return [Symbol, Object]
 
+        # @api private
+        #
+        # @return [Object]
+        def to_sorbet_type
+          case values
+          in []
+            T.noreturn
+          in [value, *_]
+            T.all(ModernTreasury::Internal::Util::SorbetRuntimeSupport.to_sorbet_type(value), self)
+          end
+        end
+
         # @api private
         #
         # @param depth [Integer]

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

@@ -89,6 +89,13 @@ module ModernTreasury
 
             value
           end
+
+          # @api private
+          #
+          # @return [Object]
+          def to_sorbet_type
+            T.any(Pathname, StringIO, IO, String, ModernTreasury::FilePart)
+          end
         end
       end
     end

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

@@ -12,6 +12,7 @@ module ModernTreasury
       # Hash of items of a given type.
       class HashOf
         include ModernTreasury::Internal::Type::Converter
+        include ModernTreasury::Internal::Util::SorbetRuntimeSupport
 
         private_class_method :new
 
@@ -130,6 +131,13 @@ module ModernTreasury
           end
         end
 
+        # @api private
+        #
+        # @return [Object]
+        def to_sorbet_type
+          T::Hash[ModernTreasury::Internal::Util::SorbetRuntimeSupport.to_sorbet_type(item_type)]
+        end
+
         # @api private
         #
         # @return [generic<Elem>]

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

@@ -208,6 +208,18 @@ module ModernTreasury
           super
         end
 
+        # @api private
+        #
+        # @return [Object]
+        def to_sorbet_type
+          case (v = variants)
+          in []
+            T.noreturn
+          else
+            T.any(*v.map { ModernTreasury::Internal::Util::SorbetRuntimeSupport.to_sorbet_type(_1) })
+          end
+        end
+
         # rubocop:enable Style/CaseEquality
         # rubocop:enable Style/HashEachMethods
 

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

@@ -10,6 +10,7 @@ module ModernTreasury
       # When we don't know what to expect for the value.
       class Unknown
         extend ModernTreasury::Internal::Type::Converter
+        extend ModernTreasury::Internal::Util::SorbetRuntimeSupport
 
         # rubocop:disable Lint/UnusedMethodArgument
 
@@ -58,6 +59,13 @@ module ModernTreasury
           #     @option state [Boolean] :can_retry
           #
           #   @return [Object]
+
+          # @api private
+          #
+          # @return [Object]
+          def to_sorbet_type
+            T.anything
+          end
         end
 
         # rubocop:enable Lint/UnusedMethodArgument

data/lib/modern_treasury/internal/util.rb

@@ -9,6 +9,23 @@ module ModernTreasury
       # @return [Float]
       def self.monotonic_secs = Process.clock_gettime(Process::CLOCK_MONOTONIC)
 
+      # @api private
+      #
+      # @param ns [Module, Class]
+      #
+      # @return [Enumerable<Module, Class>]
+      def self.walk_namespaces(ns)
+        ns.constants(false).lazy.flat_map do
+          case (c = ns.const_get(_1, false))
+          in Module | Class
+            walk_namespaces(c)
+          else
+            []
+          end
+        end
+          .chain([ns])
+      end
+
       class << self
         # @api private
         #
@@ -583,11 +600,13 @@ module ModernTreasury
         #
         # @return [Object]
         def encode_content(headers, body)
+          # rubocop:disable Style/CaseEquality
+          # rubocop:disable Layout/LineLength
           content_type = headers["content-type"]
           case [content_type, body]
           in [ModernTreasury::Internal::Util::JSON_CONTENT, Hash | Array | -> { primitive?(_1) }]
             [headers, JSON.generate(body)]
-          in [ModernTreasury::Internal::Util::JSONL_CONTENT, Enumerable] unless body.is_a?(ModernTreasury::Internal::Type::FileInput)
+          in [ModernTreasury::Internal::Util::JSONL_CONTENT, Enumerable] unless ModernTreasury::Internal::Type::FileInput === body
             [headers, body.lazy.map { JSON.generate(_1) }]
           in [%r{^multipart/form-data}, Hash | ModernTreasury::Internal::Type::FileInput]
             boundary, strio = encode_multipart_streaming(body)
@@ -602,6 +621,8 @@ module ModernTreasury
           else
             [headers, body]
           end
+          # rubocop:enable Layout/LineLength
+          # rubocop:enable Style/CaseEquality
         end
 
         # @api private
@@ -826,11 +847,39 @@ module ModernTreasury
           sorbet_runtime_constants.fetch(name).call
         end
 
+        # @api private
+        #
+        # @param name [Symbol]
+        #
+        # @return [Boolean]
+        def sorbet_constant_defined?(name) = sorbet_runtime_constants.key?(name)
+
         # @api private
         #
         # @param name [Symbol]
         # @param blk [Proc]
         def define_sorbet_constant!(name, &blk) = sorbet_runtime_constants.store(name, blk)
+
+        # @api private
+        #
+        # @return [Object]
+        def to_sorbet_type = raise NotImplementedError
+
+        class << self
+          # @api private
+          #
+          # @param type [ModernTreasury::Internal::Util::SorbetRuntimeSupport, Object]
+          #
+          # @return [Object]
+          def to_sorbet_type(type)
+            case type
+            in ModernTreasury::Internal::Util::SorbetRuntimeSupport
+              type.to_sorbet_type
+            else
+              type
+            end
+          end
+        end
       end
 
       extend ModernTreasury::Internal::Util::SorbetRuntimeSupport