@chainlesschain/personal-data-hub 0.4.7 → 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-baidu-netdisk.test.js

@@ -0,0 +1,102 @@
+"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 nd = require("../../lib/adapters/doc-baidu-netdisk");
+
+function writeTmp(content) {
+  const p = path.join(os.tmpdir(), `cc-nd-${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 = "BDUSS=abc; STOKEN=xyz";
+
+describe("doc-baidu-netdisk mappers", () => {
+  it("name/version", () => {
+    expect(nd.NAME).toBe("doc-baidu-netdisk");
+    expect(nd.VERSION).toBe("0.1.0");
+  });
+  it("mapDoc maps netdisk fields; category + isdir → docType", () => {
+    const rec = nd.mapDoc({ fs_id: 123, server_filename: "电影.mp4", category: 1, size: 999, server_mtime: 1716383000, path: "/影视/电影.mp4" });
+    expect(rec).toMatchObject({ docId: "123", title: "电影.mp4", docType: "video" });
+    expect(rec.updatedMs).toBe(1716383000000);
+    expect(rec.extra.path).toBe("/影视/电影.mp4");
+    expect(nd.mapDoc({ fs_id: 1, isdir: 1, server_filename: "我的资料" }).docType).toBe("folder");
+    expect(nd.mapDoc({ fs_id: 2, server_filename: "报告.pdf" }).docType).toBe("doc"); // extension fallback
+    expect(nd.mapDoc({ server_filename: "noid" })).toBe(null);
+  });
+  it("extractDocs tolerant", () => {
+    expect(nd.extractDocs({ list: [{ fs_id: 1 }] })).toHaveLength(1);
+    expect(nd.extractDocs({ data: { list: [{ fs_id: 1 }] } })).toHaveLength(1);
+    expect(nd.extractDocs({})).toEqual([]);
+  });
+});
+
+describe("BaiduNetdiskAdapter (via _document-base)", () => {
+  const SNAP = JSON.stringify({
+    schemaVersion: 1,
+    snapshottedAt: 1716383000000,
+    account: { userId: "u1" },
+    events: [
+      { kind: "document", id: "doc-F1", docId: "F1", title: "合同.pdf", docType: "doc", updatedTime: 1716383000, url: "/工作/合同.pdf" },
+    ],
+  });
+
+  it("snapshot sync + normalize → event(post)+item(document)", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new nd.BaiduNetdiskAdapter();
+      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("合同.pdf");
+      expect(batch.items[0].extra.platform).toBe("baidu-netdisk");
+    } finally {
+      fs.unlinkSync(p);
+    }
+  });
+
+  it("cookie-api: fetch + paginate + normalize", async () => {
+    const pages = [
+      { list: [{ fs_id: 7, server_filename: "照片.jpg", category: 3, server_mtime: 1716383000 }] },
+      { list: [] },
+    ];
+    const calls = [];
+    const a = new nd.BaiduNetdiskAdapter({
+      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("baidu-netdisk: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("照片.jpg");
+    expect(batch.items[0].extra.docType).toBe("image");
+  });
+
+  it("default fetch throws; no input throws", async () => {
+    const a = new nd.BaiduNetdiskAdapter({ account: { cookies: COOKIES } });
+    await expect(collect(a.sync({}))).rejects.toThrow(/no fetchFn configured/);
+    const b = new nd.BaiduNetdiskAdapter();
+    await expect(collect(b.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/doc-platforms.test.js

@@ -0,0 +1,177 @@
+"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 wps = require("../../lib/adapters/doc-wps");
+const tdocs = require("../../lib/adapters/doc-tencent-docs");
+
+function writeTmp(content) {
+  const p = path.join(os.tmpdir(), `cc-doc-${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 = "wps_sid=abc; uid=1";
+
+describe("doc-wps constants + mappers", () => {
+  it("exposes name/version", () => {
+    expect(wps.NAME).toBe("doc-wps");
+    expect(wps.VERSION).toBe("0.1.0");
+  });
+  it("mapDoc maps WPS fields + infers docType from extension", () => {
+    const rec = wps.mapDoc({ id: "F1", fname: "预算.xlsx", ctime: 1716300000, mtime: 1716383000 });
+    expect(rec).toMatchObject({ docId: "F1", title: "预算.xlsx", docType: "sheet" });
+    expect(rec.createdMs).toBe(1716300000000);
+    expect(rec.updatedMs).toBe(1716383000000);
+    expect(rec.url).toContain("kdocs.cn");
+    expect(wps.mapDoc({ id: "F2", fname: "方案.pptx" }).docType).toBe("slide");
+    expect(wps.mapDoc({ id: "F3", fname: "说明.docx" }).docType).toBe("doc");
+    expect(wps.mapDoc({ fname: "noid" })).toBe(null);
+  });
+  it("extractDocs tolerant of shapes", () => {
+    expect(wps.extractDocs({ files: [{ id: 1 }] })).toHaveLength(1);
+    expect(wps.extractDocs({ data: { files: [{ id: 1 }] } })).toHaveLength(1);
+    expect(wps.extractDocs({})).toEqual([]);
+  });
+});
+
+describe("doc-tencent-docs constants + mappers", () => {
+  it("exposes name/version", () => {
+    expect(tdocs.NAME).toBe("doc-tencent-docs");
+    expect(tdocs.VERSION).toBe("0.1.0");
+  });
+  it("mapDoc maps Tencent fields + type codes", () => {
+    const rec = tdocs.mapDoc({ id: "T1", title: "周报", type: "sheet", createTime: 1716300000, lastModifyTime: 1716383000 });
+    expect(rec).toMatchObject({ docId: "T1", title: "周报", docType: "sheet" });
+    expect(rec.url).toContain("docs.qq.com");
+    expect(tdocs.mapDoc({ id: "T2", type: 2 }).docType).toBe("sheet");
+    expect(tdocs.mapDoc({ id: "T3", type: "presentation" }).docType).toBe("slide");
+    expect(tdocs.mapDoc({ title: "noid" })).toBe(null);
+  });
+});
+
+describe("WpsDocAdapter snapshot mode", () => {
+  const SNAP = JSON.stringify({
+    schemaVersion: 1,
+    snapshottedAt: 1716383000000,
+    account: { userId: "u1" },
+    events: [
+      { kind: "document", id: "doc-D1", docId: "D1", title: "我的文档", docType: "doc", createdTime: 1716300000, updatedTime: 1716383000, url: "https://kdocs.cn/p/D1" },
+    ],
+  });
+
+  it("authenticate validates inputPath", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new wps.WpsDocAdapter();
+      expect((await a.authenticate({ inputPath: p })).mode).toBe("snapshot-file");
+      expect((await a.authenticate({ inputPath: path.join(os.tmpdir(), "nope.json") })).reason).toBe("INPUT_PATH_UNREADABLE");
+    } finally {
+      fs.unlinkSync(p);
+    }
+  });
+
+  it("sync yields doc + normalize → event(post)+item(document)", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new wps.WpsDocAdapter();
+      const items = await collect(a.sync({ inputPath: p }));
+      expect(items).toHaveLength(1);
+      expect(items[0].originalId).toBe("wps:document:doc-D1");
+      const batch = a.normalize(items[0]);
+      expect(batch.events[0].subtype).toBe("post");
+      expect(batch.events[0].content.title).toBe("文档: 我的文档");
+      expect(batch.items[0].subtype).toBe("document");
+      expect(batch.items[0].name).toBe("我的文档");
+      expect(batch.items[0].extra.platform).toBe("wps");
+      // event references the item
+      expect(batch.events[0].extra.itemRef).toBe(batch.items[0].id);
+    } finally {
+      fs.unlinkSync(p);
+    }
+  });
+
+  it("schemaVersion mismatch throws; normalize missing record throws", async () => {
+    const p = writeTmp(JSON.stringify({ schemaVersion: 9, events: [] }));
+    try {
+      const a = new wps.WpsDocAdapter();
+      await expect(collect(a.sync({ inputPath: p }))).rejects.toThrow(/schemaVersion mismatch/);
+      expect(() => a.normalize({ payload: {} })).toThrow(/payload.record missing/);
+    } finally {
+      fs.unlinkSync(p);
+    }
+  });
+});
+
+describe("TencentDocsAdapter cookie-api mode", () => {
+  it("authenticate cookie mode (userId optional)", async () => {
+    const a = new tdocs.TencentDocsAdapter({ account: { cookies: COOKIES } });
+    expect(await a.authenticate()).toEqual({ ok: true, account: null, mode: "cookie" });
+  });
+
+  it("sync fetches, paginates, normalizes", async () => {
+    const pages = [
+      { data: { files: [{ id: "T1", title: "项目计划", type: "doc", lastModifyTime: 1716383000 }] } },
+      { data: { files: [] } },
+    ];
+    const calls = [];
+    const fetchFn = async ({ url, cookies, query, sign }) => {
+      calls.push({ url, cookies, offset: query.offset, sign });
+      return query.offset === 0 ? pages[0] : pages[1];
+    };
+    const a = new tdocs.TencentDocsAdapter({ account: { cookies: COOKIES, userId: "u1" }, fetchFn });
+    const items = await collect(a.sync({}));
+    expect(items).toHaveLength(1);
+    expect(items[0].originalId).toBe("tencent-docs:document:T1");
+    expect(calls[0].cookies).toBe(COOKIES);
+    expect(calls[0].sign).toBe(null);
+    const batch = a.normalize(items[0]);
+    expect(batch.items[0].name).toBe("项目计划");
+    expect(batch.items[0].extra.platform).toBe("tencent-docs");
+  });
+
+  it("invokes signProvider when configured", async () => {
+    const signCalls = [];
+    const a = new tdocs.TencentDocsAdapter({
+      account: { cookies: COOKIES },
+      fetchFn: async ({ query }) => (query.offset === 0 ? { files: [{ id: "S1", title: "x" }] } : { files: [] }),
+      signProvider: async (ctx) => { signCalls.push(ctx); return "SIG"; },
+    });
+    const items = await collect(a.sync({}));
+    expect(items).toHaveLength(1);
+    expect(signCalls.length).toBeGreaterThan(0);
+    expect(signCalls[0].cookies).toBe(COOKIES);
+  });
+
+  it("sinceWatermark + limit + empty response", async () => {
+    const a1 = new tdocs.TencentDocsAdapter({
+      account: { cookies: COOKIES },
+      fetchFn: async ({ query }) => query.offset === 0 ? { files: [
+        { id: "NEW", title: "n", lastModifyTime: 2_000_000_000 },
+        { id: "OLD", title: "o", lastModifyTime: 1_000_000_000 },
+      ] } : { files: [] },
+    });
+    const got = await collect(a1.sync({ sinceWatermark: 1_500_000_000_000 }));
+    expect(got.map((x) => x.originalId)).toEqual(["tencent-docs:document:NEW"]);
+
+    const a2 = new tdocs.TencentDocsAdapter({ account: { cookies: COOKIES }, fetchFn: async () => "<html>login</html>" });
+    expect(await collect(a2.sync({}))).toEqual([]);
+  });
+
+  it("default fetch throws; no input throws", async () => {
+    const a = new tdocs.TencentDocsAdapter({ account: { cookies: COOKIES } });
+    await expect(collect(a.sync({}))).rejects.toThrow(/no fetchFn configured/);
+    const b = new tdocs.TencentDocsAdapter();
+    await expect(collect(b.sync({}))).rejects.toThrow(/needs opts.inputPath/);
+  });
+});