meeglesdk 0.1.0

package/dist/service/workitem/search.js

@@ -0,0 +1,242 @@
+/**
+ * 搜索服务
+ * 100% 参考 Meego API 文档
+ *
+ * 提供工作项的多种搜索方式：
+ * - 筛选（单空间/跨空间）
+ * - 复杂条件搜索
+ * - 关联工作项搜索
+ * - 全局搜索
+ */
+import { BaseService } from '../../core/base-service.js';
+/** API 路径 */
+export const API_PATHS = {
+    /** 筛选工作项（单空间） */
+    FILTER: '/open_api/:project_key/work_item/filter',
+    /** 筛选工作项（跨空间） */
+    FILTER_ACROSS_PROJECT: '/open_api/work_items/filter_across_project',
+    /** 复杂条件搜索（单空间） */
+    SEARCH_BY_PARAMS: '/open_api/:project_key/work_item/:work_item_type_key/search/params',
+    /** 关联工作项搜索（单空间） */
+    SEARCH_BY_RELATION: '/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/search_by_relation',
+    /** 全局搜索 */
+    COMPOSITIVE_SEARCH: '/open_api/compositive_search',
+};
+/**
+ * 搜索服务
+ *
+ * 提供工作项的多种搜索能力
+ */
+export class SearchService extends BaseService {
+    /**
+     * 筛选工作项（单空间）
+     *
+     * 在指定空间内，根据工作项名称、用户、ID、时间、状态等条件筛选工作项
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param request 筛选请求
+     * @param options 请求选项
+     * @returns 分页的工作项列表（最多 5000 条）
+     *
+     * @example
+     * ```typescript
+     * // 按工作项类型和名称筛选
+     * const result = await client.workItem.search.filter('my-project', {
+     *   work_item_type_keys: ['story'],
+     *   work_item_name: '需求',
+     *   page_size: 20,
+     * });
+     *
+     * // 按工作项 ID 列表精确查询
+     * const result = await client.workItem.search.filter('my-project', {
+     *   work_item_type_keys: ['story', 'bug'],
+     *   work_item_ids: [123, 456, 789],
+     * });
+     *
+     * // 按时间范围筛选
+     * const result = await client.workItem.search.filter('my-project', {
+     *   work_item_type_keys: ['story'],
+     *   created_at: {
+     *     start: Date.now() - 7 * 24 * 60 * 60 * 1000, // 7天前
+     *     end: Date.now(),
+     *   },
+     * });
+     * ```
+     */
+    async filter(projectKey, request, options) {
+        return this.postPaginated(API_PATHS.FILTER, request, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 筛选工作项（跨空间）
+     *
+     * 跨多个空间搜索符合条件的工作项
+     *
+     * @param request 筛选请求
+     * @param options 请求选项
+     * @returns 分页的工作项列表（最多 5000 条）
+     *
+     * @example
+     * ```typescript
+     * // 跨空间筛选需求
+     * const result = await client.workItem.search.filterAcrossProject({
+     *   work_item_type_key: 'story',
+     *   project_keys: ['project1', 'project2'],
+     *   work_item_name: '需求',
+     * });
+     *
+     * // 按用户筛选
+     * const result = await client.workItem.search.filterAcrossProject({
+     *   work_item_type_key: 'story',
+     *   search_user: {
+     *     user_keys: ['user123'],
+     *     field_key: 'created_by',
+     *   },
+     * });
+     * ```
+     */
+    async filterAcrossProject(request, options) {
+        return this.postPaginated(API_PATHS.FILTER_ACROSS_PROJECT, request, options);
+    }
+    /**
+     * 复杂条件搜索（单空间）
+     *
+     * 使用复杂的搜索条件组合搜索工作项，支持多种操作符和嵌套条件
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param request 搜索请求
+     * @param options 请求选项
+     * @returns 分页的工作项列表（最多 5000 条）
+     *
+     * @example
+     * ```typescript
+     * // 搜索指定 ID 的工作项
+     * const result = await client.workItem.search.searchByParams('my-project', 'story', {
+     *   search_group: {
+     *     conjunction: 'AND',
+     *     search_params: [
+     *       {
+     *         param_key: 'work_item_id',
+     *         value: [123456],
+     *         operator: 'HAS ANY OF',
+     *       },
+     *     ],
+     *   },
+     * });
+     *
+     * // 组合条件搜索
+     * const result = await client.workItem.search.searchByParams('my-project', 'story', {
+     *   search_group: {
+     *     conjunction: 'AND',
+     *     search_params: [
+     *       { param_key: 'priority', value: ['P0', 'P1'], operator: 'HAS ANY OF' },
+     *       { param_key: 'created_at', value: 1700000000000, operator: '>=' },
+     *     ],
+     *   },
+     *   expand: { need_workflow: true },
+     * });
+     * ```
+     */
+    async searchByParams(projectKey, workItemTypeKey, request, options) {
+        return this.postPaginated(API_PATHS.SEARCH_BY_PARAMS, request, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 搜索关联工作项
+     *
+     * 获取与指定工作项存在关联关系的工作项列表
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param request 搜索请求
+     * @param options 请求选项
+     * @returns 分页的关联工作项列表（最多 2000 条）
+     *
+     * @example
+     * ```typescript
+     * // 获取需求关联的缺陷列表
+     * const result = await client.workItem.search.searchByRelation(
+     *   'my-project',
+     *   'story',
+     *   123456,
+     *   {
+     *     relation_work_item_type_key: 'issue',
+     *     relation_key: '_field_linked_story',
+     *   }
+     * );
+     *
+     * // 使用对接标识查询
+     * const result = await client.workItem.search.searchByRelation(
+     *   'my-project',
+     *   'story',
+     *   123456,
+     *   {
+     *     relation_work_item_type_key: 'bug',
+     *     relation_key: 'my_relation_alias',
+     *     relation_type: 1, // 使用对接标识
+     *   }
+     * );
+     * ```
+     */
+    async searchByRelation(projectKey, workItemTypeKey, workItemId, request, options) {
+        return this.postPaginated(API_PATHS.SEARCH_BY_RELATION, request, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                work_item_id: String(workItemId),
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 全局搜索
+     *
+     * 按照标题、描述、人员等多字段跨空间搜索工作项或视图
+     *
+     * @param request 搜索请求
+     * @param options 请求选项
+     * @returns 分页的搜索结果（最多 200 条）
+     *
+     * @example
+     * ```typescript
+     * // 搜索工作项
+     * const result = await client.workItem.search.compositiveSearch({
+     *   query_type: 'workitem',
+     *   query: '测试需求',
+     *   query_sub_type: ['story'],
+     *   page_size: 20,
+     * });
+     *
+     * // 搜索视图
+     * const result = await client.workItem.search.compositiveSearch({
+     *   query_type: 'view',
+     *   query: '我的视图',
+     * });
+     *
+     * // 限定空间范围搜索
+     * const result = await client.workItem.search.compositiveSearch({
+     *   query_type: 'workitem',
+     *   query: '紧急',
+     *   project_keys: ['project1', 'project2'],
+     * });
+     * ```
+     */
+    async compositiveSearch(request, options) {
+        return this.postPaginated(API_PATHS.COMPOSITIVE_SEARCH, request, options);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/service/workitem/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/service/workitem/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAA8B,MAAM,4BAA4B,CAAC;AAYrF,aAAa;AACb,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,iBAAiB;IACjB,MAAM,EAAE,yCAAyC;IACjD,iBAAiB;IACjB,qBAAqB,EAAE,4CAA4C;IACnE,kBAAkB;IAClB,gBAAgB,EAAE,oEAAoE;IACtF,mBAAmB;IACnB,kBAAkB,EAChB,uFAAuF;IACzF,WAAW;IACX,kBAAkB,EAAE,8BAA8B;CACnD,CAAC;AAEF;;;;GAIG;AACH,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,KAAK,CAAC,MAAM,CACV,UAAkB,EAClB,OAA+B,EAC/B,OAAyC;QAEzC,OAAO,IAAI,CAAC,aAAa,CAAW,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE;YAC7D,GAAG,OAAO;YACV,UAAU,EAAE;gBACV,WAAW,EAAE,UAAU;gBACvB,GAAG,OAAO,EAAE,UAAU;aACvB;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,mBAAmB,CACvB,OAA4C,EAC5C,OAAyC;QAEzC,OAAO,IAAI,CAAC,aAAa,CAAW,SAAS,CAAC,qBAAqB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,KAAK,CAAC,cAAc,CAClB,UAAkB,EAClB,eAAuB,EACvB,OAAuC,EACvC,OAAyC;QAEzC,OAAO,IAAI,CAAC,aAAa,CAAW,SAAS,CAAC,gBAAgB,EAAE,OAAO,EAAE;YACvE,GAAG,OAAO;YACV,UAAU,EAAE;gBACV,WAAW,EAAE,UAAU;gBACvB,kBAAkB,EAAE,eAAe;gBACnC,GAAG,OAAO,EAAE,UAAU;aACvB;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,KAAK,CAAC,gBAAgB,CACpB,UAAkB,EAClB,eAAuB,EACvB,UAAkB,EAClB,OAAgC,EAChC,OAAyC;QAEzC,OAAO,IAAI,CAAC,aAAa,CAAW,SAAS,CAAC,kBAAkB,EAAE,OAAO,EAAE;YACzE,GAAG,OAAO;YACV,UAAU,EAAE;gBACV,WAAW,EAAE,UAAU;gBACvB,kBAAkB,EAAE,eAAe;gBACnC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC;gBAChC,GAAG,OAAO,EAAE,UAAU;aACvB;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,KAAK,CAAC,iBAAiB,CACrB,OAAiC,EACjC,OAAsD;QAEtD,OAAO,IAAI,CAAC,aAAa,CACvB,SAAS,CAAC,kBAAkB,EAC5B,OAAO,EACP,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/dist/service/workitem/subtask.d.ts

@@ -0,0 +1,193 @@
+/**
+ * 子任务服务
+ * 100% 参考 Meego API 文档
+ *
+ * 提供节点子任务的创建、更新、删除、查询、完成/回滚功能
+ */
+import { BaseService, type ServiceRequestOptions } from '../../core/base-service.js';
+import type { PaginatedResult } from '../../types/common.js';
+import type { CreateSubtaskRequest, UpdateSubtaskRequest, CompleteRollbackSubtaskRequest, GetSubtasksQuery, SearchSubtasksRequest, NodeTask, SubtaskSearchResult } from '../../types/workitem.js';
+/** API 路径 */
+export declare const API_PATHS: {
+    /** 创建子任务 */
+    CREATE: string;
+    /** 更新子任务 */
+    UPDATE: string;
+    /** 删除子任务 */
+    DELETE: string;
+    /** 获取子任务详情 */
+    GET: string;
+    /** 子任务完成/回滚 */
+    COMPLETE_ROLLBACK: string;
+    /** 获取指定的子任务列表（跨空间） */
+    SEARCH_ACROSS_PROJECT: string;
+};
+/**
+ * 子任务服务
+ *
+ * 提供节点子任务的创建、更新、删除、查询、完成/回滚功能
+ */
+export declare class SubtaskService extends BaseService {
+    /**
+     * 创建子任务
+     *
+     * 在工作项实例的指定节点上创建一个子任务
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param request 创建请求
+     * @param options 请求选项
+     * @returns 创建成功的子任务 ID
+     *
+     * @example
+     * ```typescript
+     * // 创建简单子任务
+     * const taskId = await client.workItem.subtask.create('my-project', 'story', 123456, {
+     *   node_id: 'doing',
+     *   name: '需求分析',
+     * });
+     *
+     * // 创建带排期的子任务
+     * const taskId = await client.workItem.subtask.create('my-project', 'story', 123456, {
+     *   node_id: 'doing',
+     *   name: '需求分析',
+     *   schedule: {
+     *     points: 1,
+     *     estimate_start_date: 1724169600000,
+     *     estimate_end_date: 1724428799999,
+     *   },
+     *   assignee: ['706477916559299xxxx'],
+     * });
+     * ```
+     */
+    create(projectKey: string, workItemTypeKey: string, workItemId: number, request: CreateSubtaskRequest, options?: ServiceRequestOptions<number>): Promise<number>;
+    /**
+     * 更新子任务
+     *
+     * 更新工作项实例指定节点上的子任务详细信息
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param nodeId 目标节点 ID
+     * @param taskId 子任务 ID
+     * @param request 更新请求
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * await client.workItem.subtask.update('my-project', 'story', 123456, 'doing', 789, {
+     *   name: '更新后的名称',
+     *   note: '备注信息',
+     *   schedule: {
+     *     points: 3,
+     *     estimate_start_date: 1724169600000,
+     *     estimate_end_date: 1724428799999,
+     *   },
+     * });
+     * ```
+     */
+    update(projectKey: string, workItemTypeKey: string, workItemId: number, nodeId: string, taskId: number, request: UpdateSubtaskRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+    /**
+     * 删除子任务
+     *
+     * 删除指定工作项实例中的一个子任务
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param taskId 子任务 ID
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * await client.workItem.subtask.remove('my-project', 'story', 123456, 789);
+     * ```
+     */
+    remove(projectKey: string, workItemTypeKey: string, workItemId: number, taskId: number, options?: ServiceRequestOptions<void>): Promise<void>;
+    /**
+     * 获取子任务列表
+     *
+     * 获取指定工作项实例上的子任务详细信息
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param query 查询参数
+     * @param options 请求选项
+     * @returns 节点子任务信息数组
+     *
+     * @example
+     * ```typescript
+     * // 获取所有节点的子任务
+     * const nodeTasks = await client.workItem.subtask.list('my-project', 'story', 123456);
+     *
+     * // 获取指定节点的子任务
+     * const nodeTasks = await client.workItem.subtask.list('my-project', 'story', 123456, {
+     *   node_id: 'doing',
+     * });
+     * ```
+     */
+    list(projectKey: string, workItemTypeKey: string, workItemId: number, query?: GetSubtasksQuery, options?: ServiceRequestOptions<NodeTask[]>): Promise<NodeTask[]>;
+    /**
+     * 完成或回滚子任务
+     *
+     * 完成或者回滚工作项实例指定节点上的一个子任务
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param request 操作请求
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * // 完成子任务
+     * await client.workItem.subtask.completeOrRollback('my-project', 'story', 123456, {
+     *   node_id: 'doing',
+     *   task_id: 789,
+     *   action: 'confirm',
+     * });
+     *
+     * // 回滚子任务并更新信息
+     * await client.workItem.subtask.completeOrRollback('my-project', 'story', 123456, {
+     *   node_id: 'doing',
+     *   task_id: 789,
+     *   action: 'rollback',
+     *   note: '需要重新处理',
+     * });
+     * ```
+     */
+    completeOrRollback(projectKey: string, workItemTypeKey: string, workItemId: number, request: CompleteRollbackSubtaskRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+    /**
+     * 搜索子任务（跨空间）
+     *
+     * 跨空间搜索符合传入条件的子任务，最多返回 5000 条数据
+     *
+     * @param request 搜索请求
+     * @param options 请求选项
+     * @returns 搜索结果（包含分页信息和子任务列表）
+     *
+     * @example
+     * ```typescript
+     * // 搜索指定空间下的所有子任务
+     * const result = await client.workItem.subtask.search({
+     *   project_keys: ['my-project'],
+     * });
+     * console.log(result.pagination.total); // 总数
+     * console.log(result.data); // 子任务列表
+     *
+     * // 搜索指定负责人的进行中子任务
+     * const result = await client.workItem.subtask.search({
+     *   project_keys: ['my-project'],
+     *   user_keys: ['user123'],
+     *   status: 0, // 进行中
+     *   page_size: 20,
+     *   page_num: 1,
+     * });
+     * ```
+     */
+    search(request: SearchSubtasksRequest, options?: ServiceRequestOptions<SubtaskSearchResult>): Promise<PaginatedResult<SubtaskSearchResult>>;
+}
+//# sourceMappingURL=subtask.d.ts.map

package/dist/service/workitem/subtask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtask.d.ts","sourceRoot":"","sources":["../../../src/service/workitem/subtask.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,EAC9B,gBAAgB,EAChB,qBAAqB,EACrB,QAAQ,EACR,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAEjC,aAAa;AACb,eAAO,MAAM,SAAS;IACpB,YAAY;;IAEZ,YAAY;;IAEZ,YAAY;;IAEZ,cAAc;;IAEd,eAAe;;IAEf,sBAAsB;;CAEvB,CAAC;AAEF;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC;IAgBlB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;;;;;;;;;;;;;OAeG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAgBhB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,IAAI,CACR,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,qBAAqB,CAAC,QAAQ,EAAE,CAAC,GAC1C,OAAO,CAAC,QAAQ,EAAE,CAAC;IAgBtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,8BAA8B,EACvC,OAAO,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAgBhB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,MAAM,CACV,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,GACnD,OAAO,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;CAOjD"}

package/dist/service/workitem/subtask.js

@@ -0,0 +1,247 @@
+/**
+ * 子任务服务
+ * 100% 参考 Meego API 文档
+ *
+ * 提供节点子任务的创建、更新、删除、查询、完成/回滚功能
+ */
+import { BaseService } from '../../core/base-service.js';
+/** API 路径 */
+export const API_PATHS = {
+    /** 创建子任务 */
+    CREATE: '/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/workflow/task',
+    /** 更新子任务 */
+    UPDATE: '/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/workflow/:node_id/task/:task_id',
+    /** 删除子任务 */
+    DELETE: '/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/task/:task_id',
+    /** 获取子任务详情 */
+    GET: '/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/workflow/task',
+    /** 子任务完成/回滚 */
+    COMPLETE_ROLLBACK: '/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/subtask/modify',
+    /** 获取指定的子任务列表（跨空间） */
+    SEARCH_ACROSS_PROJECT: '/open_api/work_item/subtask/search',
+};
+/**
+ * 子任务服务
+ *
+ * 提供节点子任务的创建、更新、删除、查询、完成/回滚功能
+ */
+export class SubtaskService extends BaseService {
+    /**
+     * 创建子任务
+     *
+     * 在工作项实例的指定节点上创建一个子任务
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param request 创建请求
+     * @param options 请求选项
+     * @returns 创建成功的子任务 ID
+     *
+     * @example
+     * ```typescript
+     * // 创建简单子任务
+     * const taskId = await client.workItem.subtask.create('my-project', 'story', 123456, {
+     *   node_id: 'doing',
+     *   name: '需求分析',
+     * });
+     *
+     * // 创建带排期的子任务
+     * const taskId = await client.workItem.subtask.create('my-project', 'story', 123456, {
+     *   node_id: 'doing',
+     *   name: '需求分析',
+     *   schedule: {
+     *     points: 1,
+     *     estimate_start_date: 1724169600000,
+     *     estimate_end_date: 1724428799999,
+     *   },
+     *   assignee: ['706477916559299xxxx'],
+     * });
+     * ```
+     */
+    async create(projectKey, workItemTypeKey, workItemId, request, options) {
+        return this.post(API_PATHS.CREATE, request, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                work_item_id: String(workItemId),
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 更新子任务
+     *
+     * 更新工作项实例指定节点上的子任务详细信息
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param nodeId 目标节点 ID
+     * @param taskId 子任务 ID
+     * @param request 更新请求
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * await client.workItem.subtask.update('my-project', 'story', 123456, 'doing', 789, {
+     *   name: '更新后的名称',
+     *   note: '备注信息',
+     *   schedule: {
+     *     points: 3,
+     *     estimate_start_date: 1724169600000,
+     *     estimate_end_date: 1724428799999,
+     *   },
+     * });
+     * ```
+     */
+    async update(projectKey, workItemTypeKey, workItemId, nodeId, taskId, request, options) {
+        await this.post(API_PATHS.UPDATE, request, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                work_item_id: String(workItemId),
+                node_id: nodeId,
+                task_id: String(taskId),
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 删除子任务
+     *
+     * 删除指定工作项实例中的一个子任务
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param taskId 子任务 ID
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * await client.workItem.subtask.remove('my-project', 'story', 123456, 789);
+     * ```
+     */
+    async remove(projectKey, workItemTypeKey, workItemId, taskId, options) {
+        await this.delete(API_PATHS.DELETE, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                work_item_id: String(workItemId),
+                task_id: String(taskId),
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 获取子任务列表
+     *
+     * 获取指定工作项实例上的子任务详细信息
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param query 查询参数
+     * @param options 请求选项
+     * @returns 节点子任务信息数组
+     *
+     * @example
+     * ```typescript
+     * // 获取所有节点的子任务
+     * const nodeTasks = await client.workItem.subtask.list('my-project', 'story', 123456);
+     *
+     * // 获取指定节点的子任务
+     * const nodeTasks = await client.workItem.subtask.list('my-project', 'story', 123456, {
+     *   node_id: 'doing',
+     * });
+     * ```
+     */
+    async list(projectKey, workItemTypeKey, workItemId, query, options) {
+        return this.get(API_PATHS.GET, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                work_item_id: String(workItemId),
+                ...options?.pathParams,
+            },
+            query: query?.node_id ? { node_id: query.node_id } : undefined,
+        });
+    }
+    /**
+     * 完成或回滚子任务
+     *
+     * 完成或者回滚工作项实例指定节点上的一个子任务
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param request 操作请求
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * // 完成子任务
+     * await client.workItem.subtask.completeOrRollback('my-project', 'story', 123456, {
+     *   node_id: 'doing',
+     *   task_id: 789,
+     *   action: 'confirm',
+     * });
+     *
+     * // 回滚子任务并更新信息
+     * await client.workItem.subtask.completeOrRollback('my-project', 'story', 123456, {
+     *   node_id: 'doing',
+     *   task_id: 789,
+     *   action: 'rollback',
+     *   note: '需要重新处理',
+     * });
+     * ```
+     */
+    async completeOrRollback(projectKey, workItemTypeKey, workItemId, request, options) {
+        await this.post(API_PATHS.COMPLETE_ROLLBACK, request, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                work_item_id: String(workItemId),
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 搜索子任务（跨空间）
+     *
+     * 跨空间搜索符合传入条件的子任务，最多返回 5000 条数据
+     *
+     * @param request 搜索请求
+     * @param options 请求选项
+     * @returns 搜索结果（包含分页信息和子任务列表）
+     *
+     * @example
+     * ```typescript
+     * // 搜索指定空间下的所有子任务
+     * const result = await client.workItem.subtask.search({
+     *   project_keys: ['my-project'],
+     * });
+     * console.log(result.pagination.total); // 总数
+     * console.log(result.data); // 子任务列表
+     *
+     * // 搜索指定负责人的进行中子任务
+     * const result = await client.workItem.subtask.search({
+     *   project_keys: ['my-project'],
+     *   user_keys: ['user123'],
+     *   status: 0, // 进行中
+     *   page_size: 20,
+     *   page_num: 1,
+     * });
+     * ```
+     */
+    async search(request, options) {
+        return this.postPaginated(API_PATHS.SEARCH_ACROSS_PROJECT, request, options);
+    }
+}
+//# sourceMappingURL=subtask.js.map