@coze/realtime-api 1.0.4-alpha.aea086 → 1.0.4-beta.2

package/README.md

@@ -83,7 +83,9 @@ const operations = {
   disconnect: () => client.disconnect(),
   interrupt: () => client.interrupt(),
   toggleMicrophone: (enabled: boolean) => client.setAudioEnable(enabled),
-  checkConnection: () => client.isConnected
+  checkConnection: () => client.isConnected,
+  // get rtc engine instance, for detail visit https://www.volcengine.com/docs/6348/104478#rtcengine
+  getRtcEngine: () => client.getRtcEngine(),
 };
 
 // Event Handling

package/README.zh-CN.md

@@ -79,7 +79,9 @@ const operations = {
   disconnect: () => client.disconnect(),
   interrupt: () => client.interrupt(),
   toggleMicrophone: (enabled: boolean) => client.setAudioEnable(enabled),
-  checkConnection: () => client.isConnected
+  checkConnection: () => client.isConnected,
+  // 获取 RTC 引擎实例，详情请访问  https://www.volcengine.com/docs/6348/104478#rtcengine
+  getRtcEngine: () => client.getRtcEngine(),
 };
 
 // 事件处理

package/dist/cjs/index.cjs

@@ -3841,6 +3841,8 @@ class Voices extends APIResource {
    * | 如果传入会基于该文本生成预览音频，否则使用默认的文本
    * @param params.text - Optional. Users can read this text, service will compare audio with text. Returns error if difference is too large
    * | 可以让用户按照该文本念诵，服务会对比音频与该文本的差异。若差异过大会返回错误
+   * @param params.space_id - Optional.  The space id of the voice. | 空间ID
+   * @param params.description- Optional. The description of the voice. | 音色描述
    * @param options - Request options
    * @returns Clone voice data
    */ async clone(params, options) {
@@ -3865,6 +3867,17 @@ class Voices extends APIResource {
         return response.data;
     }
 }
+class Transcriptions extends APIResource {
+    /**
+   * ASR voice to text | ASR 语音转文本
+   * @param params - Required The parameters for file upload | 上传文件所需的参数
+   * @param params.file - Required The audio file to be uploaded. | 需要上传的音频文件。
+   */ async create(params, options) {
+        const apiUrl = '/v1/audio/transcriptions';
+        const response = await this._client.post(apiUrl, axios_toFormData(params), false, options);
+        return response.data;
+    }
+}
 class Speech extends APIResource {
     /**
    * @description Speech synthesis | 语音合成
@@ -3896,7 +3909,7 @@ class Rooms extends APIResource {
 }
 class audio_Audio extends APIResource {
     constructor(...args){
-        super(...args), this.rooms = new Rooms(this._client), this.voices = new Voices(this._client), this.speech = new Speech(this._client);
+        super(...args), this.rooms = new Rooms(this._client), this.voices = new Voices(this._client), this.speech = new Speech(this._client), this.transcriptions = new Transcriptions(this._client);
     }
 }
 class Templates extends APIResource {
@@ -3916,7 +3929,7 @@ class Templates extends APIResource {
 // 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.0.16-alpha.aea086","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"},"main":"src/index.ts","module":"src/index.ts","browser":{"crypto":false,"os":false,"jsonwebtoken":false},"types":"src/index.ts","files":["dist","LICENSE","README.md","README.zh-CN.md"],"scripts":{"build":"rm -rf dist && rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","start":"rm -rf dist && rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2"},"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/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@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"}},"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.0.16","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"},"main":"src/index.ts","module":"src/index.ts","browser":{"crypto":false,"os":false,"jsonwebtoken":false},"types":"src/index.ts","files":["dist","LICENSE","README.md","README.zh-CN.md"],"scripts":{"build":"rm -rf dist && rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","start":"rm -rf dist && rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2"},"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/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@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"}},"main":"dist/cjs/index.cjs","module":"dist/esm/index.js","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
@@ -4121,6 +4134,8 @@ function isAxiosStatic(instance) {
         }
         const config = mergeConfig(this.axiosOptions, options, {
             headers
+        }, {
+            headers: this.headers || {}
         });
         config.method = method;
         config.data = body;
@@ -4131,11 +4146,11 @@ function isAxiosStatic(instance) {
         const fetchOptions = await this.buildOptions(method, body, options);
         fetchOptions.isStreaming = isStream;
         fetchOptions.axiosInstance = this.axiosInstance;
-        this.debugLog(`--- request url: ${fullUrl}`);
-        this.debugLog('--- request options:', fetchOptions);
+        this.debugLog(null == options ? void 0 : options.debug, `--- request url: ${fullUrl}`);
+        this.debugLog(null == options ? void 0 : options.debug, '--- request options:', fetchOptions);
         const { response, stream, json } = await fetchAPI(fullUrl, fetchOptions);
-        this.debugLog(`--- response status: ${response.status}`);
-        this.debugLog('--- response headers: ', response.headers);
+        this.debugLog(null == options ? void 0 : options.debug, `--- response status: ${response.status}`);
+        this.debugLog(null == options ? void 0 : options.debug, '--- response headers: ', response.headers);
         var _response_headers;
         // Taro use `header`
         const contentType = (null !== (_response_headers = response.headers) && void 0 !== _response_headers ? _response_headers : response.header)['content-type'];
@@ -4178,8 +4193,9 @@ function isAxiosStatic(instance) {
     }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     debugLog() {
-        for(var _len = arguments.length, msgs = new Array(_len), _key = 0; _key < _len; _key++)msgs[_key] = arguments[_key];
-        if (this.debug) console.debug(...msgs);
+        let forceDebug = arguments.length > 0 && void 0 !== arguments[0] && arguments[0];
+        for(var _len = arguments.length, msgs = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++)msgs[_key - 1] = arguments[_key];
+        if (this.debug || forceDebug) console.debug(...msgs);
     }
     constructor(config){
         this._config = config;
@@ -42328,6 +42344,9 @@ class EngineClient extends RealtimeEventHandler {
             throw e;
         }
     }
+    getRtcEngine() {
+        return this.engine;
+    }
     // eslint-disable-next-line max-params
     constructor(appId, debug = false, isTestEnv = false, isSupportVideo = false, videoConfig){
         super(debug), this.joinUserId = '', this._AIAnsExtension = null, this._isSupportVideo = false;
@@ -42360,9 +42379,10 @@ class RealtimeClient extends RealtimeEventHandler {
             // Step1 get token
             roomInfo = await this._api.audio.rooms.create({
                 bot_id: botId,
-                conversation_id: conversationId,
+                conversation_id: conversationId || void 0,
                 voice_id: voiceId && voiceId.length > 0 ? voiceId : void 0,
-                connector_id: this._config.connectorId
+                connector_id: this._config.connectorId,
+                uid: this._config.userId || void 0
             });
         } catch (error) {
             this.dispatch(event_handler_EventNames.ERROR, error);
@@ -42513,6 +42533,14 @@ class RealtimeClient extends RealtimeEventHandler {
         });
     }
     /**
+   * en: Get the RTC engine instance, for detail visit https://www.volcengine.com/docs/6348/104481
+   *
+   * zh: 获取 RTC 引擎实例，详情请访问 https://www.volcengine.com/docs/6348/104481
+   */ getRtcEngine() {
+        var _this__client;
+        return null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.getRtcEngine();
+    }
+    /**
    * Constructor for initializing a RealtimeClient instance.
    *
    * 构造函数，初始化RealtimeClient实例。
@@ -42526,6 +42554,8 @@ class RealtimeClient extends RealtimeEventHandler {
    *                         可选，音色Id。
    * @param config.conversationId - Optional, Conversation Id. |
    *                               可选，会话Id。
+   * @param config.userId - Optional, User Id. |
+   *                        可选，用户Id。
    * @param config.baseURL - Optional, defaults to "https://api.coze.cn". |
    *                        可选，默认值为 "https://api.coze.cn"。
    * @param config.debug - Optional, defaults to false.

package/dist/esm/index.js

@@ -3829,6 +3829,8 @@ class Voices extends APIResource {
    * | 如果传入会基于该文本生成预览音频，否则使用默认的文本
    * @param params.text - Optional. Users can read this text, service will compare audio with text. Returns error if difference is too large
    * | 可以让用户按照该文本念诵，服务会对比音频与该文本的差异。若差异过大会返回错误
+   * @param params.space_id - Optional.  The space id of the voice. | 空间ID
+   * @param params.description- Optional. The description of the voice. | 音色描述
    * @param options - Request options
    * @returns Clone voice data
    */ async clone(params, options) {
@@ -3853,6 +3855,17 @@ class Voices extends APIResource {
         return response.data;
     }
 }
+class Transcriptions extends APIResource {
+    /**
+   * ASR voice to text | ASR 语音转文本
+   * @param params - Required The parameters for file upload | 上传文件所需的参数
+   * @param params.file - Required The audio file to be uploaded. | 需要上传的音频文件。
+   */ async create(params, options) {
+        const apiUrl = '/v1/audio/transcriptions';
+        const response = await this._client.post(apiUrl, axios_toFormData(params), false, options);
+        return response.data;
+    }
+}
 class Speech extends APIResource {
     /**
    * @description Speech synthesis | 语音合成
@@ -3884,7 +3897,7 @@ class Rooms extends APIResource {
 }
 class audio_Audio extends APIResource {
     constructor(...args){
-        super(...args), this.rooms = new Rooms(this._client), this.voices = new Voices(this._client), this.speech = new Speech(this._client);
+        super(...args), this.rooms = new Rooms(this._client), this.voices = new Voices(this._client), this.speech = new Speech(this._client), this.transcriptions = new Transcriptions(this._client);
     }
 }
 class Templates extends APIResource {
@@ -3904,7 +3917,7 @@ class Templates extends APIResource {
 // 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.0.16-alpha.aea086","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"},"main":"src/index.ts","module":"src/index.ts","browser":{"crypto":false,"os":false,"jsonwebtoken":false},"types":"src/index.ts","files":["dist","LICENSE","README.md","README.zh-CN.md"],"scripts":{"build":"rm -rf dist && rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","start":"rm -rf dist && rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2"},"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/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@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"}},"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.0.16","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"},"main":"src/index.ts","module":"src/index.ts","browser":{"crypto":false,"os":false,"jsonwebtoken":false},"types":"src/index.ts","files":["dist","LICENSE","README.md","README.zh-CN.md"],"scripts":{"build":"rm -rf dist && rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","start":"rm -rf dist && rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2"},"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/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@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"}},"main":"dist/cjs/index.cjs","module":"dist/esm/index.js","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
@@ -4109,6 +4122,8 @@ function isAxiosStatic(instance) {
         }
         const config = mergeConfig(this.axiosOptions, options, {
             headers
+        }, {
+            headers: this.headers || {}
         });
         config.method = method;
         config.data = body;
@@ -4119,11 +4134,11 @@ function isAxiosStatic(instance) {
         const fetchOptions = await this.buildOptions(method, body, options);
         fetchOptions.isStreaming = isStream;
         fetchOptions.axiosInstance = this.axiosInstance;
-        this.debugLog(`--- request url: ${fullUrl}`);
-        this.debugLog('--- request options:', fetchOptions);
+        this.debugLog(null == options ? void 0 : options.debug, `--- request url: ${fullUrl}`);
+        this.debugLog(null == options ? void 0 : options.debug, '--- request options:', fetchOptions);
         const { response, stream, json } = await fetchAPI(fullUrl, fetchOptions);
-        this.debugLog(`--- response status: ${response.status}`);
-        this.debugLog('--- response headers: ', response.headers);
+        this.debugLog(null == options ? void 0 : options.debug, `--- response status: ${response.status}`);
+        this.debugLog(null == options ? void 0 : options.debug, '--- response headers: ', response.headers);
         var _response_headers;
         // Taro use `header`
         const contentType = (null !== (_response_headers = response.headers) && void 0 !== _response_headers ? _response_headers : response.header)['content-type'];
@@ -4166,8 +4181,9 @@ function isAxiosStatic(instance) {
     }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     debugLog() {
-        for(var _len = arguments.length, msgs = new Array(_len), _key = 0; _key < _len; _key++)msgs[_key] = arguments[_key];
-        if (this.debug) console.debug(...msgs);
+        let forceDebug = arguments.length > 0 && void 0 !== arguments[0] && arguments[0];
+        for(var _len = arguments.length, msgs = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++)msgs[_key - 1] = arguments[_key];
+        if (this.debug || forceDebug) console.debug(...msgs);
     }
     constructor(config){
         this._config = config;
@@ -42316,6 +42332,9 @@ class EngineClient extends RealtimeEventHandler {
             throw e;
         }
     }
+    getRtcEngine() {
+        return this.engine;
+    }
     // eslint-disable-next-line max-params
     constructor(appId, debug = false, isTestEnv = false, isSupportVideo = false, videoConfig){
         super(debug), this.joinUserId = '', this._AIAnsExtension = null, this._isSupportVideo = false;
@@ -42348,9 +42367,10 @@ class RealtimeClient extends RealtimeEventHandler {
             // Step1 get token
             roomInfo = await this._api.audio.rooms.create({
                 bot_id: botId,
-                conversation_id: conversationId,
+                conversation_id: conversationId || void 0,
                 voice_id: voiceId && voiceId.length > 0 ? voiceId : void 0,
-                connector_id: this._config.connectorId
+                connector_id: this._config.connectorId,
+                uid: this._config.userId || void 0
             });
         } catch (error) {
             this.dispatch(event_handler_EventNames.ERROR, error);
@@ -42501,6 +42521,14 @@ class RealtimeClient extends RealtimeEventHandler {
         });
     }
     /**
+   * en: Get the RTC engine instance, for detail visit https://www.volcengine.com/docs/6348/104481
+   *
+   * zh: 获取 RTC 引擎实例，详情请访问 https://www.volcengine.com/docs/6348/104481
+   */ getRtcEngine() {
+        var _this__client;
+        return null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.getRtcEngine();
+    }
+    /**
    * Constructor for initializing a RealtimeClient instance.
    *
    * 构造函数，初始化RealtimeClient实例。
@@ -42514,6 +42542,8 @@ class RealtimeClient extends RealtimeEventHandler {
    *                         可选，音色Id。
    * @param config.conversationId - Optional, Conversation Id. |
    *                               可选，会话Id。
+   * @param config.userId - Optional, User Id. |
+   *                        可选，用户Id。
    * @param config.baseURL - Optional, defaults to "https://api.coze.cn". |
    *                        可选，默认值为 "https://api.coze.cn"。
    * @param config.debug - Optional, defaults to false.

package/dist/types/client.d.ts

@@ -1,4 +1,4 @@
-import { type AudioPropertiesConfig, type onUserJoinedEvent, type onUserLeaveEvent, type UserMessageEvent } from '@volcengine/rtc';
+import { type AudioPropertiesConfig, type IRTCEngine, type onUserJoinedEvent, type onUserLeaveEvent, type UserMessageEvent } from '@volcengine/rtc';
 import { RealtimeEventHandler } from './event-handler';
 import { type VideoConfig } from '.';
 export declare class EngineClient extends RealtimeEventHandler {
@@ -43,4 +43,5 @@ export declare class EngineClient extends RealtimeEventHandler {
     changeAIAnsExtension(enable: boolean): void;
     startAudioPlaybackDeviceTest(): Promise<void>;
     stopAudioPlaybackDeviceTest(): void;
+    getRtcEngine(): IRTCEngine;
 }

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-import { type ScreenConfig, type AudioPropertiesConfig } from '@volcengine/rtc';
+import { type ScreenConfig, type AudioPropertiesConfig, type IRTCEngine } from '@volcengine/rtc';
 import { type GetToken } from '@coze/api';
 import * as RealtimeUtils from './utils';
 import { RealtimeEventHandler, EventNames } from './event-handler';
@@ -14,6 +14,7 @@ export interface RealtimeClientConfig {
     botId: string /** required, Bot Id */;
     voiceId?: string /** optional, Voice Id */;
     conversationId?: string /** optional, Conversation Id */;
+    userId?: string /** optional, User Id */;
     baseURL?: string /** optional, defaults to "https://api.coze.cn" */;
     debug?: boolean /** optional, defaults to false */;
     /** Whether Personal Access Tokens (PAT) are allowed in browser environments */
@@ -48,6 +49,8 @@ declare class RealtimeClient extends RealtimeEventHandler {
      *                         可选，音色Id。
      * @param config.conversationId - Optional, Conversation Id. |
      *                               可选，会话Id。
+     * @param config.userId - Optional, User Id. |
+     *                        可选，用户Id。
      * @param config.baseURL - Optional, defaults to "https://api.coze.cn". |
      *                        可选，默认值为 "https://api.coze.cn"。
      * @param config.debug - Optional, defaults to false.
@@ -138,5 +141,11 @@ declare class RealtimeClient extends RealtimeEventHandler {
      */
     setAudioOutputDevice(deviceId: string): Promise<void>;
     setVideoInputDevice(deviceId: string): Promise<void>;
+    /**
+     * en: Get the RTC engine instance, for detail visit https://www.volcengine.com/docs/6348/104481
+     *
+     * zh: 获取 RTC 引擎实例，详情请访问 https://www.volcengine.com/docs/6348/104481
+     */
+    getRtcEngine(): IRTCEngine | undefined;
 }
 export { RealtimeUtils, RealtimeClient, RealtimeAPIError, RealtimeError, EventNames, };

package/dist/umd/index.js

@@ -3847,6 +3847,8 @@
    * | 如果传入会基于该文本生成预览音频，否则使用默认的文本
    * @param params.text - Optional. Users can read this text, service will compare audio with text. Returns error if difference is too large
    * | 可以让用户按照该文本念诵，服务会对比音频与该文本的差异。若差异过大会返回错误
+   * @param params.space_id - Optional.  The space id of the voice. | 空间ID
+   * @param params.description- Optional. The description of the voice. | 音色描述
    * @param options - Request options
    * @returns Clone voice data
    */ async clone(params, options) {
@@ -3871,6 +3873,17 @@
                 return response.data;
             }
         }
+        class Transcriptions extends APIResource {
+            /**
+   * ASR voice to text | ASR 语音转文本
+   * @param params - Required The parameters for file upload | 上传文件所需的参数
+   * @param params.file - Required The audio file to be uploaded. | 需要上传的音频文件。
+   */ async create(params, options) {
+                const apiUrl = '/v1/audio/transcriptions';
+                const response = await this._client.post(apiUrl, axios_toFormData(params), false, options);
+                return response.data;
+            }
+        }
         class Speech extends APIResource {
             /**
    * @description Speech synthesis | 语音合成
@@ -3902,7 +3915,7 @@
         }
         class audio_Audio extends APIResource {
             constructor(...args){
-                super(...args), this.rooms = new Rooms(this._client), this.voices = new Voices(this._client), this.speech = new Speech(this._client);
+                super(...args), this.rooms = new Rooms(this._client), this.voices = new Voices(this._client), this.speech = new Speech(this._client), this.transcriptions = new Transcriptions(this._client);
             }
         }
         class Templates extends APIResource {
@@ -3922,7 +3935,7 @@
         // 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.0.16-alpha.aea086","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"},"main":"src/index.ts","module":"src/index.ts","browser":{"crypto":false,"os":false,"jsonwebtoken":false},"types":"src/index.ts","files":["dist","LICENSE","README.md","README.zh-CN.md"],"scripts":{"build":"rm -rf dist && rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","start":"rm -rf dist && rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2"},"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/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@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"}},"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.0.16","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"},"main":"src/index.ts","module":"src/index.ts","browser":{"crypto":false,"os":false,"jsonwebtoken":false},"types":"src/index.ts","files":["dist","LICENSE","README.md","README.zh-CN.md"],"scripts":{"build":"rm -rf dist && rslib build","format":"prettier --write .","lint":"eslint ./ --cache --quiet","start":"rm -rf dist && rslib build -w","test":"vitest","test:cov":"vitest --coverage --run"},"dependencies":{"jsonwebtoken":"^9.0.2"},"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/uuid":"^9.0.1","@types/whatwg-fetch":"^0.0.33","@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"}},"main":"dist/cjs/index.cjs","module":"dist/esm/index.js","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
@@ -4127,6 +4140,8 @@
                 }
                 const config = mergeConfig(this.axiosOptions, options, {
                     headers
+                }, {
+                    headers: this.headers || {}
                 });
                 config.method = method;
                 config.data = body;
@@ -4137,11 +4152,11 @@
                 const fetchOptions = await this.buildOptions(method, body, options);
                 fetchOptions.isStreaming = isStream;
                 fetchOptions.axiosInstance = this.axiosInstance;
-                this.debugLog(`--- request url: ${fullUrl}`);
-                this.debugLog('--- request options:', fetchOptions);
+                this.debugLog(null == options ? void 0 : options.debug, `--- request url: ${fullUrl}`);
+                this.debugLog(null == options ? void 0 : options.debug, '--- request options:', fetchOptions);
                 const { response, stream, json } = await fetchAPI(fullUrl, fetchOptions);
-                this.debugLog(`--- response status: ${response.status}`);
-                this.debugLog('--- response headers: ', response.headers);
+                this.debugLog(null == options ? void 0 : options.debug, `--- response status: ${response.status}`);
+                this.debugLog(null == options ? void 0 : options.debug, '--- response headers: ', response.headers);
                 var _response_headers;
                 // Taro use `header`
                 const contentType = (null !== (_response_headers = response.headers) && void 0 !== _response_headers ? _response_headers : response.header)['content-type'];
@@ -4184,8 +4199,9 @@
             }
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             debugLog() {
-                for(var _len = arguments.length, msgs = new Array(_len), _key = 0; _key < _len; _key++)msgs[_key] = arguments[_key];
-                if (this.debug) console.debug(...msgs);
+                let forceDebug = arguments.length > 0 && void 0 !== arguments[0] && arguments[0];
+                for(var _len = arguments.length, msgs = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++)msgs[_key - 1] = arguments[_key];
+                if (this.debug || forceDebug) console.debug(...msgs);
             }
             constructor(config){
                 this._config = config;
@@ -42334,6 +42350,9 @@
                     throw e;
                 }
             }
+            getRtcEngine() {
+                return this.engine;
+            }
             // eslint-disable-next-line max-params
             constructor(appId, debug = false, isTestEnv = false, isSupportVideo = false, videoConfig){
                 super(debug), this.joinUserId = '', this._AIAnsExtension = null, this._isSupportVideo = false;
@@ -42366,9 +42385,10 @@
                     // Step1 get token
                     roomInfo = await this._api.audio.rooms.create({
                         bot_id: botId,
-                        conversation_id: conversationId,
+                        conversation_id: conversationId || void 0,
                         voice_id: voiceId && voiceId.length > 0 ? voiceId : void 0,
-                        connector_id: this._config.connectorId
+                        connector_id: this._config.connectorId,
+                        uid: this._config.userId || void 0
                     });
                 } catch (error) {
                     this.dispatch(event_handler_EventNames.ERROR, error);
@@ -42519,6 +42539,14 @@
                 });
             }
             /**
+   * en: Get the RTC engine instance, for detail visit https://www.volcengine.com/docs/6348/104481
+   *
+   * zh: 获取 RTC 引擎实例，详情请访问 https://www.volcengine.com/docs/6348/104481
+   */ getRtcEngine() {
+                var _this__client;
+                return null === (_this__client = this._client) || void 0 === _this__client ? void 0 : _this__client.getRtcEngine();
+            }
+            /**
    * Constructor for initializing a RealtimeClient instance.
    *
    * 构造函数，初始化RealtimeClient实例。
@@ -42532,6 +42560,8 @@
    *                         可选，音色Id。
    * @param config.conversationId - Optional, Conversation Id. |
    *                               可选，会话Id。
+   * @param config.userId - Optional, User Id. |
+   *                        可选，用户Id。
    * @param config.baseURL - Optional, defaults to "https://api.coze.cn". |
    *                        可选，默认值为 "https://api.coze.cn"。
    * @param config.debug - Optional, defaults to false.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze/realtime-api",
-  "version": "1.0.4-alpha.aea086",
+  "version": "1.0.4-beta.2",
   "description": "A powerful real-time communication SDK for voice interactions with Coze AI bots | 扣子官方实时通信 SDK，用于与 Coze AI bots 进行语音交互",
   "keywords": [
     "coze",
@@ -49,7 +49,7 @@
     "test:cov": "vitest --coverage --run"
   },
   "dependencies": {
-    "@coze/api": "1.0.16-alpha.aea086",
+    "@coze/api": "1.0.16",
     "@volcengine/rtc": "^4.62.1"
   },
   "devDependencies": {