@cloudcome/utils-uni 1.12.0 → 1.14.0

package/dist/_helpers.cjs

@@ -1,10 +1,22 @@
 "use strict";
 const error = require("@cloudcome/utils-core/error");
-function parseCloudObjectOutput(output, fallbackErrorMessage = "") {
+const object = require("@cloudcome/utils-core/object");
+function parseCloudMethodOutput(output, fallbackErrorMessage = "") {
   if (output.errCode) {
     throw error.errorAssign(new Error(output.errMsg || fallbackErrorMessage), output);
   }
   return output.data;
 }
-exports.parseCloudObjectOutput = parseCloudObjectOutput;
+function parseDatabaseOutput(res) {
+  const keys = Object.keys(res);
+  const isClient = keys.length === 1 && keys[0] === "result";
+  if (isClient) {
+    const { result } = res;
+    if (!result.errCode) return object.objectOmit(result, ["errCode", "errMsg", "code", "message"]);
+    throw error.errorAssign(new Error(result.errMsg), result);
+  }
+  return res;
+}
+exports.parseCloudMethodOutput = parseCloudMethodOutput;
+exports.parseDatabaseOutput = parseDatabaseOutput;
 //# sourceMappingURL=_helpers.cjs.map

package/dist/_helpers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"_helpers.cjs","sources":["../src/_helpers.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\nimport type { UniCloudObjectOutput } from './cloud';\n\n/**\n * 解析云对象输出结果\n * @param output 云对象输出结果\n * @param fallbackErrorMessage 错误信息\n * @returns 返回云对象输出结果中的数据\n */\nexport function parseCloudObjectOutput<O>(output: UniCloudObjectOutput<O>, fallbackErrorMessage = ''): O {\n  if (output.errCode) {\n    throw errorAssign(new Error(output.errMsg || fallbackErrorMessage), output);\n  }\n\n  return output.data;\n}\n"],"names":["errorAssign"],"mappings":";;AASgB,SAAA,uBAA0B,QAAiC,uBAAuB,IAAO;AACvG,MAAI,OAAO,SAAS;AAClB,UAAMA,MAAAA,YAAY,IAAI,MAAM,OAAO,UAAU,oBAAoB,GAAG,MAAM;AAAA,EAAA;AAG5E,SAAO,OAAO;AAChB;;"}
+{"version":3,"file":"_helpers.cjs","sources":["../src/_helpers.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\nimport { objectOmit } from '@cloudcome/utils-core/object';\nimport type { CloudMethodOutput } from './cloud';\nimport type { ClientDatabaseOutput, CloudDatabaseOutput } from './database';\n\n/**\n * 解析云对象方法调用的输出结果\n *\n * @template O - 云对象方法返回数据的类型\n * @param output - 云对象方法调用的输出结果\n * @param fallbackErrorMessage - 当输出中没有错误信息时使用的默认错误消息\n * @returns 云对象方法返回成功时的数据部分\n * @throws 当云对象方法调用失败时，抛出包含错误信息的异常\n */\nexport function parseCloudMethodOutput<O>(output: CloudMethodOutput<O>, fallbackErrorMessage = ''): O {\n  if (output.errCode) {\n    throw errorAssign(new Error(output.errMsg || fallbackErrorMessage), output);\n  }\n\n  return output.data;\n}\n\n/**\n * 解析数据库执行结果\n * @param res 客户端、云端响应结果\n * @returns 处理后的结果\n */\nexport function parseDatabaseOutput<T>(res: ClientDatabaseOutput<T> | CloudDatabaseOutput<T>) {\n  const keys = Object.keys(res as AnyObject);\n  // 客户端 { result: {errCode: 0, errMsg: 'ok'} & 数据 }\n  const isClient = keys.length === 1 && keys[0] === 'result';\n\n  if (isClient) {\n    const { result } = res as ClientDatabaseOutput<T>;\n    if (!result.errCode) return objectOmit(result, ['errCode', 'errMsg', 'code', 'message']);\n    throw errorAssign(new Error(result.errMsg), result);\n  }\n\n  // 云端 数据\n  return res as T;\n}\n"],"names":["errorAssign","objectOmit"],"mappings":";;;AAcgB,SAAA,uBAA0B,QAA8B,uBAAuB,IAAO;AACpG,MAAI,OAAO,SAAS;AAClB,UAAMA,MAAAA,YAAY,IAAI,MAAM,OAAO,UAAU,oBAAoB,GAAG,MAAM;AAAA,EAAA;AAG5E,SAAO,OAAO;AAChB;AAOO,SAAS,oBAAuB,KAAuD;AACtF,QAAA,OAAO,OAAO,KAAK,GAAgB;AAEzC,QAAM,WAAW,KAAK,WAAW,KAAK,KAAK,CAAC,MAAM;AAElD,MAAI,UAAU;AACN,UAAA,EAAE,WAAW;AACf,QAAA,CAAC,OAAO,QAAgB,QAAAC,kBAAW,QAAQ,CAAC,WAAW,UAAU,QAAQ,SAAS,CAAC;AACvF,UAAMD,MAAAA,YAAY,IAAI,MAAM,OAAO,MAAM,GAAG,MAAM;AAAA,EAAA;AAI7C,SAAA;AACT;;;"}

package/dist/_helpers.d.ts

@@ -1,8 +1,23 @@
-import { UniCloudObjectOutput } from './cloud';
+import { CloudMethodOutput } from './cloud';
+import { ClientDatabaseOutput, CloudDatabaseOutput } from './database';
 /**
- * 解析云对象输出结果
- * @param output 云对象输出结果
- * @param fallbackErrorMessage 错误信息
- * @returns 返回云对象输出结果中的数据
+ * 解析云对象方法调用的输出结果
+ *
+ * @template O - 云对象方法返回数据的类型
+ * @param output - 云对象方法调用的输出结果
+ * @param fallbackErrorMessage - 当输出中没有错误信息时使用的默认错误消息
+ * @returns 云对象方法返回成功时的数据部分
+ * @throws 当云对象方法调用失败时，抛出包含错误信息的异常
  */
-export declare function parseCloudObjectOutput<O>(output: UniCloudObjectOutput<O>, fallbackErrorMessage?: string): O;
+export declare function parseCloudMethodOutput<O>(output: CloudMethodOutput<O>, fallbackErrorMessage?: string): O;
+/**
+ * 解析数据库执行结果
+ * @param res 客户端、云端响应结果
+ * @returns 处理后的结果
+ */
+export declare function parseDatabaseOutput<T>(res: ClientDatabaseOutput<T> | CloudDatabaseOutput<T>): T | Omit<T & {
+    code?: number | string;
+    errCode?: number | string;
+    errMsg?: string;
+    message?: string;
+}, "errCode" | "errMsg" | "code" | "message">;

package/dist/_helpers.mjs

@@ -1,11 +1,23 @@
 import { errorAssign } from "@cloudcome/utils-core/error";
-function parseCloudObjectOutput(output, fallbackErrorMessage = "") {
+import { objectOmit } from "@cloudcome/utils-core/object";
+function parseCloudMethodOutput(output, fallbackErrorMessage = "") {
   if (output.errCode) {
     throw errorAssign(new Error(output.errMsg || fallbackErrorMessage), output);
   }
   return output.data;
 }
+function parseDatabaseOutput(res) {
+  const keys = Object.keys(res);
+  const isClient = keys.length === 1 && keys[0] === "result";
+  if (isClient) {
+    const { result } = res;
+    if (!result.errCode) return objectOmit(result, ["errCode", "errMsg", "code", "message"]);
+    throw errorAssign(new Error(result.errMsg), result);
+  }
+  return res;
+}
 export {
-  parseCloudObjectOutput as p
+  parseDatabaseOutput as a,
+  parseCloudMethodOutput as p
 };
 //# sourceMappingURL=_helpers.mjs.map

package/dist/_helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_helpers.mjs","sources":["../src/_helpers.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\nimport type { UniCloudObjectOutput } from './cloud';\n\n/**\n * 解析云对象输出结果\n * @param output 云对象输出结果\n * @param fallbackErrorMessage 错误信息\n * @returns 返回云对象输出结果中的数据\n */\nexport function parseCloudObjectOutput<O>(output: UniCloudObjectOutput<O>, fallbackErrorMessage = ''): O {\n  if (output.errCode) {\n    throw errorAssign(new Error(output.errMsg || fallbackErrorMessage), output);\n  }\n\n  return output.data;\n}\n"],"names":[],"mappings":";AASgB,SAAA,uBAA0B,QAAiC,uBAAuB,IAAO;AACvG,MAAI,OAAO,SAAS;AAClB,UAAM,YAAY,IAAI,MAAM,OAAO,UAAU,oBAAoB,GAAG,MAAM;AAAA,EAAA;AAG5E,SAAO,OAAO;AAChB;"}
+{"version":3,"file":"_helpers.mjs","sources":["../src/_helpers.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\nimport { objectOmit } from '@cloudcome/utils-core/object';\nimport type { CloudMethodOutput } from './cloud';\nimport type { ClientDatabaseOutput, CloudDatabaseOutput } from './database';\n\n/**\n * 解析云对象方法调用的输出结果\n *\n * @template O - 云对象方法返回数据的类型\n * @param output - 云对象方法调用的输出结果\n * @param fallbackErrorMessage - 当输出中没有错误信息时使用的默认错误消息\n * @returns 云对象方法返回成功时的数据部分\n * @throws 当云对象方法调用失败时，抛出包含错误信息的异常\n */\nexport function parseCloudMethodOutput<O>(output: CloudMethodOutput<O>, fallbackErrorMessage = ''): O {\n  if (output.errCode) {\n    throw errorAssign(new Error(output.errMsg || fallbackErrorMessage), output);\n  }\n\n  return output.data;\n}\n\n/**\n * 解析数据库执行结果\n * @param res 客户端、云端响应结果\n * @returns 处理后的结果\n */\nexport function parseDatabaseOutput<T>(res: ClientDatabaseOutput<T> | CloudDatabaseOutput<T>) {\n  const keys = Object.keys(res as AnyObject);\n  // 客户端 { result: {errCode: 0, errMsg: 'ok'} & 数据 }\n  const isClient = keys.length === 1 && keys[0] === 'result';\n\n  if (isClient) {\n    const { result } = res as ClientDatabaseOutput<T>;\n    if (!result.errCode) return objectOmit(result, ['errCode', 'errMsg', 'code', 'message']);\n    throw errorAssign(new Error(result.errMsg), result);\n  }\n\n  // 云端 数据\n  return res as T;\n}\n"],"names":[],"mappings":";;AAcgB,SAAA,uBAA0B,QAA8B,uBAAuB,IAAO;AACpG,MAAI,OAAO,SAAS;AAClB,UAAM,YAAY,IAAI,MAAM,OAAO,UAAU,oBAAoB,GAAG,MAAM;AAAA,EAAA;AAG5E,SAAO,OAAO;AAChB;AAOO,SAAS,oBAAuB,KAAuD;AACtF,QAAA,OAAO,OAAO,KAAK,GAAgB;AAEzC,QAAM,WAAW,KAAK,WAAW,KAAK,KAAK,CAAC,MAAM;AAElD,MAAI,UAAU;AACN,UAAA,EAAE,WAAW;AACf,QAAA,CAAC,OAAO,QAAgB,QAAA,WAAW,QAAQ,CAAC,WAAW,UAAU,QAAQ,SAAS,CAAC;AACvF,UAAM,YAAY,IAAI,MAAM,OAAO,MAAM,GAAG,MAAM;AAAA,EAAA;AAI7C,SAAA;AACT;"}

package/dist/client.cjs

@@ -2,16 +2,17 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const request = require("@cloudcome/utils-vue/request");
 const _helpers = require("./_helpers.cjs");
-function createUseCloudObject(objectName, options) {
+function importCloudObject(objectName, options) {
   const server = options?._mockServer || uniCloud.importObject(objectName, options);
   const fallbackErrorMessage = options?.fallbackErrorMessage || "请求失败";
-  const useCloudObject = (caller, options2) => {
+  const useCloudMethod = (method, caller, options2) => {
     return request.useRequest(async (...inputs) => {
-      const result = await caller(server, ...inputs);
-      return _helpers.parseCloudObjectOutput(result, fallbackErrorMessage);
+      const request2 = server[method];
+      const output = await caller(request2, ...inputs);
+      return _helpers.parseCloudMethodOutput(output, fallbackErrorMessage);
     }, options2);
   };
-  return useCloudObject;
+  return useCloudMethod;
 }
 function useDatabase(caller, options) {
   const db = options?._mockDatabase || uniCloud.database();
@@ -21,7 +22,7 @@ function useDatabase(caller, options) {
     throw new Error(result.errMsg || "请求失败");
   }, options);
 }
-exports.parseCloudObjectOutput = _helpers.parseCloudObjectOutput;
-exports.createUseCloudObject = createUseCloudObject;
+exports.parseCloudMethodOutput = _helpers.parseCloudMethodOutput;
+exports.importCloudObject = importCloudObject;
 exports.useDatabase = useDatabase;
 //# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.cjs","sources":["../src/client.ts"],"sourcesContent":["import type { UniCloudObjectOutput } from '@/cloud';\nimport type { UniClientDatabaseOutput } from '@/database';\nimport type { AnyArray } from '@cloudcome/utils-core/types';\nimport {\n  type UseRequestOptions,\n  type UseRequestOutput,\n  type UseRequestOutputFilled,\n  useRequest,\n} from '@cloudcome/utils-vue/request';\nimport { parseCloudObjectOutput } from './_helpers';\n\ntype ImportObject = UniCloudNamespace.UniCloud['importObject'];\ntype ImportObjectArgs = Parameters<ImportObject>;\n\nexport type UniCloudObjectServer<O> = Record<string, (...inputs: unknown[]) => Promise<UniCloudObjectOutput<O>>>;\n\nexport type CreateUseCloudObjectOptions = ImportObjectArgs[1] & {\n  /**\n   * 模拟云对象，用于单元测试\n   * @private\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockServer?: any;\n\n  /**\n   * 回退错误信息\n   * @default '请求失败'\n   */\n  fallbackErrorMessage?: string;\n};\n\nexport type UseCloudObject = {\n  <I extends AnyArray, O>(\n    caller: (server: UniCloudObjectServer<O>, ...inputs: I) => Promise<UniCloudObjectOutput<O>>,\n    options: Omit<UseRequestOptions<I, O>, 'placeholder'> & { placeholder: () => O },\n  ): UseRequestOutputFilled<I, O>;\n  <I extends AnyArray, O>(\n    caller: (server: UniCloudObjectServer<O>, ...inputs: I) => Promise<UniCloudObjectOutput<O>>,\n    options?: UseRequestOptions<I, O>,\n  ): UseRequestOutput<I, O>;\n};\n\n/**\n * 创建一个用于调用云对象的hook工厂函数\n * @param objectName 云对象名称，用于导入对应的云对象\n * @param options 导入云对象时的可选配置参数\n * @returns 返回一个函数，该函数可以用于创建云对象调用hook\n */\nexport function createUseCloudObject(objectName: ImportObjectArgs[0], options?: CreateUseCloudObjectOptions) {\n  const server = options?._mockServer || uniCloud.importObject(objectName, options);\n  const fallbackErrorMessage = options?.fallbackErrorMessage || '请求失败';\n  const useCloudObject: UseCloudObject = (caller, options) => {\n    // 使用请求hook处理云对象调用\n    return useRequest(async (...inputs) => {\n      const result = await caller(server, ...inputs);\n      return parseCloudObjectOutput(result, fallbackErrorMessage);\n    }, options);\n  };\n\n  return useCloudObject;\n}\n\nexport type UseDatabaseOptions<I extends AnyArray, O> = UseRequestOptions<I, O> & {\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any;\n};\n\n/**\n * 创建一个用于调用云数据库的hook\n * @param caller 调用云数据库的函数，接收数据库实例和输入参数，返回Promise\n * @param options 配置选项\n * @returns 返回一个请求hook，用于处理云数据库调用\n */\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (db: UniCloud.Database, ...inputs: I) => Promise<UniClientDatabaseOutput<O>>,\n  options: Omit<UseDatabaseOptions<I, O>, 'placeholder'> & { placeholder: () => O },\n): UseRequestOutputFilled<I, O>;\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (db: UniCloud.Database, ...inputs: I) => Promise<UniClientDatabaseOutput<O>>,\n  options?: UseDatabaseOptions<I, O>,\n): UseRequestOutput<I, O>;\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (db: UniCloud.Database, ...inputs: I) => Promise<UniClientDatabaseOutput<O>>,\n  options?: UseDatabaseOptions<I, O>,\n): UseRequestOutput<I, O> {\n  // 获取数据库实例，优先使用模拟数据库（用于测试），否则使用uniCloud数据库\n  const db = options?._mockDatabase || uniCloud.database();\n  return useRequest(async (...inputs: I) => {\n    const { result } = await caller(db, ...inputs);\n    if (!result.errCode) return result;\n    throw new Error(result.errMsg || '请求失败');\n  }, options);\n}\n\nexport { parseCloudObjectOutput } from './_helpers';\n"],"names":["options","useRequest","parseCloudObjectOutput"],"mappings":";;;;AAgDgB,SAAA,qBAAqB,YAAiC,SAAuC;AAC3G,QAAM,SAAS,SAAS,eAAe,SAAS,aAAa,YAAY,OAAO;AAC1E,QAAA,uBAAuB,SAAS,wBAAwB;AACxD,QAAA,iBAAiC,CAAC,QAAQA,aAAY;AAEnD,WAAAC,QAAA,WAAW,UAAU,WAAW;AACrC,YAAM,SAAS,MAAM,OAAO,QAAQ,GAAG,MAAM;AACtC,aAAAC,SAAA,uBAAuB,QAAQ,oBAAoB;AAAA,OACzDF,QAAO;AAAA,EACZ;AAEO,SAAA;AACT;AAwBgB,SAAA,YACd,QACA,SACwB;AAExB,QAAM,KAAK,SAAS,iBAAiB,SAAS,SAAS;AAChD,SAAAC,QAAA,WAAW,UAAU,WAAc;AACxC,UAAM,EAAE,OAAO,IAAI,MAAM,OAAO,IAAI,GAAG,MAAM;AACzC,QAAA,CAAC,OAAO,QAAgB,QAAA;AAC5B,UAAM,IAAI,MAAM,OAAO,UAAU,MAAM;AAAA,KACtC,OAAO;AACZ;;;;"}
+{"version":3,"file":"client.cjs","sources":["../src/client.ts"],"sourcesContent":["import type { CloudMethodOutput } from '@/cloud';\nimport type { ClientDatabaseOutput } from '@/database';\nimport type { AnyArray, AnyFunction } from '@cloudcome/utils-core/types';\nimport {\n  type UseRequestOptions,\n  type UseRequestOutput,\n  type UseRequestOutputFilled,\n  useRequest,\n} from '@cloudcome/utils-vue/request';\nimport { parseCloudMethodOutput } from './_helpers';\n\ntype _ImportObject = UniCloudNamespace.UniCloud['importObject'];\ntype _ImportObjectArgs = Parameters<_ImportObject>;\n\nexport type CreateUseCloudObjectOptions = _ImportObjectArgs[1] & {\n  /**\n   * 模拟云对象，用于单元测试\n   * @private\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockServer?: any;\n\n  /**\n   * 回退错误信息\n   * @default '请求失败'\n   */\n  fallbackErrorMessage?: string;\n};\n\n/**\n * 云对象请求函数类型定义\n * @template F 云对象方法函数类型\n * @param input 云对象方法的参数数组\n * @returns 返回云对象方法执行结果的Promise\n */\nexport type CloudObjectRequest = <F extends AnyFunction>(\n  ...input: Parameters<F>\n) => Promise<CloudMethodOutput<ReturnType<F>>>;\n\n/**\n * 用于调用云对象方法的hook函数类型定义\n * @template I 输入参数类型数组\n * @template O 输出结果类型\n */\nexport type UseCloudMethod = {\n  /**\n   * 重载签名：当提供 placeholder 选项时，返回包含初始值的输出类型\n   * @param method 云对象方法名\n   * @param caller 调用云对象方法的函数\n   * @param options 包含 placeholder 的请求配置选项\n   * @returns 返回包含初始值的请求输出\n   */\n  <I extends AnyArray, O>(\n    method: string,\n    caller: (request: CloudObjectRequest, ...inputs: I) => Promise<CloudMethodOutput<O>>,\n    options: Omit<UseRequestOptions<I, O>, 'placeholder'> & { placeholder: () => O },\n  ): UseRequestOutputFilled<I, O>;\n\n  /**\n   * 重载签名：当不提供 placeholder 选项时，返回普通输出类型\n   * @param method 云对象方法名\n   * @param caller 调用云对象方法的函数\n   * @param options 可选的请求配置选项\n   * @returns 返回普通的请求输出\n   */\n  <I extends AnyArray, O>(\n    method: string,\n    caller: (request: CloudObjectRequest, ...inputs: I) => Promise<CloudMethodOutput<O>>,\n    options?: UseRequestOptions<I, O>,\n  ): UseRequestOutput<I, O>;\n};\n/**\n * 导入云对象并创建一个用于调用云对象的hook\n * @param objectName 云对象名称\n * @param options 配置选项，包含模拟服务器、回退错误信息等\n * @returns 返回一个可用于调用云对象方法的hook函数\n */\nexport function importCloudObject(objectName: _ImportObjectArgs[0], options?: CreateUseCloudObjectOptions) {\n  const server = options?._mockServer || uniCloud.importObject(objectName, options);\n  const fallbackErrorMessage = options?.fallbackErrorMessage || '请求失败';\n\n  /**\n   * 用于调用云对象方法的hook函数\n   * @template I 输入参数类型\n   * @template O 输出结果类型\n   * @param method 云对象方法名\n   * @param caller 调用云对象的函数\n   * @param options 配置选项，包含请求相关的配置\n   * @returns 返回一个请求hook，用于处理云对象调用\n   */\n  const useCloudMethod: UseCloudMethod = (method, caller, options) => {\n    // 使用请求hook处理云对象调用\n    return useRequest(async (...inputs) => {\n      const request = server[method];\n      const output = await caller(request, ...inputs);\n      return parseCloudMethodOutput(output, fallbackErrorMessage);\n    }, options);\n  };\n\n  return useCloudMethod;\n}\n\nexport type UseDatabaseOptions<I extends AnyArray, O> = UseRequestOptions<I, O> & {\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any;\n};\n\n/**\n * 创建一个用于调用云数据库的hook\n * @param caller 调用云数据库的函数，接收数据库实例和输入参数，返回Promise\n * @param options 配置选项\n * @returns 返回一个请求hook，用于处理云数据库调用\n */\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (db: UniCloud.Database, ...inputs: I) => Promise<ClientDatabaseOutput<O>>,\n  options: Omit<UseDatabaseOptions<I, O>, 'placeholder'> & { placeholder: () => O },\n): UseRequestOutputFilled<I, O>;\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (db: UniCloud.Database, ...inputs: I) => Promise<ClientDatabaseOutput<O>>,\n  options?: UseDatabaseOptions<I, O>,\n): UseRequestOutput<I, O>;\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (db: UniCloud.Database, ...inputs: I) => Promise<ClientDatabaseOutput<O>>,\n  options?: UseDatabaseOptions<I, O>,\n): UseRequestOutput<I, O> {\n  // 获取数据库实例，优先使用模拟数据库（用于测试），否则使用uniCloud数据库\n  const db = options?._mockDatabase || uniCloud.database();\n  return useRequest(async (...inputs: I) => {\n    const { result } = await caller(db, ...inputs);\n    if (!result.errCode) return result;\n    throw new Error(result.errMsg || '请求失败');\n  }, options);\n}\n\nexport { parseCloudMethodOutput } from './_helpers';\n"],"names":["options","useRequest","request","parseCloudMethodOutput"],"mappings":";;;;AA6EgB,SAAA,kBAAkB,YAAkC,SAAuC;AACzG,QAAM,SAAS,SAAS,eAAe,SAAS,aAAa,YAAY,OAAO;AAC1E,QAAA,uBAAuB,SAAS,wBAAwB;AAW9D,QAAM,iBAAiC,CAAC,QAAQ,QAAQA,aAAY;AAE3D,WAAAC,QAAA,WAAW,UAAU,WAAW;AAC/B,YAAAC,WAAU,OAAO,MAAM;AAC7B,YAAM,SAAS,MAAM,OAAOA,UAAS,GAAG,MAAM;AACvC,aAAAC,SAAA,uBAAuB,QAAQ,oBAAoB;AAAA,OACzDH,QAAO;AAAA,EACZ;AAEO,SAAA;AACT;AAwBgB,SAAA,YACd,QACA,SACwB;AAExB,QAAM,KAAK,SAAS,iBAAiB,SAAS,SAAS;AAChD,SAAAC,QAAA,WAAW,UAAU,WAAc;AACxC,UAAM,EAAE,OAAO,IAAI,MAAM,OAAO,IAAI,GAAG,MAAM;AACzC,QAAA,CAAC,OAAO,QAAgB,QAAA;AAC5B,UAAM,IAAI,MAAM,OAAO,UAAU,MAAM;AAAA,KACtC,OAAO;AACZ;;;;"}

package/dist/client.d.ts

@@ -1,11 +1,10 @@
-import { UniCloudObjectOutput } from './cloud';
-import { UniClientDatabaseOutput } from './database';
-import { AnyArray } from '@cloudcome/utils-core/types';
+import { CloudMethodOutput } from './cloud';
+import { ClientDatabaseOutput } from './database';
+import { AnyArray, AnyFunction } from '@cloudcome/utils-core/types';
 import { UseRequestOptions, UseRequestOutput, UseRequestOutputFilled } from '@cloudcome/utils-vue/request';
-type ImportObject = UniCloudNamespace.UniCloud['importObject'];
-type ImportObjectArgs = Parameters<ImportObject>;
-export type UniCloudObjectServer<O> = Record<string, (...inputs: unknown[]) => Promise<UniCloudObjectOutput<O>>>;
-export type CreateUseCloudObjectOptions = ImportObjectArgs[1] & {
+type _ImportObject = UniCloudNamespace.UniCloud['importObject'];
+type _ImportObjectArgs = Parameters<_ImportObject>;
+export type CreateUseCloudObjectOptions = _ImportObjectArgs[1] & {
     /**
      * 模拟云对象，用于单元测试
      * @private
@@ -17,19 +16,45 @@ export type CreateUseCloudObjectOptions = ImportObjectArgs[1] & {
      */
     fallbackErrorMessage?: string;
 };
-export type UseCloudObject = {
-    <I extends AnyArray, O>(caller: (server: UniCloudObjectServer<O>, ...inputs: I) => Promise<UniCloudObjectOutput<O>>, options: Omit<UseRequestOptions<I, O>, 'placeholder'> & {
+/**
+ * 云对象请求函数类型定义
+ * @template F 云对象方法函数类型
+ * @param input 云对象方法的参数数组
+ * @returns 返回云对象方法执行结果的Promise
+ */
+export type CloudObjectRequest = <F extends AnyFunction>(...input: Parameters<F>) => Promise<CloudMethodOutput<ReturnType<F>>>;
+/**
+ * 用于调用云对象方法的hook函数类型定义
+ * @template I 输入参数类型数组
+ * @template O 输出结果类型
+ */
+export type UseCloudMethod = {
+    /**
+     * 重载签名：当提供 placeholder 选项时，返回包含初始值的输出类型
+     * @param method 云对象方法名
+     * @param caller 调用云对象方法的函数
+     * @param options 包含 placeholder 的请求配置选项
+     * @returns 返回包含初始值的请求输出
+     */
+    <I extends AnyArray, O>(method: string, caller: (request: CloudObjectRequest, ...inputs: I) => Promise<CloudMethodOutput<O>>, options: Omit<UseRequestOptions<I, O>, 'placeholder'> & {
         placeholder: () => O;
     }): UseRequestOutputFilled<I, O>;
-    <I extends AnyArray, O>(caller: (server: UniCloudObjectServer<O>, ...inputs: I) => Promise<UniCloudObjectOutput<O>>, options?: UseRequestOptions<I, O>): UseRequestOutput<I, O>;
+    /**
+     * 重载签名：当不提供 placeholder 选项时，返回普通输出类型
+     * @param method 云对象方法名
+     * @param caller 调用云对象方法的函数
+     * @param options 可选的请求配置选项
+     * @returns 返回普通的请求输出
+     */
+    <I extends AnyArray, O>(method: string, caller: (request: CloudObjectRequest, ...inputs: I) => Promise<CloudMethodOutput<O>>, options?: UseRequestOptions<I, O>): UseRequestOutput<I, O>;
 };
 /**
- * 创建一个用于调用云对象的hook工厂函数
- * @param objectName 云对象名称，用于导入对应的云对象
- * @param options 导入云对象时的可选配置参数
- * @returns 返回一个函数，该函数可以用于创建云对象调用hook
+ * 导入云对象并创建一个用于调用云对象的hook
+ * @param objectName 云对象名称
+ * @param options 配置选项，包含模拟服务器、回退错误信息等
+ * @returns 返回一个可用于调用云对象方法的hook函数
  */
-export declare function createUseCloudObject(objectName: ImportObjectArgs[0], options?: CreateUseCloudObjectOptions): UseCloudObject;
+export declare function importCloudObject(objectName: _ImportObjectArgs[0], options?: CreateUseCloudObjectOptions): UseCloudMethod;
 export type UseDatabaseOptions<I extends AnyArray, O> = UseRequestOptions<I, O> & {
     /**
      * 模拟数据库，用于单元测试
@@ -42,8 +67,8 @@ export type UseDatabaseOptions<I extends AnyArray, O> = UseRequestOptions<I, O>
  * @param options 配置选项
  * @returns 返回一个请求hook，用于处理云数据库调用
  */
-export declare function useDatabase<I extends AnyArray, O>(caller: (db: UniCloud.Database, ...inputs: I) => Promise<UniClientDatabaseOutput<O>>, options: Omit<UseDatabaseOptions<I, O>, 'placeholder'> & {
+export declare function useDatabase<I extends AnyArray, O>(caller: (db: UniCloud.Database, ...inputs: I) => Promise<ClientDatabaseOutput<O>>, options: Omit<UseDatabaseOptions<I, O>, 'placeholder'> & {
     placeholder: () => O;
 }): UseRequestOutputFilled<I, O>;
-export declare function useDatabase<I extends AnyArray, O>(caller: (db: UniCloud.Database, ...inputs: I) => Promise<UniClientDatabaseOutput<O>>, options?: UseDatabaseOptions<I, O>): UseRequestOutput<I, O>;
-export { parseCloudObjectOutput } from './_helpers';
+export declare function useDatabase<I extends AnyArray, O>(caller: (db: UniCloud.Database, ...inputs: I) => Promise<ClientDatabaseOutput<O>>, options?: UseDatabaseOptions<I, O>): UseRequestOutput<I, O>;
+export { parseCloudMethodOutput } from './_helpers';

package/dist/client.mjs

@@ -1,15 +1,16 @@
 import { useRequest } from "@cloudcome/utils-vue/request";
-import { p as parseCloudObjectOutput } from "./_helpers.mjs";
-function createUseCloudObject(objectName, options) {
+import { p as parseCloudMethodOutput } from "./_helpers.mjs";
+function importCloudObject(objectName, options) {
   const server = options?._mockServer || uniCloud.importObject(objectName, options);
   const fallbackErrorMessage = options?.fallbackErrorMessage || "请求失败";
-  const useCloudObject = (caller, options2) => {
+  const useCloudMethod = (method, caller, options2) => {
     return useRequest(async (...inputs) => {
-      const result = await caller(server, ...inputs);
-      return parseCloudObjectOutput(result, fallbackErrorMessage);
+      const request = server[method];
+      const output = await caller(request, ...inputs);
+      return parseCloudMethodOutput(output, fallbackErrorMessage);
     }, options2);
   };
-  return useCloudObject;
+  return useCloudMethod;
 }
 function useDatabase(caller, options) {
   const db = options?._mockDatabase || uniCloud.database();
@@ -20,8 +21,8 @@ function useDatabase(caller, options) {
   }, options);
 }
 export {
-  createUseCloudObject,
-  parseCloudObjectOutput,
+  importCloudObject,
+  parseCloudMethodOutput,
   useDatabase
 };
 //# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.mjs","sources":["../src/client.ts"],"sourcesContent":["import type { UniCloudObjectOutput } from '@/cloud';\nimport type { UniClientDatabaseOutput } from '@/database';\nimport type { AnyArray } from '@cloudcome/utils-core/types';\nimport {\n  type UseRequestOptions,\n  type UseRequestOutput,\n  type UseRequestOutputFilled,\n  useRequest,\n} from '@cloudcome/utils-vue/request';\nimport { parseCloudObjectOutput } from './_helpers';\n\ntype ImportObject = UniCloudNamespace.UniCloud['importObject'];\ntype ImportObjectArgs = Parameters<ImportObject>;\n\nexport type UniCloudObjectServer<O> = Record<string, (...inputs: unknown[]) => Promise<UniCloudObjectOutput<O>>>;\n\nexport type CreateUseCloudObjectOptions = ImportObjectArgs[1] & {\n  /**\n   * 模拟云对象，用于单元测试\n   * @private\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockServer?: any;\n\n  /**\n   * 回退错误信息\n   * @default '请求失败'\n   */\n  fallbackErrorMessage?: string;\n};\n\nexport type UseCloudObject = {\n  <I extends AnyArray, O>(\n    caller: (server: UniCloudObjectServer<O>, ...inputs: I) => Promise<UniCloudObjectOutput<O>>,\n    options: Omit<UseRequestOptions<I, O>, 'placeholder'> & { placeholder: () => O },\n  ): UseRequestOutputFilled<I, O>;\n  <I extends AnyArray, O>(\n    caller: (server: UniCloudObjectServer<O>, ...inputs: I) => Promise<UniCloudObjectOutput<O>>,\n    options?: UseRequestOptions<I, O>,\n  ): UseRequestOutput<I, O>;\n};\n\n/**\n * 创建一个用于调用云对象的hook工厂函数\n * @param objectName 云对象名称，用于导入对应的云对象\n * @param options 导入云对象时的可选配置参数\n * @returns 返回一个函数，该函数可以用于创建云对象调用hook\n */\nexport function createUseCloudObject(objectName: ImportObjectArgs[0], options?: CreateUseCloudObjectOptions) {\n  const server = options?._mockServer || uniCloud.importObject(objectName, options);\n  const fallbackErrorMessage = options?.fallbackErrorMessage || '请求失败';\n  const useCloudObject: UseCloudObject = (caller, options) => {\n    // 使用请求hook处理云对象调用\n    return useRequest(async (...inputs) => {\n      const result = await caller(server, ...inputs);\n      return parseCloudObjectOutput(result, fallbackErrorMessage);\n    }, options);\n  };\n\n  return useCloudObject;\n}\n\nexport type UseDatabaseOptions<I extends AnyArray, O> = UseRequestOptions<I, O> & {\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any;\n};\n\n/**\n * 创建一个用于调用云数据库的hook\n * @param caller 调用云数据库的函数，接收数据库实例和输入参数，返回Promise\n * @param options 配置选项\n * @returns 返回一个请求hook，用于处理云数据库调用\n */\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (db: UniCloud.Database, ...inputs: I) => Promise<UniClientDatabaseOutput<O>>,\n  options: Omit<UseDatabaseOptions<I, O>, 'placeholder'> & { placeholder: () => O },\n): UseRequestOutputFilled<I, O>;\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (db: UniCloud.Database, ...inputs: I) => Promise<UniClientDatabaseOutput<O>>,\n  options?: UseDatabaseOptions<I, O>,\n): UseRequestOutput<I, O>;\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (db: UniCloud.Database, ...inputs: I) => Promise<UniClientDatabaseOutput<O>>,\n  options?: UseDatabaseOptions<I, O>,\n): UseRequestOutput<I, O> {\n  // 获取数据库实例，优先使用模拟数据库（用于测试），否则使用uniCloud数据库\n  const db = options?._mockDatabase || uniCloud.database();\n  return useRequest(async (...inputs: I) => {\n    const { result } = await caller(db, ...inputs);\n    if (!result.errCode) return result;\n    throw new Error(result.errMsg || '请求失败');\n  }, options);\n}\n\nexport { parseCloudObjectOutput } from './_helpers';\n"],"names":["options"],"mappings":";;AAgDgB,SAAA,qBAAqB,YAAiC,SAAuC;AAC3G,QAAM,SAAS,SAAS,eAAe,SAAS,aAAa,YAAY,OAAO;AAC1E,QAAA,uBAAuB,SAAS,wBAAwB;AACxD,QAAA,iBAAiC,CAAC,QAAQA,aAAY;AAEnD,WAAA,WAAW,UAAU,WAAW;AACrC,YAAM,SAAS,MAAM,OAAO,QAAQ,GAAG,MAAM;AACtC,aAAA,uBAAuB,QAAQ,oBAAoB;AAAA,OACzDA,QAAO;AAAA,EACZ;AAEO,SAAA;AACT;AAwBgB,SAAA,YACd,QACA,SACwB;AAExB,QAAM,KAAK,SAAS,iBAAiB,SAAS,SAAS;AAChD,SAAA,WAAW,UAAU,WAAc;AACxC,UAAM,EAAE,OAAO,IAAI,MAAM,OAAO,IAAI,GAAG,MAAM;AACzC,QAAA,CAAC,OAAO,QAAgB,QAAA;AAC5B,UAAM,IAAI,MAAM,OAAO,UAAU,MAAM;AAAA,KACtC,OAAO;AACZ;"}
+{"version":3,"file":"client.mjs","sources":["../src/client.ts"],"sourcesContent":["import type { CloudMethodOutput } from '@/cloud';\nimport type { ClientDatabaseOutput } from '@/database';\nimport type { AnyArray, AnyFunction } from '@cloudcome/utils-core/types';\nimport {\n  type UseRequestOptions,\n  type UseRequestOutput,\n  type UseRequestOutputFilled,\n  useRequest,\n} from '@cloudcome/utils-vue/request';\nimport { parseCloudMethodOutput } from './_helpers';\n\ntype _ImportObject = UniCloudNamespace.UniCloud['importObject'];\ntype _ImportObjectArgs = Parameters<_ImportObject>;\n\nexport type CreateUseCloudObjectOptions = _ImportObjectArgs[1] & {\n  /**\n   * 模拟云对象，用于单元测试\n   * @private\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockServer?: any;\n\n  /**\n   * 回退错误信息\n   * @default '请求失败'\n   */\n  fallbackErrorMessage?: string;\n};\n\n/**\n * 云对象请求函数类型定义\n * @template F 云对象方法函数类型\n * @param input 云对象方法的参数数组\n * @returns 返回云对象方法执行结果的Promise\n */\nexport type CloudObjectRequest = <F extends AnyFunction>(\n  ...input: Parameters<F>\n) => Promise<CloudMethodOutput<ReturnType<F>>>;\n\n/**\n * 用于调用云对象方法的hook函数类型定义\n * @template I 输入参数类型数组\n * @template O 输出结果类型\n */\nexport type UseCloudMethod = {\n  /**\n   * 重载签名：当提供 placeholder 选项时，返回包含初始值的输出类型\n   * @param method 云对象方法名\n   * @param caller 调用云对象方法的函数\n   * @param options 包含 placeholder 的请求配置选项\n   * @returns 返回包含初始值的请求输出\n   */\n  <I extends AnyArray, O>(\n    method: string,\n    caller: (request: CloudObjectRequest, ...inputs: I) => Promise<CloudMethodOutput<O>>,\n    options: Omit<UseRequestOptions<I, O>, 'placeholder'> & { placeholder: () => O },\n  ): UseRequestOutputFilled<I, O>;\n\n  /**\n   * 重载签名：当不提供 placeholder 选项时，返回普通输出类型\n   * @param method 云对象方法名\n   * @param caller 调用云对象方法的函数\n   * @param options 可选的请求配置选项\n   * @returns 返回普通的请求输出\n   */\n  <I extends AnyArray, O>(\n    method: string,\n    caller: (request: CloudObjectRequest, ...inputs: I) => Promise<CloudMethodOutput<O>>,\n    options?: UseRequestOptions<I, O>,\n  ): UseRequestOutput<I, O>;\n};\n/**\n * 导入云对象并创建一个用于调用云对象的hook\n * @param objectName 云对象名称\n * @param options 配置选项，包含模拟服务器、回退错误信息等\n * @returns 返回一个可用于调用云对象方法的hook函数\n */\nexport function importCloudObject(objectName: _ImportObjectArgs[0], options?: CreateUseCloudObjectOptions) {\n  const server = options?._mockServer || uniCloud.importObject(objectName, options);\n  const fallbackErrorMessage = options?.fallbackErrorMessage || '请求失败';\n\n  /**\n   * 用于调用云对象方法的hook函数\n   * @template I 输入参数类型\n   * @template O 输出结果类型\n   * @param method 云对象方法名\n   * @param caller 调用云对象的函数\n   * @param options 配置选项，包含请求相关的配置\n   * @returns 返回一个请求hook，用于处理云对象调用\n   */\n  const useCloudMethod: UseCloudMethod = (method, caller, options) => {\n    // 使用请求hook处理云对象调用\n    return useRequest(async (...inputs) => {\n      const request = server[method];\n      const output = await caller(request, ...inputs);\n      return parseCloudMethodOutput(output, fallbackErrorMessage);\n    }, options);\n  };\n\n  return useCloudMethod;\n}\n\nexport type UseDatabaseOptions<I extends AnyArray, O> = UseRequestOptions<I, O> & {\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any;\n};\n\n/**\n * 创建一个用于调用云数据库的hook\n * @param caller 调用云数据库的函数，接收数据库实例和输入参数，返回Promise\n * @param options 配置选项\n * @returns 返回一个请求hook，用于处理云数据库调用\n */\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (db: UniCloud.Database, ...inputs: I) => Promise<ClientDatabaseOutput<O>>,\n  options: Omit<UseDatabaseOptions<I, O>, 'placeholder'> & { placeholder: () => O },\n): UseRequestOutputFilled<I, O>;\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (db: UniCloud.Database, ...inputs: I) => Promise<ClientDatabaseOutput<O>>,\n  options?: UseDatabaseOptions<I, O>,\n): UseRequestOutput<I, O>;\nexport function useDatabase<I extends AnyArray, O>(\n  caller: (db: UniCloud.Database, ...inputs: I) => Promise<ClientDatabaseOutput<O>>,\n  options?: UseDatabaseOptions<I, O>,\n): UseRequestOutput<I, O> {\n  // 获取数据库实例，优先使用模拟数据库（用于测试），否则使用uniCloud数据库\n  const db = options?._mockDatabase || uniCloud.database();\n  return useRequest(async (...inputs: I) => {\n    const { result } = await caller(db, ...inputs);\n    if (!result.errCode) return result;\n    throw new Error(result.errMsg || '请求失败');\n  }, options);\n}\n\nexport { parseCloudMethodOutput } from './_helpers';\n"],"names":["options"],"mappings":";;AA6EgB,SAAA,kBAAkB,YAAkC,SAAuC;AACzG,QAAM,SAAS,SAAS,eAAe,SAAS,aAAa,YAAY,OAAO;AAC1E,QAAA,uBAAuB,SAAS,wBAAwB;AAW9D,QAAM,iBAAiC,CAAC,QAAQ,QAAQA,aAAY;AAE3D,WAAA,WAAW,UAAU,WAAW;AAC/B,YAAA,UAAU,OAAO,MAAM;AAC7B,YAAM,SAAS,MAAM,OAAO,SAAS,GAAG,MAAM;AACvC,aAAA,uBAAuB,QAAQ,oBAAoB;AAAA,OACzDA,QAAO;AAAA,EACZ;AAEO,SAAA;AACT;AAwBgB,SAAA,YACd,QACA,SACwB;AAExB,QAAM,KAAK,SAAS,iBAAiB,SAAS,SAAS;AAChD,SAAA,WAAW,UAAU,WAAc;AACxC,UAAM,EAAE,OAAO,IAAI,MAAM,OAAO,IAAI,GAAG,MAAM;AACzC,QAAA,CAAC,OAAO,QAAgB,QAAA;AAC5B,UAAM,IAAI,MAAM,OAAO,UAAU,MAAM;AAAA,KACtC,OAAO;AACZ;"}

package/dist/cloud/method.d.ts

@@ -0,0 +1,102 @@
+import { MaybePromise } from '@cloudcome/utils-core/types';
+import { default as z, ZodObject } from 'zod';
+import { CloudMethod, CloudObjectThis } from './types';
+import { UniIdCommonModule } from './uni-id';
+type _CloudObjectThisAppendUser = {
+    id: string;
+    role: string[];
+    permission: string[];
+    isAdmin: boolean;
+};
+type _CloudObjectThisAppend = {
+    options: Required<CreateCloudObjectOptions>;
+    user: _CloudObjectThisAppendUser;
+};
+export type CloudObjectContext = CloudObjectThis & _CloudObjectThisAppend;
+export type BuildCloudMethodCreatorOptions = {
+    /**
+     * UniId 通用模块
+     * 用于处理用户身份验证和权限管理
+     * 如果提供，将在云对象执行前验证用户身份
+     */
+    uniIdCommonModule?: UniIdCommonModule;
+    /**
+     * 需要用户登录态的错误码
+     * @default 'uni-id-check-token-failed'
+     */
+    requiredUserErrCode?: number | string;
+    /**
+     * 需要用户登录态的错误消息
+     * @default '需要登录后才能进行此操作'
+     */
+    requiredUserErrMsg?: string;
+    /**
+     * 仅允许本地环境运行的错误消息
+     * @default '运行环境不匹配'
+     */
+    onlyLocalEnvErrMsg?: string;
+    /**
+     * 响应附加数据函数
+     * 用于在云对象响应中添加额外的上下文信息
+     * @param objectThis 云对象上下文
+     * @returns 返回要附加到响应中的数据对象
+     */
+    respondAppend?: (objectThis: CloudObjectThis) => AnyObject;
+};
+export type CreateCloudObjectOptions = {
+    /**
+     * 是否需要用户登录态
+     * @default false
+     */
+    requiredUser?: boolean;
+    /**
+     * 是否仅在本地环境运行
+     * @default false
+     */
+    onlyLocalEnv?: boolean;
+};
+/**
+ * 云对象方法创建器类型定义
+ *
+ * 用于定义云对象方法的创建函数类型，支持两种重载形式：
+ * 1. 带输入验证的版本：接收schema、处理函数和选项
+ * 2. 无输入参数的版本：仅接收处理函数和选项
+ */
+export type CreateCloudMethod = {
+    /**
+     * 带输入验证的云对象方法创建器
+     * @template S - Zod验证模式类型
+     * @template O - 返回值类型
+     * @param schema - Zod验证模式，用于验证输入数据
+     * @param fn - 业务逻辑处理函数，接收上下文和验证后的输入数据
+     * @param options - 云对象创建选项
+     * @returns 云对象方法函数
+     */
+    <S extends ZodObject, O>(schema: S, fn: (context: CloudObjectContext, input: z.infer<S>) => MaybePromise<O>, options?: CreateCloudObjectOptions): CloudMethod<z.infer<S>, O>;
+    /**
+     * 无输入参数的云对象方法创建器
+     * @template O - 返回值类型
+     * @param fn - 业务逻辑处理函数，仅接收上下文
+     * @param options - 云对象创建选项
+     * @returns 云对象方法函数
+     */
+    <O>(fn: (context: CloudObjectContext) => MaybePromise<O>, options?: CreateCloudObjectOptions): CloudMethod<void, O>;
+};
+/**
+ * 构建云对象方法创建器
+ *
+ * 该函数用于创建云对象方法的工厂函数，支持输入验证、用户身份验证、环境检查等功能。
+ * 返回的创建器函数可以根据不同的配置创建云对象方法。
+ *
+ * @param options 构建选项，用于配置云对象方法创建器的行为
+ * @returns 返回一个云对象方法创建器函数
+ *
+ * @example
+ * // 创建一个需要用户登录的云对象方法
+ * const createMethod = buildCloudMethodCreator({ uniIdCommonModule });
+ * const myMethod = createMethod(async (context) => {
+ *   return { message: 'Hello ' + context.user.id };
+ * }, { requiredUser: true });
+ */
+export declare function buildCloudMethodCreator(options?: BuildCloudMethodCreatorOptions): CreateCloudMethod;
+export {};

package/dist/cloud/module.d.ts

@@ -0,0 +1,27 @@
+import { CloudModuleOutput } from './types';
+/**
+ * 解析云模块输出结果
+ *
+ * 该函数用于处理云模块的输出，如果输出中包含错误码，则抛出相应的错误；
+ * 否则返回去除错误码和错误信息后的数据部分。
+ *
+ * @template O - 输出数据的类型
+ * @param output - 云模块的输出结果，包含errCode、errMsg和数据部分
+ * @param fallbackErrorMessage - 当输出中没有错误信息时使用的默认错误消息
+ * @returns 返回去除errCode和errMsg字段后的数据对象
+ * @throws {CloudObjectError} 当output中存在errCode时抛出包含错误码和错误信息的异常
+ *
+ * @example
+ * // 成功情况
+ * const result = parseCloudModuleOutput({ value: 'success', errCode: 0, errMsg: '' });
+ * // 返回: { value: 'success' }
+ *
+ * @example
+ * // 错误情况
+ * try {
+ *   parseCloudModuleOutput({ errCode: 404, errMsg: 'Not Found' });
+ * } catch (error) {
+ *   // 抛出错误: CloudObjectError('Not Found', 404)
+ * }
+ */
+export declare function parseCloudModuleOutput<O>(output: CloudModuleOutput<O>, fallbackErrorMessage?: string): Omit<O, 'errCode' | 'errMsg'>;

package/dist/cloud/respond.d.ts

@@ -1,24 +1,18 @@
 import { MaybePromise } from '@cloudcome/utils-core/types';
-import { UniCloudObjectOutput } from './types';
+import { CloudMethodOutput } from './types';
 /**
- * 处理云函数响应结果，统一返回格式
- * @param fn - 执行函数，可以返回任意类型的值或Promise
- * @param append - 需要附加到响应结果中的额外字段
- * @returns 统一格式的云函数响应结果
+ * 执行云对象方法并标准化响应格式
+ *
+ * @template O - 函数返回值的类型
+ * @param fn - 要执行的异步函数
+ * @param append - 要附加到响应中的额外数据
+ * @returns 标准化的云对象响应对象
  *
  * @example
  * ```typescript
- * // 成功情况
- * const result = await respondCloudObject(async () => {
- *   return { name: 'test', value: 123 };
- * });
- * // 返回: { errCode: 0, errMsg: '', data: { name: 'test', value: 123 } }
- *
- * // 失败情况
- * const result = await respondCloudObject(() => {
- *   throw new Error('操作失败');
- * });
- * // 返回: { errCode: -1, errMsg: '操作失败', data: null }
+ * const result = await respondCloudMethod(async () => {
+ *   return await getData();
+ * }, { extra: 'data' });
  * ```
  */
-export declare function respondCloudObject<O>(fn: () => MaybePromise<O>, append?: AnyObject): Promise<UniCloudObjectOutput<O>>;
+export declare function respondCloudMethod<O>(fn: () => MaybePromise<O>, append?: AnyObject): Promise<CloudMethodOutput<O>>;

package/dist/cloud/types.d.ts

@@ -62,7 +62,7 @@ export type ClientInfo = {
 };
 /**
  * 云环境信息类型定义
- * 包含了云函数运行环境的相关信息
+ * 包含了云对象运行环境的相关信息
  */
 export type CloudInfo = {
     /** 云服务提供商 */
@@ -96,7 +96,7 @@ export type HttpInfo = {
     /** 是否为Base64编码 */
     isBase64Encoded: boolean;
 };
-export type UniCloudObjectThis = {
+export type CloudObjectThis = {
     /**
      * 获取客户端信息
      */
@@ -124,10 +124,11 @@ export type UniCloudObjectThis = {
     getHttpInfo: () => HttpInfo | undefined;
 };
 /**
- * 云对象输出类型定义
- * 用于统一云对象返回格式
+ * 云对象方法输出类型定义
+ * 用于统一云对象方法返回格式
+ * @template T 返回数据的类型
  */
-export type UniCloudObjectOutput<T> = {
+export type CloudMethodOutput<T> = {
     /** 错误码，可选 */
     errCode?: number | string;
     /** 错误信息，可选 */
@@ -139,19 +140,19 @@ export type UniCloudObjectOutput<T> = {
  * 提取云对象输出类型中的数据类型
  * 用于从 UniCloudObjectOutput<T> 中提取 T 类型
  */
-export type ExtractUniCloudOutput<T> = T extends UniCloudObjectOutput<infer U> ? Awaited<U> : never;
+export type ExtractUniCloudOutput<T> = T extends CloudMethodOutput<infer U> ? Awaited<U> : never;
 /**
  * 云模块输出类型定义
  * 用于统一云模块返回格式
  */
-export type UniCloudModuleOutput<T> = {
+export type CloudModuleOutput<T> = {
     /** 错误码，可选 */
     errCode?: number | string;
     /** 错误信息，可选 */
     errMsg?: string;
 } & T;
 /**
- * 云对象函数类型定义
+ * 云对象方法类型定义
  * 定义了云对象方法的函数签名
  * @template I 输入参数类型
  * @template O 输出数据类型
@@ -159,9 +160,23 @@ export type UniCloudModuleOutput<T> = {
  * @param input 输入参数
  * @returns 返回包含输出数据的Promise
  */
-export type UniCloudObjectExpose<I, O> = (
+export type CloudMethod<I, O> = (
 /** 云对象上下文 */
-this: UniCloudObjectThis, 
+this: CloudObjectThis, 
 /** 输入参数 */
-input: I) => Promise<UniCloudObjectOutput<O>>;
-export type ExtractUniCloudObjectExpose<T> = T extends UniCloudObjectExpose<infer I, infer O> ? UniCloudObjectOutput<O> : never;
+input: I) => Promise<CloudMethodOutput<O>>;
+/**
+ * 提取云对象方法输入参数类型
+ * 用于从 UniCloudExpose<I, O> 中提取输入参数类型 I
+ */
+export type ExtractCloudMethodInput<T> = T extends CloudMethod<infer I, infer O> ? I : never;
+/**
+ * 提取云对象方法输出数据类型
+ * 用于从 UniCloudExpose<I, O> 中提取输出数据类型 O
+ */
+export type ExtractCloudMethodData<T> = T extends CloudMethod<infer I, infer O> ? O : never;
+/**
+ * 提取云对象方法签名类型
+ * 用于从 UniCloudExpose<I, O> 中提取函数签名 (input: I) => O
+ */
+export type ExtractCloudMethodFunction<T> = T extends CloudMethod<infer I, infer O> ? (input: I) => O : never;

package/dist/cloud/uni-id.d.ts

@@ -1,4 +1,4 @@
-import { ClientInfo, UniCloudModuleOutput } from './types';
+import { ClientInfo, CloudModuleOutput } from './types';
 /**
  * uni-id-common 模块
  */
@@ -10,7 +10,7 @@ export type UniIdCommonModule = {
 export type UniIdCommonInstance = {
     checkToken: (token: string) => Promise<UniIdUser | undefined>;
 };
-export type UniIdUser = UniCloudModuleOutput<{
+export type UniIdUser = CloudModuleOutput<{
     uid?: string;
     role?: string[];
     permission?: string[];