@cloudcome/utils-uni 1.49.1 → 1.50.0

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

@@ -1,9 +1,10 @@
 export declare class DbBaseCommand {
-    private _command;
-    private _parameter;
+    protected _command: string;
+    protected _parameter: unknown;
     private _options?;
     protected _isQuery: boolean;
     protected _isMutate: boolean;
+    protected _isGroup: boolean;
     constructor(_command: string, _parameter: unknown, _options?: {
         formatParameter?: (db: UniCloud.Database) => unknown;
         rewriteValue?: (db: UniCloud.Database, parameter: unknown) => unknown;
@@ -21,3 +22,9 @@ export declare class DbQueryCommand extends DbBaseCommand {
 export declare class DbMutateCommand extends DbBaseCommand {
     protected _isMutate: boolean;
 }
+export declare class DbGroupCommand<T> extends DbBaseCommand {
+    protected _isGroup: boolean;
+    /** Phantom type marker - compile-time only, used by `group()`'s `infer T` to extract per-accumulator value types */
+    readonly __type: T;
+    toAggregate(): Record<string, unknown>;
+}

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

@@ -1,6 +1,6 @@
 import { UniError } from '../_types';
 import { AnyObject, MergeIntersection } from '@cloudcome/utils-core/types';
-import { DbQueryCommand } from './_command.class';
+import { DbGroupCommand, DbQueryCommand } from './_command.class';
 import { DbCreate, DbForeign, DbOrder, DbQuery, DbRelation, DbSelect, DbUpdate, DbWhere } from './types';
 export type DbOptions = {
     /**
@@ -141,14 +141,42 @@ export declare class Db<D1, S1 extends DbSelect<D1> = {}, D2 extends AnyObject =
     limit(limit: number): this;
     private _hasSample;
     private _sampleSize;
+    private _hasGroup;
+    private _group;
     /**
      * 随机从文档中选取指定数量的记录
      * @param size 要选取的记录数量，必须为正整数
      * @returns 当前Db实例，支持链式调用
      */
     sample(size: number): this;
+    /**
+     * 设置分组聚合条件
+     * @param field 分组字段，单个字段传入字段名，多个字段传入数组
+     * @param accumulators 累加器定义对象，value 使用 db.dbGroup 命令
+     * @returns 当前Db实例，支持链式调用
+     *
+     * @example
+     * ```typescript
+     * // 按单个字段分组计数
+     * .group('consecutiveDays', { count: db.dbGroup.sum(1) })
+     *
+     * // 按多字段组合分组求和
+     * .group(['year', 'month'], { total: db.dbGroup.sum('amount') })
+     * ```
+     */
+    group<const K extends keyof D1, const A extends Record<string, DbGroupCommand<any>>>(field: K | readonly K[], accumulators: A): Db<D1 & { [P in keyof A]: A[P] extends DbGroupCommand<infer T> ? T : unknown; }, {}, D2, W2>;
     private _hasLookup;
     get hasLookup(): boolean;
+    get dbGroup(): {
+        sum: (value: number | string) => DbGroupCommand<number>;
+        avg: (field: keyof D1 & string) => DbGroupCommand<number>;
+        min: <K extends keyof D1>(field: K) => DbGroupCommand<D1[K]>;
+        max: <K extends keyof D1>(field: K) => DbGroupCommand<D1[K]>;
+        push: <K extends keyof D1>(field: K) => DbGroupCommand<D1[K][]>;
+        addToSet: <K extends keyof D1>(field: K) => DbGroupCommand<D1[K][]>;
+        first: <K extends keyof D1>(field: K) => DbGroupCommand<D1[K]>;
+        last: <K extends keyof D1>(field: K) => DbGroupCommand<D1[K]>;
+    };
     private _lookups;
     lookup<FD1, FS1 extends DbSelect<FD1>, FD2 extends AnyObject, FW2 extends AnyObject, RL extends DbRelation, AS extends string, US extends boolean | undefined | void = undefined, LF extends keyof D1 & string = keyof D1 & string>(table: Db<FD1, FS1, FD2, FW2>, lookup: DbLookupOptions<RL, D1, FD1, AS, US, LF>): Db<D1, S1, US extends true ? D2 : MergeIntersection<D2 & DbForeign<D1, FD1, FS1, FD2, RL, AS, LF>>, MergeIntersection<W2 & Partial<Record<AS, DbQueryCommand>>>>;
     private _ending;

package/dist/database.cjs

@@ -11,6 +11,7 @@ var DbBaseCommand = class {
 	_options;
 	_isQuery = false;
 	_isMutate = false;
+	_isGroup = false;
 	constructor(_command, _parameter, _options) {
 		this._command = _command;
 		this._parameter = _parameter;
@@ -36,6 +37,13 @@ var DbQueryCommand = class extends DbBaseCommand {
 var DbMutateCommand = class extends DbBaseCommand {
 	_isMutate = true;
 };
+var DbGroupCommand = class extends DbBaseCommand {
+	_isGroup = true;
+	toAggregate() {
+		const value = typeof this._parameter === "string" ? `$${this._parameter}` : this._parameter;
+		return { [`$${this._command}`]: value };
+	}
+};
 //#endregion
 //#region src/database/command.ts
 /**
@@ -412,6 +420,8 @@ var Db = class Db {
 	}
 	_hasSample = 0;
 	_sampleSize = 0;
+	_hasGroup = 0;
+	_group = {};
 	/**
 	* 随机从文档中选取指定数量的记录
 	* @param size 要选取的记录数量，必须为正整数
@@ -425,10 +435,52 @@ var Db = class Db {
 		this._sampleSize = size;
 		return this;
 	}
+	/**
+	* 设置分组聚合条件
+	* @param field 分组字段，单个字段传入字段名，多个字段传入数组
+	* @param accumulators 累加器定义对象，value 使用 db.dbGroup 命令
+	* @returns 当前Db实例，支持链式调用
+	*
+	* @example
+	* ```typescript
+	* // 按单个字段分组计数
+	* .group('consecutiveDays', { count: db.dbGroup.sum(1) })
+	*
+	* // 按多字段组合分组求和
+	* .group(['year', 'month'], { total: db.dbGroup.sum('amount') })
+	* ```
+	*/
+	group(field, accumulators) {
+		if (this._isTransaction) throw new Error("db.group() 方法不支持事务模式");
+		if (this._hasGroup) throw new Error("db.group() 方法只能调用一次");
+		if (this._hasSelect) throw new Error("db.group() 方法不支持 select 条件");
+		if (this._hasSample) throw new Error("db.group() 方法不支持 sample 条件");
+		if (this._hasLookup) throw new Error("db.group() 方法不支持 lookup 关联查询");
+		this._hasGroup++;
+		const fieldArr = Array.isArray(field) ? field : [field];
+		const id = fieldArr.length === 1 ? `$${String(fieldArr[0])}` : Object.fromEntries(fieldArr.map((f) => [String(f), `$${String(f)}`]));
+		this._group = {
+			_id: id,
+			...accumulators
+		};
+		return this;
+	}
 	_hasLookup = 0;
 	get hasLookup() {
 		return this._hasLookup > 0;
 	}
+	get dbGroup() {
+		return {
+			sum: (value) => new DbGroupCommand("sum", value),
+			avg: (field) => new DbGroupCommand("avg", field),
+			min: (field) => new DbGroupCommand("min", String(field)),
+			max: (field) => new DbGroupCommand("max", String(field)),
+			push: (field) => new DbGroupCommand("push", String(field)),
+			addToSet: (field) => new DbGroupCommand("addToSet", String(field)),
+			first: (field) => new DbGroupCommand("first", String(field)),
+			last: (field) => new DbGroupCommand("last", String(field))
+		};
+	}
 	_lookups = [];
 	lookup(table, lookup) {
 		if (this._isTransaction) throw new Error("db.lookup() 方法不支持事务模式");
@@ -479,6 +531,7 @@ var Db = class Db {
 			this._lookupAs[as] = true;
 		}
 		if (this._hasWhere) returnAggRef = returnAggRef.match(_mapCommandRaw(this._where));
+		if (this._hasGroup) returnAggRef = returnAggRef.group(_mapGroupRaw(this._group));
 		if (this._hasSample) returnAggRef = returnAggRef.sample({ size: this._sampleSize });
 		if (this._hasOrder) returnAggRef = returnAggRef.sort((0, _cloudcome_utils_core_object.objectMap)(this._order, (v) => v === "asc" ? 1 : -1));
 		if (this._hasSkip) returnAggRef = returnAggRef.skip(this._skip);
@@ -539,8 +592,8 @@ var Db = class Db {
 	async many() {
 		try {
 			let res;
-			if (this._isTransaction && (this._hasLookup || this._hasSample)) throw new Error("事务模式下不支持 lookup 聚合或 sample 取样查询");
-			if (this._hasLookup || this._hasSample) {
+			if (this._isTransaction && (this._hasLookup || this._hasSample || this._hasGroup)) throw new Error("事务模式下不支持 lookup 聚合、sample 取样或 group 分组查询");
+			if (this._hasLookup || this._hasSample || this._hasGroup) {
 				let aggRef = this._createAggregate();
 				aggRef = this._endAggregate(aggRef);
 				res = await aggRef.end();
@@ -562,7 +615,7 @@ var Db = class Db {
 	*/
 	async firstOrThrow() {
 		if (this._hasLimit) throw new Error("db.firstOrThrow() 方法不支持 limit 条件");
-		if (!this._hasWhereId && !this._hasSample) this.limit(1);
+		if (!this._hasWhereId && !this._hasSample && !this._hasGroup) this.limit(1);
 		const res = (await this.many()).at(0);
 		if (!res) throw require_cloud.createCloudObjectError("查询数据为空", "firstOrThrow");
 		return res;
@@ -574,7 +627,7 @@ var Db = class Db {
 	*/
 	async firstOrNull() {
 		if (this._hasLimit) throw new Error("db.firstOrNull() 方法不支持 limit 条件");
-		if (!this._hasWhereId && !this._hasSample) this.limit(1);
+		if (!this._hasWhereId && !this._hasSample && !this._hasGroup) this.limit(1);
 		return (await this.many()).at(0) || null;
 	}
 	/**
@@ -585,6 +638,7 @@ var Db = class Db {
 		if (this._isTransaction) throw new Error("db.count() 方法不支持事务模式");
 		if (this._hasSample) throw new Error("db.count() 方法不支持 sample 取样");
 		if (this._hasLookup) throw new Error("db.count() 方法不支持 lookup 聚合");
+		if (this._hasGroup) throw new Error("db.count() 方法不支持 group 分组");
 		if (this._hasSelect) throw new Error("db.count() 方法不支持 select 条件");
 		if (this._hasOrder) throw new Error("db.count() 方法不支持 order 条件");
 		if (this._hasSkip) throw new Error("db.count() 方法不支持 skip 条件");
@@ -605,6 +659,7 @@ var Db = class Db {
 	*/
 	async create(data) {
 		if (this._hasLookup) throw new Error("db.create() 方法不支持 lookup 聚合");
+		if (this._hasGroup) throw new Error("db.create() 方法不支持 group 分组");
 		if (this._hasWhere) throw new Error("db.create() 方法不支持 where 条件");
 		if (this._hasSelect) throw new Error("db.create() 方法不支持 select 条件");
 		if (this._hasOrder) throw new Error("db.create() 方法不支持 order 条件");
@@ -626,6 +681,7 @@ var Db = class Db {
 	*/
 	async update(data) {
 		if (this._hasLookup) throw new Error("db.update() 方法不支持 lookup 聚合");
+		if (this._hasGroup) throw new Error("db.update() 方法不支持 group 分组");
 		if (!this._hasWhere) throw new Error("设置 where 条件后才能执行 db.update() 方法");
 		if (this._hasSelect) throw new Error("db.update() 方法不支持 select 条件");
 		if (this._hasOrder) throw new Error("db.update() 方法不支持 order 条件");
@@ -647,6 +703,7 @@ var Db = class Db {
 	*/
 	async remove() {
 		if (this._hasLookup) throw new Error("db.remove() 方法不支持 lookup 聚合");
+		if (this._hasGroup) throw new Error("db.remove() 方法不支持 group 分组");
 		if (!this._hasWhere) throw new Error("设置 where 条件后才能执行 db.remove() 方法");
 		if (this._hasSelect) throw new Error("db.remove() 方法不支持 select 条件");
 		if (this._hasOrder) throw new Error("db.remove() 方法不支持 order 条件");
@@ -671,6 +728,12 @@ function _mapCommandRaw(data) {
 	};
 	return (0, _cloudcome_utils_core_object.objectMap)(data, map);
 }
+function _mapGroupRaw(group) {
+	const result = {};
+	for (const [key, value] of Object.entries(group)) if (value instanceof DbGroupCommand) result[key] = value.toAggregate();
+	else result[key] = value;
+	return result;
+}
 function _mapOrderSelect(order) {
 	return (0, _cloudcome_utils_core_object.objectMap)(order, (_val, _key) => true);
 }

package/dist/database.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"database.cjs","names":[],"sources":["../src/database/_command.class.ts","../src/database/command.ts","../src/database/each.ts","../src/database/error.ts","../src/database/paging.ts","../src/database/_db.class.ts","../src/database/proxy.ts","../src/database/transaction.ts","../src/database/upsert.ts","../src/database/unique.ts"],"sourcesContent":["// 设置私有属性和静态方法是避免在 update 的时候提示类属性\n\nexport class DbBaseCommand {\n  protected _isQuery = false;\n  protected _isMutate = false;\n\n  constructor(\n    private _command: string,\n    private _parameter: unknown,\n    private _options?: {\n      formatParameter?: (db: UniCloud.Database) => unknown;\n      rewriteValue?: (db: UniCloud.Database, parameter: unknown) => unknown;\n    },\n  ) {}\n\n  static getValue(cmd: DbBaseCommand, db: UniCloud.Database) {\n    if (cmd._options?.rewriteValue) {\n      return cmd._options.rewriteValue(db, cmd._parameter);\n    }\n\n    return (db.command as unknown as Record<string, (value: unknown) => unknown>)[cmd._command].call(\n      db.command,\n      cmd._options?.formatParameter?.(db) || cmd._parameter,\n    );\n  }\n\n  static getExpression(cmd: DbBaseCommand, fieldName: string) {\n    return {\n      [`$${cmd._command}`]: [fieldName, cmd._parameter],\n    };\n  }\n\n  static isQueryCommand(cmd: DbBaseCommand) {\n    return cmd._isQuery;\n  }\n\n  static isMutateCommand(cmd: DbBaseCommand) {\n    return cmd._isMutate;\n  }\n}\n\nexport class DbQueryCommand extends DbBaseCommand {\n  protected _isQuery = true;\n}\n\nexport class DbMutateCommand extends DbBaseCommand {\n  protected _isMutate = true;\n}\n","import { DbBaseCommand, DbMutateCommand, DbQueryCommand } from './_command.class';\n\n/**\n * 数据库查询命令对象，提供各种查询操作符\n */\nexport const dbQuery = {\n  /**\n   * 等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  eq: (value: unknown) => new DbQueryCommand('eq', value),\n\n  /**\n   * 不等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  neq: (value: unknown) => new DbQueryCommand('neq', value),\n\n  /**\n   * 大于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  gt: (value: unknown) => new DbQueryCommand('gt', value),\n\n  /**\n   * 大于等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  gte: (value: unknown) => new DbQueryCommand('gte', value),\n\n  /**\n   * 小于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  lt: (value: unknown) => new DbQueryCommand('lt', value),\n\n  /**\n   * 小于等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  lte: (value: unknown) => new DbQueryCommand('lte', value),\n\n  /**\n   * 包含在数组中操作符\n   * @param value 值数组\n   * @returns DbQueryCommand 查询命令对象\n   */\n  in: (value: unknown[]) => new DbQueryCommand('in', value),\n\n  /**\n   * 不包含在数组中操作符\n   * @param value 值数组\n   * @returns DbQueryCommand 查询命令对象\n   */\n  nin: (value: unknown[]) => new DbQueryCommand('nin', value),\n\n  /**\n   * 数组长度匹配操作符\n   * @param size 数组长度\n   * @returns DbQueryCommand 查询命令对象\n   */\n  size: (size: number) => new DbQueryCommand('size', size),\n\n  /**\n   * 正则表达式匹配操作符\n   * @param regExp 正则表达式\n   * @returns DbQueryCommand 查询命令对象\n   */\n  regExp: (regExp: RegExp) =>\n    new DbQueryCommand('regExp', regExp, {\n      rewriteValue: (_db, parameter) => parameter,\n    }),\n\n  /**\n   * 逻辑与操作符\n   * @param conditions 查询条件参数\n   * @returns DbQueryCommand 查询命令对象\n   */\n  and: (conditions: DbQueryCommand[]) =>\n    new DbQueryCommand('and', conditions, {\n      formatParameter: (db) => conditions.map((c) => DbBaseCommand.getValue(c, db)),\n    }),\n\n  /**\n   * 逻辑或操作符\n   * @param conditions 查询条件参数\n   * @returns DbQueryCommand 查询命令对象\n   */\n  or: (conditions: DbQueryCommand[]) =>\n    new DbQueryCommand('or', conditions, {\n      formatParameter: (db) => conditions.map((c) => DbBaseCommand.getValue(c, db)),\n    }),\n};\n\n/**\n * 数据库变更命令对象，提供各种数据更新操作符\n */\nexport const dbMutate = {\n  /**\n   * 数值增加操作符\n   * @param value 增加的数值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  inc: (value: number) => new DbMutateCommand('inc', value),\n\n  /**\n   * 数值乘法操作符\n   * @param value 乘数\n   * @returns DbMutateCommand 变更命令对象\n   */\n  mul: (value: number) => new DbMutateCommand('mul', value),\n\n  /**\n   * 设置字段值操作符\n   * @param value 设置的值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  set: (value: unknown) => new DbMutateCommand('set', value),\n\n  /**\n   * 向数组末尾添加元素操作符\n   * @param value 添加的值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  push: (value: unknown) => new DbMutateCommand('push', value),\n\n  /**\n   * 向数组开头添加元素操作符\n   * @param value 添加的值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  unshift: (value: unknown) => new DbMutateCommand('unshift', value),\n\n  /**\n   * 从数组末尾移除元素操作符\n   * @returns DbMutateCommand 变更命令对象\n   */\n  pop: () => new DbMutateCommand('pop', undefined),\n\n  /**\n   * 从数组开头移除元素操作符\n   * @returns DbMutateCommand 变更命令对象\n   */\n  shift: () => new DbMutateCommand('shift', undefined),\n\n  /**\n   * 移除字段操作符\n   * @returns DbMutateCommand 变更命令对象\n   */\n  remove: () => new DbMutateCommand('remove', undefined),\n};\n","import type { Db } from './_db.class';\nimport type { DbWhere } from './types';\n\n/**\n * 遍历表中的每一行数据并执行回调函数\n *\n * 采用分批查询策略，每批查询 100 条记录，通过 skip/limit 实现分页遍历，\n * 避免一次性加载大量数据导致内存溢出。\n *\n * 迭代器按顺序串行执行，即每一行数据的迭代器完成后才会处理下一行。\n *\n * @template T - 数据行类型\n * @param table 数据库表代理对象\n * @param where 查询条件\n * @param iterator 对每一行数据执行的异步迭代器函数\n * @param maxCount 最大遍历数量，默认值为 Number.MAX_SAFE_INTEGER。\n *   注意：由于分批查询机制（每批 100 条），实际遍历的行数可能略大于 maxCount，\n *   例如 maxCount=150 时，会分两批查询（0-99、100-199），实际遍历 200 行。\n * @example\n * ```ts\n * // 遍历所有状态为 active 的用户\n * await dbEach(userTable, { status: 'active' }, async (user) => {\n *   await sendEmail(user.email);\n * });\n *\n * // 限制最多遍历 500 条记录\n * await dbEach(orderTable, { status: 'pending' }, async (order) => {\n *   await processOrder(order);\n * }, 500);\n * ```\n */\nexport async function dbEach<T>(\n  table: Db<T>,\n  where: DbWhere<T>,\n  iterator: (row: T) => Promise<unknown>,\n  maxCount = Number.MAX_SAFE_INTEGER,\n) {\n  const count = Math.min(await table.where(where).count(), maxCount);\n  const limit = 100;\n\n  for (let skip = 0; skip < count; skip += limit) {\n    const rows = await table.where(where).limit(limit).skip(skip).many();\n\n    for (const row of rows) {\n      await iterator(row as T);\n    }\n  }\n}\n","/**\n * 数据库底层异常类\n * 当 uniCloud 数据库操作抛出错误时，统一包装为该异常\n */\nexport class DbError extends Error {\n  /** 原始错误码，如 'InternalServerError' */\n  errCode: string | number;\n  /** MongoDB 错误码，如 'E11000'。不匹配则为空字符串 */\n  dbCode: string;\n\n  constructor(message: string, extra: { errCode: string | number; dbCode: string }) {\n    super(message);\n    this.name = 'DbError';\n    this.errCode = extra.errCode;\n    this.dbCode = extra.dbCode;\n  }\n}\n\n/**\n * 判断错误是否为数据库底层错误\n * @param err - 任意错误对象\n * @returns 是否为 DbError\n */\nexport function isDbError(err: unknown): err is DbError {\n  return err instanceof DbError;\n}\n\n/**\n * 从 MongoDB 错误消息中提取错误码\n * @param errMsg - 错误消息字符串，如 'E11000 duplicate key error...'\n * @returns MongoDB 错误码，如 'E11000'\n */\nexport function extractMongoCode(errMsg: string): string {\n  const m = errMsg.match(/^E\\d+/);\n  return m ? m[0] : '';\n}\n","import type { AnyObject } from '@cloudcome/utils-core/types';\nimport type { Db } from './_db.class';\nimport type { DbSelect } from './types';\n\n/**\n * 数据库分页查询函数\n * @template T - 数据类型\n * @param queryDb - 数据库查询实例\n * @returns 包含数据列表和总数的对象\n */\n\nexport async function dbPaging<\n  D1,\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  S1 extends DbSelect<D1> = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  D2 extends AnyObject = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  W2 extends AnyObject = {},\n>(queryDb: Db<D1, S1, D2, W2>) {\n  // 获取原始查询条件，不包映射字段\n  const where = queryDb.getWhere(true);\n\n  // 克隆查询实例用于统计总数，避免影响原查询\n  const countDb = queryDb.clone();\n\n  // 执行查询获取数据列表\n  const list = await queryDb.many();\n\n  // 基于相同查询条件统计总数\n  const total = await countDb.where(where).count();\n\n  // 返回分页结果\n  return {\n    list,\n    total,\n  };\n}\n","import { isUniError, parseDatabaseOutput } from '@/_helpers';\nimport type { UniError } from '@/_types';\nimport { createCloudObjectError } from '@/cloud';\nimport { objectEach, objectFilter, objectMap, objectOmit } from '@cloudcome/utils-core/object';\nimport { isArray, isObject } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MergeIntersection } from '@cloudcome/utils-core/types';\nimport { DbBaseCommand, type DbQueryCommand } from './_command.class';\nimport { DbError, extractMongoCode } from './error';\nimport type { DbCreate, DbForeign, DbOrder, DbQuery, DbRelation, DbSelect, DbUpdate, DbWhere } from './types';\n\n/**\n * 数据库聚合操作符命令\n */\nconst dbAgg = uniCloud.database().command.aggregate as UniCloud.AggregateCommand & {\n  pipeline: () => UniCloud.AggregateReference & {\n    done: () => unknown;\n  };\n};\n\nconst db0 = uniCloud.database();\n\nexport type DbOptions = {\n  /**\n   * 数据表名称\n   */\n  table: string;\n\n  /**\n   * 事务对象，用于事务操作\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n  transaction?: any;\n\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n  _mockDatabase?: any;\n\n  /**\n   * 自定义错误处理函数\n   * @param error unknown 数据库异常对象\n   * @returns 自定义错误对象\n   */\n  parseError?: (error: unknown) => UniError;\n};\n\nexport type DbLookupOptions<\n  RL extends DbRelation,\n  D1,\n  FD1,\n  AS,\n  // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n  US extends boolean | undefined | void = undefined,\n  LF extends keyof D1 & string = keyof D1 & string,\n> = {\n  /**\n   * 关联类型\n   */\n  relation: RL;\n\n  /**\n   * 主表字段\n   */\n  localField: LF;\n\n  /**\n   * 关联表字段\n   */\n  foreignField: keyof FD1 & string;\n\n  /**\n   * 关联数据在结果中的字段名\n   */\n  as: AS;\n\n  /**\n   * 是否取消筛选关联数据\n   */\n  unselect?: US;\n};\n\nexport type DbLookup = DbLookupOptions<\n  // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n  any,\n  unknown,\n  unknown,\n  string,\n  boolean\n> & {\n  /**\n   * 关联表\n   */\n  table: Db<unknown>;\n};\n\nlet gid = 0;\n\n/**\n * 数据库类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @template D2 - 副表数据\n * @template W2 - 副表查询\n */\nexport class Db<\n  D1,\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  S1 extends DbSelect<D1> = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  D2 extends AnyObject = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  W2 extends AnyObject = {},\n> {\n  /**\n   * 是否为事务环境\n   * - 更新条件只能是 id\n   * - 删除条件只能是 id\n   */\n  private _isTransaction = false;\n\n  private _options: DbOptions;\n\n  /**\n   * 构造函数，初始化数据库集合引用\n   * @param collection 数据表名称\n   * @param _mockDatabase 模拟数据库，用于单元测试\n   */\n  constructor(options: DbOptions) {\n    this._options = options;\n    // hostRef =\n    //   options._mockDatabase || options.transaction?.collection(options.table) || db0.collection(options.table);\n    this._isTransaction = !!options.transaction;\n  }\n\n  /**\n   * 创建一个新的数据库实例，可选是否移除事务\n   * @param withoutTransaction 是否移除事务，默认 false\n   * @returns 新的数据库实例\n   */\n  clone(withoutTransaction?: boolean) {\n    return new Db({\n      ...this._options,\n      transaction: withoutTransaction ? null : this._options.transaction,\n    });\n  }\n\n  get table() {\n    return this._options.table;\n  }\n\n  get options() {\n    return this._options;\n  }\n\n  get isTransaction() {\n    return this._isTransaction;\n  }\n\n  _createHost(withoutTransaction?: boolean) {\n    const options = this._options;\n    return (\n      options._mockDatabase ||\n      (withoutTransaction ? null : options.transaction?.collection(options.table) || db0.collection(options.table))\n    );\n  }\n\n  /**\n   * 获取聚合操作实例\n   * @returns 聚合操作实例\n   */\n  _createAggregate() {\n    const host = this._createHost();\n    return host.aggregate();\n  }\n\n  private _hasWhere = false;\n  private _hasWhereId = false;\n  private _where = {};\n\n  /**\n   * 设置查询条件\n   * @param where 查询条件对象\n   * @returns 当前Db实例，支持链式调用\n   */\n  where(where: DbWhere<D1> & W2) {\n    if (this._isTransaction) throw new Error('事务模式下请使用 whereId() 方法');\n    if (this._hasWhere) throw new Error('已调用过一次 db.where({...}) 或 db.whereId(id) 了');\n\n    // 过滤掉值为 undefined 的键值对，数据库不支持查询全 undefined 值\n    const realWhere = objectFilter(where, (value) => value !== undefined);\n\n    this._hasWhere = true;\n    this._where = realWhere;\n\n    return this;\n  }\n\n  /**\n   * 获取当前查询条件\n   * @param plain 是否返回原始查询条件对象，默认 false\n   * @returns 当前查询条件对象\n   */\n  getWhere(plain?: boolean) {\n    return plain\n      ? // biome-ignore lint/suspicious/noTsIgnore: 必须这么用\n        // @ts-ignore\n        objectOmit(this._where, Object.keys(this._lookupAs))\n      : this._where;\n  }\n\n  /**\n   * 根据ID设置查询条件\n   * @param id 记录ID\n   * @returns 当前Db实例，支持链式调用\n   */\n  whereId(id: string | number) {\n    if (this._hasWhere) throw new Error('已调用过一次 db.where({...}) 或 db.whereId(id) 了');\n    if (this._hasLimit) throw new Error('db.whereId(id) 方法不能与 db.limit() 方法同时调用');\n\n    this._hasWhere = true;\n    this._hasWhereId = true;\n    this._where = { _id: id };\n\n    return this;\n  }\n\n  private _hasSelect = 0;\n  private _select = {};\n\n  /**\n   * 指定要返回的字段\n   * @param fields 要返回的字段对象，true表示返回，false表示不返回\n   * @returns 当前Db实例，支持链式调用\n   */\n  select<const S extends DbSelect<D1>>(fields: S) {\n    if (this._hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n    this._hasSelect++;\n    this._select = fields;\n\n    return this as Db<D1, S, D2, W2>;\n  }\n\n  private _hasOrder = 0;\n  private _order = {};\n\n  /**\n   * 设置排序规则\n   * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n   * @returns 当前Db实例，支持链式调用\n   */\n  order(order: DbOrder<D1>) {\n    if (this._isTransaction) throw new Error('db.order() 方法不支持事务模式');\n\n    this._hasOrder++;\n    this._order = order;\n\n    return this;\n  }\n\n  private _hasSkip = 0;\n  private _skip = 0;\n\n  /**\n   * 跳过指定数量的记录\n   * @param skip 要跳过的记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  skip(skip: number) {\n    if (this._isTransaction) throw new Error('db.skip() 方法不支持事务模式');\n    if (this._hasSkip) throw new Error('db.skip() 方法只能调用一次');\n\n    this._hasSkip++;\n    this._skip = skip;\n\n    return this;\n  }\n\n  private _hasLimit = 0;\n  private _limit = 0;\n\n  /**\n   * 限制返回的记录数量\n   * @param limit 最大返回记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  limit(limit: number) {\n    if (this._isTransaction) throw new Error('db.limit() 方法不支持事务模式');\n    if (this._hasLimit) throw new Error('db.limit() 方法只能调用一次');\n    if (this._hasSample) throw new Error('db.limit() 方法不支持 sample 条件');\n\n    if (this._hasWhereId) {\n      throw new Error('db.limit() 方法不能与 db.whereId(id) 方法同时调用');\n    }\n\n    this._hasLimit++;\n    this._limit = limit;\n\n    return this;\n  }\n\n  private _hasSample = 0;\n  private _sampleSize = 0;\n\n  /**\n   * 随机从文档中选取指定数量的记录\n   * @param size 要选取的记录数量，必须为正整数\n   * @returns 当前Db实例，支持链式调用\n   */\n  sample(size: number) {\n    if (this._isTransaction) throw new Error('db.sample() 方法不支持事务模式');\n    if (this._hasSample) throw new Error('db.sample() 方法只能调用一次');\n    if (this._hasLimit) throw new Error('db.sample() 方法不支持 limit 条件');\n\n    this._hasSample++;\n    this._sampleSize = size;\n\n    return this;\n  }\n\n  private _hasLookup = 0;\n  get hasLookup() {\n    return this._hasLookup > 0;\n  }\n\n  private _lookups: DbLookup[] = [];\n  lookup<\n    FD1,\n    FS1 extends DbSelect<FD1>,\n    FD2 extends AnyObject,\n    FW2 extends AnyObject,\n    RL extends DbRelation,\n    AS extends string,\n    // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n    US extends boolean | undefined | void = undefined,\n    LF extends keyof D1 & string = keyof D1 & string,\n  >(table: Db<FD1, FS1, FD2, FW2>, lookup: DbLookupOptions<RL, D1, FD1, AS, US, LF>) {\n    if (this._isTransaction) throw new Error('db.lookup() 方法不支持事务模式');\n\n    // 对方表也记为关联查询，避免做表更新操作\n    table._hasLookup++;\n    this._hasLookup++;\n    this._lookups.push({\n      ...lookup,\n      table,\n    } as unknown as DbLookup);\n\n    // @ts-expect-error\n    return this as Db<\n      D1,\n      S1,\n      US extends true ? D2 : MergeIntersection<D2 & DbForeign<D1, FD1, FS1, FD2, RL, AS, LF>>,\n      MergeIntersection<W2 & Partial<Record<AS, DbQueryCommand>>>\n    >;\n  }\n\n  private _ending = false;\n\n  private _aggregated = false;\n  private _lookupAs = {} as Record<string, true>;\n  private _endAggregate(aggRef: UniCloud.AggregateReference) {\n    if (this._aggregated) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n    if (this._ending) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n\n    this._ending = true;\n    this._aggregated = true;\n    let returnAggRef = aggRef;\n    let _hasAggSelect = 0;\n    const aggSelect = {} as Record<string, true>;\n    let hasAggUnselect = 0;\n    const aggUnselect = {} as Record<string, false>;\n\n    // 后做关联查询\n    for (const { relation: type, as, foreignField, localField, table, unselect } of this._lookups) {\n      const letName = `let${gid++}`;\n      let pipeline = dbAgg.pipeline();\n\n      // 关联条件\n      // @ts-expect-error\n      pipeline = pipeline.match({\n        $expr: {\n          $and: [\n            type === 'n:1'\n              ? { $in: [`$${foreignField}`, `$$${letName}`] }\n              : { $eq: [`$${foreignField}`, `$$${letName}`] },\n          ],\n        },\n      });\n\n      // 其他查询条件\n      // @ts-expect-error\n      pipeline = table._endAggregate(pipeline);\n\n      // @ts-expect-error\n      pipeline = pipeline.done();\n\n      returnAggRef = returnAggRef.lookup({\n        let: {\n          [letName]: `$${localField}`,\n        },\n        as,\n        from: table.table,\n        pipeline,\n      });\n\n      // 1对1，展开数组\n      if (type === '1:1') {\n        // @ts-expect-error\n        returnAggRef = returnAggRef.unwind({\n          path: `$${as}`,\n          preserveNullAndEmptyArrays: true,\n        });\n      }\n\n      if (unselect) {\n        hasAggUnselect++;\n        aggUnselect[as] = false;\n      } else {\n        _hasAggSelect++;\n        aggSelect[as] = true;\n      }\n\n      this._lookupAs[as] = true;\n    }\n\n    // 主表查询，注意顺序，筛选->排序->跳过->限制\n    if (this._hasWhere) returnAggRef = returnAggRef.match(_mapCommandRaw(this._where));\n    if (this._hasSample) returnAggRef = returnAggRef.sample({ size: this._sampleSize });\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    // 如果主表有选择字段，则合并选择字段（包括关联查询的字段和排序字段）\n    if (this._hasSelect) {\n      returnAggRef = returnAggRef.project(_mergeSelect({ ...this._select, ...aggSelect }, this._order));\n    }\n    // 如果主表没有选择字段，则排除取消选择字段\n    else if (hasAggUnselect) {\n      returnAggRef = returnAggRef.project(aggUnselect);\n    }\n\n    return returnAggRef;\n  }\n\n  private _endHost(host: UniCloud.CollectionReference, action: 'query' | 'create' | 'update' | 'remove' | 'count') {\n    if (this._ending) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n    this._ending = true;\n\n    // 事务模式下：查询/更新/删除必须使用 whereId\n    if (\n      this._isTransaction &&\n      (action === 'query' || action === 'update' || action === 'remove') &&\n      !this._hasWhereId\n    ) {\n      throw new Error('事务模式下查询/更新/删除条件只能是 ID，请使用 whereId() 方法');\n    }\n\n    let hostRef = host;\n    if (this._hasWhere) {\n      // 事务模式下：更新/删除/查询只能用 doc(id)\n      if (this._isTransaction && (action === 'update' || action === 'remove' || action === 'query')) {\n        // @ts-expect-error\n        hostRef = hostRef.doc(this._where._id);\n      } else {\n        // @ts-expect-error\n        hostRef = hostRef.where(_mapCommandRaw(this._where));\n      }\n    }\n\n    if (this._hasSelect) {\n      // @ts-expect-error\n      hostRef = hostRef.field(_mergeSelect(this._select, this._order));\n    }\n\n    if (this._hasOrder) {\n      objectEach(this._order, (val, key) => {\n        // @ts-expect-error\n        hostRef = hostRef.orderBy(key, val);\n      });\n    }\n\n    // @ts-expect-error\n    if (this._hasSkip) hostRef = hostRef.skip(this._skip);\n\n    if (this._hasLimit && action === 'query')\n      // @ts-expect-error\n      hostRef = hostRef.limit(this._limit);\n    else if (this._hasWhereId && action === 'query' && !this._isTransaction)\n      // @ts-expect-error\n      hostRef = hostRef.limit(1);\n\n    return hostRef;\n  }\n\n  /**\n   * 将 uniCloud 数据库原始错误包装为 DbError\n   * @param err - 原始错误对象，来自 uniCloud DB 操作（Error 实例，含 errMsg、errCode 属性）\n   * @returns DbError 实例\n   */\n  private _parseDbError(err: UniError) {\n    const errCode = err.errCode || '';\n    const message = err.errMsg || err.message;\n    const dbCode = extractMongoCode(err.errMsg || err.message);\n\n    if (dbCode) {\n      return new DbError(message, {\n        errCode: errCode,\n        dbCode: dbCode,\n      });\n    } else {\n      return err;\n    }\n  }\n\n  /**\n   * 统一处理 DB 操作抛出的错误\n   * - uniCloud 数据库错误（含 errMsg）→ 包装为 DbError → 经 parseError 回调后抛出\n   * - 非数据库错误（如网络中断）→ 原样抛出\n   */\n  private _handleDbError(err: unknown): never {\n    if (isUniError(err)) {\n      const dbErr = this._parseDbError(err);\n      throw this._options.parseError?.(dbErr) || dbErr;\n    } else {\n      throw this._options.parseError?.(err) || err;\n    }\n  }\n\n  /**\n   * 执行查询操作\n   * @returns 查询结果\n   */\n  async many() {\n    try {\n      let res: { data: DbQuery<D1, S1, D2>[] | DbQuery<D1, S1, D2> | undefined };\n\n      // 事务模式下不支持聚合查询\n      if (this._isTransaction && (this._hasLookup || this._hasSample)) {\n        throw new Error('事务模式下不支持 lookup 聚合或 sample 取样查询');\n      }\n\n      // 关联查询 / sample 查询（sample 依赖聚合管线）\n      if (this._hasLookup || this._hasSample) {\n        let aggRef = this._createAggregate();\n        aggRef = this._endAggregate(aggRef);\n        res = await aggRef.end();\n      }\n      // 单表查询\n      else {\n        let hostRef = this._createHost();\n        hostRef = this._endHost(hostRef, 'query');\n        res = await hostRef.get();\n      }\n\n      const { data } = parseDatabaseOutput(res);\n\n      // doc(id).get() 返回单个对象或 undefined，需包装为数组以统一 many() 返回值\n      return isArray(data) ? data : data ? [data] : [];\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * 如果没有匹配到记录，会抛出错误\n   * @returns 查询结果\n   */\n  async firstOrThrow(): Promise<DbQuery<D1, S1, D2>> {\n    if (this._hasLimit) throw new Error('db.firstOrThrow() 方法不支持 limit 条件');\n    if (!this._hasWhereId && !this._hasSample) this.limit(1);\n\n    const data = await this.many();\n    const res = data.at(0);\n\n    if (!res) throw createCloudObjectError('查询数据为空', 'firstOrThrow');\n    return res;\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * 如果没有匹配到记录，返回 null\n   * @returns 查询结果或 null\n   */\n  async firstOrNull(): Promise<DbQuery<D1, S1, D2> | null> {\n    if (this._hasLimit) throw new Error('db.firstOrNull() 方法不支持 limit 条件');\n    if (!this._hasWhereId && !this._hasSample) this.limit(1);\n\n    const data = await this.many();\n    return data.at(0) || null;\n  }\n\n  /**\n   * 获取匹配记录的数量\n   * @returns 记录总数\n   */\n  async count() {\n    if (this._isTransaction) throw new Error('db.count() 方法不支持事务模式');\n    if (this._hasSample) throw new Error('db.count() 方法不支持 sample 取样');\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'count');\n      const res = await hostRef.count();\n      const { total } = parseDatabaseOutput<{ total: number }>(res);\n      return total;\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n\n  /**\n   * 创建新记录\n   * @param data 要创建的数据\n   * @returns 创建结果\n   */\n  async create(data: DbCreate<D1>) {\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'create');\n      const res = await hostRef.add(data);\n      const { id } = parseDatabaseOutput<{ id: string }>(res);\n      return id;\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n\n  /**\n   * 更新记录\n   * @param data 要更新的数据\n   * @returns 更新结果\n   */\n  async update(data: DbUpdate<D1>) {\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'update');\n      const res = await hostRef.update(objectOmit(_mapCommandRaw(data), ['_id']));\n      const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n      return updated;\n    } catch (err) {\n      this._handleDbError(err);\n    }\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'remove');\n      const res = await hostRef.remove();\n      const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n      return deleted;\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: 必须这么用\nfunction _mapCommandRaw(data: any) {\n  // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n  const map = (val: any): any => {\n    if (!isObject(val)) return val;\n    if (val instanceof DbBaseCommand) return DbBaseCommand.getValue(val, db0);\n    return objectMap(val, map);\n  };\n\n  return objectMap(data, map);\n}\n\nfunction _mapOrderSelect(order: DbOrder<unknown>) {\n  return objectMap(order, (_val, _key) => true);\n}\n\nfunction _mergeSelect(select: DbSelect<unknown>, order: DbOrder<unknown>) {\n  const noSelect = Object.keys(select).length === 0;\n  // 如果没有 select 条件，默认返回所有字段\n  if (noSelect) return select;\n\n  const onlyOmitId = Object.keys(select).length === 1 && '_id' in select && select._id === false;\n  // 如果只排除 _id 字段，则保持现状\n  if (onlyOmitId) return select;\n\n  return {\n    ...select,\n    ..._mapOrderSelect(order),\n  };\n}\n","import { isFunction } from '@cloudcome/utils-core/type';\nimport { Db } from './_db.class';\nimport type { DbSelect } from './types';\nimport type { UniError } from '@/_types';\n\nexport type DbProxyOptions = {\n  /**\n   * 自定义错误处理函数\n   * @param error unknown 数据库异常对象\n   * @returns 自定义错误对象\n   */\n  parseError?: (error: unknown) => UniError;\n};\n\n/**\n * 创建一个数据库代理对象，用于延迟实例化数据库操作类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @param name - 数据库表名\n * @returns 返回一个代理对象，该对象会将属性访问转发到实际的数据库操作实例\n */\n\n// biome-ignore lint/complexity/noBannedTypes: 必须这么用\nexport function dbProxy<D1, S1 extends DbSelect<D1> = {}>(name: string, options?: DbProxyOptions) {\n  return new Proxy(\n    {},\n    {\n      get(_target, prop) {\n        if (prop === '_isProxy') return true;\n\n        const table = new Db<D1, S1>({ table: name, ...options });\n        const tableProp = prop as keyof Db<D1, S1>;\n        const ref = table[tableProp];\n\n        return isFunction(ref) ? ref.bind(table) : ref;\n      },\n    },\n  ) as Db<D1, S1>;\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { Db } from './_db.class';\n\ntype _TransactionDb = {\n  startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n  commit: () => Promise<unknown>;\n  rollback: () => Promise<unknown>;\n};\n\nexport type WithTransaction = <D1>(db: Db<D1>) => Db<D1>;\n\n/**\n * 在数据库事务中执行操作\n *\n * @template K - 事务操作返回值类型\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: 单测使用 any\n  _mockDatabase?: any,\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\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: WithTransaction = <D1>(db: Db<D1>) => {\n    return _mockDbInstance || new Db<D1>({ ...db.options, 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","import { isFunction } from '@cloudcome/utils-core/type';\nimport type { Db } from './_db.class';\nimport type { DbCreate, DbQuery, DbUpdate } from './types';\n\nexport type DbUpsertOptions<T, C extends DbCreate<T>, U extends DbUpdate<T>> = {\n  /** 创建数据 */\n  create: C;\n\n  /**\n   * 更新数据，可以是对象或根据查询结果生成更新对象的函数\n   * @param row 查询到的文档数据，仅在传入函数时可用\n   */\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  update: U | ((exist: DbQuery<T, {}, {}>) => 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: 必须这么用\n  onBeforeUpdate?: (exist: DbQuery<T, {}, {}>) => false | unknown;\n\n  /**\n   * 更新后回调函数\n   * @param updateData 实际更新的数据\n   * @param exist 查询到的原始文档数据\n   */\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  onAfterUpdate?: (updateData: U, exist: DbQuery<T, {}, {}>) => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\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<D1, C extends DbCreate<D1>, U extends DbUpdate<D1>>(\n  db: Db<D1>,\n  options: DbUpsertOptions<D1, C, U>,\n): Promise<DbUpsertOutput> {\n  const { create, update, onBeforeCreate, onAfterCreate, onBeforeUpdate, onAfterUpdate, _mockDbInstance } = options;\n\n  const _mutateDb = (_mockDbInstance || db.clone()) as Db<D1>;\n  const _queryDb = (_mockDbInstance || db.clone(true)) as Db<D1>;\n\n  const exist = (await _queryDb\n    .where(db.getWhere(true))\n    // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n    .firstOrNull()) as DbQuery<D1, {}, {}> | null;\n\n  if (exist) {\n    const skipUpdate = (await onBeforeUpdate?.(exist)) === false;\n\n    if (skipUpdate) {\n      // @ts-expect-error\n      return { id: exist._id as string, updated: false, created: false };\n    }\n\n    const updateData = isFunction(update) ? update(exist) : update;\n    // @ts-expect-error\n    await _mutateDb.whereId(exist._id).update(updateData);\n    onAfterUpdate?.(updateData, exist);\n\n    // @ts-expect-error\n    return { id: exist._id as string, updated: true, created: false };\n  }\n\n  await onBeforeCreate?.();\n  const createdId = await _mutateDb.create(create);\n  await onAfterCreate?.(createdId);\n\n  return { id: createdId, updated: false, created: true };\n}\n","import type { Db } from './_db.class';\nimport type { DbCreate } from './types';\nimport { dbUpsert } from './upsert';\n\nexport type DbUniqueOptions<T, C extends DbCreate<T>> = {\n  /** 创建数据 */\n  create: C;\n\n  /** 创建前回调函数 */\n  onBeforeCreate?: () => unknown;\n\n  /**\n   * 创建后回调函数\n   * @param id 创建的文档ID\n   */\n  onAfterCreate?: (id: string) => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n  _mockDbInstance?: any;\n};\n\n/**\n * 数据库 upsert 操作的返回结果类型\n */\nexport type DbUniqueOutput = {\n  /** 操作的文档ID */\n  id: string;\n  /** 是否为创建操作 */\n  created: boolean;\n};\n\nexport async function dbUnique<T, C extends DbCreate<T>>(\n  db: Db<T>,\n  options: DbUniqueOptions<T, C>,\n): Promise<DbUniqueOutput> {\n  const { id, created } = await dbUpsert(db, {\n    ...options,\n    // @ts-expect-error\n    update: {},\n    onBeforeUpdate: () => false,\n  });\n  return { id, created };\n}\n"],"mappings":"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"}
+{"version":3,"file":"database.cjs","names":[],"sources":["../src/database/_command.class.ts","../src/database/command.ts","../src/database/each.ts","../src/database/error.ts","../src/database/paging.ts","../src/database/_db.class.ts","../src/database/proxy.ts","../src/database/transaction.ts","../src/database/upsert.ts","../src/database/unique.ts"],"sourcesContent":["// 设置私有属性和静态方法是避免在 update 的时候提示类属性\n\nexport class DbBaseCommand {\n  protected _isQuery = false;\n  protected _isMutate = false;\n  protected _isGroup = false;\n\n  constructor(\n    protected _command: string,\n    protected _parameter: unknown,\n    private _options?: {\n      formatParameter?: (db: UniCloud.Database) => unknown;\n      rewriteValue?: (db: UniCloud.Database, parameter: unknown) => unknown;\n    },\n  ) {}\n\n  static getValue(cmd: DbBaseCommand, db: UniCloud.Database) {\n    if (cmd._options?.rewriteValue) {\n      return cmd._options.rewriteValue(db, cmd._parameter);\n    }\n\n    return (db.command as unknown as Record<string, (value: unknown) => unknown>)[cmd._command].call(\n      db.command,\n      cmd._options?.formatParameter?.(db) || cmd._parameter,\n    );\n  }\n\n  static getExpression(cmd: DbBaseCommand, fieldName: string) {\n    return {\n      [`$${cmd._command}`]: [fieldName, cmd._parameter],\n    };\n  }\n\n  static isQueryCommand(cmd: DbBaseCommand) {\n    return cmd._isQuery;\n  }\n\n  static isMutateCommand(cmd: DbBaseCommand) {\n    return cmd._isMutate;\n  }\n}\n\nexport class DbQueryCommand extends DbBaseCommand {\n  protected _isQuery = true;\n}\n\nexport class DbMutateCommand extends DbBaseCommand {\n  protected _isMutate = true;\n}\n\nexport class DbGroupCommand<T> extends DbBaseCommand {\n  protected _isGroup = true;\n\n  /** Phantom type marker - compile-time only, used by `group()`'s `infer T` to extract per-accumulator value types */\n  declare readonly __type: T;\n\n  toAggregate(): Record<string, unknown> {\n    const value = typeof this._parameter === 'string' ? `$${this._parameter}` : this._parameter;\n    return { [`$${this._command}`]: value };\n  }\n}\n","import { DbBaseCommand, DbMutateCommand, DbQueryCommand } from './_command.class';\n\n/**\n * 数据库查询命令对象，提供各种查询操作符\n */\nexport const dbQuery = {\n  /**\n   * 等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  eq: (value: unknown) => new DbQueryCommand('eq', value),\n\n  /**\n   * 不等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  neq: (value: unknown) => new DbQueryCommand('neq', value),\n\n  /**\n   * 大于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  gt: (value: unknown) => new DbQueryCommand('gt', value),\n\n  /**\n   * 大于等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  gte: (value: unknown) => new DbQueryCommand('gte', value),\n\n  /**\n   * 小于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  lt: (value: unknown) => new DbQueryCommand('lt', value),\n\n  /**\n   * 小于等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  lte: (value: unknown) => new DbQueryCommand('lte', value),\n\n  /**\n   * 包含在数组中操作符\n   * @param value 值数组\n   * @returns DbQueryCommand 查询命令对象\n   */\n  in: (value: unknown[]) => new DbQueryCommand('in', value),\n\n  /**\n   * 不包含在数组中操作符\n   * @param value 值数组\n   * @returns DbQueryCommand 查询命令对象\n   */\n  nin: (value: unknown[]) => new DbQueryCommand('nin', value),\n\n  /**\n   * 数组长度匹配操作符\n   * @param size 数组长度\n   * @returns DbQueryCommand 查询命令对象\n   */\n  size: (size: number) => new DbQueryCommand('size', size),\n\n  /**\n   * 正则表达式匹配操作符\n   * @param regExp 正则表达式\n   * @returns DbQueryCommand 查询命令对象\n   */\n  regExp: (regExp: RegExp) =>\n    new DbQueryCommand('regExp', regExp, {\n      rewriteValue: (_db, parameter) => parameter,\n    }),\n\n  /**\n   * 逻辑与操作符\n   * @param conditions 查询条件参数\n   * @returns DbQueryCommand 查询命令对象\n   */\n  and: (conditions: DbQueryCommand[]) =>\n    new DbQueryCommand('and', conditions, {\n      formatParameter: (db) => conditions.map((c) => DbBaseCommand.getValue(c, db)),\n    }),\n\n  /**\n   * 逻辑或操作符\n   * @param conditions 查询条件参数\n   * @returns DbQueryCommand 查询命令对象\n   */\n  or: (conditions: DbQueryCommand[]) =>\n    new DbQueryCommand('or', conditions, {\n      formatParameter: (db) => conditions.map((c) => DbBaseCommand.getValue(c, db)),\n    }),\n};\n\n/**\n * 数据库变更命令对象，提供各种数据更新操作符\n */\nexport const dbMutate = {\n  /**\n   * 数值增加操作符\n   * @param value 增加的数值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  inc: (value: number) => new DbMutateCommand('inc', value),\n\n  /**\n   * 数值乘法操作符\n   * @param value 乘数\n   * @returns DbMutateCommand 变更命令对象\n   */\n  mul: (value: number) => new DbMutateCommand('mul', value),\n\n  /**\n   * 设置字段值操作符\n   * @param value 设置的值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  set: (value: unknown) => new DbMutateCommand('set', value),\n\n  /**\n   * 向数组末尾添加元素操作符\n   * @param value 添加的值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  push: (value: unknown) => new DbMutateCommand('push', value),\n\n  /**\n   * 向数组开头添加元素操作符\n   * @param value 添加的值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  unshift: (value: unknown) => new DbMutateCommand('unshift', value),\n\n  /**\n   * 从数组末尾移除元素操作符\n   * @returns DbMutateCommand 变更命令对象\n   */\n  pop: () => new DbMutateCommand('pop', undefined),\n\n  /**\n   * 从数组开头移除元素操作符\n   * @returns DbMutateCommand 变更命令对象\n   */\n  shift: () => new DbMutateCommand('shift', undefined),\n\n  /**\n   * 移除字段操作符\n   * @returns DbMutateCommand 变更命令对象\n   */\n  remove: () => new DbMutateCommand('remove', undefined),\n};\n","import type { Db } from './_db.class';\nimport type { DbWhere } from './types';\n\n/**\n * 遍历表中的每一行数据并执行回调函数\n *\n * 采用分批查询策略，每批查询 100 条记录，通过 skip/limit 实现分页遍历，\n * 避免一次性加载大量数据导致内存溢出。\n *\n * 迭代器按顺序串行执行，即每一行数据的迭代器完成后才会处理下一行。\n *\n * @template T - 数据行类型\n * @param table 数据库表代理对象\n * @param where 查询条件\n * @param iterator 对每一行数据执行的异步迭代器函数\n * @param maxCount 最大遍历数量，默认值为 Number.MAX_SAFE_INTEGER。\n *   注意：由于分批查询机制（每批 100 条），实际遍历的行数可能略大于 maxCount，\n *   例如 maxCount=150 时，会分两批查询（0-99、100-199），实际遍历 200 行。\n * @example\n * ```ts\n * // 遍历所有状态为 active 的用户\n * await dbEach(userTable, { status: 'active' }, async (user) => {\n *   await sendEmail(user.email);\n * });\n *\n * // 限制最多遍历 500 条记录\n * await dbEach(orderTable, { status: 'pending' }, async (order) => {\n *   await processOrder(order);\n * }, 500);\n * ```\n */\nexport async function dbEach<T>(\n  table: Db<T>,\n  where: DbWhere<T>,\n  iterator: (row: T) => Promise<unknown>,\n  maxCount = Number.MAX_SAFE_INTEGER,\n) {\n  const count = Math.min(await table.where(where).count(), maxCount);\n  const limit = 100;\n\n  for (let skip = 0; skip < count; skip += limit) {\n    const rows = await table.where(where).limit(limit).skip(skip).many();\n\n    for (const row of rows) {\n      await iterator(row as T);\n    }\n  }\n}\n","/**\n * 数据库底层异常类\n * 当 uniCloud 数据库操作抛出错误时，统一包装为该异常\n */\nexport class DbError extends Error {\n  /** 原始错误码，如 'InternalServerError' */\n  errCode: string | number;\n  /** MongoDB 错误码，如 'E11000'。不匹配则为空字符串 */\n  dbCode: string;\n\n  constructor(message: string, extra: { errCode: string | number; dbCode: string }) {\n    super(message);\n    this.name = 'DbError';\n    this.errCode = extra.errCode;\n    this.dbCode = extra.dbCode;\n  }\n}\n\n/**\n * 判断错误是否为数据库底层错误\n * @param err - 任意错误对象\n * @returns 是否为 DbError\n */\nexport function isDbError(err: unknown): err is DbError {\n  return err instanceof DbError;\n}\n\n/**\n * 从 MongoDB 错误消息中提取错误码\n * @param errMsg - 错误消息字符串，如 'E11000 duplicate key error...'\n * @returns MongoDB 错误码，如 'E11000'\n */\nexport function extractMongoCode(errMsg: string): string {\n  const m = errMsg.match(/^E\\d+/);\n  return m ? m[0] : '';\n}\n","import type { AnyObject } from '@cloudcome/utils-core/types';\nimport type { Db } from './_db.class';\nimport type { DbSelect } from './types';\n\n/**\n * 数据库分页查询函数\n * @template T - 数据类型\n * @param queryDb - 数据库查询实例\n * @returns 包含数据列表和总数的对象\n */\n\nexport async function dbPaging<\n  D1,\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  S1 extends DbSelect<D1> = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  D2 extends AnyObject = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  W2 extends AnyObject = {},\n>(queryDb: Db<D1, S1, D2, W2>) {\n  // 获取原始查询条件，不包映射字段\n  const where = queryDb.getWhere(true);\n\n  // 克隆查询实例用于统计总数，避免影响原查询\n  const countDb = queryDb.clone();\n\n  // 执行查询获取数据列表\n  const list = await queryDb.many();\n\n  // 基于相同查询条件统计总数\n  const total = await countDb.where(where).count();\n\n  // 返回分页结果\n  return {\n    list,\n    total,\n  };\n}\n","import { isUniError, parseDatabaseOutput } from '@/_helpers';\nimport type { UniError } from '@/_types';\nimport { createCloudObjectError } from '@/cloud';\nimport { objectEach, objectFilter, objectMap, objectOmit } from '@cloudcome/utils-core/object';\nimport { isArray, isObject } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MergeIntersection } from '@cloudcome/utils-core/types';\nimport { DbBaseCommand, DbGroupCommand, type DbQueryCommand } from './_command.class';\nimport { DbError, extractMongoCode } from './error';\nimport type { DbCreate, DbForeign, DbOrder, DbQuery, DbRelation, DbSelect, DbUpdate, DbWhere } from './types';\n\n/**\n * 数据库聚合操作符命令\n */\nconst dbAgg = uniCloud.database().command.aggregate as UniCloud.AggregateCommand & {\n  pipeline: () => UniCloud.AggregateReference & {\n    done: () => unknown;\n  };\n};\n\nconst db0 = uniCloud.database();\n\nexport type DbOptions = {\n  /**\n   * 数据表名称\n   */\n  table: string;\n\n  /**\n   * 事务对象，用于事务操作\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n  transaction?: any;\n\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n  _mockDatabase?: any;\n\n  /**\n   * 自定义错误处理函数\n   * @param error unknown 数据库异常对象\n   * @returns 自定义错误对象\n   */\n  parseError?: (error: unknown) => UniError;\n};\n\nexport type DbLookupOptions<\n  RL extends DbRelation,\n  D1,\n  FD1,\n  AS,\n  // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n  US extends boolean | undefined | void = undefined,\n  LF extends keyof D1 & string = keyof D1 & string,\n> = {\n  /**\n   * 关联类型\n   */\n  relation: RL;\n\n  /**\n   * 主表字段\n   */\n  localField: LF;\n\n  /**\n   * 关联表字段\n   */\n  foreignField: keyof FD1 & string;\n\n  /**\n   * 关联数据在结果中的字段名\n   */\n  as: AS;\n\n  /**\n   * 是否取消筛选关联数据\n   */\n  unselect?: US;\n};\n\nexport type DbLookup = DbLookupOptions<\n  // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n  any,\n  unknown,\n  unknown,\n  string,\n  boolean\n> & {\n  /**\n   * 关联表\n   */\n  table: Db<unknown>;\n};\n\nlet gid = 0;\n\n/**\n * 数据库类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @template D2 - 副表数据\n * @template W2 - 副表查询\n */\nexport class Db<\n  D1,\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  S1 extends DbSelect<D1> = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  D2 extends AnyObject = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  W2 extends AnyObject = {},\n> {\n  /**\n   * 是否为事务环境\n   * - 更新条件只能是 id\n   * - 删除条件只能是 id\n   */\n  private _isTransaction = false;\n\n  private _options: DbOptions;\n\n  /**\n   * 构造函数，初始化数据库集合引用\n   * @param collection 数据表名称\n   * @param _mockDatabase 模拟数据库，用于单元测试\n   */\n  constructor(options: DbOptions) {\n    this._options = options;\n    // hostRef =\n    //   options._mockDatabase || options.transaction?.collection(options.table) || db0.collection(options.table);\n    this._isTransaction = !!options.transaction;\n  }\n\n  /**\n   * 创建一个新的数据库实例，可选是否移除事务\n   * @param withoutTransaction 是否移除事务，默认 false\n   * @returns 新的数据库实例\n   */\n  clone(withoutTransaction?: boolean) {\n    return new Db({\n      ...this._options,\n      transaction: withoutTransaction ? null : this._options.transaction,\n    });\n  }\n\n  get table() {\n    return this._options.table;\n  }\n\n  get options() {\n    return this._options;\n  }\n\n  get isTransaction() {\n    return this._isTransaction;\n  }\n\n  _createHost(withoutTransaction?: boolean) {\n    const options = this._options;\n    return (\n      options._mockDatabase ||\n      (withoutTransaction ? null : options.transaction?.collection(options.table) || db0.collection(options.table))\n    );\n  }\n\n  /**\n   * 获取聚合操作实例\n   * @returns 聚合操作实例\n   */\n  _createAggregate() {\n    const host = this._createHost();\n    return host.aggregate();\n  }\n\n  private _hasWhere = false;\n  private _hasWhereId = false;\n  private _where = {};\n\n  /**\n   * 设置查询条件\n   * @param where 查询条件对象\n   * @returns 当前Db实例，支持链式调用\n   */\n  where(where: DbWhere<D1> & W2) {\n    if (this._isTransaction) throw new Error('事务模式下请使用 whereId() 方法');\n    if (this._hasWhere) throw new Error('已调用过一次 db.where({...}) 或 db.whereId(id) 了');\n\n    // 过滤掉值为 undefined 的键值对，数据库不支持查询全 undefined 值\n    const realWhere = objectFilter(where, (value) => value !== undefined);\n\n    this._hasWhere = true;\n    this._where = realWhere;\n\n    return this;\n  }\n\n  /**\n   * 获取当前查询条件\n   * @param plain 是否返回原始查询条件对象，默认 false\n   * @returns 当前查询条件对象\n   */\n  getWhere(plain?: boolean) {\n    return plain\n      ? // biome-ignore lint/suspicious/noTsIgnore: 必须这么用\n        // @ts-ignore\n        objectOmit(this._where, Object.keys(this._lookupAs))\n      : this._where;\n  }\n\n  /**\n   * 根据ID设置查询条件\n   * @param id 记录ID\n   * @returns 当前Db实例，支持链式调用\n   */\n  whereId(id: string | number) {\n    if (this._hasWhere) throw new Error('已调用过一次 db.where({...}) 或 db.whereId(id) 了');\n    if (this._hasLimit) throw new Error('db.whereId(id) 方法不能与 db.limit() 方法同时调用');\n\n    this._hasWhere = true;\n    this._hasWhereId = true;\n    this._where = { _id: id };\n\n    return this;\n  }\n\n  private _hasSelect = 0;\n  private _select = {};\n\n  /**\n   * 指定要返回的字段\n   * @param fields 要返回的字段对象，true表示返回，false表示不返回\n   * @returns 当前Db实例，支持链式调用\n   */\n  select<const S extends DbSelect<D1>>(fields: S) {\n    if (this._hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n    this._hasSelect++;\n    this._select = fields;\n\n    return this as Db<D1, S, D2, W2>;\n  }\n\n  private _hasOrder = 0;\n  private _order = {};\n\n  /**\n   * 设置排序规则\n   * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n   * @returns 当前Db实例，支持链式调用\n   */\n  order(order: DbOrder<D1>) {\n    if (this._isTransaction) throw new Error('db.order() 方法不支持事务模式');\n\n    this._hasOrder++;\n    this._order = order;\n\n    return this;\n  }\n\n  private _hasSkip = 0;\n  private _skip = 0;\n\n  /**\n   * 跳过指定数量的记录\n   * @param skip 要跳过的记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  skip(skip: number) {\n    if (this._isTransaction) throw new Error('db.skip() 方法不支持事务模式');\n    if (this._hasSkip) throw new Error('db.skip() 方法只能调用一次');\n\n    this._hasSkip++;\n    this._skip = skip;\n\n    return this;\n  }\n\n  private _hasLimit = 0;\n  private _limit = 0;\n\n  /**\n   * 限制返回的记录数量\n   * @param limit 最大返回记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  limit(limit: number) {\n    if (this._isTransaction) throw new Error('db.limit() 方法不支持事务模式');\n    if (this._hasLimit) throw new Error('db.limit() 方法只能调用一次');\n    if (this._hasSample) throw new Error('db.limit() 方法不支持 sample 条件');\n\n    if (this._hasWhereId) {\n      throw new Error('db.limit() 方法不能与 db.whereId(id) 方法同时调用');\n    }\n\n    this._hasLimit++;\n    this._limit = limit;\n\n    return this;\n  }\n\n  private _hasSample = 0;\n  private _sampleSize = 0;\n\n  private _hasGroup = 0;\n  private _group: Record<string, unknown> = {};\n\n  /**\n   * 随机从文档中选取指定数量的记录\n   * @param size 要选取的记录数量，必须为正整数\n   * @returns 当前Db实例，支持链式调用\n   */\n  sample(size: number) {\n    if (this._isTransaction) throw new Error('db.sample() 方法不支持事务模式');\n    if (this._hasSample) throw new Error('db.sample() 方法只能调用一次');\n    if (this._hasLimit) throw new Error('db.sample() 方法不支持 limit 条件');\n\n    this._hasSample++;\n    this._sampleSize = size;\n\n    return this;\n  }\n\n  /**\n   * 设置分组聚合条件\n   * @param field 分组字段，单个字段传入字段名，多个字段传入数组\n   * @param accumulators 累加器定义对象，value 使用 db.dbGroup 命令\n   * @returns 当前Db实例，支持链式调用\n   *\n   * @example\n   * ```typescript\n   * // 按单个字段分组计数\n   * .group('consecutiveDays', { count: db.dbGroup.sum(1) })\n   *\n   * // 按多字段组合分组求和\n   * .group(['year', 'month'], { total: db.dbGroup.sum('amount') })\n   * ```\n   */\n  group<const K extends keyof D1, const A extends Record<string, DbGroupCommand<any>>>(\n    field: K | readonly K[],\n    accumulators: A,\n  ) {\n    if (this._isTransaction) throw new Error('db.group() 方法不支持事务模式');\n    if (this._hasGroup) throw new Error('db.group() 方法只能调用一次');\n    if (this._hasSelect) throw new Error('db.group() 方法不支持 select 条件');\n    if (this._hasSample) throw new Error('db.group() 方法不支持 sample 条件');\n    if (this._hasLookup) throw new Error('db.group() 方法不支持 lookup 关联查询');\n\n    this._hasGroup++;\n\n    const fieldArr = Array.isArray(field) ? field : [field];\n    const id =\n      fieldArr.length === 1\n        ? `$${String(fieldArr[0])}`\n        : Object.fromEntries(fieldArr.map((f) => [String(f), `$${String(f)}`]));\n\n    this._group = { _id: id, ...accumulators };\n\n    type AccumulatorValues = { [P in keyof A]: A[P] extends DbGroupCommand<infer T> ? T : unknown };\n    return this as unknown as Db<D1 & AccumulatorValues, {}, D2, W2>;\n  }\n\n  private _hasLookup = 0;\n  get hasLookup() {\n    return this._hasLookup > 0;\n  }\n\n  get dbGroup() {\n    return {\n      sum: (value: number | string) => new DbGroupCommand<number>('sum', value),\n      avg: (field: keyof D1 & string) => new DbGroupCommand<number>('avg', field),\n      min: <K extends keyof D1>(field: K) => new DbGroupCommand<D1[K]>('min', String(field)),\n      max: <K extends keyof D1>(field: K) => new DbGroupCommand<D1[K]>('max', String(field)),\n      push: <K extends keyof D1>(field: K) => new DbGroupCommand<D1[K][]>('push', String(field)),\n      addToSet: <K extends keyof D1>(field: K) => new DbGroupCommand<D1[K][]>('addToSet', String(field)),\n      first: <K extends keyof D1>(field: K) => new DbGroupCommand<D1[K]>('first', String(field)),\n      last: <K extends keyof D1>(field: K) => new DbGroupCommand<D1[K]>('last', String(field)),\n    };\n  }\n\n  private _lookups: DbLookup[] = [];\n  lookup<\n    FD1,\n    FS1 extends DbSelect<FD1>,\n    FD2 extends AnyObject,\n    FW2 extends AnyObject,\n    RL extends DbRelation,\n    AS extends string,\n    // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n    US extends boolean | undefined | void = undefined,\n    LF extends keyof D1 & string = keyof D1 & string,\n  >(table: Db<FD1, FS1, FD2, FW2>, lookup: DbLookupOptions<RL, D1, FD1, AS, US, LF>) {\n    if (this._isTransaction) throw new Error('db.lookup() 方法不支持事务模式');\n\n    // 对方表也记为关联查询，避免做表更新操作\n    table._hasLookup++;\n    this._hasLookup++;\n    this._lookups.push({\n      ...lookup,\n      table,\n    } as unknown as DbLookup);\n\n    // @ts-expect-error\n    return this as Db<\n      D1,\n      S1,\n      US extends true ? D2 : MergeIntersection<D2 & DbForeign<D1, FD1, FS1, FD2, RL, AS, LF>>,\n      MergeIntersection<W2 & Partial<Record<AS, DbQueryCommand>>>\n    >;\n  }\n\n  private _ending = false;\n\n  private _aggregated = false;\n  private _lookupAs = {} as Record<string, true>;\n  private _endAggregate(aggRef: UniCloud.AggregateReference) {\n    if (this._aggregated) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n    if (this._ending) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n\n    this._ending = true;\n    this._aggregated = true;\n    let returnAggRef = aggRef;\n    let _hasAggSelect = 0;\n    const aggSelect = {} as Record<string, true>;\n    let hasAggUnselect = 0;\n    const aggUnselect = {} as Record<string, false>;\n\n    // 后做关联查询\n    for (const { relation: type, as, foreignField, localField, table, unselect } of this._lookups) {\n      const letName = `let${gid++}`;\n      let pipeline = dbAgg.pipeline();\n\n      // 关联条件\n      // @ts-expect-error\n      pipeline = pipeline.match({\n        $expr: {\n          $and: [\n            type === 'n:1'\n              ? { $in: [`$${foreignField}`, `$$${letName}`] }\n              : { $eq: [`$${foreignField}`, `$$${letName}`] },\n          ],\n        },\n      });\n\n      // 其他查询条件\n      // @ts-expect-error\n      pipeline = table._endAggregate(pipeline);\n\n      // @ts-expect-error\n      pipeline = pipeline.done();\n\n      returnAggRef = returnAggRef.lookup({\n        let: {\n          [letName]: `$${localField}`,\n        },\n        as,\n        from: table.table,\n        pipeline,\n      });\n\n      // 1对1，展开数组\n      if (type === '1:1') {\n        // @ts-expect-error\n        returnAggRef = returnAggRef.unwind({\n          path: `$${as}`,\n          preserveNullAndEmptyArrays: true,\n        });\n      }\n\n      if (unselect) {\n        hasAggUnselect++;\n        aggUnselect[as] = false;\n      } else {\n        _hasAggSelect++;\n        aggSelect[as] = true;\n      }\n\n      this._lookupAs[as] = true;\n    }\n\n    // 主表查询，注意顺序，筛选->分组->取样->排序->跳过->限制\n    if (this._hasWhere) returnAggRef = returnAggRef.match(_mapCommandRaw(this._where));\n    if (this._hasGroup) returnAggRef = returnAggRef.group(_mapGroupRaw(this._group));\n    if (this._hasSample) returnAggRef = returnAggRef.sample({ size: this._sampleSize });\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    // 如果主表有选择字段，则合并选择字段（包括关联查询的字段和排序字段）\n    if (this._hasSelect) {\n      returnAggRef = returnAggRef.project(_mergeSelect({ ...this._select, ...aggSelect }, this._order));\n    }\n    // 如果主表没有选择字段，则排除取消选择字段\n    else if (hasAggUnselect) {\n      returnAggRef = returnAggRef.project(aggUnselect);\n    }\n\n    return returnAggRef;\n  }\n\n  private _endHost(host: UniCloud.CollectionReference, action: 'query' | 'create' | 'update' | 'remove' | 'count') {\n    if (this._ending) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n    this._ending = true;\n\n    // 事务模式下：查询/更新/删除必须使用 whereId\n    if (\n      this._isTransaction &&\n      (action === 'query' || action === 'update' || action === 'remove') &&\n      !this._hasWhereId\n    ) {\n      throw new Error('事务模式下查询/更新/删除条件只能是 ID，请使用 whereId() 方法');\n    }\n\n    let hostRef = host;\n    if (this._hasWhere) {\n      // 事务模式下：更新/删除/查询只能用 doc(id)\n      if (this._isTransaction && (action === 'update' || action === 'remove' || action === 'query')) {\n        // @ts-expect-error\n        hostRef = hostRef.doc(this._where._id);\n      } else {\n        // @ts-expect-error\n        hostRef = hostRef.where(_mapCommandRaw(this._where));\n      }\n    }\n\n    if (this._hasSelect) {\n      // @ts-expect-error\n      hostRef = hostRef.field(_mergeSelect(this._select, this._order));\n    }\n\n    if (this._hasOrder) {\n      objectEach(this._order, (val, key) => {\n        // @ts-expect-error\n        hostRef = hostRef.orderBy(key, val);\n      });\n    }\n\n    // @ts-expect-error\n    if (this._hasSkip) hostRef = hostRef.skip(this._skip);\n\n    if (this._hasLimit && action === 'query')\n      // @ts-expect-error\n      hostRef = hostRef.limit(this._limit);\n    else if (this._hasWhereId && action === 'query' && !this._isTransaction)\n      // @ts-expect-error\n      hostRef = hostRef.limit(1);\n\n    return hostRef;\n  }\n\n  /**\n   * 将 uniCloud 数据库原始错误包装为 DbError\n   * @param err - 原始错误对象，来自 uniCloud DB 操作（Error 实例，含 errMsg、errCode 属性）\n   * @returns DbError 实例\n   */\n  private _parseDbError(err: UniError) {\n    const errCode = err.errCode || '';\n    const message = err.errMsg || err.message;\n    const dbCode = extractMongoCode(err.errMsg || err.message);\n\n    if (dbCode) {\n      return new DbError(message, {\n        errCode: errCode,\n        dbCode: dbCode,\n      });\n    } else {\n      return err;\n    }\n  }\n\n  /**\n   * 统一处理 DB 操作抛出的错误\n   * - uniCloud 数据库错误（含 errMsg）→ 包装为 DbError → 经 parseError 回调后抛出\n   * - 非数据库错误（如网络中断）→ 原样抛出\n   */\n  private _handleDbError(err: unknown): never {\n    if (isUniError(err)) {\n      const dbErr = this._parseDbError(err);\n      throw this._options.parseError?.(dbErr) || dbErr;\n    } else {\n      throw this._options.parseError?.(err) || err;\n    }\n  }\n\n  /**\n   * 执行查询操作\n   * @returns 查询结果\n   */\n  async many() {\n    try {\n      let res: { data: DbQuery<D1, S1, D2>[] | DbQuery<D1, S1, D2> | undefined };\n\n      // 事务模式下不支持聚合查询\n      if (this._isTransaction && (this._hasLookup || this._hasSample || this._hasGroup)) {\n        throw new Error('事务模式下不支持 lookup 聚合、sample 取样或 group 分组查询');\n      }\n\n      // 关联查询 / sample 查询 / group 分组（依赖聚合管线）\n      if (this._hasLookup || this._hasSample || this._hasGroup) {\n        let aggRef = this._createAggregate();\n        aggRef = this._endAggregate(aggRef);\n        res = await aggRef.end();\n      }\n      // 单表查询\n      else {\n        let hostRef = this._createHost();\n        hostRef = this._endHost(hostRef, 'query');\n        res = await hostRef.get();\n      }\n\n      const { data } = parseDatabaseOutput(res);\n\n      // doc(id).get() 返回单个对象或 undefined，需包装为数组以统一 many() 返回值\n      return isArray(data) ? data : data ? [data] : [];\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * 如果没有匹配到记录，会抛出错误\n   * @returns 查询结果\n   */\n  async firstOrThrow(): Promise<DbQuery<D1, S1, D2>> {\n    if (this._hasLimit) throw new Error('db.firstOrThrow() 方法不支持 limit 条件');\n    if (!this._hasWhereId && !this._hasSample && !this._hasGroup) this.limit(1);\n\n    const data = await this.many();\n    const res = data.at(0);\n\n    if (!res) throw createCloudObjectError('查询数据为空', 'firstOrThrow');\n    return res;\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * 如果没有匹配到记录，返回 null\n   * @returns 查询结果或 null\n   */\n  async firstOrNull(): Promise<DbQuery<D1, S1, D2> | null> {\n    if (this._hasLimit) throw new Error('db.firstOrNull() 方法不支持 limit 条件');\n    if (!this._hasWhereId && !this._hasSample && !this._hasGroup) this.limit(1);\n\n    const data = await this.many();\n    return data.at(0) || null;\n  }\n\n  /**\n   * 获取匹配记录的数量\n   * @returns 记录总数\n   */\n  async count() {\n    if (this._isTransaction) throw new Error('db.count() 方法不支持事务模式');\n    if (this._hasSample) throw new Error('db.count() 方法不支持 sample 取样');\n    if (this._hasLookup) throw new Error('db.count() 方法不支持 lookup 聚合');\n    if (this._hasGroup) throw new Error('db.count() 方法不支持 group 分组');\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'count');\n      const res = await hostRef.count();\n      const { total } = parseDatabaseOutput<{ total: number }>(res);\n      return total;\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n\n  /**\n   * 创建新记录\n   * @param data 要创建的数据\n   * @returns 创建结果\n   */\n  async create(data: DbCreate<D1>) {\n    if (this._hasLookup) throw new Error('db.create() 方法不支持 lookup 聚合');\n    if (this._hasGroup) throw new Error('db.create() 方法不支持 group 分组');\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'create');\n      const res = await hostRef.add(data);\n      const { id } = parseDatabaseOutput<{ id: string }>(res);\n      return id;\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n\n  /**\n   * 更新记录\n   * @param data 要更新的数据\n   * @returns 更新结果\n   */\n  async update(data: DbUpdate<D1>) {\n    if (this._hasLookup) throw new Error('db.update() 方法不支持 lookup 聚合');\n    if (this._hasGroup) throw new Error('db.update() 方法不支持 group 分组');\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'update');\n      const res = await hostRef.update(objectOmit(_mapCommandRaw(data), ['_id']));\n      const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n      return updated;\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n\n  /**\n   * 删除记录\n   * @returns 删除结果\n   */\n  async remove() {\n    if (this._hasLookup) throw new Error('db.remove() 方法不支持 lookup 聚合');\n    if (this._hasGroup) throw new Error('db.remove() 方法不支持 group 分组');\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'remove');\n      const res = await hostRef.remove();\n      const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n      return deleted;\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: 必须这么用\nfunction _mapCommandRaw(data: any) {\n  // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n  const map = (val: any): any => {\n    if (!isObject(val)) return val;\n    if (val instanceof DbBaseCommand) return DbBaseCommand.getValue(val, db0);\n    return objectMap(val, map);\n  };\n\n  return objectMap(data, map);\n}\n\nfunction _mapGroupRaw(group: Record<string, unknown>) {\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(group)) {\n    if (value instanceof DbGroupCommand) {\n      result[key] = value.toAggregate();\n    } else {\n      result[key] = value;\n    }\n  }\n  return result;\n}\n\nfunction _mapOrderSelect(order: DbOrder<unknown>) {\n  return objectMap(order, (_val, _key) => true);\n}\n\nfunction _mergeSelect(select: DbSelect<unknown>, order: DbOrder<unknown>) {\n  const noSelect = Object.keys(select).length === 0;\n  // 如果没有 select 条件，默认返回所有字段\n  if (noSelect) return select;\n\n  const onlyOmitId = Object.keys(select).length === 1 && '_id' in select && select._id === false;\n  // 如果只排除 _id 字段，则保持现状\n  if (onlyOmitId) return select;\n\n  return {\n    ...select,\n    ..._mapOrderSelect(order),\n  };\n}\n","import { isFunction } from '@cloudcome/utils-core/type';\nimport { Db } from './_db.class';\nimport type { DbSelect } from './types';\nimport type { UniError } from '@/_types';\n\nexport type DbProxyOptions = {\n  /**\n   * 自定义错误处理函数\n   * @param error unknown 数据库异常对象\n   * @returns 自定义错误对象\n   */\n  parseError?: (error: unknown) => UniError;\n};\n\n/**\n * 创建一个数据库代理对象，用于延迟实例化数据库操作类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @param name - 数据库表名\n * @returns 返回一个代理对象，该对象会将属性访问转发到实际的数据库操作实例\n */\n\n// biome-ignore lint/complexity/noBannedTypes: 必须这么用\nexport function dbProxy<D1, S1 extends DbSelect<D1> = {}>(name: string, options?: DbProxyOptions) {\n  return new Proxy(\n    {},\n    {\n      get(_target, prop) {\n        if (prop === '_isProxy') return true;\n\n        const table = new Db<D1, S1>({ table: name, ...options });\n        const tableProp = prop as keyof Db<D1, S1>;\n        const ref = table[tableProp];\n\n        return isFunction(ref) ? ref.bind(table) : ref;\n      },\n    },\n  ) as Db<D1, S1>;\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { Db } from './_db.class';\n\ntype _TransactionDb = {\n  startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n  commit: () => Promise<unknown>;\n  rollback: () => Promise<unknown>;\n};\n\nexport type WithTransaction = <D1>(db: Db<D1>) => Db<D1>;\n\n/**\n * 在数据库事务中执行操作\n *\n * @template K - 事务操作返回值类型\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: 单测使用 any\n  _mockDatabase?: any,\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\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: WithTransaction = <D1>(db: Db<D1>) => {\n    return _mockDbInstance || new Db<D1>({ ...db.options, 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","import { isFunction } from '@cloudcome/utils-core/type';\nimport type { Db } from './_db.class';\nimport type { DbCreate, DbQuery, DbUpdate } from './types';\n\nexport type DbUpsertOptions<T, C extends DbCreate<T>, U extends DbUpdate<T>> = {\n  /** 创建数据 */\n  create: C;\n\n  /**\n   * 更新数据，可以是对象或根据查询结果生成更新对象的函数\n   * @param row 查询到的文档数据，仅在传入函数时可用\n   */\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  update: U | ((exist: DbQuery<T, {}, {}>) => 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: 必须这么用\n  onBeforeUpdate?: (exist: DbQuery<T, {}, {}>) => false | unknown;\n\n  /**\n   * 更新后回调函数\n   * @param updateData 实际更新的数据\n   * @param exist 查询到的原始文档数据\n   */\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  onAfterUpdate?: (updateData: U, exist: DbQuery<T, {}, {}>) => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\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<D1, C extends DbCreate<D1>, U extends DbUpdate<D1>>(\n  db: Db<D1>,\n  options: DbUpsertOptions<D1, C, U>,\n): Promise<DbUpsertOutput> {\n  const { create, update, onBeforeCreate, onAfterCreate, onBeforeUpdate, onAfterUpdate, _mockDbInstance } = options;\n\n  const _mutateDb = (_mockDbInstance || db.clone()) as Db<D1>;\n  const _queryDb = (_mockDbInstance || db.clone(true)) as Db<D1>;\n\n  const exist = (await _queryDb\n    .where(db.getWhere(true))\n    // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n    .firstOrNull()) as DbQuery<D1, {}, {}> | null;\n\n  if (exist) {\n    const skipUpdate = (await onBeforeUpdate?.(exist)) === false;\n\n    if (skipUpdate) {\n      // @ts-expect-error\n      return { id: exist._id as string, updated: false, created: false };\n    }\n\n    const updateData = isFunction(update) ? update(exist) : update;\n    // @ts-expect-error\n    await _mutateDb.whereId(exist._id).update(updateData);\n    onAfterUpdate?.(updateData, exist);\n\n    // @ts-expect-error\n    return { id: exist._id as string, updated: true, created: false };\n  }\n\n  await onBeforeCreate?.();\n  const createdId = await _mutateDb.create(create);\n  await onAfterCreate?.(createdId);\n\n  return { id: createdId, updated: false, created: true };\n}\n","import type { Db } from './_db.class';\nimport type { DbCreate } from './types';\nimport { dbUpsert } from './upsert';\n\nexport type DbUniqueOptions<T, C extends DbCreate<T>> = {\n  /** 创建数据 */\n  create: C;\n\n  /** 创建前回调函数 */\n  onBeforeCreate?: () => unknown;\n\n  /**\n   * 创建后回调函数\n   * @param id 创建的文档ID\n   */\n  onAfterCreate?: (id: string) => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n  _mockDbInstance?: any;\n};\n\n/**\n * 数据库 upsert 操作的返回结果类型\n */\nexport type DbUniqueOutput = {\n  /** 操作的文档ID */\n  id: string;\n  /** 是否为创建操作 */\n  created: boolean;\n};\n\nexport async function dbUnique<T, C extends DbCreate<T>>(\n  db: Db<T>,\n  options: DbUniqueOptions<T, C>,\n): Promise<DbUniqueOutput> {\n  const { id, created } = await dbUpsert(db, {\n    ...options,\n    // @ts-expect-error\n    update: {},\n    onBeforeUpdate: () => false,\n  });\n  return { id, created };\n}\n"],"mappings":"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"}

package/dist/database.mjs

@@ -10,6 +10,7 @@ var DbBaseCommand = class {
 	_options;
 	_isQuery = false;
 	_isMutate = false;
+	_isGroup = false;
 	constructor(_command, _parameter, _options) {
 		this._command = _command;
 		this._parameter = _parameter;
@@ -35,6 +36,13 @@ var DbQueryCommand = class extends DbBaseCommand {
 var DbMutateCommand = class extends DbBaseCommand {
 	_isMutate = true;
 };
+var DbGroupCommand = class extends DbBaseCommand {
+	_isGroup = true;
+	toAggregate() {
+		const value = typeof this._parameter === "string" ? `$${this._parameter}` : this._parameter;
+		return { [`$${this._command}`]: value };
+	}
+};
 //#endregion
 //#region src/database/command.ts
 /**
@@ -411,6 +419,8 @@ var Db = class Db {
 	}
 	_hasSample = 0;
 	_sampleSize = 0;
+	_hasGroup = 0;
+	_group = {};
 	/**
 	* 随机从文档中选取指定数量的记录
 	* @param size 要选取的记录数量，必须为正整数
@@ -424,10 +434,52 @@ var Db = class Db {
 		this._sampleSize = size;
 		return this;
 	}
+	/**
+	* 设置分组聚合条件
+	* @param field 分组字段，单个字段传入字段名，多个字段传入数组
+	* @param accumulators 累加器定义对象，value 使用 db.dbGroup 命令
+	* @returns 当前Db实例，支持链式调用
+	*
+	* @example
+	* ```typescript
+	* // 按单个字段分组计数
+	* .group('consecutiveDays', { count: db.dbGroup.sum(1) })
+	*
+	* // 按多字段组合分组求和
+	* .group(['year', 'month'], { total: db.dbGroup.sum('amount') })
+	* ```
+	*/
+	group(field, accumulators) {
+		if (this._isTransaction) throw new Error("db.group() 方法不支持事务模式");
+		if (this._hasGroup) throw new Error("db.group() 方法只能调用一次");
+		if (this._hasSelect) throw new Error("db.group() 方法不支持 select 条件");
+		if (this._hasSample) throw new Error("db.group() 方法不支持 sample 条件");
+		if (this._hasLookup) throw new Error("db.group() 方法不支持 lookup 关联查询");
+		this._hasGroup++;
+		const fieldArr = Array.isArray(field) ? field : [field];
+		const id = fieldArr.length === 1 ? `$${String(fieldArr[0])}` : Object.fromEntries(fieldArr.map((f) => [String(f), `$${String(f)}`]));
+		this._group = {
+			_id: id,
+			...accumulators
+		};
+		return this;
+	}
 	_hasLookup = 0;
 	get hasLookup() {
 		return this._hasLookup > 0;
 	}
+	get dbGroup() {
+		return {
+			sum: (value) => new DbGroupCommand("sum", value),
+			avg: (field) => new DbGroupCommand("avg", field),
+			min: (field) => new DbGroupCommand("min", String(field)),
+			max: (field) => new DbGroupCommand("max", String(field)),
+			push: (field) => new DbGroupCommand("push", String(field)),
+			addToSet: (field) => new DbGroupCommand("addToSet", String(field)),
+			first: (field) => new DbGroupCommand("first", String(field)),
+			last: (field) => new DbGroupCommand("last", String(field))
+		};
+	}
 	_lookups = [];
 	lookup(table, lookup) {
 		if (this._isTransaction) throw new Error("db.lookup() 方法不支持事务模式");
@@ -478,6 +530,7 @@ var Db = class Db {
 			this._lookupAs[as] = true;
 		}
 		if (this._hasWhere) returnAggRef = returnAggRef.match(_mapCommandRaw(this._where));
+		if (this._hasGroup) returnAggRef = returnAggRef.group(_mapGroupRaw(this._group));
 		if (this._hasSample) returnAggRef = returnAggRef.sample({ size: this._sampleSize });
 		if (this._hasOrder) returnAggRef = returnAggRef.sort(objectMap(this._order, (v) => v === "asc" ? 1 : -1));
 		if (this._hasSkip) returnAggRef = returnAggRef.skip(this._skip);
@@ -538,8 +591,8 @@ var Db = class Db {
 	async many() {
 		try {
 			let res;
-			if (this._isTransaction && (this._hasLookup || this._hasSample)) throw new Error("事务模式下不支持 lookup 聚合或 sample 取样查询");
-			if (this._hasLookup || this._hasSample) {
+			if (this._isTransaction && (this._hasLookup || this._hasSample || this._hasGroup)) throw new Error("事务模式下不支持 lookup 聚合、sample 取样或 group 分组查询");
+			if (this._hasLookup || this._hasSample || this._hasGroup) {
 				let aggRef = this._createAggregate();
 				aggRef = this._endAggregate(aggRef);
 				res = await aggRef.end();
@@ -561,7 +614,7 @@ var Db = class Db {
 	*/
 	async firstOrThrow() {
 		if (this._hasLimit) throw new Error("db.firstOrThrow() 方法不支持 limit 条件");
-		if (!this._hasWhereId && !this._hasSample) this.limit(1);
+		if (!this._hasWhereId && !this._hasSample && !this._hasGroup) this.limit(1);
 		const res = (await this.many()).at(0);
 		if (!res) throw createCloudObjectError("查询数据为空", "firstOrThrow");
 		return res;
@@ -573,7 +626,7 @@ var Db = class Db {
 	*/
 	async firstOrNull() {
 		if (this._hasLimit) throw new Error("db.firstOrNull() 方法不支持 limit 条件");
-		if (!this._hasWhereId && !this._hasSample) this.limit(1);
+		if (!this._hasWhereId && !this._hasSample && !this._hasGroup) this.limit(1);
 		return (await this.many()).at(0) || null;
 	}
 	/**
@@ -584,6 +637,7 @@ var Db = class Db {
 		if (this._isTransaction) throw new Error("db.count() 方法不支持事务模式");
 		if (this._hasSample) throw new Error("db.count() 方法不支持 sample 取样");
 		if (this._hasLookup) throw new Error("db.count() 方法不支持 lookup 聚合");
+		if (this._hasGroup) throw new Error("db.count() 方法不支持 group 分组");
 		if (this._hasSelect) throw new Error("db.count() 方法不支持 select 条件");
 		if (this._hasOrder) throw new Error("db.count() 方法不支持 order 条件");
 		if (this._hasSkip) throw new Error("db.count() 方法不支持 skip 条件");
@@ -604,6 +658,7 @@ var Db = class Db {
 	*/
 	async create(data) {
 		if (this._hasLookup) throw new Error("db.create() 方法不支持 lookup 聚合");
+		if (this._hasGroup) throw new Error("db.create() 方法不支持 group 分组");
 		if (this._hasWhere) throw new Error("db.create() 方法不支持 where 条件");
 		if (this._hasSelect) throw new Error("db.create() 方法不支持 select 条件");
 		if (this._hasOrder) throw new Error("db.create() 方法不支持 order 条件");
@@ -625,6 +680,7 @@ var Db = class Db {
 	*/
 	async update(data) {
 		if (this._hasLookup) throw new Error("db.update() 方法不支持 lookup 聚合");
+		if (this._hasGroup) throw new Error("db.update() 方法不支持 group 分组");
 		if (!this._hasWhere) throw new Error("设置 where 条件后才能执行 db.update() 方法");
 		if (this._hasSelect) throw new Error("db.update() 方法不支持 select 条件");
 		if (this._hasOrder) throw new Error("db.update() 方法不支持 order 条件");
@@ -646,6 +702,7 @@ var Db = class Db {
 	*/
 	async remove() {
 		if (this._hasLookup) throw new Error("db.remove() 方法不支持 lookup 聚合");
+		if (this._hasGroup) throw new Error("db.remove() 方法不支持 group 分组");
 		if (!this._hasWhere) throw new Error("设置 where 条件后才能执行 db.remove() 方法");
 		if (this._hasSelect) throw new Error("db.remove() 方法不支持 select 条件");
 		if (this._hasOrder) throw new Error("db.remove() 方法不支持 order 条件");
@@ -670,6 +727,12 @@ function _mapCommandRaw(data) {
 	};
 	return objectMap(data, map);
 }
+function _mapGroupRaw(group) {
+	const result = {};
+	for (const [key, value] of Object.entries(group)) if (value instanceof DbGroupCommand) result[key] = value.toAggregate();
+	else result[key] = value;
+	return result;
+}
 function _mapOrderSelect(order) {
 	return objectMap(order, (_val, _key) => true);
 }

package/dist/database.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database.mjs","names":[],"sources":["../src/database/_command.class.ts","../src/database/command.ts","../src/database/each.ts","../src/database/error.ts","../src/database/paging.ts","../src/database/_db.class.ts","../src/database/proxy.ts","../src/database/transaction.ts","../src/database/upsert.ts","../src/database/unique.ts"],"sourcesContent":["// 设置私有属性和静态方法是避免在 update 的时候提示类属性\n\nexport class DbBaseCommand {\n  protected _isQuery = false;\n  protected _isMutate = false;\n\n  constructor(\n    private _command: string,\n    private _parameter: unknown,\n    private _options?: {\n      formatParameter?: (db: UniCloud.Database) => unknown;\n      rewriteValue?: (db: UniCloud.Database, parameter: unknown) => unknown;\n    },\n  ) {}\n\n  static getValue(cmd: DbBaseCommand, db: UniCloud.Database) {\n    if (cmd._options?.rewriteValue) {\n      return cmd._options.rewriteValue(db, cmd._parameter);\n    }\n\n    return (db.command as unknown as Record<string, (value: unknown) => unknown>)[cmd._command].call(\n      db.command,\n      cmd._options?.formatParameter?.(db) || cmd._parameter,\n    );\n  }\n\n  static getExpression(cmd: DbBaseCommand, fieldName: string) {\n    return {\n      [`$${cmd._command}`]: [fieldName, cmd._parameter],\n    };\n  }\n\n  static isQueryCommand(cmd: DbBaseCommand) {\n    return cmd._isQuery;\n  }\n\n  static isMutateCommand(cmd: DbBaseCommand) {\n    return cmd._isMutate;\n  }\n}\n\nexport class DbQueryCommand extends DbBaseCommand {\n  protected _isQuery = true;\n}\n\nexport class DbMutateCommand extends DbBaseCommand {\n  protected _isMutate = true;\n}\n","import { DbBaseCommand, DbMutateCommand, DbQueryCommand } from './_command.class';\n\n/**\n * 数据库查询命令对象，提供各种查询操作符\n */\nexport const dbQuery = {\n  /**\n   * 等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  eq: (value: unknown) => new DbQueryCommand('eq', value),\n\n  /**\n   * 不等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  neq: (value: unknown) => new DbQueryCommand('neq', value),\n\n  /**\n   * 大于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  gt: (value: unknown) => new DbQueryCommand('gt', value),\n\n  /**\n   * 大于等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  gte: (value: unknown) => new DbQueryCommand('gte', value),\n\n  /**\n   * 小于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  lt: (value: unknown) => new DbQueryCommand('lt', value),\n\n  /**\n   * 小于等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  lte: (value: unknown) => new DbQueryCommand('lte', value),\n\n  /**\n   * 包含在数组中操作符\n   * @param value 值数组\n   * @returns DbQueryCommand 查询命令对象\n   */\n  in: (value: unknown[]) => new DbQueryCommand('in', value),\n\n  /**\n   * 不包含在数组中操作符\n   * @param value 值数组\n   * @returns DbQueryCommand 查询命令对象\n   */\n  nin: (value: unknown[]) => new DbQueryCommand('nin', value),\n\n  /**\n   * 数组长度匹配操作符\n   * @param size 数组长度\n   * @returns DbQueryCommand 查询命令对象\n   */\n  size: (size: number) => new DbQueryCommand('size', size),\n\n  /**\n   * 正则表达式匹配操作符\n   * @param regExp 正则表达式\n   * @returns DbQueryCommand 查询命令对象\n   */\n  regExp: (regExp: RegExp) =>\n    new DbQueryCommand('regExp', regExp, {\n      rewriteValue: (_db, parameter) => parameter,\n    }),\n\n  /**\n   * 逻辑与操作符\n   * @param conditions 查询条件参数\n   * @returns DbQueryCommand 查询命令对象\n   */\n  and: (conditions: DbQueryCommand[]) =>\n    new DbQueryCommand('and', conditions, {\n      formatParameter: (db) => conditions.map((c) => DbBaseCommand.getValue(c, db)),\n    }),\n\n  /**\n   * 逻辑或操作符\n   * @param conditions 查询条件参数\n   * @returns DbQueryCommand 查询命令对象\n   */\n  or: (conditions: DbQueryCommand[]) =>\n    new DbQueryCommand('or', conditions, {\n      formatParameter: (db) => conditions.map((c) => DbBaseCommand.getValue(c, db)),\n    }),\n};\n\n/**\n * 数据库变更命令对象，提供各种数据更新操作符\n */\nexport const dbMutate = {\n  /**\n   * 数值增加操作符\n   * @param value 增加的数值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  inc: (value: number) => new DbMutateCommand('inc', value),\n\n  /**\n   * 数值乘法操作符\n   * @param value 乘数\n   * @returns DbMutateCommand 变更命令对象\n   */\n  mul: (value: number) => new DbMutateCommand('mul', value),\n\n  /**\n   * 设置字段值操作符\n   * @param value 设置的值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  set: (value: unknown) => new DbMutateCommand('set', value),\n\n  /**\n   * 向数组末尾添加元素操作符\n   * @param value 添加的值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  push: (value: unknown) => new DbMutateCommand('push', value),\n\n  /**\n   * 向数组开头添加元素操作符\n   * @param value 添加的值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  unshift: (value: unknown) => new DbMutateCommand('unshift', value),\n\n  /**\n   * 从数组末尾移除元素操作符\n   * @returns DbMutateCommand 变更命令对象\n   */\n  pop: () => new DbMutateCommand('pop', undefined),\n\n  /**\n   * 从数组开头移除元素操作符\n   * @returns DbMutateCommand 变更命令对象\n   */\n  shift: () => new DbMutateCommand('shift', undefined),\n\n  /**\n   * 移除字段操作符\n   * @returns DbMutateCommand 变更命令对象\n   */\n  remove: () => new DbMutateCommand('remove', undefined),\n};\n","import type { Db } from './_db.class';\nimport type { DbWhere } from './types';\n\n/**\n * 遍历表中的每一行数据并执行回调函数\n *\n * 采用分批查询策略，每批查询 100 条记录，通过 skip/limit 实现分页遍历，\n * 避免一次性加载大量数据导致内存溢出。\n *\n * 迭代器按顺序串行执行，即每一行数据的迭代器完成后才会处理下一行。\n *\n * @template T - 数据行类型\n * @param table 数据库表代理对象\n * @param where 查询条件\n * @param iterator 对每一行数据执行的异步迭代器函数\n * @param maxCount 最大遍历数量，默认值为 Number.MAX_SAFE_INTEGER。\n *   注意：由于分批查询机制（每批 100 条），实际遍历的行数可能略大于 maxCount，\n *   例如 maxCount=150 时，会分两批查询（0-99、100-199），实际遍历 200 行。\n * @example\n * ```ts\n * // 遍历所有状态为 active 的用户\n * await dbEach(userTable, { status: 'active' }, async (user) => {\n *   await sendEmail(user.email);\n * });\n *\n * // 限制最多遍历 500 条记录\n * await dbEach(orderTable, { status: 'pending' }, async (order) => {\n *   await processOrder(order);\n * }, 500);\n * ```\n */\nexport async function dbEach<T>(\n  table: Db<T>,\n  where: DbWhere<T>,\n  iterator: (row: T) => Promise<unknown>,\n  maxCount = Number.MAX_SAFE_INTEGER,\n) {\n  const count = Math.min(await table.where(where).count(), maxCount);\n  const limit = 100;\n\n  for (let skip = 0; skip < count; skip += limit) {\n    const rows = await table.where(where).limit(limit).skip(skip).many();\n\n    for (const row of rows) {\n      await iterator(row as T);\n    }\n  }\n}\n","/**\n * 数据库底层异常类\n * 当 uniCloud 数据库操作抛出错误时，统一包装为该异常\n */\nexport class DbError extends Error {\n  /** 原始错误码，如 'InternalServerError' */\n  errCode: string | number;\n  /** MongoDB 错误码，如 'E11000'。不匹配则为空字符串 */\n  dbCode: string;\n\n  constructor(message: string, extra: { errCode: string | number; dbCode: string }) {\n    super(message);\n    this.name = 'DbError';\n    this.errCode = extra.errCode;\n    this.dbCode = extra.dbCode;\n  }\n}\n\n/**\n * 判断错误是否为数据库底层错误\n * @param err - 任意错误对象\n * @returns 是否为 DbError\n */\nexport function isDbError(err: unknown): err is DbError {\n  return err instanceof DbError;\n}\n\n/**\n * 从 MongoDB 错误消息中提取错误码\n * @param errMsg - 错误消息字符串，如 'E11000 duplicate key error...'\n * @returns MongoDB 错误码，如 'E11000'\n */\nexport function extractMongoCode(errMsg: string): string {\n  const m = errMsg.match(/^E\\d+/);\n  return m ? m[0] : '';\n}\n","import type { AnyObject } from '@cloudcome/utils-core/types';\nimport type { Db } from './_db.class';\nimport type { DbSelect } from './types';\n\n/**\n * 数据库分页查询函数\n * @template T - 数据类型\n * @param queryDb - 数据库查询实例\n * @returns 包含数据列表和总数的对象\n */\n\nexport async function dbPaging<\n  D1,\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  S1 extends DbSelect<D1> = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  D2 extends AnyObject = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  W2 extends AnyObject = {},\n>(queryDb: Db<D1, S1, D2, W2>) {\n  // 获取原始查询条件，不包映射字段\n  const where = queryDb.getWhere(true);\n\n  // 克隆查询实例用于统计总数，避免影响原查询\n  const countDb = queryDb.clone();\n\n  // 执行查询获取数据列表\n  const list = await queryDb.many();\n\n  // 基于相同查询条件统计总数\n  const total = await countDb.where(where).count();\n\n  // 返回分页结果\n  return {\n    list,\n    total,\n  };\n}\n","import { isUniError, parseDatabaseOutput } from '@/_helpers';\nimport type { UniError } from '@/_types';\nimport { createCloudObjectError } from '@/cloud';\nimport { objectEach, objectFilter, objectMap, objectOmit } from '@cloudcome/utils-core/object';\nimport { isArray, isObject } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MergeIntersection } from '@cloudcome/utils-core/types';\nimport { DbBaseCommand, type DbQueryCommand } from './_command.class';\nimport { DbError, extractMongoCode } from './error';\nimport type { DbCreate, DbForeign, DbOrder, DbQuery, DbRelation, DbSelect, DbUpdate, DbWhere } from './types';\n\n/**\n * 数据库聚合操作符命令\n */\nconst dbAgg = uniCloud.database().command.aggregate as UniCloud.AggregateCommand & {\n  pipeline: () => UniCloud.AggregateReference & {\n    done: () => unknown;\n  };\n};\n\nconst db0 = uniCloud.database();\n\nexport type DbOptions = {\n  /**\n   * 数据表名称\n   */\n  table: string;\n\n  /**\n   * 事务对象，用于事务操作\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n  transaction?: any;\n\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n  _mockDatabase?: any;\n\n  /**\n   * 自定义错误处理函数\n   * @param error unknown 数据库异常对象\n   * @returns 自定义错误对象\n   */\n  parseError?: (error: unknown) => UniError;\n};\n\nexport type DbLookupOptions<\n  RL extends DbRelation,\n  D1,\n  FD1,\n  AS,\n  // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n  US extends boolean | undefined | void = undefined,\n  LF extends keyof D1 & string = keyof D1 & string,\n> = {\n  /**\n   * 关联类型\n   */\n  relation: RL;\n\n  /**\n   * 主表字段\n   */\n  localField: LF;\n\n  /**\n   * 关联表字段\n   */\n  foreignField: keyof FD1 & string;\n\n  /**\n   * 关联数据在结果中的字段名\n   */\n  as: AS;\n\n  /**\n   * 是否取消筛选关联数据\n   */\n  unselect?: US;\n};\n\nexport type DbLookup = DbLookupOptions<\n  // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n  any,\n  unknown,\n  unknown,\n  string,\n  boolean\n> & {\n  /**\n   * 关联表\n   */\n  table: Db<unknown>;\n};\n\nlet gid = 0;\n\n/**\n * 数据库类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @template D2 - 副表数据\n * @template W2 - 副表查询\n */\nexport class Db<\n  D1,\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  S1 extends DbSelect<D1> = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  D2 extends AnyObject = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  W2 extends AnyObject = {},\n> {\n  /**\n   * 是否为事务环境\n   * - 更新条件只能是 id\n   * - 删除条件只能是 id\n   */\n  private _isTransaction = false;\n\n  private _options: DbOptions;\n\n  /**\n   * 构造函数，初始化数据库集合引用\n   * @param collection 数据表名称\n   * @param _mockDatabase 模拟数据库，用于单元测试\n   */\n  constructor(options: DbOptions) {\n    this._options = options;\n    // hostRef =\n    //   options._mockDatabase || options.transaction?.collection(options.table) || db0.collection(options.table);\n    this._isTransaction = !!options.transaction;\n  }\n\n  /**\n   * 创建一个新的数据库实例，可选是否移除事务\n   * @param withoutTransaction 是否移除事务，默认 false\n   * @returns 新的数据库实例\n   */\n  clone(withoutTransaction?: boolean) {\n    return new Db({\n      ...this._options,\n      transaction: withoutTransaction ? null : this._options.transaction,\n    });\n  }\n\n  get table() {\n    return this._options.table;\n  }\n\n  get options() {\n    return this._options;\n  }\n\n  get isTransaction() {\n    return this._isTransaction;\n  }\n\n  _createHost(withoutTransaction?: boolean) {\n    const options = this._options;\n    return (\n      options._mockDatabase ||\n      (withoutTransaction ? null : options.transaction?.collection(options.table) || db0.collection(options.table))\n    );\n  }\n\n  /**\n   * 获取聚合操作实例\n   * @returns 聚合操作实例\n   */\n  _createAggregate() {\n    const host = this._createHost();\n    return host.aggregate();\n  }\n\n  private _hasWhere = false;\n  private _hasWhereId = false;\n  private _where = {};\n\n  /**\n   * 设置查询条件\n   * @param where 查询条件对象\n   * @returns 当前Db实例，支持链式调用\n   */\n  where(where: DbWhere<D1> & W2) {\n    if (this._isTransaction) throw new Error('事务模式下请使用 whereId() 方法');\n    if (this._hasWhere) throw new Error('已调用过一次 db.where({...}) 或 db.whereId(id) 了');\n\n    // 过滤掉值为 undefined 的键值对，数据库不支持查询全 undefined 值\n    const realWhere = objectFilter(where, (value) => value !== undefined);\n\n    this._hasWhere = true;\n    this._where = realWhere;\n\n    return this;\n  }\n\n  /**\n   * 获取当前查询条件\n   * @param plain 是否返回原始查询条件对象，默认 false\n   * @returns 当前查询条件对象\n   */\n  getWhere(plain?: boolean) {\n    return plain\n      ? // biome-ignore lint/suspicious/noTsIgnore: 必须这么用\n        // @ts-ignore\n        objectOmit(this._where, Object.keys(this._lookupAs))\n      : this._where;\n  }\n\n  /**\n   * 根据ID设置查询条件\n   * @param id 记录ID\n   * @returns 当前Db实例，支持链式调用\n   */\n  whereId(id: string | number) {\n    if (this._hasWhere) throw new Error('已调用过一次 db.where({...}) 或 db.whereId(id) 了');\n    if (this._hasLimit) throw new Error('db.whereId(id) 方法不能与 db.limit() 方法同时调用');\n\n    this._hasWhere = true;\n    this._hasWhereId = true;\n    this._where = { _id: id };\n\n    return this;\n  }\n\n  private _hasSelect = 0;\n  private _select = {};\n\n  /**\n   * 指定要返回的字段\n   * @param fields 要返回的字段对象，true表示返回，false表示不返回\n   * @returns 当前Db实例，支持链式调用\n   */\n  select<const S extends DbSelect<D1>>(fields: S) {\n    if (this._hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n    this._hasSelect++;\n    this._select = fields;\n\n    return this as Db<D1, S, D2, W2>;\n  }\n\n  private _hasOrder = 0;\n  private _order = {};\n\n  /**\n   * 设置排序规则\n   * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n   * @returns 当前Db实例，支持链式调用\n   */\n  order(order: DbOrder<D1>) {\n    if (this._isTransaction) throw new Error('db.order() 方法不支持事务模式');\n\n    this._hasOrder++;\n    this._order = order;\n\n    return this;\n  }\n\n  private _hasSkip = 0;\n  private _skip = 0;\n\n  /**\n   * 跳过指定数量的记录\n   * @param skip 要跳过的记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  skip(skip: number) {\n    if (this._isTransaction) throw new Error('db.skip() 方法不支持事务模式');\n    if (this._hasSkip) throw new Error('db.skip() 方法只能调用一次');\n\n    this._hasSkip++;\n    this._skip = skip;\n\n    return this;\n  }\n\n  private _hasLimit = 0;\n  private _limit = 0;\n\n  /**\n   * 限制返回的记录数量\n   * @param limit 最大返回记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  limit(limit: number) {\n    if (this._isTransaction) throw new Error('db.limit() 方法不支持事务模式');\n    if (this._hasLimit) throw new Error('db.limit() 方法只能调用一次');\n    if (this._hasSample) throw new Error('db.limit() 方法不支持 sample 条件');\n\n    if (this._hasWhereId) {\n      throw new Error('db.limit() 方法不能与 db.whereId(id) 方法同时调用');\n    }\n\n    this._hasLimit++;\n    this._limit = limit;\n\n    return this;\n  }\n\n  private _hasSample = 0;\n  private _sampleSize = 0;\n\n  /**\n   * 随机从文档中选取指定数量的记录\n   * @param size 要选取的记录数量，必须为正整数\n   * @returns 当前Db实例，支持链式调用\n   */\n  sample(size: number) {\n    if (this._isTransaction) throw new Error('db.sample() 方法不支持事务模式');\n    if (this._hasSample) throw new Error('db.sample() 方法只能调用一次');\n    if (this._hasLimit) throw new Error('db.sample() 方法不支持 limit 条件');\n\n    this._hasSample++;\n    this._sampleSize = size;\n\n    return this;\n  }\n\n  private _hasLookup = 0;\n  get hasLookup() {\n    return this._hasLookup > 0;\n  }\n\n  private _lookups: DbLookup[] = [];\n  lookup<\n    FD1,\n    FS1 extends DbSelect<FD1>,\n    FD2 extends AnyObject,\n    FW2 extends AnyObject,\n    RL extends DbRelation,\n    AS extends string,\n    // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n    US extends boolean | undefined | void = undefined,\n    LF extends keyof D1 & string = keyof D1 & string,\n  >(table: Db<FD1, FS1, FD2, FW2>, lookup: DbLookupOptions<RL, D1, FD1, AS, US, LF>) {\n    if (this._isTransaction) throw new Error('db.lookup() 方法不支持事务模式');\n\n    // 对方表也记为关联查询，避免做表更新操作\n    table._hasLookup++;\n    this._hasLookup++;\n    this._lookups.push({\n      ...lookup,\n      table,\n    } as unknown as DbLookup);\n\n    // @ts-expect-error\n    return this as Db<\n      D1,\n      S1,\n      US extends true ? D2 : MergeIntersection<D2 & DbForeign<D1, FD1, FS1, FD2, RL, AS, LF>>,\n      MergeIntersection<W2 & Partial<Record<AS, DbQueryCommand>>>\n    >;\n  }\n\n  private _ending = false;\n\n  private _aggregated = false;\n  private _lookupAs = {} as Record<string, true>;\n  private _endAggregate(aggRef: UniCloud.AggregateReference) {\n    if (this._aggregated) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n    if (this._ending) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n\n    this._ending = true;\n    this._aggregated = true;\n    let returnAggRef = aggRef;\n    let _hasAggSelect = 0;\n    const aggSelect = {} as Record<string, true>;\n    let hasAggUnselect = 0;\n    const aggUnselect = {} as Record<string, false>;\n\n    // 后做关联查询\n    for (const { relation: type, as, foreignField, localField, table, unselect } of this._lookups) {\n      const letName = `let${gid++}`;\n      let pipeline = dbAgg.pipeline();\n\n      // 关联条件\n      // @ts-expect-error\n      pipeline = pipeline.match({\n        $expr: {\n          $and: [\n            type === 'n:1'\n              ? { $in: [`$${foreignField}`, `$$${letName}`] }\n              : { $eq: [`$${foreignField}`, `$$${letName}`] },\n          ],\n        },\n      });\n\n      // 其他查询条件\n      // @ts-expect-error\n      pipeline = table._endAggregate(pipeline);\n\n      // @ts-expect-error\n      pipeline = pipeline.done();\n\n      returnAggRef = returnAggRef.lookup({\n        let: {\n          [letName]: `$${localField}`,\n        },\n        as,\n        from: table.table,\n        pipeline,\n      });\n\n      // 1对1，展开数组\n      if (type === '1:1') {\n        // @ts-expect-error\n        returnAggRef = returnAggRef.unwind({\n          path: `$${as}`,\n          preserveNullAndEmptyArrays: true,\n        });\n      }\n\n      if (unselect) {\n        hasAggUnselect++;\n        aggUnselect[as] = false;\n      } else {\n        _hasAggSelect++;\n        aggSelect[as] = true;\n      }\n\n      this._lookupAs[as] = true;\n    }\n\n    // 主表查询，注意顺序，筛选->排序->跳过->限制\n    if (this._hasWhere) returnAggRef = returnAggRef.match(_mapCommandRaw(this._where));\n    if (this._hasSample) returnAggRef = returnAggRef.sample({ size: this._sampleSize });\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    // 如果主表有选择字段，则合并选择字段（包括关联查询的字段和排序字段）\n    if (this._hasSelect) {\n      returnAggRef = returnAggRef.project(_mergeSelect({ ...this._select, ...aggSelect }, this._order));\n    }\n    // 如果主表没有选择字段，则排除取消选择字段\n    else if (hasAggUnselect) {\n      returnAggRef = returnAggRef.project(aggUnselect);\n    }\n\n    return returnAggRef;\n  }\n\n  private _endHost(host: UniCloud.CollectionReference, action: 'query' | 'create' | 'update' | 'remove' | 'count') {\n    if (this._ending) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n    this._ending = true;\n\n    // 事务模式下：查询/更新/删除必须使用 whereId\n    if (\n      this._isTransaction &&\n      (action === 'query' || action === 'update' || action === 'remove') &&\n      !this._hasWhereId\n    ) {\n      throw new Error('事务模式下查询/更新/删除条件只能是 ID，请使用 whereId() 方法');\n    }\n\n    let hostRef = host;\n    if (this._hasWhere) {\n      // 事务模式下：更新/删除/查询只能用 doc(id)\n      if (this._isTransaction && (action === 'update' || action === 'remove' || action === 'query')) {\n        // @ts-expect-error\n        hostRef = hostRef.doc(this._where._id);\n      } else {\n        // @ts-expect-error\n        hostRef = hostRef.where(_mapCommandRaw(this._where));\n      }\n    }\n\n    if (this._hasSelect) {\n      // @ts-expect-error\n      hostRef = hostRef.field(_mergeSelect(this._select, this._order));\n    }\n\n    if (this._hasOrder) {\n      objectEach(this._order, (val, key) => {\n        // @ts-expect-error\n        hostRef = hostRef.orderBy(key, val);\n      });\n    }\n\n    // @ts-expect-error\n    if (this._hasSkip) hostRef = hostRef.skip(this._skip);\n\n    if (this._hasLimit && action === 'query')\n      // @ts-expect-error\n      hostRef = hostRef.limit(this._limit);\n    else if (this._hasWhereId && action === 'query' && !this._isTransaction)\n      // @ts-expect-error\n      hostRef = hostRef.limit(1);\n\n    return hostRef;\n  }\n\n  /**\n   * 将 uniCloud 数据库原始错误包装为 DbError\n   * @param err - 原始错误对象，来自 uniCloud DB 操作（Error 实例，含 errMsg、errCode 属性）\n   * @returns DbError 实例\n   */\n  private _parseDbError(err: UniError) {\n    const errCode = err.errCode || '';\n    const message = err.errMsg || err.message;\n    const dbCode = extractMongoCode(err.errMsg || err.message);\n\n    if (dbCode) {\n      return new DbError(message, {\n        errCode: errCode,\n        dbCode: dbCode,\n      });\n    } else {\n      return err;\n    }\n  }\n\n  /**\n   * 统一处理 DB 操作抛出的错误\n   * - uniCloud 数据库错误（含 errMsg）→ 包装为 DbError → 经 parseError 回调后抛出\n   * - 非数据库错误（如网络中断）→ 原样抛出\n   */\n  private _handleDbError(err: unknown): never {\n    if (isUniError(err)) {\n      const dbErr = this._parseDbError(err);\n      throw this._options.parseError?.(dbErr) || dbErr;\n    } else {\n      throw this._options.parseError?.(err) || err;\n    }\n  }\n\n  /**\n   * 执行查询操作\n   * @returns 查询结果\n   */\n  async many() {\n    try {\n      let res: { data: DbQuery<D1, S1, D2>[] | DbQuery<D1, S1, D2> | undefined };\n\n      // 事务模式下不支持聚合查询\n      if (this._isTransaction && (this._hasLookup || this._hasSample)) {\n        throw new Error('事务模式下不支持 lookup 聚合或 sample 取样查询');\n      }\n\n      // 关联查询 / sample 查询（sample 依赖聚合管线）\n      if (this._hasLookup || this._hasSample) {\n        let aggRef = this._createAggregate();\n        aggRef = this._endAggregate(aggRef);\n        res = await aggRef.end();\n      }\n      // 单表查询\n      else {\n        let hostRef = this._createHost();\n        hostRef = this._endHost(hostRef, 'query');\n        res = await hostRef.get();\n      }\n\n      const { data } = parseDatabaseOutput(res);\n\n      // doc(id).get() 返回单个对象或 undefined，需包装为数组以统一 many() 返回值\n      return isArray(data) ? data : data ? [data] : [];\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * 如果没有匹配到记录，会抛出错误\n   * @returns 查询结果\n   */\n  async firstOrThrow(): Promise<DbQuery<D1, S1, D2>> {\n    if (this._hasLimit) throw new Error('db.firstOrThrow() 方法不支持 limit 条件');\n    if (!this._hasWhereId && !this._hasSample) this.limit(1);\n\n    const data = await this.many();\n    const res = data.at(0);\n\n    if (!res) throw createCloudObjectError('查询数据为空', 'firstOrThrow');\n    return res;\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * 如果没有匹配到记录，返回 null\n   * @returns 查询结果或 null\n   */\n  async firstOrNull(): Promise<DbQuery<D1, S1, D2> | null> {\n    if (this._hasLimit) throw new Error('db.firstOrNull() 方法不支持 limit 条件');\n    if (!this._hasWhereId && !this._hasSample) this.limit(1);\n\n    const data = await this.many();\n    return data.at(0) || null;\n  }\n\n  /**\n   * 获取匹配记录的数量\n   * @returns 记录总数\n   */\n  async count() {\n    if (this._isTransaction) throw new Error('db.count() 方法不支持事务模式');\n    if (this._hasSample) throw new Error('db.count() 方法不支持 sample 取样');\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'count');\n      const res = await hostRef.count();\n      const { total } = parseDatabaseOutput<{ total: number }>(res);\n      return total;\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n\n  /**\n   * 创建新记录\n   * @param data 要创建的数据\n   * @returns 创建结果\n   */\n  async create(data: DbCreate<D1>) {\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'create');\n      const res = await hostRef.add(data);\n      const { id } = parseDatabaseOutput<{ id: string }>(res);\n      return id;\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n\n  /**\n   * 更新记录\n   * @param data 要更新的数据\n   * @returns 更新结果\n   */\n  async update(data: DbUpdate<D1>) {\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'update');\n      const res = await hostRef.update(objectOmit(_mapCommandRaw(data), ['_id']));\n      const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n      return updated;\n    } catch (err) {\n      this._handleDbError(err);\n    }\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'remove');\n      const res = await hostRef.remove();\n      const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n      return deleted;\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: 必须这么用\nfunction _mapCommandRaw(data: any) {\n  // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n  const map = (val: any): any => {\n    if (!isObject(val)) return val;\n    if (val instanceof DbBaseCommand) return DbBaseCommand.getValue(val, db0);\n    return objectMap(val, map);\n  };\n\n  return objectMap(data, map);\n}\n\nfunction _mapOrderSelect(order: DbOrder<unknown>) {\n  return objectMap(order, (_val, _key) => true);\n}\n\nfunction _mergeSelect(select: DbSelect<unknown>, order: DbOrder<unknown>) {\n  const noSelect = Object.keys(select).length === 0;\n  // 如果没有 select 条件，默认返回所有字段\n  if (noSelect) return select;\n\n  const onlyOmitId = Object.keys(select).length === 1 && '_id' in select && select._id === false;\n  // 如果只排除 _id 字段，则保持现状\n  if (onlyOmitId) return select;\n\n  return {\n    ...select,\n    ..._mapOrderSelect(order),\n  };\n}\n","import { isFunction } from '@cloudcome/utils-core/type';\nimport { Db } from './_db.class';\nimport type { DbSelect } from './types';\nimport type { UniError } from '@/_types';\n\nexport type DbProxyOptions = {\n  /**\n   * 自定义错误处理函数\n   * @param error unknown 数据库异常对象\n   * @returns 自定义错误对象\n   */\n  parseError?: (error: unknown) => UniError;\n};\n\n/**\n * 创建一个数据库代理对象，用于延迟实例化数据库操作类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @param name - 数据库表名\n * @returns 返回一个代理对象，该对象会将属性访问转发到实际的数据库操作实例\n */\n\n// biome-ignore lint/complexity/noBannedTypes: 必须这么用\nexport function dbProxy<D1, S1 extends DbSelect<D1> = {}>(name: string, options?: DbProxyOptions) {\n  return new Proxy(\n    {},\n    {\n      get(_target, prop) {\n        if (prop === '_isProxy') return true;\n\n        const table = new Db<D1, S1>({ table: name, ...options });\n        const tableProp = prop as keyof Db<D1, S1>;\n        const ref = table[tableProp];\n\n        return isFunction(ref) ? ref.bind(table) : ref;\n      },\n    },\n  ) as Db<D1, S1>;\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { Db } from './_db.class';\n\ntype _TransactionDb = {\n  startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n  commit: () => Promise<unknown>;\n  rollback: () => Promise<unknown>;\n};\n\nexport type WithTransaction = <D1>(db: Db<D1>) => Db<D1>;\n\n/**\n * 在数据库事务中执行操作\n *\n * @template K - 事务操作返回值类型\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: 单测使用 any\n  _mockDatabase?: any,\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\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: WithTransaction = <D1>(db: Db<D1>) => {\n    return _mockDbInstance || new Db<D1>({ ...db.options, 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","import { isFunction } from '@cloudcome/utils-core/type';\nimport type { Db } from './_db.class';\nimport type { DbCreate, DbQuery, DbUpdate } from './types';\n\nexport type DbUpsertOptions<T, C extends DbCreate<T>, U extends DbUpdate<T>> = {\n  /** 创建数据 */\n  create: C;\n\n  /**\n   * 更新数据，可以是对象或根据查询结果生成更新对象的函数\n   * @param row 查询到的文档数据，仅在传入函数时可用\n   */\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  update: U | ((exist: DbQuery<T, {}, {}>) => 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: 必须这么用\n  onBeforeUpdate?: (exist: DbQuery<T, {}, {}>) => false | unknown;\n\n  /**\n   * 更新后回调函数\n   * @param updateData 实际更新的数据\n   * @param exist 查询到的原始文档数据\n   */\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  onAfterUpdate?: (updateData: U, exist: DbQuery<T, {}, {}>) => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\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<D1, C extends DbCreate<D1>, U extends DbUpdate<D1>>(\n  db: Db<D1>,\n  options: DbUpsertOptions<D1, C, U>,\n): Promise<DbUpsertOutput> {\n  const { create, update, onBeforeCreate, onAfterCreate, onBeforeUpdate, onAfterUpdate, _mockDbInstance } = options;\n\n  const _mutateDb = (_mockDbInstance || db.clone()) as Db<D1>;\n  const _queryDb = (_mockDbInstance || db.clone(true)) as Db<D1>;\n\n  const exist = (await _queryDb\n    .where(db.getWhere(true))\n    // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n    .firstOrNull()) as DbQuery<D1, {}, {}> | null;\n\n  if (exist) {\n    const skipUpdate = (await onBeforeUpdate?.(exist)) === false;\n\n    if (skipUpdate) {\n      // @ts-expect-error\n      return { id: exist._id as string, updated: false, created: false };\n    }\n\n    const updateData = isFunction(update) ? update(exist) : update;\n    // @ts-expect-error\n    await _mutateDb.whereId(exist._id).update(updateData);\n    onAfterUpdate?.(updateData, exist);\n\n    // @ts-expect-error\n    return { id: exist._id as string, updated: true, created: false };\n  }\n\n  await onBeforeCreate?.();\n  const createdId = await _mutateDb.create(create);\n  await onAfterCreate?.(createdId);\n\n  return { id: createdId, updated: false, created: true };\n}\n","import type { Db } from './_db.class';\nimport type { DbCreate } from './types';\nimport { dbUpsert } from './upsert';\n\nexport type DbUniqueOptions<T, C extends DbCreate<T>> = {\n  /** 创建数据 */\n  create: C;\n\n  /** 创建前回调函数 */\n  onBeforeCreate?: () => unknown;\n\n  /**\n   * 创建后回调函数\n   * @param id 创建的文档ID\n   */\n  onAfterCreate?: (id: string) => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n  _mockDbInstance?: any;\n};\n\n/**\n * 数据库 upsert 操作的返回结果类型\n */\nexport type DbUniqueOutput = {\n  /** 操作的文档ID */\n  id: string;\n  /** 是否为创建操作 */\n  created: boolean;\n};\n\nexport async function dbUnique<T, C extends DbCreate<T>>(\n  db: Db<T>,\n  options: DbUniqueOptions<T, C>,\n): Promise<DbUniqueOutput> {\n  const { id, created } = await dbUpsert(db, {\n    ...options,\n    // @ts-expect-error\n    update: {},\n    onBeforeUpdate: () => false,\n  });\n  return { id, created };\n}\n"],"mappings":"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"}
+{"version":3,"file":"database.mjs","names":[],"sources":["../src/database/_command.class.ts","../src/database/command.ts","../src/database/each.ts","../src/database/error.ts","../src/database/paging.ts","../src/database/_db.class.ts","../src/database/proxy.ts","../src/database/transaction.ts","../src/database/upsert.ts","../src/database/unique.ts"],"sourcesContent":["// 设置私有属性和静态方法是避免在 update 的时候提示类属性\n\nexport class DbBaseCommand {\n  protected _isQuery = false;\n  protected _isMutate = false;\n  protected _isGroup = false;\n\n  constructor(\n    protected _command: string,\n    protected _parameter: unknown,\n    private _options?: {\n      formatParameter?: (db: UniCloud.Database) => unknown;\n      rewriteValue?: (db: UniCloud.Database, parameter: unknown) => unknown;\n    },\n  ) {}\n\n  static getValue(cmd: DbBaseCommand, db: UniCloud.Database) {\n    if (cmd._options?.rewriteValue) {\n      return cmd._options.rewriteValue(db, cmd._parameter);\n    }\n\n    return (db.command as unknown as Record<string, (value: unknown) => unknown>)[cmd._command].call(\n      db.command,\n      cmd._options?.formatParameter?.(db) || cmd._parameter,\n    );\n  }\n\n  static getExpression(cmd: DbBaseCommand, fieldName: string) {\n    return {\n      [`$${cmd._command}`]: [fieldName, cmd._parameter],\n    };\n  }\n\n  static isQueryCommand(cmd: DbBaseCommand) {\n    return cmd._isQuery;\n  }\n\n  static isMutateCommand(cmd: DbBaseCommand) {\n    return cmd._isMutate;\n  }\n}\n\nexport class DbQueryCommand extends DbBaseCommand {\n  protected _isQuery = true;\n}\n\nexport class DbMutateCommand extends DbBaseCommand {\n  protected _isMutate = true;\n}\n\nexport class DbGroupCommand<T> extends DbBaseCommand {\n  protected _isGroup = true;\n\n  /** Phantom type marker - compile-time only, used by `group()`'s `infer T` to extract per-accumulator value types */\n  declare readonly __type: T;\n\n  toAggregate(): Record<string, unknown> {\n    const value = typeof this._parameter === 'string' ? `$${this._parameter}` : this._parameter;\n    return { [`$${this._command}`]: value };\n  }\n}\n","import { DbBaseCommand, DbMutateCommand, DbQueryCommand } from './_command.class';\n\n/**\n * 数据库查询命令对象，提供各种查询操作符\n */\nexport const dbQuery = {\n  /**\n   * 等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  eq: (value: unknown) => new DbQueryCommand('eq', value),\n\n  /**\n   * 不等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  neq: (value: unknown) => new DbQueryCommand('neq', value),\n\n  /**\n   * 大于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  gt: (value: unknown) => new DbQueryCommand('gt', value),\n\n  /**\n   * 大于等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  gte: (value: unknown) => new DbQueryCommand('gte', value),\n\n  /**\n   * 小于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  lt: (value: unknown) => new DbQueryCommand('lt', value),\n\n  /**\n   * 小于等于操作符\n   * @param value 比较值\n   * @returns DbQueryCommand 查询命令对象\n   */\n  lte: (value: unknown) => new DbQueryCommand('lte', value),\n\n  /**\n   * 包含在数组中操作符\n   * @param value 值数组\n   * @returns DbQueryCommand 查询命令对象\n   */\n  in: (value: unknown[]) => new DbQueryCommand('in', value),\n\n  /**\n   * 不包含在数组中操作符\n   * @param value 值数组\n   * @returns DbQueryCommand 查询命令对象\n   */\n  nin: (value: unknown[]) => new DbQueryCommand('nin', value),\n\n  /**\n   * 数组长度匹配操作符\n   * @param size 数组长度\n   * @returns DbQueryCommand 查询命令对象\n   */\n  size: (size: number) => new DbQueryCommand('size', size),\n\n  /**\n   * 正则表达式匹配操作符\n   * @param regExp 正则表达式\n   * @returns DbQueryCommand 查询命令对象\n   */\n  regExp: (regExp: RegExp) =>\n    new DbQueryCommand('regExp', regExp, {\n      rewriteValue: (_db, parameter) => parameter,\n    }),\n\n  /**\n   * 逻辑与操作符\n   * @param conditions 查询条件参数\n   * @returns DbQueryCommand 查询命令对象\n   */\n  and: (conditions: DbQueryCommand[]) =>\n    new DbQueryCommand('and', conditions, {\n      formatParameter: (db) => conditions.map((c) => DbBaseCommand.getValue(c, db)),\n    }),\n\n  /**\n   * 逻辑或操作符\n   * @param conditions 查询条件参数\n   * @returns DbQueryCommand 查询命令对象\n   */\n  or: (conditions: DbQueryCommand[]) =>\n    new DbQueryCommand('or', conditions, {\n      formatParameter: (db) => conditions.map((c) => DbBaseCommand.getValue(c, db)),\n    }),\n};\n\n/**\n * 数据库变更命令对象，提供各种数据更新操作符\n */\nexport const dbMutate = {\n  /**\n   * 数值增加操作符\n   * @param value 增加的数值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  inc: (value: number) => new DbMutateCommand('inc', value),\n\n  /**\n   * 数值乘法操作符\n   * @param value 乘数\n   * @returns DbMutateCommand 变更命令对象\n   */\n  mul: (value: number) => new DbMutateCommand('mul', value),\n\n  /**\n   * 设置字段值操作符\n   * @param value 设置的值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  set: (value: unknown) => new DbMutateCommand('set', value),\n\n  /**\n   * 向数组末尾添加元素操作符\n   * @param value 添加的值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  push: (value: unknown) => new DbMutateCommand('push', value),\n\n  /**\n   * 向数组开头添加元素操作符\n   * @param value 添加的值\n   * @returns DbMutateCommand 变更命令对象\n   */\n  unshift: (value: unknown) => new DbMutateCommand('unshift', value),\n\n  /**\n   * 从数组末尾移除元素操作符\n   * @returns DbMutateCommand 变更命令对象\n   */\n  pop: () => new DbMutateCommand('pop', undefined),\n\n  /**\n   * 从数组开头移除元素操作符\n   * @returns DbMutateCommand 变更命令对象\n   */\n  shift: () => new DbMutateCommand('shift', undefined),\n\n  /**\n   * 移除字段操作符\n   * @returns DbMutateCommand 变更命令对象\n   */\n  remove: () => new DbMutateCommand('remove', undefined),\n};\n","import type { Db } from './_db.class';\nimport type { DbWhere } from './types';\n\n/**\n * 遍历表中的每一行数据并执行回调函数\n *\n * 采用分批查询策略，每批查询 100 条记录，通过 skip/limit 实现分页遍历，\n * 避免一次性加载大量数据导致内存溢出。\n *\n * 迭代器按顺序串行执行，即每一行数据的迭代器完成后才会处理下一行。\n *\n * @template T - 数据行类型\n * @param table 数据库表代理对象\n * @param where 查询条件\n * @param iterator 对每一行数据执行的异步迭代器函数\n * @param maxCount 最大遍历数量，默认值为 Number.MAX_SAFE_INTEGER。\n *   注意：由于分批查询机制（每批 100 条），实际遍历的行数可能略大于 maxCount，\n *   例如 maxCount=150 时，会分两批查询（0-99、100-199），实际遍历 200 行。\n * @example\n * ```ts\n * // 遍历所有状态为 active 的用户\n * await dbEach(userTable, { status: 'active' }, async (user) => {\n *   await sendEmail(user.email);\n * });\n *\n * // 限制最多遍历 500 条记录\n * await dbEach(orderTable, { status: 'pending' }, async (order) => {\n *   await processOrder(order);\n * }, 500);\n * ```\n */\nexport async function dbEach<T>(\n  table: Db<T>,\n  where: DbWhere<T>,\n  iterator: (row: T) => Promise<unknown>,\n  maxCount = Number.MAX_SAFE_INTEGER,\n) {\n  const count = Math.min(await table.where(where).count(), maxCount);\n  const limit = 100;\n\n  for (let skip = 0; skip < count; skip += limit) {\n    const rows = await table.where(where).limit(limit).skip(skip).many();\n\n    for (const row of rows) {\n      await iterator(row as T);\n    }\n  }\n}\n","/**\n * 数据库底层异常类\n * 当 uniCloud 数据库操作抛出错误时，统一包装为该异常\n */\nexport class DbError extends Error {\n  /** 原始错误码，如 'InternalServerError' */\n  errCode: string | number;\n  /** MongoDB 错误码，如 'E11000'。不匹配则为空字符串 */\n  dbCode: string;\n\n  constructor(message: string, extra: { errCode: string | number; dbCode: string }) {\n    super(message);\n    this.name = 'DbError';\n    this.errCode = extra.errCode;\n    this.dbCode = extra.dbCode;\n  }\n}\n\n/**\n * 判断错误是否为数据库底层错误\n * @param err - 任意错误对象\n * @returns 是否为 DbError\n */\nexport function isDbError(err: unknown): err is DbError {\n  return err instanceof DbError;\n}\n\n/**\n * 从 MongoDB 错误消息中提取错误码\n * @param errMsg - 错误消息字符串，如 'E11000 duplicate key error...'\n * @returns MongoDB 错误码，如 'E11000'\n */\nexport function extractMongoCode(errMsg: string): string {\n  const m = errMsg.match(/^E\\d+/);\n  return m ? m[0] : '';\n}\n","import type { AnyObject } from '@cloudcome/utils-core/types';\nimport type { Db } from './_db.class';\nimport type { DbSelect } from './types';\n\n/**\n * 数据库分页查询函数\n * @template T - 数据类型\n * @param queryDb - 数据库查询实例\n * @returns 包含数据列表和总数的对象\n */\n\nexport async function dbPaging<\n  D1,\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  S1 extends DbSelect<D1> = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  D2 extends AnyObject = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  W2 extends AnyObject = {},\n>(queryDb: Db<D1, S1, D2, W2>) {\n  // 获取原始查询条件，不包映射字段\n  const where = queryDb.getWhere(true);\n\n  // 克隆查询实例用于统计总数，避免影响原查询\n  const countDb = queryDb.clone();\n\n  // 执行查询获取数据列表\n  const list = await queryDb.many();\n\n  // 基于相同查询条件统计总数\n  const total = await countDb.where(where).count();\n\n  // 返回分页结果\n  return {\n    list,\n    total,\n  };\n}\n","import { isUniError, parseDatabaseOutput } from '@/_helpers';\nimport type { UniError } from '@/_types';\nimport { createCloudObjectError } from '@/cloud';\nimport { objectEach, objectFilter, objectMap, objectOmit } from '@cloudcome/utils-core/object';\nimport { isArray, isObject } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MergeIntersection } from '@cloudcome/utils-core/types';\nimport { DbBaseCommand, DbGroupCommand, type DbQueryCommand } from './_command.class';\nimport { DbError, extractMongoCode } from './error';\nimport type { DbCreate, DbForeign, DbOrder, DbQuery, DbRelation, DbSelect, DbUpdate, DbWhere } from './types';\n\n/**\n * 数据库聚合操作符命令\n */\nconst dbAgg = uniCloud.database().command.aggregate as UniCloud.AggregateCommand & {\n  pipeline: () => UniCloud.AggregateReference & {\n    done: () => unknown;\n  };\n};\n\nconst db0 = uniCloud.database();\n\nexport type DbOptions = {\n  /**\n   * 数据表名称\n   */\n  table: string;\n\n  /**\n   * 事务对象，用于事务操作\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n  transaction?: any;\n\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n  _mockDatabase?: any;\n\n  /**\n   * 自定义错误处理函数\n   * @param error unknown 数据库异常对象\n   * @returns 自定义错误对象\n   */\n  parseError?: (error: unknown) => UniError;\n};\n\nexport type DbLookupOptions<\n  RL extends DbRelation,\n  D1,\n  FD1,\n  AS,\n  // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n  US extends boolean | undefined | void = undefined,\n  LF extends keyof D1 & string = keyof D1 & string,\n> = {\n  /**\n   * 关联类型\n   */\n  relation: RL;\n\n  /**\n   * 主表字段\n   */\n  localField: LF;\n\n  /**\n   * 关联表字段\n   */\n  foreignField: keyof FD1 & string;\n\n  /**\n   * 关联数据在结果中的字段名\n   */\n  as: AS;\n\n  /**\n   * 是否取消筛选关联数据\n   */\n  unselect?: US;\n};\n\nexport type DbLookup = DbLookupOptions<\n  // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n  any,\n  unknown,\n  unknown,\n  string,\n  boolean\n> & {\n  /**\n   * 关联表\n   */\n  table: Db<unknown>;\n};\n\nlet gid = 0;\n\n/**\n * 数据库类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @template D2 - 副表数据\n * @template W2 - 副表查询\n */\nexport class Db<\n  D1,\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  S1 extends DbSelect<D1> = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  D2 extends AnyObject = {},\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  W2 extends AnyObject = {},\n> {\n  /**\n   * 是否为事务环境\n   * - 更新条件只能是 id\n   * - 删除条件只能是 id\n   */\n  private _isTransaction = false;\n\n  private _options: DbOptions;\n\n  /**\n   * 构造函数，初始化数据库集合引用\n   * @param collection 数据表名称\n   * @param _mockDatabase 模拟数据库，用于单元测试\n   */\n  constructor(options: DbOptions) {\n    this._options = options;\n    // hostRef =\n    //   options._mockDatabase || options.transaction?.collection(options.table) || db0.collection(options.table);\n    this._isTransaction = !!options.transaction;\n  }\n\n  /**\n   * 创建一个新的数据库实例，可选是否移除事务\n   * @param withoutTransaction 是否移除事务，默认 false\n   * @returns 新的数据库实例\n   */\n  clone(withoutTransaction?: boolean) {\n    return new Db({\n      ...this._options,\n      transaction: withoutTransaction ? null : this._options.transaction,\n    });\n  }\n\n  get table() {\n    return this._options.table;\n  }\n\n  get options() {\n    return this._options;\n  }\n\n  get isTransaction() {\n    return this._isTransaction;\n  }\n\n  _createHost(withoutTransaction?: boolean) {\n    const options = this._options;\n    return (\n      options._mockDatabase ||\n      (withoutTransaction ? null : options.transaction?.collection(options.table) || db0.collection(options.table))\n    );\n  }\n\n  /**\n   * 获取聚合操作实例\n   * @returns 聚合操作实例\n   */\n  _createAggregate() {\n    const host = this._createHost();\n    return host.aggregate();\n  }\n\n  private _hasWhere = false;\n  private _hasWhereId = false;\n  private _where = {};\n\n  /**\n   * 设置查询条件\n   * @param where 查询条件对象\n   * @returns 当前Db实例，支持链式调用\n   */\n  where(where: DbWhere<D1> & W2) {\n    if (this._isTransaction) throw new Error('事务模式下请使用 whereId() 方法');\n    if (this._hasWhere) throw new Error('已调用过一次 db.where({...}) 或 db.whereId(id) 了');\n\n    // 过滤掉值为 undefined 的键值对，数据库不支持查询全 undefined 值\n    const realWhere = objectFilter(where, (value) => value !== undefined);\n\n    this._hasWhere = true;\n    this._where = realWhere;\n\n    return this;\n  }\n\n  /**\n   * 获取当前查询条件\n   * @param plain 是否返回原始查询条件对象，默认 false\n   * @returns 当前查询条件对象\n   */\n  getWhere(plain?: boolean) {\n    return plain\n      ? // biome-ignore lint/suspicious/noTsIgnore: 必须这么用\n        // @ts-ignore\n        objectOmit(this._where, Object.keys(this._lookupAs))\n      : this._where;\n  }\n\n  /**\n   * 根据ID设置查询条件\n   * @param id 记录ID\n   * @returns 当前Db实例，支持链式调用\n   */\n  whereId(id: string | number) {\n    if (this._hasWhere) throw new Error('已调用过一次 db.where({...}) 或 db.whereId(id) 了');\n    if (this._hasLimit) throw new Error('db.whereId(id) 方法不能与 db.limit() 方法同时调用');\n\n    this._hasWhere = true;\n    this._hasWhereId = true;\n    this._where = { _id: id };\n\n    return this;\n  }\n\n  private _hasSelect = 0;\n  private _select = {};\n\n  /**\n   * 指定要返回的字段\n   * @param fields 要返回的字段对象，true表示返回，false表示不返回\n   * @returns 当前Db实例，支持链式调用\n   */\n  select<const S extends DbSelect<D1>>(fields: S) {\n    if (this._hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n    this._hasSelect++;\n    this._select = fields;\n\n    return this as Db<D1, S, D2, W2>;\n  }\n\n  private _hasOrder = 0;\n  private _order = {};\n\n  /**\n   * 设置排序规则\n   * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n   * @returns 当前Db实例，支持链式调用\n   */\n  order(order: DbOrder<D1>) {\n    if (this._isTransaction) throw new Error('db.order() 方法不支持事务模式');\n\n    this._hasOrder++;\n    this._order = order;\n\n    return this;\n  }\n\n  private _hasSkip = 0;\n  private _skip = 0;\n\n  /**\n   * 跳过指定数量的记录\n   * @param skip 要跳过的记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  skip(skip: number) {\n    if (this._isTransaction) throw new Error('db.skip() 方法不支持事务模式');\n    if (this._hasSkip) throw new Error('db.skip() 方法只能调用一次');\n\n    this._hasSkip++;\n    this._skip = skip;\n\n    return this;\n  }\n\n  private _hasLimit = 0;\n  private _limit = 0;\n\n  /**\n   * 限制返回的记录数量\n   * @param limit 最大返回记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  limit(limit: number) {\n    if (this._isTransaction) throw new Error('db.limit() 方法不支持事务模式');\n    if (this._hasLimit) throw new Error('db.limit() 方法只能调用一次');\n    if (this._hasSample) throw new Error('db.limit() 方法不支持 sample 条件');\n\n    if (this._hasWhereId) {\n      throw new Error('db.limit() 方法不能与 db.whereId(id) 方法同时调用');\n    }\n\n    this._hasLimit++;\n    this._limit = limit;\n\n    return this;\n  }\n\n  private _hasSample = 0;\n  private _sampleSize = 0;\n\n  private _hasGroup = 0;\n  private _group: Record<string, unknown> = {};\n\n  /**\n   * 随机从文档中选取指定数量的记录\n   * @param size 要选取的记录数量，必须为正整数\n   * @returns 当前Db实例，支持链式调用\n   */\n  sample(size: number) {\n    if (this._isTransaction) throw new Error('db.sample() 方法不支持事务模式');\n    if (this._hasSample) throw new Error('db.sample() 方法只能调用一次');\n    if (this._hasLimit) throw new Error('db.sample() 方法不支持 limit 条件');\n\n    this._hasSample++;\n    this._sampleSize = size;\n\n    return this;\n  }\n\n  /**\n   * 设置分组聚合条件\n   * @param field 分组字段，单个字段传入字段名，多个字段传入数组\n   * @param accumulators 累加器定义对象，value 使用 db.dbGroup 命令\n   * @returns 当前Db实例，支持链式调用\n   *\n   * @example\n   * ```typescript\n   * // 按单个字段分组计数\n   * .group('consecutiveDays', { count: db.dbGroup.sum(1) })\n   *\n   * // 按多字段组合分组求和\n   * .group(['year', 'month'], { total: db.dbGroup.sum('amount') })\n   * ```\n   */\n  group<const K extends keyof D1, const A extends Record<string, DbGroupCommand<any>>>(\n    field: K | readonly K[],\n    accumulators: A,\n  ) {\n    if (this._isTransaction) throw new Error('db.group() 方法不支持事务模式');\n    if (this._hasGroup) throw new Error('db.group() 方法只能调用一次');\n    if (this._hasSelect) throw new Error('db.group() 方法不支持 select 条件');\n    if (this._hasSample) throw new Error('db.group() 方法不支持 sample 条件');\n    if (this._hasLookup) throw new Error('db.group() 方法不支持 lookup 关联查询');\n\n    this._hasGroup++;\n\n    const fieldArr = Array.isArray(field) ? field : [field];\n    const id =\n      fieldArr.length === 1\n        ? `$${String(fieldArr[0])}`\n        : Object.fromEntries(fieldArr.map((f) => [String(f), `$${String(f)}`]));\n\n    this._group = { _id: id, ...accumulators };\n\n    type AccumulatorValues = { [P in keyof A]: A[P] extends DbGroupCommand<infer T> ? T : unknown };\n    return this as unknown as Db<D1 & AccumulatorValues, {}, D2, W2>;\n  }\n\n  private _hasLookup = 0;\n  get hasLookup() {\n    return this._hasLookup > 0;\n  }\n\n  get dbGroup() {\n    return {\n      sum: (value: number | string) => new DbGroupCommand<number>('sum', value),\n      avg: (field: keyof D1 & string) => new DbGroupCommand<number>('avg', field),\n      min: <K extends keyof D1>(field: K) => new DbGroupCommand<D1[K]>('min', String(field)),\n      max: <K extends keyof D1>(field: K) => new DbGroupCommand<D1[K]>('max', String(field)),\n      push: <K extends keyof D1>(field: K) => new DbGroupCommand<D1[K][]>('push', String(field)),\n      addToSet: <K extends keyof D1>(field: K) => new DbGroupCommand<D1[K][]>('addToSet', String(field)),\n      first: <K extends keyof D1>(field: K) => new DbGroupCommand<D1[K]>('first', String(field)),\n      last: <K extends keyof D1>(field: K) => new DbGroupCommand<D1[K]>('last', String(field)),\n    };\n  }\n\n  private _lookups: DbLookup[] = [];\n  lookup<\n    FD1,\n    FS1 extends DbSelect<FD1>,\n    FD2 extends AnyObject,\n    FW2 extends AnyObject,\n    RL extends DbRelation,\n    AS extends string,\n    // biome-ignore lint/suspicious/noConfusingVoidType: 必须这么用\n    US extends boolean | undefined | void = undefined,\n    LF extends keyof D1 & string = keyof D1 & string,\n  >(table: Db<FD1, FS1, FD2, FW2>, lookup: DbLookupOptions<RL, D1, FD1, AS, US, LF>) {\n    if (this._isTransaction) throw new Error('db.lookup() 方法不支持事务模式');\n\n    // 对方表也记为关联查询，避免做表更新操作\n    table._hasLookup++;\n    this._hasLookup++;\n    this._lookups.push({\n      ...lookup,\n      table,\n    } as unknown as DbLookup);\n\n    // @ts-expect-error\n    return this as Db<\n      D1,\n      S1,\n      US extends true ? D2 : MergeIntersection<D2 & DbForeign<D1, FD1, FS1, FD2, RL, AS, LF>>,\n      MergeIntersection<W2 & Partial<Record<AS, DbQueryCommand>>>\n    >;\n  }\n\n  private _ending = false;\n\n  private _aggregated = false;\n  private _lookupAs = {} as Record<string, true>;\n  private _endAggregate(aggRef: UniCloud.AggregateReference) {\n    if (this._aggregated) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n    if (this._ending) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n\n    this._ending = true;\n    this._aggregated = true;\n    let returnAggRef = aggRef;\n    let _hasAggSelect = 0;\n    const aggSelect = {} as Record<string, true>;\n    let hasAggUnselect = 0;\n    const aggUnselect = {} as Record<string, false>;\n\n    // 后做关联查询\n    for (const { relation: type, as, foreignField, localField, table, unselect } of this._lookups) {\n      const letName = `let${gid++}`;\n      let pipeline = dbAgg.pipeline();\n\n      // 关联条件\n      // @ts-expect-error\n      pipeline = pipeline.match({\n        $expr: {\n          $and: [\n            type === 'n:1'\n              ? { $in: [`$${foreignField}`, `$$${letName}`] }\n              : { $eq: [`$${foreignField}`, `$$${letName}`] },\n          ],\n        },\n      });\n\n      // 其他查询条件\n      // @ts-expect-error\n      pipeline = table._endAggregate(pipeline);\n\n      // @ts-expect-error\n      pipeline = pipeline.done();\n\n      returnAggRef = returnAggRef.lookup({\n        let: {\n          [letName]: `$${localField}`,\n        },\n        as,\n        from: table.table,\n        pipeline,\n      });\n\n      // 1对1，展开数组\n      if (type === '1:1') {\n        // @ts-expect-error\n        returnAggRef = returnAggRef.unwind({\n          path: `$${as}`,\n          preserveNullAndEmptyArrays: true,\n        });\n      }\n\n      if (unselect) {\n        hasAggUnselect++;\n        aggUnselect[as] = false;\n      } else {\n        _hasAggSelect++;\n        aggSelect[as] = true;\n      }\n\n      this._lookupAs[as] = true;\n    }\n\n    // 主表查询，注意顺序，筛选->分组->取样->排序->跳过->限制\n    if (this._hasWhere) returnAggRef = returnAggRef.match(_mapCommandRaw(this._where));\n    if (this._hasGroup) returnAggRef = returnAggRef.group(_mapGroupRaw(this._group));\n    if (this._hasSample) returnAggRef = returnAggRef.sample({ size: this._sampleSize });\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    // 如果主表有选择字段，则合并选择字段（包括关联查询的字段和排序字段）\n    if (this._hasSelect) {\n      returnAggRef = returnAggRef.project(_mergeSelect({ ...this._select, ...aggSelect }, this._order));\n    }\n    // 如果主表没有选择字段，则排除取消选择字段\n    else if (hasAggUnselect) {\n      returnAggRef = returnAggRef.project(aggUnselect);\n    }\n\n    return returnAggRef;\n  }\n\n  private _endHost(host: UniCloud.CollectionReference, action: 'query' | 'create' | 'update' | 'remove' | 'count') {\n    if (this._ending) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n    this._ending = true;\n\n    // 事务模式下：查询/更新/删除必须使用 whereId\n    if (\n      this._isTransaction &&\n      (action === 'query' || action === 'update' || action === 'remove') &&\n      !this._hasWhereId\n    ) {\n      throw new Error('事务模式下查询/更新/删除条件只能是 ID，请使用 whereId() 方法');\n    }\n\n    let hostRef = host;\n    if (this._hasWhere) {\n      // 事务模式下：更新/删除/查询只能用 doc(id)\n      if (this._isTransaction && (action === 'update' || action === 'remove' || action === 'query')) {\n        // @ts-expect-error\n        hostRef = hostRef.doc(this._where._id);\n      } else {\n        // @ts-expect-error\n        hostRef = hostRef.where(_mapCommandRaw(this._where));\n      }\n    }\n\n    if (this._hasSelect) {\n      // @ts-expect-error\n      hostRef = hostRef.field(_mergeSelect(this._select, this._order));\n    }\n\n    if (this._hasOrder) {\n      objectEach(this._order, (val, key) => {\n        // @ts-expect-error\n        hostRef = hostRef.orderBy(key, val);\n      });\n    }\n\n    // @ts-expect-error\n    if (this._hasSkip) hostRef = hostRef.skip(this._skip);\n\n    if (this._hasLimit && action === 'query')\n      // @ts-expect-error\n      hostRef = hostRef.limit(this._limit);\n    else if (this._hasWhereId && action === 'query' && !this._isTransaction)\n      // @ts-expect-error\n      hostRef = hostRef.limit(1);\n\n    return hostRef;\n  }\n\n  /**\n   * 将 uniCloud 数据库原始错误包装为 DbError\n   * @param err - 原始错误对象，来自 uniCloud DB 操作（Error 实例，含 errMsg、errCode 属性）\n   * @returns DbError 实例\n   */\n  private _parseDbError(err: UniError) {\n    const errCode = err.errCode || '';\n    const message = err.errMsg || err.message;\n    const dbCode = extractMongoCode(err.errMsg || err.message);\n\n    if (dbCode) {\n      return new DbError(message, {\n        errCode: errCode,\n        dbCode: dbCode,\n      });\n    } else {\n      return err;\n    }\n  }\n\n  /**\n   * 统一处理 DB 操作抛出的错误\n   * - uniCloud 数据库错误（含 errMsg）→ 包装为 DbError → 经 parseError 回调后抛出\n   * - 非数据库错误（如网络中断）→ 原样抛出\n   */\n  private _handleDbError(err: unknown): never {\n    if (isUniError(err)) {\n      const dbErr = this._parseDbError(err);\n      throw this._options.parseError?.(dbErr) || dbErr;\n    } else {\n      throw this._options.parseError?.(err) || err;\n    }\n  }\n\n  /**\n   * 执行查询操作\n   * @returns 查询结果\n   */\n  async many() {\n    try {\n      let res: { data: DbQuery<D1, S1, D2>[] | DbQuery<D1, S1, D2> | undefined };\n\n      // 事务模式下不支持聚合查询\n      if (this._isTransaction && (this._hasLookup || this._hasSample || this._hasGroup)) {\n        throw new Error('事务模式下不支持 lookup 聚合、sample 取样或 group 分组查询');\n      }\n\n      // 关联查询 / sample 查询 / group 分组（依赖聚合管线）\n      if (this._hasLookup || this._hasSample || this._hasGroup) {\n        let aggRef = this._createAggregate();\n        aggRef = this._endAggregate(aggRef);\n        res = await aggRef.end();\n      }\n      // 单表查询\n      else {\n        let hostRef = this._createHost();\n        hostRef = this._endHost(hostRef, 'query');\n        res = await hostRef.get();\n      }\n\n      const { data } = parseDatabaseOutput(res);\n\n      // doc(id).get() 返回单个对象或 undefined，需包装为数组以统一 many() 返回值\n      return isArray(data) ? data : data ? [data] : [];\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * 如果没有匹配到记录，会抛出错误\n   * @returns 查询结果\n   */\n  async firstOrThrow(): Promise<DbQuery<D1, S1, D2>> {\n    if (this._hasLimit) throw new Error('db.firstOrThrow() 方法不支持 limit 条件');\n    if (!this._hasWhereId && !this._hasSample && !this._hasGroup) this.limit(1);\n\n    const data = await this.many();\n    const res = data.at(0);\n\n    if (!res) throw createCloudObjectError('查询数据为空', 'firstOrThrow');\n    return res;\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * 如果没有匹配到记录，返回 null\n   * @returns 查询结果或 null\n   */\n  async firstOrNull(): Promise<DbQuery<D1, S1, D2> | null> {\n    if (this._hasLimit) throw new Error('db.firstOrNull() 方法不支持 limit 条件');\n    if (!this._hasWhereId && !this._hasSample && !this._hasGroup) this.limit(1);\n\n    const data = await this.many();\n    return data.at(0) || null;\n  }\n\n  /**\n   * 获取匹配记录的数量\n   * @returns 记录总数\n   */\n  async count() {\n    if (this._isTransaction) throw new Error('db.count() 方法不支持事务模式');\n    if (this._hasSample) throw new Error('db.count() 方法不支持 sample 取样');\n    if (this._hasLookup) throw new Error('db.count() 方法不支持 lookup 聚合');\n    if (this._hasGroup) throw new Error('db.count() 方法不支持 group 分组');\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'count');\n      const res = await hostRef.count();\n      const { total } = parseDatabaseOutput<{ total: number }>(res);\n      return total;\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n\n  /**\n   * 创建新记录\n   * @param data 要创建的数据\n   * @returns 创建结果\n   */\n  async create(data: DbCreate<D1>) {\n    if (this._hasLookup) throw new Error('db.create() 方法不支持 lookup 聚合');\n    if (this._hasGroup) throw new Error('db.create() 方法不支持 group 分组');\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'create');\n      const res = await hostRef.add(data);\n      const { id } = parseDatabaseOutput<{ id: string }>(res);\n      return id;\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n\n  /**\n   * 更新记录\n   * @param data 要更新的数据\n   * @returns 更新结果\n   */\n  async update(data: DbUpdate<D1>) {\n    if (this._hasLookup) throw new Error('db.update() 方法不支持 lookup 聚合');\n    if (this._hasGroup) throw new Error('db.update() 方法不支持 group 分组');\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'update');\n      const res = await hostRef.update(objectOmit(_mapCommandRaw(data), ['_id']));\n      const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n      return updated;\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n\n  /**\n   * 删除记录\n   * @returns 删除结果\n   */\n  async remove() {\n    if (this._hasLookup) throw new Error('db.remove() 方法不支持 lookup 聚合');\n    if (this._hasGroup) throw new Error('db.remove() 方法不支持 group 分组');\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    try {\n      let hostRef = this._createHost();\n      hostRef = this._endHost(hostRef, 'remove');\n      const res = await hostRef.remove();\n      const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n      return deleted;\n    } catch (err) {\n      this._handleDbError(err);\n    }\n  }\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: 必须这么用\nfunction _mapCommandRaw(data: any) {\n  // biome-ignore lint/suspicious/noExplicitAny: 必须这么用\n  const map = (val: any): any => {\n    if (!isObject(val)) return val;\n    if (val instanceof DbBaseCommand) return DbBaseCommand.getValue(val, db0);\n    return objectMap(val, map);\n  };\n\n  return objectMap(data, map);\n}\n\nfunction _mapGroupRaw(group: Record<string, unknown>) {\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(group)) {\n    if (value instanceof DbGroupCommand) {\n      result[key] = value.toAggregate();\n    } else {\n      result[key] = value;\n    }\n  }\n  return result;\n}\n\nfunction _mapOrderSelect(order: DbOrder<unknown>) {\n  return objectMap(order, (_val, _key) => true);\n}\n\nfunction _mergeSelect(select: DbSelect<unknown>, order: DbOrder<unknown>) {\n  const noSelect = Object.keys(select).length === 0;\n  // 如果没有 select 条件，默认返回所有字段\n  if (noSelect) return select;\n\n  const onlyOmitId = Object.keys(select).length === 1 && '_id' in select && select._id === false;\n  // 如果只排除 _id 字段，则保持现状\n  if (onlyOmitId) return select;\n\n  return {\n    ...select,\n    ..._mapOrderSelect(order),\n  };\n}\n","import { isFunction } from '@cloudcome/utils-core/type';\nimport { Db } from './_db.class';\nimport type { DbSelect } from './types';\nimport type { UniError } from '@/_types';\n\nexport type DbProxyOptions = {\n  /**\n   * 自定义错误处理函数\n   * @param error unknown 数据库异常对象\n   * @returns 自定义错误对象\n   */\n  parseError?: (error: unknown) => UniError;\n};\n\n/**\n * 创建一个数据库代理对象，用于延迟实例化数据库操作类\n * @template D1 - 主表数据\n * @template S1 - 主表筛选\n * @param name - 数据库表名\n * @returns 返回一个代理对象，该对象会将属性访问转发到实际的数据库操作实例\n */\n\n// biome-ignore lint/complexity/noBannedTypes: 必须这么用\nexport function dbProxy<D1, S1 extends DbSelect<D1> = {}>(name: string, options?: DbProxyOptions) {\n  return new Proxy(\n    {},\n    {\n      get(_target, prop) {\n        if (prop === '_isProxy') return true;\n\n        const table = new Db<D1, S1>({ table: name, ...options });\n        const tableProp = prop as keyof Db<D1, S1>;\n        const ref = table[tableProp];\n\n        return isFunction(ref) ? ref.bind(table) : ref;\n      },\n    },\n  ) as Db<D1, S1>;\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { Db } from './_db.class';\n\ntype _TransactionDb = {\n  startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n  commit: () => Promise<unknown>;\n  rollback: () => Promise<unknown>;\n};\n\nexport type WithTransaction = <D1>(db: Db<D1>) => Db<D1>;\n\n/**\n * 在数据库事务中执行操作\n *\n * @template K - 事务操作返回值类型\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: 单测使用 any\n  _mockDatabase?: any,\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\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: WithTransaction = <D1>(db: Db<D1>) => {\n    return _mockDbInstance || new Db<D1>({ ...db.options, 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","import { isFunction } from '@cloudcome/utils-core/type';\nimport type { Db } from './_db.class';\nimport type { DbCreate, DbQuery, DbUpdate } from './types';\n\nexport type DbUpsertOptions<T, C extends DbCreate<T>, U extends DbUpdate<T>> = {\n  /** 创建数据 */\n  create: C;\n\n  /**\n   * 更新数据，可以是对象或根据查询结果生成更新对象的函数\n   * @param row 查询到的文档数据，仅在传入函数时可用\n   */\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  update: U | ((exist: DbQuery<T, {}, {}>) => 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: 必须这么用\n  onBeforeUpdate?: (exist: DbQuery<T, {}, {}>) => false | unknown;\n\n  /**\n   * 更新后回调函数\n   * @param updateData 实际更新的数据\n   * @param exist 查询到的原始文档数据\n   */\n  // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n  onAfterUpdate?: (updateData: U, exist: DbQuery<T, {}, {}>) => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\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<D1, C extends DbCreate<D1>, U extends DbUpdate<D1>>(\n  db: Db<D1>,\n  options: DbUpsertOptions<D1, C, U>,\n): Promise<DbUpsertOutput> {\n  const { create, update, onBeforeCreate, onAfterCreate, onBeforeUpdate, onAfterUpdate, _mockDbInstance } = options;\n\n  const _mutateDb = (_mockDbInstance || db.clone()) as Db<D1>;\n  const _queryDb = (_mockDbInstance || db.clone(true)) as Db<D1>;\n\n  const exist = (await _queryDb\n    .where(db.getWhere(true))\n    // biome-ignore lint/complexity/noBannedTypes: 必须这么用\n    .firstOrNull()) as DbQuery<D1, {}, {}> | null;\n\n  if (exist) {\n    const skipUpdate = (await onBeforeUpdate?.(exist)) === false;\n\n    if (skipUpdate) {\n      // @ts-expect-error\n      return { id: exist._id as string, updated: false, created: false };\n    }\n\n    const updateData = isFunction(update) ? update(exist) : update;\n    // @ts-expect-error\n    await _mutateDb.whereId(exist._id).update(updateData);\n    onAfterUpdate?.(updateData, exist);\n\n    // @ts-expect-error\n    return { id: exist._id as string, updated: true, created: false };\n  }\n\n  await onBeforeCreate?.();\n  const createdId = await _mutateDb.create(create);\n  await onAfterCreate?.(createdId);\n\n  return { id: createdId, updated: false, created: true };\n}\n","import type { Db } from './_db.class';\nimport type { DbCreate } from './types';\nimport { dbUpsert } from './upsert';\n\nexport type DbUniqueOptions<T, C extends DbCreate<T>> = {\n  /** 创建数据 */\n  create: C;\n\n  /** 创建前回调函数 */\n  onBeforeCreate?: () => unknown;\n\n  /**\n   * 创建后回调函数\n   * @param id 创建的文档ID\n   */\n  onAfterCreate?: (id: string) => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: 单测使用 any\n  _mockDbInstance?: any;\n};\n\n/**\n * 数据库 upsert 操作的返回结果类型\n */\nexport type DbUniqueOutput = {\n  /** 操作的文档ID */\n  id: string;\n  /** 是否为创建操作 */\n  created: boolean;\n};\n\nexport async function dbUnique<T, C extends DbCreate<T>>(\n  db: Db<T>,\n  options: DbUniqueOptions<T, C>,\n): Promise<DbUniqueOutput> {\n  const { id, created } = await dbUpsert(db, {\n    ...options,\n    // @ts-expect-error\n    update: {},\n    onBeforeUpdate: () => false,\n  });\n  return { id, created };\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -3,7 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 /**
 * `@cloudcome/utils-uni` 版本号
 */
-var VERSION = "1.49.1";
+var VERSION = "1.50.0";
 //#endregion
 exports.VERSION = VERSION;
 

package/dist/index.mjs

@@ -2,7 +2,7 @@
 /**
 * `@cloudcome/utils-uni` 版本号
 */
-var VERSION = "1.49.1";
+var VERSION = "1.50.0";
 //#endregion
 export { VERSION };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcome/utils-uni",
-  "version": "1.49.1",
+  "version": "1.50.0",
   "description": "cloudcome utils for uni-app",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -58,10 +58,10 @@
   },
   "dependencies": {
     "@cloudcome/utils-core": "~1.23.1",
-    "@cloudcome/utils-vue": "~1.16.2",
-    "@dcloudio/types": "^3.4.31",
-    "@dcloudio/uni-app": "^3.0.0-alpha-5000920260515001",
-    "vue": "^3.5.34",
+    "@cloudcome/utils-vue": "~1.16.4",
+    "@dcloudio/types": "^3.0.0",
+    "@dcloudio/uni-app": "^3.0.0-alpha-5000020260104004",
+    "vue": "^3.0.0",
     "zod": "^4.4.3"
   },
   "keywords": [