@cloudcome/utils-uni 1.8.0 → 1.9.0

package/dist/cloud/expose.d.ts

@@ -33,6 +33,13 @@ export type BuildCloudExposeCreatorOptions = {
      * @default '需要登录后才能进行此操作'
      */
     requiredUserErrMsg?: string;
+    /**
+     * 响应附加数据函数
+     * 用于在云对象响应中添加额外的上下文信息
+     * @param objectThis 云对象上下文
+     * @returns 返回要附加到响应中的数据对象
+     */
+    respondAppend?: (objectThis: UniCloudObjectThis) => AnyObject;
 };
 export type CreateCloudObjectOptions = {
     /**
@@ -45,4 +52,36 @@ export type CreateCloudObjectExpose = {
     <S extends ZodObject, O>(schema: S, fn: (context: UniCloudObjectContext, input: z.infer<S>) => MaybePromise<O>, options?: CreateCloudObjectOptions): UniCloudObject<z.infer<S>, O>;
     <O>(fn: (context: UniCloudObjectContext) => MaybePromise<O>, options?: CreateCloudObjectOptions): UniCloudObject<void, O>;
 };
+/**
+ * 构建云对象暴露创建器
+ *
+ * 该函数用于创建一个云对象暴露函数，可以处理用户身份验证、输入验证和错误处理等通用逻辑
+ *
+ * @param options 构建选项配置
+ * @param options.uniIdCloudObject 可选的UniIdCloudObject实例，用于处理用户身份验证和权限管理
+ * @param options.requiredUserErrCode 需要用户登录态时的错误码，默认为 'uni-id-check-token-failed'
+ * @param options.requiredUserErrMsg 需要用户登录态时的错误消息，默认为 '需要登录后才能进行此操作'
+ *
+ * @returns 返回一个云对象暴露创建函数，支持两种重载形式：
+ * 1. 无输入参数的形式：(fn, options) => UniCloudObject
+ * 2. 有输入验证的形式：(schema, fn, options) => UniCloudObject
+ *
+ * @example
+ * // 无输入参数的使用方式
+ * const expose = buildCloudObjectExposeCreator();
+ * export default expose(async (context) => {
+ *   // 业务逻辑
+ * });
+ *
+ * @example
+ * // 有输入验证的使用方式
+ * const expose = buildCloudObjectExposeCreator();
+ * const schema = z.object({
+ *   name: z.string().min(1)
+ * });
+ *
+ * export default expose(schema, async (context, input) => {
+ *   // 业务逻辑，input类型已自动推断
+ * });
+ */
 export declare function buildCloudObjectExposeCreator(options?: BuildCloudExposeCreatorOptions): CreateCloudObjectExpose;

package/dist/cloud/object.d.ts

@@ -127,6 +127,5 @@ export type UniCloudObjectOutput<T> = {
     errCode?: number | string;
     errMsg?: string;
     data: T;
-    requestId?: string;
 };
 export type UniCloudObject<I, O> = (this: UniCloudObjectThis, input: I) => Promise<UniCloudObjectOutput<O>>;

package/dist/cloud/respond.d.ts

@@ -1,3 +1,24 @@
 import { MaybePromise } from '@cloudcome/utils-core/types';
 import { UniCloudObjectOutput } from './object';
-export declare function respondCloudObject<O>(fn: () => MaybePromise<O>, requestId?: string): Promise<UniCloudObjectOutput<O>>;
+/**
+ * 处理云函数响应结果，统一返回格式
+ * @param fn - 执行函数，可以返回任意类型的值或Promise
+ * @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 }
+ * ```
+ */
+export declare function respondCloudObject<O>(fn: () => MaybePromise<O>, append?: AnyObject): Promise<UniCloudObjectOutput<O>>;

package/dist/cloud.cjs

@@ -11,14 +11,14 @@ function createCloudObjectError(message, code) {
     errMsg: message
   });
 }
-async function respondCloudObject(fn, requestId) {
+async function respondCloudObject(fn, append) {
   try {
     const data = await fn();
     return {
       errCode: 0,
       errMsg: "",
       data,
-      requestId
+      ...append
     };
   } catch (err) {
     console.error("respondCloudObject error");
@@ -29,14 +29,15 @@ async function respondCloudObject(fn, requestId) {
       errMsg: err2.errMsg || err2.message || "",
       // @ts-ignore
       data: null,
-      requestId
+      ...append
     };
   }
 }
 function buildCloudObjectExposeCreator(options) {
   const buildOptions = object.objectDefaults(options || {}, {
     requiredUserErrCode: "uni-id-check-token-failed",
-    requiredUserErrMsg: "需要登录后才能进行此操作"
+    requiredUserErrMsg: "需要登录后才能进行此操作",
+    respondAppend: () => ({})
   });
   const createCloudObjectExpose = (arg0, arg1, arg2) => {
     const optionsSource = type.isFunction(arg0) ? arg1 : arg2;
@@ -65,7 +66,7 @@ function buildCloudObjectExposeCreator(options) {
           throw new Error("请求数据不正确");
         }
         return await arg1(context, parsed.data);
-      }, this.getUniCloudRequestId());
+      }, buildOptions.respondAppend(this));
     };
   };
   return createCloudObjectExpose;

package/dist/cloud.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cloud.cjs","sources":["../src/cloud/error.ts","../src/cloud/respond.ts","../src/cloud/expose.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\n\nexport function createCloudObjectError(message: string, code?: number | string) {\n  return errorAssign(new Error(message), {\n    errCode: code,\n    errMsg: message,\n  });\n}\n","import { errorNormalize } from '@cloudcome/utils-core/error';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type { UniCloudObjectOutput } from './object';\n\nexport async function respondCloudObject<O>(\n  fn: () => MaybePromise<O>,\n  requestId?: string,\n): Promise<UniCloudObjectOutput<O>> {\n  try {\n    const data = await fn();\n\n    return {\n      errCode: 0,\n      errMsg: '',\n      data,\n      requestId,\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      requestId,\n    };\n  }\n}\n","import { parseCloudObjectOutput } from '@/_helpers';\nimport { objectDefaults } 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 type { UniCloudObject, UniCloudObjectThis } from './object';\nimport { respondCloudObject } from './respond';\nimport type { UniIdCloudObject } from './uni-id';\n\nexport type UniCloudObjectThisAppendUser = {\n  id: string;\n  role: string[];\n  permission: string[];\n  isAdmin: boolean;\n};\n\nexport type UniCloudObjectThisAppend = {\n  options: Required<CreateCloudObjectOptions>;\n  user: UniCloudObjectThisAppendUser;\n};\n\nexport type UniCloudObjectContext = UniCloudObjectThis & UniCloudObjectThisAppend;\n\n/**\n * 构建云函数暴露创建器的选项配置\n * 用于配置云函数暴露创建器的行为，目前支持传入UniIdCloudObject实例\n */\nexport type BuildCloudExposeCreatorOptions = {\n  /**\n   * 可选的UniIdCloudObject实例\n   * 用于处理用户身份验证和权限管理相关功能\n   */\n  uniIdCloudObject?: UniIdCloudObject;\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\nexport type CreateCloudObjectOptions = {\n  /**\n   * 是否需要用户登录态\n   * @default false\n   */\n  requiredUser?: boolean;\n};\n\nexport type CreateCloudObjectExpose = {\n  <S extends ZodObject, O>(\n    schema: S,\n    fn: (context: UniCloudObjectContext, input: z.infer<S>) => MaybePromise<O>,\n    options?: CreateCloudObjectOptions,\n  ): UniCloudObject<z.infer<S>, O>;\n  <O>(\n    fn: (context: UniCloudObjectContext) => MaybePromise<O>,\n    options?: CreateCloudObjectOptions,\n  ): UniCloudObject<void, O>;\n};\n\nexport function buildCloudObjectExposeCreator(options?: BuildCloudExposeCreatorOptions) {\n  const buildOptions = objectDefaults(options || {}, {\n    requiredUserErrCode: 'uni-id-check-token-failed',\n    requiredUserErrMsg: '需要登录后才能进行此操作',\n  }) as Required<BuildCloudExposeCreatorOptions>;\n\n  // @ts-ignore\n  const createCloudObjectExpose: CreateCloudObjectExpose = (arg0, arg1, arg2) => {\n    // 选项来源\n    const optionsSource = (isFunction(arg0) ? arg1 : arg2) as CreateCloudObjectOptions | undefined;\n    // 设置默认选项值\n    const createOptions = objectDefaults(optionsSource || {}, {\n      requiredUser: false,\n    }) as Required<CreateCloudObjectOptions>;\n\n    return async function (input) {\n      // 处理云函数响应逻辑\n      return await respondCloudObject(async () => {\n        // 构建附加的上下文信息\n        const user = await parseAppendUser(this, options?.uniIdCloudObject);\n        const append: UniCloudObjectThisAppend = {\n          options: createOptions,\n          user: user,\n        };\n        const context = Object.assign(this, append) as UniCloudObjectContext;\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        // 验证输入数据\n        const parsed = arg0.safeParse(input);\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        return await arg1(context, parsed.data);\n      }, this.getUniCloudRequestId());\n    };\n  };\n\n  return createCloudObjectExpose;\n}\n\nasync function parseAppendUser(\n  objectThis: UniCloudObjectThis,\n  uniIdCloudObject?: UniIdCloudObject,\n): Promise<UniCloudObjectThisAppendUser> {\n  const appendUser: UniCloudObjectThisAppendUser = {\n    id: '',\n    role: [],\n    permission: [],\n    isAdmin: false,\n  };\n\n  if (!uniIdCloudObject) return appendUser;\n\n  const uniId = uniIdCloudObject.createInstance({\n    clientInfo: objectThis.getClientInfo(),\n  });\n\n  // 忽略错误1\n  const [err1, user] = await tryFlatten(uniId.checkToken(objectThis.getUniIdToken() || ''));\n  if (!user) return appendUser;\n\n  // 忽略错误2\n  const [err2, userData] = tryFlatten(() => parseCloudObjectOutput(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":["errorAssign","errorNormalize","objectDefaults","isFunction","tryFlatten","parseCloudObjectOutput"],"mappings":";;;;;;;AAEgB,SAAA,uBAAuB,SAAiB,MAAwB;AAC9E,SAAOA,kBAAY,IAAI,MAAM,OAAO,GAAG;AAAA,IACrC,SAAS;AAAA,IACT,QAAQ;AAAA,EAAA,CACT;AACH;ACHsB,eAAA,mBACpB,IACA,WACkC;AAC9B,MAAA;AACI,UAAA,OAAO,MAAM,GAAG;AAEf,WAAA;AAAA,MACL,SAAS;AAAA,MACT,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,WACO,KAAK;AACZ,YAAQ,MAAM,0BAA0B;AACxC,YAAQ,MAAM,GAAG;AAEX,UAAA,OAAOC,qBAAe,GAA6D;AAElF,WAAA;AAAA,MACL,SAAS,KAAK,WAAW;AAAA,MACzB,QAAQ,KAAK,UAAU,KAAK,WAAW;AAAA;AAAA,MAEvC,MAAM;AAAA,MACN;AAAA,IACF;AAAA,EAAA;AAEJ;ACuCO,SAAS,8BAA8B,SAA0C;AACtF,QAAM,eAAeC,OAAAA,eAAe,WAAW,IAAI;AAAA,IACjD,qBAAqB;AAAA,IACrB,oBAAoB;AAAA,EAAA,CACrB;AAGD,QAAM,0BAAmD,CAAC,MAAM,MAAM,SAAS;AAE7E,UAAM,gBAAiBC,KAAA,WAAW,IAAI,IAAI,OAAO;AAEjD,UAAM,gBAAgBD,OAAAA,eAAe,iBAAiB,IAAI;AAAA,MACxD,cAAc;AAAA,IAAA,CACf;AAED,WAAO,eAAgB,OAAO;AAErB,aAAA,MAAM,mBAAmB,YAAY;AAE1C,cAAM,OAAO,MAAM,gBAAgB,MAAM,SAAS,gBAAgB;AAClE,cAAM,SAAmC;AAAA,UACvC,SAAS;AAAA,UACT;AAAA,QACF;AACA,cAAM,UAAU,OAAO,OAAO,MAAM,MAAM;AAE1C,YAAI,cAAc,gBAAgB,CAAC,KAAK,IAAI;AAC1C,gBAAM,uBAAuB,aAAa,oBAAoB,aAAa,mBAAmB;AAAA,QAAA;AAI5F,YAAAC,KAAAA,WAAW,IAAI,GAAG;AACb,iBAAA,MAAM,KAAK,OAAO;AAAA,QAAA;AAKrB,cAAA,SAAS,KAAK,UAAU,KAAK;AAE/B,YAAA,CAAC,OAAO,SAAS;AACX,kBAAA,IAAI,OAAO,MAAM,MAAM;AAE/B,gBAAM,SAAS,OAAO,OAAO,SAAS,CAAC;AAGvC,cAAI,QAAQ,SAAS,SAAU,OAAM,OAAO;AACtC,gBAAA,IAAI,MAAM,SAAS;AAAA,QAAA;AAG3B,eAAO,MAAM,KAAK,SAAS,OAAO,IAAI;AAAA,MAAA,GACrC,KAAK,sBAAsB;AAAA,IAChC;AAAA,EACF;AAEO,SAAA;AACT;AAEA,eAAe,gBACb,YACA,kBACuC;AACvC,QAAM,aAA2C;AAAA,IAC/C,IAAI;AAAA,IACJ,MAAM,CAAC;AAAA,IACP,YAAY,CAAC;AAAA,IACb,SAAS;AAAA,EACX;AAEI,MAAA,CAAC,iBAAyB,QAAA;AAExB,QAAA,QAAQ,iBAAiB,eAAe;AAAA,IAC5C,YAAY,WAAW,cAAc;AAAA,EAAA,CACtC;AAGD,QAAM,CAAC,MAAM,IAAI,IAAI,MAAMC,KAAA,WAAW,MAAM,WAAW,WAAW,cAAmB,KAAA,EAAE,CAAC;AACpF,MAAA,CAAC,KAAa,QAAA;AAGZ,QAAA,CAAC,MAAM,QAAQ,IAAIA,gBAAW,MAAMC,SAAAA,uBAAuB,IAAI,CAAC;AAClE,MAAA,CAAC,SAAiB,QAAA;AAEX,aAAA,KAAK,SAAS,OAAO;AACrB,aAAA,OAAO,SAAS,QAAQ,CAAC;AACzB,aAAA,aAAa,SAAS,cAAc,CAAC;AACrC,aAAA,UAAU,WAAW,KAAK,SAAS,OAAO,KAAK,WAAW,WAAW,WAAW;AAEpF,SAAA;AACT;;;;"}
+{"version":3,"file":"cloud.cjs","sources":["../src/cloud/error.ts","../src/cloud/respond.ts","../src/cloud/expose.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\n\nexport function createCloudObjectError(message: string, code?: number | string) {\n  return errorAssign(new Error(message), {\n    errCode: code,\n    errMsg: message,\n  });\n}\n","import { errorNormalize } from '@cloudcome/utils-core/error';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type { UniCloudObjectOutput } from './object';\n\n/**\n * 处理云函数响应结果，统一返回格式\n * @param fn - 执行函数，可以返回任意类型的值或Promise\n * @param append - 需要附加到响应结果中的额外字段\n * @returns 统一格式的云函数响应结果\n *\n * @example\n * ```typescript\n * // 成功情况\n * const result = await respondCloudObject(async () => {\n *   return { name: 'test', value: 123 };\n * });\n * // 返回: { errCode: 0, errMsg: '', data: { name: 'test', value: 123 } }\n *\n * // 失败情况\n * const result = await respondCloudObject(() => {\n *   throw new Error('操作失败');\n * });\n * // 返回: { errCode: -1, errMsg: '操作失败', data: null }\n * ```\n */\nexport async function respondCloudObject<O>(\n  fn: () => MaybePromise<O>,\n  append?: AnyObject,\n): Promise<UniCloudObjectOutput<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 { parseCloudObjectOutput } from '@/_helpers';\nimport { objectDefaults } 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 type { UniCloudObject, UniCloudObjectThis } from './object';\nimport { respondCloudObject } from './respond';\nimport type { UniIdCloudObject } from './uni-id';\n\nexport type UniCloudObjectThisAppendUser = {\n  id: string;\n  role: string[];\n  permission: string[];\n  isAdmin: boolean;\n};\n\nexport type UniCloudObjectThisAppend = {\n  options: Required<CreateCloudObjectOptions>;\n  user: UniCloudObjectThisAppendUser;\n};\n\nexport type UniCloudObjectContext = UniCloudObjectThis & UniCloudObjectThisAppend;\n\n/**\n * 构建云函数暴露创建器的选项配置\n * 用于配置云函数暴露创建器的行为，目前支持传入UniIdCloudObject实例\n */\nexport type BuildCloudExposeCreatorOptions = {\n  /**\n   * 可选的UniIdCloudObject实例\n   * 用于处理用户身份验证和权限管理相关功能\n   */\n  uniIdCloudObject?: UniIdCloudObject;\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   * 用于在云对象响应中添加额外的上下文信息\n   * @param objectThis 云对象上下文\n   * @returns 返回要附加到响应中的数据对象\n   */\n  respondAppend?: (objectThis: UniCloudObjectThis) => AnyObject;\n};\n\nexport type CreateCloudObjectOptions = {\n  /**\n   * 是否需要用户登录态\n   * @default false\n   */\n  requiredUser?: boolean;\n};\n\nexport type CreateCloudObjectExpose = {\n  <S extends ZodObject, O>(\n    schema: S,\n    fn: (context: UniCloudObjectContext, input: z.infer<S>) => MaybePromise<O>,\n    options?: CreateCloudObjectOptions,\n  ): UniCloudObject<z.infer<S>, O>;\n  <O>(\n    fn: (context: UniCloudObjectContext) => MaybePromise<O>,\n    options?: CreateCloudObjectOptions,\n  ): UniCloudObject<void, O>;\n};\n\n/**\n * 构建云对象暴露创建器\n *\n * 该函数用于创建一个云对象暴露函数，可以处理用户身份验证、输入验证和错误处理等通用逻辑\n *\n * @param options 构建选项配置\n * @param options.uniIdCloudObject 可选的UniIdCloudObject实例，用于处理用户身份验证和权限管理\n * @param options.requiredUserErrCode 需要用户登录态时的错误码，默认为 'uni-id-check-token-failed'\n * @param options.requiredUserErrMsg 需要用户登录态时的错误消息，默认为 '需要登录后才能进行此操作'\n *\n * @returns 返回一个云对象暴露创建函数，支持两种重载形式：\n * 1. 无输入参数的形式：(fn, options) => UniCloudObject\n * 2. 有输入验证的形式：(schema, fn, options) => UniCloudObject\n *\n * @example\n * // 无输入参数的使用方式\n * const expose = buildCloudObjectExposeCreator();\n * export default expose(async (context) => {\n *   // 业务逻辑\n * });\n *\n * @example\n * // 有输入验证的使用方式\n * const expose = buildCloudObjectExposeCreator();\n * const schema = z.object({\n *   name: z.string().min(1)\n * });\n *\n * export default expose(schema, async (context, input) => {\n *   // 业务逻辑，input类型已自动推断\n * });\n */\nexport function buildCloudObjectExposeCreator(options?: BuildCloudExposeCreatorOptions) {\n  const buildOptions = objectDefaults(options || {}, {\n    requiredUserErrCode: 'uni-id-check-token-failed',\n    requiredUserErrMsg: '需要登录后才能进行此操作',\n    respondAppend: () => ({}),\n  }) as Required<BuildCloudExposeCreatorOptions>;\n\n  // @ts-ignore\n  const createCloudObjectExpose: CreateCloudObjectExpose = (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    }) as Required<CreateCloudObjectOptions>;\n\n    return async function (input) {\n      // 处理云函数响应逻辑，包括错误捕获和统一响应格式\n      return await respondCloudObject(async () => {\n        // 构建附加的上下文信息，包括用户身份和权限信息\n        const user = await parseAppendUser(this, options?.uniIdCloudObject);\n        const append: UniCloudObjectThisAppend = {\n          options: createOptions,\n          user: user,\n        };\n        const context = Object.assign(this, append) as UniCloudObjectContext;\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 createCloudObjectExpose;\n}\n\nasync function parseAppendUser(\n  objectThis: UniCloudObjectThis,\n  uniIdCloudObject?: UniIdCloudObject,\n): Promise<UniCloudObjectThisAppendUser> {\n  const appendUser: UniCloudObjectThisAppendUser = {\n    id: '',\n    role: [],\n    permission: [],\n    isAdmin: false,\n  };\n\n  if (!uniIdCloudObject) return appendUser;\n\n  const uniId = uniIdCloudObject.createInstance({\n    clientInfo: objectThis.getClientInfo(),\n  });\n\n  // 忽略错误1\n  const [err1, user] = await tryFlatten(uniId.checkToken(objectThis.getUniIdToken() || ''));\n  if (!user) return appendUser;\n\n  // 忽略错误2\n  const [err2, userData] = tryFlatten(() => parseCloudObjectOutput(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":["errorAssign","errorNormalize","objectDefaults","isFunction","tryFlatten","parseCloudObjectOutput"],"mappings":"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"}

package/dist/cloud.mjs

@@ -9,14 +9,14 @@ function createCloudObjectError(message, code) {
     errMsg: message
   });
 }
-async function respondCloudObject(fn, requestId) {
+async function respondCloudObject(fn, append) {
   try {
     const data = await fn();
     return {
       errCode: 0,
       errMsg: "",
       data,
-      requestId
+      ...append
     };
   } catch (err) {
     console.error("respondCloudObject error");
@@ -27,14 +27,15 @@ async function respondCloudObject(fn, requestId) {
       errMsg: err2.errMsg || err2.message || "",
       // @ts-ignore
       data: null,
-      requestId
+      ...append
     };
   }
 }
 function buildCloudObjectExposeCreator(options) {
   const buildOptions = objectDefaults(options || {}, {
     requiredUserErrCode: "uni-id-check-token-failed",
-    requiredUserErrMsg: "需要登录后才能进行此操作"
+    requiredUserErrMsg: "需要登录后才能进行此操作",
+    respondAppend: () => ({})
   });
   const createCloudObjectExpose = (arg0, arg1, arg2) => {
     const optionsSource = isFunction(arg0) ? arg1 : arg2;
@@ -63,7 +64,7 @@ function buildCloudObjectExposeCreator(options) {
           throw new Error("请求数据不正确");
         }
         return await arg1(context, parsed.data);
-      }, this.getUniCloudRequestId());
+      }, buildOptions.respondAppend(this));
     };
   };
   return createCloudObjectExpose;

package/dist/cloud.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cloud.mjs","sources":["../src/cloud/error.ts","../src/cloud/respond.ts","../src/cloud/expose.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\n\nexport function createCloudObjectError(message: string, code?: number | string) {\n  return errorAssign(new Error(message), {\n    errCode: code,\n    errMsg: message,\n  });\n}\n","import { errorNormalize } from '@cloudcome/utils-core/error';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type { UniCloudObjectOutput } from './object';\n\nexport async function respondCloudObject<O>(\n  fn: () => MaybePromise<O>,\n  requestId?: string,\n): Promise<UniCloudObjectOutput<O>> {\n  try {\n    const data = await fn();\n\n    return {\n      errCode: 0,\n      errMsg: '',\n      data,\n      requestId,\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      requestId,\n    };\n  }\n}\n","import { parseCloudObjectOutput } from '@/_helpers';\nimport { objectDefaults } 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 type { UniCloudObject, UniCloudObjectThis } from './object';\nimport { respondCloudObject } from './respond';\nimport type { UniIdCloudObject } from './uni-id';\n\nexport type UniCloudObjectThisAppendUser = {\n  id: string;\n  role: string[];\n  permission: string[];\n  isAdmin: boolean;\n};\n\nexport type UniCloudObjectThisAppend = {\n  options: Required<CreateCloudObjectOptions>;\n  user: UniCloudObjectThisAppendUser;\n};\n\nexport type UniCloudObjectContext = UniCloudObjectThis & UniCloudObjectThisAppend;\n\n/**\n * 构建云函数暴露创建器的选项配置\n * 用于配置云函数暴露创建器的行为，目前支持传入UniIdCloudObject实例\n */\nexport type BuildCloudExposeCreatorOptions = {\n  /**\n   * 可选的UniIdCloudObject实例\n   * 用于处理用户身份验证和权限管理相关功能\n   */\n  uniIdCloudObject?: UniIdCloudObject;\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\nexport type CreateCloudObjectOptions = {\n  /**\n   * 是否需要用户登录态\n   * @default false\n   */\n  requiredUser?: boolean;\n};\n\nexport type CreateCloudObjectExpose = {\n  <S extends ZodObject, O>(\n    schema: S,\n    fn: (context: UniCloudObjectContext, input: z.infer<S>) => MaybePromise<O>,\n    options?: CreateCloudObjectOptions,\n  ): UniCloudObject<z.infer<S>, O>;\n  <O>(\n    fn: (context: UniCloudObjectContext) => MaybePromise<O>,\n    options?: CreateCloudObjectOptions,\n  ): UniCloudObject<void, O>;\n};\n\nexport function buildCloudObjectExposeCreator(options?: BuildCloudExposeCreatorOptions) {\n  const buildOptions = objectDefaults(options || {}, {\n    requiredUserErrCode: 'uni-id-check-token-failed',\n    requiredUserErrMsg: '需要登录后才能进行此操作',\n  }) as Required<BuildCloudExposeCreatorOptions>;\n\n  // @ts-ignore\n  const createCloudObjectExpose: CreateCloudObjectExpose = (arg0, arg1, arg2) => {\n    // 选项来源\n    const optionsSource = (isFunction(arg0) ? arg1 : arg2) as CreateCloudObjectOptions | undefined;\n    // 设置默认选项值\n    const createOptions = objectDefaults(optionsSource || {}, {\n      requiredUser: false,\n    }) as Required<CreateCloudObjectOptions>;\n\n    return async function (input) {\n      // 处理云函数响应逻辑\n      return await respondCloudObject(async () => {\n        // 构建附加的上下文信息\n        const user = await parseAppendUser(this, options?.uniIdCloudObject);\n        const append: UniCloudObjectThisAppend = {\n          options: createOptions,\n          user: user,\n        };\n        const context = Object.assign(this, append) as UniCloudObjectContext;\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        // 验证输入数据\n        const parsed = arg0.safeParse(input);\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        return await arg1(context, parsed.data);\n      }, this.getUniCloudRequestId());\n    };\n  };\n\n  return createCloudObjectExpose;\n}\n\nasync function parseAppendUser(\n  objectThis: UniCloudObjectThis,\n  uniIdCloudObject?: UniIdCloudObject,\n): Promise<UniCloudObjectThisAppendUser> {\n  const appendUser: UniCloudObjectThisAppendUser = {\n    id: '',\n    role: [],\n    permission: [],\n    isAdmin: false,\n  };\n\n  if (!uniIdCloudObject) return appendUser;\n\n  const uniId = uniIdCloudObject.createInstance({\n    clientInfo: objectThis.getClientInfo(),\n  });\n\n  // 忽略错误1\n  const [err1, user] = await tryFlatten(uniId.checkToken(objectThis.getUniIdToken() || ''));\n  if (!user) return appendUser;\n\n  // 忽略错误2\n  const [err2, userData] = tryFlatten(() => parseCloudObjectOutput(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":";;;;;AAEgB,SAAA,uBAAuB,SAAiB,MAAwB;AAC9E,SAAO,YAAY,IAAI,MAAM,OAAO,GAAG;AAAA,IACrC,SAAS;AAAA,IACT,QAAQ;AAAA,EAAA,CACT;AACH;ACHsB,eAAA,mBACpB,IACA,WACkC;AAC9B,MAAA;AACI,UAAA,OAAO,MAAM,GAAG;AAEf,WAAA;AAAA,MACL,SAAS;AAAA,MACT,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,WACO,KAAK;AACZ,YAAQ,MAAM,0BAA0B;AACxC,YAAQ,MAAM,GAAG;AAEX,UAAA,OAAO,eAAe,GAA6D;AAElF,WAAA;AAAA,MACL,SAAS,KAAK,WAAW;AAAA,MACzB,QAAQ,KAAK,UAAU,KAAK,WAAW;AAAA;AAAA,MAEvC,MAAM;AAAA,MACN;AAAA,IACF;AAAA,EAAA;AAEJ;ACuCO,SAAS,8BAA8B,SAA0C;AACtF,QAAM,eAAe,eAAe,WAAW,IAAI;AAAA,IACjD,qBAAqB;AAAA,IACrB,oBAAoB;AAAA,EAAA,CACrB;AAGD,QAAM,0BAAmD,CAAC,MAAM,MAAM,SAAS;AAE7E,UAAM,gBAAiB,WAAW,IAAI,IAAI,OAAO;AAEjD,UAAM,gBAAgB,eAAe,iBAAiB,IAAI;AAAA,MACxD,cAAc;AAAA,IAAA,CACf;AAED,WAAO,eAAgB,OAAO;AAErB,aAAA,MAAM,mBAAmB,YAAY;AAE1C,cAAM,OAAO,MAAM,gBAAgB,MAAM,SAAS,gBAAgB;AAClE,cAAM,SAAmC;AAAA,UACvC,SAAS;AAAA,UACT;AAAA,QACF;AACA,cAAM,UAAU,OAAO,OAAO,MAAM,MAAM;AAE1C,YAAI,cAAc,gBAAgB,CAAC,KAAK,IAAI;AAC1C,gBAAM,uBAAuB,aAAa,oBAAoB,aAAa,mBAAmB;AAAA,QAAA;AAI5F,YAAA,WAAW,IAAI,GAAG;AACb,iBAAA,MAAM,KAAK,OAAO;AAAA,QAAA;AAKrB,cAAA,SAAS,KAAK,UAAU,KAAK;AAE/B,YAAA,CAAC,OAAO,SAAS;AACX,kBAAA,IAAI,OAAO,MAAM,MAAM;AAE/B,gBAAM,SAAS,OAAO,OAAO,SAAS,CAAC;AAGvC,cAAI,QAAQ,SAAS,SAAU,OAAM,OAAO;AACtC,gBAAA,IAAI,MAAM,SAAS;AAAA,QAAA;AAG3B,eAAO,MAAM,KAAK,SAAS,OAAO,IAAI;AAAA,MAAA,GACrC,KAAK,sBAAsB;AAAA,IAChC;AAAA,EACF;AAEO,SAAA;AACT;AAEA,eAAe,gBACb,YACA,kBACuC;AACvC,QAAM,aAA2C;AAAA,IAC/C,IAAI;AAAA,IACJ,MAAM,CAAC;AAAA,IACP,YAAY,CAAC;AAAA,IACb,SAAS;AAAA,EACX;AAEI,MAAA,CAAC,iBAAyB,QAAA;AAExB,QAAA,QAAQ,iBAAiB,eAAe;AAAA,IAC5C,YAAY,WAAW,cAAc;AAAA,EAAA,CACtC;AAGD,QAAM,CAAC,MAAM,IAAI,IAAI,MAAM,WAAW,MAAM,WAAW,WAAW,cAAmB,KAAA,EAAE,CAAC;AACpF,MAAA,CAAC,KAAa,QAAA;AAGZ,QAAA,CAAC,MAAM,QAAQ,IAAI,WAAW,MAAM,uBAAuB,IAAI,CAAC;AAClE,MAAA,CAAC,SAAiB,QAAA;AAEX,aAAA,KAAK,SAAS,OAAO;AACrB,aAAA,OAAO,SAAS,QAAQ,CAAC;AACzB,aAAA,aAAa,SAAS,cAAc,CAAC;AACrC,aAAA,UAAU,WAAW,KAAK,SAAS,OAAO,KAAK,WAAW,WAAW,WAAW;AAEpF,SAAA;AACT;"}
+{"version":3,"file":"cloud.mjs","sources":["../src/cloud/error.ts","../src/cloud/respond.ts","../src/cloud/expose.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\n\nexport function createCloudObjectError(message: string, code?: number | string) {\n  return errorAssign(new Error(message), {\n    errCode: code,\n    errMsg: message,\n  });\n}\n","import { errorNormalize } from '@cloudcome/utils-core/error';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\nimport type { UniCloudObjectOutput } from './object';\n\n/**\n * 处理云函数响应结果，统一返回格式\n * @param fn - 执行函数，可以返回任意类型的值或Promise\n * @param append - 需要附加到响应结果中的额外字段\n * @returns 统一格式的云函数响应结果\n *\n * @example\n * ```typescript\n * // 成功情况\n * const result = await respondCloudObject(async () => {\n *   return { name: 'test', value: 123 };\n * });\n * // 返回: { errCode: 0, errMsg: '', data: { name: 'test', value: 123 } }\n *\n * // 失败情况\n * const result = await respondCloudObject(() => {\n *   throw new Error('操作失败');\n * });\n * // 返回: { errCode: -1, errMsg: '操作失败', data: null }\n * ```\n */\nexport async function respondCloudObject<O>(\n  fn: () => MaybePromise<O>,\n  append?: AnyObject,\n): Promise<UniCloudObjectOutput<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 { parseCloudObjectOutput } from '@/_helpers';\nimport { objectDefaults } 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 type { UniCloudObject, UniCloudObjectThis } from './object';\nimport { respondCloudObject } from './respond';\nimport type { UniIdCloudObject } from './uni-id';\n\nexport type UniCloudObjectThisAppendUser = {\n  id: string;\n  role: string[];\n  permission: string[];\n  isAdmin: boolean;\n};\n\nexport type UniCloudObjectThisAppend = {\n  options: Required<CreateCloudObjectOptions>;\n  user: UniCloudObjectThisAppendUser;\n};\n\nexport type UniCloudObjectContext = UniCloudObjectThis & UniCloudObjectThisAppend;\n\n/**\n * 构建云函数暴露创建器的选项配置\n * 用于配置云函数暴露创建器的行为，目前支持传入UniIdCloudObject实例\n */\nexport type BuildCloudExposeCreatorOptions = {\n  /**\n   * 可选的UniIdCloudObject实例\n   * 用于处理用户身份验证和权限管理相关功能\n   */\n  uniIdCloudObject?: UniIdCloudObject;\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   * 用于在云对象响应中添加额外的上下文信息\n   * @param objectThis 云对象上下文\n   * @returns 返回要附加到响应中的数据对象\n   */\n  respondAppend?: (objectThis: UniCloudObjectThis) => AnyObject;\n};\n\nexport type CreateCloudObjectOptions = {\n  /**\n   * 是否需要用户登录态\n   * @default false\n   */\n  requiredUser?: boolean;\n};\n\nexport type CreateCloudObjectExpose = {\n  <S extends ZodObject, O>(\n    schema: S,\n    fn: (context: UniCloudObjectContext, input: z.infer<S>) => MaybePromise<O>,\n    options?: CreateCloudObjectOptions,\n  ): UniCloudObject<z.infer<S>, O>;\n  <O>(\n    fn: (context: UniCloudObjectContext) => MaybePromise<O>,\n    options?: CreateCloudObjectOptions,\n  ): UniCloudObject<void, O>;\n};\n\n/**\n * 构建云对象暴露创建器\n *\n * 该函数用于创建一个云对象暴露函数，可以处理用户身份验证、输入验证和错误处理等通用逻辑\n *\n * @param options 构建选项配置\n * @param options.uniIdCloudObject 可选的UniIdCloudObject实例，用于处理用户身份验证和权限管理\n * @param options.requiredUserErrCode 需要用户登录态时的错误码，默认为 'uni-id-check-token-failed'\n * @param options.requiredUserErrMsg 需要用户登录态时的错误消息，默认为 '需要登录后才能进行此操作'\n *\n * @returns 返回一个云对象暴露创建函数，支持两种重载形式：\n * 1. 无输入参数的形式：(fn, options) => UniCloudObject\n * 2. 有输入验证的形式：(schema, fn, options) => UniCloudObject\n *\n * @example\n * // 无输入参数的使用方式\n * const expose = buildCloudObjectExposeCreator();\n * export default expose(async (context) => {\n *   // 业务逻辑\n * });\n *\n * @example\n * // 有输入验证的使用方式\n * const expose = buildCloudObjectExposeCreator();\n * const schema = z.object({\n *   name: z.string().min(1)\n * });\n *\n * export default expose(schema, async (context, input) => {\n *   // 业务逻辑，input类型已自动推断\n * });\n */\nexport function buildCloudObjectExposeCreator(options?: BuildCloudExposeCreatorOptions) {\n  const buildOptions = objectDefaults(options || {}, {\n    requiredUserErrCode: 'uni-id-check-token-failed',\n    requiredUserErrMsg: '需要登录后才能进行此操作',\n    respondAppend: () => ({}),\n  }) as Required<BuildCloudExposeCreatorOptions>;\n\n  // @ts-ignore\n  const createCloudObjectExpose: CreateCloudObjectExpose = (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    }) as Required<CreateCloudObjectOptions>;\n\n    return async function (input) {\n      // 处理云函数响应逻辑，包括错误捕获和统一响应格式\n      return await respondCloudObject(async () => {\n        // 构建附加的上下文信息，包括用户身份和权限信息\n        const user = await parseAppendUser(this, options?.uniIdCloudObject);\n        const append: UniCloudObjectThisAppend = {\n          options: createOptions,\n          user: user,\n        };\n        const context = Object.assign(this, append) as UniCloudObjectContext;\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 createCloudObjectExpose;\n}\n\nasync function parseAppendUser(\n  objectThis: UniCloudObjectThis,\n  uniIdCloudObject?: UniIdCloudObject,\n): Promise<UniCloudObjectThisAppendUser> {\n  const appendUser: UniCloudObjectThisAppendUser = {\n    id: '',\n    role: [],\n    permission: [],\n    isAdmin: false,\n  };\n\n  if (!uniIdCloudObject) return appendUser;\n\n  const uniId = uniIdCloudObject.createInstance({\n    clientInfo: objectThis.getClientInfo(),\n  });\n\n  // 忽略错误1\n  const [err1, user] = await tryFlatten(uniId.checkToken(objectThis.getUniIdToken() || ''));\n  if (!user) return appendUser;\n\n  // 忽略错误2\n  const [err2, userData] = tryFlatten(() => parseCloudObjectOutput(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":";;;;;AAEgB,SAAA,uBAAuB,SAAiB,MAAwB;AAC9E,SAAO,YAAY,IAAI,MAAM,OAAO,GAAG;AAAA,IACrC,SAAS;AAAA,IACT,QAAQ;AAAA,EAAA,CACT;AACH;ACkBsB,eAAA,mBACpB,IACA,QACkC;AAC9B,MAAA;AACI,UAAA,OAAO,MAAM,GAAG;AAEf,WAAA;AAAA,MACL,SAAS;AAAA,MACT,QAAQ;AAAA,MACR;AAAA,MACA,GAAG;AAAA,IACL;AAAA,WACO,KAAK;AACZ,YAAQ,MAAM,0BAA0B;AACxC,YAAQ,MAAM,GAAG;AAEX,UAAA,OAAO,eAAe,GAA6D;AAElF,WAAA;AAAA,MACL,SAAS,KAAK,WAAW;AAAA,MACzB,QAAQ,KAAK,UAAU,KAAK,WAAW;AAAA;AAAA,MAEvC,MAAM;AAAA,MACN,GAAG;AAAA,IACL;AAAA,EAAA;AAEJ;AC0DO,SAAS,8BAA8B,SAA0C;AACtF,QAAM,eAAe,eAAe,WAAW,IAAI;AAAA,IACjD,qBAAqB;AAAA,IACrB,oBAAoB;AAAA,IACpB,eAAe,OAAO,CAAC;AAAA,EAAA,CACxB;AAGD,QAAM,0BAAmD,CAAC,MAAM,MAAM,SAAS;AAE7E,UAAM,gBAAiB,WAAW,IAAI,IAAI,OAAO;AAGjD,UAAM,gBAAgB,eAAe,iBAAiB,IAAI;AAAA,MACxD,cAAc;AAAA,IAAA,CACf;AAED,WAAO,eAAgB,OAAO;AAErB,aAAA,MAAM,mBAAmB,YAAY;AAE1C,cAAM,OAAO,MAAM,gBAAgB,MAAM,SAAS,gBAAgB;AAClE,cAAM,SAAmC;AAAA,UACvC,SAAS;AAAA,UACT;AAAA,QACF;AACA,cAAM,UAAU,OAAO,OAAO,MAAM,MAAM;AAG1C,YAAI,cAAc,gBAAgB,CAAC,KAAK,IAAI;AAC1C,gBAAM,uBAAuB,aAAa,oBAAoB,aAAa,mBAAmB;AAAA,QAAA;AAI5F,YAAA,WAAW,IAAI,GAAG;AACb,iBAAA,MAAM,KAAK,OAAO;AAAA,QAAA;AAIrB,cAAA,SAAS,KAAK,UAAU,KAAK;AAG/B,YAAA,CAAC,OAAO,SAAS;AACX,kBAAA,IAAI,OAAO,MAAM,MAAM;AAE/B,gBAAM,SAAS,OAAO,OAAO,SAAS,CAAC;AAGvC,cAAI,QAAQ,SAAS,SAAU,OAAM,OAAO;AACtC,gBAAA,IAAI,MAAM,SAAS;AAAA,QAAA;AAI3B,eAAO,MAAM,KAAK,SAAS,OAAO,IAAI;AAAA,MAAA,GACrC,aAAa,cAAc,IAAI,CAAC;AAAA,IACrC;AAAA,EACF;AAEO,SAAA;AACT;AAEA,eAAe,gBACb,YACA,kBACuC;AACvC,QAAM,aAA2C;AAAA,IAC/C,IAAI;AAAA,IACJ,MAAM,CAAC;AAAA,IACP,YAAY,CAAC;AAAA,IACb,SAAS;AAAA,EACX;AAEI,MAAA,CAAC,iBAAyB,QAAA;AAExB,QAAA,QAAQ,iBAAiB,eAAe;AAAA,IAC5C,YAAY,WAAW,cAAc;AAAA,EAAA,CACtC;AAGD,QAAM,CAAC,MAAM,IAAI,IAAI,MAAM,WAAW,MAAM,WAAW,WAAW,cAAmB,KAAA,EAAE,CAAC;AACpF,MAAA,CAAC,KAAa,QAAA;AAGZ,QAAA,CAAC,MAAM,QAAQ,IAAI,WAAW,MAAM,uBAAuB,IAAI,CAAC;AAClE,MAAA,CAAC,SAAiB,QAAA;AAEX,aAAA,KAAK,SAAS,OAAO;AACrB,aAAA,OAAO,SAAS,QAAQ,CAAC;AACzB,aAAA,aAAa,SAAS,cAAc,CAAC;AACrC,aAAA,UAAU,WAAW,KAAK,SAAS,OAAO,KAAK,WAAW,WAAW,WAAW;AAEpF,SAAA;AACT;"}

package/dist/database/db.d.ts

@@ -1,5 +1,5 @@
 import { AnyObject, HasProperty, IsEmptyObject, IsOnlyProperty, MergeIntersection } from '@cloudcome/utils-core/types';
-import { UniClientDatabaseOutput, UniCloudDatabaseOutput } from './types';
+import { UniClientDatabaseOutput, UniCloudDatabaseOutput, UniDatabaseCommand } from './types';
 export type DbWhere<T> = {
     [K in keyof T]?: unknown;
 };
@@ -24,9 +24,7 @@ export type DbOrder<T> = Record<keyof T, 'asc' | 'desc'>;
 /**
  * 数据库操作符命令
  */
-export declare const dbCmd: UniCloud.QueryCommand & {
-    expr: (expr: unknown) => unknown;
-};
+export declare const dbCmd: UniDatabaseCommand;
 /**
  * 数据库聚合操作符命令
  */

package/dist/database/fns.d.ts

@@ -11,7 +11,7 @@ export type DbUpsertOptions<T, S extends DbSelect<T>, C extends DbCreate<T>, U e
      * 更新数据，可以是对象或根据查询结果生成更新对象的函数
      * @param row 查询到的文档数据，仅在传入函数时可用
      */
-    update: U | ((existed: DbQuery<T, S, {}>) => U);
+    update: U | ((exist: DbQuery<T, S, {}>) => U);
     /** 创建前回调函数 */
     onBeforeCreate?: () => unknown;
     /**
@@ -21,16 +21,16 @@ export type DbUpsertOptions<T, S extends DbSelect<T>, C extends DbCreate<T>, U e
     onAfterCreate?: (id: string) => unknown;
     /**
      * 更新前回调函数
-     * @param existed 查询到的原始文档数据
+     * @param exist 查询到的原始文档数据
      * @returns 如果返回 false，则取消更新操作
      */
-    onBeforeUpdate?: (existed: DbQuery<T, S, {}>) => false | unknown;
+    onBeforeUpdate?: (exist: DbQuery<T, S, {}>) => false | unknown;
     /**
      * 更新后回调函数
      * @param updateData 实际更新的数据
-     * @param existed 查询到的原始文档数据
+     * @param exist 查询到的原始文档数据
      */
-    onAfterUpdate?: (updateData: U, existed: DbQuery<T, S, {}>) => unknown;
+    onAfterUpdate?: (updateData: U, exist: DbQuery<T, S, {}>) => unknown;
     /** 用于测试的模拟数据库实例 */
     _mockDbInstance?: any;
 };
@@ -45,7 +45,7 @@ export type DbUpsertOutput = {
     /** 是否为更新操作 */
     updated: boolean;
 };
-export declare function dbUpsert<T, S extends DbSelect<T>, C extends DbCreate<T>, U extends DbUpdate<T>>(dbProxy: DbProxy<T, S, C>, options: DbUpsertOptions<T, S, C, U>): Promise<DbUpsertOutput>;
+export declare function dbUpsert<T, S extends DbSelect<T>, C extends DbCreate<T>, U extends DbUpdate<T>>(dbProxy: DbProxy<T>, options: DbUpsertOptions<T, S, C, U>): Promise<DbUpsertOutput>;
 type _WithTransaction = <T, S extends DbSelect<T>, R extends AnyObject>(table: DbProxy<T, S, R>) => Db<T, S, R>;
 /**
  * 在数据库事务中执行操作

package/dist/database/types.d.ts

@@ -7,3 +7,138 @@ export type UniClientDatabaseOutput<T> = {
     };
 };
 export type UniCloudDatabaseOutput<T> = T;
+/**
+ * UniDatabaseCommand 数据库操作命令类型定义
+ */
+export type UniDatabaseCommand = {
+    /**
+     * 聚合表达式操作符
+     * @param expr 表达式参数
+     * @returns 返回聚合表达式结果
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#dbcmd-expr expr 文档}
+     */
+    expr: (expr: unknown) => unknown;
+    /**
+     * 等于操作符
+     * @param value 比较值
+     * @returns 返回查询条件
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#dbcmd-eq eq 文档}
+     */
+    eq: (value: unknown) => unknown;
+    /**
+     * 不等于操作符
+     * @param value 比较值
+     * @returns 返回查询条件
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#dbcmd-neq neq 文档}
+     */
+    neq: (value: unknown) => unknown;
+    /**
+     * 大于操作符
+     * @param value 比较值
+     * @returns 返回查询条件
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#dbcmd-gt gt 文档}
+     */
+    gt: (value: unknown) => unknown;
+    /**
+     * 大于等于操作符
+     * @param value 比较值
+     * @returns 返回查询条件
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#dbcmd-gte gte 文档}
+     */
+    gte: (value: unknown) => unknown;
+    /**
+     * 小于操作符
+     * @param value 比较值
+     * @returns 返回查询条件
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#dbcmd-lt lt 文档}
+     */
+    lt: (value: unknown) => unknown;
+    /**
+     * 小于等于操作符
+     * @param value 比较值
+     * @returns 返回查询条件
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#dbcmd-lte lte 文档}
+     */
+    lte: (value: unknown) => unknown;
+    /**
+     * 包含在数组内操作符
+     * @param value 包含的值数组
+     * @returns 返回查询条件
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#dbcmd-in in 文档}
+     */
+    in: (value: unknown[]) => unknown;
+    /**
+     * 不包含在数组内操作符
+     * @param value 不包含的值数组
+     * @returns 返回查询条件
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#dbcmd-nin nin 文档}
+     */
+    nin: (value: unknown[]) => unknown;
+    /**
+     * 逻辑与操作符
+     * @param args 多个查询条件
+     * @returns 返回逻辑与查询条件
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#dbcmd-and and 文档}
+     */
+    and: (...args: unknown[]) => unknown;
+    /**
+     * 逻辑或操作符
+     * @param args 多个查询条件
+     * @returns 返回逻辑或查询条件
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#dbcmd-or or 文档}
+     */
+    or: (...args: unknown[]) => unknown;
+    /**
+     * 自增操作符
+     * @param value 增加的数值
+     * @returns 返回更新操作
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#operator-inc inc 文档}
+     */
+    inc: (value: number) => unknown;
+    /**
+     * 自乘操作符
+     * @param value 相乘的数值
+     * @returns 返回更新操作
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#operator-mul mul 文档}
+     */
+    mul: (value: number) => unknown;
+    /**
+     * 设置字段值操作符
+     * @param value 设置的值
+     * @returns 返回更新操作
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#operator-set set 文档}
+     */
+    set: (value: unknown) => unknown;
+    /**
+     * 数组末尾添加元素操作符
+     * @param value 添加的值
+     * @returns 返回更新操作
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#operator-push push 文档}
+     */
+    push: (value: unknown) => unknown;
+    /**
+     * 数组开头添加元素操作符
+     * @param value 添加的值
+     * @returns 返回更新操作
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#operator-unshift unshift 文档}
+     */
+    unshift: (value: unknown) => unknown;
+    /**
+     * 删除数组末尾元素操作符
+     * @returns 返回更新操作
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#operator-pop pop 文档}
+     */
+    pop: () => unknown;
+    /**
+     * 删除数组开头元素操作符
+     * @returns 返回更新操作
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#operator-shift shift 文档}
+     */
+    shift: () => unknown;
+    /**
+     * 删除字段操作符
+     * @returns 返回更新操作
+     * @see {@link https://doc.dcloud.net.cn/uniCloud/cf-database.html#operator-remove remove 文档}
+     */
+    remove: () => unknown;
+};

package/dist/database.cjs

@@ -180,9 +180,7 @@ class Db {
     return returnAggRef;
   }
   #endHost() {
-    if (this.#hasWhereId) {
-      this.#host = this.#host.doc(this.#where._id);
-    } else if (this.#hasWhere) {
+    if (this.#hasWhere) {
       this.#host = this.#host.where(this.#where);
     }
     if (this.#hasSelect) {
@@ -195,6 +193,7 @@ class Db {
     }
     if (this.#hasSkip) this.#host = this.#host.skip(this.#skip);
     if (this.#hasLimit) this.#host = this.#host.limit(this.#limit);
+    else if (this.#hasWhereId) this.#host = this.#host.limit(1);
   }
   /**
    * 执行查询操作
@@ -210,6 +209,7 @@ class Db {
       this.#endHost();
       res = await this.#host.get();
     }
+    type.isArray(res.data) ? res.data : [res.data];
     const { data } = parseDatabaseOutput(res);
     return data;
   }
@@ -341,16 +341,16 @@ async function dbUpsert(dbProxy, options) {
   } = options;
   if ("_id" in select) throw new Error("select 条件不能包含 _id 字段");
   const _db = _mockDbInstance || dbProxy;
-  const existed = await _db.where(where).select(select || {}).queryOne(true);
-  if (existed) {
-    const skipUpdate = await onBeforeUpdate?.(existed) === false;
+  const exist = await _db.where(where).select(select || {}).queryOne(true);
+  if (exist) {
+    const skipUpdate = await onBeforeUpdate?.(exist) === false;
     if (skipUpdate) {
-      return { id: existed._id, updated: false, created: false };
+      return { id: exist._id, updated: false, created: false };
     }
-    const updateData = type.isFunction(update) ? update(existed) : update;
-    await _db.whereId(existed._id).update(updateData);
-    onAfterUpdate?.(updateData, existed);
-    return { id: existed._id, updated: true, created: false };
+    const updateData = type.isFunction(update) ? update(exist) : update;
+    await _db.whereId(exist._id).update(updateData);
+    onAfterUpdate?.(updateData, exist);
+    return { id: exist._id, updated: true, created: false };
   }
   await onBeforeCreate?.();
   const createdId = await _db.create(create);

package/dist/database.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"database.cjs","sources":["../src/database/db.ts","../src/database/fns.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\nimport { objectEach, objectMap, objectOmit } from '@cloudcome/utils-core/object';\nimport { isFunction, isNumber, isString } from '@cloudcome/utils-core/type';\nimport type {\n  AnyObject,\n  HasProperty,\n  IsEmptyObject,\n  IsOnlyProperty,\n  MergeIntersection,\n  UnionToIntersection,\n} from '@cloudcome/utils-core/types';\nimport type { UniClientDatabaseOutput, UniCloudDatabaseOutput } from './types';\n\nexport type DbWhere<T> = {\n  [K in keyof T]?: unknown;\n};\nexport type DbSelect<T> = {\n  [K in keyof T]?: K extends '_id' ? false : true;\n};\nexport type DbFieldsDefault<T> = {\n  [K in keyof T]: true;\n};\ntype _DbFields<T, S extends DbSelect<T>> = IsEmptyObject<S> extends true // 判断是否为空对象\n  ? // 默认全部字段\n    DbFieldsDefault<T>\n  : // 判断 _id 是否为唯一属性\n    IsOnlyProperty<S, '_id'> extends true\n    ? // 从默认字段里排除 _id\n      Omit<DbFieldsDefault<T>, '_id'>\n    : // 判断是否有 _id\n      HasProperty<S, '_id'> extends true\n      ? // 有的话保留 {_id, ...}\n        S\n      : // 没有的话补上 {_id, ...}\n        S & { _id: true };\ntype _DbQuery<T, S extends Record<keyof T, boolean>> = {\n  [K in keyof T as S[K] extends true ? K : never]: T[K];\n};\n// @ts-ignore\nexport type DbQuery<T, S extends DbSelect<T>, R> = _DbQuery<T, _DbFields<T, S>> & R;\nexport type DbForeign<T, S extends DbSelect<T>, R, J extends DbJoinType, A> = Record<\n  A & string,\n  J extends '1:1' ? DbQuery<T, S, R> : DbQuery<T, S, R>[]\n>;\nexport type DbCreate<T> = Partial<T>;\nexport type DbUpdate<T> = Partial<T>;\nexport type DbOrder<T> = Record<keyof T, 'asc' | 'desc'>;\n\ntype _WhereFrom = 'where' | 'whereId';\n\nconst db0 = uniCloud.database();\n/**\n * 数据库操作符命令\n */\nexport const dbCmd = db0.command as UniCloud.QueryCommand & {\n  expr: (expr: unknown) => unknown;\n};\n\n/**\n * 数据库聚合操作符命令\n */\nexport const dbAgg = db0.command.aggregate as UniCloud.AggregateCommand & {\n  pipeline: () => UniCloud.AggregateReference & {\n    done: () => unknown;\n  };\n};\n\nexport type DbOptions = {\n  /**\n   * 数据表名称\n   */\n  table: string;\n\n  /**\n   * 事务对象，用于事务操作\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  transaction?: any;\n\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any;\n};\n\n/**\n * 数据库关联类型\n * - '1:1': 一对一关联，返回值 1 个\n * - '1:n': 一对多关联，返回值 n 个\n * - 'n:1': 多对一关联，返回值 n 个\n */\nexport type DbJoinType = '1:1' | '1:n' | 'n:1';\nexport type DbLookupOptions<J extends DbJoinType, L, F, A> = {\n  /**\n   * 关联类型\n   */\n  type: J;\n\n  /**\n   * 主表字段\n   */\n  localField: keyof L & string;\n\n  /**\n   * 关联表字段\n   */\n  foreignField: keyof F & string;\n\n  /**\n   * 关联数据在结果中的字段名\n   */\n  as: A;\n};\n\nexport type DbLookup = {\n  /**\n   * 关联表\n   */\n  table: Db<unknown>;\n\n  /**\n   * 关联类型\n   */\n  type: DbJoinType;\n\n  /**\n   * 主表字段\n   */\n  localField: string;\n\n  /**\n   * 关联表字段\n   */\n  foreignField: string;\n\n  /**\n   * 关联表名称\n   */\n  from: string;\n\n  /**\n   * 关联数据在结果中的字段名\n   */\n  as: string;\n};\n\nlet gid = 0;\n\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport class Db<T, S extends DbSelect<T> = {}, R extends AnyObject = {}> {\n  #host: UniCloud.CollectionReference;\n\n  /**\n   * 是否为事务环境\n   * - 查询条件只能是 id\n   * - 不能聚合操作\n   */\n  #isTransaction = false;\n\n  #options: DbOptions;\n\n  /**\n   * 构造函数，初始化数据库集合引用\n   * @param collection 数据表名称\n   * @param _mockDatabase 模拟数据库，用于单元测试\n   */\n  constructor(options: DbOptions) {\n    this.#options = options;\n    this.#host =\n      options._mockDatabase || options.transaction?.collection(options.table) || db0.collection(options.table);\n    this.#isTransaction = !!options.transaction;\n  }\n\n  get table() {\n    return this.#options.table;\n  }\n\n  /**\n   * 获取聚合操作实例\n   * @returns 聚合操作实例\n   */\n  aggregate() {\n    return this.#host.aggregate();\n  }\n\n  #hasWhere: _WhereFrom | undefined = undefined;\n  #hasWhereId: _WhereFrom | undefined = undefined;\n  #where = {};\n\n  #doWhere(where: DbWhere<T>, from: _WhereFrom) {\n    if (this.#hasWhere) throw new Error(`已调用过一次 db.${_toWhereMethod(this.#hasWhere)} 了`);\n\n    const whereKeys = Object.keys(where);\n    // 只有 _id 值为字符串或数字时，才能调用 doc 方法\n    const isWhereId = whereKeys.length === 1 && '_id' in where && (isString(where._id) || isNumber(where._id));\n\n    if (isWhereId && this.#hasLimit) {\n      throw new Error(`db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`);\n    }\n\n    this.#hasWhere = from;\n    this.#where = where;\n    if (isWhereId) this.#hasWhereId = from;\n\n    return this;\n  }\n\n  /**\n   * 设置查询条件\n   * @param where 查询条件对象\n   * @returns 当前Db实例，支持链式调用\n   */\n  where(where: DbWhere<T>) {\n    return this.#doWhere(where, 'where');\n  }\n\n  /**\n   * 根据ID设置查询条件\n   * @param id 记录ID\n   * @returns 当前Db实例，支持链式调用\n   */\n  whereId(id: string | number) {\n    // @ts-ignore\n    return this.#doWhere({ _id: id }, 'whereId');\n  }\n\n  #hasSelect = 0;\n  #select = {};\n\n  /**\n   * 指定要返回的字段\n   * @param fields 要返回的字段对象，true表示返回，false表示不返回\n   * @returns 当前Db实例，支持链式调用\n   */\n  select<U extends DbSelect<T>>(fields: U) {\n    if (this.#hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n    this.#hasSelect++;\n    this.#select = fields;\n\n    return this as Db<T, S & U, R>;\n  }\n\n  #hasOrder = 0;\n  #order = {};\n\n  /**\n   * 设置排序规则\n   * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n   * @returns 当前Db实例，支持链式调用\n   */\n  order(order: DbOrder<T>) {\n    this.#hasOrder++;\n    this.#order = order;\n\n    return this;\n  }\n\n  #hasSkip = 0;\n  #skip = 0;\n\n  /**\n   * 跳过指定数量的记录\n   * @param skip 要跳过的记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  skip(skip: number) {\n    if (this.#hasSkip) throw new Error('db.skip() 方法只能调用一次');\n\n    this.#hasSkip++;\n    this.#skip = skip;\n\n    return this;\n  }\n\n  #hasLimit = 0;\n  #limit = 0;\n\n  /**\n   * 限制返回的记录数量\n   * @param limit 最大返回记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  limit(limit: number) {\n    if (this.#hasLimit) throw new Error('db.limit() 方法只能调用一次');\n\n    if (this.#hasWhereId) {\n      throw new Error(`db.limit() 方法不能与 ${_toWhereIdMethod(this.#hasWhereId)} 方法同时调用`);\n    }\n\n    this.#hasLimit++;\n    this.#limit = limit;\n\n    return this;\n  }\n\n  #hasLookup = 0;\n  get hasLookup() {\n    return this.#hasLookup > 0;\n  }\n\n  #lookups: DbLookup[] = [];\n  lookup<FT, FS extends DbSelect<FT>, FR extends AnyObject, J extends DbJoinType, A extends string>(\n    table: Db<FT, FS, FR>,\n    lookup: DbLookupOptions<J, T, FT, A>,\n  ) {\n    // 对方表也记为关联查询，避免做表更新操作\n    table.#hasLookup++;\n    this.#hasLookup++;\n    this.#lookups.push({\n      ...lookup,\n      table,\n      from: table.table,\n    });\n\n    // 这里必须合并联合类型，否则类型结果会丢失最后一次 lookup\n    // @ts-ignore\n    return this as Db<T, S, MergeIntersection<R & DbForeign<FT, FS, FR, J, A>>>;\n  }\n\n  #aggregated = false;\n  #endAggregate(aggRef: UniCloud.AggregateReference) {\n    if (this.#aggregated) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n\n    this.#aggregated = true;\n    let returnAggRef = aggRef;\n    const projects: Record<string, true> = {};\n\n    for (const { type, as, foreignField, from, localField, table } of this.#lookups) {\n      const varName = `v${gid++}`;\n      let pipeline = dbAgg.pipeline();\n\n      // 关联条件\n      // @ts-ignore\n      pipeline = pipeline.match(\n        dbCmd.expr(\n          type === 'n:1'\n            ? // @ts-ignore\n              dbAgg.in([`$${foreignField}`, `$$${varName}`])\n            : dbAgg.eq([`$${foreignField}`, `$$${varName}`]),\n        ),\n      );\n\n      // 其他查询条件\n      // @ts-ignore\n      pipeline = table.#endAggregate(pipeline);\n\n      // @ts-ignore\n      pipeline = pipeline.done();\n\n      returnAggRef = returnAggRef.lookup({\n        let: {\n          [varName]: `$${localField}`,\n        },\n        as,\n        from,\n        pipeline,\n      });\n\n      // 1对1，展开数组\n      if (type === '1:1') {\n        // @ts-ignore\n        returnAggRef = returnAggRef.unwind({\n          path: `$${as}`,\n          preserveNullAndEmptyArrays: true,\n        });\n      }\n\n      projects[as] = true;\n    }\n\n    // 主表查询\n    if (this.#hasWhere) returnAggRef = returnAggRef.match(this.#where);\n    if (this.#hasSelect) returnAggRef = returnAggRef.project({ ...this.#select, ...projects });\n    if (this.#hasOrder) returnAggRef = returnAggRef.sort(objectMap(this.#order, (v) => (v === 'asc' ? 1 : -1)));\n    if (this.#hasSkip) returnAggRef = returnAggRef.skip(this.#skip);\n    if (this.#hasLimit) returnAggRef = returnAggRef.limit(this.#limit);\n\n    return returnAggRef;\n  }\n\n  #endHost() {\n    if (this.#hasWhereId) {\n      // @ts-ignore\n      this.#host = this.#host.doc(this.#where._id);\n    } else if (this.#hasWhere) {\n      // @ts-ignore\n      this.#host = this.#host.where(this.#where);\n    }\n\n    if (this.#hasSelect) {\n      // @ts-ignore\n      this.#host = this.#host.field(this.#select);\n    }\n\n    if (this.#hasOrder) {\n      objectEach(this.#order, (val, key) => {\n        // @ts-ignore\n        this.#host = this.#host.orderBy(key, val);\n      });\n    }\n\n    // @ts-ignore\n    if (this.#hasSkip) this.#host = this.#host.skip(this.#skip);\n\n    // @ts-ignore\n    if (this.#hasLimit) this.#host = this.#host.limit(this.#limit);\n  }\n\n  /**\n   * 执行查询操作\n   * @returns 查询结果\n   */\n  async query() {\n    // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n    let res: any;\n\n    // 关联查询\n    if (this.#hasLookup) {\n      const aggRef = this.aggregate();\n      this.#endAggregate(aggRef);\n      res = await aggRef.end();\n    }\n    // 单表查询\n    else {\n      this.#endHost();\n      res = await this.#host.get();\n    }\n\n    const { data } = parseDatabaseOutput<{ data: DbQuery<T, S, R>[] }>(res);\n    return data;\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * @param ignoreMiss 是否忽略没有匹配到记录\n   * @returns 查询结果\n   */\n  async queryOne(): Promise<DbQuery<T, S, R>>;\n  async queryOne(ignoreMiss: false): Promise<DbQuery<T, S, R>>;\n  async queryOne(ignoreMiss: true): Promise<DbQuery<T, S, R> | undefined>;\n  async queryOne(ignoreMiss = false): Promise<DbQuery<T, S, R> | undefined> {\n    if (this.#hasLimit) throw new Error('db.queryOne() 方法不支持 limit 条件');\n    if (!this.#hasWhereId) this.limit(1);\n\n    const data = await this.query();\n    const res = data.at(0);\n\n    if (!ignoreMiss && !res) throw new Error('未找到匹配记录');\n    return res;\n  }\n\n  /**\n   * 获取匹配记录的数量\n   * @returns 记录总数\n   */\n  async count() {\n    if (this.#hasLookup) throw new Error('db.count() 方法不支持 lookup 聚合');\n    if (this.#hasSelect) throw new Error('db.count() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.count() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.count() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.count() 方法不支持 limit 条件');\n\n    this.#endHost();\n    const res = await this.#host.count();\n    const { total } = parseDatabaseOutput<{ total: number }>(res);\n    return total;\n  }\n\n  /**\n   * 创建新记录\n   * @param data 要创建的数据\n   * @returns 创建结果\n   */\n  async create(data: DbCreate<T>) {\n    if (this.#hasLookup) throw new Error('db.create() 方法不支持 lookup 聚合');\n    if (this.#hasWhere) throw new Error('db.create() 方法不支持 where 条件');\n    if (this.#hasSelect) throw new Error('db.create() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.create() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.create() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.create() 方法不支持 limit 条件');\n\n    this.#endHost();\n    const res = await this.#host.add(data);\n    const { id } = parseDatabaseOutput<{ id: string }>(res);\n    return id;\n  }\n\n  /**\n   * 更新记录\n   * @param data 要更新的数据\n   * @returns 更新结果\n   */\n  async update(data: AnyObject) {\n    if (this.#hasLookup) throw new Error('db.update() 方法不支持 lookup 聚合');\n    if (!this.#hasWhere) throw new Error('设置 where 条件后才能执行 db.update() 方法');\n    if (this.#hasSelect) throw new Error('db.update() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.update() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.update() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.update() 方法不支持 limit 条件');\n\n    if (this.#isTransaction && !this.#hasWhereId) throw new Error('事务模式下 db.update() 的 where 条件必须是 _id');\n\n    this.#endHost();\n    const res = await this.#host.update(data);\n    const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n    return updated;\n  }\n\n  /**\n   * 删除记录\n   * @returns 删除结果\n   */\n  async remove() {\n    if (this.#hasLookup) throw new Error('db.remove() 方法不支持 lookup 聚合');\n    if (!this.#hasWhere) throw new Error('设置 where 条件后才能执行 db.remove() 方法');\n    if (this.#hasSelect) throw new Error('db.remove() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.remove() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.remove() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.remove() 方法不支持 limit 条件');\n\n    if (this.#isTransaction && !this.#hasWhereId) throw new Error('事务模式下 db.remove() 的 where 条件必须是 _id');\n\n    this.#endHost();\n    const res = await this.#host.remove();\n    const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n    return deleted;\n  }\n}\n\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport type DbProxy<T, S extends DbSelect<T> = {}, R extends AnyObject = {}> = Db<T, S, R> & {\n  _isProxy: true;\n};\n\n/**\n * 数据库操作对象\n */\nexport const db = {\n  /**\n   * 获取指定名称的数据库集合实例\n   * @param name 数据表名称\n   * @returns Db类实例，用于执行数据库操作\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  table<T, S extends DbSelect<T> = {}, R extends AnyObject = {}>(name: string) {\n    return new Proxy(\n      {},\n      {\n        get(target, prop) {\n          if (prop === '_isProxy') return true;\n\n          const table = new Db<T, S, R>({ table: name });\n          const tableProp = prop as keyof Db<T, S, R>;\n          const ref = table[tableProp];\n\n          return isFunction(ref) ? ref.bind(table) : ref;\n        },\n      },\n    ) as DbProxy<T>;\n  },\n};\n\n/**\n * 解析数据库执行结果\n * @param res 客户端、云端响应结果\n * @returns 处理后的结果\n */\nexport function parseDatabaseOutput<T>(res: UniClientDatabaseOutput<T> | UniCloudDatabaseOutput<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 UniClientDatabaseOutput<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\nfunction _toWhereMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({...})' : 'whereId(id)';\n}\n\nfunction _toWhereIdMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({ _id })' : 'whereId(id)';\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MaybeCallable } from '@cloudcome/utils-core/types';\nimport { Db, type DbCreate, type DbProxy, type DbQuery, type DbSelect, type DbUpdate, type DbWhere, db } from './db';\n\nexport type DbUpsertOptions<T, S extends DbSelect<T>, C extends DbCreate<T>, U extends DbUpdate<T>> = {\n  /** 查询条件 */\n  where: DbWhere<T>;\n\n  /** 查询返回字段 */\n  select?: S;\n\n  /** 创建数据 */\n  create: C;\n\n  /**\n   * 更新数据，可以是对象或根据查询结果生成更新对象的函数\n   * @param row 查询到的文档数据，仅在传入函数时可用\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  update: U | ((existed: DbQuery<T, S, {}>) => U);\n\n  /** 创建前回调函数 */\n  onBeforeCreate?: () => unknown;\n\n  /**\n   * 创建后回调函数\n   * @param id 创建的文档ID\n   */\n  onAfterCreate?: (id: string) => unknown;\n\n  /**\n   * 更新前回调函数\n   * @param existed 查询到的原始文档数据\n   * @returns 如果返回 false，则取消更新操作\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  onBeforeUpdate?: (existed: DbQuery<T, S, {}>) => false | unknown;\n\n  /**\n   * 更新后回调函数\n   * @param updateData 实际更新的数据\n   * @param existed 查询到的原始文档数据\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  onAfterUpdate?: (updateData: U, existed: DbQuery<T, S, {}>) => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDbInstance?: any;\n};\n\n/**\n * 数据库 upsert 操作的返回结果类型\n */\nexport type DbUpsertOutput = {\n  /** 操作的文档ID */\n  id: string;\n  /** 是否为创建操作 */\n  created: boolean;\n  /** 是否为更新操作 */\n  updated: boolean;\n};\n\nexport async function dbUpsert<T, S extends DbSelect<T>, C extends DbCreate<T>, U extends DbUpdate<T>>(\n  dbProxy: DbProxy<T, S, C>,\n  options: DbUpsertOptions<T, S, C, U>,\n): Promise<DbUpsertOutput> {\n  const {\n    where,\n    select = {},\n    create,\n    update,\n    onBeforeCreate,\n    onAfterCreate,\n    onBeforeUpdate,\n    onAfterUpdate,\n    _mockDbInstance,\n  } = options;\n\n  // @ts-ignore\n  if ('_id' in select) throw new Error('select 条件不能包含 _id 字段');\n\n  const _db = (_mockDbInstance || dbProxy) as DbProxy<T, S>;\n  const existed = (await _db\n    .where(where)\n    .select(select || {})\n    // biome-ignore lint/complexity/noBannedTypes: <explanation>\n    .queryOne(true)) as DbQuery<T, S, {}> | undefined;\n\n  if (existed) {\n    const skipUpdate = (await onBeforeUpdate?.(existed)) === false;\n\n    if (skipUpdate) {\n      // @ts-ignore\n      return { id: existed._id as string, updated: false, created: false };\n    }\n\n    const updateData = isFunction(update) ? update(existed) : update;\n    // @ts-ignore\n    const updated = await _db.whereId(existed._id).update(updateData);\n    onAfterUpdate?.(updateData, existed);\n\n    // @ts-ignore\n    return { id: existed._id as string, updated: true, created: false };\n  }\n\n  await onBeforeCreate?.();\n  const createdId = await _db.create(create);\n  await onAfterCreate?.(createdId);\n\n  return { id: createdId, updated: false, created: true };\n}\n\ntype _TransactionDb = {\n  startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n  commit: () => Promise<unknown>;\n  rollback: () => Promise<unknown>;\n};\n\ntype _WithTransaction = <T, S extends DbSelect<T>, R extends AnyObject>(table: DbProxy<T, S, R>) => Db<T, S, R>;\n\n/**\n * 在数据库事务中执行操作\n *\n * @template T - 事务操作返回值类型\n * @param transacting - 事务执行函数，接收事务数据库实例作为参数\n * @param _mockDatabase - 用于测试的模拟数据库对象\n * @param _mockDbInstance - 用于测试的模拟数据库实例\n * @returns 事务操作的返回结果\n *\n * @example\n * ```typescript\n * const result = await dbTransaction(async (withTransaction) => {\n *   const userId = await withTransaction(db.table('user')).create({ name: 'John' });\n *   const order = await withTransaction(db.table('orders')).create({ userId, amount: 100 });\n *   return { user, order };\n * });\n * ```\n */\nexport async function dbTransaction<K>(\n  transacting: (withTransaction: _WithTransaction) => Promise<K>,\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any,\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDbInstance?: any,\n) {\n  const transactionDb = (_mockDatabase || uniCloud.database()) as _TransactionDb;\n\n  const [err1, transaction] = await tryFlatten(transactionDb.startTransaction());\n  if (err1) throw err1;\n\n  const withTransaction = <T, S extends DbSelect<T>, R extends AnyObject>(dbProxy: DbProxy<T, S, R>) => {\n    return _mockDbInstance || new Db<T, S, R>({ table: dbProxy.table, transaction });\n  };\n\n  const [err2, result] = await tryFlatten(async () => {\n    const result = await transacting(withTransaction);\n    await transaction.commit();\n    return result;\n  });\n\n  if (err2) {\n    await tryFlatten(transaction.rollback());\n    throw err2;\n  }\n\n  return result as unknown as K;\n}\n"],"names":["isString","isNumber","type","objectMap","objectEach","isFunction","objectOmit","errorAssign","tryFlatten","result"],"mappings":"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"}
+{"version":3,"file":"database.cjs","sources":["../src/database/db.ts","../src/database/fns.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\nimport { objectEach, objectMap, objectOmit } from '@cloudcome/utils-core/object';\nimport { isArray, isFunction, isNumber, isString } from '@cloudcome/utils-core/type';\nimport type {\n  AnyObject,\n  HasProperty,\n  IsEmptyObject,\n  IsOnlyProperty,\n  MergeIntersection,\n  UnionToIntersection,\n} from '@cloudcome/utils-core/types';\nimport type { UniClientDatabaseOutput, UniCloudDatabaseOutput, UniDatabaseCommand } from './types';\n\nexport type DbWhere<T> = {\n  [K in keyof T]?: unknown;\n};\nexport type DbSelect<T> = {\n  [K in keyof T]?: K extends '_id' ? false : true;\n};\nexport type DbFieldsDefault<T> = {\n  [K in keyof T]: true;\n};\ntype _DbFields<T, S extends DbSelect<T>> = IsEmptyObject<S> extends true // 判断是否为空对象\n  ? // 默认全部字段\n    DbFieldsDefault<T>\n  : // 判断 _id 是否为唯一属性\n    IsOnlyProperty<S, '_id'> extends true\n    ? // 从默认字段里排除 _id\n      Omit<DbFieldsDefault<T>, '_id'>\n    : // 判断是否有 _id\n      HasProperty<S, '_id'> extends true\n      ? // 有的话保留 {_id, ...}\n        S\n      : // 没有的话补上 {_id, ...}\n        S & { _id: true };\ntype _DbQuery<T, S extends Record<keyof T, boolean>> = {\n  [K in keyof T as S[K] extends true ? K : never]: T[K];\n};\n// @ts-ignore\nexport type DbQuery<T, S extends DbSelect<T>, R> = _DbQuery<T, _DbFields<T, S>> & R;\nexport type DbForeign<T, S extends DbSelect<T>, R, J extends DbJoinType, A> = Record<\n  A & string,\n  J extends '1:1' ? DbQuery<T, S, R> : DbQuery<T, S, R>[]\n>;\nexport type DbCreate<T> = Partial<T>;\nexport type DbUpdate<T> = Partial<T>;\nexport type DbOrder<T> = Record<keyof T, 'asc' | 'desc'>;\n\ntype _WhereFrom = 'where' | 'whereId';\n\nconst db0 = uniCloud.database();\n/**\n * 数据库操作符命令\n */\nexport const dbCmd = db0.command as unknown as UniDatabaseCommand;\n\n/**\n * 数据库聚合操作符命令\n */\nexport const dbAgg = db0.command.aggregate as UniCloud.AggregateCommand & {\n  pipeline: () => UniCloud.AggregateReference & {\n    done: () => unknown;\n  };\n};\n\nexport type DbOptions = {\n  /**\n   * 数据表名称\n   */\n  table: string;\n\n  /**\n   * 事务对象，用于事务操作\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  transaction?: any;\n\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any;\n};\n\n/**\n * 数据库关联类型\n * - '1:1': 一对一关联，返回值 1 个\n * - '1:n': 一对多关联，返回值 n 个\n * - 'n:1': 多对一关联，返回值 n 个\n */\nexport type DbJoinType = '1:1' | '1:n' | 'n:1';\nexport type DbLookupOptions<J extends DbJoinType, L, F, A> = {\n  /**\n   * 关联类型\n   */\n  type: J;\n\n  /**\n   * 主表字段\n   */\n  localField: keyof L & string;\n\n  /**\n   * 关联表字段\n   */\n  foreignField: keyof F & string;\n\n  /**\n   * 关联数据在结果中的字段名\n   */\n  as: A;\n};\n\nexport type DbLookup = {\n  /**\n   * 关联表\n   */\n  table: Db<unknown>;\n\n  /**\n   * 关联类型\n   */\n  type: DbJoinType;\n\n  /**\n   * 主表字段\n   */\n  localField: string;\n\n  /**\n   * 关联表字段\n   */\n  foreignField: string;\n\n  /**\n   * 关联表名称\n   */\n  from: string;\n\n  /**\n   * 关联数据在结果中的字段名\n   */\n  as: string;\n};\n\nlet gid = 0;\n\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport class Db<T, S extends DbSelect<T> = {}, R extends AnyObject = {}> {\n  #host: UniCloud.CollectionReference;\n\n  /**\n   * 是否为事务环境\n   * - 查询条件只能是 id\n   * - 不能聚合操作\n   */\n  #isTransaction = false;\n\n  #options: DbOptions;\n\n  /**\n   * 构造函数，初始化数据库集合引用\n   * @param collection 数据表名称\n   * @param _mockDatabase 模拟数据库，用于单元测试\n   */\n  constructor(options: DbOptions) {\n    this.#options = options;\n    this.#host =\n      options._mockDatabase || options.transaction?.collection(options.table) || db0.collection(options.table);\n    this.#isTransaction = !!options.transaction;\n  }\n\n  get table() {\n    return this.#options.table;\n  }\n\n  /**\n   * 获取聚合操作实例\n   * @returns 聚合操作实例\n   */\n  aggregate() {\n    return this.#host.aggregate();\n  }\n\n  #hasWhere: _WhereFrom | undefined = undefined;\n  #hasWhereId: _WhereFrom | undefined = undefined;\n  #where = {};\n\n  #doWhere(where: DbWhere<T>, from: _WhereFrom) {\n    if (this.#hasWhere) throw new Error(`已调用过一次 db.${_toWhereMethod(this.#hasWhere)} 了`);\n\n    const whereKeys = Object.keys(where);\n    // 只有 _id 值为字符串或数字时，才能调用 doc 方法\n    const isWhereId = whereKeys.length === 1 && '_id' in where && (isString(where._id) || isNumber(where._id));\n\n    if (isWhereId && this.#hasLimit) {\n      throw new Error(`db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`);\n    }\n\n    this.#hasWhere = from;\n    this.#where = where;\n    if (isWhereId) this.#hasWhereId = from;\n\n    return this;\n  }\n\n  /**\n   * 设置查询条件\n   * @param where 查询条件对象\n   * @returns 当前Db实例，支持链式调用\n   */\n  where(where: DbWhere<T>) {\n    return this.#doWhere(where, 'where');\n  }\n\n  /**\n   * 根据ID设置查询条件\n   * @param id 记录ID\n   * @returns 当前Db实例，支持链式调用\n   */\n  whereId(id: string | number) {\n    // @ts-ignore\n    return this.#doWhere({ _id: id }, 'whereId');\n  }\n\n  #hasSelect = 0;\n  #select = {};\n\n  /**\n   * 指定要返回的字段\n   * @param fields 要返回的字段对象，true表示返回，false表示不返回\n   * @returns 当前Db实例，支持链式调用\n   */\n  select<U extends DbSelect<T>>(fields: U) {\n    if (this.#hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n    this.#hasSelect++;\n    this.#select = fields;\n\n    return this as Db<T, S & U, R>;\n  }\n\n  #hasOrder = 0;\n  #order = {};\n\n  /**\n   * 设置排序规则\n   * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n   * @returns 当前Db实例，支持链式调用\n   */\n  order(order: DbOrder<T>) {\n    this.#hasOrder++;\n    this.#order = order;\n\n    return this;\n  }\n\n  #hasSkip = 0;\n  #skip = 0;\n\n  /**\n   * 跳过指定数量的记录\n   * @param skip 要跳过的记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  skip(skip: number) {\n    if (this.#hasSkip) throw new Error('db.skip() 方法只能调用一次');\n\n    this.#hasSkip++;\n    this.#skip = skip;\n\n    return this;\n  }\n\n  #hasLimit = 0;\n  #limit = 0;\n\n  /**\n   * 限制返回的记录数量\n   * @param limit 最大返回记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  limit(limit: number) {\n    if (this.#hasLimit) throw new Error('db.limit() 方法只能调用一次');\n\n    if (this.#hasWhereId) {\n      throw new Error(`db.limit() 方法不能与 ${_toWhereIdMethod(this.#hasWhereId)} 方法同时调用`);\n    }\n\n    this.#hasLimit++;\n    this.#limit = limit;\n\n    return this;\n  }\n\n  #hasLookup = 0;\n  get hasLookup() {\n    return this.#hasLookup > 0;\n  }\n\n  #lookups: DbLookup[] = [];\n  lookup<FT, FS extends DbSelect<FT>, FR extends AnyObject, J extends DbJoinType, A extends string>(\n    table: Db<FT, FS, FR>,\n    lookup: DbLookupOptions<J, T, FT, A>,\n  ) {\n    // 对方表也记为关联查询，避免做表更新操作\n    table.#hasLookup++;\n    this.#hasLookup++;\n    this.#lookups.push({\n      ...lookup,\n      table,\n      from: table.table,\n    });\n\n    // 这里必须合并联合类型，否则类型结果会丢失最后一次 lookup\n    // @ts-ignore\n    return this as Db<T, S, MergeIntersection<R & DbForeign<FT, FS, FR, J, A>>>;\n  }\n\n  #aggregated = false;\n  #endAggregate(aggRef: UniCloud.AggregateReference) {\n    if (this.#aggregated) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n\n    this.#aggregated = true;\n    let returnAggRef = aggRef;\n    const projects: Record<string, true> = {};\n\n    for (const { type, as, foreignField, from, localField, table } of this.#lookups) {\n      const varName = `v${gid++}`;\n      let pipeline = dbAgg.pipeline();\n\n      // 关联条件\n      // @ts-ignore\n      pipeline = pipeline.match(\n        dbCmd.expr(\n          type === 'n:1'\n            ? // @ts-ignore\n              dbAgg.in([`$${foreignField}`, `$$${varName}`])\n            : dbAgg.eq([`$${foreignField}`, `$$${varName}`]),\n        ),\n      );\n\n      // 其他查询条件\n      // @ts-ignore\n      pipeline = table.#endAggregate(pipeline);\n\n      // @ts-ignore\n      pipeline = pipeline.done();\n\n      returnAggRef = returnAggRef.lookup({\n        let: {\n          [varName]: `$${localField}`,\n        },\n        as,\n        from,\n        pipeline,\n      });\n\n      // 1对1，展开数组\n      if (type === '1:1') {\n        // @ts-ignore\n        returnAggRef = returnAggRef.unwind({\n          path: `$${as}`,\n          preserveNullAndEmptyArrays: true,\n        });\n      }\n\n      projects[as] = true;\n    }\n\n    // 主表查询\n    if (this.#hasWhere) returnAggRef = returnAggRef.match(this.#where);\n    if (this.#hasSelect) returnAggRef = returnAggRef.project({ ...this.#select, ...projects });\n    if (this.#hasOrder) returnAggRef = returnAggRef.sort(objectMap(this.#order, (v) => (v === 'asc' ? 1 : -1)));\n    if (this.#hasSkip) returnAggRef = returnAggRef.skip(this.#skip);\n    if (this.#hasLimit) returnAggRef = returnAggRef.limit(this.#limit);\n\n    return returnAggRef;\n  }\n\n  #endHost() {\n    if (this.#hasWhere) {\n      // @ts-ignore\n      this.#host = this.#host.where(this.#where);\n    }\n\n    if (this.#hasSelect) {\n      // @ts-ignore\n      this.#host = this.#host.field(this.#select);\n    }\n\n    if (this.#hasOrder) {\n      objectEach(this.#order, (val, key) => {\n        // @ts-ignore\n        this.#host = this.#host.orderBy(key, val);\n      });\n    }\n\n    // @ts-ignore\n    if (this.#hasSkip) this.#host = this.#host.skip(this.#skip);\n\n    // @ts-ignore\n    if (this.#hasLimit) this.#host = this.#host.limit(this.#limit);\n    // @ts-ignore\n    else if (this.#hasWhereId) this.#host = this.#host.limit(1);\n  }\n\n  /**\n   * 执行查询操作\n   * @returns 查询结果\n   */\n  async query() {\n    let res: { data: DbQuery<T, S, R>[] };\n\n    // 关联查询\n    if (this.#hasLookup) {\n      const aggRef = this.aggregate();\n      this.#endAggregate(aggRef);\n      res = await aggRef.end();\n    }\n    // 单表查询\n    else {\n      this.#endHost();\n      res = await this.#host.get();\n    }\n\n    const rows = isArray(res.data) ? res.data : [res.data];\n    const { data } = parseDatabaseOutput(res);\n    return data;\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * @param ignoreMiss 是否忽略没有匹配到记录\n   * @returns 查询结果\n   */\n  async queryOne(): Promise<DbQuery<T, S, R>>;\n  async queryOne(ignoreMiss: false): Promise<DbQuery<T, S, R>>;\n  async queryOne(ignoreMiss: true): Promise<DbQuery<T, S, R> | undefined>;\n  async queryOne(ignoreMiss = false): Promise<DbQuery<T, S, R> | undefined> {\n    if (this.#hasLimit) throw new Error('db.queryOne() 方法不支持 limit 条件');\n    if (!this.#hasWhereId) this.limit(1);\n\n    const data = await this.query();\n    const res = data.at(0);\n\n    if (!ignoreMiss && !res) throw new Error('未找到匹配记录');\n    return res;\n  }\n\n  /**\n   * 获取匹配记录的数量\n   * @returns 记录总数\n   */\n  async count() {\n    if (this.#hasLookup) throw new Error('db.count() 方法不支持 lookup 聚合');\n    if (this.#hasSelect) throw new Error('db.count() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.count() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.count() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.count() 方法不支持 limit 条件');\n\n    this.#endHost();\n    const res = await this.#host.count();\n    const { total } = parseDatabaseOutput<{ total: number }>(res);\n    return total;\n  }\n\n  /**\n   * 创建新记录\n   * @param data 要创建的数据\n   * @returns 创建结果\n   */\n  async create(data: DbCreate<T>) {\n    if (this.#hasLookup) throw new Error('db.create() 方法不支持 lookup 聚合');\n    if (this.#hasWhere) throw new Error('db.create() 方法不支持 where 条件');\n    if (this.#hasSelect) throw new Error('db.create() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.create() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.create() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.create() 方法不支持 limit 条件');\n\n    this.#endHost();\n    const res = await this.#host.add(data);\n    const { id } = parseDatabaseOutput<{ id: string }>(res);\n    return id;\n  }\n\n  /**\n   * 更新记录\n   * @param data 要更新的数据\n   * @returns 更新结果\n   */\n  async update(data: AnyObject) {\n    if (this.#hasLookup) throw new Error('db.update() 方法不支持 lookup 聚合');\n    if (!this.#hasWhere) throw new Error('设置 where 条件后才能执行 db.update() 方法');\n    if (this.#hasSelect) throw new Error('db.update() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.update() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.update() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.update() 方法不支持 limit 条件');\n\n    if (this.#isTransaction && !this.#hasWhereId) throw new Error('事务模式下 db.update() 的 where 条件必须是 _id');\n\n    this.#endHost();\n    const res = await this.#host.update(data);\n    const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n    return updated;\n  }\n\n  /**\n   * 删除记录\n   * @returns 删除结果\n   */\n  async remove() {\n    if (this.#hasLookup) throw new Error('db.remove() 方法不支持 lookup 聚合');\n    if (!this.#hasWhere) throw new Error('设置 where 条件后才能执行 db.remove() 方法');\n    if (this.#hasSelect) throw new Error('db.remove() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.remove() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.remove() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.remove() 方法不支持 limit 条件');\n\n    if (this.#isTransaction && !this.#hasWhereId) throw new Error('事务模式下 db.remove() 的 where 条件必须是 _id');\n\n    this.#endHost();\n    const res = await this.#host.remove();\n    const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n    return deleted;\n  }\n}\n\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport type DbProxy<T, S extends DbSelect<T> = {}, R extends AnyObject = {}> = Db<T, S, R> & {\n  _isProxy: true;\n};\n\n/**\n * 数据库操作对象\n */\nexport const db = {\n  /**\n   * 获取指定名称的数据库集合实例\n   * @param name 数据表名称\n   * @returns Db类实例，用于执行数据库操作\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  table<T, S extends DbSelect<T> = {}, R extends AnyObject = {}>(name: string) {\n    return new Proxy(\n      {},\n      {\n        get(target, prop) {\n          if (prop === '_isProxy') return true;\n\n          const table = new Db<T, S, R>({ table: name });\n          const tableProp = prop as keyof Db<T, S, R>;\n          const ref = table[tableProp];\n\n          return isFunction(ref) ? ref.bind(table) : ref;\n        },\n      },\n    ) as DbProxy<T>;\n  },\n};\n\n/**\n * 解析数据库执行结果\n * @param res 客户端、云端响应结果\n * @returns 处理后的结果\n */\nexport function parseDatabaseOutput<T>(res: UniClientDatabaseOutput<T> | UniCloudDatabaseOutput<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 UniClientDatabaseOutput<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\nfunction _toWhereMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({...})' : 'whereId(id)';\n}\n\nfunction _toWhereIdMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({ _id })' : 'whereId(id)';\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MaybeCallable } from '@cloudcome/utils-core/types';\nimport { Db, type DbCreate, type DbProxy, type DbQuery, type DbSelect, type DbUpdate, type DbWhere, db } from './db';\n\nexport type DbUpsertOptions<T, S extends DbSelect<T>, C extends DbCreate<T>, U extends DbUpdate<T>> = {\n  /** 查询条件 */\n  where: DbWhere<T>;\n\n  /** 查询返回字段 */\n  select?: S;\n\n  /** 创建数据 */\n  create: C;\n\n  /**\n   * 更新数据，可以是对象或根据查询结果生成更新对象的函数\n   * @param row 查询到的文档数据，仅在传入函数时可用\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  update: U | ((exist: DbQuery<T, S, {}>) => U);\n\n  /** 创建前回调函数 */\n  onBeforeCreate?: () => unknown;\n\n  /**\n   * 创建后回调函数\n   * @param id 创建的文档ID\n   */\n  onAfterCreate?: (id: string) => unknown;\n\n  /**\n   * 更新前回调函数\n   * @param exist 查询到的原始文档数据\n   * @returns 如果返回 false，则取消更新操作\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  onBeforeUpdate?: (exist: DbQuery<T, S, {}>) => false | unknown;\n\n  /**\n   * 更新后回调函数\n   * @param updateData 实际更新的数据\n   * @param exist 查询到的原始文档数据\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  onAfterUpdate?: (updateData: U, exist: DbQuery<T, S, {}>) => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDbInstance?: any;\n};\n\n/**\n * 数据库 upsert 操作的返回结果类型\n */\nexport type DbUpsertOutput = {\n  /** 操作的文档ID */\n  id: string;\n  /** 是否为创建操作 */\n  created: boolean;\n  /** 是否为更新操作 */\n  updated: boolean;\n};\n\nexport async function dbUpsert<T, S extends DbSelect<T>, C extends DbCreate<T>, U extends DbUpdate<T>>(\n  dbProxy: DbProxy<T>,\n  options: DbUpsertOptions<T, S, C, U>,\n): Promise<DbUpsertOutput> {\n  const {\n    where,\n    select = {},\n    create,\n    update,\n    onBeforeCreate,\n    onAfterCreate,\n    onBeforeUpdate,\n    onAfterUpdate,\n    _mockDbInstance,\n  } = options;\n\n  // @ts-ignore\n  if ('_id' in select) throw new Error('select 条件不能包含 _id 字段');\n\n  const _db = (_mockDbInstance || dbProxy) as DbProxy<T, S>;\n  const exist = (await _db\n    .where(where)\n    .select(select || {})\n    // biome-ignore lint/complexity/noBannedTypes: <explanation>\n    .queryOne(true)) as DbQuery<T, S, {}> | undefined;\n\n  if (exist) {\n    const skipUpdate = (await onBeforeUpdate?.(exist)) === false;\n\n    if (skipUpdate) {\n      // @ts-ignore\n      return { id: exist._id as string, updated: false, created: false };\n    }\n\n    const updateData = isFunction(update) ? update(exist) : update;\n    // @ts-ignore\n    const updated = await _db.whereId(exist._id).update(updateData);\n    onAfterUpdate?.(updateData, exist);\n\n    // @ts-ignore\n    return { id: exist._id as string, updated: true, created: false };\n  }\n\n  await onBeforeCreate?.();\n  const createdId = await _db.create(create);\n  await onAfterCreate?.(createdId);\n\n  return { id: createdId, updated: false, created: true };\n}\n\ntype _TransactionDb = {\n  startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n  commit: () => Promise<unknown>;\n  rollback: () => Promise<unknown>;\n};\n\ntype _WithTransaction = <T, S extends DbSelect<T>, R extends AnyObject>(table: DbProxy<T, S, R>) => Db<T, S, R>;\n\n/**\n * 在数据库事务中执行操作\n *\n * @template T - 事务操作返回值类型\n * @param transacting - 事务执行函数，接收事务数据库实例作为参数\n * @param _mockDatabase - 用于测试的模拟数据库对象\n * @param _mockDbInstance - 用于测试的模拟数据库实例\n * @returns 事务操作的返回结果\n *\n * @example\n * ```typescript\n * const result = await dbTransaction(async (withTransaction) => {\n *   const userId = await withTransaction(db.table('user')).create({ name: 'John' });\n *   const order = await withTransaction(db.table('orders')).create({ userId, amount: 100 });\n *   return { user, order };\n * });\n * ```\n */\nexport async function dbTransaction<K>(\n  transacting: (withTransaction: _WithTransaction) => Promise<K>,\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any,\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDbInstance?: any,\n) {\n  const transactionDb = (_mockDatabase || uniCloud.database()) as _TransactionDb;\n\n  const [err1, transaction] = await tryFlatten(transactionDb.startTransaction());\n  if (err1) throw err1;\n\n  const withTransaction = <T, S extends DbSelect<T>, R extends AnyObject>(dbProxy: DbProxy<T, S, R>) => {\n    return _mockDbInstance || new Db<T, S, R>({ table: dbProxy.table, transaction });\n  };\n\n  const [err2, result] = await tryFlatten(async () => {\n    const result = await transacting(withTransaction);\n    await transaction.commit();\n    return result;\n  });\n\n  if (err2) {\n    await tryFlatten(transaction.rollback());\n    throw err2;\n  }\n\n  return result as unknown as K;\n}\n"],"names":["isString","isNumber","type","objectMap","objectEach","isArray","isFunction","objectOmit","errorAssign","tryFlatten","result"],"mappings":"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"}

package/dist/database.mjs

@@ -1,6 +1,6 @@
 import { errorAssign } from "@cloudcome/utils-core/error";
 import { objectMap, objectEach, objectOmit } from "@cloudcome/utils-core/object";
-import { isString, isNumber, isFunction } from "@cloudcome/utils-core/type";
+import { isString, isNumber, isArray, isFunction } from "@cloudcome/utils-core/type";
 import { tryFlatten } from "@cloudcome/utils-core/try";
 const db0 = uniCloud.database();
 const dbCmd = db0.command;
@@ -178,9 +178,7 @@ class Db {
     return returnAggRef;
   }
   #endHost() {
-    if (this.#hasWhereId) {
-      this.#host = this.#host.doc(this.#where._id);
-    } else if (this.#hasWhere) {
+    if (this.#hasWhere) {
       this.#host = this.#host.where(this.#where);
     }
     if (this.#hasSelect) {
@@ -193,6 +191,7 @@ class Db {
     }
     if (this.#hasSkip) this.#host = this.#host.skip(this.#skip);
     if (this.#hasLimit) this.#host = this.#host.limit(this.#limit);
+    else if (this.#hasWhereId) this.#host = this.#host.limit(1);
   }
   /**
    * 执行查询操作
@@ -208,6 +207,7 @@ class Db {
       this.#endHost();
       res = await this.#host.get();
     }
+    isArray(res.data) ? res.data : [res.data];
     const { data } = parseDatabaseOutput(res);
     return data;
   }
@@ -339,16 +339,16 @@ async function dbUpsert(dbProxy, options) {
   } = options;
   if ("_id" in select) throw new Error("select 条件不能包含 _id 字段");
   const _db = _mockDbInstance || dbProxy;
-  const existed = await _db.where(where).select(select || {}).queryOne(true);
-  if (existed) {
-    const skipUpdate = await onBeforeUpdate?.(existed) === false;
+  const exist = await _db.where(where).select(select || {}).queryOne(true);
+  if (exist) {
+    const skipUpdate = await onBeforeUpdate?.(exist) === false;
     if (skipUpdate) {
-      return { id: existed._id, updated: false, created: false };
+      return { id: exist._id, updated: false, created: false };
     }
-    const updateData = isFunction(update) ? update(existed) : update;
-    await _db.whereId(existed._id).update(updateData);
-    onAfterUpdate?.(updateData, existed);
-    return { id: existed._id, updated: true, created: false };
+    const updateData = isFunction(update) ? update(exist) : update;
+    await _db.whereId(exist._id).update(updateData);
+    onAfterUpdate?.(updateData, exist);
+    return { id: exist._id, updated: true, created: false };
   }
   await onBeforeCreate?.();
   const createdId = await _db.create(create);

package/dist/database.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database.mjs","sources":["../src/database/db.ts","../src/database/fns.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\nimport { objectEach, objectMap, objectOmit } from '@cloudcome/utils-core/object';\nimport { isFunction, isNumber, isString } from '@cloudcome/utils-core/type';\nimport type {\n  AnyObject,\n  HasProperty,\n  IsEmptyObject,\n  IsOnlyProperty,\n  MergeIntersection,\n  UnionToIntersection,\n} from '@cloudcome/utils-core/types';\nimport type { UniClientDatabaseOutput, UniCloudDatabaseOutput } from './types';\n\nexport type DbWhere<T> = {\n  [K in keyof T]?: unknown;\n};\nexport type DbSelect<T> = {\n  [K in keyof T]?: K extends '_id' ? false : true;\n};\nexport type DbFieldsDefault<T> = {\n  [K in keyof T]: true;\n};\ntype _DbFields<T, S extends DbSelect<T>> = IsEmptyObject<S> extends true // 判断是否为空对象\n  ? // 默认全部字段\n    DbFieldsDefault<T>\n  : // 判断 _id 是否为唯一属性\n    IsOnlyProperty<S, '_id'> extends true\n    ? // 从默认字段里排除 _id\n      Omit<DbFieldsDefault<T>, '_id'>\n    : // 判断是否有 _id\n      HasProperty<S, '_id'> extends true\n      ? // 有的话保留 {_id, ...}\n        S\n      : // 没有的话补上 {_id, ...}\n        S & { _id: true };\ntype _DbQuery<T, S extends Record<keyof T, boolean>> = {\n  [K in keyof T as S[K] extends true ? K : never]: T[K];\n};\n// @ts-ignore\nexport type DbQuery<T, S extends DbSelect<T>, R> = _DbQuery<T, _DbFields<T, S>> & R;\nexport type DbForeign<T, S extends DbSelect<T>, R, J extends DbJoinType, A> = Record<\n  A & string,\n  J extends '1:1' ? DbQuery<T, S, R> : DbQuery<T, S, R>[]\n>;\nexport type DbCreate<T> = Partial<T>;\nexport type DbUpdate<T> = Partial<T>;\nexport type DbOrder<T> = Record<keyof T, 'asc' | 'desc'>;\n\ntype _WhereFrom = 'where' | 'whereId';\n\nconst db0 = uniCloud.database();\n/**\n * 数据库操作符命令\n */\nexport const dbCmd = db0.command as UniCloud.QueryCommand & {\n  expr: (expr: unknown) => unknown;\n};\n\n/**\n * 数据库聚合操作符命令\n */\nexport const dbAgg = db0.command.aggregate as UniCloud.AggregateCommand & {\n  pipeline: () => UniCloud.AggregateReference & {\n    done: () => unknown;\n  };\n};\n\nexport type DbOptions = {\n  /**\n   * 数据表名称\n   */\n  table: string;\n\n  /**\n   * 事务对象，用于事务操作\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  transaction?: any;\n\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any;\n};\n\n/**\n * 数据库关联类型\n * - '1:1': 一对一关联，返回值 1 个\n * - '1:n': 一对多关联，返回值 n 个\n * - 'n:1': 多对一关联，返回值 n 个\n */\nexport type DbJoinType = '1:1' | '1:n' | 'n:1';\nexport type DbLookupOptions<J extends DbJoinType, L, F, A> = {\n  /**\n   * 关联类型\n   */\n  type: J;\n\n  /**\n   * 主表字段\n   */\n  localField: keyof L & string;\n\n  /**\n   * 关联表字段\n   */\n  foreignField: keyof F & string;\n\n  /**\n   * 关联数据在结果中的字段名\n   */\n  as: A;\n};\n\nexport type DbLookup = {\n  /**\n   * 关联表\n   */\n  table: Db<unknown>;\n\n  /**\n   * 关联类型\n   */\n  type: DbJoinType;\n\n  /**\n   * 主表字段\n   */\n  localField: string;\n\n  /**\n   * 关联表字段\n   */\n  foreignField: string;\n\n  /**\n   * 关联表名称\n   */\n  from: string;\n\n  /**\n   * 关联数据在结果中的字段名\n   */\n  as: string;\n};\n\nlet gid = 0;\n\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport class Db<T, S extends DbSelect<T> = {}, R extends AnyObject = {}> {\n  #host: UniCloud.CollectionReference;\n\n  /**\n   * 是否为事务环境\n   * - 查询条件只能是 id\n   * - 不能聚合操作\n   */\n  #isTransaction = false;\n\n  #options: DbOptions;\n\n  /**\n   * 构造函数，初始化数据库集合引用\n   * @param collection 数据表名称\n   * @param _mockDatabase 模拟数据库，用于单元测试\n   */\n  constructor(options: DbOptions) {\n    this.#options = options;\n    this.#host =\n      options._mockDatabase || options.transaction?.collection(options.table) || db0.collection(options.table);\n    this.#isTransaction = !!options.transaction;\n  }\n\n  get table() {\n    return this.#options.table;\n  }\n\n  /**\n   * 获取聚合操作实例\n   * @returns 聚合操作实例\n   */\n  aggregate() {\n    return this.#host.aggregate();\n  }\n\n  #hasWhere: _WhereFrom | undefined = undefined;\n  #hasWhereId: _WhereFrom | undefined = undefined;\n  #where = {};\n\n  #doWhere(where: DbWhere<T>, from: _WhereFrom) {\n    if (this.#hasWhere) throw new Error(`已调用过一次 db.${_toWhereMethod(this.#hasWhere)} 了`);\n\n    const whereKeys = Object.keys(where);\n    // 只有 _id 值为字符串或数字时，才能调用 doc 方法\n    const isWhereId = whereKeys.length === 1 && '_id' in where && (isString(where._id) || isNumber(where._id));\n\n    if (isWhereId && this.#hasLimit) {\n      throw new Error(`db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`);\n    }\n\n    this.#hasWhere = from;\n    this.#where = where;\n    if (isWhereId) this.#hasWhereId = from;\n\n    return this;\n  }\n\n  /**\n   * 设置查询条件\n   * @param where 查询条件对象\n   * @returns 当前Db实例，支持链式调用\n   */\n  where(where: DbWhere<T>) {\n    return this.#doWhere(where, 'where');\n  }\n\n  /**\n   * 根据ID设置查询条件\n   * @param id 记录ID\n   * @returns 当前Db实例，支持链式调用\n   */\n  whereId(id: string | number) {\n    // @ts-ignore\n    return this.#doWhere({ _id: id }, 'whereId');\n  }\n\n  #hasSelect = 0;\n  #select = {};\n\n  /**\n   * 指定要返回的字段\n   * @param fields 要返回的字段对象，true表示返回，false表示不返回\n   * @returns 当前Db实例，支持链式调用\n   */\n  select<U extends DbSelect<T>>(fields: U) {\n    if (this.#hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n    this.#hasSelect++;\n    this.#select = fields;\n\n    return this as Db<T, S & U, R>;\n  }\n\n  #hasOrder = 0;\n  #order = {};\n\n  /**\n   * 设置排序规则\n   * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n   * @returns 当前Db实例，支持链式调用\n   */\n  order(order: DbOrder<T>) {\n    this.#hasOrder++;\n    this.#order = order;\n\n    return this;\n  }\n\n  #hasSkip = 0;\n  #skip = 0;\n\n  /**\n   * 跳过指定数量的记录\n   * @param skip 要跳过的记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  skip(skip: number) {\n    if (this.#hasSkip) throw new Error('db.skip() 方法只能调用一次');\n\n    this.#hasSkip++;\n    this.#skip = skip;\n\n    return this;\n  }\n\n  #hasLimit = 0;\n  #limit = 0;\n\n  /**\n   * 限制返回的记录数量\n   * @param limit 最大返回记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  limit(limit: number) {\n    if (this.#hasLimit) throw new Error('db.limit() 方法只能调用一次');\n\n    if (this.#hasWhereId) {\n      throw new Error(`db.limit() 方法不能与 ${_toWhereIdMethod(this.#hasWhereId)} 方法同时调用`);\n    }\n\n    this.#hasLimit++;\n    this.#limit = limit;\n\n    return this;\n  }\n\n  #hasLookup = 0;\n  get hasLookup() {\n    return this.#hasLookup > 0;\n  }\n\n  #lookups: DbLookup[] = [];\n  lookup<FT, FS extends DbSelect<FT>, FR extends AnyObject, J extends DbJoinType, A extends string>(\n    table: Db<FT, FS, FR>,\n    lookup: DbLookupOptions<J, T, FT, A>,\n  ) {\n    // 对方表也记为关联查询，避免做表更新操作\n    table.#hasLookup++;\n    this.#hasLookup++;\n    this.#lookups.push({\n      ...lookup,\n      table,\n      from: table.table,\n    });\n\n    // 这里必须合并联合类型，否则类型结果会丢失最后一次 lookup\n    // @ts-ignore\n    return this as Db<T, S, MergeIntersection<R & DbForeign<FT, FS, FR, J, A>>>;\n  }\n\n  #aggregated = false;\n  #endAggregate(aggRef: UniCloud.AggregateReference) {\n    if (this.#aggregated) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n\n    this.#aggregated = true;\n    let returnAggRef = aggRef;\n    const projects: Record<string, true> = {};\n\n    for (const { type, as, foreignField, from, localField, table } of this.#lookups) {\n      const varName = `v${gid++}`;\n      let pipeline = dbAgg.pipeline();\n\n      // 关联条件\n      // @ts-ignore\n      pipeline = pipeline.match(\n        dbCmd.expr(\n          type === 'n:1'\n            ? // @ts-ignore\n              dbAgg.in([`$${foreignField}`, `$$${varName}`])\n            : dbAgg.eq([`$${foreignField}`, `$$${varName}`]),\n        ),\n      );\n\n      // 其他查询条件\n      // @ts-ignore\n      pipeline = table.#endAggregate(pipeline);\n\n      // @ts-ignore\n      pipeline = pipeline.done();\n\n      returnAggRef = returnAggRef.lookup({\n        let: {\n          [varName]: `$${localField}`,\n        },\n        as,\n        from,\n        pipeline,\n      });\n\n      // 1对1，展开数组\n      if (type === '1:1') {\n        // @ts-ignore\n        returnAggRef = returnAggRef.unwind({\n          path: `$${as}`,\n          preserveNullAndEmptyArrays: true,\n        });\n      }\n\n      projects[as] = true;\n    }\n\n    // 主表查询\n    if (this.#hasWhere) returnAggRef = returnAggRef.match(this.#where);\n    if (this.#hasSelect) returnAggRef = returnAggRef.project({ ...this.#select, ...projects });\n    if (this.#hasOrder) returnAggRef = returnAggRef.sort(objectMap(this.#order, (v) => (v === 'asc' ? 1 : -1)));\n    if (this.#hasSkip) returnAggRef = returnAggRef.skip(this.#skip);\n    if (this.#hasLimit) returnAggRef = returnAggRef.limit(this.#limit);\n\n    return returnAggRef;\n  }\n\n  #endHost() {\n    if (this.#hasWhereId) {\n      // @ts-ignore\n      this.#host = this.#host.doc(this.#where._id);\n    } else if (this.#hasWhere) {\n      // @ts-ignore\n      this.#host = this.#host.where(this.#where);\n    }\n\n    if (this.#hasSelect) {\n      // @ts-ignore\n      this.#host = this.#host.field(this.#select);\n    }\n\n    if (this.#hasOrder) {\n      objectEach(this.#order, (val, key) => {\n        // @ts-ignore\n        this.#host = this.#host.orderBy(key, val);\n      });\n    }\n\n    // @ts-ignore\n    if (this.#hasSkip) this.#host = this.#host.skip(this.#skip);\n\n    // @ts-ignore\n    if (this.#hasLimit) this.#host = this.#host.limit(this.#limit);\n  }\n\n  /**\n   * 执行查询操作\n   * @returns 查询结果\n   */\n  async query() {\n    // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n    let res: any;\n\n    // 关联查询\n    if (this.#hasLookup) {\n      const aggRef = this.aggregate();\n      this.#endAggregate(aggRef);\n      res = await aggRef.end();\n    }\n    // 单表查询\n    else {\n      this.#endHost();\n      res = await this.#host.get();\n    }\n\n    const { data } = parseDatabaseOutput<{ data: DbQuery<T, S, R>[] }>(res);\n    return data;\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * @param ignoreMiss 是否忽略没有匹配到记录\n   * @returns 查询结果\n   */\n  async queryOne(): Promise<DbQuery<T, S, R>>;\n  async queryOne(ignoreMiss: false): Promise<DbQuery<T, S, R>>;\n  async queryOne(ignoreMiss: true): Promise<DbQuery<T, S, R> | undefined>;\n  async queryOne(ignoreMiss = false): Promise<DbQuery<T, S, R> | undefined> {\n    if (this.#hasLimit) throw new Error('db.queryOne() 方法不支持 limit 条件');\n    if (!this.#hasWhereId) this.limit(1);\n\n    const data = await this.query();\n    const res = data.at(0);\n\n    if (!ignoreMiss && !res) throw new Error('未找到匹配记录');\n    return res;\n  }\n\n  /**\n   * 获取匹配记录的数量\n   * @returns 记录总数\n   */\n  async count() {\n    if (this.#hasLookup) throw new Error('db.count() 方法不支持 lookup 聚合');\n    if (this.#hasSelect) throw new Error('db.count() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.count() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.count() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.count() 方法不支持 limit 条件');\n\n    this.#endHost();\n    const res = await this.#host.count();\n    const { total } = parseDatabaseOutput<{ total: number }>(res);\n    return total;\n  }\n\n  /**\n   * 创建新记录\n   * @param data 要创建的数据\n   * @returns 创建结果\n   */\n  async create(data: DbCreate<T>) {\n    if (this.#hasLookup) throw new Error('db.create() 方法不支持 lookup 聚合');\n    if (this.#hasWhere) throw new Error('db.create() 方法不支持 where 条件');\n    if (this.#hasSelect) throw new Error('db.create() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.create() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.create() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.create() 方法不支持 limit 条件');\n\n    this.#endHost();\n    const res = await this.#host.add(data);\n    const { id } = parseDatabaseOutput<{ id: string }>(res);\n    return id;\n  }\n\n  /**\n   * 更新记录\n   * @param data 要更新的数据\n   * @returns 更新结果\n   */\n  async update(data: AnyObject) {\n    if (this.#hasLookup) throw new Error('db.update() 方法不支持 lookup 聚合');\n    if (!this.#hasWhere) throw new Error('设置 where 条件后才能执行 db.update() 方法');\n    if (this.#hasSelect) throw new Error('db.update() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.update() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.update() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.update() 方法不支持 limit 条件');\n\n    if (this.#isTransaction && !this.#hasWhereId) throw new Error('事务模式下 db.update() 的 where 条件必须是 _id');\n\n    this.#endHost();\n    const res = await this.#host.update(data);\n    const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n    return updated;\n  }\n\n  /**\n   * 删除记录\n   * @returns 删除结果\n   */\n  async remove() {\n    if (this.#hasLookup) throw new Error('db.remove() 方法不支持 lookup 聚合');\n    if (!this.#hasWhere) throw new Error('设置 where 条件后才能执行 db.remove() 方法');\n    if (this.#hasSelect) throw new Error('db.remove() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.remove() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.remove() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.remove() 方法不支持 limit 条件');\n\n    if (this.#isTransaction && !this.#hasWhereId) throw new Error('事务模式下 db.remove() 的 where 条件必须是 _id');\n\n    this.#endHost();\n    const res = await this.#host.remove();\n    const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n    return deleted;\n  }\n}\n\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport type DbProxy<T, S extends DbSelect<T> = {}, R extends AnyObject = {}> = Db<T, S, R> & {\n  _isProxy: true;\n};\n\n/**\n * 数据库操作对象\n */\nexport const db = {\n  /**\n   * 获取指定名称的数据库集合实例\n   * @param name 数据表名称\n   * @returns Db类实例，用于执行数据库操作\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  table<T, S extends DbSelect<T> = {}, R extends AnyObject = {}>(name: string) {\n    return new Proxy(\n      {},\n      {\n        get(target, prop) {\n          if (prop === '_isProxy') return true;\n\n          const table = new Db<T, S, R>({ table: name });\n          const tableProp = prop as keyof Db<T, S, R>;\n          const ref = table[tableProp];\n\n          return isFunction(ref) ? ref.bind(table) : ref;\n        },\n      },\n    ) as DbProxy<T>;\n  },\n};\n\n/**\n * 解析数据库执行结果\n * @param res 客户端、云端响应结果\n * @returns 处理后的结果\n */\nexport function parseDatabaseOutput<T>(res: UniClientDatabaseOutput<T> | UniCloudDatabaseOutput<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 UniClientDatabaseOutput<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\nfunction _toWhereMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({...})' : 'whereId(id)';\n}\n\nfunction _toWhereIdMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({ _id })' : 'whereId(id)';\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MaybeCallable } from '@cloudcome/utils-core/types';\nimport { Db, type DbCreate, type DbProxy, type DbQuery, type DbSelect, type DbUpdate, type DbWhere, db } from './db';\n\nexport type DbUpsertOptions<T, S extends DbSelect<T>, C extends DbCreate<T>, U extends DbUpdate<T>> = {\n  /** 查询条件 */\n  where: DbWhere<T>;\n\n  /** 查询返回字段 */\n  select?: S;\n\n  /** 创建数据 */\n  create: C;\n\n  /**\n   * 更新数据，可以是对象或根据查询结果生成更新对象的函数\n   * @param row 查询到的文档数据，仅在传入函数时可用\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  update: U | ((existed: DbQuery<T, S, {}>) => U);\n\n  /** 创建前回调函数 */\n  onBeforeCreate?: () => unknown;\n\n  /**\n   * 创建后回调函数\n   * @param id 创建的文档ID\n   */\n  onAfterCreate?: (id: string) => unknown;\n\n  /**\n   * 更新前回调函数\n   * @param existed 查询到的原始文档数据\n   * @returns 如果返回 false，则取消更新操作\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  onBeforeUpdate?: (existed: DbQuery<T, S, {}>) => false | unknown;\n\n  /**\n   * 更新后回调函数\n   * @param updateData 实际更新的数据\n   * @param existed 查询到的原始文档数据\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  onAfterUpdate?: (updateData: U, existed: DbQuery<T, S, {}>) => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDbInstance?: any;\n};\n\n/**\n * 数据库 upsert 操作的返回结果类型\n */\nexport type DbUpsertOutput = {\n  /** 操作的文档ID */\n  id: string;\n  /** 是否为创建操作 */\n  created: boolean;\n  /** 是否为更新操作 */\n  updated: boolean;\n};\n\nexport async function dbUpsert<T, S extends DbSelect<T>, C extends DbCreate<T>, U extends DbUpdate<T>>(\n  dbProxy: DbProxy<T, S, C>,\n  options: DbUpsertOptions<T, S, C, U>,\n): Promise<DbUpsertOutput> {\n  const {\n    where,\n    select = {},\n    create,\n    update,\n    onBeforeCreate,\n    onAfterCreate,\n    onBeforeUpdate,\n    onAfterUpdate,\n    _mockDbInstance,\n  } = options;\n\n  // @ts-ignore\n  if ('_id' in select) throw new Error('select 条件不能包含 _id 字段');\n\n  const _db = (_mockDbInstance || dbProxy) as DbProxy<T, S>;\n  const existed = (await _db\n    .where(where)\n    .select(select || {})\n    // biome-ignore lint/complexity/noBannedTypes: <explanation>\n    .queryOne(true)) as DbQuery<T, S, {}> | undefined;\n\n  if (existed) {\n    const skipUpdate = (await onBeforeUpdate?.(existed)) === false;\n\n    if (skipUpdate) {\n      // @ts-ignore\n      return { id: existed._id as string, updated: false, created: false };\n    }\n\n    const updateData = isFunction(update) ? update(existed) : update;\n    // @ts-ignore\n    const updated = await _db.whereId(existed._id).update(updateData);\n    onAfterUpdate?.(updateData, existed);\n\n    // @ts-ignore\n    return { id: existed._id as string, updated: true, created: false };\n  }\n\n  await onBeforeCreate?.();\n  const createdId = await _db.create(create);\n  await onAfterCreate?.(createdId);\n\n  return { id: createdId, updated: false, created: true };\n}\n\ntype _TransactionDb = {\n  startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n  commit: () => Promise<unknown>;\n  rollback: () => Promise<unknown>;\n};\n\ntype _WithTransaction = <T, S extends DbSelect<T>, R extends AnyObject>(table: DbProxy<T, S, R>) => Db<T, S, R>;\n\n/**\n * 在数据库事务中执行操作\n *\n * @template T - 事务操作返回值类型\n * @param transacting - 事务执行函数，接收事务数据库实例作为参数\n * @param _mockDatabase - 用于测试的模拟数据库对象\n * @param _mockDbInstance - 用于测试的模拟数据库实例\n * @returns 事务操作的返回结果\n *\n * @example\n * ```typescript\n * const result = await dbTransaction(async (withTransaction) => {\n *   const userId = await withTransaction(db.table('user')).create({ name: 'John' });\n *   const order = await withTransaction(db.table('orders')).create({ userId, amount: 100 });\n *   return { user, order };\n * });\n * ```\n */\nexport async function dbTransaction<K>(\n  transacting: (withTransaction: _WithTransaction) => Promise<K>,\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any,\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDbInstance?: any,\n) {\n  const transactionDb = (_mockDatabase || uniCloud.database()) as _TransactionDb;\n\n  const [err1, transaction] = await tryFlatten(transactionDb.startTransaction());\n  if (err1) throw err1;\n\n  const withTransaction = <T, S extends DbSelect<T>, R extends AnyObject>(dbProxy: DbProxy<T, S, R>) => {\n    return _mockDbInstance || new Db<T, S, R>({ table: dbProxy.table, transaction });\n  };\n\n  const [err2, result] = await tryFlatten(async () => {\n    const result = await transacting(withTransaction);\n    await transaction.commit();\n    return result;\n  });\n\n  if (err2) {\n    await tryFlatten(transaction.rollback());\n    throw err2;\n  }\n\n  return result as unknown as K;\n}\n"],"names":["result"],"mappings":"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"}
+{"version":3,"file":"database.mjs","sources":["../src/database/db.ts","../src/database/fns.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\nimport { objectEach, objectMap, objectOmit } from '@cloudcome/utils-core/object';\nimport { isArray, isFunction, isNumber, isString } from '@cloudcome/utils-core/type';\nimport type {\n  AnyObject,\n  HasProperty,\n  IsEmptyObject,\n  IsOnlyProperty,\n  MergeIntersection,\n  UnionToIntersection,\n} from '@cloudcome/utils-core/types';\nimport type { UniClientDatabaseOutput, UniCloudDatabaseOutput, UniDatabaseCommand } from './types';\n\nexport type DbWhere<T> = {\n  [K in keyof T]?: unknown;\n};\nexport type DbSelect<T> = {\n  [K in keyof T]?: K extends '_id' ? false : true;\n};\nexport type DbFieldsDefault<T> = {\n  [K in keyof T]: true;\n};\ntype _DbFields<T, S extends DbSelect<T>> = IsEmptyObject<S> extends true // 判断是否为空对象\n  ? // 默认全部字段\n    DbFieldsDefault<T>\n  : // 判断 _id 是否为唯一属性\n    IsOnlyProperty<S, '_id'> extends true\n    ? // 从默认字段里排除 _id\n      Omit<DbFieldsDefault<T>, '_id'>\n    : // 判断是否有 _id\n      HasProperty<S, '_id'> extends true\n      ? // 有的话保留 {_id, ...}\n        S\n      : // 没有的话补上 {_id, ...}\n        S & { _id: true };\ntype _DbQuery<T, S extends Record<keyof T, boolean>> = {\n  [K in keyof T as S[K] extends true ? K : never]: T[K];\n};\n// @ts-ignore\nexport type DbQuery<T, S extends DbSelect<T>, R> = _DbQuery<T, _DbFields<T, S>> & R;\nexport type DbForeign<T, S extends DbSelect<T>, R, J extends DbJoinType, A> = Record<\n  A & string,\n  J extends '1:1' ? DbQuery<T, S, R> : DbQuery<T, S, R>[]\n>;\nexport type DbCreate<T> = Partial<T>;\nexport type DbUpdate<T> = Partial<T>;\nexport type DbOrder<T> = Record<keyof T, 'asc' | 'desc'>;\n\ntype _WhereFrom = 'where' | 'whereId';\n\nconst db0 = uniCloud.database();\n/**\n * 数据库操作符命令\n */\nexport const dbCmd = db0.command as unknown as UniDatabaseCommand;\n\n/**\n * 数据库聚合操作符命令\n */\nexport const dbAgg = db0.command.aggregate as UniCloud.AggregateCommand & {\n  pipeline: () => UniCloud.AggregateReference & {\n    done: () => unknown;\n  };\n};\n\nexport type DbOptions = {\n  /**\n   * 数据表名称\n   */\n  table: string;\n\n  /**\n   * 事务对象，用于事务操作\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  transaction?: any;\n\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any;\n};\n\n/**\n * 数据库关联类型\n * - '1:1': 一对一关联，返回值 1 个\n * - '1:n': 一对多关联，返回值 n 个\n * - 'n:1': 多对一关联，返回值 n 个\n */\nexport type DbJoinType = '1:1' | '1:n' | 'n:1';\nexport type DbLookupOptions<J extends DbJoinType, L, F, A> = {\n  /**\n   * 关联类型\n   */\n  type: J;\n\n  /**\n   * 主表字段\n   */\n  localField: keyof L & string;\n\n  /**\n   * 关联表字段\n   */\n  foreignField: keyof F & string;\n\n  /**\n   * 关联数据在结果中的字段名\n   */\n  as: A;\n};\n\nexport type DbLookup = {\n  /**\n   * 关联表\n   */\n  table: Db<unknown>;\n\n  /**\n   * 关联类型\n   */\n  type: DbJoinType;\n\n  /**\n   * 主表字段\n   */\n  localField: string;\n\n  /**\n   * 关联表字段\n   */\n  foreignField: string;\n\n  /**\n   * 关联表名称\n   */\n  from: string;\n\n  /**\n   * 关联数据在结果中的字段名\n   */\n  as: string;\n};\n\nlet gid = 0;\n\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport class Db<T, S extends DbSelect<T> = {}, R extends AnyObject = {}> {\n  #host: UniCloud.CollectionReference;\n\n  /**\n   * 是否为事务环境\n   * - 查询条件只能是 id\n   * - 不能聚合操作\n   */\n  #isTransaction = false;\n\n  #options: DbOptions;\n\n  /**\n   * 构造函数，初始化数据库集合引用\n   * @param collection 数据表名称\n   * @param _mockDatabase 模拟数据库，用于单元测试\n   */\n  constructor(options: DbOptions) {\n    this.#options = options;\n    this.#host =\n      options._mockDatabase || options.transaction?.collection(options.table) || db0.collection(options.table);\n    this.#isTransaction = !!options.transaction;\n  }\n\n  get table() {\n    return this.#options.table;\n  }\n\n  /**\n   * 获取聚合操作实例\n   * @returns 聚合操作实例\n   */\n  aggregate() {\n    return this.#host.aggregate();\n  }\n\n  #hasWhere: _WhereFrom | undefined = undefined;\n  #hasWhereId: _WhereFrom | undefined = undefined;\n  #where = {};\n\n  #doWhere(where: DbWhere<T>, from: _WhereFrom) {\n    if (this.#hasWhere) throw new Error(`已调用过一次 db.${_toWhereMethod(this.#hasWhere)} 了`);\n\n    const whereKeys = Object.keys(where);\n    // 只有 _id 值为字符串或数字时，才能调用 doc 方法\n    const isWhereId = whereKeys.length === 1 && '_id' in where && (isString(where._id) || isNumber(where._id));\n\n    if (isWhereId && this.#hasLimit) {\n      throw new Error(`db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`);\n    }\n\n    this.#hasWhere = from;\n    this.#where = where;\n    if (isWhereId) this.#hasWhereId = from;\n\n    return this;\n  }\n\n  /**\n   * 设置查询条件\n   * @param where 查询条件对象\n   * @returns 当前Db实例，支持链式调用\n   */\n  where(where: DbWhere<T>) {\n    return this.#doWhere(where, 'where');\n  }\n\n  /**\n   * 根据ID设置查询条件\n   * @param id 记录ID\n   * @returns 当前Db实例，支持链式调用\n   */\n  whereId(id: string | number) {\n    // @ts-ignore\n    return this.#doWhere({ _id: id }, 'whereId');\n  }\n\n  #hasSelect = 0;\n  #select = {};\n\n  /**\n   * 指定要返回的字段\n   * @param fields 要返回的字段对象，true表示返回，false表示不返回\n   * @returns 当前Db实例，支持链式调用\n   */\n  select<U extends DbSelect<T>>(fields: U) {\n    if (this.#hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n    this.#hasSelect++;\n    this.#select = fields;\n\n    return this as Db<T, S & U, R>;\n  }\n\n  #hasOrder = 0;\n  #order = {};\n\n  /**\n   * 设置排序规则\n   * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n   * @returns 当前Db实例，支持链式调用\n   */\n  order(order: DbOrder<T>) {\n    this.#hasOrder++;\n    this.#order = order;\n\n    return this;\n  }\n\n  #hasSkip = 0;\n  #skip = 0;\n\n  /**\n   * 跳过指定数量的记录\n   * @param skip 要跳过的记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  skip(skip: number) {\n    if (this.#hasSkip) throw new Error('db.skip() 方法只能调用一次');\n\n    this.#hasSkip++;\n    this.#skip = skip;\n\n    return this;\n  }\n\n  #hasLimit = 0;\n  #limit = 0;\n\n  /**\n   * 限制返回的记录数量\n   * @param limit 最大返回记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  limit(limit: number) {\n    if (this.#hasLimit) throw new Error('db.limit() 方法只能调用一次');\n\n    if (this.#hasWhereId) {\n      throw new Error(`db.limit() 方法不能与 ${_toWhereIdMethod(this.#hasWhereId)} 方法同时调用`);\n    }\n\n    this.#hasLimit++;\n    this.#limit = limit;\n\n    return this;\n  }\n\n  #hasLookup = 0;\n  get hasLookup() {\n    return this.#hasLookup > 0;\n  }\n\n  #lookups: DbLookup[] = [];\n  lookup<FT, FS extends DbSelect<FT>, FR extends AnyObject, J extends DbJoinType, A extends string>(\n    table: Db<FT, FS, FR>,\n    lookup: DbLookupOptions<J, T, FT, A>,\n  ) {\n    // 对方表也记为关联查询，避免做表更新操作\n    table.#hasLookup++;\n    this.#hasLookup++;\n    this.#lookups.push({\n      ...lookup,\n      table,\n      from: table.table,\n    });\n\n    // 这里必须合并联合类型，否则类型结果会丢失最后一次 lookup\n    // @ts-ignore\n    return this as Db<T, S, MergeIntersection<R & DbForeign<FT, FS, FR, J, A>>>;\n  }\n\n  #aggregated = false;\n  #endAggregate(aggRef: UniCloud.AggregateReference) {\n    if (this.#aggregated) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n\n    this.#aggregated = true;\n    let returnAggRef = aggRef;\n    const projects: Record<string, true> = {};\n\n    for (const { type, as, foreignField, from, localField, table } of this.#lookups) {\n      const varName = `v${gid++}`;\n      let pipeline = dbAgg.pipeline();\n\n      // 关联条件\n      // @ts-ignore\n      pipeline = pipeline.match(\n        dbCmd.expr(\n          type === 'n:1'\n            ? // @ts-ignore\n              dbAgg.in([`$${foreignField}`, `$$${varName}`])\n            : dbAgg.eq([`$${foreignField}`, `$$${varName}`]),\n        ),\n      );\n\n      // 其他查询条件\n      // @ts-ignore\n      pipeline = table.#endAggregate(pipeline);\n\n      // @ts-ignore\n      pipeline = pipeline.done();\n\n      returnAggRef = returnAggRef.lookup({\n        let: {\n          [varName]: `$${localField}`,\n        },\n        as,\n        from,\n        pipeline,\n      });\n\n      // 1对1，展开数组\n      if (type === '1:1') {\n        // @ts-ignore\n        returnAggRef = returnAggRef.unwind({\n          path: `$${as}`,\n          preserveNullAndEmptyArrays: true,\n        });\n      }\n\n      projects[as] = true;\n    }\n\n    // 主表查询\n    if (this.#hasWhere) returnAggRef = returnAggRef.match(this.#where);\n    if (this.#hasSelect) returnAggRef = returnAggRef.project({ ...this.#select, ...projects });\n    if (this.#hasOrder) returnAggRef = returnAggRef.sort(objectMap(this.#order, (v) => (v === 'asc' ? 1 : -1)));\n    if (this.#hasSkip) returnAggRef = returnAggRef.skip(this.#skip);\n    if (this.#hasLimit) returnAggRef = returnAggRef.limit(this.#limit);\n\n    return returnAggRef;\n  }\n\n  #endHost() {\n    if (this.#hasWhere) {\n      // @ts-ignore\n      this.#host = this.#host.where(this.#where);\n    }\n\n    if (this.#hasSelect) {\n      // @ts-ignore\n      this.#host = this.#host.field(this.#select);\n    }\n\n    if (this.#hasOrder) {\n      objectEach(this.#order, (val, key) => {\n        // @ts-ignore\n        this.#host = this.#host.orderBy(key, val);\n      });\n    }\n\n    // @ts-ignore\n    if (this.#hasSkip) this.#host = this.#host.skip(this.#skip);\n\n    // @ts-ignore\n    if (this.#hasLimit) this.#host = this.#host.limit(this.#limit);\n    // @ts-ignore\n    else if (this.#hasWhereId) this.#host = this.#host.limit(1);\n  }\n\n  /**\n   * 执行查询操作\n   * @returns 查询结果\n   */\n  async query() {\n    let res: { data: DbQuery<T, S, R>[] };\n\n    // 关联查询\n    if (this.#hasLookup) {\n      const aggRef = this.aggregate();\n      this.#endAggregate(aggRef);\n      res = await aggRef.end();\n    }\n    // 单表查询\n    else {\n      this.#endHost();\n      res = await this.#host.get();\n    }\n\n    const rows = isArray(res.data) ? res.data : [res.data];\n    const { data } = parseDatabaseOutput(res);\n    return data;\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * @param ignoreMiss 是否忽略没有匹配到记录\n   * @returns 查询结果\n   */\n  async queryOne(): Promise<DbQuery<T, S, R>>;\n  async queryOne(ignoreMiss: false): Promise<DbQuery<T, S, R>>;\n  async queryOne(ignoreMiss: true): Promise<DbQuery<T, S, R> | undefined>;\n  async queryOne(ignoreMiss = false): Promise<DbQuery<T, S, R> | undefined> {\n    if (this.#hasLimit) throw new Error('db.queryOne() 方法不支持 limit 条件');\n    if (!this.#hasWhereId) this.limit(1);\n\n    const data = await this.query();\n    const res = data.at(0);\n\n    if (!ignoreMiss && !res) throw new Error('未找到匹配记录');\n    return res;\n  }\n\n  /**\n   * 获取匹配记录的数量\n   * @returns 记录总数\n   */\n  async count() {\n    if (this.#hasLookup) throw new Error('db.count() 方法不支持 lookup 聚合');\n    if (this.#hasSelect) throw new Error('db.count() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.count() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.count() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.count() 方法不支持 limit 条件');\n\n    this.#endHost();\n    const res = await this.#host.count();\n    const { total } = parseDatabaseOutput<{ total: number }>(res);\n    return total;\n  }\n\n  /**\n   * 创建新记录\n   * @param data 要创建的数据\n   * @returns 创建结果\n   */\n  async create(data: DbCreate<T>) {\n    if (this.#hasLookup) throw new Error('db.create() 方法不支持 lookup 聚合');\n    if (this.#hasWhere) throw new Error('db.create() 方法不支持 where 条件');\n    if (this.#hasSelect) throw new Error('db.create() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.create() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.create() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.create() 方法不支持 limit 条件');\n\n    this.#endHost();\n    const res = await this.#host.add(data);\n    const { id } = parseDatabaseOutput<{ id: string }>(res);\n    return id;\n  }\n\n  /**\n   * 更新记录\n   * @param data 要更新的数据\n   * @returns 更新结果\n   */\n  async update(data: AnyObject) {\n    if (this.#hasLookup) throw new Error('db.update() 方法不支持 lookup 聚合');\n    if (!this.#hasWhere) throw new Error('设置 where 条件后才能执行 db.update() 方法');\n    if (this.#hasSelect) throw new Error('db.update() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.update() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.update() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.update() 方法不支持 limit 条件');\n\n    if (this.#isTransaction && !this.#hasWhereId) throw new Error('事务模式下 db.update() 的 where 条件必须是 _id');\n\n    this.#endHost();\n    const res = await this.#host.update(data);\n    const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n    return updated;\n  }\n\n  /**\n   * 删除记录\n   * @returns 删除结果\n   */\n  async remove() {\n    if (this.#hasLookup) throw new Error('db.remove() 方法不支持 lookup 聚合');\n    if (!this.#hasWhere) throw new Error('设置 where 条件后才能执行 db.remove() 方法');\n    if (this.#hasSelect) throw new Error('db.remove() 方法不支持 select 条件');\n    if (this.#hasOrder) throw new Error('db.remove() 方法不支持 order 条件');\n    if (this.#hasSkip) throw new Error('db.remove() 方法不支持 skip 条件');\n    if (this.#hasLimit) throw new Error('db.remove() 方法不支持 limit 条件');\n\n    if (this.#isTransaction && !this.#hasWhereId) throw new Error('事务模式下 db.remove() 的 where 条件必须是 _id');\n\n    this.#endHost();\n    const res = await this.#host.remove();\n    const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n    return deleted;\n  }\n}\n\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport type DbProxy<T, S extends DbSelect<T> = {}, R extends AnyObject = {}> = Db<T, S, R> & {\n  _isProxy: true;\n};\n\n/**\n * 数据库操作对象\n */\nexport const db = {\n  /**\n   * 获取指定名称的数据库集合实例\n   * @param name 数据表名称\n   * @returns Db类实例，用于执行数据库操作\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  table<T, S extends DbSelect<T> = {}, R extends AnyObject = {}>(name: string) {\n    return new Proxy(\n      {},\n      {\n        get(target, prop) {\n          if (prop === '_isProxy') return true;\n\n          const table = new Db<T, S, R>({ table: name });\n          const tableProp = prop as keyof Db<T, S, R>;\n          const ref = table[tableProp];\n\n          return isFunction(ref) ? ref.bind(table) : ref;\n        },\n      },\n    ) as DbProxy<T>;\n  },\n};\n\n/**\n * 解析数据库执行结果\n * @param res 客户端、云端响应结果\n * @returns 处理后的结果\n */\nexport function parseDatabaseOutput<T>(res: UniClientDatabaseOutput<T> | UniCloudDatabaseOutput<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 UniClientDatabaseOutput<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\nfunction _toWhereMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({...})' : 'whereId(id)';\n}\n\nfunction _toWhereIdMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({ _id })' : 'whereId(id)';\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MaybeCallable } from '@cloudcome/utils-core/types';\nimport { Db, type DbCreate, type DbProxy, type DbQuery, type DbSelect, type DbUpdate, type DbWhere, db } from './db';\n\nexport type DbUpsertOptions<T, S extends DbSelect<T>, C extends DbCreate<T>, U extends DbUpdate<T>> = {\n  /** 查询条件 */\n  where: DbWhere<T>;\n\n  /** 查询返回字段 */\n  select?: S;\n\n  /** 创建数据 */\n  create: C;\n\n  /**\n   * 更新数据，可以是对象或根据查询结果生成更新对象的函数\n   * @param row 查询到的文档数据，仅在传入函数时可用\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  update: U | ((exist: DbQuery<T, S, {}>) => U);\n\n  /** 创建前回调函数 */\n  onBeforeCreate?: () => unknown;\n\n  /**\n   * 创建后回调函数\n   * @param id 创建的文档ID\n   */\n  onAfterCreate?: (id: string) => unknown;\n\n  /**\n   * 更新前回调函数\n   * @param exist 查询到的原始文档数据\n   * @returns 如果返回 false，则取消更新操作\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  onBeforeUpdate?: (exist: DbQuery<T, S, {}>) => false | unknown;\n\n  /**\n   * 更新后回调函数\n   * @param updateData 实际更新的数据\n   * @param exist 查询到的原始文档数据\n   */\n  // biome-ignore lint/complexity/noBannedTypes: <explanation>\n  onAfterUpdate?: (updateData: U, exist: DbQuery<T, S, {}>) => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDbInstance?: any;\n};\n\n/**\n * 数据库 upsert 操作的返回结果类型\n */\nexport type DbUpsertOutput = {\n  /** 操作的文档ID */\n  id: string;\n  /** 是否为创建操作 */\n  created: boolean;\n  /** 是否为更新操作 */\n  updated: boolean;\n};\n\nexport async function dbUpsert<T, S extends DbSelect<T>, C extends DbCreate<T>, U extends DbUpdate<T>>(\n  dbProxy: DbProxy<T>,\n  options: DbUpsertOptions<T, S, C, U>,\n): Promise<DbUpsertOutput> {\n  const {\n    where,\n    select = {},\n    create,\n    update,\n    onBeforeCreate,\n    onAfterCreate,\n    onBeforeUpdate,\n    onAfterUpdate,\n    _mockDbInstance,\n  } = options;\n\n  // @ts-ignore\n  if ('_id' in select) throw new Error('select 条件不能包含 _id 字段');\n\n  const _db = (_mockDbInstance || dbProxy) as DbProxy<T, S>;\n  const exist = (await _db\n    .where(where)\n    .select(select || {})\n    // biome-ignore lint/complexity/noBannedTypes: <explanation>\n    .queryOne(true)) as DbQuery<T, S, {}> | undefined;\n\n  if (exist) {\n    const skipUpdate = (await onBeforeUpdate?.(exist)) === false;\n\n    if (skipUpdate) {\n      // @ts-ignore\n      return { id: exist._id as string, updated: false, created: false };\n    }\n\n    const updateData = isFunction(update) ? update(exist) : update;\n    // @ts-ignore\n    const updated = await _db.whereId(exist._id).update(updateData);\n    onAfterUpdate?.(updateData, exist);\n\n    // @ts-ignore\n    return { id: exist._id as string, updated: true, created: false };\n  }\n\n  await onBeforeCreate?.();\n  const createdId = await _db.create(create);\n  await onAfterCreate?.(createdId);\n\n  return { id: createdId, updated: false, created: true };\n}\n\ntype _TransactionDb = {\n  startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n  commit: () => Promise<unknown>;\n  rollback: () => Promise<unknown>;\n};\n\ntype _WithTransaction = <T, S extends DbSelect<T>, R extends AnyObject>(table: DbProxy<T, S, R>) => Db<T, S, R>;\n\n/**\n * 在数据库事务中执行操作\n *\n * @template T - 事务操作返回值类型\n * @param transacting - 事务执行函数，接收事务数据库实例作为参数\n * @param _mockDatabase - 用于测试的模拟数据库对象\n * @param _mockDbInstance - 用于测试的模拟数据库实例\n * @returns 事务操作的返回结果\n *\n * @example\n * ```typescript\n * const result = await dbTransaction(async (withTransaction) => {\n *   const userId = await withTransaction(db.table('user')).create({ name: 'John' });\n *   const order = await withTransaction(db.table('orders')).create({ userId, amount: 100 });\n *   return { user, order };\n * });\n * ```\n */\nexport async function dbTransaction<K>(\n  transacting: (withTransaction: _WithTransaction) => Promise<K>,\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any,\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDbInstance?: any,\n) {\n  const transactionDb = (_mockDatabase || uniCloud.database()) as _TransactionDb;\n\n  const [err1, transaction] = await tryFlatten(transactionDb.startTransaction());\n  if (err1) throw err1;\n\n  const withTransaction = <T, S extends DbSelect<T>, R extends AnyObject>(dbProxy: DbProxy<T, S, R>) => {\n    return _mockDbInstance || new Db<T, S, R>({ table: dbProxy.table, transaction });\n  };\n\n  const [err2, result] = await tryFlatten(async () => {\n    const result = await transacting(withTransaction);\n    await transaction.commit();\n    return result;\n  });\n\n  if (err2) {\n    await tryFlatten(transaction.rollback());\n    throw err2;\n  }\n\n  return result as unknown as K;\n}\n"],"names":["result"],"mappings":"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"}

package/dist/index.cjs

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const VERSION = "1.7.1";
+const VERSION = "1.8.0";
 exports.VERSION = VERSION;
 //# sourceMappingURL=index.cjs.map

package/dist/index.mjs

@@ -1,4 +1,4 @@
-const VERSION = "1.7.1";
+const VERSION = "1.8.0";
 export {
   VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcome/utils-uni",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "cloudcome utils for uni-app",
   "engines": {
     "node": ">=22"
@@ -58,8 +58,8 @@
     "dist"
   ],
   "dependencies": {
-    "@cloudcome/utils-core": "~1.9.1",
-    "@cloudcome/utils-vue": "~1.9.6",
+    "@cloudcome/utils-core": "~1.9.2",
+    "@cloudcome/utils-vue": "~1.9.7",
     "@dcloudio/types": "^3.4.21",
     "@dcloudio/uni-app": "vue3",
     "vue": "^3.5.13",