metronome-sdk 3.4.0 → 3.6.0

data/rbi/metronome_sdk/models/contract_v2.rbi

@@ -287,11 +287,16 @@ module MetronomeSDK
       attr_writer :spend_threshold_configuration
 
       # List of subscriptions on the contract.
-      sig { returns(T.nilable(T::Array[MetronomeSDK::Subscription])) }
+      sig do
+        returns(T.nilable(T::Array[MetronomeSDK::ContractV2::Subscription]))
+      end
       attr_reader :subscriptions
 
       sig do
-        params(subscriptions: T::Array[MetronomeSDK::Subscription::OrHash]).void
+        params(
+          subscriptions:
+            T::Array[MetronomeSDK::ContractV2::Subscription::OrHash]
+        ).void
       end
       attr_writer :subscriptions
 
@@ -356,7 +361,8 @@ module MetronomeSDK
             MetronomeSDK::ContractV2::ScheduledChargesOnUsageInvoices::OrSymbol,
           spend_threshold_configuration:
             MetronomeSDK::SpendThresholdConfigurationV2::OrHash,
-          subscriptions: T::Array[MetronomeSDK::Subscription::OrHash],
+          subscriptions:
+            T::Array[MetronomeSDK::ContractV2::Subscription::OrHash],
           total_contract_value: Float,
           uniqueness_key: String
         ).returns(T.attached_class)
@@ -470,7 +476,7 @@ module MetronomeSDK
               MetronomeSDK::ContractV2::ScheduledChargesOnUsageInvoices::TaggedSymbol,
             spend_threshold_configuration:
               MetronomeSDK::SpendThresholdConfigurationV2,
-            subscriptions: T::Array[MetronomeSDK::Subscription],
+            subscriptions: T::Array[MetronomeSDK::ContractV2::Subscription],
             total_contract_value: Float,
             uniqueness_key: String
           }
@@ -2345,6 +2351,9 @@ module MetronomeSDK
         sig { returns(String) }
         attr_accessor :id
 
+        sig { returns(Time) }
+        attr_accessor :created_at
+
         sig { returns(Time) }
         attr_accessor :starting_at
 
@@ -2465,6 +2474,7 @@ module MetronomeSDK
         sig do
           params(
             id: String,
+            created_at: Time,
             starting_at: Time,
             applicable_product_tags: T::Array[String],
             ending_before: Time,
@@ -2486,6 +2496,7 @@ module MetronomeSDK
         end
         def self.new(
           id:,
+          created_at:,
           starting_at:,
           applicable_product_tags: nil,
           ending_before: nil,
@@ -2506,6 +2517,7 @@ module MetronomeSDK
           override.returns(
             {
               id: String,
+              created_at: Time,
               starting_at: Time,
               applicable_product_tags: T::Array[String],
               ending_before: Time,
@@ -2592,12 +2604,6 @@ module MetronomeSDK
           sig { params(recurring_commit_ids: T::Array[String]).void }
           attr_writer :recurring_commit_ids
 
-          sig { returns(T.nilable(T::Array[String])) }
-          attr_reader :recurring_credit_ids
-
-          sig { params(recurring_credit_ids: T::Array[String]).void }
-          attr_writer :recurring_credit_ids
-
           sig do
             params(
               billing_frequency:
@@ -2607,8 +2613,7 @@ module MetronomeSDK
               pricing_group_values: T::Hash[Symbol, String],
               product_id: String,
               product_tags: T::Array[String],
-              recurring_commit_ids: T::Array[String],
-              recurring_credit_ids: T::Array[String]
+              recurring_commit_ids: T::Array[String]
             ).returns(T.attached_class)
           end
           def self.new(
@@ -2618,8 +2623,7 @@ module MetronomeSDK
             pricing_group_values: nil,
             product_id: nil,
             product_tags: nil,
-            recurring_commit_ids: nil,
-            recurring_credit_ids: nil
+            recurring_commit_ids: nil
           )
           end
 
@@ -2633,8 +2637,7 @@ module MetronomeSDK
                 pricing_group_values: T::Hash[Symbol, String],
                 product_id: String,
                 product_tags: T::Array[String],
-                recurring_commit_ids: T::Array[String],
-                recurring_credit_ids: T::Array[String]
+                recurring_commit_ids: T::Array[String]
               }
             )
           end
@@ -3214,6 +3217,12 @@ module MetronomeSDK
         sig { params(applicable_product_tags: T::Array[String]).void }
         attr_writer :applicable_product_tags
 
+        sig { returns(T.nilable(Time)) }
+        attr_reader :archived_at
+
+        sig { params(archived_at: Time).void }
+        attr_writer :archived_at
+
         # The current balance of the credit or commit. This balance reflects the amount of
         # credit or commit that the customer has access to use at this moment - thus,
         # expired and upcoming credit or commit segments contribute 0 to the balance. The
@@ -3295,7 +3304,8 @@ module MetronomeSDK
                   MetronomeSDK::ContractV2::Credit::Ledger::CreditCanceledLedgerEntry::OrHash,
                   MetronomeSDK::ContractV2::Credit::Ledger::CreditCreditedLedgerEntry::OrHash,
                   MetronomeSDK::ContractV2::Credit::Ledger::CreditManualLedgerEntry::OrHash,
-                  MetronomeSDK::ContractV2::Credit::Ledger::CreditSeatBasedAdjustmentLedgerEntry::OrHash
+                  MetronomeSDK::ContractV2::Credit::Ledger::CreditSeatBasedAdjustmentLedgerEntry::OrHash,
+                  MetronomeSDK::ContractV2::Credit::Ledger::CreditRolloverLedgerEntry::OrHash
                 )
               ]
           ).void
@@ -3330,6 +3340,19 @@ module MetronomeSDK
         sig { params(recurring_credit_id: String).void }
         attr_writer :recurring_credit_id
 
+        sig do
+          returns(T.nilable(MetronomeSDK::ContractV2::Credit::RolledOverFrom))
+        end
+        attr_reader :rolled_over_from
+
+        sig do
+          params(
+            rolled_over_from:
+              MetronomeSDK::ContractV2::Credit::RolledOverFrom::OrHash
+          ).void
+        end
+        attr_writer :rolled_over_from
+
         # This field's availability is dependent on your client's configuration.
         sig { returns(T.nilable(String)) }
         attr_reader :salesforce_opportunity_id
@@ -3373,6 +3396,7 @@ module MetronomeSDK
             applicable_contract_ids: T::Array[String],
             applicable_product_ids: T::Array[String],
             applicable_product_tags: T::Array[String],
+            archived_at: Time,
             balance: Float,
             contract: MetronomeSDK::ContractV2::Credit::Contract::OrHash,
             created_at: Time,
@@ -3389,13 +3413,16 @@ module MetronomeSDK
                   MetronomeSDK::ContractV2::Credit::Ledger::CreditCanceledLedgerEntry::OrHash,
                   MetronomeSDK::ContractV2::Credit::Ledger::CreditCreditedLedgerEntry::OrHash,
                   MetronomeSDK::ContractV2::Credit::Ledger::CreditManualLedgerEntry::OrHash,
-                  MetronomeSDK::ContractV2::Credit::Ledger::CreditSeatBasedAdjustmentLedgerEntry::OrHash
+                  MetronomeSDK::ContractV2::Credit::Ledger::CreditSeatBasedAdjustmentLedgerEntry::OrHash,
+                  MetronomeSDK::ContractV2::Credit::Ledger::CreditRolloverLedgerEntry::OrHash
                 )
               ],
             name: String,
             netsuite_sales_order_id: String,
             priority: Float,
             recurring_credit_id: String,
+            rolled_over_from:
+              MetronomeSDK::ContractV2::Credit::RolledOverFrom::OrHash,
             salesforce_opportunity_id: String,
             specifiers: T::Array[MetronomeSDK::CommitSpecifier::OrHash],
             subscription_config:
@@ -3411,6 +3438,7 @@ module MetronomeSDK
           applicable_contract_ids: nil,
           applicable_product_ids: nil,
           applicable_product_tags: nil,
+          archived_at: nil,
           # The current balance of the credit or commit. This balance reflects the amount of
           # credit or commit that the customer has access to use at this moment - thus,
           # expired and upcoming credit or commit segments contribute 0 to the balance. The
@@ -3442,6 +3470,7 @@ module MetronomeSDK
           priority: nil,
           # The ID of the recurring credit that created this credit
           recurring_credit_id: nil,
+          rolled_over_from: nil,
           # This field's availability is dependent on your client's configuration.
           salesforce_opportunity_id: nil,
           # List of filters that determine what kind of customer usage draws down a commit
@@ -3463,6 +3492,7 @@ module MetronomeSDK
               applicable_contract_ids: T::Array[String],
               applicable_product_ids: T::Array[String],
               applicable_product_tags: T::Array[String],
+              archived_at: Time,
               balance: Float,
               contract: MetronomeSDK::ContractV2::Credit::Contract,
               created_at: Time,
@@ -3476,6 +3506,8 @@ module MetronomeSDK
               netsuite_sales_order_id: String,
               priority: Float,
               recurring_credit_id: String,
+              rolled_over_from:
+                MetronomeSDK::ContractV2::Credit::RolledOverFrom,
               salesforce_opportunity_id: String,
               specifiers: T::Array[MetronomeSDK::CommitSpecifier],
               subscription_config:
@@ -3564,7 +3596,8 @@ module MetronomeSDK
                 MetronomeSDK::ContractV2::Credit::Ledger::CreditCanceledLedgerEntry,
                 MetronomeSDK::ContractV2::Credit::Ledger::CreditCreditedLedgerEntry,
                 MetronomeSDK::ContractV2::Credit::Ledger::CreditManualLedgerEntry,
-                MetronomeSDK::ContractV2::Credit::Ledger::CreditSeatBasedAdjustmentLedgerEntry
+                MetronomeSDK::ContractV2::Credit::Ledger::CreditSeatBasedAdjustmentLedgerEntry,
+                MetronomeSDK::ContractV2::Credit::Ledger::CreditRolloverLedgerEntry
               )
             end
 
@@ -4195,6 +4228,98 @@ module MetronomeSDK
             end
           end
 
+          class CreditRolloverLedgerEntry < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::ContractV2::Credit::Ledger::CreditRolloverLedgerEntry,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            sig { returns(Float) }
+            attr_accessor :amount
+
+            sig { returns(String) }
+            attr_accessor :new_contract_id
+
+            sig { returns(String) }
+            attr_accessor :segment_id
+
+            sig { returns(Time) }
+            attr_accessor :timestamp
+
+            sig do
+              returns(
+                MetronomeSDK::ContractV2::Credit::Ledger::CreditRolloverLedgerEntry::Type::TaggedSymbol
+              )
+            end
+            attr_accessor :type
+
+            sig do
+              params(
+                amount: Float,
+                new_contract_id: String,
+                segment_id: String,
+                timestamp: Time,
+                type:
+                  MetronomeSDK::ContractV2::Credit::Ledger::CreditRolloverLedgerEntry::Type::OrSymbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              amount:,
+              new_contract_id:,
+              segment_id:,
+              timestamp:,
+              type:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  amount: Float,
+                  new_contract_id: String,
+                  segment_id: String,
+                  timestamp: Time,
+                  type:
+                    MetronomeSDK::ContractV2::Credit::Ledger::CreditRolloverLedgerEntry::Type::TaggedSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            module Type
+              extend MetronomeSDK::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    MetronomeSDK::ContractV2::Credit::Ledger::CreditRolloverLedgerEntry::Type
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              CREDIT_ROLLOVER =
+                T.let(
+                  :CREDIT_ROLLOVER,
+                  MetronomeSDK::ContractV2::Credit::Ledger::CreditRolloverLedgerEntry::Type::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    MetronomeSDK::ContractV2::Credit::Ledger::CreditRolloverLedgerEntry::Type::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+
           sig do
             override.returns(
               T::Array[MetronomeSDK::ContractV2::Credit::Ledger::Variants]
@@ -4203,6 +4328,34 @@ module MetronomeSDK
           def self.variants
           end
         end
+
+        class RolledOverFrom < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractV2::Credit::RolledOverFrom,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :contract_id
+
+          sig { returns(String) }
+          attr_accessor :credit_id
+
+          sig do
+            params(contract_id: String, credit_id: String).returns(
+              T.attached_class
+            )
+          end
+          def self.new(contract_id:, credit_id:)
+          end
+
+          sig { override.returns({ contract_id: String, credit_id: String }) }
+          def to_hash
+          end
+        end
       end
 
       class CustomerBillingProviderConfiguration < MetronomeSDK::Internal::Type::BaseModel
@@ -6526,6 +6679,750 @@ module MetronomeSDK
         def self.values
         end
       end
+
+      class Subscription < MetronomeSDK::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              MetronomeSDK::ContractV2::Subscription,
+              MetronomeSDK::Internal::AnyHash
+            )
+          end
+
+        # Previous, current, and next billing periods for the subscription.
+        sig { returns(MetronomeSDK::ContractV2::Subscription::BillingPeriods) }
+        attr_reader :billing_periods
+
+        sig do
+          params(
+            billing_periods:
+              MetronomeSDK::ContractV2::Subscription::BillingPeriods::OrHash
+          ).void
+        end
+        attr_writer :billing_periods
+
+        sig do
+          returns(
+            MetronomeSDK::ContractV2::Subscription::CollectionSchedule::TaggedSymbol
+          )
+        end
+        attr_accessor :collection_schedule
+
+        sig { returns(MetronomeSDK::ContractV2::Subscription::Proration) }
+        attr_reader :proration
+
+        sig do
+          params(
+            proration: MetronomeSDK::ContractV2::Subscription::Proration::OrHash
+          ).void
+        end
+        attr_writer :proration
+
+        # Determines how the subscription's quantity is controlled. Defaults to
+        # QUANTITY_ONLY. **QUANTITY_ONLY**: The subscription quantity is specified
+        # directly on the subscription. `initial_quantity` must be provided with this
+        # option. Compatible with recurring commits/credits that use POOLED allocation.
+        # **SEAT_BASED**: Use when you want to pass specific seat identifiers (e.g. add
+        # user_123) to increment and decrement a subscription quantity, rather than
+        # directly providing the quantity. You must use a **SEAT_BASED** subscription to
+        # use a linked recurring credit with an allocation per seat. `seat_config` must be
+        # provided with this option.
+        sig do
+          returns(
+            MetronomeSDK::ContractV2::Subscription::QuantityManagementMode::TaggedSymbol
+          )
+        end
+        attr_accessor :quantity_management_mode
+
+        # List of quantity schedule items for the subscription. Only includes the current
+        # quantity and future quantity changes.
+        sig do
+          returns(
+            T::Array[MetronomeSDK::ContractV2::Subscription::QuantitySchedule]
+          )
+        end
+        attr_accessor :quantity_schedule
+
+        sig { returns(Time) }
+        attr_accessor :starting_at
+
+        sig do
+          returns(MetronomeSDK::ContractV2::Subscription::SubscriptionRate)
+        end
+        attr_reader :subscription_rate
+
+        sig do
+          params(
+            subscription_rate:
+              MetronomeSDK::ContractV2::Subscription::SubscriptionRate::OrHash
+          ).void
+        end
+        attr_writer :subscription_rate
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :id
+
+        sig { params(id: String).void }
+        attr_writer :id
+
+        # Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+        sig { returns(T.nilable(T::Hash[Symbol, String])) }
+        attr_reader :custom_fields
+
+        sig { params(custom_fields: T::Hash[Symbol, String]).void }
+        attr_writer :custom_fields
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :description
+
+        sig { params(description: String).void }
+        attr_writer :description
+
+        sig { returns(T.nilable(Time)) }
+        attr_reader :ending_before
+
+        sig { params(ending_before: Time).void }
+        attr_writer :ending_before
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :fiat_credit_type_id
+
+        sig { params(fiat_credit_type_id: String).void }
+        attr_writer :fiat_credit_type_id
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :name
+
+        sig { params(name: String).void }
+        attr_writer :name
+
+        sig do
+          returns(T.nilable(MetronomeSDK::ContractV2::Subscription::SeatConfig))
+        end
+        attr_reader :seat_config
+
+        sig do
+          params(
+            seat_config:
+              MetronomeSDK::ContractV2::Subscription::SeatConfig::OrHash
+          ).void
+        end
+        attr_writer :seat_config
+
+        sig do
+          params(
+            billing_periods:
+              MetronomeSDK::ContractV2::Subscription::BillingPeriods::OrHash,
+            collection_schedule:
+              MetronomeSDK::ContractV2::Subscription::CollectionSchedule::OrSymbol,
+            proration:
+              MetronomeSDK::ContractV2::Subscription::Proration::OrHash,
+            quantity_management_mode:
+              MetronomeSDK::ContractV2::Subscription::QuantityManagementMode::OrSymbol,
+            quantity_schedule:
+              T::Array[
+                MetronomeSDK::ContractV2::Subscription::QuantitySchedule::OrHash
+              ],
+            starting_at: Time,
+            subscription_rate:
+              MetronomeSDK::ContractV2::Subscription::SubscriptionRate::OrHash,
+            id: String,
+            custom_fields: T::Hash[Symbol, String],
+            description: String,
+            ending_before: Time,
+            fiat_credit_type_id: String,
+            name: String,
+            seat_config:
+              MetronomeSDK::ContractV2::Subscription::SeatConfig::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Previous, current, and next billing periods for the subscription.
+          billing_periods:,
+          collection_schedule:,
+          proration:,
+          # Determines how the subscription's quantity is controlled. Defaults to
+          # QUANTITY_ONLY. **QUANTITY_ONLY**: The subscription quantity is specified
+          # directly on the subscription. `initial_quantity` must be provided with this
+          # option. Compatible with recurring commits/credits that use POOLED allocation.
+          # **SEAT_BASED**: Use when you want to pass specific seat identifiers (e.g. add
+          # user_123) to increment and decrement a subscription quantity, rather than
+          # directly providing the quantity. You must use a **SEAT_BASED** subscription to
+          # use a linked recurring credit with an allocation per seat. `seat_config` must be
+          # provided with this option.
+          quantity_management_mode:,
+          # List of quantity schedule items for the subscription. Only includes the current
+          # quantity and future quantity changes.
+          quantity_schedule:,
+          starting_at:,
+          subscription_rate:,
+          id: nil,
+          # Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+          custom_fields: nil,
+          description: nil,
+          ending_before: nil,
+          fiat_credit_type_id: nil,
+          name: nil,
+          seat_config: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              billing_periods:
+                MetronomeSDK::ContractV2::Subscription::BillingPeriods,
+              collection_schedule:
+                MetronomeSDK::ContractV2::Subscription::CollectionSchedule::TaggedSymbol,
+              proration: MetronomeSDK::ContractV2::Subscription::Proration,
+              quantity_management_mode:
+                MetronomeSDK::ContractV2::Subscription::QuantityManagementMode::TaggedSymbol,
+              quantity_schedule:
+                T::Array[
+                  MetronomeSDK::ContractV2::Subscription::QuantitySchedule
+                ],
+              starting_at: Time,
+              subscription_rate:
+                MetronomeSDK::ContractV2::Subscription::SubscriptionRate,
+              id: String,
+              custom_fields: T::Hash[Symbol, String],
+              description: String,
+              ending_before: Time,
+              fiat_credit_type_id: String,
+              name: String,
+              seat_config: MetronomeSDK::ContractV2::Subscription::SeatConfig
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class BillingPeriods < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractV2::Subscription::BillingPeriods,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          sig do
+            returns(
+              T.nilable(
+                MetronomeSDK::ContractV2::Subscription::BillingPeriods::Current
+              )
+            )
+          end
+          attr_reader :current
+
+          sig do
+            params(
+              current:
+                MetronomeSDK::ContractV2::Subscription::BillingPeriods::Current::OrHash
+            ).void
+          end
+          attr_writer :current
+
+          sig do
+            returns(
+              T.nilable(
+                MetronomeSDK::ContractV2::Subscription::BillingPeriods::Next
+              )
+            )
+          end
+          attr_reader :next_
+
+          sig do
+            params(
+              next_:
+                MetronomeSDK::ContractV2::Subscription::BillingPeriods::Next::OrHash
+            ).void
+          end
+          attr_writer :next_
+
+          sig do
+            returns(
+              T.nilable(
+                MetronomeSDK::ContractV2::Subscription::BillingPeriods::Previous
+              )
+            )
+          end
+          attr_reader :previous
+
+          sig do
+            params(
+              previous:
+                MetronomeSDK::ContractV2::Subscription::BillingPeriods::Previous::OrHash
+            ).void
+          end
+          attr_writer :previous
+
+          # Previous, current, and next billing periods for the subscription.
+          sig do
+            params(
+              current:
+                MetronomeSDK::ContractV2::Subscription::BillingPeriods::Current::OrHash,
+              next_:
+                MetronomeSDK::ContractV2::Subscription::BillingPeriods::Next::OrHash,
+              previous:
+                MetronomeSDK::ContractV2::Subscription::BillingPeriods::Previous::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(current: nil, next_: nil, previous: nil)
+          end
+
+          sig do
+            override.returns(
+              {
+                current:
+                  MetronomeSDK::ContractV2::Subscription::BillingPeriods::Current,
+                next_:
+                  MetronomeSDK::ContractV2::Subscription::BillingPeriods::Next,
+                previous:
+                  MetronomeSDK::ContractV2::Subscription::BillingPeriods::Previous
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Current < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::ContractV2::Subscription::BillingPeriods::Current,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            sig { returns(Time) }
+            attr_accessor :ending_before
+
+            sig { returns(Time) }
+            attr_accessor :starting_at
+
+            sig do
+              params(ending_before: Time, starting_at: Time).returns(
+                T.attached_class
+              )
+            end
+            def self.new(ending_before:, starting_at:)
+            end
+
+            sig { override.returns({ ending_before: Time, starting_at: Time }) }
+            def to_hash
+            end
+          end
+
+          class Next < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::ContractV2::Subscription::BillingPeriods::Next,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            sig { returns(Time) }
+            attr_accessor :ending_before
+
+            sig { returns(Time) }
+            attr_accessor :starting_at
+
+            sig do
+              params(ending_before: Time, starting_at: Time).returns(
+                T.attached_class
+              )
+            end
+            def self.new(ending_before:, starting_at:)
+            end
+
+            sig { override.returns({ ending_before: Time, starting_at: Time }) }
+            def to_hash
+            end
+          end
+
+          class Previous < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::ContractV2::Subscription::BillingPeriods::Previous,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            sig { returns(Time) }
+            attr_accessor :ending_before
+
+            sig { returns(Time) }
+            attr_accessor :starting_at
+
+            sig do
+              params(ending_before: Time, starting_at: Time).returns(
+                T.attached_class
+              )
+            end
+            def self.new(ending_before:, starting_at:)
+            end
+
+            sig { override.returns({ ending_before: Time, starting_at: Time }) }
+            def to_hash
+            end
+          end
+        end
+
+        module CollectionSchedule
+          extend MetronomeSDK::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                MetronomeSDK::ContractV2::Subscription::CollectionSchedule
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          ADVANCE =
+            T.let(
+              :ADVANCE,
+              MetronomeSDK::ContractV2::Subscription::CollectionSchedule::TaggedSymbol
+            )
+          ARREARS =
+            T.let(
+              :ARREARS,
+              MetronomeSDK::ContractV2::Subscription::CollectionSchedule::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                MetronomeSDK::ContractV2::Subscription::CollectionSchedule::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        class Proration < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractV2::Subscription::Proration,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          sig do
+            returns(
+              MetronomeSDK::ContractV2::Subscription::Proration::InvoiceBehavior::TaggedSymbol
+            )
+          end
+          attr_accessor :invoice_behavior
+
+          sig { returns(T::Boolean) }
+          attr_accessor :is_prorated
+
+          sig do
+            params(
+              invoice_behavior:
+                MetronomeSDK::ContractV2::Subscription::Proration::InvoiceBehavior::OrSymbol,
+              is_prorated: T::Boolean
+            ).returns(T.attached_class)
+          end
+          def self.new(invoice_behavior:, is_prorated:)
+          end
+
+          sig do
+            override.returns(
+              {
+                invoice_behavior:
+                  MetronomeSDK::ContractV2::Subscription::Proration::InvoiceBehavior::TaggedSymbol,
+                is_prorated: T::Boolean
+              }
+            )
+          end
+          def to_hash
+          end
+
+          module InvoiceBehavior
+            extend MetronomeSDK::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  MetronomeSDK::ContractV2::Subscription::Proration::InvoiceBehavior
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            BILL_IMMEDIATELY =
+              T.let(
+                :BILL_IMMEDIATELY,
+                MetronomeSDK::ContractV2::Subscription::Proration::InvoiceBehavior::TaggedSymbol
+              )
+            BILL_ON_NEXT_COLLECTION_DATE =
+              T.let(
+                :BILL_ON_NEXT_COLLECTION_DATE,
+                MetronomeSDK::ContractV2::Subscription::Proration::InvoiceBehavior::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  MetronomeSDK::ContractV2::Subscription::Proration::InvoiceBehavior::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
+        # Determines how the subscription's quantity is controlled. Defaults to
+        # QUANTITY_ONLY. **QUANTITY_ONLY**: The subscription quantity is specified
+        # directly on the subscription. `initial_quantity` must be provided with this
+        # option. Compatible with recurring commits/credits that use POOLED allocation.
+        # **SEAT_BASED**: Use when you want to pass specific seat identifiers (e.g. add
+        # user_123) to increment and decrement a subscription quantity, rather than
+        # directly providing the quantity. You must use a **SEAT_BASED** subscription to
+        # use a linked recurring credit with an allocation per seat. `seat_config` must be
+        # provided with this option.
+        module QuantityManagementMode
+          extend MetronomeSDK::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                MetronomeSDK::ContractV2::Subscription::QuantityManagementMode
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          SEAT_BASED =
+            T.let(
+              :SEAT_BASED,
+              MetronomeSDK::ContractV2::Subscription::QuantityManagementMode::TaggedSymbol
+            )
+          QUANTITY_ONLY =
+            T.let(
+              :QUANTITY_ONLY,
+              MetronomeSDK::ContractV2::Subscription::QuantityManagementMode::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                MetronomeSDK::ContractV2::Subscription::QuantityManagementMode::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        class QuantitySchedule < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractV2::Subscription::QuantitySchedule,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          sig { returns(Float) }
+          attr_accessor :quantity
+
+          sig { returns(Time) }
+          attr_accessor :starting_at
+
+          sig { returns(T.nilable(Time)) }
+          attr_reader :ending_before
+
+          sig { params(ending_before: Time).void }
+          attr_writer :ending_before
+
+          sig do
+            params(
+              quantity: Float,
+              starting_at: Time,
+              ending_before: Time
+            ).returns(T.attached_class)
+          end
+          def self.new(quantity:, starting_at:, ending_before: nil)
+          end
+
+          sig do
+            override.returns(
+              { quantity: Float, starting_at: Time, ending_before: Time }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        class SubscriptionRate < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractV2::Subscription::SubscriptionRate,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          sig do
+            returns(
+              MetronomeSDK::ContractV2::Subscription::SubscriptionRate::BillingFrequency::TaggedSymbol
+            )
+          end
+          attr_accessor :billing_frequency
+
+          sig do
+            returns(
+              MetronomeSDK::ContractV2::Subscription::SubscriptionRate::Product
+            )
+          end
+          attr_reader :product
+
+          sig do
+            params(
+              product:
+                MetronomeSDK::ContractV2::Subscription::SubscriptionRate::Product::OrHash
+            ).void
+          end
+          attr_writer :product
+
+          sig do
+            params(
+              billing_frequency:
+                MetronomeSDK::ContractV2::Subscription::SubscriptionRate::BillingFrequency::OrSymbol,
+              product:
+                MetronomeSDK::ContractV2::Subscription::SubscriptionRate::Product::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(billing_frequency:, product:)
+          end
+
+          sig do
+            override.returns(
+              {
+                billing_frequency:
+                  MetronomeSDK::ContractV2::Subscription::SubscriptionRate::BillingFrequency::TaggedSymbol,
+                product:
+                  MetronomeSDK::ContractV2::Subscription::SubscriptionRate::Product
+              }
+            )
+          end
+          def to_hash
+          end
+
+          module BillingFrequency
+            extend MetronomeSDK::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  MetronomeSDK::ContractV2::Subscription::SubscriptionRate::BillingFrequency
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            MONTHLY =
+              T.let(
+                :MONTHLY,
+                MetronomeSDK::ContractV2::Subscription::SubscriptionRate::BillingFrequency::TaggedSymbol
+              )
+            QUARTERLY =
+              T.let(
+                :QUARTERLY,
+                MetronomeSDK::ContractV2::Subscription::SubscriptionRate::BillingFrequency::TaggedSymbol
+              )
+            ANNUAL =
+              T.let(
+                :ANNUAL,
+                MetronomeSDK::ContractV2::Subscription::SubscriptionRate::BillingFrequency::TaggedSymbol
+              )
+            WEEKLY =
+              T.let(
+                :WEEKLY,
+                MetronomeSDK::ContractV2::Subscription::SubscriptionRate::BillingFrequency::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  MetronomeSDK::ContractV2::Subscription::SubscriptionRate::BillingFrequency::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          class Product < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::ContractV2::Subscription::SubscriptionRate::Product,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            sig { returns(String) }
+            attr_accessor :id
+
+            sig { returns(String) }
+            attr_accessor :name
+
+            sig { params(id: String, name: String).returns(T.attached_class) }
+            def self.new(id:, name:)
+            end
+
+            sig { override.returns({ id: String, name: String }) }
+            def to_hash
+            end
+          end
+        end
+
+        class SeatConfig < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractV2::Subscription::SeatConfig,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          # The property name, sent on usage events, that identifies the seat ID associated
+          # with the usage event. For example, the property name might be seat_id or
+          # user_id. The property must be set as a group key on billable metrics and a
+          # presentation/pricing group key on contract products. This allows linked
+          # recurring credits with an allocation per seat to be consumed by only one seat's
+          # usage.
+          sig { returns(String) }
+          attr_accessor :seat_group_key
+
+          sig { params(seat_group_key: String).returns(T.attached_class) }
+          def self.new(
+            # The property name, sent on usage events, that identifies the seat ID associated
+            # with the usage event. For example, the property name might be seat_id or
+            # user_id. The property must be set as a group key on billable metrics and a
+            # presentation/pricing group key on contract products. This allows linked
+            # recurring credits with an allocation per seat to be consumed by only one seat's
+            # usage.
+            seat_group_key:
+          )
+          end
+
+          sig { override.returns({ seat_group_key: String }) }
+          def to_hash
+          end
+        end
+      end
     end
   end
 end