@cloudcome/utils-uni 1.19.0 → 1.20.0

package/dist/_helpers.cjs

@@ -12,7 +12,7 @@ function parseDatabaseOutput(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"]);
+    if (!result.errCode) return object.objectOmit(result, ["errCode", "errMsg"]);
     throw error.errorAssign(new Error(result.errMsg), result);
   }
   return res;

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 { 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;;;"}
+{"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']);\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,QAAS,QAAOC,OAAAA,WAAW,QAAQ,CAAC,WAAW,QAAQ,CAAC;AACpE,UAAMD,MAAAA,YAAY,IAAI,MAAM,OAAO,MAAM,GAAG,MAAM;AAAA,EAAA;AAI7C,SAAA;AACT;;;"}

package/dist/_helpers.d.ts

@@ -15,9 +15,4 @@ export declare function parseCloudMethodOutput<O>(output: CloudMethodOutput<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">;
+export declare function parseDatabaseOutput<T>(res: ClientDatabaseOutput<T> | CloudDatabaseOutput<T>): T | Omit<T & import('./_types').UniErrorData, "errCode" | "errMsg">;

package/dist/_helpers.mjs

@@ -11,7 +11,7 @@ function parseDatabaseOutput(res) {
   const isClient = keys.length === 1 && keys[0] === "result";
   if (isClient) {
     const { result } = res;
-    if (!result.errCode) return objectOmit(result, ["errCode", "errMsg", "code", "message"]);
+    if (!result.errCode) return objectOmit(result, ["errCode", "errMsg"]);
     throw errorAssign(new Error(result.errMsg), result);
   }
   return res;

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 { 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;"}
+{"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']);\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,QAAS,QAAO,WAAW,QAAQ,CAAC,WAAW,QAAQ,CAAC;AACpE,UAAM,YAAY,IAAI,MAAM,OAAO,MAAM,GAAG,MAAM;AAAA,EAAA;AAI7C,SAAA;AACT;"}

package/dist/_types.d.ts

@@ -0,0 +1,7 @@
+export type UniErrorData = {
+    /** 错误码 */
+    errCode?: number | string;
+    /** 错误信息 */
+    errMsg?: string;
+};
+export type UniError = Error & UniErrorData;

package/dist/client.cjs

@@ -3,16 +3,44 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const type = require("@cloudcome/utils-core/type");
 const request = require("@cloudcome/utils-vue/request");
 const _helpers = require("./_helpers.cjs");
-function importCloudObject(objectName, options) {
-  const server = options?._mockServer || uniCloud.importObject(objectName, options);
-  const fallbackErrorMessage = options?.fallbackErrorMessage || "请求失败";
-  const useCloudMethod = (method, caller, options2) => {
-    return request.useRequest(async (...inputs) => {
-      const methodName = type.isFunction(method) ? method(...inputs) : method;
-      const request2 = server[methodName];
-      const output = await caller(request2, ...inputs);
-      return _helpers.parseCloudMethodOutput(output, fallbackErrorMessage);
-    }, options2);
+function importCloudObject(objectName, importOptions) {
+  const fallbackErrorMessage = importOptions?.fallbackErrorMessage || "请求失败";
+  const server = importOptions?._mockServer || uniCloud.importObject(objectName, importOptions);
+  const useCloudMethod = (method, caller, options) => {
+    return request.useRequest(
+      async (...inputs) => {
+        const methodName = type.isFunction(method) ? method(...inputs) : method;
+        const request2 = server[methodName];
+        const output = await caller(request2, ...inputs);
+        return _helpers.parseCloudMethodOutput(output, fallbackErrorMessage);
+      },
+      {
+        ...options,
+        onBefore(...inputs) {
+          if (options?.showLoading) uni.showLoading({ title: "", mask: true });
+          importOptions?.onBefore?.();
+          options?.onBefore?.(...inputs);
+        },
+        onSuccess(data, ...inputs) {
+          importOptions?.onSuccess?.();
+          options?.onSuccess?.(data, ...inputs);
+        },
+        onError(err, ...inputs) {
+          importOptions?.onError?.(err);
+          options?.onError?.(err, ...inputs);
+          if (options?.showError) {
+            setTimeout(() => {
+              uni.showToast({ title: err.message, icon: "none", duration: 3e3, mask: false });
+            });
+          }
+        },
+        onAfter(...inputs) {
+          if (options?.showLoading) uni.hideLoading();
+          importOptions?.onAfter?.();
+          options?.onAfter?.(...inputs);
+        }
+      }
+    );
   };
   return useCloudMethod;
 }

package/dist/client.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.cjs","sources":["../src/client.ts"],"sourcesContent":["import type { CloudMethodOutput } from '@/cloud';\nimport type { ClientDatabaseOutput } from '@/database';\nimport { isFunction } from '@cloudcome/utils-core/type';\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 | ((...inputs: I) => 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 | ((...inputs: I) => 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 methodName = isFunction(method) ? method(...inputs) : method;\n      const request = server[methodName];\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","isFunction","request","parseCloudMethodOutput"],"mappings":";;;;;AA8EgB,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;AACrC,YAAM,aAAaC,KAAAA,WAAW,MAAM,IAAI,OAAO,GAAG,MAAM,IAAI;AACtD,YAAAC,WAAU,OAAO,UAAU;AACjC,YAAM,SAAS,MAAM,OAAOA,UAAS,GAAG,MAAM;AACvC,aAAAC,SAAA,uBAAuB,QAAQ,oBAAoB;AAAA,OACzDJ,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, UniError } from '@/cloud';\nimport type { ClientDatabaseOutput } from '@/database';\nimport { isFunction } from '@cloudcome/utils-core/type';\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>;\ntype _ImportObjectOptions = _ImportObjectArgs[1];\n\nexport type CreateUseCloudObjectOptions = _ImportObjectOptions & {\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  onBefore?: () => unknown;\n\n  /**\n   * 请求成功后的回调函数\n   */\n  onSuccess?: () => unknown;\n\n  /**\n   * 请求失败时的回调函数\n   * @param err 错误信息\n   */\n  onError?: (err: UniError) => unknown;\n\n  /**\n   * 请求完成后的回调函数（无论成功或失败都会执行）\n   */\n  onAfter?: () => unknown;\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 * 用于调用云对象方法的配置选项类型定义\n * @template I 输入参数类型数组\n * @template O 输出结果类型\n */\nexport type UseCloudMethodOptions<I extends AnyArray, O> = Omit<UseRequestOptions<I, O>, 'onError'> & {\n  /**\n   * 请求发生错误时的回调函数\n   * @param err 错误信息\n   * @param inputs 请求输入参数\n   */\n  onError?: (err: UniError, ...inputs: I) => unknown;\n\n  /**\n   * 是否显示加载状态\n   * @default false\n   */\n  showLoading?: boolean;\n\n  /**\n   * 是否显示错误信息\n   * @default false\n   */\n  showError?: boolean;\n};\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 | ((...inputs: I) => string),\n    caller: (request: CloudObjectRequest, ...inputs: I) => Promise<CloudMethodOutput<O>>,\n    options: Omit<UseCloudMethodOptions<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 | ((...inputs: I) => string),\n    caller: (request: CloudObjectRequest, ...inputs: I) => Promise<CloudMethodOutput<O>>,\n    options?: UseCloudMethodOptions<I, O>,\n  ): UseRequestOutput<I, O>;\n};\n\n/**\n * 导入云对象并创建一个用于调用云对象的hook\n * @param objectName 云对象名称\n * @param importOptions 配置选项，包含模拟服务器、回退错误信息等\n * @returns 返回一个可用于调用云对象方法的hook函数\n */\nexport function importCloudObject(objectName: _ImportObjectArgs[0], importOptions?: CreateUseCloudObjectOptions) {\n  const fallbackErrorMessage = importOptions?.fallbackErrorMessage || '请求失败';\n  const server = importOptions?._mockServer || uniCloud.importObject(objectName, importOptions);\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(\n      async (...inputs) => {\n        const methodName = isFunction(method) ? method(...inputs) : method;\n        const request = server[methodName];\n        const output = await caller(request, ...inputs);\n        return parseCloudMethodOutput(output, fallbackErrorMessage);\n      },\n      {\n        ...options,\n        onBefore(...inputs) {\n          if (options?.showLoading) uni.showLoading({ title: '', mask: true });\n\n          importOptions?.onBefore?.();\n          options?.onBefore?.(...inputs);\n        },\n        onSuccess(data, ...inputs) {\n          importOptions?.onSuccess?.();\n          options?.onSuccess?.(data, ...inputs);\n        },\n        onError(err, ...inputs) {\n          importOptions?.onError?.(err as UniError);\n          options?.onError?.(err as UniError, ...inputs);\n\n          if (options?.showError) {\n            // 加延迟是尽量保证在 loading 隐藏后显示\n            setTimeout(() => {\n              uni.showToast({ title: (err as UniError).message, icon: 'none', duration: 3000, mask: false });\n            });\n          }\n        },\n        onAfter(...inputs) {\n          if (options?.showLoading) uni.hideLoading();\n\n          importOptions?.onAfter?.();\n          options?.onAfter?.(...inputs);\n        },\n      },\n    );\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';\nexport type { UniError } from './_types';\n"],"names":["useRequest","isFunction","request","parseCloudMethodOutput"],"mappings":";;;;;AA+HgB,SAAA,kBAAkB,YAAkC,eAA6C;AACzG,QAAA,uBAAuB,eAAe,wBAAwB;AACpE,QAAM,SAAS,eAAe,eAAe,SAAS,aAAa,YAAY,aAAa;AAW5F,QAAM,iBAAiC,CAAC,QAAQ,QAAQ,YAAY;AAE3D,WAAAA,QAAA;AAAA,MACL,UAAU,WAAW;AACnB,cAAM,aAAaC,KAAAA,WAAW,MAAM,IAAI,OAAO,GAAG,MAAM,IAAI;AACtD,cAAAC,WAAU,OAAO,UAAU;AACjC,cAAM,SAAS,MAAM,OAAOA,UAAS,GAAG,MAAM;AACvC,eAAAC,SAAA,uBAAuB,QAAQ,oBAAoB;AAAA,MAC5D;AAAA,MACA;AAAA,QACE,GAAG;AAAA,QACH,YAAY,QAAQ;AACd,cAAA,SAAS,YAAiB,KAAA,YAAY,EAAE,OAAO,IAAI,MAAM,MAAM;AAEnE,yBAAe,WAAW;AACjB,mBAAA,WAAW,GAAG,MAAM;AAAA,QAC/B;AAAA,QACA,UAAU,SAAS,QAAQ;AACzB,yBAAe,YAAY;AAClB,mBAAA,YAAY,MAAM,GAAG,MAAM;AAAA,QACtC;AAAA,QACA,QAAQ,QAAQ,QAAQ;AACtB,yBAAe,UAAU,GAAe;AAC/B,mBAAA,UAAU,KAAiB,GAAG,MAAM;AAE7C,cAAI,SAAS,WAAW;AAEtB,uBAAW,MAAM;AACX,kBAAA,UAAU,EAAE,OAAQ,IAAiB,SAAS,MAAM,QAAQ,UAAU,KAAM,MAAM,MAAA,CAAO;AAAA,YAAA,CAC9F;AAAA,UAAA;AAAA,QAEL;AAAA,QACA,WAAW,QAAQ;AACb,cAAA,SAAS,YAAa,KAAI,YAAY;AAE1C,yBAAe,UAAU;AAChB,mBAAA,UAAU,GAAG,MAAM;AAAA,QAAA;AAAA,MAC9B;AAAA,IAEJ;AAAA,EACF;AAEO,SAAA;AACT;AAwBgB,SAAA,YACd,QACA,SACwB;AAExB,QAAM,KAAK,SAAS,iBAAiB,SAAS,SAAS;AAChD,SAAAH,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,10 +1,11 @@
-import { CloudMethodOutput } from './cloud';
+import { CloudMethodOutput, UniError } 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 CreateUseCloudObjectOptions = _ImportObjectArgs[1] & {
+type _ImportObjectOptions = _ImportObjectArgs[1];
+export type CreateUseCloudObjectOptions = _ImportObjectOptions & {
     /**
      * 模拟云对象，用于单元测试
      * @private
@@ -15,6 +16,23 @@ export type CreateUseCloudObjectOptions = _ImportObjectArgs[1] & {
      * @default '请求失败'
      */
     fallbackErrorMessage?: string;
+    /**
+     * 请求开始前的回调函数
+     */
+    onBefore?: () => unknown;
+    /**
+     * 请求成功后的回调函数
+     */
+    onSuccess?: () => unknown;
+    /**
+     * 请求失败时的回调函数
+     * @param err 错误信息
+     */
+    onError?: (err: UniError) => unknown;
+    /**
+     * 请求完成后的回调函数（无论成功或失败都会执行）
+     */
+    onAfter?: () => unknown;
 };
 /**
  * 云对象请求函数类型定义
@@ -23,6 +41,29 @@ export type CreateUseCloudObjectOptions = _ImportObjectArgs[1] & {
  * @returns 返回云对象方法执行结果的Promise
  */
 export type CloudObjectRequest = <F extends AnyFunction>(...input: Parameters<F>) => Promise<CloudMethodOutput<ReturnType<F>>>;
+/**
+ * 用于调用云对象方法的配置选项类型定义
+ * @template I 输入参数类型数组
+ * @template O 输出结果类型
+ */
+export type UseCloudMethodOptions<I extends AnyArray, O> = Omit<UseRequestOptions<I, O>, 'onError'> & {
+    /**
+     * 请求发生错误时的回调函数
+     * @param err 错误信息
+     * @param inputs 请求输入参数
+     */
+    onError?: (err: UniError, ...inputs: I) => unknown;
+    /**
+     * 是否显示加载状态
+     * @default false
+     */
+    showLoading?: boolean;
+    /**
+     * 是否显示错误信息
+     * @default false
+     */
+    showError?: boolean;
+};
 /**
  * 用于调用云对象方法的hook函数类型定义
  * @template I 输入参数类型数组
@@ -36,7 +77,7 @@ export type UseCloudMethod = {
      * @param options 包含 placeholder 的请求配置选项
      * @returns 返回包含初始值的请求输出
      */
-    <I extends AnyArray, O>(method: string | ((...inputs: I) => string), caller: (request: CloudObjectRequest, ...inputs: I) => Promise<CloudMethodOutput<O>>, options: Omit<UseRequestOptions<I, O>, 'placeholder'> & {
+    <I extends AnyArray, O>(method: string | ((...inputs: I) => string), caller: (request: CloudObjectRequest, ...inputs: I) => Promise<CloudMethodOutput<O>>, options: Omit<UseCloudMethodOptions<I, O>, 'placeholder'> & {
         placeholder: () => O;
     }): UseRequestOutputFilled<I, O>;
     /**
@@ -46,15 +87,15 @@ export type UseCloudMethod = {
      * @param options 可选的请求配置选项
      * @returns 返回普通的请求输出
      */
-    <I extends AnyArray, O>(method: string | ((...inputs: I) => string), caller: (request: CloudObjectRequest, ...inputs: I) => Promise<CloudMethodOutput<O>>, options?: UseRequestOptions<I, O>): UseRequestOutput<I, O>;
+    <I extends AnyArray, O>(method: string | ((...inputs: I) => string), caller: (request: CloudObjectRequest, ...inputs: I) => Promise<CloudMethodOutput<O>>, options?: UseCloudMethodOptions<I, O>): UseRequestOutput<I, O>;
 };
 /**
  * 导入云对象并创建一个用于调用云对象的hook
  * @param objectName 云对象名称
- * @param options 配置选项，包含模拟服务器、回退错误信息等
+ * @param importOptions 配置选项，包含模拟服务器、回退错误信息等
  * @returns 返回一个可用于调用云对象方法的hook函数
  */
-export declare function importCloudObject(objectName: _ImportObjectArgs[0], options?: CreateUseCloudObjectOptions): UseCloudMethod;
+export declare function importCloudObject(objectName: _ImportObjectArgs[0], importOptions?: CreateUseCloudObjectOptions): UseCloudMethod;
 export type UseDatabaseOptions<I extends AnyArray, O> = UseRequestOptions<I, O> & {
     /**
      * 模拟数据库，用于单元测试
@@ -72,3 +113,4 @@ export declare function useDatabase<I extends AnyArray, O>(caller: (db: UniCloud
 }): UseRequestOutputFilled<I, O>;
 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';
+export type { UniError } from './_types';

package/dist/client.mjs

@@ -1,16 +1,44 @@
 import { isFunction } from "@cloudcome/utils-core/type";
 import { useRequest } from "@cloudcome/utils-vue/request";
 import { p as parseCloudMethodOutput } from "./_helpers.mjs";
-function importCloudObject(objectName, options) {
-  const server = options?._mockServer || uniCloud.importObject(objectName, options);
-  const fallbackErrorMessage = options?.fallbackErrorMessage || "请求失败";
-  const useCloudMethod = (method, caller, options2) => {
-    return useRequest(async (...inputs) => {
-      const methodName = isFunction(method) ? method(...inputs) : method;
-      const request = server[methodName];
-      const output = await caller(request, ...inputs);
-      return parseCloudMethodOutput(output, fallbackErrorMessage);
-    }, options2);
+function importCloudObject(objectName, importOptions) {
+  const fallbackErrorMessage = importOptions?.fallbackErrorMessage || "请求失败";
+  const server = importOptions?._mockServer || uniCloud.importObject(objectName, importOptions);
+  const useCloudMethod = (method, caller, options) => {
+    return useRequest(
+      async (...inputs) => {
+        const methodName = isFunction(method) ? method(...inputs) : method;
+        const request = server[methodName];
+        const output = await caller(request, ...inputs);
+        return parseCloudMethodOutput(output, fallbackErrorMessage);
+      },
+      {
+        ...options,
+        onBefore(...inputs) {
+          if (options?.showLoading) uni.showLoading({ title: "", mask: true });
+          importOptions?.onBefore?.();
+          options?.onBefore?.(...inputs);
+        },
+        onSuccess(data, ...inputs) {
+          importOptions?.onSuccess?.();
+          options?.onSuccess?.(data, ...inputs);
+        },
+        onError(err, ...inputs) {
+          importOptions?.onError?.(err);
+          options?.onError?.(err, ...inputs);
+          if (options?.showError) {
+            setTimeout(() => {
+              uni.showToast({ title: err.message, icon: "none", duration: 3e3, mask: false });
+            });
+          }
+        },
+        onAfter(...inputs) {
+          if (options?.showLoading) uni.hideLoading();
+          importOptions?.onAfter?.();
+          options?.onAfter?.(...inputs);
+        }
+      }
+    );
   };
   return useCloudMethod;
 }

package/dist/client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.mjs","sources":["../src/client.ts"],"sourcesContent":["import type { CloudMethodOutput } from '@/cloud';\nimport type { ClientDatabaseOutput } from '@/database';\nimport { isFunction } from '@cloudcome/utils-core/type';\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 | ((...inputs: I) => 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 | ((...inputs: I) => 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 methodName = isFunction(method) ? method(...inputs) : method;\n      const request = server[methodName];\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":";;;AA8EgB,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;AACrC,YAAM,aAAa,WAAW,MAAM,IAAI,OAAO,GAAG,MAAM,IAAI;AACtD,YAAA,UAAU,OAAO,UAAU;AACjC,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;"}
+{"version":3,"file":"client.mjs","sources":["../src/client.ts"],"sourcesContent":["import type { CloudMethodOutput, UniError } from '@/cloud';\nimport type { ClientDatabaseOutput } from '@/database';\nimport { isFunction } from '@cloudcome/utils-core/type';\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>;\ntype _ImportObjectOptions = _ImportObjectArgs[1];\n\nexport type CreateUseCloudObjectOptions = _ImportObjectOptions & {\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  onBefore?: () => unknown;\n\n  /**\n   * 请求成功后的回调函数\n   */\n  onSuccess?: () => unknown;\n\n  /**\n   * 请求失败时的回调函数\n   * @param err 错误信息\n   */\n  onError?: (err: UniError) => unknown;\n\n  /**\n   * 请求完成后的回调函数（无论成功或失败都会执行）\n   */\n  onAfter?: () => unknown;\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 * 用于调用云对象方法的配置选项类型定义\n * @template I 输入参数类型数组\n * @template O 输出结果类型\n */\nexport type UseCloudMethodOptions<I extends AnyArray, O> = Omit<UseRequestOptions<I, O>, 'onError'> & {\n  /**\n   * 请求发生错误时的回调函数\n   * @param err 错误信息\n   * @param inputs 请求输入参数\n   */\n  onError?: (err: UniError, ...inputs: I) => unknown;\n\n  /**\n   * 是否显示加载状态\n   * @default false\n   */\n  showLoading?: boolean;\n\n  /**\n   * 是否显示错误信息\n   * @default false\n   */\n  showError?: boolean;\n};\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 | ((...inputs: I) => string),\n    caller: (request: CloudObjectRequest, ...inputs: I) => Promise<CloudMethodOutput<O>>,\n    options: Omit<UseCloudMethodOptions<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 | ((...inputs: I) => string),\n    caller: (request: CloudObjectRequest, ...inputs: I) => Promise<CloudMethodOutput<O>>,\n    options?: UseCloudMethodOptions<I, O>,\n  ): UseRequestOutput<I, O>;\n};\n\n/**\n * 导入云对象并创建一个用于调用云对象的hook\n * @param objectName 云对象名称\n * @param importOptions 配置选项，包含模拟服务器、回退错误信息等\n * @returns 返回一个可用于调用云对象方法的hook函数\n */\nexport function importCloudObject(objectName: _ImportObjectArgs[0], importOptions?: CreateUseCloudObjectOptions) {\n  const fallbackErrorMessage = importOptions?.fallbackErrorMessage || '请求失败';\n  const server = importOptions?._mockServer || uniCloud.importObject(objectName, importOptions);\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(\n      async (...inputs) => {\n        const methodName = isFunction(method) ? method(...inputs) : method;\n        const request = server[methodName];\n        const output = await caller(request, ...inputs);\n        return parseCloudMethodOutput(output, fallbackErrorMessage);\n      },\n      {\n        ...options,\n        onBefore(...inputs) {\n          if (options?.showLoading) uni.showLoading({ title: '', mask: true });\n\n          importOptions?.onBefore?.();\n          options?.onBefore?.(...inputs);\n        },\n        onSuccess(data, ...inputs) {\n          importOptions?.onSuccess?.();\n          options?.onSuccess?.(data, ...inputs);\n        },\n        onError(err, ...inputs) {\n          importOptions?.onError?.(err as UniError);\n          options?.onError?.(err as UniError, ...inputs);\n\n          if (options?.showError) {\n            // 加延迟是尽量保证在 loading 隐藏后显示\n            setTimeout(() => {\n              uni.showToast({ title: (err as UniError).message, icon: 'none', duration: 3000, mask: false });\n            });\n          }\n        },\n        onAfter(...inputs) {\n          if (options?.showLoading) uni.hideLoading();\n\n          importOptions?.onAfter?.();\n          options?.onAfter?.(...inputs);\n        },\n      },\n    );\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';\nexport type { UniError } from './_types';\n"],"names":[],"mappings":";;;AA+HgB,SAAA,kBAAkB,YAAkC,eAA6C;AACzG,QAAA,uBAAuB,eAAe,wBAAwB;AACpE,QAAM,SAAS,eAAe,eAAe,SAAS,aAAa,YAAY,aAAa;AAW5F,QAAM,iBAAiC,CAAC,QAAQ,QAAQ,YAAY;AAE3D,WAAA;AAAA,MACL,UAAU,WAAW;AACnB,cAAM,aAAa,WAAW,MAAM,IAAI,OAAO,GAAG,MAAM,IAAI;AACtD,cAAA,UAAU,OAAO,UAAU;AACjC,cAAM,SAAS,MAAM,OAAO,SAAS,GAAG,MAAM;AACvC,eAAA,uBAAuB,QAAQ,oBAAoB;AAAA,MAC5D;AAAA,MACA;AAAA,QACE,GAAG;AAAA,QACH,YAAY,QAAQ;AACd,cAAA,SAAS,YAAiB,KAAA,YAAY,EAAE,OAAO,IAAI,MAAM,MAAM;AAEnE,yBAAe,WAAW;AACjB,mBAAA,WAAW,GAAG,MAAM;AAAA,QAC/B;AAAA,QACA,UAAU,SAAS,QAAQ;AACzB,yBAAe,YAAY;AAClB,mBAAA,YAAY,MAAM,GAAG,MAAM;AAAA,QACtC;AAAA,QACA,QAAQ,QAAQ,QAAQ;AACtB,yBAAe,UAAU,GAAe;AAC/B,mBAAA,UAAU,KAAiB,GAAG,MAAM;AAE7C,cAAI,SAAS,WAAW;AAEtB,uBAAW,MAAM;AACX,kBAAA,UAAU,EAAE,OAAQ,IAAiB,SAAS,MAAM,QAAQ,UAAU,KAAM,MAAM,MAAA,CAAO;AAAA,YAAA,CAC9F;AAAA,UAAA;AAAA,QAEL;AAAA,QACA,WAAW,QAAQ;AACb,cAAA,SAAS,YAAa,KAAI,YAAY;AAE1C,yBAAe,UAAU;AAChB,mBAAA,UAAU,GAAG,MAAM;AAAA,QAAA;AAAA,MAC9B;AAAA,IAEJ;AAAA,EACF;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/types.d.ts

@@ -1,3 +1,4 @@
+import { UniErrorData } from '../_types';
 /**
  * 客户端信息类型定义
  * 包含了客户端的各种环境和设备信息
@@ -128,11 +129,7 @@ export type CloudObjectThis = {
  * 用于统一云对象方法返回格式
  * @template T 返回数据的类型
  */
-export type CloudMethodOutput<T> = {
-    /** 错误码，可选 */
-    errCode?: number | string;
-    /** 错误信息，可选 */
-    errMsg?: string;
+export type CloudMethodOutput<T> = UniErrorData & {
     /** 返回数据 */
     data: T;
 };
@@ -145,12 +142,7 @@ export type ExtractUniCloudOutput<T> = T extends CloudMethodOutput<infer U> ? Aw
  * 云模块输出类型定义
  * 用于统一云模块返回格式
  */
-export type CloudModuleOutput<T> = {
-    /** 错误码，可选 */
-    errCode?: number | string;
-    /** 错误信息，可选 */
-    errMsg?: string;
-} & T;
+export type CloudModuleOutput<T> = UniErrorData & T;
 /**
  * 云对象方法类型定义
  * 定义了云对象方法的函数签名

package/dist/cloud.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cloud.cjs","sources":["../src/cloud/module.ts","../src/cloud/respond.ts","../src/cloud/method.ts"],"sourcesContent":["import { objectOmit } from '@cloudcome/utils-core/object';\nimport { createCloudObjectError } from './error';\nimport type { CloudModuleOutput } from './types';\n\n/**\n * 解析云模块输出结果\n *\n * 该函数用于处理云模块的输出，如果输出中包含错误码，则抛出相应的错误；\n * 否则返回去除错误码和错误信息后的数据部分。\n *\n * @template O - 输出数据的类型\n * @param output - 云模块的输出结果，包含errCode、errMsg和数据部分\n * @param fallbackErrorMessage - 当输出中没有错误信息时使用的默认错误消息\n * @returns 返回去除errCode和errMsg字段后的数据对象\n * @throws {CloudObjectError} 当output中存在errCode时抛出包含错误码和错误信息的异常\n *\n * @example\n * // 成功情况\n * const result = parseCloudModuleOutput({ value: 'success', errCode: 0, errMsg: '' });\n * // 返回: { value: 'success' }\n *\n * @example\n * // 错误情况\n * try {\n *   parseCloudModuleOutput({ errCode: 404, errMsg: 'Not Found' });\n * } catch (error) {\n *   // 抛出错误: CloudObjectError('Not Found', 404)\n * }\n */\nexport function parseCloudModuleOutput<O>(\n  output: CloudModuleOutput<O>,\n  fallbackErrorMessage = '',\n): Omit<O, 'errCode' | 'errMsg'> {\n  if (output.errCode) {\n    throw createCloudObjectError(output.errMsg || fallbackErrorMessage, output.errCode);\n  }\n  return objectOmit(output, ['errCode', 'errMsg']);\n}\n","import { errorNormalize } from '@cloudcome/utils-core/error';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type { CloudMethodOutput } from './types';\n\n/**\n * 执行云对象方法并标准化响应格式\n *\n * @template O - 函数返回值的类型\n * @param fn - 要执行的异步函数\n * @param append - 要附加到响应中的额外数据\n * @returns 标准化的云对象响应对象\n *\n * @example\n * ```typescript\n * const result = await respondCloudMethod(async () => {\n *   return await getData();\n * }, { extra: 'data' });\n * ```\n */\nexport async function respondCloudMethod<O>(\n  fn: () => MaybePromise<O>,\n  append?: AnyObject,\n): Promise<CloudMethodOutput<O>> {\n  try {\n    const data = await fn();\n\n    return {\n      errCode: 0,\n      errMsg: '',\n      data,\n      ...append,\n    };\n  } catch (err) {\n    console.error('respondCloudObject error');\n    console.error(err);\n\n    const err2 = errorNormalize(err as Error & { errCode?: number | string; errMsg?: string });\n\n    return {\n      errCode: err2.errCode || -1,\n      errMsg: err2.errMsg || err2.message || '',\n      // @ts-ignore\n      data: null,\n      ...append,\n    };\n  }\n}\n","import { objectDefaults, objectOmit } from '@cloudcome/utils-core/object';\nimport { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type z from 'zod';\nimport type { ZodObject } from 'zod';\nimport { createCloudObjectError } from './error';\nimport { parseCloudModuleOutput } from './module';\nimport { respondCloudMethod } from './respond';\nimport type { CloudMethod, CloudModuleOutput, CloudObjectThis } from './types';\nimport type { UniIdCommonModule } from './uni-id';\n\ntype _CloudObjectThisAppendUser = {\n  id: string;\n  role: string[];\n  permission: string[];\n  isAdmin: boolean;\n};\n\ntype _CloudObjectThisAppend = {\n  options: Required<CreateCloudObjectOptions>;\n  user: _CloudObjectThisAppendUser;\n};\n\nexport type CloudObjectContext = CloudObjectThis & _CloudObjectThisAppend;\n\nexport type BuildCloudMethodCreatorOptions = {\n  /**\n   * UniId 通用模块\n   * 用于处理用户身份验证和权限管理\n   * 如果提供，将在云对象执行前验证用户身份\n   */\n  uniIdCommonModule?: UniIdCommonModule;\n\n  /**\n   * 需要用户登录态的错误码\n   * @default 'uni-id-check-token-failed'\n   */\n  requiredUserErrCode?: number | string;\n\n  /**\n   * 需要用户登录态的错误消息\n   * @default '需要登录后才能进行此操作'\n   */\n  requiredUserErrMsg?: string;\n\n  /**\n   * 仅允许本地环境运行的错误消息\n   * @default '运行环境不匹配'\n   */\n  onlyLocalEnvErrMsg?: string;\n\n  /**\n   * 响应附加数据函数\n   * 用于在云对象响应中添加额外的上下文信息\n   * @param objectThis 云对象上下文\n   * @returns 返回要附加到响应中的数据对象\n   */\n  respondAppend?: (objectThis: CloudObjectThis) => AnyObject;\n};\n\nexport type CreateCloudObjectOptions = {\n  /**\n   * 是否需要用户登录态\n   * @default false\n   */\n  requiredUser?: boolean;\n\n  /**\n   * 是否仅在本地环境运行\n   * @default false\n   */\n  onlyLocalEnv?: boolean;\n};\n\n/**\n * 云对象方法创建器类型定义\n *\n * 用于定义云对象方法的创建函数类型，支持两种重载形式：\n * 1. 带输入验证的版本：接收schema、处理函数和选项\n * 2. 无输入参数的版本：仅接收处理函数和选项\n */\nexport type CreateCloudMethod = {\n  /**\n   * 带输入验证的云对象方法创建器\n   * @template S - Zod验证模式类型\n   * @template O - 返回值类型\n   * @param schema - Zod验证模式，用于验证输入数据\n   * @param fn - 业务逻辑处理函数，接收上下文和验证后的输入数据\n   * @param options - 云对象创建选项\n   * @returns 云对象方法函数\n   */\n  <S extends ZodObject, O>(\n    schema: S,\n    fn: (context: CloudObjectContext, input: z.infer<S>) => MaybePromise<O>,\n    options?: CreateCloudObjectOptions,\n  ): CloudMethod<z.infer<S>, O>;\n\n  /**\n   * 无输入参数的云对象方法创建器\n   * @template O - 返回值类型\n   * @param fn - 业务逻辑处理函数，仅接收上下文\n   * @param options - 云对象创建选项\n   * @returns 云对象方法函数\n   */\n  <O>(fn: (context: CloudObjectContext) => MaybePromise<O>, options?: CreateCloudObjectOptions): CloudMethod<void, O>;\n};\n\n/**\n * 构建云对象方法创建器\n *\n * 该函数用于创建云对象方法的工厂函数，支持输入验证、用户身份验证、环境检查等功能。\n * 返回的创建器函数可以根据不同的配置创建云对象方法。\n *\n * @param options 构建选项，用于配置云对象方法创建器的行为\n * @returns 返回一个云对象方法创建器函数\n *\n * @example\n * // 创建一个需要用户登录的云对象方法\n * const createMethod = buildCloudMethodCreator({ uniIdCommonModule });\n * const myMethod = createMethod(async (context) => {\n *   return { message: 'Hello ' + context.user.id };\n * }, { requiredUser: true });\n */\nexport function buildCloudMethodCreator(options?: BuildCloudMethodCreatorOptions) {\n  const buildOptions = objectDefaults(options || {}, {\n    requiredUserErrCode: 'uni-id-check-token-failed',\n    requiredUserErrMsg: '需要登录后才能进行此操作',\n    onlyLocalEnvErrMsg: '运行环境不匹配',\n    respondAppend: () => ({}),\n  }) as Required<BuildCloudMethodCreatorOptions>;\n\n  // @ts-ignore\n  const createCloudMethod: CreateCloudMethod = (arg0, arg1, arg2) => {\n    // 确定选项来源：如果arg0是函数，则选项在arg1；否则在arg2\n    const optionsSource = (isFunction(arg0) ? arg1 : arg2) as CreateCloudObjectOptions | undefined;\n\n    // 设置默认选项值\n    const createOptions = objectDefaults(optionsSource || {}, {\n      requiredUser: false,\n      onlyLocalEnv: false,\n    }) as Required<CreateCloudObjectOptions>;\n\n    return async function (input) {\n      // 处理云对象方法响应逻辑，包括错误捕获和统一响应格式\n      return await respondCloudMethod(async () => {\n        const runtimeEnv = this.getCloudInfo().runtimeEnv;\n\n        if (createOptions.onlyLocalEnv && runtimeEnv !== 'local') {\n          throw createCloudObjectError(buildOptions.onlyLocalEnvErrMsg);\n        }\n\n        // 构建附加的上下文信息，包括用户身份和权限信息\n        const user = await _parseAppendUser(this, options?.uniIdCommonModule);\n        const append: _CloudObjectThisAppend = {\n          options: createOptions,\n          user: user,\n        };\n        const context = Object.assign(this, append) as CloudObjectContext;\n\n        // 如果需要用户登录态但用户未登录，则抛出错误\n        if (createOptions.requiredUser && !user.id) {\n          throw createCloudObjectError(buildOptions.requiredUserErrMsg, buildOptions.requiredUserErrCode);\n        }\n\n        // 无入参函数调用\n        if (isFunction(arg0)) {\n          return await arg0(context);\n        }\n\n        // 有入参函数调用 - 验证输入数据\n        const parsed = arg0.safeParse(input);\n\n        // 输入验证失败处理\n        if (!parsed.success) {\n          console.log(parsed.error.issues);\n\n          const issue0 = parsed.error?.issues?.[0];\n\n          // 处理自定义验证错误\n          if (issue0?.code === 'custom') throw issue0.message;\n          throw new Error('请求数据不正确');\n        }\n\n        // 执行业务逻辑函数，传入上下文和验证后的数据\n        return await arg1(context, parsed.data);\n      }, buildOptions.respondAppend(this));\n    };\n  };\n\n  return createCloudMethod;\n}\n\n/**\n * 解析并附加用户信息到云对象上下文\n *\n * 该函数用于验证用户身份并获取用户权限信息，将结果附加到云对象上下文中的user字段\n * 如果未提供uniIdCommonModule或验证失败，则返回默认的空用户信息\n *\n * @param objectThis 云对象上下文，包含客户端信息和token等\n * @param uniIdCommonModule 可选的UniId通用模块实例，用于验证用户token\n * @returns 返回包含用户ID、角色、权限等信息的对象\n *\n * @example\n * // 成功验证用户身份\n * const user = await _parseAppendUser(this, uniIdModule);\n * // 返回: { id: 'user123', role: ['user'], permission: ['read'], isAdmin: false }\n *\n * @example\n * // 验证失败或未提供模块\n * const user = await _parseAppendUser(this);\n * // 返回: { id: '', role: [], permission: [], isAdmin: false }\n */\nasync function _parseAppendUser(\n  objectThis: CloudObjectThis,\n  uniIdCommonModule?: UniIdCommonModule,\n): Promise<_CloudObjectThisAppendUser> {\n  const appendUser: _CloudObjectThisAppendUser = {\n    id: '',\n    role: [],\n    permission: [],\n    isAdmin: false,\n  };\n\n  if (!uniIdCommonModule) return appendUser;\n\n  const uic = uniIdCommonModule.createInstance({\n    clientInfo: objectThis.getClientInfo(),\n  });\n\n  // 验证用户token，忽略验证过程中的错误\n  const [err1, user] = await tryFlatten(uic.checkToken(objectThis.getUniIdToken() || ''));\n  if (!user) return appendUser;\n\n  // 解析验证结果，忽略解析过程中的错误\n  const [err2, userData] = tryFlatten(() => parseCloudModuleOutput(user));\n  if (!userData) return appendUser;\n\n  appendUser.id = userData.uid || '';\n  appendUser.role = userData.role || [];\n  appendUser.permission = userData.permission || [];\n  appendUser.isAdmin = appendUser.role.includes('admin') && appendUser.permission.length === 0;\n\n  return appendUser;\n}\n"],"names":["createCloudObjectError","objectOmit","errorNormalize","objectDefaults","isFunction","tryFlatten"],"mappings":"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"}
+{"version":3,"file":"cloud.cjs","sources":["../src/cloud/module.ts","../src/cloud/respond.ts","../src/cloud/method.ts"],"sourcesContent":["import { objectOmit } from '@cloudcome/utils-core/object';\nimport { createCloudObjectError } from './error';\nimport type { CloudModuleOutput } from './types';\n\n/**\n * 解析云模块输出结果\n *\n * 该函数用于处理云模块的输出，如果输出中包含错误码，则抛出相应的错误；\n * 否则返回去除错误码和错误信息后的数据部分。\n *\n * @template O - 输出数据的类型\n * @param output - 云模块的输出结果，包含errCode、errMsg和数据部分\n * @param fallbackErrorMessage - 当输出中没有错误信息时使用的默认错误消息\n * @returns 返回去除errCode和errMsg字段后的数据对象\n * @throws {CloudObjectError} 当output中存在errCode时抛出包含错误码和错误信息的异常\n *\n * @example\n * // 成功情况\n * const result = parseCloudModuleOutput({ value: 'success', errCode: 0, errMsg: '' });\n * // 返回: { value: 'success' }\n *\n * @example\n * // 错误情况\n * try {\n *   parseCloudModuleOutput({ errCode: 404, errMsg: 'Not Found' });\n * } catch (error) {\n *   // 抛出错误: CloudObjectError('Not Found', 404)\n * }\n */\nexport function parseCloudModuleOutput<O>(\n  output: CloudModuleOutput<O>,\n  fallbackErrorMessage = '',\n): Omit<O, 'errCode' | 'errMsg'> {\n  if (output.errCode) {\n    throw createCloudObjectError(output.errMsg || fallbackErrorMessage, output.errCode);\n  }\n  return objectOmit(output, ['errCode', 'errMsg']);\n}\n","import type { UniError } from '@/_types';\nimport { errorNormalize } from '@cloudcome/utils-core/error';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type { CloudMethodOutput } from './types';\n\n/**\n * 执行云对象方法并标准化响应格式\n *\n * @template O - 函数返回值的类型\n * @param fn - 要执行的异步函数\n * @param append - 要附加到响应中的额外数据\n * @returns 标准化的云对象响应对象\n *\n * @example\n * ```typescript\n * const result = await respondCloudMethod(async () => {\n *   return await getData();\n * }, { extra: 'data' });\n * ```\n */\nexport async function respondCloudMethod<O>(\n  fn: () => MaybePromise<O>,\n  append?: AnyObject,\n): Promise<CloudMethodOutput<O>> {\n  try {\n    const data = await fn();\n\n    return {\n      errCode: 0,\n      errMsg: '',\n      data,\n      ...append,\n    };\n  } catch (err) {\n    console.error('respondCloudObject error');\n    console.error(err);\n\n    const err2 = errorNormalize(err as UniError);\n\n    return {\n      errCode: err2.errCode || -1,\n      errMsg: err2.errMsg || err2.message || '',\n      // @ts-ignore\n      data: null,\n      ...append,\n    };\n  }\n}\n","import { objectDefaults, objectOmit } from '@cloudcome/utils-core/object';\nimport { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type z from 'zod';\nimport type { ZodObject } from 'zod';\nimport { createCloudObjectError } from './error';\nimport { parseCloudModuleOutput } from './module';\nimport { respondCloudMethod } from './respond';\nimport type { CloudMethod, CloudModuleOutput, CloudObjectThis } from './types';\nimport type { UniIdCommonModule } from './uni-id';\n\ntype _CloudObjectThisAppendUser = {\n  id: string;\n  role: string[];\n  permission: string[];\n  isAdmin: boolean;\n};\n\ntype _CloudObjectThisAppend = {\n  options: Required<CreateCloudObjectOptions>;\n  user: _CloudObjectThisAppendUser;\n};\n\nexport type CloudObjectContext = CloudObjectThis & _CloudObjectThisAppend;\n\nexport type BuildCloudMethodCreatorOptions = {\n  /**\n   * UniId 通用模块\n   * 用于处理用户身份验证和权限管理\n   * 如果提供，将在云对象执行前验证用户身份\n   */\n  uniIdCommonModule?: UniIdCommonModule;\n\n  /**\n   * 需要用户登录态的错误码\n   * @default 'uni-id-check-token-failed'\n   */\n  requiredUserErrCode?: number | string;\n\n  /**\n   * 需要用户登录态的错误消息\n   * @default '需要登录后才能进行此操作'\n   */\n  requiredUserErrMsg?: string;\n\n  /**\n   * 仅允许本地环境运行的错误消息\n   * @default '运行环境不匹配'\n   */\n  onlyLocalEnvErrMsg?: string;\n\n  /**\n   * 响应附加数据函数\n   * 用于在云对象响应中添加额外的上下文信息\n   * @param objectThis 云对象上下文\n   * @returns 返回要附加到响应中的数据对象\n   */\n  respondAppend?: (objectThis: CloudObjectThis) => AnyObject;\n};\n\nexport type CreateCloudObjectOptions = {\n  /**\n   * 是否需要用户登录态\n   * @default false\n   */\n  requiredUser?: boolean;\n\n  /**\n   * 是否仅在本地环境运行\n   * @default false\n   */\n  onlyLocalEnv?: boolean;\n};\n\n/**\n * 云对象方法创建器类型定义\n *\n * 用于定义云对象方法的创建函数类型，支持两种重载形式：\n * 1. 带输入验证的版本：接收schema、处理函数和选项\n * 2. 无输入参数的版本：仅接收处理函数和选项\n */\nexport type CreateCloudMethod = {\n  /**\n   * 带输入验证的云对象方法创建器\n   * @template S - Zod验证模式类型\n   * @template O - 返回值类型\n   * @param schema - Zod验证模式，用于验证输入数据\n   * @param fn - 业务逻辑处理函数，接收上下文和验证后的输入数据\n   * @param options - 云对象创建选项\n   * @returns 云对象方法函数\n   */\n  <S extends ZodObject, O>(\n    schema: S,\n    fn: (context: CloudObjectContext, input: z.infer<S>) => MaybePromise<O>,\n    options?: CreateCloudObjectOptions,\n  ): CloudMethod<z.infer<S>, O>;\n\n  /**\n   * 无输入参数的云对象方法创建器\n   * @template O - 返回值类型\n   * @param fn - 业务逻辑处理函数，仅接收上下文\n   * @param options - 云对象创建选项\n   * @returns 云对象方法函数\n   */\n  <O>(fn: (context: CloudObjectContext) => MaybePromise<O>, options?: CreateCloudObjectOptions): CloudMethod<void, O>;\n};\n\n/**\n * 构建云对象方法创建器\n *\n * 该函数用于创建云对象方法的工厂函数，支持输入验证、用户身份验证、环境检查等功能。\n * 返回的创建器函数可以根据不同的配置创建云对象方法。\n *\n * @param options 构建选项，用于配置云对象方法创建器的行为\n * @returns 返回一个云对象方法创建器函数\n *\n * @example\n * // 创建一个需要用户登录的云对象方法\n * const createMethod = buildCloudMethodCreator({ uniIdCommonModule });\n * const myMethod = createMethod(async (context) => {\n *   return { message: 'Hello ' + context.user.id };\n * }, { requiredUser: true });\n */\nexport function buildCloudMethodCreator(options?: BuildCloudMethodCreatorOptions) {\n  const buildOptions = objectDefaults(options || {}, {\n    requiredUserErrCode: 'uni-id-check-token-failed',\n    requiredUserErrMsg: '需要登录后才能进行此操作',\n    onlyLocalEnvErrMsg: '运行环境不匹配',\n    respondAppend: () => ({}),\n  }) as Required<BuildCloudMethodCreatorOptions>;\n\n  // @ts-ignore\n  const createCloudMethod: CreateCloudMethod = (arg0, arg1, arg2) => {\n    // 确定选项来源：如果arg0是函数，则选项在arg1；否则在arg2\n    const optionsSource = (isFunction(arg0) ? arg1 : arg2) as CreateCloudObjectOptions | undefined;\n\n    // 设置默认选项值\n    const createOptions = objectDefaults(optionsSource || {}, {\n      requiredUser: false,\n      onlyLocalEnv: false,\n    }) as Required<CreateCloudObjectOptions>;\n\n    return async function (input) {\n      // 处理云对象方法响应逻辑，包括错误捕获和统一响应格式\n      return await respondCloudMethod(async () => {\n        const runtimeEnv = this.getCloudInfo().runtimeEnv;\n\n        if (createOptions.onlyLocalEnv && runtimeEnv !== 'local') {\n          throw createCloudObjectError(buildOptions.onlyLocalEnvErrMsg);\n        }\n\n        // 构建附加的上下文信息，包括用户身份和权限信息\n        const user = await _parseAppendUser(this, options?.uniIdCommonModule);\n        const append: _CloudObjectThisAppend = {\n          options: createOptions,\n          user: user,\n        };\n        const context = Object.assign(this, append) as CloudObjectContext;\n\n        // 如果需要用户登录态但用户未登录，则抛出错误\n        if (createOptions.requiredUser && !user.id) {\n          throw createCloudObjectError(buildOptions.requiredUserErrMsg, buildOptions.requiredUserErrCode);\n        }\n\n        // 无入参函数调用\n        if (isFunction(arg0)) {\n          return await arg0(context);\n        }\n\n        // 有入参函数调用 - 验证输入数据\n        const parsed = arg0.safeParse(input);\n\n        // 输入验证失败处理\n        if (!parsed.success) {\n          console.log(parsed.error.issues);\n\n          const issue0 = parsed.error?.issues?.[0];\n\n          // 处理自定义验证错误\n          if (issue0?.code === 'custom') throw issue0.message;\n          throw new Error('请求数据不正确');\n        }\n\n        // 执行业务逻辑函数，传入上下文和验证后的数据\n        return await arg1(context, parsed.data);\n      }, buildOptions.respondAppend(this));\n    };\n  };\n\n  return createCloudMethod;\n}\n\n/**\n * 解析并附加用户信息到云对象上下文\n *\n * 该函数用于验证用户身份并获取用户权限信息，将结果附加到云对象上下文中的user字段\n * 如果未提供uniIdCommonModule或验证失败，则返回默认的空用户信息\n *\n * @param objectThis 云对象上下文，包含客户端信息和token等\n * @param uniIdCommonModule 可选的UniId通用模块实例，用于验证用户token\n * @returns 返回包含用户ID、角色、权限等信息的对象\n *\n * @example\n * // 成功验证用户身份\n * const user = await _parseAppendUser(this, uniIdModule);\n * // 返回: { id: 'user123', role: ['user'], permission: ['read'], isAdmin: false }\n *\n * @example\n * // 验证失败或未提供模块\n * const user = await _parseAppendUser(this);\n * // 返回: { id: '', role: [], permission: [], isAdmin: false }\n */\nasync function _parseAppendUser(\n  objectThis: CloudObjectThis,\n  uniIdCommonModule?: UniIdCommonModule,\n): Promise<_CloudObjectThisAppendUser> {\n  const appendUser: _CloudObjectThisAppendUser = {\n    id: '',\n    role: [],\n    permission: [],\n    isAdmin: false,\n  };\n\n  if (!uniIdCommonModule) return appendUser;\n\n  const uic = uniIdCommonModule.createInstance({\n    clientInfo: objectThis.getClientInfo(),\n  });\n\n  // 验证用户token，忽略验证过程中的错误\n  const [err1, user] = await tryFlatten(uic.checkToken(objectThis.getUniIdToken() || ''));\n  if (!user) return appendUser;\n\n  // 解析验证结果，忽略解析过程中的错误\n  const [err2, userData] = tryFlatten(() => parseCloudModuleOutput(user));\n  if (!userData) return appendUser;\n\n  appendUser.id = userData.uid || '';\n  appendUser.role = userData.role || [];\n  appendUser.permission = userData.permission || [];\n  appendUser.isAdmin = appendUser.role.includes('admin') && appendUser.permission.length === 0;\n\n  return appendUser;\n}\n"],"names":["createCloudObjectError","objectOmit","errorNormalize","objectDefaults","isFunction","tryFlatten"],"mappings":"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"}

package/dist/cloud.d.ts

@@ -1,4 +1,5 @@
 export { parseCloudMethodOutput } from './_helpers';
+export type { UniError } from './_types';
 export * from './cloud/error';
 export * from './cloud/method';
 export * from './cloud/types';

package/dist/cloud.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cloud.mjs","sources":["../src/cloud/module.ts","../src/cloud/respond.ts","../src/cloud/method.ts"],"sourcesContent":["import { objectOmit } from '@cloudcome/utils-core/object';\nimport { createCloudObjectError } from './error';\nimport type { CloudModuleOutput } from './types';\n\n/**\n * 解析云模块输出结果\n *\n * 该函数用于处理云模块的输出，如果输出中包含错误码，则抛出相应的错误；\n * 否则返回去除错误码和错误信息后的数据部分。\n *\n * @template O - 输出数据的类型\n * @param output - 云模块的输出结果，包含errCode、errMsg和数据部分\n * @param fallbackErrorMessage - 当输出中没有错误信息时使用的默认错误消息\n * @returns 返回去除errCode和errMsg字段后的数据对象\n * @throws {CloudObjectError} 当output中存在errCode时抛出包含错误码和错误信息的异常\n *\n * @example\n * // 成功情况\n * const result = parseCloudModuleOutput({ value: 'success', errCode: 0, errMsg: '' });\n * // 返回: { value: 'success' }\n *\n * @example\n * // 错误情况\n * try {\n *   parseCloudModuleOutput({ errCode: 404, errMsg: 'Not Found' });\n * } catch (error) {\n *   // 抛出错误: CloudObjectError('Not Found', 404)\n * }\n */\nexport function parseCloudModuleOutput<O>(\n  output: CloudModuleOutput<O>,\n  fallbackErrorMessage = '',\n): Omit<O, 'errCode' | 'errMsg'> {\n  if (output.errCode) {\n    throw createCloudObjectError(output.errMsg || fallbackErrorMessage, output.errCode);\n  }\n  return objectOmit(output, ['errCode', 'errMsg']);\n}\n","import { errorNormalize } from '@cloudcome/utils-core/error';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type { CloudMethodOutput } from './types';\n\n/**\n * 执行云对象方法并标准化响应格式\n *\n * @template O - 函数返回值的类型\n * @param fn - 要执行的异步函数\n * @param append - 要附加到响应中的额外数据\n * @returns 标准化的云对象响应对象\n *\n * @example\n * ```typescript\n * const result = await respondCloudMethod(async () => {\n *   return await getData();\n * }, { extra: 'data' });\n * ```\n */\nexport async function respondCloudMethod<O>(\n  fn: () => MaybePromise<O>,\n  append?: AnyObject,\n): Promise<CloudMethodOutput<O>> {\n  try {\n    const data = await fn();\n\n    return {\n      errCode: 0,\n      errMsg: '',\n      data,\n      ...append,\n    };\n  } catch (err) {\n    console.error('respondCloudObject error');\n    console.error(err);\n\n    const err2 = errorNormalize(err as Error & { errCode?: number | string; errMsg?: string });\n\n    return {\n      errCode: err2.errCode || -1,\n      errMsg: err2.errMsg || err2.message || '',\n      // @ts-ignore\n      data: null,\n      ...append,\n    };\n  }\n}\n","import { objectDefaults, objectOmit } from '@cloudcome/utils-core/object';\nimport { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type z from 'zod';\nimport type { ZodObject } from 'zod';\nimport { createCloudObjectError } from './error';\nimport { parseCloudModuleOutput } from './module';\nimport { respondCloudMethod } from './respond';\nimport type { CloudMethod, CloudModuleOutput, CloudObjectThis } from './types';\nimport type { UniIdCommonModule } from './uni-id';\n\ntype _CloudObjectThisAppendUser = {\n  id: string;\n  role: string[];\n  permission: string[];\n  isAdmin: boolean;\n};\n\ntype _CloudObjectThisAppend = {\n  options: Required<CreateCloudObjectOptions>;\n  user: _CloudObjectThisAppendUser;\n};\n\nexport type CloudObjectContext = CloudObjectThis & _CloudObjectThisAppend;\n\nexport type BuildCloudMethodCreatorOptions = {\n  /**\n   * UniId 通用模块\n   * 用于处理用户身份验证和权限管理\n   * 如果提供，将在云对象执行前验证用户身份\n   */\n  uniIdCommonModule?: UniIdCommonModule;\n\n  /**\n   * 需要用户登录态的错误码\n   * @default 'uni-id-check-token-failed'\n   */\n  requiredUserErrCode?: number | string;\n\n  /**\n   * 需要用户登录态的错误消息\n   * @default '需要登录后才能进行此操作'\n   */\n  requiredUserErrMsg?: string;\n\n  /**\n   * 仅允许本地环境运行的错误消息\n   * @default '运行环境不匹配'\n   */\n  onlyLocalEnvErrMsg?: string;\n\n  /**\n   * 响应附加数据函数\n   * 用于在云对象响应中添加额外的上下文信息\n   * @param objectThis 云对象上下文\n   * @returns 返回要附加到响应中的数据对象\n   */\n  respondAppend?: (objectThis: CloudObjectThis) => AnyObject;\n};\n\nexport type CreateCloudObjectOptions = {\n  /**\n   * 是否需要用户登录态\n   * @default false\n   */\n  requiredUser?: boolean;\n\n  /**\n   * 是否仅在本地环境运行\n   * @default false\n   */\n  onlyLocalEnv?: boolean;\n};\n\n/**\n * 云对象方法创建器类型定义\n *\n * 用于定义云对象方法的创建函数类型，支持两种重载形式：\n * 1. 带输入验证的版本：接收schema、处理函数和选项\n * 2. 无输入参数的版本：仅接收处理函数和选项\n */\nexport type CreateCloudMethod = {\n  /**\n   * 带输入验证的云对象方法创建器\n   * @template S - Zod验证模式类型\n   * @template O - 返回值类型\n   * @param schema - Zod验证模式，用于验证输入数据\n   * @param fn - 业务逻辑处理函数，接收上下文和验证后的输入数据\n   * @param options - 云对象创建选项\n   * @returns 云对象方法函数\n   */\n  <S extends ZodObject, O>(\n    schema: S,\n    fn: (context: CloudObjectContext, input: z.infer<S>) => MaybePromise<O>,\n    options?: CreateCloudObjectOptions,\n  ): CloudMethod<z.infer<S>, O>;\n\n  /**\n   * 无输入参数的云对象方法创建器\n   * @template O - 返回值类型\n   * @param fn - 业务逻辑处理函数，仅接收上下文\n   * @param options - 云对象创建选项\n   * @returns 云对象方法函数\n   */\n  <O>(fn: (context: CloudObjectContext) => MaybePromise<O>, options?: CreateCloudObjectOptions): CloudMethod<void, O>;\n};\n\n/**\n * 构建云对象方法创建器\n *\n * 该函数用于创建云对象方法的工厂函数，支持输入验证、用户身份验证、环境检查等功能。\n * 返回的创建器函数可以根据不同的配置创建云对象方法。\n *\n * @param options 构建选项，用于配置云对象方法创建器的行为\n * @returns 返回一个云对象方法创建器函数\n *\n * @example\n * // 创建一个需要用户登录的云对象方法\n * const createMethod = buildCloudMethodCreator({ uniIdCommonModule });\n * const myMethod = createMethod(async (context) => {\n *   return { message: 'Hello ' + context.user.id };\n * }, { requiredUser: true });\n */\nexport function buildCloudMethodCreator(options?: BuildCloudMethodCreatorOptions) {\n  const buildOptions = objectDefaults(options || {}, {\n    requiredUserErrCode: 'uni-id-check-token-failed',\n    requiredUserErrMsg: '需要登录后才能进行此操作',\n    onlyLocalEnvErrMsg: '运行环境不匹配',\n    respondAppend: () => ({}),\n  }) as Required<BuildCloudMethodCreatorOptions>;\n\n  // @ts-ignore\n  const createCloudMethod: CreateCloudMethod = (arg0, arg1, arg2) => {\n    // 确定选项来源：如果arg0是函数，则选项在arg1；否则在arg2\n    const optionsSource = (isFunction(arg0) ? arg1 : arg2) as CreateCloudObjectOptions | undefined;\n\n    // 设置默认选项值\n    const createOptions = objectDefaults(optionsSource || {}, {\n      requiredUser: false,\n      onlyLocalEnv: false,\n    }) as Required<CreateCloudObjectOptions>;\n\n    return async function (input) {\n      // 处理云对象方法响应逻辑，包括错误捕获和统一响应格式\n      return await respondCloudMethod(async () => {\n        const runtimeEnv = this.getCloudInfo().runtimeEnv;\n\n        if (createOptions.onlyLocalEnv && runtimeEnv !== 'local') {\n          throw createCloudObjectError(buildOptions.onlyLocalEnvErrMsg);\n        }\n\n        // 构建附加的上下文信息，包括用户身份和权限信息\n        const user = await _parseAppendUser(this, options?.uniIdCommonModule);\n        const append: _CloudObjectThisAppend = {\n          options: createOptions,\n          user: user,\n        };\n        const context = Object.assign(this, append) as CloudObjectContext;\n\n        // 如果需要用户登录态但用户未登录，则抛出错误\n        if (createOptions.requiredUser && !user.id) {\n          throw createCloudObjectError(buildOptions.requiredUserErrMsg, buildOptions.requiredUserErrCode);\n        }\n\n        // 无入参函数调用\n        if (isFunction(arg0)) {\n          return await arg0(context);\n        }\n\n        // 有入参函数调用 - 验证输入数据\n        const parsed = arg0.safeParse(input);\n\n        // 输入验证失败处理\n        if (!parsed.success) {\n          console.log(parsed.error.issues);\n\n          const issue0 = parsed.error?.issues?.[0];\n\n          // 处理自定义验证错误\n          if (issue0?.code === 'custom') throw issue0.message;\n          throw new Error('请求数据不正确');\n        }\n\n        // 执行业务逻辑函数，传入上下文和验证后的数据\n        return await arg1(context, parsed.data);\n      }, buildOptions.respondAppend(this));\n    };\n  };\n\n  return createCloudMethod;\n}\n\n/**\n * 解析并附加用户信息到云对象上下文\n *\n * 该函数用于验证用户身份并获取用户权限信息，将结果附加到云对象上下文中的user字段\n * 如果未提供uniIdCommonModule或验证失败，则返回默认的空用户信息\n *\n * @param objectThis 云对象上下文，包含客户端信息和token等\n * @param uniIdCommonModule 可选的UniId通用模块实例，用于验证用户token\n * @returns 返回包含用户ID、角色、权限等信息的对象\n *\n * @example\n * // 成功验证用户身份\n * const user = await _parseAppendUser(this, uniIdModule);\n * // 返回: { id: 'user123', role: ['user'], permission: ['read'], isAdmin: false }\n *\n * @example\n * // 验证失败或未提供模块\n * const user = await _parseAppendUser(this);\n * // 返回: { id: '', role: [], permission: [], isAdmin: false }\n */\nasync function _parseAppendUser(\n  objectThis: CloudObjectThis,\n  uniIdCommonModule?: UniIdCommonModule,\n): Promise<_CloudObjectThisAppendUser> {\n  const appendUser: _CloudObjectThisAppendUser = {\n    id: '',\n    role: [],\n    permission: [],\n    isAdmin: false,\n  };\n\n  if (!uniIdCommonModule) return appendUser;\n\n  const uic = uniIdCommonModule.createInstance({\n    clientInfo: objectThis.getClientInfo(),\n  });\n\n  // 验证用户token，忽略验证过程中的错误\n  const [err1, user] = await tryFlatten(uic.checkToken(objectThis.getUniIdToken() || ''));\n  if (!user) return appendUser;\n\n  // 解析验证结果，忽略解析过程中的错误\n  const [err2, userData] = tryFlatten(() => parseCloudModuleOutput(user));\n  if (!userData) return appendUser;\n\n  appendUser.id = userData.uid || '';\n  appendUser.role = userData.role || [];\n  appendUser.permission = userData.permission || [];\n  appendUser.isAdmin = appendUser.role.includes('admin') && appendUser.permission.length === 0;\n\n  return appendUser;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"cloud.mjs","sources":["../src/cloud/module.ts","../src/cloud/respond.ts","../src/cloud/method.ts"],"sourcesContent":["import { objectOmit } from '@cloudcome/utils-core/object';\nimport { createCloudObjectError } from './error';\nimport type { CloudModuleOutput } from './types';\n\n/**\n * 解析云模块输出结果\n *\n * 该函数用于处理云模块的输出，如果输出中包含错误码，则抛出相应的错误；\n * 否则返回去除错误码和错误信息后的数据部分。\n *\n * @template O - 输出数据的类型\n * @param output - 云模块的输出结果，包含errCode、errMsg和数据部分\n * @param fallbackErrorMessage - 当输出中没有错误信息时使用的默认错误消息\n * @returns 返回去除errCode和errMsg字段后的数据对象\n * @throws {CloudObjectError} 当output中存在errCode时抛出包含错误码和错误信息的异常\n *\n * @example\n * // 成功情况\n * const result = parseCloudModuleOutput({ value: 'success', errCode: 0, errMsg: '' });\n * // 返回: { value: 'success' }\n *\n * @example\n * // 错误情况\n * try {\n *   parseCloudModuleOutput({ errCode: 404, errMsg: 'Not Found' });\n * } catch (error) {\n *   // 抛出错误: CloudObjectError('Not Found', 404)\n * }\n */\nexport function parseCloudModuleOutput<O>(\n  output: CloudModuleOutput<O>,\n  fallbackErrorMessage = '',\n): Omit<O, 'errCode' | 'errMsg'> {\n  if (output.errCode) {\n    throw createCloudObjectError(output.errMsg || fallbackErrorMessage, output.errCode);\n  }\n  return objectOmit(output, ['errCode', 'errMsg']);\n}\n","import type { UniError } from '@/_types';\nimport { errorNormalize } from '@cloudcome/utils-core/error';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type { CloudMethodOutput } from './types';\n\n/**\n * 执行云对象方法并标准化响应格式\n *\n * @template O - 函数返回值的类型\n * @param fn - 要执行的异步函数\n * @param append - 要附加到响应中的额外数据\n * @returns 标准化的云对象响应对象\n *\n * @example\n * ```typescript\n * const result = await respondCloudMethod(async () => {\n *   return await getData();\n * }, { extra: 'data' });\n * ```\n */\nexport async function respondCloudMethod<O>(\n  fn: () => MaybePromise<O>,\n  append?: AnyObject,\n): Promise<CloudMethodOutput<O>> {\n  try {\n    const data = await fn();\n\n    return {\n      errCode: 0,\n      errMsg: '',\n      data,\n      ...append,\n    };\n  } catch (err) {\n    console.error('respondCloudObject error');\n    console.error(err);\n\n    const err2 = errorNormalize(err as UniError);\n\n    return {\n      errCode: err2.errCode || -1,\n      errMsg: err2.errMsg || err2.message || '',\n      // @ts-ignore\n      data: null,\n      ...append,\n    };\n  }\n}\n","import { objectDefaults, objectOmit } from '@cloudcome/utils-core/object';\nimport { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type z from 'zod';\nimport type { ZodObject } from 'zod';\nimport { createCloudObjectError } from './error';\nimport { parseCloudModuleOutput } from './module';\nimport { respondCloudMethod } from './respond';\nimport type { CloudMethod, CloudModuleOutput, CloudObjectThis } from './types';\nimport type { UniIdCommonModule } from './uni-id';\n\ntype _CloudObjectThisAppendUser = {\n  id: string;\n  role: string[];\n  permission: string[];\n  isAdmin: boolean;\n};\n\ntype _CloudObjectThisAppend = {\n  options: Required<CreateCloudObjectOptions>;\n  user: _CloudObjectThisAppendUser;\n};\n\nexport type CloudObjectContext = CloudObjectThis & _CloudObjectThisAppend;\n\nexport type BuildCloudMethodCreatorOptions = {\n  /**\n   * UniId 通用模块\n   * 用于处理用户身份验证和权限管理\n   * 如果提供，将在云对象执行前验证用户身份\n   */\n  uniIdCommonModule?: UniIdCommonModule;\n\n  /**\n   * 需要用户登录态的错误码\n   * @default 'uni-id-check-token-failed'\n   */\n  requiredUserErrCode?: number | string;\n\n  /**\n   * 需要用户登录态的错误消息\n   * @default '需要登录后才能进行此操作'\n   */\n  requiredUserErrMsg?: string;\n\n  /**\n   * 仅允许本地环境运行的错误消息\n   * @default '运行环境不匹配'\n   */\n  onlyLocalEnvErrMsg?: string;\n\n  /**\n   * 响应附加数据函数\n   * 用于在云对象响应中添加额外的上下文信息\n   * @param objectThis 云对象上下文\n   * @returns 返回要附加到响应中的数据对象\n   */\n  respondAppend?: (objectThis: CloudObjectThis) => AnyObject;\n};\n\nexport type CreateCloudObjectOptions = {\n  /**\n   * 是否需要用户登录态\n   * @default false\n   */\n  requiredUser?: boolean;\n\n  /**\n   * 是否仅在本地环境运行\n   * @default false\n   */\n  onlyLocalEnv?: boolean;\n};\n\n/**\n * 云对象方法创建器类型定义\n *\n * 用于定义云对象方法的创建函数类型，支持两种重载形式：\n * 1. 带输入验证的版本：接收schema、处理函数和选项\n * 2. 无输入参数的版本：仅接收处理函数和选项\n */\nexport type CreateCloudMethod = {\n  /**\n   * 带输入验证的云对象方法创建器\n   * @template S - Zod验证模式类型\n   * @template O - 返回值类型\n   * @param schema - Zod验证模式，用于验证输入数据\n   * @param fn - 业务逻辑处理函数，接收上下文和验证后的输入数据\n   * @param options - 云对象创建选项\n   * @returns 云对象方法函数\n   */\n  <S extends ZodObject, O>(\n    schema: S,\n    fn: (context: CloudObjectContext, input: z.infer<S>) => MaybePromise<O>,\n    options?: CreateCloudObjectOptions,\n  ): CloudMethod<z.infer<S>, O>;\n\n  /**\n   * 无输入参数的云对象方法创建器\n   * @template O - 返回值类型\n   * @param fn - 业务逻辑处理函数，仅接收上下文\n   * @param options - 云对象创建选项\n   * @returns 云对象方法函数\n   */\n  <O>(fn: (context: CloudObjectContext) => MaybePromise<O>, options?: CreateCloudObjectOptions): CloudMethod<void, O>;\n};\n\n/**\n * 构建云对象方法创建器\n *\n * 该函数用于创建云对象方法的工厂函数，支持输入验证、用户身份验证、环境检查等功能。\n * 返回的创建器函数可以根据不同的配置创建云对象方法。\n *\n * @param options 构建选项，用于配置云对象方法创建器的行为\n * @returns 返回一个云对象方法创建器函数\n *\n * @example\n * // 创建一个需要用户登录的云对象方法\n * const createMethod = buildCloudMethodCreator({ uniIdCommonModule });\n * const myMethod = createMethod(async (context) => {\n *   return { message: 'Hello ' + context.user.id };\n * }, { requiredUser: true });\n */\nexport function buildCloudMethodCreator(options?: BuildCloudMethodCreatorOptions) {\n  const buildOptions = objectDefaults(options || {}, {\n    requiredUserErrCode: 'uni-id-check-token-failed',\n    requiredUserErrMsg: '需要登录后才能进行此操作',\n    onlyLocalEnvErrMsg: '运行环境不匹配',\n    respondAppend: () => ({}),\n  }) as Required<BuildCloudMethodCreatorOptions>;\n\n  // @ts-ignore\n  const createCloudMethod: CreateCloudMethod = (arg0, arg1, arg2) => {\n    // 确定选项来源：如果arg0是函数，则选项在arg1；否则在arg2\n    const optionsSource = (isFunction(arg0) ? arg1 : arg2) as CreateCloudObjectOptions | undefined;\n\n    // 设置默认选项值\n    const createOptions = objectDefaults(optionsSource || {}, {\n      requiredUser: false,\n      onlyLocalEnv: false,\n    }) as Required<CreateCloudObjectOptions>;\n\n    return async function (input) {\n      // 处理云对象方法响应逻辑，包括错误捕获和统一响应格式\n      return await respondCloudMethod(async () => {\n        const runtimeEnv = this.getCloudInfo().runtimeEnv;\n\n        if (createOptions.onlyLocalEnv && runtimeEnv !== 'local') {\n          throw createCloudObjectError(buildOptions.onlyLocalEnvErrMsg);\n        }\n\n        // 构建附加的上下文信息，包括用户身份和权限信息\n        const user = await _parseAppendUser(this, options?.uniIdCommonModule);\n        const append: _CloudObjectThisAppend = {\n          options: createOptions,\n          user: user,\n        };\n        const context = Object.assign(this, append) as CloudObjectContext;\n\n        // 如果需要用户登录态但用户未登录，则抛出错误\n        if (createOptions.requiredUser && !user.id) {\n          throw createCloudObjectError(buildOptions.requiredUserErrMsg, buildOptions.requiredUserErrCode);\n        }\n\n        // 无入参函数调用\n        if (isFunction(arg0)) {\n          return await arg0(context);\n        }\n\n        // 有入参函数调用 - 验证输入数据\n        const parsed = arg0.safeParse(input);\n\n        // 输入验证失败处理\n        if (!parsed.success) {\n          console.log(parsed.error.issues);\n\n          const issue0 = parsed.error?.issues?.[0];\n\n          // 处理自定义验证错误\n          if (issue0?.code === 'custom') throw issue0.message;\n          throw new Error('请求数据不正确');\n        }\n\n        // 执行业务逻辑函数，传入上下文和验证后的数据\n        return await arg1(context, parsed.data);\n      }, buildOptions.respondAppend(this));\n    };\n  };\n\n  return createCloudMethod;\n}\n\n/**\n * 解析并附加用户信息到云对象上下文\n *\n * 该函数用于验证用户身份并获取用户权限信息，将结果附加到云对象上下文中的user字段\n * 如果未提供uniIdCommonModule或验证失败，则返回默认的空用户信息\n *\n * @param objectThis 云对象上下文，包含客户端信息和token等\n * @param uniIdCommonModule 可选的UniId通用模块实例，用于验证用户token\n * @returns 返回包含用户ID、角色、权限等信息的对象\n *\n * @example\n * // 成功验证用户身份\n * const user = await _parseAppendUser(this, uniIdModule);\n * // 返回: { id: 'user123', role: ['user'], permission: ['read'], isAdmin: false }\n *\n * @example\n * // 验证失败或未提供模块\n * const user = await _parseAppendUser(this);\n * // 返回: { id: '', role: [], permission: [], isAdmin: false }\n */\nasync function _parseAppendUser(\n  objectThis: CloudObjectThis,\n  uniIdCommonModule?: UniIdCommonModule,\n): Promise<_CloudObjectThisAppendUser> {\n  const appendUser: _CloudObjectThisAppendUser = {\n    id: '',\n    role: [],\n    permission: [],\n    isAdmin: false,\n  };\n\n  if (!uniIdCommonModule) return appendUser;\n\n  const uic = uniIdCommonModule.createInstance({\n    clientInfo: objectThis.getClientInfo(),\n  });\n\n  // 验证用户token，忽略验证过程中的错误\n  const [err1, user] = await tryFlatten(uic.checkToken(objectThis.getUniIdToken() || ''));\n  if (!user) return appendUser;\n\n  // 解析验证结果，忽略解析过程中的错误\n  const [err2, userData] = tryFlatten(() => parseCloudModuleOutput(user));\n  if (!userData) return appendUser;\n\n  appendUser.id = userData.uid || '';\n  appendUser.role = userData.role || [];\n  appendUser.permission = userData.permission || [];\n  appendUser.isAdmin = appendUser.role.includes('admin') && appendUser.permission.length === 0;\n\n  return appendUser;\n}\n"],"names":[],"mappings":"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"}

package/dist/database/_db.class.d.ts

@@ -1,3 +1,4 @@
+import { UniError } from '../_types';
 import { AnyObject, MergeIntersection } from '@cloudcome/utils-core/types';
 import { DbQueryCommand } from './_command.class';
 import { DbCreate, DbForeign, DbOrder, DbQuery, DbRelation, DbSelect, DbUpdate, DbWhere } from './types';
@@ -14,6 +15,12 @@ export type DbOptions = {
      * 模拟数据库，用于单元测试
      */
     _mockDatabase?: any;
+    /**
+     * 自定义错误处理函数
+     * @param error 数据库错误对象
+     * @returns 处理后的数据库错误对象
+     */
+    parseError?: (error: UniError) => UniError;
 };
 export type DbLookupOptions<RL extends DbRelation, D1, FD1, AS, US extends boolean | undefined | void = undefined> = {
     /**
@@ -66,6 +73,7 @@ export declare class Db<D1, S1 extends DbSelect<D1> = {}, D2 extends AnyObject =
      */
     constructor(options: DbOptions);
     get table(): string;
+    get options(): DbOptions;
     /**
      * 获取聚合操作实例
      * @returns 聚合操作实例

package/dist/database/proxy.d.ts

@@ -1,3 +1,4 @@
+import { UniError } from '../_types';
 import { Db } from './_db.class';
 import { DbSelect } from './types';
 /**
@@ -8,6 +9,14 @@ import { DbSelect } from './types';
 export type DbProxy<D1, S1 extends DbSelect<D1> = {}> = Db<D1, S1> & {
     _isProxy: true;
 };
+export type DbProxyOptions = {
+    /**
+     * 自定义错误处理函数
+     * @param error 数据库错误对象
+     * @returns 处理后的数据库错误对象
+     */
+    parseError?: (error: UniError) => UniError;
+};
 /**
  * 创建一个数据库代理对象，用于延迟实例化数据库操作类
  * @template D1 - 主表数据
@@ -15,4 +24,4 @@ export type DbProxy<D1, S1 extends DbSelect<D1> = {}> = Db<D1, S1> & {
  * @param name - 数据库表名
  * @returns 返回一个代理对象，该对象会将属性访问转发到实际的数据库操作实例
  */
-export declare function dbProxy<D1, S1 extends DbSelect<D1> = {}>(name: string): DbProxy<D1, S1>;
+export declare function dbProxy<D1, S1 extends DbSelect<D1> = {}>(name: string, options?: DbProxyOptions): DbProxy<D1, S1>;