@satorijs/adapter-lark 3.11.8 → 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/aily.d.ts

@@ -62,17 +62,17 @@ export declare namespace Aily {
         namespace AilyMessage {
             interface Methods {
                 /**
-                 * 发送智能伙伴消息
+                 * 发送 Aily 消息
                  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/aily-v1/aily_session-aily_message/create
                  */
                 create(aily_session_id: string, body: CreateRequest): Promise<CreateResponse>;
                 /**
-                 * 获取智能伙伴消息
+                 * 获取 Aily 消息
                  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/aily-v1/aily_session-aily_message/get
                  */
                 get(aily_session_id: string, aily_message_id: string): Promise<GetResponse>;
                 /**
-                 * 列出智能伙伴消息
+                 * 列出 Aily 消息
                  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/aily-v1/aily_session-aily_message/list
                  */
                 list(aily_session_id: string, query?: ListQuery): Paginated<Lark.AilyMessage, 'messages'>;

package/lib/types/apaas.d.ts

@@ -7,12 +7,23 @@ declare module '../internal' {
 }
 export declare namespace Apaas {
     interface Methods {
+        app: App.Methods;
         seatAssignment: SeatAssignment.Methods;
         seatActivity: SeatActivity.Methods;
         application: Application.Methods;
         userTask: UserTask.Methods;
         approvalTask: ApprovalTask.Methods;
         approvalInstance: ApprovalInstance.Methods;
+        workspace: Workspace.Methods;
+    }
+    namespace App {
+        interface Methods {
+            /**
+             * 查看应用基本信息
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/app/list
+             */
+            list(query?: Pagination): Paginated<Lark.App>;
+        }
     }
     namespace SeatAssignment {
         interface Methods {
@@ -43,8 +54,8 @@ export declare namespace Apaas {
     namespace Application {
         interface Methods {
             auditLog: AuditLog.Methods;
-            role: Role.Methods;
             recordPermission: RecordPermission.Methods;
+            role: Role.Methods;
             object: Object.Methods;
             function: Function.Methods;
             environmentVariable: EnvironmentVariable.Methods;
@@ -150,6 +161,33 @@ export declare namespace Apaas {
                 data?: Lark.AuditLogDetail;
             }
         }
+        namespace RecordPermission {
+            interface Methods {
+                member: Member.Methods;
+            }
+            namespace Member {
+                interface Methods {
+                    /**
+                     * 批量删除记录权限用户授权
+                     * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/application-record_permission-member/batch_remove_authorization
+                     */
+                    batchRemoveAuthorization(namespace: string, record_permission_api_name: string, body: BatchRemoveAuthorizationRequest): Promise<void>;
+                    /**
+                     * 批量创建记录权限用户授权
+                     * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/application-record_permission-member/batch_create_authorization
+                     */
+                    batchCreateAuthorization(namespace: string, record_permission_api_name: string, body: BatchCreateAuthorizationRequest): Promise<void>;
+                }
+                interface BatchRemoveAuthorizationRequest {
+                    /** 需要删除的用户 ID 列表 */
+                    user_ids?: string[];
+                }
+                interface BatchCreateAuthorizationRequest {
+                    /** 需要新增的用户 ID 列表 */
+                    user_ids?: string[];
+                }
+            }
+        }
         namespace Role {
             interface Methods {
                 member: Member.Methods;
@@ -196,33 +234,6 @@ export declare namespace Apaas {
                 }
             }
         }
-        namespace RecordPermission {
-            interface Methods {
-                member: Member.Methods;
-            }
-            namespace Member {
-                interface Methods {
-                    /**
-                     * 批量删除记录权限用户授权
-                     * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/application-record_permission-member/batch_remove_authorization
-                     */
-                    batchRemoveAuthorization(namespace: string, record_permission_api_name: string, body: BatchRemoveAuthorizationRequest): Promise<void>;
-                    /**
-                     * 批量创建记录权限用户授权
-                     * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/application-record_permission-member/batch_create_authorization
-                     */
-                    batchCreateAuthorization(namespace: string, record_permission_api_name: string, body: BatchCreateAuthorizationRequest): Promise<void>;
-                }
-                interface BatchRemoveAuthorizationRequest {
-                    /** 需要删除的用户 ID 列表 */
-                    user_ids?: string[];
-                }
-                interface BatchCreateAuthorizationRequest {
-                    /** 需要新增的用户 ID 列表 */
-                    user_ids?: string[];
-                }
-            }
-        }
         namespace Object {
             interface Methods {
                 record: Record.Methods;
@@ -648,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

@@ -11,20 +11,76 @@ export declare namespace Board {
     namespace Whiteboard {
         interface Methods {
             node: Node.Methods;
+            /**
+             * 获取画板主题
+             * @see https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/board-v1/whiteboard/theme
+             */
+            theme(whiteboard_id: string): Promise<ThemeResponse>;
+            /**
+             * 更新画板主题
+             * @see https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/board-v1/whiteboard/update_theme
+             */
+            updateTheme(whiteboard_id: string, body: UpdateThemeRequest): Promise<void>;
             /**
              * 获取画板缩略图片
              * @see https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/board-v1/whiteboard/download_as_image
              */
             downloadAsImage(whiteboard_id: string): Promise<ArrayBuffer>;
         }
+        interface ThemeResponse {
+            /** 主题 */
+            theme: 'classic' | 'minimalist_gray' | 'retro' | 'vibrant_color' | 'minimalist_blue' | 'default';
+        }
+        interface UpdateThemeRequest {
+            /** 主题名称 */
+            theme?: string;
+        }
         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
+                 */
+                create(whiteboard_id: string, body: CreateRequest, query?: CreateQuery): Promise<CreateResponse>;
                 /**
                  * 获取所有节点
                  * @see https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/board-v1/whiteboard-node/list
                  */
                 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[];
+            }
+            interface CreateQuery {
+                /** 操作的唯一标识，与接口返回值的 client_token 相对应，用于幂等的进行更新操作。此值为空表示将发起一次新的请求，此值非空表示幂等的进行更新操作 */
+                client_token?: string;
+                /** 此次调用中使用的用户ID的类型 */
+                user_id_type?: 'user_id' | 'union_id' | 'open_id';
+            }
+            interface CreateResponse {
+                /** 所创建的节点 id 列表 */
+                ids: string[];
+                /** 操作的唯一标识，更新请求中使用此值表示幂等的进行此次更新 */
+                client_token?: string;
+            }
             interface ListResponse {
                 /** 查询结果 */
                 nodes?: Lark.WhiteboardNode[];