@satorijs/adapter-lark 3.11.8 → 3.12.0

package/src/types/calendar.ts

@@ -30,11 +30,21 @@ export namespace Calendar {
      * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/primary
      */
     primary(query?: PrimaryQuery): Promise<PrimaryResponse>
+    /**
+     * 批量获取主日历信息
+     * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/primarys
+     */
+    primarys(body: PrimarysRequest, query?: PrimarysQuery): Promise<PrimarysResponse>
     /**
      * 查询日历信息
      * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get
      */
     get(calendar_id: string): Promise<GetResponse>
+    /**
+     * 批量查询日历信息
+     * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/mget
+     */
+    mget(body: MgetRequest): Promise<MgetResponse>
     /**
      * 查询日历列表
      * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/list
@@ -100,6 +110,21 @@ export namespace Calendar {
     calendars?: Lark.UserCalendar[]
   }
 
+  export interface PrimarysRequest {
+    /** 用户ID列表 */
+    user_ids: string[]
+  }
+
+  export interface PrimarysQuery {
+    /** 此次调用中使用的用户ID的类型 */
+    user_id_type?: 'user_id' | 'union_id' | 'open_id'
+  }
+
+  export interface PrimarysResponse {
+    /** 主日历列表 */
+    calendars?: Lark.UserCalendar[]
+  }
+
   export interface GetResponse {
     /** 日历OpenId */
     calendar_id: string
@@ -123,6 +148,16 @@ export namespace Calendar {
     role?: 'unknown' | 'free_busy_reader' | 'reader' | 'writer' | 'owner'
   }
 
+  export interface MgetRequest {
+    /** 日历ID列表 */
+    calendar_ids: string[]
+  }
+
+  export interface MgetResponse {
+    /** 日历列表 */
+    calendars?: Lark.Calendar[]
+  }
+
   export interface ListQuery extends Pagination {
     /** 上次请求Response返回的增量同步标记，分页请求未结束时为空 */
     sync_token?: string
@@ -181,6 +216,11 @@ export namespace Calendar {
        * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/freebusy/list
        */
       list(body: ListRequest, query?: ListQuery): Promise<ListResponse>
+      /**
+       * 批量查询主日历日程忙闲信息
+       * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/freebusy/batch
+       */
+      batch(body: BatchRequest, query?: BatchQuery): Promise<BatchResponse>
     }
 
     export interface ListRequest {
@@ -188,7 +228,7 @@ export 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
@@ -207,6 +247,29 @@ export namespace Calendar {
       /** 日历上请求时间区间内的忙闲信息 */
       freebusy_list?: Lark.Freebusy[]
     }
+
+    export interface BatchRequest {
+      /** 获取忙闲信息的开始时间，RFC3339 date_time格式；time_min与time_max的时间区间不能超过3个月。 */
+      time_min: string
+      /** 获取忙闲信息的开始时间，RFC3339 date_time格式；time_min与time_max的时间区间不能超过3个月。 */
+      time_max: string
+      /** 用户ID列表 */
+      user_ids: string[]
+      /** 是否包含绑定的三方日历中的日程，不传默认为true，即包含。 */
+      include_external_calendar?: boolean
+      /** 是否包含标记为空闲的日程，不传默认为true，即包含空闲日程。 */
+      only_busy?: boolean
+    }
+
+    export interface BatchQuery {
+      /** 此次调用中使用的用户ID的类型 */
+      user_id_type?: 'user_id' | 'union_id' | 'open_id'
+    }
+
+    export interface BatchResponse {
+      /** 用户忙闲信息列表 */
+      freebusy_lists?: Lark.UserFreebusy[]
+    }
   }
 
   export namespace Acl {
@@ -568,7 +631,10 @@ export namespace Calendar {
       }
 
       export interface CreateRequest {
-        /** 新增参与人列表；<br>- 单次请求会议室的数量限制为100。 */
+        /**
+         * 新增参与人列表；
+         * - 单次请求会议室的数量限制为100。
+         */
         attendees?: Lark.CalendarEventAttendee[]
         /** 是否给参与人发送bot通知 默认为true */
         need_notification?: boolean
@@ -591,7 +657,7 @@ export namespace Calendar {
       }
 
       export 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[]
@@ -657,7 +723,11 @@ export 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
     }
 
@@ -679,7 +749,11 @@ export 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
     }
   }
@@ -789,9 +863,18 @@ Internal.define({
   '/calendar/v4/calendars/primary': {
     POST: 'calendar.primary',
   },
+  '/calendar/v4/calendars/primarys': {
+    POST: 'calendar.primarys',
+  },
+  '/calendar/v4/calendars/mget': {
+    POST: 'calendar.mget',
+  },
   '/calendar/v4/freebusy/list': {
     POST: 'calendar.freebusy.list',
   },
+  '/calendar/v4/freebusy/batch': {
+    POST: 'calendar.freebusy.batch',
+  },
   '/calendar/v4/calendars/search': {
     POST: { name: 'calendar.search', pagination: { argIndex: 1 } },
   },

package/src/types/cardkit.ts

@@ -21,12 +21,12 @@ export namespace Cardkit {
        */
       create(body: CreateRequest): Promise<CreateResponse>
       /**
-       * 更新卡片配置
+       * 更新卡片实体配置
        * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card/settings
        */
       settings(card_id: string, body: SettingsRequest): Promise<void>
       /**
-       * 批量更新卡片实体
+       * 局部更新卡片实体
        * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card/batch_update
        */
       batchUpdate(card_id: string, body: BatchUpdateRequest): Promise<void>