@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.
@@ -1 +1 @@
1
- {"version":3,"file":"database.mjs","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.mjs","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/index.cjs CHANGED
@@ -3,7 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
3
  /**
4
4
  * `@cloudcome/utils-uni` 版本号
5
5
  */
6
- var VERSION = "1.34.0";
6
+ var VERSION = "1.35.1";
7
7
  //#endregion
8
8
  exports.VERSION = VERSION;
9
9
 
package/dist/index.mjs CHANGED
@@ -2,7 +2,7 @@
2
2
  /**
3
3
  * `@cloudcome/utils-uni` 版本号
4
4
  */
5
- var VERSION = "1.34.0";
5
+ var VERSION = "1.35.1";
6
6
  //#endregion
7
7
  export { VERSION };
8
8
 
@@ -0,0 +1,79 @@
1
+ import { request } from '../cloud';
2
+ /**
3
+ * 发送微信订阅消息的数据结构
4
+ * @template T - payload 字段类型,key 为模板字段名,value 为 string | number
5
+ */
6
+ export type SendData<T> = {
7
+ /**
8
+ * 用户ID,用于查找对应的微信 openId
9
+ */
10
+ userId: string;
11
+ /**
12
+ * 小程序环境
13
+ * - `develop`: 开发版
14
+ * - `trial`: 体验版
15
+ * - `release`: 正式版
16
+ */
17
+ clientEnv: 'develop' | 'trial' | 'release';
18
+ /**
19
+ * 通知数据,key 对应模板字段(如 thing1, number1)
20
+ */
21
+ payload: T;
22
+ /**
23
+ * 点击消息后跳转的页面路径,开头 `/` 会被自动移除
24
+ */
25
+ page: string;
26
+ };
27
+ /**
28
+ * 构建微信订阅消息发送服务的选项
29
+ */
30
+ export type BuildSendWeixinNoticeServiceOptions = {
31
+ /**
32
+ * 订阅消息模板ID
33
+ */
34
+ templateId: string;
35
+ /**
36
+ * 获取微信 access_token 的服务函数
37
+ */
38
+ getWeixinAccessTokenService: () => Promise<string>;
39
+ /**
40
+ * 根据用户ID获取微信 openId
41
+ * @param userId - 用户ID
42
+ * @returns 微信 openId,未绑定时返回空字符串
43
+ */
44
+ getUserWeixinOpenId: (userId: string) => Promise<string>;
45
+ /**
46
+ * 模拟请求函数,用于单元测试注入
47
+ */
48
+ _mockRequest?: typeof request;
49
+ };
50
+ /**
51
+ * 构建微信订阅消息发送服务。
52
+ *
53
+ * 封装微信订阅消息发送逻辑,自动处理 access_token 获取、openId 查找、
54
+ * 字段长度截断(thing 类型 20 字符,character_string 类型 32 字符)等。
55
+ *
56
+ * @template T - payload 字段类型
57
+ * @param options - 构造选项
58
+ * @returns 发送订阅消息的函数
59
+ *
60
+ * @example
61
+ * ```ts
62
+ * const sendNotice = buildSendWeixinNoticeService({
63
+ * templateId: 'tmpl_abc123',
64
+ * getWeixinAccessTokenService: getAccessToken,
65
+ * getUserWeixinOpenId: async (userId) => {
66
+ * const user = await db.collection('users').doc(userId).get()
67
+ * return user.data?.openId
68
+ * },
69
+ * })
70
+ *
71
+ * await sendNotice({
72
+ * userId: 'user-123',
73
+ * clientEnv: 'release',
74
+ * payload: { thing1: '订单已发货', number1: 12345 },
75
+ * page: '/pages/order/detail?id=12345',
76
+ * })
77
+ * ```
78
+ */
79
+ export declare function buildSendWeixinNoticeService<T extends Record<string, number | string>>(options: BuildSendWeixinNoticeServiceOptions): (sendData: SendData<T>) => Promise<void>;
@@ -0,0 +1,49 @@
1
+ import { request } from '../cloud';
2
+ /**
3
+ * 构建微信 access_token 获取服务的选项
4
+ */
5
+ export type BuildWeixinAccessTokenServiceOptions = {
6
+ /**
7
+ * 微信小程序应用ID
8
+ */
9
+ appId: string;
10
+ /**
11
+ * 微信小程序应用密钥
12
+ */
13
+ appSecret: string;
14
+ /**
15
+ * 获取临时数据(用于缓存 access_token)
16
+ * @returns 缓存的 access_token,无缓存时返回空字符串
17
+ */
18
+ getTempDataService: () => Promise<string>;
19
+ /**
20
+ * 设置临时数据(用于缓存 access_token)
21
+ * @param accessToken access_token 值
22
+ * @param expiresIn 过期时间,单位毫秒
23
+ */
24
+ setTempDataService: (accessToken: string, expiresIn: number) => Promise<void>;
25
+ /**
26
+ * 模拟请求函数,用于单元测试注入
27
+ */
28
+ _mockRequest?: typeof request;
29
+ };
30
+ /**
31
+ * 构建微信 access_token 获取服务。
32
+ *
33
+ * 自动处理缓存逻辑:优先从临时数据中获取,不存在时调用微信 API 获取并缓存。
34
+ *
35
+ * @param options - 构造选项
36
+ * @returns 获取 access_token 的异步函数
37
+ *
38
+ * @example
39
+ * ```ts
40
+ * const getAccessToken = await buildWeixinAccessTokenService({
41
+ * appId: 'wx123',
42
+ * appSecret: 'secret',
43
+ * getTempDataService: () => kv.get('token'),
44
+ * setTempDataService: (token, ttl) => kv.set('token', token, ttl),
45
+ * })
46
+ * const token = await getAccessToken()
47
+ * ```
48
+ */
49
+ export declare function buildWeixinAccessTokenService(options: BuildWeixinAccessTokenServiceOptions): Promise<() => Promise<string>>;
@@ -0,0 +1,132 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ const require_cloud = require("./cloud.cjs");
3
+ let _cloudcome_utils_core_object = require("@cloudcome/utils-core/object");
4
+ let _cloudcome_utils_core_try = require("@cloudcome/utils-core/try");
5
+ //#region src/weixin/token.ts
6
+ /**
7
+ * 构建微信 access_token 获取服务。
8
+ *
9
+ * 自动处理缓存逻辑:优先从临时数据中获取,不存在时调用微信 API 获取并缓存。
10
+ *
11
+ * @param options - 构造选项
12
+ * @returns 获取 access_token 的异步函数
13
+ *
14
+ * @example
15
+ * ```ts
16
+ * const getAccessToken = await buildWeixinAccessTokenService({
17
+ * appId: 'wx123',
18
+ * appSecret: 'secret',
19
+ * getTempDataService: () => kv.get('token'),
20
+ * setTempDataService: (token, ttl) => kv.set('token', token, ttl),
21
+ * })
22
+ * const token = await getAccessToken()
23
+ * ```
24
+ */
25
+ async function buildWeixinAccessTokenService(options) {
26
+ const { appId, appSecret, _mockRequest, getTempDataService, setTempDataService } = options;
27
+ return async function getWeixinAccessTokenService() {
28
+ let accessToken = await getTempDataService();
29
+ if (accessToken) return accessToken;
30
+ const { data: accessInfo } = await (_mockRequest || require_cloud.request)({
31
+ url: "https://api.weixin.qq.com/cgi-bin/token",
32
+ method: "GET",
33
+ query: {
34
+ grant_type: "client_credential",
35
+ appid: appId,
36
+ secret: appSecret
37
+ }
38
+ });
39
+ if (!accessInfo.access_token) throw new Error(accessInfo.errmsg || "获取 access_token 失败");
40
+ accessToken = accessInfo.access_token;
41
+ const [err] = await (0, _cloudcome_utils_core_try.tryFlatten)(setTempDataService(accessToken, accessInfo.expires_in * 1e3));
42
+ if (err) console.error("设置临时数据失败", err);
43
+ return accessToken;
44
+ };
45
+ }
46
+ //#endregion
47
+ //#region src/weixin/notice.ts
48
+ /**
49
+ * 构建微信订阅消息发送服务。
50
+ *
51
+ * 封装微信订阅消息发送逻辑,自动处理 access_token 获取、openId 查找、
52
+ * 字段长度截断(thing 类型 20 字符,character_string 类型 32 字符)等。
53
+ *
54
+ * @template T - payload 字段类型
55
+ * @param options - 构造选项
56
+ * @returns 发送订阅消息的函数
57
+ *
58
+ * @example
59
+ * ```ts
60
+ * const sendNotice = buildSendWeixinNoticeService({
61
+ * templateId: 'tmpl_abc123',
62
+ * getWeixinAccessTokenService: getAccessToken,
63
+ * getUserWeixinOpenId: async (userId) => {
64
+ * const user = await db.collection('users').doc(userId).get()
65
+ * return user.data?.openId
66
+ * },
67
+ * })
68
+ *
69
+ * await sendNotice({
70
+ * userId: 'user-123',
71
+ * clientEnv: 'release',
72
+ * payload: { thing1: '订单已发货', number1: 12345 },
73
+ * page: '/pages/order/detail?id=12345',
74
+ * })
75
+ * ```
76
+ */
77
+ function buildSendWeixinNoticeService(options) {
78
+ const { templateId, getWeixinAccessTokenService, getUserWeixinOpenId, _mockRequest } = options;
79
+ return async function sendWeixinNoticeService(sendData) {
80
+ const { userId, page, payload } = sendData;
81
+ const wxOpenId = await getUserWeixinOpenId(userId);
82
+ if (!wxOpenId) throw new Error("用户未绑定微信");
83
+ const accessToken = await getWeixinAccessTokenService();
84
+ const { data } = await (_mockRequest || require_cloud.request)({
85
+ url: `https://api.weixin.qq.com/cgi-bin/message/subscribe/send`,
86
+ method: "POST",
87
+ query: { access_token: accessToken },
88
+ data: {
89
+ touser: wxOpenId,
90
+ template_id: templateId,
91
+ page: page.replace(/^\//, ""),
92
+ miniprogram_state: sendData.clientEnv === "trial" ? "trial" : "formal",
93
+ lang: "zh_CN",
94
+ data: (0, _cloudcome_utils_core_object.objectMap)(payload, (val, key) => ({ value: _fixPayloadValue(key, val) }))
95
+ }
96
+ });
97
+ if (data.errcode === 43101) return;
98
+ if (data.errcode !== 0) throw new Error(data.errmsg || "发送失败,未知错误");
99
+ };
100
+ }
101
+ /**
102
+ * 修复通知 payload 字段值,根据微信模板字段类型自动截断。
103
+ *
104
+ * 截断规则:
105
+ * - thing 类型:20 字符以内
106
+ * - character_string 类型:32 字符以内
107
+ * - 其他类型:不处理
108
+ *
109
+ * @param key - 模板字段 key(如 thing1, number1)
110
+ * @param val - 字段值
111
+ * @returns 修复后的值
112
+ */
113
+ function _fixPayloadValue(key, val) {
114
+ if (key.startsWith("thing")) return _autoEllipsis(val.toString(), 20);
115
+ if (key.startsWith("character_string")) return _autoEllipsis(val.toString(), 32);
116
+ return val;
117
+ }
118
+ /**
119
+ * 字符串超长时自动截断并添加省略号。
120
+ *
121
+ * @param val - 原始字符串
122
+ * @param len - 最大长度
123
+ * @returns 截断后的字符串
124
+ */
125
+ function _autoEllipsis(val, len) {
126
+ return val.length > len ? `${val.slice(0, len - 3)}...` : val;
127
+ }
128
+ //#endregion
129
+ exports.buildSendWeixinNoticeService = buildSendWeixinNoticeService;
130
+ exports.buildWeixinAccessTokenService = buildWeixinAccessTokenService;
131
+
132
+ //# sourceMappingURL=weixin.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"weixin.cjs","names":[],"sources":["../src/weixin/token.ts","../src/weixin/notice.ts"],"sourcesContent":["import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { request } from '../cloud';\n\n/**\n * 构建微信 access_token 获取服务的选项\n */\nexport type BuildWeixinAccessTokenServiceOptions = {\n /**\n * 微信小程序应用ID\n */\n appId: string;\n\n /**\n * 微信小程序应用密钥\n */\n appSecret: string;\n\n /**\n * 获取临时数据(用于缓存 access_token)\n * @returns 缓存的 access_token,无缓存时返回空字符串\n */\n getTempDataService: () => Promise<string>;\n\n /**\n * 设置临时数据(用于缓存 access_token)\n * @param accessToken access_token 值\n * @param expiresIn 过期时间,单位毫秒\n */\n setTempDataService: (accessToken: string, expiresIn: number) => Promise<void>;\n\n /**\n * 模拟请求函数,用于单元测试注入\n */\n _mockRequest?: typeof request;\n};\n\n/**\n * 构建微信 access_token 获取服务。\n *\n * 自动处理缓存逻辑:优先从临时数据中获取,不存在时调用微信 API 获取并缓存。\n *\n * @param options - 构造选项\n * @returns 获取 access_token 的异步函数\n *\n * @example\n * ```ts\n * const getAccessToken = await buildWeixinAccessTokenService({\n * appId: 'wx123',\n * appSecret: 'secret',\n * getTempDataService: () => kv.get('token'),\n * setTempDataService: (token, ttl) => kv.set('token', token, ttl),\n * })\n * const token = await getAccessToken()\n * ```\n */\nexport async function buildWeixinAccessTokenService(options: BuildWeixinAccessTokenServiceOptions) {\n const { appId, appSecret, _mockRequest, getTempDataService, setTempDataService } = options;\n\n return async function getWeixinAccessTokenService() {\n let accessToken = await getTempDataService();\n if (accessToken) return accessToken;\n\n const { data: accessInfo } = await (_mockRequest || request)<{\n access_token: string;\n expires_in: number;\n errmsg: string;\n errcode: number;\n }>({\n url: 'https://api.weixin.qq.com/cgi-bin/token',\n method: 'GET',\n query: {\n grant_type: 'client_credential',\n appid: appId,\n secret: appSecret,\n },\n });\n\n if (!accessInfo.access_token) throw new Error(accessInfo.errmsg || '获取 access_token 失败');\n accessToken = accessInfo.access_token;\n\n const [err] = await tryFlatten(setTempDataService(accessToken, accessInfo.expires_in * 1000));\n if (err) console.error('设置临时数据失败', err);\n\n return accessToken;\n };\n}\n","import { request } from '@/cloud';\nimport { objectMap } from '@cloudcome/utils-core/object';\n\n/**\n * 发送微信订阅消息的数据结构\n * @template T - payload 字段类型,key 为模板字段名,value 为 string | number\n */\nexport type SendData<T> = {\n /**\n * 用户ID,用于查找对应的微信 openId\n */\n userId: string;\n\n /**\n * 小程序环境\n * - `develop`: 开发版\n * - `trial`: 体验版\n * - `release`: 正式版\n */\n clientEnv: 'develop' | 'trial' | 'release';\n\n /**\n * 通知数据,key 对应模板字段(如 thing1, number1)\n */\n payload: T;\n\n /**\n * 点击消息后跳转的页面路径,开头 `/` 会被自动移除\n */\n page: string;\n};\n\n/**\n * 构建微信订阅消息发送服务的选项\n */\nexport type BuildSendWeixinNoticeServiceOptions = {\n /**\n * 订阅消息模板ID\n */\n templateId: string;\n\n /**\n * 获取微信 access_token 的服务函数\n */\n getWeixinAccessTokenService: () => Promise<string>;\n\n /**\n * 根据用户ID获取微信 openId\n * @param userId - 用户ID\n * @returns 微信 openId,未绑定时返回空字符串\n */\n getUserWeixinOpenId: (userId: string) => Promise<string>;\n\n /**\n * 模拟请求函数,用于单元测试注入\n */\n _mockRequest?: typeof request;\n};\n\n/**\n * 构建微信订阅消息发送服务。\n *\n * 封装微信订阅消息发送逻辑,自动处理 access_token 获取、openId 查找、\n * 字段长度截断(thing 类型 20 字符,character_string 类型 32 字符)等。\n *\n * @template T - payload 字段类型\n * @param options - 构造选项\n * @returns 发送订阅消息的函数\n *\n * @example\n * ```ts\n * const sendNotice = buildSendWeixinNoticeService({\n * templateId: 'tmpl_abc123',\n * getWeixinAccessTokenService: getAccessToken,\n * getUserWeixinOpenId: async (userId) => {\n * const user = await db.collection('users').doc(userId).get()\n * return user.data?.openId\n * },\n * })\n *\n * await sendNotice({\n * userId: 'user-123',\n * clientEnv: 'release',\n * payload: { thing1: '订单已发货', number1: 12345 },\n * page: '/pages/order/detail?id=12345',\n * })\n * ```\n */\nexport function buildSendWeixinNoticeService<T extends Record<string, number | string>>(\n options: BuildSendWeixinNoticeServiceOptions,\n) {\n const { templateId, getWeixinAccessTokenService, getUserWeixinOpenId, _mockRequest } = options;\n\n return async function sendWeixinNoticeService(sendData: SendData<T>) {\n const { userId, page, payload } = sendData;\n const wxOpenId = await getUserWeixinOpenId(userId);\n if (!wxOpenId) throw new Error('用户未绑定微信');\n\n const accessToken = await getWeixinAccessTokenService();\n const { data } = await (_mockRequest || request)<{\n errcode: number;\n errmsg: string;\n }>({\n url: `https://api.weixin.qq.com/cgi-bin/message/subscribe/send`,\n method: 'POST',\n query: {\n access_token: accessToken,\n },\n data: {\n touser: wxOpenId,\n template_id: templateId,\n page: page.replace(/^\\//, ''),\n miniprogram_state: sendData.clientEnv === 'trial' ? 'trial' : 'formal',\n lang: 'zh_CN',\n data: objectMap(payload, (val, key) => ({\n value: _fixPayloadValue(key as string, val),\n })),\n },\n });\n\n if (data.errcode === 43101) return;\n\n if (data.errcode !== 0) throw new Error(data.errmsg || '发送失败,未知错误');\n };\n}\n\n/**\n * 修复通知 payload 字段值,根据微信模板字段类型自动截断。\n *\n * 截断规则:\n * - thing 类型:20 字符以内\n * - character_string 类型:32 字符以内\n * - 其他类型:不处理\n *\n * @param key - 模板字段 key(如 thing1, number1)\n * @param val - 字段值\n * @returns 修复后的值\n */\nfunction _fixPayloadValue(key: string, val: number | string) {\n if (key.startsWith('thing')) return _autoEllipsis(val.toString(), 20);\n if (key.startsWith('character_string')) return _autoEllipsis(val.toString(), 32);\n return val;\n}\n\n/**\n * 字符串超长时自动截断并添加省略号。\n *\n * @param val - 原始字符串\n * @param len - 最大长度\n * @returns 截断后的字符串\n */\nfunction _autoEllipsis(val: string, len: number) {\n return val.length > len ? `${val.slice(0, len - 3)}...` : val;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAuDA,eAAsB,8BAA8B,SAA+C;CACjG,MAAM,EAAE,OAAO,WAAW,cAAc,oBAAoB,uBAAuB;CAEnF,OAAO,eAAe,8BAA8B;EAClD,IAAI,cAAc,MAAM,oBAAoB;EAC5C,IAAI,aAAa,OAAO;EAExB,MAAM,EAAE,MAAM,eAAe,OAAO,gBAAgB,cAAA,SAKjD;GACD,KAAK;GACL,QAAQ;GACR,OAAO;IACL,YAAY;IACZ,OAAO;IACP,QAAQ;IACT;GACF,CAAC;EAEF,IAAI,CAAC,WAAW,cAAc,MAAM,IAAI,MAAM,WAAW,UAAU,qBAAqB;EACxF,cAAc,WAAW;EAEzB,MAAM,CAAC,OAAO,OAAA,GAAA,0BAAA,YAAiB,mBAAmB,aAAa,WAAW,aAAa,IAAK,CAAC;EAC7F,IAAI,KAAK,QAAQ,MAAM,YAAY,IAAI;EAEvC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACKX,SAAgB,6BACd,SACA;CACA,MAAM,EAAE,YAAY,6BAA6B,qBAAqB,iBAAiB;CAEvF,OAAO,eAAe,wBAAwB,UAAuB;EACnE,MAAM,EAAE,QAAQ,MAAM,YAAY;EAClC,MAAM,WAAW,MAAM,oBAAoB,OAAO;EAClD,IAAI,CAAC,UAAU,MAAM,IAAI,MAAM,UAAU;EAEzC,MAAM,cAAc,MAAM,6BAA6B;EACvD,MAAM,EAAE,SAAS,OAAO,gBAAgB,cAAA,SAGrC;GACD,KAAK;GACL,QAAQ;GACR,OAAO,EACL,cAAc,aACf;GACD,MAAM;IACJ,QAAQ;IACR,aAAa;IACb,MAAM,KAAK,QAAQ,OAAO,GAAG;IAC7B,mBAAmB,SAAS,cAAc,UAAU,UAAU;IAC9D,MAAM;IACN,OAAA,GAAA,6BAAA,WAAgB,UAAU,KAAK,SAAS,EACtC,OAAO,iBAAiB,KAAe,IAAI,EAC5C,EAAE;IACJ;GACF,CAAC;EAEF,IAAI,KAAK,YAAY,OAAO;EAE5B,IAAI,KAAK,YAAY,GAAG,MAAM,IAAI,MAAM,KAAK,UAAU,YAAY;;;;;;;;;;;;;;;AAgBvE,SAAS,iBAAiB,KAAa,KAAsB;CAC3D,IAAI,IAAI,WAAW,QAAQ,EAAE,OAAO,cAAc,IAAI,UAAU,EAAE,GAAG;CACrE,IAAI,IAAI,WAAW,mBAAmB,EAAE,OAAO,cAAc,IAAI,UAAU,EAAE,GAAG;CAChF,OAAO;;;;;;;;;AAUT,SAAS,cAAc,KAAa,KAAa;CAC/C,OAAO,IAAI,SAAS,MAAM,GAAG,IAAI,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO"}
@@ -0,0 +1,2 @@
1
+ export * from './weixin/token';
2
+ export * from './weixin/notice';