@xihe-lab/tapd-core 2.0.0-rc.2 → 2.0.0-rc.4

package/dist/cache/read-cache.test.js

@@ -0,0 +1,429 @@
+/**
+ * 只读数据 TTL 缓存测试（Wave 2）。
+ *
+ * 挂载方式（禁改 package.json）：本文件由 src/registry/registry.test.ts 末尾
+ * 动态 import 挂进 pnpm test 既有链路；也可单独运行：
+ *   npx tsx src/cache/read-cache.test.ts
+ *
+ * 覆盖：allowlist 边界 / 键规范化与 workspace 隔离 / 命中·未命中·TTL 过期 /
+ * 并发 in-flight 去重 / LRU 逐出 / 深拷贝隔离 / 失败不缓存不换形 /
+ * invalidateCache 按项目与全量清除 / 环境变量解析容错 / DEBUG 命中率日志 /
+ * 工具层零感知（handler 返回形态缓存前后一致）。
+ *
+ * 时钟：单测用注入时钟（readCache.now 可替换实例字段）；服务端命中数即回源次数。
+ */
+import assert from 'node:assert/strict';
+import { createServer } from 'node:http';
+import { TapdClient } from '../tapd-client.js';
+import { TapdError } from '../errors/index.js';
+import { workflowTools } from '../tools/workflow.js';
+import { CACHE_TTL_MS, ReadCache, canonicalQuery, cacheKeyFor, invalidateCache, parseCacheDebug, parseCacheEnabled, parseTtlMultiplier, readCache, ttlForPath, } from './read-cache.js';
+// 确定性：错误路径断言走 fetch 单通道；退避基数调小（registry.test.ts 已设，独立运行也成立）
+process.env.TAPD_SDK_DISABLED = '1';
+TapdClient.retryBackoffBaseMs = 1;
+async function withFakeTapd(fn) {
+    let hits = 0;
+    let behavior = {};
+    const server = createServer((req, res) => {
+        hits += 1;
+        const b = behavior;
+        const respond = () => {
+            const data = b.data !== undefined ? b.data : { n: hits };
+            const body = JSON.stringify({ status: b.tapdStatus ?? 1, data, info: b.info ?? '' });
+            res.writeHead(b.status ?? 200, { 'Content-Type': 'application/json' });
+            res.end(body);
+        };
+        if (b.delayMs !== undefined) {
+            setTimeout(respond, b.delayMs);
+        }
+        else {
+            respond();
+        }
+    });
+    await new Promise(resolve => server.listen(0, '127.0.0.1', resolve));
+    const address = server.address();
+    try {
+        await fn({
+            baseUrl: `http://127.0.0.1:${address.port}`,
+            hits: () => hits,
+            setBehavior: next => { behavior = next; },
+        });
+    }
+    finally {
+        await new Promise(resolve => server.close(() => resolve()));
+    }
+}
+function mkClient(baseUrl) {
+    return TapdClient.fromAccessToken('cache-test-token', baseUrl);
+}
+// ---------------------------------------------------------------------------
+// 单例状态复位（每个用例前后执行，防串扰）
+// ---------------------------------------------------------------------------
+const ENV_KEYS = ['TAPD_CACHE', 'TAPD_CACHE_TTL', 'TAPD_CACHE_DEBUG'];
+function resetCacheState() {
+    readCache.invalidate();
+    readCache.resetStats();
+    readCache.now = Date.now;
+    for (const key of ENV_KEYS)
+        delete process.env[key];
+}
+// ---------------------------------------------------------------------------
+// 用例
+// ---------------------------------------------------------------------------
+const checks = [
+    ['ttlForPath: allowlist 全覆盖（精确表 + custom_fields_settings 后缀族），表外一律 undefined', () => {
+            // 精确表：workitem_types / workflow 状态表步骤 / 成员 / settings 系 / 分类 / 角色
+            assert.equal(ttlForPath('/workitem_types'), CACHE_TTL_MS.workitemTypes);
+            for (const path of [
+                '/workflows', '/workflows/status_map', '/workflows/step_map', '/workflows/last_steps',
+                '/workflows/first_step', '/workflows/all_transitions', '/workflows/all_last_steps',
+            ]) {
+                assert.equal(ttlForPath(path), CACHE_TTL_MS.workflow, path);
+            }
+            assert.equal(ttlForPath('/users'), CACHE_TTL_MS.workspaceMembers);
+            assert.equal(ttlForPath('/workspaces/users'), CACHE_TTL_MS.workspaceMembers);
+            for (const path of [
+                '/settings/modules', '/settings/modules/count', '/settings/versions', '/settings/versions/count',
+                '/settings/features', '/settings/features/count', '/settings/workspace_setting',
+            ]) {
+                assert.equal(ttlForPath(path), CACHE_TTL_MS.settings, path);
+            }
+            for (const path of ['/story_categories', '/story_categories/count', '/tcase_categories', '/tcase_categories/count']) {
+                assert.equal(ttlForPath(path), CACHE_TTL_MS.categories, path);
+            }
+            assert.equal(ttlForPath('/roles'), CACHE_TTL_MS.roles);
+            assert.equal(ttlForPath('/workspaces/custom_fields'), CACHE_TTL_MS.customFieldConfig);
+            // 后缀族：各实体自定义字段配置（含 launch_forms）
+            for (const path of [
+                '/stories/custom_fields_settings', '/bugs/custom_fields_settings', '/tasks/custom_fields_settings',
+                '/tcases/custom_fields_settings', '/iterations/custom_fields_settings', '/launch_forms/custom_fields_settings',
+            ]) {
+                assert.equal(ttlForPath(path), CACHE_TTL_MS.customFieldConfig, path);
+            }
+            // 表外直连
+            for (const path of ['/stories', '/bugs', '/comments', '/settings/baselines', '/users/info', '/workflows/other', 'custom_fields_settings']) {
+                assert.equal(ttlForPath(path), undefined, path);
+            }
+        }],
+    ['canonicalQuery/cacheKeyFor: 剔除 undefined、键排序、origin 命名空间、workspace 参数隔离', () => {
+            assert.equal(canonicalQuery(undefined), '');
+            assert.equal(canonicalQuery({}), '');
+            assert.equal(canonicalQuery({ b: 2, a: 'x', c: undefined }), 'a=x&b=2');
+            assert.equal(canonicalQuery({ a: 'x', b: 2 }), 'a=x&b=2');
+            const key = (params) => cacheKeyFor('https://api.tapd.cn', '/workflows/status_map', params);
+            assert.equal(key({ system: 'bug', workspace_id: 1 }), key({ workspace_id: 1, system: 'bug' }));
+            assert.equal(key({ system: 'bug', workspace_id: 1 }), key({ system: 'bug', workspace_id: 1, fields: undefined }));
+            assert.notEqual(key({ workspace_id: 1 }), key({ workspace_id: 2 })); // workspace 维度隔离
+            assert.notEqual(key({ system: 'bug' }), key({ system: 'story' }));
+            assert.match(key({ workspace_id: 1 }), /^https:\/\/api\.tapd\.cn /); // origin 前缀防多环境串缓存
+        }],
+    ['env 解析容错：TAPD_CACHE / TAPD_CACHE_TTL / TAPD_CACHE_DEBUG 非法值回退默认，绝不抛错', () => {
+            // 开关：默认 on；off 族词关；其余视为 on
+            for (const raw of [undefined, '', 'on', '1', 'true', 'YES', 'enabled']) {
+                assert.equal(parseCacheEnabled(raw), true, String(raw));
+            }
+            for (const raw of ['0', 'off', 'false', 'No', 'DISABLED']) {
+                assert.equal(parseCacheEnabled(raw), false, String(raw));
+            }
+            // 倍率：正数生效；空/非法/非正回退 1
+            assert.equal(parseTtlMultiplier(undefined), 1);
+            assert.equal(parseTtlMultiplier(''), 1);
+            assert.equal(parseTtlMultiplier('2'), 2);
+            assert.equal(parseTtlMultiplier('0.5'), 0.5);
+            assert.equal(parseTtlMultiplier('abc'), 1);
+            assert.equal(parseTtlMultiplier('0'), 1);
+            assert.equal(parseTtlMultiplier('-3'), 1);
+            assert.equal(parseTtlMultiplier('NaN'), 1);
+            // 调试：on 族词开，其余关
+            assert.equal(parseCacheDebug(undefined), false);
+            assert.equal(parseCacheDebug('1'), true);
+            assert.equal(parseCacheDebug('TRUE'), true);
+            assert.equal(parseCacheDebug('on'), true);
+            assert.equal(parseCacheDebug('0'), false);
+            assert.equal(parseCacheDebug('whatever'), false);
+        }],
+    ['client: allowlist 命中/未命中——同键两次只回源一次且返回深拷贝；表外端点与 POST 一律直连', async () => {
+            await withFakeTapd(async (tapd) => {
+                const client = mkClient(tapd.baseUrl);
+                const first = await client.get('/workitem_types', { workspace_id: 39814312 });
+                const second = await client.get('/workitem_types', { workspace_id: 39814312 });
+                assert.equal(tapd.hits(), 1); // 第二次走缓存
+                assert.deepEqual(second, first); // 形态零变化
+                assert.notEqual(second, first); // 深拷贝：非同引用
+                // 后缀族（自定义字段配置）同样缓存
+                await client.get('/stories/custom_fields_settings', { workspace_id: 39814312 });
+                await client.get('/stories/custom_fields_settings', { workspace_id: 39814312 });
+                assert.equal(tapd.hits(), 2);
+                // 非 allowlist：GET 直连
+                await client.get('/stories', { workspace_id: 39814312 });
+                await client.get('/stories', { workspace_id: 39814312 });
+                assert.equal(tapd.hits(), 4);
+                // POST 不缓存
+                await client.post('/settings/modules/add', { workspace_id: 39814312, name: 'x' });
+                await client.post('/settings/modules/add', { workspace_id: 39814312, name: 'x' });
+                assert.equal(tapd.hits(), 6);
+            });
+        }],
+    ['client: 键规范化与 workspace 隔离——异序同键共享缓存，不同 workspace 各自回源', async () => {
+            await withFakeTapd(async (tapd) => {
+                const client = mkClient(tapd.baseUrl);
+                await client.get('/workflows/status_map', { workspace_id: 39814312, system: 'bug' });
+                await client.get('/workflows/status_map', { system: 'bug', workspace_id: 39814312 });
+                assert.equal(tapd.hits(), 1); // 参数异序 → 同键命中
+                await client.get('/workflows/status_map', { workspace_id: 22222222, system: 'bug' });
+                assert.equal(tapd.hits(), 2); // 不同项目 → 独立回源
+                await client.get('/workflows/status_map', { workspace_id: 39814312, system: 'story' });
+                assert.equal(tapd.hits(), 3); // 参数不同 → 独立回源
+            });
+        }],
+    ['client: TTL 过期——注入时钟推进未满 TTL 命中缓存，越过 1h 后重新回源', async () => {
+            let fakeNow = 1_700_000_000_000;
+            readCache.now = () => fakeNow;
+            await withFakeTapd(async (tapd) => {
+                const client = mkClient(tapd.baseUrl);
+                const params = { workspace_id: 39814312 };
+                const first = await client.get('/workitem_types', params);
+                assert.equal(first.n, 1);
+                fakeNow += CACHE_TTL_MS.workitemTypes - 60_000; // 59 分钟后
+                const cached = await client.get('/workitem_types', params);
+                assert.equal(cached.n, 1); // 仍命中缓存
+                assert.equal(tapd.hits(), 1);
+                fakeNow += 2 * 60_000; // 越过 1h TTL
+                const fresh = await client.get('/workitem_types', params);
+                assert.equal(fresh.n, 2); // 过期重新回源
+                assert.equal(tapd.hits(), 2);
+            });
+        }],
+    ['client: in-flight 去重——并发同键共享一次回源，慢服务端下也不重复；回源结果照常入库', async () => {
+            await withFakeTapd(async (tapd) => {
+                tapd.setBehavior({ delayMs: 25 });
+                const client = mkClient(tapd.baseUrl);
+                const params = { workspace_id: 39814312 };
+                const [a, b, c] = await Promise.all([
+                    client.get('/settings/modules', params),
+                    client.get('/settings/modules', params),
+                    client.get('/settings/modules', params),
+                ]);
+                assert.equal(tapd.hits(), 1); // 三个并发只打一次
+                assert.deepEqual(a, { n: 1 });
+                assert.deepEqual(b, a);
+                assert.deepEqual(c, a);
+                // 并发结束后再请求 → 命中缓存，不再回源
+                const again = await client.get('/settings/modules', params);
+                assert.equal(tapd.hits(), 1);
+                assert.deepEqual(again, { n: 1 });
+            });
+        }],
+    ['client: 深拷贝隔离——消费方 mutate 命中结果不污染缓存，源头对象后续变更也不入库', async () => {
+            await withFakeTapd(async (tapd) => {
+                tapd.setBehavior({ data: { list: [{ id: 1 }] } });
+                const client = mkClient(tapd.baseUrl);
+                const params = { workspace_id: 39814312 };
+                const first = await client.get('/workspaces/custom_fields', params);
+                first.list[0].id = 999; // 消费方破坏性修改
+                const second = await client.get('/workspaces/custom_fields', params);
+                assert.equal(second.list[0].id, 1); // 缓存未被污染
+                assert.equal(tapd.hits(), 1);
+                second.list.push({ id: 42 });
+                const third = await client.get('/workspaces/custom_fields', params);
+                assert.equal(third.list.length, 1); // 增删同样不影响
+            });
+        }],
+    ['client: 失败不缓存、错误不吞不换形——HTTP 403 / 业务 status=0 / 并发失败共享且 in-flight 自清理', async () => {
+            await withFakeTapd(async (tapd) => {
+                const client = mkClient(tapd.baseUrl);
+                const params = { workspace_id: 39814312 };
+                const getTypes = () => client.get('/workitem_types', params);
+                // HTTP 403：TapdError 原样上抛，两次调用两次回源（失败不入缓存）
+                tapd.setBehavior({ status: 403 });
+                await assert.rejects(getTypes(), (error) => {
+                    assert.ok(error instanceof TapdError);
+                    assert.equal(error.detail.code, 'TAPD_HTTP_403');
+                    assert.ok(error.detail.hint.length > 0);
+                    return true;
+                });
+                await assert.rejects(getTypes(), (error) => error instanceof TapdError);
+                assert.equal(tapd.hits(), 2);
+                // 业务错误（HTTP 200 + status=0）：同样不缓存、形态不变
+                tapd.setBehavior({ tapdStatus: 0, info: 'no permission' });
+                await assert.rejects(getTypes(), (error) => {
+                    assert.ok(error instanceof TapdError);
+                    assert.equal(error.detail.code, 'TAPD_API_STATUS');
+                    return true;
+                });
+                assert.equal(tapd.hits(), 3);
+                // 并发失败：共享一次回源；settle 后 in-flight 清理，下一发正常回源
+                tapd.setBehavior({ tapdStatus: 0, info: 'boom' });
+                await Promise.allSettled([getTypes(), getTypes()]).then(results => {
+                    assert.equal(results.filter(r => r.status === 'rejected').length, 2);
+                });
+                assert.equal(tapd.hits(), 4); // 并发只打一次
+                await assert.rejects(getTypes(), (error) => error instanceof TapdError);
+                assert.equal(tapd.hits(), 5); // 失败后的下一次是全新回源
+                assert.equal(readCache.stats().size, 0); // 全程零成功 → 零条目
+            });
+        }],
+    ['invalidateCache: 按 workspace 清除只动该项目，其余项目继续命中；无参全量清空', async () => {
+            await withFakeTapd(async (tapd) => {
+                const client = mkClient(tapd.baseUrl);
+                await client.get('/workitem_types', { workspace_id: 111 });
+                await client.get('/workitem_types', { workspace_id: 222 });
+                assert.equal(tapd.hits(), 2);
+                assert.equal(invalidateCache(111), 1); // 只清 111 的一条
+                await client.get('/workitem_types', { workspace_id: 111 });
+                assert.equal(tapd.hits(), 3); // 111 重新回源
+                await client.get('/workitem_types', { workspace_id: 222 });
+                assert.equal(tapd.hits(), 3); // 222 仍命中缓存
+                assert.equal(invalidateCache(), 2); // 全量：清掉 111 重取入库 + 222 存量，共两条
+                await client.get('/workitem_types', { workspace_id: 222 });
+                assert.equal(tapd.hits(), 4);
+            });
+        }],
+    ['client: TAPD_CACHE=off 全直连（0/1 等价），恢复后重新生效', async () => {
+            await withFakeTapd(async (tapd) => {
+                const client = mkClient(tapd.baseUrl);
+                const params = { workspace_id: 39814312 };
+                process.env.TAPD_CACHE = 'off';
+                await client.get('/workitem_types', params);
+                await client.get('/workitem_types', params);
+                assert.equal(tapd.hits(), 2); // 关闭时逐次直连
+                process.env.TAPD_CACHE = '0';
+                await client.get('/workitem_types', params);
+                await client.get('/workitem_types', params);
+                assert.equal(tapd.hits(), 4); // '0' 等价关闭
+                delete process.env.TAPD_CACHE; // 恢复默认 on
+                await client.get('/workitem_types', params);
+                await client.get('/workitem_types', params);
+                assert.equal(tapd.hits(), 5); // 第一发回源入库，第二发命中
+            });
+        }],
+    ['client: TAPD_CACHE_TTL 倍率——2x 下 1.5h 仍命中、2.1h 过期；非法倍率容错为 1x', async () => {
+            let fakeNow = 1_700_000_000_000;
+            readCache.now = () => fakeNow;
+            await withFakeTapd(async (tapd) => {
+                const client = mkClient(tapd.baseUrl);
+                const params = { workspace_id: 39814312 };
+                const getTypes = () => client.get('/workitem_types', params);
+                process.env.TAPD_CACHE_TTL = '2';
+                assert.equal((await getTypes()).n, 1);
+                fakeNow += CACHE_TTL_MS.workitemTypes * 1.5; // 1.5h（2h 窗口内）
+                assert.deepEqual(await getTypes(), { n: 1 }); // 仍命中
+                assert.equal(tapd.hits(), 1);
+                fakeNow += CACHE_TTL_MS.workitemTypes * 0.6; // 累计 2.1h，越过 2x 窗口
+                assert.equal((await getTypes()).n, 2); // 过期回源
+                assert.equal(tapd.hits(), 2);
+                process.env.TAPD_CACHE_TTL = 'abc'; // 非法倍率 → 回退 1x
+                invalidateCache();
+                assert.equal((await getTypes()).n, 3);
+                fakeNow += CACHE_TTL_MS.workitemTypes + 1; // 1x 窗口刚好越过
+                assert.equal((await getTypes()).n, 4);
+                assert.equal(tapd.hits(), 4);
+            });
+        }],
+    ['ReadCache: LRU 逐出——超限逐出最久未命中条目，命中刷新新近度', () => {
+            let t = 1_000;
+            const cache = new ReadCache({ now: () => t, maxEntries: 2, enabled: true, ttlMultiplier: 1 });
+            cache.store('k1', { v: 1 }, 10_000);
+            t += 10;
+            cache.store('k2', { v: 2 }, 10_000);
+            t += 10;
+            assert.ok(cache.peek('k1') !== undefined); // touch k1 → 最旧变成 k2
+            t += 10;
+            cache.store('k3', { v: 3 }, 10_000); // 超限逐出 k2
+            assert.ok(cache.peek('k1') !== undefined);
+            assert.equal(cache.peek('k2'), undefined); // 被逐出
+            assert.ok(cache.peek('k3') !== undefined);
+            assert.equal(cache.stats().size, 2);
+        }],
+    ['ReadCache: store/peek 深拷贝双向隔离 + 过期惰性清除 + stats/resetStats', () => {
+            let t = 1_000;
+            const cache = new ReadCache({ now: () => t, enabled: true, ttlMultiplier: 1 });
+            const source = { nested: { count: 1 } };
+            cache.store('k', source, 1_000);
+            source.nested.count = 99; // 入库后改源头
+            const out = cache.peek('k');
+            assert.equal(out.nested.count, 1); // 存的是深拷贝
+            out.nested.count = 42; // 读出的也是深拷贝
+            assert.equal((cache.peek('k')).nested.count, 1);
+            t += 1_001; // 越过 TTL
+            assert.equal(cache.peek('k'), undefined); // 惰性清除
+            assert.equal(cache.stats().size, 0);
+            assert.equal(cache.stats().misses >= 1, true);
+            assert.equal(cache.stats().hitRate > 0, true);
+            cache.resetStats();
+            assert.deepEqual(cache.stats(), { size: 0, inflight: 0, hits: 0, misses: 0, hitRate: 0 });
+        }],
+    ['ReadCache: invalidate 按 workspace 清除返回条目数，短/长 ID 数值与字符串等价', () => {
+            const cache = new ReadCache({ enabled: true, ttlMultiplier: 1 });
+            cache.store('a', 1, 1_000, 111);
+            cache.store('b', 2, 1_000, '111'); // String() 归一后同属 111
+            cache.store('c', 3, 1_000, 222);
+            assert.equal(cache.invalidate('111'), 2); // 数值/字符串同一项目
+            assert.equal(cache.peek('a'), undefined);
+            assert.equal(cache.peek('b'), undefined);
+            assert.ok(cache.peek('c') !== undefined);
+            assert.equal(cache.invalidate(), 1);
+            assert.equal(cache.peek('c'), undefined);
+            // 无 workspace 元数据条目只在全量清除时移除
+            cache.store('plain', 4, 1_000);
+            assert.equal(cache.invalidate(999), 0);
+            assert.equal(cache.invalidate(), 1);
+        }],
+    ['ReadCache: TAPD_CACHE_DEBUG——命中/未命中日志携带键与实时命中率', () => {
+            const logs = [];
+            const cache = new ReadCache({ enabled: true, ttlMultiplier: 1, debug: true, log: m => logs.push(m) });
+            cache.store('ns /roles?workspace_id=1', [{ name: 'dev' }], 1_000);
+            assert.ok(cache.peek('ns /roles?workspace_id=1') !== undefined);
+            assert.equal(cache.peek('ns /roles?missing'), undefined);
+            assert.equal(cache.peek('ns /roles?workspace_id=1') !== undefined, true);
+            const hitLogs = logs.filter(l => l.includes('HIT ns /roles?workspace_id=1'));
+            const missLogs = logs.filter(l => l.includes('MISS ns /roles?missing'));
+            assert.equal(hitLogs.length, 2);
+            assert.equal(missLogs.length, 1);
+            assert.match(hitLogs[0], /hits 1\/1, 100%/);
+            assert.match(hitLogs[1], /hits 2\/3, 67%/);
+            // 关闭 debug 时零日志
+            const quiet = new ReadCache({ enabled: true, ttlMultiplier: 1, debug: false, log: m => logs.push(m) });
+            quiet.store('k', 1, 1_000);
+            quiet.peek('k');
+            assert.equal(logs.length, 3);
+        }],
+    ['工具层零感知：workflow 工具 handler 直连与缓存两次调用的返回形态完全一致', async () => {
+            await withFakeTapd(async (tapd) => {
+                const client = mkClient(tapd.baseUrl);
+                const tool = workflowTools.find(t => t.name === 'tapd_get_workflow_status_map');
+                assert.ok(tool, 'tapd_get_workflow_status_map not found');
+                const params = { system: 'bug', workspace_id: 39814312 };
+                const direct = await tool.handler(client, params); // 首次：回源
+                const cached = await tool.handler(client, params); // 二次：命中缓存
+                assert.equal(tapd.hits(), 1);
+                assert.deepEqual(cached, direct); // registry/工具层无感，形态零变化
+            });
+        }],
+];
+// ---------------------------------------------------------------------------
+// 运行器（与既有测试文件同款：PASS/FAIL 逐条 + 退出码）
+// ---------------------------------------------------------------------------
+resetCacheState();
+let failed = 0;
+for (const [name, check] of checks) {
+    resetCacheState();
+    try {
+        await check();
+        console.log(`PASS ${name}`);
+    }
+    catch (error) {
+        failed++;
+        console.error(`FAIL ${name}`);
+        console.error(`  ${error instanceof Error ? error.stack ?? error.message : String(error)}`);
+    }
+}
+resetCacheState();
+if (failed > 0) {
+    console.error(`\n${failed}/${checks.length} failed`);
+    process.exitCode = 1;
+}
+else {
+    console.log(`\n${checks.length}/${checks.length} passed`);
+}
+//# sourceMappingURL=read-cache.test.js.map

package/dist/cache/read-cache.test.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,120 @@
+/**
+ * TapdError —— 结构化错误模型（错误降级详情）
+ *
+ * 设计目标：工具报错时输出"足够人工接管"的信息，而不是薄薄一行状态码 + message。
+ * - 统一字段：内部错误码 / HTTP 状态 / endpoint / TAPD 服务端原始 status+info / 脱敏参数
+ * - hint：针对性修复建议（按错误码定制）
+ * - takeover：人工接管指引（建议检查项 / 开放平台·后台操作路径 / 需收集的信息）
+ * - JSON 友好：`toJSON()` 返回纯结构；`message` 首行保留人可读摘要（兼容旧日志/测试），
+ *   首行之后追加 `tapd-error <code>:` + pretty JSON 块——MCP 层只透出 message 字符串即可
+ *   完整携带结构（mcp 仓零改动受益）。
+ */
+/** 内部错误码。HTTP 类为 `TAPD_HTTP_<status>`；语义化的用专名码。 */
+export type TapdErrorCode = `TAPD_HTTP_${number}` | 'TAPD_RATE_LIMIT' | 'TAPD_BAD_ID' | 'TAPD_API_STATUS' | 'TAPD_NON_JSON' | 'TAPD_NETWORK' | 'TAPD_SDK_ERROR' | 'TAPD_TIMEOUT' | 'TAPD_PARTIAL' | 'TAPD_UNKNOWN';
+/** 人工接管指引：建议检查项 / 操作路径 / 需收集反馈的信息。 */
+export interface TapdTakeover {
+    /** 建议检查项（按顺序排查） */
+    checks: string[];
+    /** 开放平台 / TAPD 后台操作路径 */
+    where?: string[];
+    /** 找平台管理员/提单时需要收集的信息 */
+    collect?: string[];
+}
+/** 批量操作（TAPD_PARTIAL）逐项失败条目。 */
+export interface BatchFailureItem {
+    id: string;
+    error: TapdErrorDetail;
+}
+/** 错误详情的 JSON 友好结构（可直接 JSON.stringify 透出）。 */
+export interface TapdErrorDetail {
+    code: TapdErrorCode;
+    /** 首行人可读摘要（与 Error.message 首行一致） */
+    message: string;
+    httpStatus?: number;
+    method?: 'GET' | 'POST';
+    /** 完整 API 路径（如 /stories） */
+    endpoint?: string;
+    /** TAPD 响应体原始 status（业务码，区别于 HTTP status） */
+    tapdStatus?: number;
+    /** TAPD 响应体原始 info/message */
+    tapdMessage?: string;
+    /** 脱敏后的关键请求参数（凭证类字段掩码、长文本截断） */
+    params?: Record<string, unknown>;
+    /** 服务端 Retry-After 解析值（仅 429 有时携带） */
+    retryAfterMs?: number;
+    /** 实际发起的请求次数（含首次；可判断是否已重试穷尽） */
+    attempts?: number;
+    hint: string;
+    takeover: TapdTakeover;
+    /** 底层原始错误消息（网络异常 / SDK 异常等） */
+    cause?: string;
+    /** 工具名（registry 层超时等无 endpoint 场景） */
+    tool?: string;
+    /** TAPD_PARTIAL：逐项错误 */
+    items?: BatchFailureItem[];
+}
+/** 请求上下文（client 层抛错时携带，供 detail 组装）。 */
+export interface RequestContext {
+    method: 'GET' | 'POST';
+    path: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * 错误详情参数脱敏：
+ * - 凭证类字段（password/token/secret/credential）一律掩码为 ***（与 registry 审计同规则）
+ * - 超长字符串截断（description/content 类字段不应淹没错误详情）
+ */
+export declare function sanitizeParamsForError(params?: Record<string, unknown>): Record<string, unknown> | undefined;
+/** 解析 Retry-After 头（秒数或 HTTP 日期）为毫秒；无法解析返回 undefined。 */
+export declare function parseRetryAfterMs(header: string | null): number | undefined;
+/**
+ * 按错误码生成针对性 hint + takeover。
+ * 独立成纯函数便于单测各状态码的指引内容。
+ */
+export declare function buildGuidance(code: TapdErrorCode, ctx?: RequestContext, info?: {
+    httpStatus?: number;
+    tapdMessage?: string;
+    retryAfterMs?: number;
+    attempts?: number;
+    timeoutMs?: number;
+    total?: number;
+}): {
+    hint: string;
+    takeover: TapdTakeover;
+};
+/**
+ * 统一错误对象。
+ * - `message` 首行 = detail.message（人可读摘要，兼容旧日志/test 对首行的依赖）
+ * - `toJSON()` 返回纯结构（registry 会挂到 ExecResult.error.detail）
+ */
+export declare class TapdError extends Error {
+    readonly detail: TapdErrorDetail;
+    constructor(detail: TapdErrorDetail);
+    toJSON(): TapdErrorDetail;
+    /** HTTP 非 2xx：按状态码归一语义码（429→RATE_LIMIT，404+id→BAD_ID）。 */
+    static http(ctx: RequestContext, httpStatus: number, statusText: string, bodyText: string, opts?: {
+        retryAfterMs?: number;
+        attempts?: number;
+    }): TapdError;
+    /** HTTP 200 但响应体 status !== 1（TAPD 业务错误）。 */
+    static apiStatus(ctx: RequestContext, tapdStatus: number, info: string, attempts?: number): TapdError;
+    /** 响应非 JSON（网关/代理/异常页）。 */
+    static nonJson(ctx: RequestContext, text: string, attempts?: number): TapdError;
+    /** 网络层失败（fetch reject：DNS/连接/中断）。 */
+    static network(ctx: RequestContext, cause: unknown, attempts?: number): TapdError;
+    /** SDK 通道抛错（POST 不回退 fetch）。 */
+    static sdk(ctx: RequestContext, cause: unknown): TapdError;
+    /** registry 层工具执行超时。 */
+    static timeout(tool: string, timeoutMs: number, args?: Record<string, unknown>): TapdError;
+    /**
+     * 批量操作全部失败（部分失败时 handler 返回降级聚合结构，不抛错）。
+     * items 携带逐项 TapdErrorDetail，保证"全部失败"也不丢任何单项信息。
+     */
+    static partial(ctx: RequestContext, total: number, failed: {
+        id: string;
+        error: TapdError;
+    }[]): TapdError;
+    /** 未分类错误统一包一层（保留原 message 为首行摘要）。 */
+    static wrap(cause: unknown, tool?: string): TapdError;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

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