orb-billing 0.11.0 → 1.0.0

data/rbi/orb/models/new_percentage_discount.rbi

@@ -0,0 +1,193 @@
+# typed: strong
+
+module Orb
+  module Models
+    class NewPercentageDiscount < Orb::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Orb::NewPercentageDiscount, Orb::Internal::AnyHash)
+        end
+
+      sig { returns(Orb::NewPercentageDiscount::AdjustmentType::OrSymbol) }
+      attr_accessor :adjustment_type
+
+      sig { returns(Float) }
+      attr_accessor :percentage_discount
+
+      # If set, the adjustment will apply to every price on the subscription.
+      sig do
+        returns(T.nilable(Orb::NewPercentageDiscount::AppliesToAll::OrBoolean))
+      end
+      attr_accessor :applies_to_all
+
+      # The set of item IDs to which this adjustment applies.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :applies_to_item_ids
+
+      # The set of price IDs to which this adjustment applies.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :applies_to_price_ids
+
+      # If set, only prices in the specified currency will have the adjustment applied.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :currency
+
+      # A list of filters that determine which prices this adjustment will apply to.
+      sig { returns(T.nilable(T::Array[Orb::TransformPriceFilter])) }
+      attr_accessor :filters
+
+      # When false, this adjustment will be applied to a single price. Otherwise, it
+      # will be applied at the invoice level, possibly to multiple prices.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :is_invoice_level
+
+      sig { params(is_invoice_level: T::Boolean).void }
+      attr_writer :is_invoice_level
+
+      # If set, only prices of the specified type will have the adjustment applied.
+      sig do
+        returns(T.nilable(Orb::NewPercentageDiscount::PriceType::OrSymbol))
+      end
+      attr_accessor :price_type
+
+      sig do
+        params(
+          adjustment_type: Orb::NewPercentageDiscount::AdjustmentType::OrSymbol,
+          percentage_discount: Float,
+          applies_to_all:
+            T.nilable(Orb::NewPercentageDiscount::AppliesToAll::OrBoolean),
+          applies_to_item_ids: T.nilable(T::Array[String]),
+          applies_to_price_ids: T.nilable(T::Array[String]),
+          currency: T.nilable(String),
+          filters: T.nilable(T::Array[Orb::TransformPriceFilter::OrHash]),
+          is_invoice_level: T::Boolean,
+          price_type: T.nilable(Orb::NewPercentageDiscount::PriceType::OrSymbol)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        adjustment_type:,
+        percentage_discount:,
+        # If set, the adjustment will apply to every price on the subscription.
+        applies_to_all: nil,
+        # The set of item IDs to which this adjustment applies.
+        applies_to_item_ids: nil,
+        # The set of price IDs to which this adjustment applies.
+        applies_to_price_ids: nil,
+        # If set, only prices in the specified currency will have the adjustment applied.
+        currency: nil,
+        # A list of filters that determine which prices this adjustment will apply to.
+        filters: nil,
+        # When false, this adjustment will be applied to a single price. Otherwise, it
+        # will be applied at the invoice level, possibly to multiple prices.
+        is_invoice_level: nil,
+        # If set, only prices of the specified type will have the adjustment applied.
+        price_type: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            adjustment_type:
+              Orb::NewPercentageDiscount::AdjustmentType::OrSymbol,
+            percentage_discount: Float,
+            applies_to_all:
+              T.nilable(Orb::NewPercentageDiscount::AppliesToAll::OrBoolean),
+            applies_to_item_ids: T.nilable(T::Array[String]),
+            applies_to_price_ids: T.nilable(T::Array[String]),
+            currency: T.nilable(String),
+            filters: T.nilable(T::Array[Orb::TransformPriceFilter]),
+            is_invoice_level: T::Boolean,
+            price_type:
+              T.nilable(Orb::NewPercentageDiscount::PriceType::OrSymbol)
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module AdjustmentType
+        extend Orb::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Orb::NewPercentageDiscount::AdjustmentType)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        PERCENTAGE_DISCOUNT =
+          T.let(
+            :percentage_discount,
+            Orb::NewPercentageDiscount::AdjustmentType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Orb::NewPercentageDiscount::AdjustmentType::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # If set, the adjustment will apply to every price on the subscription.
+      module AppliesToAll
+        extend Orb::Internal::Type::Enum
+
+        TaggedBoolean =
+          T.type_alias do
+            T.all(T::Boolean, Orb::NewPercentageDiscount::AppliesToAll)
+          end
+        OrBoolean = T.type_alias { T::Boolean }
+
+        TRUE =
+          T.let(true, Orb::NewPercentageDiscount::AppliesToAll::TaggedBoolean)
+
+        sig do
+          override.returns(
+            T::Array[Orb::NewPercentageDiscount::AppliesToAll::TaggedBoolean]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # If set, only prices of the specified type will have the adjustment applied.
+      module PriceType
+        extend Orb::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Orb::NewPercentageDiscount::PriceType) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        USAGE =
+          T.let(:usage, Orb::NewPercentageDiscount::PriceType::TaggedSymbol)
+        FIXED_IN_ADVANCE =
+          T.let(
+            :fixed_in_advance,
+            Orb::NewPercentageDiscount::PriceType::TaggedSymbol
+          )
+        FIXED_IN_ARREARS =
+          T.let(
+            :fixed_in_arrears,
+            Orb::NewPercentageDiscount::PriceType::TaggedSymbol
+          )
+        FIXED =
+          T.let(:fixed, Orb::NewPercentageDiscount::PriceType::TaggedSymbol)
+        IN_ARREARS =
+          T.let(
+            :in_arrears,
+            Orb::NewPercentageDiscount::PriceType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Orb::NewPercentageDiscount::PriceType::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/orb/models/new_plan_bps_price.rbi

@@ -0,0 +1,294 @@
+# typed: strong
+
+module Orb
+  module Models
+    class NewPlanBPSPrice < Orb::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Orb::NewPlanBPSPrice, Orb::Internal::AnyHash) }
+
+      sig { returns(Orb::BPSConfig) }
+      attr_reader :bps_config
+
+      sig { params(bps_config: Orb::BPSConfig::OrHash).void }
+      attr_writer :bps_config
+
+      # The cadence to bill for this price on.
+      sig { returns(Orb::NewPlanBPSPrice::Cadence::OrSymbol) }
+      attr_accessor :cadence
+
+      # The id of the item the price will be associated with.
+      sig { returns(String) }
+      attr_accessor :item_id
+
+      sig { returns(Orb::NewPlanBPSPrice::ModelType::OrSymbol) }
+      attr_accessor :model_type
+
+      # The name of the price.
+      sig { returns(String) }
+      attr_accessor :name
+
+      # 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
+
+      # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+      # price is billed.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :currency
+
+      # 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
+
+      # 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(
+          bps_config: Orb::BPSConfig::OrHash,
+          cadence: Orb::NewPlanBPSPrice::Cadence::OrSymbol,
+          item_id: String,
+          model_type: Orb::NewPlanBPSPrice::ModelType::OrSymbol,
+          name: String,
+          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
+              )
+            ),
+          currency: T.nilable(String),
+          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),
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        bps_config:,
+        # The cadence to bill for this price on.
+        cadence:,
+        # The id of the item the price will be associated with.
+        item_id:,
+        model_type:,
+        # The name of the price.
+        name:,
+        # 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,
+        # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+        # price is billed.
+        currency: 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,
+        # 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
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            bps_config: Orb::BPSConfig,
+            cadence: Orb::NewPlanBPSPrice::Cadence::OrSymbol,
+            item_id: String,
+            model_type: Orb::NewPlanBPSPrice::ModelType::OrSymbol,
+            name: String,
+            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
+                )
+              ),
+            currency: T.nilable(String),
+            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),
+            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 { T.all(Symbol, Orb::NewPlanBPSPrice::Cadence) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ANNUAL = T.let(:annual, Orb::NewPlanBPSPrice::Cadence::TaggedSymbol)
+        SEMI_ANNUAL =
+          T.let(:semi_annual, Orb::NewPlanBPSPrice::Cadence::TaggedSymbol)
+        MONTHLY = T.let(:monthly, Orb::NewPlanBPSPrice::Cadence::TaggedSymbol)
+        QUARTERLY =
+          T.let(:quarterly, Orb::NewPlanBPSPrice::Cadence::TaggedSymbol)
+        ONE_TIME = T.let(:one_time, Orb::NewPlanBPSPrice::Cadence::TaggedSymbol)
+        CUSTOM = T.let(:custom, Orb::NewPlanBPSPrice::Cadence::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Orb::NewPlanBPSPrice::Cadence::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      module ModelType
+        extend Orb::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Orb::NewPlanBPSPrice::ModelType) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        BPS = T.let(:bps, Orb::NewPlanBPSPrice::ModelType::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Orb::NewPlanBPSPrice::ModelType::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # The configuration for the rate of the price currency to the invoicing currency.
+      module ConversionRateConfig
+        extend Orb::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              Orb::UnitConversionRateConfig,
+              Orb::TieredConversionRateConfig
+            )
+          end
+
+        sig do
+          override.returns(
+            T::Array[Orb::NewPlanBPSPrice::ConversionRateConfig::Variants]
+          )
+        end
+        def self.variants
+        end
+      end
+    end
+  end
+end