import { test, expect, describe } from "bun:test"; import { scanTrackingDiff, summarizeTrackingImpact, trackingNeedsAttention, renderTrackingImpactMarkdown, TRACKING_GUARD_BLOCK, } from "@bbbug/shared/tracking_guard"; /** * 埋点扫描的判定。 * * 这些用例钉的是**档位**,不是命中数:档位是唯一进入卡片、飞书通知和抽屉的东西, * 而命中数只是给人读的注脚。尤其是 `removed`(有删无增)和 `changed`(有删有增) * 必须分开 —— 前者是「埋点没了」,后者是「埋点改了」,提需人对这两件事的反应不同。 */ const diff = (file: string, body: string) => `diff --git a/${file} b/${file}\n--- a/${file}\n+++ b/${file}\n@@ -1,5 +1,5 @@\n${body}\n`; describe("埋点扫描 · 档位判定", () => { test("删掉一个上报调用且无对应新增 → removed", () => { const i = scanTrackingDiff(diff("app/src/Entry.kt", [ " fun onClick() {", '- MobClickHelper.onEventV3("story_camera_click", params)', " navigate()", " }", ].join("\n"))); expect(i.verdict).toBe("removed"); expect(i.removed).toBe(1); expect(i.eventKeys).toContain("story_camera_click"); expect(trackingNeedsAttention(i)).toBe(true); }); test("有删有增(改名 / 挪位置)→ changed", () => { const i = scanTrackingDiff(diff("app/src/Entry.kt", [ '- MobClickHelper.onEventV3("story_camera_click", params)', '+ MobClickHelper.onEventV3("story_camera_tap", params)', ].join("\n"))); expect(i.verdict).toBe("changed"); expect(trackingNeedsAttention(i)).toBe(true); }); test("只新增上报 → added,且不算需要人确认", () => { const i = scanTrackingDiff(diff("app/src/Entry.kt", '+ MobClickHelper.onEventV3("new_entry_show", params)')); expect(i.verdict).toBe("added"); expect(trackingNeedsAttention(i)).toBe(false); }); test("改动紧挨着既有埋点但没碰它 → nearby(漏埋的信号)", () => { const i = scanTrackingDiff(diff("app/src/Entry.kt", [ ' MobClickHelper.onEventV3("story_camera_click", params)', "- navigate(OLD)", "+ navigate(NEW)", ].join("\n"))); expect(i.verdict).toBe("nearby"); expect(i.removed + i.added).toBe(0); expect(trackingNeedsAttention(i)).toBe(false); }); test("完全不沾埋点 → none", () => { const i = scanTrackingDiff(diff("app/src/Entry.kt", "- val a = 1\n+ val a = 2")); expect(i.verdict).toBe("none"); expect(summarizeTrackingImpact(i)).toContain("未触碰埋点"); }); test("非源码文件的命中不算数(锁文件 / 快照里的同名字符串)", () => { const i = scanTrackingDiff(diff("bun.lock", '- "trackEvent": "1.0.0"')); expect(i.verdict).toBe("none"); }); test("iOS 侧的上报家族同样识别", () => { const i = scanTrackingDiff(diff("Sources/AWEEntry.m", '- [AWEUserTrackManager trackEvent:@"story_camera_click" params:p];')); expect(i.verdict).toBe("removed"); }); test("空 diff 不炸", () => { expect(scanTrackingDiff("").verdict).toBe("none"); expect(scanTrackingDiff(" \n").verdict).toBe("none"); }); }); describe("埋点扫描 · 产物", () => { test("removed 档的 markdown 明确要求提需人确认", () => { const i = scanTrackingDiff(diff("app/src/Entry.kt", '- MobClickHelper.onEventV3("story_camera_click", params)')); const md = renderTrackingImpactMarkdown(i); expect(md).toContain("## 埋点影响"); expect(md).toContain("需要提需人确认"); expect(md).toContain("app/src/Entry.kt"); }); test("扫描失败时的摘要说的是「没扫成」,不是「没事」", () => { // 这两者混为一谈,正是这套护栏要防的那类沉默。 const s = summarizeTrackingImpact({ verdict: "none", files: [], removed: 0, added: 0, nearby: 0, eventKeys: [], error: "仓库不存在", }); expect(s).toContain("未能扫描"); expect(s).not.toContain("未触碰"); }); }); describe("埋点铁律块", () => { test("不再把覆盖率插桩和业务埋点绑在一起", () => { expect(TRACKING_GUARD_BLOCK).not.toContain("调试插桩"); expect(TRACKING_GUARD_BLOCK).not.toContain("行覆盖"); expect(TRACKING_GUARD_BLOCK).toContain("业务埋点"); }); });