meeglesdk 0.1.8 → 0.2.0

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.
Files changed (61) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.md +164 -7
  3. package/RELEASE.md +48 -0
  4. package/dist/client.d.ts +9 -0
  5. package/dist/client.js +10 -0
  6. package/dist/core/base-service.d.ts +2 -0
  7. package/dist/core/base-service.js +12 -0
  8. package/dist/core/request/handler.js +3 -2
  9. package/dist/core/request/types.d.ts +2 -0
  10. package/dist/helpers/event.d.ts +1 -1
  11. package/dist/helpers/event.js +14 -0
  12. package/dist/index.d.ts +14 -10
  13. package/dist/index.js +3 -0
  14. package/dist/service/aifield/index.d.ts +26 -0
  15. package/dist/service/aifield/index.js +27 -0
  16. package/dist/service/config/resource.d.ts +3 -3
  17. package/dist/service/config/resource.js +5 -1
  18. package/dist/service/config/role.d.ts +2 -1
  19. package/dist/service/config/role.js +2 -1
  20. package/dist/service/measure/index.d.ts +8 -0
  21. package/dist/service/measure/index.js +10 -0
  22. package/dist/service/measure/query.d.ts +31 -1
  23. package/dist/service/measure/query.js +31 -16
  24. package/dist/service/view/query.d.ts +10 -1
  25. package/dist/service/view/query.js +15 -0
  26. package/dist/service/workitem/attachment.d.ts +12 -12
  27. package/dist/service/workitem/attachment.js +8 -8
  28. package/dist/service/workitem/comment.d.ts +11 -11
  29. package/dist/service/workitem/comment.js +7 -7
  30. package/dist/service/workitem/search.d.ts +3 -7
  31. package/dist/service/workitem/search.js +8 -8
  32. package/dist/service/workitem/wbsDraft/index.d.ts +191 -0
  33. package/dist/service/workitem/wbsDraft/index.js +264 -0
  34. package/dist/service/workitem/wbsDraft.d.ts +191 -0
  35. package/dist/service/workitem/wbsDraft.js +394 -0
  36. package/dist/service/workitem/wbsProjectKeyResolver.d.ts +34 -0
  37. package/dist/service/workitem/wbsProjectKeyResolver.js +133 -0
  38. package/dist/service/workitem/wbsView/index.d.ts +46 -0
  39. package/dist/service/workitem/wbsView/index.js +51 -0
  40. package/dist/service/workitem/wbsView.d.ts +48 -0
  41. package/dist/service/workitem/wbsView.js +86 -0
  42. package/dist/service/workitem/workItem.d.ts +30 -7
  43. package/dist/service/workitem/workItem.js +43 -10
  44. package/dist/service/workitem/workflow.d.ts +2 -2
  45. package/dist/service/workitem/workflow.js +1 -0
  46. package/dist/service/workitem/workhour.d.ts +3 -3
  47. package/dist/types/aifield.d.ts +12 -0
  48. package/dist/types/aifield.js +4 -0
  49. package/dist/types/ainode.d.ts +70 -40
  50. package/dist/types/ainode.js +0 -3
  51. package/dist/types/common.d.ts +7 -1
  52. package/dist/types/config.d.ts +85 -22
  53. package/dist/types/event.d.ts +176 -9
  54. package/dist/types/index.d.ts +2 -0
  55. package/dist/types/index.js +2 -0
  56. package/dist/types/measure.d.ts +7 -0
  57. package/dist/types/tenant.d.ts +17 -4
  58. package/dist/types/user.d.ts +5 -1
  59. package/dist/types/view.d.ts +6 -0
  60. package/dist/types/workitem.d.ts +1413 -159
  61. package/package.json +8 -4
@@ -0,0 +1,191 @@
1
+ /**
2
+ * WBS 草稿服务
3
+ *
4
+ * 之所以单独拆出这个服务,是因为计划表草稿接口已经形成独立能力域,
5
+ * 继续混在 workflow 服务里会让文档对齐、接口扩展和测试边界越来越混乱。
6
+ */
7
+ import { BaseService, type ServiceRequestOptions } from '../../../core/base-service.js';
8
+ import type { CreateWbsDraftRequest, CreateWbsDraftResponse, QueryWbsDraftRequest, WbsDraft, PatchWbsDraftRequest, PatchWbsDraftResponse, PublishWbsDraftRequest, PublishWbsDraftResponse, CompleteCreateAuditDraftRequest, UpdateWbsDraftFrozenRowsRequest, PublishWbsDraftByCommitRequest, SwitchBackWbsDraftRequest, CreateWbsDraftProgressRequest, CreateWbsDraftProgressResponse, PatchWbsDraftProgressRequest, PatchWbsDraftProgressResponse, PublishWbsDraftProgressRequest, PublishWbsDraftProgressResponse, ResetWbsDraftProgressRequest, ResetWbsDraftProgressResponse, ResetWbsDraftRequest, ResetWbsDraftResponse, QueryWbsDraftStructureRequest, QueryWbsDraftStructureResponse, QueryWbsDraftRowDetailRequest, QueryWbsDraftRowDetailResponse, QueryWbsDraftRowConfigRequest, QueryWbsDraftRowConfigResponse, GetWbsDraftSubWorkItemConfRequest, WbsDraftSubWorkItemConf, WbsDraftSuccessResponse } from '../../../types/workitem.js';
9
+ /** API 路径 */
10
+ export declare const API_PATHS: {
11
+ /** 创建 WBS 草稿 */
12
+ CREATE: string;
13
+ /** 查询 WBS 草稿 */
14
+ QUERY: string;
15
+ /** 查询创建草稿进度 */
16
+ CREATE_PROGRESS: string;
17
+ /** 更新 WBS 草稿 */
18
+ PATCH: string;
19
+ /** 查询更新草稿进度 */
20
+ PATCH_PROGRESS: string;
21
+ /** 发布 WBS 草稿 */
22
+ PUBLISH: string;
23
+ /** 完成创建草稿审核 */
24
+ COMPLETE_CREATE_AUDIT: string;
25
+ /** 重置 WBS 草稿 */
26
+ RESET: string;
27
+ /** 查询发布草稿进度 */
28
+ PUBLISH_PROGRESS: string;
29
+ /** 查询重置草稿进度 */
30
+ RESET_PROGRESS: string;
31
+ /** 查询 WBS 草稿子工作项配置 */
32
+ SUB_WORK_ITEM_CONF: string;
33
+ /** 查询 WBS 草稿骨架 */
34
+ STRUCTURE: string;
35
+ /** 查询 WBS 草稿行详情 */
36
+ ROW_DETAIL: string;
37
+ /** 查询 WBS 草稿行配置 */
38
+ ROW_CONFIG: string;
39
+ /** 更新草稿冻结行 */
40
+ UPDATE_FROZEN_ROWS: string;
41
+ /** 基于提交版本发布草稿 */
42
+ COLLABORATION_PUBLISH: string;
43
+ /** 审批拒绝切回草稿 */
44
+ SWITCH_BACK: string;
45
+ };
46
+ /**
47
+ * WBS 草稿服务
48
+ */
49
+ export declare class WbsDraftService extends BaseService {
50
+ /**
51
+ * 创建 WBS 草稿
52
+ *
53
+ * @param request 创建请求
54
+ * @param options 请求选项
55
+ * @returns 创建草稿结果
56
+ */
57
+ createDraft(request: CreateWbsDraftRequest, options?: ServiceRequestOptions<CreateWbsDraftResponse>): Promise<CreateWbsDraftResponse>;
58
+ /**
59
+ * 查询 WBS 草稿
60
+ *
61
+ * @param request 查询请求
62
+ * @param options 请求选项
63
+ * @returns WBS 草稿
64
+ */
65
+ getDraft(request: QueryWbsDraftRequest, options?: ServiceRequestOptions<WbsDraft>): Promise<WbsDraft>;
66
+ /**
67
+ * 更新 WBS 草稿
68
+ *
69
+ * @param request 更新请求
70
+ * @param options 请求选项
71
+ * @returns 平台返回的关系字段回填结果
72
+ */
73
+ patchDraft(request: PatchWbsDraftRequest, options?: ServiceRequestOptions<PatchWbsDraftResponse>): Promise<PatchWbsDraftResponse>;
74
+ /**
75
+ * 发布 WBS 草稿
76
+ *
77
+ * @param request 发布请求
78
+ * @param options 请求选项
79
+ */
80
+ publishDraft(request: PublishWbsDraftRequest, options?: ServiceRequestOptions<PublishWbsDraftResponse>): Promise<PublishWbsDraftResponse>;
81
+ /**
82
+ * 查询创建草稿进度
83
+ *
84
+ * @param request 进度查询请求
85
+ * @param options 请求选项
86
+ * @returns 任务进度
87
+ */
88
+ getCreateDraftProgress(request: CreateWbsDraftProgressRequest, options?: ServiceRequestOptions<CreateWbsDraftProgressResponse>): Promise<CreateWbsDraftProgressResponse>;
89
+ /**
90
+ * 完成创建草稿审核
91
+ *
92
+ * 这条接口和普通草稿发布链路分离,
93
+ * 单独暴露可以避免调用方误把审核态提交当成普通发布。
94
+ *
95
+ * @param request 审核完成请求
96
+ * @param options 请求选项
97
+ * @returns 是否成功
98
+ */
99
+ completeCreateAuditDraft(request: CompleteCreateAuditDraftRequest, options?: ServiceRequestOptions<WbsDraftSuccessResponse>): Promise<WbsDraftSuccessResponse>;
100
+ /**
101
+ * 重置 WBS 草稿
102
+ *
103
+ * @param request 重置请求
104
+ * @param options 请求选项
105
+ * @returns 重置后的 WBS 草稿
106
+ */
107
+ resetDraft(request: ResetWbsDraftRequest, options?: ServiceRequestOptions<ResetWbsDraftResponse>): Promise<ResetWbsDraftResponse>;
108
+ /**
109
+ * 查询更新草稿进度
110
+ *
111
+ * @param request 进度查询请求
112
+ * @param options 请求选项
113
+ * @returns 任务进度
114
+ */
115
+ getPatchDraftProgress(request: PatchWbsDraftProgressRequest, options?: ServiceRequestOptions<PatchWbsDraftProgressResponse>): Promise<PatchWbsDraftProgressResponse>;
116
+ /**
117
+ * 查询 WBS 草稿子工作项配置
118
+ *
119
+ * @param request 查询请求
120
+ * @param options 请求选项
121
+ * @returns 子工作项配置列表
122
+ */
123
+ getSubWorkItemConf(request: GetWbsDraftSubWorkItemConfRequest, options?: ServiceRequestOptions<WbsDraftSubWorkItemConf[]>): Promise<WbsDraftSubWorkItemConf[]>;
124
+ /**
125
+ * 查询全量计划表草稿骨架
126
+ *
127
+ * 唯一文档只保留了能力名称,没有保留字段表,
128
+ * 因此这里按“请求透传、响应透传”的方式先把能力占位补齐,
129
+ * 等后续拿到更完整字段后再做结构收紧。
130
+ *
131
+ * @param request 草稿骨架查询请求
132
+ * @param options 请求选项
133
+ * @returns 草稿骨架原始响应
134
+ */
135
+ queryStructure(request: QueryWbsDraftStructureRequest, options?: ServiceRequestOptions<QueryWbsDraftStructureResponse>): Promise<QueryWbsDraftStructureResponse>;
136
+ /**
137
+ * 查询计划表草稿数据行详细信息
138
+ *
139
+ * @param request 草稿行详情查询请求
140
+ * @param options 请求选项
141
+ * @returns 草稿行详情原始响应
142
+ */
143
+ queryRowDetails(request: QueryWbsDraftRowDetailRequest, options?: ServiceRequestOptions<QueryWbsDraftRowDetailResponse>): Promise<QueryWbsDraftRowDetailResponse>;
144
+ /**
145
+ * 查询计划表草稿行配置信息
146
+ *
147
+ * @param request 草稿行配置查询请求
148
+ * @param options 请求选项
149
+ * @returns 草稿行配置原始响应
150
+ */
151
+ queryRowConfig(request: QueryWbsDraftRowConfigRequest, options?: ServiceRequestOptions<QueryWbsDraftRowConfigResponse>): Promise<QueryWbsDraftRowConfigResponse>;
152
+ /**
153
+ * 更新草稿冻结行
154
+ *
155
+ * @param request 冻结行更新请求
156
+ * @param options 请求选项
157
+ */
158
+ updateFrozenRows(request: UpdateWbsDraftFrozenRowsRequest, options?: ServiceRequestOptions<void>): Promise<void>;
159
+ /**
160
+ * 基于提交版本发布草稿
161
+ *
162
+ * @param request 发布请求
163
+ * @param options 请求选项
164
+ * @returns 是否成功
165
+ */
166
+ publishDraftByCommit(request: PublishWbsDraftByCommitRequest, options?: ServiceRequestOptions<WbsDraftSuccessResponse>): Promise<WbsDraftSuccessResponse>;
167
+ /**
168
+ * 查询发布草稿进度
169
+ *
170
+ * @param request 进度查询请求
171
+ * @param options 请求选项
172
+ * @returns 任务进度
173
+ */
174
+ getPublishDraftProgress(request: PublishWbsDraftProgressRequest, options?: ServiceRequestOptions<PublishWbsDraftProgressResponse>): Promise<PublishWbsDraftProgressResponse>;
175
+ /**
176
+ * 审批拒绝后切回草稿
177
+ *
178
+ * @param request 切回草稿请求
179
+ * @param options 请求选项
180
+ * @returns 是否成功
181
+ */
182
+ switchBackDraft(request: SwitchBackWbsDraftRequest, options?: ServiceRequestOptions<WbsDraftSuccessResponse>): Promise<WbsDraftSuccessResponse>;
183
+ /**
184
+ * 查询重置草稿进度
185
+ *
186
+ * @param request 进度查询请求
187
+ * @param options 请求选项
188
+ * @returns 任务进度
189
+ */
190
+ getResetDraftProgress(request: ResetWbsDraftProgressRequest, options?: ServiceRequestOptions<ResetWbsDraftProgressResponse>): Promise<ResetWbsDraftProgressResponse>;
191
+ }
@@ -0,0 +1,264 @@
1
+ /**
2
+ * WBS 草稿服务
3
+ *
4
+ * 之所以单独拆出这个服务,是因为计划表草稿接口已经形成独立能力域,
5
+ * 继续混在 workflow 服务里会让文档对齐、接口扩展和测试边界越来越混乱。
6
+ */
7
+ import { BaseService } from '../../../core/base-service.js';
8
+ /** API 路径 */
9
+ export const API_PATHS = {
10
+ /** 创建 WBS 草稿 */
11
+ CREATE: '/open_api/work_item/wbs_draft/create',
12
+ /** 查询 WBS 草稿 */
13
+ QUERY: '/open_api/work_item/wbs_view_draft/query',
14
+ /** 查询创建草稿进度 */
15
+ CREATE_PROGRESS: '/open_api/work_item/wbs_draft_create/progress/query',
16
+ /** 更新 WBS 草稿 */
17
+ PATCH: '/open_api/work_item/wbs_draft/patch/update',
18
+ /** 查询更新草稿进度 */
19
+ PATCH_PROGRESS: '/open_api/work_item/wbs_draft_patch/progress/query',
20
+ /** 发布 WBS 草稿 */
21
+ PUBLISH: '/open_api/work_item/wbs_draft/publish',
22
+ /** 完成创建草稿审核 */
23
+ COMPLETE_CREATE_AUDIT: '/open_api/wbs_view_draft/complete-create-audit',
24
+ /** 重置 WBS 草稿 */
25
+ RESET: '/open_api/work_item/wbs_draft/reset',
26
+ /** 查询发布草稿进度 */
27
+ PUBLISH_PROGRESS: '/open_api/work_item/wbs_draft_publish/progress/query',
28
+ /** 查询重置草稿进度 */
29
+ RESET_PROGRESS: '/open_api/work_item/wbs_draft_reset/progress/query',
30
+ /** 查询 WBS 草稿子工作项配置 */
31
+ SUB_WORK_ITEM_CONF: '/open_api/work_item/wbs_view_draft/sub_work_item_conf',
32
+ /** 查询 WBS 草稿骨架 */
33
+ STRUCTURE: '/open_api/work_item/wbs_draft/structure/query',
34
+ /** 查询 WBS 草稿行详情 */
35
+ ROW_DETAIL: '/open_api/work_item/wbs_draft/detail/query',
36
+ /** 查询 WBS 草稿行配置 */
37
+ ROW_CONFIG: '/open_api/work_item/wbs_draft/task_conf/query',
38
+ /** 更新草稿冻结行 */
39
+ UPDATE_FROZEN_ROWS: '/open_api/:project_key/wbs_view_draft/update/frozen_rows',
40
+ /** 基于提交版本发布草稿 */
41
+ COLLABORATION_PUBLISH: '/open_api/:project_key/wbs_view_draft/publish',
42
+ /** 审批拒绝切回草稿 */
43
+ SWITCH_BACK: '/open_api/:project_key/wbs_view_draft/switch',
44
+ };
45
+ /**
46
+ * WBS 草稿服务
47
+ */
48
+ export class WbsDraftService extends BaseService {
49
+ /**
50
+ * 创建 WBS 草稿
51
+ *
52
+ * @param request 创建请求
53
+ * @param options 请求选项
54
+ * @returns 创建草稿结果
55
+ */
56
+ async createDraft(request, options) {
57
+ return this.post(API_PATHS.CREATE, request, options);
58
+ }
59
+ /**
60
+ * 查询 WBS 草稿
61
+ *
62
+ * @param request 查询请求
63
+ * @param options 请求选项
64
+ * @returns WBS 草稿
65
+ */
66
+ async getDraft(request, options) {
67
+ const result = await this.post(API_PATHS.QUERY, request, options);
68
+ return result.wbs_draft ?? {};
69
+ }
70
+ /**
71
+ * 更新 WBS 草稿
72
+ *
73
+ * @param request 更新请求
74
+ * @param options 请求选项
75
+ * @returns 平台返回的关系字段回填结果
76
+ */
77
+ async patchDraft(request, options) {
78
+ return this.post(API_PATHS.PATCH, request, options);
79
+ }
80
+ /**
81
+ * 发布 WBS 草稿
82
+ *
83
+ * @param request 发布请求
84
+ * @param options 请求选项
85
+ */
86
+ async publishDraft(request, options) {
87
+ return this.post(API_PATHS.PUBLISH, request, options);
88
+ }
89
+ /**
90
+ * 查询创建草稿进度
91
+ *
92
+ * @param request 进度查询请求
93
+ * @param options 请求选项
94
+ * @returns 任务进度
95
+ */
96
+ async getCreateDraftProgress(request, options) {
97
+ return this.post(API_PATHS.CREATE_PROGRESS, request, options);
98
+ }
99
+ /**
100
+ * 完成创建草稿审核
101
+ *
102
+ * 这条接口和普通草稿发布链路分离,
103
+ * 单独暴露可以避免调用方误把审核态提交当成普通发布。
104
+ *
105
+ * @param request 审核完成请求
106
+ * @param options 请求选项
107
+ * @returns 是否成功
108
+ */
109
+ async completeCreateAuditDraft(request, options) {
110
+ const result = await this.post(API_PATHS.COMPLETE_CREATE_AUDIT, request, options);
111
+ return { success: result.success };
112
+ }
113
+ /**
114
+ * 重置 WBS 草稿
115
+ *
116
+ * @param request 重置请求
117
+ * @param options 请求选项
118
+ * @returns 重置后的 WBS 草稿
119
+ */
120
+ async resetDraft(request, options) {
121
+ return this.post(API_PATHS.RESET, request, options);
122
+ }
123
+ /**
124
+ * 查询更新草稿进度
125
+ *
126
+ * @param request 进度查询请求
127
+ * @param options 请求选项
128
+ * @returns 任务进度
129
+ */
130
+ async getPatchDraftProgress(request, options) {
131
+ return this.post(API_PATHS.PATCH_PROGRESS, request, options);
132
+ }
133
+ /**
134
+ * 查询 WBS 草稿子工作项配置
135
+ *
136
+ * @param request 查询请求
137
+ * @param options 请求选项
138
+ * @returns 子工作项配置列表
139
+ */
140
+ async getSubWorkItemConf(request, options) {
141
+ const result = await this.get(API_PATHS.SUB_WORK_ITEM_CONF, {
142
+ ...options,
143
+ query: {
144
+ draft_id: request.draft_id,
145
+ work_item_id: request.work_item_id,
146
+ node_uuid: request.node_uuid,
147
+ project_key: request.project_key,
148
+ ...options?.query,
149
+ },
150
+ });
151
+ return result.draft_view_sub_work_item_confs ?? [];
152
+ }
153
+ /**
154
+ * 查询全量计划表草稿骨架
155
+ *
156
+ * 唯一文档只保留了能力名称,没有保留字段表,
157
+ * 因此这里按“请求透传、响应透传”的方式先把能力占位补齐,
158
+ * 等后续拿到更完整字段后再做结构收紧。
159
+ *
160
+ * @param request 草稿骨架查询请求
161
+ * @param options 请求选项
162
+ * @returns 草稿骨架原始响应
163
+ */
164
+ async queryStructure(request, options) {
165
+ return this.post(API_PATHS.STRUCTURE, request, options);
166
+ }
167
+ /**
168
+ * 查询计划表草稿数据行详细信息
169
+ *
170
+ * @param request 草稿行详情查询请求
171
+ * @param options 请求选项
172
+ * @returns 草稿行详情原始响应
173
+ */
174
+ async queryRowDetails(request, options) {
175
+ return this.post(API_PATHS.ROW_DETAIL, request, options);
176
+ }
177
+ /**
178
+ * 查询计划表草稿行配置信息
179
+ *
180
+ * @param request 草稿行配置查询请求
181
+ * @param options 请求选项
182
+ * @returns 草稿行配置原始响应
183
+ */
184
+ async queryRowConfig(request, options) {
185
+ return this.post(API_PATHS.ROW_CONFIG, request, options);
186
+ }
187
+ /**
188
+ * 更新草稿冻结行
189
+ *
190
+ * @param request 冻结行更新请求
191
+ * @param options 请求选项
192
+ */
193
+ async updateFrozenRows(request, options) {
194
+ await this.post(API_PATHS.UPDATE_FROZEN_ROWS, request, {
195
+ ...options,
196
+ pathParams: {
197
+ project_key: request.project_key,
198
+ ...options?.pathParams,
199
+ },
200
+ });
201
+ }
202
+ /**
203
+ * 基于提交版本发布草稿
204
+ *
205
+ * @param request 发布请求
206
+ * @param options 请求选项
207
+ * @returns 是否成功
208
+ */
209
+ async publishDraftByCommit(request, options) {
210
+ const result = await this.post(API_PATHS.COLLABORATION_PUBLISH, {
211
+ work_item_id: request.work_item_id,
212
+ draft_id: request.draft_id,
213
+ commit_id: request.commit_id,
214
+ }, {
215
+ ...options,
216
+ pathParams: {
217
+ project_key: request.project_key,
218
+ ...options?.pathParams,
219
+ },
220
+ });
221
+ return { success: result.success };
222
+ }
223
+ /**
224
+ * 查询发布草稿进度
225
+ *
226
+ * @param request 进度查询请求
227
+ * @param options 请求选项
228
+ * @returns 任务进度
229
+ */
230
+ async getPublishDraftProgress(request, options) {
231
+ return this.post(API_PATHS.PUBLISH_PROGRESS, request, options);
232
+ }
233
+ /**
234
+ * 审批拒绝后切回草稿
235
+ *
236
+ * @param request 切回草稿请求
237
+ * @param options 请求选项
238
+ * @returns 是否成功
239
+ */
240
+ async switchBackDraft(request, options) {
241
+ const result = await this.post(API_PATHS.SWITCH_BACK, {
242
+ work_item_id: request.work_item_id,
243
+ draft_id: request.draft_id,
244
+ commit_id: request.commit_id,
245
+ }, {
246
+ ...options,
247
+ pathParams: {
248
+ project_key: request.project_key,
249
+ ...options?.pathParams,
250
+ },
251
+ });
252
+ return { success: result.success };
253
+ }
254
+ /**
255
+ * 查询重置草稿进度
256
+ *
257
+ * @param request 进度查询请求
258
+ * @param options 请求选项
259
+ * @returns 任务进度
260
+ */
261
+ async getResetDraftProgress(request, options) {
262
+ return this.post(API_PATHS.RESET_PROGRESS, request, options);
263
+ }
264
+ }
@@ -0,0 +1,191 @@
1
+ /**
2
+ * WBS 草稿服务
3
+ *
4
+ * 之所以单独拆出这个服务,是因为计划表草稿接口已经形成独立能力域,
5
+ * 继续混在 workflow 服务里会让文档对齐、接口扩展和测试边界越来越混乱。
6
+ */
7
+ import { BaseService, type ServiceRequestOptions } from '../../core/base-service.js';
8
+ import type { CreateWbsDraftRequest, CreateWbsDraftResponse, QueryWbsDraftRequest, WbsDraft, PatchWbsDraftRequest, PatchWbsDraftResponse, PublishWbsDraftRequest, PublishWbsDraftResponse, CompleteCreateAuditDraftRequest, UpdateWbsDraftFrozenRowsRequest, PublishWbsDraftByCommitRequest, SwitchBackWbsDraftRequest, CreateWbsDraftProgressRequest, CreateWbsDraftProgressResponse, PatchWbsDraftProgressRequest, PatchWbsDraftProgressResponse, PublishWbsDraftProgressRequest, PublishWbsDraftProgressResponse, ResetWbsDraftProgressRequest, ResetWbsDraftProgressResponse, ResetWbsDraftRequest, ResetWbsDraftResponse, QueryWbsDraftStructureRequest, QueryWbsDraftStructureResponse, QueryWbsDraftRowDetailRequest, QueryWbsDraftRowDetailResponse, QueryWbsDraftRowConfigRequest, QueryWbsDraftRowConfigResponse, GetWbsDraftSubWorkItemConfRequest, WbsDraftSubWorkItemConf, WbsDraftSuccessResponse } from '../../types/workitem.js';
9
+ /** API 路径 */
10
+ export declare const API_PATHS: {
11
+ /** 创建 WBS 草稿 */
12
+ CREATE: string;
13
+ /** 查询 WBS 草稿 */
14
+ QUERY: string;
15
+ /** 查询创建草稿进度 */
16
+ CREATE_PROGRESS: string;
17
+ /** 更新 WBS 草稿 */
18
+ PATCH: string;
19
+ /** 查询更新草稿进度 */
20
+ PATCH_PROGRESS: string;
21
+ /** 发布 WBS 草稿 */
22
+ PUBLISH: string;
23
+ /** 完成创建草稿审核 */
24
+ COMPLETE_CREATE_AUDIT: string;
25
+ /** 重置 WBS 草稿 */
26
+ RESET: string;
27
+ /** 查询发布草稿进度 */
28
+ PUBLISH_PROGRESS: string;
29
+ /** 查询重置草稿进度 */
30
+ RESET_PROGRESS: string;
31
+ /** 查询 WBS 草稿子工作项配置 */
32
+ SUB_WORK_ITEM_CONF: string;
33
+ /** 查询 WBS 草稿骨架 */
34
+ STRUCTURE: string;
35
+ /** 查询 WBS 草稿行详情 */
36
+ ROW_DETAIL: string;
37
+ /** 查询 WBS 草稿行配置 */
38
+ ROW_CONFIG: string;
39
+ /** 更新草稿冻结行 */
40
+ UPDATE_FROZEN_ROWS: string;
41
+ /** 基于提交版本发布草稿 */
42
+ COLLABORATION_PUBLISH: string;
43
+ /** 审批拒绝切回草稿 */
44
+ SWITCH_BACK: string;
45
+ };
46
+ /**
47
+ * WBS 草稿服务
48
+ */
49
+ export declare class WbsDraftService extends BaseService {
50
+ private readonly projectKeyResolver;
51
+ constructor(requestHandler: ConstructorParameters<typeof BaseService>[0]);
52
+ /**
53
+ * 创建 WBS 草稿
54
+ *
55
+ * @param request 创建请求
56
+ * @param options 请求选项
57
+ * @returns 创建草稿结果
58
+ */
59
+ createDraft(request: CreateWbsDraftRequest, options?: ServiceRequestOptions<CreateWbsDraftResponse>): Promise<CreateWbsDraftResponse>;
60
+ /**
61
+ * 查询 WBS 草稿
62
+ *
63
+ * @param request 查询请求
64
+ * @param options 请求选项
65
+ * @returns WBS 草稿
66
+ */
67
+ getDraft(request: QueryWbsDraftRequest, options?: ServiceRequestOptions<WbsDraft>): Promise<WbsDraft>;
68
+ /**
69
+ * 更新 WBS 草稿
70
+ *
71
+ * @param request 更新请求
72
+ * @param options 请求选项
73
+ * @returns 平台返回的关系字段回填结果
74
+ */
75
+ patchDraft(request: PatchWbsDraftRequest, options?: ServiceRequestOptions<PatchWbsDraftResponse>): Promise<PatchWbsDraftResponse>;
76
+ /**
77
+ * 发布 WBS 草稿
78
+ *
79
+ * @param request 发布请求
80
+ * @param options 请求选项
81
+ */
82
+ publishDraft(request: PublishWbsDraftRequest, options?: ServiceRequestOptions<PublishWbsDraftResponse>): Promise<PublishWbsDraftResponse>;
83
+ /**
84
+ * 查询创建草稿进度
85
+ *
86
+ * @param request 进度查询请求
87
+ * @param options 请求选项
88
+ * @returns 任务进度
89
+ */
90
+ getCreateDraftProgress(request: CreateWbsDraftProgressRequest, options?: ServiceRequestOptions<CreateWbsDraftProgressResponse>): Promise<CreateWbsDraftProgressResponse>;
91
+ /**
92
+ * 完成创建草稿审核
93
+ *
94
+ * 这条接口和普通草稿发布链路分离,
95
+ * 单独暴露可以避免调用方误把审核态提交当成普通发布。
96
+ *
97
+ * @param request 审核完成请求
98
+ * @param options 请求选项
99
+ * @returns 是否成功
100
+ */
101
+ completeCreateAuditDraft(request: CompleteCreateAuditDraftRequest, options?: ServiceRequestOptions<WbsDraftSuccessResponse>): Promise<WbsDraftSuccessResponse>;
102
+ /**
103
+ * 重置 WBS 草稿
104
+ *
105
+ * @param request 重置请求
106
+ * @param options 请求选项
107
+ * @returns 重置后的 WBS 草稿
108
+ */
109
+ resetDraft(request: ResetWbsDraftRequest, options?: ServiceRequestOptions<ResetWbsDraftResponse>): Promise<ResetWbsDraftResponse>;
110
+ /**
111
+ * 查询更新草稿进度
112
+ *
113
+ * @param request 进度查询请求
114
+ * @param options 请求选项
115
+ * @returns 任务进度
116
+ */
117
+ getPatchDraftProgress(request: PatchWbsDraftProgressRequest, options?: ServiceRequestOptions<PatchWbsDraftProgressResponse>): Promise<PatchWbsDraftProgressResponse>;
118
+ /**
119
+ * 查询 WBS 草稿子工作项配置
120
+ *
121
+ * @param request 查询请求
122
+ * @param options 请求选项
123
+ * @returns 子工作项配置列表
124
+ */
125
+ getSubWorkItemConf(request: GetWbsDraftSubWorkItemConfRequest, options?: ServiceRequestOptions<WbsDraftSubWorkItemConf[]>): Promise<WbsDraftSubWorkItemConf[]>;
126
+ /**
127
+ * 查询全量计划表草稿骨架
128
+ *
129
+ * 草稿骨架是后续行详情查询的前置输入,保持独立方法可以让调用链路更清晰。
130
+ *
131
+ * @param request 草稿骨架查询请求
132
+ * @param options 请求选项
133
+ * @returns 草稿骨架响应
134
+ */
135
+ queryStructure(request: QueryWbsDraftStructureRequest, options?: ServiceRequestOptions<QueryWbsDraftStructureResponse>): Promise<QueryWbsDraftStructureResponse>;
136
+ /**
137
+ * 查询计划表草稿数据行详细信息
138
+ *
139
+ * @param request 草稿行详情查询请求
140
+ * @param options 请求选项
141
+ * @returns 草稿行详情原始响应
142
+ */
143
+ queryRowDetails(request: QueryWbsDraftRowDetailRequest, options?: ServiceRequestOptions<QueryWbsDraftRowDetailResponse>): Promise<QueryWbsDraftRowDetailResponse>;
144
+ /**
145
+ * 查询计划表草稿行配置信息
146
+ *
147
+ * @param request 草稿行配置查询请求
148
+ * @param options 请求选项
149
+ * @returns 草稿行配置原始响应
150
+ */
151
+ queryRowConfig(request: QueryWbsDraftRowConfigRequest, options?: ServiceRequestOptions<QueryWbsDraftRowConfigResponse>): Promise<QueryWbsDraftRowConfigResponse>;
152
+ /**
153
+ * 更新草稿冻结行
154
+ *
155
+ * @param request 冻结行更新请求
156
+ * @param options 请求选项
157
+ */
158
+ updateFrozenRows(request: UpdateWbsDraftFrozenRowsRequest, options?: ServiceRequestOptions<void>): Promise<void>;
159
+ /**
160
+ * 基于提交版本发布草稿
161
+ *
162
+ * @param request 发布请求
163
+ * @param options 请求选项
164
+ * @returns 是否成功
165
+ */
166
+ publishDraftByCommit(request: PublishWbsDraftByCommitRequest, options?: ServiceRequestOptions<WbsDraftSuccessResponse>): Promise<WbsDraftSuccessResponse>;
167
+ /**
168
+ * 查询发布草稿进度
169
+ *
170
+ * @param request 进度查询请求
171
+ * @param options 请求选项
172
+ * @returns 任务进度
173
+ */
174
+ getPublishDraftProgress(request: PublishWbsDraftProgressRequest, options?: ServiceRequestOptions<PublishWbsDraftProgressResponse>): Promise<PublishWbsDraftProgressResponse>;
175
+ /**
176
+ * 审批拒绝后切回草稿
177
+ *
178
+ * @param request 切回草稿请求
179
+ * @param options 请求选项
180
+ * @returns 是否成功
181
+ */
182
+ switchBackDraft(request: SwitchBackWbsDraftRequest, options?: ServiceRequestOptions<WbsDraftSuccessResponse>): Promise<WbsDraftSuccessResponse>;
183
+ /**
184
+ * 查询重置草稿进度
185
+ *
186
+ * @param request 进度查询请求
187
+ * @param options 请求选项
188
+ * @returns 任务进度
189
+ */
190
+ getResetDraftProgress(request: ResetWbsDraftProgressRequest, options?: ServiceRequestOptions<ResetWbsDraftProgressResponse>): Promise<ResetWbsDraftProgressResponse>;
191
+ }