@cloudbase/node-sdk 3.15.0 → 3.16.0

package/dist/ai/index.js

@@ -0,0 +1,58 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAI = void 0;
+const ai_1 = require("@cloudbase/ai");
+const request_adapter_1 = require("./request-adapter");
+const tcbopenapiendpoint_1 = require("../utils/tcbopenapiendpoint");
+const symbol_1 = require("../const/symbol");
+const openapicommonrequester = __importStar(require("../utils/tcbopenapicommonrequester"));
+const app_1 = require("@cloudbase/app");
+/**
+ * 创建 AI 实例
+ * @param cloudbase CloudBase 实例
+ * @returns AI 实例
+ */
+function createAI(cloudbase) {
+    const config = cloudbase.config;
+    // 获取环境 ID
+    const envId = config.envName === symbol_1.SYMBOL_CURRENT_ENV ? openapicommonrequester.getEnvIdFromContext() : config.envName;
+    // 构建 AI 基础 URL
+    const baseUrl = (0, tcbopenapiendpoint_1.buildCommonOpenApiUrlWithPath)({
+        serviceUrl: config.serviceUrl,
+        envId,
+        path: '/v1',
+        region: config.region
+    });
+    // 创建请求适配器
+    const requestAdapter = new request_adapter_1.AIRequestAdapter(config, async () => {
+        const credential = await cloudbase.auth().getClientCredential();
+        return credential.access_token;
+    });
+    // 创建 AI 实例
+    const ai = new ai_1.AI(requestAdapter, baseUrl, { t: (s) => s, lang: app_1.LANGS.ZH, LANG_HEADER_KEY: 'Accept-Language' });
+    return ai;
+}
+exports.createAI = createAI;

package/dist/ai/request-adapter.js

@@ -0,0 +1,259 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIRequestAdapter = void 0;
+const openapicommonrequester = __importStar(require("../utils/tcbopenapicommonrequester"));
+const web_streams_polyfill_1 = require("web-streams-polyfill");
+const utils_1 = require("../utils/utils");
+class AIRequestAdapter {
+    constructor(config, getAccessToken) {
+        this.config = config;
+        this.getAccessToken = getAccessToken;
+    }
+    async fetch(options) {
+        var _a, _b;
+        const { url, stream = false, timeout, method = 'POST', headers, body } = options;
+        const headersObj = {};
+        if (isHeaders(headers)) {
+            headers.forEach((value, key) => {
+                headersObj[key] = value;
+            });
+        }
+        else if (Array.isArray(headers)) {
+            headers.forEach(([k, v]) => (headersObj[k] = v));
+        }
+        else {
+            Object.assign(headersObj, headers);
+        }
+        let parsedBody;
+        if (typeof body === 'string') {
+            try {
+                parsedBody = JSON.parse(body);
+            }
+            catch (_c) {
+                parsedBody = body;
+            }
+        }
+        else {
+            parsedBody = body;
+        }
+        const token = await this.getAccessToken();
+        const result = await openapicommonrequester.request({
+            config: this.config,
+            data: parsedBody,
+            method: (method === null || method === void 0 ? void 0 : method.toUpperCase()) || 'POST',
+            url,
+            headers: Object.assign({ 'Content-Type': 'application/json' }, headersObj),
+            token,
+            opts: {
+                timeout: timeout || this.config.timeout,
+                stream
+            }
+        });
+        const { body: bodyData, headers: responseHeaders, statusCode } = result;
+        if (statusCode < 200 || statusCode >= 300) {
+            let errorMessage = `Request failed with status code ${statusCode}`;
+            let errorCode = `${statusCode}`;
+            let requestId = '';
+            let errorBody = null;
+            if (typeof bodyData === 'string') {
+                errorBody = bodyData;
+            }
+            else if (Buffer.isBuffer(bodyData)) {
+                errorBody = bodyData.toString('utf-8');
+            }
+            else if (bodyData && typeof bodyData === 'object' && typeof bodyData.on === 'function') {
+                errorBody = await readStreamToString(bodyData);
+            }
+            if (errorBody) {
+                try {
+                    const errorData = JSON.parse(errorBody);
+                    if ((_a = errorData.error) === null || _a === void 0 ? void 0 : _a.message) {
+                        errorMessage = errorData.error.message;
+                    }
+                    else if (errorData.message) {
+                        errorMessage = errorData.message;
+                    }
+                    if ((_b = errorData.error) === null || _b === void 0 ? void 0 : _b.code) {
+                        errorCode = errorData.error.code;
+                    }
+                    else if (errorData.code) {
+                        errorCode = errorData.code;
+                    }
+                    if (errorData.requestId) {
+                        requestId = errorData.requestId;
+                    }
+                }
+                catch (_d) {
+                    errorMessage = errorBody || errorMessage;
+                }
+            }
+            // 从响应头中获取 requestId
+            if (!requestId && responseHeaders) {
+                const headerRequestId = responseHeaders['x-cloudbase-request-id'] || responseHeaders['x-request-id'] || '';
+                requestId = Array.isArray(headerRequestId) ? headerRequestId[0] : headerRequestId;
+            }
+            throw (0, utils_1.E)({
+                code: errorCode,
+                message: errorMessage,
+                requestId
+            });
+        }
+        if (stream) {
+            // 对于流式响应,将 Node.js 原生流转换为 Web ReadableStream
+            let readableStream;
+            if (bodyData && typeof bodyData === 'object' && 'on' in bodyData && typeof bodyData.on === 'function') {
+                const nodeStream = bodyData;
+                // Node 12 兼容: 使用标志位追踪 stream 状态,避免重复 close 导致异常
+                let streamClosed = false;
+                readableStream = new web_streams_polyfill_1.ReadableStream({
+                    start(controller) {
+                        nodeStream.on('data', (chunk) => {
+                            if (streamClosed)
+                                return;
+                            controller.enqueue(new Uint8Array(chunk));
+                        });
+                        nodeStream.on('end', () => {
+                            if (streamClosed)
+                                return;
+                            streamClosed = true;
+                            controller.close();
+                        });
+                        nodeStream.on('error', (err) => {
+                            if (streamClosed)
+                                return;
+                            streamClosed = true;
+                            controller.error(err);
+                        });
+                    },
+                    cancel() {
+                        streamClosed = true;
+                        nodeStream.destroy();
+                    }
+                });
+            }
+            else if (bodyData instanceof Buffer) {
+                readableStream = new web_streams_polyfill_1.ReadableStream({
+                    start(controller) {
+                        controller.enqueue(new Uint8Array(bodyData));
+                        controller.close();
+                    }
+                });
+            }
+            else if (typeof bodyData === 'string') {
+                const encoder = new TextEncoder();
+                readableStream = new web_streams_polyfill_1.ReadableStream({
+                    start(controller) {
+                        controller.enqueue(encoder.encode(bodyData));
+                        controller.close();
+                    }
+                });
+            }
+            else {
+                readableStream = new web_streams_polyfill_1.ReadableStream({
+                    start(controller) {
+                        controller.close();
+                    }
+                });
+            }
+            return {
+                data: readableStream,
+                statusCode,
+                header: responseHeaders
+            };
+        }
+        let responseData;
+        if (typeof bodyData === 'string') {
+            try {
+                responseData = JSON.parse(bodyData);
+            }
+            catch (_e) {
+                responseData = bodyData;
+            }
+        }
+        else if (bodyData instanceof Buffer) {
+            const bodyString = bodyData.toString('utf-8');
+            try {
+                responseData = JSON.parse(bodyString);
+            }
+            catch (_f) {
+                responseData = bodyString;
+            }
+        }
+        else {
+            responseData = bodyData;
+        }
+        return {
+            data: Promise.resolve(responseData),
+            statusCode,
+            header: responseHeaders
+        };
+    }
+    /**
+     * post 方法 - AI 模块可能不使用,但需要实现接口
+     */
+    async post() {
+        throw new Error('post method is not supported in AI module');
+    }
+    /**
+     * upload 方法 - AI 模块可能不使用,但需要实现接口
+     */
+    async upload() {
+        throw new Error('upload method is not supported in AI module');
+    }
+    /**
+     * download 方法 - AI 模块可能不使用,但需要实现接口
+     */
+    async download() {
+        throw new Error('download method is not supported in AI module');
+    }
+}
+exports.AIRequestAdapter = AIRequestAdapter;
+function isHeaders(h) {
+    try {
+        // Node.js 低版本可能没有 Headers
+        return h instanceof Headers;
+    }
+    catch (_) {
+        return false;
+    }
+}
+/**
+ * 从 Node.js 流中读取完整内容为字符串
+ */
+async function readStreamToString(stream) {
+    return await new Promise((resolve, reject) => {
+        const chunks = [];
+        stream.on('data', (chunk) => {
+            chunks.push(chunk);
+        });
+        stream.on('end', () => {
+            resolve(Buffer.concat(chunks).toString('utf-8'));
+        });
+        stream.on('error', (err) => {
+            reject(err);
+        });
+    });
+}

package/dist/cloudbase.js

@@ -47,6 +47,7 @@ const database_1 = require("./database");
 const storage_1 = require("./storage");
 const wx_1 = require("./wx");
 const analytics_1 = require("./analytics");
+const ai_1 = require("./ai");
 const logger_1 = require("./logger");
 const code_1 = require("./const/code");
 const utils = __importStar(require("./utils/utils"));
@@ -75,8 +76,7 @@ class CloudBase {
         /* eslint-disable-next-line */
         (0, cloudplatform_1.preflightRuntimeCloudPlatform)();
         const { debug, secretId, secretKey, sessionToken, env, timeout, headers = {} } = config, restConfig = __rest(config, ["debug", "secretId", "secretKey", "sessionToken", "env", "timeout", "headers"]);
-        if (('secretId' in config && !('secretKey' in config))
-            || (!('secretId' in config) && 'secretKey' in config)) {
+        if (('secretId' in config && !('secretKey' in config)) || (!('secretId' in config) && 'secretKey' in config)) {
             throw utils.E(Object.assign(Object.assign({}, code_1.ERROR.INVALID_PARAM), { message: 'secretId and secretKey must be a pair' }));
         }
         const newConfig = Object.assign(Object.assign({}, restConfig), { debug: !!debug, secretId,
@@ -115,14 +115,70 @@ class CloudBase {
                     token: (await this.auth().getClientCredential()).access_token
                 });
                 return result.body;
-            }, (0, tcbopenapiendpoint_1.buildCommonOpenApiUrlWithPath)({ serviceUrl: this.config.serviceUrl, envId, path: '/v1/model' }), {
-                sqlBaseUrl: (0, tcbopenapiendpoint_1.buildCommonOpenApiUrlWithPath)({ serviceUrl: this.config.serviceUrl, envId, path: '/v1/sql' })
+            }, (0, tcbopenapiendpoint_1.buildCommonOpenApiUrlWithPath)({ serviceUrl: this.config.serviceUrl, envId, path: '/v1/model', region: this.config.region }), {
+                sqlBaseUrl: (0, tcbopenapiendpoint_1.buildCommonOpenApiUrlWithPath)({ serviceUrl: this.config.serviceUrl, envId, path: '/v1/sql', region: this.config.region })
             });
             this.models = httpClient;
         }
         catch (e) {
             // ignore
         }
+        try {
+            const getEntity = (options) => {
+                const envId = this.config.envName === symbol_1.SYMBOL_CURRENT_ENV
+                    ? openapicommonrequester.getEnvIdFromContext()
+                    : this.config.envName;
+                const { instance = 'default', database = envId } = options || {};
+                const mysqlClient = wx_cloud_client_sdk_1.default.generateMySQLClient(this, {
+                    mysqlBaseUrl: (0, tcbopenapiendpoint_1.buildCommonOpenApiUrlWithPath)({
+                        serviceUrl: this.config.serviceUrl,
+                        envId,
+                        path: '/v1/rdb/rest',
+                        region: this.config.region
+                    }),
+                    fetch: async (url, options) => {
+                        var _a;
+                        let headers = {};
+                        if (options.headers instanceof Headers) {
+                            options.headers.forEach((value, key) => {
+                                headers[key] = value;
+                            });
+                        }
+                        else {
+                            headers = options.headers || {};
+                        }
+                        const result = await openapicommonrequester.request({
+                            config: this.config,
+                            data: safeParseJSON(options.body),
+                            method: (_a = options.method) === null || _a === void 0 ? void 0 : _a.toUpperCase(),
+                            url: url instanceof URL ? url.href : String(url),
+                            headers: Object.assign({ 'Content-Type': 'application/json' }, headersInitToRecord(Object.assign({ 'X-Db-Instance': instance, 'Accept-Profile': database, 'Content-Profile': database }, headers))),
+                            token: (await this.auth().getClientCredential()).access_token
+                        });
+                        const data = result.body;
+                        const res = {
+                            ok: (result === null || result === void 0 ? void 0 : result.statusCode) >= 200 && (result === null || result === void 0 ? void 0 : result.statusCode) < 300,
+                            status: (result === null || result === void 0 ? void 0 : result.statusCode) || 200,
+                            statusText: (result === null || result === void 0 ? void 0 : result.statusMessage) || 'OK',
+                            json: async () => await Promise.resolve(data || {}),
+                            text: async () => await Promise.resolve(typeof data === 'string' ? data : JSON.stringify(data || {})),
+                            headers: new Headers(incomingHttpHeadersToHeadersInit((result === null || result === void 0 ? void 0 : result.headers) || {}))
+                        };
+                        return res;
+                    }
+                });
+                return mysqlClient;
+            };
+            this.mysql = (options) => {
+                return getEntity(options)(options);
+            };
+            this.rdb = (options) => {
+                return getEntity(options)(options);
+            };
+        }
+        catch (e) {
+            // ignore
+        }
     }
     logger() {
         if (!this.clsLogger) {
@@ -136,6 +192,12 @@ class CloudBase {
     database(dbConfig = {}) {
         return (0, database_1.newDb)(this, dbConfig);
     }
+    ai() {
+        if (!this.aiInstance) {
+            this.aiInstance = (0, ai_1.createAI)(this);
+        }
+        return this.aiInstance;
+    }
     async callFunction(callFunctionOptions, opts) {
         return await (0, functions_1.callFunction)(this, callFunctionOptions, opts);
     }
@@ -240,7 +302,7 @@ function headersInitToRecord(headers) {
         });
     }
     else {
-        Object.keys(headers).forEach(key => {
+        Object.keys(headers).forEach((key) => {
             ret[key] = headers[key];
         });
     }
@@ -254,3 +316,20 @@ function safeParseJSON(x) {
         return x;
     }
 }
+function incomingHttpHeadersToHeadersInit(headers) {
+    const result = [];
+    for (const [key, value] of Object.entries(headers)) {
+        if (value === undefined) {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            for (const v of value) {
+                result.push([key, v]);
+            }
+        }
+        else {
+            result.push([key, value]);
+        }
+    }
+    return result;
+}

package/dist/utils/request-core.js

@@ -113,6 +113,10 @@ async function onResponse(res, { encoding, type = 'json' }) {
     if (type === 'stream') {
         return await Promise.resolve(undefined);
     }
+    // rawStream: 返回原始的 Node.js 流，用于真正的流式处理
+    if (type === 'rawStream') {
+        return await Promise.resolve(res);
+    }
     if (encoding) {
         res.setEncoding(encoding);
     }

package/dist/utils/tcbopenapicommonrequester.js

@@ -80,7 +80,7 @@ class TcbOpenApiHttpCommonRequester {
         });
     }
     makeReqOpts() {
-        var _a;
+        var _a, _b;
         const config = this.config;
         const args = this.args;
         const envId = args.config.envName === symbol_1.SYMBOL_CURRENT_ENV
@@ -88,7 +88,8 @@ class TcbOpenApiHttpCommonRequester {
             : args.config.envName;
         const url = args.url || (0, tcbopenapiendpoint_1.buildCommonOpenApiUrlWithPath)({
             envId,
-            path: args.path
+            path: args.path,
+            region: config.region
         });
         const timeout = ((_a = this.args.opts) === null || _a === void 0 ? void 0 : _a.timeout) || this.config.timeout || this.defaultTimeout;
         const opts = {
@@ -107,14 +108,20 @@ class TcbOpenApiHttpCommonRequester {
             opts.keepalive = typeof config.keepalive === 'boolean' && config.keepalive;
         }
         if (args.data) {
-            if (['post', 'put'].includes(args.method.toLowerCase())) {
+            if (['post', 'put', 'patch', 'delete'].includes(args.method.toLowerCase())) {
                 if (args.isFormData) {
                     opts.formData = args.data;
                     opts.encoding = null;
                 }
                 else {
                     opts.body = args.data;
-                    opts.json = true;
+                    if (((_b = args.opts) === null || _b === void 0 ? void 0 : _b.stream) !== true) {
+                        opts.json = true;
+                    }
+                    else {
+                        // 使用 rawStream 类型返回原始的 Node.js 流，实现真正的流式响应
+                        opts.type = 'rawStream';
+                    }
                 }
             }
             else {

package/dist/utils/tcbopenapiendpoint.js

@@ -1,14 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildCommonOpenApiUrlWithPath = exports.buildUrl = void 0;
+const ZONE_CHINA = ['ap-shanghai', 'ap-guangzhou', 'ap-shenzhen-fsi', 'ap-shanghai-fsi', 'ap-nanjing', 'ap-beijing', 'ap-chengdu', 'ap-chongqing', 'ap-hongkong'];
 /* eslint-disable complexity */
 function buildUrl(options) {
-    const endpoint = `https://${options.envId}.api.tcloudbasegateway.com/v1/cloudrun/${options.name}`;
+    const endpoint = `https://${getGatewayUrl(options)}/v1/cloudrun/${options.name}`;
     const path = options.path.startsWith('/') ? options.path : `/${options.path}`;
     return `${endpoint}${path}`;
 }
 exports.buildUrl = buildUrl;
 function buildCommonOpenApiUrlWithPath(options) {
-    return `${options.protocol || 'https'}://${options.serviceUrl || `${options.envId}.api.tcloudbasegateway.com`}${options.path}`;
+    return `${options.protocol || 'https'}://${options.serviceUrl || getGatewayUrl(options)}${options.path}`;
 }
 exports.buildCommonOpenApiUrlWithPath = buildCommonOpenApiUrlWithPath;
+function getGatewayUrl(options) {
+    const region = options.region || 'ap-shanghai';
+    let baseUrl = `${options.envId}.api.tcloudbasegateway.com`;
+    if (!ZONE_CHINA.includes(region)) {
+        baseUrl = `${options.envId}.api.intl.tcloudbasegateway.com`;
+    }
+    return baseUrl;
+}

package/dist/utils/tcbopenapirequester.js

@@ -88,7 +88,7 @@ class TcbOpenApiHttpRequester {
             : args.config.envName;
         const url = (0, tcbopenapiendpoint_1.buildUrl)({
             envId,
-            // region: this.config.region,
+            region: this.config.region,
             // protocol: this.config.protocol || 'https',
             // serviceUrl: this.config.serviceUrl,
             // seqId: this.tracingInfo.seqId,
@@ -125,6 +125,7 @@ class TcbOpenApiHttpRequester {
             }
             else {
                 /* istanbul ignore next */
+                // 这里 qs 参数暂时并没使用
                 opts.qs = args.data;
             }
         }
@@ -168,13 +169,18 @@ class TcbOpenApiHttpRequester {
             requiredHeaders['X-TCB-Region'] = region;
         }
         requiredHeaders = Object.assign(Object.assign(Object.assign({}, config.headers), args.headers), requiredHeaders);
+        let params = args.data || '';
+        // GET 方法不支持传 BODY
+        if (method.toLowerCase() === 'get') {
+            params = '';
+        }
         // TODO: 升级SDK版本，否则没传 args.data 时会签名失败
         const { authorization, timestamp } = (0, signature_nodejs_1.sign)({
             secretId,
             secretKey,
             method,
             url,
-            params: args.data || '',
+            params,
             headers: requiredHeaders,
             timestamp: second() - 1,
             withSignedParams: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbase/node-sdk",
-  "version": "3.15.0",
+  "version": "3.16.0",
   "description": "tencent cloud base server sdk for node.js",
   "main": "dist/index.js",
   "typings": "types/index.d.ts",
@@ -41,8 +41,11 @@
     "prepare": "husky install"
   },
   "dependencies": {
+    "@cloudbase/ai": "^2.23.0",
+    "@cloudbase/app": "^2.23.0",
     "@cloudbase/database": "1.4.2",
     "@cloudbase/signature-nodejs": "2.2.0",
+    "@cloudbase/types": "^2.23.0",
     "@cloudbase/wx-cloud-client-sdk": "1.7.1",
     "agentkeepalive": "^4.3.0",
     "axios": "0.27.2",
@@ -51,6 +54,7 @@
     "https-proxy-agent": "^5.0.1",
     "jsonwebtoken": "^9.0.2",
     "retry": "^0.13.1",
+    "web-streams-polyfill": "^4.2.0",
     "xml2js": "^0.6.2"
   },
   "devDependencies": {

package/src/ai/index.ts

@@ -0,0 +1,38 @@
+import { AI } from '@cloudbase/ai'
+import { CloudBase } from '../cloudbase'
+import { AIRequestAdapter } from './request-adapter'
+import { buildCommonOpenApiUrlWithPath } from '../utils/tcbopenapiendpoint'
+import { SYMBOL_CURRENT_ENV } from '../const/symbol'
+import * as openapicommonrequester from '../utils/tcbopenapicommonrequester'
+import { LANGS } from '@cloudbase/app'
+
+/**
+ * 创建 AI 实例
+ * @param cloudbase CloudBase 实例
+ * @returns AI 实例
+ */
+export function createAI(cloudbase: CloudBase): AI {
+  const config = cloudbase.config
+
+  // 获取环境 ID
+  const envId = config.envName === SYMBOL_CURRENT_ENV ? openapicommonrequester.getEnvIdFromContext() : (config.envName as string)
+
+  // 构建 AI 基础 URL
+  const baseUrl = buildCommonOpenApiUrlWithPath({
+    serviceUrl: config.serviceUrl,
+    envId,
+    path: '/v1',
+    region: config.region
+  })
+
+  // 创建请求适配器
+  const requestAdapter = new AIRequestAdapter(config, async () => {
+    const credential = await cloudbase.auth().getClientCredential()
+    return credential.access_token
+  })
+
+  // 创建 AI 实例
+  const ai = new AI(requestAdapter, baseUrl, { t: (s) => s, lang: LANGS.ZH, LANG_HEADER_KEY: 'Accept-Language' })
+
+  return ai
+}

package/src/ai/request-adapter.ts

@@ -0,0 +1,235 @@
+import { SDKRequestInterface, IFetchOptions, ResponseObject } from '@cloudbase/adapter-interface'
+import { ICloudBaseConfig } from '../../types'
+import * as openapicommonrequester from '../utils/tcbopenapicommonrequester'
+import { ReadableStream } from 'web-streams-polyfill'
+import { E } from '../utils/utils'
+
+export class AIRequestAdapter implements SDKRequestInterface {
+  constructor(private readonly config: ICloudBaseConfig, private readonly getAccessToken: () => Promise<string>) {}
+
+  async fetch(options: IFetchOptions): Promise<ResponseObject> {
+    const { url, stream = false, timeout, method = 'POST', headers, body } = options
+
+    const headersObj: Record<string, string> = {}
+    if (isHeaders(headers)) {
+      headers.forEach((value, key) => {
+        headersObj[key] = value
+      })
+    } else if (Array.isArray(headers)) {
+      headers.forEach(([k, v]) => (headersObj[k] = v))
+    } else {
+      Object.assign(headersObj, headers)
+    }
+
+    let parsedBody: any
+    if (typeof body === 'string') {
+      try {
+        parsedBody = JSON.parse(body)
+      } catch {
+        parsedBody = body
+      }
+    } else {
+      parsedBody = body
+    }
+
+    const token = await this.getAccessToken()
+
+    const result = await openapicommonrequester.request({
+      config: this.config,
+      data: parsedBody,
+      method: method?.toUpperCase() || 'POST',
+      url,
+      headers: {
+        'Content-Type': 'application/json',
+        ...headersObj
+      },
+      token,
+      opts: {
+        timeout: timeout || this.config.timeout,
+        stream
+      }
+    })
+
+    const { body: bodyData, headers: responseHeaders, statusCode } = result
+
+    if (statusCode < 200 || statusCode >= 300) {
+      let errorMessage = `Request failed with status code ${statusCode}`
+      let errorCode = `${statusCode}`
+      let requestId = ''
+      let errorBody: string | null = null
+
+      if (typeof bodyData === 'string') {
+        errorBody = bodyData
+      } else if (Buffer.isBuffer(bodyData)) {
+        errorBody = bodyData.toString('utf-8')
+      } else if (bodyData && typeof bodyData === 'object' && typeof (bodyData as any).on === 'function') {
+        errorBody = await readStreamToString(bodyData as unknown as NodeJS.ReadableStream)
+      }
+
+      if (errorBody) {
+        try {
+          const errorData = JSON.parse(errorBody)
+          if (errorData.error?.message) {
+            errorMessage = errorData.error.message
+          } else if (errorData.message) {
+            errorMessage = errorData.message
+          }
+          if (errorData.error?.code) {
+            errorCode = errorData.error.code
+          } else if (errorData.code) {
+            errorCode = errorData.code
+          }
+          if (errorData.requestId) {
+            requestId = errorData.requestId
+          }
+        } catch {
+          errorMessage = errorBody || errorMessage
+        }
+      }
+
+      // 从响应头中获取 requestId
+      if (!requestId && responseHeaders) {
+        const headerRequestId = responseHeaders['x-cloudbase-request-id'] || responseHeaders['x-request-id'] || ''
+        requestId = Array.isArray(headerRequestId) ? headerRequestId[0] : headerRequestId
+      }
+
+      throw E({
+        code: errorCode,
+        message: errorMessage,
+        requestId
+      })
+    }
+
+    if (stream) {
+      // 对于流式响应,将 Node.js 原生流转换为 Web ReadableStream
+      let readableStream: ReadableStream<Uint8Array>
+
+      if (bodyData && typeof bodyData === 'object' && 'on' in bodyData && typeof bodyData.on === 'function') {
+        const nodeStream = bodyData
+        // Node 12 兼容: 使用标志位追踪 stream 状态,避免重复 close 导致异常
+        let streamClosed = false
+        readableStream = new ReadableStream({
+          start(controller) {
+            nodeStream.on('data', (chunk: Buffer) => {
+              if (streamClosed) return
+              controller.enqueue(new Uint8Array(chunk))
+            })
+            nodeStream.on('end', () => {
+              if (streamClosed) return
+              streamClosed = true
+              controller.close()
+            })
+            nodeStream.on('error', (err) => {
+              if (streamClosed) return
+              streamClosed = true
+              controller.error(err)
+            })
+          },
+          cancel() {
+            streamClosed = true
+            nodeStream.destroy()
+          }
+        })
+      } else if (bodyData instanceof Buffer) {
+        readableStream = new ReadableStream({
+          start(controller) {
+            controller.enqueue(new Uint8Array(bodyData))
+            controller.close()
+          }
+        })
+      } else if (typeof bodyData === 'string') {
+        const encoder = new TextEncoder()
+        readableStream = new ReadableStream({
+          start(controller) {
+            controller.enqueue(encoder.encode(bodyData))
+            controller.close()
+          }
+        })
+      } else {
+        readableStream = new ReadableStream({
+          start(controller) {
+            controller.close()
+          }
+        })
+      }
+
+      return {
+        data: readableStream,
+        statusCode,
+        header: responseHeaders
+      }
+    }
+
+    let responseData: any
+    if (typeof bodyData === 'string') {
+      try {
+        responseData = JSON.parse(bodyData)
+      } catch {
+        responseData = bodyData
+      }
+    } else if (bodyData instanceof Buffer) {
+      const bodyString = bodyData.toString('utf-8')
+      try {
+        responseData = JSON.parse(bodyString)
+      } catch {
+        responseData = bodyString
+      }
+    } else {
+      responseData = bodyData
+    }
+
+    return {
+      data: Promise.resolve(responseData),
+      statusCode,
+      header: responseHeaders
+    }
+  }
+
+  /**
+   * post 方法 - AI 模块可能不使用,但需要实现接口
+   */
+  async post() {
+    throw new Error('post method is not supported in AI module')
+  }
+
+  /**
+   * upload 方法 - AI 模块可能不使用,但需要实现接口
+   */
+  async upload() {
+    throw new Error('upload method is not supported in AI module')
+  }
+
+  /**
+   * download 方法 - AI 模块可能不使用,但需要实现接口
+   */
+  async download() {
+    throw new Error('download method is not supported in AI module')
+  }
+}
+
+function isHeaders(h: HeadersInit): h is Headers {
+  try {
+    // Node.js 低版本可能没有 Headers
+    return h instanceof Headers
+  } catch (_) {
+    return false
+  }
+}
+
+/**
+ * 从 Node.js 流中读取完整内容为字符串
+ */
+async function readStreamToString(stream: NodeJS.ReadableStream): Promise<string> {
+  return await new Promise((resolve, reject) => {
+    const chunks: Buffer[] = []
+    stream.on('data', (chunk: Buffer) => {
+      chunks.push(chunk)
+    })
+    stream.on('end', () => {
+      resolve(Buffer.concat(chunks).toString('utf-8'))
+    })
+    stream.on('error', (err) => {
+      reject(err)
+    })
+  })
+}

package/src/cloudbase.ts

@@ -46,6 +46,8 @@ import { newDb } from './database'
 import { uploadFile, deleteFile, getTempFileURL, getFileInfo, downloadFile, getUploadMetadata, getFileAuthority, copyFile } from './storage'
 import { callWxOpenApi, callCompatibleWxOpenApi, callWxPayApi, wxCallContainerApi } from './wx'
 import { analytics } from './analytics'
+import { createAI } from './ai'
+import { AI } from '@cloudbase/ai'
 
 import { Logger, logger } from './logger'
 
@@ -59,6 +61,7 @@ import * as openapicommonrequester from './utils/tcbopenapicommonrequester'
 import { IFetchOptions } from '@cloudbase/adapter-interface'
 import { buildCommonOpenApiUrlWithPath } from './utils/tcbopenapiendpoint'
 import { SYMBOL_CURRENT_ENV } from './const/symbol'
+import { IncomingHttpHeaders } from 'http'
 
 export class CloudBase {
   public static scfContext: ISCFContext
@@ -79,6 +82,8 @@ export class CloudBase {
 
   private extensionMap: Map<string, Extension>
 
+  private aiInstance: AI
+
   public models: OrmClient & OrmRawQueryClient
 
   public mysql: IMySqlClient
@@ -94,19 +99,9 @@ export class CloudBase {
     /* eslint-disable-next-line */
     preflightRuntimeCloudPlatform()
 
-    const {
-      debug,
-      secretId,
-      secretKey,
-      sessionToken,
-      env,
-      timeout,
-      headers = {},
-      ...restConfig
-    } = config
+    const { debug, secretId, secretKey, sessionToken, env, timeout, headers = {}, ...restConfig } = config
 
-    if (('secretId' in config && !('secretKey' in config))
-      || (!('secretId' in config) && 'secretKey' in config)) {
+    if (('secretId' in config && !('secretKey' in config)) || (!('secretId' in config) && 'secretKey' in config)) {
       throw utils.E({
         ...ERROR.INVALID_PARAM,
         message: 'secretId and secretKey must be a pair'
@@ -220,13 +215,10 @@ export class CloudBase {
             const res = {
               ok: result?.statusCode >= 200 && result?.statusCode < 300,
               status: result?.statusCode || 200,
-              statusText: result?.statusMessage || 'OK',
+              statusText: (result as unknown as { statusMessage: string })?.statusMessage || 'OK',
               json: async () => await Promise.resolve(data || {}),
-              text: async () =>
-                await Promise.resolve(
-                  typeof data === 'string' ? data : JSON.stringify(data || {})
-                ),
-              headers: new Headers(result?.headers || {})
+              text: async () => await Promise.resolve(typeof data === 'string' ? data : JSON.stringify(data || {})),
+              headers: new Headers(incomingHttpHeadersToHeadersInit(result?.headers || {}))
             }
 
             return res as Response
@@ -262,6 +254,13 @@ export class CloudBase {
     return newDb(this, dbConfig)
   }
 
+  public ai(): AI {
+    if (!this.aiInstance) {
+      this.aiInstance = createAI(this)
+    }
+    return this.aiInstance
+  }
+
   public async callFunction<ParaT, ResultT>(callFunctionOptions: ICallFunctionOptions<ParaT>, opts?: ICustomReqOpts) {
     return await callFunction<ParaT, ResultT>(this, callFunctionOptions, opts)
   }
@@ -270,8 +269,8 @@ export class CloudBase {
     return await callContainer<ParaT, ResultT>(this, callContainerOptions, opts)
   }
 
-  public async callApis<ParaT, ResultT>(callApiOptions: ICallApisOptions<ParaT>, opts?: ICustomReqOpts) {
-    return await callApis<ParaT, ResultT>(this, callApiOptions, opts)
+  public async callApis<ParaT>(callApiOptions: ICallApisOptions<ParaT>, opts?: ICustomReqOpts) {
+    return await callApis<ParaT>(this, callApiOptions, opts)
   }
 
   public async callWxOpenApi(wxOpenApiOptions: ICallWxOpenApiOptions, opts?: ICustomReqOpts): Promise<ICallWxOpenApiResult> {
@@ -384,7 +383,7 @@ function headersInitToRecord(headers: HeadersInit): Record<string, string> {
       ret[key] = value
     })
   } else {
-    Object.keys(headers).forEach(key => {
+    Object.keys(headers).forEach((key) => {
       ret[key] = headers[key]
     })
   }
@@ -398,3 +397,20 @@ function safeParseJSON(x: unknown) {
     return x
   }
 }
+
+function incomingHttpHeadersToHeadersInit(headers: IncomingHttpHeaders): HeadersInit {
+  const result: Array<[string, string]> = []
+  for (const [key, value] of Object.entries(headers)) {
+    if (value === undefined) {
+      continue
+    }
+    if (Array.isArray(value)) {
+      for (const v of value) {
+        result.push([key, v])
+      }
+    } else {
+      result.push([key, value])
+    }
+  }
+  return result
+}

package/src/functions/index.ts

@@ -76,7 +76,7 @@ export async function callFunction<ParaT, ResultT>(cloudbase: CloudBase, callFun
  * @param opts
  * @returns
  */
-export async function callApis<ParaT, ResultT>(cloudbase: CloudBase, callApiOptions: ICallApisOptions<ParaT>, opts?: ICustomReqOpts): Promise<ResultT> {
+export async function callApis<ParaT>(cloudbase: CloudBase, callApiOptions: ICallApisOptions<ParaT>, opts?: ICustomReqOpts) {
   let { name, body, path = '', method = 'POST', header = {}, token = '' } = callApiOptions
 
   if (!name) {

package/src/utils/request-core.ts

@@ -101,12 +101,17 @@ async function onResponse(
   {
     encoding,
     type = 'json'
-  }: { encoding?: string, type?: 'stream' | 'raw' | 'json' }
-): Promise<string | Buffer | undefined> {
+  }: { encoding?: string, type?: 'stream' | 'raw' | 'json' | 'rawStream' }
+): Promise<string | Buffer | http.IncomingMessage | undefined> {
   if (type === 'stream') {
     return await Promise.resolve(undefined)
   }
 
+  // rawStream: 返回原始的 Node.js 流，用于真正的流式处理
+  if (type === 'rawStream') {
+    return await Promise.resolve(res)
+  }
+
   if (encoding) {
     res.setEncoding(encoding)
   }
@@ -171,7 +176,13 @@ function onTimeout(req: http.ClientRequest, cb: RequestCB) {
 
 export type RequestCB = (err: Error, res?: http.IncomingMessage, body?: string | Buffer) => void
 
-export function request(opts: IReqOpts, cb: RequestCB): http.ClientRequest {
+// 用于 rawStream 类型的回调，body 参数实际上是 IncomingMessage
+export type RequestCBWithStream = (err: Error, res?: http.IncomingMessage, body?: string | Buffer | http.IncomingMessage) => void
+
+// 函数重载：支持普通回调和流式回调
+export function request(opts: IReqOpts, cb: RequestCB): http.ClientRequest
+export function request(opts: IReqOpts & { type: 'rawStream' }, cb: RequestCBWithStream): http.ClientRequest
+export function request(opts: IReqOpts, cb: RequestCB | RequestCBWithStream): http.ClientRequest {
   const times = opts.times || 1
 
   const options: http.ClientRequestArgs = {
@@ -200,7 +211,7 @@ export function request(opts: IReqOpts, cb: RequestCB): http.ClientRequest {
       type: opts.json ? 'json' : opts.type
     })
       .then((body) => {
-        cb(null, res, body)
+        (cb as RequestCBWithStream)(null, res, body)
       })
       .catch((err) => {
         cb(err)

package/src/utils/request.ts

@@ -67,7 +67,7 @@ interface IExtraRequestOptions {
 interface IResponse {
   statusCode: number
   headers: http.IncomingHttpHeaders
-  body: string | Buffer
+  body: string | Buffer | http.IncomingMessage
 }
 
 /* istanbul ignore next */
@@ -99,7 +99,7 @@ export async function requestWithTimingsMeasure(opts: IReqOpts, extraOptions?: I
     })
 
     ; (function r() {
-      const cRequest = request(opts, (err: Error, res: http.IncomingMessage, body: string | Buffer) => {
+      const cRequest = request(opts, (err: Error, res: http.IncomingMessage, body) => {
         if (err) {
           reject(err)
         } else {

package/src/utils/tcbopenapicommonrequester.ts

@@ -53,7 +53,7 @@ export class TcbOpenApiHttpCommonRequester {
     this.tracingInfo = generateTracingInfo(args.config?.context?.eventID)
   }
 
-  public async request(): Promise<any> {
+  public async request() {
     await this.prepareCredentials()
 
     const opts = this.makeReqOpts()
@@ -75,7 +75,7 @@ export class TcbOpenApiHttpCommonRequester {
       seqId: this.tracingInfo.seqId,
       retryOptions,
       timingsMeasurerOptions: config.timingsMeasurerOptions || {}
-    }).then((response: any) => {
+    }).then((response) => {
       this.slowWarnTimer && clearTimeout(this.slowWarnTimer)
       return response
     })
@@ -120,7 +120,12 @@ export class TcbOpenApiHttpCommonRequester {
           opts.encoding = null
         } else {
           opts.body = args.data
-          opts.json = true
+          if (args.opts?.stream !== true) {
+            opts.json = true
+          } else {
+            // 使用 rawStream 类型返回原始的 Node.js 流，实现真正的流式响应
+            opts.type = 'rawStream'
+          }
         }
       } else {
         /* istanbul ignore next */
@@ -201,7 +206,7 @@ export class TcbOpenApiHttpCommonRequester {
   }
 }
 
-export async function request(args: ITcbOpenApiHttpCommonRequestInfo): Promise<any> {
+export async function request(args: ITcbOpenApiHttpCommonRequestInfo) {
   if (typeof args.isInternal === 'undefined') {
     args.isInternal = await checkIsInternalAsync()
   }

package/types/index.d.ts

@@ -2,6 +2,7 @@ import fs from 'fs'
 
 import { Db } from '@cloudbase/database'
 import { OrmClient, OrmRawQueryClient } from '@cloudbase/wx-cloud-client-sdk'
+import { AI } from '@cloudbase/ai'
 
 type IKeyValue = Record<string, any>
 
@@ -570,6 +571,11 @@ export declare class CloudBase {
   wxCallContainerApi(wxOpenApiOptions: ICallWxOpenApiOptions, opts?: ICustomReqOpts): Promise<any>
   callCompatibleWxOpenApi(wxOpenApiOptions: ICallWxOpenApiOptions, opts?: ICustomReqOpts): Promise<any>
 
+  /**
+   * ai - 获取 AI 实例
+   */
+  ai(): AI
+
   registerExtension(ext: Extension): void
   invokeExtension<T>(name: string, opts: T)
 }

package/types/internal.d.ts

@@ -39,7 +39,7 @@ export interface IReqOpts {
   timeout?: number
   headers?: IHeaderOpts
   json?: boolean
-  type?: 'stream' | 'raw' | 'json'
+  type?: 'stream' | 'raw' | 'json' | 'rawStream'
   debug?: boolean
   times?: number
   noBody?: boolean