refactor: move io.agora.spring.boot package to io.agora.cloud

- io.agora.spring.boot (incl. req/resp) -> io.agora.cloud, keeps the SDK
  free of any Spring-flavoured package naming
- fix cross-package imports in DefaultRecordingEventHandler
- update README/README.zh-CN accordingly
- add missing junit-jupiter test dependency

Author: loong10k

README.md

@@ -35,10 +35,10 @@ Agora (声网) platform services commonly needed by server-side applications:
 - **On-premise Recording** — a JNI bridge (`RecordingSDK`) to the Agora recording
   native library for local / on-premise recording scenarios.
 
-The SDK core (packages `io.agora.media`, `io.agora.recording`, `io.agora.rtm`,
-`io.agora.signal`) has no framework dependency. The `io.agora.spring.boot` package
-provides a Spring-friendly facade (`AgoraTemplate`, `AgoraProperties`) that stays a
-plain POJO layer — no Spring classes are required to compile or run it.
+The whole SDK (including the `io.agora.cloud` REST facade with `AgoraTemplate`
+and `AgoraProperties`) is a plain POJO layer — no Spring classes are required to
+compile or run it. Spring Boot integration is provided by the separate
+`agora-spring-boot-starter` project.
 
 What it is **not**:
 
@@ -93,7 +93,7 @@ Version lines:
 | RTC client app   |   | agora-java-sdk (single jar)              |
 | (channel / uid)  |-->|  media   : RtcTokenBuilder, AccessToken  |
 | Agora Console    |   |  rtm/sig : RtmTokenBuilder, Signaling    |
-| (AppId / Cert)   |   |  spring.boot : AgoraTemplate, Operations |
+| (AppId / Cert)   |   |  cloud : AgoraTemplate, Operations |
 |                  |   |  recording : RecordingSDK (native)       |
 +------------------+   +---------------------+--------------------+
                                             |
@@ -162,7 +162,7 @@ accepts for the channel until the expiry timestamp.
 ## 7. Configuration
 
 This library has no runtime configuration file of its own. When used with the
-`io.agora.spring.boot` facade, `AgoraProperties` defines the property prefix
+`io.agora.cloud` facade, `AgoraProperties` defines the property prefix
 `agora` (constant `AgoraProperties.PREFIX`). In Spring Boot, bind it with
 `@ConfigurationProperties(prefix = "agora")`.
 
@@ -198,7 +198,7 @@ agora:
 
 ```java
 import com.fasterxml.jackson.databind.ObjectMapper;
-import io.agora.spring.boot.*;
+import io.agora.cloud.*;
 import okhttp3.OkHttpClient;
 
 AgoraProperties props = new AgoraProperties();
@@ -228,7 +228,7 @@ The operations follow the official Agora REST flow and map 1:1 to documented API
 → `updateMixRecording(...)` / `updateIndividualRecording(...)` / `updateLayout(...)`
 → `queryRecording(channelName, uid, resourceId, sid, mode)` → `stopRecording(channelName, uid, resourceId, sid, mode, asyncStop)`.
 
-Request/response models live in `io.agora.spring.boot.req` and `io.agora.spring.boot.resp`
+Request/response models live in `io.agora.cloud.req` and `io.agora.cloud.resp`
 (e.g. `RecordingStorageConfig`, `TranscodingConfig`, `CloudRecordingQueryResponse`).
 
 ## 9. Testing & Build

README.zh-CN.md

@@ -32,10 +32,9 @@
 - **频道管理** — REST 客户端操作：查询频道用户状态、频道用户列表、频道列表。
 - **本地录制** — `RecordingSDK`（JNI 桥接），对接声网录制端原生库，用于本地 / 私有化录制场景。
 
-SDK 核心（`io.agora.media`、`io.agora.recording`、`io.agora.rtm`、`io.agora.signal`
-包）无任何框架依赖。`io.agora.spring.boot` 包提供对 Spring 友好的门面
-（`AgoraTemplate`、`AgoraProperties`），但始终是纯 POJO 层——编译和运行都不依赖
-Spring 类。
+整个 SDK（包括 `io.agora.cloud` 包的 REST 门面 `AgoraTemplate`、`AgoraProperties`）
+都是纯 POJO 层——编译和运行都不依赖任何框架类。Spring Boot 集成由独立的
+`agora-spring-boot-starter` 项目提供。
 
 它不是：
 
@@ -88,7 +87,7 @@ Spring 类。
 | RTC client app   |   | agora-java-sdk (single jar)              |
 | (channel / uid)  |-->|  media   : RtcTokenBuilder, AccessToken  |
 | Agora Console    |   |  rtm/sig : RtmTokenBuilder, Signaling    |
-| (AppId / Cert)   |   |  spring.boot : AgoraTemplate, Operations |
+| (AppId / Cert)   |   |  cloud : AgoraTemplate, Operations |
 |                  |   |  recording : RecordingSDK (native)       |
 +------------------+   +---------------------+--------------------+
                                             |
@@ -155,7 +154,7 @@ public class TokenDemo {
 
 ## 7. 配置
 
-本库自身没有运行时配置文件。使用 `io.agora.spring.boot` 门面时，
+本库自身没有运行时配置文件。使用 `io.agora.cloud` 门面时，
 `AgoraProperties` 定义了属性前缀 `agora`（常量 `AgoraProperties.PREFIX`）。
 Spring Boot 中通过 `@ConfigurationProperties(prefix = "agora")` 绑定。
 
@@ -190,7 +189,7 @@ agora:
 
 ```java
 import com.fasterxml.jackson.databind.ObjectMapper;
-import io.agora.spring.boot.*;
+import io.agora.cloud.*;
 import okhttp3.OkHttpClient;
 
 AgoraProperties props = new AgoraProperties();
@@ -220,7 +219,7 @@ CloudRecordingStartResponse start = template.opsForCloudRecording().startRecordi
 → `updateMixRecording(...)` / `updateIndividualRecording(...)` / `updateLayout(...)`
 → `queryRecording(channelName, uid, resourceId, sid, mode)` → `stopRecording(channelName, uid, resourceId, sid, mode, asyncStop)`。
 
-请求 / 响应模型位于 `io.agora.spring.boot.req` 与 `io.agora.spring.boot.resp`
+请求 / 响应模型位于 `io.agora.cloud.req` 与 `io.agora.cloud.resp`
 （如 `RecordingStorageConfig`、`TranscodingConfig`、`CloudRecordingQueryResponse`）。
 
 ## 9. 测试与构建

pom.xml

@@ -160,6 +160,13 @@
             <groupId>commons-codec</groupId>
             <artifactId>commons-codec</artifactId>
         </dependency>
+        <!-- For JUnit Jupiter -->
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter</artifactId>
+            <version>${junit-jupiter.version}</version>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
 
     <!-- 构建配置（Build） -->

…o/agora/spring/boot/AgoraApiAddress.java …java/io/agora/cloud/AgoraApiAddress.javasrc/main/java/io/agora/spring/boot/AgoraApiAddress.java renamed to src/main/java/io/agora/cloud/AgoraApiAddress.java src/main/java/io/agora/spring/boot/AgoraApiAddress.java renamed to src/main/java/io/agora/cloud/AgoraApiAddress.java

@@ -1,4 +1,4 @@
-package io.agora.spring.boot;
+package io.agora.cloud;
 
 import java.text.MessageFormat;
 

…/AgoraChannelManagerAsyncOperations.java …/AgoraChannelManagerAsyncOperations.javasrc/main/java/io/agora/spring/boot/AgoraChannelManagerAsyncOperations.java renamed to src/main/java/io/agora/cloud/AgoraChannelManagerAsyncOperations.java src/main/java/io/agora/spring/boot/AgoraChannelManagerAsyncOperations.java renamed to src/main/java/io/agora/cloud/AgoraChannelManagerAsyncOperations.java

@@ -13,7 +13,7 @@
  * License for the specific language governing permissions and limitations under
  * the License.
  */
-package io.agora.spring.boot;
+package io.agora.cloud;
 
 /**
  * Asynchronous variant of {@link AgoraChannelManagerOperations} for non-blocking

…/boot/AgoraChannelManagerOperations.java …cloud/AgoraChannelManagerOperations.javasrc/main/java/io/agora/spring/boot/AgoraChannelManagerOperations.java renamed to src/main/java/io/agora/cloud/AgoraChannelManagerOperations.java src/main/java/io/agora/spring/boot/AgoraChannelManagerOperations.java renamed to src/main/java/io/agora/cloud/AgoraChannelManagerOperations.java

@@ -13,10 +13,10 @@
  * License for the specific language governing permissions and limitations under
  * the License.
  */
-package io.agora.spring.boot;
+package io.agora.cloud;
 
-import io.agora.spring.boot.resp.ChannelUserListResponse;
-import io.agora.spring.boot.resp.ChannelUserStateResponse;
+import io.agora.cloud.resp.ChannelUserListResponse;
+import io.agora.cloud.resp.ChannelUserStateResponse;
 
 import java.io.IOException;
 

…/AgoraCloudRecordingAsyncOperations.java …/AgoraCloudRecordingAsyncOperations.javasrc/main/java/io/agora/spring/boot/AgoraCloudRecordingAsyncOperations.java renamed to src/main/java/io/agora/cloud/AgoraCloudRecordingAsyncOperations.java src/main/java/io/agora/spring/boot/AgoraCloudRecordingAsyncOperations.java renamed to src/main/java/io/agora/cloud/AgoraCloudRecordingAsyncOperations.java

@@ -13,14 +13,14 @@
  * License for the specific language governing permissions and limitations under
  * the License.
  */
-package io.agora.spring.boot;
+package io.agora.cloud;
 
 import com.google.common.collect.ImmutableMap;
-import io.agora.spring.boot.req.*;
-import io.agora.spring.boot.resp.CloudRecordingStartResponse;
-import io.agora.spring.boot.resp.CloudRecordingStopResponse;
-import io.agora.spring.boot.resp.CloudRecordingUpdateLayoutResponse;
-import io.agora.spring.boot.resp.CloudRecordingUpdateResponse;
+import io.agora.cloud.req.*;
+import io.agora.cloud.resp.CloudRecordingStartResponse;
+import io.agora.cloud.resp.CloudRecordingStopResponse;
+import io.agora.cloud.resp.CloudRecordingUpdateLayoutResponse;
+import io.agora.cloud.resp.CloudRecordingUpdateResponse;
 import org.apache.commons.lang3.StringUtils;
 
 import java.io.IOException;

…/boot/AgoraCloudRecordingOperations.java …cloud/AgoraCloudRecordingOperations.javasrc/main/java/io/agora/spring/boot/AgoraCloudRecordingOperations.java renamed to src/main/java/io/agora/cloud/AgoraCloudRecordingOperations.java src/main/java/io/agora/spring/boot/AgoraCloudRecordingOperations.java renamed to src/main/java/io/agora/cloud/AgoraCloudRecordingOperations.java

@@ -13,12 +13,12 @@
  * License for the specific language governing permissions and limitations under
  * the License.
  */
-package io.agora.spring.boot;
+package io.agora.cloud;
 
 import com.google.common.collect.ImmutableMap;
 import com.google.common.collect.Maps;
-import io.agora.spring.boot.req.*;
-import io.agora.spring.boot.resp.*;
+import io.agora.cloud.req.*;
+import io.agora.cloud.resp.*;
 import org.apache.commons.lang3.StringUtils;
 
 import java.io.IOException;

…/io/agora/spring/boot/AgoraConstant.java …n/java/io/agora/cloud/AgoraConstant.javasrc/main/java/io/agora/spring/boot/AgoraConstant.java renamed to src/main/java/io/agora/cloud/AgoraConstant.java src/main/java/io/agora/spring/boot/AgoraConstant.java renamed to src/main/java/io/agora/cloud/AgoraConstant.java

@@ -1,4 +1,4 @@
-package io.agora.spring.boot;
+package io.agora.cloud;
 
 /**
  * Constants used across the Agora Spring Boot integration, including

…ra/spring/boot/AgoraOkHttp3Template.java …io/agora/cloud/AgoraOkHttp3Template.javasrc/main/java/io/agora/spring/boot/AgoraOkHttp3Template.java renamed to src/main/java/io/agora/cloud/AgoraOkHttp3Template.java src/main/java/io/agora/spring/boot/AgoraOkHttp3Template.java renamed to src/main/java/io/agora/cloud/AgoraOkHttp3Template.java

@@ -13,11 +13,11 @@
  * License for the specific language governing permissions and limitations under
  * the License.
  */
-package io.agora.spring.boot;
+package io.agora.cloud;
 
 import com.alibaba.fastjson2.JSONObject;
 import com.fasterxml.jackson.databind.ObjectMapper;
-import io.agora.spring.boot.resp.AgoraResponse;
+import io.agora.cloud.resp.AgoraResponse;
 import lombok.extern.slf4j.Slf4j;
 import okhttp3.*;
 // InitializingBean removed for SDK