feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 139
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-87e16688d40cde735bc36efd40d8c12a7918919b18268d9c40b46d0cdf2f6251.yml
-openapi_spec_hash: 83f1f5a6fa7a07db4af09426232d0786
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-d6a851f21804170f796637f1911c3382f1c57f5ed6b9b77cd7d0c6f74c06e174.yml
+openapi_spec_hash: 82df33badf54d0c7087a61145d379f58
 config_hash: 3279841440b02d4e8303c961d6983492

orb-java-core/src/main/kotlin/com/withorb/api/models/Alert.kt

@@ -41,6 +41,7 @@ private constructor(
     private val thresholds: JsonField<List<Threshold>>,
     private val type: JsonField<Type>,
     private val balanceAlertStatus: JsonField<List<BalanceAlertStatus>>,
+    private val groupingKeys: JsonField<List<String>>,
     private val licenseType: JsonField<LicenseType>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
@@ -68,6 +69,9 @@ private constructor(
         @JsonProperty("balance_alert_status")
         @ExcludeMissing
         balanceAlertStatus: JsonField<List<BalanceAlertStatus>> = JsonMissing.of(),
+        @JsonProperty("grouping_keys")
+        @ExcludeMissing
+        groupingKeys: JsonField<List<String>> = JsonMissing.of(),
         @JsonProperty("license_type")
         @ExcludeMissing
         licenseType: JsonField<LicenseType> = JsonMissing.of(),
@@ -83,6 +87,7 @@ private constructor(
         thresholds,
         type,
         balanceAlertStatus,
+        groupingKeys,
         licenseType,
         mutableMapOf(),
     )
@@ -176,6 +181,15 @@ private constructor(
     fun balanceAlertStatus(): Optional<List<BalanceAlertStatus>> =
         balanceAlertStatus.getOptional("balance_alert_status")
 
+    /**
+     * The property keys to group cost alerts by. Only present for cost alerts with grouping
+     * enabled.
+     *
+     * @throws OrbInvalidDataException if the JSON field has an unexpected type (e.g. if the server
+     *   responded with an unexpected value).
+     */
+    fun groupingKeys(): Optional<List<String>> = groupingKeys.getOptional("grouping_keys")
+
     /**
      * Minified license type for alert serialization.
      *
@@ -272,6 +286,15 @@ private constructor(
     @ExcludeMissing
     fun _balanceAlertStatus(): JsonField<List<BalanceAlertStatus>> = balanceAlertStatus
 
+    /**
+     * Returns the raw JSON value of [groupingKeys].
+     *
+     * Unlike [groupingKeys], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("grouping_keys")
+    @ExcludeMissing
+    fun _groupingKeys(): JsonField<List<String>> = groupingKeys
+
     /**
      * Returns the raw JSON value of [licenseType].
      *
@@ -329,6 +352,7 @@ private constructor(
         private var thresholds: JsonField<MutableList<Threshold>>? = null
         private var type: JsonField<Type>? = null
         private var balanceAlertStatus: JsonField<MutableList<BalanceAlertStatus>>? = null
+        private var groupingKeys: JsonField<MutableList<String>>? = null
         private var licenseType: JsonField<LicenseType> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
@@ -345,6 +369,7 @@ private constructor(
             thresholds = alert.thresholds.map { it.toMutableList() }
             type = alert.type
             balanceAlertStatus = alert.balanceAlertStatus.map { it.toMutableList() }
+            groupingKeys = alert.groupingKeys.map { it.toMutableList() }
             licenseType = alert.licenseType
             additionalProperties = alert.additionalProperties.toMutableMap()
         }
@@ -534,6 +559,40 @@ private constructor(
                 }
         }
 
+        /**
+         * The property keys to group cost alerts by. Only present for cost alerts with grouping
+         * enabled.
+         */
+        fun groupingKeys(groupingKeys: List<String>?) =
+            groupingKeys(JsonField.ofNullable(groupingKeys))
+
+        /** Alias for calling [Builder.groupingKeys] with `groupingKeys.orElse(null)`. */
+        fun groupingKeys(groupingKeys: Optional<List<String>>) =
+            groupingKeys(groupingKeys.getOrNull())
+
+        /**
+         * Sets [Builder.groupingKeys] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.groupingKeys] with a well-typed `List<String>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun groupingKeys(groupingKeys: JsonField<List<String>>) = apply {
+            this.groupingKeys = groupingKeys.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [String] to [groupingKeys].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addGroupingKey(groupingKey: String) = apply {
+            groupingKeys =
+                (groupingKeys ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("groupingKeys", it).add(groupingKey)
+                }
+        }
+
         /** Minified license type for alert serialization. */
         fun licenseType(licenseType: LicenseType?) = licenseType(JsonField.ofNullable(licenseType))
 
@@ -604,6 +663,7 @@ private constructor(
                 checkRequired("thresholds", thresholds).map { it.toImmutable() },
                 checkRequired("type", type),
                 (balanceAlertStatus ?: JsonMissing.of()).map { it.toImmutable() },
+                (groupingKeys ?: JsonMissing.of()).map { it.toImmutable() },
                 licenseType,
                 additionalProperties.toMutableMap(),
             )
@@ -627,6 +687,7 @@ private constructor(
         thresholds().ifPresent { it.forEach { it.validate() } }
         type().validate()
         balanceAlertStatus().ifPresent { it.forEach { it.validate() } }
+        groupingKeys()
         licenseType().ifPresent { it.validate() }
         validated = true
     }
@@ -657,6 +718,7 @@ private constructor(
             (thresholds.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
             (type.asKnown().getOrNull()?.validity() ?: 0) +
             (balanceAlertStatus.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (groupingKeys.asKnown().getOrNull()?.size ?: 0) +
             (licenseType.asKnown().getOrNull()?.validity() ?: 0)
 
     /** The metric the alert applies to. */
@@ -1639,6 +1701,7 @@ private constructor(
             thresholds == other.thresholds &&
             type == other.type &&
             balanceAlertStatus == other.balanceAlertStatus &&
+            groupingKeys == other.groupingKeys &&
             licenseType == other.licenseType &&
             additionalProperties == other.additionalProperties
     }
@@ -1656,6 +1719,7 @@ private constructor(
             thresholds,
             type,
             balanceAlertStatus,
+            groupingKeys,
             licenseType,
             additionalProperties,
         )
@@ -1664,5 +1728,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "Alert{id=$id, createdAt=$createdAt, currency=$currency, customer=$customer, enabled=$enabled, metric=$metric, plan=$plan, subscription=$subscription, thresholds=$thresholds, type=$type, balanceAlertStatus=$balanceAlertStatus, licenseType=$licenseType, additionalProperties=$additionalProperties}"
+        "Alert{id=$id, createdAt=$createdAt, currency=$currency, customer=$customer, enabled=$enabled, metric=$metric, plan=$plan, subscription=$subscription, thresholds=$thresholds, type=$type, balanceAlertStatus=$balanceAlertStatus, groupingKeys=$groupingKeys, licenseType=$licenseType, additionalProperties=$additionalProperties}"
 }