@cloudcome/utils-uni 1.3.1 → 1.4.0

package/dist/database/types.d.ts

@@ -0,0 +1,9 @@
+export type UniClientDatabaseOutput<T> = {
+    result: T & {
+        code?: number | string;
+        errCode?: number | string;
+        errMsg?: string;
+        message?: string;
+    };
+};
+export type UniCloudDatabaseOutput<T> = T;

package/dist/database.cjs

@@ -0,0 +1,200 @@
+"use strict";
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var _db, _db2;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const error = require("@cloudcome/utils-core/error");
+const object = require("@cloudcome/utils-core/object");
+const db0 = uniCloud.database();
+const dbCmd = db0.command;
+const dbAgg = db0.command.aggregate;
+class Aggregate {
+  constructor(db2) {
+    __privateAdd(this, _db);
+    __privateSet(this, _db, db2);
+  }
+  start() {
+    return __privateGet(this, _db).aggregate();
+  }
+}
+_db = new WeakMap();
+class Db {
+  /**
+   * 构造函数，初始化数据库集合引用
+   * @param collection 集合名称
+   */
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  constructor(collection, _mockDatabase) {
+    __privateAdd(this, _db2);
+    __privateSet(this, _db2, _mockDatabase || db0.collection(collection));
+  }
+  aggregate() {
+    return new Aggregate(__privateGet(this, _db2)).start();
+  }
+  start() {
+    return {
+      where: this.where.bind(this),
+      select: this.select.bind(this),
+      order: this.order.bind(this),
+      skip: this.skip.bind(this),
+      limit: this.limit.bind(this),
+      create: this.create.bind(this),
+      count: this.count.bind(this),
+      query: this.query.bind(this),
+      aggregate: this.aggregate.bind(this)
+    };
+  }
+  /**
+   * 设置查询条件
+   * @param where 查询条件对象
+   * @returns 当前Db实例，支持链式调用
+   */
+  where(where) {
+    __privateSet(this, _db2, __privateGet(this, _db2).where(where));
+    return {
+      where: this.where.bind(this),
+      select: this.select.bind(this),
+      order: this.order.bind(this),
+      skip: this.skip.bind(this),
+      limit: this.limit.bind(this),
+      count: this.count.bind(this),
+      query: this.query.bind(this),
+      update: this.update.bind(this),
+      remove: this.remove.bind(this)
+    };
+  }
+  /**
+   * 指定要返回的字段
+   * @param fields 要返回的字段对象，true表示返回，false表示不返回
+   * @returns 当前Db实例，支持链式调用
+   */
+  select(fields) {
+    __privateSet(this, _db2, __privateGet(this, _db2).field(fields));
+    return {
+      where: this.where.bind(this),
+      order: this.order.bind(this),
+      skip: this.skip.bind(this),
+      limit: this.limit.bind(this),
+      query: this.query.bind(this)
+    };
+  }
+  /**
+   * 设置排序规则
+   * @param order 排序规则对象，key为字段名，value为"asc"或"desc"
+   * @returns 当前Db实例，支持链式调用
+   */
+  order(order) {
+    object.objectEach(order, (val, key) => {
+      __privateSet(this, _db2, __privateGet(this, _db2).orderBy(key, val));
+    });
+    return {
+      where: this.where.bind(this),
+      order: this.order.bind(this),
+      skip: this.skip.bind(this),
+      limit: this.limit.bind(this),
+      query: this.query.bind(this)
+    };
+  }
+  /**
+   * 跳过指定数量的记录
+   * @param skip 要跳过的记录数
+   * @returns 当前Db实例，支持链式调用
+   */
+  skip(skip) {
+    __privateSet(this, _db2, __privateGet(this, _db2).skip(skip));
+    return {
+      where: this.where.bind(this),
+      order: this.order.bind(this),
+      limit: this.limit.bind(this),
+      query: this.query.bind(this)
+    };
+  }
+  /**
+   * 限制返回的记录数量
+   * @param limit 最大返回记录数
+   * @returns 当前Db实例，支持链式调用
+   */
+  limit(limit) {
+    __privateSet(this, _db2, __privateGet(this, _db2).limit(limit));
+    return {
+      where: this.where.bind(this),
+      order: this.order.bind(this),
+      skip: this.skip.bind(this),
+      query: this.query.bind(this)
+    };
+  }
+  /**
+   * 创建新记录
+   * @param data 要创建的数据
+   * @returns 创建结果
+   */
+  async create(data) {
+    const res = await __privateGet(this, _db2).add(data);
+    return parseDatabaseOutput(res);
+  }
+  /**
+   * 获取匹配记录的数量
+   * @returns 记录总数
+   */
+  async count() {
+    const res = await __privateGet(this, _db2).count();
+    return parseDatabaseOutput(res);
+  }
+  /**
+   * 执行查询操作
+   * @returns 查询结果
+   */
+  async query() {
+    const res = await __privateGet(this, _db2).get();
+    return parseDatabaseOutput(res);
+  }
+  /**
+   * 更新记录
+   * @param data 要更新的数据
+   * @returns 更新结果
+   */
+  async update(data) {
+    const res = await __privateGet(this, _db2).update(data);
+    return parseDatabaseOutput(res);
+  }
+  /**
+   * 删除记录
+   * @returns 删除结果
+   */
+  async remove() {
+    const res = await __privateGet(this, _db2).remove();
+    return parseDatabaseOutput(res);
+  }
+}
+_db2 = new WeakMap();
+const db = {
+  /**
+   * 获取指定名称的数据库集合实例
+   * @param collection 集合名称
+   * @returns Db类实例，用于执行数据库操作
+   */
+  collection(collection) {
+    return new Db(collection).start();
+  }
+};
+function parseDatabaseOutput(res) {
+  const keys = Object.keys(res);
+  const isClient = keys.length === 1 && keys[0] === "result";
+  if (isClient) {
+    const { result } = res;
+    if (!result.errCode) return object.objectOmit(result, ["errCode", "errMsg", "code", "message"]);
+    throw error.errorAssign(new Error(result.errMsg), result);
+  }
+  return res;
+}
+exports.Db = Db;
+exports.db = db;
+exports.dbAgg = dbAgg;
+exports.dbCmd = dbCmd;
+exports.parseDatabaseOutput = parseDatabaseOutput;
+//# sourceMappingURL=database.cjs.map

package/dist/database.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.cjs","sources":["../src/database/db.ts"],"sourcesContent":["import { parseCloudObjectOutput } from '@/_helpers';\nimport { type UniCloudObjectOutput, respondCloudObject } from '@/cloud';\nimport { errorAssign } from '@cloudcome/utils-core/error';\nimport { objectEach, objectOmit } from '@cloudcome/utils-core/object';\nimport type { UniClientDatabaseOutput, UniCloudDatabaseOutput } from './types';\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 class Db {\n  #db: UniCloud.CollectionReference;\n\n  /**\n   * 构造函数，初始化数据库集合引用\n   * @param collection 集合名称\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  constructor(collection: string, _mockDatabase?: any) {\n    this.#db = _mockDatabase || db0.collection(collection);\n  }\n\n  aggregate() {\n    return new Aggregate(this.#db).start();\n  }\n\n  start() {\n    return {\n      where: this.where.bind(this),\n      select: this.select.bind(this),\n      order: this.order.bind(this),\n      skip: this.skip.bind(this),\n      limit: this.limit.bind(this),\n      create: this.create.bind(this),\n      count: this.count.bind(this),\n      query: this.query.bind(this),\n      aggregate: this.aggregate.bind(this),\n    };\n  }\n\n  /**\n   * 设置查询条件\n   * @param where 查询条件对象\n   * @returns 当前Db实例，支持链式调用\n   */\n  where(where: AnyObject) {\n    // @ts-ignore\n    this.#db = this.#db.where(where);\n    return {\n      where: this.where.bind(this),\n      select: this.select.bind(this),\n      order: this.order.bind(this),\n      skip: this.skip.bind(this),\n      limit: this.limit.bind(this),\n      count: this.count.bind(this),\n      query: this.query.bind(this),\n      update: this.update.bind(this),\n      remove: this.remove.bind(this),\n    };\n  }\n\n  /**\n   * 指定要返回的字段\n   * @param fields 要返回的字段对象，true表示返回，false表示不返回\n   * @returns 当前Db实例，支持链式调用\n   */\n  select(fields: Record<string, true> & { _id?: false }) {\n    // @ts-ignore\n    this.#db = this.#db.field(fields);\n    return {\n      where: this.where.bind(this),\n      order: this.order.bind(this),\n      skip: this.skip.bind(this),\n      limit: this.limit.bind(this),\n      query: this.query.bind(this),\n    };\n  }\n\n  /**\n   * 设置排序规则\n   * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n   * @returns 当前Db实例，支持链式调用\n   */\n  order(order: Record<string, 'asc' | 'desc'>) {\n    objectEach(order, (val, key) => {\n      // @ts-ignore\n      this.#db = this.#db.orderBy(key, val);\n    });\n\n    return {\n      where: this.where.bind(this),\n      order: this.order.bind(this),\n      skip: this.skip.bind(this),\n      limit: this.limit.bind(this),\n      query: this.query.bind(this),\n    };\n  }\n\n  /**\n   * 跳过指定数量的记录\n   * @param skip 要跳过的记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  skip(skip: number) {\n    // @ts-ignore\n    this.#db = this.#db.skip(skip);\n    return {\n      where: this.where.bind(this),\n      order: this.order.bind(this),\n      limit: this.limit.bind(this),\n      query: this.query.bind(this),\n    };\n  }\n\n  /**\n   * 限制返回的记录数量\n   * @param limit 最大返回记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  limit(limit: number) {\n    // @ts-ignore\n    this.#db = this.#db.limit(limit);\n    return {\n      where: this.where.bind(this),\n      order: this.order.bind(this),\n      skip: this.skip.bind(this),\n      query: this.query.bind(this),\n    };\n  }\n\n  /**\n   * 创建新记录\n   * @param data 要创建的数据\n   * @returns 创建结果\n   */\n  async create(data: AnyObject) {\n    const res = await this.#db.add(data);\n    return parseDatabaseOutput<{ id: string }>(res);\n  }\n\n  /**\n   * 获取匹配记录的数量\n   * @returns 记录总数\n   */\n  async count() {\n    const res = await this.#db.count();\n    return parseDatabaseOutput<{ total: number }>(res);\n  }\n\n  /**\n   * 执行查询操作\n   * @returns 查询结果\n   */\n  async query<T>() {\n    const res = await this.#db.get();\n    return parseDatabaseOutput<{ data: T[] }>(res);\n  }\n\n  /**\n   * 更新记录\n   * @param data 要更新的数据\n   * @returns 更新结果\n   */\n  async update(data: AnyObject) {\n    const res = await this.#db.update(data);\n    return parseDatabaseOutput<{ updated: number }>(res);\n  }\n\n  /**\n   * 删除记录\n   * @returns 删除结果\n   */\n  async remove() {\n    const res = await this.#db.remove();\n    return parseDatabaseOutput<{ deleted: number }>(res);\n  }\n}\n\n/**\n * 数据库操作对象\n */\nexport const db = {\n  /**\n   * 获取指定名称的数据库集合实例\n   * @param collection 集合名称\n   * @returns Db类实例，用于执行数据库操作\n   */\n  collection(collection: string) {\n    return new Db(collection).start();\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"],"names":["db","_db","objectEach","objectOmit","errorAssign"],"mappings":"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"}

package/dist/database.d.ts

@@ -0,0 +1,2 @@
+export * from './database/db';
+export * from './database/types';

package/dist/database.mjs

@@ -0,0 +1,200 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var _db, _db2;
+import { errorAssign } from "@cloudcome/utils-core/error";
+import { objectEach, objectOmit } from "@cloudcome/utils-core/object";
+const db0 = uniCloud.database();
+const dbCmd = db0.command;
+const dbAgg = db0.command.aggregate;
+class Aggregate {
+  constructor(db2) {
+    __privateAdd(this, _db);
+    __privateSet(this, _db, db2);
+  }
+  start() {
+    return __privateGet(this, _db).aggregate();
+  }
+}
+_db = new WeakMap();
+class Db {
+  /**
+   * 构造函数，初始化数据库集合引用
+   * @param collection 集合名称
+   */
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  constructor(collection, _mockDatabase) {
+    __privateAdd(this, _db2);
+    __privateSet(this, _db2, _mockDatabase || db0.collection(collection));
+  }
+  aggregate() {
+    return new Aggregate(__privateGet(this, _db2)).start();
+  }
+  start() {
+    return {
+      where: this.where.bind(this),
+      select: this.select.bind(this),
+      order: this.order.bind(this),
+      skip: this.skip.bind(this),
+      limit: this.limit.bind(this),
+      create: this.create.bind(this),
+      count: this.count.bind(this),
+      query: this.query.bind(this),
+      aggregate: this.aggregate.bind(this)
+    };
+  }
+  /**
+   * 设置查询条件
+   * @param where 查询条件对象
+   * @returns 当前Db实例，支持链式调用
+   */
+  where(where) {
+    __privateSet(this, _db2, __privateGet(this, _db2).where(where));
+    return {
+      where: this.where.bind(this),
+      select: this.select.bind(this),
+      order: this.order.bind(this),
+      skip: this.skip.bind(this),
+      limit: this.limit.bind(this),
+      count: this.count.bind(this),
+      query: this.query.bind(this),
+      update: this.update.bind(this),
+      remove: this.remove.bind(this)
+    };
+  }
+  /**
+   * 指定要返回的字段
+   * @param fields 要返回的字段对象，true表示返回，false表示不返回
+   * @returns 当前Db实例，支持链式调用
+   */
+  select(fields) {
+    __privateSet(this, _db2, __privateGet(this, _db2).field(fields));
+    return {
+      where: this.where.bind(this),
+      order: this.order.bind(this),
+      skip: this.skip.bind(this),
+      limit: this.limit.bind(this),
+      query: this.query.bind(this)
+    };
+  }
+  /**
+   * 设置排序规则
+   * @param order 排序规则对象，key为字段名，value为"asc"或"desc"
+   * @returns 当前Db实例，支持链式调用
+   */
+  order(order) {
+    objectEach(order, (val, key) => {
+      __privateSet(this, _db2, __privateGet(this, _db2).orderBy(key, val));
+    });
+    return {
+      where: this.where.bind(this),
+      order: this.order.bind(this),
+      skip: this.skip.bind(this),
+      limit: this.limit.bind(this),
+      query: this.query.bind(this)
+    };
+  }
+  /**
+   * 跳过指定数量的记录
+   * @param skip 要跳过的记录数
+   * @returns 当前Db实例，支持链式调用
+   */
+  skip(skip) {
+    __privateSet(this, _db2, __privateGet(this, _db2).skip(skip));
+    return {
+      where: this.where.bind(this),
+      order: this.order.bind(this),
+      limit: this.limit.bind(this),
+      query: this.query.bind(this)
+    };
+  }
+  /**
+   * 限制返回的记录数量
+   * @param limit 最大返回记录数
+   * @returns 当前Db实例，支持链式调用
+   */
+  limit(limit) {
+    __privateSet(this, _db2, __privateGet(this, _db2).limit(limit));
+    return {
+      where: this.where.bind(this),
+      order: this.order.bind(this),
+      skip: this.skip.bind(this),
+      query: this.query.bind(this)
+    };
+  }
+  /**
+   * 创建新记录
+   * @param data 要创建的数据
+   * @returns 创建结果
+   */
+  async create(data) {
+    const res = await __privateGet(this, _db2).add(data);
+    return parseDatabaseOutput(res);
+  }
+  /**
+   * 获取匹配记录的数量
+   * @returns 记录总数
+   */
+  async count() {
+    const res = await __privateGet(this, _db2).count();
+    return parseDatabaseOutput(res);
+  }
+  /**
+   * 执行查询操作
+   * @returns 查询结果
+   */
+  async query() {
+    const res = await __privateGet(this, _db2).get();
+    return parseDatabaseOutput(res);
+  }
+  /**
+   * 更新记录
+   * @param data 要更新的数据
+   * @returns 更新结果
+   */
+  async update(data) {
+    const res = await __privateGet(this, _db2).update(data);
+    return parseDatabaseOutput(res);
+  }
+  /**
+   * 删除记录
+   * @returns 删除结果
+   */
+  async remove() {
+    const res = await __privateGet(this, _db2).remove();
+    return parseDatabaseOutput(res);
+  }
+}
+_db2 = new WeakMap();
+const db = {
+  /**
+   * 获取指定名称的数据库集合实例
+   * @param collection 集合名称
+   * @returns Db类实例，用于执行数据库操作
+   */
+  collection(collection) {
+    return new Db(collection).start();
+  }
+};
+function parseDatabaseOutput(res) {
+  const keys = Object.keys(res);
+  const isClient = keys.length === 1 && keys[0] === "result";
+  if (isClient) {
+    const { result } = res;
+    if (!result.errCode) return objectOmit(result, ["errCode", "errMsg", "code", "message"]);
+    throw errorAssign(new Error(result.errMsg), result);
+  }
+  return res;
+}
+export {
+  Db,
+  db,
+  dbAgg,
+  dbCmd,
+  parseDatabaseOutput
+};
+//# sourceMappingURL=database.mjs.map

package/dist/database.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.mjs","sources":["../src/database/db.ts"],"sourcesContent":["import { parseCloudObjectOutput } from '@/_helpers';\nimport { type UniCloudObjectOutput, respondCloudObject } from '@/cloud';\nimport { errorAssign } from '@cloudcome/utils-core/error';\nimport { objectEach, objectOmit } from '@cloudcome/utils-core/object';\nimport type { UniClientDatabaseOutput, UniCloudDatabaseOutput } from './types';\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 class Db {\n  #db: UniCloud.CollectionReference;\n\n  /**\n   * 构造函数，初始化数据库集合引用\n   * @param collection 集合名称\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  constructor(collection: string, _mockDatabase?: any) {\n    this.#db = _mockDatabase || db0.collection(collection);\n  }\n\n  aggregate() {\n    return new Aggregate(this.#db).start();\n  }\n\n  start() {\n    return {\n      where: this.where.bind(this),\n      select: this.select.bind(this),\n      order: this.order.bind(this),\n      skip: this.skip.bind(this),\n      limit: this.limit.bind(this),\n      create: this.create.bind(this),\n      count: this.count.bind(this),\n      query: this.query.bind(this),\n      aggregate: this.aggregate.bind(this),\n    };\n  }\n\n  /**\n   * 设置查询条件\n   * @param where 查询条件对象\n   * @returns 当前Db实例，支持链式调用\n   */\n  where(where: AnyObject) {\n    // @ts-ignore\n    this.#db = this.#db.where(where);\n    return {\n      where: this.where.bind(this),\n      select: this.select.bind(this),\n      order: this.order.bind(this),\n      skip: this.skip.bind(this),\n      limit: this.limit.bind(this),\n      count: this.count.bind(this),\n      query: this.query.bind(this),\n      update: this.update.bind(this),\n      remove: this.remove.bind(this),\n    };\n  }\n\n  /**\n   * 指定要返回的字段\n   * @param fields 要返回的字段对象，true表示返回，false表示不返回\n   * @returns 当前Db实例，支持链式调用\n   */\n  select(fields: Record<string, true> & { _id?: false }) {\n    // @ts-ignore\n    this.#db = this.#db.field(fields);\n    return {\n      where: this.where.bind(this),\n      order: this.order.bind(this),\n      skip: this.skip.bind(this),\n      limit: this.limit.bind(this),\n      query: this.query.bind(this),\n    };\n  }\n\n  /**\n   * 设置排序规则\n   * @param order 排序规则对象，key为字段名，value为\"asc\"或\"desc\"\n   * @returns 当前Db实例，支持链式调用\n   */\n  order(order: Record<string, 'asc' | 'desc'>) {\n    objectEach(order, (val, key) => {\n      // @ts-ignore\n      this.#db = this.#db.orderBy(key, val);\n    });\n\n    return {\n      where: this.where.bind(this),\n      order: this.order.bind(this),\n      skip: this.skip.bind(this),\n      limit: this.limit.bind(this),\n      query: this.query.bind(this),\n    };\n  }\n\n  /**\n   * 跳过指定数量的记录\n   * @param skip 要跳过的记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  skip(skip: number) {\n    // @ts-ignore\n    this.#db = this.#db.skip(skip);\n    return {\n      where: this.where.bind(this),\n      order: this.order.bind(this),\n      limit: this.limit.bind(this),\n      query: this.query.bind(this),\n    };\n  }\n\n  /**\n   * 限制返回的记录数量\n   * @param limit 最大返回记录数\n   * @returns 当前Db实例，支持链式调用\n   */\n  limit(limit: number) {\n    // @ts-ignore\n    this.#db = this.#db.limit(limit);\n    return {\n      where: this.where.bind(this),\n      order: this.order.bind(this),\n      skip: this.skip.bind(this),\n      query: this.query.bind(this),\n    };\n  }\n\n  /**\n   * 创建新记录\n   * @param data 要创建的数据\n   * @returns 创建结果\n   */\n  async create(data: AnyObject) {\n    const res = await this.#db.add(data);\n    return parseDatabaseOutput<{ id: string }>(res);\n  }\n\n  /**\n   * 获取匹配记录的数量\n   * @returns 记录总数\n   */\n  async count() {\n    const res = await this.#db.count();\n    return parseDatabaseOutput<{ total: number }>(res);\n  }\n\n  /**\n   * 执行查询操作\n   * @returns 查询结果\n   */\n  async query<T>() {\n    const res = await this.#db.get();\n    return parseDatabaseOutput<{ data: T[] }>(res);\n  }\n\n  /**\n   * 更新记录\n   * @param data 要更新的数据\n   * @returns 更新结果\n   */\n  async update(data: AnyObject) {\n    const res = await this.#db.update(data);\n    return parseDatabaseOutput<{ updated: number }>(res);\n  }\n\n  /**\n   * 删除记录\n   * @returns 删除结果\n   */\n  async remove() {\n    const res = await this.#db.remove();\n    return parseDatabaseOutput<{ deleted: number }>(res);\n  }\n}\n\n/**\n * 数据库操作对象\n */\nexport const db = {\n  /**\n   * 获取指定名称的数据库集合实例\n   * @param collection 集合名称\n   * @returns Db类实例，用于执行数据库操作\n   */\n  collection(collection: string) {\n    return new Db(collection).start();\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"],"names":["db","_db"],"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.3.0";
+const VERSION = "1.3.1";
 exports.VERSION = VERSION;
 //# sourceMappingURL=index.cjs.map

package/dist/index.mjs

@@ -1,4 +1,4 @@
-const VERSION = "1.3.0";
+const VERSION = "1.3.1";
 export {
   VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcome/utils-uni",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "cloudcome utils for uni-app",
   "engines": {
     "node": ">=22"
@@ -14,11 +14,21 @@
       "require": "./dist/index.cjs"
     },
     "./package.json": "./package.json",
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.mjs",
+      "require": "./dist/client.cjs"
+    },
     "./cloud": {
       "types": "./dist/cloud.d.ts",
       "import": "./dist/cloud.mjs",
       "require": "./dist/cloud.cjs"
     },
+    "./database": {
+      "types": "./dist/database.d.ts",
+      "import": "./dist/database.mjs",
+      "require": "./dist/database.cjs"
+    },
     "./page": {
       "types": "./dist/page.d.ts",
       "import": "./dist/page.mjs",
@@ -27,9 +37,15 @@
   },
   "typesVersions": {
     "*": {
+      "client": [
+        "./dist/client.d.ts"
+      ],
       "cloud": [
         "./dist/cloud.d.ts"
       ],
+      "database": [
+        "./dist/database.d.ts"
+      ],
       "page": [
         "./dist/page.d.ts"
       ]
@@ -42,11 +58,12 @@
     "dist"
   ],
   "dependencies": {
-    "@cloudcome/utils-core": "~1.5.0",
-    "@cloudcome/utils-vue": "~1.9.1",
+    "@cloudcome/utils-core": "~1.6.0",
+    "@cloudcome/utils-vue": "~1.9.2",
     "@dcloudio/types": "^3.4.21",
     "@dcloudio/uni-app": "vue3",
-    "vue": "^3.5.13"
+    "vue": "^3.5.13",
+    "zod": "^4.1.8"
   },
   "repository": {
     "type": "git",