@cloudcome/utils-uni 1.6.0 → 1.7.0

package/dist/database/db.d.ts

@@ -133,10 +133,10 @@ export declare class Db<T, S extends DbSelect<T> = Record<string, never>> {
 export declare const db: {
     /**
      * 获取指定名称的数据库集合实例
-     * @param table 数据表名称
+     * @param name 数据表名称
      * @returns Db类实例，用于执行数据库操作
      */
-    table<T, S extends DbSelect<T> = Record<never, never>>(table: string): Db<T, S>;
+    table<T>(name: string): Db<T>;
 };
 /**
  * 解析数据库执行结果

package/dist/database.cjs

@@ -198,11 +198,19 @@ class Db {
 const db = {
   /**
    * 获取指定名称的数据库集合实例
-   * @param table 数据表名称
+   * @param name 数据表名称
    * @returns Db类实例，用于执行数据库操作
    */
-  table(table) {
-    return new Db({ table });
+  table(name) {
+    return new Proxy(
+      {},
+      {
+        get(target, prop) {
+          const table = new Db({ table: name });
+          return table[prop].bind(table);
+        }
+      }
+    );
   }
 };
 function parseDatabaseOutput(res) {

package/dist/database.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"database.cjs","sources":["../src/database/db.ts","../src/database/fns.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\nimport { objectEach, objectOmit } from '@cloudcome/utils-core/object';\nimport type {\n  AnyObject,\n  HasProperty,\n  IsEmptyObject,\n  IsOnlyProperty,\n  LowercaseStartString,\n} from '@cloudcome/utils-core/types';\nimport type { UniClientDatabaseOutput, UniCloudDatabaseOutput } from './types';\n\nexport type DbWhere<T> = {\n  [K in keyof T]?: unknown;\n};\nexport type DbSelect<T> = {\n  [K in keyof T]?: K extends '_id' ? false : true;\n};\nexport type DbFieldsDefault<T> = {\n  [K in keyof T]: true;\n};\ntype _DbFields<T, S extends DbSelect<T>> = IsEmptyObject<S> extends true // 判断是否为空对象\n  ? // 默认全部字段\n    DbFieldsDefault<T>\n  : // 判断 _id 是否为唯一属性\n    IsOnlyProperty<S, '_id'> extends true\n    ? // 从默认字段里排除 _id\n      Omit<DbFieldsDefault<T>, '_id'>\n    : // 判断是否有 _id\n      HasProperty<S, '_id'> extends true\n      ? // 有的话保留 {_id, ...}\n        S\n      : // 没有的话补上 {_id, ...}\n        S & { _id: true };\ntype _DbQuery<T, S extends Record<keyof T, boolean>> = {\n  [K in keyof T as S[K] extends true ? K : never]: T[K];\n};\n// @ts-ignore\nexport type DbQuery<T, S extends DbSelect<T>> = _DbQuery<T, _DbFields<T, S>>;\nexport type DbCreate<T> = Partial<T>;\nexport type DbUpdate<T> = Partial<T>;\nexport type DbOrder<T> = Record<keyof T, 'asc' | 'desc'>;\n\ntype _WhereFrom = 'where' | 'whereId';\n\nconst db0 = uniCloud.database();\n/**\n * 数据库操作符命令\n */\nexport const dbCmd = db0.command;\n\n/**\n * 数据库聚合操作符命令\n */\nexport const dbAgg = db0.command.aggregate;\n\nclass Aggregate {\n  #db: UniCloud.CollectionReference;\n\n  constructor(db: UniCloud.CollectionReference) {\n    this.#db = db;\n  }\n\n  start() {\n    return this.#db.aggregate();\n  }\n}\n\nexport type DbOptions = {\n  /**\n   * 数据表名称\n   */\n  table: string;\n\n  /**\n   * 事务对象，用于事务操作\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  transaction?: any;\n\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any;\n};\n\nexport class Db<T, S extends DbSelect<T> = Record<string, never>> {\n  #host: UniCloud.CollectionReference;\n\n  /**\n   * 是否为事务环境\n   * - 查询条件只能是 id\n   * - 不能聚合操作\n   */\n  #isTransaction: boolean;\n\n  /**\n   * 构造函数，初始化数据库集合引用\n   * @param collection 数据表名称\n   * @param _mockDatabase 模拟数据库，用于单元测试\n   */\n  constructor(options: DbOptions) {\n    this.#host = options._mockDatabase || options.transaction || db0.collection(options.table);\n    this.#isTransaction = !!options.transaction;\n  }\n\n  /**\n   * 创建聚合操作实例\n   * @returns 聚合操作实例\n   */\n  aggregate() {\n    if (!this.#isTransaction) throw new Error('db.aggregate() 不支持事务模式');\n\n    return this.#host.aggregate();\n  }\n\n  #hasWhere: _WhereFrom | undefined = undefined;\n  #hasWhereId: _WhereFrom | undefined = undefined;\n\n  #where(where: DbWhere<T>, from: _WhereFrom) {\n    if (this.#hasWhere) throw new Error(`已调用过一次 db.${_toWhereMethod(this.#hasWhere)} 了`);\n\n    const whereKeys = Object.keys(where);\n    const isWhereId = whereKeys.length === 1 && whereKeys[0] === '_id';\n\n    if (isWhereId && this.#hasLimit) {\n      throw new Error(`db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`);\n    }\n\n    this.#hasWhere = from;\n\n    if (isWhereId) {\n      this.#hasWhereId = from;\n      // @ts-ignore\n      this.#host = this.#host.doc(where._id);\n    } else {\n      // @ts-ignore\n      this.#host = this.#host.where(where);\n    }\n\n    return this;\n  }\n\n  /**\n   * 设置查询条件\n   * @param where 查询条件对象\n   * @returns 当前Db实例，支持链式调用\n   */\n  where(where: DbWhere<T>) {\n    return this.#where(where, 'where');\n  }\n\n  /**\n   * 根据ID设置查询条件\n   * @param id 记录ID\n   * @returns 当前Db实例，支持链式调用\n   */\n  whereId(id: string) {\n    // @ts-ignore\n    return this.#where({ _id: id }, 'whereId');\n  }\n\n  #hasSelect = 0;\n\n  /**\n   * 指定要返回的字段\n   * @param fields 要返回的字段对象，true表示返回，false表示不返回\n   * @returns 当前Db实例，支持链式调用\n   */\n  select<U extends DbSelect<T>>(fields: U): Db<T, U> {\n    if (this.#hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n    this.#hasSelect++;\n    // @ts-ignore\n    this.#host = this.#host.field(fields);\n    // @ts-ignore\n    return this;\n  }\n\n  #hasOrder = 0;\n\n  /**\n   * 设置排序规则\n   * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n   * @returns 当前Db实例，支持链式调用\n   */\n  order(order: DbOrder<T>) {\n    this.#hasOrder++;\n    objectEach(order, (val, key) => {\n      // @ts-ignore\n      this.#host = this.#host.orderBy(key, val);\n    });\n\n    return this;\n  }\n\n  #hasSkip = 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    // @ts-ignore\n    this.#host = this.#host.skip(skip);\n    return this;\n  }\n\n  #hasLimit = 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    // @ts-ignore\n    this.#host = this.#host.limit(limit);\n    return this;\n  }\n\n  /**\n   * 创建新记录\n   * @param data 要创建的数据\n   * @returns 创建结果\n   */\n  async create(data: DbCreate<T>) {\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    const res = await this.#host.add(data);\n    const { id } = parseDatabaseOutput<{ id: string }>(res);\n    return id;\n  }\n\n  /**\n   * 执行查询操作\n   * @returns 查询结果\n   */\n  async query() {\n    const res = await this.#host.get();\n    const { data } = parseDatabaseOutput<{ data: DbQuery<T, S>[] }>(res);\n    return data;\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * @param ignoreMiss 是否忽略没有匹配到记录\n   * @returns 查询结果\n   */\n  async queryOne(): Promise<DbQuery<T, S>>;\n  async queryOne(ignoreMiss: false): Promise<DbQuery<T, S>>;\n  async queryOne(ignoreMiss: true): Promise<DbQuery<T, S> | undefined>;\n  async queryOne(ignoreMiss = false): Promise<DbQuery<T, S> | undefined> {\n    if (this.#hasLimit) throw new Error('db.queryOne() 方法不支持 limit 条件');\n    if (!this.#hasWhereId) this.limit(1);\n\n    const data = await this.query();\n    const res = data.at(0);\n\n    if (!ignoreMiss && !res) throw new Error('未找到匹配记录');\n    return res;\n  }\n\n  /**\n   * 获取匹配记录的数量\n   * @returns 记录总数\n   */\n  async count() {\n    if (this.#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    const res = await this.#host.count();\n    const { total } = parseDatabaseOutput<{ total: number }>(res);\n    return total;\n  }\n\n  /**\n   * 更新记录\n   * @param data 要更新的数据\n   * @returns 更新结果\n   */\n  async update(data: AnyObject) {\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    const res = await this.#host.update(data);\n    const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n    return updated;\n  }\n\n  /**\n   * 删除记录\n   * @returns 删除结果\n   */\n  async remove() {\n    if (!this.#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    const res = await this.#host.remove();\n    const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n    return deleted;\n  }\n}\n\n/**\n * 数据库操作对象\n */\nexport const db = {\n  /**\n   * 获取指定名称的数据库集合实例\n   * @param table 数据表名称\n   * @returns Db类实例，用于执行数据库操作\n   */\n  table<T, S extends DbSelect<T> = Record<never, never>>(table: string) {\n    return new Db<T, S>({ table });\n  },\n};\n\n/**\n * 解析数据库执行结果\n * @param res 客户端、云端响应结果\n * @returns 处理后的结果\n */\nexport function parseDatabaseOutput<T>(res: UniClientDatabaseOutput<T> | UniCloudDatabaseOutput<T>) {\n  const keys = Object.keys(res as AnyObject);\n  // 客户端 { result: {errCode: 0, errMsg: 'ok'} & 数据 }\n  const isClient = keys.length === 1 && keys[0] === 'result';\n\n  if (isClient) {\n    const { result } = res as UniClientDatabaseOutput<T>;\n    if (!result.errCode) return objectOmit(result, ['errCode', 'errMsg', 'code', 'message']);\n    throw errorAssign(new Error(result.errMsg), result);\n  }\n\n  // 云端 数据\n  return res as T;\n}\n\nfunction _toWhereMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({...})' : 'whereId(id)';\n}\n\nfunction _toWhereIdMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({ _id })' : 'whereId(id)';\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MaybeCallable } from '@cloudcome/utils-core/types';\nimport { Db, type DbCreate, type DbQuery, type DbSelect, type DbUpdate, type DbWhere, db } from './db';\n\n/**\n * 数据库 upsert 操作的配置选项\n *\n * @template W - 查询条件类型\n * @template S - 查询返回字段类型\n * @template C - 创建数据类型\n * @template U - 更新数据类型\n * @template R - 查询结果类型\n */\nexport type DbUpsertOptions<\n  T,\n  W extends DbWhere<T>,\n  S extends DbSelect<T>,\n  C extends DbCreate<T>,\n  U extends DbUpdate<T>,\n> = {\n  /** 集合名称 */\n  collection: string;\n\n  /** 查询条件 */\n  where: W;\n\n  /** 查询返回字段 */\n  select?: S;\n\n  /** 创建数据 */\n  create: C;\n\n  /**\n   * 更新数据，可以是对象或根据查询结果生成更新对象的函数\n   * @param row 查询到的文档数据，仅在传入函数时可用\n   */\n  update: U | ((row: DbQuery<T, S>) => U);\n\n  /** 创建前回调函数 */\n  onBeforeCreate?: () => unknown;\n\n  /**\n   * 创建后回调函数\n   * @param id 创建的文档ID\n   */\n  onAfterCreate?: (id: string) => unknown;\n\n  /**\n   * 更新前回调函数\n   * @param row 查询到的文档\n   */\n  onBeforeUpdate?: (row: DbQuery<T, S>) => unknown;\n\n  /** 更新后回调函数 */\n  onAfterUpdate?: () => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDb?: (collection: string) => any;\n};\n\nexport async function dbUpsert<\n  T,\n  W extends DbWhere<T>,\n  S extends DbSelect<T>,\n  C extends DbCreate<T>,\n  U extends DbUpdate<T>,\n>(options: DbUpsertOptions<T, W, S, C, U>) {\n  const {\n    collection,\n    where,\n    select = {},\n    create,\n    update,\n    onBeforeCreate,\n    onAfterCreate,\n    onBeforeUpdate,\n    onAfterUpdate,\n    _mockDb,\n  } = options;\n\n  // @ts-ignore\n  if ('_id' in select) throw new Error('select 条件不能包含 _id 字段');\n\n  const _db = () => (_mockDb?.(collection) || db.table(collection)) as Db<T, S>;\n  const found = (await _db()\n    .where(where)\n    .select(select || {})\n    .limit(1)\n    .queryOne(true)) as DbQuery<T, S> | undefined;\n\n  if (found) {\n    await onBeforeUpdate?.(found);\n    const updateData = isFunction(update) ? update(found) : update;\n    // @ts-ignore\n    const updated = await _db().whereId(found._id).update(updateData);\n    onAfterUpdate?.();\n\n    return updated;\n  }\n\n  await onBeforeCreate?.();\n  const createdId = await _db().create(create);\n  await onAfterCreate?.(createdId);\n\n  return createdId;\n}\n\ntype _TransactionDb = {\n  startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n  commit: () => Promise<unknown>;\n  rollback: () => Promise<unknown>;\n};\n\n/**\n * 在数据库事务中执行操作\n *\n * @template T - 事务操作返回值类型\n * @param transact - 事务执行函数，接收事务数据库实例作为参数\n * @param _mockDatabase - 用于测试的模拟数据库实例\n * @returns 事务操作的返回结果\n *\n * @example\n * ```typescript\n * const result = await dbTransaction(async (ta) => {\n *   const user = await ta.collection('users').create({ name: 'John' });\n *   const order = await ta.collection('orders').create({ userId: user.id, amount: 100 });\n *   return { user, order };\n * });\n * ```\n */\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport async function dbTransaction<T, S extends DbSelect<T> = {}>(\n  transact: (ta: Db<T, S>) => Promise<unknown>,\n  _mockDatabase?: _TransactionDb,\n) {\n  const db = (_mockDatabase || uniCloud.database()) as _TransactionDb;\n\n  const [err1, transaction] = await tryFlatten(db.startTransaction());\n  if (err1) throw err1;\n\n  const ta = new Db<T, S>({ table: '', transaction });\n  const [err2, result] = await tryFlatten(async () => {\n    const result = await transact(ta);\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;\n}\n"],"names":["objectEach","objectOmit","errorAssign","isFunction","db","tryFlatten","result"],"mappings":"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"}
+{"version":3,"file":"database.cjs","sources":["../src/database/db.ts","../src/database/fns.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\nimport { objectEach, objectOmit } from '@cloudcome/utils-core/object';\nimport type {\n  AnyObject,\n  HasProperty,\n  IsEmptyObject,\n  IsOnlyProperty,\n  LowercaseStartString,\n} from '@cloudcome/utils-core/types';\nimport type { UniClientDatabaseOutput, UniCloudDatabaseOutput } from './types';\n\nexport type DbWhere<T> = {\n  [K in keyof T]?: unknown;\n};\nexport type DbSelect<T> = {\n  [K in keyof T]?: K extends '_id' ? false : true;\n};\nexport type DbFieldsDefault<T> = {\n  [K in keyof T]: true;\n};\ntype _DbFields<T, S extends DbSelect<T>> = IsEmptyObject<S> extends true // 判断是否为空对象\n  ? // 默认全部字段\n    DbFieldsDefault<T>\n  : // 判断 _id 是否为唯一属性\n    IsOnlyProperty<S, '_id'> extends true\n    ? // 从默认字段里排除 _id\n      Omit<DbFieldsDefault<T>, '_id'>\n    : // 判断是否有 _id\n      HasProperty<S, '_id'> extends true\n      ? // 有的话保留 {_id, ...}\n        S\n      : // 没有的话补上 {_id, ...}\n        S & { _id: true };\ntype _DbQuery<T, S extends Record<keyof T, boolean>> = {\n  [K in keyof T as S[K] extends true ? K : never]: T[K];\n};\n// @ts-ignore\nexport type DbQuery<T, S extends DbSelect<T>> = _DbQuery<T, _DbFields<T, S>>;\nexport type DbCreate<T> = Partial<T>;\nexport type DbUpdate<T> = Partial<T>;\nexport type DbOrder<T> = Record<keyof T, 'asc' | 'desc'>;\n\ntype _WhereFrom = 'where' | 'whereId';\n\nconst db0 = uniCloud.database();\n/**\n * 数据库操作符命令\n */\nexport const dbCmd = db0.command;\n\n/**\n * 数据库聚合操作符命令\n */\nexport const dbAgg = db0.command.aggregate;\n\nclass Aggregate {\n  #db: UniCloud.CollectionReference;\n\n  constructor(db: UniCloud.CollectionReference) {\n    this.#db = db;\n  }\n\n  start() {\n    return this.#db.aggregate();\n  }\n}\n\nexport type DbOptions = {\n  /**\n   * 数据表名称\n   */\n  table: string;\n\n  /**\n   * 事务对象，用于事务操作\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  transaction?: any;\n\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any;\n};\n\nexport class Db<T, S extends DbSelect<T> = Record<string, never>> {\n  #host: UniCloud.CollectionReference;\n\n  /**\n   * 是否为事务环境\n   * - 查询条件只能是 id\n   * - 不能聚合操作\n   */\n  #isTransaction: boolean;\n\n  /**\n   * 构造函数，初始化数据库集合引用\n   * @param collection 数据表名称\n   * @param _mockDatabase 模拟数据库，用于单元测试\n   */\n  constructor(options: DbOptions) {\n    this.#host = options._mockDatabase || options.transaction || db0.collection(options.table);\n    this.#isTransaction = !!options.transaction;\n  }\n\n  /**\n   * 创建聚合操作实例\n   * @returns 聚合操作实例\n   */\n  aggregate() {\n    if (!this.#isTransaction) throw new Error('db.aggregate() 不支持事务模式');\n\n    return this.#host.aggregate();\n  }\n\n  #hasWhere: _WhereFrom | undefined = undefined;\n  #hasWhereId: _WhereFrom | undefined = undefined;\n\n  #where(where: DbWhere<T>, from: _WhereFrom) {\n    if (this.#hasWhere) throw new Error(`已调用过一次 db.${_toWhereMethod(this.#hasWhere)} 了`);\n\n    const whereKeys = Object.keys(where);\n    const isWhereId = whereKeys.length === 1 && whereKeys[0] === '_id';\n\n    if (isWhereId && this.#hasLimit) {\n      throw new Error(`db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`);\n    }\n\n    this.#hasWhere = from;\n\n    if (isWhereId) {\n      this.#hasWhereId = from;\n      // @ts-ignore\n      this.#host = this.#host.doc(where._id);\n    } else {\n      // @ts-ignore\n      this.#host = this.#host.where(where);\n    }\n\n    return this;\n  }\n\n  /**\n   * 设置查询条件\n   * @param where 查询条件对象\n   * @returns 当前Db实例，支持链式调用\n   */\n  where(where: DbWhere<T>) {\n    return this.#where(where, 'where');\n  }\n\n  /**\n   * 根据ID设置查询条件\n   * @param id 记录ID\n   * @returns 当前Db实例，支持链式调用\n   */\n  whereId(id: string) {\n    // @ts-ignore\n    return this.#where({ _id: id }, 'whereId');\n  }\n\n  #hasSelect = 0;\n\n  /**\n   * 指定要返回的字段\n   * @param fields 要返回的字段对象，true表示返回，false表示不返回\n   * @returns 当前Db实例，支持链式调用\n   */\n  select<U extends DbSelect<T>>(fields: U): Db<T, U> {\n    if (this.#hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n    this.#hasSelect++;\n    // @ts-ignore\n    this.#host = this.#host.field(fields);\n    // @ts-ignore\n    return this;\n  }\n\n  #hasOrder = 0;\n\n  /**\n   * 设置排序规则\n   * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n   * @returns 当前Db实例，支持链式调用\n   */\n  order(order: DbOrder<T>) {\n    this.#hasOrder++;\n    objectEach(order, (val, key) => {\n      // @ts-ignore\n      this.#host = this.#host.orderBy(key, val);\n    });\n\n    return this;\n  }\n\n  #hasSkip = 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    // @ts-ignore\n    this.#host = this.#host.skip(skip);\n    return this;\n  }\n\n  #hasLimit = 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    // @ts-ignore\n    this.#host = this.#host.limit(limit);\n    return this;\n  }\n\n  /**\n   * 创建新记录\n   * @param data 要创建的数据\n   * @returns 创建结果\n   */\n  async create(data: DbCreate<T>) {\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    const res = await this.#host.add(data);\n    const { id } = parseDatabaseOutput<{ id: string }>(res);\n    return id;\n  }\n\n  /**\n   * 执行查询操作\n   * @returns 查询结果\n   */\n  async query() {\n    const res = await this.#host.get();\n    const { data } = parseDatabaseOutput<{ data: DbQuery<T, S>[] }>(res);\n    return data;\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * @param ignoreMiss 是否忽略没有匹配到记录\n   * @returns 查询结果\n   */\n  async queryOne(): Promise<DbQuery<T, S>>;\n  async queryOne(ignoreMiss: false): Promise<DbQuery<T, S>>;\n  async queryOne(ignoreMiss: true): Promise<DbQuery<T, S> | undefined>;\n  async queryOne(ignoreMiss = false): Promise<DbQuery<T, S> | undefined> {\n    if (this.#hasLimit) throw new Error('db.queryOne() 方法不支持 limit 条件');\n    if (!this.#hasWhereId) this.limit(1);\n\n    const data = await this.query();\n    const res = data.at(0);\n\n    if (!ignoreMiss && !res) throw new Error('未找到匹配记录');\n    return res;\n  }\n\n  /**\n   * 获取匹配记录的数量\n   * @returns 记录总数\n   */\n  async count() {\n    if (this.#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    const res = await this.#host.count();\n    const { total } = parseDatabaseOutput<{ total: number }>(res);\n    return total;\n  }\n\n  /**\n   * 更新记录\n   * @param data 要更新的数据\n   * @returns 更新结果\n   */\n  async update(data: AnyObject) {\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    const res = await this.#host.update(data);\n    const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n    return updated;\n  }\n\n  /**\n   * 删除记录\n   * @returns 删除结果\n   */\n  async remove() {\n    if (!this.#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    const res = await this.#host.remove();\n    const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n    return deleted;\n  }\n}\n\n/**\n * 数据库操作对象\n */\nexport const db = {\n  /**\n   * 获取指定名称的数据库集合实例\n   * @param name 数据表名称\n   * @returns Db类实例，用于执行数据库操作\n   */\n  table<T>(name: string) {\n    return new Proxy(\n      {},\n      {\n        get(target, prop) {\n          const table = new Db<T>({ table: name });\n          return table[prop as keyof Db<T>].bind(table);\n        },\n      },\n    ) as Db<T>;\n  },\n};\n\n/**\n * 解析数据库执行结果\n * @param res 客户端、云端响应结果\n * @returns 处理后的结果\n */\nexport function parseDatabaseOutput<T>(res: UniClientDatabaseOutput<T> | UniCloudDatabaseOutput<T>) {\n  const keys = Object.keys(res as AnyObject);\n  // 客户端 { result: {errCode: 0, errMsg: 'ok'} & 数据 }\n  const isClient = keys.length === 1 && keys[0] === 'result';\n\n  if (isClient) {\n    const { result } = res as UniClientDatabaseOutput<T>;\n    if (!result.errCode) return objectOmit(result, ['errCode', 'errMsg', 'code', 'message']);\n    throw errorAssign(new Error(result.errMsg), result);\n  }\n\n  // 云端 数据\n  return res as T;\n}\n\nfunction _toWhereMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({...})' : 'whereId(id)';\n}\n\nfunction _toWhereIdMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({ _id })' : 'whereId(id)';\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MaybeCallable } from '@cloudcome/utils-core/types';\nimport { Db, type DbCreate, type DbQuery, type DbSelect, type DbUpdate, type DbWhere, db } from './db';\n\n/**\n * 数据库 upsert 操作的配置选项\n *\n * @template W - 查询条件类型\n * @template S - 查询返回字段类型\n * @template C - 创建数据类型\n * @template U - 更新数据类型\n * @template R - 查询结果类型\n */\nexport type DbUpsertOptions<\n  T,\n  W extends DbWhere<T>,\n  S extends DbSelect<T>,\n  C extends DbCreate<T>,\n  U extends DbUpdate<T>,\n> = {\n  /** 集合名称 */\n  collection: string;\n\n  /** 查询条件 */\n  where: W;\n\n  /** 查询返回字段 */\n  select?: S;\n\n  /** 创建数据 */\n  create: C;\n\n  /**\n   * 更新数据，可以是对象或根据查询结果生成更新对象的函数\n   * @param row 查询到的文档数据，仅在传入函数时可用\n   */\n  update: U | ((row: DbQuery<T, S>) => U);\n\n  /** 创建前回调函数 */\n  onBeforeCreate?: () => unknown;\n\n  /**\n   * 创建后回调函数\n   * @param id 创建的文档ID\n   */\n  onAfterCreate?: (id: string) => unknown;\n\n  /**\n   * 更新前回调函数\n   * @param row 查询到的文档\n   */\n  onBeforeUpdate?: (row: DbQuery<T, S>) => unknown;\n\n  /** 更新后回调函数 */\n  onAfterUpdate?: () => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDb?: (collection: string) => any;\n};\n\nexport async function dbUpsert<\n  T,\n  W extends DbWhere<T>,\n  S extends DbSelect<T>,\n  C extends DbCreate<T>,\n  U extends DbUpdate<T>,\n>(options: DbUpsertOptions<T, W, S, C, U>) {\n  const {\n    collection,\n    where,\n    select = {},\n    create,\n    update,\n    onBeforeCreate,\n    onAfterCreate,\n    onBeforeUpdate,\n    onAfterUpdate,\n    _mockDb,\n  } = options;\n\n  // @ts-ignore\n  if ('_id' in select) throw new Error('select 条件不能包含 _id 字段');\n\n  const _db = () => (_mockDb?.(collection) || db.table(collection)) as Db<T, S>;\n  const found = (await _db()\n    .where(where)\n    .select(select || {})\n    .limit(1)\n    .queryOne(true)) as DbQuery<T, S> | undefined;\n\n  if (found) {\n    await onBeforeUpdate?.(found);\n    const updateData = isFunction(update) ? update(found) : update;\n    // @ts-ignore\n    const updated = await _db().whereId(found._id).update(updateData);\n    onAfterUpdate?.();\n\n    return updated;\n  }\n\n  await onBeforeCreate?.();\n  const createdId = await _db().create(create);\n  await onAfterCreate?.(createdId);\n\n  return createdId;\n}\n\ntype _TransactionDb = {\n  startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n  commit: () => Promise<unknown>;\n  rollback: () => Promise<unknown>;\n};\n\n/**\n * 在数据库事务中执行操作\n *\n * @template T - 事务操作返回值类型\n * @param transact - 事务执行函数，接收事务数据库实例作为参数\n * @param _mockDatabase - 用于测试的模拟数据库实例\n * @returns 事务操作的返回结果\n *\n * @example\n * ```typescript\n * const result = await dbTransaction(async (ta) => {\n *   const user = await ta.collection('users').create({ name: 'John' });\n *   const order = await ta.collection('orders').create({ userId: user.id, amount: 100 });\n *   return { user, order };\n * });\n * ```\n */\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport async function dbTransaction<T, S extends DbSelect<T> = {}>(\n  transact: (ta: Db<T, S>) => Promise<unknown>,\n  _mockDatabase?: _TransactionDb,\n) {\n  const db = (_mockDatabase || uniCloud.database()) as _TransactionDb;\n\n  const [err1, transaction] = await tryFlatten(db.startTransaction());\n  if (err1) throw err1;\n\n  const ta = new Db<T, S>({ table: '', transaction });\n  const [err2, result] = await tryFlatten(async () => {\n    const result = await transact(ta);\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;\n}\n"],"names":["objectEach","objectOmit","errorAssign","isFunction","db","tryFlatten","result"],"mappings":"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"}

package/dist/database.mjs

@@ -196,11 +196,19 @@ class Db {
 const db = {
   /**
    * 获取指定名称的数据库集合实例
-   * @param table 数据表名称
+   * @param name 数据表名称
    * @returns Db类实例，用于执行数据库操作
    */
-  table(table) {
-    return new Db({ table });
+  table(name) {
+    return new Proxy(
+      {},
+      {
+        get(target, prop) {
+          const table = new Db({ table: name });
+          return table[prop].bind(table);
+        }
+      }
+    );
   }
 };
 function parseDatabaseOutput(res) {

package/dist/database.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database.mjs","sources":["../src/database/db.ts","../src/database/fns.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\nimport { objectEach, objectOmit } from '@cloudcome/utils-core/object';\nimport type {\n  AnyObject,\n  HasProperty,\n  IsEmptyObject,\n  IsOnlyProperty,\n  LowercaseStartString,\n} from '@cloudcome/utils-core/types';\nimport type { UniClientDatabaseOutput, UniCloudDatabaseOutput } from './types';\n\nexport type DbWhere<T> = {\n  [K in keyof T]?: unknown;\n};\nexport type DbSelect<T> = {\n  [K in keyof T]?: K extends '_id' ? false : true;\n};\nexport type DbFieldsDefault<T> = {\n  [K in keyof T]: true;\n};\ntype _DbFields<T, S extends DbSelect<T>> = IsEmptyObject<S> extends true // 判断是否为空对象\n  ? // 默认全部字段\n    DbFieldsDefault<T>\n  : // 判断 _id 是否为唯一属性\n    IsOnlyProperty<S, '_id'> extends true\n    ? // 从默认字段里排除 _id\n      Omit<DbFieldsDefault<T>, '_id'>\n    : // 判断是否有 _id\n      HasProperty<S, '_id'> extends true\n      ? // 有的话保留 {_id, ...}\n        S\n      : // 没有的话补上 {_id, ...}\n        S & { _id: true };\ntype _DbQuery<T, S extends Record<keyof T, boolean>> = {\n  [K in keyof T as S[K] extends true ? K : never]: T[K];\n};\n// @ts-ignore\nexport type DbQuery<T, S extends DbSelect<T>> = _DbQuery<T, _DbFields<T, S>>;\nexport type DbCreate<T> = Partial<T>;\nexport type DbUpdate<T> = Partial<T>;\nexport type DbOrder<T> = Record<keyof T, 'asc' | 'desc'>;\n\ntype _WhereFrom = 'where' | 'whereId';\n\nconst db0 = uniCloud.database();\n/**\n * 数据库操作符命令\n */\nexport const dbCmd = db0.command;\n\n/**\n * 数据库聚合操作符命令\n */\nexport const dbAgg = db0.command.aggregate;\n\nclass Aggregate {\n  #db: UniCloud.CollectionReference;\n\n  constructor(db: UniCloud.CollectionReference) {\n    this.#db = db;\n  }\n\n  start() {\n    return this.#db.aggregate();\n  }\n}\n\nexport type DbOptions = {\n  /**\n   * 数据表名称\n   */\n  table: string;\n\n  /**\n   * 事务对象，用于事务操作\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  transaction?: any;\n\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any;\n};\n\nexport class Db<T, S extends DbSelect<T> = Record<string, never>> {\n  #host: UniCloud.CollectionReference;\n\n  /**\n   * 是否为事务环境\n   * - 查询条件只能是 id\n   * - 不能聚合操作\n   */\n  #isTransaction: boolean;\n\n  /**\n   * 构造函数，初始化数据库集合引用\n   * @param collection 数据表名称\n   * @param _mockDatabase 模拟数据库，用于单元测试\n   */\n  constructor(options: DbOptions) {\n    this.#host = options._mockDatabase || options.transaction || db0.collection(options.table);\n    this.#isTransaction = !!options.transaction;\n  }\n\n  /**\n   * 创建聚合操作实例\n   * @returns 聚合操作实例\n   */\n  aggregate() {\n    if (!this.#isTransaction) throw new Error('db.aggregate() 不支持事务模式');\n\n    return this.#host.aggregate();\n  }\n\n  #hasWhere: _WhereFrom | undefined = undefined;\n  #hasWhereId: _WhereFrom | undefined = undefined;\n\n  #where(where: DbWhere<T>, from: _WhereFrom) {\n    if (this.#hasWhere) throw new Error(`已调用过一次 db.${_toWhereMethod(this.#hasWhere)} 了`);\n\n    const whereKeys = Object.keys(where);\n    const isWhereId = whereKeys.length === 1 && whereKeys[0] === '_id';\n\n    if (isWhereId && this.#hasLimit) {\n      throw new Error(`db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`);\n    }\n\n    this.#hasWhere = from;\n\n    if (isWhereId) {\n      this.#hasWhereId = from;\n      // @ts-ignore\n      this.#host = this.#host.doc(where._id);\n    } else {\n      // @ts-ignore\n      this.#host = this.#host.where(where);\n    }\n\n    return this;\n  }\n\n  /**\n   * 设置查询条件\n   * @param where 查询条件对象\n   * @returns 当前Db实例，支持链式调用\n   */\n  where(where: DbWhere<T>) {\n    return this.#where(where, 'where');\n  }\n\n  /**\n   * 根据ID设置查询条件\n   * @param id 记录ID\n   * @returns 当前Db实例，支持链式调用\n   */\n  whereId(id: string) {\n    // @ts-ignore\n    return this.#where({ _id: id }, 'whereId');\n  }\n\n  #hasSelect = 0;\n\n  /**\n   * 指定要返回的字段\n   * @param fields 要返回的字段对象，true表示返回，false表示不返回\n   * @returns 当前Db实例，支持链式调用\n   */\n  select<U extends DbSelect<T>>(fields: U): Db<T, U> {\n    if (this.#hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n    this.#hasSelect++;\n    // @ts-ignore\n    this.#host = this.#host.field(fields);\n    // @ts-ignore\n    return this;\n  }\n\n  #hasOrder = 0;\n\n  /**\n   * 设置排序规则\n   * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n   * @returns 当前Db实例，支持链式调用\n   */\n  order(order: DbOrder<T>) {\n    this.#hasOrder++;\n    objectEach(order, (val, key) => {\n      // @ts-ignore\n      this.#host = this.#host.orderBy(key, val);\n    });\n\n    return this;\n  }\n\n  #hasSkip = 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    // @ts-ignore\n    this.#host = this.#host.skip(skip);\n    return this;\n  }\n\n  #hasLimit = 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    // @ts-ignore\n    this.#host = this.#host.limit(limit);\n    return this;\n  }\n\n  /**\n   * 创建新记录\n   * @param data 要创建的数据\n   * @returns 创建结果\n   */\n  async create(data: DbCreate<T>) {\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    const res = await this.#host.add(data);\n    const { id } = parseDatabaseOutput<{ id: string }>(res);\n    return id;\n  }\n\n  /**\n   * 执行查询操作\n   * @returns 查询结果\n   */\n  async query() {\n    const res = await this.#host.get();\n    const { data } = parseDatabaseOutput<{ data: DbQuery<T, S>[] }>(res);\n    return data;\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * @param ignoreMiss 是否忽略没有匹配到记录\n   * @returns 查询结果\n   */\n  async queryOne(): Promise<DbQuery<T, S>>;\n  async queryOne(ignoreMiss: false): Promise<DbQuery<T, S>>;\n  async queryOne(ignoreMiss: true): Promise<DbQuery<T, S> | undefined>;\n  async queryOne(ignoreMiss = false): Promise<DbQuery<T, S> | undefined> {\n    if (this.#hasLimit) throw new Error('db.queryOne() 方法不支持 limit 条件');\n    if (!this.#hasWhereId) this.limit(1);\n\n    const data = await this.query();\n    const res = data.at(0);\n\n    if (!ignoreMiss && !res) throw new Error('未找到匹配记录');\n    return res;\n  }\n\n  /**\n   * 获取匹配记录的数量\n   * @returns 记录总数\n   */\n  async count() {\n    if (this.#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    const res = await this.#host.count();\n    const { total } = parseDatabaseOutput<{ total: number }>(res);\n    return total;\n  }\n\n  /**\n   * 更新记录\n   * @param data 要更新的数据\n   * @returns 更新结果\n   */\n  async update(data: AnyObject) {\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    const res = await this.#host.update(data);\n    const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n    return updated;\n  }\n\n  /**\n   * 删除记录\n   * @returns 删除结果\n   */\n  async remove() {\n    if (!this.#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    const res = await this.#host.remove();\n    const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n    return deleted;\n  }\n}\n\n/**\n * 数据库操作对象\n */\nexport const db = {\n  /**\n   * 获取指定名称的数据库集合实例\n   * @param table 数据表名称\n   * @returns Db类实例，用于执行数据库操作\n   */\n  table<T, S extends DbSelect<T> = Record<never, never>>(table: string) {\n    return new Db<T, S>({ table });\n  },\n};\n\n/**\n * 解析数据库执行结果\n * @param res 客户端、云端响应结果\n * @returns 处理后的结果\n */\nexport function parseDatabaseOutput<T>(res: UniClientDatabaseOutput<T> | UniCloudDatabaseOutput<T>) {\n  const keys = Object.keys(res as AnyObject);\n  // 客户端 { result: {errCode: 0, errMsg: 'ok'} & 数据 }\n  const isClient = keys.length === 1 && keys[0] === 'result';\n\n  if (isClient) {\n    const { result } = res as UniClientDatabaseOutput<T>;\n    if (!result.errCode) return objectOmit(result, ['errCode', 'errMsg', 'code', 'message']);\n    throw errorAssign(new Error(result.errMsg), result);\n  }\n\n  // 云端 数据\n  return res as T;\n}\n\nfunction _toWhereMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({...})' : 'whereId(id)';\n}\n\nfunction _toWhereIdMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({ _id })' : 'whereId(id)';\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MaybeCallable } from '@cloudcome/utils-core/types';\nimport { Db, type DbCreate, type DbQuery, type DbSelect, type DbUpdate, type DbWhere, db } from './db';\n\n/**\n * 数据库 upsert 操作的配置选项\n *\n * @template W - 查询条件类型\n * @template S - 查询返回字段类型\n * @template C - 创建数据类型\n * @template U - 更新数据类型\n * @template R - 查询结果类型\n */\nexport type DbUpsertOptions<\n  T,\n  W extends DbWhere<T>,\n  S extends DbSelect<T>,\n  C extends DbCreate<T>,\n  U extends DbUpdate<T>,\n> = {\n  /** 集合名称 */\n  collection: string;\n\n  /** 查询条件 */\n  where: W;\n\n  /** 查询返回字段 */\n  select?: S;\n\n  /** 创建数据 */\n  create: C;\n\n  /**\n   * 更新数据，可以是对象或根据查询结果生成更新对象的函数\n   * @param row 查询到的文档数据，仅在传入函数时可用\n   */\n  update: U | ((row: DbQuery<T, S>) => U);\n\n  /** 创建前回调函数 */\n  onBeforeCreate?: () => unknown;\n\n  /**\n   * 创建后回调函数\n   * @param id 创建的文档ID\n   */\n  onAfterCreate?: (id: string) => unknown;\n\n  /**\n   * 更新前回调函数\n   * @param row 查询到的文档\n   */\n  onBeforeUpdate?: (row: DbQuery<T, S>) => unknown;\n\n  /** 更新后回调函数 */\n  onAfterUpdate?: () => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDb?: (collection: string) => any;\n};\n\nexport async function dbUpsert<\n  T,\n  W extends DbWhere<T>,\n  S extends DbSelect<T>,\n  C extends DbCreate<T>,\n  U extends DbUpdate<T>,\n>(options: DbUpsertOptions<T, W, S, C, U>) {\n  const {\n    collection,\n    where,\n    select = {},\n    create,\n    update,\n    onBeforeCreate,\n    onAfterCreate,\n    onBeforeUpdate,\n    onAfterUpdate,\n    _mockDb,\n  } = options;\n\n  // @ts-ignore\n  if ('_id' in select) throw new Error('select 条件不能包含 _id 字段');\n\n  const _db = () => (_mockDb?.(collection) || db.table(collection)) as Db<T, S>;\n  const found = (await _db()\n    .where(where)\n    .select(select || {})\n    .limit(1)\n    .queryOne(true)) as DbQuery<T, S> | undefined;\n\n  if (found) {\n    await onBeforeUpdate?.(found);\n    const updateData = isFunction(update) ? update(found) : update;\n    // @ts-ignore\n    const updated = await _db().whereId(found._id).update(updateData);\n    onAfterUpdate?.();\n\n    return updated;\n  }\n\n  await onBeforeCreate?.();\n  const createdId = await _db().create(create);\n  await onAfterCreate?.(createdId);\n\n  return createdId;\n}\n\ntype _TransactionDb = {\n  startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n  commit: () => Promise<unknown>;\n  rollback: () => Promise<unknown>;\n};\n\n/**\n * 在数据库事务中执行操作\n *\n * @template T - 事务操作返回值类型\n * @param transact - 事务执行函数，接收事务数据库实例作为参数\n * @param _mockDatabase - 用于测试的模拟数据库实例\n * @returns 事务操作的返回结果\n *\n * @example\n * ```typescript\n * const result = await dbTransaction(async (ta) => {\n *   const user = await ta.collection('users').create({ name: 'John' });\n *   const order = await ta.collection('orders').create({ userId: user.id, amount: 100 });\n *   return { user, order };\n * });\n * ```\n */\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport async function dbTransaction<T, S extends DbSelect<T> = {}>(\n  transact: (ta: Db<T, S>) => Promise<unknown>,\n  _mockDatabase?: _TransactionDb,\n) {\n  const db = (_mockDatabase || uniCloud.database()) as _TransactionDb;\n\n  const [err1, transaction] = await tryFlatten(db.startTransaction());\n  if (err1) throw err1;\n\n  const ta = new Db<T, S>({ table: '', transaction });\n  const [err2, result] = await tryFlatten(async () => {\n    const result = await transact(ta);\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;\n}\n"],"names":["db","result"],"mappings":"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"}
+{"version":3,"file":"database.mjs","sources":["../src/database/db.ts","../src/database/fns.ts"],"sourcesContent":["import { errorAssign } from '@cloudcome/utils-core/error';\nimport { objectEach, objectOmit } from '@cloudcome/utils-core/object';\nimport type {\n  AnyObject,\n  HasProperty,\n  IsEmptyObject,\n  IsOnlyProperty,\n  LowercaseStartString,\n} from '@cloudcome/utils-core/types';\nimport type { UniClientDatabaseOutput, UniCloudDatabaseOutput } from './types';\n\nexport type DbWhere<T> = {\n  [K in keyof T]?: unknown;\n};\nexport type DbSelect<T> = {\n  [K in keyof T]?: K extends '_id' ? false : true;\n};\nexport type DbFieldsDefault<T> = {\n  [K in keyof T]: true;\n};\ntype _DbFields<T, S extends DbSelect<T>> = IsEmptyObject<S> extends true // 判断是否为空对象\n  ? // 默认全部字段\n    DbFieldsDefault<T>\n  : // 判断 _id 是否为唯一属性\n    IsOnlyProperty<S, '_id'> extends true\n    ? // 从默认字段里排除 _id\n      Omit<DbFieldsDefault<T>, '_id'>\n    : // 判断是否有 _id\n      HasProperty<S, '_id'> extends true\n      ? // 有的话保留 {_id, ...}\n        S\n      : // 没有的话补上 {_id, ...}\n        S & { _id: true };\ntype _DbQuery<T, S extends Record<keyof T, boolean>> = {\n  [K in keyof T as S[K] extends true ? K : never]: T[K];\n};\n// @ts-ignore\nexport type DbQuery<T, S extends DbSelect<T>> = _DbQuery<T, _DbFields<T, S>>;\nexport type DbCreate<T> = Partial<T>;\nexport type DbUpdate<T> = Partial<T>;\nexport type DbOrder<T> = Record<keyof T, 'asc' | 'desc'>;\n\ntype _WhereFrom = 'where' | 'whereId';\n\nconst db0 = uniCloud.database();\n/**\n * 数据库操作符命令\n */\nexport const dbCmd = db0.command;\n\n/**\n * 数据库聚合操作符命令\n */\nexport const dbAgg = db0.command.aggregate;\n\nclass Aggregate {\n  #db: UniCloud.CollectionReference;\n\n  constructor(db: UniCloud.CollectionReference) {\n    this.#db = db;\n  }\n\n  start() {\n    return this.#db.aggregate();\n  }\n}\n\nexport type DbOptions = {\n  /**\n   * 数据表名称\n   */\n  table: string;\n\n  /**\n   * 事务对象，用于事务操作\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  transaction?: any;\n\n  /**\n   * 模拟数据库，用于单元测试\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDatabase?: any;\n};\n\nexport class Db<T, S extends DbSelect<T> = Record<string, never>> {\n  #host: UniCloud.CollectionReference;\n\n  /**\n   * 是否为事务环境\n   * - 查询条件只能是 id\n   * - 不能聚合操作\n   */\n  #isTransaction: boolean;\n\n  /**\n   * 构造函数，初始化数据库集合引用\n   * @param collection 数据表名称\n   * @param _mockDatabase 模拟数据库，用于单元测试\n   */\n  constructor(options: DbOptions) {\n    this.#host = options._mockDatabase || options.transaction || db0.collection(options.table);\n    this.#isTransaction = !!options.transaction;\n  }\n\n  /**\n   * 创建聚合操作实例\n   * @returns 聚合操作实例\n   */\n  aggregate() {\n    if (!this.#isTransaction) throw new Error('db.aggregate() 不支持事务模式');\n\n    return this.#host.aggregate();\n  }\n\n  #hasWhere: _WhereFrom | undefined = undefined;\n  #hasWhereId: _WhereFrom | undefined = undefined;\n\n  #where(where: DbWhere<T>, from: _WhereFrom) {\n    if (this.#hasWhere) throw new Error(`已调用过一次 db.${_toWhereMethod(this.#hasWhere)} 了`);\n\n    const whereKeys = Object.keys(where);\n    const isWhereId = whereKeys.length === 1 && whereKeys[0] === '_id';\n\n    if (isWhereId && this.#hasLimit) {\n      throw new Error(`db.${_toWhereIdMethod(from)} 方法不能与 db.limit() 方法同时调用`);\n    }\n\n    this.#hasWhere = from;\n\n    if (isWhereId) {\n      this.#hasWhereId = from;\n      // @ts-ignore\n      this.#host = this.#host.doc(where._id);\n    } else {\n      // @ts-ignore\n      this.#host = this.#host.where(where);\n    }\n\n    return this;\n  }\n\n  /**\n   * 设置查询条件\n   * @param where 查询条件对象\n   * @returns 当前Db实例，支持链式调用\n   */\n  where(where: DbWhere<T>) {\n    return this.#where(where, 'where');\n  }\n\n  /**\n   * 根据ID设置查询条件\n   * @param id 记录ID\n   * @returns 当前Db实例，支持链式调用\n   */\n  whereId(id: string) {\n    // @ts-ignore\n    return this.#where({ _id: id }, 'whereId');\n  }\n\n  #hasSelect = 0;\n\n  /**\n   * 指定要返回的字段\n   * @param fields 要返回的字段对象，true表示返回，false表示不返回\n   * @returns 当前Db实例，支持链式调用\n   */\n  select<U extends DbSelect<T>>(fields: U): Db<T, U> {\n    if (this.#hasSelect) throw new Error('db.select() 方法只能调用一次');\n\n    this.#hasSelect++;\n    // @ts-ignore\n    this.#host = this.#host.field(fields);\n    // @ts-ignore\n    return this;\n  }\n\n  #hasOrder = 0;\n\n  /**\n   * 设置排序规则\n   * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n   * @returns 当前Db实例，支持链式调用\n   */\n  order(order: DbOrder<T>) {\n    this.#hasOrder++;\n    objectEach(order, (val, key) => {\n      // @ts-ignore\n      this.#host = this.#host.orderBy(key, val);\n    });\n\n    return this;\n  }\n\n  #hasSkip = 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    // @ts-ignore\n    this.#host = this.#host.skip(skip);\n    return this;\n  }\n\n  #hasLimit = 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    // @ts-ignore\n    this.#host = this.#host.limit(limit);\n    return this;\n  }\n\n  /**\n   * 创建新记录\n   * @param data 要创建的数据\n   * @returns 创建结果\n   */\n  async create(data: DbCreate<T>) {\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    const res = await this.#host.add(data);\n    const { id } = parseDatabaseOutput<{ id: string }>(res);\n    return id;\n  }\n\n  /**\n   * 执行查询操作\n   * @returns 查询结果\n   */\n  async query() {\n    const res = await this.#host.get();\n    const { data } = parseDatabaseOutput<{ data: DbQuery<T, S>[] }>(res);\n    return data;\n  }\n\n  /**\n   * 只查询一条，自动添加 limit(1) 条件\n   * @param ignoreMiss 是否忽略没有匹配到记录\n   * @returns 查询结果\n   */\n  async queryOne(): Promise<DbQuery<T, S>>;\n  async queryOne(ignoreMiss: false): Promise<DbQuery<T, S>>;\n  async queryOne(ignoreMiss: true): Promise<DbQuery<T, S> | undefined>;\n  async queryOne(ignoreMiss = false): Promise<DbQuery<T, S> | undefined> {\n    if (this.#hasLimit) throw new Error('db.queryOne() 方法不支持 limit 条件');\n    if (!this.#hasWhereId) this.limit(1);\n\n    const data = await this.query();\n    const res = data.at(0);\n\n    if (!ignoreMiss && !res) throw new Error('未找到匹配记录');\n    return res;\n  }\n\n  /**\n   * 获取匹配记录的数量\n   * @returns 记录总数\n   */\n  async count() {\n    if (this.#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    const res = await this.#host.count();\n    const { total } = parseDatabaseOutput<{ total: number }>(res);\n    return total;\n  }\n\n  /**\n   * 更新记录\n   * @param data 要更新的数据\n   * @returns 更新结果\n   */\n  async update(data: AnyObject) {\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    const res = await this.#host.update(data);\n    const { updated } = parseDatabaseOutput<{ updated: number }>(res);\n    return updated;\n  }\n\n  /**\n   * 删除记录\n   * @returns 删除结果\n   */\n  async remove() {\n    if (!this.#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    const res = await this.#host.remove();\n    const { deleted } = parseDatabaseOutput<{ deleted: number }>(res);\n    return deleted;\n  }\n}\n\n/**\n * 数据库操作对象\n */\nexport const db = {\n  /**\n   * 获取指定名称的数据库集合实例\n   * @param name 数据表名称\n   * @returns Db类实例，用于执行数据库操作\n   */\n  table<T>(name: string) {\n    return new Proxy(\n      {},\n      {\n        get(target, prop) {\n          const table = new Db<T>({ table: name });\n          return table[prop as keyof Db<T>].bind(table);\n        },\n      },\n    ) as Db<T>;\n  },\n};\n\n/**\n * 解析数据库执行结果\n * @param res 客户端、云端响应结果\n * @returns 处理后的结果\n */\nexport function parseDatabaseOutput<T>(res: UniClientDatabaseOutput<T> | UniCloudDatabaseOutput<T>) {\n  const keys = Object.keys(res as AnyObject);\n  // 客户端 { result: {errCode: 0, errMsg: 'ok'} & 数据 }\n  const isClient = keys.length === 1 && keys[0] === 'result';\n\n  if (isClient) {\n    const { result } = res as UniClientDatabaseOutput<T>;\n    if (!result.errCode) return objectOmit(result, ['errCode', 'errMsg', 'code', 'message']);\n    throw errorAssign(new Error(result.errMsg), result);\n  }\n\n  // 云端 数据\n  return res as T;\n}\n\nfunction _toWhereMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({...})' : 'whereId(id)';\n}\n\nfunction _toWhereIdMethod(whereFrom: _WhereFrom) {\n  return whereFrom === 'where' ? 'where({ _id })' : 'whereId(id)';\n}\n","import { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction } from '@cloudcome/utils-core/type';\nimport type { AnyObject, MaybeCallable } from '@cloudcome/utils-core/types';\nimport { Db, type DbCreate, type DbQuery, type DbSelect, type DbUpdate, type DbWhere, db } from './db';\n\n/**\n * 数据库 upsert 操作的配置选项\n *\n * @template W - 查询条件类型\n * @template S - 查询返回字段类型\n * @template C - 创建数据类型\n * @template U - 更新数据类型\n * @template R - 查询结果类型\n */\nexport type DbUpsertOptions<\n  T,\n  W extends DbWhere<T>,\n  S extends DbSelect<T>,\n  C extends DbCreate<T>,\n  U extends DbUpdate<T>,\n> = {\n  /** 集合名称 */\n  collection: string;\n\n  /** 查询条件 */\n  where: W;\n\n  /** 查询返回字段 */\n  select?: S;\n\n  /** 创建数据 */\n  create: C;\n\n  /**\n   * 更新数据，可以是对象或根据查询结果生成更新对象的函数\n   * @param row 查询到的文档数据，仅在传入函数时可用\n   */\n  update: U | ((row: DbQuery<T, S>) => U);\n\n  /** 创建前回调函数 */\n  onBeforeCreate?: () => unknown;\n\n  /**\n   * 创建后回调函数\n   * @param id 创建的文档ID\n   */\n  onAfterCreate?: (id: string) => unknown;\n\n  /**\n   * 更新前回调函数\n   * @param row 查询到的文档\n   */\n  onBeforeUpdate?: (row: DbQuery<T, S>) => unknown;\n\n  /** 更新后回调函数 */\n  onAfterUpdate?: () => unknown;\n\n  /** 用于测试的模拟数据库实例 */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  _mockDb?: (collection: string) => any;\n};\n\nexport async function dbUpsert<\n  T,\n  W extends DbWhere<T>,\n  S extends DbSelect<T>,\n  C extends DbCreate<T>,\n  U extends DbUpdate<T>,\n>(options: DbUpsertOptions<T, W, S, C, U>) {\n  const {\n    collection,\n    where,\n    select = {},\n    create,\n    update,\n    onBeforeCreate,\n    onAfterCreate,\n    onBeforeUpdate,\n    onAfterUpdate,\n    _mockDb,\n  } = options;\n\n  // @ts-ignore\n  if ('_id' in select) throw new Error('select 条件不能包含 _id 字段');\n\n  const _db = () => (_mockDb?.(collection) || db.table(collection)) as Db<T, S>;\n  const found = (await _db()\n    .where(where)\n    .select(select || {})\n    .limit(1)\n    .queryOne(true)) as DbQuery<T, S> | undefined;\n\n  if (found) {\n    await onBeforeUpdate?.(found);\n    const updateData = isFunction(update) ? update(found) : update;\n    // @ts-ignore\n    const updated = await _db().whereId(found._id).update(updateData);\n    onAfterUpdate?.();\n\n    return updated;\n  }\n\n  await onBeforeCreate?.();\n  const createdId = await _db().create(create);\n  await onAfterCreate?.(createdId);\n\n  return createdId;\n}\n\ntype _TransactionDb = {\n  startTransaction: () => Promise<_Transaction>;\n};\n\ntype _Transaction = {\n  commit: () => Promise<unknown>;\n  rollback: () => Promise<unknown>;\n};\n\n/**\n * 在数据库事务中执行操作\n *\n * @template T - 事务操作返回值类型\n * @param transact - 事务执行函数，接收事务数据库实例作为参数\n * @param _mockDatabase - 用于测试的模拟数据库实例\n * @returns 事务操作的返回结果\n *\n * @example\n * ```typescript\n * const result = await dbTransaction(async (ta) => {\n *   const user = await ta.collection('users').create({ name: 'John' });\n *   const order = await ta.collection('orders').create({ userId: user.id, amount: 100 });\n *   return { user, order };\n * });\n * ```\n */\n// biome-ignore lint/complexity/noBannedTypes: <explanation>\nexport async function dbTransaction<T, S extends DbSelect<T> = {}>(\n  transact: (ta: Db<T, S>) => Promise<unknown>,\n  _mockDatabase?: _TransactionDb,\n) {\n  const db = (_mockDatabase || uniCloud.database()) as _TransactionDb;\n\n  const [err1, transaction] = await tryFlatten(db.startTransaction());\n  if (err1) throw err1;\n\n  const ta = new Db<T, S>({ table: '', transaction });\n  const [err2, result] = await tryFlatten(async () => {\n    const result = await transact(ta);\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;\n}\n"],"names":["db","result"],"mappings":"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"}

package/dist/index.cjs

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

package/dist/index.mjs

@@ -1,4 +1,4 @@
-const VERSION = "1.5.1";
+const VERSION = "1.6.0";
 export {
   VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcome/utils-uni",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "cloudcome utils for uni-app",
   "engines": {
     "node": ">=22"