metronome-sdk 0.1.0.pre.alpha.3 → 0.1.0.pre.alpha.4

data/lib/metronome_sdk/models.rb

@@ -11,16 +11,16 @@ module MetronomeSDK
       mod.constants.each do |name|
         case mod.const_get(name)
         in true | false
-          mod.define_sorbet_constant!(:TaggedBoolean) { T.type_alias { T.all(T::Boolean, mod) } }
+          mod.define_sorbet_constant!(:TaggedBoolean) { T.type_alias { T::Boolean } }
           mod.define_sorbet_constant!(:OrBoolean) { T.type_alias { T::Boolean } }
         in Integer
-          mod.define_sorbet_constant!(:TaggedInteger) { T.type_alias { T.all(Integer, mod) } }
+          mod.define_sorbet_constant!(:TaggedInteger) { T.type_alias { Integer } }
           mod.define_sorbet_constant!(:OrInteger) { T.type_alias { Integer } }
         in Float
-          mod.define_sorbet_constant!(:TaggedFloat) { T.type_alias { T.all(Float, mod) } }
+          mod.define_sorbet_constant!(:TaggedFloat) { T.type_alias { Float } }
           mod.define_sorbet_constant!(:OrFloat) { T.type_alias { Float } }
         in Symbol
-          mod.define_sorbet_constant!(:TaggedSymbol) { T.type_alias { T.all(Symbol, mod) } }
+          mod.define_sorbet_constant!(:TaggedSymbol) { T.type_alias { Symbol } }
           mod.define_sorbet_constant!(:OrSymbol) { T.type_alias { T.any(Symbol, String) } }
         else
         end
@@ -39,6 +39,38 @@ module MetronomeSDK
     mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
   end
 
+  BaseUsageFilter = MetronomeSDK::Models::BaseUsageFilter
+
+  Commit = MetronomeSDK::Models::Commit
+
+  ContractWithoutAmendments = MetronomeSDK::Models::ContractWithoutAmendments
+
+  Credit = MetronomeSDK::Models::Credit
+
+  CreditTypeData = MetronomeSDK::Models::CreditTypeData
+
+  Discount = MetronomeSDK::Models::Discount
+
+  EventTypeFilter = MetronomeSDK::Models::EventTypeFilter
+
+  ID = MetronomeSDK::Models::ID
+
+  Override = MetronomeSDK::Models::Override
+
+  PropertyFilter = MetronomeSDK::Models::PropertyFilter
+
+  ProService = MetronomeSDK::Models::ProService
+
+  Rate = MetronomeSDK::Models::Rate
+
+  ScheduledCharge = MetronomeSDK::Models::ScheduledCharge
+
+  ScheduleDuration = MetronomeSDK::Models::ScheduleDuration
+
+  SchedulePointInTime = MetronomeSDK::Models::SchedulePointInTime
+
+  Tier = MetronomeSDK::Models::Tier
+
   V1 = MetronomeSDK::Models::V1
 
   V2 = MetronomeSDK::Models::V2

data/lib/metronome_sdk/resources/v1/alerts.rb

@@ -21,7 +21,7 @@ module MetronomeSDK
         #
         # @param credit_grant_type_filters [Array<String>] An array of strings, representing a way to filter the credit grant this alert ap
         #
-        # @param credit_type_id [String]
+        # @param credit_type_id [String] ID of the credit's currency, defaults to USD. If the specific alert type require
         #
         # @param custom_field_filters [Array<MetronomeSDK::Models::V1::AlertCreateParams::CustomFieldFilter>] A list of custom field filters for alert types that support advanced filtering.
         #

data/lib/metronome_sdk/resources/v1/billable_metrics.rb

@@ -19,11 +19,11 @@ module MetronomeSDK
         #
         # @param custom_fields [Hash{Symbol=>String}] Custom fields to attach to the billable metric.
         #
-        # @param event_type_filter [MetronomeSDK::Models::V1::BillableMetricCreateParams::EventTypeFilter] An optional filtering rule to match the 'event_type' property of an event.
+        # @param event_type_filter [MetronomeSDK::Models::EventTypeFilter] An optional filtering rule to match the 'event_type' property of an event.
         #
         # @param group_keys [Array<Array<String>>] Property names that are used to group usage costs on an invoice. Each entry repr
         #
-        # @param property_filters [Array<MetronomeSDK::Models::V1::BillableMetricCreateParams::PropertyFilter>] A list of filters to match events to this billable metric. Each filter defines a
+        # @param property_filters [Array<MetronomeSDK::Models::PropertyFilter>] A list of filters to match events to this billable metric. Each filter defines a
         #
         # @param sql [String] The SQL query associated with the billable metric. This field is mutually exclus
         #

data/lib/metronome_sdk/resources/v1/contracts/products.rb

@@ -34,9 +34,9 @@ module MetronomeSDK
           #
           # @param pricing_group_key [Array<String>] For USAGE products only. If set, pricing for this product will be determined for
           #
-          # @param quantity_conversion [MetronomeSDK::Models::V1::Contracts::ProductCreateParams::QuantityConversion, nil] Optional. Only valid for USAGE products. If provided, the quantity will be conve
+          # @param quantity_conversion [MetronomeSDK::Models::V1::Contracts::QuantityConversion, nil] Optional. Only valid for USAGE products. If provided, the quantity will be conve
           #
-          # @param quantity_rounding [MetronomeSDK::Models::V1::Contracts::ProductCreateParams::QuantityRounding, nil] Optional. Only valid for USAGE products. If provided, the quantity will be round
+          # @param quantity_rounding [MetronomeSDK::Models::V1::Contracts::QuantityRounding, nil] Optional. Only valid for USAGE products. If provided, the quantity will be round
           #
           # @param tags [Array<String>]
           #
@@ -108,9 +108,9 @@ module MetronomeSDK
           #
           # @param pricing_group_key [Array<String>] For USAGE products only. If set, pricing for this product will be determined for
           #
-          # @param quantity_conversion [MetronomeSDK::Models::V1::Contracts::ProductUpdateParams::QuantityConversion, nil] Optional. Only valid for USAGE products. If provided, the quantity will be conve
+          # @param quantity_conversion [MetronomeSDK::Models::V1::Contracts::QuantityConversion, nil] Optional. Only valid for USAGE products. If provided, the quantity will be conve
           #
-          # @param quantity_rounding [MetronomeSDK::Models::V1::Contracts::ProductUpdateParams::QuantityRounding, nil] Optional. Only valid for USAGE products. If provided, the quantity will be round
+          # @param quantity_rounding [MetronomeSDK::Models::V1::Contracts::QuantityRounding, nil] Optional. Only valid for USAGE products. If provided, the quantity will be round
           #
           # @param tags [Array<String>] If not provided, defaults to product's current tags
           #

data/lib/metronome_sdk/resources/v1/contracts/rate_cards/rates.rb

@@ -79,7 +79,7 @@ module MetronomeSDK
             #
             # @param quantity [Float] Default quantity. For SUBSCRIPTION rate_type, this must be >=0.
             #
-            # @param tiers [Array<MetronomeSDK::Models::V1::Contracts::RateCards::RateAddParams::Tier>] Only set for TIERED rate_type.
+            # @param tiers [Array<MetronomeSDK::Models::Tier>] Only set for TIERED rate_type.
             #
             # @param use_list_prices [Boolean] Only set for PERCENTAGE rate_type. Defaults to false. If true, rate is computed
             #

data/lib/metronome_sdk/resources/v1/contracts.rb

@@ -18,13 +18,13 @@ module MetronomeSDK
         #
         # Create a new contract
         #
-        # @overload create(customer_id:, starting_at:, billing_provider_configuration: nil, commits: nil, credits: nil, custom_fields: nil, discounts: nil, ending_before: nil, multiplier_override_prioritization: nil, name: nil, net_payment_terms_days: nil, netsuite_sales_order_id: nil, overrides: nil, prepaid_balance_threshold_configuration: nil, professional_services: nil, rate_card_alias: nil, rate_card_id: nil, recurring_commits: nil, recurring_credits: nil, reseller_royalties: nil, salesforce_opportunity_id: nil, scheduled_charges: nil, scheduled_charges_on_usage_invoices: nil, spend_threshold_configuration: nil, subscriptions: nil, total_contract_value: nil, transition: nil, uniqueness_key: nil, usage_filter: nil, usage_statement_schedule: nil, request_options: {})
+        # @overload create(customer_id:, starting_at:, billing_provider_configuration: nil, commits: nil, credits: nil, custom_fields: nil, discounts: nil, ending_before: nil, hierarchy_configuration: nil, multiplier_override_prioritization: nil, name: nil, net_payment_terms_days: nil, netsuite_sales_order_id: nil, overrides: nil, prepaid_balance_threshold_configuration: nil, priority: nil, professional_services: nil, rate_card_alias: nil, rate_card_id: nil, recurring_commits: nil, recurring_credits: nil, reseller_royalties: nil, salesforce_opportunity_id: nil, scheduled_charges: nil, scheduled_charges_on_usage_invoices: nil, spend_threshold_configuration: nil, subscriptions: nil, total_contract_value: nil, transition: nil, uniqueness_key: nil, usage_filter: nil, usage_statement_schedule: nil, request_options: {})
         #
         # @param customer_id [String]
         #
         # @param starting_at [Time] inclusive contract start time
         #
-        # @param billing_provider_configuration [MetronomeSDK::Models::V1::ContractCreateParams::BillingProviderConfiguration] The billing provider configuration associated with a contract.
+        # @param billing_provider_configuration [MetronomeSDK::Models::V1::ContractCreateParams::BillingProviderConfiguration] The billing provider configuration associated with a contract. Provide either an
         #
         # @param commits [Array<MetronomeSDK::Models::V1::ContractCreateParams::Commit>]
         #
@@ -36,6 +36,8 @@ module MetronomeSDK
         #
         # @param ending_before [Time] exclusive contract end time
         #
+        # @param hierarchy_configuration [MetronomeSDK::Models::V1::ContractCreateParams::HierarchyConfiguration]
+        #
         # @param multiplier_override_prioritization [Symbol, MetronomeSDK::Models::V1::ContractCreateParams::MultiplierOverridePrioritization] Defaults to LOWEST_MULTIPLIER, which applies the greatest discount to list price
         #
         # @param name [String]
@@ -48,6 +50,8 @@ module MetronomeSDK
         #
         # @param prepaid_balance_threshold_configuration [MetronomeSDK::Models::V1::ContractCreateParams::PrepaidBalanceThresholdConfiguration]
         #
+        # @param priority [Float] Priority of the contract.
+        #
         # @param professional_services [Array<MetronomeSDK::Models::V1::ContractCreateParams::ProfessionalService>] This field's availability is dependent on your client's configuration.
         #
         # @param rate_card_alias [String] Selects the rate card linked to the specified alias as of the contract's start d
@@ -68,7 +72,7 @@ module MetronomeSDK
         #
         # @param spend_threshold_configuration [MetronomeSDK::Models::V1::ContractCreateParams::SpendThresholdConfiguration]
         #
-        # @param subscriptions [Array<MetronomeSDK::Models::V1::ContractCreateParams::Subscription>] (beta) Optional list of [subscriptions](https://docs.metronome.com/manage-produc
+        # @param subscriptions [Array<MetronomeSDK::Models::V1::ContractCreateParams::Subscription>] Optional list of [subscriptions](https://docs.metronome.com/manage-product-acces
         #
         # @param total_contract_value [Float] This field's availability is dependent on your client's configuration.
         #
@@ -76,7 +80,7 @@ module MetronomeSDK
         #
         # @param uniqueness_key [String] Prevents the creation of duplicates. If a request to create a record is made wit
         #
-        # @param usage_filter [MetronomeSDK::Models::V1::ContractCreateParams::UsageFilter]
+        # @param usage_filter [MetronomeSDK::Models::BaseUsageFilter]
         #
         # @param usage_statement_schedule [MetronomeSDK::Models::V1::ContractCreateParams::UsageStatementSchedule]
         #

data/lib/metronome_sdk/resources/v1/credit_grants.rb

@@ -130,10 +130,12 @@ module MetronomeSDK
         # Ledger entries are returned in chronological order. Ledger entries associated
         # with voided credit grants are not included.
         #
-        # @overload list_entries(next_page: nil, credit_type_ids: nil, customer_ids: nil, ending_before: nil, starting_on: nil, request_options: {})
+        # @overload list_entries(next_page: nil, sort: nil, credit_type_ids: nil, customer_ids: nil, ending_before: nil, starting_on: nil, request_options: {})
         #
         # @param next_page [String] Query param: Cursor that indicates where the next page of results should start.
         #
+        # @param sort [Symbol, MetronomeSDK::Models::V1::CreditGrantListEntriesParams::Sort] Query param: Ledgers sort order by date, asc or desc. Defaults to asc.
+        #
         # @param credit_type_ids [Array<String>] Body param: A list of Metronome credit type IDs to fetch ledger entries for. If
         #
         # @param customer_ids [Array<String>] Body param: A list of Metronome customer IDs to fetch ledger entries for. If abs
@@ -150,7 +152,7 @@ module MetronomeSDK
         # @see MetronomeSDK::Models::V1::CreditGrantListEntriesParams
         def list_entries(params = {})
           parsed, options = MetronomeSDK::V1::CreditGrantListEntriesParams.dump_request(params)
-          query_params = [:next_page]
+          query_params = [:next_page, :sort]
           @client.request(
             method: :post,
             path: "v1/credits/listEntries",

data/lib/metronome_sdk/resources/v1/customers/commits.rb

@@ -24,9 +24,9 @@ module MetronomeSDK
           #
           # @param applicable_contract_ids [Array<String>] Which contract the commit applies to. If not provided, the commit applies to all
           #
-          # @param applicable_product_ids [Array<String>] Which products the commit applies to. If both applicable_product_ids and applica
+          # @param applicable_product_ids [Array<String>] Which products the commit applies to. If applicable_product_ids, applicable_prod
           #
-          # @param applicable_product_tags [Array<String>] Which tags the commit applies to. If both applicable*product_ids and applicable*
+          # @param applicable_product_tags [Array<String>] Which tags the commit applies to. If applicable*product_ids, applicable_product*
           #
           # @param custom_fields [Hash{Symbol=>String}]
           #

data/lib/metronome_sdk/resources/v1/customers/invoices.rb

@@ -70,7 +70,7 @@ module MetronomeSDK
           #
           # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [MetronomeSDK::Internal::CursorPage<MetronomeSDK::Models::V1::Customers::InvoiceListResponse>]
+          # @return [MetronomeSDK::Internal::CursorPage<MetronomeSDK::Models::V1::Customers::Invoice>]
           #
           # @see MetronomeSDK::Models::V1::Customers::InvoiceListParams
           def list(params)
@@ -84,7 +84,7 @@ module MetronomeSDK
               path: ["v1/customers/%1$s/invoices", customer_id],
               query: parsed,
               page: MetronomeSDK::Internal::CursorPage,
-              model: MetronomeSDK::Models::V1::Customers::InvoiceListResponse,
+              model: MetronomeSDK::V1::Customers::Invoice,
               options: options
             )
           end

data/lib/metronome_sdk/resources/v1/customers.rb

@@ -105,7 +105,7 @@ module MetronomeSDK
         #
         # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [MetronomeSDK::Internal::CursorPage<MetronomeSDK::Models::V1::CustomerListResponse>]
+        # @return [MetronomeSDK::Internal::CursorPage<MetronomeSDK::Models::V1::CustomerDetail>]
         #
         # @see MetronomeSDK::Models::V1::CustomerListParams
         def list(params = {})
@@ -115,7 +115,7 @@ module MetronomeSDK
             path: "v1/customers",
             query: parsed,
             page: MetronomeSDK::Internal::CursorPage,
-            model: MetronomeSDK::Models::V1::CustomerListResponse,
+            model: MetronomeSDK::V1::CustomerDetail,
             options: options
           )
         end
@@ -217,6 +217,44 @@ module MetronomeSDK
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {MetronomeSDK::Models::V1::CustomerPreviewEventsParams} for more details.
+        #
+        # Preview how a set of events will affect a customer's invoice. Generates a draft
+        # invoice for a customer using their current contract configuration and the
+        # provided events. This is useful for testing how new events will affect the
+        # customer's invoice before they are actually processed.
+        #
+        # @overload preview_events(customer_id:, events:, mode: nil, skip_zero_qty_line_items: nil, request_options: {})
+        #
+        # @param customer_id [String] Path param:
+        #
+        # @param events [Array<MetronomeSDK::Models::V1::CustomerPreviewEventsParams::Event>] Body param:
+        #
+        # @param mode [Symbol, MetronomeSDK::Models::V1::CustomerPreviewEventsParams::Mode] Body param: If set to "replace", the preview will be generated as if those were
+        #
+        # @param skip_zero_qty_line_items [Boolean] Body param: If set, all zero quantity line items will be filtered out of the res
+        #
+        # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [MetronomeSDK::Models::V1::CustomerPreviewEventsResponse]
+        #
+        # @see MetronomeSDK::Models::V1::CustomerPreviewEventsParams
+        def preview_events(params)
+          parsed, options = MetronomeSDK::V1::CustomerPreviewEventsParams.dump_request(params)
+          customer_id =
+            parsed.delete(:customer_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :post,
+            path: ["v1/customers/%1$s/previewEvents", customer_id],
+            body: parsed,
+            model: MetronomeSDK::Models::V1::CustomerPreviewEventsResponse,
+            options: options
+          )
+        end
+
         # Sets the ingest aliases for a customer. Ingest aliases can be used in the
         # `customer_id` field when sending usage events to Metronome. This call is
         # idempotent. It fully replaces the set of ingest aliases for the given customer.

data/lib/metronome_sdk/resources/v1/usage.rb

@@ -112,6 +112,31 @@ module MetronomeSDK
           )
         end
 
+        # For a set of events, look up matched billable metrics and customers by
+        # transaction id. This endpoint looks at transactions that occurred in the last 34
+        # days, and is intended for sampling-based testing workflows. It is heavily rate
+        # limited.
+        #
+        # @overload search(transaction_ids:, request_options: {})
+        #
+        # @param transaction_ids [Array<String>] The transaction IDs of the events to retrieve
+        #
+        # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Array<MetronomeSDK::Models::V1::UsageSearchResponseItem>]
+        #
+        # @see MetronomeSDK::Models::V1::UsageSearchParams
+        def search(params)
+          parsed, options = MetronomeSDK::V1::UsageSearchParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/events/search",
+            body: parsed,
+            model: MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Models::V1::UsageSearchResponseItem],
+            options: options
+          )
+        end
+
         # @api private
         #
         # @param client [MetronomeSDK::Client]

data/lib/metronome_sdk/resources/v2/contracts.rb

@@ -41,8 +41,8 @@ module MetronomeSDK
         # Some parameter documentations has been truncated, see
         # {MetronomeSDK::Models::V2::ContractListParams} for more details.
         #
-        # List all contracts for a customer. New clients should use this endpoint rather
-        # than the v1 endpoint.
+        # List all contracts for a customer in chronological order. New clients should use
+        # this endpoint rather than the v1 endpoint.
         #
         # @overload list(customer_id:, covering_date: nil, include_archived: nil, include_balance: nil, include_ledgers: nil, starting_at: nil, request_options: {})
         #
@@ -79,7 +79,7 @@ module MetronomeSDK
         #
         # Edit a contract. Contract editing must be enabled to use this endpoint.
         #
-        # @overload edit(contract_id:, customer_id:, add_commits: nil, add_credits: nil, add_discounts: nil, add_overrides: nil, add_prepaid_balance_threshold_configuration: nil, add_professional_services: nil, add_recurring_commits: nil, add_recurring_credits: nil, add_reseller_royalties: nil, add_scheduled_charges: nil, add_spend_threshold_configuration: nil, add_subscriptions: nil, allow_contract_ending_before_finalized_invoice: nil, archive_commits: nil, archive_credits: nil, archive_scheduled_charges: nil, remove_overrides: nil, update_commits: nil, update_contract_end_date: nil, update_credits: nil, update_prepaid_balance_threshold_configuration: nil, update_recurring_commits: nil, update_recurring_credits: nil, update_scheduled_charges: nil, update_spend_threshold_configuration: nil, update_subscriptions: nil, request_options: {})
+        # @overload edit(contract_id:, customer_id:, add_commits: nil, add_credits: nil, add_discounts: nil, add_overrides: nil, add_prepaid_balance_threshold_configuration: nil, add_professional_services: nil, add_recurring_commits: nil, add_recurring_credits: nil, add_reseller_royalties: nil, add_scheduled_charges: nil, add_spend_threshold_configuration: nil, add_subscriptions: nil, allow_contract_ending_before_finalized_invoice: nil, archive_commits: nil, archive_credits: nil, archive_scheduled_charges: nil, remove_overrides: nil, update_commits: nil, update_contract_end_date: nil, update_contract_name: nil, update_credits: nil, update_prepaid_balance_threshold_configuration: nil, update_recurring_commits: nil, update_recurring_credits: nil, update_scheduled_charges: nil, update_spend_threshold_configuration: nil, update_subscriptions: nil, request_options: {})
         #
         # @param contract_id [String] ID of the contract being edited
         #
@@ -107,7 +107,7 @@ module MetronomeSDK
         #
         # @param add_spend_threshold_configuration [MetronomeSDK::Models::V2::ContractEditParams::AddSpendThresholdConfiguration]
         #
-        # @param add_subscriptions [Array<MetronomeSDK::Models::V2::ContractEditParams::AddSubscription>] (beta) Optional list of [subscriptions](https://docs.metronome.com/manage-produc
+        # @param add_subscriptions [Array<MetronomeSDK::Models::V2::ContractEditParams::AddSubscription>] Optional list of [subscriptions](https://docs.metronome.com/manage-product-acces
         #
         # @param allow_contract_ending_before_finalized_invoice [Boolean] If true, allows setting the contract end date earlier than the end_timestamp of
         #
@@ -123,6 +123,8 @@ module MetronomeSDK
         #
         # @param update_contract_end_date [Time, nil] RFC 3339 timestamp indicating when the contract will end (exclusive).
         #
+        # @param update_contract_name [String, nil] Value to update the contract name to. If not provided, the contract name will re
+        #
         # @param update_credits [Array<MetronomeSDK::Models::V2::ContractEditParams::UpdateCredit>]
         #
         # @param update_prepaid_balance_threshold_configuration [MetronomeSDK::Models::V2::ContractEditParams::UpdatePrepaidBalanceThresholdConfiguration]
@@ -135,7 +137,7 @@ module MetronomeSDK
         #
         # @param update_spend_threshold_configuration [MetronomeSDK::Models::V2::ContractEditParams::UpdateSpendThresholdConfiguration]
         #
-        # @param update_subscriptions [Array<MetronomeSDK::Models::V2::ContractEditParams::UpdateSubscription>] (beta) Optional list of subscriptions to update.
+        # @param update_subscriptions [Array<MetronomeSDK::Models::V2::ContractEditParams::UpdateSubscription>] Optional list of subscriptions to update.
         #
         # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -167,9 +169,9 @@ module MetronomeSDK
         #
         # @param access_schedule [MetronomeSDK::Models::V2::ContractEditCommitParams::AccessSchedule]
         #
-        # @param applicable_product_ids [Array<String>, nil] Which products the commit applies to. If both applicable_product_ids and applica
+        # @param applicable_product_ids [Array<String>, nil] Which products the commit applies to. If applicable_product_ids, applicable_prod
         #
-        # @param applicable_product_tags [Array<String>, nil] Which tags the commit applies to. If both applicable*product_ids and applicable*
+        # @param applicable_product_tags [Array<String>, nil] Which tags the commit applies to. If applicable*product_ids, applicable_product*
         #
         # @param invoice_contract_id [String] ID of contract to use for invoicing
         #
@@ -177,7 +179,7 @@ module MetronomeSDK
         #
         # @param product_id [String]
         #
-        # @param specifiers [Array<MetronomeSDK::Models::V2::ContractEditCommitParams::Specifier>] List of filters that determine what kind of customer usage draws down a commit o
+        # @param specifiers [Array<MetronomeSDK::Models::V2::ContractEditCommitParams::Specifier>, nil] List of filters that determine what kind of customer usage draws down a commit o
         #
         # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -215,7 +217,7 @@ module MetronomeSDK
         #
         # @param product_id [String]
         #
-        # @param specifiers [Array<MetronomeSDK::Models::V2::ContractEditCreditParams::Specifier>] List of filters that determine what kind of customer usage draws down a commit o
+        # @param specifiers [Array<MetronomeSDK::Models::V2::ContractEditCreditParams::Specifier>, nil] List of filters that determine what kind of customer usage draws down a commit o
         #
         # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/metronome_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MetronomeSDK
-  VERSION = "0.1.0.pre.alpha.3"
+  VERSION = "0.1.0.pre.alpha.4"
 end

data/lib/metronome_sdk.rb

@@ -51,6 +51,23 @@ require_relative "metronome_sdk/internal/transport/base_client"
 require_relative "metronome_sdk/internal/transport/pooled_net_requester"
 require_relative "metronome_sdk/client"
 require_relative "metronome_sdk/internal/cursor_page"
+require_relative "metronome_sdk/models/id"
+require_relative "metronome_sdk/models/v1/customers/invoice"
+require_relative "metronome_sdk/models/base_usage_filter"
+require_relative "metronome_sdk/models/commit"
+require_relative "metronome_sdk/models/contract_without_amendments"
+require_relative "metronome_sdk/models/credit"
+require_relative "metronome_sdk/models/credit_type_data"
+require_relative "metronome_sdk/models/discount"
+require_relative "metronome_sdk/models/event_type_filter"
+require_relative "metronome_sdk/models/override"
+require_relative "metronome_sdk/models/property_filter"
+require_relative "metronome_sdk/models/pro_service"
+require_relative "metronome_sdk/models/rate"
+require_relative "metronome_sdk/models/scheduled_charge"
+require_relative "metronome_sdk/models/schedule_duration"
+require_relative "metronome_sdk/models/schedule_point_in_time"
+require_relative "metronome_sdk/models/tier"
 require_relative "metronome_sdk/models/v1/alert_archive_params"
 require_relative "metronome_sdk/models/v1/alert_archive_response"
 require_relative "metronome_sdk/models/v1/alert_create_params"
@@ -91,12 +108,15 @@ require_relative "metronome_sdk/models/v1/contracts/product_archive_params"
 require_relative "metronome_sdk/models/v1/contracts/product_archive_response"
 require_relative "metronome_sdk/models/v1/contracts/product_create_params"
 require_relative "metronome_sdk/models/v1/contracts/product_create_response"
+require_relative "metronome_sdk/models/v1/contracts/product_list_item_state"
 require_relative "metronome_sdk/models/v1/contracts/product_list_params"
 require_relative "metronome_sdk/models/v1/contracts/product_list_response"
 require_relative "metronome_sdk/models/v1/contracts/product_retrieve_params"
 require_relative "metronome_sdk/models/v1/contracts/product_retrieve_response"
 require_relative "metronome_sdk/models/v1/contracts/product_update_params"
 require_relative "metronome_sdk/models/v1/contracts/product_update_response"
+require_relative "metronome_sdk/models/v1/contracts/quantity_conversion"
+require_relative "metronome_sdk/models/v1/contracts/quantity_rounding"
 require_relative "metronome_sdk/models/v1/contracts/rate_card_archive_params"
 require_relative "metronome_sdk/models/v1/contracts/rate_card_archive_response"
 require_relative "metronome_sdk/models/v1/contracts/rate_card_create_params"
@@ -137,16 +157,20 @@ require_relative "metronome_sdk/models/v1/credit_grant_list_params"
 require_relative "metronome_sdk/models/v1/credit_grant_list_response"
 require_relative "metronome_sdk/models/v1/credit_grant_void_params"
 require_relative "metronome_sdk/models/v1/credit_grant_void_response"
+require_relative "metronome_sdk/models/v1/credit_ledger_entry"
+require_relative "metronome_sdk/models/v1/customer"
 require_relative "metronome_sdk/models/v1/customer_archive_params"
 require_relative "metronome_sdk/models/v1/customer_archive_response"
 require_relative "metronome_sdk/models/v1/customer_create_params"
 require_relative "metronome_sdk/models/v1/customer_create_response"
+require_relative "metronome_sdk/models/v1/customer_detail"
 require_relative "metronome_sdk/models/v1/customer_list_billable_metrics_params"
 require_relative "metronome_sdk/models/v1/customer_list_billable_metrics_response"
 require_relative "metronome_sdk/models/v1/customer_list_costs_params"
 require_relative "metronome_sdk/models/v1/customer_list_costs_response"
 require_relative "metronome_sdk/models/v1/customer_list_params"
-require_relative "metronome_sdk/models/v1/customer_list_response"
+require_relative "metronome_sdk/models/v1/customer_preview_events_params"
+require_relative "metronome_sdk/models/v1/customer_preview_events_response"
 require_relative "metronome_sdk/models/v1/customer_retrieve_params"
 require_relative "metronome_sdk/models/v1/customer_retrieve_response"
 require_relative "metronome_sdk/models/v1/customers/alert_list_params"
@@ -170,12 +194,12 @@ require_relative "metronome_sdk/models/v1/customers/credit_list_params"
 require_relative "metronome_sdk/models/v1/customers/credit_list_response"
 require_relative "metronome_sdk/models/v1/customers/credit_update_end_date_params"
 require_relative "metronome_sdk/models/v1/customers/credit_update_end_date_response"
+require_relative "metronome_sdk/models/v1/customers/customer_alert"
 require_relative "metronome_sdk/models/v1/customers/invoice_add_charge_params"
 require_relative "metronome_sdk/models/v1/customers/invoice_add_charge_response"
 require_relative "metronome_sdk/models/v1/customers/invoice_list_breakdowns_params"
 require_relative "metronome_sdk/models/v1/customers/invoice_list_breakdowns_response"
 require_relative "metronome_sdk/models/v1/customers/invoice_list_params"
-require_relative "metronome_sdk/models/v1/customers/invoice_list_response"
 require_relative "metronome_sdk/models/v1/customers/invoice_retrieve_params"
 require_relative "metronome_sdk/models/v1/customers/invoice_retrieve_response"
 require_relative "metronome_sdk/models/v1/customers/named_schedule_retrieve_params"
@@ -205,6 +229,7 @@ require_relative "metronome_sdk/models/v1/invoice_regenerate_params"
 require_relative "metronome_sdk/models/v1/invoice_regenerate_response"
 require_relative "metronome_sdk/models/v1/invoice_void_params"
 require_relative "metronome_sdk/models/v1/invoice_void_response"
+require_relative "metronome_sdk/models/v1/plan_detail"
 require_relative "metronome_sdk/models/v1/plan_get_details_params"
 require_relative "metronome_sdk/models/v1/plan_get_details_response"
 require_relative "metronome_sdk/models/v1/plan_list_charges_params"
@@ -215,6 +240,8 @@ require_relative "metronome_sdk/models/v1/plan_list_params"
 require_relative "metronome_sdk/models/v1/plan_list_response"
 require_relative "metronome_sdk/models/v1/pricing_unit_list_params"
 require_relative "metronome_sdk/models/v1/pricing_unit_list_response"
+require_relative "metronome_sdk/models/v1/rollover_amount_max_amount"
+require_relative "metronome_sdk/models/v1/rollover_amount_max_percentage"
 require_relative "metronome_sdk/models/v1/service_list_params"
 require_relative "metronome_sdk/models/v1/service_list_response"
 require_relative "metronome_sdk/models/v1/usage_ingest_params"
@@ -222,6 +249,8 @@ require_relative "metronome_sdk/models/v1/usage_list_params"
 require_relative "metronome_sdk/models/v1/usage_list_response"
 require_relative "metronome_sdk/models/v1/usage_list_with_groups_params"
 require_relative "metronome_sdk/models/v1/usage_list_with_groups_response"
+require_relative "metronome_sdk/models/v1/usage_search_params"
+require_relative "metronome_sdk/models/v1/usage_search_response"
 require_relative "metronome_sdk/models/v2/contract_edit_commit_params"
 require_relative "metronome_sdk/models/v2/contract_edit_commit_response"
 require_relative "metronome_sdk/models/v2/contract_edit_credit_params"

data/rbi/metronome_sdk/errors.rbi

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

data/rbi/metronome_sdk/internal/type/boolean.rbi

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

data/rbi/metronome_sdk/internal/type/converter.rbi

@@ -15,12 +15,14 @@ module MetronomeSDK
         CoerceState =
           T.type_alias do
             {
-              strictness: T.any(T::Boolean, Symbol),
+              translate_names: T::Boolean,
+              strictness: T::Boolean,
               exactness: {
                 yes: Integer,
                 no: Integer,
                 maybe: Integer
               },
+              error: T::Class[StandardError],
               branched: Integer
             }
           end
@@ -90,6 +92,15 @@ module MetronomeSDK
           def self.type_info(spec)
           end
 
+          # @api private
+          sig do
+            params(translate_names: T::Boolean).returns(
+              MetronomeSDK::Internal::Type::Converter::CoerceState
+            )
+          end
+          def self.new_coerce_state(translate_names: true)
+          end
+
           # @api private
           #
           # Based on `target`, transform `value` into `target`, to the extent possible:
@@ -111,14 +122,11 @@ module MetronomeSDK
           def self.coerce(
             target,
             value,
-            # The `strictness` is one of `true`, `false`, or `:strong`. This informs the
-            # coercion strategy when we have to decide between multiple possible conversion
-            # targets:
+            # The `strictness` is one of `true`, `false`. This informs the coercion strategy
+            # when we have to decide between multiple possible conversion targets:
             #
             # - `true`: the conversion must be exact, with minimum coercion.
             # - `false`: the conversion can be approximate, with some coercion.
-            # - `:strong`: the conversion must be exact, with no coercion, and raise an error
-            #   if not possible.
             #
             # The `exactness` is `Hash` with keys being one of `yes`, `no`, or `maybe`. For
             # any given conversion attempt, the exactness will be updated based on how closely
@@ -130,15 +138,7 @@ module MetronomeSDK
             # - `no`: the value cannot be converted to the target type.
             #
             # See implementation below for more details.
-            state: {
-              strictness: true,
-              exactness: {
-                yes: 0,
-                no: 0,
-                maybe: 0
-              },
-              branched: 0
-            }
+            state: MetronomeSDK::Internal::Type::Converter.new_coerce_state
           )
           end
 

data/rbi/metronome_sdk/internal/type/union.rbi

@@ -78,6 +78,11 @@ module MetronomeSDK
         end
 
         # @api private
+        #
+        # Tries to efficiently coerce the given value to one of the known variants.
+        #
+        # If the value cannot match any of the known variants, the coercion is considered
+        # non-viable and returns the original value.
         sig do
           override
             .params(

data/rbi/metronome_sdk/internal/type/unknown.rbi

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