@satorijs/adapter-lark 3.11.8 → 3.12.0

package/src/types/apaas.ts

@@ -9,12 +9,24 @@ declare module '../internal' {
 
 export namespace Apaas {
   export 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
+  }
+
+  export namespace App {
+    export interface Methods {
+      /**
+       * 查看应用基本信息
+       * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/app/list
+       */
+      list(query?: Pagination): Paginated<Lark.App>
+    }
   }
 
   export namespace SeatAssignment {
@@ -50,8 +62,8 @@ export namespace Apaas {
   export namespace Application {
     export interface Methods {
       auditLog: AuditLog.Methods
-      role: Role.Methods
       recordPermission: RecordPermission.Methods
+      role: Role.Methods
       object: Object.Methods
       function: Function.Methods
       environmentVariable: EnvironmentVariable.Methods
@@ -167,6 +179,37 @@ export namespace Apaas {
       }
     }
 
+    export namespace RecordPermission {
+      export interface Methods {
+        member: Member.Methods
+      }
+
+      export namespace Member {
+        export 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>
+        }
+
+        export interface BatchRemoveAuthorizationRequest {
+          /** 需要删除的用户 ID 列表 */
+          user_ids?: string[]
+        }
+
+        export interface BatchCreateAuthorizationRequest {
+          /** 需要新增的用户 ID 列表 */
+          user_ids?: string[]
+        }
+      }
+    }
+
     export namespace Role {
       export interface Methods {
         member: Member.Methods
@@ -219,37 +262,6 @@ export namespace Apaas {
       }
     }
 
-    export namespace RecordPermission {
-      export interface Methods {
-        member: Member.Methods
-      }
-
-      export namespace Member {
-        export 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>
-        }
-
-        export interface BatchRemoveAuthorizationRequest {
-          /** 需要删除的用户 ID 列表 */
-          user_ids?: string[]
-        }
-
-        export interface BatchCreateAuthorizationRequest {
-          /** 需要新增的用户 ID 列表 */
-          user_ids?: string[]
-        }
-      }
-    }
-
     export namespace Object {
       export interface Methods {
         record: Record.Methods
@@ -720,9 +732,181 @@ export namespace Apaas {
       opinion: string
     }
   }
+
+  export namespace Workspace {
+    export 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>
+    }
+
+    export interface SqlCommandsRequest {
+      /** 要执行的 SQL 语句 */
+      sql: string
+    }
+
+    export interface SqlCommandsResponse {
+      /** 如果是 SELECT 命令，返回的是查询结果的 JSON 序列化字符串。如果是其他无返回的命令，如 DELETE 等，result 为空。 */
+      result: string
+    }
+
+    export namespace Table {
+      export 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>
+      }
+
+      export 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
+      }
+
+      export interface RecordsGetResponse {
+        /** 是否还有更多项 */
+        has_more: boolean
+        /** 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token */
+        page_token: string
+        /** 符合条件的记录总数 */
+        total: number
+        /** 数据记录列表，格式为数组序列化后的 JSONString */
+        items: string
+      }
+
+      export interface RecordsPostRequest {
+        /** 要插入的数据记录列表，单次支持最多 500 条 */
+        records: string
+      }
+
+      export interface RecordsPostQuery {
+        /** UPSERT 时使用，指定列，多列英文逗号拼接 */
+        columns?: string
+        /**
+         * UPSERT 时使用，指定使用哪一个或多个具有唯一约束的字段作为冲突判断依据，默认为表主键。
+         * 假设 user_products 表有一个由 user_id 和 product_id 组成的复合唯一约束。
+         */
+        on_conflict?: string
+      }
+
+      export interface RecordsPostResponse {
+        /** 按照记录顺序创建或更新的记录 ID 列表 */
+        record_ids: Lark.Uuid[]
+      }
+
+      export interface RecordsPatchRequest {
+        /** 要更新的数据记录信息 */
+        record: string
+      }
+
+      export interface RecordsPatchQuery {
+        /** 筛选条件，尊许 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#horizontal-filtering */
+        filter: string
+      }
+
+      export interface RecordsPatchResponse {
+        /** 更新的记录唯一ID列表 */
+        record_ids: Lark.Uuid[]
+      }
+
+      export interface RecordsBatchUpdateRequest {
+        /** 要更新的数据记录列表，单次支持最多 500条，每行 record 都必须包含主键 _id，且不同行要更新的字段需保持一致 */
+        records: string
+      }
+
+      export interface RecordsBatchUpdateResponse {
+        /** 更新的记录唯一ID列表 */
+        record_ids: Lark.Uuid[]
+      }
+
+      export interface RecordsDeleteQuery {
+        /**
+         * 筛选条件，尊许 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#horizontal-filtering
+         * 此处用法和查询数据记录一致
+         */
+        filter: string
+      }
+    }
+
+    export namespace View {
+      export 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>
+      }
+
+      export 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
+      }
+
+      export interface ViewsGetResponse {
+        /** 是否还有更多项 */
+        has_more: boolean
+        /** 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token */
+        page_token: string
+        /** 符合条件的记录总数 */
+        total: number
+        /** 数据记录列表，格式为数组序列化后的 JSONString */
+        items: string
+      }
+    }
+  }
 }
 
 Internal.define({
+  '/apaas/v1/apps': {
+    GET: { name: 'apaas.app.list', pagination: { argIndex: 0 } },
+  },
   '/apaas/v1/seat_assignments': {
     GET: { name: 'apaas.seatAssignment.list', pagination: { argIndex: 0 } },
   },
@@ -741,6 +925,12 @@ Internal.define({
   '/apaas/v1/applications/{namespace}/audit_log/data_change_log_detail': {
     GET: 'apaas.application.auditLog.dataChangeLogDetail',
   },
+  '/apaas/v1/applications/{namespace}/record_permissions/{record_permission_api_name}/member/batch_remove_authorization': {
+    POST: 'apaas.application.recordPermission.member.batchRemoveAuthorization',
+  },
+  '/apaas/v1/applications/{namespace}/record_permissions/{record_permission_api_name}/member/batch_create_authorization': {
+    POST: 'apaas.application.recordPermission.member.batchCreateAuthorization',
+  },
   '/apaas/v1/applications/{namespace}/roles/{role_api_name}/member/batch_remove_authorization': {
     POST: 'apaas.application.role.member.batchRemoveAuthorization',
   },
@@ -750,12 +940,6 @@ Internal.define({
   '/apaas/v1/applications/{namespace}/roles/{role_api_name}/member': {
     GET: 'apaas.application.role.member.get',
   },
-  '/apaas/v1/applications/{namespace}/record_permissions/{record_permission_api_name}/member/batch_remove_authorization': {
-    POST: 'apaas.application.recordPermission.member.batchRemoveAuthorization',
-  },
-  '/apaas/v1/applications/{namespace}/record_permissions/{record_permission_api_name}/member/batch_create_authorization': {
-    POST: 'apaas.application.recordPermission.member.batchCreateAuthorization',
-  },
   '/apaas/v1/applications/{namespace}/objects/oql_query': {
     POST: 'apaas.application.object.oqlQuery',
   },
@@ -829,4 +1013,19 @@ Internal.define({
   '/apaas/v1/user_tasks/{task_id}/chat_group': {
     POST: 'apaas.userTask.chatGroup',
   },
+  '/apaas/v1/workspaces/{workspace_id}/tables/{table_name}/records': {
+    GET: 'apaas.workspace.table.recordsGet',
+    POST: 'apaas.workspace.table.recordsPost',
+    PATCH: 'apaas.workspace.table.recordsPatch',
+    DELETE: 'apaas.workspace.table.recordsDelete',
+  },
+  '/apaas/v1/workspaces/{workspace_id}/tables/{table_name}/records_batch_update': {
+    PATCH: 'apaas.workspace.table.recordsBatchUpdate',
+  },
+  '/apaas/v1/workspaces/{workspace_id}/views/{view_name}/records': {
+    GET: 'apaas.workspace.view.viewsGet',
+  },
+  '/apaas/v1/workspaces/{workspace_id}/sql_commands': {
+    POST: 'apaas.workspace.sqlCommands',
+  },
 })

package/src/types/application.ts

@@ -479,7 +479,12 @@ export 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
@@ -508,7 +513,11 @@ export 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
     }
 
@@ -536,7 +545,11 @@ export 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'
@@ -607,7 +620,10 @@ export namespace Application {
     export 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/src/types/approval.ts

@@ -129,11 +129,6 @@ export 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
@@ -314,15 +309,6 @@ export namespace Approval {
       instance_code: string
     }
 
-    export interface ListQuery extends Pagination {
-      /** 审批定义唯一标识 */
-      approval_code: string
-      /** 审批实例创建时间区间（毫秒） */
-      start_time: string
-      /** 审批实例创建时间区间（毫秒） */
-      end_time: string
-    }
-
     export interface SpecifiedRollbackRequest {
       /** 用户ID */
       user_id: string
@@ -924,7 +910,6 @@ Internal.define({
   },
   '/approval/v4/instances': {
     POST: 'approval.instance.create',
-    GET: { name: 'approval.instance.list', pagination: { argIndex: 0, itemsKey: 'instance_code_list' } },
   },
   '/approval/v4/instances/cancel': {
     POST: 'approval.instance.cancel',

package/src/types/attendance.ts

@@ -221,7 +221,7 @@ export namespace Attendance {
     export 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
     }
 
@@ -318,7 +318,7 @@ export namespace Attendance {
     export 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
     }
 
@@ -659,9 +659,15 @@ export namespace Attendance {
       stats_type: 'daily' | 'month'
       /** 开始时间 */
       start_date: number
-      /** 结束时间（时间间隔不超过 40 天） */
+      /**
+       * 结束时间
+       * （时间间隔不超过 40 天）
+       */
       end_date: number
-      /** 查询的用户 ID 列表（用户数量不超过 200） */
+      /**
+       * 查询的用户 ID 列表
+       * （用户数量不超过 200）
+       */
       user_ids?: string[]
       /** 是否需要历史数据 */
       need_history?: boolean
@@ -764,7 +770,7 @@ export namespace Attendance {
     }
 
     export 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/src/types/authen.ts

@@ -105,7 +105,10 @@ export namespace Authen {
       export 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
       }
 
@@ -196,7 +199,10 @@ export namespace Authen {
     export 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
     }
 

package/src/types/bitable.ts

@@ -454,15 +454,36 @@ export namespace Bitable {
         }
 
         export 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/src/types/board.ts

@@ -15,6 +15,16 @@ export namespace Board {
   export namespace Whiteboard {
     export 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
@@ -22,8 +32,28 @@ export namespace Board {
       downloadAsImage(whiteboard_id: string): Promise<ArrayBuffer>
     }
 
+    export interface ThemeResponse {
+      /** 主题 */
+      theme: 'classic' | 'minimalist_gray' | 'retro' | 'vibrant_color' | 'minimalist_blue' | 'default'
+    }
+
+    export interface UpdateThemeRequest {
+      /** 主题名称 */
+      theme?: string
+    }
+
     export namespace Node {
       export 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
@@ -31,6 +61,39 @@ export namespace Board {
         list(whiteboard_id: string): Promise<ListResponse>
       }
 
+      export interface CreatePlantumlRequest {
+        /** plant uml 代码 */
+        plant_uml_code: string
+        style_type?: Lark.StyleType
+        /** 语法类型 */
+        syntax_type?: Lark.SyntaxType
+        diagram_type?: Lark.DiagramType
+      }
+
+      export interface CreatePlantumlResponse {
+        /** 创建生成的plant uml节点id */
+        node_id?: string
+      }
+
+      export interface CreateRequest {
+        /** 子节点数据 */
+        nodes?: Lark.WhiteboardNode[]
+      }
+
+      export interface CreateQuery {
+        /** 操作的唯一标识，与接口返回值的 client_token 相对应，用于幂等的进行更新操作。此值为空表示将发起一次新的请求，此值非空表示幂等的进行更新操作 */
+        client_token?: string
+        /** 此次调用中使用的用户ID的类型 */
+        user_id_type?: 'user_id' | 'union_id' | 'open_id'
+      }
+
+      export interface CreateResponse {
+        /** 所创建的节点 id 列表 */
+        ids: string[]
+        /** 操作的唯一标识，更新请求中使用此值表示幂等的进行此次更新 */
+        client_token?: string
+      }
+
       export interface ListResponse {
         /** 查询结果 */
         nodes?: Lark.WhiteboardNode[]
@@ -40,10 +103,20 @@ export namespace Board {
 }
 
 Internal.define({
-  '/board/v1/whiteboards/{whiteboard_id}/nodes': {
-    GET: 'board.whiteboard.node.list',
+  '/board/v1/whiteboards/{whiteboard_id}/theme': {
+    GET: 'board.whiteboard.theme',
+  },
+  '/board/v1/whiteboards/{whiteboard_id}/update_theme': {
+    POST: 'board.whiteboard.updateTheme',
   },
   '/board/v1/whiteboards/{whiteboard_id}/download_as_image': {
     GET: { name: 'board.whiteboard.downloadAsImage', type: 'binary' },
   },
+  '/board/v1/whiteboards/{whiteboard_id}/nodes/plantuml': {
+    POST: 'board.whiteboard.node.createPlantuml',
+  },
+  '/board/v1/whiteboards/{whiteboard_id}/nodes': {
+    POST: 'board.whiteboard.node.create',
+    GET: 'board.whiteboard.node.list',
+  },
 })