@satorijs/adapter-lark 3.9.0 → 3.9.2

package/lib/types/api.d.ts

@@ -451,7 +451,7 @@ declare module './internal' {
         * 获取指定消息的内容
         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/get
         */
-        getImMessage(message_id: string): Promise<GetImMessageResponse>;
+        getImMessage(message_id: string, query?: GetImMessageQuery): Promise<GetImMessageResponse>;
         /**
         * 发送应用内加急
         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/urgent_app
@@ -5426,6 +5426,8 @@ declare module '.' {
             root_id?: string;
             /** 父消息的id open_message_id */
             parent_id?: string;
+            /** 消息所属的话题 ID */
+            thread_id?: string;
             /** 消息类型 text post card image等等 */
             msg_type?: string;
             /** 消息生成的时间戳(毫秒) */
@@ -16732,6 +16734,17 @@ export interface GetImMessageResourceQuery {
     /** 资源类型，可选"image, file“； image对应消息中的 图片，富文本消息中的图片。  file对应消息中的 文件、音频、视频、（表情包除外） */
     type: string;
 }
+export interface GetImMessageQuery {
+    /**
+     * 用户 ID 类型
+     *
+     * - `open_id`：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。
+     * - `union_id`：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。
+     * - `user_id`：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。
+     * @default 'open_id'
+     */
+    user_id_type?: 'open_id' | 'user_id' | 'union_id';
+}
 export interface UrgentAppImMessageRequest {
     /** 该字段标识目标用户的id类型 */
     user_id_list: string[];

package/lib/types/application.d.ts

@@ -36,7 +36,7 @@ declare module '../internal' {
          * 获取企业安装的应用
          * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application/list
          */
-        listApplication(query?: ListApplicationQuery): Promise<ListApplicationResponse>;
+        listApplication(query?: ListApplicationQuery): Promise<ListApplicationResponse> & AsyncIterableIterator<Application>;
         /**
          * 查看待审核的应用列表
          * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application/underauditlist
@@ -111,12 +111,12 @@ declare module '../internal' {
          * 获取用户自定义常用的应用
          * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v5/application/favourite
          */
-        favouriteApplication(query?: FavouriteApplicationQuery): Promise<FavouriteApplicationResponse>;
+        favouriteApplication(query?: FavouriteApplicationQuery): Promise<FavouriteApplicationResponse> & AsyncIterableIterator<Application>;
         /**
          * 获取管理员推荐的应用
          * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v5/application/recommend
          */
-        recommendApplication(query?: RecommendApplicationQuery): Promise<RecommendApplicationResponse>;
+        recommendApplication(query?: RecommendApplicationQuery): Promise<RecommendApplicationResponse> & AsyncIterableIterator<Application>;
         /**
          * 获取当前设置的推荐规则列表
          * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/app_recommend_rule/list
@@ -130,12 +130,19 @@ export interface GetApplicationQuery {
     /** 此次调用中使用的用户ID的类型 */
     user_id_type?: 'user_id' | 'union_id' | 'open_id';
 }
+export interface GetApplicationResponse {
+    /** 应用数据 */
+    app?: Application;
+}
 export interface GetApplicationApplicationAppVersionQuery {
     /** 应用信息的语言版本 */
     lang: 'zh_cn' | 'en_us' | 'ja_jp';
     /** 此次调用中使用的用户ID的类型 */
     user_id_type?: 'user_id' | 'union_id' | 'open_id';
 }
+export interface GetApplicationApplicationAppVersionResponse {
+    app_version?: ApplicationAppVersion;
+}
 export interface ListApplicationApplicationAppVersionQuery extends Pagination {
     /** 应用信息的语言版本 */
     lang: 'zh_cn' | 'en_us' | 'ja_jp';
@@ -150,17 +157,55 @@ export interface ContactsRangeSuggestApplicationApplicationAppVersionQuery {
     /** 此次调用中使用的用户ID的类型 */
     user_id_type?: 'user_id' | 'union_id' | 'open_id';
 }
+export interface ContactsRangeSuggestApplicationApplicationAppVersionResponse {
+    contacts_range?: ApplicationAppContactsRange;
+}
+export interface ListApplicationScopeResponse {
+    scopes?: Scope[];
+}
+export declare const enum ListApplicationQueryStatus {
+    /** 停用 */
+    AvailabilityStopped = 0,
+    /** 启用 */
+    AvailabilityActivated = 1,
+    /** 未启用 */
+    AvailabilityUnactivated = 2
+}
+export declare const enum ListApplicationQueryPaymentType {
+    /** 免费 */
+    Free = 0,
+    /** 付费 */
+    Paid = 1
+}
+export declare const enum ListApplicationQueryOwnerType {
+    /** 飞书科技 */
+    FeishuTechnology = 0,
+    /** 飞书合作伙伴 */
+    FeishuThirdParty = 1,
+    /** 企业内成员 */
+    EnterpriseMember = 2
+}
 export interface ListApplicationQuery extends Pagination {
     /** 用户 ID 类型 */
     user_id_type?: string;
     /** 应用的图标、描述、帮助文档链接是按照应用的主语言返回；其他内容（如应用权限、应用分类）按照该参数设定返回对应的语言。可选值有： zh_cn：中文 en_us：英文 ja_jp：日文  如不填写，则按照应用的主语言返回 */
     lang: string;
     /** 不传入代表全部返回。传入则按照这种应用状态返回。应用状态可选值有：0：停用状态1：启用状态 2：未启用状态 */
-    status?: 0 | 1 | 2;
+    status?: ListApplicationQueryStatus;
     /** 不传入代表全部返回。传入则按照这种应用状态返回。 付费类型 可选值： 0：免费 1：付费 */
-    payment_type?: 0 | 1;
+    payment_type?: ListApplicationQueryPaymentType;
     /** 不传入代表全部返回。传入则按照这种应用状态返回。所有者类型，可选值： 0：飞书科技 1：飞书合作伙伴 2：企业内成员 */
-    owner_type?: 0 | 1 | 2;
+    owner_type?: ListApplicationQueryOwnerType;
+}
+export interface ListApplicationResponse {
+    /** 应用列表 */
+    app_list?: Application[];
+    /** 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token */
+    page_token?: string;
+    /** 是否还有更多项 */
+    has_more?: boolean;
+    /** 应用状态=启用的应用总数 */
+    total_count?: number;
 }
 export interface UnderauditlistApplicationQuery extends Pagination {
     /** 指定返回的语言 */
@@ -168,9 +213,21 @@ export interface UnderauditlistApplicationQuery extends Pagination {
     /** 此次调用中使用的用户ID的类型 */
     user_id_type?: 'user_id' | 'union_id' | 'open_id';
 }
+export declare const enum PatchApplicationApplicationAppVersionRequestStatus {
+    /** 未知状态 */
+    Unknown = 0,
+    /** 审核通过 */
+    Audited = 1,
+    /** 审核拒绝 */
+    Reject = 2,
+    /** 审核中 */
+    UnderAudit = 3,
+    /** 未提交审核 */
+    Unaudit = 4
+}
 export interface PatchApplicationApplicationAppVersionRequest {
     /** 版本状态 */
-    status?: 0 | 1 | 2 | 3 | 4;
+    status?: PatchApplicationApplicationAppVersionRequestStatus;
 }
 export interface PatchApplicationApplicationAppVersionQuery {
     /** 此次调用中使用的用户ID的类型 */
@@ -194,6 +251,13 @@ export interface ContactsRangeConfigurationApplicationQuery extends Pagination {
     /** 此次调用中使用的用户ID的类型 */
     user_id_type?: 'user_id' | 'union_id' | 'open_id';
 }
+export interface ContactsRangeConfigurationApplicationResponse {
+    contacts_range?: ApplicationAppContactsRange;
+    /** 是否还有更多项 */
+    has_more?: boolean;
+    /** 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token */
+    page_token?: string;
+}
 export interface PatchApplicationApplicationContactsRangeRequest {
     /** 更新范围方式 */
     contacts_range_type: 'equal_to_availability' | 'some' | 'all';
@@ -222,6 +286,14 @@ export interface CheckWhiteBlackListApplicationApplicationVisibilityQuery {
     /** 此次请求传参中的department_id的类型 */
     department_id_type?: 'department_id' | 'open_department_id';
 }
+export interface CheckWhiteBlackListApplicationApplicationVisibilityResponse {
+    /** 用户可见性信息列表 */
+    user_visibility_list?: ApplicationVisibilityUserWhiteBlackInfo[];
+    /** 部门可见性信息列表 */
+    department_visibility_list?: ApplicationVisibilityDepartmentWhiteBlackInfo[];
+    /** 用户组可见性信息列表 */
+    group_visibility_list?: ApplicationVisibilityGroupWhiteBlackInfo[];
+}
 export interface PatchApplicationApplicationVisibilityRequest {
     /** 添加可用人员名单 */
     add_visible_list?: AppVisibilityIdList;
@@ -244,11 +316,19 @@ export interface UpdateApplicationApplicationManagementRequest {
     /** 启用/停用应用 */
     enable?: boolean;
 }
+export declare const enum DepartmentOverviewApplicationApplicationAppUsageRequestCycleType {
+    /** 日活 */
+    Day = 1,
+    /** 周活， date字段应该填自然周周一的日期 */
+    Week = 2,
+    /** 月活， date字段应该填自然月1号的日期 */
+    Month = 3
+}
 export interface DepartmentOverviewApplicationApplicationAppUsageRequest {
     /** 查询日期，格式为yyyy-mm-dd，若cycle_type为1，date可以为任何自然日；若cycle_type为2，则输入的date必须为周一； 若cycle_type为3，则输入的date必须为每月1号 */
     date: string;
     /** 活跃周期的统计类型 */
-    cycle_type: 1 | 2 | 3;
+    cycle_type: DepartmentOverviewApplicationApplicationAppUsageRequestCycleType;
     /** 查询的部门id，获取方法可参考[部门ID概述](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)-  若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户） 以及多级子部门的使用数据。-  若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。- 若不填写则返回整个租户的数据 */
     department_id?: string;
     /** 是否需要查询部门下多层子部门的数据。未设置或为0时，仅查询department_id对应的部门。设置为n时，查询department_id及其n级子部门的数据。仅在department_id参数传递时有效，最大值为4。 */
@@ -262,11 +342,19 @@ export interface DepartmentOverviewApplicationApplicationAppUsageQuery {
     /** 调用中使用的部门ID的类型 */
     department_id_type?: 'department_id' | 'open_department_id';
 }
+export declare const enum MessagePushOverviewApplicationApplicationAppUsageRequestCycleType {
+    /** 日活 */
+    Day = 1,
+    /** 周活， date字段应该填自然周周一的日期 */
+    Week = 2,
+    /** 月活， date字段应该填自然月1号的日期 */
+    Month = 3
+}
 export interface MessagePushOverviewApplicationApplicationAppUsageRequest {
     /** 查询日期，若cycle_type为week，则输入的date必须为周一； 若cycle_type为month，则输入的date必须为每月1号 */
     date: string;
     /** 枚举值：day，week，month；week指自然周，返回当前日期所在周的数据；不满一周则从周一到当前日期算。month指自然月，返回当前日期所在月的数据。 */
-    cycle_type: 1 | 2 | 3;
+    cycle_type: MessagePushOverviewApplicationApplicationAppUsageRequestCycleType;
     /** 需要查询的部门id，获取方法可参考[部门ID概述](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)-  若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户）； -  若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。返回当前部门的使用数据； 若不填写，则返回当前租户的使用数据 */
     department_id?: string;
 }
@@ -274,11 +362,23 @@ export interface MessagePushOverviewApplicationApplicationAppUsageQuery {
     /** 调用中使用的部门ID的类型 */
     department_id_type?: 'department_id' | 'open_department_id';
 }
+export interface MessagePushOverviewApplicationApplicationAppUsageResponse {
+    /** 消息推送情况 */
+    items?: ApplicationAppUsage[];
+}
+export declare const enum OverviewApplicationApplicationAppUsageRequestCycleType {
+    /** 日活 */
+    Day = 1,
+    /** 周活， date字段应该填自然周周一的日期 */
+    Week = 2,
+    /** 月活， date字段应该填自然月1号的日期 */
+    Month = 3
+}
 export interface OverviewApplicationApplicationAppUsageRequest {
     /** 查询日期，格式为yyyy-mm-dd，若cycle_type为1，date可以为任何自然日；若cycle_type为2，则输入的date必须为周一； 若cycle_type为3，则输入的date必须为每月1号 */
     date: string;
     /** 活跃周期的统计类型 */
-    cycle_type: 1 | 2 | 3;
+    cycle_type: OverviewApplicationApplicationAppUsageRequestCycleType;
     /** 查询的部门id，获取方法可参考[部门ID概述](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)-  若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户）； -  若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。 */
     department_id?: string;
     /** 能力类型，按能力类型进行筛选，返回对应能力的活跃数据 */
@@ -288,22 +388,52 @@ export interface OverviewApplicationApplicationAppUsageQuery {
     /** 调用中使用的部门ID的类型 */
     department_id_type?: 'department_id' | 'open_department_id';
 }
+export interface OverviewApplicationApplicationAppUsageResponse {
+    /** 员工使用应用概览数据 */
+    items?: ApplicationAppUsage[];
+}
+export declare const enum PatchApplicationApplicationFeedbackQueryStatus {
+    /** 反馈未处理 */
+    Unmarked = 0,
+    /** 反馈已处理 */
+    Marked = 1,
+    /** 反馈处理中 */
+    Processing = 2,
+    /** 反馈已关闭 */
+    Closed = 3
+}
 export interface PatchApplicationApplicationFeedbackQuery {
     user_id_type?: 'open_id' | 'union_id' | 'user_id';
     /** 反馈处理状态 */
-    status: 0 | 1 | 2 | 3;
+    status: PatchApplicationApplicationFeedbackQueryStatus;
     /** 反馈处理人员id，租户内用户的唯一标识， ID值与查询参数中的user_id_type 对应 */
     operator_id: string;
 }
+export declare const enum ListApplicationApplicationFeedbackQueryFeedbackType {
+    /** 故障反馈 */
+    Fault = 1,
+    /** 产品建议 */
+    Advice = 2
+}
+export declare const enum ListApplicationApplicationFeedbackQueryStatus {
+    /** 反馈未处理 */
+    Unmarked = 0,
+    /** 反馈已处理 */
+    Marked = 1,
+    /** 反馈处理中 */
+    Processing = 2,
+    /** 反馈已关闭 */
+    Closed = 3
+}
 export interface ListApplicationApplicationFeedbackQuery extends Pagination {
     /** 查询的起始日期，格式为yyyy-mm-dd。不填则默认为当前日期减去180天。 */
     from_date?: string;
     /** 查询的结束日期，格式为yyyy-mm-dd。不填默认为当前日期。只能查询 180 天内的数据。 */
     to_date?: string;
     /** 反馈类型，不填写则表示查询所有反馈类型。 */
-    feedback_type?: 1 | 2;
+    feedback_type?: ListApplicationApplicationFeedbackQueryFeedbackType;
     /** 反馈处理状态，不填写则表示查询所有处理类型。 */
-    status?: 0 | 1 | 2 | 3;
+    status?: ListApplicationApplicationFeedbackQueryStatus;
     user_id_type?: 'open_id' | 'union_id' | 'user_id';
 }
 export interface SetApplicationAppBadgeRequest {
@@ -326,62 +456,6 @@ export interface FavouriteApplicationQuery extends Pagination {
     /** 应用信息的语言版本 */
     language?: 'zh_cn' | 'en_us' | 'ja_jp';
 }
-export interface RecommendApplicationQuery extends Pagination {
-    /** 应用信息的语言版本 */
-    language?: 'zh_cn' | 'en_us' | 'ja_jp';
-    /** 推荐应用类型，默认为用户不可移除的推荐应用列表 */
-    recommend_type?: 'user_unremovable' | 'user_removable';
-}
-export interface ListApplicationAppRecommendRuleQuery extends Pagination {
-    /** 此次调用中使用的用户ID的类型 */
-    user_id_type?: 'user_id' | 'union_id' | 'open_id';
-}
-export interface GetApplicationResponse {
-    /** 应用数据 */
-    app?: Application;
-}
-export interface GetApplicationApplicationAppVersionResponse {
-    app_version?: ApplicationAppVersion;
-}
-export interface ContactsRangeSuggestApplicationApplicationAppVersionResponse {
-    contacts_range?: ApplicationAppContactsRange;
-}
-export interface ListApplicationScopeResponse {
-    scopes?: Scope[];
-}
-export interface ListApplicationResponse {
-    /** 应用列表 */
-    app_list?: Application[];
-    /** 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token */
-    page_token?: string;
-    /** 是否还有更多项 */
-    has_more?: boolean;
-    /** 应用状态=启用的应用总数 */
-    total_count?: number;
-}
-export interface ContactsRangeConfigurationApplicationResponse {
-    contacts_range?: ApplicationAppContactsRange;
-    /** 是否还有更多项 */
-    has_more?: boolean;
-    /** 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token */
-    page_token?: string;
-}
-export interface CheckWhiteBlackListApplicationApplicationVisibilityResponse {
-    /** 用户可见性信息列表 */
-    user_visibility_list?: ApplicationVisibilityUserWhiteBlackInfo[];
-    /** 部门可见性信息列表 */
-    department_visibility_list?: ApplicationVisibilityDepartmentWhiteBlackInfo[];
-    /** 用户组可见性信息列表 */
-    group_visibility_list?: ApplicationVisibilityGroupWhiteBlackInfo[];
-}
-export interface MessagePushOverviewApplicationApplicationAppUsageResponse {
-    /** 消息推送情况 */
-    items?: ApplicationAppUsage[];
-}
-export interface OverviewApplicationApplicationAppUsageResponse {
-    /** 员工使用应用概览数据 */
-    items?: ApplicationAppUsage[];
-}
 export interface FavouriteApplicationResponse {
     /** 分页的token */
     page_token?: string;
@@ -392,6 +466,12 @@ export interface FavouriteApplicationResponse {
     /** 应用数据列表 */
     app_list?: Application[];
 }
+export interface RecommendApplicationQuery extends Pagination {
+    /** 应用信息的语言版本 */
+    language?: 'zh_cn' | 'en_us' | 'ja_jp';
+    /** 推荐应用类型，默认为用户不可移除的推荐应用列表 */
+    recommend_type?: 'user_unremovable' | 'user_removable';
+}
 export interface RecommendApplicationResponse {
     /** 分页的token */
     page_token?: string;
@@ -404,3 +484,7 @@ export interface RecommendApplicationResponse {
     /** 应用数据列表 */
     app_list?: Application[];
 }
+export interface ListApplicationAppRecommendRuleQuery extends Pagination {
+    /** 此次调用中使用的用户ID的类型 */
+    user_id_type?: 'user_id' | 'union_id' | 'open_id';
+}