feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 115
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/xquik%2Fx-twitter-scraper-93bb7d4f1475c8043af464ec88244a034456c549136c8477f284f0a33192e1c9.yml
-openapi_spec_hash: 74dca63c872249274ad99b111dea0833
+configured_endpoints: 102
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/xquik%2Fx-twitter-scraper-f4a2baf44e99ee3fa87e08d50099bc70680c9ef2e612290ab1f749396266455d.yml
+openapi_spec_hash: 1b7655f5b5cc5ffb69e41461cd4d9158
 config_hash: 8894c96caeb6df84c9394518810221bd

x-twitter-scraper-java-core/src/main/kotlin/com/x_twitter_scraper/api/models/radar/RadarRetrieveTrendingTopicsParams.kt

@@ -2,9 +2,13 @@
 
 package com.x_twitter_scraper.api.models.radar
 
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.x_twitter_scraper.api.core.Enum
+import com.x_twitter_scraper.api.core.JsonField
 import com.x_twitter_scraper.api.core.Params
 import com.x_twitter_scraper.api.core.http.Headers
 import com.x_twitter_scraper.api.core.http.QueryParams
+import com.x_twitter_scraper.api.errors.XTwitterScraperInvalidDataException
 import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
@@ -16,7 +20,7 @@ private constructor(
     private val count: Long?,
     private val hours: Long?,
     private val region: String?,
-    private val source: String?,
+    private val source: Source?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
 ) : Params {
@@ -37,7 +41,7 @@ private constructor(
      * Source filter. One of: github, google_trends, hacker_news, polymarket, reddit, trustmrr,
      * wikipedia
      */
-    fun source(): Optional<String> = Optional.ofNullable(source)
+    fun source(): Optional<Source> = Optional.ofNullable(source)
 
     /** Additional headers to send with the request. */
     fun _additionalHeaders(): Headers = additionalHeaders
@@ -65,7 +69,7 @@ private constructor(
         private var count: Long? = null
         private var hours: Long? = null
         private var region: String? = null
-        private var source: String? = null
+        private var source: Source? = null
         private var additionalHeaders: Headers.Builder = Headers.builder()
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
 
@@ -124,10 +128,10 @@ private constructor(
          * Source filter. One of: github, google_trends, hacker_news, polymarket, reddit, trustmrr,
          * wikipedia
          */
-        fun source(source: String?) = apply { this.source = source }
+        fun source(source: Source?) = apply { this.source = source }
 
         /** Alias for calling [Builder.source] with `source.orElse(null)`. */
-        fun source(source: Optional<String>) = source(source.getOrNull())
+        fun source(source: Optional<Source>) = source(source.getOrNull())
 
         fun additionalHeaders(additionalHeaders: Headers) = apply {
             this.additionalHeaders.clear()
@@ -253,11 +257,172 @@ private constructor(
                 count?.let { put("count", it.toString()) }
                 hours?.let { put("hours", it.toString()) }
                 region?.let { put("region", it) }
-                source?.let { put("source", it) }
+                source?.let { put("source", it.toString()) }
                 putAll(additionalQueryParams)
             }
             .build()
 
+    /**
+     * Source filter. One of: github, google_trends, hacker_news, polymarket, reddit, trustmrr,
+     * wikipedia
+     */
+    class Source @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 GITHUB = of("github")
+
+            @JvmField val GOOGLE_TRENDS = of("google_trends")
+
+            @JvmField val HACKER_NEWS = of("hacker_news")
+
+            @JvmField val POLYMARKET = of("polymarket")
+
+            @JvmField val REDDIT = of("reddit")
+
+            @JvmField val TRUSTMRR = of("trustmrr")
+
+            @JvmField val WIKIPEDIA = of("wikipedia")
+
+            @JvmStatic fun of(value: String) = Source(JsonField.of(value))
+        }
+
+        /** An enum containing [Source]'s known values. */
+        enum class Known {
+            GITHUB,
+            GOOGLE_TRENDS,
+            HACKER_NEWS,
+            POLYMARKET,
+            REDDIT,
+            TRUSTMRR,
+            WIKIPEDIA,
+        }
+
+        /**
+         * An enum containing [Source]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Source] 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 {
+            GITHUB,
+            GOOGLE_TRENDS,
+            HACKER_NEWS,
+            POLYMARKET,
+            REDDIT,
+            TRUSTMRR,
+            WIKIPEDIA,
+            /** An enum member indicating that [Source] 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) {
+                GITHUB -> Value.GITHUB
+                GOOGLE_TRENDS -> Value.GOOGLE_TRENDS
+                HACKER_NEWS -> Value.HACKER_NEWS
+                POLYMARKET -> Value.POLYMARKET
+                REDDIT -> Value.REDDIT
+                TRUSTMRR -> Value.TRUSTMRR
+                WIKIPEDIA -> Value.WIKIPEDIA
+                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 XTwitterScraperInvalidDataException if this class instance's value is a not a
+         *   known member.
+         */
+        fun known(): Known =
+            when (this) {
+                GITHUB -> Known.GITHUB
+                GOOGLE_TRENDS -> Known.GOOGLE_TRENDS
+                HACKER_NEWS -> Known.HACKER_NEWS
+                POLYMARKET -> Known.POLYMARKET
+                REDDIT -> Known.REDDIT
+                TRUSTMRR -> Known.TRUSTMRR
+                WIKIPEDIA -> Known.WIKIPEDIA
+                else -> throw XTwitterScraperInvalidDataException("Unknown Source: $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 XTwitterScraperInvalidDataException if this class instance's value does not have
+         *   the expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow {
+                XTwitterScraperInvalidDataException("Value is not a String")
+            }
+
+        private var validated: Boolean = false
+
+        fun validate(): Source = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: XTwitterScraperInvalidDataException) {
+                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 Source && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true