@satorijs/adapter-lark 3.12.4 → 3.12.5

package/lib/types/corehr.d.ts

@@ -57,6 +57,7 @@ export declare namespace Corehr {
         bp: Bp.Methods;
         assignedUser: AssignedUser.Methods;
         process: Process.Methods;
+        processStart: ProcessStart.Methods;
         processRevoke: ProcessRevoke.Methods;
         processWithdraw: ProcessWithdraw.Methods;
         approver: Approver.Methods;
@@ -703,6 +704,7 @@ export declare namespace Corehr {
     }
     namespace Employee {
         interface Methods {
+            customOrg: CustomOrg.Methods;
             /**
              * 批量查询员工信息
              * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get
@@ -922,6 +924,127 @@ export declare namespace Corehr {
             /** 任职信息 ID */
             job_data_id?: string;
         }
+        namespace CustomOrg {
+            interface Methods {
+                /**
+                 * 新增人员自定义组织变更记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee-custom_org/create_emp_custom_org
+                 */
+                createEmpCustomOrg(body: CreateEmpCustomOrgRequest, query?: CreateEmpCustomOrgQuery): Promise<CreateEmpCustomOrgResponse>;
+                /**
+                 * 更新人员自定义组织变更记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee-custom_org/edit_emp_custom_org
+                 */
+                editEmpCustomOrg(body: EditEmpCustomOrgRequest, query?: EditEmpCustomOrgQuery): Promise<EditEmpCustomOrgResponse>;
+                /**
+                 * 查询单个人员自定义组织变更记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee-custom_org/querybyid
+                 */
+                querybyid(query?: QuerybyidQuery): Promise<QuerybyidResponse>;
+                /**
+                 * 批量查询人员自定义组织变更记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee-custom_org/employment_custom_org_record
+                 */
+                employmentCustomOrgRecord(query?: EmploymentCustomOrgRecordQuery): Promise<EmploymentCustomOrgRecordResponse>;
+                /**
+                 * 删除人员自定义组织变更记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee-custom_org/del
+                 */
+                del(body: DelRequest, query?: DelQuery): Promise<DelResponse>;
+            }
+            interface CreateEmpCustomOrgRequest {
+                /** 用户ID */
+                user_id: string;
+                /** 自定义组织类型编码 */
+                object_api_name: string;
+                /** 自定义组织列表 */
+                custom_org_with_rates: Lark.CustomOrgWithRate[];
+                /** 变更原因 */
+                start_reason?: string;
+                /** 生效时间 */
+                effective_time: string;
+            }
+            interface CreateEmpCustomOrgQuery {
+                /** 此次调用中使用的用户ID的类型 */
+                user_id_type: 'people_corehr_id' | 'open_id' | 'union_id' | 'user_id';
+            }
+            interface CreateEmpCustomOrgResponse {
+                /** 自定义组织ID */
+                job_data_custom_org_id: string;
+                /** 版本ID */
+                version_id: string;
+            }
+            interface EditEmpCustomOrgRequest {
+                /** 用户ID */
+                user_id: string;
+                /** 自定义组织类型编码 */
+                object_api_name: string;
+                /** 自定义组织ID */
+                job_data_custom_org_id: string;
+                /** 版本ID */
+                version_id: string;
+                /** 自定义组织列表 */
+                custom_org_with_rates: Lark.CustomOrgWithRate[];
+                /** 生效时间 */
+                effective_time: string;
+                /** 变更原因 */
+                start_reason?: string;
+            }
+            interface EditEmpCustomOrgQuery {
+                /** 此次调用中使用的用户ID的类型 */
+                user_id_type: 'open_id' | 'union_id' | 'user_id' | 'people_corehr_id';
+            }
+            interface EditEmpCustomOrgResponse {
+                /** 添加成功 */
+                data?: string;
+            }
+            interface QuerybyidQuery {
+                /** 自定义组织ID */
+                job_data_custom_org_id: string;
+                /** 版本IDs 。为空是查 全部的版本记录 */
+                version_id?: string[];
+                /** 自定义组织类型编码 */
+                object_api_name: string;
+                /** 用户ID标识 */
+                user_id_type: 'people_corehr_id' | 'open_id' | 'union_id' | 'user_id';
+            }
+            interface QuerybyidResponse {
+                /** 详情 */
+                custom_org: Lark.EmpCustomOrgList[];
+                /** 用户编码 */
+                user_id?: string;
+            }
+            interface EmploymentCustomOrgRecordQuery {
+                /** 用户ID */
+                user_ids: string[];
+                /** 用户 ID 类型 */
+                user_id_type: 'open_id' | 'union_id' | 'user_id' | 'people_corehr_id';
+                /** 组织类型编码，可在「飞书人事-设置-组织设置」中相应的自定义组织目录下查看 */
+                object_api_names: string[];
+            }
+            interface EmploymentCustomOrgRecordResponse {
+                /** 自定义组织列表 */
+                custom_org_list?: Lark.EmpCustomOrgList[];
+            }
+            interface DelRequest {
+                /** 用户ID */
+                user_id: string;
+                /** 自定义组织ID */
+                job_data_custom_org_id: string;
+                /** 版本ID */
+                version_id: string;
+                /** 自定义组织类型编码 */
+                object_api_name: string;
+            }
+            interface DelQuery {
+                /** 此次调用中使用的用户ID的类型 */
+                user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
+            }
+            interface DelResponse {
+                /** 返回值 */
+                data: string;
+            }
+        }
     }
     namespace Person {
         interface Methods {
@@ -2622,6 +2745,11 @@ export declare namespace Corehr {
              * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/location/query_recent_change
              */
             queryRecentChange(query?: QueryRecentChangeQuery): Promise<QueryRecentChangeResponse>;
+            /**
+             * 查询指定时间范围地点版本
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/location/query_multi_timeline
+             */
+            queryMultiTimeline(body: QueryMultiTimelineRequest): Promise<QueryMultiTimelineResponse>;
             /**
              * 通过地点 ID 批量获取地点信息
              * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/location/batch_get
@@ -2716,6 +2844,20 @@ export declare namespace Corehr {
             /** 删除的地点 ID 列表 */
             deleted_location_ids?: string[];
         }
+        interface QueryMultiTimelineRequest {
+            /** 地点 ID 列表 */
+            location_ids: string[];
+            /** 查询开始时间（包含） */
+            start_date?: string;
+            /** 查询结束时间(包含) */
+            end_date?: string;
+            /** 返回数据的字段列表，可选["location_name", "code", "active", "parent_location_id", "description", "effective_date"] */
+            fields?: string[];
+        }
+        interface QueryMultiTimelineResponse {
+            /** 地点信息 */
+            items?: Lark.LocationTimeline[];
+        }
         interface BatchGetRequest {
             /** 地点 ID 列表 */
             location_ids: string[];
@@ -2865,6 +3007,11 @@ export declare namespace Corehr {
              * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list
              */
             list(query?: Pagination): Paginated<Lark.Company>;
+            /**
+             * 查询指定时间范围公司版本
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/company/query_multi_timeline
+             */
+            queryMultiTimeline(body: QueryMultiTimelineRequest): Promise<QueryMultiTimelineResponse>;
             /**
              * 查询当前生效信息变更公司
              * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/company/query_recent_change
@@ -2975,6 +3122,20 @@ export declare namespace Corehr {
             /** 公司信息 */
             company?: Lark.Company;
         }
+        interface QueryMultiTimelineRequest {
+            /** 公司 ID 列表 */
+            company_ids: string[];
+            /** 查询开始时间（包含） */
+            start_date?: string;
+            /** 查询结束时间(包含) */
+            end_date?: string;
+            /** 返回数据的字段列表，可选["company_name", "code", "active", "description", "effective_date", "expiration_date"] */
+            fields?: string[];
+        }
+        interface QueryMultiTimelineResponse {
+            /** 公司信息 */
+            items?: Lark.CompanyTimeline[];
+        }
         interface QueryRecentChangeQuery extends Pagination {
             /** 查询的开始时间，支持"yyyy-MM-dd HH:MM:SS" */
             start_date: string;
@@ -4406,6 +4567,11 @@ export declare namespace Corehr {
     namespace Probation {
         interface Methods {
             assessment: Assessment.Methods;
+            /**
+             * 编辑试用期
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/probation/edit
+             */
+            edit(body: EditRequest, query?: EditQuery): Promise<void>;
             /**
              * 启用/停用试用期考核功能
              * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/probation/enable_disable_assessment
@@ -4427,6 +4593,34 @@ export declare namespace Corehr {
              */
             withdraw(body: WithdrawRequest, query?: WithdrawQuery): Promise<void>;
         }
+        interface EditRequest {
+            /** 试用期人员的雇佣 ID */
+            employment_id: string;
+            /** 试用期开始日期，格式："YYYY-MM-DD"，填写时满足以下规则 - 「试用期开始日期」和「试用期预计结束日期」需要一同填写。 - 若该员工存在试用期记录，且同时填写「试用期开始日期」和「试用期预计结束日期」为空串，则删除该试用期记录。 - 若该员工不存在试用期记录，且填写「试用期开始日期」和「试用期预计结束日期」，则新增试用期记录。 - 若该员工不存在试用期记录，且未填写「试用期开始日期」和「试用期预计结束日期」，则试用期记录不会创建，其他写入数据不会生效。 - 入职日期 <= 试用期开始日期 <= 试用期预计结束日期 */
+            probation_start_date?: string;
+            /** 试用期预计结束日期，格式："YYYY-MM-DD"，填写时满足以下规则 - 「试用期开始日期」和「试用期预计结束日期」需要一同填写。 - 若该员工存在试用期记录，且同时填写「试用期开始日期」和「试用期预计结束日期」为空串，则删除该试用期记录。 - 若该员工不存在试用期记录，且填写「试用期开始日期」和「试用期预计结束日期」，则新增试用期记录。 - 若该员工不存在试用期记录，且未填写「试用期开始日期」和「试用期预计结束日期」，则试用期记录不会创建，其他写入数据不会生效。 - 试用期开始日期 <= 试用期预计结束日期 */
+            probation_expected_end_date?: string;
+            /** 试用期结果，填写时满足以下规则 - 填写「通过」时，必填「试用期实际结束日期」。 - 填写「延长」时，「延长后试用期预计结束日期」和「试用期预计延长时长」至少填写一项。 */
+            probation_outcome?: 'passed' | 'failed' | 'delayed';
+            /** 试用期实际结束日期，格式："YYYY-MM-DD"，填写时满足以下规则 - 需同时指定试用期结果为「通过」。 - 在试用期结果为空时，填写后将自动赋值试用期结果为「通过」。 - 试用期开始时间 <= 试用期实际结束日期 <= 试用期预计结束日期。 */
+            actual_probation_end_date?: string;
+            /** 延长后试用期预计结束日期，格式："YYYY-MM-DD"，填写时满足以下规则 - 需同时指定「试用期结果」为「延期」。 - 若同时填写「试用期预计延长时长」，需保持两者数据一致。 - 延长后试用期预计结束日期 > 试用期预计结束日期。 */
+            probation_extend_expected_end_date?: string;
+            /** 试用期预计延长时长，填写时满足以下规则 - 需同时指定「试用期结果」为「延期」。 - 填写时需要指定「试用期延长时长单位」。 - 若同时填写「延长后试用期预计结束日期」，需保持两者数据一致。 - 试用期预计延长时长 > 0。 */
+            extended_probation_period_duration?: number;
+            /** 试用期延长时长单位，填写时满足以下规则 - 需要和「试用期预计延长时长」一同填写。 - 需同时指定「试用期结果」为「延期」。 */
+            extended_probation_period_unit?: 'day' | 'week' | 'month';
+            /** 备注 */
+            notes?: string;
+            /** 员工自评 */
+            self_review?: string;
+            /** 自定义字段（当前不支持附件类型字段写入） */
+            custom_fields?: Lark.CustomFieldData[];
+        }
+        interface EditQuery {
+            /** 用户 ID 类型 */
+            user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
+        }
         interface EnableDisableAssessmentRequest {
             /** 启用 / 停用状态。启用后可在试用期管理页面中可见试用期考核相关的字段。 */
             active: boolean;
@@ -6028,6 +6222,35 @@ export declare namespace Corehr {
             }
         }
     }
+    namespace ProcessStart {
+        interface Methods {
+            /**
+             * 发起流程
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/process_start/create
+             */
+            create(body: CreateRequest, query?: CreateQuery): Promise<CreateResponse>;
+        }
+        interface CreateRequest {
+            /** 流程定义ID */
+            flow_definition_id: string;
+            /** 发起人用户ID，按user_id_type类型传递。如果system_initiator为false，则必填；为true时非必填。 */
+            initiator_id?: string;
+            /** 是否为系统身份发起流程。 true - 使用系统身份发起，若使用系统身份；false - 按照所传的人员身份审批 */
+            system_initiator?: boolean;
+            /** 业务数据 */
+            flow_data?: Lark.ProcessFormVariableV2[];
+        }
+        interface CreateQuery {
+            /** 用户 ID 类型 */
+            user_id_type?: 'open_id' | 'union_id' | 'user_id' | 'people_corehr_id';
+            /** 此次调用中使用的部门 ID 类型 */
+            department_id_type?: 'open_department_id' | 'department_id' | 'people_corehr_department_id';
+        }
+        interface CreateResponse {
+            /** 流程实例id */
+            process_id?: string;
+        }
+    }
     namespace ProcessRevoke {
         interface Methods {
             /**

package/lib/types/drive.d.ts

@@ -12,7 +12,9 @@ export declare namespace Drive {
         importTask: ImportTask.Methods;
         exportTask: ExportTask.Methods;
         media: Media.Methods;
+        user: User.Methods;
         permission: Permission.Methods;
+        commentReaction: CommentReaction.Methods;
     }
     namespace File {
         interface Methods {
@@ -545,6 +547,11 @@ export declare namespace Drive {
             }
             namespace Reply {
                 interface Methods {
+                    /**
+                     * 添加回复
+                     * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment-reply/create
+                     */
+                    create(file_token: string, comment_id: string, body: CreateRequest, query?: CreateQuery): Promise<CreateResponse>;
                     /**
                      * 获取回复信息
                      * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment-reply/list
@@ -561,6 +568,32 @@ export declare namespace Drive {
                      */
                     delete(file_token: string, comment_id: string, reply_id: string, query?: DeleteQuery): Promise<void>;
                 }
+                interface CreateRequest {
+                    /** 回复内容 */
+                    content: Lark.ReplyContent;
+                }
+                interface CreateQuery {
+                    /** 文档类型 */
+                    file_type: 'doc' | 'sheet' | 'file' | 'docx';
+                    /** 此次调用中使用的用户ID的类型 */
+                    user_id_type?: 'user_id' | 'union_id' | 'open_id';
+                }
+                interface CreateResponse {
+                    /** 回复内容 */
+                    content: Lark.ReplyContent;
+                    /** 回复 ID */
+                    reply_id?: string;
+                    /** 用户 ID */
+                    user_id?: string;
+                    /** 创建时间 */
+                    create_time?: number;
+                    /** 更新时间 */
+                    update_time?: number;
+                    /** 回复的其他内容，图片 Token 等 */
+                    extra?: Lark.ReplyExtra;
+                    /** 评论回复卡片上对应的表情回复信息 */
+                    reactions?: Lark.FileCommentV2BatchQueryReactionData[];
+                }
                 interface ListQuery extends Pagination {
                     /** 文档类型 */
                     file_type: 'doc' | 'sheet' | 'file' | 'docx';
@@ -859,6 +892,41 @@ export declare namespace Drive {
             tmp_download_urls?: Lark.TmpDownloadUrl[];
         }
     }
+    namespace User {
+        interface Methods {
+            /**
+             * 订阅用户云文档事件
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/user/subscription
+             */
+            subscription(body: SubscriptionRequest): Promise<void>;
+            /**
+             * 取消用户云文档事件订阅
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/user/remove_subscription
+             */
+            removeSubscription(query?: RemoveSubscriptionQuery): Promise<void>;
+            /**
+             * 查询用户云文档事件订阅状态
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/user/subscription_status
+             */
+            subscriptionStatus(query?: SubscriptionStatusQuery): Promise<SubscriptionStatusResponse>;
+        }
+        interface SubscriptionRequest {
+            /** 事件类型 */
+            event_type: string;
+        }
+        interface RemoveSubscriptionQuery {
+            /** 事件类型 */
+            event_type: string;
+        }
+        interface SubscriptionStatusQuery {
+            /** 事件类型 */
+            event_type: string;
+        }
+        interface SubscriptionStatusResponse {
+            /** 订阅状态 */
+            data: string;
+        }
+    }
     namespace Permission {
         interface Methods {
             member: Member.Methods;
@@ -1112,4 +1180,25 @@ export declare namespace Drive {
             }
         }
     }
+    namespace CommentReaction {
+        interface Methods {
+            /**
+             * 添加/取消表情回应
+             * @see https://open.feishu.cn/document/ukTMukTMukTM/uIzNzUjLyczM14iM3MTN/drive-v2/comment_reaction/update_reaction
+             */
+            updateReaction(file_token: string, body: UpdateReactionRequest, query?: UpdateReactionQuery): Promise<void>;
+        }
+        interface UpdateReactionRequest {
+            /** 操作类型: add/delete */
+            action: 'add' | 'delete';
+            /** 回复 ID */
+            reply_id: string;
+            /** reaction 类型 */
+            reaction_type: string;
+        }
+        interface UpdateReactionQuery {
+            /** 文件类型，用于区分不同类型的云文档，可选值需参考开放平台文件类型枚举规范。 */
+            file_type: string;
+        }
+    }
 }

package/lib/types/im.d.ts

@@ -61,7 +61,7 @@ export declare namespace Im {
              */
             pushFollowUp(message_id: string, body: PushFollowUpRequest): Promise<void>;
             /**
-             * 查询消息已读信息
+             * 消息发送者查询消息已读状态
              * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/read_users
              */
             readUsers(message_id: string, query?: ReadUsersQuery): Paginated<Lark.ReadUser>;
@@ -372,6 +372,11 @@ export declare namespace Im {
                  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/list
                  */
                 list(message_id: string, query?: ListQuery): Paginated<Lark.MessageReaction>;
+                /**
+                 * 批量获取消息表情回复
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/batch_query
+                 */
+                batchQuery(body: BatchQueryRequest, query?: BatchQueryQuery): Promise<BatchQueryResponse>;
                 /**
                  * 删除消息表情回复
                  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/delete
@@ -401,6 +406,26 @@ export declare namespace Im {
                 /** 当操作人为用户时返回用户ID的类型 */
                 user_id_type?: 'open_id' | 'union_id' | 'user_id';
             }
+            interface BatchQueryRequest {
+                /** 要查询的消息 */
+                queries: Lark.MessageQuery[];
+                /** 每个消息最多返回多少个表情 */
+                page_size_per_message?: number;
+                /** 表情类型 */
+                reaction_type?: string;
+            }
+            interface BatchQueryQuery {
+                /** 用户 ID 类型，控制接口返回值中表情添加者的ID */
+                user_id_type?: 'user_id' | 'union_id' | 'open_id';
+            }
+            interface BatchQueryResponse {
+                /** 成功获取到的表情列表 */
+                success_msg_reaction_details?: Lark.SuccessMsgReactionDetails[];
+                /** 成功获取到的表情数量统计 */
+                success_msg_reaction_counts?: Lark.SuccessMsgReactionCount[];
+                /** 未成功获取的消息 */
+                fail_msg_reaction_details?: Lark.FailMsgReactionDetails[];
+            }
             interface DeleteResponse {
                 /** reaction资源ID */
                 reaction_id?: string;