metronome-sdk 3.6.0 → 3.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d4d5355d04639b7153cfe94271378797fceaff008c386c001c6450f66674a584
-  data.tar.gz: 25c993147e97e4acead3048b17b7328e67b4e95274bef1893723bf806ddd9bec
+  metadata.gz: 72c947987bf3b6947462d66133a12deab29b5c7ed85c20169adfa923caf73076
+  data.tar.gz: 54e641c55d3862d539331f0716fb62feece95b6cf83e15217dedb4fbdf2dc1bc
 SHA512:
-  metadata.gz: 653c76e15fba1881dcc6e344161a61f7c0c061aba2603bdb26a3f489986c23e31d1fe77bb2134070f53333efe9efa5d37b73f206abb30b4cba33eb05f967c771
-  data.tar.gz: 3d6505e8bd6767e3873ba2d70c28bc93eac7280ae2ca126eba43a18eca5e4a113704574909e5c0a26f503204675bc407582190dd9d1f20afa91ecc98cc30def0
+  metadata.gz: 1e9d8143dcda81173e1fd5c63001d0d952a27b667194d9c1e26c2a19a1f3d0c80b82f5463d394603cd22bd0f0ab79d7ffd47faaabaf6e7633ed73a73fcbb99cd
+  data.tar.gz: fa66a0ab59ddde426e0e9ac34adae0f40d3d99e1fdb827ed4934bde394d6902b90372f7e1e69942aeb416706e6cfc9ade9a05c9267723bc5b98dd7fb1943376e

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 3.7.0 (2026-05-29)
+
+Full Changelog: [v3.6.0...v3.7.0](https://github.com/Metronome-Industries/metronome-ruby/compare/v3.6.0...v3.7.0)
+
+### Features
+
+* [LAUNCH-2814] editContract returns full edit in the response ([fd684bc](https://github.com/Metronome-Industries/metronome-ruby/commit/fd684bc491dc2083911a144ba0a455385eaf315d))
+* [orch-1860] remove all deprecated `/payments/*` endpoints from API ([1c6cdb1](https://github.com/Metronome-Industries/metronome-ruby/commit/1c6cdb1d7629e6a29adc78a1dbd460eebbbab08b))
+* create contract returns contract data ([16469e5](https://github.com/Metronome-Industries/metronome-ruby/commit/16469e57c6563dd35b5b2f3cf05893a69ec7d406))
+* nikku-orch-1723-update-create-contract ([a5de974](https://github.com/Metronome-Industries/metronome-ruby/commit/a5de9740f141a211e0435fff858ceca62d2b5359))
+
+
+### Chores
+
+* (internal) Add threshold balance specifier to contract create & edit, package create and both contract and package retrievals ([eb1049d](https://github.com/Metronome-Industries/metronome-ruby/commit/eb1049d2826865a29710c274e13cc311005a0e91))
+
 ## 3.6.0 (2026-05-18)
 
 Full Changelog: [v3.5.0...v3.6.0](https://github.com/Metronome-Industries/metronome-ruby/compare/v3.5.0...v3.6.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "metronome-sdk", "~> 3.6.0"
+gem "metronome-sdk", "~> 3.7.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -15,31 +15,6 @@ module MetronomeSDK
       #
       # We can therefore convert string values to Symbols, but can't convert other
       # values safely.
-      #
-      # @example
-      #   # `payment_status` is a `MetronomeSDK::V1::PaymentStatus`
-      #   case payment_status
-      #   when MetronomeSDK::V1::PaymentStatus::PENDING
-      #     # ...
-      #   when MetronomeSDK::V1::PaymentStatus::REQUIRES_INTERVENTION
-      #     # ...
-      #   when MetronomeSDK::V1::PaymentStatus::PAID
-      #     # ...
-      #   else
-      #     puts(payment_status)
-      #   end
-      #
-      # @example
-      #   case payment_status
-      #   in :pending
-      #     # ...
-      #   in :requires_intervention
-      #     # ...
-      #   in :paid
-      #     # ...
-      #   else
-      #     puts(payment_status)
-      #   end
       module Enum
         include MetronomeSDK::Internal::Type::Converter
         include MetronomeSDK::Internal::Util::SorbetRuntimeSupport

data/lib/metronome_sdk/models/commit.rb

@@ -171,6 +171,12 @@ module MetronomeSDK
       #   @return [Array<MetronomeSDK::Models::CommitSpecifier>, nil]
       optional :specifiers, -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::CommitSpecifier] }
 
+      # @!attribute spend_tracker_attributes
+      #   Optional attributes controlling how this commit interacts with spend trackers.
+      #
+      #   @return [MetronomeSDK::Models::Commit::SpendTrackerAttributes, nil]
+      optional :spend_tracker_attributes, -> { MetronomeSDK::Commit::SpendTrackerAttributes }
+
       # @!attribute subscription_config
       #   The subscription configuration for this commit, if it was generated from a
       #   recurring commit with a subscription attached.
@@ -187,7 +193,7 @@ module MetronomeSDK
       #   @return [String, nil]
       optional :uniqueness_key, String
 
-      # @!method initialize(id:, created_at:, product:, type:, access_schedule: nil, amount: nil, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, archived_at: nil, balance: nil, contract: nil, custom_fields: nil, description: nil, hierarchy_configuration: nil, invoice_contract: nil, invoice_schedule: nil, ledger: nil, name: nil, netsuite_sales_order_id: nil, priority: nil, rate_type: nil, recurring_commit_id: nil, rolled_over_from: nil, rollover_fraction: nil, salesforce_opportunity_id: nil, specifiers: nil, subscription_config: nil, uniqueness_key: nil)
+      # @!method initialize(id:, created_at:, product:, type:, access_schedule: nil, amount: nil, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, archived_at: nil, balance: nil, contract: nil, custom_fields: nil, description: nil, hierarchy_configuration: nil, invoice_contract: nil, invoice_schedule: nil, ledger: nil, name: nil, netsuite_sales_order_id: nil, priority: nil, rate_type: nil, recurring_commit_id: nil, rolled_over_from: nil, rollover_fraction: nil, salesforce_opportunity_id: nil, specifiers: nil, spend_tracker_attributes: nil, subscription_config: nil, uniqueness_key: nil)
       #   Some parameter documentations has been truncated, see
       #   {MetronomeSDK::Models::Commit} for more details.
       #
@@ -245,6 +251,8 @@ module MetronomeSDK
       #
       #   @param specifiers [Array<MetronomeSDK::Models::CommitSpecifier>] List of filters that determine what kind of customer usage draws down a commit o
       #
+      #   @param spend_tracker_attributes [MetronomeSDK::Models::Commit::SpendTrackerAttributes] Optional attributes controlling how this commit interacts with spend trackers.
+      #
       #   @param subscription_config [MetronomeSDK::Models::Commit::SubscriptionConfig] The subscription configuration for this commit, if it was generated from a recur
       #
       #   @param uniqueness_key [String] Prevents the creation of duplicates. If a request to create a commit or credit i
@@ -953,6 +961,24 @@ module MetronomeSDK
         #   @param contract_id [String]
       end
 
+      # @see MetronomeSDK::Models::Commit#spend_tracker_attributes
+      class SpendTrackerAttributes < MetronomeSDK::Internal::Type::BaseModel
+        # @!attribute counts_as_discounted
+        #   If true, this commit is included in spend trackers with discounted set to
+        #   DISCOUNTED_ONLY
+        #
+        #   @return [Boolean]
+        required :counts_as_discounted, MetronomeSDK::Internal::Type::Boolean
+
+        # @!method initialize(counts_as_discounted:)
+        #   Some parameter documentations has been truncated, see
+        #   {MetronomeSDK::Models::Commit::SpendTrackerAttributes} for more details.
+        #
+        #   Optional attributes controlling how this commit interacts with spend trackers.
+        #
+        #   @param counts_as_discounted [Boolean] If true, this commit is included in spend trackers with discounted set to DISCOU
+      end
+
       # @see MetronomeSDK::Models::Commit#subscription_config
       class SubscriptionConfig < MetronomeSDK::Internal::Type::BaseModel
         # @!attribute allocation

data/lib/metronome_sdk/models/contract.rb

@@ -76,6 +76,13 @@ module MetronomeSDK
       #   @return [MetronomeSDK::Models::SpendThresholdConfiguration, nil]
       optional :spend_threshold_configuration, -> { MetronomeSDK::SpendThresholdConfiguration }
 
+      # @!attribute spend_trackers
+      #   Spend trackers attached to this contract.
+      #
+      #   @return [Array<MetronomeSDK::Models::Contract::SpendTracker>, nil]
+      optional :spend_trackers,
+               -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Contract::SpendTracker] }
+
       # @!attribute subscriptions
       #   List of subscriptions on the contract.
       #
@@ -90,7 +97,7 @@ module MetronomeSDK
       #   @return [String, nil]
       optional :uniqueness_key, String
 
-      # @!method initialize(id:, amendments:, current:, customer_id:, initial:, archived_at: nil, custom_fields: nil, customer_billing_provider_configuration: nil, package_id: nil, prepaid_balance_threshold_configuration: nil, scheduled_charges_on_usage_invoices: nil, spend_threshold_configuration: nil, subscriptions: nil, uniqueness_key: nil)
+      # @!method initialize(id:, amendments:, current:, customer_id:, initial:, archived_at: nil, custom_fields: nil, customer_billing_provider_configuration: nil, package_id: nil, prepaid_balance_threshold_configuration: nil, scheduled_charges_on_usage_invoices: nil, spend_threshold_configuration: nil, spend_trackers: nil, subscriptions: nil, uniqueness_key: nil)
       #   Some parameter documentations has been truncated, see
       #   {MetronomeSDK::Models::Contract} for more details.
       #
@@ -118,6 +125,8 @@ module MetronomeSDK
       #
       #   @param spend_threshold_configuration [MetronomeSDK::Models::SpendThresholdConfiguration]
       #
+      #   @param spend_trackers [Array<MetronomeSDK::Models::Contract::SpendTracker>] Spend trackers attached to this contract.
+      #
       #   @param subscriptions [Array<MetronomeSDK::Models::Subscription>] List of subscriptions on the contract.
       #
       #   @param uniqueness_key [String] Prevents the creation of duplicates. If a request to create a record is made wit
@@ -400,6 +409,136 @@ module MetronomeSDK
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      class SpendTracker < MetronomeSDK::Internal::Type::BaseModel
+        # @!attribute alias_
+        #   Human-readable identifier, unique per contract.
+        #
+        #   @return [String]
+        required :alias_, String, api_name: :alias
+
+        # @!attribute applicable_spend_specifiers
+        #
+        #   @return [Array<MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier>]
+        required :applicable_spend_specifiers,
+                 -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Contract::SpendTracker::ApplicableSpendSpecifier] }
+
+        # @!attribute credit_type_id
+        #
+        #   @return [String]
+        required :credit_type_id, String
+
+        # @!attribute reset_frequency
+        #
+        #   @return [Symbol, MetronomeSDK::Models::Contract::SpendTracker::ResetFrequency]
+        required :reset_frequency, enum: -> { MetronomeSDK::Contract::SpendTracker::ResetFrequency }
+
+        # @!attribute accumulated_spend
+        #
+        #   @return [MetronomeSDK::Models::Contract::SpendTracker::AccumulatedSpend, nil]
+        optional :accumulated_spend, -> { MetronomeSDK::Contract::SpendTracker::AccumulatedSpend }
+
+        # @!method initialize(alias_:, applicable_spend_specifiers:, credit_type_id:, reset_frequency:, accumulated_spend: nil)
+        #   @param alias_ [String] Human-readable identifier, unique per contract.
+        #
+        #   @param applicable_spend_specifiers [Array<MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier>]
+        #
+        #   @param credit_type_id [String]
+        #
+        #   @param reset_frequency [Symbol, MetronomeSDK::Models::Contract::SpendTracker::ResetFrequency]
+        #
+        #   @param accumulated_spend [MetronomeSDK::Models::Contract::SpendTracker::AccumulatedSpend]
+
+        class ApplicableSpendSpecifier < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute sources
+          #
+          #   @return [Array<Symbol, MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::Source>]
+          required :sources,
+                   -> { MetronomeSDK::Internal::Type::ArrayOf[enum: MetronomeSDK::Contract::SpendTracker::ApplicableSpendSpecifier::Source] }
+
+          # @!attribute spend_type
+          #
+          #   @return [Symbol, MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::SpendType]
+          required :spend_type,
+                   enum: -> { MetronomeSDK::Contract::SpendTracker::ApplicableSpendSpecifier::SpendType }
+
+          # @!attribute discounted
+          #
+          #   @return [Symbol, MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::Discounted, nil]
+          optional :discounted,
+                   enum: -> { MetronomeSDK::Contract::SpendTracker::ApplicableSpendSpecifier::Discounted }
+
+          # @!method initialize(sources:, spend_type:, discounted: nil)
+          #   @param sources [Array<Symbol, MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::Source>]
+          #   @param spend_type [Symbol, MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::SpendType]
+          #   @param discounted [Symbol, MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::Discounted]
+
+          module Source
+            extend MetronomeSDK::Internal::Type::Enum
+
+            THRESHOLD_RECHARGE = :THRESHOLD_RECHARGE
+            MANUAL = :MANUAL
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier#spend_type
+          module SpendType
+            extend MetronomeSDK::Internal::Type::Enum
+
+            COMMIT_PURCHASE = :COMMIT_PURCHASE
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier#discounted
+          module Discounted
+            extend MetronomeSDK::Internal::Type::Enum
+
+            ANY = :ANY
+            DISCOUNTED_ONLY = :DISCOUNTED_ONLY
+            UNDISCOUNTED_ONLY = :UNDISCOUNTED_ONLY
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # @see MetronomeSDK::Models::Contract::SpendTracker#reset_frequency
+        module ResetFrequency
+          extend MetronomeSDK::Internal::Type::Enum
+
+          BILLING_PERIOD = :BILLING_PERIOD
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see MetronomeSDK::Models::Contract::SpendTracker#accumulated_spend
+        class AccumulatedSpend < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute amount
+          #
+          #   @return [Float]
+          required :amount, Float
+
+          # @!attribute period_ending_before
+          #
+          #   @return [Time]
+          required :period_ending_before, Time
+
+          # @!attribute period_starting_at
+          #
+          #   @return [Time]
+          required :period_starting_at, Time
+
+          # @!method initialize(amount:, period_ending_before:, period_starting_at:)
+          #   @param amount [Float]
+          #   @param period_ending_before [Time]
+          #   @param period_starting_at [Time]
+        end
+      end
     end
   end
 end

data/lib/metronome_sdk/models/contract_v2.rb

@@ -197,6 +197,13 @@ module MetronomeSDK
       #   @return [MetronomeSDK::Models::SpendThresholdConfigurationV2, nil]
       optional :spend_threshold_configuration, -> { MetronomeSDK::SpendThresholdConfigurationV2 }
 
+      # @!attribute spend_trackers
+      #   Spend trackers attached to this contract.
+      #
+      #   @return [Array<MetronomeSDK::Models::ContractV2::SpendTracker>, nil]
+      optional :spend_trackers,
+               -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::ContractV2::SpendTracker] }
+
       # @!attribute subscriptions
       #   List of subscriptions on the contract.
       #
@@ -215,7 +222,7 @@ module MetronomeSDK
       #   @return [String, nil]
       optional :uniqueness_key, String
 
-      # @!method initialize(id:, commits:, created_at:, created_by:, customer_id:, overrides:, scheduled_charges:, starting_at:, transitions:, usage_filter:, usage_statement_schedule:, archived_at: nil, credits: nil, custom_fields: nil, customer_billing_provider_configuration: nil, discounts: nil, ending_before: nil, has_more: nil, hierarchy_configuration: nil, multiplier_override_prioritization: nil, name: nil, net_payment_terms_days: nil, netsuite_sales_order_id: nil, prepaid_balance_threshold_configuration: nil, priority: nil, professional_services: nil, rate_card_id: nil, recurring_commits: nil, recurring_credits: nil, reseller_royalties: nil, salesforce_opportunity_id: nil, scheduled_charges_on_usage_invoices: nil, spend_threshold_configuration: nil, subscriptions: nil, total_contract_value: nil, uniqueness_key: nil)
+      # @!method initialize(id:, commits:, created_at:, created_by:, customer_id:, overrides:, scheduled_charges:, starting_at:, transitions:, usage_filter:, usage_statement_schedule:, archived_at: nil, credits: nil, custom_fields: nil, customer_billing_provider_configuration: nil, discounts: nil, ending_before: nil, has_more: nil, hierarchy_configuration: nil, multiplier_override_prioritization: nil, name: nil, net_payment_terms_days: nil, netsuite_sales_order_id: nil, prepaid_balance_threshold_configuration: nil, priority: nil, professional_services: nil, rate_card_id: nil, recurring_commits: nil, recurring_credits: nil, reseller_royalties: nil, salesforce_opportunity_id: nil, scheduled_charges_on_usage_invoices: nil, spend_threshold_configuration: nil, spend_trackers: nil, subscriptions: nil, total_contract_value: nil, uniqueness_key: nil)
       #   Some parameter documentations has been truncated, see
       #   {MetronomeSDK::Models::ContractV2} for more details.
       #
@@ -285,6 +292,8 @@ module MetronomeSDK
       #
       #   @param spend_threshold_configuration [MetronomeSDK::Models::SpendThresholdConfigurationV2]
       #
+      #   @param spend_trackers [Array<MetronomeSDK::Models::ContractV2::SpendTracker>] Spend trackers attached to this contract.
+      #
       #   @param subscriptions [Array<MetronomeSDK::Models::ContractV2::Subscription>] List of subscriptions on the contract.
       #
       #   @param total_contract_value [Float]
@@ -452,13 +461,19 @@ module MetronomeSDK
         #   @return [Array<MetronomeSDK::Models::CommitSpecifier>, nil]
         optional :specifiers, -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::CommitSpecifier] }
 
+        # @!attribute spend_tracker_attributes
+        #   Optional attributes controlling how this commit interacts with spend trackers.
+        #
+        #   @return [MetronomeSDK::Models::ContractV2::Commit::SpendTrackerAttributes, nil]
+        optional :spend_tracker_attributes, -> { MetronomeSDK::ContractV2::Commit::SpendTrackerAttributes }
+
         # @!attribute subscription_config
         #   Attach a subscription to the recurring commit/credit.
         #
         #   @return [MetronomeSDK::Models::RecurringCommitSubscriptionConfig, nil]
         optional :subscription_config, -> { MetronomeSDK::RecurringCommitSubscriptionConfig }
 
-        # @!method initialize(id:, created_at:, product:, type:, access_schedule: nil, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, archived_at: nil, balance: nil, contract: nil, custom_fields: nil, description: nil, hierarchy_configuration: nil, invoice_contract: nil, invoice_schedule: nil, ledger: nil, name: nil, netsuite_sales_order_id: nil, priority: nil, rate_type: nil, recurring_commit_id: nil, rolled_over_from: nil, rollover_fraction: nil, salesforce_opportunity_id: nil, specifiers: nil, subscription_config: nil)
+        # @!method initialize(id:, created_at:, product:, type:, access_schedule: nil, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, archived_at: nil, balance: nil, contract: nil, custom_fields: nil, description: nil, hierarchy_configuration: nil, invoice_contract: nil, invoice_schedule: nil, ledger: nil, name: nil, netsuite_sales_order_id: nil, priority: nil, rate_type: nil, recurring_commit_id: nil, rolled_over_from: nil, rollover_fraction: nil, salesforce_opportunity_id: nil, specifiers: nil, spend_tracker_attributes: nil, subscription_config: nil)
         #   Some parameter documentations has been truncated, see
         #   {MetronomeSDK::Models::ContractV2::Commit} for more details.
         #
@@ -514,6 +529,8 @@ module MetronomeSDK
         #
         #   @param specifiers [Array<MetronomeSDK::Models::CommitSpecifier>] List of filters that determine what kind of customer usage draws down a commit o
         #
+        #   @param spend_tracker_attributes [MetronomeSDK::Models::ContractV2::Commit::SpendTrackerAttributes] Optional attributes controlling how this commit interacts with spend trackers.
+        #
         #   @param subscription_config [MetronomeSDK::Models::RecurringCommitSubscriptionConfig] Attach a subscription to the recurring commit/credit.
 
         # @see MetronomeSDK::Models::ContractV2::Commit#product
@@ -1230,6 +1247,25 @@ module MetronomeSDK
           #   @param commit_id [String]
           #   @param contract_id [String]
         end
+
+        # @see MetronomeSDK::Models::ContractV2::Commit#spend_tracker_attributes
+        class SpendTrackerAttributes < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute counts_as_discounted
+          #   If true, this commit is included in spend trackers with discounted set to
+          #   DISCOUNTED_ONLY
+          #
+          #   @return [Boolean]
+          required :counts_as_discounted, MetronomeSDK::Internal::Type::Boolean
+
+          # @!method initialize(counts_as_discounted:)
+          #   Some parameter documentations has been truncated, see
+          #   {MetronomeSDK::Models::ContractV2::Commit::SpendTrackerAttributes} for more
+          #   details.
+          #
+          #   Optional attributes controlling how this commit interacts with spend trackers.
+          #
+          #   @param counts_as_discounted [Boolean] If true, this commit is included in spend trackers with discounted set to DISCOU
+        end
       end
 
       class Override < MetronomeSDK::Internal::Type::BaseModel
@@ -3306,6 +3342,136 @@ module MetronomeSDK
         #   @return [Array<Symbol>]
       end
 
+      class SpendTracker < MetronomeSDK::Internal::Type::BaseModel
+        # @!attribute alias_
+        #   Human-readable identifier, unique per contract.
+        #
+        #   @return [String]
+        required :alias_, String, api_name: :alias
+
+        # @!attribute applicable_spend_specifiers
+        #
+        #   @return [Array<MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier>]
+        required :applicable_spend_specifiers,
+                 -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier] }
+
+        # @!attribute credit_type_id
+        #
+        #   @return [String]
+        required :credit_type_id, String
+
+        # @!attribute reset_frequency
+        #
+        #   @return [Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ResetFrequency]
+        required :reset_frequency, enum: -> { MetronomeSDK::ContractV2::SpendTracker::ResetFrequency }
+
+        # @!attribute accumulated_spend
+        #
+        #   @return [MetronomeSDK::Models::ContractV2::SpendTracker::AccumulatedSpend, nil]
+        optional :accumulated_spend, -> { MetronomeSDK::ContractV2::SpendTracker::AccumulatedSpend }
+
+        # @!method initialize(alias_:, applicable_spend_specifiers:, credit_type_id:, reset_frequency:, accumulated_spend: nil)
+        #   @param alias_ [String] Human-readable identifier, unique per contract.
+        #
+        #   @param applicable_spend_specifiers [Array<MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier>]
+        #
+        #   @param credit_type_id [String]
+        #
+        #   @param reset_frequency [Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ResetFrequency]
+        #
+        #   @param accumulated_spend [MetronomeSDK::Models::ContractV2::SpendTracker::AccumulatedSpend]
+
+        class ApplicableSpendSpecifier < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute sources
+          #
+          #   @return [Array<Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier::Source>]
+          required :sources,
+                   -> { MetronomeSDK::Internal::Type::ArrayOf[enum: MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Source] }
+
+          # @!attribute spend_type
+          #
+          #   @return [Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier::SpendType]
+          required :spend_type,
+                   enum: -> { MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::SpendType }
+
+          # @!attribute discounted
+          #
+          #   @return [Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted, nil]
+          optional :discounted,
+                   enum: -> { MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted }
+
+          # @!method initialize(sources:, spend_type:, discounted: nil)
+          #   @param sources [Array<Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier::Source>]
+          #   @param spend_type [Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier::SpendType]
+          #   @param discounted [Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted]
+
+          module Source
+            extend MetronomeSDK::Internal::Type::Enum
+
+            THRESHOLD_RECHARGE = :THRESHOLD_RECHARGE
+            MANUAL = :MANUAL
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier#spend_type
+          module SpendType
+            extend MetronomeSDK::Internal::Type::Enum
+
+            COMMIT_PURCHASE = :COMMIT_PURCHASE
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier#discounted
+          module Discounted
+            extend MetronomeSDK::Internal::Type::Enum
+
+            ANY = :ANY
+            DISCOUNTED_ONLY = :DISCOUNTED_ONLY
+            UNDISCOUNTED_ONLY = :UNDISCOUNTED_ONLY
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # @see MetronomeSDK::Models::ContractV2::SpendTracker#reset_frequency
+        module ResetFrequency
+          extend MetronomeSDK::Internal::Type::Enum
+
+          BILLING_PERIOD = :BILLING_PERIOD
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see MetronomeSDK::Models::ContractV2::SpendTracker#accumulated_spend
+        class AccumulatedSpend < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute amount
+          #
+          #   @return [Float]
+          required :amount, Float
+
+          # @!attribute period_ending_before
+          #
+          #   @return [Time]
+          required :period_ending_before, Time
+
+          # @!attribute period_starting_at
+          #
+          #   @return [Time]
+          required :period_starting_at, Time
+
+          # @!method initialize(amount:, period_ending_before:, period_starting_at:)
+          #   @param amount [Float]
+          #   @param period_ending_before [Time]
+          #   @param period_starting_at [Time]
+        end
+      end
+
       class Subscription < MetronomeSDK::Internal::Type::BaseModel
         # @!attribute billing_periods
         #   Previous, current, and next billing periods for the subscription.