@satorijs/adapter-lark 3.12.3 → 3.12.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -59,6 +59,7 @@ export namespace Corehr {
59
59
  bp: Bp.Methods
60
60
  assignedUser: AssignedUser.Methods
61
61
  process: Process.Methods
62
+ processStart: ProcessStart.Methods
62
63
  processRevoke: ProcessRevoke.Methods
63
64
  processWithdraw: ProcessWithdraw.Methods
64
65
  approver: Approver.Methods
@@ -783,6 +784,7 @@ export namespace Corehr {
783
784
 
784
785
  export namespace Employee {
785
786
  export interface Methods {
787
+ customOrg: CustomOrg.Methods
786
788
  /**
787
789
  * 批量查询员工信息
788
790
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get
@@ -1010,6 +1012,141 @@ export namespace Corehr {
1010
1012
  /** 任职信息 ID */
1011
1013
  job_data_id?: string
1012
1014
  }
1015
+
1016
+ export namespace CustomOrg {
1017
+ export interface Methods {
1018
+ /**
1019
+ * 新增人员自定义组织变更记录
1020
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee-custom_org/create_emp_custom_org
1021
+ */
1022
+ createEmpCustomOrg(body: CreateEmpCustomOrgRequest, query?: CreateEmpCustomOrgQuery): Promise<CreateEmpCustomOrgResponse>
1023
+ /**
1024
+ * 更新人员自定义组织变更记录
1025
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee-custom_org/edit_emp_custom_org
1026
+ */
1027
+ editEmpCustomOrg(body: EditEmpCustomOrgRequest, query?: EditEmpCustomOrgQuery): Promise<EditEmpCustomOrgResponse>
1028
+ /**
1029
+ * 查询单个人员自定义组织变更记录
1030
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee-custom_org/querybyid
1031
+ */
1032
+ querybyid(query?: QuerybyidQuery): Promise<QuerybyidResponse>
1033
+ /**
1034
+ * 批量查询人员自定义组织变更记录
1035
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee-custom_org/employment_custom_org_record
1036
+ */
1037
+ employmentCustomOrgRecord(query?: EmploymentCustomOrgRecordQuery): Promise<EmploymentCustomOrgRecordResponse>
1038
+ /**
1039
+ * 删除人员自定义组织变更记录
1040
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee-custom_org/del
1041
+ */
1042
+ del(body: DelRequest, query?: DelQuery): Promise<DelResponse>
1043
+ }
1044
+
1045
+ export interface CreateEmpCustomOrgRequest {
1046
+ /** 用户ID */
1047
+ user_id: string
1048
+ /** 自定义组织类型编码 */
1049
+ object_api_name: string
1050
+ /** 自定义组织列表 */
1051
+ custom_org_with_rates: Lark.CustomOrgWithRate[]
1052
+ /** 变更原因 */
1053
+ start_reason?: string
1054
+ /** 生效时间 */
1055
+ effective_time: string
1056
+ }
1057
+
1058
+ export interface CreateEmpCustomOrgQuery {
1059
+ /** 此次调用中使用的用户ID的类型 */
1060
+ user_id_type: 'people_corehr_id' | 'open_id' | 'union_id' | 'user_id'
1061
+ }
1062
+
1063
+ export interface CreateEmpCustomOrgResponse {
1064
+ /** 自定义组织ID */
1065
+ job_data_custom_org_id: string
1066
+ /** 版本ID */
1067
+ version_id: string
1068
+ }
1069
+
1070
+ export interface EditEmpCustomOrgRequest {
1071
+ /** 用户ID */
1072
+ user_id: string
1073
+ /** 自定义组织类型编码 */
1074
+ object_api_name: string
1075
+ /** 自定义组织ID */
1076
+ job_data_custom_org_id: string
1077
+ /** 版本ID */
1078
+ version_id: string
1079
+ /** 自定义组织列表 */
1080
+ custom_org_with_rates: Lark.CustomOrgWithRate[]
1081
+ /** 生效时间 */
1082
+ effective_time: string
1083
+ /** 变更原因 */
1084
+ start_reason?: string
1085
+ }
1086
+
1087
+ export interface EditEmpCustomOrgQuery {
1088
+ /** 此次调用中使用的用户ID的类型 */
1089
+ user_id_type: 'open_id' | 'union_id' | 'user_id' | 'people_corehr_id'
1090
+ }
1091
+
1092
+ export interface EditEmpCustomOrgResponse {
1093
+ /** 添加成功 */
1094
+ data?: string
1095
+ }
1096
+
1097
+ export interface QuerybyidQuery {
1098
+ /** 自定义组织ID */
1099
+ job_data_custom_org_id: string
1100
+ /** 版本IDs 。为空是查 全部的版本记录 */
1101
+ version_id?: string[]
1102
+ /** 自定义组织类型编码 */
1103
+ object_api_name: string
1104
+ /** 用户ID标识 */
1105
+ user_id_type: 'people_corehr_id' | 'open_id' | 'union_id' | 'user_id'
1106
+ }
1107
+
1108
+ export interface QuerybyidResponse {
1109
+ /** 详情 */
1110
+ custom_org: Lark.EmpCustomOrgList[]
1111
+ /** 用户编码 */
1112
+ user_id?: string
1113
+ }
1114
+
1115
+ export interface EmploymentCustomOrgRecordQuery {
1116
+ /** 用户ID */
1117
+ user_ids: string[]
1118
+ /** 用户 ID 类型 */
1119
+ user_id_type: 'open_id' | 'union_id' | 'user_id' | 'people_corehr_id'
1120
+ /** 组织类型编码,可在「飞书人事-设置-组织设置」中相应的自定义组织目录下查看 */
1121
+ object_api_names: string[]
1122
+ }
1123
+
1124
+ export interface EmploymentCustomOrgRecordResponse {
1125
+ /** 自定义组织列表 */
1126
+ custom_org_list?: Lark.EmpCustomOrgList[]
1127
+ }
1128
+
1129
+ export interface DelRequest {
1130
+ /** 用户ID */
1131
+ user_id: string
1132
+ /** 自定义组织ID */
1133
+ job_data_custom_org_id: string
1134
+ /** 版本ID */
1135
+ version_id: string
1136
+ /** 自定义组织类型编码 */
1137
+ object_api_name: string
1138
+ }
1139
+
1140
+ export interface DelQuery {
1141
+ /** 此次调用中使用的用户ID的类型 */
1142
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id'
1143
+ }
1144
+
1145
+ export interface DelResponse {
1146
+ /** 返回值 */
1147
+ data: string
1148
+ }
1149
+ }
1013
1150
  }
1014
1151
 
1015
1152
  export namespace Person {
@@ -2823,6 +2960,11 @@ export namespace Corehr {
2823
2960
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/location/query_recent_change
2824
2961
  */
2825
2962
  queryRecentChange(query?: QueryRecentChangeQuery): Promise<QueryRecentChangeResponse>
2963
+ /**
2964
+ * 查询指定时间范围地点版本
2965
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/location/query_multi_timeline
2966
+ */
2967
+ queryMultiTimeline(body: QueryMultiTimelineRequest): Promise<QueryMultiTimelineResponse>
2826
2968
  /**
2827
2969
  * 通过地点 ID 批量获取地点信息
2828
2970
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/location/batch_get
@@ -2926,6 +3068,22 @@ export namespace Corehr {
2926
3068
  deleted_location_ids?: string[]
2927
3069
  }
2928
3070
 
3071
+ export interface QueryMultiTimelineRequest {
3072
+ /** 地点 ID 列表 */
3073
+ location_ids: string[]
3074
+ /** 查询开始时间(包含) */
3075
+ start_date?: string
3076
+ /** 查询结束时间(包含) */
3077
+ end_date?: string
3078
+ /** 返回数据的字段列表,可选["location_name", "code", "active", "parent_location_id", "description", "effective_date"] */
3079
+ fields?: string[]
3080
+ }
3081
+
3082
+ export interface QueryMultiTimelineResponse {
3083
+ /** 地点信息 */
3084
+ items?: Lark.LocationTimeline[]
3085
+ }
3086
+
2929
3087
  export interface BatchGetRequest {
2930
3088
  /** 地点 ID 列表 */
2931
3089
  location_ids: string[]
@@ -3084,6 +3242,11 @@ export namespace Corehr {
3084
3242
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list
3085
3243
  */
3086
3244
  list(query?: Pagination): Paginated<Lark.Company>
3245
+ /**
3246
+ * 查询指定时间范围公司版本
3247
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/company/query_multi_timeline
3248
+ */
3249
+ queryMultiTimeline(body: QueryMultiTimelineRequest): Promise<QueryMultiTimelineResponse>
3087
3250
  /**
3088
3251
  * 查询当前生效信息变更公司
3089
3252
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/company/query_recent_change
@@ -3203,6 +3366,22 @@ export namespace Corehr {
3203
3366
  company?: Lark.Company
3204
3367
  }
3205
3368
 
3369
+ export interface QueryMultiTimelineRequest {
3370
+ /** 公司 ID 列表 */
3371
+ company_ids: string[]
3372
+ /** 查询开始时间(包含) */
3373
+ start_date?: string
3374
+ /** 查询结束时间(包含) */
3375
+ end_date?: string
3376
+ /** 返回数据的字段列表,可选["company_name", "code", "active", "description", "effective_date", "expiration_date"] */
3377
+ fields?: string[]
3378
+ }
3379
+
3380
+ export interface QueryMultiTimelineResponse {
3381
+ /** 公司信息 */
3382
+ items?: Lark.CompanyTimeline[]
3383
+ }
3384
+
3206
3385
  export interface QueryRecentChangeQuery extends Pagination {
3207
3386
  /** 查询的开始时间,支持"yyyy-MM-dd HH:MM:SS" */
3208
3387
  start_date: string
@@ -4778,6 +4957,11 @@ export namespace Corehr {
4778
4957
  export namespace Probation {
4779
4958
  export interface Methods {
4780
4959
  assessment: Assessment.Methods
4960
+ /**
4961
+ * 编辑试用期
4962
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/probation/edit
4963
+ */
4964
+ edit(body: EditRequest, query?: EditQuery): Promise<void>
4781
4965
  /**
4782
4966
  * 启用/停用试用期考核功能
4783
4967
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/probation/enable_disable_assessment
@@ -4800,6 +4984,36 @@ export namespace Corehr {
4800
4984
  withdraw(body: WithdrawRequest, query?: WithdrawQuery): Promise<void>
4801
4985
  }
4802
4986
 
4987
+ export interface EditRequest {
4988
+ /** 试用期人员的雇佣 ID */
4989
+ employment_id: string
4990
+ /** 试用期开始日期,格式:"YYYY-MM-DD",填写时满足以下规则 - 「试用期开始日期」和「试用期预计结束日期」需要一同填写。 - 若该员工存在试用期记录,且同时填写「试用期开始日期」和「试用期预计结束日期」为空串,则删除该试用期记录。 - 若该员工不存在试用期记录,且填写「试用期开始日期」和「试用期预计结束日期」,则新增试用期记录。 - 若该员工不存在试用期记录,且未填写「试用期开始日期」和「试用期预计结束日期」,则试用期记录不会创建,其他写入数据不会生效。 - 入职日期 <= 试用期开始日期 <= 试用期预计结束日期 */
4991
+ probation_start_date?: string
4992
+ /** 试用期预计结束日期,格式:"YYYY-MM-DD",填写时满足以下规则 - 「试用期开始日期」和「试用期预计结束日期」需要一同填写。 - 若该员工存在试用期记录,且同时填写「试用期开始日期」和「试用期预计结束日期」为空串,则删除该试用期记录。 - 若该员工不存在试用期记录,且填写「试用期开始日期」和「试用期预计结束日期」,则新增试用期记录。 - 若该员工不存在试用期记录,且未填写「试用期开始日期」和「试用期预计结束日期」,则试用期记录不会创建,其他写入数据不会生效。 - 试用期开始日期 <= 试用期预计结束日期 */
4993
+ probation_expected_end_date?: string
4994
+ /** 试用期结果,填写时满足以下规则 - 填写「通过」时,必填「试用期实际结束日期」。 - 填写「延长」时,「延长后试用期预计结束日期」和「试用期预计延长时长」至少填写一项。 */
4995
+ probation_outcome?: 'passed' | 'failed' | 'delayed'
4996
+ /** 试用期实际结束日期,格式:"YYYY-MM-DD",填写时满足以下规则 - 需同时指定试用期结果为「通过」。 - 在试用期结果为空时,填写后将自动赋值试用期结果为「通过」。 - 试用期开始时间 <= 试用期实际结束日期 <= 试用期预计结束日期。 */
4997
+ actual_probation_end_date?: string
4998
+ /** 延长后试用期预计结束日期,格式:"YYYY-MM-DD",填写时满足以下规则 - 需同时指定「试用期结果」为「延期」。 - 若同时填写「试用期预计延长时长」,需保持两者数据一致。 - 延长后试用期预计结束日期 > 试用期预计结束日期。 */
4999
+ probation_extend_expected_end_date?: string
5000
+ /** 试用期预计延长时长,填写时满足以下规则 - 需同时指定「试用期结果」为「延期」。 - 填写时需要指定「试用期延长时长单位」。 - 若同时填写「延长后试用期预计结束日期」,需保持两者数据一致。 - 试用期预计延长时长 > 0。 */
5001
+ extended_probation_period_duration?: number
5002
+ /** 试用期延长时长单位,填写时满足以下规则 - 需要和「试用期预计延长时长」一同填写。 - 需同时指定「试用期结果」为「延期」。 */
5003
+ extended_probation_period_unit?: 'day' | 'week' | 'month'
5004
+ /** 备注 */
5005
+ notes?: string
5006
+ /** 员工自评 */
5007
+ self_review?: string
5008
+ /** 自定义字段(当前不支持附件类型字段写入) */
5009
+ custom_fields?: Lark.CustomFieldData[]
5010
+ }
5011
+
5012
+ export interface EditQuery {
5013
+ /** 用户 ID 类型 */
5014
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id'
5015
+ }
5016
+
4803
5017
  export interface EnableDisableAssessmentRequest {
4804
5018
  /** 启用 / 停用状态。启用后可在试用期管理页面中可见试用期考核相关的字段。 */
4805
5019
  active: boolean
@@ -6260,6 +6474,7 @@ export namespace Corehr {
6260
6474
  export namespace Process {
6261
6475
  export interface Methods {
6262
6476
  formVariableData: FormVariableData.Methods
6477
+ queryFlowDataTemplate: QueryFlowDataTemplate.Methods
6263
6478
  approver: Approver.Methods
6264
6479
  extra: Extra.Methods
6265
6480
  transfer: Transfer.Methods
@@ -6403,6 +6618,35 @@ export namespace Corehr {
6403
6618
  }
6404
6619
  }
6405
6620
 
6621
+ export namespace QueryFlowDataTemplate {
6622
+ export interface Methods {
6623
+ /**
6624
+ * 查询流程数据参数模板
6625
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/process-query_flow_data_template/create
6626
+ */
6627
+ create(body: CreateRequest, query?: CreateQuery): Promise<CreateResponse>
6628
+ }
6629
+
6630
+ export interface CreateRequest {
6631
+ /** 流程定义ID */
6632
+ flow_definition_id: string
6633
+ /** 需要传入的变量的ApiName。如果是多级下钻变量用"."分割 */
6634
+ variable_api_names: string[]
6635
+ }
6636
+
6637
+ export interface CreateQuery {
6638
+ /** 此次调用中使用的用户ID的类型 */
6639
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id'
6640
+ }
6641
+
6642
+ export interface CreateResponse {
6643
+ /** 流程参数模板 */
6644
+ field_values: Lark.ProcessFormVariableV2[]
6645
+ /** 错误信息 */
6646
+ error_info?: string
6647
+ }
6648
+ }
6649
+
6406
6650
  export namespace Approver {
6407
6651
  export interface Methods {
6408
6652
  /**
@@ -6526,6 +6770,39 @@ export namespace Corehr {
6526
6770
  }
6527
6771
  }
6528
6772
 
6773
+ export namespace ProcessStart {
6774
+ export interface Methods {
6775
+ /**
6776
+ * 发起流程
6777
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/process_start/create
6778
+ */
6779
+ create(body: CreateRequest, query?: CreateQuery): Promise<CreateResponse>
6780
+ }
6781
+
6782
+ export interface CreateRequest {
6783
+ /** 流程定义ID */
6784
+ flow_definition_id: string
6785
+ /** 发起人用户ID,按user_id_type类型传递。如果system_initiator为false,则必填;为true时非必填。 */
6786
+ initiator_id?: string
6787
+ /** 是否为系统身份发起流程。 true - 使用系统身份发起,若使用系统身份;false - 按照所传的人员身份审批 */
6788
+ system_initiator?: boolean
6789
+ /** 业务数据 */
6790
+ flow_data?: Lark.ProcessFormVariableV2[]
6791
+ }
6792
+
6793
+ export interface CreateQuery {
6794
+ /** 用户 ID 类型 */
6795
+ user_id_type?: 'open_id' | 'union_id' | 'user_id' | 'people_corehr_id'
6796
+ /** 此次调用中使用的部门 ID 类型 */
6797
+ department_id_type?: 'open_department_id' | 'department_id' | 'people_corehr_department_id'
6798
+ }
6799
+
6800
+ export interface CreateResponse {
6801
+ /** 流程实例id */
6802
+ process_id?: string
6803
+ }
6804
+ }
6805
+
6529
6806
  export namespace ProcessRevoke {
6530
6807
  export interface Methods {
6531
6808
  /**
@@ -6882,6 +7159,21 @@ Internal.define({
6882
7159
  '/corehr/v2/employees/additional_jobs/batch': {
6883
7160
  POST: { name: 'corehr.employees.additionalJob.batch', pagination: { argIndex: 1 } },
6884
7161
  },
7162
+ '/corehr/v2/custom_org/create_emp_custom_org': {
7163
+ POST: 'corehr.employee.customOrg.createEmpCustomOrg',
7164
+ },
7165
+ '/corehr/v2/custom_org/edit_emp_custom_org': {
7166
+ POST: 'corehr.employee.customOrg.editEmpCustomOrg',
7167
+ },
7168
+ '/corehr/v2/custom_org/querybyid': {
7169
+ GET: 'corehr.employee.customOrg.querybyid',
7170
+ },
7171
+ '/corehr/v2/custom_org/employment_custom_org_record': {
7172
+ GET: 'corehr.employee.customOrg.employmentCustomOrgRecord',
7173
+ },
7174
+ '/corehr/v2/custom_org/del': {
7175
+ POST: 'corehr.employee.customOrg.del',
7176
+ },
6885
7177
  '/corehr/v2/default_cost_centers/update_version': {
6886
7178
  POST: 'corehr.defaultCostCenter.updateVersion',
6887
7179
  },
@@ -6952,6 +7244,9 @@ Internal.define({
6952
7244
  '/corehr/v2/locations/query_recent_change': {
6953
7245
  GET: 'corehr.location.queryRecentChange',
6954
7246
  },
7247
+ '/corehr/v2/locations/query_multi_timeline': {
7248
+ POST: 'corehr.location.queryMultiTimeline',
7249
+ },
6955
7250
  '/corehr/v2/locations/batch_get': {
6956
7251
  POST: 'corehr.location.batchGet',
6957
7252
  },
@@ -6977,6 +7272,9 @@ Internal.define({
6977
7272
  '/corehr/v2/companies/active': {
6978
7273
  POST: 'corehr.company.active',
6979
7274
  },
7275
+ '/corehr/v2/companies/query_multi_timeline': {
7276
+ POST: 'corehr.company.queryMultiTimeline',
7277
+ },
6980
7278
  '/corehr/v2/companies/query_recent_change': {
6981
7279
  GET: 'corehr.company.queryRecentChange',
6982
7280
  },
@@ -7166,6 +7464,9 @@ Internal.define({
7166
7464
  '/corehr/v2/pre_hires/{pre_hire_id}/complete': {
7167
7465
  POST: 'corehr.preHire.complete',
7168
7466
  },
7467
+ '/corehr/v2/probation/edit': {
7468
+ POST: 'corehr.probation.edit',
7469
+ },
7169
7470
  '/corehr/v2/probation/assessments': {
7170
7471
  POST: 'corehr.probation.assessment.create',
7171
7472
  },
@@ -7341,6 +7642,12 @@ Internal.define({
7341
7642
  '/corehr/v2/processes/{process_id}/form_variable_data': {
7342
7643
  GET: 'corehr.process.formVariableData.get',
7343
7644
  },
7645
+ '/corehr/v2/query_flow_data_template': {
7646
+ POST: 'corehr.process.queryFlowDataTemplate.create',
7647
+ },
7648
+ '/corehr/v2/process_start': {
7649
+ POST: 'corehr.processStart.create',
7650
+ },
7344
7651
  '/corehr/v2/process_revoke/{process_id}': {
7345
7652
  PUT: 'corehr.processRevoke.update',
7346
7653
  },
@@ -14,7 +14,9 @@ export namespace Drive {
14
14
  importTask: ImportTask.Methods
15
15
  exportTask: ExportTask.Methods
16
16
  media: Media.Methods
17
+ user: User.Methods
17
18
  permission: Permission.Methods
19
+ commentReaction: CommentReaction.Methods
18
20
  }
19
21
 
20
22
  export namespace File {
@@ -603,6 +605,11 @@ export namespace Drive {
603
605
 
604
606
  export namespace Reply {
605
607
  export interface Methods {
608
+ /**
609
+ * 添加回复
610
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment-reply/create
611
+ */
612
+ create(file_token: string, comment_id: string, body: CreateRequest, query?: CreateQuery): Promise<CreateResponse>
606
613
  /**
607
614
  * 获取回复信息
608
615
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment-reply/list
@@ -620,6 +627,35 @@ export namespace Drive {
620
627
  delete(file_token: string, comment_id: string, reply_id: string, query?: DeleteQuery): Promise<void>
621
628
  }
622
629
 
630
+ export interface CreateRequest {
631
+ /** 回复内容 */
632
+ content: Lark.ReplyContent
633
+ }
634
+
635
+ export interface CreateQuery {
636
+ /** 文档类型 */
637
+ file_type: 'doc' | 'sheet' | 'file' | 'docx'
638
+ /** 此次调用中使用的用户ID的类型 */
639
+ user_id_type?: 'user_id' | 'union_id' | 'open_id'
640
+ }
641
+
642
+ export interface CreateResponse {
643
+ /** 回复内容 */
644
+ content: Lark.ReplyContent
645
+ /** 回复 ID */
646
+ reply_id?: string
647
+ /** 用户 ID */
648
+ user_id?: string
649
+ /** 创建时间 */
650
+ create_time?: number
651
+ /** 更新时间 */
652
+ update_time?: number
653
+ /** 回复的其他内容,图片 Token 等 */
654
+ extra?: Lark.ReplyExtra
655
+ /** 评论回复卡片上对应的表情回复信息 */
656
+ reactions?: Lark.FileCommentV2BatchQueryReactionData[]
657
+ }
658
+
623
659
  export interface ListQuery extends Pagination {
624
660
  /** 文档类型 */
625
661
  file_type: 'doc' | 'sheet' | 'file' | 'docx'
@@ -953,6 +989,46 @@ export namespace Drive {
953
989
  }
954
990
  }
955
991
 
992
+ export namespace User {
993
+ export interface Methods {
994
+ /**
995
+ * 订阅用户云文档事件
996
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/user/subscription
997
+ */
998
+ subscription(body: SubscriptionRequest): Promise<void>
999
+ /**
1000
+ * 取消用户云文档事件订阅
1001
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/user/remove_subscription
1002
+ */
1003
+ removeSubscription(query?: RemoveSubscriptionQuery): Promise<void>
1004
+ /**
1005
+ * 查询用户云文档事件订阅状态
1006
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/user/subscription_status
1007
+ */
1008
+ subscriptionStatus(query?: SubscriptionStatusQuery): Promise<SubscriptionStatusResponse>
1009
+ }
1010
+
1011
+ export interface SubscriptionRequest {
1012
+ /** 事件类型 */
1013
+ event_type: string
1014
+ }
1015
+
1016
+ export interface RemoveSubscriptionQuery {
1017
+ /** 事件类型 */
1018
+ event_type: string
1019
+ }
1020
+
1021
+ export interface SubscriptionStatusQuery {
1022
+ /** 事件类型 */
1023
+ event_type: string
1024
+ }
1025
+
1026
+ export interface SubscriptionStatusResponse {
1027
+ /** 订阅状态 */
1028
+ data: string
1029
+ }
1030
+ }
1031
+
956
1032
  export namespace Permission {
957
1033
  export interface Methods {
958
1034
  member: Member.Methods
@@ -1236,6 +1312,30 @@ export namespace Drive {
1236
1312
  }
1237
1313
  }
1238
1314
  }
1315
+
1316
+ export namespace CommentReaction {
1317
+ export interface Methods {
1318
+ /**
1319
+ * 添加/取消表情回应
1320
+ * @see https://open.feishu.cn/document/ukTMukTMukTM/uIzNzUjLyczM14iM3MTN/drive-v2/comment_reaction/update_reaction
1321
+ */
1322
+ updateReaction(file_token: string, body: UpdateReactionRequest, query?: UpdateReactionQuery): Promise<void>
1323
+ }
1324
+
1325
+ export interface UpdateReactionRequest {
1326
+ /** 操作类型: add/delete */
1327
+ action: 'add' | 'delete'
1328
+ /** 回复 ID */
1329
+ reply_id: string
1330
+ /** reaction 类型 */
1331
+ reaction_type: string
1332
+ }
1333
+
1334
+ export interface UpdateReactionQuery {
1335
+ /** 文件类型,用于区分不同类型的云文档,可选值需参考开放平台文件类型枚举规范。 */
1336
+ file_type: string
1337
+ }
1338
+ }
1239
1339
  }
1240
1340
 
1241
1341
  Internal.define({
@@ -1337,6 +1437,15 @@ Internal.define({
1337
1437
  '/drive/v1/files/{file_token}/delete_subscribe': {
1338
1438
  DELETE: 'drive.file.deleteSubscribe',
1339
1439
  },
1440
+ '/drive/v1/user/subscription': {
1441
+ POST: 'drive.user.subscription',
1442
+ },
1443
+ '/drive/v1/user/remove_subscription': {
1444
+ DELETE: 'drive.user.removeSubscription',
1445
+ },
1446
+ '/drive/v1/user/subscription_status': {
1447
+ GET: 'drive.user.subscriptionStatus',
1448
+ },
1340
1449
  '/drive/v1/permissions/{token}/members': {
1341
1450
  POST: 'drive.permission.member.create',
1342
1451
  GET: 'drive.permission.member.list',
@@ -1375,12 +1484,16 @@ Internal.define({
1375
1484
  GET: 'drive.file.comment.get',
1376
1485
  },
1377
1486
  '/drive/v1/files/{file_token}/comments/{comment_id}/replies': {
1487
+ POST: 'drive.file.comment.reply.create',
1378
1488
  GET: { name: 'drive.file.comment.reply.list', pagination: { argIndex: 2 } },
1379
1489
  },
1380
1490
  '/drive/v1/files/{file_token}/comments/{comment_id}/replies/{reply_id}': {
1381
1491
  PUT: 'drive.file.comment.reply.update',
1382
1492
  DELETE: 'drive.file.comment.reply.delete',
1383
1493
  },
1494
+ '/drive/v2/files/{file_token}/comments/reaction': {
1495
+ POST: 'drive.commentReaction.updateReaction',
1496
+ },
1384
1497
  '/drive/v1/files/{file_token}/subscriptions/{subscription_id}': {
1385
1498
  GET: 'drive.file.subscription.get',
1386
1499
  PATCH: 'drive.file.subscription.patch',
package/src/types/im.ts CHANGED
@@ -64,7 +64,7 @@ export namespace Im {
64
64
  */
65
65
  pushFollowUp(message_id: string, body: PushFollowUpRequest): Promise<void>
66
66
  /**
67
- * 查询消息已读信息
67
+ * 消息发送者查询消息已读状态
68
68
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/read_users
69
69
  */
70
70
  readUsers(message_id: string, query?: ReadUsersQuery): Paginated<Lark.ReadUser>
@@ -406,6 +406,11 @@ export namespace Im {
406
406
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/list
407
407
  */
408
408
  list(message_id: string, query?: ListQuery): Paginated<Lark.MessageReaction>
409
+ /**
410
+ * 批量获取消息表情回复
411
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/batch_query
412
+ */
413
+ batchQuery(body: BatchQueryRequest, query?: BatchQueryQuery): Promise<BatchQueryResponse>
409
414
  /**
410
415
  * 删除消息表情回复
411
416
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/delete
@@ -439,6 +444,29 @@ export namespace Im {
439
444
  user_id_type?: 'open_id' | 'union_id' | 'user_id'
440
445
  }
441
446
 
447
+ export interface BatchQueryRequest {
448
+ /** 要查询的消息 */
449
+ queries: Lark.MessageQuery[]
450
+ /** 每个消息最多返回多少个表情 */
451
+ page_size_per_message?: number
452
+ /** 表情类型 */
453
+ reaction_type?: string
454
+ }
455
+
456
+ export interface BatchQueryQuery {
457
+ /** 用户 ID 类型,控制接口返回值中表情添加者的ID */
458
+ user_id_type?: 'user_id' | 'union_id' | 'open_id'
459
+ }
460
+
461
+ export interface BatchQueryResponse {
462
+ /** 成功获取到的表情列表 */
463
+ success_msg_reaction_details?: Lark.SuccessMsgReactionDetails[]
464
+ /** 成功获取到的表情数量统计 */
465
+ success_msg_reaction_counts?: Lark.SuccessMsgReactionCount[]
466
+ /** 未成功获取的消息 */
467
+ fail_msg_reaction_details?: Lark.FailMsgReactionDetails[]
468
+ }
469
+
442
470
  export interface DeleteResponse {
443
471
  /** reaction资源ID */
444
472
  reaction_id?: string
@@ -1696,6 +1724,9 @@ Internal.define({
1696
1724
  POST: 'im.message.reaction.create',
1697
1725
  GET: { name: 'im.message.reaction.list', pagination: { argIndex: 1 } },
1698
1726
  },
1727
+ '/im/messages/reactions/batch_query': {
1728
+ POST: 'im.message.reaction.batchQuery',
1729
+ },
1699
1730
  '/im/v1/messages/{message_id}/reactions/{reaction_id}': {
1700
1731
  DELETE: 'im.message.reaction.delete',
1701
1732
  },