orb-billing 1.44.0 → 1.46.0

data/rbi/orb/models/webhooks/subscription_grouped_cost_exceeded_standard_webhook_event.rbi

@@ -0,0 +1,1321 @@
+# typed: strong
+
+module Orb
+  module Models
+    module Webhooks
+      class SubscriptionGroupedCostExceededStandardWebhookEvent < Orb::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent,
+              Orb::Internal::AnyHash
+            )
+          end
+
+        # The ID of this webhook event.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The time at which this event was created, to the second.
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        # The serialization style this payload was rendered in, as configured on the
+        # endpoint.
+        sig do
+          returns(
+            Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::PayloadStyle::TaggedSymbol
+          )
+        end
+        attr_accessor :payload_style
+
+        # Every group that crossed a threshold for one alert, batched into a single
+        # message.
+        sig do
+          returns(
+            Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties
+          )
+        end
+        attr_reader :properties
+
+        sig do
+          params(
+            properties:
+              Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::OrHash
+          ).void
+        end
+        attr_writer :properties
+
+        # A lightweight subscription representation for webhook payloads.
+        #
+        # This avoids the expensive to_subscription_params() call required for full
+        # serialization.
+        sig do
+          returns(
+            Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription
+          )
+        end
+        attr_reader :subscription
+
+        sig do
+          params(
+            subscription:
+              Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::OrHash
+          ).void
+        end
+        attr_writer :subscription
+
+        # The event this payload describes.
+        sig do
+          returns(
+            Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Type::TaggedSymbol
+          )
+        end
+        attr_accessor :type
+
+        # Issued when grouped subscription costs exceed a pre-configured amount threshold.
+        sig do
+          params(
+            id: String,
+            created_at: Time,
+            payload_style:
+              Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::PayloadStyle::OrSymbol,
+            properties:
+              Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::OrHash,
+            subscription:
+              Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::OrHash,
+            type:
+              Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Type::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The ID of this webhook event.
+          id:,
+          # The time at which this event was created, to the second.
+          created_at:,
+          # The serialization style this payload was rendered in, as configured on the
+          # endpoint.
+          payload_style:,
+          # Every group that crossed a threshold for one alert, batched into a single
+          # message.
+          properties:,
+          # A lightweight subscription representation for webhook payloads.
+          #
+          # This avoids the expensive to_subscription_params() call required for full
+          # serialization.
+          subscription:,
+          # The event this payload describes.
+          type:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Time,
+              payload_style:
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::PayloadStyle::TaggedSymbol,
+              properties:
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties,
+              subscription:
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription,
+              type:
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Type::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # The serialization style this payload was rendered in, as configured on the
+        # endpoint.
+        module PayloadStyle
+          extend Orb::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::PayloadStyle
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          EXPANDED =
+            T.let(
+              :expanded,
+              Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::PayloadStyle::TaggedSymbol
+            )
+          STANDARD =
+            T.let(
+              :standard,
+              Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::PayloadStyle::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::PayloadStyle::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        class Properties < Orb::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties,
+                Orb::Internal::AnyHash
+              )
+            end
+
+          # [Alerts within Orb](/product-catalog/configuring-alerts) monitor spending,
+          # usage, or credit balance and trigger webhooks when a threshold is exceeded.
+          #
+          # Alerts created through the API can be scoped to either customers or
+          # subscriptions.
+          sig do
+            returns(
+              Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration
+            )
+          end
+          attr_reader :alert_configuration
+
+          sig do
+            params(
+              alert_configuration:
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::OrHash
+            ).void
+          end
+          attr_writer :alert_configuration
+
+          sig { returns(T::Array[String]) }
+          attr_accessor :grouping_keys
+
+          sig do
+            returns(
+              T::Array[
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::Group
+              ]
+            )
+          end
+          attr_accessor :groups
+
+          sig { returns(Time) }
+          attr_accessor :timeframe_end
+
+          sig { returns(Time) }
+          attr_accessor :timeframe_start
+
+          # Every group that crossed a threshold for one alert, batched into a single
+          # message.
+          sig do
+            params(
+              alert_configuration:
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::OrHash,
+              grouping_keys: T::Array[String],
+              groups:
+                T::Array[
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::Group::OrHash
+                ],
+              timeframe_end: Time,
+              timeframe_start: Time
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # [Alerts within Orb](/product-catalog/configuring-alerts) monitor spending,
+            # usage, or credit balance and trigger webhooks when a threshold is exceeded.
+            #
+            # Alerts created through the API can be scoped to either customers or
+            # subscriptions.
+            alert_configuration:,
+            grouping_keys:,
+            groups:,
+            timeframe_end:,
+            timeframe_start:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                alert_configuration:
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration,
+                grouping_keys: T::Array[String],
+                groups:
+                  T::Array[
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::Group
+                  ],
+                timeframe_end: Time,
+                timeframe_start: Time
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class AlertConfiguration < Orb::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration,
+                  Orb::Internal::AnyHash
+                )
+              end
+
+            # Also referred to as alert_id in this documentation.
+            sig { returns(String) }
+            attr_accessor :id
+
+            # The creation time of the resource in Orb.
+            sig { returns(Time) }
+            attr_accessor :created_at
+
+            # The name of the currency the credit balance or invoice cost is denominated in.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :currency
+
+            # The customer the alert applies to.
+            sig { returns(T.nilable(Orb::CustomerMinified)) }
+            attr_reader :customer
+
+            sig do
+              params(customer: T.nilable(Orb::CustomerMinified::OrHash)).void
+            end
+            attr_writer :customer
+
+            # Whether the alert is enabled or disabled.
+            sig { returns(T::Boolean) }
+            attr_accessor :enabled
+
+            # The metric the alert applies to.
+            sig do
+              returns(
+                T.nilable(
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Metric
+                )
+              )
+            end
+            attr_reader :metric
+
+            sig do
+              params(
+                metric:
+                  T.nilable(
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Metric::OrHash
+                  )
+              ).void
+            end
+            attr_writer :metric
+
+            # The plan the alert applies to.
+            sig do
+              returns(
+                T.nilable(
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Plan
+                )
+              )
+            end
+            attr_reader :plan
+
+            sig do
+              params(
+                plan:
+                  T.nilable(
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Plan::OrHash
+                  )
+              ).void
+            end
+            attr_writer :plan
+
+            # The subscription the alert applies to.
+            sig { returns(T.nilable(Orb::SubscriptionMinified)) }
+            attr_reader :subscription
+
+            sig do
+              params(
+                subscription: T.nilable(Orb::SubscriptionMinified::OrHash)
+              ).void
+            end
+            attr_writer :subscription
+
+            # The thresholds that define the conditions under which the alert will be
+            # triggered.
+            sig do
+              returns(
+                T.nilable(
+                  T::Array[
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Threshold
+                  ]
+                )
+              )
+            end
+            attr_accessor :thresholds
+
+            # The type of alert. This must be a valid alert type.
+            sig do
+              returns(
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Type::TaggedSymbol
+              )
+            end
+            attr_accessor :type
+
+            # The current status of the alert. This field is only present for credit balance
+            # alerts.
+            sig do
+              returns(
+                T.nilable(
+                  T::Array[
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::BalanceAlertStatus
+                  ]
+                )
+              )
+            end
+            attr_accessor :balance_alert_status
+
+            # The property keys to group cost alerts by. Only present for cost alerts with
+            # grouping enabled.
+            sig { returns(T.nilable(T::Array[String])) }
+            attr_accessor :grouping_keys
+
+            # Minified license type for alert serialization.
+            sig do
+              returns(
+                T.nilable(
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::LicenseType
+                )
+              )
+            end
+            attr_reader :license_type
+
+            sig do
+              params(
+                license_type:
+                  T.nilable(
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::LicenseType::OrHash
+                  )
+              ).void
+            end
+            attr_writer :license_type
+
+            # Filters scoping which prices are included in spend and grouped cost alert
+            # evaluation. Alerts use the price_id, item_id, and price_type fields only; the
+            # alert's pricing unit is reported by currency.
+            sig do
+              returns(
+                T.nilable(
+                  T::Array[
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter
+                  ]
+                )
+              )
+            end
+            attr_accessor :price_filters
+
+            # Per-group threshold overrides. Each override maps a specific combination of
+            # grouping_keys values to a replacement threshold list. Only present for grouped
+            # cost alerts that have at least one override.
+            sig do
+              returns(
+                T.nilable(
+                  T::Array[
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::ThresholdOverride
+                  ]
+                )
+              )
+            end
+            attr_accessor :threshold_overrides
+
+            # [Alerts within Orb](/product-catalog/configuring-alerts) monitor spending,
+            # usage, or credit balance and trigger webhooks when a threshold is exceeded.
+            #
+            # Alerts created through the API can be scoped to either customers or
+            # subscriptions.
+            sig do
+              params(
+                id: String,
+                created_at: Time,
+                currency: T.nilable(String),
+                customer: T.nilable(Orb::CustomerMinified::OrHash),
+                enabled: T::Boolean,
+                metric:
+                  T.nilable(
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Metric::OrHash
+                  ),
+                plan:
+                  T.nilable(
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Plan::OrHash
+                  ),
+                subscription: T.nilable(Orb::SubscriptionMinified::OrHash),
+                thresholds:
+                  T.nilable(
+                    T::Array[
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Threshold::OrHash
+                    ]
+                  ),
+                type:
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Type::OrSymbol,
+                balance_alert_status:
+                  T.nilable(
+                    T::Array[
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::BalanceAlertStatus::OrHash
+                    ]
+                  ),
+                grouping_keys: T.nilable(T::Array[String]),
+                license_type:
+                  T.nilable(
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::LicenseType::OrHash
+                  ),
+                price_filters:
+                  T.nilable(
+                    T::Array[
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::OrHash
+                    ]
+                  ),
+                threshold_overrides:
+                  T.nilable(
+                    T::Array[
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::ThresholdOverride::OrHash
+                    ]
+                  )
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Also referred to as alert_id in this documentation.
+              id:,
+              # The creation time of the resource in Orb.
+              created_at:,
+              # The name of the currency the credit balance or invoice cost is denominated in.
+              currency:,
+              # The customer the alert applies to.
+              customer:,
+              # Whether the alert is enabled or disabled.
+              enabled:,
+              # The metric the alert applies to.
+              metric:,
+              # The plan the alert applies to.
+              plan:,
+              # The subscription the alert applies to.
+              subscription:,
+              # The thresholds that define the conditions under which the alert will be
+              # triggered.
+              thresholds:,
+              # The type of alert. This must be a valid alert type.
+              type:,
+              # The current status of the alert. This field is only present for credit balance
+              # alerts.
+              balance_alert_status: nil,
+              # The property keys to group cost alerts by. Only present for cost alerts with
+              # grouping enabled.
+              grouping_keys: nil,
+              # Minified license type for alert serialization.
+              license_type: nil,
+              # Filters scoping which prices are included in spend and grouped cost alert
+              # evaluation. Alerts use the price_id, item_id, and price_type fields only; the
+              # alert's pricing unit is reported by currency.
+              price_filters: nil,
+              # Per-group threshold overrides. Each override maps a specific combination of
+              # grouping_keys values to a replacement threshold list. Only present for grouped
+              # cost alerts that have at least one override.
+              threshold_overrides: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  id: String,
+                  created_at: Time,
+                  currency: T.nilable(String),
+                  customer: T.nilable(Orb::CustomerMinified),
+                  enabled: T::Boolean,
+                  metric:
+                    T.nilable(
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Metric
+                    ),
+                  plan:
+                    T.nilable(
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Plan
+                    ),
+                  subscription: T.nilable(Orb::SubscriptionMinified),
+                  thresholds:
+                    T.nilable(
+                      T::Array[
+                        Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Threshold
+                      ]
+                    ),
+                  type:
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Type::TaggedSymbol,
+                  balance_alert_status:
+                    T.nilable(
+                      T::Array[
+                        Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::BalanceAlertStatus
+                      ]
+                    ),
+                  grouping_keys: T.nilable(T::Array[String]),
+                  license_type:
+                    T.nilable(
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::LicenseType
+                    ),
+                  price_filters:
+                    T.nilable(
+                      T::Array[
+                        Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter
+                      ]
+                    ),
+                  threshold_overrides:
+                    T.nilable(
+                      T::Array[
+                        Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::ThresholdOverride
+                      ]
+                    )
+                }
+              )
+            end
+            def to_hash
+            end
+
+            class Metric < Orb::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Metric,
+                    Orb::Internal::AnyHash
+                  )
+                end
+
+              sig { returns(String) }
+              attr_accessor :id
+
+              # The metric the alert applies to.
+              sig { params(id: String).returns(T.attached_class) }
+              def self.new(id:)
+              end
+
+              sig { override.returns({ id: String }) }
+              def to_hash
+              end
+            end
+
+            class Plan < Orb::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Plan,
+                    Orb::Internal::AnyHash
+                  )
+                end
+
+              sig { returns(T.nilable(String)) }
+              attr_accessor :id
+
+              # An optional user-defined ID for this plan resource, used throughout the system
+              # as an alias for this Plan. Use this field to identify a plan by an existing
+              # identifier in your system.
+              sig { returns(T.nilable(String)) }
+              attr_accessor :external_plan_id
+
+              sig { returns(T.nilable(String)) }
+              attr_accessor :name
+
+              sig { returns(String) }
+              attr_accessor :plan_version
+
+              # The plan the alert applies to.
+              sig do
+                params(
+                  id: T.nilable(String),
+                  external_plan_id: T.nilable(String),
+                  name: T.nilable(String),
+                  plan_version: String
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                id:,
+                # An optional user-defined ID for this plan resource, used throughout the system
+                # as an alias for this Plan. Use this field to identify a plan by an existing
+                # identifier in your system.
+                external_plan_id:,
+                name:,
+                plan_version:
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    id: T.nilable(String),
+                    external_plan_id: T.nilable(String),
+                    name: T.nilable(String),
+                    plan_version: String
+                  }
+                )
+              end
+              def to_hash
+              end
+            end
+
+            class Threshold < Orb::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Threshold,
+                    Orb::Internal::AnyHash
+                  )
+                end
+
+              # The value at which an alert will fire. For credit balance alerts, the alert will
+              # fire at or below this value. For usage and cost alerts, the alert will fire at
+              # or above this value.
+              sig { returns(String) }
+              attr_accessor :value
+
+              # Thresholds are used to define the conditions under which an alert will be
+              # triggered.
+              sig { params(value: String).returns(T.attached_class) }
+              def self.new(
+                # The value at which an alert will fire. For credit balance alerts, the alert will
+                # fire at or below this value. For usage and cost alerts, the alert will fire at
+                # or above this value.
+                value:
+              )
+              end
+
+              sig { override.returns({ value: String }) }
+              def to_hash
+              end
+            end
+
+            # The type of alert. This must be a valid alert type.
+            module Type
+              extend Orb::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Type
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              CREDIT_BALANCE_DEPLETED =
+                T.let(
+                  :credit_balance_depleted,
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Type::TaggedSymbol
+                )
+              CREDIT_BALANCE_DROPPED =
+                T.let(
+                  :credit_balance_dropped,
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Type::TaggedSymbol
+                )
+              CREDIT_BALANCE_RECOVERED =
+                T.let(
+                  :credit_balance_recovered,
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Type::TaggedSymbol
+                )
+              USAGE_EXCEEDED =
+                T.let(
+                  :usage_exceeded,
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Type::TaggedSymbol
+                )
+              COST_EXCEEDED =
+                T.let(
+                  :cost_exceeded,
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Type::TaggedSymbol
+                )
+              SPEND_EXCEEDED =
+                T.let(
+                  :spend_exceeded,
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Type::TaggedSymbol
+                )
+              LICENSE_BALANCE_THRESHOLD_REACHED =
+                T.let(
+                  :license_balance_threshold_reached,
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Type::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::Type::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+
+            class BalanceAlertStatus < Orb::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::BalanceAlertStatus,
+                    Orb::Internal::AnyHash
+                  )
+                end
+
+              # Whether the alert is currently in-alert or not.
+              sig { returns(T::Boolean) }
+              attr_accessor :in_alert
+
+              # The value of the threshold that defines the alert status.
+              sig { returns(String) }
+              attr_accessor :threshold_value
+
+              # Alert status is used to determine if an alert is currently in-alert or not.
+              sig do
+                params(in_alert: T::Boolean, threshold_value: String).returns(
+                  T.attached_class
+                )
+              end
+              def self.new(
+                # Whether the alert is currently in-alert or not.
+                in_alert:,
+                # The value of the threshold that defines the alert status.
+                threshold_value:
+              )
+              end
+
+              sig do
+                override.returns(
+                  { in_alert: T::Boolean, threshold_value: String }
+                )
+              end
+              def to_hash
+              end
+            end
+
+            class LicenseType < Orb::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::LicenseType,
+                    Orb::Internal::AnyHash
+                  )
+                end
+
+              sig { returns(String) }
+              attr_accessor :id
+
+              # Minified license type for alert serialization.
+              sig { params(id: String).returns(T.attached_class) }
+              def self.new(id:)
+              end
+
+              sig { override.returns({ id: String }) }
+              def to_hash
+              end
+            end
+
+            class PriceFilter < Orb::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter,
+                    Orb::Internal::AnyHash
+                  )
+                end
+
+              # The property of the price to filter on.
+              sig do
+                returns(
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Field::TaggedSymbol
+                )
+              end
+              attr_accessor :field
+
+              # Should prices that match the filter be included or excluded.
+              sig do
+                returns(
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Operator::TaggedSymbol
+                )
+              end
+              attr_accessor :operator
+
+              # The IDs or values that match this filter.
+              sig { returns(T::Array[String]) }
+              attr_accessor :values
+
+              sig do
+                params(
+                  field:
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Field::OrSymbol,
+                  operator:
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Operator::OrSymbol,
+                  values: T::Array[String]
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # The property of the price to filter on.
+                field:,
+                # Should prices that match the filter be included or excluded.
+                operator:,
+                # The IDs or values that match this filter.
+                values:
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    field:
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Field::TaggedSymbol,
+                    operator:
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Operator::TaggedSymbol,
+                    values: T::Array[String]
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              # The property of the price to filter on.
+              module Field
+                extend Orb::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Field
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                PRICE_ID =
+                  T.let(
+                    :price_id,
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Field::TaggedSymbol
+                  )
+                ITEM_ID =
+                  T.let(
+                    :item_id,
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Field::TaggedSymbol
+                  )
+                PRICE_TYPE =
+                  T.let(
+                    :price_type,
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Field::TaggedSymbol
+                  )
+                CURRENCY =
+                  T.let(
+                    :currency,
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Field::TaggedSymbol
+                  )
+                PRICING_UNIT_ID =
+                  T.let(
+                    :pricing_unit_id,
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Field::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Field::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
+
+              # Should prices that match the filter be included or excluded.
+              module Operator
+                extend Orb::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Operator
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                INCLUDES =
+                  T.let(
+                    :includes,
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Operator::TaggedSymbol
+                  )
+                EXCLUDES =
+                  T.let(
+                    :excludes,
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Operator::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::PriceFilter::Operator::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
+            end
+
+            class ThresholdOverride < Orb::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::ThresholdOverride,
+                    Orb::Internal::AnyHash
+                  )
+                end
+
+              # The values identifying this group, ordered to match group_keys when set and the
+              # alert's grouping_keys otherwise.
+              sig { returns(T::Array[String]) }
+              attr_accessor :group_values
+
+              # The thresholds applied to this group. An empty list means the group is silenced.
+              sig do
+                returns(
+                  T::Array[
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::ThresholdOverride::Threshold
+                  ]
+                )
+              end
+              attr_accessor :thresholds
+
+              # The subset of the alert's grouping_keys this override binds. Null when the
+              # override targets one exact group across every grouping key.
+              sig { returns(T.nilable(T::Array[String])) }
+              attr_accessor :group_keys
+
+              # A per-group threshold override on a grouped cost alert.
+              #
+              # An empty `thresholds` list means the group is silenced (never fires). A
+              # non-empty list fully replaces the default thresholds for that group.
+              sig do
+                params(
+                  group_values: T::Array[String],
+                  thresholds:
+                    T::Array[
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::ThresholdOverride::Threshold::OrHash
+                    ],
+                  group_keys: T.nilable(T::Array[String])
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # The values identifying this group, ordered to match group_keys when set and the
+                # alert's grouping_keys otherwise.
+                group_values:,
+                # The thresholds applied to this group. An empty list means the group is silenced.
+                thresholds:,
+                # The subset of the alert's grouping_keys this override binds. Null when the
+                # override targets one exact group across every grouping key.
+                group_keys: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    group_values: T::Array[String],
+                    thresholds:
+                      T::Array[
+                        Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::ThresholdOverride::Threshold
+                      ],
+                    group_keys: T.nilable(T::Array[String])
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              class Threshold < Orb::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::AlertConfiguration::ThresholdOverride::Threshold,
+                      Orb::Internal::AnyHash
+                    )
+                  end
+
+                # The value at which an alert will fire. For credit balance alerts, the alert will
+                # fire at or below this value. For usage and cost alerts, the alert will fire at
+                # or above this value.
+                sig { returns(String) }
+                attr_accessor :value
+
+                # Thresholds are used to define the conditions under which an alert will be
+                # triggered.
+                sig { params(value: String).returns(T.attached_class) }
+                def self.new(
+                  # The value at which an alert will fire. For credit balance alerts, the alert will
+                  # fire at or below this value. For usage and cost alerts, the alert will fire at
+                  # or above this value.
+                  value:
+                )
+                end
+
+                sig { override.returns({ value: String }) }
+                def to_hash
+                end
+              end
+            end
+          end
+
+          class Group < Orb::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Properties::Group,
+                  Orb::Internal::AnyHash
+                )
+              end
+
+            sig { returns(T.nilable(String)) }
+            attr_accessor :amount_threshold
+
+            sig { returns(T.nilable(String)) }
+            attr_accessor :evaluated_amount
+
+            sig { returns(T::Array[String]) }
+            attr_accessor :group_values
+
+            sig do
+              params(
+                amount_threshold: T.nilable(String),
+                evaluated_amount: T.nilable(String),
+                group_values: T::Array[String]
+              ).returns(T.attached_class)
+            end
+            def self.new(amount_threshold:, evaluated_amount:, group_values:)
+            end
+
+            sig do
+              override.returns(
+                {
+                  amount_threshold: T.nilable(String),
+                  evaluated_amount: T.nilable(String),
+                  group_values: T::Array[String]
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+        end
+
+        class Subscription < Orb::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription,
+                Orb::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :id
+
+          sig { returns(Orb::CustomerMinified) }
+          attr_reader :customer
+
+          sig { params(customer: Orb::CustomerMinified::OrHash).void }
+          attr_writer :customer
+
+          sig { returns(T.nilable(Time)) }
+          attr_accessor :end_date
+
+          sig do
+            returns(
+              T.nilable(
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::Plan
+              )
+            )
+          end
+          attr_reader :plan
+
+          sig do
+            params(
+              plan:
+                T.nilable(
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::Plan::OrHash
+                )
+            ).void
+          end
+          attr_writer :plan
+
+          sig { returns(Time) }
+          attr_accessor :start_date
+
+          sig do
+            returns(
+              Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::Status::TaggedSymbol
+            )
+          end
+          attr_accessor :status
+
+          # A lightweight subscription representation for webhook payloads.
+          #
+          # This avoids the expensive to_subscription_params() call required for full
+          # serialization.
+          sig do
+            params(
+              id: String,
+              customer: Orb::CustomerMinified::OrHash,
+              end_date: T.nilable(Time),
+              plan:
+                T.nilable(
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::Plan::OrHash
+                ),
+              start_date: Time,
+              status:
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::Status::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(id:, customer:, end_date:, plan:, start_date:, status:)
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                customer: Orb::CustomerMinified,
+                end_date: T.nilable(Time),
+                plan:
+                  T.nilable(
+                    Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::Plan
+                  ),
+                start_date: Time,
+                status:
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::Status::TaggedSymbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Plan < Orb::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::Plan,
+                  Orb::Internal::AnyHash
+                )
+              end
+
+            sig { returns(T.nilable(String)) }
+            attr_accessor :id
+
+            # An optional user-defined ID for this plan resource, used throughout the system
+            # as an alias for this Plan. Use this field to identify a plan by an existing
+            # identifier in your system.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :external_plan_id
+
+            sig { returns(T.nilable(String)) }
+            attr_accessor :name
+
+            sig do
+              params(
+                id: T.nilable(String),
+                external_plan_id: T.nilable(String),
+                name: T.nilable(String)
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              id:,
+              # An optional user-defined ID for this plan resource, used throughout the system
+              # as an alias for this Plan. Use this field to identify a plan by an existing
+              # identifier in your system.
+              external_plan_id:,
+              name:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  id: T.nilable(String),
+                  external_plan_id: T.nilable(String),
+                  name: T.nilable(String)
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+
+          module Status
+            extend Orb::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ACTIVE =
+              T.let(
+                :active,
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::Status::TaggedSymbol
+              )
+            ENDED =
+              T.let(
+                :ended,
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::Status::TaggedSymbol
+              )
+            UPCOMING =
+              T.let(
+                :upcoming,
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Subscription::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
+        # The event this payload describes.
+        module Type
+          extend Orb::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Type
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          SUBSCRIPTION_GROUPED_COST_EXCEEDED =
+            T.let(
+              :"subscription.grouped_cost_exceeded",
+              Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Type::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Orb::Webhooks::SubscriptionGroupedCostExceededStandardWebhookEvent::Type::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end