@cloudbase/js-sdk 3.1.4 → 3.1.6

package/index.d.ts

@@ -525,7 +525,7 @@ declare namespace cloudbase.app {
     /**
      * 获取数据库实例
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#%E8%8E%B7%E5%8F%96%E6%95%B0%E6%8D%AE%E5%BA%93%E5%AE%9E%E4%BE%8B}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#%E8%8E%B7%E5%8F%96%E6%95%B0%E6%8D%AE%E5%BA%93%E5%AE%9E%E4%BE%8B}
      *
      * @example
      * ```javascript
@@ -537,7 +537,7 @@ declare namespace cloudbase.app {
      *
      * @return 数据库实例
      */
-    database(dbConfig?: object): cloudbase.database.App
+    database(dbConfig?: cloudbase.database.IDbConfig): cloudbase.database.App
     /**
      * 调用扩展能力插件功能
      *
@@ -1444,7 +1444,7 @@ declare namespace cloudbase.database {
     /**
      * 关闭实时推送
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database.html#shu-ju-ku-shi-shi-tui-song}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database.html#shu-ju-ku-shi-shi-tui-song}
      *
      * @example
      * // 启动监听
@@ -1489,7 +1489,7 @@ declare namespace cloudbase.database {
     /**
      * 开启实时推送
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#%E6%95%B0%E6%8D%AE%E5%BA%93%E5%AE%9E%E6%97%B6%E6%8E%A8%E9%80%81}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#%E6%95%B0%E6%8D%AE%E5%BA%93%E5%AE%9E%E6%97%B6%E6%8E%A8%E9%80%81}
      *
      * @example
      * const ref = db
@@ -1516,21 +1516,44 @@ declare namespace cloudbase.database {
    */
   interface ICollection extends IQuery {
     /**
-     * 插入一条文档
+     * 向集合中添加一条新记录
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#add}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#add}
      *
-     * @param data 文档数据
+     * @example
+     * const result = await db.collection('todos').add({
+     *   title: '学习 CloudBase',
+     *   completed: false
+     * })
+     * console.log('新增成功，文档 ID:', result.id)
+     *
+     * @param data 要新增的数据对象，支持嵌套对象、数组、地理位置等数据类型
+     *
+     * @return Promise<AddRes> 包含新增文档的 id 和 requestId
      */
-    add(data: Object): Promise<Pick<SetRes, 'code' | 'message'>>
+    add(data: Object): Promise<AddRes>
     /**
      * 获取一条文档的引用
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#record--document}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#record--document}
      *
      * @param id 文档ID
      */
-    doc(id: string): IDocument
+    doc(id: string | number): IDocument
+    /**
+     * 获取聚合操作对象
+     *
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#aggregate}
+     *
+     * @example
+     * const result = await db.collection('todos')
+     *   .aggregate()
+     *   .group({ _id: '$priority', count: { $sum: 1 } })
+     *   .end()
+     *
+     * @return 聚合操作对象，可链式调用各种聚合阶段方法
+     */
+    aggregate(): IAggregate
   }
   /**
    * command types
@@ -1550,7 +1573,7 @@ declare namespace cloudbase.database {
     /**
      * 表示字段等于某个值
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#eq}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#eq}
      *
      * @example
      * const _ = db.command;
@@ -1565,7 +1588,7 @@ declare namespace cloudbase.database {
     /**
      * 表示字段不等于某个值
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#neq}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#neq}
      *
      * @example
      * const _ = db.command;
@@ -1580,7 +1603,7 @@ declare namespace cloudbase.database {
     /**
      * 字段大于指定值
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#gt}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#gt}
      *
      * @example
      * const _ = db.command;
@@ -1595,7 +1618,7 @@ declare namespace cloudbase.database {
     /**
      * 字段大于或等于指定值
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#neq}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#neq}
      *
      * @example
      * const _ = db.command;
@@ -1610,7 +1633,7 @@ declare namespace cloudbase.database {
     /**
      * 字段小于指定值
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#lt}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#lt}
      *
      * @example
      * const _ = db.command;
@@ -1625,7 +1648,7 @@ declare namespace cloudbase.database {
     /**
      * 字段小于或等于指定值
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#lte}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#lte}
      *
      * @example
      * const _ = db.command;
@@ -1640,7 +1663,7 @@ declare namespace cloudbase.database {
     /**
      * 字段值在给定的数组中
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#in}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#in}
      *
      * @example
      * const _ = db.command;
@@ -1655,7 +1678,7 @@ declare namespace cloudbase.database {
     /**
      * 字段值不在给定的数组中
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#nin}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#nin}
      *
      * @example
      * const _ = db.command;
@@ -1670,7 +1693,7 @@ declare namespace cloudbase.database {
     /**
      * 表示需同时满足指定的两个或以上的条件
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#and}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#and}
      *
      * @example
      * const _ = db.command;
@@ -1685,7 +1708,7 @@ declare namespace cloudbase.database {
     /**
      * 表示需满足所有指定条件中的至少一个
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#or}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#or}
      *
      * @example
      * const _ = db.command;
@@ -1700,7 +1723,7 @@ declare namespace cloudbase.database {
     /**
      * 用于设定字段等于指定值
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#set}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#set}
      *
      * @example
      * const _ = db.command;
@@ -1721,7 +1744,7 @@ declare namespace cloudbase.database {
     /**
      * 用于指示字段自增某个值
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#inc}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#inc}
      *
      * @example
      * const _ = db.command;
@@ -1740,7 +1763,7 @@ declare namespace cloudbase.database {
     /**
      * 用于指示字段自乘某个值
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#mul}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#mul}
      *
      * @example
      * const _ = db.command;
@@ -1759,7 +1782,7 @@ declare namespace cloudbase.database {
     /**
      * 用于表示删除某个字段
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#remove}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#remove}
      *
      * @example
      * const _ = db.command;
@@ -1774,7 +1797,7 @@ declare namespace cloudbase.database {
     /**
      * 向数组尾部追加元素
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#push}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#push}
      *
      * @example
      * const _ = db.command;
@@ -1790,7 +1813,7 @@ declare namespace cloudbase.database {
     /**
      * 删除数组尾部元素
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#pop}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#pop}
      *
      * @example
      * const _ = db.command;
@@ -1805,7 +1828,7 @@ declare namespace cloudbase.database {
     /**
      * 向数组头部添加元素
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#unshift}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#unshift}
      *
      * @example
      * const _ = db.command;
@@ -1821,7 +1844,7 @@ declare namespace cloudbase.database {
     /**
      * 删除数组头部元素
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#shift}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#shift}
      *
      * @example
      * const _ = db.command;
@@ -1833,10 +1856,148 @@ declare namespace cloudbase.database {
      *
      */
     shift(): any
+    /**
+     * 条件取反
+     *
+     * @example
+     * const _ = db.command;
+     * db.collection('users').where({
+     *   status: _.not(_.eq('deleted'))
+     * })
+     *
+     * @param condition 查询条件
+     */
+    not(condition: any): any
+    /**
+     * 都不满足指定的条件
+     *
+     * @example
+     * const _ = db.command;
+     * db.collection('users').where(
+     *   _.nor([{ status: 'banned' }, { status: 'deleted' }])
+     * )
+     *
+     * @param conditions 条件数组
+     */
+    nor(conditions: any[]): any
+    /**
+     * 判断字段是否存在
+     *
+     * @example
+     * const _ = db.command;
+     * db.collection('users').where({
+     *   avatar: _.exists(true)
+     * })
+     *
+     * @param val true 表示字段存在，false 表示不存在
+     */
+    exists(val: boolean): any
+    /**
+     * 取模运算
+     *
+     * @example
+     * const _ = db.command;
+     * db.collection('users').where({
+     *   age: _.mod([2, 0])
+     * })
+     *
+     * @param val [除数, 余数]
+     */
+    mod(val: [number, number]): any
+    /**
+     * 数组包含所有指定元素
+     *
+     * @example
+     * const _ = db.command;
+     * db.collection('articles').where({
+     *   tags: _.all(['javascript', 'nodejs'])
+     * })
+     *
+     * @param list 必须包含的元素数组
+     */
+    all(list: any[]): any
+    /**
+     * 数组元素匹配
+     *
+     * @example
+     * const _ = db.command;
+     * db.collection('orders').where({
+     *   items: _.elemMatch({ price: _.gt(100) })
+     * })
+     *
+     * @param condition 匹配条件对象
+     */
+    elemMatch(condition: Object): any
+    /**
+     * 数组长度匹配
+     *
+     * @example
+     * const _ = db.command;
+     * db.collection('articles').where({
+     *   tags: _.size(3)
+     * })
+     *
+     * @param size 数组长度
+     */
+    size(size: number): any
+    /**
+     * 取最小值更新
+     *
+     * @param val 比较值
+     */
+    min(val: number): any
+    /**
+     * 取最大值更新
+     *
+     * @param val 比较值
+     */
+    max(val: number): any
+    /**
+     * 重命名字段
+     *
+     * @param newFieldName 新字段名
+     */
+    rename(newFieldName: string): any
+    /**
+     * 位运算
+     *
+     * @param options 位运算选项，如 { and: 5 }
+     */
+    bit(options: Object): any
+    /**
+     * 删除数组中匹配的元素
+     *
+     * @example
+     * const _ = db.command;
+     * db.collection('articles').doc('id').update({
+     *   tags: _.pull('要删除的标签')
+     * })
+     *
+     * @param val 要删除的元素或匹配条件
+     */
+    pull(val: any): any
+    /**
+     * 删除数组中所有匹配的元素
+     *
+     * @param list 要删除的元素数组
+     */
+    pullAll(list: any[]): any
+    /**
+     * 向数组添加不重复的元素
+     *
+     * @example
+     * const _ = db.command;
+     * db.collection('articles').doc('id').update({
+     *   tags: _.addToSet('唯一标签')
+     * })
+     *
+     * @param val 要添加的元素
+     */
+    addToSet(val: any): any
     /**
      * 按从近到远的顺序，找出字段值在给定点的附近的文档
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#geonear}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#geonear}
      *
      * @example
      * const _ = db.command;
@@ -1857,7 +2018,7 @@ declare namespace cloudbase.database {
     /**
      * 找出字段值在指定 Polygon / MultiPolygon 内的文档，无排序
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#geowithin}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#geowithin}
      *
      * @example
      * const _ = db.command;
@@ -1876,7 +2037,7 @@ declare namespace cloudbase.database {
     /**
      * 找出字段值和给定的地理位置图形相交的文档
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#geointersects}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#geointersects}
      *
      * @example
      * const _ = db.command;
@@ -1896,9 +2057,9 @@ declare namespace cloudbase.database {
    */
   interface IDocument extends IWatchable {
     /**
-     * 更新文档，如果要更新的文档不存在时新增一个文档
+     * 设置文档数据，如果文档不存在则创建新文档
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database.html#update-set}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database.html#update-set}
      *
      * @example
      * collection
@@ -1906,55 +2067,65 @@ declare namespace cloudbase.database {
      *   .set({name:'cloudbase'})
      *   .then(res=>{})
      *
-     * @param data 文档数据
+     * @param data 要设置的数据对象，将完全替换原有文档内容
      *
-     * @return Promise
+     * @return Promise<SetRes> 包含 updated 或 upsertedId
      */
     set(data: Object): Promise<SetRes>
     /**
-     * 获取查询结果
+     * 获取文档数据
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#get}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#get}
      *
      * @example
      * collection
      *   .doc('docId')
      *   .get()
-     *   .then(res=>{})
+     *   .then(res=>{ console.log(res.data) })
      *
-     * @return Promise-查询结果
+     * @return Promise<GetRes> 包含 data 数组和 requestId
      */
     get(): Promise<GetRes>
     /**
-     * 更新文档，如果要更新的文档不存在什么也不会做
+     * 更新文档数据，如果文档不存在则不做任何操作
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#update--set}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#update--set}
      *
      * @example
      * collection
      *   .doc('docId')
-     *   .update({name:'cloudbase'})
-     *   .then(res=>{})
+     *   .update({completed: true})
+     *   .then(res=>{ console.log(res.updated) })
      *
-     * @param data 文档数据
+     * @param data 要更新的数据对象，支持操作符
      *
-     * @return Promise
+     * @return Promise<UpdateRes> 包含 updated 字段
      */
-    update(data: Object): Promise<SetRes>
+    update(data: Object): Promise<UpdateRes>
     /**
      * 删除一条文档
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database.html#remove-2}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database.html#remove-2}
      *
      * @example
      * collection
      *   .doc('docId')
      *   .remove()
-     *   .then(res=>{})
+     *   .then(res=>{ console.log(res.deleted) })
      *
-     * @return Promise
+     * @return Promise<RemoveRes> 包含 deleted 字段
      */
-    remove(): Promise<any>
+    remove(): Promise<RemoveRes>
+    /**
+     * 指定要返回的字段
+     *
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#field}
+     *
+     * @param projection 字段投影对象，true 表示返回，false 表示不返回
+     *
+     * @return 文档引用，可继续链式调用 get()
+     */
+    field(projection: Object): IDocument
   }
   /**
    * query types
@@ -1963,7 +2134,7 @@ declare namespace cloudbase.database {
     code?: string
     message?: string
     updated?: number
-    upsertedId?: number
+    upsertedId?: string
     requestId: string
   }
   interface GetRes {
@@ -1976,11 +2147,181 @@ declare namespace cloudbase.database {
   interface UpdateRes {
     requestId: string
     updated?: number
-    upsertId?: string
+    upsertedId?: string
     code?: string
     message?: string
   }
 
+  interface AddRes {
+    id: string
+    requestId: string
+    code?: string
+    message?: string
+  }
+
+  interface CountRes {
+    total: number
+    requestId: string
+    code?: string
+    message?: string
+  }
+
+  interface RemoveRes {
+    deleted: number
+    requestId: string
+    code?: string
+    message?: string
+  }
+
+  interface CreateCollectionRes {
+    data: string
+    requestId: string
+    code?: string
+    message?: string
+  }
+
+  interface IRunCommandsReq {
+    /** 命令对象数组 */
+    commands: Object[]
+    /** 事务 ID（可选） */
+    transactionId?: string
+  }
+
+  interface IRunCommandsResult {
+    requestId: string
+    /** 命令执行结果数组 */
+    list: Object[][]
+    code?: string
+    message?: string
+  }
+
+  /**
+   * 数据库配置
+   */
+  interface IDbConfig {
+    /** 实例 ID（可选），不填则使用默认实例 */
+    instance?: string
+    /** 数据库名称（可选），不填则使用默认数据库 */
+    database?: string
+  }
+
+  /**
+   * 聚合操作对象
+   */
+  interface IAggregate {
+    /**
+     * 添加新字段
+     */
+    addFields(fieldObj: Object): IAggregate
+    /**
+     * 分桶
+     */
+    bucket(bucketObj: Object): IAggregate
+    /**
+     * 自动分桶
+     */
+    bucketAuto(bucketObj: Object): IAggregate
+    /**
+     * 计数
+     */
+    count(fieldName: string): IAggregate
+    /**
+     * 地理位置附近查询
+     */
+    geoNear(options: Object): IAggregate
+    /**
+     * 分组统计
+     *
+     * @example
+     * db.collection('todos').aggregate()
+     *   .group({ _id: '$priority', count: { $sum: 1 } })
+     *   .end()
+     */
+    group(groupObj: Object): IAggregate
+    /**
+     * 限制结果数量
+     */
+    limit(limit: number): IAggregate
+    /**
+     * 联表查询
+     */
+    lookup(lookupObj: Object): IAggregate
+    /**
+     * 条件筛选
+     */
+    match(matchObj: Object): IAggregate
+    /**
+     * 字段投影
+     */
+    project(projectObj: Object): IAggregate
+    /**
+     * 替换根文档
+     */
+    replaceRoot(replaceObj: Object): IAggregate
+    /**
+     * 随机采样
+     */
+    sample(sampleObj: Object): IAggregate
+    /**
+     * 跳过数量
+     */
+    skip(skip: number): IAggregate
+    /**
+     * 排序
+     */
+    sort(sortObj: Object): IAggregate
+    /**
+     * 按数量排序
+     */
+    sortByCount(fieldName: string): IAggregate
+    /**
+     * 展开数组
+     */
+    unwind(fieldPath: string | Object): IAggregate
+    /**
+     * 结束聚合管道，返回结果
+     */
+    end(): Promise<GetRes>
+  }
+
+  /**
+   * 事务对象
+   */
+  interface ITransaction {
+    /**
+     * 获取事务内的集合引用
+     */
+    collection(name: string): ITransactionCollection
+    /**
+     * 提交事务
+     */
+    commit(): Promise<void>
+    /**
+     * 回滚事务
+     *
+     * @param reason 回滚原因
+     */
+    rollback(reason?: any): Promise<void>
+  }
+
+  /**
+   * 事务内的集合引用
+   */
+  interface ITransactionCollection {
+    doc(id: string): ITransactionDocument
+  }
+
+  /**
+   * 事务内的文档引用
+   */
+  interface ITransactionDocument {
+    get(): Promise<GetRes>
+    create(data: Object): Promise<any>
+    set(data: Object): Promise<SetRes>
+    update(data: Object): Promise<UpdateRes>
+    remove(): Promise<RemoveRes>
+  }
+
   interface QueryOrder {
     field?: string
     direction?: 'asc' | 'desc'
@@ -1998,7 +2339,7 @@ declare namespace cloudbase.database {
     /**
      * 获取数据库查询结果
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database.html#get}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database.html#get}
      *
      * @example
      * collection
@@ -2014,7 +2355,7 @@ declare namespace cloudbase.database {
     /**
      * 更新数据库文档
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database.html#update-set}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database.html#update-set}
      *
      * @example
      * collection
@@ -2032,7 +2373,7 @@ declare namespace cloudbase.database {
     /**
      * 获取数据库查询结果的数目
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#count}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#count}
      *
      * @example
      * collection
@@ -2042,13 +2383,13 @@ declare namespace cloudbase.database {
      *   .count()
      *   .then(res=>{})
      *
-     * @return Promise-查询结果
+     * @return Promise<CountRes> 包含 total 字段
      */
-    count(): Promise<any>
+    count(): Promise<CountRes>
     /**
      * 设置过滤条件
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#where}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#where}
      *
      * @example
      * collection
@@ -2063,7 +2404,7 @@ declare namespace cloudbase.database {
     /**
      * 指定查询结果集数量上限
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#limit}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#limit}
      *
      * @example
      * collection
@@ -2078,7 +2419,7 @@ declare namespace cloudbase.database {
     /**
      * 指定查询返回结果时从指定序列后的结果开始返回，常用于分页
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#skip}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#skip}
      *
      * @example
      * collection
@@ -2093,7 +2434,7 @@ declare namespace cloudbase.database {
     /**
      * 指定查询排序条件
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#orderby}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#orderby}
      *
      * @example
      * collection
@@ -2109,7 +2450,7 @@ declare namespace cloudbase.database {
     /**
      * 指定返回结果中文档需返回的字段
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#field}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#field}
      *
      * @example
      * collection
@@ -2124,7 +2465,7 @@ declare namespace cloudbase.database {
     /**
      * 删除查询到的结果
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#remove-1}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#remove-1}
      *
      * @example
      * collection
@@ -2133,9 +2474,9 @@ declare namespace cloudbase.database {
      *   })
      *   .remove()
      *
-     * @return Promise
+     * @return Promise<RemoveRes> 包含 deleted 字段
      */
-    remove(): Promise<any>
+    remove(): Promise<RemoveRes>
   }
   /**
    * geo types
@@ -2150,7 +2491,7 @@ declare namespace cloudbase.database {
     /**
      * 用于表示地理位置点
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#point}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#point}
      *
      * @example
      * const point = new db.Geo.Point(lng,lat);
@@ -2166,7 +2507,7 @@ declare namespace cloudbase.database {
     /**
      * 用于表示地理路径，是由两个或者更多的 Point 组成的线段
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#linestring}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#linestring}
      *
      * @example
      * const point = new db.Geo.LineString([pointA,pointB]);
@@ -2181,7 +2522,7 @@ declare namespace cloudbase.database {
     /**
      * 用于表示地理上的一个多边形
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#polygon}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#polygon}
      *
      * @example
      * const point = new db.Geo.Polygon([lineStringA,lineStringB]);
@@ -2196,7 +2537,7 @@ declare namespace cloudbase.database {
     /**
      * 用于表示多个点 Point 的集合
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#multipoint}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#multipoint}
      *
      * @example
      * const point = new db.Geo.MultiPoint([pointA,pointB]);
@@ -2211,7 +2552,7 @@ declare namespace cloudbase.database {
     /**
      * 用于表示多个地理路径 LineString 的集合
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#multilinestring}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#multilinestring}
      *
      * @example
      * const point = new db.Geo.MultiLineString([lineA,lineB]);
@@ -2226,7 +2567,7 @@ declare namespace cloudbase.database {
     /**
      * 用于表示多个地理多边形 Polygon 的集合
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#multipolygon}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#multipolygon}
      *
      * @example
      * const point = new db.Geo.MultiPolygon([polygonA,polygonB]);
@@ -2256,19 +2597,19 @@ declare namespace cloudbase.database {
     /**
      * 数据库指令
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database#%E6%9F%A5%E8%AF%A2%E6%8C%87%E4%BB%A4}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#%E6%9F%A5%E8%AF%A2%E6%8C%87%E4%BB%A4}
      */
     command: ICommand
     /**
      * 数据库Geo地理位置
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database.html#geo-shu-ju-lei-xing}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database.html#geo-shu-ju-lei-xing}
      */
     Geo: IGeo
     /**
      * 根据正则表达式进行筛选
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database.html#regexp}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database.html#regexp}
      *
      * @example
      * db.collection('articles').where({
@@ -2286,7 +2627,7 @@ declare namespace cloudbase.database {
     /**
      * 创建集合的引用
      *
-     * {@link https://docs.cloudbase.net/api-reference/webv3/database.html#collection}
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database.html#collection}
      *
      * @example
      * const coll = db.collection('demo');
@@ -2296,6 +2637,82 @@ declare namespace cloudbase.database {
      * @return 集合的引用
      */
     collection(name: string): ICollection
+    /**
+     * 创建集合
+     *
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#createcollection}
+     *
+     * @example
+     * const result = await db.createCollection('new-collection')
+     *
+     * @param collName 集合名称
+     *
+     * @return Promise<CreateCollectionRes>
+     */
+    createCollection(collName: string): Promise<CreateCollectionRes>
+    /**
+     * 构造服务端时间对象
+     *
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#serverdate}
+     *
+     * @example
+     * db.collection('todos').add({
+     *   createdAt: db.serverDate()
+     * })
+     *
+     * @param options 可选配置，支持 offset（毫秒偏移量）
+     *
+     * @return 服务端时间对象
+     */
+    serverDate(options?: { offset?: number }): any
+    /**
+     * 开启一个新事务
+     *
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#starttransaction}
+     *
+     * @example
+     * const transaction = await db.startTransaction()
+     * // ... 事务操作
+     * await transaction.commit()
+     *
+     * @return Promise<ITransaction> 事务对象
+     */
+    startTransaction(): Promise<ITransaction>
+    /**
+     * 执行事务操作，自动处理提交和回滚
+     *
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#runtransaction}
+     *
+     * @example
+     * const result = await db.runTransaction(async (transaction) => {
+     *   const doc = await transaction.collection('accounts').doc('id').get()
+     *   await transaction.collection('accounts').doc('id').update({ balance: doc.data.balance - 100 })
+     *   return { success: true }
+     * })
+     *
+     * @param callback 事务回调函数
+     * @param times 事务冲突时的重试次数，默认为 3
+     *
+     * @return Promise<any> 事务回调函数的返回值
+     */
+    runTransaction(callback: (transaction: ITransaction) => Promise<any>, times?: number): Promise<any>
+    /**
+     * 执行 MongoDB 原生命令
+     *
+     * {@link https://docs.cloudbase.net/api-reference/webv3-next/database#runcommands}
+     *
+     * @example
+     * const result = await db.runCommands({
+     *   commands: [
+     *     { find: 'users', filter: { age: { $gte: 18 } }, limit: 10 }
+     *   ]
+     * })
+     *
+     * @param params 命令参数，包含 commands 数组和可选的 transactionId
+     *
+     * @return Promise<IRunCommandsResult>
+     */
+    runCommands(params: IRunCommandsReq): Promise<IRunCommandsResult>
   }
 }