orbcorp · stainless-app · Dec 12, 2024 · Dec 12, 2024
diff --git a/.stats.yml b/.stats.yml
@@ -1,2 +1,2 @@
 configured_endpoints: 97
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-16e9b5c2b884f624e9b1f3dddf584353822295512ead0b72ffb574e6b1780570.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-908960f165205e2874dd29322cc974df5ab10c7634ab9a342ab22047013de1b4.yml
diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/models/AlertDisableParams.kt b/orb-java-core/src/main/kotlin/com/withorb/api/models/AlertDisableParams.kt
@@ -13,13 +13,16 @@ import java.util.Optional
 class AlertDisableParams
 constructor(
     private val alertConfigurationId: String,
+    private val subscriptionId: String?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
     private val additionalBodyProperties: Map<String, JsonValue>,
 ) {
 
     fun alertConfigurationId(): String = alertConfigurationId
 
+    fun subscriptionId(): Optional<String> = Optional.ofNullable(subscriptionId)
+
     fun _additionalHeaders(): Headers = additionalHeaders
 
     fun _additionalQueryParams(): QueryParams = additionalQueryParams
@@ -33,7 +36,13 @@ constructor(
 
     @JvmSynthetic internal fun getHeaders(): Headers = additionalHeaders
 
-    @JvmSynthetic internal fun getQueryParams(): QueryParams = additionalQueryParams
+    @JvmSynthetic
+    internal fun getQueryParams(): QueryParams {
+        val queryParams = QueryParams.builder()
+        this.subscriptionId?.let { queryParams.put("subscription_id", listOf(it.toString())) }
+        queryParams.putAll(additionalQueryParams)
+        return queryParams.build()
+    }
 
     fun getPathParam(index: Int): String {
         return when (index) {
@@ -53,13 +62,15 @@ constructor(
     class Builder {
 
         private var alertConfigurationId: String? = null
+        private var subscriptionId: String? = null
         private var additionalHeaders: Headers.Builder = Headers.builder()
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
         private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
         internal fun from(alertDisableParams: AlertDisableParams) = apply {
             alertConfigurationId = alertDisableParams.alertConfigurationId
+            subscriptionId = alertDisableParams.subscriptionId
             additionalHeaders = alertDisableParams.additionalHeaders.toBuilder()
             additionalQueryParams = alertDisableParams.additionalQueryParams.toBuilder()
             additionalBodyProperties = alertDisableParams.additionalBodyProperties.toMutableMap()
@@ -69,6 +80,9 @@ constructor(
             this.alertConfigurationId = alertConfigurationId
         }
 
+        /** Used to update the status of a plan alert scoped to this subscription_id */
+        fun subscriptionId(subscriptionId: String) = apply { this.subscriptionId = subscriptionId }
+
         fun additionalHeaders(additionalHeaders: Headers) = apply {
             this.additionalHeaders.clear()
             putAllAdditionalHeaders(additionalHeaders)
@@ -194,6 +208,7 @@ constructor(
                 checkNotNull(alertConfigurationId) {
                     "`alertConfigurationId` is required but was not set"
                 },
+                subscriptionId,
                 additionalHeaders.build(),
                 additionalQueryParams.build(),
                 additionalBodyProperties.toImmutable(),
@@ -205,11 +220,11 @@ constructor(
             return true
         }
 
-        return /* spotless:off */ other is AlertDisableParams && alertConfigurationId == other.alertConfigurationId && additionalHeaders == other.additionalHeaders && additionalQueryParams == other.additionalQueryParams && additionalBodyProperties == other.additionalBodyProperties /* spotless:on */
+        return /* spotless:off */ other is AlertDisableParams && alertConfigurationId == other.alertConfigurationId && subscriptionId == other.subscriptionId && additionalHeaders == other.additionalHeaders && additionalQueryParams == other.additionalQueryParams && additionalBodyProperties == other.additionalBodyProperties /* spotless:on */
     }
 
-    override fun hashCode(): Int = /* spotless:off */ Objects.hash(alertConfigurationId, additionalHeaders, additionalQueryParams, additionalBodyProperties) /* spotless:on */
+    override fun hashCode(): Int = /* spotless:off */ Objects.hash(alertConfigurationId, subscriptionId, additionalHeaders, additionalQueryParams, additionalBodyProperties) /* spotless:on */
 
     override fun toString() =
-        "AlertDisableParams{alertConfigurationId=$alertConfigurationId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+        "AlertDisableParams{alertConfigurationId=$alertConfigurationId, subscriptionId=$subscriptionId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
 }
diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/models/AlertEnableParams.kt b/orb-java-core/src/main/kotlin/com/withorb/api/models/AlertEnableParams.kt
@@ -13,13 +13,16 @@ import java.util.Optional
 class AlertEnableParams
 constructor(
     private val alertConfigurationId: String,
+    private val subscriptionId: String?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
     private val additionalBodyProperties: Map<String, JsonValue>,
 ) {
 
     fun alertConfigurationId(): String = alertConfigurationId
 
+    fun subscriptionId(): Optional<String> = Optional.ofNullable(subscriptionId)
+
     fun _additionalHeaders(): Headers = additionalHeaders
 
     fun _additionalQueryParams(): QueryParams = additionalQueryParams
@@ -33,7 +36,13 @@ constructor(
 
     @JvmSynthetic internal fun getHeaders(): Headers = additionalHeaders
 
-    @JvmSynthetic internal fun getQueryParams(): QueryParams = additionalQueryParams
+    @JvmSynthetic
+    internal fun getQueryParams(): QueryParams {
+        val queryParams = QueryParams.builder()
+        this.subscriptionId?.let { queryParams.put("subscription_id", listOf(it.toString())) }
+        queryParams.putAll(additionalQueryParams)
+        return queryParams.build()
+    }
 
     fun getPathParam(index: Int): String {
         return when (index) {
@@ -53,13 +62,15 @@ constructor(
     class Builder {
 
         private var alertConfigurationId: String? = null
+        private var subscriptionId: String? = null
         private var additionalHeaders: Headers.Builder = Headers.builder()
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
         private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
         internal fun from(alertEnableParams: AlertEnableParams) = apply {
             alertConfigurationId = alertEnableParams.alertConfigurationId
+            subscriptionId = alertEnableParams.subscriptionId
             additionalHeaders = alertEnableParams.additionalHeaders.toBuilder()
             additionalQueryParams = alertEnableParams.additionalQueryParams.toBuilder()
             additionalBodyProperties = alertEnableParams.additionalBodyProperties.toMutableMap()
@@ -69,6 +80,9 @@ constructor(
             this.alertConfigurationId = alertConfigurationId
         }
 
+        /** Used to update the status of a plan alert scoped to this subscription_id */
+        fun subscriptionId(subscriptionId: String) = apply { this.subscriptionId = subscriptionId }
+
         fun additionalHeaders(additionalHeaders: Headers) = apply {
             this.additionalHeaders.clear()
             putAllAdditionalHeaders(additionalHeaders)
@@ -194,6 +208,7 @@ constructor(
                 checkNotNull(alertConfigurationId) {
                     "`alertConfigurationId` is required but was not set"
                 },
+                subscriptionId,
                 additionalHeaders.build(),
                 additionalQueryParams.build(),
                 additionalBodyProperties.toImmutable(),
@@ -205,11 +220,11 @@ constructor(
             return true
         }
 
-        return /* spotless:off */ other is AlertEnableParams && alertConfigurationId == other.alertConfigurationId && additionalHeaders == other.additionalHeaders && additionalQueryParams == other.additionalQueryParams && additionalBodyProperties == other.additionalBodyProperties /* spotless:on */
+        return /* spotless:off */ other is AlertEnableParams && alertConfigurationId == other.alertConfigurationId && subscriptionId == other.subscriptionId && additionalHeaders == other.additionalHeaders && additionalQueryParams == other.additionalQueryParams && additionalBodyProperties == other.additionalBodyProperties /* spotless:on */
     }
 
-    override fun hashCode(): Int = /* spotless:off */ Objects.hash(alertConfigurationId, additionalHeaders, additionalQueryParams, additionalBodyProperties) /* spotless:on */
+    override fun hashCode(): Int = /* spotless:off */ Objects.hash(alertConfigurationId, subscriptionId, additionalHeaders, additionalQueryParams, additionalBodyProperties) /* spotless:on */
 
     override fun toString() =
-        "AlertEnableParams{alertConfigurationId=$alertConfigurationId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+        "AlertEnableParams{alertConfigurationId=$alertConfigurationId, subscriptionId=$subscriptionId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
 }
diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/AlertServiceAsync.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/AlertServiceAsync.kt
@@ -98,14 +98,22 @@ interface AlertServiceAsync {
         requestOptions: RequestOptions = RequestOptions.none()
     ): CompletableFuture<Alert>
 
-    /** This endpoint can be used to disable an alert. */
+    /**
+     * This endpoint allows you to disable an alert. To disable a plan-level alert for a specific
+     * subscription, you must include the `subscription_id`. The `subscription_id` is not required
+     * for customer or subscription level alerts.
+     */
     @JvmOverloads
     fun disable(
         params: AlertDisableParams,
         requestOptions: RequestOptions = RequestOptions.none()
     ): CompletableFuture<Alert>
 
-    /** This endpoint can be used to enable an alert. */
+    /**
+     * This endpoint allows you to enable an alert. To enable a plan-level alert for a specific
+     * subscription, you must include the `subscription_id`. The `subscription_id` is not required
+     * for customer or subscription level alerts.
+     */
     @JvmOverloads
     fun enable(
         params: AlertEnableParams,

diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/async/AlertServiceAsyncImpl.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/async/AlertServiceAsyncImpl.kt
@@ -251,7 +251,11 @@ constructor(
     private val disableHandler: Handler<Alert> =
         jsonHandler<Alert>(clientOptions.jsonMapper).withErrorHandler(errorHandler)
 
-    /** This endpoint can be used to disable an alert. */
+    /**
+     * This endpoint allows you to disable an alert. To disable a plan-level alert for a specific
+     * subscription, you must include the `subscription_id`. The `subscription_id` is not required
+     * for customer or subscription level alerts.
+     */
     override fun disable(
         params: AlertDisableParams,
         requestOptions: RequestOptions
@@ -281,7 +285,11 @@ constructor(
     private val enableHandler: Handler<Alert> =
         jsonHandler<Alert>(clientOptions.jsonMapper).withErrorHandler(errorHandler)
 
-    /** This endpoint can be used to enable an alert. */
+    /**
+     * This endpoint allows you to enable an alert. To enable a plan-level alert for a specific
+     * subscription, you must include the `subscription_id`. The `subscription_id` is not required
+     * for customer or subscription level alerts.
+     */
     override fun enable(
         params: AlertEnableParams,
         requestOptions: RequestOptions

diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/AlertService.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/AlertService.kt
@@ -97,14 +97,22 @@ interface AlertService {
         requestOptions: RequestOptions = RequestOptions.none()
     ): Alert
 
-    /** This endpoint can be used to disable an alert. */
+    /**
+     * This endpoint allows you to disable an alert. To disable a plan-level alert for a specific
+     * subscription, you must include the `subscription_id`. The `subscription_id` is not required
+     * for customer or subscription level alerts.
+     */
     @JvmOverloads
     fun disable(
         params: AlertDisableParams,
         requestOptions: RequestOptions = RequestOptions.none()
     ): Alert
 
-    /** This endpoint can be used to enable an alert. */
+    /**
+     * This endpoint allows you to enable an alert. To enable a plan-level alert for a specific
+     * subscription, you must include the `subscription_id`. The `subscription_id` is not required
+     * for customer or subscription level alerts.
+     */
     @JvmOverloads
     fun enable(
         params: AlertEnableParams,

diff --git a/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/AlertServiceImpl.kt b/orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/AlertServiceImpl.kt
@@ -234,7 +234,11 @@ constructor(
     private val disableHandler: Handler<Alert> =
         jsonHandler<Alert>(clientOptions.jsonMapper).withErrorHandler(errorHandler)
 
-    /** This endpoint can be used to disable an alert. */
+    /**
+     * This endpoint allows you to disable an alert. To disable a plan-level alert for a specific
+     * subscription, you must include the `subscription_id`. The `subscription_id` is not required
+     * for customer or subscription level alerts.
+     */
     override fun disable(params: AlertDisableParams, requestOptions: RequestOptions): Alert {
         val request =
             HttpRequest.builder()
@@ -260,7 +264,11 @@ constructor(
     private val enableHandler: Handler<Alert> =
         jsonHandler<Alert>(clientOptions.jsonMapper).withErrorHandler(errorHandler)
 
-    /** This endpoint can be used to enable an alert. */
+    /**
+     * This endpoint allows you to enable an alert. To enable a plan-level alert for a specific
+     * subscription, you must include the `subscription_id`. The `subscription_id` is not required
+     * for customer or subscription level alerts.
+     */
     override fun enable(params: AlertEnableParams, requestOptions: RequestOptions): Alert {
         val request =
             HttpRequest.builder()

diff --git a/orb-java-core/src/test/kotlin/com/withorb/api/models/AlertDisableParamsTest.kt b/orb-java-core/src/test/kotlin/com/withorb/api/models/AlertDisableParamsTest.kt
@@ -2,14 +2,38 @@
 
 package com.withorb.api.models
 
+import com.withorb.api.core.http.QueryParams
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
 class AlertDisableParamsTest {
 
     @Test
     fun createAlertDisableParams() {
-        AlertDisableParams.builder().alertConfigurationId("alert_configuration_id").build()
+        AlertDisableParams.builder()
+            .alertConfigurationId("alert_configuration_id")
+            .subscriptionId("subscription_id")
+            .build()
+    }
+
+    @Test
+    fun getQueryParams() {
+        val params =
+            AlertDisableParams.builder()
+                .alertConfigurationId("alert_configuration_id")
+                .subscriptionId("subscription_id")
+                .build()
+        val expected = QueryParams.builder()
+        expected.put("subscription_id", "subscription_id")
+        assertThat(params.getQueryParams()).isEqualTo(expected.build())
+    }
+
+    @Test
+    fun getQueryParamsWithoutOptionalFields() {
+        val params =
+            AlertDisableParams.builder().alertConfigurationId("alert_configuration_id").build()
+        val expected = QueryParams.builder()
+        assertThat(params.getQueryParams()).isEqualTo(expected.build())
     }
 
     @Test

diff --git a/orb-java-core/src/test/kotlin/com/withorb/api/models/AlertEnableParamsTest.kt b/orb-java-core/src/test/kotlin/com/withorb/api/models/AlertEnableParamsTest.kt
@@ -2,14 +2,38 @@
 
 package com.withorb.api.models
 
+import com.withorb.api.core.http.QueryParams
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
 class AlertEnableParamsTest {
 
     @Test
     fun createAlertEnableParams() {
-        AlertEnableParams.builder().alertConfigurationId("alert_configuration_id").build()
+        AlertEnableParams.builder()
+            .alertConfigurationId("alert_configuration_id")
+            .subscriptionId("subscription_id")
+            .build()
+    }
+
+    @Test
+    fun getQueryParams() {
+        val params =
+            AlertEnableParams.builder()
+                .alertConfigurationId("alert_configuration_id")
+                .subscriptionId("subscription_id")
+                .build()
+        val expected = QueryParams.builder()
+        expected.put("subscription_id", "subscription_id")
+        assertThat(params.getQueryParams()).isEqualTo(expected.build())
+    }
+
+    @Test
+    fun getQueryParamsWithoutOptionalFields() {
+        val params =
+            AlertEnableParams.builder().alertConfigurationId("alert_configuration_id").build()
+        val expected = QueryParams.builder()
+        assertThat(params.getQueryParams()).isEqualTo(expected.build())
     }
 
     @Test

diff --git a/orb-java-core/src/test/kotlin/com/withorb/api/services/blocking/AlertServiceTest.kt b/orb-java-core/src/test/kotlin/com/withorb/api/services/blocking/AlertServiceTest.kt
@@ -150,7 +150,10 @@ class AlertServiceTest {
         val alertService = client.alerts()
         val alert =
             alertService.disable(
-                AlertDisableParams.builder().alertConfigurationId("alert_configuration_id").build()
+                AlertDisableParams.builder()
+                    .alertConfigurationId("alert_configuration_id")
+                    .subscriptionId("subscription_id")
+                    .build()
             )
         println(alert)
         alert.validate()
@@ -166,7 +169,10 @@ class AlertServiceTest {
         val alertService = client.alerts()
         val alert =
             alertService.enable(
-                AlertEnableParams.builder().alertConfigurationId("alert_configuration_id").build()
+                AlertEnableParams.builder()
+                    .alertConfigurationId("alert_configuration_id")
+                    .subscriptionId("subscription_id")
+                    .build()
             )
         println(alert)
         alert.validate()