@satorijs/adapter-lark 3.12.3 → 3.12.5

package/lib/types/minutes.d.ts

@@ -13,12 +13,25 @@ export declare namespace Minutes {
             media: Media.Methods;
             transcript: Transcript.Methods;
             statistics: Statistics.Methods;
+            /**
+             * 获取妙记AI产物
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/minutes-v1/minute/artifacts
+             */
+            artifacts(minute_token: string): Promise<ArtifactsResponse>;
             /**
              * 获取妙记信息
              * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/minutes-v1/minute/get
              */
             get(minute_token: string, query?: GetQuery): Promise<GetResponse>;
         }
+        interface ArtifactsResponse {
+            /** 妙记总结 */
+            summary?: string;
+            /** 妙记章节 */
+            minute_chapters?: Lark.MinuteChapter[];
+            /** 妙记待办 */
+            minute_todos?: Lark.MinuteTodo[];
+        }
         interface GetQuery {
             /** 此次调用中使用的用户ID的类型 */
             user_id_type?: 'user_id' | 'union_id' | 'open_id';

package/lib/types/performance.d.ts

@@ -13,6 +13,7 @@ export declare namespace Performance {
         additionalInformations: AdditionalInformations.Methods;
         userGroupUserRel: UserGroupUserRel.Methods;
         reviewee: Reviewee.Methods;
+        userInfo: UserInfo.Methods;
         reviewTemplate: ReviewTemplate.Methods;
         indicator: Indicator.Methods;
         question: Question.Methods;
@@ -209,6 +210,32 @@ export declare namespace Performance {
             page_token?: string;
         }
     }
+    namespace UserInfo {
+        interface Methods {
+            /**
+             * 获取绩效周期的人员信息
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/user_info/query
+             */
+            query(body: QueryRequest, query?: QueryQuery): Promise<QueryResponse>;
+        }
+        interface QueryRequest {
+            /** 评估周期 ID 列表，semester_id 可通过【获取周期】获得 */
+            semester_id: string;
+            /** 人员 ID 列表，ID 类型与user_id_type 的取值一致 */
+            user_ids: string[];
+        }
+        interface QueryQuery {
+            user_id_type?: 'user_id' | 'union_id' | 'open_id';
+            /** 指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见部门 ID 说明。 */
+            department_id_type?: string;
+        }
+        interface QueryResponse {
+            /** 评估周期 ID */
+            semester_id?: string;
+            /** 人员的快照信息列表 */
+            user_infos?: Lark.UserInfo[];
+        }
+    }
     namespace ReviewTemplate {
         interface Methods {
             /**

package/lib/types/search.d.ts

@@ -7,11 +7,43 @@ declare module '../internal' {
 }
 export declare namespace Search {
     interface Methods {
+        docWiki: DocWiki.Methods;
         message: Message.Methods;
         app: App.Methods;
         dataSource: DataSource.Methods;
         schema: Schema.Methods;
     }
+    namespace DocWiki {
+        interface Methods {
+            /**
+             * 搜索文档
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/doc_wiki/search
+             */
+            search(body: SearchRequest): Promise<SearchResponse> & AsyncIterableIterator<Lark.DocResUnit>;
+        }
+        interface SearchRequest {
+            /** 搜索关键词 */
+            query: string;
+            /** 文档过滤参数 */
+            doc_filter?: Lark.DocFilter;
+            /** Wiki过滤参数 */
+            wiki_filter?: Lark.WikiFilter;
+            /** 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该page_token获取查询结果 */
+            page_token?: string;
+            /** 分页大小 */
+            page_size?: number;
+        }
+        interface SearchResponse {
+            /** 匹配结果总数（辅助分页参考） */
+            total?: number;
+            /** 是否有更多数据可供加载 */
+            has_more: boolean;
+            /** 搜索结果列表 */
+            res_units?: Lark.DocResUnit[];
+            /** 下一页分页标记，无更多结果时为空 */
+            page_token?: string;
+        }
+    }
     namespace Message {
         interface Methods {
             /**

package/lib/types/security_and_compliance.d.ts

@@ -10,6 +10,8 @@ export declare namespace SecurityAndCompliance {
         deviceRecord: DeviceRecord.Methods;
         deviceApplyRecord: DeviceApplyRecord.Methods;
         openapiLog: OpenapiLog.Methods;
+        multiGeoEntity: MultiGeoEntity.Methods;
+        userMigration: UserMigration.Methods;
     }
     namespace DeviceRecord {
         interface Methods {
@@ -285,4 +287,88 @@ export declare namespace SecurityAndCompliance {
             page_token?: string;
         }
     }
+    namespace MultiGeoEntity {
+        interface Methods {
+            tenant: Tenant.Methods;
+        }
+        namespace Tenant {
+            interface Methods {
+                /**
+                 * 获取地理位置列表
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/security_and_compliance-v1/multi_geo_entity-tenant/get
+                 */
+                get(): Promise<GetResponse>;
+            }
+            interface GetResponse {
+                /** 多地理位置租户信息 */
+                tenant?: Lark.Tenant;
+            }
+        }
+    }
+    namespace UserMigration {
+        interface Methods {
+            /**
+             * 迁移用户
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/security_and_compliance-v1/user_migration/create
+             */
+            create(body: CreateRequest, query?: CreateQuery): Promise<CreateResponse>;
+            /**
+             * 获取单个用户迁移状态
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/security_and_compliance-v1/user_migration/get
+             */
+            get(user_id: string, query?: GetQuery): Promise<GetResponse>;
+            /**
+             * 批量获取用户迁移状态
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/security_and_compliance-v1/user_migration/search
+             */
+            search(body: SearchRequest, query?: SearchQuery): Promise<SearchResponse>;
+            /**
+             * 取消用户迁移
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/security_and_compliance-v1/user_migration/cancel
+             */
+            cancel(body: CancelRequest, query?: CancelQuery): Promise<void>;
+        }
+        interface CreateRequest {
+            /** 迁移用户 id 列表 */
+            user_ids: string[];
+            /** 迁移目标地理位置区域 */
+            dest_geo: string;
+        }
+        interface CreateQuery {
+            /** 此次调用中使用的用户 ID 的类型 */
+            user_id_type: 'user_id' | 'union_id' | 'open_id';
+        }
+        interface CreateResponse {
+            /** 用户迁移列表 */
+            user_migrations?: Lark.UserMigration[];
+        }
+        interface GetQuery {
+            /** 用户 id 类型 */
+            user_id_type: 'user_id' | 'union_id' | 'open_id';
+        }
+        interface GetResponse {
+            /** 用户迁移 */
+            user_migration?: Lark.UserMigration;
+        }
+        interface SearchRequest {
+            /** 用户 id 列表 */
+            user_ids: string[];
+        }
+        interface SearchQuery {
+            /** 此次调用中使用的用户 ID 的类型 */
+            user_id_type: 'user_id' | 'union_id' | 'open_id';
+        }
+        interface SearchResponse {
+            /** 用户迁移列表 */
+            items?: Lark.UserMigration[];
+        }
+        interface CancelRequest {
+            /** 取消迁移用户 id 列表 */
+            user_ids: string[];
+        }
+        interface CancelQuery {
+            /** 此次调用中使用的用户 ID 的类型 */
+            user_id_type: 'user_id' | 'union_id' | 'open_id';
+        }
+    }
 }

package/lib/types/spark.d.ts

@@ -0,0 +1,356 @@
+import * as Lark from '.';
+import { Paginated, Pagination } from '../internal';
+declare module '../internal' {
+    interface Internal {
+        spark: Spark.Methods;
+    }
+}
+export declare namespace Spark {
+    interface Methods {
+        app: App.Methods;
+        directory: Directory.Methods;
+    }
+    namespace App {
+        interface Methods {
+            table: Table.Methods;
+            view: View.Methods;
+            enum: Enum.Methods;
+            storage: Storage.Methods;
+            /**
+             * 执行 SQL
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/spark-v1/app/sql_commands
+             */
+            sqlCommands(app_id: string, body: SqlCommandsRequest, query?: SqlCommandsQuery): Promise<SqlCommandsResponse>;
+        }
+        interface SqlCommandsRequest {
+            /** 要执行的 SQL 语句 */
+            sql: string;
+        }
+        interface SqlCommandsQuery {
+            /** 访问的 database 环境，默认为 online（线上环境） */
+            env?: string;
+        }
+        interface SqlCommandsResponse {
+            /** 如果是 SELECT 命令，返回的是查询结果的 JSON 序列化字符串。如果是其他无返回的命令，如 DELETE 等，result 为空 */
+            result: string;
+        }
+        namespace Table {
+            interface Methods {
+                /**
+                 * 获取数据表列表
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/spark-v1/app-table/get_table_list
+                 */
+                getTableList(app_id: string, query?: GetTableListQuery): Paginated<Lark.AppTable>;
+                /**
+                 * 获取数据表详细信息
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/spark-v1/app-table/get_table_detail
+                 */
+                getTableDetail(app_id: string, table_name: string, query?: GetTableDetailQuery): Promise<GetTableDetailResponse>;
+                /**
+                 * 查询数据表数据记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/spark-v1/app-table/get_table_record_list
+                 */
+                getTableRecordList(app_id: string, table_name: string, query?: GetTableRecordListQuery): Promise<GetTableRecordListResponse>;
+                /**
+                 * 向数据表中添加或更新记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/spark-v1/app-table/post_table_records
+                 */
+                postTableRecords(app_id: string, table_name: string, body: PostTableRecordsRequest, query?: PostTableRecordsQuery): Promise<PostTableRecordsResponse>;
+                /**
+                 * 按条件更新数据表中的记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/spark-v1/app-table/patch_table_records
+                 */
+                patchTableRecords(app_id: string, table_name: string, body: PatchTableRecordsRequest, query?: PatchTableRecordsQuery): Promise<PatchTableRecordsResponse>;
+                /**
+                 * 批量更新数据表中的记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/spark-v1/app-table/batch_update_table_records
+                 */
+                batchUpdateTableRecords(app_id: string, table_name: string, body: BatchUpdateTableRecordsRequest, query?: BatchUpdateTableRecordsQuery): Promise<BatchUpdateTableRecordsResponse>;
+                /**
+                 * 删除数据表中的记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/spark-v1/app-table/delete_table_records
+                 */
+                deleteTableRecords(app_id: string, table_name: string, query?: DeleteTableRecordsQuery): Promise<void>;
+            }
+            interface GetTableListQuery extends Pagination {
+                /** 访问的 database 环境，默认为 online（线上环境） */
+                env?: string;
+            }
+            interface GetTableDetailQuery {
+                /** 访问的 database 环境，默认为 online（线上环境） */
+                env?: string;
+            }
+            interface GetTableDetailResponse {
+                /** 数据表名，如 student */
+                name: string;
+                /** 数据表描述 */
+                description: string;
+                /** 数据表列 */
+                columns: Lark.AppTableColumn[];
+            }
+            interface GetTableRecordListQuery 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;
+                /** 访问的 database 环境，默认为 online（线上环境） */
+                env?: string;
+                /**
+                 * 此次调用使用的用户 ID 类型，将使用指定的 ID 来标示某个用户在接口入参和出参中的值。
+                 * 示例值：`miaoda_user_id`
+                 * 可选值：
+                 * - `miaoda_user_id`：标识一个用户在飞书开发套件应用中的身份。示例值：1838493619298330
+                 * - `open_id`：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。示例值：ou_bdbbd8f3f919829064b3ffc1b9476105 了解更多：如何获取 Open ID
+                 * - `union_id`：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。示例值：on_b1b44199e8f3def4ebda5355409e2033 了解更多：如何获取 Union ID？
+                 * 默认值：`miaoda_user_id`
+                 */
+                user_identifier_type?: string;
+            }
+            interface GetTableRecordListResponse {
+                /** 是否还有更多项 */
+                has_more: boolean;
+                /** 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token */
+                page_token: string;
+                /** 符合条件的记录总数 */
+                total: number;
+                /** 数据记录列表，格式为数组序列化后的 JSONString */
+                items: string;
+            }
+            interface PostTableRecordsRequest {
+                /** 要插入的数据记录列表，单次支持最多 500 条 */
+                records: string;
+            }
+            interface PostTableRecordsQuery {
+                /** UPSERT 时使用，指定列，多列英文逗号拼接 */
+                columns?: string;
+                /**
+                 * UPSERT 时使用，指定使用哪一个或多个具有唯一约束的字段作为冲突判断依据，默认为表主键。
+                 * 假设 user_products 表有一个由 user_id 和 product_id 组成的复合唯一约束
+                 */
+                on_conflict?: string;
+                /** 访问的 database 环境，默认为 online（线上环境） */
+                env?: string;
+                /**
+                 * 此次调用使用的用户 ID 类型，将使用指定的 ID 来标示某个用户在接口入参和出参中的值。
+                 * 示例值：`miaoda_user_id`
+                 * 可选值：
+                 * - `miaoda_user_id`：标识一个用户在飞书开发套件应用中的身份。示例值：1838493619298330
+                 * - `open_id`：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。示例值：ou_bdbbd8f3f919829064b3ffc1b9476105 了解更多：如何获取 Open ID
+                 * - `union_id`：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。示例值：on_b1b44199e8f3def4ebda5355409e2033 了解更多：如何获取 Union ID？
+                 * 默认值：`miaoda_user_id`
+                 */
+                user_identifier_type?: string;
+            }
+            interface PostTableRecordsResponse {
+                /** 按照记录顺序创建或更新的记录 ID 列表 */
+                record_ids: Lark.Uuid[];
+            }
+            interface PatchTableRecordsRequest {
+                /** 要更新的数据记录信息 */
+                record: string;
+            }
+            interface PatchTableRecordsQuery {
+                /** 筛选条件，尊许 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#horizontal-filtering */
+                filter: string;
+                /** 访问的 database 环境，默认为 online（线上环境） */
+                env?: string;
+                /**
+                 * 此次调用使用的用户 ID 类型，将使用指定的 ID 来标示某个用户在接口入参和出参中的值。
+                 * 示例值：`miaoda_user_id`
+                 * 可选值：
+                 * - `miaoda_user_id`：标识一个用户在飞书开发套件应用中的身份。示例值：1838493619298330
+                 * - `open_id`：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。示例值：ou_bdbbd8f3f919829064b3ffc1b9476105 了解更多：如何获取 Open ID
+                 * - `union_id`：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。示例值：on_b1b44199e8f3def4ebda5355409e2033 了解更多：如何获取 Union ID？
+                 * 默认值：`miaoda_user_id`
+                 */
+                user_identifier_type?: string;
+            }
+            interface PatchTableRecordsResponse {
+                /** 更新的记录唯一ID列表 */
+                record_ids: Lark.Uuid[];
+            }
+            interface BatchUpdateTableRecordsRequest {
+                /** 要更新的数据记录列表，单次支持最多 500条，每行 record 都必须包含主键 _id，且不同行要更新的字段需保持一致 */
+                records: string;
+            }
+            interface BatchUpdateTableRecordsQuery {
+                /** 访问的 database 环境，默认为 online（线上环境） */
+                env?: string;
+                /**
+                 * 此次调用使用的用户 ID 类型，将使用指定的 ID 来标示某个用户在接口入参和出参中的值。
+                 * 示例值：`miaoda_user_id`
+                 * 可选值：
+                 * - `miaoda_user_id`：标识一个用户在飞书开发套件应用中的身份。示例值：1838493619298330
+                 * - `open_id`：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。示例值：ou_bdbbd8f3f919829064b3ffc1b9476105 了解更多：如何获取 Open ID
+                 * - `union_id`：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。示例值：on_b1b44199e8f3def4ebda5355409e2033 了解更多：如何获取 Union ID？
+                 * 默认值：`miaoda_user_id`
+                 */
+                user_identifier_type?: string;
+            }
+            interface BatchUpdateTableRecordsResponse {
+                /** 更新的记录唯一ID列表 */
+                record_ids: Lark.Uuid[];
+            }
+            interface DeleteTableRecordsQuery {
+                /**
+                 * 筛选条件，尊许 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#horizontal-filtering
+                 * 此处用法和查询数据记录一致
+                 */
+                filter: string;
+                /** 访问的 database 环境，默认为 online（线上环境） */
+                env?: string;
+            }
+        }
+        namespace View {
+            interface Methods {
+                /**
+                 * 查询视图数据记录
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/spark-v1/app-view/get_view_record_list
+                 */
+                getViewRecordList(app_id: string, view_name: string, query?: GetViewRecordListQuery): Promise<GetViewRecordListResponse>;
+            }
+            interface GetViewRecordListQuery 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;
+                /** 访问的 database 环境，默认为 online（线上环境） */
+                env?: string;
+                /**
+                 * 此次调用使用的用户 ID 类型，将使用指定的 ID 来标示某个用户在接口入参和出参中的值。
+                 * 示例值：`miaoda_user_id`
+                 * 可选值：
+                 * - `miaoda_user_id`：标识一个用户在飞书开发套件应用中的身份。示例值：1838493619298330
+                 * - `open_id`：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。示例值：ou_bdbbd8f3f919829064b3ffc1b9476105 了解更多：如何获取 Open ID
+                 * - `union_id`：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。示例值：on_b1b44199e8f3def4ebda5355409e2033 了解更多：如何获取 Union ID？
+                 * 默认值：`miaoda_user_id`
+                 */
+                user_identifier_type?: string;
+            }
+            interface GetViewRecordListResponse {
+                /** 是否还有更多项 */
+                has_more: boolean;
+                /** 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token */
+                page_token: string;
+                /** 符合条件的记录总数 */
+                total: number;
+                /** 数据记录列表，格式为数组序列化后的 JSONString */
+                items: string;
+            }
+        }
+        namespace Enum {
+            interface Methods {
+                /**
+                 * 获取自定义枚举列表
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/spark-v1/app-enum/get_enum_list
+                 */
+                getEnumList(app_id: string, query?: GetEnumListQuery): Paginated<Lark.AppEnum>;
+                /**
+                 * 获取自定义枚举详细信息
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/spark-v1/app-enum/get_enum_detail
+                 */
+                getEnumDetail(app_id: string, enum_name: string, query?: GetEnumDetailQuery): Promise<GetEnumDetailResponse>;
+            }
+            interface GetEnumListQuery extends Pagination {
+                /** 访问的 database 环境，默认为 online（线上环境） */
+                env?: string;
+            }
+            interface GetEnumDetailQuery {
+                /** 访问的 database 环境，默认为 online（线上环境） */
+                env?: string;
+            }
+            interface GetEnumDetailResponse {
+                /** 枚举名称 */
+                name: string;
+                /** 枚举描述 */
+                description: string;
+                /** 枚举值列表 */
+                options: string[];
+                /** 创建时间，毫秒时间戳 */
+                created_at: string;
+            }
+        }
+        namespace Storage {
+            interface Methods {
+                /**
+                 * 上传文件
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/spark-v1/app-storage/upload
+                 */
+                upload(app_id: string, form: UploadForm): Promise<UploadResponse>;
+                /**
+                 * 下载文件
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/spark-v1/app-storage/download
+                 */
+                download(app_id: string, query?: DownloadQuery): Promise<ArrayBuffer>;
+            }
+            interface UploadForm {
+                /** 文件名称 */
+                file_name: string;
+                /** 文件的十六进制 SHA-256 值，用于文件一致性校验。如果传入此值，服务端会在上传完成后对比接收到文件的 SHA-256 值，如果不一致，会返回上传失败。 */
+                check_sum?: string;
+                /** 文件二进制 */
+                file: Blob;
+            }
+            interface UploadResponse {
+                /** 文件 ID */
+                file_key: string;
+                /** 文件 URL，相对路径 */
+                file_url: string;
+                /** 文件名称 */
+                file_name: string;
+                /** 文件大小，单位字节 */
+                file_size: number;
+                /** 文件 MIME 类型 */
+                mime_type: string;
+            }
+            interface DownloadQuery {
+                /** 文件 ID，ID 和 URL 不能同时为空，都提供的情况下，使用 file_key */
+                file_key?: string;
+                /** 文件 URL，ID 和 URL 不能同时为空 */
+                file_url?: string;
+            }
+        }
+    }
+    namespace Directory {
+        interface Methods {
+            user: User.Methods;
+        }
+        namespace User {
+            interface Methods {
+                /**
+                 * 妙搭和飞书用户 ID 转换
+                 * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/spark-v1/directory-user/id_convert
+                 */
+                idConvert(body: IdConvertRequest): Promise<IdConvertResponse>;
+            }
+            interface IdConvertRequest {
+                /** ID 转换类型，枚举 */
+                id_convert_type: Lark.IdConvertType;
+                /** 长度最大100 */
+                ids?: string[];
+            }
+            interface IdConvertResponse {
+                /** ID 映射，查询不到或者查询出错的不返回 */
+                items?: Lark.IdMapItem[];
+            }
+        }
+    }
+}

package/lib/types/vc.d.ts

@@ -7,6 +7,7 @@ declare module '../internal' {
 }
 export declare namespace Vc {
     interface Methods {
+        note: Note.Methods;
         reserve: Reserve.Methods;
         meeting: Meeting.Methods;
         report: Report.Methods;
@@ -22,6 +23,23 @@ export declare namespace Vc {
         alert: Alert.Methods;
         roomConfig: RoomConfig.Methods;
     }
+    namespace Note {
+        interface Methods {
+            /**
+             * 获取纪要详情
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/note/get
+             */
+            get(note_id: string, query?: GetQuery): Promise<GetResponse>;
+        }
+        interface GetQuery {
+            /** 此次调用中使用的用户ID的类型 */
+            user_id_type?: 'user_id' | 'union_id' | 'open_id';
+        }
+        interface GetResponse {
+            /** 纪要信息 */
+            note?: Lark.Note;
+        }
+    }
     namespace Reserve {
         interface Methods {
             /**
@@ -100,6 +118,11 @@ export declare namespace Vc {
     namespace Meeting {
         interface Methods {
             recording: Recording.Methods;
+            /**
+             * 搜索会议记录
+             * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting/search
+             */
+            search(body: SearchRequest, query?: Pagination): Promise<SearchResponse> & AsyncIterableIterator<Lark.MeetingSearchItem>;
             /**
              * 邀请参会人
              * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting/invite
@@ -131,6 +154,25 @@ export declare namespace Vc {
              */
             listByNo(query?: ListByNoQuery): Paginated<Lark.Meeting, 'meeting_briefs'>;
         }
+        interface SearchRequest {
+            /**
+             * 搜索关键词
+             * **数据校验规则：** 长度范围：1 字符 ～ 50 字符
+             */
+            query?: string;
+            /** 视频会议过滤参数 */
+            meeting_filter?: Lark.MeetingFilter;
+        }
+        interface SearchResponse {
+            /** 匹配结果总数（辅助分页参考） */
+            total?: number;
+            /** 是否有更多数据可供加载 */
+            has_more: boolean;
+            /** 返回结果列表 */
+            items?: Lark.MeetingSearchItem[];
+            /** 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token */
+            page_token?: string;
+        }
         interface InviteRequest {
             /** 被邀请的用户列表 */
             invitees: Lark.MeetingUser[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@satorijs/adapter-lark",
   "description": "Lark (飞书) Adapter for Satorijs",
-  "version": "3.12.3",
+  "version": "3.12.5",
   "type": "module",
   "main": "lib/index.cjs",
   "types": "lib/index.d.ts",
@@ -35,13 +35,13 @@
   ],
   "devDependencies": {
     "@cordisjs/plugin-server": "^0.2.9",
-    "@satorijs/core": "^4.5.2",
+    "@satorijs/core": "^4.6.0",
     "cordis": "^3.18.1",
     "cosmokit": "^1.8.1",
     "dedent": "^1.5.3"
   },
   "peerDependencies": {
-    "@satorijs/core": "^4.5.2"
+    "@satorijs/core": "^4.6.0"
   },
   "dependencies": {
     "protobufjs": "^8.0.0"

package/src/bot.ts

@@ -83,7 +83,6 @@ export class LarkBot<C extends Context = Context, T extends LarkBot.Config = Lar
     // 剩余有效期小于 30 分钟时，调用本接口会返回一个新的 tenant_access_token，此时会同时存在两个有效的 tenant_access_token。
     // 剩余有效期大于等于 30 分钟时，调用本接口会返回原有的 tenant_access_token。
     // 初次获得 token 后的半小时内必须刷新一次，因为初次获得的 token 可能是 1.5 小时前生成的。
-    if (!this.isActive) return
     let timeout = Time.minute * 20
     try {
       const { tenant_access_token: token } = await this.internal.auth.tenantAccessTokenInternal({