metronome-sdk 1.0.0 → 2.1.0

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

@@ -176,7 +176,7 @@ module MetronomeSDK
         # - Ingest aliases remain idempotent for archived customers. In order to reuse an
         #   ingest alias, first remove the ingest alias from the customer prior to
         #   archiving.
-        # - Any alerts associated with the customer will no longer be triggered.
+        # - Any notifications associated with the customer will no longer be triggered.
         #
         # @overload archive(id:, request_options: {})
         #
@@ -240,7 +240,8 @@ module MetronomeSDK
 
         # Fetch daily pending costs for the specified customer, broken down by credit type
         # and line items. Note: this is not supported for customers whose plan includes a
-        # UNIQUE-type billable metric.
+        # UNIQUE-type billable metric. This is a Plans (deprecated) endpoint. New clients
+        # should implement using Contracts.
         #
         # @overload list_costs(customer_id:, ending_before:, starting_on:, limit: nil, next_page: nil, request_options: {})
         #
@@ -278,20 +279,21 @@ module MetronomeSDK
         # 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
+        # Preview how a set of events will affect a customer's invoices. Generates draft
+        # invoices 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.
+        # customer's invoices before they are actually processed. Customers on contracts
+        # with SQL billable metrics are not supported.
         #
         # @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 events [Array<MetronomeSDK::Models::V1::CustomerPreviewEventsParams::Event>] Body param: Array of usage events to include in the preview calculation. Must co
         #
-        # @param mode [Symbol, MetronomeSDK::Models::V1::CustomerPreviewEventsParams::Mode] Body param: If set to "replace", the preview will be generated as if those were
+        # @param mode [Symbol, MetronomeSDK::Models::V1::CustomerPreviewEventsParams::Mode] Body param: Controls how the provided events are combined with existing usage da
         #
-        # @param skip_zero_qty_line_items [Boolean] Body param: If set, all zero quantity line items will be filtered out of the res
+        # @param skip_zero_qty_line_items [Boolean] Body param: When `true`, line items with zero quantity are excluded from the res
         #
         # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -353,6 +355,9 @@ module MetronomeSDK
         #   through system A (e.g. Stripe) but will now be billed through system B (e.g.
         #   AWS). Once created, the new configuration can then be associated to the
         #   customer's contract.
+        # - Multiple configurations can be added per destination. For example, you can
+        #   create two Stripe billing configurations for a Metronome customer that each
+        #   have a distinct `collection_method`.
         #
         # ### Delivery method options:
         #

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

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+module MetronomeSDK
+  module Resources
+    class V1
+      class Payments
+        # Fetch all payment attempts for the given invoice.
+        #
+        # @overload list(customer_id:, invoice_id:, limit: nil, next_page: nil, statuses: nil, request_options: {})
+        #
+        # @param customer_id [String]
+        #
+        # @param invoice_id [String]
+        #
+        # @param limit [Integer] The maximum number of payments to return. Defaults to 25.
+        #
+        # @param next_page [String] The next page token from a previous response.
+        #
+        # @param statuses [Array<Symbol, MetronomeSDK::Models::V1::PaymentStatus>]
+        #
+        # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [MetronomeSDK::Internal::BodyCursorPage<MetronomeSDK::Models::V1::Payment>]
+        #
+        # @see MetronomeSDK::Models::V1::PaymentListParams
+        def list(params)
+          parsed, options = MetronomeSDK::V1::PaymentListParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/payments/list",
+            body: parsed,
+            page: MetronomeSDK::Internal::BodyCursorPage,
+            model: MetronomeSDK::V1::Payment,
+            options: options
+          )
+        end
+
+        # Trigger a new attempt by canceling any existing attempts for this invoice and
+        # creating a new Payment. This will trigger another attempt to charge the
+        # Customer's configured Payment Gateway. Payment can only be attempted if all of
+        # the following are true:
+        #
+        # - The Metronome Invoice is finalized
+        # - PLG Invoicing is configured for the Customer
+        # - You cannot attempt payments for invoices that have already been `paid` or
+        #   `voided`.
+        #
+        # Attempting to payment on an ineligible Invoice or Customer will result in a
+        # `400` response.
+        #
+        # @overload attempt(customer_id:, invoice_id:, request_options: {})
+        #
+        # @param customer_id [String]
+        # @param invoice_id [String]
+        # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [MetronomeSDK::Models::V1::PaymentAttemptResponse]
+        #
+        # @see MetronomeSDK::Models::V1::PaymentAttemptParams
+        def attempt(params)
+          parsed, options = MetronomeSDK::V1::PaymentAttemptParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/payments/attempt",
+            body: parsed,
+            model: MetronomeSDK::Models::V1::PaymentAttemptResponse,
+            options: options
+          )
+        end
+
+        # Cancel an existing payment attempt for an invoice.
+        #
+        # @overload cancel(customer_id:, invoice_id:, request_options: {})
+        #
+        # @param customer_id [String]
+        # @param invoice_id [String]
+        # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [MetronomeSDK::Models::V1::PaymentCancelResponse]
+        #
+        # @see MetronomeSDK::Models::V1::PaymentCancelParams
+        def cancel(params)
+          parsed, options = MetronomeSDK::V1::PaymentCancelParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/payments/cancel",
+            body: parsed,
+            model: MetronomeSDK::Models::V1::PaymentCancelResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [MetronomeSDK::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

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

@@ -4,7 +4,8 @@ module MetronomeSDK
   module Resources
     class V1
       class Plans
-        # List all available plans.
+        # List all available plans. This is a Plans (deprecated) endpoint. New clients
+        # should implement using Contracts.
         #
         # @overload list(limit: nil, next_page: nil, request_options: {})
         #
@@ -29,7 +30,8 @@ module MetronomeSDK
           )
         end
 
-        # Fetch high level details of a specific plan.
+        # Fetch high level details of a specific plan. This is a Plans (deprecated)
+        # endpoint. New clients should implement using Contracts.
         #
         # @overload get_details(plan_id:, request_options: {})
         #
@@ -53,7 +55,8 @@ module MetronomeSDK
           )
         end
 
-        # Fetches a list of charges of a specific plan.
+        # Fetches a list of charges of a specific plan. This is a Plans (deprecated)
+        # endpoint. New clients should implement using Contracts.
         #
         # @overload list_charges(plan_id:, limit: nil, next_page: nil, request_options: {})
         #
@@ -88,7 +91,8 @@ module MetronomeSDK
         # {MetronomeSDK::Models::V1::PlanListCustomersParams} for more details.
         #
         # Fetches a list of customers on a specific plan (by default, only currently
-        # active plans are included)
+        # active plans are included). This is a Plans (deprecated) endpoint. New clients
+        # should implement using Contracts.
         #
         # @overload list_customers(plan_id:, limit: nil, next_page: nil, status: nil, request_options: {})
         #

data/lib/metronome_sdk/resources/v1/settings/billing_providers.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module MetronomeSDK
+  module Resources
+    class V1
+      class Settings
+        class BillingProviders
+          # Some parameter documentations has been truncated, see
+          # {MetronomeSDK::Models::V1::Settings::BillingProviderCreateParams} for more
+          # details.
+          #
+          # Set up account-level configuration for a billing provider. Once configured,
+          # individual contracts across customers can be mapped to this configuration using
+          # the returned delivery_method_id.
+          #
+          # @overload create(billing_provider:, configuration:, delivery_method:, request_options: {})
+          #
+          # @param billing_provider [Symbol, MetronomeSDK::Models::V1::Settings::BillingProviderCreateParams::BillingProvider] The billing provider set for this configuration.
+          #
+          # @param configuration [Hash{Symbol=>Object}] Account-level configuration for the billing provider. The structure of this obje
+          #
+          # @param delivery_method [Symbol, MetronomeSDK::Models::V1::Settings::BillingProviderCreateParams::DeliveryMethod] The method to use for delivering invoices for this configuration.
+          #
+          # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [MetronomeSDK::Models::V1::Settings::BillingProviderCreateResponse]
+          #
+          # @see MetronomeSDK::Models::V1::Settings::BillingProviderCreateParams
+          def create(params)
+            parsed, options = MetronomeSDK::V1::Settings::BillingProviderCreateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: "v1/setUpBillingProvider",
+              body: parsed,
+              model: MetronomeSDK::Models::V1::Settings::BillingProviderCreateResponse,
+              options: options
+            )
+          end
+
+          # Lists all configured billing providers and their delivery method configurations
+          # for your account. Returns provider details, delivery method IDs, and
+          # configuration settings needed for mapping individual customer contracts to
+          # billing integrations.
+          #
+          # @overload list(next_page: nil, request_options: {})
+          #
+          # @param next_page [String, nil] The cursor to the next page of results
+          #
+          # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [MetronomeSDK::Models::V1::Settings::BillingProviderListResponse]
+          #
+          # @see MetronomeSDK::Models::V1::Settings::BillingProviderListParams
+          def list(params = {})
+            parsed, options = MetronomeSDK::V1::Settings::BillingProviderListParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: "v1/listConfiguredBillingProviders",
+              body: parsed,
+              model: MetronomeSDK::Models::V1::Settings::BillingProviderListResponse,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [MetronomeSDK::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module MetronomeSDK
+  module Resources
+    class V1
+      class Settings
+        # @return [MetronomeSDK::Resources::V1::Settings::BillingProviders]
+        attr_reader :billing_providers
+
+        # Some parameter documentations has been truncated, see
+        # {MetronomeSDK::Models::V1::SettingUpsertAvalaraCredentialsParams} for more
+        # details.
+        #
+        # Set the Avalara credentials for some specified `delivery_method_ids`, which can
+        # be found in the `/listConfiguredBillingProviders` response. This maps the
+        # Avalara credentials to the appropriate billing entity. These credentials are
+        # only used for PLG Invoicing today.
+        #
+        # @overload upsert_avalara_credentials(avalara_environment:, avalara_password:, avalara_username:, delivery_method_ids:, request_options: {})
+        #
+        # @param avalara_environment [Symbol, MetronomeSDK::Models::V1::SettingUpsertAvalaraCredentialsParams::AvalaraEnvironment] The Avalara environment to use (SANDBOX or PRODUCTION).
+        #
+        # @param avalara_password [String] The password for the Avalara account.
+        #
+        # @param avalara_username [String] The username for the Avalara account.
+        #
+        # @param delivery_method_ids [Array<String>] The delivery method IDs of the billing provider configurations to update, can be
+        #
+        # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [MetronomeSDK::Models::V1::SettingUpsertAvalaraCredentialsResponse]
+        #
+        # @see MetronomeSDK::Models::V1::SettingUpsertAvalaraCredentialsParams
+        def upsert_avalara_credentials(params)
+          parsed, options = MetronomeSDK::V1::SettingUpsertAvalaraCredentialsParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/upsertAvalaraCredentials",
+            body: parsed,
+            model: MetronomeSDK::Models::V1::SettingUpsertAvalaraCredentialsResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [MetronomeSDK::Client]
+        def initialize(client:)
+          @client = client
+          @billing_providers = MetronomeSDK::Resources::V1::Settings::BillingProviders.new(client: client)
+        end
+      end
+    end
+  end
+end

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

@@ -80,8 +80,7 @@ module MetronomeSDK
         # ingestion, supports backdating 34 days, and is built to handle mission-critical
         # usage data with enterprise-grade reliability. Metronome supports 100,000 events
         # per second without requiring pre-aggregation or rollups and can scale up from
-        # there. See
-        # [Getting usage into Metronome](https://docs.metronome.com/connect-metronome/) to
+        # there. See the [Send usage events](/guides/events/send-usage-events) guide to
         # learn more about usage events.
         #
         # ### Use this endpoint to:
@@ -124,6 +123,9 @@ module MetronomeSDK
         # }
         # ```
         #
+        # Learn more about
+        # [usage event structure definitions](/guides/events/design-usage-events).
+        #
         # #### Transaction ID
         #
         # The transaction_id serves as your idempotency key, ensuring events are processed

data/lib/metronome_sdk/resources/v1.rb

@@ -42,6 +42,12 @@ module MetronomeSDK
       # @return [MetronomeSDK::Resources::V1::Contracts]
       attr_reader :contracts
 
+      # @return [MetronomeSDK::Resources::V1::Payments]
+      attr_reader :payments
+
+      # @return [MetronomeSDK::Resources::V1::Settings]
+      attr_reader :settings
+
       # @api private
       #
       # @param client [MetronomeSDK::Client]
@@ -60,6 +66,8 @@ module MetronomeSDK
         @services = MetronomeSDK::Resources::V1::Services.new(client: client)
         @invoices = MetronomeSDK::Resources::V1::Invoices.new(client: client)
         @contracts = MetronomeSDK::Resources::V1::Contracts.new(client: client)
+        @payments = MetronomeSDK::Resources::V1::Payments.new(client: client)
+        @settings = MetronomeSDK::Resources::V1::Settings.new(client: client)
       end
     end
   end

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

@@ -128,12 +128,14 @@ module MetronomeSDK
         # - Contract editing must be enabled to use this endpoint. Reach out to your
         #   Metronome representative to learn more.
         #
-        # @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, uniqueness_key: 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: {})
+        # @overload edit(contract_id:, customer_id:, add_billing_provider_configuration_update: nil, 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, uniqueness_key: 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_billing_provider_configuration_update [MetronomeSDK::Models::V2::ContractEditParams::AddBillingProviderConfigurationUpdate] Update the billing provider configuration on the contract. Currently only suppor
+        #
         # @param add_commits [Array<MetronomeSDK::Models::V2::ContractEditParams::AddCommit>]
         #
         # @param add_credits [Array<MetronomeSDK::Models::V2::ContractEditParams::AddCredit>]
@@ -226,7 +228,7 @@ module MetronomeSDK
         #   finalized invoice. You can void the invoice beforehand and then remove the
         #   access schedule segment.
         #
-        # @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, priority: nil, product_id: nil, rate_type: nil, specifiers: nil, request_options: {})
+        # @overload edit_commit(commit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, hierarchy_configuration: nil, invoice_contract_id: nil, invoice_schedule: nil, priority: nil, product_id: nil, rate_type: nil, specifiers: nil, request_options: {})
         #
         # @param commit_id [String] ID of the commit to edit
         #
@@ -238,6 +240,8 @@ module MetronomeSDK
         #
         # @param applicable_product_tags [Array<String>, nil] Which tags the commit applies to. If applicable*product_ids, applicable_product*
         #
+        # @param hierarchy_configuration [MetronomeSDK::Models::CommitHierarchyConfiguration] Optional configuration for commit hierarchy access control
+        #
         # @param invoice_contract_id [String] ID of contract to use for invoicing
         #
         # @param invoice_schedule [MetronomeSDK::Models::V2::ContractEditCommitParams::InvoiceSchedule]
@@ -286,7 +290,7 @@ module MetronomeSDK
         #   invoice. You can void the invoice beforehand and then remove the access
         #   schedule segment.
         #
-        # @overload edit_credit(credit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, priority: nil, product_id: nil, rate_type: nil, specifiers: nil, request_options: {})
+        # @overload edit_credit(credit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, hierarchy_configuration: nil, priority: nil, product_id: nil, rate_type: nil, specifiers: nil, request_options: {})
         #
         # @param credit_id [String] ID of the credit to edit
         #
@@ -298,6 +302,8 @@ module MetronomeSDK
         #
         # @param applicable_product_tags [Array<String>, nil] Which tags the credit applies to. If both applicable*product_ids and applicable*
         #
+        # @param hierarchy_configuration [MetronomeSDK::Models::CommitHierarchyConfiguration] Optional configuration for credit hierarchy access control
+        #
         # @param priority [Float, nil] If multiple commits are applicable, the one with the lower priority will apply f
         #
         # @param product_id [String]

data/lib/metronome_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MetronomeSDK
-  VERSION = "1.0.0"
+  VERSION = "2.1.0"
 end

data/lib/metronome_sdk.rb

@@ -221,6 +221,7 @@ require_relative "metronome_sdk/models/v1/customers/invoice_list_breakdowns_para
 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_retrieve_params"
+require_relative "metronome_sdk/models/v1/customers/invoice_retrieve_pdf_params"
 require_relative "metronome_sdk/models/v1/customers/invoice_retrieve_response"
 require_relative "metronome_sdk/models/v1/customers/named_schedule_retrieve_params"
 require_relative "metronome_sdk/models/v1/customers/named_schedule_retrieve_response"
@@ -250,6 +251,13 @@ 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/payment"
+require_relative "metronome_sdk/models/v1/payment_attempt_params"
+require_relative "metronome_sdk/models/v1/payment_attempt_response"
+require_relative "metronome_sdk/models/v1/payment_cancel_params"
+require_relative "metronome_sdk/models/v1/payment_cancel_response"
+require_relative "metronome_sdk/models/v1/payment_list_params"
+require_relative "metronome_sdk/models/v1/payment_status"
 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"
@@ -265,6 +273,12 @@ 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/settings/billing_provider_create_params"
+require_relative "metronome_sdk/models/v1/settings/billing_provider_create_response"
+require_relative "metronome_sdk/models/v1/settings/billing_provider_list_params"
+require_relative "metronome_sdk/models/v1/settings/billing_provider_list_response"
+require_relative "metronome_sdk/models/v1/setting_upsert_avalara_credentials_params"
+require_relative "metronome_sdk/models/v1/setting_upsert_avalara_credentials_response"
 require_relative "metronome_sdk/models/v1/usage_ingest_params"
 require_relative "metronome_sdk/models/v1/usage_list_params"
 require_relative "metronome_sdk/models/v1/usage_list_response"
@@ -308,9 +322,12 @@ require_relative "metronome_sdk/resources/v1/customers/plans"
 require_relative "metronome_sdk/resources/v1/custom_fields"
 require_relative "metronome_sdk/resources/v1/dashboards"
 require_relative "metronome_sdk/resources/v1/invoices"
+require_relative "metronome_sdk/resources/v1/payments"
 require_relative "metronome_sdk/resources/v1/plans"
 require_relative "metronome_sdk/resources/v1/pricing_units"
 require_relative "metronome_sdk/resources/v1/services"
+require_relative "metronome_sdk/resources/v1/settings"
+require_relative "metronome_sdk/resources/v1/settings/billing_providers"
 require_relative "metronome_sdk/resources/v1/usage"
 require_relative "metronome_sdk/resources/v2"
 require_relative "metronome_sdk/resources/v2/contracts"

data/rbi/metronome_sdk/errors.rbi

@@ -33,6 +33,9 @@ module MetronomeSDK
       sig { returns(T.nilable(Integer)) }
       attr_accessor :status
 
+      sig { returns(T.nilable(T::Hash[String, String])) }
+      attr_accessor :headers
+
       sig { returns(T.nilable(T.anything)) }
       attr_accessor :body
 
@@ -41,6 +44,7 @@ module MetronomeSDK
         params(
           url: URI::Generic,
           status: T.nilable(Integer),
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
@@ -50,6 +54,7 @@ module MetronomeSDK
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -70,6 +75,7 @@ module MetronomeSDK
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -79,6 +85,7 @@ module MetronomeSDK
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -93,6 +100,7 @@ module MetronomeSDK
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -102,6 +110,7 @@ module MetronomeSDK
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -116,13 +125,22 @@ module MetronomeSDK
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.for(url:, status:, body:, request:, response:, message: nil)
+      def self.for(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
 
       sig { returns(Integer) }
@@ -133,13 +151,22 @@ module MetronomeSDK
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.new(url:, status:, body:, request:, response:, message: nil)
+      def self.new(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
     end
 

data/rbi/metronome_sdk/file_part.rbi

@@ -27,7 +27,7 @@ module MetronomeSDK
     sig do
       params(
         content: T.any(Pathname, StringIO, IO, String),
-        filename: T.nilable(String),
+        filename: T.nilable(T.any(Pathname, String)),
         content_type: T.nilable(String)
       ).returns(T.attached_class)
     end

data/rbi/metronome_sdk/internal/transport/base_client.rbi

@@ -85,10 +85,9 @@ module MetronomeSDK
 
           # @api private
           sig do
-            params(
-              status: Integer,
-              headers: T.any(T::Hash[String, String], Net::HTTPHeader)
-            ).returns(T::Boolean)
+            params(status: Integer, headers: T::Hash[String, String]).returns(
+              T::Boolean
+            )
           end
           def should_retry?(status, headers:)
           end
@@ -99,7 +98,7 @@ module MetronomeSDK
               request:
                 MetronomeSDK::Internal::Transport::BaseClient::RequestInput,
               status: Integer,
-              response_headers: T.any(T::Hash[String, String], Net::HTTPHeader)
+              response_headers: T::Hash[String, String]
             ).returns(
               MetronomeSDK::Internal::Transport::BaseClient::RequestInput
             )

data/rbi/metronome_sdk/internal/type/base_page.rbi

@@ -31,7 +31,7 @@ module MetronomeSDK
             client: MetronomeSDK::Internal::Transport::BaseClient,
             req:
               MetronomeSDK::Internal::Transport::BaseClient::RequestComponents,
-            headers: T.any(T::Hash[String, String], Net::HTTPHeader),
+            headers: T::Hash[String, String],
             page_data: T.anything
           ).void
         end

data/rbi/metronome_sdk/internal/util.rbi

@@ -361,7 +361,7 @@ module MetronomeSDK
         # Assumes each chunk in stream has `Encoding::BINARY`.
         sig do
           params(
-            headers: T.any(T::Hash[String, String], Net::HTTPHeader),
+            headers: T::Hash[String, String],
             stream: T::Enumerable[String],
             suppress_error: T::Boolean
           ).returns(T.anything)

data/rbi/metronome_sdk/models/contract.rbi

@@ -673,6 +673,11 @@ module MetronomeSDK
               :gcp_marketplace,
               MetronomeSDK::Contract::CustomerBillingProviderConfiguration::BillingProvider::TaggedSymbol
             )
+          METRONOME =
+            T.let(
+              :metronome,
+              MetronomeSDK::Contract::CustomerBillingProviderConfiguration::BillingProvider::TaggedSymbol
+            )
 
           sig do
             override.returns(