@chainlesschain/personal-data-hub 0.4.29 → 0.4.31

package/__tests__/adapters/browser-history-edge.test.js

@@ -1,159 +0,0 @@
-"use strict";
-
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { mkdtempSync, rmSync, mkdirSync } from "node:fs";
-import { join } from "node:path";
-import { tmpdir } from "node:os";
-import Database from "better-sqlite3";
-
-const {
-  BrowserHistoryEdgeAdapter,
-  BROWSER_HISTORY_EDGE_NAME,
-  BROWSER_HISTORY_EDGE_VERSION,
-} = require("../../lib/adapters/browser-history-edge");
-const { assertAdapter } = require("../../lib/adapter-spec");
-const {
-  EVENT_SUBTYPES,
-  ITEM_SUBTYPES,
-} = require("../../lib/constants");
-const {
-  epochMsToWebkitUs,
-  defaultEdgeProfileDir,
-} = require("../../lib/adapters/browser-history-chrome/chrome-db-reader");
-
-let tmpDir;
-let profileDir;
-let historyPath;
-
-function buildHistoryFixture() {
-  mkdirSync(profileDir, { recursive: true });
-  const db = new Database(historyPath);
-  db.exec(`
-    CREATE TABLE urls(
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      url LONGVARCHAR, title LONGVARCHAR,
-      visit_count INTEGER DEFAULT 0 NOT NULL,
-      typed_count INTEGER DEFAULT 0 NOT NULL,
-      last_visit_time INTEGER NOT NULL,
-      hidden INTEGER DEFAULT 0 NOT NULL
-    );
-    CREATE TABLE visits(
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      url INTEGER NOT NULL,
-      visit_time INTEGER NOT NULL,
-      from_visit INTEGER,
-      transition INTEGER DEFAULT 0 NOT NULL,
-      visit_duration INTEGER DEFAULT 0 NOT NULL
-    );
-  `);
-  const t = epochMsToWebkitUs(1_700_000_001_000).toString();
-  db.prepare(
-    "INSERT INTO urls(url, title, last_visit_time) VALUES('https://bing.com', 'Bing', ?)",
-  ).run(t);
-  db.prepare(
-    "INSERT INTO visits(url, visit_time, transition) VALUES(1, ?, 1)",
-  ).run(t);
-  db.close();
-}
-
-beforeEach(() => {
-  tmpDir = mkdtempSync(join(tmpdir(), "edge-adapter-test-"));
-  profileDir = join(tmpDir, "Default");
-  historyPath = join(profileDir, "History");
-});
-
-afterEach(() => {
-  rmSync(tmpDir, { recursive: true, force: true });
-});
-
-describe("BrowserHistoryEdgeAdapter — contract + defaults", () => {
-  it("conforms to PersonalDataAdapter contract", () => {
-    const adapter = new BrowserHistoryEdgeAdapter();
-    expect(assertAdapter(adapter)).toEqual({ ok: true });
-  });
-
-  it("identifies as browser-history-edge with edge-prefixed capabilities", () => {
-    const adapter = new BrowserHistoryEdgeAdapter();
-    expect(adapter.name).toBe(BROWSER_HISTORY_EDGE_NAME);
-    expect(adapter.name).toBe("browser-history-edge");
-    expect(adapter.version).toBe(BROWSER_HISTORY_EDGE_VERSION);
-    expect(adapter.capabilities).toContain("sync:edge-history-sqlite");
-    expect(adapter.capabilities).toContain("sync:edge-bookmarks-json");
-  });
-
-  it("defaultEdgeProfileDir resolves to platform-correct Edge path", () => {
-    const dir = defaultEdgeProfileDir();
-    expect(typeof dir === "string" || dir === null).toBe(true);
-    if (process.platform === "win32" && process.env.LOCALAPPDATA) {
-      expect(dir).toBe(
-        join(process.env.LOCALAPPDATA, "Microsoft", "Edge", "User Data", "Default"),
-      );
-    }
-  });
-});
-
-describe("BrowserHistoryEdgeAdapter — sync + normalize use edge prefix", () => {
-  it("yields visits with edge-visit: originalId prefix", async () => {
-    buildHistoryFixture();
-    const adapter = new BrowserHistoryEdgeAdapter({ profilePath: profileDir });
-    const raws = [];
-    for await (const r of adapter.sync()) raws.push(r);
-    expect(raws).toHaveLength(1);
-    expect(raws[0].kind).toBe("visit");
-    expect(raws[0].originalId).toMatch(/^edge-visit:/);
-  });
-
-  it("normalize emits browser='edge' in extra + event id prefixed edge", () => {
-    const adapter = new BrowserHistoryEdgeAdapter();
-    const { events } = adapter.normalize({
-      kind: "visit",
-      capturedAt: 1_700_000_000_000,
-      payload: {
-        visitId: 42,
-        url: "https://bing.com",
-        title: "Bing",
-        visitTimeMs: 1_700_000_000_000,
-        visitDurationMs: 0,
-        transition: "link",
-        rawTransition: 0,
-        profileDir: "/p/Default",
-      },
-    });
-    expect(events).toHaveLength(1);
-    expect(events[0].extra.browser).toBe("edge");
-    expect(events[0].id).toBe("event-edge-visit-42");
-    expect(events[0].subtype).toBe(EVENT_SUBTYPES.BROWSE);
-    expect(events[0].source.originalId).toBe("edge-visit:/p/Default:42");
-    expect(events[0].source.adapter).toBe("browser-history-edge");
-  });
-
-  it("normalize bookmark emits browser='edge'", () => {
-    const adapter = new BrowserHistoryEdgeAdapter();
-    const { items } = adapter.normalize({
-      kind: "bookmark",
-      capturedAt: 1_700_000_000_000,
-      payload: {
-        guid: "g1",
-        name: "Bing",
-        url: "https://bing.com",
-        dateAddedMs: 1_600_000_000_000,
-        folderPath: "书签栏",
-        profileDir: "/p/Default",
-      },
-    });
-    expect(items).toHaveLength(1);
-    expect(items[0].extra.browser).toBe("edge");
-    expect(items[0].id).toBe("item-edge-bookmark-g1");
-    expect(items[0].subtype).toBe(ITEM_SUBTYPES.LINK);
-    expect(items[0].source.originalId).toBe("edge-bookmark:/p/Default:g1");
-  });
-
-  it("PROFILE_NOT_FOUND error message mentions edge, not chrome", async () => {
-    const adapter = new BrowserHistoryEdgeAdapter({ profilePath: profileDir });
-    const r = await adapter.authenticate({});
-    expect(r.ok).toBe(false);
-    expect(r.reason).toBe("PROFILE_NOT_FOUND");
-    expect(r.message).toContain("edge");
-    expect(r.message).not.toContain("Chrome");
-  });
-});

package/__tests__/adapters/car-mercedesme.test.js

@@ -1,74 +0,0 @@
-"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 mb = require("../../lib/adapters/car-mercedesme");
-
-function writeTmp(content) {
-  const p = path.join(os.tmpdir(), `cc-mb-${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 = "mb_token=abc";
-
-describe("car-mercedesme", () => {
-  it("name + tripToRecord (km direct + meters fallback; no id → null)", () => {
-    expect(mb.NAME).toBe("car-mercedesme");
-    const r = mb.tripToRecord({ tripId: "T1", startTime: 1716383000, endTime: 1716385000, startAddress: "家", endAddress: "公司", distanceKm: 12.4, plate: "京A12345" });
-    expect(r).toMatchObject({ vendorId: "mercedesme", recordId: "T1", vehicleType: "car", carrier: "Mercedes me", vehicleNumber: "京A12345" });
-    expect(r.from.name).toBe("家");
-    expect(r.to.name).toBe("公司");
-    expect(r.extras.distanceKm).toBeCloseTo(12.4, 2);
-    // meters fallback
-    expect(mb.tripToRecord({ tripId: "T2", distanceMeters: 5230 }).extras.distanceKm).toBeCloseTo(5.23, 2);
-    expect(mb.tripToRecord({ startAddress: "x" })).toBe(null);
-  });
-  it("extractTrips tolerant", () => {
-    expect(mb.extractTrips({ trips: [{ tripId: 1 }] })).toHaveLength(1);
-    expect(mb.extractTrips({ data: { list: [{ tripId: 1 }] } })).toHaveLength(1);
-    expect(mb.extractTrips({})).toEqual([]);
-  });
-
-  it("snapshot trip → car travel event", async () => {
-    const SNAP = JSON.stringify({ trips: [{ tripId: "T1", startTime: 1716383000, endTime: 1716385000, startAddress: "家", endAddress: "公司", distanceKm: 12.4 }] });
-    const p = writeTmp(SNAP);
-    try {
-      const a = new mb.MercedesMeAdapter();
-      const items = await collect(a.sync({ inputPath: p }));
-      expect(items).toHaveLength(1);
-      expect(items[0].originalId).toBe("T1");
-      const b = a.normalize(items[0]);
-      expect(b.events[0].source.adapter).toBe("car-mercedesme");
-    } finally {
-      fs.unlinkSync(p);
-    }
-  });
-
-  it("cookie-api: unverified + sign seam", async () => {
-    let signed = 0;
-    const a = new mb.MercedesMeAdapter({
-      account: { cookies: COOKIES, userId: "u1" },
-      signProvider: async () => { signed += 1; return "sig"; },
-      fetchFn: async ({ query }) => (query.page > 1 ? { trips: [] } : { trips: [{ tripId: "T9", startTime: 1716383000, distanceMeters: 8000 }] }),
-    });
-    expect(await a.authenticate()).toMatchObject({ ok: true, mode: "cookie", unverified: true });
-    const items = await collect(a.sync({}));
-    expect(items).toHaveLength(1);
-    expect(items[0].originalId).toBe("T9");
-    expect(signed).toBeGreaterThan(0);
-  });
-
-  it("medium sensitivity; default fetch throws", async () => {
-    expect(new mb.MercedesMeAdapter().dataDisclosure.sensitivity).toBe("medium");
-    await expect(collect(new mb.MercedesMeAdapter({ account: { cookies: COOKIES } }).sync({}))).rejects.toThrow(/no fetchFn/);
-  });
-});

package/__tests__/adapters/doc-baidu-netdisk.test.js

@@ -1,102 +0,0 @@
-"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

@@ -1,147 +0,0 @@
-"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

@@ -1,177 +0,0 @@
-"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/);
-  });
-});