orb-billing 1.54.0 → 1.55.0

data/rbi/orb/models/price_create_params.rbi

@@ -48,7 +48,8 @@ module Orb
             Orb::PriceCreateParams::Body::MeteredAllowance,
             Orb::NewFloatingMinimumCompositePrice,
             Orb::PriceCreateParams::Body::Percent,
-            Orb::PriceCreateParams::Body::EventOutput
+            Orb::PriceCreateParams::Body::EventOutput,
+            Orb::PriceCreateParams::Body::UnitWithMultiplier
           )
         )
       end
@@ -93,7 +94,8 @@ module Orb
               Orb::PriceCreateParams::Body::MeteredAllowance::OrHash,
               Orb::NewFloatingMinimumCompositePrice::OrHash,
               Orb::PriceCreateParams::Body::Percent::OrHash,
-              Orb::PriceCreateParams::Body::EventOutput::OrHash
+              Orb::PriceCreateParams::Body::EventOutput::OrHash,
+              Orb::PriceCreateParams::Body::UnitWithMultiplier::OrHash
             ),
           request_options: Orb::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -145,7 +147,8 @@ module Orb
                 Orb::PriceCreateParams::Body::MeteredAllowance,
                 Orb::NewFloatingMinimumCompositePrice,
                 Orb::PriceCreateParams::Body::Percent,
-                Orb::PriceCreateParams::Body::EventOutput
+                Orb::PriceCreateParams::Body::EventOutput,
+                Orb::PriceCreateParams::Body::UnitWithMultiplier
               ),
             request_options: Orb::RequestOptions
           }
@@ -196,7 +199,8 @@ module Orb
               Orb::PriceCreateParams::Body::MeteredAllowance,
               Orb::NewFloatingMinimumCompositePrice,
               Orb::PriceCreateParams::Body::Percent,
-              Orb::PriceCreateParams::Body::EventOutput
+              Orb::PriceCreateParams::Body::EventOutput,
+              Orb::PriceCreateParams::Body::UnitWithMultiplier
             )
           end
 
@@ -4458,6 +4462,395 @@ module Orb
           end
         end
 
+        class UnitWithMultiplier < Orb::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Orb::PriceCreateParams::Body::UnitWithMultiplier,
+                Orb::Internal::AnyHash
+              )
+            end
+
+          # The cadence to bill for this price on.
+          sig do
+            returns(
+              Orb::PriceCreateParams::Body::UnitWithMultiplier::Cadence::OrSymbol
+            )
+          end
+          attr_accessor :cadence
+
+          # An ISO 4217 currency string for which this price is billed in.
+          sig { returns(String) }
+          attr_accessor :currency
+
+          # The id of the item the price will be associated with.
+          sig { returns(String) }
+          attr_accessor :item_id
+
+          # The pricing model type
+          sig { returns(Symbol) }
+          attr_accessor :model_type
+
+          # The name of the price.
+          sig { returns(String) }
+          attr_accessor :name
+
+          # Configuration for unit_with_multiplier pricing
+          sig do
+            returns(
+              Orb::PriceCreateParams::Body::UnitWithMultiplier::UnitWithMultiplierConfig
+            )
+          end
+          attr_reader :unit_with_multiplier_config
+
+          sig do
+            params(
+              unit_with_multiplier_config:
+                Orb::PriceCreateParams::Body::UnitWithMultiplier::UnitWithMultiplierConfig::OrHash
+            ).void
+          end
+          attr_writer :unit_with_multiplier_config
+
+          # The id of the billable metric for the price. Only needed if the price is
+          # usage-based.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :billable_metric_id
+
+          # If the Price represents a fixed cost, the price will be billed in-advance if
+          # this is true, and in-arrears if this is false.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_accessor :billed_in_advance
+
+          # For custom cadence: specifies the duration of the billing period in days or
+          # months.
+          sig { returns(T.nilable(Orb::NewBillingCycleConfiguration)) }
+          attr_reader :billing_cycle_configuration
+
+          sig do
+            params(
+              billing_cycle_configuration:
+                T.nilable(Orb::NewBillingCycleConfiguration::OrHash)
+            ).void
+          end
+          attr_writer :billing_cycle_configuration
+
+          # The per unit conversion rate of the price currency to the invoicing currency.
+          sig { returns(T.nilable(Float)) }
+          attr_accessor :conversion_rate
+
+          # The configuration for the rate of the price currency to the invoicing currency.
+          sig do
+            returns(
+              T.nilable(
+                T.any(
+                  Orb::UnitConversionRateConfig,
+                  Orb::TieredConversionRateConfig
+                )
+              )
+            )
+          end
+          attr_accessor :conversion_rate_config
+
+          # For dimensional price: specifies a price group and dimension values
+          sig { returns(T.nilable(Orb::NewDimensionalPriceConfiguration)) }
+          attr_reader :dimensional_price_configuration
+
+          sig do
+            params(
+              dimensional_price_configuration:
+                T.nilable(Orb::NewDimensionalPriceConfiguration::OrHash)
+            ).void
+          end
+          attr_writer :dimensional_price_configuration
+
+          # An alias for the price.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :external_price_id
+
+          # If the Price represents a fixed cost, this represents the quantity of units
+          # applied.
+          sig { returns(T.nilable(Float)) }
+          attr_accessor :fixed_price_quantity
+
+          # The property used to group this price on an invoice
+          sig { returns(T.nilable(String)) }
+          attr_accessor :invoice_grouping_key
+
+          # Within each billing cycle, specifies the cadence at which invoices are produced.
+          # If unspecified, a single invoice is produced per billing cycle.
+          sig { returns(T.nilable(Orb::NewBillingCycleConfiguration)) }
+          attr_reader :invoicing_cycle_configuration
+
+          sig do
+            params(
+              invoicing_cycle_configuration:
+                T.nilable(Orb::NewBillingCycleConfiguration::OrHash)
+            ).void
+          end
+          attr_writer :invoicing_cycle_configuration
+
+          # The ID of the license type to associate with this price. On a usage price this
+          # also marks the price as eligible to draw down from that license type's
+          # allocation; a usage price created without it is billed normally. Usage prices
+          # with a license type must use the `unit` model, and only draw down when their
+          # currency matches the allocation's.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :license_type_id
+
+          # User-specified key/value pairs for the resource. Individual keys can be removed
+          # by setting the value to `null`, and the entire metadata mapping can be cleared
+          # by setting `metadata` to `null`.
+          sig { returns(T.nilable(T::Hash[Symbol, T.nilable(String)])) }
+          attr_accessor :metadata
+
+          sig do
+            params(
+              cadence:
+                Orb::PriceCreateParams::Body::UnitWithMultiplier::Cadence::OrSymbol,
+              currency: String,
+              item_id: String,
+              name: String,
+              unit_with_multiplier_config:
+                Orb::PriceCreateParams::Body::UnitWithMultiplier::UnitWithMultiplierConfig::OrHash,
+              billable_metric_id: T.nilable(String),
+              billed_in_advance: T.nilable(T::Boolean),
+              billing_cycle_configuration:
+                T.nilable(Orb::NewBillingCycleConfiguration::OrHash),
+              conversion_rate: T.nilable(Float),
+              conversion_rate_config:
+                T.nilable(
+                  T.any(
+                    Orb::UnitConversionRateConfig::OrHash,
+                    Orb::TieredConversionRateConfig::OrHash
+                  )
+                ),
+              dimensional_price_configuration:
+                T.nilable(Orb::NewDimensionalPriceConfiguration::OrHash),
+              external_price_id: T.nilable(String),
+              fixed_price_quantity: T.nilable(Float),
+              invoice_grouping_key: T.nilable(String),
+              invoicing_cycle_configuration:
+                T.nilable(Orb::NewBillingCycleConfiguration::OrHash),
+              license_type_id: T.nilable(String),
+              metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+              model_type: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The cadence to bill for this price on.
+            cadence:,
+            # An ISO 4217 currency string for which this price is billed in.
+            currency:,
+            # The id of the item the price will be associated with.
+            item_id:,
+            # The name of the price.
+            name:,
+            # Configuration for unit_with_multiplier pricing
+            unit_with_multiplier_config:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
+            billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
+            billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
+            billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
+            conversion_rate: nil,
+            # The configuration for the rate of the price currency to the invoicing currency.
+            conversion_rate_config: nil,
+            # For dimensional price: specifies a price group and dimension values
+            dimensional_price_configuration: nil,
+            # An alias for the price.
+            external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
+            fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
+            invoice_grouping_key: nil,
+            # Within each billing cycle, specifies the cadence at which invoices are produced.
+            # If unspecified, a single invoice is produced per billing cycle.
+            invoicing_cycle_configuration: nil,
+            # The ID of the license type to associate with this price. On a usage price this
+            # also marks the price as eligible to draw down from that license type's
+            # allocation; a usage price created without it is billed normally. Usage prices
+            # with a license type must use the `unit` model, and only draw down when their
+            # currency matches the allocation's.
+            license_type_id: nil,
+            # User-specified key/value pairs for the resource. Individual keys can be removed
+            # by setting the value to `null`, and the entire metadata mapping can be cleared
+            # by setting `metadata` to `null`.
+            metadata: nil,
+            # The pricing model type
+            model_type: :unit_with_multiplier
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                cadence:
+                  Orb::PriceCreateParams::Body::UnitWithMultiplier::Cadence::OrSymbol,
+                currency: String,
+                item_id: String,
+                model_type: Symbol,
+                name: String,
+                unit_with_multiplier_config:
+                  Orb::PriceCreateParams::Body::UnitWithMultiplier::UnitWithMultiplierConfig,
+                billable_metric_id: T.nilable(String),
+                billed_in_advance: T.nilable(T::Boolean),
+                billing_cycle_configuration:
+                  T.nilable(Orb::NewBillingCycleConfiguration),
+                conversion_rate: T.nilable(Float),
+                conversion_rate_config:
+                  T.nilable(
+                    T.any(
+                      Orb::UnitConversionRateConfig,
+                      Orb::TieredConversionRateConfig
+                    )
+                  ),
+                dimensional_price_configuration:
+                  T.nilable(Orb::NewDimensionalPriceConfiguration),
+                external_price_id: T.nilable(String),
+                fixed_price_quantity: T.nilable(Float),
+                invoice_grouping_key: T.nilable(String),
+                invoicing_cycle_configuration:
+                  T.nilable(Orb::NewBillingCycleConfiguration),
+                license_type_id: T.nilable(String),
+                metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The cadence to bill for this price on.
+          module Cadence
+            extend Orb::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Orb::PriceCreateParams::Body::UnitWithMultiplier::Cadence
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ONE_TIME =
+              T.let(
+                :one_time,
+                Orb::PriceCreateParams::Body::UnitWithMultiplier::Cadence::TaggedSymbol
+              )
+            MONTHLY =
+              T.let(
+                :monthly,
+                Orb::PriceCreateParams::Body::UnitWithMultiplier::Cadence::TaggedSymbol
+              )
+            QUARTERLY =
+              T.let(
+                :quarterly,
+                Orb::PriceCreateParams::Body::UnitWithMultiplier::Cadence::TaggedSymbol
+              )
+            SEMI_ANNUAL =
+              T.let(
+                :semi_annual,
+                Orb::PriceCreateParams::Body::UnitWithMultiplier::Cadence::TaggedSymbol
+              )
+            ANNUAL =
+              T.let(
+                :annual,
+                Orb::PriceCreateParams::Body::UnitWithMultiplier::Cadence::TaggedSymbol
+              )
+            CUSTOM =
+              T.let(
+                :custom,
+                Orb::PriceCreateParams::Body::UnitWithMultiplier::Cadence::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Orb::PriceCreateParams::Body::UnitWithMultiplier::Cadence::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          class UnitWithMultiplierConfig < Orb::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Orb::PriceCreateParams::Body::UnitWithMultiplier::UnitWithMultiplierConfig,
+                  Orb::Internal::AnyHash
+                )
+              end
+
+            # Sub-line label for list-price events that don't set display_name_key. Unlabeled
+            # events with another multiplier are labeled by their multiplier (e.g. '0.8×
+            # rate').
+            sig { returns(String) }
+            attr_accessor :default_display_name
+
+            # Event property holding the sub-line label for the event's rate (e.g.
+            # 'Off-peak').
+            sig { returns(String) }
+            attr_accessor :display_name_key
+
+            # Event property holding the multiplier applied to unit_amount (e.g. 0.8 for a 20%
+            # discount). Events without a number between 0 and 1000 with at most 12 decimal
+            # places are charged at unit_amount.
+            sig { returns(String) }
+            attr_accessor :multiplier_key
+
+            # List price per unit, before the event's multiplier is applied.
+            sig { returns(String) }
+            attr_accessor :unit_amount
+
+            # Configuration for unit_with_multiplier pricing
+            sig do
+              params(
+                default_display_name: String,
+                display_name_key: String,
+                multiplier_key: String,
+                unit_amount: String
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Sub-line label for list-price events that don't set display_name_key. Unlabeled
+              # events with another multiplier are labeled by their multiplier (e.g. '0.8×
+              # rate').
+              default_display_name:,
+              # Event property holding the sub-line label for the event's rate (e.g.
+              # 'Off-peak').
+              display_name_key:,
+              # Event property holding the multiplier applied to unit_amount (e.g. 0.8 for a 20%
+              # discount). Events without a number between 0 and 1000 with at most 12 decimal
+              # places are charged at unit_amount.
+              multiplier_key:,
+              # List price per unit, before the event's multiplier is applied.
+              unit_amount:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  default_display_name: String,
+                  display_name_key: String,
+                  multiplier_key: String,
+                  unit_amount: String
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+        end
+
         sig do
           override.returns(T::Array[Orb::PriceCreateParams::Body::Variants])
         end

data/rbi/orb/models/price_edited_webhook_event.rbi

@@ -91,7 +91,8 @@ module Orb
               Orb::Price::MeteredAllowance::OrHash,
               Orb::Price::MinimumComposite::OrHash,
               Orb::Price::Percent::OrHash,
-              Orb::Price::EventOutput::OrHash
+              Orb::Price::EventOutput::OrHash,
+              Orb::Price::UnitWithMultiplier::OrHash
             ),
           properties: Orb::PriceEditedWebhookEvent::Properties::OrHash,
           type: Orb::PriceEditedWebhookEvent::Type::OrSymbol