@byted-apaas/server-sdk-node 1.0.14 → 1.0.16-beta.16

package/README.md

@@ -1,7 +1,45 @@
 ## aPaaS @byted-apaas/server-sdk-node 版本说明：
 
+### 版本：1.0.18｜兼容升级
+优化：包结构调整，参考文档：
+
+-------
+### 版本：1.0.18｜兼容升级
+新功能：支持开发者获取飞书集成 app access token 及 tenant access token
+
+-------
+### 版本：1.0.17｜兼容升级
+优化：废弃 flow.variables & flow.updateVariable 相关 API
+
+-------
+### 版本：1.0.16|兼容升级
+新功能：支持模糊查询 fuzzySearch
+```js
+await context.db.object("obj").fuzzySearch("keyword", ["field1", "field2"]).find();
+```
+
 -------
-### 版本：1.0.13｜兼容升级
+### 版本：1.0.15｜兼容升级
+新功能：数据操作接口支持指定鉴权身份
+- 不指定: 访问数据模型时, 权限 1.0 应用默认使用系统身份鉴权, 权限 2.0 应用默认使用用户身份鉴权
+- useUserAuth(): 访问数据模型时, 使用用户身份鉴权
+- useSystemAuth(): 访问数据模型时, 使用系统身份鉴权
+```js
+// 示例
+await context.db.object("obj").findOne();
+await context.db.object("obj").useUserAuth().findOne();
+await context.db.object("obj").useSystemAuth().findOne();
+
+await context.db.newTransaction().object("obj").commit();
+await context.db.newTransaction().useUserAuth().object("obj").commit();
+await context.db.newTransaction().useSystemAuth().object("obj").commit();
+
+await context.db.oql("SELECT _id FROM obj").execute();
+await context.db.oql("SELECT _id FROM obj").useUserAuth().execute();
+await context.db.oql("SELECT _id FROM obj").useSystemAuth().execute();
+```
+
+### 版本：1.0.14｜兼容升级
 新功能：支持流式查询 findStream
 ```js
 await context.db.object("_user").findStream(async (records) => {

package/application/application.d.ts

@@ -1,9 +1,10 @@
-import { _IOpenSDKResources } from "../context/resources/IResources";
-import { ITool, IToolsExtra } from "@byted-apaas/server-common-node/kunlun/tool/Itool";
-import { AppCredential } from "@byted-apaas/server-common-node/credential/credential";
-import { IDBSync } from "../context/db/db";
-import { IFunction } from "./function/function";
-import { PlatformEnvType } from "@byted-apaas/server-common-node/constants/constants";
+import { _IOpenSDKResources } from '../context/resources/IResources';
+import { ITool, IToolsExtra } from '@byted-apaas/server-common-node/kunlun/tool/Itool';
+import { AppCredential } from '@byted-apaas/server-common-node/credential/credential';
+import { IDBSync } from '../context/db/db';
+import { IFunction } from './function/function';
+import { PlatformEnvType } from '@byted-apaas/server-common-node/constants/constants';
+import { _IIntegration } from '../context/integration/IIntegration';
 /**
  * IApplication 为 OpenSDK 能力的核心接口
  *   - data:     元数据相关能力
@@ -14,16 +15,17 @@ export interface IApplication {
     data: IDBSync;
     resources: _IOpenSDKResources;
     tools: ITool & IToolsExtra;
+    integration: _IIntegration;
     cloudfunction(funcName: string): IFunction;
     env(platformEnvType: PlatformEnvType): IApplication;
     localDebugMode(): IApplication;
     setLaneName(laneName: string): IApplication;
 }
-export type AppMode = 'openSDK' | 'faasSDK';
+export declare type AppMode = 'openSDK' | 'faasSDK';
 export interface AppCtx {
     mode: AppMode;
     env?: PlatformEnvType;
     credential: AppCredential;
-    debugType?: "0" | "2";
+    debugType?: '0' | '2';
     x_tt_env?: string;
 }

package/application/impl/impl.d.ts

@@ -1,14 +1,16 @@
-import { ITool, IToolsExtra } from "@byted-apaas/server-common-node/kunlun/tool/Itool";
-import { IFunction } from "../function/function";
-import { IApplication } from "../application";
-import { _IOpenSDKResources } from "../../context/resources/IResources";
-import { IDBSync } from "../../context/db/db";
-import { PlatformEnvType } from "@byted-apaas/server-common-node/constants/constants";
+import { ITool, IToolsExtra } from '@byted-apaas/server-common-node/kunlun/tool/Itool';
+import { IFunction } from '../function/function';
+import { IApplication } from '../application';
+import { _IOpenSDKResources } from '../../context/resources/IResources';
+import { IDBSync } from '../../context/db/db';
+import { PlatformEnvType } from '@byted-apaas/server-common-node/constants/constants';
+import { _IIntegration } from '../../context/integration/IIntegration';
 export declare class Application implements IApplication {
     private appCtx;
     data: IDBSync;
     resources: _IOpenSDKResources;
     tools: ITool & IToolsExtra;
+    integration: _IIntegration;
     constructor(clientID: string, clientSecret: string);
     cloudfunction(funcName: string): IFunction;
     env(platformEnvType: PlatformEnvType): IApplication;

package/application/impl/impl.js

@@ -8,16 +8,18 @@ const function_1 = require("../function/function");
 const common_1 = require("../../request/common");
 const resources_1 = require("../../context/resources/impl/resources");
 const constants_1 = require("@byted-apaas/server-common-node/constants/constants");
+const integration_1 = require("../../context/integration/impl/integration");
 class Application {
     constructor(clientID, clientSecret) {
         this.appCtx = {
-            mode: "openSDK",
+            mode: 'openSDK',
             credential: new credential_1.AppCredential(clientID, clientSecret),
-            debugType: constants_1.DefaultDebugType ? constants_1.DefaultDebugType : "2",
-            env: "online"
+            debugType: constants_1.DefaultDebugType ? constants_1.DefaultDebugType : '2',
+            env: 'online',
         };
         this.data = new db_1.ApplicationDB(this.appCtx);
         this.resources = new resources_1._OpenSDKResources(this.appCtx);
+        this.integration = new integration_1._OpenSDKIntegration(this.appCtx);
         this.tools = new tool_1.Tool();
         this.tools.getTenantInfo = async () => {
             return await (0, common_1.getTenantInfo)(this.appCtx);
@@ -32,7 +34,7 @@ class Application {
     }
     // 设置本地调试模式
     localDebugMode() {
-        this.appCtx.debugType = "2";
+        this.appCtx.debugType = '2';
         return this;
     }
     setLaneName(laneName) {

package/constants/constants.js

@@ -4,15 +4,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.triggerType = exports.httpStatusCodes = exports.httpHeaderKeys = exports.notifyModel = void 0;
 exports.notifyModel = {
-    key: "ee.kunlun.cloudfunction.faas_buildin",
+    key: 'ee.kunlun.cloudfunction.faas_buildin',
 };
 exports.httpHeaderKeys = {
-    statusCode: "X-Kunlun-Status-Code",
-    location: "Location",
+    statusCode: 'X-Kunlun-Status-Code',
+    location: 'Location',
 };
 exports.httpStatusCodes = {
     redirect: 302,
 };
 exports.triggerType = {
-    defaultTrigger: "default-trigger"
+    defaultTrigger: 'default-trigger',
 };

package/constants/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG;IACvB,GAAG,EAAE,sCAAsC;CAC9C,CAAA;AAEY,QAAA,cAAc,GAAG;IAC1B,UAAU,EAAE,sBAAsB;IAClC,QAAQ,EAAE,UAAU;CACvB,CAAA;AAEY,QAAA,eAAe,GAAG;IAC3B,QAAQ,EAAE,GAAG;CAChB,CAAA"}

package/context/context.d.ts

@@ -1,74 +1,5 @@
-import { _Resources } from "./resources/impl/resources";
-import { Tasks } from "./tasks/tasks";
-import { Message } from "./msg/msg";
-import { IDBGetter } from "./db/db";
 import { Context as CommonContext } from '@byted-apaas/server-common-node';
-import { IMetaData } from "./metadata/metadata";
-export declare class Context<T, mt, cf, gv> extends CommonContext implements IContext<T, mt, cf, gv> {
-    /**
-     * 操作数据库中的记录数据
-     */
-    db: IDBGetter<T, mt>;
-    /**
-     * 元数据读写
-     */
-    metadata: IMetaData<mt>;
-    /**
-     * 静态资源类操作
-     */
-    resources: _Resources;
-    /**
-     * 全局函数
-     * @param funcName 函数名
-     */
-    function(funcName: cf): {
-        invoke: (params: any) => Promise<any>;
-    };
-    /**
-     * 任务操作
-     */
-    tasks: Tasks<cf>;
-    /**
-     * 向消息中心推送及更新消息
-     */
-    msg: Message;
-    /**
-     * 根据 apiName 获取对应的全局变量
-     * @param apiName 全局变量的 API Name
-     */
-    getVar<Key extends keyof gv>(apiName: Key): Promise<gv[Key]>;
+export declare class Context extends CommonContext implements IContext {
 }
-export interface IContext<T, mt = {}, cf = "", gv = {}> {
-    /**
-     * 操作数据库中的记录数据
-     */
-    db: IDBGetter<T, mt>;
-    /**
-     * 元数据读写
-     */
-    metadata: IMetaData<mt>;
-    /**
-     * 静态资源类操作
-     */
-    resources: _Resources;
-    /**
-     * 全局函数
-     * @param funcName 函数名
-     */
-    function(funcName: cf): {
-        invoke: (params: any) => Promise<any>;
-    };
-    /**
-     * 任务操作
-     */
-    tasks: Tasks<cf>;
-    /**
-     * 向消息中心推送及更新消息
-     */
-    msg: Message;
-    /**
-     * 根据 apiName 获取对应的全局变量
-     * @param apiName 全局变量的 API Name
-     */
-    getVar<Key extends keyof gv>(apiName: Key): Promise<gv[Key]>;
+export interface IContext {
 }

package/context/context.js

@@ -4,22 +4,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Context = void 0;
 const server_common_node_1 = require("@byted-apaas/server-common-node");
-// TODO MERGE cf
 class Context extends server_common_node_1.Context {
-    /**
-     * 全局函数
-     * @param funcName 函数名
-     */
-    function(funcName) {
-        return null;
-    }
-    /**
-     * 根据 apiName 获取对应的全局变量
-     * @param apiName 全局变量的 API Name
-     */
-    async getVar(apiName) {
-        return null;
-    }
-    ;
 }
 exports.Context = Context;

package/context/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["context.ts"],"names":[],"mappings":";;;AAIA,8DAAqE;AAGrE,gBAAgB;AAEhB,MAAa,OAAmB,SAAQ,uBAAgB;IAcpD;;;OAGG;IACH,QAAQ,CAAC,QAAyB;QAC9B,OAAO,IAAI,CAAC;IAChB,CAAC;CAiCJ;AArDD,0BAqDC"}

package/context/db/db.d.ts

@@ -1,14 +1,10 @@
-import { currentObjApiName } from '../../data';
 import { _IKAllEndpoint, _IKSyncEndpoint, _IKQuery } from './impl/IObject';
 import { ITransactionGetter } from './impl/transaction';
 import { IOql } from './impl/oql/ioql';
 /**
- * - IDBGetter 是声明 DB interface 的顶级入口，在使用时应该避免直接使用 IDB 和 IDBWithCurrentObject
- * 应该直接使用 IDBGetter。
- * - 目前 IDBGetter 支持的是 currentObject 方法的动态声明，使用泛型实现，期望传入的 T 是 Context 结构。
- * - 如果 Context 有 objectApiName 属性，则拥有 .db.currentObject 和 .db.transaction.currentObject
+ * IDBGetter 是声明 DB interface 的顶级入口
  */
-export type IDBGetter<T, mt> = T extends {
+export declare type IDBGetter<T, mt> = T extends {
     'objectApiName': string;
 } ? IDB<T, mt> & IDBWithCurrentObject<{}, mt> : IDB<{}, mt>;
 /**
@@ -20,8 +16,8 @@ export interface IDB<T, mt> {
      * @param objectApiName 指定对象的 ApiName
      * @example
      * ```
-     * context.db.object("_user").where({
-     *     gender: "male"
+     * application.data.object('_user').where({
+     *     gender: 'male'
      * }).find()
      * ```
      */
@@ -30,12 +26,12 @@ export interface IDB<T, mt> {
      * 创建一个新的空事务
      * @example
      * ```
-     * let tx = context.db.newTransaction();
-     * let user = tx.object("_user").registerCreate({
-     *     _name: new kunlun.type.Multilingual({ zh: "用户1", en: "user1" }),
+     * let tx = application.data.newTransaction();
+     * let user = tx.object('_user').registerCreate({
+     *     _name: new application.constants.type.Multilingual({ zh: '用户1', en: 'user1' }),
      * });
-     * let contract = tx.object("contract").registerCreate({
-     *     _name: new kunlun.type.Multilingual({ zh: "用户1的合同", en: "user1's contract" }),
+     * let contract = tx.object('contract').registerCreate({
+     *     _name: new application.constants.type.Multilingual({ zh: '用户1的合同', en: 'user1's contract' }),
      *     user: {id: user._id}
      * });
      * await tx.commit();
@@ -47,7 +43,7 @@ export interface IDB<T, mt> {
      * @param oql OQL 语句
      * @example
      * ```
-     * let users = await context.db.oql("select _email from _user").execute();
+     * let users = await application.data.oql('select _email from _user').execute();
      * ```
      */
     oql(oql: string): IOql;
@@ -57,8 +53,8 @@ export interface IDB<T, mt> {
      * @param nameArgs 用于替换 OQL 语句中的占位符
      * @example
      * ```
-     * let employees = await context.db.oql("select _email from _user where _type = $user_type",{
-     *     "user_type": "_employee",
+     * let employees = await application.data.oql('select _email from _user where _type = $user_type',{
+     *     'user_type': '_employee',
      * }).execute();
      * ```
      */
@@ -68,10 +64,6 @@ export interface IDB<T, mt> {
  * IDBWithCurrentObject 经由 IDBGetter 返回，是 DB 的动态增加的接口结构
  */
 export interface IDBWithCurrentObject<T, mt> {
-    /**
-     * 无需入参，操作当前对象的记录数据
-     */
-    currentObject(): _IKAllEndpoint<mt[currentObjApiName]> & _IKQuery<mt[currentObjApiName]>;
 }
 /**
  * IDBSync 仅包含同步调用接口，当前应用场景为 OpenSDK

package/context/db/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["db.ts"],"names":[],"mappings":""}

package/context/db/impl/IObject.d.ts

@@ -5,13 +5,13 @@ export interface _IKSyncEndpoint<T> {
     /**
      * 创建记录
      * @param recordMap 用于创建的一条记录
-     * @paramExample {_name: "John", age: 19, gender: "male"}
+     * @paramExample {_name: 'John', age: 19, gender: 'male'}
      * @example
      * ```
-     * context.db.object("_department").create({
-     *     _name: new kunlun.type.Multilingual({ zh: "部门" }),
+     * application.data.object('_department').create({
+     *     _name: new application.constants.type.Multilingual({ zh: '部门' }),
      *     _manager: { _id: 1660000000 },
-     *     _status: "_active"
+     *     _status: '_active'
      * })
      * ```
      */
@@ -23,7 +23,7 @@ export interface _IKSyncEndpoint<T> {
      * @param recordID 用于删除的一条记录的 ID
      * @example
      * ```
-     * context.db.object("_user").delete(123456789123)
+     * application.data.object('_user').delete(123456789123)
      * ```
      */
     delete(recordID: number): Promise<void>;
@@ -32,7 +32,7 @@ export interface _IKSyncEndpoint<T> {
      * @param record 用于删除的一条完整记录
      * @example
      * ```
-     * context.db.object("_user").delete(context.targetRecord.original)
+     * application.data.object('_user').delete(context.targetRecord.original)
      * ```
      */
     delete(record: _Cond<T>): Promise<void>;
@@ -40,11 +40,11 @@ export interface _IKSyncEndpoint<T> {
      * 指定 _id 后，更新对应记录
      * @param _id 主键
      * @param recordMap 用于更新的一条记录
-     * @paramExample {_name: "John", age: 19, gender: "male"}
+     * @paramExample {_name: 'John', age: 19, gender: 'male'}
      * @example
      * ```
-     * context.db.object("_user").update(1660000000, {
-     *     gender: "male"
+     * application.data.object('_user').update(1660000000, {
+     *     gender: 'male'
      * })
      * ```
      */
@@ -52,12 +52,12 @@ export interface _IKSyncEndpoint<T> {
     /**
      * 指定 _id 后，更新对应记录
      * @param recordMap 用于更新的一条记录，需对 _id 赋值
-     * @paramExample {_id: 1660000000, _name: "John", age: 19, gender: "male"}
+     * @paramExample {_id: 1660000000, _name: 'John', age: 19, gender: 'male'}
      * @example
      * ```
-     * context.db.object("_user").update({
+     * application.data.object('_user').update({
      *     _id: 1660000000,
-     *     gender: "male"
+     *     gender: 'male'
      * })
      * ```
      */
@@ -65,7 +65,7 @@ export interface _IKSyncEndpoint<T> {
     /**
      * 批量创建记录
      * @param recordMapList 多条用于创建的记录数据组成的数组
-     * @paramExample [{_name: "John", age: 19, gender: "male"}, {_name: "Alis", age: 16, gender: "female"}]
+     * @paramExample [{_name: 'John', age: 19, gender: 'male'}, {_name: 'Alis', age: 16, gender: 'female'}]
      */
     batchCreate(recordMapList: _Cond<T>[]): Promise<number[]>;
     /**
@@ -77,21 +77,29 @@ export interface _IKSyncEndpoint<T> {
     /**
      * 批量删除记录
      * @param recordList 多条用于删除的记录数据组成的数组，记录数据需对 _id 赋值
-     * @paramExample [{_id: 1001, _name: "John", gender: "male"}, {_id: 1002, _name: "Alis", gender: "female"}]
+     * @paramExample [{_id: 1001, _name: 'John', gender: 'male'}, {_id: 1002, _name: 'Alis', gender: 'female'}]
      */
     batchDelete(recordList: _Cond<T>[]): Promise<void>;
     /**
      * 根据 _id 批量更新记录
      * @param recordMapList 多条用于更新的记录数据组成的数组，记录数据需对 _id 赋值
-     * @paramExample [{_id: 1001, _name: "John", gender: "male"}, {_id: 1002, _name: "Alis", gender: "female"}]
+     * @paramExample [{_id: 1001, _name: 'John', gender: 'male'}, {_id: 1002, _name: 'Alis', gender: 'female'}]
      */
     batchUpdate(recordMapList: _Cond<T>[]): Promise<void>;
+    /**
+     * 用户级鉴权
+     */
+    useUserAuth(): this;
+    /**
+     * 系统级鉴权
+     */
+    useSystemAuth(): this;
 }
 export interface _IKAsyncEndpoint<T> {
     /**
      * 批量创建记录（为异步任务）
      * @param recordMapList 用于创建的多条记录
-     * @paramExample [{_name: "John", age: 19, gender: "male"}, {_name: "Alis", age: 16, gender: "female"}]
+     * @paramExample [{_name: 'John', age: 19, gender: 'male'}, {_name: 'Alis', age: 16, gender: 'female'}]
      */
     batchCreateAsync(recordMapList: _Cond<T>[]): Promise<{
         taskID: number;
@@ -113,11 +121,19 @@ export interface _IKAsyncEndpoint<T> {
     /**
      * 根据 _id 批量更新记录（为异步任务）
      * @param recordMapList 用于更新的多条记录，需对 _id 赋值
-     * @paramExample [{_id: 1001, _name: "John", gender: "male"}, {_id: 1002, _name: "Alis", gender: "female"}]
+     * @paramExample [{_id: 1001, _name: 'John', gender: 'male'}, {_id: 1002, _name: 'Alis', gender: 'female'}]
      */
     batchUpdateAsync(recordMapList: _Cond<T>[]): Promise<{
         taskID: number;
     }>;
+    /**
+     * 用户级鉴权
+     */
+    useUserAuth(): this;
+    /**
+     * 系统级鉴权
+     */
+    useSystemAuth(): this;
 }
 export interface _IKQuery<T> {
     /**
@@ -126,8 +142,8 @@ export interface _IKQuery<T> {
      * 无需入参，返回全部符合条件的记录
      * @example
      * ```
-     * context.db.object("_user").where({
-     *     gender: "male"
+     * application.data.object('_user').where({
+     *     gender: 'male'
      * }).findAll()
      * ```
      */
@@ -137,7 +153,7 @@ export interface _IKQuery<T> {
      * @param handler 业务处理函数
      * @example
      * ```
-     * await context.db.object("_user").findStream(async (records) => {
+     * await application.data.object('_user').findStream(async (records) => {
      *     // doSomething ...
      * });
      * ```
@@ -147,8 +163,8 @@ export interface _IKQuery<T> {
      * 无需入参，返回符合条件的记录，单次返回 200 条
      * @example
      * ```
-     * context.db.object("_user").where({
-     *     gender: "male"
+     * application.data.object('_user').where({
+     *     gender: 'male'
      * }).find()
      * ```
      */
@@ -157,8 +173,8 @@ export interface _IKQuery<T> {
      * 无需入参，返回排在第一位的记录
      * @example
      * ```
-     * context.db.object("_user").where({
-     *     gender: "male"
+     * application.data.object('_user').where({
+     *     gender: 'male'
      * }).findOne()
      * ```
      */
@@ -168,7 +184,7 @@ export interface _IKQuery<T> {
      * @param fieldApiNames 排序依据的字段数组，按先后顺序确定优先级
      * @example
      * ```
-     * context.db.object("_user").orderBy(["_email", "_phoneNumber"]).find()
+     * application.data.object('_user').orderBy(['_email', '_phoneNumber']).find()
      * ```
      */
     orderBy<K extends keyof T>(fieldApiNames: K[]): Omit<_IKQuery<T>, 'findAll'>;
@@ -177,7 +193,7 @@ export interface _IKQuery<T> {
      * @param fieldApiNames 排序依据的字段，按先后顺序确定优先级，用逗号分隔
      * @example
      * ```
-     * context.db.object("_user").orderBy("_email", "_phoneNumber").find()
+     * application.data.object('_user').orderBy('_email', '_phoneNumber').find()
      * ```
      */
     orderBy<K extends keyof T>(...fieldApiNames: K[]): Omit<_IKQuery<T>, 'findAll'>;
@@ -186,7 +202,7 @@ export interface _IKQuery<T> {
      * @param fieldApiNames 排序依据的字段数组，按先后顺序确定优先级
      * @example
      * ```
-     * context.db.object("_user").orderByDesc("_email", "_phoneNumber").find()
+     * application.data.object('_user').orderByDesc('_email', '_phoneNumber').find()
      * ```
      */
     orderByDesc<K extends keyof T>(fieldApiNames: K[]): Omit<_IKQuery<T>, 'findAll'>;
@@ -195,7 +211,7 @@ export interface _IKQuery<T> {
      * @param fieldApiNames 排序依据的字段，按先后顺序确定优先级，用逗号分隔
      * @example
      * ```
-     * context.db.object("_user").orderByDesc("_email", "_phoneNumber").find()
+     * application.data.object('_user').orderByDesc('_email', '_phoneNumber').find()
      * ```
      */
     orderByDesc<K extends keyof T>(...fieldApiNames: K[]): Omit<_IKQuery<T>, 'findAll'>;
@@ -204,7 +220,7 @@ export interface _IKQuery<T> {
      * @param fieldApiNames 需返回的字段数组
      * @example
      * ```
-     * context.db.object("_user").select(["_name", "_email"]).find()
+     * application.data.object('_user').select(['_name', '_email']).find()
      * ```
      */
     select<K extends keyof T>(fieldApiNames: K[]): Omit<_IKQuery<T>, 'findAll'>;
@@ -213,18 +229,18 @@ export interface _IKQuery<T> {
      * @param fieldApiNames 需返回的字段，用逗号分隔
      * @example
      * ```
-     * context.db.object("_user").select("_name", "_email").find()
+     * application.data.object('_user').select('_name', '_email').find()
      * ```
      */
     select<K extends keyof T>(...fieldApiNames: K[]): Omit<_IKQuery<T>, 'findAll'>;
     /**
      * 设置查询条件
      * @param conditionMap 对字段赋值以指定查询筛选条件
-     * @paramExample {gender: "male"}
+     * @paramExample {gender: 'male'}
      * @example
      * ```
-     * context.db.object("_user").where({
-     *     gender: "male"
+     * application.data.object('_user').where({
+     *     gender: 'male'
      * }).find()
      * ```
      */
@@ -233,13 +249,23 @@ export interface _IKQuery<T> {
      * 设置查询条件
      */
     where(): Omit<_IKQuery<T>, 'findAll'>;
+    /**
+     * 模糊查询：与 where 之间是与关系
+     * @param keyword 模糊查询的关键字，必填且不可以为空串
+     * @param fieldAPINames 『可搜索字段』的字段列表，不可为空
+     * @example
+     * ```
+     * application.data.object('_user').fuzzySearch('张三', ['_name']).find()
+     * ```
+     */
+    fuzzySearch(keyword: string, fieldAPINames: string[]): Omit<_IKQuery<T>, 'findAll'>;
     /**
      * 指定分页查询的数量
      * @param limit 分页查询的数量
      * @paramExample 10
      * @example
      * ```
-     * context.db.object("_user").limit(10)
+     * application.data.object('_user').limit(10)
      * ```
      */
     limit(limit: number): Omit<_IKQuery<T>, 'findAll'>;
@@ -249,7 +275,7 @@ export interface _IKQuery<T> {
      * @paramExample 0
      * @example
      * ```
-     * context.db.object("_user").offset(0)
+     * application.data.object('_user').offset(0)
      * ```
      */
     offset(offset: number): Omit<_IKQuery<T>, 'findAll'>;
@@ -257,8 +283,16 @@ export interface _IKQuery<T> {
      * 指定条件的行数
      * @example
      * ```
-     * context.db.object("_user").count()
+     * application.data.object('_user').count()
      * ```
      */
     count(): Promise<number>;
+    /**
+     * 用户级鉴权
+     */
+    useUserAuth(): this;
+    /**
+     * 系统级鉴权
+     */
+    useSystemAuth(): this;
 }

package/context/db/impl/IObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IObject.js","sourceRoot":"","sources":["IObject.ts"],"names":[],"mappings":""}