modern_treasury 0.1.0.pre.alpha.20 → 0.1.0.pre.alpha.22

data/lib/modern_treasury/resources/ledger_account_categories.rb

@@ -105,7 +105,7 @@ module ModernTreasury
       #
       # Get a list of ledger account categories.
       #
-      # @overload list(id: nil, after_cursor: nil, balances: nil, currency: nil, ledger_account_id: nil, ledger_id: nil, metadata: nil, name: nil, parent_ledger_account_category_id: nil, per_page: nil, request_options: {})
+      # @overload list(id: nil, after_cursor: nil, balances: nil, currency: nil, external_id: nil, ledger_account_id: nil, ledger_id: nil, metadata: nil, name: nil, parent_ledger_account_category_id: nil, per_page: nil, request_options: {})
       #
       # @param id [Array<String>] If you have specific IDs to retrieve in bulk, you can pass them as query paramet
       #
@@ -115,6 +115,8 @@ module ModernTreasury
       #
       # @param currency [String]
       #
+      # @param external_id [String]
+      #
       # @param ledger_account_id [String] Query categories which contain a ledger account directly or through child catego
       #
       # @param ledger_id [String]

data/lib/modern_treasury/resources/ledger_accounts.rb

@@ -109,7 +109,7 @@ module ModernTreasury
       #
       # Get a list of ledger accounts.
       #
-      # @overload list(id: nil, after_cursor: nil, available_balance_amount: nil, balances: nil, created_at: nil, currency: nil, ledger_account_category_id: nil, ledger_id: nil, metadata: nil, name: nil, pending_balance_amount: nil, per_page: nil, posted_balance_amount: nil, updated_at: nil, request_options: {})
+      # @overload list(id: nil, after_cursor: nil, available_balance_amount: nil, balances: nil, created_at: nil, currency: nil, external_id: nil, ledger_account_category_id: nil, ledger_id: nil, metadata: nil, name: nil, normal_balance: nil, pending_balance_amount: nil, per_page: nil, posted_balance_amount: nil, updated_at: nil, request_options: {})
       #
       # @param id [Array<String>] If you have specific IDs to retrieve in bulk, you can pass them as query paramet
       #
@@ -123,6 +123,8 @@ module ModernTreasury
       #
       # @param currency [String]
       #
+      # @param external_id [String]
+      #
       # @param ledger_account_category_id [String]
       #
       # @param ledger_id [String]
@@ -131,6 +133,8 @@ module ModernTreasury
       #
       # @param name [Array<String>] If you have specific names to retrieve in bulk, you can pass them as query param
       #
+      # @param normal_balance [Symbol, ModernTreasury::Models::TransactionDirection]
+      #
       # @param pending_balance_amount [ModernTreasury::Models::LedgerAccountListParams::PendingBalanceAmount] Use `gt` (>), `gte` (>=), `lt` (<), `lte` (<=), `eq` (=), or `not_eq` (!=) to fi
       #
       # @param per_page [Integer]

data/lib/modern_treasury/resources/ledger_event_handlers.rb

@@ -3,117 +3,6 @@
 module ModernTreasury
   module Resources
     class LedgerEventHandlers
-      # Some parameter documentations has been truncated, see
-      # {ModernTreasury::Models::LedgerEventHandlerCreateParams} for more details.
-      #
-      # create ledger_event_handler
-      #
-      # @overload create(ledger_transaction_template:, name:, conditions: nil, description: nil, ledger_id: nil, metadata: nil, variables: nil, request_options: {})
-      #
-      # @param ledger_transaction_template [ModernTreasury::Models::LedgerEventHandlerCreateParams::LedgerTransactionTemplate]
-      #
-      # @param name [String] Name of the ledger event handler.
-      #
-      # @param conditions [ModernTreasury::Models::LedgerEventHandlerCreateParams::Conditions, nil]
-      #
-      # @param description [String, nil] An optional description.
-      #
-      # @param ledger_id [String] The id of the ledger that this account belongs to.
-      #
-      # @param metadata [Hash{Symbol=>String}, nil] Additional data represented as key-value pairs. Both the key and value must be s
-      #
-      # @param variables [Hash{Symbol=>ModernTreasury::Models::LedgerEventHandlerVariable}, nil]
-      #
-      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [ModernTreasury::Models::LedgerEventHandler]
-      #
-      # @see ModernTreasury::Models::LedgerEventHandlerCreateParams
-      def create(params)
-        parsed, options = ModernTreasury::LedgerEventHandlerCreateParams.dump_request(params)
-        @client.request(
-          method: :post,
-          path: "api/ledger_event_handlers",
-          body: parsed,
-          model: ModernTreasury::LedgerEventHandler,
-          options: options
-        )
-      end
-
-      # Get details on a single ledger event handler.
-      #
-      # @overload retrieve(id, request_options: {})
-      #
-      # @param id [String] id
-      #
-      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [ModernTreasury::Models::LedgerEventHandler]
-      #
-      # @see ModernTreasury::Models::LedgerEventHandlerRetrieveParams
-      def retrieve(id, params = {})
-        @client.request(
-          method: :get,
-          path: ["api/ledger_event_handlers/%1$s", id],
-          model: ModernTreasury::LedgerEventHandler,
-          options: params[:request_options]
-        )
-      end
-
-      # Some parameter documentations has been truncated, see
-      # {ModernTreasury::Models::LedgerEventHandlerListParams} for more details.
-      #
-      # Get a list of ledger event handlers.
-      #
-      # @overload list(after_cursor: nil, created_at: nil, metadata: nil, name: nil, per_page: nil, request_options: {})
-      #
-      # @param after_cursor [String, nil]
-      #
-      # @param created_at [Hash{Symbol=>Time}] Use `gt` (>), `gte` (>=), `lt` (<), `lte` (<=), or `eq` (=) to filter by the pos
-      #
-      # @param metadata [Hash{Symbol=>String}] For example, if you want to query for records with metadata key `Type` and value
-      #
-      # @param name [String]
-      #
-      # @param per_page [Integer]
-      #
-      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [ModernTreasury::Internal::Page<ModernTreasury::Models::LedgerEventHandler>]
-      #
-      # @see ModernTreasury::Models::LedgerEventHandlerListParams
-      def list(params = {})
-        parsed, options = ModernTreasury::LedgerEventHandlerListParams.dump_request(params)
-        @client.request(
-          method: :get,
-          path: "api/ledger_event_handlers",
-          query: parsed,
-          page: ModernTreasury::Internal::Page,
-          model: ModernTreasury::LedgerEventHandler,
-          options: options
-        )
-      end
-
-      # Archive a ledger event handler.
-      #
-      # @overload delete(id, request_options: {})
-      #
-      # @param id [String] id
-      #
-      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [ModernTreasury::Models::LedgerEventHandler]
-      #
-      # @see ModernTreasury::Models::LedgerEventHandlerDeleteParams
-      def delete(id, params = {})
-        @client.request(
-          method: :delete,
-          path: ["api/ledger_event_handlers/%1$s", id],
-          model: ModernTreasury::LedgerEventHandler,
-          options: params[:request_options]
-        )
-      end
-
       # @api private
       #
       # @param client [ModernTreasury::Client]

data/lib/modern_treasury/resources/ledgerable_events.rb

@@ -3,57 +3,6 @@
 module ModernTreasury
   module Resources
     class LedgerableEvents
-      # Some parameter documentations has been truncated, see
-      # {ModernTreasury::Models::LedgerableEventCreateParams} for more details.
-      #
-      # Create a ledgerable event.
-      #
-      # @overload create(name:, custom_data: nil, description: nil, metadata: nil, request_options: {})
-      #
-      # @param name [String] Name of the ledgerable event.
-      #
-      # @param custom_data [Object, nil] Additionally data to be used by the Ledger Event Handler.
-      #
-      # @param description [String, nil] Description of the ledgerable event.
-      #
-      # @param metadata [Hash{Symbol=>String}] Additional data represented as key-value pairs. Both the key and value must be s
-      #
-      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [ModernTreasury::Models::LedgerableEvent]
-      #
-      # @see ModernTreasury::Models::LedgerableEventCreateParams
-      def create(params)
-        parsed, options = ModernTreasury::LedgerableEventCreateParams.dump_request(params)
-        @client.request(
-          method: :post,
-          path: "api/ledgerable_events",
-          body: parsed,
-          model: ModernTreasury::LedgerableEvent,
-          options: options
-        )
-      end
-
-      # Get details on a single ledgerable event.
-      #
-      # @overload retrieve(id, request_options: {})
-      #
-      # @param id [String] id
-      #
-      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [ModernTreasury::Models::LedgerableEvent]
-      #
-      # @see ModernTreasury::Models::LedgerableEventRetrieveParams
-      def retrieve(id, params = {})
-        @client.request(
-          method: :get,
-          path: ["api/ledgerable_events/%1$s", id],
-          model: ModernTreasury::LedgerableEvent,
-          options: params[:request_options]
-        )
-      end
-
       # @api private
       #
       # @param client [ModernTreasury::Client]

data/lib/modern_treasury/resources/payment_orders.rb

@@ -27,7 +27,7 @@ module ModernTreasury
       #
       # @param accounting_ledger_class_id [String, nil] The ID of one of your accounting ledger classes. Note that these will only be ac
       #
-      # @param charge_bearer [Symbol, ModernTreasury::Models::PaymentOrderCreateParams::ChargeBearer, nil] The party that will pay the fees for the payment order. Only applies to wire pay
+      # @param charge_bearer [Symbol, ModernTreasury::Models::PaymentOrderCreateParams::ChargeBearer, nil] The party that will pay the fees for the payment order. See https://docs.modernt
       #
       # @param currency [Symbol, ModernTreasury::Models::Currency] Defaults to the currency of the originating account.
       #
@@ -137,7 +137,7 @@ module ModernTreasury
       #
       # @param amount [Integer] Value in specified currency's smallest unit. e.g. $10 would be represented as 10
       #
-      # @param charge_bearer [Symbol, ModernTreasury::Models::PaymentOrderUpdateParams::ChargeBearer, nil] The party that will pay the fees for the payment order. Only applies to wire pay
+      # @param charge_bearer [Symbol, ModernTreasury::Models::PaymentOrderUpdateParams::ChargeBearer, nil] The party that will pay the fees for the payment order. See https://docs.modernt
       #
       # @param counterparty_id [String, nil] Required when receiving_account_id is passed the ID of an external account.
       #
@@ -218,7 +218,7 @@ module ModernTreasury
       #
       # Get a list of all payment orders
       #
-      # @overload list(after_cursor: nil, counterparty_id: nil, created_at_end: nil, created_at_start: nil, direction: nil, effective_date_end: nil, effective_date_start: nil, metadata: nil, originating_account_id: nil, per_page: nil, priority: nil, process_after_end: nil, process_after_start: nil, reference_number: nil, status: nil, transaction_id: nil, type: nil, request_options: {})
+      # @overload list(after_cursor: nil, counterparty_id: nil, created_at_end: nil, created_at_start: nil, direction: nil, effective_date_end: nil, effective_date_start: nil, external_id: nil, metadata: nil, originating_account_id: nil, per_page: nil, priority: nil, process_after_end: nil, process_after_start: nil, reference_number: nil, status: nil, transaction_id: nil, type: nil, request_options: {})
       #
       # @param after_cursor [String, nil]
       #
@@ -234,6 +234,8 @@ module ModernTreasury
       #
       # @param effective_date_start [Date] An inclusive lower bound for searching effective_date
       #
+      # @param external_id [String]
+      #
       # @param metadata [Hash{Symbol=>String}] For example, if you want to query for records with metadata key `Type` and value
       #
       # @param originating_account_id [String]
@@ -292,7 +294,7 @@ module ModernTreasury
       #
       # @param accounting_ledger_class_id [String, nil] The ID of one of your accounting ledger classes. Note that these will only be ac
       #
-      # @param charge_bearer [Symbol, ModernTreasury::Models::PaymentOrderCreateAsyncParams::ChargeBearer, nil] The party that will pay the fees for the payment order. Only applies to wire pay
+      # @param charge_bearer [Symbol, ModernTreasury::Models::PaymentOrderCreateAsyncParams::ChargeBearer, nil] The party that will pay the fees for the payment order. See https://docs.modernt
       #
       # @param currency [Symbol, ModernTreasury::Models::Currency] Defaults to the currency of the originating account.
       #

data/lib/modern_treasury/resources/returns.rb

@@ -8,7 +8,7 @@ module ModernTreasury
       #
       # Create a return.
       #
-      # @overload create(returnable_id:, returnable_type:, additional_information: nil, code: nil, data: nil, date_of_death: nil, reason: nil, request_options: {})
+      # @overload create(returnable_id:, returnable_type:, additional_information: nil, code: nil, corrections: nil, data: nil, date_of_death: nil, reason: nil, request_options: {})
       #
       # @param returnable_id [String, nil] The ID of the object being returned or `null`.
       #
@@ -18,6 +18,8 @@ module ModernTreasury
       #
       # @param code [Symbol, ModernTreasury::Models::ReturnCreateParams::Code, nil] The return code. For ACH returns, this is the required ACH return code.
       #
+      # @param corrections [ModernTreasury::Models::ReturnCreateParams::Corrections, nil] Only relevant for ACH NOC returns. This is an object containing all of the new a
+      #
       # @param data [Object, nil] The raw data from the return file that we get from the bank.
       #
       # @param date_of_death [Date, nil] If the return code is `R14` or `R15` this is the date the deceased counterparty

data/lib/modern_treasury/resources/transactions.rb

@@ -11,7 +11,7 @@ module ModernTreasury
       #
       # create transaction
       #
-      # @overload create(amount:, as_of_date:, direction:, internal_account_id:, vendor_code:, vendor_code_type:, metadata: nil, posted: nil, type: nil, vendor_description: nil, request_options: {})
+      # @overload create(amount:, as_of_date:, direction:, internal_account_id:, vendor_code:, vendor_code_type:, metadata: nil, posted: nil, type: nil, vendor_customer_id: nil, vendor_description: nil, request_options: {})
       #
       # @param amount [Integer] Value in specified currency's smallest unit. e.g. $10 would be represented as 10
       #
@@ -31,6 +31,8 @@ module ModernTreasury
       #
       # @param type [Symbol, ModernTreasury::Models::TransactionCreateParams::Type, nil] The type of the transaction. Examples could be `card, `ach`, `wire`, `check`, `r
       #
+      # @param vendor_customer_id [String, nil] An identifier given to this transaction by the bank, often `null`.
+      #
       # @param vendor_description [String, nil] The transaction detail text that often appears in on your bank statement and in
       #
       # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/modern_treasury/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ModernTreasury
-  VERSION = "0.1.0.pre.alpha.20"
+  VERSION = "0.1.0.pre.alpha.22"
 end

data/lib/modern_treasury.rb

@@ -20,7 +20,9 @@ require "uri"
 
 # We already ship the preferred sorbet manifests in the package itself.
 # `tapioca` currently does not offer us a way to opt out of unnecessary compilation.
-if Object.const_defined?(:Tapioca) && caller.chain([$PROGRAM_NAME]).chain(ARGV).grep(/tapioca/)
+if Object.const_defined?(:Tapioca) &&
+   caller.chain([$PROGRAM_NAME]).chain(ARGV).any?(/tapioca/) &&
+   ARGV.none?(/dsl/)
   return
 end
 
@@ -142,9 +144,6 @@ require_relative "modern_treasury/models/invoices/line_item_retrieve_params"
 require_relative "modern_treasury/models/invoices/line_item_update_params"
 require_relative "modern_treasury/models/invoice_update_params"
 require_relative "modern_treasury/models/ledger"
-require_relative "modern_treasury/models/ledgerable_event"
-require_relative "modern_treasury/models/ledgerable_event_create_params"
-require_relative "modern_treasury/models/ledgerable_event_retrieve_params"
 require_relative "modern_treasury/models/ledger_account"
 require_relative "modern_treasury/models/ledger_account_balance_monitor"
 require_relative "modern_treasury/models/ledger_account_balance_monitor_create_params"
@@ -184,12 +183,6 @@ require_relative "modern_treasury/models/ledger_entry"
 require_relative "modern_treasury/models/ledger_entry_list_params"
 require_relative "modern_treasury/models/ledger_entry_retrieve_params"
 require_relative "modern_treasury/models/ledger_entry_update_params"
-require_relative "modern_treasury/models/ledger_event_handler"
-require_relative "modern_treasury/models/ledger_event_handler_create_params"
-require_relative "modern_treasury/models/ledger_event_handler_delete_params"
-require_relative "modern_treasury/models/ledger_event_handler_list_params"
-require_relative "modern_treasury/models/ledger_event_handler_retrieve_params"
-require_relative "modern_treasury/models/ledger_event_handler_variable"
 require_relative "modern_treasury/models/ledger_list_params"
 require_relative "modern_treasury/models/ledger_retrieve_params"
 require_relative "modern_treasury/models/ledger_transaction"

data/rbi/modern_treasury/errors.rbi

@@ -8,6 +8,22 @@ module ModernTreasury
     end
 
     class ConversionError < ModernTreasury::Errors::Error
+      sig { returns(T.nilable(StandardError)) }
+      def cause
+      end
+
+      # @api private
+      sig do
+        params(
+          on: T::Class[StandardError],
+          method: Symbol,
+          target: T.anything,
+          value: T.anything,
+          cause: T.nilable(StandardError)
+        ).returns(T.attached_class)
+      end
+      def self.new(on:, method:, target:, value:, cause: nil)
+      end
     end
 
     class APIError < ModernTreasury::Errors::Error

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

@@ -22,6 +22,8 @@ module ModernTreasury
 
         class << self
           # @api private
+          #
+          # Coerce value to Boolean if possible, otherwise return the original value.
           sig do
             override
               .params(

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

@@ -18,12 +18,14 @@ module ModernTreasury
         CoerceState =
           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
@@ -93,6 +95,15 @@ module ModernTreasury
           def self.type_info(spec)
           end
 
+          # @api private
+          sig do
+            params(translate_names: T::Boolean).returns(
+              ModernTreasury::Internal::Type::Converter::CoerceState
+            )
+          end
+          def self.new_coerce_state(translate_names: true)
+          end
+
           # @api private
           #
           # Based on `target`, transform `value` into `target`, to the extent possible:
@@ -114,14 +125,11 @@ module ModernTreasury
           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
@@ -133,15 +141,7 @@ module ModernTreasury
             # - `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
-            }
+            state: ModernTreasury::Internal::Type::Converter.new_coerce_state
           )
           end
 

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

@@ -78,6 +78,11 @@ module ModernTreasury
         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(

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

@@ -22,6 +22,8 @@ module ModernTreasury
 
         class << self
           # @api private
+          #
+          # No coercion needed for Unknown type.
           sig do
             override
               .params(

data/rbi/modern_treasury/internal/util.rbi

@@ -332,6 +332,8 @@ module ModernTreasury
         end
 
         # @api private
+        #
+        # https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.1.md#special-considerations-for-multipart-content
         sig do
           params(body: T.anything).returns([String, T::Enumerable[String]])
         end