orb-billing 0.2.0 → 0.3.1

data/rbi/{lib/orb → orb}/models/subscription_change_retrieve_response.rbi

@@ -47,8 +47,17 @@ module Orb
         )
           .returns(T.attached_class)
       end
-      def self.new(id:, expiration_time:, status:, subscription:, applied_at: nil, cancelled_at: nil); end
-
+      def self.new(
+        id:,
+        # Subscription change will be cancelled at this time and can no longer be applied.
+        expiration_time:,
+        status:,
+        subscription:,
+        # When this change was applied.
+        applied_at: nil,
+        # When this change was cancelled.
+        cancelled_at: nil
+      ); end
       sig do
         override
           .returns(
@@ -68,8 +77,7 @@ module Orb
         extend Orb::Internal::Type::Enum
 
         TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::SubscriptionChangeRetrieveResponse::Status) }
-        OrSymbol =
-          T.type_alias { T.any(Symbol, String, Orb::Models::SubscriptionChangeRetrieveResponse::Status::TaggedSymbol) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         PENDING = T.let(:pending, Orb::Models::SubscriptionChangeRetrieveResponse::Status::TaggedSymbol)
         APPLIED = T.let(:applied, Orb::Models::SubscriptionChangeRetrieveResponse::Status::TaggedSymbol)
@@ -169,9 +177,9 @@ module Orb
           returns(
             T::Array[
               T.any(
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::AmountDiscountInterval,
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::PercentageDiscountInterval,
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::UsageDiscountInterval
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::Amount,
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::Percentage,
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::Usage
               )
             ]
           )
@@ -321,10 +329,10 @@ module Orb
             default_invoice_memo: T.nilable(String),
             discount_intervals: T::Array[
               T.any(
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::AmountDiscountInterval,
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::Amount,
                 Orb::Internal::AnyHash,
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::PercentageDiscountInterval,
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::UsageDiscountInterval
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::Percentage,
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::Usage
               )
             ],
             end_date: T.nilable(Time),
@@ -382,31 +390,90 @@ module Orb
         end
         def self.new(
           id:,
+          # The current plan phase that is active, only if the subscription's plan has
+          # phases.
           active_plan_phase_order:,
+          # The adjustment intervals for this subscription sorted by the start_date of the
+          # adjustment interval.
           adjustment_intervals:,
+          # Determines whether issued invoices for this subscription will automatically be
+          # charged with the saved payment method on the due date. This property defaults to
+          # the plan's behavior. If null, defaults to the customer's setting.
           auto_collection:,
           billing_cycle_anchor_configuration:,
+          # The day of the month on which the billing cycle is anchored. If the maximum
+          # number of days in a month is greater than this value, the last day of the month
+          # is the billing cycle day (e.g. billing_cycle_day=31 for April means the billing
+          # period begins on the 30th.
           billing_cycle_day:,
           created_at:,
+          # The end of the current billing period. This is an exclusive timestamp, such that
+          # the instant returned is not part of the billing period. Set to null for
+          # subscriptions that are not currently active.
           current_billing_period_end_date:,
+          # The start date of the current billing period. This is an inclusive timestamp;
+          # the instant returned is exactly the beginning of the billing period. Set to null
+          # if the subscription is not currently active.
           current_billing_period_start_date:,
+          # A customer is a buyer of your products, and the other party to the billing
+          # relationship.
+          #
+          # In Orb, customers are assigned system generated identifiers automatically, but
+          # it's often desirable to have these match existing identifiers in your system. To
+          # avoid having to denormalize Orb ID information, you can pass in an
+          # `external_customer_id` with your own identifier. See
+          # [Customer ID Aliases](/events-and-metrics/customer-aliases) for further
+          # information about how these aliases work in Orb.
+          #
+          # In addition to having an identifier in your system, a customer may exist in a
+          # payment provider solution like Stripe. Use the `payment_provider_id` and the
+          # `payment_provider` enum field to express this mapping.
+          #
+          # A customer also has a timezone (from the standard
+          # [IANA timezone database](https://www.iana.org/time-zones)), which defaults to
+          # your account's timezone. See [Timezone localization](/essentials/timezones) for
+          # information on what this timezone parameter influences within Orb.
           customer:,
+          # Determines the default memo on this subscriptions' invoices. Note that if this
+          # is not provided, it is determined by the plan configuration.
           default_invoice_memo:,
+          # The discount intervals for this subscription sorted by the start_date.
           discount_intervals:,
+          # The date Orb stops billing for this subscription.
           end_date:,
           fixed_fee_quantity_schedule:,
           invoicing_threshold:,
+          # The maximum intervals for this subscription sorted by the start_date.
           maximum_intervals:,
+          # User specified key-value pairs for the resource. If not present, this defaults
+          # to an empty dictionary. 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:,
+          # The minimum intervals for this subscription sorted by the start_date.
           minimum_intervals:,
+          # Determines the difference between the invoice issue date for subscription
+          # invoices as the date that they are due. A value of `0` here represents that the
+          # invoice is due on issue, whereas a value of `30` represents that the customer
+          # has a month to pay the invoice.
           net_terms:,
+          # A pending subscription change if one exists on this subscription.
           pending_subscription_change:,
+          # The [Plan](/core-concepts#plan-and-price) resource represents a plan that can be
+          # subscribed to by a customer. Plans define the billing behavior of the
+          # subscription. You can see more about how to configure prices in the
+          # [Price resource](/reference/price).
           plan:,
+          # The price intervals for this subscription.
           price_intervals:,
           redeemed_coupon:,
+          # The date Orb starts billing for this subscription.
           start_date:,
           status:,
           trial_info:,
+          # The resources that were changed as part of this operation. Only present when
+          # fetched through the subscription changes API or if the
+          # `include_changed_resources` parameter was passed in the request.
           changed_resources: nil
         ); end
         sig do
@@ -426,9 +493,9 @@ module Orb
                 default_invoice_memo: T.nilable(String),
                 discount_intervals: T::Array[
                   T.any(
-                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::AmountDiscountInterval,
-                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::PercentageDiscountInterval,
-                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::UsageDiscountInterval
+                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::Amount,
+                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::Percentage,
+                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::Usage
                   )
                 ],
                 end_date: T.nilable(Time),
@@ -458,11 +525,11 @@ module Orb
           sig do
             returns(
               T.any(
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseUsageDiscountAdjustment,
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseAmountDiscountAdjustment,
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhasePercentageDiscountAdjustment,
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseMinimumAdjustment,
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseMaximumAdjustment
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::UsageDiscount,
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::AmountDiscount,
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PercentageDiscount,
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::Minimum,
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::Maximum
               )
             )
           end
@@ -484,12 +551,12 @@ module Orb
             params(
               id: String,
               adjustment: T.any(
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseUsageDiscountAdjustment,
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::UsageDiscount,
                 Orb::Internal::AnyHash,
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseAmountDiscountAdjustment,
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhasePercentageDiscountAdjustment,
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseMinimumAdjustment,
-                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseMaximumAdjustment
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::AmountDiscount,
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PercentageDiscount,
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::Minimum,
+                Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::Maximum
               ),
               applies_to_price_interval_ids: T::Array[String],
               end_date: T.nilable(Time),
@@ -497,19 +564,27 @@ module Orb
             )
               .returns(T.attached_class)
           end
-          def self.new(id:, adjustment:, applies_to_price_interval_ids:, end_date:, start_date:); end
-
+          def self.new(
+            id:,
+            adjustment:,
+            # The price interval IDs that this adjustment applies to.
+            applies_to_price_interval_ids:,
+            # The end date of the adjustment interval.
+            end_date:,
+            # The start date of the adjustment interval.
+            start_date:
+          ); end
           sig do
             override
               .returns(
                 {
                   id: String,
                   adjustment: T.any(
-                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseUsageDiscountAdjustment,
-                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseAmountDiscountAdjustment,
-                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhasePercentageDiscountAdjustment,
-                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseMinimumAdjustment,
-                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseMaximumAdjustment
+                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::UsageDiscount,
+                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::AmountDiscount,
+                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PercentageDiscount,
+                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::Minimum,
+                    Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::Maximum
                   ),
                   applies_to_price_interval_ids: T::Array[String],
                   end_date: T.nilable(Time),
@@ -522,7 +597,7 @@ module Orb
           module Adjustment
             extend Orb::Internal::Type::Union
 
-            class PlanPhaseUsageDiscountAdjustment < Orb::Internal::Type::BaseModel
+            class UsageDiscount < Orb::Internal::Type::BaseModel
               sig { returns(String) }
               attr_accessor :id
 
@@ -565,10 +640,17 @@ module Orb
               end
               def self.new(
                 id:,
+                # The price IDs that this adjustment applies to.
                 applies_to_price_ids:,
+                # True for adjustments that apply to an entire invocice, false for adjustments
+                # that apply to only one price.
                 is_invoice_level:,
+                # The plan phase in which this adjustment is active.
                 plan_phase_order:,
+                # The reason for the adjustment.
                 reason:,
+                # The number of usage units by which to discount the price this adjustment applies
+                # to in a given billing period.
                 usage_discount:,
                 adjustment_type: :usage_discount
               ); end
@@ -589,7 +671,7 @@ module Orb
               def to_hash; end
             end
 
-            class PlanPhaseAmountDiscountAdjustment < Orb::Internal::Type::BaseModel
+            class AmountDiscount < Orb::Internal::Type::BaseModel
               sig { returns(String) }
               attr_accessor :id
 
@@ -632,10 +714,17 @@ module Orb
               end
               def self.new(
                 id:,
+                # The amount by which to discount the prices this adjustment applies to in a given
+                # billing period.
                 amount_discount:,
+                # The price IDs that this adjustment applies to.
                 applies_to_price_ids:,
+                # True for adjustments that apply to an entire invocice, false for adjustments
+                # that apply to only one price.
                 is_invoice_level:,
+                # The plan phase in which this adjustment is active.
                 plan_phase_order:,
+                # The reason for the adjustment.
                 reason:,
                 adjustment_type: :amount_discount
               ); end
@@ -656,7 +745,7 @@ module Orb
               def to_hash; end
             end
 
-            class PlanPhasePercentageDiscountAdjustment < Orb::Internal::Type::BaseModel
+            class PercentageDiscount < Orb::Internal::Type::BaseModel
               sig { returns(String) }
               attr_accessor :id
 
@@ -699,10 +788,17 @@ module Orb
               end
               def self.new(
                 id:,
+                # The price IDs that this adjustment applies to.
                 applies_to_price_ids:,
+                # True for adjustments that apply to an entire invocice, false for adjustments
+                # that apply to only one price.
                 is_invoice_level:,
+                # The percentage (as a value between 0 and 1) by which to discount the price
+                # intervals this adjustment applies to in a given billing period.
                 percentage_discount:,
+                # The plan phase in which this adjustment is active.
                 plan_phase_order:,
+                # The reason for the adjustment.
                 reason:,
                 adjustment_type: :percentage_discount
               ); end
@@ -723,7 +819,7 @@ module Orb
               def to_hash; end
             end
 
-            class PlanPhaseMinimumAdjustment < Orb::Internal::Type::BaseModel
+            class Minimum < Orb::Internal::Type::BaseModel
               sig { returns(String) }
               attr_accessor :id
 
@@ -771,11 +867,19 @@ module Orb
               end
               def self.new(
                 id:,
+                # The price IDs that this adjustment applies to.
                 applies_to_price_ids:,
+                # True for adjustments that apply to an entire invocice, false for adjustments
+                # that apply to only one price.
                 is_invoice_level:,
+                # The item ID that revenue from this minimum will be attributed to.
                 item_id:,
+                # The minimum amount to charge in a given billing period for the prices this
+                # adjustment applies to.
                 minimum_amount:,
+                # The plan phase in which this adjustment is active.
                 plan_phase_order:,
+                # The reason for the adjustment.
                 reason:,
                 adjustment_type: :minimum
               ); end
@@ -797,7 +901,7 @@ module Orb
               def to_hash; end
             end
 
-            class PlanPhaseMaximumAdjustment < Orb::Internal::Type::BaseModel
+            class Maximum < Orb::Internal::Type::BaseModel
               sig { returns(String) }
               attr_accessor :id
 
@@ -840,10 +944,17 @@ module Orb
               end
               def self.new(
                 id:,
+                # The price IDs that this adjustment applies to.
                 applies_to_price_ids:,
+                # True for adjustments that apply to an entire invocice, false for adjustments
+                # that apply to only one price.
                 is_invoice_level:,
+                # The maximum amount to charge in a given billing period for the prices this
+                # adjustment applies to.
                 maximum_amount:,
+                # The plan phase in which this adjustment is active.
                 plan_phase_order:,
+                # The reason for the adjustment.
                 reason:,
                 adjustment_type: :maximum
               ); end
@@ -867,7 +978,7 @@ module Orb
             sig do
               override
                 .returns(
-                  [Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseUsageDiscountAdjustment, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseAmountDiscountAdjustment, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhasePercentageDiscountAdjustment, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseMinimumAdjustment, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PlanPhaseMaximumAdjustment]
+                  [Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::UsageDiscount, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::AmountDiscount, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::PercentageDiscount, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::Minimum, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::AdjustmentInterval::Adjustment::Maximum]
                 )
             end
             def self.variants; end
@@ -900,8 +1011,20 @@ module Orb
               year: T.nilable(Integer)
             ).returns(T.attached_class)
           end
-          def self.new(day:, month: nil, year: nil); end
-
+          def self.new(
+            # The day of the month on which the billing cycle is anchored. If the maximum
+            # number of days in a month is greater than this value, the last day of the month
+            # is the billing cycle day (e.g. billing_cycle_day=31 for April means the billing
+            # period begins on the 30th.
+            day:,
+            # The month on which the billing cycle is anchored (e.g. a quarterly price
+            # anchored in February would have cycles starting February, May, August, and
+            # November).
+            month: nil,
+            # The year on which the billing cycle is anchored (e.g. a 2 year billing cycle
+            # anchored on 2021 would have cycles starting on 2021, 2023, 2025, etc.).
+            year: nil
+          ); end
           sig { override.returns({day: Integer, month: T.nilable(Integer), year: T.nilable(Integer)}) }
           def to_hash; end
         end
@@ -909,7 +1032,7 @@ module Orb
         module DiscountInterval
           extend Orb::Internal::Type::Union
 
-          class AmountDiscountInterval < Orb::Internal::Type::BaseModel
+          class Amount < Orb::Internal::Type::BaseModel
             # Only available if discount_type is `amount`.
             sig { returns(String) }
             attr_accessor :amount_discount
@@ -945,10 +1068,15 @@ module Orb
                 .returns(T.attached_class)
             end
             def self.new(
+              # Only available if discount_type is `amount`.
               amount_discount:,
+              # The price ids that this discount interval applies to.
               applies_to_price_ids:,
+              # The price interval ids that this discount interval applies to.
               applies_to_price_interval_ids:,
+              # The end date of the discount interval.
               end_date:,
+              # The start date of the discount interval.
               start_date:,
               discount_type: :amount
             ); end
@@ -968,7 +1096,7 @@ module Orb
             def to_hash; end
           end
 
-          class PercentageDiscountInterval < Orb::Internal::Type::BaseModel
+          class Percentage < Orb::Internal::Type::BaseModel
             # The price ids that this discount interval applies to.
             sig { returns(T::Array[String]) }
             attr_accessor :applies_to_price_ids
@@ -1005,10 +1133,16 @@ module Orb
                 .returns(T.attached_class)
             end
             def self.new(
+              # The price ids that this discount interval applies to.
               applies_to_price_ids:,
+              # The price interval ids that this discount interval applies to.
               applies_to_price_interval_ids:,
+              # The end date of the discount interval.
               end_date:,
+              # Only available if discount_type is `percentage`.This is a number between 0
+              # and 1.
               percentage_discount:,
+              # The start date of the discount interval.
               start_date:,
               discount_type: :percentage
             ); end
@@ -1028,7 +1162,7 @@ module Orb
             def to_hash; end
           end
 
-          class UsageDiscountInterval < Orb::Internal::Type::BaseModel
+          class Usage < Orb::Internal::Type::BaseModel
             # The price ids that this discount interval applies to.
             sig { returns(T::Array[String]) }
             attr_accessor :applies_to_price_ids
@@ -1065,10 +1199,16 @@ module Orb
                 .returns(T.attached_class)
             end
             def self.new(
+              # The price ids that this discount interval applies to.
               applies_to_price_ids:,
+              # The price interval ids that this discount interval applies to.
               applies_to_price_interval_ids:,
+              # The end date of the discount interval.
               end_date:,
+              # The start date of the discount interval.
               start_date:,
+              # Only available if discount_type is `usage`. Number of usage units that this
+              # discount is for
               usage_discount:,
               discount_type: :usage
             ); end
@@ -1091,7 +1231,7 @@ module Orb
           sig do
             override
               .returns(
-                [Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::AmountDiscountInterval, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::PercentageDiscountInterval, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::UsageDiscountInterval]
+                [Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::Amount, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::Percentage, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::DiscountInterval::Usage]
               )
           end
           def self.variants; end
@@ -1155,14 +1295,18 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The price ids that this maximum interval applies to.
             applies_to_price_ids:,
+            # The price interval ids that this maximum interval applies to.
             applies_to_price_interval_ids:,
+            # The end date of the maximum interval.
             end_date:,
+            # The maximum amount to charge in a given billing period for the price intervals
+            # this transform applies to.
             maximum_amount:,
+            # The start date of the maximum interval.
             start_date:
-          )
-          end
-
+          ); end
           sig do
             override
               .returns(
@@ -1211,14 +1355,18 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The price ids that this minimum interval applies to.
             applies_to_price_ids:,
+            # The price interval ids that this minimum interval applies to.
             applies_to_price_interval_ids:,
+            # The end date of the minimum interval.
             end_date:,
+            # The minimum amount to charge in a given billing period for the price intervals
+            # this minimum applies to.
             minimum_amount:,
+            # The start date of the minimum interval.
             start_date:
-          )
-          end
-
+          ); end
           sig do
             override
               .returns(
@@ -1299,34 +1447,34 @@ module Orb
           sig do
             returns(
               T.any(
-                Orb::Models::Price::UnitPrice,
-                Orb::Models::Price::PackagePrice,
-                Orb::Models::Price::MatrixPrice,
-                Orb::Models::Price::TieredPrice,
-                Orb::Models::Price::TieredBpsPrice,
-                Orb::Models::Price::BpsPrice,
-                Orb::Models::Price::BulkBpsPrice,
-                Orb::Models::Price::BulkPrice,
-                Orb::Models::Price::ThresholdTotalAmountPrice,
-                Orb::Models::Price::TieredPackagePrice,
-                Orb::Models::Price::GroupedTieredPrice,
-                Orb::Models::Price::TieredWithMinimumPrice,
-                Orb::Models::Price::TieredPackageWithMinimumPrice,
-                Orb::Models::Price::PackageWithAllocationPrice,
-                Orb::Models::Price::UnitWithPercentPrice,
-                Orb::Models::Price::MatrixWithAllocationPrice,
-                Orb::Models::Price::TieredWithProrationPrice,
-                Orb::Models::Price::UnitWithProrationPrice,
-                Orb::Models::Price::GroupedAllocationPrice,
-                Orb::Models::Price::GroupedWithProratedMinimumPrice,
-                Orb::Models::Price::GroupedWithMeteredMinimumPrice,
-                Orb::Models::Price::MatrixWithDisplayNamePrice,
-                Orb::Models::Price::BulkWithProrationPrice,
-                Orb::Models::Price::GroupedTieredPackagePrice,
-                Orb::Models::Price::MaxGroupTieredPackagePrice,
-                Orb::Models::Price::ScalableMatrixWithUnitPricingPrice,
-                Orb::Models::Price::ScalableMatrixWithTieredPricingPrice,
-                Orb::Models::Price::CumulativeGroupedBulkPrice
+                Orb::Models::Price::Unit,
+                Orb::Models::Price::Package,
+                Orb::Models::Price::Matrix,
+                Orb::Models::Price::Tiered,
+                Orb::Models::Price::TieredBps,
+                Orb::Models::Price::Bps,
+                Orb::Models::Price::BulkBps,
+                Orb::Models::Price::Bulk,
+                Orb::Models::Price::ThresholdTotalAmount,
+                Orb::Models::Price::TieredPackage,
+                Orb::Models::Price::GroupedTiered,
+                Orb::Models::Price::TieredWithMinimum,
+                Orb::Models::Price::TieredPackageWithMinimum,
+                Orb::Models::Price::PackageWithAllocation,
+                Orb::Models::Price::UnitWithPercent,
+                Orb::Models::Price::MatrixWithAllocation,
+                Orb::Models::Price::TieredWithProration,
+                Orb::Models::Price::UnitWithProration,
+                Orb::Models::Price::GroupedAllocation,
+                Orb::Models::Price::GroupedWithProratedMinimum,
+                Orb::Models::Price::GroupedWithMeteredMinimum,
+                Orb::Models::Price::MatrixWithDisplayName,
+                Orb::Models::Price::BulkWithProration,
+                Orb::Models::Price::GroupedTieredPackage,
+                Orb::Models::Price::MaxGroupTieredPackage,
+                Orb::Models::Price::ScalableMatrixWithUnitPricing,
+                Orb::Models::Price::ScalableMatrixWithTieredPricing,
+                Orb::Models::Price::CumulativeGroupedBulk
               )
             )
           end
@@ -1362,35 +1510,35 @@ module Orb
                 ]
               ),
               price: T.any(
-                Orb::Models::Price::UnitPrice,
+                Orb::Models::Price::Unit,
                 Orb::Internal::AnyHash,
-                Orb::Models::Price::PackagePrice,
-                Orb::Models::Price::MatrixPrice,
-                Orb::Models::Price::TieredPrice,
-                Orb::Models::Price::TieredBpsPrice,
-                Orb::Models::Price::BpsPrice,
-                Orb::Models::Price::BulkBpsPrice,
-                Orb::Models::Price::BulkPrice,
-                Orb::Models::Price::ThresholdTotalAmountPrice,
-                Orb::Models::Price::TieredPackagePrice,
-                Orb::Models::Price::GroupedTieredPrice,
-                Orb::Models::Price::TieredWithMinimumPrice,
-                Orb::Models::Price::TieredPackageWithMinimumPrice,
-                Orb::Models::Price::PackageWithAllocationPrice,
-                Orb::Models::Price::UnitWithPercentPrice,
-                Orb::Models::Price::MatrixWithAllocationPrice,
-                Orb::Models::Price::TieredWithProrationPrice,
-                Orb::Models::Price::UnitWithProrationPrice,
-                Orb::Models::Price::GroupedAllocationPrice,
-                Orb::Models::Price::GroupedWithProratedMinimumPrice,
-                Orb::Models::Price::GroupedWithMeteredMinimumPrice,
-                Orb::Models::Price::MatrixWithDisplayNamePrice,
-                Orb::Models::Price::BulkWithProrationPrice,
-                Orb::Models::Price::GroupedTieredPackagePrice,
-                Orb::Models::Price::MaxGroupTieredPackagePrice,
-                Orb::Models::Price::ScalableMatrixWithUnitPricingPrice,
-                Orb::Models::Price::ScalableMatrixWithTieredPricingPrice,
-                Orb::Models::Price::CumulativeGroupedBulkPrice
+                Orb::Models::Price::Package,
+                Orb::Models::Price::Matrix,
+                Orb::Models::Price::Tiered,
+                Orb::Models::Price::TieredBps,
+                Orb::Models::Price::Bps,
+                Orb::Models::Price::BulkBps,
+                Orb::Models::Price::Bulk,
+                Orb::Models::Price::ThresholdTotalAmount,
+                Orb::Models::Price::TieredPackage,
+                Orb::Models::Price::GroupedTiered,
+                Orb::Models::Price::TieredWithMinimum,
+                Orb::Models::Price::TieredPackageWithMinimum,
+                Orb::Models::Price::PackageWithAllocation,
+                Orb::Models::Price::UnitWithPercent,
+                Orb::Models::Price::MatrixWithAllocation,
+                Orb::Models::Price::TieredWithProration,
+                Orb::Models::Price::UnitWithProration,
+                Orb::Models::Price::GroupedAllocation,
+                Orb::Models::Price::GroupedWithProratedMinimum,
+                Orb::Models::Price::GroupedWithMeteredMinimum,
+                Orb::Models::Price::MatrixWithDisplayName,
+                Orb::Models::Price::BulkWithProration,
+                Orb::Models::Price::GroupedTieredPackage,
+                Orb::Models::Price::MaxGroupTieredPackage,
+                Orb::Models::Price::ScalableMatrixWithUnitPricing,
+                Orb::Models::Price::ScalableMatrixWithTieredPricing,
+                Orb::Models::Price::CumulativeGroupedBulk
               ),
               start_date: Time,
               usage_customer_ids: T.nilable(T::Array[String])
@@ -1399,14 +1547,40 @@ module Orb
           end
           def self.new(
             id:,
+            # The day of the month that Orb bills for this price
             billing_cycle_day:,
+            # The end of the current billing period. This is an exclusive timestamp, such that
+            # the instant returned is exactly the end of the billing period. Set to null if
+            # this price interval is not currently active.
             current_billing_period_end_date:,
+            # The start date of the current billing period. This is an inclusive timestamp;
+            # the instant returned is exactly the beginning of the billing period. Set to null
+            # if this price interval is not currently active.
             current_billing_period_start_date:,
+            # The end date of the price interval. This is the date that Orb stops billing for
+            # this price.
             end_date:,
+            # An additional filter to apply to usage queries.
             filter:,
+            # The fixed fee quantity transitions for this price interval. This is only
+            # relevant for fixed fees.
             fixed_fee_quantity_transitions:,
+            # The Price resource represents a price that can be billed on a subscription,
+            # resulting in a charge on an invoice in the form of an invoice line item. Prices
+            # take a quantity and determine an amount to bill.
+            #
+            # Orb supports a few different pricing models out of the box. Each of these models
+            # is serialized differently in a given Price object. The model_type field
+            # determines the key for the configuration object that is present.
+            #
+            # For more on the types of prices, see
+            # [the core concepts documentation](/core-concepts#plan-and-price)
             price:,
+            # The start date of the price interval. This is the date that Orb starts billing
+            # for this price.
             start_date:,
+            # A list of customer IDs whose usage events will be aggregated and billed under
+            # this price interval.
             usage_customer_ids:
           ); end
           sig do
@@ -1423,34 +1597,34 @@ module Orb
                     T::Array[Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::PriceInterval::FixedFeeQuantityTransition]
                   ),
                   price: T.any(
-                    Orb::Models::Price::UnitPrice,
-                    Orb::Models::Price::PackagePrice,
-                    Orb::Models::Price::MatrixPrice,
-                    Orb::Models::Price::TieredPrice,
-                    Orb::Models::Price::TieredBpsPrice,
-                    Orb::Models::Price::BpsPrice,
-                    Orb::Models::Price::BulkBpsPrice,
-                    Orb::Models::Price::BulkPrice,
-                    Orb::Models::Price::ThresholdTotalAmountPrice,
-                    Orb::Models::Price::TieredPackagePrice,
-                    Orb::Models::Price::GroupedTieredPrice,
-                    Orb::Models::Price::TieredWithMinimumPrice,
-                    Orb::Models::Price::TieredPackageWithMinimumPrice,
-                    Orb::Models::Price::PackageWithAllocationPrice,
-                    Orb::Models::Price::UnitWithPercentPrice,
-                    Orb::Models::Price::MatrixWithAllocationPrice,
-                    Orb::Models::Price::TieredWithProrationPrice,
-                    Orb::Models::Price::UnitWithProrationPrice,
-                    Orb::Models::Price::GroupedAllocationPrice,
-                    Orb::Models::Price::GroupedWithProratedMinimumPrice,
-                    Orb::Models::Price::GroupedWithMeteredMinimumPrice,
-                    Orb::Models::Price::MatrixWithDisplayNamePrice,
-                    Orb::Models::Price::BulkWithProrationPrice,
-                    Orb::Models::Price::GroupedTieredPackagePrice,
-                    Orb::Models::Price::MaxGroupTieredPackagePrice,
-                    Orb::Models::Price::ScalableMatrixWithUnitPricingPrice,
-                    Orb::Models::Price::ScalableMatrixWithTieredPricingPrice,
-                    Orb::Models::Price::CumulativeGroupedBulkPrice
+                    Orb::Models::Price::Unit,
+                    Orb::Models::Price::Package,
+                    Orb::Models::Price::Matrix,
+                    Orb::Models::Price::Tiered,
+                    Orb::Models::Price::TieredBps,
+                    Orb::Models::Price::Bps,
+                    Orb::Models::Price::BulkBps,
+                    Orb::Models::Price::Bulk,
+                    Orb::Models::Price::ThresholdTotalAmount,
+                    Orb::Models::Price::TieredPackage,
+                    Orb::Models::Price::GroupedTiered,
+                    Orb::Models::Price::TieredWithMinimum,
+                    Orb::Models::Price::TieredPackageWithMinimum,
+                    Orb::Models::Price::PackageWithAllocation,
+                    Orb::Models::Price::UnitWithPercent,
+                    Orb::Models::Price::MatrixWithAllocation,
+                    Orb::Models::Price::TieredWithProration,
+                    Orb::Models::Price::UnitWithProration,
+                    Orb::Models::Price::GroupedAllocation,
+                    Orb::Models::Price::GroupedWithProratedMinimum,
+                    Orb::Models::Price::GroupedWithMeteredMinimum,
+                    Orb::Models::Price::MatrixWithDisplayName,
+                    Orb::Models::Price::BulkWithProration,
+                    Orb::Models::Price::GroupedTieredPackage,
+                    Orb::Models::Price::MaxGroupTieredPackage,
+                    Orb::Models::Price::ScalableMatrixWithUnitPricing,
+                    Orb::Models::Price::ScalableMatrixWithTieredPricing,
+                    Orb::Models::Price::CumulativeGroupedBulk
                   ),
                   start_date: Time,
                   usage_customer_ids: T.nilable(T::Array[String])
@@ -1503,8 +1677,7 @@ module Orb
 
           TaggedSymbol =
             T.type_alias { T.all(Symbol, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::Status) }
-          OrSymbol =
-            T.type_alias { T.any(Symbol, String, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::Status::TaggedSymbol) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
           ACTIVE =
             T.let(:active, Orb::Models::SubscriptionChangeRetrieveResponse::Subscription::Status::TaggedSymbol)
@@ -1560,8 +1733,16 @@ module Orb
             )
               .returns(T.attached_class)
           end
-          def self.new(created_credit_notes:, created_invoices:, voided_credit_notes:, voided_invoices:); end
-
+          def self.new(
+            # The credit notes that were created as part of this operation.
+            created_credit_notes:,
+            # The invoices that were created as part of this operation.
+            created_invoices:,
+            # The credit notes that were voided as part of this operation.
+            voided_credit_notes:,
+            # The invoices that were voided as part of this operation.
+            voided_invoices:
+          ); end
           sig do
             override
               .returns(