metronome-sdk 3.5.0 → 3.7.0

data/lib/metronome_sdk/models/v1/contract_list_seat_balances_params.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+module MetronomeSDK
+  module Models
+    module V1
+      # @see MetronomeSDK::Resources::V1::Contracts#list_seat_balances
+      class ContractListSeatBalancesParams < MetronomeSDK::Internal::Type::BaseModel
+        extend MetronomeSDK::Internal::Type::RequestParameters::Converter
+        include MetronomeSDK::Internal::Type::RequestParameters
+
+        # @!attribute contract_id
+        #   The contract ID to retrieve seat balances for
+        #
+        #   @return [String]
+        required :contract_id, String
+
+        # @!attribute customer_id
+        #   The customer ID to retrieve seat balances for
+        #
+        #   @return [String]
+        required :customer_id, String
+
+        # @!attribute covering_date
+        #   Include only commits or credits with access that cover this specific date
+        #   (cannot be used with starting_at or ending_before).
+        #
+        #   @return [Time, nil]
+        optional :covering_date, Time
+
+        # @!attribute cursor
+        #   Page token from a previous response to retrieve the next page
+        #
+        #   @return [String, nil]
+        optional :cursor, String
+
+        # @!attribute effective_before
+        #   Include only commits or credits with access effective on or before this date
+        #   (cannot be used with covering_date).
+        #
+        #   @return [Time, nil]
+        optional :effective_before, Time
+
+        # @!attribute include_credits_and_commits
+        #   Include credits and commits in the response
+        #
+        #   @return [Boolean, nil]
+        optional :include_credits_and_commits, MetronomeSDK::Internal::Type::Boolean
+
+        # @!attribute include_ledgers
+        #   Include ledger entries for each commit and commit. `include_credits_and_commits`
+        #   must be set to `true` for `include_ledgers=true` to apply.
+        #
+        #   @return [Boolean, nil]
+        optional :include_ledgers, MetronomeSDK::Internal::Type::Boolean
+
+        # @!attribute limit
+        #   Maximum number of seats to return. Range: 1-100. Default: 25. When
+        #   `include_credits_and_commits = true`, if the total commits/credits across all
+        #   seats exceeds 100, a limit of 100 applies to the total credits and commits.
+        #   Seats are included greedily to maximize the number of seats returned. Example:
+        #   if seat 1 has 98 commits and seat 2 has 10 commits, both seats will be returned
+        #   (total: 108 commits). Each returned seat includes all of its associated credits
+        #   and commits.
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute seat_ids
+        #   Optional filter to only include specific seats.
+        #
+        #   @return [Array<String>, nil]
+        optional :seat_ids, MetronomeSDK::Internal::Type::ArrayOf[String]
+
+        # @!attribute starting_at
+        #   Include only commits or credits with access effective on or after this date
+        #   (cannot be used with covering_date).
+        #
+        #   @return [Time, nil]
+        optional :starting_at, Time
+
+        # @!attribute subscription_ids
+        #   Optional filter to only include seats from specific subscriptions. If
+        #   subscriptions ids are not mapped to SEAT_BASED subscriptions, error will be
+        #   returned.
+        #
+        #   @return [Array<String>, nil]
+        optional :subscription_ids, MetronomeSDK::Internal::Type::ArrayOf[String]
+
+        # @!method initialize(contract_id:, customer_id:, covering_date: nil, cursor: nil, effective_before: nil, include_credits_and_commits: nil, include_ledgers: nil, limit: nil, seat_ids: nil, starting_at: nil, subscription_ids: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {MetronomeSDK::Models::V1::ContractListSeatBalancesParams} for more details.
+        #
+        #   @param contract_id [String] The contract ID to retrieve seat balances for
+        #
+        #   @param customer_id [String] The customer ID to retrieve seat balances for
+        #
+        #   @param covering_date [Time] Include only commits or credits with access that cover this specific date (canno
+        #
+        #   @param cursor [String] Page token from a previous response to retrieve the next page
+        #
+        #   @param effective_before [Time] Include only commits or credits with access effective on or before this date (ca
+        #
+        #   @param include_credits_and_commits [Boolean] Include credits and commits in the response
+        #
+        #   @param include_ledgers [Boolean] Include ledger entries for each commit and commit. `include_credits_and_commits`
+        #
+        #   @param limit [Integer] Maximum number of seats to return. Range: 1-100. Default: 25.
+        #
+        #   @param seat_ids [Array<String>] Optional filter to only include specific seats.
+        #
+        #   @param starting_at [Time] Include only commits or credits with access effective on or after this date (can
+        #
+        #   @param subscription_ids [Array<String>] Optional filter to only include seats from specific subscriptions. If subscripti
+        #
+        #   @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/metronome_sdk/models/v1/contract_list_seat_balances_response.rb

@@ -0,0 +1,315 @@
+# frozen_string_literal: true
+
+module MetronomeSDK
+  module Models
+    module V1
+      # @see MetronomeSDK::Resources::V1::Contracts#list_seat_balances
+      class ContractListSeatBalancesResponse < MetronomeSDK::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Array<MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data>]
+        required :data,
+                 -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data] }
+
+        # @!attribute pagination
+        #
+        #   @return [MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Pagination]
+        required :pagination, -> { MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Pagination }
+
+        # @!method initialize(data:, pagination:)
+        #   @param data [Array<MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data>]
+        #   @param pagination [MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Pagination]
+
+        class Data < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute balances
+          #
+          #   @return [Array<MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Balance>]
+          required :balances,
+                   -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Balance] }
+
+          # @!attribute seat_id
+          #   The unique identifier for the seat
+          #
+          #   @return [String]
+          required :seat_id, String
+
+          # @!attribute commits
+          #   Array of commits applicable to this seat with their balances
+          #
+          #   @return [Array<MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Commit>, nil]
+          optional :commits,
+                   -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Commit] },
+                   nil?: true
+
+          # @!attribute credits
+          #   Array of credits applicable to this seat with their balances
+          #
+          #   @return [Array<MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Credit>, nil]
+          optional :credits,
+                   -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Credit] }
+
+          # @!method initialize(balances:, seat_id:, commits: nil, credits: nil)
+          #   @param balances [Array<MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Balance>]
+          #
+          #   @param seat_id [String] The unique identifier for the seat
+          #
+          #   @param commits [Array<MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Commit>, nil] Array of commits applicable to this seat with their balances
+          #
+          #   @param credits [Array<MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Credit>] Array of credits applicable to this seat with their balances
+
+          class Balance < MetronomeSDK::Internal::Type::BaseModel
+            # @!attribute balance
+            #   The total balance across all commits and credits for this seat, of this credit
+            #   type.
+            #
+            #   @return [Float]
+            required :balance, Float
+
+            # @!attribute credit_type_id
+            #
+            #   @return [String]
+            required :credit_type_id, String
+
+            # @!attribute starting_balance
+            #   The total initial balances of all commits and credits for this seat, of this
+            #   credit type.
+            #
+            #   @return [Float]
+            required :starting_balance, Float
+
+            # @!method initialize(balance:, credit_type_id:, starting_balance:)
+            #   Some parameter documentations has been truncated, see
+            #   {MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Balance} for
+            #   more details.
+            #
+            #   @param balance [Float] The total balance across all commits and credits for this seat, of this credit t
+            #
+            #   @param credit_type_id [String]
+            #
+            #   @param starting_balance [Float] The total initial balances of all commits and credits for this seat, of this cre
+          end
+
+          class Commit < MetronomeSDK::Internal::Type::BaseModel
+            # @!attribute id
+            #   The commit or credit ID
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute balance
+            #   The current balance for this commit for this specific seat
+            #
+            #   @return [Float]
+            required :balance, Float
+
+            # @!attribute start_date
+            #   The datetime when the commit becomes active
+            #
+            #   @return [Time]
+            required :start_date, Time
+
+            # @!attribute end_date
+            #   The datetime when the commit expires
+            #
+            #   @return [Time, nil]
+            optional :end_date, Time, nil?: true
+
+            # @!attribute ledger_entries
+            #   Transaction history for this commit for this seat (only included if
+            #   include_ledgers=true)
+            #
+            #   @return [Array<MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Commit::LedgerEntry>, nil]
+            optional :ledger_entries,
+                     -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Commit::LedgerEntry] }
+
+            # @!method initialize(id:, balance:, start_date:, end_date: nil, ledger_entries: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Commit} for
+            #   more details.
+            #
+            #   @param id [String] The commit or credit ID
+            #
+            #   @param balance [Float] The current balance for this commit for this specific seat
+            #
+            #   @param start_date [Time] The datetime when the commit becomes active
+            #
+            #   @param end_date [Time, nil] The datetime when the commit expires
+            #
+            #   @param ledger_entries [Array<MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Commit::LedgerEntry>] Transaction history for this commit for this seat (only included if include_ledg
+
+            class LedgerEntry < MetronomeSDK::Internal::Type::BaseModel
+              # @!attribute amount
+              #   Amount of the ledger entry
+              #
+              #   @return [Float]
+              required :amount, Float
+
+              # @!attribute timestamp
+              #   The datetime when the ledger is created
+              #
+              #   @return [Time]
+              required :timestamp, Time
+
+              # @!attribute type
+              #   Commit ledger type
+              #
+              #   @return [Symbol, MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Commit::LedgerEntry::Type]
+              required :type,
+                       enum: -> { MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Commit::LedgerEntry::Type }
+
+              # @!method initialize(amount:, timestamp:, type:)
+              #   @param amount [Float] Amount of the ledger entry
+              #
+              #   @param timestamp [Time] The datetime when the ledger is created
+              #
+              #   @param type [Symbol, MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Commit::LedgerEntry::Type] Commit ledger type
+
+              # Commit ledger type
+              #
+              # @see MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Commit::LedgerEntry#type
+              module Type
+                extend MetronomeSDK::Internal::Type::Enum
+
+                PREPAID_COMMIT_SEGMENT_START = :PREPAID_COMMIT_SEGMENT_START
+                PREPAID_COMMIT_AUTOMATED_INVOICE_DEDUCTION = :PREPAID_COMMIT_AUTOMATED_INVOICE_DEDUCTION
+                PREPAID_COMMIT_ROLLOVER = :PREPAID_COMMIT_ROLLOVER
+                PREPAID_COMMIT_EXPIRATION = :PREPAID_COMMIT_EXPIRATION
+                PREPAID_COMMIT_CANCELED = :PREPAID_COMMIT_CANCELED
+                PREPAID_COMMIT_CREDITED = :PREPAID_COMMIT_CREDITED
+                PREPAID_COMMIT_MANUAL = :PREPAID_COMMIT_MANUAL
+                PREPAID_COMMIT_SEAT_BASED_ADJUSTMENT = :PREPAID_COMMIT_SEAT_BASED_ADJUSTMENT
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+          end
+
+          class Credit < MetronomeSDK::Internal::Type::BaseModel
+            # @!attribute id
+            #   The credit ID
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute balance
+            #   The current balance for this credit for this specific seat
+            #
+            #   @return [Float]
+            required :balance, Float
+
+            # @!attribute start_date
+            #   The datetime when the credit becomes active
+            #
+            #   @return [Time]
+            required :start_date, Time
+
+            # @!attribute end_date
+            #   The datetime when the credit expires
+            #
+            #   @return [Time, nil]
+            optional :end_date, Time, nil?: true
+
+            # @!attribute ledger_entries
+            #   Transaction history for this credit for this seat (only included if
+            #   include_ledgers=true)
+            #
+            #   @return [Array<MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Credit::LedgerEntry>, nil]
+            optional :ledger_entries,
+                     -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Credit::LedgerEntry] }
+
+            # @!method initialize(id:, balance:, start_date:, end_date: nil, ledger_entries: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Credit} for
+            #   more details.
+            #
+            #   @param id [String] The credit ID
+            #
+            #   @param balance [Float] The current balance for this credit for this specific seat
+            #
+            #   @param start_date [Time] The datetime when the credit becomes active
+            #
+            #   @param end_date [Time, nil] The datetime when the credit expires
+            #
+            #   @param ledger_entries [Array<MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Credit::LedgerEntry>] Transaction history for this credit for this seat (only included if include_ledg
+
+            class LedgerEntry < MetronomeSDK::Internal::Type::BaseModel
+              # @!attribute amount
+              #   Amount of the ledger entry
+              #
+              #   @return [Float]
+              required :amount, Float
+
+              # @!attribute timestamp
+              #   The datetime when the ledger is created
+              #
+              #   @return [Time]
+              required :timestamp, Time
+
+              # @!attribute type
+              #   Credit ledger type
+              #
+              #   @return [Symbol, MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Credit::LedgerEntry::Type]
+              required :type,
+                       enum: -> { MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Credit::LedgerEntry::Type }
+
+              # @!method initialize(amount:, timestamp:, type:)
+              #   @param amount [Float] Amount of the ledger entry
+              #
+              #   @param timestamp [Time] The datetime when the ledger is created
+              #
+              #   @param type [Symbol, MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Credit::LedgerEntry::Type] Credit ledger type
+
+              # Credit ledger type
+              #
+              # @see MetronomeSDK::Models::V1::ContractListSeatBalancesResponse::Data::Credit::LedgerEntry#type
+              module Type
+                extend MetronomeSDK::Internal::Type::Enum
+
+                CREDIT_SEGMENT_START = :CREDIT_SEGMENT_START
+                CREDIT_AUTOMATED_INVOICE_DEDUCTION = :CREDIT_AUTOMATED_INVOICE_DEDUCTION
+                CREDIT_EXPIRATION = :CREDIT_EXPIRATION
+                CREDIT_CANCELED = :CREDIT_CANCELED
+                CREDIT_CREDITED = :CREDIT_CREDITED
+                CREDIT_MANUAL = :CREDIT_MANUAL
+                CREDIT_SEAT_BASED_ADJUSTMENT = :CREDIT_SEAT_BASED_ADJUSTMENT
+                CREDIT_ROLLOVER = :CREDIT_ROLLOVER
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+          end
+        end
+
+        # @see MetronomeSDK::Models::V1::ContractListSeatBalancesResponse#pagination
+        class Pagination < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute seats_available_for_next_page
+          #   Number of seats available to fetch in the next page
+          #
+          #   @return [Float]
+          required :seats_available_for_next_page, Float
+
+          # @!attribute seats_included
+          #   Number of seats included in this response
+          #
+          #   @return [Float]
+          required :seats_included, Float
+
+          # @!attribute next_page
+          #   Token to retrieve the next page of results. Null if no more pages available
+          #
+          #   @return [String, nil]
+          optional :next_page, String, nil?: true
+
+          # @!method initialize(seats_available_for_next_page:, seats_included:, next_page: nil)
+          #   @param seats_available_for_next_page [Float] Number of seats available to fetch in the next page
+          #
+          #   @param seats_included [Float] Number of seats included in this response
+          #
+          #   @param next_page [String, nil] Token to retrieve the next page of results. Null if no more pages available
+        end
+      end
+    end
+  end
+end

data/lib/metronome_sdk/models/v1/contracts/product_create_params.rb

@@ -108,12 +108,24 @@ module MetronomeSDK
           #   @return [MetronomeSDK::Models::V1::Contracts::QuantityRounding, nil]
           optional :quantity_rounding, -> { MetronomeSDK::V1::Contracts::QuantityRounding }, nil?: true
 
+          # @!attribute sql_breakdown_granularity
+          #   Defines the breakdown behavior when calculating usage from SQL Billable Metrics.
+          #   If set to 'service_period' (default), the usage will be evaluated once for all
+          #   events the invoice service period and the usage will be applied at the last
+          #   instant of the invoice. If set to 'hour', it will be broken down and evaluated
+          #   for each hour. For most use cases, 'hour' is recommended. The setting has no
+          #   effect for Streaming Billable Metrics.
+          #
+          #   @return [Symbol, MetronomeSDK::Models::V1::Contracts::ProductCreateParams::SqlBreakdownGranularity, nil]
+          optional :sql_breakdown_granularity,
+                   enum: -> { MetronomeSDK::V1::Contracts::ProductCreateParams::SqlBreakdownGranularity }
+
           # @!attribute tags
           #
           #   @return [Array<String>, nil]
           optional :tags, MetronomeSDK::Internal::Type::ArrayOf[String]
 
-          # @!method initialize(name:, type:, billable_metric_id: nil, composite_product_ids: nil, composite_tags: nil, custom_fields: nil, exclude_free_usage: nil, is_refundable: nil, netsuite_internal_item_id: nil, netsuite_overage_item_id: nil, presentation_group_key: nil, pricing_group_key: nil, quantity_conversion: nil, quantity_rounding: nil, tags: nil, request_options: {})
+          # @!method initialize(name:, type:, billable_metric_id: nil, composite_product_ids: nil, composite_tags: nil, custom_fields: nil, exclude_free_usage: nil, is_refundable: nil, netsuite_internal_item_id: nil, netsuite_overage_item_id: nil, presentation_group_key: nil, pricing_group_key: nil, quantity_conversion: nil, quantity_rounding: nil, sql_breakdown_granularity: nil, tags: nil, request_options: {})
           #   Some parameter documentations has been truncated, see
           #   {MetronomeSDK::Models::V1::Contracts::ProductCreateParams} for more details.
           #
@@ -145,6 +157,8 @@ module MetronomeSDK
           #
           #   @param quantity_rounding [MetronomeSDK::Models::V1::Contracts::QuantityRounding, nil] Optional. Only valid for USAGE products. If provided, the quantity will be round
           #
+          #   @param sql_breakdown_granularity [Symbol, MetronomeSDK::Models::V1::Contracts::ProductCreateParams::SqlBreakdownGranularity] Defines the breakdown behavior when calculating usage from SQL Billable Metrics.
+          #
           #   @param tags [Array<String>]
           #
           #   @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}]
@@ -162,6 +176,22 @@ module MetronomeSDK
             # @!method self.values
             #   @return [Array<Symbol>]
           end
+
+          # Defines the breakdown behavior when calculating usage from SQL Billable Metrics.
+          # If set to 'service_period' (default), the usage will be evaluated once for all
+          # events the invoice service period and the usage will be applied at the last
+          # instant of the invoice. If set to 'hour', it will be broken down and evaluated
+          # for each hour. For most use cases, 'hour' is recommended. The setting has no
+          # effect for Streaming Billable Metrics.
+          module SqlBreakdownGranularity
+            extend MetronomeSDK::Internal::Type::Enum
+
+            HOUR = :HOUR
+            SERVICE_PERIOD = :SERVICE_PERIOD
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/metronome_sdk/models/v1/contracts/product_update_params.rb

@@ -116,13 +116,25 @@ module MetronomeSDK
           #   @return [MetronomeSDK::Models::V1::Contracts::QuantityRounding, nil]
           optional :quantity_rounding, -> { MetronomeSDK::V1::Contracts::QuantityRounding }, nil?: true
 
+          # @!attribute sql_breakdown_granularity
+          #   Defines the breakdown behavior when calculating usage from SQL Billable Metrics.
+          #   If set to 'service_period' (default), the usage will be evaluated once for all
+          #   events the invoice service period and the usage will be applied at the last
+          #   instant of the invoice. If set to 'hour', it will be broken down and evaluated
+          #   for each hour. For most use cases, 'hour' is recommended. The setting has no
+          #   effect for Streaming Billable Metrics.
+          #
+          #   @return [Symbol, MetronomeSDK::Models::V1::Contracts::ProductUpdateParams::SqlBreakdownGranularity, nil]
+          optional :sql_breakdown_granularity,
+                   enum: -> { MetronomeSDK::V1::Contracts::ProductUpdateParams::SqlBreakdownGranularity }
+
           # @!attribute tags
           #   If not provided, defaults to product's current tags
           #
           #   @return [Array<String>, nil]
           optional :tags, MetronomeSDK::Internal::Type::ArrayOf[String]
 
-          # @!method initialize(product_id:, starting_at:, billable_metric_id: nil, composite_product_ids: nil, composite_tags: nil, exclude_free_usage: nil, is_refundable: nil, name: nil, netsuite_internal_item_id: nil, netsuite_overage_item_id: nil, presentation_group_key: nil, pricing_group_key: nil, quantity_conversion: nil, quantity_rounding: nil, tags: nil, request_options: {})
+          # @!method initialize(product_id:, starting_at:, billable_metric_id: nil, composite_product_ids: nil, composite_tags: nil, exclude_free_usage: nil, is_refundable: nil, name: nil, netsuite_internal_item_id: nil, netsuite_overage_item_id: nil, presentation_group_key: nil, pricing_group_key: nil, quantity_conversion: nil, quantity_rounding: nil, sql_breakdown_granularity: nil, tags: nil, request_options: {})
           #   Some parameter documentations has been truncated, see
           #   {MetronomeSDK::Models::V1::Contracts::ProductUpdateParams} for more details.
           #
@@ -154,9 +166,27 @@ module MetronomeSDK
           #
           #   @param quantity_rounding [MetronomeSDK::Models::V1::Contracts::QuantityRounding, nil] Optional. Only valid for USAGE products. If provided, the quantity will be round
           #
+          #   @param sql_breakdown_granularity [Symbol, MetronomeSDK::Models::V1::Contracts::ProductUpdateParams::SqlBreakdownGranularity] Defines the breakdown behavior when calculating usage from SQL Billable Metrics.
+          #
           #   @param tags [Array<String>] If not provided, defaults to product's current tags
           #
           #   @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}]
+
+          # Defines the breakdown behavior when calculating usage from SQL Billable Metrics.
+          # If set to 'service_period' (default), the usage will be evaluated once for all
+          # events the invoice service period and the usage will be applied at the last
+          # instant of the invoice. If set to 'hour', it will be broken down and evaluated
+          # for each hour. For most use cases, 'hour' is recommended. The setting has no
+          # effect for Streaming Billable Metrics.
+          module SqlBreakdownGranularity
+            extend MetronomeSDK::Internal::Type::Enum
+
+            HOUR = :HOUR
+            SERVICE_PERIOD = :SERVICE_PERIOD
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/metronome_sdk/models/v1/customers/customer_alert.rb

@@ -236,6 +236,7 @@ module MetronomeSDK
                 CONTRACT = :Contract
                 COMMIT = :Commit
                 CONTRACT_CREDIT = :ContractCredit
+                CONTRACT_CREDIT_OR_COMMIT = :ContractCreditOrCommit
 
                 # @!method self.values
                 #   @return [Array<Symbol>]

data/lib/metronome_sdk/models/v1/customers/invoice.rb

@@ -152,6 +152,11 @@ module MetronomeSDK
           #   @return [String, nil]
           optional :plan_name, String
 
+          # @!attribute regenerated_from_invoice_id
+          #
+          #   @return [String, nil]
+          optional :regenerated_from_invoice_id, String
+
           # @!attribute reseller_royalty
           #   Only present for contract invoices with reseller royalties.
           #
@@ -184,7 +189,7 @@ module MetronomeSDK
           #   @return [Float, nil]
           optional :subtotal, Float
 
-          # @!method initialize(id:, credit_type:, customer_id:, line_items:, status:, total:, type:, amendment_id: nil, billable_status: nil, constituent_invoices: nil, contract_custom_fields: nil, contract_id: nil, correction_record: nil, created_at: nil, custom_fields: nil, customer_custom_fields: nil, end_timestamp: nil, external_invoice: nil, invoice_adjustments: nil, issued_at: nil, net_payment_terms_days: nil, netsuite_sales_order_id: nil, payer: nil, plan_custom_fields: nil, plan_id: nil, plan_name: nil, reseller_royalty: nil, revenue_system_invoices: nil, salesforce_opportunity_id: nil, start_timestamp: nil, subtotal: nil)
+          # @!method initialize(id:, credit_type:, customer_id:, line_items:, status:, total:, type:, amendment_id: nil, billable_status: nil, constituent_invoices: nil, contract_custom_fields: nil, contract_id: nil, correction_record: nil, created_at: nil, custom_fields: nil, customer_custom_fields: nil, end_timestamp: nil, external_invoice: nil, invoice_adjustments: nil, issued_at: nil, net_payment_terms_days: nil, netsuite_sales_order_id: nil, payer: nil, plan_custom_fields: nil, plan_id: nil, plan_name: nil, regenerated_from_invoice_id: nil, reseller_royalty: nil, revenue_system_invoices: nil, salesforce_opportunity_id: nil, start_timestamp: nil, subtotal: nil)
           #   Some parameter documentations has been truncated, see
           #   {MetronomeSDK::Models::V1::Customers::Invoice} for more details.
           #
@@ -240,6 +245,8 @@ module MetronomeSDK
           #
           #   @param plan_name [String]
           #
+          #   @param regenerated_from_invoice_id [String]
+          #
           #   @param reseller_royalty [MetronomeSDK::Models::V1::Customers::Invoice::ResellerRoyalty] Only present for contract invoices with reseller royalties.
           #
           #   @param revenue_system_invoices [Array<MetronomeSDK::Models::V1::Customers::Invoice::RevenueSystemInvoice>, nil]

data/lib/metronome_sdk/models/v1/customers/invoice_list_params.rb

@@ -14,6 +14,12 @@ module MetronomeSDK
           #   @return [String]
           required :customer_id, String
 
+          # @!attribute contract_id
+          #   Only return invoices for the specified contract
+          #
+          #   @return [String, nil]
+          optional :contract_id, String
+
           # @!attribute credit_type_id
           #   Only return invoices for the specified credit type
           #
@@ -65,12 +71,20 @@ module MetronomeSDK
           #   @return [String, nil]
           optional :status, String
 
-          # @!method initialize(customer_id:, credit_type_id: nil, ending_before: nil, limit: nil, next_page: nil, skip_zero_qty_line_items: nil, sort: nil, starting_on: nil, status: nil, request_options: {})
+          # @!attribute type
+          #   Filter invoices by type. Defaults to returning all invoice types.
+          #
+          #   @return [Symbol, MetronomeSDK::Models::V1::Customers::InvoiceListParams::Type, nil]
+          optional :type, enum: -> { MetronomeSDK::V1::Customers::InvoiceListParams::Type }
+
+          # @!method initialize(customer_id:, contract_id: nil, credit_type_id: nil, ending_before: nil, limit: nil, next_page: nil, skip_zero_qty_line_items: nil, sort: nil, starting_on: nil, status: nil, type: nil, request_options: {})
           #   Some parameter documentations has been truncated, see
           #   {MetronomeSDK::Models::V1::Customers::InvoiceListParams} for more details.
           #
           #   @param customer_id [String]
           #
+          #   @param contract_id [String] Only return invoices for the specified contract
+          #
           #   @param credit_type_id [String] Only return invoices for the specified credit type
           #
           #   @param ending_before [Time] RFC 3339 timestamp (exclusive). Invoices will only be returned for billing perio
@@ -87,6 +101,8 @@ module MetronomeSDK
           #
           #   @param status [String] Invoice status, e.g. DRAFT, FINALIZED, or VOID
           #
+          #   @param type [Symbol, MetronomeSDK::Models::V1::Customers::InvoiceListParams::Type] Filter invoices by type. Defaults to returning all invoice types.
+          #
           #   @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}]
 
           # Invoice sort order by issued_at, e.g. date_asc or date_desc. Defaults to
@@ -100,6 +116,18 @@ module MetronomeSDK
             # @!method self.values
             #   @return [Array<Symbol>]
           end
+
+          # Filter invoices by type. Defaults to returning all invoice types.
+          module Type
+            extend MetronomeSDK::Internal::Type::Enum
+
+            USAGE = :USAGE
+            USAGE_CONSOLIDATED = :USAGE_CONSOLIDATED
+            SCHEDULED = :SCHEDULED
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end