@xihe-lab/tapd-mcp-server 1.0.6 → 1.4.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 (107) hide show
  1. package/README.md +56 -7
  2. package/dist/integration-test.d.ts +10 -0
  3. package/dist/integration-test.d.ts.map +1 -0
  4. package/dist/integration-test.js +117 -0
  5. package/dist/integration-test.js.map +1 -0
  6. package/dist/server.d.ts.map +1 -1
  7. package/dist/server.js +6 -4
  8. package/dist/server.js.map +1 -1
  9. package/dist/tapd-client.d.ts +65 -1
  10. package/dist/tapd-client.d.ts.map +1 -1
  11. package/dist/tapd-client.js +135 -28
  12. package/dist/tapd-client.js.map +1 -1
  13. package/dist/tools/attachment.d.ts +3 -0
  14. package/dist/tools/attachment.d.ts.map +1 -0
  15. package/dist/tools/attachment.js +99 -0
  16. package/dist/tools/attachment.js.map +1 -0
  17. package/dist/tools/board.d.ts +3 -0
  18. package/dist/tools/board.d.ts.map +1 -0
  19. package/dist/tools/board.js +98 -0
  20. package/dist/tools/board.js.map +1 -0
  21. package/dist/tools/bug.d.ts.map +1 -1
  22. package/dist/tools/bug.js +386 -7
  23. package/dist/tools/bug.js.map +1 -1
  24. package/dist/tools/changes.d.ts +3 -0
  25. package/dist/tools/changes.d.ts.map +1 -0
  26. package/dist/tools/changes.js +73 -0
  27. package/dist/tools/changes.js.map +1 -0
  28. package/dist/tools/comment.d.ts.map +1 -1
  29. package/dist/tools/comment.js +53 -3
  30. package/dist/tools/comment.js.map +1 -1
  31. package/dist/tools/custom-fields.d.ts +3 -0
  32. package/dist/tools/custom-fields.d.ts.map +1 -0
  33. package/dist/tools/custom-fields.js +105 -0
  34. package/dist/tools/custom-fields.js.map +1 -0
  35. package/dist/tools/image.d.ts +3 -0
  36. package/dist/tools/image.d.ts.map +1 -0
  37. package/dist/tools/image.js +23 -0
  38. package/dist/tools/image.js.map +1 -0
  39. package/dist/tools/index.d.ts.map +1 -1
  40. package/dist/tools/index.js +26 -0
  41. package/dist/tools/index.js.map +1 -1
  42. package/dist/tools/iteration.d.ts.map +1 -1
  43. package/dist/tools/iteration.js +99 -6
  44. package/dist/tools/iteration.js.map +1 -1
  45. package/dist/tools/mini-comment.d.ts +3 -0
  46. package/dist/tools/mini-comment.d.ts.map +1 -0
  47. package/dist/tools/mini-comment.js +74 -0
  48. package/dist/tools/mini-comment.js.map +1 -0
  49. package/dist/tools/mini-item.d.ts +3 -0
  50. package/dist/tools/mini-item.d.ts.map +1 -0
  51. package/dist/tools/mini-item.js +166 -0
  52. package/dist/tools/mini-item.js.map +1 -0
  53. package/dist/tools/mini-workspace.d.ts +3 -0
  54. package/dist/tools/mini-workspace.d.ts.map +1 -0
  55. package/dist/tools/mini-workspace.js +43 -0
  56. package/dist/tools/mini-workspace.js.map +1 -0
  57. package/dist/tools/program.d.ts +3 -0
  58. package/dist/tools/program.d.ts.map +1 -0
  59. package/dist/tools/program.js +27 -0
  60. package/dist/tools/program.js.map +1 -0
  61. package/dist/tools/relations.d.ts +3 -0
  62. package/dist/tools/relations.d.ts.map +1 -0
  63. package/dist/tools/relations.js +68 -0
  64. package/dist/tools/relations.js.map +1 -0
  65. package/dist/tools/release.d.ts.map +1 -1
  66. package/dist/tools/release.js +228 -2
  67. package/dist/tools/release.js.map +1 -1
  68. package/dist/tools/report.d.ts +3 -0
  69. package/dist/tools/report.d.ts.map +1 -0
  70. package/dist/tools/report.js +38 -0
  71. package/dist/tools/report.js.map +1 -0
  72. package/dist/tools/settings.d.ts.map +1 -1
  73. package/dist/tools/settings.js +384 -18
  74. package/dist/tools/settings.js.map +1 -1
  75. package/dist/tools/source.d.ts +3 -0
  76. package/dist/tools/source.d.ts.map +1 -0
  77. package/dist/tools/source.js +69 -0
  78. package/dist/tools/source.js.map +1 -0
  79. package/dist/tools/story.d.ts.map +1 -1
  80. package/dist/tools/story.js +650 -144
  81. package/dist/tools/story.js.map +1 -1
  82. package/dist/tools/task.d.ts.map +1 -1
  83. package/dist/tools/task.js +109 -11
  84. package/dist/tools/task.js.map +1 -1
  85. package/dist/tools/test.d.ts.map +1 -1
  86. package/dist/tools/test.js +546 -26
  87. package/dist/tools/test.js.map +1 -1
  88. package/dist/tools/timesheet.d.ts.map +1 -1
  89. package/dist/tools/timesheet.js +72 -11
  90. package/dist/tools/timesheet.js.map +1 -1
  91. package/dist/tools/user.d.ts.map +1 -1
  92. package/dist/tools/user.js +37 -4
  93. package/dist/tools/user.js.map +1 -1
  94. package/dist/tools/utility.d.ts +3 -0
  95. package/dist/tools/utility.d.ts.map +1 -0
  96. package/dist/tools/utility.js +132 -0
  97. package/dist/tools/utility.js.map +1 -0
  98. package/dist/tools/wiki.d.ts.map +1 -1
  99. package/dist/tools/wiki.js +205 -2
  100. package/dist/tools/wiki.js.map +1 -1
  101. package/dist/tools/workflow.d.ts.map +1 -1
  102. package/dist/tools/workflow.js +92 -6
  103. package/dist/tools/workflow.js.map +1 -1
  104. package/dist/tools/workspace.d.ts.map +1 -1
  105. package/dist/tools/workspace.js +94 -4
  106. package/dist/tools/workspace.js.map +1 -1
  107. package/package.json +2 -1
package/README.md CHANGED
@@ -33,13 +33,15 @@ TAPD 是腾讯敏捷研发管理平台,覆盖需求、计划、研发、测试
33
33
 
34
34
  #### 方式一:一键安装命令
35
35
 
36
- 注意替换 `your_access_token`、`your_workspace_id` `your_nick_name`:
36
+ 注意替换以下参数(必填项标记为 **必填**,其余可选)。`-s user` 为用户级配置(所有项目生效),改为 `-s project` 则仅当前项目生效:
37
37
 
38
38
  ```bash
39
39
  claude mcp add -s user tapd \
40
- --env TAPD_ACCESS_TOKEN=your_access_token \
41
- --env TAPD_DEFAULT_WORKSPACE_ID=your_workspace_id \
42
- --env TAPD_NICK_NAME=your_nick_name \
40
+ --env TAPD_ACCESS_TOKEN=your_access_token \ # 必填:个人访问令牌
41
+ --env TAPD_DEFAULT_WORKSPACE_ID=your_workspace_id \ # 必填:默认项目 ID
42
+ --env TAPD_NICK_NAME=your_nick_name \ # 推荐:用户昵称,用于 owner/creator 默认值
43
+ --env TAPD_DEFAULT_TASK_WORKITEM_TYPE_ID=your_task_type_id \ # 可选:默认 TASK 类型 ID,可通过 tapd_get_workitem_types 查询
44
+ --env TAPD_DEFAULT_STORY_WORKITEM_TYPE_ID=your_story_type_id \ # 可选:默认 STORY 类型 ID
43
45
  -- npx -y "@xihe-lab/tapd-mcp-server"
44
46
  ```
45
47
 
@@ -66,7 +68,9 @@ claude mcp remove tapd
66
68
  "TAPD_API_PASSWORD": "",
67
69
  "TAPD_API_BASE_URL": "https://api.tapd.cn",
68
70
  "TAPD_DEFAULT_WORKSPACE_ID": "",
69
- "TAPD_NICK_NAME": ""
71
+ "TAPD_NICK_NAME": "",
72
+ "TAPD_DEFAULT_STORY_WORKITEM_TYPE_ID": "",
73
+ "TAPD_DEFAULT_TASK_WORKITEM_TYPE_ID": ""
70
74
  }
71
75
  }
72
76
  }
@@ -101,6 +105,8 @@ claude mcp remove tapd
101
105
  | `TAPD_API_BASE_URL` | 否 | API 基础地址,默认 `https://api.tapd.cn` |
102
106
  | `TAPD_DEFAULT_WORKSPACE_ID` | 否 | 默认项目 ID,省去每次传 workspace_id |
103
107
  | `TAPD_NICK_NAME` | 否 | 用户昵称,作为 owner/creator 等参数的默认值 |
108
+ | `TAPD_DEFAULT_STORY_WORKITEM_TYPE_ID` | 否 | 默认 STORY 工作项类型 ID |
109
+ | `TAPD_DEFAULT_TASK_WORKITEM_TYPE_ID` | 否 | 默认 TASK 工作项类型 ID |
104
110
 
105
111
  注意:`TAPD_API_USER`/`TAPD_API_PASSWORD`(API 账号密码)与 `TAPD_ACCESS_TOKEN`(个人访问令牌)为两种调用方式,选一种即可。
106
112
 
@@ -109,7 +115,7 @@ claude mcp remove tapd
109
115
  | 模块 | 可用操作 | 示例 |
110
116
  |------|----------|------|
111
117
  | 项目 | 查询项目信息、项目列表、成员列表 | "查看我参与的项目" |
112
- | 需求 | 查询 / 创建 / 更新需求,统计数量 | "创建需求:用户登录功能" |
118
+ | 需求 | 查询 / 创建 / 更新需求,统计数量;创建需求时可指定 TASK 类型 ID 创建任务 | "创建需求:用户登录功能"、"创建任务并关联到父需求" |
113
119
  | 缺陷 | 查询 / 创建 / 更新缺陷,统计数量 | "查看我的未解决 Bug" |
114
120
  | 任务 | 查询 / 创建 / 更新任务,统计数量 | "把任务标记为已完成" |
115
121
  | 迭代 | 查询 / 创建 / 更新迭代,统计数量 | "当前迭代还有多少未完成" |
@@ -134,6 +140,14 @@ claude mcp remove tapd
134
140
 
135
141
  在 TAPD 开放平台检查应用权限,确保已勾选所需 API 的访问权限。
136
142
 
143
+ ### 创建任务时提示权限不足
144
+
145
+ 如果 OAuth Token 没有 `tasks::create` 权限,可以通过 `tapd_create_story` 工具传入 TASK 类型的 `workitem_type_id` 来创建任务(仅需 `stories::create` 权限):
146
+
147
+ > 用 tapd_create_story 创建一个任务,workitem_type_id 设为 TASK 类型
148
+
149
+ 可通过 `tapd_get_workitem_types` 查询项目中可用的 TASK 类型 ID。
150
+
137
151
  ### 支持 Basic Auth 吗
138
152
 
139
153
  支持。设置 `TAPD_API_USER` 和 `TAPD_API_PASSWORD` 即可,与 Access Token 二选一。
@@ -152,6 +166,8 @@ claude mcp add -s user tapd \
152
166
  --env TAPD_ACCESS_TOKEN=your_access_token \
153
167
  --env TAPD_DEFAULT_WORKSPACE_ID=your_workspace_id \
154
168
  --env TAPD_NICK_NAME=your_nick_name \
169
+ --env TAPD_DEFAULT_TASK_WORKITEM_TYPE_ID=your_task_type_id \
170
+ --env TAPD_DEFAULT_STORY_WORKITEM_TYPE_ID=your_story_type_id \
155
171
  -- npx -y "@xihe-lab/tapd-mcp-server"
156
172
  ```
157
173
 
@@ -171,10 +187,43 @@ claude mcp add -s user tapd \
171
187
  }
172
188
  ```
173
189
 
174
- ### 查看当前版本
190
+ ### npm 全局安装方式
191
+
192
+ 如果通过 npm 全局安装使用:
193
+
194
+ ```bash
195
+ # 查看当前安装版本
196
+ npm list -g @xihe-lab/tapd-mcp-server
197
+
198
+ # 更新到最新版本
199
+ npm update -g @xihe-lab/tapd-mcp-server
200
+
201
+ # 或指定版本安装
202
+ npm install -g @xihe-lab/tapd-mcp-server@1.5.0
203
+ ```
204
+
205
+ 更新后需重启 MCP 客户端。
206
+
207
+ ### npx 缓存清理
208
+
209
+ 如果 npx 使用了旧版本缓存,可手动清理后重新运行:
175
210
 
176
211
  ```bash
212
+ # 清理 npx 缓存
213
+ npx clear-npx-cache
214
+
215
+ # 或手动删除缓存目录
216
+ rm -rf ~/.npm/_npx
217
+ ```
218
+
219
+ ### 查看版本信息
220
+
221
+ ```bash
222
+ # 查看最新发布版本
177
223
  npm view @xihe-lab/tapd-mcp-server version
224
+
225
+ # 查看所有已发布版本
226
+ npm view @xihe-lab/tapd-mcp-server versions
178
227
  ```
179
228
 
180
229
  ### 查看更新日志
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Integration Test Script for Tasks 210-213
3
+ *
4
+ * Tests:
5
+ * - Task 210: tapd_get_image_url
6
+ * - Task 212: tapd_get_current_user
7
+ * - Task 213: batch fetch functionality
8
+ */
9
+ export {};
10
+ //# sourceMappingURL=integration-test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"integration-test.d.ts","sourceRoot":"","sources":["../src/integration-test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}
@@ -0,0 +1,117 @@
1
+ /**
2
+ * Integration Test Script for Tasks 210-213
3
+ *
4
+ * Tests:
5
+ * - Task 210: tapd_get_image_url
6
+ * - Task 212: tapd_get_current_user
7
+ * - Task 213: batch fetch functionality
8
+ */
9
+ import { TapdClient } from './tapd-client.js';
10
+ async function runTests() {
11
+ console.log('Starting integration tests...\n');
12
+ const client = TapdClient.fromEnv();
13
+ const workspaceId = TapdClient.getDefaultWorkspaceId();
14
+ if (!workspaceId) {
15
+ console.error('ERROR: TAPD_DEFAULT_WORKSPACE_ID must be set');
16
+ process.exit(1);
17
+ }
18
+ const results = [];
19
+ // Test 212: tapd_get_current_user
20
+ console.log('Test 212: tapd_get_current_user');
21
+ try {
22
+ const user = await client.get('/users/info');
23
+ console.log(' Result:', JSON.stringify(user, null, 2).slice(0, 200));
24
+ results.push({ test: 'tapd_get_current_user', status: 'PASS' });
25
+ }
26
+ catch (error) {
27
+ const msg = error instanceof Error ? error.message : String(error);
28
+ console.log(' Error:', msg);
29
+ results.push({ test: 'tapd_get_current_user', status: 'FAIL', error: msg });
30
+ }
31
+ // Test 210: tapd_get_image_url
32
+ console.log('\nTest 210: tapd_get_image_url');
33
+ try {
34
+ // Test with a sample image path
35
+ const testImagePath = '/tfl/captures/2025/04/test.png';
36
+ const imageUrl = await client.get('/files/get_image', {
37
+ workspace_id: workspaceId,
38
+ image_path: testImagePath,
39
+ });
40
+ console.log(' Result:', JSON.stringify(imageUrl, null, 2).slice(0, 200));
41
+ results.push({ test: 'tapd_get_image_url', status: 'PASS' });
42
+ }
43
+ catch (error) {
44
+ const msg = error instanceof Error ? error.message : String(error);
45
+ console.log(' Error:', msg);
46
+ // Expected to fail for non-existent image, but API should respond correctly
47
+ if (msg.includes('TAPD API error')) {
48
+ results.push({ test: 'tapd_get_image_url', status: 'PASS' }); // API responded correctly
49
+ }
50
+ else {
51
+ results.push({ test: 'tapd_get_image_url', status: 'FAIL', error: msg });
52
+ }
53
+ }
54
+ // Test 213: batch fetch stories
55
+ console.log('\nTest 213: tapd_batch_fetch_stories');
56
+ try {
57
+ // Test with a single known story ID
58
+ const testIds = ['1']; // Short ID test
59
+ const promises = testIds.map(id => client.get('/stories', {
60
+ workspace_id: workspaceId,
61
+ id: TapdClient.toLongId(id, workspaceId),
62
+ }));
63
+ const stories = await Promise.all(promises);
64
+ console.log(' Fetched stories count:', stories.length);
65
+ results.push({ test: 'tapd_batch_fetch_stories', status: 'PASS' });
66
+ }
67
+ catch (error) {
68
+ const msg = error instanceof Error ? error.message : String(error);
69
+ console.log(' Error:', msg);
70
+ results.push({ test: 'tapd_batch_fetch_stories', status: 'FAIL', error: msg });
71
+ }
72
+ // Test 213: batch fetch bugs
73
+ console.log('\nTest 213: tapd_batch_fetch_bugs');
74
+ try {
75
+ const testIds = ['1'];
76
+ const promises = testIds.map(id => client.get('/bugs', {
77
+ workspace_id: workspaceId,
78
+ id: TapdClient.toLongId(id, workspaceId),
79
+ }));
80
+ const bugs = await Promise.all(promises);
81
+ console.log(' Fetched bugs count:', bugs.length);
82
+ results.push({ test: 'tapd_batch_fetch_bugs', status: 'PASS' });
83
+ }
84
+ catch (error) {
85
+ const msg = error instanceof Error ? error.message : String(error);
86
+ console.log(' Error:', msg);
87
+ results.push({ test: 'tapd_batch_fetch_bugs', status: 'FAIL', error: msg });
88
+ }
89
+ // Test 213: batch fetch tasks
90
+ console.log('\nTest 213: tapd_batch_fetch_tasks');
91
+ try {
92
+ const testIds = ['1'];
93
+ const promises = testIds.map(id => client.get('/tasks', {
94
+ workspace_id: workspaceId,
95
+ id: TapdClient.toLongId(id, workspaceId),
96
+ }));
97
+ const tasks = await Promise.all(promises);
98
+ console.log(' Fetched tasks count:', tasks.length);
99
+ results.push({ test: 'tapd_batch_fetch_tasks', status: 'PASS' });
100
+ }
101
+ catch (error) {
102
+ const msg = error instanceof Error ? error.message : String(error);
103
+ console.log(' Error:', msg);
104
+ results.push({ test: 'tapd_batch_fetch_tasks', status: 'FAIL', error: msg });
105
+ }
106
+ // Summary
107
+ console.log('\n=== Test Summary ===');
108
+ const passed = results.filter(r => r.status === 'PASS').length;
109
+ const failed = results.filter(r => r.status === 'FAIL').length;
110
+ console.log(`Total: ${results.length}, PASS: ${passed}, FAIL: ${failed}`);
111
+ for (const r of results) {
112
+ console.log(` ${r.status}: ${r.test}${r.error ? ` - ${r.error.slice(0, 100)}` : ''}`);
113
+ }
114
+ process.exit(failed > 0 ? 1 : 0);
115
+ }
116
+ runTests();
117
+ //# sourceMappingURL=integration-test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"integration-test.js","sourceRoot":"","sources":["../src/integration-test.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAO1C,wBAAgB,YAAY,IAAI,SAAS,CAOxC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAoCvE;AAED,wBAAsB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB3D"}
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAU1C,wBAAgB,YAAY,IAAI,SAAS,CAOxC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAmCvE;AAED,wBAAsB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB3D"}
package/dist/server.js CHANGED
@@ -1,8 +1,10 @@
1
1
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
2
  import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
3
3
  import { TapdClient } from './tapd-client.js';
4
- function createTapdClient() {
5
- return TapdClient.fromEnv();
4
+ let client = null;
5
+ function getTapdClient() {
6
+ client ??= TapdClient.fromEnv();
7
+ return client;
6
8
  }
7
9
  export function createServer() {
8
10
  const server = new McpServer({
@@ -12,13 +14,13 @@ export function createServer() {
12
14
  return server;
13
15
  }
14
16
  export function registerTools(server, tools) {
15
- const client = createTapdClient();
16
17
  for (const tool of tools) {
17
18
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
18
19
  const schema = tool.inputSchema.shape ?? tool.inputSchema;
19
20
  server.tool(tool.name, tool.description, schema, async (args) => {
20
21
  try {
21
- const result = await tool.handler(client, args);
22
+ const tapdClient = getTapdClient();
23
+ const result = await tool.handler(tapdClient, args);
22
24
  return {
23
25
  content: [
24
26
  {
@@ -1 +1 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,SAAS,gBAAgB;IACvB,OAAO,UAAU,CAAC,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,KAAgB;IAC/D,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,8DAA8D;QAC9D,MAAM,MAAM,GAAI,IAAI,CAAC,WAAmB,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC;QACnE,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,EAChB,MAAM,EACN,KAAK,EAAE,IAAa,EAAE,EAAE;YACtB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBAChD,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;gBAC9E,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;yBACvD;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,KAAgB;IAC1C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,IAAI,MAAM,GAAsB,IAAI,CAAC;AAErC,SAAS,aAAa;IACpB,MAAM,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,KAAgB;IAC/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,8DAA8D;QAC9D,MAAM,MAAM,GAAI,IAAI,CAAC,WAAmB,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC;QACnE,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,EAChB,MAAM,EACN,KAAK,EAAE,IAAa,EAAE,EAAE;YACtB,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;gBACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBACpD,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;gBAC9E,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;yBACvD;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,KAAgB;IAC1C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
@@ -1,19 +1,83 @@
1
+ /**
2
+ * TAPD API Client
3
+ *
4
+ * Supports dual authentication modes:
5
+ * - Basic Auth: using api_user + api_password
6
+ * - OAuth/Bearer Token: using access_token
7
+ *
8
+ * Uses custom HTTP client for all API calls.
9
+ */
1
10
  export declare class TapdClient {
2
11
  private authHeader;
3
12
  private baseUrl;
13
+ private authType;
14
+ private apiUser?;
15
+ private apiPassword?;
4
16
  private constructor();
17
+ /**
18
+ * Create client from OAuth access token
19
+ */
5
20
  static fromAccessToken(accessToken: string, baseUrl?: string): TapdClient;
21
+ /**
22
+ * Create client from Basic Auth credentials
23
+ */
6
24
  static fromBasicAuth(apiUser: string, apiPassword: string, baseUrl?: string): TapdClient;
25
+ /**
26
+ * Create client from environment variables
27
+ * Priority: TAPD_ACCESS_TOKEN > (TAPD_API_USER + TAPD_API_PASSWORD)
28
+ */
7
29
  static fromEnv(): TapdClient;
8
30
  /**
9
31
  * Get user nickname from environment variable TAPD_NICK_NAME
10
- * Used as default value for owner/creator/current_user parameters
11
32
  */
12
33
  static getNickName(): string | undefined;
34
+ /**
35
+ * Get default workspace ID from environment variable TAPD_DEFAULT_WORKSPACE_ID
36
+ */
37
+ static getDefaultWorkspaceId(): number | undefined;
38
+ /**
39
+ * Get default STORY workitem type ID from environment variable
40
+ */
41
+ static getDefaultStoryWorkitemTypeId(): string | undefined;
42
+ /**
43
+ * Get default TASK workitem type ID from environment variable
44
+ */
45
+ static getDefaultTaskWorkitemTypeId(): string | undefined;
46
+ /**
47
+ * Convert short ID to long ID
48
+ *
49
+ * Rules:
50
+ * - Pure numeric ID with ≤9 digits is treated as short ID
51
+ * - For cloud environment (is_cloud=true), prefix is '11'
52
+ * - Pad short ID to 9 digits and concatenate with workspace_id
53
+ * - Non-short IDs are returned unchanged
54
+ *
55
+ * @param id - Story/bug/task ID (short or long format)
56
+ * @param workspaceId - Workspace ID for constructing long ID
57
+ * @param isCloud - Whether it's cloud environment (default: true)
58
+ */
59
+ static toLongId(id: string | number, workspaceId: string | number, isCloud?: boolean): string;
60
+ /**
61
+ * Make HTTP request to TAPD API with retry support
62
+ *
63
+ * Retry policy:
64
+ * - Retry on 429/500/502/503 status codes
65
+ * - Max 3 retries with exponential backoff (1s, 2s, 4s)
66
+ * - POST requests do NOT retry (avoid duplicate creation)
67
+ */
13
68
  request<T>(method: 'GET' | 'POST', path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
69
+ /**
70
+ * GET request to TAPD API
71
+ */
14
72
  get<T>(path: string, params?: Record<string, string | number | boolean>): Promise<T>;
73
+ /**
74
+ * POST request to TAPD API
75
+ */
15
76
  post<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
16
77
  }
78
+ /**
79
+ * TAPD API response structure
80
+ */
17
81
  export interface TapdResponse<T> {
18
82
  status: number;
19
83
  data: T;
@@ -1 +1 @@
1
- {"version":3,"file":"tapd-client.d.ts","sourceRoot":"","sources":["../src/tapd-client.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO;IAKP,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU;IAIzE,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU;IAKxF,MAAM,CAAC,OAAO,IAAI,UAAU;IAmB5B;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,GAAG,SAAS;IAIlC,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC7D,OAAO,CAAC,CAAC,CAAC;IAoDP,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpF,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAGxG;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;CACd"}
1
+ {"version":3,"file":"tapd-client.d.ts","sourceRoot":"","sources":["../src/tapd-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,WAAW,CAAC,CAAS;IAE7B,OAAO;IAcP;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU;IAIzE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU;IAWxF;;;OAGG;IACH,MAAM,CAAC,OAAO,IAAI,UAAU;IAmB5B;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,GAAG,SAAS;IAIxC;;OAEG;IACH,MAAM,CAAC,qBAAqB,IAAI,MAAM,GAAG,SAAS;IAKlD;;OAEG;IACH,MAAM,CAAC,6BAA6B,IAAI,MAAM,GAAG,SAAS;IAI1D;;OAEG;IACH,MAAM,CAAC,4BAA4B,IAAI,MAAM,GAAG,SAAS;IAIzD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,GAAE,OAAc,GAAG,MAAM;IAcnG;;;;;;;KAOC;IACK,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC7D,OAAO,CAAC,CAAC,CAAC;IAkFb;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1F;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAGxG;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;CACd"}
@@ -1,37 +1,112 @@
1
+ /**
2
+ * TAPD API Client
3
+ *
4
+ * Supports dual authentication modes:
5
+ * - Basic Auth: using api_user + api_password
6
+ * - OAuth/Bearer Token: using access_token
7
+ *
8
+ * Uses custom HTTP client for all API calls.
9
+ */
1
10
  export class TapdClient {
2
11
  authHeader;
3
12
  baseUrl;
4
- constructor(authHeader, baseUrl) {
13
+ authType;
14
+ apiUser;
15
+ apiPassword;
16
+ constructor(authHeader, baseUrl, authType, apiUser, apiPassword) {
5
17
  this.authHeader = authHeader;
6
18
  this.baseUrl = baseUrl ?? process.env.TAPD_API_BASE_URL ?? 'https://api.tapd.cn';
19
+ this.authType = authType ?? 'basic';
20
+ this.apiUser = apiUser;
21
+ this.apiPassword = apiPassword;
7
22
  }
23
+ /**
24
+ * Create client from OAuth access token
25
+ */
8
26
  static fromAccessToken(accessToken, baseUrl) {
9
- return new TapdClient(`Bearer ${accessToken}`, baseUrl);
27
+ return new TapdClient(`Bearer ${accessToken}`, baseUrl, 'oauth');
10
28
  }
29
+ /**
30
+ * Create client from Basic Auth credentials
31
+ */
11
32
  static fromBasicAuth(apiUser, apiPassword, baseUrl) {
12
33
  const credentials = `${apiUser}:${apiPassword}`;
13
- return new TapdClient(`Basic ${Buffer.from(credentials).toString('base64')}`, baseUrl);
34
+ return new TapdClient(`Basic ${Buffer.from(credentials).toString('base64')}`, baseUrl, 'basic', apiUser, apiPassword);
14
35
  }
36
+ /**
37
+ * Create client from environment variables
38
+ * Priority: TAPD_ACCESS_TOKEN > (TAPD_API_USER + TAPD_API_PASSWORD)
39
+ */
15
40
  static fromEnv() {
16
41
  const apiUser = process.env.TAPD_API_USER;
17
42
  const apiPassword = process.env.TAPD_API_PASSWORD;
18
43
  const accessToken = process.env.TAPD_ACCESS_TOKEN;
19
44
  const baseUrl = process.env.TAPD_API_BASE_URL;
20
- if (apiUser && apiPassword) {
21
- return TapdClient.fromBasicAuth(apiUser, apiPassword, baseUrl);
22
- }
23
45
  if (accessToken) {
24
46
  return TapdClient.fromAccessToken(accessToken, baseUrl);
25
47
  }
48
+ if (apiUser && apiPassword) {
49
+ return TapdClient.fromBasicAuth(apiUser, apiPassword, baseUrl);
50
+ }
26
51
  throw new Error('Authentication required. Set TAPD_ACCESS_TOKEN or (TAPD_API_USER + TAPD_API_PASSWORD) environment variables.');
27
52
  }
28
53
  /**
29
54
  * Get user nickname from environment variable TAPD_NICK_NAME
30
- * Used as default value for owner/creator/current_user parameters
31
55
  */
32
56
  static getNickName() {
33
57
  return process.env.TAPD_NICK_NAME;
34
58
  }
59
+ /**
60
+ * Get default workspace ID from environment variable TAPD_DEFAULT_WORKSPACE_ID
61
+ */
62
+ static getDefaultWorkspaceId() {
63
+ const id = process.env.TAPD_DEFAULT_WORKSPACE_ID;
64
+ return id ? parseInt(id, 10) : undefined;
65
+ }
66
+ /**
67
+ * Get default STORY workitem type ID from environment variable
68
+ */
69
+ static getDefaultStoryWorkitemTypeId() {
70
+ return process.env.TAPD_DEFAULT_STORY_WORKITEM_TYPE_ID;
71
+ }
72
+ /**
73
+ * Get default TASK workitem type ID from environment variable
74
+ */
75
+ static getDefaultTaskWorkitemTypeId() {
76
+ return process.env.TAPD_DEFAULT_TASK_WORKITEM_TYPE_ID;
77
+ }
78
+ /**
79
+ * Convert short ID to long ID
80
+ *
81
+ * Rules:
82
+ * - Pure numeric ID with ≤9 digits is treated as short ID
83
+ * - For cloud environment (is_cloud=true), prefix is '11'
84
+ * - Pad short ID to 9 digits and concatenate with workspace_id
85
+ * - Non-short IDs are returned unchanged
86
+ *
87
+ * @param id - Story/bug/task ID (short or long format)
88
+ * @param workspaceId - Workspace ID for constructing long ID
89
+ * @param isCloud - Whether it's cloud environment (default: true)
90
+ */
91
+ static toLongId(id, workspaceId, isCloud = true) {
92
+ const idStr = String(id).trim();
93
+ const workspaceIdStr = String(workspaceId);
94
+ // Check if it's a pure numeric short ID (≤9 digits)
95
+ if (/^\d+$/.test(idStr) && idStr.length <= 9) {
96
+ const prefix = isCloud ? '11' : '10';
97
+ const paddedId = idStr.padStart(9, '0');
98
+ return `${prefix}${workspaceIdStr}${paddedId}`;
99
+ }
100
+ return idStr;
101
+ }
102
+ /**
103
+ * Make HTTP request to TAPD API with retry support
104
+ *
105
+ * Retry policy:
106
+ * - Retry on 429/500/502/503 status codes
107
+ * - Max 3 retries with exponential backoff (1s, 2s, 4s)
108
+ * - POST requests do NOT retry (avoid duplicate creation)
109
+ */
35
110
  async request(method, path, params) {
36
111
  const url = new URL(path, this.baseUrl);
37
112
  const headers = {
@@ -39,7 +114,6 @@ export class TapdClient {
39
114
  };
40
115
  let body;
41
116
  if (method === 'GET' && params) {
42
- // Filter out undefined values and check if there are any params left
43
117
  const filteredParams = Object.entries(params).filter(([, value]) => value !== undefined);
44
118
  for (const [key, value] of filteredParams) {
45
119
  url.searchParams.append(key, String(value));
@@ -51,31 +125,64 @@ export class TapdClient {
51
125
  .filter(([, value]) => value !== undefined)
52
126
  .map(([key, value]) => [key, String(value).replace(/\\n/g, '\n')])).toString();
53
127
  }
54
- const response = await fetch(url.toString(), {
55
- method,
56
- headers,
57
- body,
58
- });
59
- if (!response.ok) {
60
- // Try to get error message from response body
61
- const errorText = await response.text();
62
- throw new Error(`TAPD API error: ${response.status} ${response.statusText} - ${errorText.slice(0, 200)}`);
63
- }
64
- // Check if response is JSON
65
- const contentType = response.headers.get('content-type');
66
- if (!contentType?.includes('application/json')) {
67
- const text = await response.text();
68
- throw new Error(`TAPD API returned non-JSON response: ${text.slice(0, 100)}`);
69
- }
70
- const result = await response.json();
71
- if (result.status !== 1) {
72
- throw new Error(`TAPD API error: ${result.info ?? 'Unknown error'}`);
128
+ // Retry configuration
129
+ const maxRetries = 3;
130
+ const retryableStatusCodes = [429, 500, 502, 503];
131
+ const shouldRetry = method === 'GET'; // Only retry GET requests
132
+ let lastError;
133
+ for (let attempt = 0; attempt <= maxRetries; attempt++) {
134
+ try {
135
+ const response = await fetch(url.toString(), {
136
+ method,
137
+ headers,
138
+ body,
139
+ });
140
+ if (!response.ok) {
141
+ const errorText = await response.text();
142
+ const error = new Error(`TAPD API error: ${response.status} ${response.statusText} - ${errorText.slice(0, 200)}`);
143
+ // Check if we should retry
144
+ if (shouldRetry && retryableStatusCodes.includes(response.status) && attempt < maxRetries) {
145
+ lastError = error;
146
+ const delayMs = Math.pow(2, attempt) * 1000; // 1s, 2s, 4s
147
+ await new Promise(resolve => setTimeout(resolve, delayMs));
148
+ continue;
149
+ }
150
+ throw error;
151
+ }
152
+ const contentType = response.headers.get('content-type');
153
+ if (!contentType?.includes('application/json')) {
154
+ const text = await response.text();
155
+ throw new Error(`TAPD API returned non-JSON response: ${text.slice(0, 100)}`);
156
+ }
157
+ const result = await response.json();
158
+ if (result.status !== 1) {
159
+ throw new Error(`TAPD API error: ${result.info ?? 'Unknown error'}`);
160
+ }
161
+ return result.data;
162
+ }
163
+ catch (error) {
164
+ // For non-retryable errors or final attempt, throw immediately
165
+ if (!shouldRetry || attempt >= maxRetries) {
166
+ throw error;
167
+ }
168
+ // For network errors, retry
169
+ lastError = error instanceof Error ? error : new Error(String(error));
170
+ const delayMs = Math.pow(2, attempt) * 1000;
171
+ await new Promise(resolve => setTimeout(resolve, delayMs));
172
+ }
73
173
  }
74
- return result.data;
174
+ // All retries exhausted
175
+ throw lastError ?? new Error('Request failed after all retries');
75
176
  }
177
+ /**
178
+ * GET request to TAPD API
179
+ */
76
180
  async get(path, params) {
77
181
  return this.request('GET', path, params);
78
182
  }
183
+ /**
184
+ * POST request to TAPD API
185
+ */
79
186
  async post(path, params) {
80
187
  return this.request('POST', path, params);
81
188
  }
@@ -1 +1 @@
1
- {"version":3,"file":"tapd-client.js","sourceRoot":"","sources":["../src/tapd-client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tapd-client.js","sourceRoot":"","sources":["../src/tapd-client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { ToolDef } from '../types.js';
2
+ export declare const attachmentTools: ToolDef[];
3
+ //# sourceMappingURL=attachment.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../src/tools/attachment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,eAAO,MAAM,eAAe,EAAE,OAAO,EA+FpC,CAAC"}