@coze/realtime-api 1.1.0 → 1.1.1-beta.2

package/dist/esm/index.js

@@ -346,6 +346,12 @@ const handleAdditionalMessages = (additional_messages)=>null == additional_messa
             ...i,
             content: 'object' == typeof i.content ? JSON.stringify(i.content) : i.content
         }));
+const handleParameters = (parameters)=>{
+    if (parameters) {
+        for (const [key, value] of Object.entries(parameters))if ('object' == typeof value) parameters[key] = JSON.stringify(value);
+    }
+    return parameters;
+};
 class Chat extends APIResource {
     /**
    * Call the Chat API to send messages to a published Coze agent. | 调用此接口发起一次对话，支持添加上下文
@@ -368,6 +374,10 @@ class Chat extends APIResource {
         const payload = {
             ...rest,
             additional_messages: handleAdditionalMessages(params.additional_messages),
+            shortcut_command: params.shortcut_command ? {
+                ...params.shortcut_command,
+                parameters: handleParameters(params.shortcut_command.parameters)
+            } : void 0,
             stream: false
         };
         const result = await this._client.post(apiUrl, payload, false, options);
@@ -394,6 +404,10 @@ class Chat extends APIResource {
         const payload = {
             ...rest,
             additional_messages: handleAdditionalMessages(params.additional_messages),
+            shortcut_command: params.shortcut_command ? {
+                ...params.shortcut_command,
+                parameters: handleParameters(params.shortcut_command.parameters)
+            } : void 0,
             stream: false
         };
         const result = await this._client.post(apiUrl, payload, false, options);
@@ -432,6 +446,10 @@ class Chat extends APIResource {
         const payload = {
             ...rest,
             additional_messages: handleAdditionalMessages(params.additional_messages),
+            shortcut_command: params.shortcut_command ? {
+                ...params.shortcut_command,
+                parameters: handleParameters(params.shortcut_command.parameters)
+            } : void 0,
             stream: true
         };
         const result = await this._client.post(apiUrl, payload, true, options);
@@ -4595,6 +4613,8 @@ class WebSocketAPI {
         });
         this.rws.addEventListener('error', (event)=>{
             var _event_target__req_res, _event_target__req, _event_target, _event_target__req_res1, _event_target__req1, _event_target1, _this_onerror, _this;
+            const { readyState } = this.rws;
+            if (3 === readyState) return;
             const statusCode = null === (_event_target = event.target) || void 0 === _event_target ? void 0 : null === (_event_target__req = _event_target._req) || void 0 === _event_target__req ? void 0 : null === (_event_target__req_res = _event_target__req.res) || void 0 === _event_target__req_res ? void 0 : _event_target__req_res.statusCode;
             const rawHeaders = (null === (_event_target1 = event.target) || void 0 === _event_target1 ? void 0 : null === (_event_target__req1 = _event_target1._req) || void 0 === _event_target__req1 ? void 0 : null === (_event_target__req_res1 = _event_target__req1.res) || void 0 === _event_target__req_res1 ? void 0 : _event_target__req_res1.rawHeaders) || [];
             const logidIndex = rawHeaders.findIndex((header)=>'X-Tt-Logid' === header);
@@ -4618,7 +4638,8 @@ class WebSocketAPI {
                 error.data.msg = 'Forbidden';
             } else {
                 error.data.code = 500;
-                error.data.msg = String(null == event ? void 0 : event.error) || 'WebSocket error';
+                var _event_error;
+                error.data.msg = String(null !== (_event_error = null == event ? void 0 : event.error) && void 0 !== _event_error ? _event_error : '') || 'WebSocket error';
             }
             null === (_this_onerror = (_this = this).onerror) || void 0 === _this_onerror || _this_onerror.call(_this, error, event);
         });
@@ -4627,7 +4648,7 @@ class WebSocketAPI {
 // EXTERNAL MODULE: os (ignored)
 var os_ignored_ = __webpack_require__("?9050");
 var os_ignored_default = /*#__PURE__*/ __webpack_require__.n(os_ignored_);
-var package_namespaceObject = JSON.parse('{"name":"@coze/api","version":"1.1.0","description":"Official Coze Node.js SDK for seamless AI integration into your applications | 扣子官方 Node.js SDK，助您轻松集成 AI 能力到应用中","keywords":["coze","ai","nodejs","sdk","chatbot","typescript"],"homepage":"https://github.com/coze-dev/coze-js/tree/main/packages/coze-js","bugs":{"url":"https://github.com/coze-dev/coze-js/issues"},"repository":{"type":"git","url":"https://github.com/coze-dev/coze-js.git","directory":"packages/coze-js"},"license":"MIT","author":"Leeight <leeight@gmail.com>","type":"module","exports":{".":"./src/index.ts","./ws-tools":"./src/ws-tools/index.ts"},"main":"src/index.ts","module":"src/index.ts","browser":{"crypto":false,"os":false,"jsonwebtoken":false,"node-fetch":false},"typesVersions":{"*":{".":["dist/types/index.d.ts"],"ws-tools":["dist/types/ws-tools/ws-tools/index.d.ts"]}},"files":["dist","LICENSE","README.md","README.zh-CN.md"],"scripts":{"build":"rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","start":"rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2","node-fetch":"^2.x","reconnecting-websocket":"^4.4.0","uuid":"^10.0.0","ws":"^8.11.0"},"devDependencies":{"@coze-infra/eslint-config":"workspace:*","@coze-infra/ts-config":"workspace:*","@coze-infra/vitest-config":"workspace:*","@rslib/core":"0.0.18","@swc/core":"^1.3.14","@types/jsonwebtoken":"^9.0.0","@types/node":"^20","@types/node-fetch":"^2.x","@types/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@types/ws":"^8.5.1","@vitest/coverage-v8":"~2.1.4","axios":"^1.7.7","typescript":"^5.5.3","vitest":"~2.1.4"},"peerDependencies":{"axios":"^1.7.1"},"cozePublishConfig":{"exports":{".":{"require":"./dist/cjs/index.cjs","import":"./dist/esm/index.js","types":"./dist/types/index.d.ts"},"./ws-tools":{"require":"./dist/cjs/ws-tools/index.cjs","import":"./dist/esm/ws-tools/index.js","types":"./dist/types/ws-tools/ws-tools/index.d.ts"}},"main":"dist/cjs/index.cjs","module":"dist/esm/index.js","types":"dist/types/index.d.ts"}}'); // CONCATENATED MODULE: ../coze-js/src/version.ts
+var package_namespaceObject = JSON.parse('{"name":"@coze/api","version":"1.1.1-beta.1","description":"Official Coze Node.js SDK for seamless AI integration into your applications | 扣子官方 Node.js SDK，助您轻松集成 AI 能力到应用中","keywords":["coze","ai","nodejs","sdk","chatbot","typescript"],"homepage":"https://github.com/coze-dev/coze-js/tree/main/packages/coze-js","bugs":{"url":"https://github.com/coze-dev/coze-js/issues"},"repository":{"type":"git","url":"https://github.com/coze-dev/coze-js.git","directory":"packages/coze-js"},"license":"MIT","author":"Leeight <leeight@gmail.com>","exports":{".":"./src/index.ts","./ws-tools":"./src/ws-tools/index.ts"},"main":"src/index.ts","module":"src/index.ts","browser":{"crypto":false,"os":false,"jsonwebtoken":false,"node-fetch":false},"typesVersions":{"*":{".":["dist/types/index.d.ts"],"ws-tools":["dist/types/ws-tools/ws-tools/index.d.ts"]}},"files":["dist","LICENSE","README.md","README.zh-CN.md"],"scripts":{"build":"rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","start":"rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2","node-fetch":"^2.x","reconnecting-websocket":"^4.4.0","uuid":"^10.0.0","ws":"^8.11.0"},"devDependencies":{"@coze-infra/eslint-config":"workspace:*","@coze-infra/ts-config":"workspace:*","@coze-infra/vitest-config":"workspace:*","@rslib/core":"0.0.18","@swc/core":"^1.3.14","@types/jsonwebtoken":"^9.0.0","@types/node":"^20","@types/node-fetch":"^2.x","@types/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@types/ws":"^8.5.1","@vitest/coverage-v8":"~2.1.4","axios":"^1.7.7","typescript":"^5.5.3","vitest":"~2.1.4"},"peerDependencies":{"axios":"^1.7.1"},"cozePublishConfig":{"exports":{".":{"require":"./dist/cjs/index.js","import":"./dist/esm/index.mjs","types":"./dist/types/index.d.ts"},"./ws-tools":{"require":"./dist/cjs/ws-tools/index.js","import":"./dist/esm/ws-tools/index.mjs","types":"./dist/types/ws-tools/ws-tools/index.d.ts"}},"main":"dist/cjs/index.js","module":"dist/esm/index.mjs","types":"dist/types/index.d.ts"}}'); // CONCATENATED MODULE: ../coze-js/src/version.ts
 const { version: version_version } = package_namespaceObject;
 const getEnv = ()=>{
     const nodeVersion = process.version.slice(1); // Remove 'v' prefix
@@ -39431,34 +39452,7 @@ const isScreenShareDevice = (deviceId)=>'screenShare' === deviceId;
     var _navigator_mediaDevices, _navigator;
     return !!(null === (_navigator = navigator) || void 0 === _navigator ? void 0 : null === (_navigator_mediaDevices = _navigator.mediaDevices) || void 0 === _navigator_mediaDevices ? void 0 : _navigator_mediaDevices.getDisplayMedia);
 }
-var error_RealtimeError = /*#__PURE__*/ function(RealtimeError) {
-    RealtimeError["DEVICE_ACCESS_ERROR"] = "DEVICE_ACCESS_ERROR";
-    RealtimeError["STREAM_CREATION_ERROR"] = "STREAM_CREATION_ERROR";
-    RealtimeError["CONNECTION_ERROR"] = "CONNECTION_ERROR";
-    RealtimeError["DISCONNECTION_ERROR"] = "DISCONNECTION_ERROR";
-    RealtimeError["INTERRUPT_ERROR"] = "INTERRUPT_ERROR";
-    RealtimeError["EVENT_HANDLER_ERROR"] = "EVENT_HANDLER_ERROR";
-    RealtimeError["PERMISSION_DENIED"] = "PERMISSION_DENIED";
-    RealtimeError["NETWORK_ERROR"] = "NETWORK_ERROR";
-    RealtimeError["INVALID_STATE"] = "INVALID_STATE";
-    RealtimeError["CREATE_ROOM_ERROR"] = "CREATE_ROOM_ERROR";
-    RealtimeError["PARSE_MESSAGE_ERROR"] = "PARSE_MESSAGE_ERROR";
-    RealtimeError["HANDLER_MESSAGE_ERROR"] = "HANDLER_MESSAGE_ERROR";
-    return RealtimeError;
-}({});
-class RealtimeAPIError extends Error {
-    /**
-   * @param code - Error code
-   * @param message - Error message
-   * @param error - Error object
-   */ constructor(code, message, error){
-        super(`[${code}] ${message}`);
-        this.name = 'RealtimeAPIError';
-        this.code = code;
-        this.error = error;
-    }
-}
-var event_handler_EventNames = /*#__PURE__*/ function(EventNames) {
+var event_names_EventNames = /*#__PURE__*/ function(EventNames) {
     /**
    * en: All events
    * zh: 所有事件
@@ -39476,6 +39470,10 @@ var event_handler_EventNames = /*#__PURE__*/ function(EventNames) {
    * zh: 客户端连接
    */ EventNames["CONNECTED"] = "client.connected";
     /**
+   * en: Client connecting
+   * zh: 客户端连接中
+   */ EventNames["CONNECTING"] = "client.connecting";
+    /**
    * en: Client interrupted
    * zh: 客户端中断
    */ EventNames["INTERRUPTED"] = "client.interrupted";
@@ -39528,6 +39526,10 @@ var event_handler_EventNames = /*#__PURE__*/ function(EventNames) {
    * zh: 视频输入设备改变
    */ EventNames["VIDEO_INPUT_DEVICE_CHANGED"] = "client.video.input.device.changed";
     /**
+   * en: Network quality changed
+   * zh: 网络质量改变
+   */ EventNames["NETWORK_QUALITY"] = "client.network.quality";
+    /**
    * en: Bot joined
    * zh: Bot 加入
    */ EventNames["BOT_JOIN"] = "server.bot.join";
@@ -39542,7 +39544,7 @@ var event_handler_EventNames = /*#__PURE__*/ function(EventNames) {
     /**
    * en: Audio speech stopped
    * zh: 停止说话
-   */ EventNames["AUDIO_SPEECH_STOPPED"] = "server.audio.speech_stopped";
+   */ EventNames["AUDIO_AGENT_SPEECH_STOPPED"] = "server.audio.agent.speech_stopped";
     /**
    * en: Server error
    * zh: 服务端错误
@@ -39565,6 +39567,33 @@ var event_handler_EventNames = /*#__PURE__*/ function(EventNames) {
    */ EventNames["SESSION_UPDATE"] = "server.session.update";
     return EventNames;
 }({});
+var error_RealtimeError = /*#__PURE__*/ function(RealtimeError) {
+    RealtimeError["DEVICE_ACCESS_ERROR"] = "DEVICE_ACCESS_ERROR";
+    RealtimeError["STREAM_CREATION_ERROR"] = "STREAM_CREATION_ERROR";
+    RealtimeError["CONNECTION_ERROR"] = "CONNECTION_ERROR";
+    RealtimeError["DISCONNECTION_ERROR"] = "DISCONNECTION_ERROR";
+    RealtimeError["INTERRUPT_ERROR"] = "INTERRUPT_ERROR";
+    RealtimeError["EVENT_HANDLER_ERROR"] = "EVENT_HANDLER_ERROR";
+    RealtimeError["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    RealtimeError["NETWORK_ERROR"] = "NETWORK_ERROR";
+    RealtimeError["INVALID_STATE"] = "INVALID_STATE";
+    RealtimeError["CREATE_ROOM_ERROR"] = "CREATE_ROOM_ERROR";
+    RealtimeError["PARSE_MESSAGE_ERROR"] = "PARSE_MESSAGE_ERROR";
+    RealtimeError["HANDLER_MESSAGE_ERROR"] = "HANDLER_MESSAGE_ERROR";
+    return RealtimeError;
+}({});
+class RealtimeAPIError extends Error {
+    /**
+   * @param code - Error code
+   * @param message - Error message
+   * @param error - Error object
+   */ constructor(code, message, error){
+        super(`[${code}] ${message}`);
+        this.name = 'RealtimeAPIError';
+        this.code = code;
+        this.error = error;
+    }
+}
 class RealtimeEventHandler {
     clearEventHandlers() {
         this.eventHandlers = {};
@@ -39580,7 +39609,10 @@ class RealtimeEventHandler {
         const handlers = this.eventHandlers[eventName] || [];
         if (callback) {
             const index = handlers.indexOf(callback);
-            if (-1 === index) throw new RealtimeAPIError(error_RealtimeError.EVENT_HANDLER_ERROR, `Could not turn off specified event listener for "${eventName}": not found as a listener`);
+            if (-1 === index) {
+                console.warn(`Could not turn off specified event listener for "${eventName}": not found as a listener`);
+                return;
+            }
             handlers.splice(index, 1);
         } else delete this.eventHandlers[eventName];
     }
@@ -39594,18 +39626,18 @@ class RealtimeEventHandler {
     }
     dispatch(eventName, event) {
         let consoleLog = !(arguments.length > 2) || void 0 === arguments[2] || arguments[2];
-        if (consoleLog) this._log(`dispatch ${eventName} event`);
+        if (consoleLog) this._log(`dispatch ${eventName} event`, event);
         const handlers = (this.eventHandlers[eventName] || []).slice();
         this._dispatchToHandlers(eventName, event, handlers);
-        const allHandlers = (this.eventHandlers["realtime.event"] || []).slice();
+        const allHandlers = (this.eventHandlers[event_names_EventNames.ALL] || []).slice();
         this._dispatchToHandlers(eventName, event, allHandlers);
-        const allClientHandlers = (this.eventHandlers["client.*"] || []).slice();
+        const allClientHandlers = (this.eventHandlers[event_names_EventNames.ALL_CLIENT] || []).slice();
         this._dispatchToHandlers(eventName, event, allClientHandlers, 'client.');
-        const allServerHandlers = (this.eventHandlers["server.*"] || []).slice();
+        const allServerHandlers = (this.eventHandlers[event_names_EventNames.ALL_SERVER] || []).slice();
         this._dispatchToHandlers(eventName, event, allServerHandlers, 'server.');
     }
-    _log(message) {
-        if (this._debug) console.log(`[RealtimeClient] ${message}`);
+    _log(message, event) {
+        if (this._debug) console.log(`[RealtimeClient] ${message}`, event);
     }
     constructor(debug = false){
         this.eventHandlers = {};
@@ -42863,6 +42895,7 @@ class EngineClient extends RealtimeEventHandler {
         this.engine.on(index_esm_min_index.events.onUserJoined, this.handleUserJoin);
         this.engine.on(index_esm_min_index.events.onUserLeave, this.handleUserLeave);
         this.engine.on(index_esm_min_index.events.onError, this.handleEventError);
+        this.engine.on(index_esm_min_index.events.onNetworkQuality, this.handleNetworkQuality);
         if (this._isSupportVideo) this.engine.on(index_esm_min_index.events.onPlayerEvent, this.handlePlayerEvent);
         if (this._debug) {
             this.engine.on(index_esm_min_index.events.onLocalAudioPropertiesReport, this.handleLocalAudioPropertiesReport);
@@ -42874,6 +42907,7 @@ class EngineClient extends RealtimeEventHandler {
         this.engine.off(index_esm_min_index.events.onUserJoined, this.handleUserJoin);
         this.engine.off(index_esm_min_index.events.onUserLeave, this.handleUserLeave);
         this.engine.off(index_esm_min_index.events.onError, this.handleEventError);
+        this.engine.off(index_esm_min_index.events.onNetworkQuality, this.handleNetworkQuality);
         if (this._isSupportVideo) this.engine.off(index_esm_min_index.events.onPlayerEvent, this.handlePlayerEvent);
         if (this._debug) {
             this.engine.off(index_esm_min_index.events.onLocalAudioPropertiesReport, this.handleLocalAudioPropertiesReport);
@@ -42894,29 +42928,35 @@ class EngineClient extends RealtimeEventHandler {
             this.dispatch(`server.${message.event_type}`, message);
         } catch (e) {
             if (e instanceof RealtimeAPIError) {
-                if (e.code === error_RealtimeError.PARSE_MESSAGE_ERROR) this.dispatch(event_handler_EventNames.ERROR, {
+                if (e.code === error_RealtimeError.PARSE_MESSAGE_ERROR) this.dispatch(event_names_EventNames.ERROR, {
                     message: `Failed to parse message: ${event.message}`,
                     error: e
                 });
-                else if (e.code === error_RealtimeError.HANDLER_MESSAGE_ERROR) this.dispatch(event_handler_EventNames.ERROR, {
+                else if (e.code === error_RealtimeError.HANDLER_MESSAGE_ERROR) this.dispatch(event_names_EventNames.ERROR, {
                     message: `Failed to handle message: ${event.message}`,
                     error: e
                 });
-            } else this.dispatch(event_handler_EventNames.ERROR, e);
+            } else this.dispatch(event_names_EventNames.ERROR, e);
         }
     }
     handleEventError(e) {
-        this.dispatch(event_handler_EventNames.ERROR, e);
+        this.dispatch(event_names_EventNames.ERROR, e);
     }
     handleUserJoin(event) {
         this.joinUserId = event.userInfo.userId;
-        this.dispatch(event_handler_EventNames.BOT_JOIN, event);
+        this.dispatch(event_names_EventNames.BOT_JOIN, event);
     }
     handleUserLeave(event) {
-        this.dispatch(event_handler_EventNames.BOT_LEAVE, event);
+        this.dispatch(event_names_EventNames.BOT_LEAVE, event);
     }
     handlePlayerEvent(event) {
-        this.dispatch(event_handler_EventNames.PLAYER_EVENT, event);
+        this.dispatch(event_names_EventNames.PLAYER_EVENT, event);
+    }
+    handleNetworkQuality(uplinkNetworkQuality, downlinkNetworkQuality) {
+        this.dispatch(event_names_EventNames.NETWORK_QUALITY, {
+            uplinkNetworkQuality,
+            downlinkNetworkQuality
+        });
     }
     async joinRoom(options) {
         const { token, roomId, uid, audioMutedDefault, videoOnDefault, isAutoSubscribeAudio } = options;
@@ -42984,13 +43024,12 @@ class EngineClient extends RealtimeEventHandler {
     }
     async disconnect() {
         try {
-            if (this._isSupportVideo) await this.changeVideoState(false);
-            await this.changeAudioState(false);
-            await this.engine.unpublishStream(MediaType$1.AUDIO);
             await this.engine.leaveRoom();
             this.removeEventListener();
+            this.clearEventHandlers();
+            index_esm_min_index.destroyEngine(this.engine);
         } catch (e) {
-            this.dispatch(event_handler_EventNames.ERROR, e);
+            this.dispatch(event_names_EventNames.ERROR, e);
             throw e;
         }
     }
@@ -42999,7 +43038,7 @@ class EngineClient extends RealtimeEventHandler {
             if (isMicOn) await this.engine.publishStream(MediaType$1.AUDIO);
             else await this.engine.unpublishStream(MediaType$1.AUDIO);
         } catch (e) {
-            this.dispatch(event_handler_EventNames.ERROR, e);
+            this.dispatch(event_names_EventNames.ERROR, e);
             throw e;
         }
     }
@@ -43019,7 +43058,7 @@ class EngineClient extends RealtimeEventHandler {
                 await this.engine.unpublishScreen(MediaType$1.VIDEO);
             }
         } catch (e) {
-            this.dispatch(event_handler_EventNames.ERROR, e);
+            this.dispatch(event_names_EventNames.ERROR, e);
             throw e;
         }
     }
@@ -43032,7 +43071,7 @@ class EngineClient extends RealtimeEventHandler {
             }));
             this._log(`interrupt ${this.joinUserId} ${result}`);
         } catch (e) {
-            this.dispatch(event_handler_EventNames.ERROR, e);
+            this.dispatch(event_names_EventNames.ERROR, e);
             throw e;
         }
     }
@@ -43041,7 +43080,7 @@ class EngineClient extends RealtimeEventHandler {
             const result = await this.engine.sendUserMessage(this.joinUserId, JSON.stringify(message));
             this._log(`sendMessage ${this.joinUserId} ${JSON.stringify(message)} ${result}`);
         } catch (e) {
-            this.dispatch(event_handler_EventNames.ERROR, e);
+            this.dispatch(event_names_EventNames.ERROR, e);
             throw e;
         }
     }
@@ -43082,7 +43121,7 @@ class EngineClient extends RealtimeEventHandler {
         try {
             await this.engine.startAudioPlaybackDeviceTest('audio-test.wav', 200);
         } catch (e) {
-            this.dispatch(event_handler_EventNames.ERROR, e);
+            this.dispatch(event_names_EventNames.ERROR, e);
             throw e;
         }
     }
@@ -43090,7 +43129,7 @@ class EngineClient extends RealtimeEventHandler {
         try {
             this.engine.stopAudioPlaybackDeviceTest();
         } catch (e) {
-            this.dispatch(event_handler_EventNames.ERROR, e);
+            this.dispatch(event_names_EventNames.ERROR, e);
             throw e;
         }
     }
@@ -43109,6 +43148,7 @@ class EngineClient extends RealtimeEventHandler {
         this.handleUserLeave = this.handleUserLeave.bind(this);
         this.handleEventError = this.handleEventError.bind(this);
         this.handlePlayerEvent = this.handlePlayerEvent.bind(this);
+        this.handleNetworkQuality = this.handleNetworkQuality.bind(this);
         // Debug only
         this.handleLocalAudioPropertiesReport = this.handleLocalAudioPropertiesReport.bind(this);
         this.handleRemoteAudioPropertiesReport = this.handleRemoteAudioPropertiesReport.bind(this);
@@ -43116,6 +43156,8 @@ class EngineClient extends RealtimeEventHandler {
         this._videoConfig = videoConfig;
     }
 }
+// Only use for test
+const TEST_APP_ID = '6705332c79516e015e3e5f0c';
 class RealtimeClient extends RealtimeEventHandler {
     /**
    * en: Establish a connection to the Coze API and join the room
@@ -43123,48 +43165,55 @@ class RealtimeClient extends RealtimeEventHandler {
    * zh: 建立与 Coze API 的连接并加入房间
    */ async connect() {
         var _this__config_videoConfig;
-        const { botId, conversationId, voiceId } = this._config;
+        const { botId, conversationId, voiceId, getRoomInfo } = this._config;
+        this.dispatch(event_names_EventNames.CONNECTING, {});
         let roomInfo;
         try {
             // Step1 get token
-            let config;
-            if (this._config.videoConfig) config = isScreenShareDevice(this._config.videoConfig.videoInputDeviceId) ? {
-                video_config: {
-                    stream_video_type: 'screen'
-                }
-            } : {
-                video_config: {
-                    stream_video_type: 'main'
-                }
-            };
-            roomInfo = await this._api.audio.rooms.create({
-                bot_id: botId,
-                conversation_id: conversationId || void 0,
-                voice_id: voiceId && voiceId.length > 0 ? voiceId : void 0,
-                connector_id: this._config.connectorId,
-                uid: this._config.userId || void 0,
-                workflow_id: this._config.workflowId || void 0,
-                config
-            });
+            if (getRoomInfo) roomInfo = await getRoomInfo();
+            else {
+                let config;
+                if (this._config.videoConfig) config = isScreenShareDevice(this._config.videoConfig.videoInputDeviceId) ? {
+                    video_config: {
+                        stream_video_type: 'screen'
+                    }
+                } : {
+                    video_config: {
+                        stream_video_type: 'main'
+                    }
+                };
+                roomInfo = await this._api.audio.rooms.create({
+                    bot_id: botId,
+                    conversation_id: conversationId || void 0,
+                    voice_id: voiceId && voiceId.length > 0 ? voiceId : void 0,
+                    connector_id: this._config.connectorId,
+                    uid: this._config.userId || void 0,
+                    workflow_id: this._config.workflowId || void 0,
+                    config
+                });
+            }
         } catch (error) {
-            this.dispatch(event_handler_EventNames.ERROR, error);
+            this.dispatch(event_names_EventNames.ERROR, error);
             throw new RealtimeAPIError(error_RealtimeError.CREATE_ROOM_ERROR, error instanceof Error ? error.message : 'Unknown error', error);
         }
+        this._isTestEnv = TEST_APP_ID === roomInfo.app_id;
         // Step2 create engine
         this._client = new EngineClient(roomInfo.app_id, this._config.debug, this._isTestEnv, this._isSupportVideo, this._config.videoConfig);
         // Step3 bind engine events
         this._client.bindEngineEvents();
-        this._client.on(event_handler_EventNames.ALL, (eventName, data)=>{
+        this._client.on(event_names_EventNames.ALL, (eventName, data)=>{
             this.dispatch(eventName, data, false);
         });
         if (this._config.suppressStationaryNoise) {
             await this._client.enableAudioNoiseReduction();
-            this.dispatch(event_handler_EventNames.SUPPRESS_STATIONARY_NOISE, {});
+            this.dispatch(event_names_EventNames.SUPPRESS_STATIONARY_NOISE, {});
         }
-        if (this._config.suppressNonStationaryNoise) {
+        if (this._config.suppressNonStationaryNoise) try {
             await this._client.initAIAnsExtension();
             this._client.changeAIAnsExtension(true);
-            this.dispatch(event_handler_EventNames.SUPPRESS_NON_STATIONARY_NOISE, {});
+            this.dispatch(event_names_EventNames.SUPPRESS_NON_STATIONARY_NOISE, {});
+        } catch (error) {
+            console.warn('Config suppressNonStationaryNoise is not supported', error);
         }
         var _this__config_audioMutedDefault, _this__config_videoConfig_videoOnDefault, _this__config_isAutoSubscribeAudio;
         // Step4 join room
@@ -43180,7 +43229,7 @@ class RealtimeClient extends RealtimeEventHandler {
         await this._client.createLocalStream(roomInfo.uid, this._config.videoConfig);
         // step6 set connected and dispatch connected event
         this.isConnected = true;
-        this.dispatch(event_handler_EventNames.CONNECTED, {
+        this.dispatch(event_names_EventNames.CONNECTED, {
             roomId: roomInfo.room_id,
             uid: roomInfo.uid,
             token: roomInfo.token,
@@ -43194,7 +43243,7 @@ class RealtimeClient extends RealtimeEventHandler {
    */ async interrupt() {
         var _this__client;
         await (null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.stop());
-        this.dispatch(event_handler_EventNames.INTERRUPTED, {});
+        this.dispatch(event_names_EventNames.INTERRUPTED, {});
     }
     /**
    * en: Disconnect from the current session
@@ -43204,7 +43253,8 @@ class RealtimeClient extends RealtimeEventHandler {
         var _this__client;
         await (null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.disconnect());
         this.isConnected = false;
-        this.dispatch(event_handler_EventNames.DISCONNECTED, {});
+        this._client = null;
+        this.dispatch(event_names_EventNames.DISCONNECTED, {});
     }
     /**
    * en: Send a message to the bot
@@ -43223,14 +43273,14 @@ class RealtimeClient extends RealtimeEventHandler {
    */ async setAudioEnable(isEnable) {
         var _this__client;
         await (null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.changeAudioState(isEnable));
-        if (isEnable) this.dispatch(event_handler_EventNames.AUDIO_UNMUTED, {});
-        else this.dispatch(event_handler_EventNames.AUDIO_MUTED, {});
+        if (isEnable) this.dispatch(event_names_EventNames.AUDIO_UNMUTED, {});
+        else this.dispatch(event_names_EventNames.AUDIO_MUTED, {});
     }
     async setVideoEnable(isEnable) {
         var _this__client;
         await (null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.changeVideoState(isEnable));
-        if (isEnable) this.dispatch(event_handler_EventNames.VIDEO_ON, {});
-        else this.dispatch(event_handler_EventNames.VIDEO_OFF, {});
+        if (isEnable) this.dispatch(event_names_EventNames.VIDEO_ON, {});
+        else this.dispatch(event_names_EventNames.VIDEO_OFF, {});
     }
     /**
    * en: Enable audio properties reporting (debug mode only)
@@ -43272,7 +43322,7 @@ class RealtimeClient extends RealtimeEventHandler {
    */ async setAudioInputDevice(deviceId) {
         var _this__client;
         await (null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.setAudioInputDevice(deviceId));
-        this.dispatch(event_handler_EventNames.AUDIO_INPUT_DEVICE_CHANGED, {
+        this.dispatch(event_names_EventNames.AUDIO_INPUT_DEVICE_CHANGED, {
             deviceId
         });
     }
@@ -43283,14 +43333,14 @@ class RealtimeClient extends RealtimeEventHandler {
    */ async setAudioOutputDevice(deviceId) {
         var _this__client;
         await (null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.setAudioOutputDevice(deviceId));
-        this.dispatch(event_handler_EventNames.AUDIO_OUTPUT_DEVICE_CHANGED, {
+        this.dispatch(event_names_EventNames.AUDIO_OUTPUT_DEVICE_CHANGED, {
             deviceId
         });
     }
     async setVideoInputDevice(deviceId) {
         var _this__client;
         await (null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.setVideoInputDevice(deviceId));
-        this.dispatch(event_handler_EventNames.VIDEO_INPUT_DEVICE_CHANGED, {
+        this.dispatch(event_names_EventNames.VIDEO_INPUT_DEVICE_CHANGED, {
             deviceId
         });
     }
@@ -43356,8 +43406,7 @@ class RealtimeClient extends RealtimeEventHandler {
             baseURL: defaultBaseURL,
             allowPersonalAccessTokenInBrowser: this._config.allowPersonalAccessTokenInBrowser
         });
-        this._isTestEnv = 'https://api.coze.cn' !== defaultBaseURL;
         this._isSupportVideo = !!config.videoConfig;
     }
 }
-export { event_handler_EventNames as EventNames, RealtimeAPIError, RealtimeClient, error_RealtimeError as RealtimeError, src_utils_namespaceObject as RealtimeUtils };
+export { event_names_EventNames as EventNames, RealtimeAPIError, RealtimeClient, error_RealtimeError as RealtimeError, src_utils_namespaceObject as RealtimeUtils };

package/dist/types/client.d.ts

@@ -1,4 +1,4 @@
-import { type AudioPropertiesConfig, type IRTCEngine, type onUserJoinedEvent, type onUserLeaveEvent, type UserMessageEvent } from '@volcengine/rtc';
+import { type AudioPropertiesConfig, type IRTCEngine, type NetworkQuality, type onUserJoinedEvent, type onUserLeaveEvent, type UserMessageEvent } from '@volcengine/rtc';
 import { RealtimeEventHandler } from './event-handler';
 import { type VideoConfig } from '.';
 export declare class EngineClient extends RealtimeEventHandler {
@@ -18,6 +18,7 @@ export declare class EngineClient extends RealtimeEventHandler {
     handleUserJoin(event: onUserJoinedEvent): void;
     handleUserLeave(event: onUserLeaveEvent): void;
     handlePlayerEvent(event: unknown): void;
+    handleNetworkQuality(uplinkNetworkQuality: NetworkQuality, downlinkNetworkQuality: NetworkQuality): void;
     joinRoom(options: {
         token: string;
         roomId: string;