@satorijs/adapter-lark 3.11.9 → 3.12.0

package/lib/types/acs.d.ts

@@ -197,7 +197,10 @@ export declare namespace Acs {
         interface ListQuery extends Pagination {
             /** 记录开始时间，单位秒 */
             from: number;
-            /** 记录结束时间，单位秒，时间跨度不能超过30天 */
+            /**
+             * 记录结束时间，单位秒，
+             * 时间跨度不能超过30天
+             */
             to: number;
             /** 门禁设备 ID */
             device_id?: string;

package/lib/types/apaas.d.ts

@@ -14,6 +14,7 @@ export declare namespace Apaas {
         userTask: UserTask.Methods;
         approvalTask: ApprovalTask.Methods;
         approvalInstance: ApprovalInstance.Methods;
+        workspace: Workspace.Methods;
     }
     namespace App {
         interface Methods {
@@ -658,4 +659,155 @@ export declare namespace Apaas {
             opinion: string;
         }
     }
+    namespace Workspace {
+        interface Methods {
+            table: Table.Methods;
+            view: View.Methods;
+            /**
+             * 执行SQL
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/workspace/sql_commands
+             */
+            sqlCommands(workspace_id: string, body: SqlCommandsRequest): Promise<SqlCommandsResponse>;
+        }
+        interface SqlCommandsRequest {
+            /** 要执行的 SQL 语句 */
+            sql: string;
+        }
+        interface SqlCommandsResponse {
+            /** 如果是 SELECT 命令，返回的是查询结果的 JSON 序列化字符串。如果是其他无返回的命令，如 DELETE 等，result 为空。 */
+            result: string;
+        }
+        namespace Table {
+            interface Methods {
+                /**
+                 * 查询数据表数据记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/workspace-table/records_get
+                 */
+                recordsGet(workspace_id: string, table_name: string, query?: RecordsGetQuery): Promise<RecordsGetResponse>;
+                /**
+                 * 向数据表中添加或更新记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/workspace-table/records_post
+                 */
+                recordsPost(workspace_id: string, table_name: string, body: RecordsPostRequest, query?: RecordsPostQuery): Promise<RecordsPostResponse>;
+                /**
+                 * 按条件更新数据表中的记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/workspace-table/records_patch
+                 */
+                recordsPatch(workspace_id: string, table_name: string, body: RecordsPatchRequest, query?: RecordsPatchQuery): Promise<RecordsPatchResponse>;
+                /**
+                 * 批量更新数据表中的记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/workspace-table/records_batch_update
+                 */
+                recordsBatchUpdate(workspace_id: string, table_name: string, body: RecordsBatchUpdateRequest): Promise<RecordsBatchUpdateResponse>;
+                /**
+                 * 删除数据表中的记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/workspace-table/records_delete
+                 */
+                recordsDelete(workspace_id: string, table_name: string, query?: RecordsDeleteQuery): Promise<void>;
+            }
+            interface RecordsGetQuery extends Pagination {
+                /**
+                 * 返回的列，默认为 *，即返回所有列。
+                 * 遵循 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#vertical-filtering
+                 */
+                select?: string;
+                /** 筛选条件，尊许 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#horizontal-filtering */
+                filter?: string;
+                /**
+                 * 排序条件，如果没指定 asc/desc，默认为 asc，null 值可排在最前或最后。
+                 * 尊许 PostgREST 语法，详情可查看
+                 * https://docs.postgrest.org/en/v13/references/api/tables_views.html#ordering
+                 */
+                order?: string;
+            }
+            interface RecordsGetResponse {
+                /** 是否还有更多项 */
+                has_more: boolean;
+                /** 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token */
+                page_token: string;
+                /** 符合条件的记录总数 */
+                total: number;
+                /** 数据记录列表，格式为数组序列化后的 JSONString */
+                items: string;
+            }
+            interface RecordsPostRequest {
+                /** 要插入的数据记录列表，单次支持最多 500 条 */
+                records: string;
+            }
+            interface RecordsPostQuery {
+                /** UPSERT 时使用，指定列，多列英文逗号拼接 */
+                columns?: string;
+                /**
+                 * UPSERT 时使用，指定使用哪一个或多个具有唯一约束的字段作为冲突判断依据，默认为表主键。
+                 * 假设 user_products 表有一个由 user_id 和 product_id 组成的复合唯一约束。
+                 */
+                on_conflict?: string;
+            }
+            interface RecordsPostResponse {
+                /** 按照记录顺序创建或更新的记录 ID 列表 */
+                record_ids: Lark.Uuid[];
+            }
+            interface RecordsPatchRequest {
+                /** 要更新的数据记录信息 */
+                record: string;
+            }
+            interface RecordsPatchQuery {
+                /** 筛选条件，尊许 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#horizontal-filtering */
+                filter: string;
+            }
+            interface RecordsPatchResponse {
+                /** 更新的记录唯一ID列表 */
+                record_ids: Lark.Uuid[];
+            }
+            interface RecordsBatchUpdateRequest {
+                /** 要更新的数据记录列表，单次支持最多 500条，每行 record 都必须包含主键 _id，且不同行要更新的字段需保持一致 */
+                records: string;
+            }
+            interface RecordsBatchUpdateResponse {
+                /** 更新的记录唯一ID列表 */
+                record_ids: Lark.Uuid[];
+            }
+            interface RecordsDeleteQuery {
+                /**
+                 * 筛选条件，尊许 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#horizontal-filtering
+                 * 此处用法和查询数据记录一致
+                 */
+                filter: string;
+            }
+        }
+        namespace View {
+            interface Methods {
+                /**
+                 * 查询视图数据记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/workspace-view/views_get
+                 */
+                viewsGet(workspace_id: string, view_name: string, query?: ViewsGetQuery): Promise<ViewsGetResponse>;
+            }
+            interface ViewsGetQuery extends Pagination {
+                /**
+                 * 返回的列，默认为 *，即返回所有列。
+                 * 遵循 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#vertical-filtering
+                 */
+                select?: string;
+                /** 筛选条件，尊许 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#horizontal-filtering */
+                filter?: string;
+                /**
+                 * 排序条件，如果没指定 asc/desc，默认为 asc，null 值可排在最前或最后。
+                 * 尊许 PostgREST 语法，详情可查看
+                 * https://docs.postgrest.org/en/v13/references/api/tables_views.html#ordering
+                 */
+                order?: string;
+            }
+            interface ViewsGetResponse {
+                /** 是否还有更多项 */
+                has_more: boolean;
+                /** 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token */
+                page_token: string;
+                /** 符合条件的记录总数 */
+                total: number;
+                /** 数据记录列表，格式为数组序列化后的 JSONString */
+                items: string;
+            }
+        }
+    }
 }

package/lib/types/application.d.ts

@@ -428,7 +428,12 @@ export declare namespace Application {
             date: string;
             /** 活跃周期的统计类型 */
             cycle_type: DepartmentOverviewRequestCycleType;
-            /** 查询的部门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。- 若不填写则返回整个租户的数据 */
+            /**
+             * 查询的部门id，获取方法可参考[部门ID概述](https://open.feishu.cn/document/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。 */
             recursion?: number;
@@ -454,7 +459,11 @@ export declare namespace Application {
             date: string;
             /** 枚举值：day，week，month；week指自然周，返回当前日期所在周的数据；不满一周则从周一到当前日期算。month指自然月，返回当前日期所在月的数据。 */
             cycle_type: MessagePushOverviewRequestCycleType;
-            /** 需要查询的部门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。返回当前部门的使用数据； 若不填写，则返回当前租户的使用数据 */
+            /**
+             * 需要查询的部门id，获取方法可参考[部门ID概述](https://open.feishu.cn/document/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;
         }
         interface MessagePushOverviewQuery {
@@ -478,7 +487,11 @@ export declare namespace Application {
             date: string;
             /** 活跃周期的统计类型 */
             cycle_type: OverviewRequestCycleType;
-            /** 查询的部门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。 */
+            /**
+             * 查询的部门id，获取方法可参考[部门ID概述](https://open.feishu.cn/document/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;
             /** 能力类型，按能力类型进行筛选，返回对应能力的活跃数据 */
             ability: 'app' | 'mp' | 'h5' | 'bot';
@@ -541,7 +554,10 @@ export declare namespace Application {
         interface ListQuery extends Pagination {
             /** 查询的起始日期，格式为yyyy-mm-dd。不填则默认为当前日期减去180天。 */
             from_date?: string;
-            /** 查询的结束日期，格式为yyyy-mm-dd。不填默认为当前日期。只能查询 180 天内的数据。 */
+            /**
+             * 查询的结束日期，格式为yyyy-mm-dd。不填默认为当前日期。
+             * 只能查询 180 天内的数据。
+             */
             to_date?: string;
             /** 反馈类型，不填写则表示查询所有反馈类型。 */
             feedback_type?: ListQueryFeedbackType;

package/lib/types/approval.d.ts

@@ -121,11 +121,6 @@ export declare namespace Approval {
              * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/get
              */
             get(instance_id: string, query?: GetQuery): Promise<GetResponse>;
-            /**
-             * 批量获取审批实例 ID
-             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/list
-             */
-            list(query?: ListQuery): Paginated<string, 'instance_code_list'>;
             /**
              * 退回审批任务
              * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/specified_rollback
@@ -293,14 +288,6 @@ export declare namespace Approval {
             /** 审批实例 Code */
             instance_code: string;
         }
-        interface ListQuery extends Pagination {
-            /** 审批定义唯一标识 */
-            approval_code: string;
-            /** 审批实例创建时间区间（毫秒） */
-            start_time: string;
-            /** 审批实例创建时间区间（毫秒） */
-            end_time: string;
-        }
         interface SpecifiedRollbackRequest {
             /** 用户ID */
             user_id: string;

package/lib/types/attendance.d.ts

@@ -210,7 +210,7 @@ export declare namespace Attendance {
         interface BatchCreateRequest {
             /** 班表信息列表 */
             user_daily_shifts: Lark.UserDailyShift[];
-            /** 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 */
+            /** 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 */
             operator_id?: string;
         }
         interface BatchCreateQuery {
@@ -296,7 +296,7 @@ export declare namespace Attendance {
         interface CreateRequest {
             /** 6921319402260496386 */
             group: Lark.Group;
-            /** 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 */
+            /** 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 */
             operator_id?: string;
         }
         interface CreateQuery {
@@ -607,9 +607,15 @@ export declare namespace Attendance {
             stats_type: 'daily' | 'month';
             /** 开始时间 */
             start_date: number;
-            /** 结束时间（时间间隔不超过 40 天） */
+            /**
+             * 结束时间
+             * （时间间隔不超过 40 天）
+             */
             end_date: number;
-            /** 查询的用户 ID 列表（用户数量不超过 200） */
+            /**
+             * 查询的用户 ID 列表
+             * （用户数量不超过 200）
+             */
             user_ids?: string[];
             /** 是否需要历史数据 */
             need_history?: boolean;
@@ -700,7 +706,7 @@ export declare namespace Attendance {
             process(body: ProcessRequest): Promise<ProcessResponse>;
         }
         interface ProcessRequest {
-            /** 审批实例 ID，获取方式：1）[获取审批通过数据](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/query) 2）[写入审批结果](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/create) 3）[通知补卡审批发起（补卡情况下）](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task_remedy/create) */
+            /** 审批实例 ID，获取方式：1）[获取审批通过数据](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/query) 2）[写入审批结果](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/create) 3）[通知补卡审批发起（补卡情况下）](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task_remedy/create) */
             approval_id: string;
             /** 审批类型，leave：请假，out：外出，overtime：加班，trip：出差，remedy：补卡 */
             approval_type: string;

package/lib/types/authen.d.ts

@@ -94,7 +94,10 @@ export declare namespace Authen {
             interface CreateRequest {
                 /** 授权类型，**固定值**： */
                 grant_type: string;
-                /** 刷新 `user_access_token` 需要的凭证<br>获取user_access_token`接口和本接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`** */
+                /**
+                 * 刷新 `user_access_token` 需要的凭证
+                 * 获取user_access_token`接口和本接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`**
+                 */
                 refresh_token: string;
             }
             interface CreateResponse {
@@ -179,7 +182,10 @@ export declare namespace Authen {
         interface CreateRequest {
             /** 授权类型，**固定值**： */
             grant_type: string;
-            /** 刷新 `user_access_token` 需要的凭证<br>获取user_access_token`接口和本接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`** */
+            /**
+             * 刷新 `user_access_token` 需要的凭证
+             * 获取user_access_token`接口和本接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`**
+             */
             refresh_token: string;
         }
         interface CreateResponse {

package/lib/types/bitable.d.ts

@@ -402,15 +402,36 @@ export declare namespace Bitable {
                     record?: Lark.AppTableRecord;
                 }
                 interface ListQuery extends Pagination {
-                    /** 视图 id注意：如 filter 或 sort 有值，view_id 会被忽略。 */
+                    /**
+                     * 视图 id
+                     * 注意：如 filter 或 sort 有值，view_id 会被忽略。
+                     */
                     view_id?: string;
-                    /** 筛选参数注意：1.筛选记录的表达式不超过2000个字符。2.不支持对“人员”以及“关联字段”的属性进行过滤筛选，如人员的 OpenID。3.仅支持字段在页面展示字符值进行筛选。详细请参考[记录筛选开发指南](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/filter) */
+                    /**
+                     * 筛选参数
+                     * 注意：
+                     * 1.筛选记录的表达式不超过2000个字符。
+                     * 2.不支持对“人员”以及“关联字段”的属性进行过滤筛选，如人员的 OpenID。
+                     * 3.仅支持字段在页面展示字符值进行筛选。
+                     * 详细请参考[记录筛选开发指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/filter)
+                     */
                     filter?: string;
-                    /** 排序参数注意：1.表达式需要不超过1000字符。2.不支持对带“公式”和“关联字段”的表的使用。3.使用引号将字段名称和顺序逆序连接起来。 */
+                    /**
+                     * 排序参数
+                     * 注意：
+                     * 1.表达式需要不超过1000字符。
+                     * 2.不支持对带“公式”和“关联字段”的表的使用。
+                     * 3.使用引号将字段名称和顺序逆序连接起来。
+                     */
                     sort?: string;
                     /** 字段名称 */
                     field_names?: string;
-                    /** 控制多行文本字段数据的返回格式，true 表示以数组形式返回。注意：1.多行文本中如果有超链接部分，则会返回链接的 URL。2.目前可以返回多行文本中 URL 类型为多维表格链接、飞书 doc、飞书 sheet的URL类型以及@人员的数据结构。 */
+                    /**
+                     * 控制多行文本字段数据的返回格式，true 表示以数组形式返回。
+                     * 注意：
+                     * 1.多行文本中如果有超链接部分，则会返回链接的 URL。
+                     * 2.目前可以返回多行文本中 URL 类型为多维表格链接、飞书 doc、飞书 sheet的URL类型以及@人员的数据结构。
+                     */
                     text_field_as_array?: boolean;
                     /** 此次调用中使用的用户ID的类型 */
                     user_id_type?: 'user_id' | 'union_id' | 'open_id';

package/lib/types/board.d.ts

@@ -37,6 +37,11 @@ export declare namespace Board {
         }
         namespace Node {
             interface Methods {
+                /**
+                 * 解析画板语法
+                 * @see https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/board-v1/whiteboard-node/create_plantuml
+                 */
+                createPlantuml(whiteboard_id: string, body: CreatePlantumlRequest): Promise<CreatePlantumlResponse>;
                 /**
                  * 创建节点
                  * @see https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/board-v1/whiteboard-node/create
@@ -48,6 +53,18 @@ export declare namespace Board {
                  */
                 list(whiteboard_id: string): Promise<ListResponse>;
             }
+            interface CreatePlantumlRequest {
+                /** plant uml 代码 */
+                plant_uml_code: string;
+                style_type?: Lark.StyleType;
+                /** 语法类型 */
+                syntax_type?: Lark.SyntaxType;
+                diagram_type?: Lark.DiagramType;
+            }
+            interface CreatePlantumlResponse {
+                /** 创建生成的plant uml节点id */
+                node_id?: string;
+            }
             interface CreateRequest {
                 /** 子节点数据 */
                 nodes?: Lark.WhiteboardNode[];

package/lib/types/calendar.d.ts

@@ -207,7 +207,7 @@ export declare namespace Calendar {
             time_min: string;
             /** 查询时段结束时间，需要url编码 */
             time_max: string;
-            /** 用户user_id，输入时与 room_id 二选一。参见[用户相关的 ID 概念](/ssl:ttdoc/home/user-identity-introduction/introduction) */
+            /** 用户user_id，输入时与 room_id 二选一。参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) */
             user_id?: string;
             /** 会议室room_id，输入时与 user_id 二选一 */
             room_id?: string;
@@ -574,7 +574,10 @@ export declare namespace Calendar {
                 list(calendar_id: string, event_id: string, query?: ListQuery): Paginated<Lark.CalendarEventAttendee>;
             }
             interface CreateRequest {
-                /** 新增参与人列表；<br>- 单次请求会议室的数量限制为100。 */
+                /**
+                 * 新增参与人列表；
+                 * - 单次请求会议室的数量限制为100。
+                 */
                 attendees?: Lark.CalendarEventAttendee[];
                 /** 是否给参与人发送bot通知 默认为true */
                 need_notification?: boolean;
@@ -594,7 +597,7 @@ export declare namespace Calendar {
                 attendees?: Lark.CalendarEventAttendee[];
             }
             interface BatchDeleteRequest {
-                /** 要移除的参与人 ID 列表。参见[参与人ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) */
+                /** 要移除的参与人 ID 列表。参见[参与人ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) */
                 attendee_ids?: string[];
                 /** 需要删除的参与人类型实体ID，作为attendee_ids字段的补充。 */
                 delete_ids?: Lark.CalendarEventAttendeeId[];
@@ -654,7 +657,11 @@ export declare namespace Calendar {
             end_time: string;
             /** 休假日程标题，可自定义例如："请假中(全天) / 1-Day Time Off"，"请假中(半天) / 0.5-Day Time Off"，"长期休假中 / Leave of Absence"，"请假中" */
             title?: string;
-            /** 休假日程描述，可自定义,例如："若拒绝或删除此日程，飞书中相应的“请假”标签将自动消失，而请假系统中的休假申请不会被撤销。If the event is rejected or deleted, corresponding "On Leave" tag in Feishu will disappear, while the leave request in the time off system will not be revoked." */
+            /**
+             * 休假日程描述，可自定义,例如：
+             * "若拒绝或删除此日程，飞书中相应的“请假”标签将自动消失，而请假系统中的休假申请不会被撤销。
+             * If the event is rejected or deleted, corresponding "On Leave" tag in Feishu will disappear, while the leave request in the time off system will not be revoked."
+             */
             description?: string;
         }
         interface CreateQuery {
@@ -674,7 +681,11 @@ export declare namespace Calendar {
             end_time: string;
             /** 休假日程标题，可自定义例如："请假中(全天) / 1-Day Time Off"，"请假中(半天) / 0.5-Day Time Off"，"长期休假中 / Leave of Absence"，"请假中" */
             title?: string;
-            /** 休假日程描述，可自定义,例如："若拒绝或删除此日程，飞书中相应的“请假”标签将自动消失，而请假系统中的休假申请不会被撤销。If the event is rejected or deleted, corresponding "On Leave" tag in Feishu will disappear, while the leave request in the time off system will not be revoked." */
+            /**
+             * 休假日程描述，可自定义,例如：
+             * "若拒绝或删除此日程，飞书中相应的“请假”标签将自动消失，而请假系统中的休假申请不会被撤销。
+             * If the event is rejected or deleted, corresponding "On Leave" tag in Feishu will disappear, while the leave request in the time off system will not be revoked."
+             */
             description?: string;
         }
     }

package/lib/types/contact.d.ts

@@ -172,7 +172,10 @@ export declare namespace Contact {
         interface CreateQuery {
             /** 此次调用中使用的用户ID的类型 */
             user_id_type?: 'user_id' | 'union_id' | 'open_id';
-            /** 此次调用中使用的部门ID的类型。不同 ID 的说明参见[部门ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) */
+            /**
+             * 此次调用中使用的部门ID的类型。
+             * 不同 ID 的说明参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)
+             */
             department_id_type?: 'department_id' | 'open_department_id';
             /** 用于幂等判断是否为同一请求，避免重复创建。字符串类型，自行生成。 */
             client_token?: string;
@@ -262,7 +265,10 @@ export declare namespace Contact {
         interface GetQuery {
             /** 此次调用中使用的用户ID的类型 */
             user_id_type?: 'user_id' | 'union_id' | 'open_id';
-            /** 此次调用中使用的部门ID的类型不同 ID 的说明 [部门ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) */
+            /**
+             * 此次调用中使用的部门ID的类型
+             * 不同 ID 的说明 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)
+             */
             department_id_type?: 'department_id' | 'open_department_id';
         }
         interface GetResponse {
@@ -283,15 +289,31 @@ export declare namespace Contact {
         interface FindByDepartmentQuery extends Pagination {
             /** 此次调用中使用的用户ID的类型 */
             user_id_type?: 'user_id' | 'union_id' | 'open_id';
-            /** 此次调用中使用的部门ID的类型部门ID类型的区别参见[部门ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) */
+            /**
+             * 此次调用中使用的部门ID的类型
+             * 部门ID类型的区别参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)
+             */
             department_id_type?: 'department_id' | 'open_department_id';
-            /** 填写该字段表示获取该部门下用户，必填。根部门的部门ID为0。ID值与查询参数中的department_id_type 对应。不同 ID 的说明与department_id的获取方式参见 [部门ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) */
+            /**
+             * 填写该字段表示获取该部门下用户，必填。根部门的部门ID为0。
+             * ID值与查询参数中的department_id_type 对应。
+             * 不同 ID 的说明与department_id的获取方式参见 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)
+             */
             department_id: string;
         }
         interface BatchGetIdRequest {
-            /** 要查询的用户邮箱，最多 50 条。注意，emails与mobiles相互独立，每条用户邮箱返回对应的用户ID。本接口返回的用户ID数量为emails数量与mobiles数量的和。 */
+            /**
+             * 要查询的用户邮箱，最多 50 条。
+             * 注意，emails与mobiles相互独立，每条用户邮箱返回对应的用户ID。
+             * 本接口返回的用户ID数量为emails数量与mobiles数量的和。
+             */
             emails?: string[];
-            /** 要查询的用户手机号，最多 50 条。注意1. emails与mobiles相互独立，每条用户手机号返回对应的用户ID。2.  非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码。 */
+            /**
+             * 要查询的用户手机号，最多 50 条。
+             * 注意
+             * 1. emails与mobiles相互独立，每条用户手机号返回对应的用户ID。
+             * 2.  非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码。
+             */
             mobiles?: string[];
             /** 查询结果包含离职员工，可查询离职用户的ID */
             include_resigned?: boolean;
@@ -459,7 +481,12 @@ export declare namespace Contact {
             description?: string;
             /** 用户组的类型。默认为1表示普通用户组 */
             type?: CreateRequestType;
-            /** 自定义用户组ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。自定义group_id数据校验规则：最大长度：64 字符校验规则：数字、大小写字母的组合，不能包含空格 */
+            /**
+             * 自定义用户组ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。
+             * 自定义group_id数据校验规则：
+             * 最大长度：64 字符
+             * 校验规则：数字、大小写字母的组合，不能包含空格
+             */
             group_id?: string;
         }
         interface CreateQuery {
@@ -475,7 +502,10 @@ export declare namespace Contact {
         interface PatchRequest {
             /** 用户组的名字，企业内唯一，最大长度：100 字符 */
             name?: string;
-            /** 用户组描述信息最大长度：500 字 */
+            /**
+             * 用户组描述信息
+             * 最大长度：500 字
+             */
             description?: string;
         }
         interface PatchQuery {
@@ -563,7 +593,11 @@ export declare namespace Contact {
                 results?: Lark.MemberResult[];
             }
             interface SimplelistQuery extends Pagination {
-                /** 欲获取成员ID类型。当member_type=user时候，member_id_type表示user_id_type，枚举值open_id, union_id和user_id。当member_type=department时候，member_id_type表示department_id_type，枚举值open_id和department_id。 */
+                /**
+                 * 欲获取成员ID类型。
+                 * 当member_type=user时候，member_id_type表示user_id_type，枚举值open_id, union_id和user_id。
+                 * 当member_type=department时候，member_id_type表示department_id_type，枚举值open_id和department_id。
+                 */
                 member_id_type?: 'open_id' | 'union_id' | 'user_id' | 'department_id';
                 /** 欲获取的用户组成员类型。 */
                 member_type?: 'user' | 'department';
@@ -754,7 +788,10 @@ export declare namespace Contact {
         interface CreateQuery {
             /** 此次调用中使用的用户ID的类型 */
             user_id_type?: 'user_id' | 'union_id' | 'open_id';
-            /** 此次调用中使用的部门ID的类型不同 ID 的说明参见[部门ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) */
+            /**
+             * 此次调用中使用的部门ID的类型
+             * 不同 ID 的说明参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)
+             */
             department_id_type?: 'department_id' | 'open_department_id';
             /** 用于幂等判断是否为同一请求，避免重复创建。字符串类型，自行生成。 */
             client_token?: string;
@@ -837,7 +874,10 @@ export declare namespace Contact {
         interface GetQuery {
             /** 此次调用中使用的用户ID的类型 */
             user_id_type?: 'user_id' | 'union_id' | 'open_id';
-            /** 此次调用中使用的部门ID的类型不同 ID 的说明 [部门ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) */
+            /**
+             * 此次调用中使用的部门ID的类型
+             * 不同 ID 的说明 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)
+             */
             department_id_type?: 'department_id' | 'open_department_id';
         }
         interface GetResponse {
@@ -858,7 +898,10 @@ export declare namespace Contact {
         interface ChildrenQuery extends Pagination {
             /** 此次调用中使用的用户ID的类型 */
             user_id_type?: 'user_id' | 'union_id' | 'open_id';
-            /** 此次调用中使用的部门ID的类型不同 ID 的说明与department_id的获取方式参见 [部门ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) */
+            /**
+             * 此次调用中使用的部门ID的类型
+             * 不同 ID 的说明与department_id的获取方式参见 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)
+             */
             department_id_type?: 'department_id' | 'open_department_id';
             /** 是否递归获取子部门 */
             fetch_child?: boolean;