meeglesdk 0.1.0

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

@@ -0,0 +1,214 @@
+/**
+ * 工作流服务
+ * 100% 参考 Meego API 文档
+ *
+ * 提供工作项工作流相关功能：
+ * - 状态流转（状态流工作项）
+ * - 节点完成/回滚（节点流工作项）
+ * - 更新节点/排期
+ * - 获取流转必填信息
+ * - 获取工作流详情
+ */
+import { BaseService, type ServiceRequestOptions } from '../../core/base-service.js';
+import type { StateChangeRequest, NodeOperateRequest, UpdateNodeRequest, TransitionRequiredInfoRequest, TransitionRequiredInfo, WorkflowInfo, WbsViewQueryParams, WbsViewRequest, WbsWorkItem } from '../../types/workitem.js';
+/** API 路径 */
+export declare const API_PATHS: {
+    /** 获取工作流详情 */
+    WORKFLOW_QUERY: string;
+    /** 状态流转（状态流工作项） */
+    STATE_CHANGE: string;
+    /** 节点完成/回滚（节点流工作项） */
+    NODE_OPERATE: string;
+    /** 更新节点/排期 */
+    NODE_UPDATE: string;
+    /** 获取流转必填信息 */
+    TRANSITION_REQUIRED_INFO: string;
+    /** 获取工作流详情（WBS） */
+    WBS_VIEW: string;
+};
+/**
+ * 工作流服务
+ *
+ * 提供工作项工作流相关功能
+ */
+export declare class WorkflowService extends BaseService {
+    /**
+     * 获取工作流详情
+     *
+     * 获取工作项实例的工作流详情，包含节点信息、流转信息等
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param options 请求选项
+     * @returns 工作流详情
+     *
+     * @example
+     * ```typescript
+     * const workflow = await client.workItem.workflow.query('my-project', 'story', 123456);
+     * console.log('当前状态:', workflow.current_nodes);
+     * console.log('可用流转:', workflow.transitions);
+     * ```
+     */
+    query(projectKey: string, workItemTypeKey: string, workItemId: number, options?: ServiceRequestOptions<WorkflowInfo>): Promise<WorkflowInfo>;
+    /**
+     * 状态流转（状态流工作项）
+     *
+     * 用于"状态流"类型的工作项进行状态流转
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param request 流转请求
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * // 基本状态流转
+     * await client.workItem.workflow.stateChange('my-project', 'story', 123456, {
+     *   transition_id: 12345,
+     * });
+     *
+     * // 流转时同时更新字段
+     * await client.workItem.workflow.stateChange('my-project', 'story', 123456, {
+     *   transition_id: 12345,
+     *   fields: [
+     *     { field_key: 'priority', field_value: 'P0' }
+     *   ],
+     *   role_owners: [
+     *     { role_key: 'developer', owner: ['user123'] }
+     *   ]
+     * });
+     * ```
+     */
+    stateChange(projectKey: string, workItemTypeKey: string, workItemId: number, request: StateChangeRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+    /**
+     * 节点完成/回滚（节点流工作项）
+     *
+     * 用于"节点流"类型的工作项完成或回滚节点
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param nodeId 目标节点 ID
+     * @param request 操作请求
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * // 完成节点
+     * await client.workItem.workflow.operateNode('my-project', 'story', 123456, 'dev_node', {
+     *   action: 'confirm',
+     *   node_owners: ['user123'],
+     *   node_schedule: {
+     *     points: 3,
+     *     estimate_start_date: 1724169600000,
+     *     estimate_end_date: 1724428799999,
+     *   }
+     * });
+     *
+     * // 回滚节点
+     * await client.workItem.workflow.operateNode('my-project', 'story', 123456, 'dev_node', {
+     *   action: 'rollback',
+     *   rollback_reason: '需要重新开发',
+     * });
+     * ```
+     */
+    operateNode(projectKey: string, workItemTypeKey: string, workItemId: number, nodeId: string, request: NodeOperateRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+    /**
+     * 更新节点信息（节点流工作项）
+     *
+     * 更新节点的负责人、排期、字段等信息
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param nodeId 目标节点 ID
+     * @param request 更新请求
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * // 更新节点负责人和排期
+     * await client.workItem.workflow.updateNode('my-project', 'story', 123456, 'dev_node', {
+     *   node_owners: ['user123', 'user456'],
+     *   node_schedule: {
+     *     points: 5,
+     *     estimate_start_date: 1724169600000,
+     *     estimate_end_date: 1724428799999,
+     *   }
+     * });
+     *
+     * // 差异化排期（按人汇总）
+     * await client.workItem.workflow.updateNode('my-project', 'story', 123456, 'dev_node', {
+     *   node_owners: ['user123', 'user456'],
+     *   schedules: [
+     *     { owner: 'user123', points: 3, estimate_start_date: 1724169600000, estimate_end_date: 1724300799999 },
+     *     { owner: 'user456', points: 2, estimate_start_date: 1724300800000, estimate_end_date: 1724428799999 },
+     *   ]
+     * });
+     * ```
+     */
+    updateNode(projectKey: string, workItemTypeKey: string, workItemId: number, nodeId: string, request: UpdateNodeRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+    /**
+     * 获取流转必填信息
+     *
+     * 在进行状态流转或节点完成操作之前，获取目标节点/状态所需的必填信息
+     *
+     * @param request 查询请求
+     * @param options 请求选项
+     * @returns 流转必填信息
+     *
+     * @example
+     * ```typescript
+     * // 获取完整必填信息
+     * const requiredInfo = await client.workItem.workflow.getTransitionRequiredInfo({
+     *   project_key: 'my-project',
+     *   work_item_id: 123456,
+     *   state_key: 'dev_done',
+     * });
+     *
+     * // 检查必填字段
+     * if (requiredInfo.form_items) {
+     *   for (const item of requiredInfo.form_items) {
+     *     if (!item.finished) {
+     *       console.log('未完成:', item.key);
+     *     }
+     *   }
+     * }
+     *
+     * // 仅查询未完成的必填项
+     * const unfinished = await client.workItem.workflow.getTransitionRequiredInfo({
+     *   project_key: 'my-project',
+     *   work_item_id: 123456,
+     *   state_key: 'dev_done',
+     *   mode: 'unfinished',
+     * });
+     * ```
+     */
+    getTransitionRequiredInfo(request: TransitionRequiredInfoRequest, options?: ServiceRequestOptions<TransitionRequiredInfo>): Promise<TransitionRequiredInfo>;
+    /**
+     * 获取工作流详情（WBS 视图）
+     *
+     * 获取工作项的 WBS 视图信息，包含完整的工作分解结构
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param options 请求选项
+     * @returns WBS 工作项信息
+     *
+     * @example
+     * ```typescript
+     * const wbsView = await client.workItem.workflow.getWbsView('my-project', 'story', 123456);
+     * console.log('工作分解结构:', wbsView);
+     * ```
+     */
+    getWbsView(projectKey: string, workItemTypeKey: string, workItemId: number, params?: {
+        /** 查询参数（如 need_union_deliverable） */
+        query?: WbsViewQueryParams;
+        /** 请求体（expand 等扩展参数） */
+        body?: WbsViewRequest;
+    }, options?: ServiceRequestOptions<WbsWorkItem>): Promise<WbsWorkItem>;
+}
+//# sourceMappingURL=workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/service/workitem/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,6BAA6B,EAC7B,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,WAAW,EACZ,MAAM,yBAAyB,CAAC;AAEjC,aAAa;AACb,eAAO,MAAM,SAAS;IACpB,cAAc;;IAEd,mBAAmB;;IAEnB,sBAAsB;;IAEtB,cAAc;;IAEd,eAAe;;IAEf,mBAAmB;;CAEpB,CAAC;AAEF;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C;;;;;;;;;;;;;;;;;OAiBG;IACG,KAAK,CACT,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,qBAAqB,CAAC,YAAY,CAAC,GAC5C,OAAO,CAAC,YAAY,CAAC;IAYxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAahB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAahB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,yBAAyB,CAC7B,OAAO,EAAE,6BAA6B,EACtC,OAAO,CAAC,EAAE,qBAAqB,CAAC,sBAAsB,CAAC,GACtD,OAAO,CAAC,sBAAsB,CAAC;IAIlC;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE;QACP,qCAAqC;QACrC,KAAK,CAAC,EAAE,kBAAkB,CAAC;QAC3B,wBAAwB;QACxB,IAAI,CAAC,EAAE,cAAc,CAAC;KACvB,EACD,OAAO,CAAC,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAC3C,OAAO,CAAC,WAAW,CAAC;CAgCxB"}

package/dist/service/workitem/workflow.js

@@ -0,0 +1,281 @@
+/**
+ * 工作流服务
+ * 100% 参考 Meego API 文档
+ *
+ * 提供工作项工作流相关功能：
+ * - 状态流转（状态流工作项）
+ * - 节点完成/回滚（节点流工作项）
+ * - 更新节点/排期
+ * - 获取流转必填信息
+ * - 获取工作流详情
+ */
+import { BaseService } from '../../core/base-service.js';
+/** API 路径 */
+export const API_PATHS = {
+    /** 获取工作流详情 */
+    WORKFLOW_QUERY: '/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/workflow/query',
+    /** 状态流转（状态流工作项） */
+    STATE_CHANGE: '/open_api/:project_key/workflow/:work_item_type_key/:work_item_id/node/state_change',
+    /** 节点完成/回滚（节点流工作项） */
+    NODE_OPERATE: '/open_api/:project_key/workflow/:work_item_type_key/:work_item_id/node/:node_id/operate',
+    /** 更新节点/排期 */
+    NODE_UPDATE: '/open_api/:project_key/workflow/:work_item_type_key/:work_item_id/node/:node_id',
+    /** 获取流转必填信息 */
+    TRANSITION_REQUIRED_INFO: '/open_api/work_item/transition_required_info/get',
+    /** 获取工作流详情（WBS） */
+    WBS_VIEW: '/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/wbs_view',
+};
+/**
+ * 工作流服务
+ *
+ * 提供工作项工作流相关功能
+ */
+export class WorkflowService extends BaseService {
+    /**
+     * 获取工作流详情
+     *
+     * 获取工作项实例的工作流详情，包含节点信息、流转信息等
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param options 请求选项
+     * @returns 工作流详情
+     *
+     * @example
+     * ```typescript
+     * const workflow = await client.workItem.workflow.query('my-project', 'story', 123456);
+     * console.log('当前状态:', workflow.current_nodes);
+     * console.log('可用流转:', workflow.transitions);
+     * ```
+     */
+    async query(projectKey, workItemTypeKey, workItemId, options) {
+        return this.post(API_PATHS.WORKFLOW_QUERY, {}, {
+            ...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 request 流转请求
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * // 基本状态流转
+     * await client.workItem.workflow.stateChange('my-project', 'story', 123456, {
+     *   transition_id: 12345,
+     * });
+     *
+     * // 流转时同时更新字段
+     * await client.workItem.workflow.stateChange('my-project', 'story', 123456, {
+     *   transition_id: 12345,
+     *   fields: [
+     *     { field_key: 'priority', field_value: 'P0' }
+     *   ],
+     *   role_owners: [
+     *     { role_key: 'developer', owner: ['user123'] }
+     *   ]
+     * });
+     * ```
+     */
+    async stateChange(projectKey, workItemTypeKey, workItemId, request, options) {
+        await this.post(API_PATHS.STATE_CHANGE, 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 request 操作请求
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * // 完成节点
+     * await client.workItem.workflow.operateNode('my-project', 'story', 123456, 'dev_node', {
+     *   action: 'confirm',
+     *   node_owners: ['user123'],
+     *   node_schedule: {
+     *     points: 3,
+     *     estimate_start_date: 1724169600000,
+     *     estimate_end_date: 1724428799999,
+     *   }
+     * });
+     *
+     * // 回滚节点
+     * await client.workItem.workflow.operateNode('my-project', 'story', 123456, 'dev_node', {
+     *   action: 'rollback',
+     *   rollback_reason: '需要重新开发',
+     * });
+     * ```
+     */
+    async operateNode(projectKey, workItemTypeKey, workItemId, nodeId, request, options) {
+        await this.post(API_PATHS.NODE_OPERATE, request, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                work_item_id: String(workItemId),
+                node_id: nodeId,
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 更新节点信息（节点流工作项）
+     *
+     * 更新节点的负责人、排期、字段等信息
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param nodeId 目标节点 ID
+     * @param request 更新请求
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * // 更新节点负责人和排期
+     * await client.workItem.workflow.updateNode('my-project', 'story', 123456, 'dev_node', {
+     *   node_owners: ['user123', 'user456'],
+     *   node_schedule: {
+     *     points: 5,
+     *     estimate_start_date: 1724169600000,
+     *     estimate_end_date: 1724428799999,
+     *   }
+     * });
+     *
+     * // 差异化排期（按人汇总）
+     * await client.workItem.workflow.updateNode('my-project', 'story', 123456, 'dev_node', {
+     *   node_owners: ['user123', 'user456'],
+     *   schedules: [
+     *     { owner: 'user123', points: 3, estimate_start_date: 1724169600000, estimate_end_date: 1724300799999 },
+     *     { owner: 'user456', points: 2, estimate_start_date: 1724300800000, estimate_end_date: 1724428799999 },
+     *   ]
+     * });
+     * ```
+     */
+    async updateNode(projectKey, workItemTypeKey, workItemId, nodeId, request, options) {
+        await this.put(API_PATHS.NODE_UPDATE, request, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                work_item_id: String(workItemId),
+                node_id: nodeId,
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 获取流转必填信息
+     *
+     * 在进行状态流转或节点完成操作之前，获取目标节点/状态所需的必填信息
+     *
+     * @param request 查询请求
+     * @param options 请求选项
+     * @returns 流转必填信息
+     *
+     * @example
+     * ```typescript
+     * // 获取完整必填信息
+     * const requiredInfo = await client.workItem.workflow.getTransitionRequiredInfo({
+     *   project_key: 'my-project',
+     *   work_item_id: 123456,
+     *   state_key: 'dev_done',
+     * });
+     *
+     * // 检查必填字段
+     * if (requiredInfo.form_items) {
+     *   for (const item of requiredInfo.form_items) {
+     *     if (!item.finished) {
+     *       console.log('未完成:', item.key);
+     *     }
+     *   }
+     * }
+     *
+     * // 仅查询未完成的必填项
+     * const unfinished = await client.workItem.workflow.getTransitionRequiredInfo({
+     *   project_key: 'my-project',
+     *   work_item_id: 123456,
+     *   state_key: 'dev_done',
+     *   mode: 'unfinished',
+     * });
+     * ```
+     */
+    async getTransitionRequiredInfo(request, options) {
+        return this.post(API_PATHS.TRANSITION_REQUIRED_INFO, request, options);
+    }
+    /**
+     * 获取工作流详情（WBS 视图）
+     *
+     * 获取工作项的 WBS 视图信息，包含完整的工作分解结构
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型
+     * @param workItemId 工作项 ID
+     * @param options 请求选项
+     * @returns WBS 工作项信息
+     *
+     * @example
+     * ```typescript
+     * const wbsView = await client.workItem.workflow.getWbsView('my-project', 'story', 123456);
+     * console.log('工作分解结构:', wbsView);
+     * ```
+     */
+    async getWbsView(projectKey, workItemTypeKey, workItemId, params, options) {
+        // GET 请求在 fetch 中不能携带 body，将 expand 映射到 query 以保持兼容
+        const expandQuery = params?.body?.expand
+            ? {
+                need_union_deliverable: params.body.expand.need_union_deliverable,
+                need_wbs_relation_chain_path: params.body.expand.need_wbs_relation_chain_path,
+                need_wbs_relation_chain_entity: params.body.expand.need_wbs_relation_chain_entity,
+            }
+            : {};
+        const mergedQuery = {
+            ...expandQuery,
+            ...(params?.query ?? {}),
+            ...(options?.query ?? {}),
+        };
+        return this.requestHandler.request({
+            method: 'GET',
+            path: API_PATHS.WBS_VIEW,
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                work_item_id: String(workItemId),
+                ...options?.pathParams,
+            },
+            query: Object.keys(mergedQuery).length > 0 ? mergedQuery : undefined,
+            auth: options?.auth,
+            idempotencyKey: options?.idempotencyKey,
+            timeout: options?.timeout,
+            skipRetry: options?.skipRetry,
+        });
+    }
+}
+//# sourceMappingURL=workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../src/service/workitem/workflow.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,63 @@
+/**
+ * 工时登记服务
+ * 100% 参考 Meego API 文档
+ */
+import { BaseService, type ServiceRequestOptions } from '../../core/base-service.js';
+import type { CreateWorkHourRecordRequest, UpdateWorkHourRecordRequest, DeleteWorkHourRecordRequest, ListWorkHourRecordsRequest, WorkHourRecord } from '../../types/workitem.js';
+import type { PaginatedResult } from '../../types/common.js';
+/** API 路径 */
+export declare const API_PATHS: {
+    /** 创建实际工时 */
+    CREATE: string;
+    /** 更新实际工时（批量） */
+    UPDATE: string;
+    /** 删除实际工时（批量） */
+    DELETE: string;
+    /** 获取工作项的工时记录列表 */
+    LIST: string;
+};
+/**
+ * 工时登记服务
+ */
+export declare class WorkHourService extends BaseService {
+    /**
+     * 创建工时登记记录
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型 key
+     * @param workItemId 工作项 ID
+     * @param request 创建请求
+     * @param options 请求选项
+     * @returns 新建工时记录列表
+     */
+    create(projectKey: string, workItemTypeKey: string, workItemId: number, request: CreateWorkHourRecordRequest, options?: ServiceRequestOptions<WorkHourRecord[]>): Promise<WorkHourRecord[]>;
+    /**
+     * 更新工时登记记录
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型 key
+     * @param workItemId 工作项 ID
+     * @param request 更新请求
+     * @param options 请求选项
+     */
+    update(projectKey: string, workItemTypeKey: string, workItemId: number, request: UpdateWorkHourRecordRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+    /**
+     * 删除工时登记记录
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型 key
+     * @param workItemId 工作项 ID
+     * @param request 删除请求
+     * @param options 请求选项
+     */
+    deleteRecords(projectKey: string, workItemTypeKey: string, workItemId: number, request: DeleteWorkHourRecordRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+    /**
+     * 获取工作项的工时登记记录列表
+     *
+     * @param request 查询请求
+     * @param options 请求选项
+     * @returns 分页的工时记录列表
+     */
+    list(request: ListWorkHourRecordsRequest, options?: ServiceRequestOptions<WorkHourRecord>): Promise<PaginatedResult<WorkHourRecord>>;
+}
+//# sourceMappingURL=workhour.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workhour.d.ts","sourceRoot":"","sources":["../../../src/service/workitem/workhour.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,cAAc,EACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,aAAa;AACb,eAAO,MAAM,SAAS;IACpB,aAAa;;IAEb,iBAAiB;;IAEjB,iBAAiB;;IAEjB,mBAAmB;;CAEpB,CAAC;AAEF;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C;;;;;;;;;OASG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,2BAA2B,EACpC,OAAO,CAAC,EAAE,qBAAqB,CAAC,cAAc,EAAE,CAAC,GAChD,OAAO,CAAC,cAAc,EAAE,CAAC;IAY5B;;;;;;;;OAQG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,2BAA2B,EACpC,OAAO,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;;;;;OAQG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,2BAA2B,EACpC,OAAO,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;;;OAMG;IACG,IAAI,CACR,OAAO,EAAE,0BAA0B,EACnC,OAAO,CAAC,EAAE,qBAAqB,CAAC,cAAc,CAAC,GAC9C,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;CAG5C"}

package/dist/service/workitem/workhour.js

@@ -0,0 +1,93 @@
+/**
+ * 工时登记服务
+ * 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/work_hour_record',
+    /** 更新实际工时（批量） */
+    UPDATE: '/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/work_hour_record',
+    /** 删除实际工时（批量） */
+    DELETE: '/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/work_hour_record',
+    /** 获取工作项的工时记录列表 */
+    LIST: '/open_api/work_item/man_hour/records',
+};
+/**
+ * 工时登记服务
+ */
+export class WorkHourService extends BaseService {
+    /**
+     * 创建工时登记记录
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型 key
+     * @param workItemId 工作项 ID
+     * @param request 创建请求
+     * @param options 请求选项
+     * @returns 新建工时记录列表
+     */
+    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 工作项类型 key
+     * @param workItemId 工作项 ID
+     * @param request 更新请求
+     * @param options 请求选项
+     */
+    async update(projectKey, workItemTypeKey, workItemId, request, options) {
+        await this.put(API_PATHS.UPDATE, request, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                work_item_id: String(workItemId),
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 删除工时登记记录
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型 key
+     * @param workItemId 工作项 ID
+     * @param request 删除请求
+     * @param options 请求选项
+     */
+    async deleteRecords(projectKey, workItemTypeKey, workItemId, request, options) {
+        await this.deleteWithBody(API_PATHS.DELETE, request, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                work_item_id: String(workItemId),
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 获取工作项的工时登记记录列表
+     *
+     * @param request 查询请求
+     * @param options 请求选项
+     * @returns 分页的工时记录列表
+     */
+    async list(request, options) {
+        return this.postPaginated(API_PATHS.LIST, request, options);
+    }
+}
+//# sourceMappingURL=workhour.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workhour.js","sourceRoot":"","sources":["../../../src/service/workitem/workhour.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAA8B,MAAM,4BAA4B,CAAC;AAUrF,aAAa;AACb,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,aAAa;IACb,MAAM,EAAE,qFAAqF;IAC7F,iBAAiB;IACjB,MAAM,EAAE,qFAAqF;IAC7F,iBAAiB;IACjB,MAAM,EAAE,qFAAqF;IAC7F,mBAAmB;IACnB,IAAI,EAAE,sCAAsC;CAC7C,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CACV,UAAkB,EAClB,eAAuB,EACvB,UAAkB,EAClB,OAAoC,EACpC,OAAiD;QAEjD,OAAO,IAAI,CAAC,IAAI,CAAmB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE;YAC5D,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;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CACV,UAAkB,EAClB,eAAuB,EACvB,UAAkB,EAClB,OAAoC,EACpC,OAAqC;QAErC,MAAM,IAAI,CAAC,GAAG,CAAO,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE;YAC9C,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;;;;;;;;OAQG;IACH,KAAK,CAAC,aAAa,CACjB,UAAkB,EAClB,eAAuB,EACvB,UAAkB,EAClB,OAAoC,EACpC,OAAqC;QAErC,MAAM,IAAI,CAAC,cAAc,CAAO,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE;YACzD,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;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CACR,OAAmC,EACnC,OAA+C;QAE/C,OAAO,IAAI,CAAC,aAAa,CAAiB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;CACF"}