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

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

@@ -10,9 +10,9 @@ module MetronomeSDK
           #
           # Create a new commit at the customer level.
           #
-          # @overload create(access_schedule:, customer_id:, priority:, product_id:, type:, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, custom_fields: nil, description: nil, invoice_contract_id: nil, invoice_schedule: nil, name: nil, netsuite_sales_order_id: nil, rate_type: nil, salesforce_opportunity_id: nil, uniqueness_key: nil, request_options: {})
+          # @overload create(access_schedule:, customer_id:, priority:, product_id:, type:, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, custom_fields: nil, description: nil, invoice_contract_id: nil, invoice_schedule: nil, name: nil, netsuite_sales_order_id: nil, rate_type: nil, salesforce_opportunity_id: nil, specifiers: nil, uniqueness_key: nil, request_options: {})
           #
-          # @param access_schedule [MetronomeSDK::V1::Customers::CommitCreateParams::AccessSchedule] Schedule for distributing the commit to the customer. For "POSTPAID" commits onl
+          # @param access_schedule [MetronomeSDK::Models::V1::Customers::CommitCreateParams::AccessSchedule] Schedule for distributing the commit to the customer. For "POSTPAID" commits onl
           #
           # @param customer_id [String]
           #
@@ -20,13 +20,13 @@ module MetronomeSDK
           #
           # @param product_id [String] ID of the fixed product associated with the commit. This is required because pro
           #
-          # @param type [Symbol, MetronomeSDK::V1::Customers::CommitCreateParams::Type]
+          # @param type [Symbol, MetronomeSDK::Models::V1::Customers::CommitCreateParams::Type]
           #
           # @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}]
           #
@@ -34,16 +34,18 @@ module MetronomeSDK
           #
           # @param invoice_contract_id [String] The contract that this commit will be billed on. This is required for "POSTPAID"
           #
-          # @param invoice_schedule [MetronomeSDK::V1::Customers::CommitCreateParams::InvoiceSchedule] Required for "POSTPAID" commits: the true up invoice will be generated at this t
+          # @param invoice_schedule [MetronomeSDK::Models::V1::Customers::CommitCreateParams::InvoiceSchedule] Required for "POSTPAID" commits: the true up invoice will be generated at this t
           #
           # @param name [String] displayed on invoices
           #
           # @param netsuite_sales_order_id [String] This field's availability is dependent on your client's configuration.
           #
-          # @param rate_type [Symbol, MetronomeSDK::V1::Customers::CommitCreateParams::RateType]
+          # @param rate_type [Symbol, MetronomeSDK::Models::V1::Customers::CommitCreateParams::RateType]
           #
           # @param salesforce_opportunity_id [String] This field's availability is dependent on your client's configuration.
           #
+          # @param specifiers [Array<MetronomeSDK::Models::V1::Customers::CommitCreateParams::Specifier>] List of filters that determine what kind of customer usage draws down a commit o
+          #
           # @param uniqueness_key [String] Prevents the creation of duplicates. If a request to create a commit or credit i
           #
           # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]

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

@@ -10,9 +10,9 @@ module MetronomeSDK
           #
           # Create a new credit at the customer level.
           #
-          # @overload create(access_schedule:, customer_id:, priority:, product_id:, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, custom_fields: nil, description: nil, name: nil, netsuite_sales_order_id: nil, rate_type: nil, salesforce_opportunity_id: nil, uniqueness_key: nil, request_options: {})
+          # @overload create(access_schedule:, customer_id:, priority:, product_id:, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, custom_fields: nil, description: nil, name: nil, netsuite_sales_order_id: nil, rate_type: nil, salesforce_opportunity_id: nil, specifiers: nil, uniqueness_key: nil, request_options: {})
           #
-          # @param access_schedule [MetronomeSDK::V1::Customers::CreditCreateParams::AccessSchedule] Schedule for distributing the credit to the customer.
+          # @param access_schedule [MetronomeSDK::Models::V1::Customers::CreditCreateParams::AccessSchedule] Schedule for distributing the credit to the customer.
           #
           # @param customer_id [String]
           #
@@ -34,10 +34,12 @@ module MetronomeSDK
           #
           # @param netsuite_sales_order_id [String] This field's availability is dependent on your client's configuration.
           #
-          # @param rate_type [Symbol, MetronomeSDK::V1::Customers::CreditCreateParams::RateType]
+          # @param rate_type [Symbol, MetronomeSDK::Models::V1::Customers::CreditCreateParams::RateType]
           #
           # @param salesforce_opportunity_id [String] This field's availability is dependent on your client's configuration.
           #
+          # @param specifiers [Array<MetronomeSDK::Models::V1::Customers::CreditCreateParams::Specifier>] List of filters that determine what kind of customer usage draws down a commit o
+          #
           # @param uniqueness_key [String] Prevents the creation of duplicates. If a request to create a commit or credit i
           #
           # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]

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

@@ -62,7 +62,7 @@ module MetronomeSDK
           #
           # @param skip_zero_qty_line_items [Boolean] Query param: If set, all zero quantity line items will be filtered out of the re
           #
-          # @param sort [Symbol, MetronomeSDK::V1::Customers::InvoiceListParams::Sort] Query param: Invoice sort order by issued_at, e.g. date_asc or date_desc. Defau
+          # @param sort [Symbol, MetronomeSDK::Models::V1::Customers::InvoiceListParams::Sort] Query param: Invoice sort order by issued_at, e.g. date_asc or date_desc. Defau
           #
           # @param starting_on [Time] Query param: RFC 3339 timestamp (inclusive). Invoices will only be returned for
           #
@@ -70,7 +70,7 @@ module MetronomeSDK
           #
           # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [MetronomeSDK::Internal::CursorPage<MetronomeSDK::V1::Customers::Invoice>]
+          # @return [MetronomeSDK::Internal::CursorPage<MetronomeSDK::Models::V1::Customers::Invoice>]
           #
           # @see MetronomeSDK::Models::V1::Customers::InvoiceListParams
           def list(params)
@@ -156,11 +156,11 @@ module MetronomeSDK
           #
           # @param skip_zero_qty_line_items [Boolean] Query param: If set, all zero quantity line items will be filtered out of the re
           #
-          # @param sort [Symbol, MetronomeSDK::V1::Customers::InvoiceListBreakdownsParams::Sort] Query param: Invoice sort order by issued_at, e.g. date_asc or date_desc. Defau
+          # @param sort [Symbol, MetronomeSDK::Models::V1::Customers::InvoiceListBreakdownsParams::Sort] Query param: Invoice sort order by issued_at, e.g. date_asc or date_desc. Defau
           #
           # @param status [String] Query param: Invoice status, e.g. DRAFT or FINALIZED
           #
-          # @param window_size [Symbol, MetronomeSDK::V1::Customers::InvoiceListBreakdownsParams::WindowSize] Query param: The granularity of the breakdowns to return. Defaults to day.
+          # @param window_size [Symbol, MetronomeSDK::Models::V1::Customers::InvoiceListBreakdownsParams::WindowSize] Query param: The granularity of the breakdowns to return. Defaults to day.
           #
           # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
           #

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

@@ -55,11 +55,11 @@ module MetronomeSDK
           #
           # @param net_payment_terms_days [Float] Body param: Number of days after issuance of invoice after which the invoice is
           #
-          # @param overage_rate_adjustments [Array<MetronomeSDK::V1::Customers::PlanAddParams::OverageRateAdjustment>] Body param: An optional list of overage rates that override the rates of the ori
+          # @param overage_rate_adjustments [Array<MetronomeSDK::Models::V1::Customers::PlanAddParams::OverageRateAdjustment>] Body param: An optional list of overage rates that override the rates of the ori
           #
-          # @param price_adjustments [Array<MetronomeSDK::V1::Customers::PlanAddParams::PriceAdjustment>] Body param: A list of price adjustments can be applied on top of the pricing in
+          # @param price_adjustments [Array<MetronomeSDK::Models::V1::Customers::PlanAddParams::PriceAdjustment>] Body param: A list of price adjustments can be applied on top of the pricing in
           #
-          # @param trial_spec [MetronomeSDK::V1::Customers::PlanAddParams::TrialSpec] Body param: A custom trial can be set for the customer's plan. See the [trial co
+          # @param trial_spec [MetronomeSDK::Models::V1::Customers::PlanAddParams::TrialSpec] Body param: A custom trial can be set for the customer's plan. See the [trial co
           #
           # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
           #

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

@@ -34,11 +34,11 @@ module MetronomeSDK
         #
         # @param name [String] This will be truncated to 160 characters if the provided name is longer.
         #
-        # @param billing_config [MetronomeSDK::V1::CustomerCreateParams::BillingConfig]
+        # @param billing_config [MetronomeSDK::Models::V1::CustomerCreateParams::BillingConfig]
         #
         # @param custom_fields [Hash{Symbol=>String}]
         #
-        # @param customer_billing_provider_configurations [Array<MetronomeSDK::V1::CustomerCreateParams::CustomerBillingProviderConfiguration>]
+        # @param customer_billing_provider_configurations [Array<MetronomeSDK::Models::V1::CustomerCreateParams::CustomerBillingProviderConfiguration>]
         #
         # @param external_id [String] (deprecated, use ingest_aliases instead) an alias that can be used to refer to t
         #
@@ -105,7 +105,7 @@ module MetronomeSDK
         #
         # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [MetronomeSDK::Internal::CursorPage<MetronomeSDK::V1::CustomerDetail>]
+        # @return [MetronomeSDK::Internal::CursorPage<MetronomeSDK::Models::V1::CustomerDetail>]
         #
         # @see MetronomeSDK::Models::V1::CustomerListParams
         def list(params = {})
@@ -120,7 +120,8 @@ module MetronomeSDK
           )
         end
 
-        # Archive a customer
+        # Archive a customer Note: any alerts associated with the customer will not be
+        # triggered.
         #
         # @overload archive(id:, request_options: {})
         #
@@ -216,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/dashboards.rb

@@ -12,13 +12,13 @@ module MetronomeSDK
         #
         # @param customer_id [String]
         #
-        # @param dashboard [Symbol, MetronomeSDK::V1::DashboardGetEmbeddableURLParams::Dashboard] The type of dashboard to retrieve.
+        # @param dashboard [Symbol, MetronomeSDK::Models::V1::DashboardGetEmbeddableURLParams::Dashboard] The type of dashboard to retrieve.
         #
-        # @param bm_group_key_overrides [Array<MetronomeSDK::V1::DashboardGetEmbeddableURLParams::BmGroupKeyOverride>] Optional list of billable metric group key overrides
+        # @param bm_group_key_overrides [Array<MetronomeSDK::Models::V1::DashboardGetEmbeddableURLParams::BmGroupKeyOverride>] Optional list of billable metric group key overrides
         #
-        # @param color_overrides [Array<MetronomeSDK::V1::DashboardGetEmbeddableURLParams::ColorOverride>] Optional list of colors to override
+        # @param color_overrides [Array<MetronomeSDK::Models::V1::DashboardGetEmbeddableURLParams::ColorOverride>] Optional list of colors to override
         #
-        # @param dashboard_options [Array<MetronomeSDK::V1::DashboardGetEmbeddableURLParams::DashboardOption>] Optional dashboard specific options
+        # @param dashboard_options [Array<MetronomeSDK::Models::V1::DashboardGetEmbeddableURLParams::DashboardOption>] Optional dashboard specific options
         #
         # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
         #

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

@@ -98,7 +98,7 @@ module MetronomeSDK
         #
         # @param next_page [String] Query param: Cursor that indicates where the next page of results should start.
         #
-        # @param status [Symbol, MetronomeSDK::V1::PlanListCustomersParams::Status] Query param: Status of customers on a given plan. Defaults to `active`.
+        # @param status [Symbol, MetronomeSDK::Models::V1::PlanListCustomersParams::Status] Query param: Status of customers on a given plan. Defaults to `active`.
         #
         # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
         #

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

@@ -16,11 +16,11 @@ module MetronomeSDK
         #
         # @param starting_on [Time] Body param:
         #
-        # @param window_size [Symbol, MetronomeSDK::V1::UsageListParams::WindowSize] Body param: A window_size of "day" or "hour" will return the usage for the speci
+        # @param window_size [Symbol, MetronomeSDK::Models::V1::UsageListParams::WindowSize] Body param: A window_size of "day" or "hour" will return the usage for the speci
         #
         # @param next_page [String] Query param: Cursor that indicates where the next page of results should start.
         #
-        # @param billable_metrics [Array<MetronomeSDK::V1::UsageListParams::BillableMetric>] Body param: A list of billable metrics to fetch usage for. If absent, all billab
+        # @param billable_metrics [Array<MetronomeSDK::Models::V1::UsageListParams::BillableMetric>] Body param: A list of billable metrics to fetch usage for. If absent, all billab
         #
         # @param customer_ids [Array<String>] Body param: A list of Metronome customer IDs to fetch usage for. If absent, usag
         #
@@ -50,7 +50,7 @@ module MetronomeSDK
         #
         # @overload ingest(usage: nil, request_options: {})
         #
-        # @param usage [Array<MetronomeSDK::V1::UsageIngestParams::Usage>]
+        # @param usage [Array<MetronomeSDK::Models::V1::UsageIngestParams::Usage>]
         # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]
@@ -79,7 +79,7 @@ module MetronomeSDK
         #
         # @param customer_id [String] Body param:
         #
-        # @param window_size [Symbol, MetronomeSDK::V1::UsageListWithGroupsParams::WindowSize] Body param: A window_size of "day" or "hour" will return the usage for the speci
+        # @param window_size [Symbol, MetronomeSDK::Models::V1::UsageListWithGroupsParams::WindowSize] Body param: A window_size of "day" or "hour" will return the usage for the speci
         #
         # @param limit [Integer] Query param: Max number of results that should be returned
         #
@@ -89,7 +89,7 @@ module MetronomeSDK
         #
         # @param ending_before [Time] Body param:
         #
-        # @param group_by [MetronomeSDK::V1::UsageListWithGroupsParams::GroupBy] Body param:
+        # @param group_by [MetronomeSDK::Models::V1::UsageListWithGroupsParams::GroupBy] Body param:
         #
         # @param starting_on [Time] Body param:
         #
@@ -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,55 +79,65 @@ 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, 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_scheduled_charges: nil, update_spend_threshold_configuration: 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
         #
         # @param customer_id [String] ID of the customer whose contract is being edited
         #
-        # @param add_commits [Array<MetronomeSDK::V2::ContractEditParams::AddCommit>]
+        # @param add_commits [Array<MetronomeSDK::Models::V2::ContractEditParams::AddCommit>]
         #
-        # @param add_credits [Array<MetronomeSDK::V2::ContractEditParams::AddCredit>]
+        # @param add_credits [Array<MetronomeSDK::Models::V2::ContractEditParams::AddCredit>]
         #
-        # @param add_discounts [Array<MetronomeSDK::V2::ContractEditParams::AddDiscount>]
+        # @param add_discounts [Array<MetronomeSDK::Models::V2::ContractEditParams::AddDiscount>]
         #
-        # @param add_overrides [Array<MetronomeSDK::V2::ContractEditParams::AddOverride>]
+        # @param add_overrides [Array<MetronomeSDK::Models::V2::ContractEditParams::AddOverride>]
         #
-        # @param add_prepaid_balance_threshold_configuration [MetronomeSDK::V2::ContractEditParams::AddPrepaidBalanceThresholdConfiguration]
+        # @param add_prepaid_balance_threshold_configuration [MetronomeSDK::Models::V2::ContractEditParams::AddPrepaidBalanceThresholdConfiguration]
         #
-        # @param add_professional_services [Array<MetronomeSDK::V2::ContractEditParams::AddProfessionalService>] This field's availability is dependent on your client's configuration.
+        # @param add_professional_services [Array<MetronomeSDK::Models::V2::ContractEditParams::AddProfessionalService>] This field's availability is dependent on your client's configuration.
         #
-        # @param add_recurring_commits [Array<MetronomeSDK::V2::ContractEditParams::AddRecurringCommit>]
+        # @param add_recurring_commits [Array<MetronomeSDK::Models::V2::ContractEditParams::AddRecurringCommit>]
         #
-        # @param add_recurring_credits [Array<MetronomeSDK::V2::ContractEditParams::AddRecurringCredit>]
+        # @param add_recurring_credits [Array<MetronomeSDK::Models::V2::ContractEditParams::AddRecurringCredit>]
         #
-        # @param add_reseller_royalties [Array<MetronomeSDK::V2::ContractEditParams::AddResellerRoyalty>]
+        # @param add_reseller_royalties [Array<MetronomeSDK::Models::V2::ContractEditParams::AddResellerRoyalty>]
         #
-        # @param add_scheduled_charges [Array<MetronomeSDK::V2::ContractEditParams::AddScheduledCharge>]
+        # @param add_scheduled_charges [Array<MetronomeSDK::Models::V2::ContractEditParams::AddScheduledCharge>]
         #
-        # @param add_spend_threshold_configuration [MetronomeSDK::V2::ContractEditParams::AddSpendThresholdConfiguration]
+        # @param add_spend_threshold_configuration [MetronomeSDK::Models::V2::ContractEditParams::AddSpendThresholdConfiguration]
+        #
+        # @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
         #
-        # @param archive_commits [Array<MetronomeSDK::V2::ContractEditParams::ArchiveCommit>] IDs of commits to archive
+        # @param archive_commits [Array<MetronomeSDK::Models::V2::ContractEditParams::ArchiveCommit>] IDs of commits to archive
+        #
+        # @param archive_credits [Array<MetronomeSDK::Models::V2::ContractEditParams::ArchiveCredit>] IDs of credits to archive
+        #
+        # @param archive_scheduled_charges [Array<MetronomeSDK::Models::V2::ContractEditParams::ArchiveScheduledCharge>] IDs of scheduled charges to archive
+        #
+        # @param remove_overrides [Array<MetronomeSDK::Models::V2::ContractEditParams::RemoveOverride>] IDs of overrides to remove
         #
-        # @param archive_credits [Array<MetronomeSDK::V2::ContractEditParams::ArchiveCredit>] IDs of credits to archive
+        # @param update_commits [Array<MetronomeSDK::Models::V2::ContractEditParams::UpdateCommit>]
         #
-        # @param archive_scheduled_charges [Array<MetronomeSDK::V2::ContractEditParams::ArchiveScheduledCharge>] IDs of scheduled charges to archive
+        # @param update_contract_end_date [Time, nil] RFC 3339 timestamp indicating when the contract will end (exclusive).
         #
-        # @param remove_overrides [Array<MetronomeSDK::V2::ContractEditParams::RemoveOverride>] IDs of overrides to remove
+        # @param update_contract_name [String, nil] Value to update the contract name to. If not provided, the contract name will re
         #
-        # @param update_commits [Array<MetronomeSDK::V2::ContractEditParams::UpdateCommit>]
+        # @param update_credits [Array<MetronomeSDK::Models::V2::ContractEditParams::UpdateCredit>]
         #
-        # @param update_contract_end_date [Time] RFC 3339 timestamp indicating when the contract will end (exclusive).
+        # @param update_prepaid_balance_threshold_configuration [MetronomeSDK::Models::V2::ContractEditParams::UpdatePrepaidBalanceThresholdConfiguration]
         #
-        # @param update_credits [Array<MetronomeSDK::V2::ContractEditParams::UpdateCredit>]
+        # @param update_recurring_commits [Array<MetronomeSDK::Models::V2::ContractEditParams::UpdateRecurringCommit>] Edits to these recurring commits will only affect commits whose access schedules
         #
-        # @param update_prepaid_balance_threshold_configuration [MetronomeSDK::V2::ContractEditParams::UpdatePrepaidBalanceThresholdConfiguration]
+        # @param update_recurring_credits [Array<MetronomeSDK::Models::V2::ContractEditParams::UpdateRecurringCredit>] Edits to these recurring credits will only affect credits whose access schedules
         #
-        # @param update_scheduled_charges [Array<MetronomeSDK::V2::ContractEditParams::UpdateScheduledCharge>]
+        # @param update_scheduled_charges [Array<MetronomeSDK::Models::V2::ContractEditParams::UpdateScheduledCharge>]
         #
-        # @param update_spend_threshold_configuration [MetronomeSDK::V2::ContractEditParams::UpdateSpendThresholdConfiguration]
+        # @param update_spend_threshold_configuration [MetronomeSDK::Models::V2::ContractEditParams::UpdateSpendThresholdConfiguration]
+        #
+        # @param update_subscriptions [Array<MetronomeSDK::Models::V2::ContractEditParams::UpdateSubscription>] Optional list of subscriptions to update.
         #
         # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -151,24 +161,26 @@ module MetronomeSDK
         # Edit a customer or contract commit. Contract commits can only be edited using
         # this endpoint if contract editing is enabled.
         #
-        # @overload edit_commit(commit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, invoice_contract_id: nil, invoice_schedule: nil, product_id: nil, request_options: {})
+        # @overload edit_commit(commit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, invoice_contract_id: nil, invoice_schedule: nil, product_id: nil, specifiers: nil, request_options: {})
         #
         # @param commit_id [String] ID of the commit to edit
         #
         # @param customer_id [String] ID of the customer whose commit is being edited
         #
-        # @param access_schedule [MetronomeSDK::V2::ContractEditCommitParams::AccessSchedule]
+        # @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
         #
-        # @param invoice_schedule [MetronomeSDK::V2::ContractEditCommitParams::InvoiceSchedule]
+        # @param invoice_schedule [MetronomeSDK::Models::V2::ContractEditCommitParams::InvoiceSchedule]
         #
         # @param product_id [String]
         #
+        # @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]
         #
         # @return [MetronomeSDK::Models::V2::ContractEditCommitResponse]
@@ -191,13 +203,13 @@ module MetronomeSDK
         # Edit a customer or contract credit. Contract credits can only be edited using
         # this endpoint if contract editing is enabled.
         #
-        # @overload edit_credit(credit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, product_id: nil, request_options: {})
+        # @overload edit_credit(credit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, product_id: nil, specifiers: nil, request_options: {})
         #
         # @param credit_id [String] ID of the credit to edit
         #
         # @param customer_id [String] ID of the customer whose credit is being edited
         #
-        # @param access_schedule [MetronomeSDK::V2::ContractEditCreditParams::AccessSchedule]
+        # @param access_schedule [MetronomeSDK::Models::V2::ContractEditCreditParams::AccessSchedule]
         #
         # @param applicable_product_ids [Array<String>, nil] Which products the credit applies to. If both applicable_product_ids and applica
         #
@@ -205,6 +217,8 @@ module MetronomeSDK
         #
         # @param product_id [String]
         #
+        # @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]
         #
         # @return [MetronomeSDK::Models::V2::ContractEditCreditResponse]

data/lib/metronome_sdk/version.rb

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

data/lib/metronome_sdk.rb

@@ -20,7 +20,9 @@ require "uri"
 
 # We already ship the preferred sorbet manifests in the package itself.
 # `tapioca` currently does not offer us a way to opt out of unnecessary compilation.
-if Object.const_defined?(:Tapioca) && caller.chain([$PROGRAM_NAME]).chain(ARGV).grep(/tapioca/)
+if Object.const_defined?(:Tapioca) &&
+   caller.chain([$PROGRAM_NAME]).chain(ARGV).any?(/tapioca/) &&
+   ARGV.none?(/dsl/)
   return
 end
 
@@ -97,6 +99,8 @@ require_relative "metronome_sdk/models/v1/contract_retrieve_params"
 require_relative "metronome_sdk/models/v1/contract_retrieve_rate_schedule_params"
 require_relative "metronome_sdk/models/v1/contract_retrieve_rate_schedule_response"
 require_relative "metronome_sdk/models/v1/contract_retrieve_response"
+require_relative "metronome_sdk/models/v1/contract_retrieve_subscription_quantity_history_params"
+require_relative "metronome_sdk/models/v1/contract_retrieve_subscription_quantity_history_response"
 require_relative "metronome_sdk/models/v1/contracts/named_schedule_retrieve_params"
 require_relative "metronome_sdk/models/v1/contracts/named_schedule_retrieve_response"
 require_relative "metronome_sdk/models/v1/contracts/named_schedule_update_params"
@@ -165,6 +169,8 @@ require_relative "metronome_sdk/models/v1/customer_list_billable_metrics_respons
 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_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"
@@ -243,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/transport/pooled_net_requester.rbi

@@ -22,6 +22,8 @@ module MetronomeSDK
         # https://github.com/golang/go/blob/c8eced8580028328fde7c03cbfcb720ce15b2358/src/net/http/transport.go#L49
         KEEP_ALIVE_TIMEOUT = 30
 
+        DEFAULT_MAX_CONNECTIONS = T.let(T.unsafe(nil), Integer)
+
         class << self
           # @api private
           sig { params(url: URI::Generic).returns(Net::HTTP) }
@@ -68,7 +70,9 @@ module MetronomeSDK
 
         # @api private
         sig { params(size: Integer).returns(T.attached_class) }
-        def self.new(size: Etc.nprocessors)
+        def self.new(
+          size: MetronomeSDK::Internal::Transport::PooledNetRequester::DEFAULT_MAX_CONNECTIONS
+        )
         end
       end
     end

data/rbi/metronome_sdk/internal/type/array_of.rbi

@@ -8,6 +8,7 @@ module MetronomeSDK
       # Array of items of a given type.
       class ArrayOf
         include MetronomeSDK::Internal::Type::Converter
+        include MetronomeSDK::Internal::Util::SorbetRuntimeSupport
 
         abstract!
 
@@ -63,6 +64,11 @@ module MetronomeSDK
         def dump(value, state:)
         end
 
+        # @api private
+        sig { returns(T.anything) }
+        def to_sorbet_type
+        end
+
         # @api private
         sig { returns(Elem) }
         protected def item_type

data/rbi/metronome_sdk/internal/type/base_model.rbi

@@ -205,6 +205,11 @@ module MetronomeSDK
           end
           def dump(value, state:)
           end
+
+          # @api private
+          sig { returns(T.anything) }
+          def to_sorbet_type
+          end
         end
 
         class << self

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

@@ -8,6 +8,7 @@ module MetronomeSDK
       # Ruby has no Boolean class; this is something for models to refer to.
       class Boolean
         extend MetronomeSDK::Internal::Type::Converter
+        extend MetronomeSDK::Internal::Util::SorbetRuntimeSupport
 
         abstract!
 
@@ -21,6 +22,8 @@ module MetronomeSDK
 
         class << self
           # @api private
+          #
+          # Coerce value to Boolean if possible, otherwise return the original value.
           sig do
             override
               .params(
@@ -43,6 +46,11 @@ module MetronomeSDK
           end
           def dump(value, state:)
           end
+
+          # @api private
+          sig { returns(T.anything) }
+          def to_sorbet_type
+          end
         end
       end
     end