@chainlesschain/personal-data-hub 0.4.18 → 0.4.23

package/__tests__/adapters/biz-tianyancha.test.js

@@ -0,0 +1,159 @@
+"use strict";
+
+import { describe, it, expect } from "vitest";
+const fs = require("node:fs");
+const path = require("node:path");
+const os = require("node:os");
+const crypto = require("node:crypto");
+
+const {
+  TianyanchaAdapter,
+  extractData,
+  NAME,
+  VERSION,
+  SNAPSHOT_SCHEMA_VERSION,
+} = require("../../lib/adapters/biz-tianyancha");
+
+function writeTmp(content) {
+  const p = path.join(os.tmpdir(), `cc-tyc-${crypto.randomUUID()}.json`);
+  fs.writeFileSync(p, content, "utf-8");
+  return p;
+}
+async function collect(gen) {
+  const out = [];
+  for await (const x of gen) out.push(x);
+  return out;
+}
+
+const COOKIES = "auth_token=abc; TYCID=xyz";
+
+const SNAP = JSON.stringify({
+  schemaVersion: 1,
+  snapshottedAt: 1716383000000,
+  account: { userId: "u1" },
+  events: [
+    { kind: "monitor", id: "mon-G1", companyId: "G1", companyName: "字节跳动有限公司", legalPerson: "张利东", regStatus: "存续", capturedAt: 1716300000000 },
+    { kind: "search", id: "s-1", query: "小米科技", companyName: "小米科技有限责任公司", capturedAt: 1716320000000 },
+  ],
+});
+
+describe("constants + extractData", () => {
+  it("name/version/schema", () => {
+    expect(NAME).toBe("biz-tianyancha");
+    expect(VERSION).toBe("0.1.0");
+    expect(SNAPSHOT_SCHEMA_VERSION).toBe(1);
+  });
+  it("extractData tolerant", () => {
+    expect(extractData({ data: [{ id: 1 }] })).toHaveLength(1);
+    expect(extractData({ data: { resultList: [{ id: 1 }] } })).toHaveLength(1);
+    expect(extractData({ list: [{ id: 1 }] })).toHaveLength(1);
+    expect(extractData({})).toEqual([]);
+  });
+});
+
+describe("TianyanchaAdapter snapshot mode", () => {
+  it("authenticate validates inputPath", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new TianyanchaAdapter();
+      expect((await a.authenticate({ inputPath: p })).mode).toBe("snapshot-file");
+      expect((await a.authenticate({ inputPath: path.join(os.tmpdir(), "no-tyc.json") })).reason).toBe("INPUT_PATH_UNREADABLE");
+    } finally {
+      fs.unlinkSync(p);
+    }
+  });
+
+  it("sync 2 kinds + normalize monitor→like / search→interaction", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new TianyanchaAdapter();
+      const items = await collect(a.sync({ inputPath: p }));
+      expect(items.map((x) => x.kind)).toEqual(["monitor", "search"]);
+
+      const mon = a.normalize(items[0]);
+      expect(mon.events[0].subtype).toBe("like");
+      expect(mon.events[0].content.title).toBe("关注公司: 字节跳动有限公司");
+      expect(mon.events[0].extra.legalPerson).toBe("张利东");
+      expect(mon.events[0].extra.regStatus).toBe("存续");
+
+      const search = a.normalize(items[1]);
+      expect(search.events[0].subtype).toBe("interaction");
+      expect(search.events[0].content.title).toBe("搜索企业: 小米科技");
+      expect(search.events[0].extra.companyName).toBe("小米科技有限责任公司");
+    } finally {
+      fs.unlinkSync(p);
+    }
+  });
+
+  it("include + limit + schema mismatch + unknown kind", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new TianyanchaAdapter();
+      expect((await collect(a.sync({ inputPath: p, include: { monitor: false } }))).map((x) => x.kind)).toEqual(["search"]);
+      expect(await collect(a.sync({ inputPath: p, limit: 1 }))).toHaveLength(1);
+      expect(() => a.normalize({ kind: "bogus", payload: {} })).toThrow(/unknown kind/);
+    } finally {
+      fs.unlinkSync(p);
+    }
+    const bad = writeTmp(JSON.stringify({ schemaVersion: 9, events: [] }));
+    try {
+      const a = new TianyanchaAdapter();
+      await expect(collect(a.sync({ inputPath: bad }))).rejects.toThrow(/schemaVersion mismatch/);
+    } finally {
+      fs.unlinkSync(bad);
+    }
+  });
+});
+
+describe("TianyanchaAdapter cookie-api mode", () => {
+  it("authenticate cookie (userId optional)", async () => {
+    const a = new TianyanchaAdapter({ account: { cookies: COOKIES } });
+    expect(await a.authenticate()).toEqual({ ok: true, account: null, mode: "cookie" });
+  });
+
+  it("sync fetches monitor + search, normalizes", async () => {
+    const byUrl = (u) => (u.includes("monitor") ? "monitor" : "search");
+    const data = {
+      monitor: [{ graphId: "G9", companyName: "腾讯科技", legalPersonName: "马化腾", createTime: 1716300000 }],
+      search: [{ id: "h1", keyword: "阿里巴巴", searchTime: 1716320000 }],
+    };
+    const calls = [];
+    const a = new TianyanchaAdapter({
+      account: { cookies: COOKIES, userId: "u1" },
+      fetchFn: async ({ url, cookies, query, sign }) => {
+        const k = byUrl(url);
+        calls.push({ k, cookies, pageNum: query.pageNum, sign });
+        return { data: { list: query.pageNum === 1 ? data[k] : [] } };
+      },
+    });
+    const items = await collect(a.sync({}));
+    expect(items.map((x) => x.kind).sort()).toEqual(["monitor", "search"]);
+    expect(calls.every((c) => c.cookies === COOKIES && c.sign === null)).toBe(true);
+    const mon = a.normalize(items.find((x) => x.kind === "monitor"));
+    expect(mon.events[0].content.title).toBe("关注公司: 腾讯科技");
+    expect(mon.events[0].extra.legalPerson).toBe("马化腾");
+    const search = a.normalize(items.find((x) => x.kind === "search"));
+    expect(search.events[0].content.title).toBe("搜索企业: 阿里巴巴");
+  });
+
+  it("invokes signProvider + limit + empty + default fetch + no input", async () => {
+    const signCalls = [];
+    const a = new TianyanchaAdapter({
+      account: { cookies: COOKIES },
+      fetchFn: async ({ query }) => ({ data: { list: query.pageNum === 1 ? [{ graphId: "G1", companyName: "a" }, { graphId: "G2", companyName: "b" }] : [] } }),
+      signProvider: async (ctx) => { signCalls.push(ctx); return "sig"; },
+    });
+    expect(await collect(a.sync({ limit: 1, include: { search: false } }))).toHaveLength(1);
+    expect(signCalls.length).toBeGreaterThan(0);
+    expect(signCalls[0].cookies).toBe(COOKIES);
+
+    const a2 = new TianyanchaAdapter({ account: { cookies: COOKIES }, fetchFn: async () => "<html>login</html>" });
+    expect(await collect(a2.sync({}))).toEqual([]);
+
+    const a3 = new TianyanchaAdapter({ account: { cookies: COOKIES } });
+    await expect(collect(a3.sync({}))).rejects.toThrow(/no fetchFn configured/);
+
+    const a4 = new TianyanchaAdapter();
+    await expect(collect(a4.sync({}))).rejects.toThrow(/needs opts.inputPath/);
+  });
+});

package/__tests__/adapters/doc-camscanner.test.js

@@ -0,0 +1,147 @@
+"use strict";
+
+import { describe, it, expect } from "vitest";
+const fs = require("node:fs");
+const path = require("node:path");
+const os = require("node:os");
+const crypto = require("node:crypto");
+
+const cs = require("../../lib/adapters/doc-camscanner");
+
+function writeTmp(content) {
+  const p = path.join(os.tmpdir(), `cc-cs-${crypto.randomUUID()}.json`);
+  fs.writeFileSync(p, content, "utf-8");
+  return p;
+}
+async function collect(gen) {
+  const out = [];
+  for await (const x of gen) out.push(x);
+  return out;
+}
+
+const COOKIES = "INTSIG_TOKEN=abc; PHPSESSID=xyz";
+
+describe("doc-camscanner mappers", () => {
+  it("name/version", () => {
+    expect(cs.NAME).toBe("doc-camscanner");
+    expect(cs.VERSION).toBe("0.1.0");
+  });
+  it("mapDoc maps CamScanner fields; doc_type + extension → docType", () => {
+    const rec = cs.mapDoc({
+      sync_doc_id: "DOC123",
+      title: "营业执照",
+      doc_type: 2,
+      page_num: 3,
+      create_time: 1716383000,
+      modify_time: 1716390000,
+      pdf_url: "https://cs/DOC123.pdf",
+      tags: ["证件"],
+    });
+    expect(rec).toMatchObject({ docId: "DOC123", title: "营业执照", docType: "certificate" });
+    expect(rec.createdMs).toBe(1716383000000);
+    expect(rec.updatedMs).toBe(1716390000000);
+    expect(rec.url).toBe("https://cs/DOC123.pdf");
+    expect(rec.extra.pageNum).toBe(3);
+    expect(rec.extra.tags).toEqual(["证件"]);
+    // extension fallback when no doc_type
+    expect(cs.mapDoc({ doc_id: 1, title: "报表.xlsx" }).docType).toBe("excel");
+    expect(cs.mapDoc({ doc_id: 2, title: "合同.pdf" }).docType).toBe("pdf");
+    // default → scan
+    expect(cs.mapDoc({ doc_id: 3, title: "随手拍" }).docType).toBe("scan");
+    // no id → null
+    expect(cs.mapDoc({ title: "noid" })).toBe(null);
+  });
+  it("extractDocs tolerant across shapes", () => {
+    expect(cs.extractDocs({ docs: [{ doc_id: 1 }] })).toHaveLength(1);
+    expect(cs.extractDocs({ list: [{ doc_id: 1 }] })).toHaveLength(1);
+    expect(cs.extractDocs({ data: { docs: [{ doc_id: 1 }] } })).toHaveLength(1);
+    expect(cs.extractDocs({})).toEqual([]);
+  });
+});
+
+describe("CamScannerDocAdapter (via _document-base)", () => {
+  const SNAP = JSON.stringify({
+    schemaVersion: 1,
+    snapshottedAt: 1716383000000,
+    account: { userId: "u1" },
+    events: [
+      {
+        kind: "document",
+        id: "doc-S1",
+        docId: "S1",
+        title: "身份证扫描",
+        docType: "certificate",
+        updatedTime: 1716383000,
+        url: "https://cs/S1.pdf",
+      },
+    ],
+  });
+
+  it("snapshot sync + normalize → event(post)+item(document)", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new cs.CamScannerDocAdapter();
+      expect((await a.authenticate({ inputPath: p })).mode).toBe("snapshot-file");
+      const items = await collect(a.sync({ inputPath: p }));
+      expect(items).toHaveLength(1);
+      const batch = a.normalize(items[0]);
+      expect(batch.events[0].subtype).toBe("post");
+      expect(batch.items[0].subtype).toBe("document");
+      expect(batch.items[0].name).toBe("身份证扫描");
+      expect(batch.items[0].extra.platform).toBe("camscanner");
+    } finally {
+      fs.unlinkSync(p);
+    }
+  });
+
+  it("cookie-api: fetch + paginate + normalize", async () => {
+    const pages = [
+      { docs: [{ sync_doc_id: 7, title: "发票.pdf", doc_type: "pdf", modify_time: 1716383000 }] },
+      { docs: [] },
+    ];
+    const calls = [];
+    const a = new cs.CamScannerDocAdapter({
+      account: { cookies: COOKIES, userId: "u1" },
+      fetchFn: async ({ url, cookies, query, sign }) => {
+        calls.push({ url, cookies, offset: query.offset, sign });
+        return query.offset === 0 ? pages[0] : pages[1];
+      },
+    });
+    expect(await a.authenticate()).toEqual({ ok: true, account: "u1", mode: "cookie" });
+    const items = await collect(a.sync({}));
+    expect(items).toHaveLength(1);
+    expect(items[0].originalId).toBe("camscanner:document:7");
+    expect(calls[0].cookies).toBe(COOKIES);
+    expect(calls[0].sign).toBe(null);
+    const batch = a.normalize(items[0]);
+    expect(batch.items[0].name).toBe("发票.pdf");
+    expect(batch.items[0].extra.docType).toBe("pdf");
+  });
+
+  it("cookie-api: signProvider seam invoked when present", async () => {
+    let seen = null;
+    const a = new cs.CamScannerDocAdapter({
+      account: { cookies: COOKIES, userId: "u1" },
+      signProvider: async ({ url, query }) => {
+        seen = { url, offset: query.offset };
+        return "sig-abc";
+      },
+      fetchFn: async ({ sign, query }) => {
+        return query.offset === 0
+          ? { docs: [{ sync_doc_id: "X", title: "t", _sign: sign }] }
+          : { docs: [] };
+      },
+    });
+    const items = await collect(a.sync({}));
+    expect(items).toHaveLength(1);
+    expect(seen.offset).toBe(0);
+    expect(seen.url).toContain("intsig");
+  });
+
+  it("default fetch throws; no input throws", async () => {
+    const a = new cs.CamScannerDocAdapter({ account: { cookies: COOKIES } });
+    await expect(collect(a.sync({}))).rejects.toThrow(/no fetchFn configured/);
+    const b = new cs.CamScannerDocAdapter();
+    await expect(collect(b.sync({}))).rejects.toThrow(/needs opts.inputPath/);
+  });
+});

package/__tests__/adapters/gov-ixiamen.test.js

@@ -0,0 +1,150 @@
+"use strict";
+
+import { describe, it, expect } from "vitest";
+const fs = require("node:fs");
+const path = require("node:path");
+const os = require("node:os");
+const crypto = require("node:crypto");
+
+const ix = require("../../lib/adapters/gov-ixiamen");
+
+function writeTmp(content) {
+  const p = path.join(os.tmpdir(), `cc-ix-${crypto.randomUUID()}.json`);
+  fs.writeFileSync(p, content, "utf-8");
+  return p;
+}
+async function collect(gen) {
+  const out = [];
+  for await (const x of gen) out.push(x);
+  return out;
+}
+
+const COOKIES = "XMGOV_SSO=abc; tgc=xyz";
+
+describe("gov-ixiamen mappers", () => {
+  it("name/version/capabilities", () => {
+    expect(ix.NAME).toBe("gov-ixiamen");
+    expect(ix.VERSION).toBe("0.1.0");
+  });
+  it("inferCategory: explicit wins, else keyword, else fallback", () => {
+    expect(ix.inferCategory("随便", "医保")).toBe("医保");
+    expect(ix.inferCategory("城乡居民医保缴费")).toBe("医保");
+    expect(ix.inferCategory("住房公积金提取")).toBe("公积金");
+    expect(ix.inferCategory("机动车违章处理")).toBe("车驾管");
+    expect(ix.inferCategory("某个没见过的事项")).toBe("其他政务");
+  });
+  it("mapService maps gov-service fields; no id → null", () => {
+    const rec = ix.mapService({
+      service_id: "S1",
+      service_name: "养老保险待遇资格认证",
+      handle_time: 1716383000,
+      status: "已办结",
+      deptName: "厦门市社保中心",
+    });
+    expect(rec).toMatchObject({ serviceId: "S1", category: "社保", status: "已办结", dept: "厦门市社保中心" });
+    expect(rec.handledMs).toBe(1716383000000);
+    expect(ix.mapService({ service_name: "noid" })).toBe(null);
+  });
+  it("extractList tolerant", () => {
+    expect(ix.extractList({ list: [{ id: 1 }] })).toHaveLength(1);
+    expect(ix.extractList({ data: { records: [{ id: 1 }] } })).toHaveLength(1);
+    expect(ix.extractList({})).toEqual([]);
+  });
+});
+
+describe("IXiamenAdapter (snapshot + cookie-api)", () => {
+  const SNAP = JSON.stringify({
+    schemaVersion: 1,
+    snapshottedAt: 1716383000000,
+    account: { userId: "u1", name: "张三" },
+    events: [
+      {
+        kind: "service",
+        id: "svc-S1",
+        serviceId: "S1",
+        serviceName: "住房公积金缴存明细查询",
+        handledTime: 1716383000,
+        status: "已办结",
+        dept: "厦门住房公积金中心",
+      },
+    ],
+  });
+
+  it("snapshot sync + normalize → INTERACTION event + category topic", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new ix.IXiamenAdapter();
+      expect((await a.authenticate({ inputPath: p })).mode).toBe("snapshot-file");
+      const items = await collect(a.sync({ inputPath: p }));
+      expect(items).toHaveLength(1);
+      expect(items[0].originalId).toBe("ixiamen:service:S1");
+      const batch = a.normalize(items[0]);
+      expect(batch.events[0].subtype).toBe("interaction");
+      expect(batch.events[0].content.title).toBe("办理: 住房公积金缴存明细查询");
+      expect(batch.events[0].extra.category).toBe("公积金");
+      expect(batch.topics[0].name).toBe("公积金");
+      expect(batch.topics[0].id).toBe("topic-ixiamen-cat-公积金");
+      expect(batch.events[0].extra.topicRef).toBe("topic-ixiamen-cat-公积金");
+    } finally {
+      fs.unlinkSync(p);
+    }
+  });
+
+  it("dataDisclosure: high sensitivity + legalGate (gov real-name)", () => {
+    const a = new ix.IXiamenAdapter();
+    expect(a.dataDisclosure.sensitivity).toBe("high");
+    expect(a.dataDisclosure.legalGate).toBe(true);
+  });
+
+  it("cookie-api: best-effort fetch + paginate + unverified flag", async () => {
+    const pages = [
+      { list: [{ id: 7, name: "门诊报销", category: "医保", handledTime: 1716383000 }] },
+      { list: [] },
+    ];
+    const calls = [];
+    const a = new ix.IXiamenAdapter({
+      account: { cookies: COOKIES, userId: "u1" },
+      fetchFn: async ({ url, cookies, query, sign }) => {
+        calls.push({ url, cookies, page: query.page, sign });
+        return query.page === 1 ? pages[0] : pages[1];
+      },
+    });
+    const auth = await a.authenticate();
+    expect(auth).toMatchObject({ ok: true, mode: "cookie", unverified: true });
+    const items = await collect(a.sync({}));
+    expect(items).toHaveLength(1);
+    expect(items[0].originalId).toBe("ixiamen:service:7");
+    expect(calls[0].cookies).toBe(COOKIES);
+    expect(calls[0].sign).toBe(null);
+    const batch = a.normalize(items[0]);
+    expect(batch.events[0].extra.category).toBe("医保");
+  });
+
+  it("cookie-api: signProvider seam invoked + sinceWatermark stops early", async () => {
+    let seen = null;
+    const a = new ix.IXiamenAdapter({
+      account: { cookies: COOKIES },
+      signProvider: async ({ url, query }) => {
+        seen = { url, page: query.page };
+        return "gov-sig";
+      },
+      fetchFn: async () => ({
+        list: [
+          { id: "new", name: "新事项", handledTime: 1716390000 },
+          { id: "old", name: "旧事项", handledTime: 1700000000 },
+        ],
+      }),
+    });
+    const items = await collect(a.sync({ sinceWatermark: 1716000000000 }));
+    expect(items).toHaveLength(1); // old one below watermark stops iteration
+    expect(items[0].originalId).toBe("ixiamen:service:new");
+    expect(seen.url).toContain("ixm.gov.cn");
+  });
+
+  it("default fetch throws; no input throws", async () => {
+    const a = new ix.IXiamenAdapter({ account: { cookies: COOKIES } });
+    await expect(collect(a.sync({}))).rejects.toThrow(/no fetchFn configured/);
+    const b = new ix.IXiamenAdapter();
+    await expect(collect(b.sync({}))).rejects.toThrow(/needs opts.inputPath/);
+  });
+});

package/__tests__/adapters/gov-tax.test.js

@@ -0,0 +1,135 @@
+"use strict";
+
+import { describe, it, expect } from "vitest";
+const fs = require("node:fs");
+const path = require("node:path");
+const os = require("node:os");
+const crypto = require("node:crypto");
+
+const tx = require("../../lib/adapters/gov-tax");
+
+function writeTmp(content) {
+  const p = path.join(os.tmpdir(), `cc-tax-${crypto.randomUUID()}.json`);
+  fs.writeFileSync(p, content, "utf-8");
+  return p;
+}
+async function collect(gen) {
+  const out = [];
+  for await (const x of gen) out.push(x);
+  return out;
+}
+
+const COOKIES = "ETAX_SSO=abc; sid=xyz";
+
+describe("gov-tax mappers", () => {
+  it("name/version", () => {
+    expect(tx.NAME).toBe("gov-tax");
+    expect(tx.VERSION).toBe("0.1.0");
+  });
+  it("periodToMs / toAmount", () => {
+    expect(tx.periodToMs("2025-03")).toBe(Date.parse("2025-03-01T00:00:00Z"));
+    expect(tx.periodToMs("202503")).toBe(Date.parse("2025-03-01T00:00:00Z"));
+    expect(tx.toAmount("¥1,234.56")).toBeCloseTo(1234.56, 2);
+    expect(tx.toAmount(2000)).toBe(2000);
+    expect(tx.toAmount("abc")).toBe(null);
+  });
+  it("mapIncome / mapDeclaration field aliases; no id → null", () => {
+    const inc = tx.mapIncome({ record_id: "I1", tax_period: "2025-03", income_type: "工资薪金", amount: "20,000", withheldTax: 1234.56, company: "某某公司", companyId: "9144" });
+    expect(inc).toMatchObject({ recordId: "I1", incomeType: "工资薪金", payerName: "某某公司", payerId: "9144" });
+    expect(inc.amount).toBe(20000);
+    expect(inc.withheld).toBeCloseTo(1234.56, 2);
+    expect(tx.mapIncome({ amount: 1 })).toBe(null);
+    const dec = tx.mapDeclaration({ id: "D1", tax_year: 2024, type: "综合所得年度汇算", status: "已退税", amount: -800 });
+    expect(dec).toMatchObject({ recordId: "D1", year: 2024, declType: "综合所得年度汇算", status: "已退税", settleAmount: -800 });
+    expect(tx.mapDeclaration({ year: 2024 })).toBe(null);
+  });
+  it("extractList tolerant", () => {
+    expect(tx.extractList({ list: [{ id: 1 }] })).toHaveLength(1);
+    expect(tx.extractList({ data: { records: [{ id: 1 }] } })).toHaveLength(1);
+    expect(tx.extractList({})).toEqual([]);
+  });
+});
+
+describe("TaxAdapter (snapshot + cookie-api)", () => {
+  const SNAP = JSON.stringify({
+    schemaVersion: 1,
+    snapshottedAt: 1716383000000,
+    account: { userId: "u1" },
+    events: [
+      { kind: "income", id: "inc-I1", recordId: "I1", period: "2025-03", incomeType: "工资薪金", amount: 20000, withheld: 1234.56, payerName: "某某科技有限公司", payerId: "9144ABC" },
+      { kind: "declaration", id: "dec-D1", recordId: "D1", year: 2024, declType: "综合所得年度汇算", status: "已退税", settleAmount: -800, declaredAt: 1716383000 },
+    ],
+  });
+
+  it("income → INCOME event + employer Person(MERCHANT)", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new tx.TaxAdapter();
+      expect((await a.authenticate({ inputPath: p })).mode).toBe("snapshot-file");
+      const items = await collect(a.sync({ inputPath: p }));
+      expect(items).toHaveLength(2);
+      const inc = a.normalize(items[0]);
+      expect(inc.events[0].subtype).toBe("income");
+      expect(inc.events[0].extra.incomeType).toBe("工资薪金");
+      expect(inc.events[0].extra.amount).toBe(20000);
+      expect(inc.persons).toHaveLength(1);
+      expect(inc.persons[0].subtype).toBe("merchant");
+      expect(inc.persons[0].names[0]).toBe("某某科技有限公司");
+      expect(inc.events[0].extra.payerRef).toBe(inc.persons[0].id);
+      expect(items[0].originalId).toBe("tax:income:I1");
+    } finally {
+      fs.unlinkSync(p);
+    }
+  });
+
+  it("declaration → OTHER event with settleAmount", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new tx.TaxAdapter();
+      const items = await collect(a.sync({ inputPath: p }));
+      const dec = a.normalize(items[1]);
+      expect(dec.events[0].subtype).toBe("other");
+      expect(dec.events[0].content.title).toContain("个税申报");
+      expect(dec.events[0].extra.settleAmount).toBe(-800);
+      expect(dec.events[0].extra.year).toBe(2024);
+      expect(items[1].originalId).toBe("tax:declaration:D1");
+    } finally {
+      fs.unlinkSync(p);
+    }
+  });
+
+  it("dataDisclosure: high sensitivity + legalGate (financial/tax)", () => {
+    const a = new tx.TaxAdapter();
+    expect(a.dataDisclosure.sensitivity).toBe("high");
+    expect(a.dataDisclosure.legalGate).toBe(true);
+  });
+
+  it("cookie-api: best-effort both kinds + unverified flag + sign seam", async () => {
+    let signed = 0;
+    const a = new tx.TaxAdapter({
+      account: { cookies: COOKIES, userId: "u1" },
+      signProvider: async () => {
+        signed += 1;
+        return "sig";
+      },
+      fetchFn: async ({ url, query }) => {
+        if (query.page > 1) return { list: [] };
+        if (url.includes("/income")) return { list: [{ recordId: "I9", period: "2025-01", incomeType: "劳务报酬", amount: 5000 }] };
+        return { list: [{ recordId: "D9", year: 2024, declType: "年度汇算", settleAmount: 300 }] };
+      },
+    });
+    const auth = await a.authenticate();
+    expect(auth).toMatchObject({ ok: true, mode: "cookie", unverified: true });
+    const items = await collect(a.sync({}));
+    expect(items).toHaveLength(2);
+    expect(items.map((i) => i.originalId).sort()).toEqual(["tax:declaration:D9", "tax:income:I9"]);
+    expect(signed).toBeGreaterThan(0);
+  });
+
+  it("default fetch throws; no input throws", async () => {
+    const a = new tx.TaxAdapter({ account: { cookies: COOKIES } });
+    await expect(collect(a.sync({}))).rejects.toThrow(/no fetchFn configured/);
+    const b = new tx.TaxAdapter();
+    await expect(collect(b.sync({}))).rejects.toThrow(/needs opts.inputPath/);
+  });
+});