metronome-sdk 3.6.0 → 3.8.0

data/rbi/metronome_sdk/models/contract_v2.rbi

@@ -286,6 +286,20 @@ module MetronomeSDK
       end
       attr_writer :spend_threshold_configuration
 
+      # Spend trackers attached to this contract.
+      sig do
+        returns(T.nilable(T::Array[MetronomeSDK::ContractV2::SpendTracker]))
+      end
+      attr_reader :spend_trackers
+
+      sig do
+        params(
+          spend_trackers:
+            T::Array[MetronomeSDK::ContractV2::SpendTracker::OrHash]
+        ).void
+      end
+      attr_writer :spend_trackers
+
       # List of subscriptions on the contract.
       sig do
         returns(T.nilable(T::Array[MetronomeSDK::ContractV2::Subscription]))
@@ -361,6 +375,8 @@ module MetronomeSDK
             MetronomeSDK::ContractV2::ScheduledChargesOnUsageInvoices::OrSymbol,
           spend_threshold_configuration:
             MetronomeSDK::SpendThresholdConfigurationV2::OrHash,
+          spend_trackers:
+            T::Array[MetronomeSDK::ContractV2::SpendTracker::OrHash],
           subscriptions:
             T::Array[MetronomeSDK::ContractV2::Subscription::OrHash],
           total_contract_value: Float,
@@ -422,6 +438,8 @@ module MetronomeSDK
         # on a separate invoice from usage charges.
         scheduled_charges_on_usage_invoices: nil,
         spend_threshold_configuration: nil,
+        # Spend trackers attached to this contract.
+        spend_trackers: nil,
         # List of subscriptions on the contract.
         subscriptions: nil,
         total_contract_value: nil,
@@ -476,6 +494,7 @@ module MetronomeSDK
               MetronomeSDK::ContractV2::ScheduledChargesOnUsageInvoices::TaggedSymbol,
             spend_threshold_configuration:
               MetronomeSDK::SpendThresholdConfigurationV2,
+            spend_trackers: T::Array[MetronomeSDK::ContractV2::SpendTracker],
             subscriptions: T::Array[MetronomeSDK::ContractV2::Subscription],
             total_contract_value: Float,
             uniqueness_key: String
@@ -576,6 +595,14 @@ module MetronomeSDK
         end
         attr_writer :contract
 
+        # The actor who created this commit. Omitted for system-generated commits such as
+        # recurring commits, rollover commits, and threshold commits.
+        sig { returns(T.nilable(String)) }
+        attr_reader :created_by
+
+        sig { params(created_by: String).void }
+        attr_writer :created_by
+
         # Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
         sig { returns(T.nilable(T::Hash[Symbol, String])) }
         attr_reader :custom_fields
@@ -743,6 +770,22 @@ module MetronomeSDK
         end
         attr_writer :specifiers
 
+        # Optional attributes controlling how this commit interacts with spend trackers.
+        sig do
+          returns(
+            T.nilable(MetronomeSDK::ContractV2::Commit::SpendTrackerAttributes)
+          )
+        end
+        attr_reader :spend_tracker_attributes
+
+        sig do
+          params(
+            spend_tracker_attributes:
+              MetronomeSDK::ContractV2::Commit::SpendTrackerAttributes::OrHash
+          ).void
+        end
+        attr_writer :spend_tracker_attributes
+
         # Attach a subscription to the recurring commit/credit.
         sig do
           returns(T.nilable(MetronomeSDK::RecurringCommitSubscriptionConfig))
@@ -770,6 +813,7 @@ module MetronomeSDK
             archived_at: Time,
             balance: Float,
             contract: MetronomeSDK::ContractV2::Commit::Contract::OrHash,
+            created_by: String,
             custom_fields: T::Hash[Symbol, String],
             description: String,
             hierarchy_configuration:
@@ -806,6 +850,8 @@ module MetronomeSDK
             rollover_fraction: Float,
             salesforce_opportunity_id: String,
             specifiers: T::Array[MetronomeSDK::CommitSpecifier::OrHash],
+            spend_tracker_attributes:
+              MetronomeSDK::ContractV2::Commit::SpendTrackerAttributes::OrHash,
             subscription_config:
               MetronomeSDK::RecurringCommitSubscriptionConfig::OrHash
           ).returns(T.attached_class)
@@ -837,6 +883,9 @@ module MetronomeSDK
           # included in the balance, including future-dated manual ledger entries.
           balance: nil,
           contract: nil,
+          # The actor who created this commit. Omitted for system-generated commits such as
+          # recurring commits, rollover commits, and threshold commits.
+          created_by: nil,
           # Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
           custom_fields: nil,
           description: nil,
@@ -866,6 +915,8 @@ module MetronomeSDK
           # or credit. A customer's usage needs to meet the condition of at least one of the
           # specifiers to contribute to a commit's or credit's drawdown.
           specifiers: nil,
+          # Optional attributes controlling how this commit interacts with spend trackers.
+          spend_tracker_attributes: nil,
           # Attach a subscription to the recurring commit/credit.
           subscription_config: nil
         )
@@ -885,6 +936,7 @@ module MetronomeSDK
               archived_at: Time,
               balance: Float,
               contract: MetronomeSDK::ContractV2::Commit::Contract,
+              created_by: String,
               custom_fields: T::Hash[Symbol, String],
               description: String,
               hierarchy_configuration:
@@ -905,6 +957,8 @@ module MetronomeSDK
               rollover_fraction: Float,
               salesforce_opportunity_id: String,
               specifiers: T::Array[MetronomeSDK::CommitSpecifier],
+              spend_tracker_attributes:
+                MetronomeSDK::ContractV2::Commit::SpendTrackerAttributes,
               subscription_config:
                 MetronomeSDK::RecurringCommitSubscriptionConfig
             }
@@ -2337,6 +2391,36 @@ module MetronomeSDK
           def to_hash
           end
         end
+
+        class SpendTrackerAttributes < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractV2::Commit::SpendTrackerAttributes,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          # If true, this commit is included in spend trackers with discounted set to
+          # DISCOUNTED_ONLY
+          sig { returns(T::Boolean) }
+          attr_accessor :counts_as_discounted
+
+          # Optional attributes controlling how this commit interacts with spend trackers.
+          sig do
+            params(counts_as_discounted: T::Boolean).returns(T.attached_class)
+          end
+          def self.new(
+            # If true, this commit is included in spend trackers with discounted set to
+            # DISCOUNTED_ONLY
+            counts_as_discounted:
+          )
+          end
+
+          sig { override.returns({ counts_as_discounted: T::Boolean }) }
+          def to_hash
+          end
+        end
       end
 
       class Override < MetronomeSDK::Internal::Type::BaseModel
@@ -2547,6 +2631,12 @@ module MetronomeSDK
               )
             end
 
+          sig { returns(T.nilable(T::Array[String])) }
+          attr_reader :any_commit_or_credit_ids
+
+          sig { params(any_commit_or_credit_ids: T::Array[String]).void }
+          attr_writer :any_commit_or_credit_ids
+
           sig do
             returns(
               T.nilable(
@@ -2606,6 +2696,7 @@ module MetronomeSDK
 
           sig do
             params(
+              any_commit_or_credit_ids: T::Array[String],
               billing_frequency:
                 MetronomeSDK::ContractV2::Override::OverrideSpecifier::BillingFrequency::OrSymbol,
               commit_ids: T::Array[String],
@@ -2617,6 +2708,7 @@ module MetronomeSDK
             ).returns(T.attached_class)
           end
           def self.new(
+            any_commit_or_credit_ids: nil,
             billing_frequency: nil,
             commit_ids: nil,
             presentation_group_values: nil,
@@ -2630,6 +2722,7 @@ module MetronomeSDK
           sig do
             override.returns(
               {
+                any_commit_or_credit_ids: T::Array[String],
                 billing_frequency:
                   MetronomeSDK::ContractV2::Override::OverrideSpecifier::BillingFrequency::TaggedSymbol,
                 commit_ids: T::Array[String],
@@ -3257,6 +3350,14 @@ module MetronomeSDK
         sig { params(created_at: Time).void }
         attr_writer :created_at
 
+        # The actor who created this credit. Omitted for system-generated credits such as
+        # recurring credits.
+        sig { returns(T.nilable(String)) }
+        attr_reader :created_by
+
+        sig { params(created_by: String).void }
+        attr_writer :created_by
+
         # Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
         sig { returns(T.nilable(T::Hash[Symbol, String])) }
         attr_reader :custom_fields
@@ -3400,6 +3501,7 @@ module MetronomeSDK
             balance: Float,
             contract: MetronomeSDK::ContractV2::Credit::Contract::OrHash,
             created_at: Time,
+            created_by: String,
             custom_fields: T::Hash[Symbol, String],
             description: String,
             hierarchy_configuration:
@@ -3454,6 +3556,9 @@ module MetronomeSDK
           # - Recurring credits: latter of credit service period date and parent credit
           #   start date
           created_at: nil,
+          # The actor who created this credit. Omitted for system-generated credits such as
+          # recurring credits.
+          created_by: nil,
           # Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
           custom_fields: nil,
           description: nil,
@@ -3496,6 +3601,7 @@ module MetronomeSDK
               balance: Float,
               contract: MetronomeSDK::ContractV2::Credit::Contract,
               created_at: Time,
+              created_by: String,
               custom_fields: T::Hash[Symbol, String],
               description: String,
               hierarchy_configuration:
@@ -5232,6 +5338,26 @@ module MetronomeSDK
         end
         attr_writer :proration
 
+        # Rounding configuration for prorated recurring commit amounts.
+        sig do
+          returns(
+            T.nilable(
+              MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding
+            )
+          )
+        end
+        attr_reader :proration_rounding
+
+        sig do
+          params(
+            proration_rounding:
+              T.nilable(
+                MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::OrHash
+              )
+          ).void
+        end
+        attr_writer :proration_rounding
+
         # The frequency at which the recurring commits will be created. If not provided: -
         # The commits will be created on the usage invoice frequency. If provided: - The
         # period defined in the duration will correspond to this frequency. - Commits will
@@ -5316,6 +5442,10 @@ module MetronomeSDK
             netsuite_sales_order_id: String,
             proration:
               MetronomeSDK::ContractV2::RecurringCommit::Proration::OrSymbol,
+            proration_rounding:
+              T.nilable(
+                MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::OrHash
+              ),
             recurrence_frequency:
               MetronomeSDK::ContractV2::RecurringCommit::RecurrenceFrequency::OrSymbol,
             rollover_fraction: Float,
@@ -5357,6 +5487,8 @@ module MetronomeSDK
           # Determines whether the first and last commit will be prorated. If not provided,
           # the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
           proration: nil,
+          # Rounding configuration for prorated recurring commit amounts.
+          proration_rounding: nil,
           # The frequency at which the recurring commits will be created. If not provided: -
           # The commits will be created on the usage invoice frequency. If provided: - The
           # period defined in the duration will correspond to this frequency. - Commits will
@@ -5402,6 +5534,10 @@ module MetronomeSDK
               netsuite_sales_order_id: String,
               proration:
                 MetronomeSDK::ContractV2::RecurringCommit::Proration::TaggedSymbol,
+              proration_rounding:
+                T.nilable(
+                  MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding
+                ),
               recurrence_frequency:
                 MetronomeSDK::ContractV2::RecurringCommit::RecurrenceFrequency::TaggedSymbol,
               rollover_fraction: Float,
@@ -5698,6 +5834,255 @@ module MetronomeSDK
           end
         end
 
+        class ProrationRounding < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          sig do
+            returns(
+              T.nilable(
+                MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Access
+              )
+            )
+          end
+          attr_reader :access
+
+          sig do
+            params(
+              access:
+                MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Access::OrHash
+            ).void
+          end
+          attr_writer :access
+
+          sig do
+            returns(
+              T.nilable(
+                MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Invoice
+              )
+            )
+          end
+          attr_reader :invoice
+
+          sig do
+            params(
+              invoice:
+                MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Invoice::OrHash
+            ).void
+          end
+          attr_writer :invoice
+
+          # Rounding configuration for prorated recurring commit amounts.
+          sig do
+            params(
+              access:
+                MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Access::OrHash,
+              invoice:
+                MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Invoice::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(access: nil, invoice: nil)
+          end
+
+          sig do
+            override.returns(
+              {
+                access:
+                  MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Access,
+                invoice:
+                  MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Invoice
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Access < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Access,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            # Number of decimal places to round to. Applied directly to the stored monetary
+            # representation. Negative values round to powers of 10 (e.g., -2 rounds to
+            # nearest 100 in the stored unit).
+            sig { returns(Float) }
+            attr_accessor :decimal_places
+
+            sig do
+              returns(
+                MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Access::RoundingMethod::TaggedSymbol
+              )
+            end
+            attr_accessor :rounding_method
+
+            sig do
+              params(
+                decimal_places: Float,
+                rounding_method:
+                  MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Access::RoundingMethod::OrSymbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Number of decimal places to round to. Applied directly to the stored monetary
+              # representation. Negative values round to powers of 10 (e.g., -2 rounds to
+              # nearest 100 in the stored unit).
+              decimal_places:,
+              rounding_method:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  decimal_places: Float,
+                  rounding_method:
+                    MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Access::RoundingMethod::TaggedSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            module RoundingMethod
+              extend MetronomeSDK::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Access::RoundingMethod
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              HALF_UP =
+                T.let(
+                  :HALF_UP,
+                  MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Access::RoundingMethod::TaggedSymbol
+                )
+              FLOOR =
+                T.let(
+                  :FLOOR,
+                  MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Access::RoundingMethod::TaggedSymbol
+                )
+              CEILING =
+                T.let(
+                  :CEILING,
+                  MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Access::RoundingMethod::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Access::RoundingMethod::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+
+          class Invoice < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Invoice,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            # Number of decimal places to round to. Applied directly to the stored monetary
+            # representation. Negative values round to powers of 10 (e.g., -2 rounds to
+            # nearest 100 in the stored unit).
+            sig { returns(Float) }
+            attr_accessor :decimal_places
+
+            sig do
+              returns(
+                MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Invoice::RoundingMethod::TaggedSymbol
+              )
+            end
+            attr_accessor :rounding_method
+
+            sig do
+              params(
+                decimal_places: Float,
+                rounding_method:
+                  MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Invoice::RoundingMethod::OrSymbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Number of decimal places to round to. Applied directly to the stored monetary
+              # representation. Negative values round to powers of 10 (e.g., -2 rounds to
+              # nearest 100 in the stored unit).
+              decimal_places:,
+              rounding_method:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  decimal_places: Float,
+                  rounding_method:
+                    MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Invoice::RoundingMethod::TaggedSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            module RoundingMethod
+              extend MetronomeSDK::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Invoice::RoundingMethod
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              HALF_UP =
+                T.let(
+                  :HALF_UP,
+                  MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Invoice::RoundingMethod::TaggedSymbol
+                )
+              FLOOR =
+                T.let(
+                  :FLOOR,
+                  MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Invoice::RoundingMethod::TaggedSymbol
+                )
+              CEILING =
+                T.let(
+                  :CEILING,
+                  MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Invoice::RoundingMethod::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    MetronomeSDK::ContractV2::RecurringCommit::ProrationRounding::Invoice::RoundingMethod::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+        end
+
         # The frequency at which the recurring commits will be created. If not provided: -
         # The commits will be created on the usage invoice frequency. If provided: - The
         # period defined in the duration will correspond to this frequency. - Commits will
@@ -5735,6 +6120,11 @@ module MetronomeSDK
               :WEEKLY,
               MetronomeSDK::ContractV2::RecurringCommit::RecurrenceFrequency::TaggedSymbol
             )
+          DAILY =
+            T.let(
+              :DAILY,
+              MetronomeSDK::ContractV2::RecurringCommit::RecurrenceFrequency::TaggedSymbol
+            )
 
           sig do
             override.returns(
@@ -5900,6 +6290,26 @@ module MetronomeSDK
         end
         attr_writer :proration
 
+        # Rounding configuration for prorated recurring credit amounts.
+        sig do
+          returns(
+            T.nilable(
+              MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding
+            )
+          )
+        end
+        attr_reader :proration_rounding
+
+        sig do
+          params(
+            proration_rounding:
+              T.nilable(
+                MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::OrHash
+              )
+          ).void
+        end
+        attr_writer :proration_rounding
+
         # The frequency at which the recurring commits will be created. If not provided: -
         # The commits will be created on the usage invoice frequency. If provided: - The
         # period defined in the duration will correspond to this frequency. - Commits will
@@ -5982,6 +6392,10 @@ module MetronomeSDK
             netsuite_sales_order_id: String,
             proration:
               MetronomeSDK::ContractV2::RecurringCredit::Proration::OrSymbol,
+            proration_rounding:
+              T.nilable(
+                MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::OrHash
+              ),
             recurrence_frequency:
               MetronomeSDK::ContractV2::RecurringCredit::RecurrenceFrequency::OrSymbol,
             rollover_fraction: Float,
@@ -6021,6 +6435,8 @@ module MetronomeSDK
           # Determines whether the first and last commit will be prorated. If not provided,
           # the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
           proration: nil,
+          # Rounding configuration for prorated recurring credit amounts.
+          proration_rounding: nil,
           # The frequency at which the recurring commits will be created. If not provided: -
           # The commits will be created on the usage invoice frequency. If provided: - The
           # period defined in the duration will correspond to this frequency. - Commits will
@@ -6064,6 +6480,10 @@ module MetronomeSDK
               netsuite_sales_order_id: String,
               proration:
                 MetronomeSDK::ContractV2::RecurringCredit::Proration::TaggedSymbol,
+              proration_rounding:
+                T.nilable(
+                  MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding
+                ),
               recurrence_frequency:
                 MetronomeSDK::ContractV2::RecurringCredit::RecurrenceFrequency::TaggedSymbol,
               rollover_fraction: Float,
@@ -6322,14 +6742,152 @@ module MetronomeSDK
           end
         end
 
-        # The frequency at which the recurring commits will be created. If not provided: -
-        # The commits will be created on the usage invoice frequency. If provided: - The
-        # period defined in the duration will correspond to this frequency. - Commits will
-        # be created aligned with the recurring commit's starting_at rather than the usage
-        # invoice dates.
-        module RecurrenceFrequency
-          extend MetronomeSDK::Internal::Type::Enum
-
+        class ProrationRounding < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          sig do
+            returns(
+              T.nilable(
+                MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::Access
+              )
+            )
+          end
+          attr_reader :access
+
+          sig do
+            params(
+              access:
+                MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::Access::OrHash
+            ).void
+          end
+          attr_writer :access
+
+          # Rounding configuration for prorated recurring credit amounts.
+          sig do
+            params(
+              access:
+                MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::Access::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(access: nil)
+          end
+
+          sig do
+            override.returns(
+              {
+                access:
+                  MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::Access
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Access < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::Access,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            # Number of decimal places to round to. Applied directly to the stored monetary
+            # representation. Negative values round to powers of 10 (e.g., -2 rounds to
+            # nearest 100 in the stored unit).
+            sig { returns(Float) }
+            attr_accessor :decimal_places
+
+            sig do
+              returns(
+                MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::Access::RoundingMethod::TaggedSymbol
+              )
+            end
+            attr_accessor :rounding_method
+
+            sig do
+              params(
+                decimal_places: Float,
+                rounding_method:
+                  MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::Access::RoundingMethod::OrSymbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Number of decimal places to round to. Applied directly to the stored monetary
+              # representation. Negative values round to powers of 10 (e.g., -2 rounds to
+              # nearest 100 in the stored unit).
+              decimal_places:,
+              rounding_method:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  decimal_places: Float,
+                  rounding_method:
+                    MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::Access::RoundingMethod::TaggedSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            module RoundingMethod
+              extend MetronomeSDK::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::Access::RoundingMethod
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              HALF_UP =
+                T.let(
+                  :HALF_UP,
+                  MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::Access::RoundingMethod::TaggedSymbol
+                )
+              FLOOR =
+                T.let(
+                  :FLOOR,
+                  MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::Access::RoundingMethod::TaggedSymbol
+                )
+              CEILING =
+                T.let(
+                  :CEILING,
+                  MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::Access::RoundingMethod::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    MetronomeSDK::ContractV2::RecurringCredit::ProrationRounding::Access::RoundingMethod::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+        end
+
+        # The frequency at which the recurring commits will be created. If not provided: -
+        # The commits will be created on the usage invoice frequency. If provided: - The
+        # period defined in the duration will correspond to this frequency. - Commits will
+        # be created aligned with the recurring commit's starting_at rather than the usage
+        # invoice dates.
+        module RecurrenceFrequency
+          extend MetronomeSDK::Internal::Type::Enum
+
           TaggedSymbol =
             T.type_alias do
               T.all(
@@ -6359,6 +6917,11 @@ module MetronomeSDK
               :WEEKLY,
               MetronomeSDK::ContractV2::RecurringCredit::RecurrenceFrequency::TaggedSymbol
             )
+          DAILY =
+            T.let(
+              :DAILY,
+              MetronomeSDK::ContractV2::RecurringCredit::RecurrenceFrequency::TaggedSymbol
+            )
 
           sig do
             override.returns(
@@ -6680,6 +7243,344 @@ module MetronomeSDK
         end
       end
 
+      class SpendTracker < MetronomeSDK::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              MetronomeSDK::ContractV2::SpendTracker,
+              MetronomeSDK::Internal::AnyHash
+            )
+          end
+
+        # Human-readable identifier, unique per contract.
+        sig { returns(String) }
+        attr_accessor :alias_
+
+        sig do
+          returns(
+            T::Array[
+              MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier
+            ]
+          )
+        end
+        attr_accessor :applicable_spend_specifiers
+
+        sig { returns(String) }
+        attr_accessor :credit_type_id
+
+        sig do
+          returns(
+            MetronomeSDK::ContractV2::SpendTracker::ResetFrequency::TaggedSymbol
+          )
+        end
+        attr_accessor :reset_frequency
+
+        sig do
+          returns(
+            T.nilable(MetronomeSDK::ContractV2::SpendTracker::AccumulatedSpend)
+          )
+        end
+        attr_reader :accumulated_spend
+
+        sig do
+          params(
+            accumulated_spend:
+              MetronomeSDK::ContractV2::SpendTracker::AccumulatedSpend::OrHash
+          ).void
+        end
+        attr_writer :accumulated_spend
+
+        sig do
+          params(
+            alias_: String,
+            applicable_spend_specifiers:
+              T::Array[
+                MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::OrHash
+              ],
+            credit_type_id: String,
+            reset_frequency:
+              MetronomeSDK::ContractV2::SpendTracker::ResetFrequency::OrSymbol,
+            accumulated_spend:
+              MetronomeSDK::ContractV2::SpendTracker::AccumulatedSpend::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Human-readable identifier, unique per contract.
+          alias_:,
+          applicable_spend_specifiers:,
+          credit_type_id:,
+          reset_frequency:,
+          accumulated_spend: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              alias_: String,
+              applicable_spend_specifiers:
+                T::Array[
+                  MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier
+                ],
+              credit_type_id: String,
+              reset_frequency:
+                MetronomeSDK::ContractV2::SpendTracker::ResetFrequency::TaggedSymbol,
+              accumulated_spend:
+                MetronomeSDK::ContractV2::SpendTracker::AccumulatedSpend
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class ApplicableSpendSpecifier < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          sig do
+            returns(
+              T::Array[
+                MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Source::TaggedSymbol
+              ]
+            )
+          end
+          attr_accessor :sources
+
+          sig do
+            returns(
+              MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::SpendType::TaggedSymbol
+            )
+          end
+          attr_accessor :spend_type
+
+          sig do
+            returns(
+              T.nilable(
+                MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :discounted
+
+          sig do
+            params(
+              discounted:
+                MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted::OrSymbol
+            ).void
+          end
+          attr_writer :discounted
+
+          sig do
+            params(
+              sources:
+                T::Array[
+                  MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Source::OrSymbol
+                ],
+              spend_type:
+                MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::SpendType::OrSymbol,
+              discounted:
+                MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(sources:, spend_type:, discounted: nil)
+          end
+
+          sig do
+            override.returns(
+              {
+                sources:
+                  T::Array[
+                    MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Source::TaggedSymbol
+                  ],
+                spend_type:
+                  MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::SpendType::TaggedSymbol,
+                discounted:
+                  MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted::TaggedSymbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          module Source
+            extend MetronomeSDK::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Source
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            THRESHOLD_RECHARGE =
+              T.let(
+                :THRESHOLD_RECHARGE,
+                MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Source::TaggedSymbol
+              )
+            MANUAL =
+              T.let(
+                :MANUAL,
+                MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Source::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Source::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          module SpendType
+            extend MetronomeSDK::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::SpendType
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            COMMIT_PURCHASE =
+              T.let(
+                :COMMIT_PURCHASE,
+                MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::SpendType::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::SpendType::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          module Discounted
+            extend MetronomeSDK::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ANY =
+              T.let(
+                :ANY,
+                MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted::TaggedSymbol
+              )
+            DISCOUNTED_ONLY =
+              T.let(
+                :DISCOUNTED_ONLY,
+                MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted::TaggedSymbol
+              )
+            UNDISCOUNTED_ONLY =
+              T.let(
+                :UNDISCOUNTED_ONLY,
+                MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
+        module ResetFrequency
+          extend MetronomeSDK::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                MetronomeSDK::ContractV2::SpendTracker::ResetFrequency
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          BILLING_PERIOD =
+            T.let(
+              :BILLING_PERIOD,
+              MetronomeSDK::ContractV2::SpendTracker::ResetFrequency::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                MetronomeSDK::ContractV2::SpendTracker::ResetFrequency::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        class AccumulatedSpend < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractV2::SpendTracker::AccumulatedSpend,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          sig { returns(Float) }
+          attr_accessor :amount
+
+          sig { returns(Time) }
+          attr_accessor :period_ending_before
+
+          sig { returns(Time) }
+          attr_accessor :period_starting_at
+
+          sig do
+            params(
+              amount: Float,
+              period_ending_before: Time,
+              period_starting_at: Time
+            ).returns(T.attached_class)
+          end
+          def self.new(amount:, period_ending_before:, period_starting_at:)
+          end
+
+          sig do
+            override.returns(
+              {
+                amount: Float,
+                period_ending_before: Time,
+                period_starting_at: Time
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+
       class Subscription < MetronomeSDK::Internal::Type::BaseModel
         OrHash =
           T.type_alias do
@@ -6765,6 +7666,23 @@ module MetronomeSDK
         sig { params(id: String).void }
         attr_writer :id
 
+        sig do
+          returns(
+            T.nilable(
+              MetronomeSDK::ContractV2::Subscription::BillingCycleConfig
+            )
+          )
+        end
+        attr_reader :billing_cycle_config
+
+        sig do
+          params(
+            billing_cycle_config:
+              MetronomeSDK::ContractV2::Subscription::BillingCycleConfig::OrHash
+          ).void
+        end
+        attr_writer :billing_cycle_config
+
         # Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
         sig { returns(T.nilable(T::Hash[Symbol, String])) }
         attr_reader :custom_fields
@@ -6827,6 +7745,8 @@ module MetronomeSDK
             subscription_rate:
               MetronomeSDK::ContractV2::Subscription::SubscriptionRate::OrHash,
             id: String,
+            billing_cycle_config:
+              MetronomeSDK::ContractV2::Subscription::BillingCycleConfig::OrHash,
             custom_fields: T::Hash[Symbol, String],
             description: String,
             ending_before: Time,
@@ -6857,6 +7777,7 @@ module MetronomeSDK
           starting_at:,
           subscription_rate:,
           id: nil,
+          billing_cycle_config: nil,
           # Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
           custom_fields: nil,
           description: nil,
@@ -6885,6 +7806,8 @@ module MetronomeSDK
               subscription_rate:
                 MetronomeSDK::ContractV2::Subscription::SubscriptionRate,
               id: String,
+              billing_cycle_config:
+                MetronomeSDK::ContractV2::Subscription::BillingCycleConfig,
               custom_fields: T::Hash[Symbol, String],
               description: String,
               ending_before: Time,
@@ -7124,14 +8047,33 @@ module MetronomeSDK
           sig { returns(T::Boolean) }
           attr_accessor :is_prorated
 
+          sig do
+            returns(
+              T.nilable(
+                MetronomeSDK::ContractV2::Subscription::Proration::Rounding
+              )
+            )
+          end
+          attr_reader :rounding
+
+          sig do
+            params(
+              rounding:
+                MetronomeSDK::ContractV2::Subscription::Proration::Rounding::OrHash
+            ).void
+          end
+          attr_writer :rounding
+
           sig do
             params(
               invoice_behavior:
                 MetronomeSDK::ContractV2::Subscription::Proration::InvoiceBehavior::OrSymbol,
-              is_prorated: T::Boolean
+              is_prorated: T::Boolean,
+              rounding:
+                MetronomeSDK::ContractV2::Subscription::Proration::Rounding::OrHash
             ).returns(T.attached_class)
           end
-          def self.new(invoice_behavior:, is_prorated:)
+          def self.new(invoice_behavior:, is_prorated:, rounding: nil)
           end
 
           sig do
@@ -7139,7 +8081,9 @@ module MetronomeSDK
               {
                 invoice_behavior:
                   MetronomeSDK::ContractV2::Subscription::Proration::InvoiceBehavior::TaggedSymbol,
-                is_prorated: T::Boolean
+                is_prorated: T::Boolean,
+                rounding:
+                  MetronomeSDK::ContractV2::Subscription::Proration::Rounding
               }
             )
           end
@@ -7179,6 +8123,96 @@ module MetronomeSDK
             def self.values
             end
           end
+
+          class Rounding < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::ContractV2::Subscription::Proration::Rounding,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            # Number of decimal places to round to. Applied directly to the stored monetary
+            # representation. Negative values round to powers of 10 (e.g., -2 rounds to
+            # nearest 100 in the stored unit).
+            sig { returns(Float) }
+            attr_accessor :decimal_places
+
+            sig do
+              returns(
+                MetronomeSDK::ContractV2::Subscription::Proration::Rounding::RoundingMethod::TaggedSymbol
+              )
+            end
+            attr_accessor :rounding_method
+
+            sig do
+              params(
+                decimal_places: Float,
+                rounding_method:
+                  MetronomeSDK::ContractV2::Subscription::Proration::Rounding::RoundingMethod::OrSymbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Number of decimal places to round to. Applied directly to the stored monetary
+              # representation. Negative values round to powers of 10 (e.g., -2 rounds to
+              # nearest 100 in the stored unit).
+              decimal_places:,
+              rounding_method:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  decimal_places: Float,
+                  rounding_method:
+                    MetronomeSDK::ContractV2::Subscription::Proration::Rounding::RoundingMethod::TaggedSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            module RoundingMethod
+              extend MetronomeSDK::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    MetronomeSDK::ContractV2::Subscription::Proration::Rounding::RoundingMethod
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              HALF_UP =
+                T.let(
+                  :HALF_UP,
+                  MetronomeSDK::ContractV2::Subscription::Proration::Rounding::RoundingMethod::TaggedSymbol
+                )
+              FLOOR =
+                T.let(
+                  :FLOOR,
+                  MetronomeSDK::ContractV2::Subscription::Proration::Rounding::RoundingMethod::TaggedSymbol
+                )
+              CEILING =
+                T.let(
+                  :CEILING,
+                  MetronomeSDK::ContractV2::Subscription::Proration::Rounding::RoundingMethod::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    MetronomeSDK::ContractV2::Subscription::Proration::Rounding::RoundingMethod::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
         end
 
         # Determines how the subscription's quantity is controlled. Defaults to
@@ -7388,6 +8422,93 @@ module MetronomeSDK
           end
         end
 
+        class BillingCycleConfig < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractV2::Subscription::BillingCycleConfig,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          # The date this subscription's billing cycle is anchored to.
+          sig { returns(Time) }
+          attr_accessor :anchor_date
+
+          # Controls whether this subscription consolidates onto usage invoices or gets its
+          # own scheduled invoice.
+          sig do
+            returns(
+              MetronomeSDK::ContractV2::Subscription::BillingCycleConfig::InvoicePlacement::TaggedSymbol
+            )
+          end
+          attr_accessor :invoice_placement
+
+          sig do
+            params(
+              anchor_date: Time,
+              invoice_placement:
+                MetronomeSDK::ContractV2::Subscription::BillingCycleConfig::InvoicePlacement::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The date this subscription's billing cycle is anchored to.
+            anchor_date:,
+            # Controls whether this subscription consolidates onto usage invoices or gets its
+            # own scheduled invoice.
+            invoice_placement:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                anchor_date: Time,
+                invoice_placement:
+                  MetronomeSDK::ContractV2::Subscription::BillingCycleConfig::InvoicePlacement::TaggedSymbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # Controls whether this subscription consolidates onto usage invoices or gets its
+          # own scheduled invoice.
+          module InvoicePlacement
+            extend MetronomeSDK::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  MetronomeSDK::ContractV2::Subscription::BillingCycleConfig::InvoicePlacement
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ON_SCHEDULED_INVOICE =
+              T.let(
+                :ON_SCHEDULED_INVOICE,
+                MetronomeSDK::ContractV2::Subscription::BillingCycleConfig::InvoicePlacement::TaggedSymbol
+              )
+            ON_USAGE_INVOICE =
+              T.let(
+                :ON_USAGE_INVOICE,
+                MetronomeSDK::ContractV2::Subscription::BillingCycleConfig::InvoicePlacement::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  MetronomeSDK::ContractV2::Subscription::BillingCycleConfig::InvoicePlacement::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
         class SeatConfig < MetronomeSDK::Internal::Type::BaseModel
           OrHash =
             T.type_alias do