feat(api): add OAuthErrorCode type

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 151
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-dd99495ad509338e6de862802839360dfe394d5cd6d6ba6d13fec8fca92328b8.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-a6eca1bd01e0c434af356fe5275c206057216a4e626d1051d294c27016cd6d05.yml
 openapi_spec_hash: 68abda9122013a9ae3f084cfdbe8e8c1
-config_hash: 1b7e3ce9f1cb351b5077f6c9d8dccd8f
+config_hash: 5b9de93ccb5052ffa603a3c2d93b621c

openai-java-core/src/main/kotlin/com/openai/models/OAuthErrorCode.kt

@@ -0,0 +1,132 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models
+
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.openai.core.Enum
+import com.openai.core.JsonField
+import com.openai.errors.OpenAIInvalidDataException
+
+class OAuthErrorCode @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+    /**
+     * Returns this class instance's raw value.
+     *
+     * This is usually only useful if this instance was deserialized from data that doesn't match
+     * any known member, and you want to know that value. For example, if the SDK is on an older
+     * version than the API, then the API may respond with new members that the SDK is unaware of.
+     */
+    @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+    companion object {
+
+        @JvmField val INVALID_GRANT = of("invalid_grant")
+
+        @JvmField val INVALID_SUBJECT_TOKEN = of("invalid_subject_token")
+
+        @JvmStatic fun of(value: String) = OAuthErrorCode(JsonField.of(value))
+    }
+
+    /** An enum containing [OAuthErrorCode]'s known values. */
+    enum class Known {
+        INVALID_GRANT,
+        INVALID_SUBJECT_TOKEN,
+    }
+
+    /**
+     * An enum containing [OAuthErrorCode]'s known values, as well as an [_UNKNOWN] member.
+     *
+     * An instance of [OAuthErrorCode] can contain an unknown value in a couple of cases:
+     * - It was deserialized from data that doesn't match any known member. For example, if the SDK
+     *   is on an older version than the API, then the API may respond with new members that the SDK
+     *   is unaware of.
+     * - It was constructed with an arbitrary value using the [of] method.
+     */
+    enum class Value {
+        INVALID_GRANT,
+        INVALID_SUBJECT_TOKEN,
+        /**
+         * An enum member indicating that [OAuthErrorCode] was instantiated with an unknown value.
+         */
+        _UNKNOWN,
+    }
+
+    /**
+     * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN] if
+     * the class was instantiated with an unknown value.
+     *
+     * Use the [known] method instead if you're certain the value is always known or if you want to
+     * throw for the unknown case.
+     */
+    fun value(): Value =
+        when (this) {
+            INVALID_GRANT -> Value.INVALID_GRANT
+            INVALID_SUBJECT_TOKEN -> Value.INVALID_SUBJECT_TOKEN
+            else -> Value._UNKNOWN
+        }
+
+    /**
+     * Returns an enum member corresponding to this class instance's value.
+     *
+     * Use the [value] method instead if you're uncertain the value is always known and don't want
+     * to throw for the unknown case.
+     *
+     * @throws OpenAIInvalidDataException if this class instance's value is a not a known member.
+     */
+    fun known(): Known =
+        when (this) {
+            INVALID_GRANT -> Known.INVALID_GRANT
+            INVALID_SUBJECT_TOKEN -> Known.INVALID_SUBJECT_TOKEN
+            else -> throw OpenAIInvalidDataException("Unknown OAuthErrorCode: $value")
+        }
+
+    /**
+     * Returns this class instance's primitive wire representation.
+     *
+     * This differs from the [toString] method because that method is primarily for debugging and
+     * generally doesn't throw.
+     *
+     * @throws OpenAIInvalidDataException if this class instance's value does not have the expected
+     *   primitive type.
+     */
+    fun asString(): String =
+        _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+    private var validated: Boolean = false
+
+    fun validate(): OAuthErrorCode = apply {
+        if (validated) {
+            return@apply
+        }
+
+        known()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is OAuthErrorCode && value == other.value
+    }
+
+    override fun hashCode() = value.hashCode()
+
+    override fun toString() = value.toString()
+}