@satorijs/adapter-lark 3.8.6 → 3.9.1

package/lib/index.d.ts

@@ -1,11 +1,13 @@
 import { LarkBot } from './bot';
+import { Internal } from './internal';
+import { EventPayload } from './utils';
 import * as Lark from './types';
 export * from './bot';
 export { Lark, Lark as Feishu };
 export default LarkBot;
 declare module '@satorijs/core' {
     interface Session {
-        feishu: Lark.Internal & Lark.EventPayload;
-        lark: Lark.Internal & Lark.EventPayload;
+        feishu: Internal & EventPayload;
+        lark: Internal & EventPayload;
     }
 }

package/lib/internal.d.ts

@@ -0,0 +1,37 @@
+import { Dict, HTTP } from '@satorijs/core';
+import { LarkBot } from './bot';
+export interface Internal {
+}
+export interface BaseResponse {
+    /** error code. would be 0 if success, and non-0 if failed. */
+    code: number;
+    /** error message. would be 'success' if success. */
+    msg: string;
+}
+export type Paginated<T = any, ItemsKey extends string = 'items'> = Promise<{
+    [K in ItemsKey]: T[];
+} & {
+    page_token?: string;
+    has_more: boolean;
+}> & AsyncIterableIterator<T>;
+export interface Pagination {
+    page_size?: number;
+    page_token?: string;
+}
+export interface InternalRoute {
+    name: string;
+    pagination?: {
+        argIndex: number;
+        itemsKey?: string;
+        tokenKey?: string;
+    };
+    multipart?: boolean;
+    type?: 'raw-json' | 'binary';
+}
+export declare class Internal {
+    private bot;
+    constructor(bot: LarkBot);
+    private _assertResponse;
+    private _buildData;
+    static define(routes: Dict<Partial<Record<HTTP.Method, string | InternalRoute>>>): void;
+}

package/lib/message.d.ts

@@ -1,6 +1,8 @@
 import { Context, h, MessageEncoder } from '@satorijs/core';
 import { LarkBot } from './bot';
+import { EventPayload } from './utils';
 export declare class LarkMessageEncoder<C extends Context = Context> extends MessageEncoder<C, LarkBot<C>> {
+    referrer?: EventPayload;
     private quote;
     private textContent;
     private richContent;

package/lib/types/acs.d.ts

@@ -0,0 +1,177 @@
+import { AccessRecord, Device, Feature, Rule, User, UserExternal } from '.';
+import { Pagination } from '../internal';
+declare module '../internal' {
+    interface Internal {
+        /**
+         * 修改用户部分信息
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user/patch
+         */
+        patchAcsUser(user_id: string, body: PatchAcsUserRequest, query?: PatchAcsUserQuery): Promise<void>;
+        /**
+         * 获取单个用户信息
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user/get
+         */
+        getAcsUser(user_id: string, query?: GetAcsUserQuery): Promise<GetAcsUserResponse>;
+        /**
+         * 获取用户列表
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user/list
+         */
+        listAcsUser(query?: ListAcsUserQuery): Paginated<User>;
+        /**
+         * 上传人脸图片
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user-face/update
+         */
+        updateAcsUserFace(user_id: string, form: UpdateAcsUserFaceForm, query?: UpdateAcsUserFaceQuery): Promise<void>;
+        /**
+         * 下载人脸图片
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user-face/get
+         */
+        getAcsUserFace(user_id: string, query?: GetAcsUserFaceQuery): Promise<ArrayBuffer>;
+        /**
+         * 设备绑定权限组
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/rule_external/device_bind
+         */
+        deviceBindAcsRuleExternal(body: DeviceBindAcsRuleExternalRequest): Promise<void>;
+        /**
+         * 获取权限组信息
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/rule_external/get
+         */
+        getAcsRuleExternal(query?: GetAcsRuleExternalQuery): Promise<GetAcsRuleExternalResponse>;
+        /**
+         * 删除权限组
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/rule_external/delete
+         */
+        deleteAcsRuleExternal(query?: DeleteAcsRuleExternalQuery): Promise<void>;
+        /**
+         * 创建或更新权限组
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/rule_external/create
+         */
+        createAcsRuleExternal(body: CreateAcsRuleExternalRequest, query?: CreateAcsRuleExternalQuery): Promise<CreateAcsRuleExternalResponse>;
+        /**
+         * 删除访客
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/visitor/delete
+         */
+        deleteAcsVisitor(visitor_id: string, query?: DeleteAcsVisitorQuery): Promise<void>;
+        /**
+         * 添加访客
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/visitor/create
+         */
+        createAcsVisitor(body: CreateAcsVisitorRequest, query?: CreateAcsVisitorQuery): Promise<CreateAcsVisitorResponse>;
+        /**
+         * 获取门禁设备列表
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/device/list
+         */
+        listAcsDevice(): Promise<ListAcsDeviceResponse>;
+        /**
+         * 获取门禁记录列表
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/access_record/list
+         */
+        listAcsAccessRecord(query?: ListAcsAccessRecordQuery): Paginated<AccessRecord>;
+        /**
+         * 下载开门时的人脸识别图片
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/access_record-access_photo/get
+         */
+        getAcsAccessRecordAccessPhoto(access_record_id: string): Promise<ArrayBuffer>;
+    }
+}
+export interface PatchAcsUserRequest {
+    /** 用户特征 */
+    feature?: Feature;
+}
+export interface PatchAcsUserQuery {
+    /** 此次调用中使用的用户ID的类型 */
+    user_id_type?: 'user_id' | 'union_id' | 'open_id';
+}
+export interface GetAcsUserQuery {
+    /** 此次调用中使用的用户ID的类型 */
+    user_id_type?: 'user_id' | 'union_id' | 'open_id';
+}
+export interface ListAcsUserQuery extends Pagination {
+    /** 此次调用中使用的用户ID的类型 */
+    user_id_type?: 'user_id' | 'union_id' | 'open_id';
+}
+export interface UpdateAcsUserFaceForm {
+    /** 人脸图片内容 */
+    files: Blob;
+    /** 文件类型,可选的类型有jpg,png */
+    file_type: string;
+    /** 带后缀的文件名 */
+    file_name: string;
+}
+export interface UpdateAcsUserFaceQuery {
+    /** 此次调用中使用的用户ID的类型 */
+    user_id_type?: 'user_id' | 'union_id' | 'open_id';
+}
+export interface GetAcsUserFaceQuery {
+    /** 裁剪图 */
+    is_cropped?: boolean;
+    /** 此次调用中使用的用户ID的类型 */
+    user_id_type?: 'user_id' | 'union_id' | 'open_id';
+}
+export interface DeviceBindAcsRuleExternalRequest {
+    /** 设备id */
+    device_id: string;
+    /** 权限组id列表 */
+    rule_ids: string[];
+}
+export interface GetAcsRuleExternalQuery {
+    /** 设备id */
+    device_id?: string;
+    /** 此次调用中使用的用户ID的类型 */
+    user_id_type?: 'user_id' | 'union_id' | 'open_id';
+}
+export interface DeleteAcsRuleExternalQuery {
+    /** 权限组id */
+    rule_id: string;
+}
+export interface CreateAcsRuleExternalRequest {
+    /** 权限组信息 */
+    rule: Rule;
+}
+export interface CreateAcsRuleExternalQuery {
+    /** 权限组id-为空创建,不为空则更新 */
+    rule_id?: string;
+    /** 此次调用中使用的用户ID的类型 */
+    user_id_type?: 'user_id' | 'union_id' | 'open_id';
+}
+export interface DeleteAcsVisitorQuery {
+    /** 此次调用中使用的用户ID的类型 */
+    user_id_type?: 'user_id' | 'union_id' | 'open_id';
+}
+export interface CreateAcsVisitorRequest {
+    /** 访客信息 */
+    user: UserExternal;
+}
+export interface CreateAcsVisitorQuery {
+    /** 此次调用中使用的用户ID的类型 */
+    user_id_type?: 'user_id' | 'union_id' | 'open_id';
+}
+export interface ListAcsAccessRecordQuery extends Pagination {
+    /** 记录开始时间，单位秒 */
+    from: number;
+    /** 记录结束时间，单位秒，时间跨度不能超过30天 */
+    to: number;
+    /** 门禁设备 ID */
+    device_id?: string;
+    /** 此次调用中使用的用户ID的类型 */
+    user_id_type?: 'user_id' | 'union_id' | 'open_id';
+}
+export interface GetAcsUserResponse {
+    /** 门禁用户信息 */
+    user?: User;
+}
+export interface GetAcsRuleExternalResponse {
+    /** 设备权限组信息 */
+    rules: Rule[];
+}
+export interface CreateAcsRuleExternalResponse {
+    /** 权限组id */
+    rule_id: string;
+}
+export interface CreateAcsVisitorResponse {
+    /** 访客的id */
+    visitor_id: string;
+}
+export interface ListAcsDeviceResponse {
+    items?: Device[];
+}

package/lib/types/admin.d.ts

@@ -0,0 +1,270 @@
+import { AdminDeptStat, AdminUserStat, AuditInfo, Badge, Grant, I18n, Password, RuleDetail } from '.';
+import { Pagination } from '../internal';
+declare module '../internal' {
+    interface Internal {
+        /**
+         * 重置用户的企业邮箱密码
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/password/reset
+         */
+        resetAdminPassword(body: ResetAdminPasswordRequest, query?: ResetAdminPasswordQuery): Promise<void>;
+        /**
+         * 获取部门维度的用户活跃和功能使用数据
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/admin_dept_stat/list
+         */
+        listAdminAdminDeptStat(query?: ListAdminAdminDeptStatQuery): Paginated<AdminDeptStat>;
+        /**
+         * 获取用户维度的用户活跃和功能使用数据
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/admin_user_stat/list
+         */
+        listAdminAdminUserStat(query?: ListAdminAdminUserStatQuery): Paginated<AdminUserStat>;
+        /**
+         * 创建勋章
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge/create
+         */
+        createAdminBadge(body: CreateAdminBadgeRequest): Promise<CreateAdminBadgeResponse>;
+        /**
+         * 修改勋章信息
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge/update
+         */
+        updateAdminBadge(badge_id: string, body: UpdateAdminBadgeRequest): Promise<UpdateAdminBadgeResponse>;
+        /**
+         * 上传勋章图片
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge_image/create
+         */
+        createAdminBadgeImage(form: CreateAdminBadgeImageForm): Promise<CreateAdminBadgeImageResponse>;
+        /**
+         * 获取勋章列表
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge/list
+         */
+        listAdminBadge(query?: ListAdminBadgeQuery): Paginated<Badge, 'badges'>;
+        /**
+         * 获取勋章详情
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge/get
+         */
+        getAdminBadge(badge_id: string): Promise<GetAdminBadgeResponse>;
+        /**
+         * 创建授予名单
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/create
+         */
+        createAdminBadgeGrant(badge_id: string, body: CreateAdminBadgeGrantRequest, query?: CreateAdminBadgeGrantQuery): Promise<CreateAdminBadgeGrantResponse>;
+        /**
+         * 删除授予名单
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/delete
+         */
+        deleteAdminBadgeGrant(badge_id: string, grant_id: string): Promise<void>;
+        /**
+         * 修改授予名单
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/update
+         */
+        updateAdminBadgeGrant(badge_id: string, grant_id: string, body: UpdateAdminBadgeGrantRequest, query?: UpdateAdminBadgeGrantQuery): Promise<UpdateAdminBadgeGrantResponse>;
+        /**
+         * 获取授予名单列表
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/list
+         */
+        listAdminBadgeGrant(badge_id: string, query?: ListAdminBadgeGrantQuery): Paginated<Grant, 'grants'>;
+        /**
+         * 获取授予名单详情
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/get
+         */
+        getAdminBadgeGrant(badge_id: string, grant_id: string, query?: GetAdminBadgeGrantQuery): Promise<GetAdminBadgeGrantResponse>;
+        /**
+         * 获取行为审计日志数据
+         * @see https://open.feishu.cn/document/ukTMukTMukTM/uQjM5YjL0ITO24CNykjN/audit_log/audit_data_get
+         */
+        listAdminAuditInfo(query?: ListAdminAuditInfoQuery): Paginated<AuditInfo>;
+    }
+}
+export interface ResetAdminPasswordRequest {
+    /** 需要重置的密码参数，不少于8个字符，字母、数字和符号，至少三选二 */
+    password: Password;
+    /** 待修改密码的用户ID，只针对邮箱登录凭证与企业邮箱(包括别名)相等的用户生效 */
+    user_id: string;
+}
+export interface ResetAdminPasswordQuery {
+    /** 用户ID类型 */
+    user_id_type: 'open_id' | 'union_id' | 'user_id';
+}
+export interface ListAdminAdminDeptStatQuery extends Pagination {
+    /** 部门ID类型 */
+    department_id_type: 'department_id' | 'open_department_id';
+    /** 起始日期（包含），格式是YYYY-mm-dd */
+    start_date: string;
+    /** 终止日期（包含），格式是YYYY-mm-dd，起止日期之间相差不能超过91天（包含91天） */
+    end_date: string;
+    /** 部门的 ID，取决于department_id_type，仅支持根部门及其下前4级子部门 */
+    department_id: string;
+    /** 是否包含子部门，如果该值为false，则只查出本部门直属用户活跃和功能使用数据；如果该值为true，则查出该部门以及其子部门（子部门层级最多不超过根部门下的前4级）的用户活跃和功能使用数据 */
+    contains_child_dept: boolean;
+    /** 跨域访问的geo */
+    target_geo?: string;
+    /** 是否返回分产品版本数据 */
+    with_product_version?: boolean;
+}
+export interface ListAdminAdminUserStatQuery extends Pagination {
+    /** 此次调用中使用的用户ID的类型 */
+    user_id_type?: 'user_id' | 'union_id' | 'open_id';
+    /** 部门ID类型 */
+    department_id_type?: 'department_id' | 'open_department_id';
+    /** 起始日期（包含），格式是YYYY-mm-dd */
+    start_date: string;
+    /** 终止日期（包含），格式是YYYY-mm-dd。起止日期之间相差不能超过31天（包含31天） */
+    end_date: string;
+    /** 部门的 ID，取决于department_id_type */
+    department_id?: string;
+    /** 用户的open_id，user_id或者union_id，取决于user_id_type */
+    user_id?: string;
+    /** 跨域访问的geo */
+    target_geo?: string;
+}
+export interface CreateAdminBadgeRequest {
+    /** 租户内唯一的勋章名称，最多30个字符。 */
+    name: string;
+    /** 勋章的描述文案，最多100个字符。 */
+    explanation?: string;
+    /** 企业勋章的详情图Key。1.权限校验：非本租户上传的图片key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片key时，需使用1h内上传的图片key。 */
+    detail_image: string;
+    /** 企业勋章的头像挂饰图Key。1.权限校验：非本租户上传的图片key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片key时，需使用1h内上传的图片key。 */
+    show_image: string;
+    /** 勋章的多语言名称，同name字段限制，最多30个字符。 */
+    i18n_name?: I18n;
+    /** 勋章的多语言描述文案，同explanation字段限制，最多100个字符。 */
+    i18n_explanation?: I18n;
+}
+export interface UpdateAdminBadgeRequest {
+    /** 租户内唯一的勋章名称，最多30个字符。 */
+    name: string;
+    /** 勋章的描述文案，最多100个字符。 */
+    explanation?: string;
+    /** 企业勋章的详情图Key。1.权限校验：非本租户上传的图片key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片key时，需使用1h内上传的图片key。 */
+    detail_image: string;
+    /** 企业勋章的头像挂饰图Key。1.权限校验：非本租户上传的图片key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片key时，需使用1h内上传的图片key。 */
+    show_image: string;
+    /** 勋章的多语言名称，同name字段限制，最多30个字符。 */
+    i18n_name?: I18n;
+    /** 勋章的多语言描述文案，同explanation字段限制，最多100个字符。 */
+    i18n_explanation?: I18n;
+}
+export interface CreateAdminBadgeImageForm {
+    /** 勋章图片的文件，仅支持 PNG 格式，320 x 320 像素，大小不超过 1024 KB。 */
+    image_file: Blob;
+    /** 图片的类型 */
+    image_type: 1 | 2;
+}
+export interface ListAdminBadgeQuery extends Pagination {
+    /** 租户内唯一的勋章名称，精确匹配。 */
+    name?: string;
+}
+export interface CreateAdminBadgeGrantRequest {
+    /** 授予名单名称，最多100个字符。 */
+    name: string;
+    /** 勋章下唯一的授予事项 */
+    grant_type: 0 | 1;
+    /** 授予名单的生效时间对应的时区，用于检查RuleDetail的时间戳的取值是否规范，取值范围为TZ database name */
+    time_zone: string;
+    /** 规则详情 */
+    rule_detail: RuleDetail;
+    /** 是否授予给全员。1.为false时，需要关联1~500个用户群体。2.为true时，不可关联用户、用户组、部门。 */
+    is_grant_all: boolean;
+    /** 授予的用户ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 */
+    user_ids?: string[];
+    /** 授予的部门ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 */
+    department_ids?: string[];
+    /** 授予的用户组ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 */
+    group_ids?: string[];
+}
+export interface CreateAdminBadgeGrantQuery {
+    /** 用户 ID 类型 */
+    user_id_type?: 'open_id' | 'union_id' | 'user_id';
+    /** 此次调用中使用的部门ID的类型。 */
+    department_id_type?: 'department_id' | 'open_department_id';
+}
+export interface UpdateAdminBadgeGrantRequest {
+    /** 授予名单名称，最多100个字符。 */
+    name: string;
+    /** 勋章下唯一的授予事项 */
+    grant_type: 0 | 1;
+    /** 授予名单的生效时间对应的时区，用于检查RuleDetail的时间戳的取值是否规范，取值范围为TZ database name */
+    time_zone: string;
+    /** 规则详情 */
+    rule_detail: RuleDetail;
+    /** 是否授予给全员。1.为false时，需要关联1~500个用户群体。2.为true时，不可关联用户、用户组、部门。 */
+    is_grant_all: boolean;
+    /** 授予的用户ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 */
+    user_ids?: string[];
+    /** 授予的部门ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 */
+    department_ids?: string[];
+    /** 授予的用户组ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 */
+    group_ids?: string[];
+}
+export interface UpdateAdminBadgeGrantQuery {
+    /** 用户 ID 类型 */
+    user_id_type?: 'open_id' | 'union_id' | 'user_id';
+    /** 此次调用中使用的部门ID的类型。 */
+    department_id_type?: 'department_id' | 'open_department_id';
+}
+export interface ListAdminBadgeGrantQuery extends Pagination {
+    /** 用户 ID 类型 */
+    user_id_type?: 'open_id' | 'union_id' | 'user_id';
+    /** 此次调用中使用的部门ID的类型。 */
+    department_id_type?: 'department_id' | 'open_department_id';
+    /** 授予名单名称，精确匹配。 */
+    name?: string;
+}
+export interface GetAdminBadgeGrantQuery {
+    /** 用户 ID 类型 */
+    user_id_type?: 'open_id' | 'union_id' | 'user_id';
+    /** 此次调用中使用的部门ID的类型。 */
+    department_id_type?: 'department_id' | 'open_department_id';
+}
+export interface ListAdminAuditInfoQuery extends Pagination {
+    /** 此次调用中使用的用户ID的类型 */
+    user_id_type?: 'user_id' | 'union_id' | 'open_id';
+    /** 日志时间范围: 结束时间. 格式: 秒级时间戳. 默认值: 此刻 */
+    latest?: number;
+    /** 日志时间范围: 起始时间. 格式: 秒级时间戳. 默认值:  30日前此刻 */
+    oldest?: number;
+    /** 事件名称 */
+    event_name?: string;
+    /** 过滤操作者: 操作者类型. 与 operator_value 配合使用 */
+    operator_type?: 'user' | 'bot';
+    /** 过滤操作者: 操作者ID. 与 operator_type 配合使用 */
+    operator_value?: string;
+    /** 过滤模块 */
+    event_module?: number;
+    /** 过滤用户类型. 仅当 operator_type=user 时生效 */
+    user_type?: 0 | 1 | 2;
+    /** 过滤操作对象: 操作对象类型. 与object_value配合使用 */
+    object_type?: number;
+    /** 过滤操作对象: 操作对象ID. 与object_type配合使用 */
+    object_value?: string;
+    /** 增强过滤操作对象: 操作对象ID，支持云文档侧泛token过滤。会覆盖object_type和object_value查询条件 */
+    ext_filter_object_by_ccm_token?: string;
+}
+export interface CreateAdminBadgeResponse {
+    /** 勋章的信息 */
+    badge?: Badge;
+}
+export interface UpdateAdminBadgeResponse {
+    /** 勋章信息 */
+    badge?: Badge;
+}
+export interface CreateAdminBadgeImageResponse {
+    /** 图片的key */
+    image_key?: string;
+}
+export interface GetAdminBadgeResponse {
+    /** 勋章信息 */
+    badge?: Badge;
+}
+export interface CreateAdminBadgeGrantResponse {
+    /** 授予名单的信息 */
+    grant?: Grant;
+}
+export interface UpdateAdminBadgeGrantResponse {
+    /** 授予名单 */
+    grant?: Grant;
+}
+export interface GetAdminBadgeGrantResponse {
+    /** 授予名单信息 */
+    grant?: Grant;
+}