@cloudcome/utils-uni 1.34.0 → 1.35.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (24) hide show
  1. package/README.md +71 -71
  2. package/dist/_helpers.cjs.map +1 -1
  3. package/dist/_helpers.mjs.map +1 -1
  4. package/dist/client.cjs.map +1 -1
  5. package/dist/client.mjs.map +1 -1
  6. package/dist/cloud/types.d.ts +2 -2
  7. package/dist/cloud.cjs.map +1 -1
  8. package/dist/cloud.mjs.map +1 -1
  9. package/dist/database/_db.class.d.ts +5 -4
  10. package/dist/database/types.d.ts +1 -1
  11. package/dist/database.cjs +40 -30
  12. package/dist/database.cjs.map +1 -1
  13. package/dist/database.mjs +40 -30
  14. package/dist/database.mjs.map +1 -1
  15. package/dist/index.cjs +1 -1
  16. package/dist/index.mjs +1 -1
  17. package/dist/weixin/notice.d.ts +79 -0
  18. package/dist/weixin/token.d.ts +49 -0
  19. package/dist/weixin.cjs +132 -0
  20. package/dist/weixin.cjs.map +1 -0
  21. package/dist/weixin.d.ts +2 -0
  22. package/dist/weixin.mjs +130 -0
  23. package/dist/weixin.mjs.map +1 -0
  24. package/package.json +15 -7
package/dist/database.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"database.cjs","names":[],"sources":["../src/database/_command.class.ts","../src/database/command.ts","../src/database/each.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 (\n db.command as unknown as Record<string, (value: unknown) => unknown>\n )[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 {\n DbBaseCommand,\n DbMutateCommand,\n DbQueryCommand,\n} 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) =>\n 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) =>\n 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","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 {\n objectEach,\n objectFilter,\n objectMap,\n objectOmit,\n} from '@cloudcome/utils-core/object';\nimport { isNumber, isObject, isString } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MergeIntersection } from '@cloudcome/utils-core/types';\nimport { parseDatabaseOutput } from '@/_helpers';\nimport type { UniError } from '@/_types';\nimport { createCloudObjectError } from '@/cloud';\nimport { DbBaseCommand, type DbQueryCommand } from './_command.class';\nimport type {\n DbCreate,\n DbForeign,\n DbOrder,\n DbQuery,\n DbRelation,\n DbSelect,\n DbUpdate,\n DbWhere,\n} from './types';\n\n/**\n * 数据库聚合操作符命令\n */\nconst dbAgg = uniCloud.database().command\n .aggregate as UniCloud.AggregateCommand & {\n pipeline: () => UniCloud.AggregateReference & {\n done: () => unknown;\n };\n};\n\ntype _WhereFrom = 'where' | 'whereId';\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 数据库错误对象\n * @returns 处理后的数据库错误对象\n */\n parseError?: (error: UniError) => 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> = {\n /**\n * 关联类型\n */\n relation: RL;\n\n /**\n * 主表字段\n */\n localField: keyof D1 & string;\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 private _host: UniCloud.CollectionReference;\n\n /**\n * 是否为事务环境\n * - 查询条件只能是 id\n * - 不能聚合操作\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 this._host =\n options._mockDatabase ||\n options.transaction?.collection(options.table) ||\n 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 /**\n * 获取聚合操作实例\n * @returns 聚合操作实例\n */\n aggregate() {\n return this._host.aggregate();\n }\n\n private _hasWhere: _WhereFrom | undefined = undefined;\n private _hasWhereId: _WhereFrom | undefined = undefined;\n private _where = {};\n\n private _doWhere(where: DbWhere<D1>, from: _WhereFrom) {\n if (this._hasWhere)\n throw new Error(`已调用过一次 db.${_toWhereMethod(this._hasWhere)} 了`);\n\n // 过滤掉值为 undefined 的键值对，数据库不支持查询全 undefined 值\n const realWhere = objectFilter(where, (value) => value !== undefined);\n\n const whereKeys = Object.keys(realWhere);\n\n // 只有 _id 值为字符串或数字时，才能调用 doc 方法\n const isWhereId =\n whereKeys.length === 1 &&\n '_id' in realWhere &&\n (isString(realWhere._id) || isNumber(realWhere._id));\n\n if (isWhereId && this._hasLimit) {\n throw new Error(\n `db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`,\n );\n }\n\n this._hasWhere = from;\n this._where = realWhere;\n if (isWhereId) this._hasWhereId = from;\n\n return this;\n }\n\n /**\n * 设置查询条件\n * @param where 查询条件对象\n * @returns 当前Db实例，支持链式调用\n */\n where(where: DbWhere<D1> & W2) {\n return this._doWhere(where, 'where');\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 // @ts-expect-error\n return this._doWhere({ _id: id }, 'whereId');\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 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._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._hasLimit) throw new Error('db.limit() 方法只能调用一次');\n\n if (this._hasWhereId) {\n throw new Error(\n `db.limit() 方法不能与 ${_toWhereIdMethod(this._hasWhereId)} 方法同时调用`,\n );\n }\n\n this._hasLimit++;\n this._limit = limit;\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 >(\n table: Db<FD1, FS1, FD2, FW2>,\n lookup: DbLookupOptions<RL, D1, FD1, AS, US>,\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\n ? D2\n : MergeIntersection<D2 & DbForeign<FD1, FS1, FD2, RL, AS>>,\n MergeIntersection<W2 & Partial<Record<AS, DbQueryCommand>>>\n >;\n }\n\n private _aggregated = false;\n private _lookupAs = {} as Record<string, true>;\n private _endAggregate(aggRef: UniCloud.AggregateReference) {\n if (this._aggregated)\n throw new Error(`相同的数据表实例(${this.table})不能重复使用`);\n\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 {\n relation: type,\n as,\n foreignField,\n localField,\n table,\n unselect,\n } 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)\n returnAggRef = returnAggRef.match(_mapCommandRaw(this._where));\n if (this._hasOrder)\n returnAggRef = returnAggRef.sort(\n objectMap(this._order, (v) => (v === 'asc' ? 1 : -1)),\n );\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(\n _mergeSelect({ ...this._select, ...aggSelect }, this._order),\n );\n }\n // 如果主表没有选择字段，则排除取消选择字段\n else if (hasAggUnselect) {\n returnAggRef = returnAggRef.project(aggUnselect);\n }\n\n return returnAggRef;\n }\n\n private _endHost(action: 'query' | 'create' | 'update' | 'remove' | 'count') {\n if (this._hasWhere) {\n // 事务模式下：更新/删除只能用 doc(id)\n if ((action === 'update' || action === 'remove') && this._isTransaction) {\n // @ts-expect-error\n this._host = this._host.doc(this._where._id);\n } else {\n // @ts-expect-error\n this._host = this._host.where(_mapCommandRaw(this._where));\n }\n }\n\n if (this._hasSelect) {\n // @ts-expect-error\n this._host = this._host.field(_mergeSelect(this._select, this._order));\n }\n\n if (this._hasOrder) {\n objectEach(this._order, (val, key) => {\n // @ts-expect-error\n this._host = this._host.orderBy(key, val);\n });\n }\n\n // @ts-expect-error\n if (this._hasSkip) this._host = this._host.skip(this._skip);\n\n if (this._hasLimit && action === 'query')\n // @ts-expect-error\n this._host = this._host.limit(this._limit);\n else if (this._hasWhereId && action === 'query')\n // @ts-expect-error\n this._host = this._host.limit(1);\n }\n\n /**\n * 执行查询操作\n * @returns 查询结果\n */\n async many() {\n try {\n if (this._isTransaction) throw new Error('db.many() 方法不支持事务模式');\n\n let res: { data: DbQuery<D1, S1, D2>[] };\n\n // 关联查询\n if (this._hasLookup) {\n const aggRef = this.aggregate();\n this._endAggregate(aggRef);\n res = await aggRef.end();\n }\n // 单表查询\n else {\n this._endHost('query');\n res = await this._host.get();\n }\n\n const { data } = parseDatabaseOutput(res);\n return data;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) || dbErr;\n }\n }\n\n /**\n * 只查询一条，自动添加 limit(1) 条件\n * 如果没有匹配到记录，会抛出错误\n * @returns 查询结果\n */\n async firstOrThrow(): Promise<DbQuery<D1, S1, D2>> {\n if (this._isTransaction)\n throw new Error('db.firstOrThrow() 方法不支持事务模式');\n if (this._hasLimit)\n throw new Error('db.firstOrThrow() 方法不支持 limit 条件');\n if (!this._hasWhereId) 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._isTransaction)\n throw new Error('db.firstOrNull() 方法不支持事务模式');\n if (this._hasLimit)\n throw new Error('db.firstOrNull() 方法不支持 limit 条件');\n if (!this._hasWhereId) 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._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 this._endHost('count');\n const res = await this._host.count();\n const { total } = parseDatabaseOutput<{ total: number }>(res);\n return total;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) || dbErr;\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 this._endHost('create');\n const res = await this._host.add(data);\n const { id } = parseDatabaseOutput<{ id: string }>(res);\n return id;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) || dbErr;\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)\n 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)\n throw new Error('事务模式下 db.update() 的 where 条件必须是 _id');\n\n try {\n this._endHost('update');\n const res = await this._host.update(\n objectOmit(_mapCommandRaw(data), ['_id']),\n );\n const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n return updated;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) || dbErr;\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)\n 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)\n throw new Error('事务模式下 db.remove() 的 where 条件必须是 _id');\n\n try {\n this._endHost('remove');\n const res = await this._host.remove();\n const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n return deleted;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) || dbErr;\n }\n }\n}\n\nfunction _toWhereMethod(whereFrom: _WhereFrom) {\n return whereFrom === 'where' ? 'where({...})' : 'whereId(id)';\n}\n\nfunction _toWhereIdMethod(whereFrom: _WhereFrom) {\n return whereFrom === 'where' ? 'where({ _id })' : 'whereId(id)';\n}\n\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 =\n 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 type { UniError } from '@/_types';\nimport { Db } from './_db.class';\nimport type { DbSelect } from './types';\n\nexport type DbProxyOptions = {\n /**\n * 自定义错误处理函数\n * @param error 数据库错误对象\n * @returns 处理后的数据库错误对象\n */\n parseError?: (error: UniError) => 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> = {}>(\n name: string,\n options?: DbProxyOptions,\n) {\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 ||\n uniCloud.database()) as _TransactionDb;\n\n const [err1, transaction] = await tryFlatten(\n transactionDb.startTransaction(),\n );\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<\n D1,\n C extends DbCreate<D1>,\n U extends DbUpdate<D1>,\n>(db: Db<D1>, options: DbUpsertOptions<D1, C, U>): Promise<DbUpsertOutput> {\n const {\n create,\n update,\n onBeforeCreate,\n onAfterCreate,\n onBeforeUpdate,\n onAfterUpdate,\n _mockDbInstance,\n } = 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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"}
1
+ {"version":3,"file":"database.cjs","names":[],"sources":["../src/database/_command.class.ts","../src/database/command.ts","../src/database/each.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","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 { objectEach, objectFilter, objectMap, objectOmit } from '@cloudcome/utils-core/object';\nimport { isNumber, isObject, isString } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MergeIntersection } from '@cloudcome/utils-core/types';\nimport { parseDatabaseOutput } from '@/_helpers';\nimport type { UniError } from '@/_types';\nimport { createCloudObjectError } from '@/cloud';\nimport { DbBaseCommand, type DbQueryCommand } from './_command.class';\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\ntype _WhereFrom = 'where' | 'whereId';\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 数据库错误对象\n * @returns 处理后的数据库错误对象\n */\n parseError?: (error: UniError) => 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> = {\n /**\n * 关联类型\n */\n relation: RL;\n\n /**\n * 主表字段\n */\n localField: keyof D1 & string;\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: _WhereFrom | undefined = undefined;\n private _hasWhereId: _WhereFrom | undefined = undefined;\n private _where = {};\n\n private _doWhere(where: DbWhere<D1>, from: _WhereFrom) {\n if (this._hasWhere) throw new Error(`已调用过一次 db.${_toWhereMethod(this._hasWhere)} 了`);\n\n // 过滤掉值为 undefined 的键值对，数据库不支持查询全 undefined 值\n const realWhere = objectFilter(where, (value) => value !== undefined);\n\n const whereKeys = Object.keys(realWhere);\n\n // 只有 _id 值为字符串或数字时，才能调用 doc 方法\n const isWhereId =\n whereKeys.length === 1 && '_id' in realWhere && (isString(realWhere._id) || isNumber(realWhere._id));\n\n if (isWhereId && this._hasLimit) {\n throw new Error(`db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`);\n }\n\n this._hasWhere = from;\n this._where = realWhere;\n if (isWhereId) this._hasWhereId = from;\n\n return this;\n }\n\n /**\n * 设置查询条件\n * @param where 查询条件对象\n * @returns 当前Db实例，支持链式调用\n */\n where(where: DbWhere<D1> & W2) {\n return this._doWhere(where, 'where');\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 // @ts-expect-error\n return this._doWhere({ _id: id }, 'whereId');\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 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._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._hasLimit) throw new Error('db.limit() 方法只能调用一次');\n\n if (this._hasWhereId) {\n throw new Error(`db.limit() 方法不能与 ${_toWhereIdMethod(this._hasWhereId)} 方法同时调用`);\n }\n\n this._hasLimit++;\n this._limit = limit;\n\n return this;\n }\n\n 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 >(table: Db<FD1, FS1, FD2, FW2>, lookup: DbLookupOptions<RL, D1, FD1, AS, US>) {\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<FD1, FS1, FD2, RL, AS>>,\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._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 let hostRef = host;\n if (this._hasWhere) {\n // 事务模式下：更新/删除只能用 doc(id)\n if ((action === 'update' || action === 'remove') && this._isTransaction) {\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')\n // @ts-expect-error\n hostRef = hostRef.limit(1);\n\n return hostRef;\n }\n\n /**\n * 执行查询操作\n * @returns 查询结果\n */\n async many() {\n try {\n let res: { data: DbQuery<D1, S1, D2>[] };\n\n // 关联查询\n if (this._hasLookup) {\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 return data;\n } catch (err) {\n const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) || dbErr;\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.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.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._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 const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) || dbErr;\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 const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) || dbErr;\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 const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) || dbErr;\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 const dbErr = err as UniError;\n throw this._options.parseError?.(dbErr) || dbErr;\n }\n }\n}\n\nfunction _toWhereMethod(whereFrom: _WhereFrom) {\n return whereFrom === 'where' ? 'where({...})' : 'whereId(id)';\n}\n\nfunction _toWhereIdMethod(whereFrom: _WhereFrom) {\n return whereFrom === 'where' ? 'where({ _id })' : 'whereId(id)';\n}\n\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 type { UniError } from '@/_types';\nimport { Db } from './_db.class';\nimport type { DbSelect } from './types';\n\nexport type DbProxyOptions = {\n /**\n * 自定义错误处理函数\n * @param error 数据库错误对象\n * @returns 处理后的数据库错误对象\n */\n parseError?: (error: UniError) => 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 CHANGED
@@ -231,11 +231,10 @@ var gid = 0;
231
231
  * @template W2 - 副表查询
232
232
  */
233
233
  var Db = class Db {
234
- _host;
235
234
  /**
236
235
  * 是否为事务环境
237
- * - 查询条件只能是 id
238
- * - 不能聚合操作
236
+ * - 更新条件只能是 id
237
+ * - 删除条件只能是 id
239
238
  */
240
239
  _isTransaction = false;
241
240
  _options;
@@ -246,7 +245,6 @@ var Db = class Db {
246
245
  */
247
246
  constructor(options) {
248
247
  this._options = options;
249
- this._host = options._mockDatabase || options.transaction?.collection(options.table) || db0.collection(options.table);
250
248
  this._isTransaction = !!options.transaction;
251
249
  }
252
250
  /**
@@ -269,12 +267,16 @@ var Db = class Db {
269
267
  get isTransaction() {
270
268
  return this._isTransaction;
271
269
  }
270
+ _createHost(withoutTransaction) {
271
+ const options = this._options;
272
+ return options._mockDatabase || (withoutTransaction ? null : options.transaction?.collection(options.table) || db0.collection(options.table));
273
+ }
272
274
  /**
273
275
  * 获取聚合操作实例
274
276
  * @returns 聚合操作实例
275
277
  */
276
- aggregate() {
277
- return this._host.aggregate();
278
+ _createAggregate() {
279
+ return this._createHost().aggregate();
278
280
  }
279
281
  _hasWhere = void 0;
280
282
  _hasWhereId = void 0;
@@ -379,10 +381,13 @@ var Db = class Db {
379
381
  });
380
382
  return this;
381
383
  }
384
+ _ending = false;
382
385
  _aggregated = false;
383
386
  _lookupAs = {};
384
387
  _endAggregate(aggRef) {
385
388
  if (this._aggregated) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);
389
+ if (this._ending) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);
390
+ this._ending = true;
386
391
  this._aggregated = true;
387
392
  let returnAggRef = aggRef;
388
393
  let _hasAggSelect = 0;
@@ -425,16 +430,20 @@ var Db = class Db {
425
430
  else if (hasAggUnselect) returnAggRef = returnAggRef.project(aggUnselect);
426
431
  return returnAggRef;
427
432
  }
428
- _endHost(action) {
429
- if (this._hasWhere) if ((action === "update" || action === "remove") && this._isTransaction) this._host = this._host.doc(this._where._id);
430
- else this._host = this._host.where(_mapCommandRaw(this._where));
431
- if (this._hasSelect) this._host = this._host.field(_mergeSelect(this._select, this._order));
433
+ _endHost(host, action) {
434
+ if (this._ending) throw new Error(`相同的数据表实例(${this.table})不能重复使用`);
435
+ this._ending = true;
436
+ let hostRef = host;
437
+ if (this._hasWhere) if ((action === "update" || action === "remove") && this._isTransaction) hostRef = hostRef.doc(this._where._id);
438
+ else hostRef = hostRef.where(_mapCommandRaw(this._where));
439
+ if (this._hasSelect) hostRef = hostRef.field(_mergeSelect(this._select, this._order));
432
440
  if (this._hasOrder) objectEach(this._order, (val, key) => {
433
- this._host = this._host.orderBy(key, val);
441
+ hostRef = hostRef.orderBy(key, val);
434
442
  });
435
- if (this._hasSkip) this._host = this._host.skip(this._skip);
436
- if (this._hasLimit && action === "query") this._host = this._host.limit(this._limit);
437
- else if (this._hasWhereId && action === "query") this._host = this._host.limit(1);
443
+ if (this._hasSkip) hostRef = hostRef.skip(this._skip);
444
+ if (this._hasLimit && action === "query") hostRef = hostRef.limit(this._limit);
445
+ else if (this._hasWhereId && action === "query") hostRef = hostRef.limit(1);
446
+ return hostRef;
438
447
  }
439
448
  /**
440
449
  * 执行查询操作
@@ -442,15 +451,15 @@ var Db = class Db {
442
451
  */
443
452
  async many() {
444
453
  try {
445
- if (this._isTransaction) throw new Error("db.many() 方法不支持事务模式");
446
454
  let res;
447
455
  if (this._hasLookup) {
448
- const aggRef = this.aggregate();
449
- this._endAggregate(aggRef);
456
+ let aggRef = this._createAggregate();
457
+ aggRef = this._endAggregate(aggRef);
450
458
  res = await aggRef.end();
451
459
  } else {
452
- this._endHost("query");
453
- res = await this._host.get();
460
+ let hostRef = this._createHost();
461
+ hostRef = this._endHost(hostRef, "query");
462
+ res = await hostRef.get();
454
463
  }
455
464
  const { data } = parseDatabaseOutput(res);
456
465
  return data;
@@ -465,7 +474,6 @@ var Db = class Db {
465
474
  * @returns 查询结果
466
475
  */
467
476
  async firstOrThrow() {
468
- if (this._isTransaction) throw new Error("db.firstOrThrow() 方法不支持事务模式");
469
477
  if (this._hasLimit) throw new Error("db.firstOrThrow() 方法不支持 limit 条件");
470
478
  if (!this._hasWhereId) this.limit(1);
471
479
  const res = (await this.many()).at(0);
@@ -478,7 +486,6 @@ var Db = class Db {
478
486
  * @returns 查询结果或 null
479
487
  */
480
488
  async firstOrNull() {
481
- if (this._isTransaction) throw new Error("db.firstOrNull() 方法不支持事务模式");
482
489
  if (this._hasLimit) throw new Error("db.firstOrNull() 方法不支持 limit 条件");
483
490
  if (!this._hasWhereId) this.limit(1);
484
491
  return (await this.many()).at(0) || null;
@@ -488,15 +495,15 @@ var Db = class Db {
488
495
  * @returns 记录总数
489
496
  */
490
497
  async count() {
491
- if (this._isTransaction) throw new Error("db.count() 方法不支持事务模式");
492
498
  if (this._hasLookup) throw new Error("db.count() 方法不支持 lookup 聚合");
493
499
  if (this._hasSelect) throw new Error("db.count() 方法不支持 select 条件");
494
500
  if (this._hasOrder) throw new Error("db.count() 方法不支持 order 条件");
495
501
  if (this._hasSkip) throw new Error("db.count() 方法不支持 skip 条件");
496
502
  if (this._hasLimit) throw new Error("db.count() 方法不支持 limit 条件");
497
503
  try {
498
- this._endHost("count");
499
- const { total } = parseDatabaseOutput(await this._host.count());
504
+ let hostRef = this._createHost();
505
+ hostRef = this._endHost(hostRef, "count");
506
+ const { total } = parseDatabaseOutput(await hostRef.count());
500
507
  return total;
501
508
  } catch (err) {
502
509
  const dbErr = err;
@@ -516,8 +523,9 @@ var Db = class Db {
516
523
  if (this._hasSkip) throw new Error("db.create() 方法不支持 skip 条件");
517
524
  if (this._hasLimit) throw new Error("db.create() 方法不支持 limit 条件");
518
525
  try {
519
- this._endHost("create");
520
- const { id } = parseDatabaseOutput(await this._host.add(data));
526
+ let hostRef = this._createHost();
527
+ hostRef = this._endHost(hostRef, "create");
528
+ const { id } = parseDatabaseOutput(await hostRef.add(data));
521
529
  return id;
522
530
  } catch (err) {
523
531
  const dbErr = err;
@@ -538,8 +546,9 @@ var Db = class Db {
538
546
  if (this._hasLimit) throw new Error("db.update() 方法不支持 limit 条件");
539
547
  if (this._isTransaction && !this._hasWhereId) throw new Error("事务模式下 db.update() 的 where 条件必须是 _id");
540
548
  try {
541
- this._endHost("update");
542
- const { updated } = parseDatabaseOutput(await this._host.update(objectOmit(_mapCommandRaw(data), ["_id"])));
549
+ let hostRef = this._createHost();
550
+ hostRef = this._endHost(hostRef, "update");
551
+ const { updated } = parseDatabaseOutput(await hostRef.update(objectOmit(_mapCommandRaw(data), ["_id"])));
543
552
  return updated;
544
553
  } catch (err) {
545
554
  const dbErr = err;
@@ -559,8 +568,9 @@ var Db = class Db {
559
568
  if (this._hasLimit) throw new Error("db.remove() 方法不支持 limit 条件");
560
569
  if (this._isTransaction && !this._hasWhereId) throw new Error("事务模式下 db.remove() 的 where 条件必须是 _id");
561
570
  try {
562
- this._endHost("remove");
563
- const { deleted } = parseDatabaseOutput(await this._host.remove());
571
+ let hostRef = this._createHost();
572
+ hostRef = this._endHost(hostRef, "remove");
573
+ const { deleted } = parseDatabaseOutput(await hostRef.remove());
564
574
  return deleted;
565
575
  } catch (err) {
566
576
  const dbErr = err;