orb-billing 1.28.0 → 1.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e696c92aadec856a97cadfc85a5efaa55b51947b6d261e23afb9b038fc291203
-  data.tar.gz: b5fb963b9ab31969d11a701a07e188843e5f4f19560ddea000223f3bbd95f16f
+  metadata.gz: f5a6e4855b8279d4e1a6bdf28f4c400529e61861a120047763a6ffdaed8e5575
+  data.tar.gz: 36fe46e75224e82fb729f71d0d754736174092708fc02b1692600360eff66dc7
 SHA512:
-  metadata.gz: 22f4131bc53e513d7d4a9735bd04ef912b276aec5abe2fb8653ee4ff02f6ff471123a20d296bcb8c226bd6a4b1a623ff03eeb1678dfac39fc5b9edb751c1fcaa
-  data.tar.gz: 37ad33761702700de24810b0a5bb8b4df17cb21543bf8f9362405392dc2d28521fdfcc37f2dae1fe129df459301c3be044af577427d6d04322a3dfd936d3c243
+  metadata.gz: b6a5c380bac65e5c3636214e5dd68535b327a427ad3b24519af8de62f7426c95a321d492e8ba9940f5426da4df5ac39be566b756f91ba73ea3445aea90450708
+  data.tar.gz: a20cd6d63c5af3f339fbaaba7d3fd549b137a4218f7d6f5ccf9021a74c274ae8beaa6bf2f40f885f23e31267bf03c45cad819a0c329abd281d9de5832f65d5d1

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.29.0](https://github.com/orbcorp/orb-ruby/compare/v1.28.1...v1.29.0) (2026-09-03)
+
+
+### Features
+
+* **api:** support partial grouping key targeting in alert threshold overrides ([df6a1c5](https://github.com/orbcorp/orb-ruby/commit/df6a1c56eb5008b4659900048b555e6fff7dcd30))
+
+## [1.28.1](https://github.com/orbcorp/orb-ruby/compare/v1.28.0...v1.28.1) (2026-08-28)
+
+
+### Bug Fixes
+
+* **api:** require non-empty `country` in customer address input ([39ecbcc](https://github.com/orbcorp/orb-ruby/commit/39ecbcc5d8ca7f60e4aeced6c4cc744c7c4892aa))
+
 ## [1.28.0](https://github.com/orbcorp/orb-ruby/compare/v1.27.0...v1.28.0) (2026-08-25)
 
 

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "orb-billing", "~> 1.28.0"
+gem "orb-billing", "~> 1.29.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/orb/models/address_input.rb

@@ -3,15 +3,15 @@
 module Orb
   module Models
     class AddressInput < Orb::Internal::Type::BaseModel
-      # @!attribute city
+      # @!attribute country
       #
-      #   @return [String, nil]
-      optional :city, String, nil?: true
+      #   @return [String]
+      required :country, String
 
-      # @!attribute country
+      # @!attribute city
       #
       #   @return [String, nil]
-      optional :country, String, nil?: true
+      optional :city, String, nil?: true
 
       # @!attribute line1
       #
@@ -33,9 +33,9 @@ module Orb
       #   @return [String, nil]
       optional :state, String, nil?: true
 
-      # @!method initialize(city: nil, country: nil, line1: nil, line2: nil, postal_code: nil, state: nil)
+      # @!method initialize(country:, city: nil, line1: nil, line2: nil, postal_code: nil, state: nil)
+      #   @param country [String]
       #   @param city [String, nil]
-      #   @param country [String, nil]
       #   @param line1 [String, nil]
       #   @param line2 [String, nil]
       #   @param postal_code [String, nil]

data/lib/orb/models/alert.rb

@@ -308,8 +308,8 @@ module Orb
 
       class ThresholdOverride < Orb::Internal::Type::BaseModel
         # @!attribute group_values
-        #   The values of the grouping keys that identify this group. The list length
-        #   matches the alert's grouping_keys.
+        #   The values identifying this group, ordered to match group_keys when set and the
+        #   alert's grouping_keys otherwise.
         #
         #   @return [Array<String>]
         required :group_values, Orb::Internal::Type::ArrayOf[String]
@@ -320,7 +320,14 @@ module Orb
         #   @return [Array<Orb::Models::Threshold>]
         required :thresholds, -> { Orb::Internal::Type::ArrayOf[Orb::Threshold] }
 
-        # @!method initialize(group_values:, thresholds:)
+        # @!attribute group_keys
+        #   The subset of the alert's grouping_keys this override binds. Null when the
+        #   override targets one exact group across every grouping key.
+        #
+        #   @return [Array<String>, nil]
+        optional :group_keys, Orb::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!method initialize(group_values:, thresholds:, group_keys: nil)
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::Alert::ThresholdOverride} for more details.
         #
@@ -329,9 +336,11 @@ module Orb
         #   An empty `thresholds` list means the group is silenced (never fires). A
         #   non-empty list fully replaces the default thresholds for that group.
         #
-        #   @param group_values [Array<String>] The values of the grouping keys that identify this group. The list length matche
+        #   @param group_values [Array<String>] The values identifying this group, ordered to match group_keys when set and the
         #
         #   @param thresholds [Array<Orb::Models::Threshold>] The thresholds applied to this group. An empty list means the group is silenced.
+        #
+        #   @param group_keys [Array<String>, nil] The subset of the alert's grouping_keys this override binds. Null when the overr
       end
     end
   end

data/lib/orb/models/alert_create_for_subscription_params.rb

@@ -160,8 +160,8 @@ module Orb
       class ThresholdOverride < Orb::Internal::Type::BaseModel
         # @!attribute group_values
         #   The values of the grouping keys that identify this group. The list length must
-        #   match the alert's grouping_keys, and values appear in the same order as
-        #   grouping_keys.
+        #   match group_keys when it is set, and the alert's grouping_keys otherwise, with
+        #   values in the same order as whichever applies.
         #
         #   @return [Array<String>]
         required :group_values, Orb::Internal::Type::ArrayOf[String]
@@ -173,7 +173,16 @@ module Orb
         #   @return [Array<Orb::Models::Threshold>]
         required :thresholds, -> { Orb::Internal::Type::ArrayOf[Orb::Threshold] }
 
-        # @!method initialize(group_values:, thresholds:)
+        # @!attribute group_keys
+        #   The subset of the alert's grouping_keys that this override binds. Any grouping
+        #   key not named is unconstrained, so the override applies to every group matching
+        #   the named values. When omitted, group_values must cover every grouping key in
+        #   order.
+        #
+        #   @return [Array<String>, nil]
+        optional :group_keys, Orb::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!method initialize(group_values:, thresholds:, group_keys: nil)
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::AlertCreateForSubscriptionParams::ThresholdOverride} for more
         #   details.
@@ -186,6 +195,8 @@ module Orb
         #   @param group_values [Array<String>] The values of the grouping keys that identify this group. The list length must m
         #
         #   @param thresholds [Array<Orb::Models::Threshold>] The thresholds to apply to this group. An empty list silences alerts for this gr
+        #
+        #   @param group_keys [Array<String>, nil] The subset of the alert's grouping_keys that this override binds. Any grouping k
       end
     end
   end

data/lib/orb/models/alert_update_params.rb

@@ -112,8 +112,8 @@ module Orb
       class ThresholdOverride < Orb::Internal::Type::BaseModel
         # @!attribute group_values
         #   The values of the grouping keys that identify this group. The list length must
-        #   match the alert's grouping_keys, and values appear in the same order as
-        #   grouping_keys.
+        #   match group_keys when it is set, and the alert's grouping_keys otherwise, with
+        #   values in the same order as whichever applies.
         #
         #   @return [Array<String>]
         required :group_values, Orb::Internal::Type::ArrayOf[String]
@@ -125,7 +125,16 @@ module Orb
         #   @return [Array<Orb::Models::Threshold>]
         required :thresholds, -> { Orb::Internal::Type::ArrayOf[Orb::Threshold] }
 
-        # @!method initialize(group_values:, thresholds:)
+        # @!attribute group_keys
+        #   The subset of the alert's grouping_keys that this override binds. Any grouping
+        #   key not named is unconstrained, so the override applies to every group matching
+        #   the named values. When omitted, group_values must cover every grouping key in
+        #   order.
+        #
+        #   @return [Array<String>, nil]
+        optional :group_keys, Orb::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!method initialize(group_values:, thresholds:, group_keys: nil)
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::AlertUpdateParams::ThresholdOverride} for more details.
         #
@@ -137,6 +146,8 @@ module Orb
         #   @param group_values [Array<String>] The values of the grouping keys that identify this group. The list length must m
         #
         #   @param thresholds [Array<Orb::Models::Threshold>] The thresholds to apply to this group. An empty list silences alerts for this gr
+        #
+        #   @param group_keys [Array<String>, nil] The subset of the alert's grouping_keys that this override binds. Any grouping k
       end
     end
   end

data/lib/orb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Orb
-  VERSION = "1.28.0"
+  VERSION = "1.29.0"
 end

data/rbi/orb/models/address_input.rbi

@@ -5,11 +5,11 @@ module Orb
     class AddressInput < Orb::Internal::Type::BaseModel
       OrHash = T.type_alias { T.any(Orb::AddressInput, Orb::Internal::AnyHash) }
 
-      sig { returns(T.nilable(String)) }
-      attr_accessor :city
+      sig { returns(String) }
+      attr_accessor :country
 
       sig { returns(T.nilable(String)) }
-      attr_accessor :country
+      attr_accessor :city
 
       sig { returns(T.nilable(String)) }
       attr_accessor :line1
@@ -25,8 +25,8 @@ module Orb
 
       sig do
         params(
+          country: String,
           city: T.nilable(String),
-          country: T.nilable(String),
           line1: T.nilable(String),
           line2: T.nilable(String),
           postal_code: T.nilable(String),
@@ -34,8 +34,8 @@ module Orb
         ).returns(T.attached_class)
       end
       def self.new(
+        country:,
         city: nil,
-        country: nil,
         line1: nil,
         line2: nil,
         postal_code: nil,
@@ -46,8 +46,8 @@ module Orb
       sig do
         override.returns(
           {
+            country: String,
             city: T.nilable(String),
-            country: T.nilable(String),
             line1: T.nilable(String),
             line2: T.nilable(String),
             postal_code: T.nilable(String),

data/rbi/orb/models/alert.rbi

@@ -442,8 +442,8 @@ module Orb
             T.any(Orb::Alert::ThresholdOverride, Orb::Internal::AnyHash)
           end
 
-        # The values of the grouping keys that identify this group. The list length
-        # matches the alert's grouping_keys.
+        # 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
 
@@ -451,6 +451,11 @@ module Orb
         sig { returns(T::Array[Orb::Threshold]) }
         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
@@ -458,15 +463,19 @@ module Orb
         sig do
           params(
             group_values: T::Array[String],
-            thresholds: T::Array[Orb::Threshold::OrHash]
+            thresholds: T::Array[Orb::Threshold::OrHash],
+            group_keys: T.nilable(T::Array[String])
           ).returns(T.attached_class)
         end
         def self.new(
-          # The values of the grouping keys that identify this group. The list length
-          # matches the alert's grouping_keys.
+          # 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:
+          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
 
@@ -474,7 +483,8 @@ module Orb
           override.returns(
             {
               group_values: T::Array[String],
-              thresholds: T::Array[Orb::Threshold]
+              thresholds: T::Array[Orb::Threshold],
+              group_keys: T.nilable(T::Array[String])
             }
           )
         end

data/rbi/orb/models/alert_create_for_subscription_params.rbi

@@ -334,8 +334,8 @@ module Orb
           end
 
         # The values of the grouping keys that identify this group. The list length must
-        # match the alert's grouping_keys, and values appear in the same order as
-        # grouping_keys.
+        # match group_keys when it is set, and the alert's grouping_keys otherwise, with
+        # values in the same order as whichever applies.
         sig { returns(T::Array[String]) }
         attr_accessor :group_values
 
@@ -344,6 +344,13 @@ module Orb
         sig { returns(T::Array[Orb::Threshold]) }
         attr_accessor :thresholds
 
+        # The subset of the alert's grouping_keys that this override binds. Any grouping
+        # key not named is unconstrained, so the override applies to every group matching
+        # the named values. When omitted, group_values must cover every grouping key in
+        # order.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_accessor :group_keys
+
         # Per-group threshold override on a grouped cost alert.
         #
         # - An empty `thresholds` list silences alerts for this group (never fires).
@@ -351,17 +358,23 @@ module Orb
         sig do
           params(
             group_values: T::Array[String],
-            thresholds: T::Array[Orb::Threshold::OrHash]
+            thresholds: T::Array[Orb::Threshold::OrHash],
+            group_keys: T.nilable(T::Array[String])
           ).returns(T.attached_class)
         end
         def self.new(
           # The values of the grouping keys that identify this group. The list length must
-          # match the alert's grouping_keys, and values appear in the same order as
-          # grouping_keys.
+          # match group_keys when it is set, and the alert's grouping_keys otherwise, with
+          # values in the same order as whichever applies.
           group_values:,
           # The thresholds to apply to this group. An empty list silences alerts for this
           # group. A non-empty list fully replaces the default thresholds for this group.
-          thresholds:
+          thresholds:,
+          # The subset of the alert's grouping_keys that this override binds. Any grouping
+          # key not named is unconstrained, so the override applies to every group matching
+          # the named values. When omitted, group_values must cover every grouping key in
+          # order.
+          group_keys: nil
         )
         end
 
@@ -369,7 +382,8 @@ module Orb
           override.returns(
             {
               group_values: T::Array[String],
-              thresholds: T::Array[Orb::Threshold]
+              thresholds: T::Array[Orb::Threshold],
+              group_keys: T.nilable(T::Array[String])
             }
           )
         end

data/rbi/orb/models/alert_update_params.rbi

@@ -212,8 +212,8 @@ module Orb
           end
 
         # The values of the grouping keys that identify this group. The list length must
-        # match the alert's grouping_keys, and values appear in the same order as
-        # grouping_keys.
+        # match group_keys when it is set, and the alert's grouping_keys otherwise, with
+        # values in the same order as whichever applies.
         sig { returns(T::Array[String]) }
         attr_accessor :group_values
 
@@ -222,6 +222,13 @@ module Orb
         sig { returns(T::Array[Orb::Threshold]) }
         attr_accessor :thresholds
 
+        # The subset of the alert's grouping_keys that this override binds. Any grouping
+        # key not named is unconstrained, so the override applies to every group matching
+        # the named values. When omitted, group_values must cover every grouping key in
+        # order.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_accessor :group_keys
+
         # Per-group threshold override on a grouped cost alert.
         #
         # - An empty `thresholds` list silences alerts for this group (never fires).
@@ -229,17 +236,23 @@ module Orb
         sig do
           params(
             group_values: T::Array[String],
-            thresholds: T::Array[Orb::Threshold::OrHash]
+            thresholds: T::Array[Orb::Threshold::OrHash],
+            group_keys: T.nilable(T::Array[String])
           ).returns(T.attached_class)
         end
         def self.new(
           # The values of the grouping keys that identify this group. The list length must
-          # match the alert's grouping_keys, and values appear in the same order as
-          # grouping_keys.
+          # match group_keys when it is set, and the alert's grouping_keys otherwise, with
+          # values in the same order as whichever applies.
           group_values:,
           # The thresholds to apply to this group. An empty list silences alerts for this
           # group. A non-empty list fully replaces the default thresholds for this group.
-          thresholds:
+          thresholds:,
+          # The subset of the alert's grouping_keys that this override binds. Any grouping
+          # key not named is unconstrained, so the override applies to every group matching
+          # the named values. When omitted, group_values must cover every grouping key in
+          # order.
+          group_keys: nil
         )
         end
 
@@ -247,7 +260,8 @@ module Orb
           override.returns(
             {
               group_values: T::Array[String],
-              thresholds: T::Array[Orb::Threshold]
+              thresholds: T::Array[Orb::Threshold],
+              group_keys: T.nilable(T::Array[String])
             }
           )
         end

data/sig/orb/models/address_input.rbs

@@ -2,8 +2,8 @@ module Orb
   module Models
     type address_input =
       {
+        country: String,
         city: String?,
-        country: String?,
         :line1 => String?,
         :line2 => String?,
         postal_code: String?,
@@ -11,9 +11,9 @@ module Orb
       }
 
     class AddressInput < Orb::Internal::Type::BaseModel
-      attr_accessor city: String?
+      attr_accessor country: String
 
-      attr_accessor country: String?
+      attr_accessor city: String?
 
       attr_accessor line1: String?
 
@@ -24,8 +24,8 @@ module Orb
       attr_accessor state: String?
 
       def initialize: (
+        country: String,
         ?city: String?,
-        ?country: String?,
         ?line1: String?,
         ?line2: String?,
         ?postal_code: String?,
@@ -33,8 +33,8 @@ module Orb
       ) -> void
 
       def to_hash: -> {
+        country: String,
         city: String?,
-        country: String?,
         :line1 => String?,
         :line2 => String?,
         postal_code: String?,

data/sig/orb/models/alert.rbs

@@ -227,21 +227,29 @@ module Orb
       end
 
       type threshold_override =
-        { group_values: ::Array[String], thresholds: ::Array[Orb::Threshold] }
+        {
+          group_values: ::Array[String],
+          thresholds: ::Array[Orb::Threshold],
+          group_keys: ::Array[String]?
+        }
 
       class ThresholdOverride < Orb::Internal::Type::BaseModel
         attr_accessor group_values: ::Array[String]
 
         attr_accessor thresholds: ::Array[Orb::Threshold]
 
+        attr_accessor group_keys: ::Array[String]?
+
         def initialize: (
           group_values: ::Array[String],
-          thresholds: ::Array[Orb::Threshold]
+          thresholds: ::Array[Orb::Threshold],
+          ?group_keys: ::Array[String]?
         ) -> void
 
         def to_hash: -> {
           group_values: ::Array[String],
-          thresholds: ::Array[Orb::Threshold]
+          thresholds: ::Array[Orb::Threshold],
+          group_keys: ::Array[String]?
         }
       end
     end

data/sig/orb/models/alert_create_for_subscription_params.rbs

@@ -123,21 +123,29 @@ module Orb
       end
 
       type threshold_override =
-        { group_values: ::Array[String], thresholds: ::Array[Orb::Threshold] }
+        {
+          group_values: ::Array[String],
+          thresholds: ::Array[Orb::Threshold],
+          group_keys: ::Array[String]?
+        }
 
       class ThresholdOverride < Orb::Internal::Type::BaseModel
         attr_accessor group_values: ::Array[String]
 
         attr_accessor thresholds: ::Array[Orb::Threshold]
 
+        attr_accessor group_keys: ::Array[String]?
+
         def initialize: (
           group_values: ::Array[String],
-          thresholds: ::Array[Orb::Threshold]
+          thresholds: ::Array[Orb::Threshold],
+          ?group_keys: ::Array[String]?
         ) -> void
 
         def to_hash: -> {
           group_values: ::Array[String],
-          thresholds: ::Array[Orb::Threshold]
+          thresholds: ::Array[Orb::Threshold],
+          group_keys: ::Array[String]?
         }
       end
     end

data/sig/orb/models/alert_update_params.rbs

@@ -91,21 +91,29 @@ module Orb
       end
 
       type threshold_override =
-        { group_values: ::Array[String], thresholds: ::Array[Orb::Threshold] }
+        {
+          group_values: ::Array[String],
+          thresholds: ::Array[Orb::Threshold],
+          group_keys: ::Array[String]?
+        }
 
       class ThresholdOverride < Orb::Internal::Type::BaseModel
         attr_accessor group_values: ::Array[String]
 
         attr_accessor thresholds: ::Array[Orb::Threshold]
 
+        attr_accessor group_keys: ::Array[String]?
+
         def initialize: (
           group_values: ::Array[String],
-          thresholds: ::Array[Orb::Threshold]
+          thresholds: ::Array[Orb::Threshold],
+          ?group_keys: ::Array[String]?
         ) -> void
 
         def to_hash: -> {
           group_values: ::Array[String],
-          thresholds: ::Array[Orb::Threshold]
+          thresholds: ::Array[Orb::Threshold],
+          group_keys: ::Array[String]?
         }
       end
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: orb-billing
 version: !ruby/object:Gem::Version
-  version: 1.28.0
+  version: 1.29.0
 platform: ruby
 authors:
 - Orb
@@ -1407,7 +1407,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.19
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Ruby library to access the Orb API
 test_files: []