@cloudbase/wx-cloud-client-sdk 1.2.0 → 1.3.0

package/lib/index.d.ts

@@ -1,3 +1,4 @@
 import { CloudBaseInstance, ExtendedCloudBaseInstance } from './types';
 export declare function init(cloud: CloudBaseInstance): ExtendedCloudBaseInstance;
 export * from './types';
+export { generateHTTPClient } from './orm/http-orm-client';

package/lib/orm/http-orm-client.d.ts

@@ -0,0 +1,5 @@
+import { SDKRequestInterface } from '@cloudbase/adapter-interface';
+import { OrmClient, CallFunction } from '../types';
+type ModelFetch = NonNullable<SDKRequestInterface['fetch']>;
+export declare const generateHTTPClient: (callFunction: CallFunction, fetch: ModelFetch, baseUrl: string) => OrmClient;
+export {};

package/lib/orm/rawQueryClient.d.ts

@@ -0,0 +1,2 @@
+import type { CallFunction, OrmRawQueryClient } from '../types';
+export declare const createRawQueryClient: (callFunction: CallFunction) => OrmRawQueryClient;

package/lib/types/index.d.ts

@@ -10,7 +10,7 @@ export interface Model {
     updateBy?: Relation;
     _openid?: string;
 }
-export declare type EnvType = 'prod' | 'pre';
+export type EnvType = 'prod' | 'pre';
 /**
  * 模型方法的定义
  * =====================================================================
@@ -19,7 +19,7 @@ export declare type EnvType = 'prod' | 'pre';
  * 模型操作方法的返回类型定义。
  * @template T 返回数据的类型。
  */
-export declare type MethodResponse<T> = {
+export type MethodResponse<T> = {
     /**
      * 返回的数据。
      */
@@ -293,14 +293,14 @@ export interface DataModelMethods<T> {
  * 数据创建方法的返回类型定义。
  * @template T 模型字段的类型。
  */
-export declare type CreateResponse<T> = {
+export type CreateResponse<T> = {
     id: string;
 };
 /**
  * 创建多条记录的响应类型定义。
  * @template T 模型字段的类型。
  */
-export declare type CreateManyResponse<T> = {
+export type CreateManyResponse<T> = {
     /**
      * 创建的记录的ID列表。
      */
@@ -310,7 +310,7 @@ export declare type CreateManyResponse<T> = {
  * 更新操作的响应类型定义。
  * @template T 模型字段的类型。
  */
-export declare type UpdateResponse<T> = {
+export type UpdateResponse<T> = {
     /**
      * 更新操作影响的记录数量。
      */
@@ -320,7 +320,7 @@ export declare type UpdateResponse<T> = {
  * 创建或者更新的响应类型定义。
  * @template T 模型字段的类型。
  */
-export declare type UpsertResponse<T> = {
+export type UpsertResponse<T> = {
     /**
      * 变更的条数，返回非 0 值代表更新成功
      */
@@ -334,7 +334,7 @@ export declare type UpsertResponse<T> = {
  * 删除操作的响应类型定义，用于表示删除操作影响的记录数量。
  * @template T 模型字段的类型。
  */
-export declare type DeleteResponse<T> = {
+export type DeleteResponse<T> = {
     /**
      * 删除操作影响的记录数量。
      * 如果count为0，表示没有记录被删除；
@@ -346,12 +346,12 @@ export declare type DeleteResponse<T> = {
  * 删除多条记录的响应类型定义，与更新操作的响应类型相同。
  * @template T 模型字段的类型。
  */
-export declare type DeleteManyResponse<T> = UpdateResponse<T>;
+export type DeleteManyResponse<T> = UpdateResponse<T>;
 /**
  * 数据列表方法的返回类型定义。
  * @template T 模型字段的类型。
  */
-export declare type ListResponse<T> = MethodResponse<{
+export type ListResponse<T> = MethodResponse<{
     records: T[];
     total?: number;
 }>;
@@ -359,7 +359,7 @@ export declare type ListResponse<T> = MethodResponse<{
  * list 方法参数定义。
  * @template T 模型字段的类型。
  */
-export declare type ListParams<T> = {
+export type ListParams<T> = {
     filter?: FilterParams<T>;
     select?: SelectParams<T> | {
         $master: boolean;
@@ -392,7 +392,7 @@ export declare type ListParams<T> = {
     where: {},
   }
  */
-export declare type FilterParams<T> = {
+export type FilterParams<T> = {
     /**
      * 基础查询
      */
@@ -448,7 +448,7 @@ export declare type FilterParams<T> = {
  *   ]
  * }
  */
-export declare type FilterObject<T> = {
+export type FilterObject<T> = {
     [operator in LogicalOperator]?: FilterConditionItem<T>[] | FilterObject<T>;
 };
 /**
@@ -497,7 +497,7 @@ export declare type FilterObject<T> = {
  * }
  * ```
  */
-export declare type FilterConditionItem<T> = {
+export type FilterConditionItem<T> = {
     [key in keyof T]?: FilterCondition;
 };
 /**
@@ -508,7 +508,7 @@ export declare type FilterConditionItem<T> = {
  *  "$eq": "val"
  * }
  */
-export declare type FilterCondition = {
+export type FilterCondition = {
     [key in ComparisonOperator]?: any;
 };
 /**
@@ -516,7 +516,7 @@ export declare type FilterCondition = {
  * @example
  * $eq: 等于
  */
-export declare type ComparisonOperator = BasicComparisonOperator | SpecialComparisonOperator;
+export type ComparisonOperator = BasicComparisonOperator | SpecialComparisonOperator;
 /**
  * 排序参数结构定义。
  *
@@ -525,7 +525,7 @@ export declare type ComparisonOperator = BasicComparisonOperator | SpecialCompar
   "createdAt": "asc",
  }
  */
-export declare type OrderByParams = {
+export type OrderByParams = {
     [key: string]: 'asc' | 'desc';
 };
 /**
@@ -549,7 +549,7 @@ export declare type OrderByParams = {
   }
  }
  */
-export declare type SelectParams<T> = {
+export type SelectParams<T> = {
     [K in keyof T]?: T[K] extends Array<infer U> | undefined ? SelectParams<U> | boolean : T[K] extends object | undefined ? SelectParams<T[K]> | boolean : boolean;
 } & {
     $master?: boolean;
@@ -557,34 +557,42 @@ export declare type SelectParams<T> = {
 /**
  * 基础比较运算符类型定义。
  */
-export declare type BasicComparisonOperator = '$eq' | '$neq' | '$gt' | '$gte' | '$lt' | '$lte' | '$in' | '$nin';
+export type BasicComparisonOperator = '$eq' | '$neq' | '$gt' | '$gte' | '$lt' | '$lte' | '$in' | '$nin';
 /**
  * 特殊比较运算符类型定义
  */
-export declare type SpecialComparisonOperator = '$search' | '$nsearch' | '$empty' | '$nempty';
+export type SpecialComparisonOperator = '$search' | '$nsearch' | '$empty' | '$nempty';
 /**
  * 逻辑运算符类型定义。
  */
-export declare type LogicalOperator = '$and' | '$or';
-export declare type RelationField<T> = T extends {
+export type LogicalOperator = '$and' | '$or';
+export type RelationField<T> = T extends {
     [key: string]: infer U;
 } ? U : never;
 /**
  * @hidden
  */
-declare type RelationKeys<T> = T extends any ? {
+type RelationKeys<T> = T extends any ? {
     [K in keyof T]: T[K] extends Model | Model[] ? K : never;
 }[keyof T] : never;
 /**
  * 关联关系类型定义。
  * @hidden
  */
-export declare type Relation = string;
+export type Relation = string;
 export interface SQLCommandParams {
     /**
      * 超时时间，默认是 5s，最大不超过 15s
      */
     timeout?: number;
+    /**
+     * 可填写写数据连接名称
+     *
+     * 连接外部数据库时，需要填写数据库连接名称, 可在云后台的数据库管理中创建和查看数据库连接
+     * 如果不填，则会使用默认的数据库连接内置的 Mysql 连接。
+     *
+     */
+    dbLinkName?: string;
 }
 /**
  * 运行原生SQL的ORM客户端接口
@@ -677,7 +685,7 @@ export interface RunMysqlCommandParams {
  * 云函数调用接口，包含调用函数和认证信息。
  * @hidden
  */
-export declare type CloudBaseInstance = {
+export type CloudBaseInstance = {
     callFunction: CallFunction;
     auth: any;
 };
@@ -694,7 +702,7 @@ export interface ExtendedCloudBaseInstance extends CloudBaseInstance {
  * @param args - 包含函数名称、数据源名称、方法名称和参数的对象。
  * @returns 返回一个Promise，解析为任意类型。
  */
-export declare type CallFunction = (args: {
+export type CallFunction = (args: {
     name: string;
     data: Record<string, any>;
 }) => Promise<any>;

package/lib/wxCloudClientSDK.cjs.js

@@ -143,7 +143,7 @@ function getUserAgent() {
         return ua_1;
     }
 }
-var VERSION = "1.2.0";
+var VERSION = "1.3.0";
 
 var callDataSource = function (_a) {
     var dataSourceName = _a.dataSourceName, methodName = _a.methodName, params = _a.params, realMethodName = _a.realMethodName, callFunction = _a.callFunction, _b = _a.envType, envType = _b === void 0 ? 'prod' : _b, mode = _a.mode;
@@ -265,6 +265,45 @@ var runMysqlCommand = function (_a) {
     });
 };
 
+var createRawQueryClient = function (callFunction) { return ({
+    $runSQL: function (sql, params, config) {
+        return __awaiter(this, void 0, void 0, function () {
+            var res;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, runMysqlCommand({
+                            sql: sql,
+                            params: params,
+                            config: __assign(__assign({}, config), { preparedStatements: true }),
+                            callFunction: callFunction
+                        })];
+                    case 1:
+                        res = _a.sent();
+                        return [2 /*return*/, res];
+                }
+            });
+        });
+    },
+    $runSQLRaw: function (sql, config) {
+        return __awaiter(this, void 0, void 0, function () {
+            var res;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, runMysqlCommand({
+                            sql: sql,
+                            params: [],
+                            config: __assign(__assign({}, config), { preparedStatements: false }),
+                            callFunction: callFunction
+                        })];
+                    case 1:
+                        res = _a.sent();
+                        return [2 /*return*/, res];
+                }
+            });
+        });
+    }
+}); };
+
 var CRUD_METHODS = {
     create: {
         methodName: 'wedaCreateV2'
@@ -352,48 +391,11 @@ var generateClientByDataSourceName = function (dataSourceName, callFunction) {
 };
 // 使用 TypeScript 的 Proxy 来定义一个动态的客户端
 var generateClient = function (callFunction) {
-    var rawQueryClient = {
-        $runSQL: function (sql, params, config) {
-            return __awaiter(this, void 0, void 0, function () {
-                var res;
-                return __generator(this, function (_a) {
-                    switch (_a.label) {
-                        case 0: return [4 /*yield*/, runMysqlCommand({
-                                sql: sql,
-                                params: params,
-                                config: __assign(__assign({}, config), { preparedStatements: true }),
-                                callFunction: callFunction
-                            })];
-                        case 1:
-                            res = _a.sent();
-                            return [2 /*return*/, res];
-                    }
-                });
-            });
-        },
-        $runSQLRaw: function (sql, config) {
-            return __awaiter(this, void 0, void 0, function () {
-                var res;
-                return __generator(this, function (_a) {
-                    switch (_a.label) {
-                        case 0: return [4 /*yield*/, runMysqlCommand({
-                                sql: sql,
-                                params: [],
-                                config: __assign(__assign({}, config), { preparedStatements: false }),
-                                callFunction: callFunction
-                            })];
-                        case 1:
-                            res = _a.sent();
-                            return [2 /*return*/, res];
-                    }
-                });
-            });
-        }
-    };
+    var rawQueryClient = createRawQueryClient(callFunction);
     return new Proxy({}, {
         get: function (target, prop) {
             if (typeof prop === 'string') {
-                if (rawQueryClient.hasOwnProperty(prop)) {
+                if (Object.prototype.hasOwnProperty.call(rawQueryClient, prop)) {
                     return rawQueryClient[prop];
                 }
                 // 返回一个函数，这个函数接受任意参数并返回一个 Promise
@@ -403,6 +405,109 @@ var generateClient = function (callFunction) {
     });
 };
 
+var READ_DEFAULT_PARAMS = {
+    filter: {
+        where: {}
+    },
+    select: {
+        $master: true
+    }
+};
+function createDefaultMethod(methodName) {
+    return {
+        getUrl: function (modelName) { return "".concat(modelName, "/").concat(methodName); },
+        method: 'post'
+    };
+}
+var HTTP_DATA_MODEL_METHODS = {
+    get: __assign(__assign({}, createDefaultMethod('get')), { defaultParams: __assign({}, READ_DEFAULT_PARAMS) }),
+    list: __assign(__assign({}, createDefaultMethod('list')), { defaultParams: __assign({}, READ_DEFAULT_PARAMS) }),
+    create: createDefaultMethod('create'),
+    createMany: createDefaultMethod('createMany'),
+    update: __assign(__assign({}, createDefaultMethod('update')), { method: 'put' }),
+    updateMany: __assign(__assign({}, createDefaultMethod('updateMany')), { method: 'put' }),
+    upsert: createDefaultMethod('upsert'),
+    "delete": createDefaultMethod('delete'),
+    deleteMany: createDefaultMethod('deleteMany')
+};
+var UNKNOWN_ERROR_MESSAGE = 'Unknown error occurred';
+var NOT_SUPPORTED_CODE = 'NotSupported';
+var generateHTTPClient = function (callFunction, fetch, baseUrl) {
+    var rawQueryClient = createRawQueryClient(callFunction);
+    return new Proxy({}, {
+        get: function (_, modelName) {
+            if (typeof modelName !== 'string')
+                return undefined;
+            if (Object.prototype.hasOwnProperty.call(rawQueryClient, modelName)) {
+                return rawQueryClient[modelName];
+            }
+            return generateHTTPClientByDataSourceName(baseUrl, modelName, fetch);
+        }
+    });
+};
+var createWxCloudSDKError = function (message, modelName, methodName, code, requestId) {
+    return new WxCloudSDKError("\u3010\u9519\u8BEF\u3011".concat(message, "\n\u3010\u64CD\u4F5C\u3011\u8C03\u7528 models.").concat(modelName, ".").concat(methodName, "\n\u3010\u9519\u8BEF\u7801\u3011").concat(code, "\n\u3010\u8BF7\u6C42ID\u3011").concat(requestId), {
+        code: code,
+        requestId: requestId
+    });
+};
+var generateHTTPClientByDataSourceName = function (baseUrl, modelName, fetch) {
+    var client = new Proxy({}, {
+        get: function (_, methodName) {
+            var httpDataModelMethod = HTTP_DATA_MODEL_METHODS[methodName];
+            if (!httpDataModelMethod) {
+                var error = new Error("\u4E0D\u652F\u6301\u7684\u64CD\u4F5C: ".concat(methodName));
+                throw new WxCloudSDKError(error.message || UNKNOWN_ERROR_MESSAGE, {
+                    originError: error,
+                    code: NOT_SUPPORTED_CODE,
+                    requestId: 'N/A'
+                });
+            }
+            return function (params) {
+                if (params === void 0) { params = {}; }
+                return __awaiter(void 0, void 0, void 0, function () {
+                    var getUrl, method, _a, defaultParams, effectiveParams, url, result, error_1;
+                    var _b;
+                    return __generator(this, function (_c) {
+                        switch (_c.label) {
+                            case 0:
+                                getUrl = httpDataModelMethod.getUrl, method = httpDataModelMethod.method, _a = httpDataModelMethod.defaultParams, defaultParams = _a === void 0 ? {} : _a;
+                                effectiveParams = Object.assign({}, defaultParams, params);
+                                url = [baseUrl, getUrl(modelName)].join('/');
+                                _c.label = 1;
+                            case 1:
+                                _c.trys.push([1, 3, , 4]);
+                                return [4 /*yield*/, fetch({
+                                        url: url,
+                                        body: JSON.stringify(effectiveParams),
+                                        method: method
+                                    })];
+                            case 2:
+                                result = _c.sent();
+                                if (result.code) {
+                                    // 抛出错误
+                                    throw createWxCloudSDKError(result === null || result === void 0 ? void 0 : result.message, modelName, methodName, result === null || result === void 0 ? void 0 : result.code, result === null || result === void 0 ? void 0 : result.requestId);
+                                }
+                                if (methodName === 'get') {
+                                    // 和 callFunction 实现保持一致
+                                    Object.assign(result, { data: (_b = result.data.record) !== null && _b !== void 0 ? _b : result.data });
+                                }
+                                return [2 /*return*/, result];
+                            case 3:
+                                error_1 = _c.sent();
+                                throw new WxCloudSDKError((error_1 === null || error_1 === void 0 ? void 0 : error_1.message) || UNKNOWN_ERROR_MESSAGE, {
+                                    originError: error_1
+                                });
+                            case 4: return [2 /*return*/];
+                        }
+                    });
+                });
+            };
+        }
+    });
+    return client;
+};
+
 function init(cloud) {
     if (!cloud) {
         throw new Error('cloud is required');
@@ -410,9 +515,10 @@ function init(cloud) {
     if (!cloud.callFunction) {
         throw new Error('cloud.callFunction is required');
     }
-    var OrmClientImpl = generateClient(cloud.callFunction.bind(cloud));
-    cloud.models = OrmClientImpl;
+    var ormClientImpl = generateClient(cloud.callFunction.bind(cloud));
+    cloud.models = ormClientImpl;
     return cloud;
 }
 
+exports.generateHTTPClient = generateHTTPClient;
 exports.init = init;

package/lib/wxCloudClientSDK.esm.js

@@ -141,7 +141,7 @@ function getUserAgent() {
         return ua_1;
     }
 }
-var VERSION = "1.2.0";
+var VERSION = "1.3.0";
 
 var callDataSource = function (_a) {
     var dataSourceName = _a.dataSourceName, methodName = _a.methodName, params = _a.params, realMethodName = _a.realMethodName, callFunction = _a.callFunction, _b = _a.envType, envType = _b === void 0 ? 'prod' : _b, mode = _a.mode;
@@ -263,6 +263,45 @@ var runMysqlCommand = function (_a) {
     });
 };
 
+var createRawQueryClient = function (callFunction) { return ({
+    $runSQL: function (sql, params, config) {
+        return __awaiter(this, void 0, void 0, function () {
+            var res;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, runMysqlCommand({
+                            sql: sql,
+                            params: params,
+                            config: __assign(__assign({}, config), { preparedStatements: true }),
+                            callFunction: callFunction
+                        })];
+                    case 1:
+                        res = _a.sent();
+                        return [2 /*return*/, res];
+                }
+            });
+        });
+    },
+    $runSQLRaw: function (sql, config) {
+        return __awaiter(this, void 0, void 0, function () {
+            var res;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, runMysqlCommand({
+                            sql: sql,
+                            params: [],
+                            config: __assign(__assign({}, config), { preparedStatements: false }),
+                            callFunction: callFunction
+                        })];
+                    case 1:
+                        res = _a.sent();
+                        return [2 /*return*/, res];
+                }
+            });
+        });
+    }
+}); };
+
 var CRUD_METHODS = {
     create: {
         methodName: 'wedaCreateV2'
@@ -350,48 +389,11 @@ var generateClientByDataSourceName = function (dataSourceName, callFunction) {
 };
 // 使用 TypeScript 的 Proxy 来定义一个动态的客户端
 var generateClient = function (callFunction) {
-    var rawQueryClient = {
-        $runSQL: function (sql, params, config) {
-            return __awaiter(this, void 0, void 0, function () {
-                var res;
-                return __generator(this, function (_a) {
-                    switch (_a.label) {
-                        case 0: return [4 /*yield*/, runMysqlCommand({
-                                sql: sql,
-                                params: params,
-                                config: __assign(__assign({}, config), { preparedStatements: true }),
-                                callFunction: callFunction
-                            })];
-                        case 1:
-                            res = _a.sent();
-                            return [2 /*return*/, res];
-                    }
-                });
-            });
-        },
-        $runSQLRaw: function (sql, config) {
-            return __awaiter(this, void 0, void 0, function () {
-                var res;
-                return __generator(this, function (_a) {
-                    switch (_a.label) {
-                        case 0: return [4 /*yield*/, runMysqlCommand({
-                                sql: sql,
-                                params: [],
-                                config: __assign(__assign({}, config), { preparedStatements: false }),
-                                callFunction: callFunction
-                            })];
-                        case 1:
-                            res = _a.sent();
-                            return [2 /*return*/, res];
-                    }
-                });
-            });
-        }
-    };
+    var rawQueryClient = createRawQueryClient(callFunction);
     return new Proxy({}, {
         get: function (target, prop) {
             if (typeof prop === 'string') {
-                if (rawQueryClient.hasOwnProperty(prop)) {
+                if (Object.prototype.hasOwnProperty.call(rawQueryClient, prop)) {
                     return rawQueryClient[prop];
                 }
                 // 返回一个函数，这个函数接受任意参数并返回一个 Promise
@@ -401,6 +403,109 @@ var generateClient = function (callFunction) {
     });
 };
 
+var READ_DEFAULT_PARAMS = {
+    filter: {
+        where: {}
+    },
+    select: {
+        $master: true
+    }
+};
+function createDefaultMethod(methodName) {
+    return {
+        getUrl: function (modelName) { return "".concat(modelName, "/").concat(methodName); },
+        method: 'post'
+    };
+}
+var HTTP_DATA_MODEL_METHODS = {
+    get: __assign(__assign({}, createDefaultMethod('get')), { defaultParams: __assign({}, READ_DEFAULT_PARAMS) }),
+    list: __assign(__assign({}, createDefaultMethod('list')), { defaultParams: __assign({}, READ_DEFAULT_PARAMS) }),
+    create: createDefaultMethod('create'),
+    createMany: createDefaultMethod('createMany'),
+    update: __assign(__assign({}, createDefaultMethod('update')), { method: 'put' }),
+    updateMany: __assign(__assign({}, createDefaultMethod('updateMany')), { method: 'put' }),
+    upsert: createDefaultMethod('upsert'),
+    "delete": createDefaultMethod('delete'),
+    deleteMany: createDefaultMethod('deleteMany')
+};
+var UNKNOWN_ERROR_MESSAGE = 'Unknown error occurred';
+var NOT_SUPPORTED_CODE = 'NotSupported';
+var generateHTTPClient = function (callFunction, fetch, baseUrl) {
+    var rawQueryClient = createRawQueryClient(callFunction);
+    return new Proxy({}, {
+        get: function (_, modelName) {
+            if (typeof modelName !== 'string')
+                return undefined;
+            if (Object.prototype.hasOwnProperty.call(rawQueryClient, modelName)) {
+                return rawQueryClient[modelName];
+            }
+            return generateHTTPClientByDataSourceName(baseUrl, modelName, fetch);
+        }
+    });
+};
+var createWxCloudSDKError = function (message, modelName, methodName, code, requestId) {
+    return new WxCloudSDKError("\u3010\u9519\u8BEF\u3011".concat(message, "\n\u3010\u64CD\u4F5C\u3011\u8C03\u7528 models.").concat(modelName, ".").concat(methodName, "\n\u3010\u9519\u8BEF\u7801\u3011").concat(code, "\n\u3010\u8BF7\u6C42ID\u3011").concat(requestId), {
+        code: code,
+        requestId: requestId
+    });
+};
+var generateHTTPClientByDataSourceName = function (baseUrl, modelName, fetch) {
+    var client = new Proxy({}, {
+        get: function (_, methodName) {
+            var httpDataModelMethod = HTTP_DATA_MODEL_METHODS[methodName];
+            if (!httpDataModelMethod) {
+                var error = new Error("\u4E0D\u652F\u6301\u7684\u64CD\u4F5C: ".concat(methodName));
+                throw new WxCloudSDKError(error.message || UNKNOWN_ERROR_MESSAGE, {
+                    originError: error,
+                    code: NOT_SUPPORTED_CODE,
+                    requestId: 'N/A'
+                });
+            }
+            return function (params) {
+                if (params === void 0) { params = {}; }
+                return __awaiter(void 0, void 0, void 0, function () {
+                    var getUrl, method, _a, defaultParams, effectiveParams, url, result, error_1;
+                    var _b;
+                    return __generator(this, function (_c) {
+                        switch (_c.label) {
+                            case 0:
+                                getUrl = httpDataModelMethod.getUrl, method = httpDataModelMethod.method, _a = httpDataModelMethod.defaultParams, defaultParams = _a === void 0 ? {} : _a;
+                                effectiveParams = Object.assign({}, defaultParams, params);
+                                url = [baseUrl, getUrl(modelName)].join('/');
+                                _c.label = 1;
+                            case 1:
+                                _c.trys.push([1, 3, , 4]);
+                                return [4 /*yield*/, fetch({
+                                        url: url,
+                                        body: JSON.stringify(effectiveParams),
+                                        method: method
+                                    })];
+                            case 2:
+                                result = _c.sent();
+                                if (result.code) {
+                                    // 抛出错误
+                                    throw createWxCloudSDKError(result === null || result === void 0 ? void 0 : result.message, modelName, methodName, result === null || result === void 0 ? void 0 : result.code, result === null || result === void 0 ? void 0 : result.requestId);
+                                }
+                                if (methodName === 'get') {
+                                    // 和 callFunction 实现保持一致
+                                    Object.assign(result, { data: (_b = result.data.record) !== null && _b !== void 0 ? _b : result.data });
+                                }
+                                return [2 /*return*/, result];
+                            case 3:
+                                error_1 = _c.sent();
+                                throw new WxCloudSDKError((error_1 === null || error_1 === void 0 ? void 0 : error_1.message) || UNKNOWN_ERROR_MESSAGE, {
+                                    originError: error_1
+                                });
+                            case 4: return [2 /*return*/];
+                        }
+                    });
+                });
+            };
+        }
+    });
+    return client;
+};
+
 function init(cloud) {
     if (!cloud) {
         throw new Error('cloud is required');
@@ -408,9 +513,9 @@ function init(cloud) {
     if (!cloud.callFunction) {
         throw new Error('cloud.callFunction is required');
     }
-    var OrmClientImpl = generateClient(cloud.callFunction.bind(cloud));
-    cloud.models = OrmClientImpl;
+    var ormClientImpl = generateClient(cloud.callFunction.bind(cloud));
+    cloud.models = ormClientImpl;
     return cloud;
 }
 
-export { init };
+export { generateHTTPClient, init };

package/lib/wxCloudClientSDK.umd.js

@@ -147,7 +147,7 @@
             return ua_1;
         }
     }
-    var VERSION = "1.2.0";
+    var VERSION = "1.3.0";
 
     var callDataSource = function (_a) {
         var dataSourceName = _a.dataSourceName, methodName = _a.methodName, params = _a.params, realMethodName = _a.realMethodName, callFunction = _a.callFunction, _b = _a.envType, envType = _b === void 0 ? 'prod' : _b, mode = _a.mode;
@@ -269,6 +269,45 @@
         });
     };
 
+    var createRawQueryClient = function (callFunction) { return ({
+        $runSQL: function (sql, params, config) {
+            return __awaiter(this, void 0, void 0, function () {
+                var res;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0: return [4 /*yield*/, runMysqlCommand({
+                                sql: sql,
+                                params: params,
+                                config: __assign(__assign({}, config), { preparedStatements: true }),
+                                callFunction: callFunction
+                            })];
+                        case 1:
+                            res = _a.sent();
+                            return [2 /*return*/, res];
+                    }
+                });
+            });
+        },
+        $runSQLRaw: function (sql, config) {
+            return __awaiter(this, void 0, void 0, function () {
+                var res;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0: return [4 /*yield*/, runMysqlCommand({
+                                sql: sql,
+                                params: [],
+                                config: __assign(__assign({}, config), { preparedStatements: false }),
+                                callFunction: callFunction
+                            })];
+                        case 1:
+                            res = _a.sent();
+                            return [2 /*return*/, res];
+                    }
+                });
+            });
+        }
+    }); };
+
     var CRUD_METHODS = {
         create: {
             methodName: 'wedaCreateV2'
@@ -356,48 +395,11 @@
     };
     // 使用 TypeScript 的 Proxy 来定义一个动态的客户端
     var generateClient = function (callFunction) {
-        var rawQueryClient = {
-            $runSQL: function (sql, params, config) {
-                return __awaiter(this, void 0, void 0, function () {
-                    var res;
-                    return __generator(this, function (_a) {
-                        switch (_a.label) {
-                            case 0: return [4 /*yield*/, runMysqlCommand({
-                                    sql: sql,
-                                    params: params,
-                                    config: __assign(__assign({}, config), { preparedStatements: true }),
-                                    callFunction: callFunction
-                                })];
-                            case 1:
-                                res = _a.sent();
-                                return [2 /*return*/, res];
-                        }
-                    });
-                });
-            },
-            $runSQLRaw: function (sql, config) {
-                return __awaiter(this, void 0, void 0, function () {
-                    var res;
-                    return __generator(this, function (_a) {
-                        switch (_a.label) {
-                            case 0: return [4 /*yield*/, runMysqlCommand({
-                                    sql: sql,
-                                    params: [],
-                                    config: __assign(__assign({}, config), { preparedStatements: false }),
-                                    callFunction: callFunction
-                                })];
-                            case 1:
-                                res = _a.sent();
-                                return [2 /*return*/, res];
-                        }
-                    });
-                });
-            }
-        };
+        var rawQueryClient = createRawQueryClient(callFunction);
         return new Proxy({}, {
             get: function (target, prop) {
                 if (typeof prop === 'string') {
-                    if (rawQueryClient.hasOwnProperty(prop)) {
+                    if (Object.prototype.hasOwnProperty.call(rawQueryClient, prop)) {
                         return rawQueryClient[prop];
                     }
                     // 返回一个函数，这个函数接受任意参数并返回一个 Promise
@@ -407,6 +409,109 @@
         });
     };
 
+    var READ_DEFAULT_PARAMS = {
+        filter: {
+            where: {}
+        },
+        select: {
+            $master: true
+        }
+    };
+    function createDefaultMethod(methodName) {
+        return {
+            getUrl: function (modelName) { return "".concat(modelName, "/").concat(methodName); },
+            method: 'post'
+        };
+    }
+    var HTTP_DATA_MODEL_METHODS = {
+        get: __assign(__assign({}, createDefaultMethod('get')), { defaultParams: __assign({}, READ_DEFAULT_PARAMS) }),
+        list: __assign(__assign({}, createDefaultMethod('list')), { defaultParams: __assign({}, READ_DEFAULT_PARAMS) }),
+        create: createDefaultMethod('create'),
+        createMany: createDefaultMethod('createMany'),
+        update: __assign(__assign({}, createDefaultMethod('update')), { method: 'put' }),
+        updateMany: __assign(__assign({}, createDefaultMethod('updateMany')), { method: 'put' }),
+        upsert: createDefaultMethod('upsert'),
+        "delete": createDefaultMethod('delete'),
+        deleteMany: createDefaultMethod('deleteMany')
+    };
+    var UNKNOWN_ERROR_MESSAGE = 'Unknown error occurred';
+    var NOT_SUPPORTED_CODE = 'NotSupported';
+    var generateHTTPClient = function (callFunction, fetch, baseUrl) {
+        var rawQueryClient = createRawQueryClient(callFunction);
+        return new Proxy({}, {
+            get: function (_, modelName) {
+                if (typeof modelName !== 'string')
+                    return undefined;
+                if (Object.prototype.hasOwnProperty.call(rawQueryClient, modelName)) {
+                    return rawQueryClient[modelName];
+                }
+                return generateHTTPClientByDataSourceName(baseUrl, modelName, fetch);
+            }
+        });
+    };
+    var createWxCloudSDKError = function (message, modelName, methodName, code, requestId) {
+        return new WxCloudSDKError("\u3010\u9519\u8BEF\u3011".concat(message, "\n\u3010\u64CD\u4F5C\u3011\u8C03\u7528 models.").concat(modelName, ".").concat(methodName, "\n\u3010\u9519\u8BEF\u7801\u3011").concat(code, "\n\u3010\u8BF7\u6C42ID\u3011").concat(requestId), {
+            code: code,
+            requestId: requestId
+        });
+    };
+    var generateHTTPClientByDataSourceName = function (baseUrl, modelName, fetch) {
+        var client = new Proxy({}, {
+            get: function (_, methodName) {
+                var httpDataModelMethod = HTTP_DATA_MODEL_METHODS[methodName];
+                if (!httpDataModelMethod) {
+                    var error = new Error("\u4E0D\u652F\u6301\u7684\u64CD\u4F5C: ".concat(methodName));
+                    throw new WxCloudSDKError(error.message || UNKNOWN_ERROR_MESSAGE, {
+                        originError: error,
+                        code: NOT_SUPPORTED_CODE,
+                        requestId: 'N/A'
+                    });
+                }
+                return function (params) {
+                    if (params === void 0) { params = {}; }
+                    return __awaiter(void 0, void 0, void 0, function () {
+                        var getUrl, method, _a, defaultParams, effectiveParams, url, result, error_1;
+                        var _b;
+                        return __generator(this, function (_c) {
+                            switch (_c.label) {
+                                case 0:
+                                    getUrl = httpDataModelMethod.getUrl, method = httpDataModelMethod.method, _a = httpDataModelMethod.defaultParams, defaultParams = _a === void 0 ? {} : _a;
+                                    effectiveParams = Object.assign({}, defaultParams, params);
+                                    url = [baseUrl, getUrl(modelName)].join('/');
+                                    _c.label = 1;
+                                case 1:
+                                    _c.trys.push([1, 3, , 4]);
+                                    return [4 /*yield*/, fetch({
+                                            url: url,
+                                            body: JSON.stringify(effectiveParams),
+                                            method: method
+                                        })];
+                                case 2:
+                                    result = _c.sent();
+                                    if (result.code) {
+                                        // 抛出错误
+                                        throw createWxCloudSDKError(result === null || result === void 0 ? void 0 : result.message, modelName, methodName, result === null || result === void 0 ? void 0 : result.code, result === null || result === void 0 ? void 0 : result.requestId);
+                                    }
+                                    if (methodName === 'get') {
+                                        // 和 callFunction 实现保持一致
+                                        Object.assign(result, { data: (_b = result.data.record) !== null && _b !== void 0 ? _b : result.data });
+                                    }
+                                    return [2 /*return*/, result];
+                                case 3:
+                                    error_1 = _c.sent();
+                                    throw new WxCloudSDKError((error_1 === null || error_1 === void 0 ? void 0 : error_1.message) || UNKNOWN_ERROR_MESSAGE, {
+                                        originError: error_1
+                                    });
+                                case 4: return [2 /*return*/];
+                            }
+                        });
+                    });
+                };
+            }
+        });
+        return client;
+    };
+
     function init(cloud) {
         if (!cloud) {
             throw new Error('cloud is required');
@@ -414,11 +519,12 @@
         if (!cloud.callFunction) {
             throw new Error('cloud.callFunction is required');
         }
-        var OrmClientImpl = generateClient(cloud.callFunction.bind(cloud));
-        cloud.models = OrmClientImpl;
+        var ormClientImpl = generateClient(cloud.callFunction.bind(cloud));
+        cloud.models = ormClientImpl;
         return cloud;
     }
 
+    exports.generateHTTPClient = generateHTTPClient;
     exports.init = init;
 
 }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbase/wx-cloud-client-sdk",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "publishConfig": {
     "access": "public"
   },
@@ -26,6 +26,8 @@
     "deploy": "node ./scripts/deploy.mjs"
   },
   "devDependencies": {
+    "@cloudbase/adapter-interface": "^0.5.0",
+    "@cloudbase/js-sdk": "2.8.15-beta.0",
     "@rollup/plugin-commonjs": "^25.0.8",
     "@rollup/plugin-node-resolve": "^15.2.3",
     "@rollup/plugin-replace": "^5.0.7",
@@ -33,6 +35,7 @@
     "@tcwd/dev-tools": "^1.0.1",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
+    "node-fetch": "2",
     "parcel-bundler": "1.6.1",
     "rollup": "^4.18.0",
     "ts-jest": "^29.2.2",