Release: v4.2.0

buildSrc/src/main/kotlin/P.kt

@@ -34,8 +34,8 @@ object P : ProjectDetail() {
     override val homepage: String
         get() = HOMEPAGE
 
-    const val VERSION = "4.1.7"
-    const val NEXT_VERSION = "4.1.8"
+    const val VERSION = "4.2.0"
+    const val NEXT_VERSION = "4.2.1"
 
     override val snapshotVersion = "$NEXT_VERSION-SNAPSHOT"
     override val version = if (isSnapshot()) snapshotVersion else VERSION

gradle/libs.versions.toml

@@ -77,6 +77,7 @@ ktor-client-core = { group = "io.ktor", name = "ktor-client-core", version.ref =
 ktor-client-java = { group = "io.ktor", name = "ktor-client-java", version.ref = "ktor" }
 ktor-client-cio = { group = "io.ktor", name = "ktor-client-cio", version.ref = "ktor" }
 ktor-client-ws = { group = "io.ktor", name = "ktor-client-websockets", version.ref = "ktor" }
+ktor-client-mock = { group = "io.ktor", name = "ktor-client-mock", version.ref = "ktor" }
 
 ktor-client-js = { group = "io.ktor", name = "ktor-client-js", version.ref = "ktor" }
 

simbot-component-kook-api/build.gradle.kts

@@ -84,6 +84,7 @@ kotlin {
             dependencies {
                 implementation(kotlin("test"))
                 implementation(libs.kotlinx.coroutines.test)
+                implementation(libs.ktor.client.mock)
             }
         }
 

simbot-component-kook-api/src/commonMain/kotlin/love/forte/simbot/kook/api/ApiResult.kt

@@ -28,6 +28,7 @@
 import kotlinx.serialization.json.buildJsonObject
 import kotlinx.serialization.json.decodeFromJsonElement
 import love.forte.simbot.kook.InternalKookApi
+import love.forte.simbot.kook.api.KookApiResults.SUCCESS_CODE
 import love.forte.simbot.kook.api.RateLimit.Companion.DEFAULT_LIMIT
 import love.forte.simbot.kook.api.RateLimit.Companion.DEFAULT_REMAINING
 import love.forte.simbot.kook.api.RateLimit.Companion.DEFAULT_RESET
@@ -207,7 +208,7 @@
     /**
      * 此接口的响应码是否为成功的响应码.
      */
-    public val isSuccess: Boolean get() = isHttpSuccess && code == KookApiResults.SUCCESS_CODE
+    public val isSuccess: Boolean get() = isHttpSuccess && code == SUCCESS_CODE
 
     /**
      * 判断 [httpStatus] 是否 [成功][HttpStatusCode.isSuccess]。
@@ -241,7 +242,7 @@
      * @param json 用于解析 [data] 的json反序列化器
      * @param deserializationStrategy 解析目标的反序列化策略，参考 [KookApi.resultDeserializationStrategy]
      * @throws ApiResultException 如果 [code] 不为成功
      * @throws SerializationException see [Json.decodeFromJsonElement].
      */
     @JvmOverloads
     public fun <T> parseDataOrThrow(
@@ -256,8 +257,22 @@
 
 
     override fun toString(): String =
-        "ApiResult(code=$code, message=$message, data=$data, httpStatus=$httpStatus, rateLimit=$rateLimit, raw=$raw)"
-
+        "ApiResult(" +
+                "code=$code, " +
+                "message=$message, " +
+                "data=$data, " +
+                "httpStatus=${httpStatusOrNull ?: "<Not Initialized>"}, " +
+                "rateLimit=${rateLimitOrNull ?: "<Not Initialized>"}, " +
+                "raw=${rawOrNull ?: "<Not Initialized>"})"
+
+    private val httpStatusOrNull
+        get() = if (::httpStatus.isInitialized) httpStatus else null
+
+    private val rateLimitOrNull
+        get() = if (::rateLimit.isInitialized) rateLimit else null
+
+    private val rawOrNull
+        get() = if (::raw.isInitialized) raw else null
 
     override fun equals(other: Any?): Boolean {
         if (this === other) return true

simbot-component-kook-api/src/commonMain/kotlin/love/forte/simbot/kook/api/channel/ChannelKickoutApi.kt

@@ -0,0 +1,71 @@
+/*
+ *     Copyright (c) 2023-2025. ForteScarlet.
+ *
+ *     This file is part of simbot-component-kook.
+ *
+ *     simbot-component-kook is free software: you can redistribute it and/or modify
+ *     it under the terms of the GNU Lesser General Public License as published by
+ *     the Free Software Foundation, either version 3 of the License, or
+ *     (at your option) any later version.
+ *
+ *     simbot-component-kook is distributed in the hope that it will be useful,
+ *     but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ *     GNU Lesser General Public License for more details.
+ *
+ *     You should have received a copy of the GNU Lesser General Public License
+ *     along with simbot-component-kook,
+ *     If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package love.forte.simbot.kook.api.channel
+
+import kotlinx.serialization.DeserializationStrategy
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.builtins.serializer
+import love.forte.simbot.kook.api.KookPostApi
+import kotlin.jvm.JvmStatic
+
+/**
+ * [踢出语音频道中的用户](https://developer.kookapp.cn/doc/http/channel#踢出语音频道中的用户)
+ *
+ * 踢出语音频道中的用户，只能踢出在语音频道中的用户
+ *
+ * @author ForteScarlet
+ * @since 4.2.0
+ */
+public class ChannelKickoutApi private constructor(
+    channelId: String,
+    userId: String
+) : KookPostApi<Unit>() {
+    public companion object Factory {
+        private val PATH = ApiPath.create("channel", "kickout")
+
+        /**
+         * 构造 [ChannelKickoutApi].
+         *
+         * @param channelId 目标频道 id，需要是语音频道
+         * @param userId 用户 id
+         */
+        @JvmStatic
+        public fun create(channelId: String, userId: String): ChannelKickoutApi = 
+            ChannelKickoutApi(channelId, userId)
+    }
+
+    override val resultDeserializationStrategy: DeserializationStrategy<Unit>
+        get() = Unit.serializer()
+
+    override val apiPath: ApiPath
+        get() = PATH
+
+    override val body: Any = Body(channelId, userId)
+
+    @Serializable
+    private data class Body(
+        @SerialName("channel_id") 
+        val channelId: String,
+        @SerialName("user_id") 
+        val userId: String
+    )
+}

simbot-component-kook-api/src/commonMain/kotlin/love/forte/simbot/kook/api/channel/ChannelMoveUserApi.kt

@@ -0,0 +1,83 @@
+/*
+ *     Copyright (c) 2023-2025. ForteScarlet.
+ *
+ *     This file is part of simbot-component-kook.
+ *
+ *     simbot-component-kook is free software: you can redistribute it and/or modify
+ *     it under the terms of the GNU Lesser General Public License as published by
+ *     the Free Software Foundation, either version 3 of the License, or
+ *     (at your option) any later version.
+ *
+ *     simbot-component-kook is distributed in the hope that it will be useful,
+ *     but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ *     GNU Lesser General Public License for more details.
+ *
+ *     You should have received a copy of the GNU Lesser General Public License
+ *     along with simbot-component-kook,
+ *     If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package love.forte.simbot.kook.api.channel
+
+import kotlinx.serialization.DeserializationStrategy
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.builtins.serializer
+import love.forte.simbot.kook.api.KookPostApi
+import kotlin.jvm.JvmStatic
+
+/**
+ * [语音频道之间移动用户](https://developer.kookapp.cn/doc/http/channel#语音频道之间移动用户)
+ *
+ * 语音频道之间移动用户，只能在语音频道之间移动，用户也必须在其他语音频道在线才能够移动到目标频道。
+ *
+ *
+ * @author ForteScarlet
+ * @since 4.2.0
+ */
+public class ChannelMoveUserApi private constructor(
+    targetId: String,
+    userIds: List<String>
+) : KookPostApi<Unit>() {
+
+    public companion object Factory {
+        private val PATH = ApiPath.create("channel", "move-user")
+
+        /**
+         * 构造 [ChannelMoveUserApi].
+         *
+         * @param targetId 目标频道 id，需要是语音频道
+         * @param userIds 用户 id 的数组
+         */
+        @JvmStatic
+        public fun create(targetId: String, userIds: List<String>): ChannelMoveUserApi = 
+            ChannelMoveUserApi(targetId, userIds)
+
+        /**
+         * 构造 [ChannelMoveUserApi].
+         *
+         * @param targetId 目标频道 id，需要是语音频道
+         * @param userIds 用户 id 的数组
+         */
+        @JvmStatic
+        public fun create(targetId: String, vararg userIds: String): ChannelMoveUserApi = 
+            ChannelMoveUserApi(targetId, userIds.asList())
+    }
+
+    override val resultDeserializationStrategy: DeserializationStrategy<Unit>
+        get() = Unit.serializer()
+
+    override val apiPath: ApiPath
+        get() = PATH
+
+    override val body: Any = Body(targetId, userIds)
+
+    @Serializable
+    private data class Body(
+        @SerialName("target_id") 
+        val targetId: String,
+        @SerialName("user_ids") 
+        val userIds: List<String>
+    )
+}