@chainlesschain/personal-data-hub 0.4.7 → 0.4.18

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-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/);
+  });
+});

package/__tests__/adapters/music-kugou.test.js

@@ -0,0 +1,187 @@
+"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 {
+  KugouMusicAdapter,
+  extractList,
+  songItemToRecord,
+  playlistItemToRecord,
+  NAME,
+  VERSION,
+  SNAPSHOT_SCHEMA_VERSION,
+} = require("../../lib/adapters/music-kugou");
+
+function writeTmp(content) {
+  const p = path.join(os.tmpdir(), `cc-kg-${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 = "KuGoo=abc; kg_mid=xyz";
+
+const SNAP = JSON.stringify({
+  schemaVersion: 1,
+  snapshottedAt: 1716383000000,
+  account: { userId: "u1" },
+  events: [
+    { kind: "play", id: "p1", songId: "S1", song: "晴天", artist: "周杰伦", album: "叶惠美", playCount: 12, capturedAt: 1716300000000 },
+    { kind: "favorite", id: "f1", songId: "S2", song: "稻香", artist: "周杰伦" },
+    { kind: "playlist", id: "pl1", playlistId: "L1", name: "华语经典", trackCount: 88, creator: "我" },
+  ],
+});
+
+describe("constants + item mappers", () => {
+  it("name/version", () => {
+    expect(NAME).toBe("music-kugou");
+    expect(VERSION).toBe("0.1.0");
+    expect(SNAPSHOT_SCHEMA_VERSION).toBe(1);
+  });
+  it("songItemToRecord: discrete fields + filename split fallback", () => {
+    const r1 = songItemToRecord({ hash: "H1", songname: "夜曲", singername: "周杰伦", album_name: "十一月的萧邦", addtime: 1716300000 });
+    expect(r1).toMatchObject({ id: "H1", song: "夜曲", artist: "周杰伦", album: "十一月的萧邦" });
+    expect(r1.occurredAt).toBe(1716300000000);
+    const r2 = songItemToRecord({ mixsongid: 9, filename: "林俊杰 - 江南" });
+    expect(r2).toMatchObject({ song: "江南", artist: "林俊杰" });
+    expect(songItemToRecord({ songname: "noid" })).toBe(null);
+  });
+  it("playlistItemToRecord", () => {
+    const r = playlistItemToRecord({ listid: "L9", name: "睡前", count: 30, nickname: "我" });
+    expect(r).toMatchObject({ id: "L9", playlistId: "L9", name: "睡前", trackCount: 30, creator: "我" });
+  });
+  it("extractList tolerant", () => {
+    expect(extractList({ list: [{ hash: 1 }] })).toHaveLength(1);
+    expect(extractList({ data: { info: [{ hash: 1 }] } })).toHaveLength(1);
+    expect(extractList({})).toEqual([]);
+  });
+});
+
+describe("KugouMusicAdapter snapshot mode", () => {
+  it("authenticate validates inputPath", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new KugouMusicAdapter();
+      expect((await a.authenticate({ inputPath: p })).mode).toBe("snapshot-file");
+      expect((await a.authenticate({ inputPath: path.join(os.tmpdir(), "no-kg.json") })).reason).toBe("INPUT_PATH_UNREADABLE");
+    } finally {
+      fs.unlinkSync(p);
+    }
+  });
+
+  it("sync 3 kinds + normalize play→media+item / favorite→like / playlist→topic", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new KugouMusicAdapter();
+      const items = await collect(a.sync({ inputPath: p }));
+      expect(items.map((x) => x.kind)).toEqual(["play", "favorite", "playlist"]);
+
+      const play = a.normalize(items[0]);
+      expect(play.events[0].subtype).toBe("media");
+      expect(play.events[0].content.title).toBe("听了: 晴天 - 周杰伦");
+      expect(play.items[0].subtype).toBe("media");
+      expect(play.items[0].extra.platform).toBe("kugou");
+      expect(play.events[0].extra.itemRef).toBe(play.items[0].id);
+
+      const fav = a.normalize(items[1]);
+      expect(fav.events[0].subtype).toBe("like");
+      expect(fav.events[0].content.title).toBe("收藏: 稻香 - 周杰伦");
+
+      const pl = a.normalize(items[2]);
+      expect(pl.topics[0].name).toBe("华语经典");
+      expect(pl.topics[0].extra.trackCount).toBe(88);
+    } finally {
+      fs.unlinkSync(p);
+    }
+  });
+
+  it("include + limit + schema mismatch + unknown kind", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new KugouMusicAdapter();
+      expect((await collect(a.sync({ inputPath: p, include: { play: false, favorite: false } }))).map((x) => x.kind)).toEqual(["playlist"]);
+      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 KugouMusicAdapter();
+      await expect(collect(a.sync({ inputPath: bad }))).rejects.toThrow(/schemaVersion mismatch/);
+    } finally {
+      fs.unlinkSync(bad);
+    }
+  });
+});
+
+describe("KugouMusicAdapter cookie-api mode", () => {
+  it("authenticate cookie mode (userId optional)", async () => {
+    const a = new KugouMusicAdapter({ account: { cookies: COOKIES } });
+    expect(await a.authenticate()).toEqual({ ok: true, account: null, mode: "cookie" });
+  });
+
+  it("sync fetches plays/favorites/playlists, normalizes", async () => {
+    const byUrl = (u) => (u.includes("listen") ? "play" : u.includes("favorite") ? "favorite" : "playlist");
+    const data = {
+      play: [{ hash: "H1", songname: "七里香", singername: "周杰伦", addtime: 1716300000 }],
+      favorite: [{ hash: "H2", filename: "陈奕迅 - 浮夸" }],
+      playlist: [{ listid: "L1", name: "粤语", count: 50 }],
+    };
+    const calls = [];
+    const a = new KugouMusicAdapter({
+      account: { cookies: COOKIES, userId: "u1" },
+      fetchFn: async ({ url, cookies, query, sign }) => {
+        const k = byUrl(url);
+        calls.push({ k, cookies, page: query.page, sign });
+        return { data: { list: query.page === 1 ? data[k] : [] } };
+      },
+    });
+    const items = await collect(a.sync({}));
+    expect(items.map((x) => x.kind).sort()).toEqual(["favorite", "play", "playlist"]);
+    expect(calls.every((c) => c.cookies === COOKIES && c.sign === null)).toBe(true);
+    const play = a.normalize(items.find((x) => x.kind === "play"));
+    expect(play.events[0].content.title).toBe("听了: 七里香 - 周杰伦");
+    const fav = a.normalize(items.find((x) => x.kind === "favorite"));
+    expect(fav.events[0].content.title).toBe("收藏: 浮夸 - 陈奕迅"); // filename split
+    const pl = a.normalize(items.find((x) => x.kind === "playlist"));
+    expect(pl.topics[0].name).toBe("粤语");
+  });
+
+  it("invokes signProvider", async () => {
+    const signCalls = [];
+    const a = new KugouMusicAdapter({
+      account: { cookies: COOKIES },
+      fetchFn: async ({ query }) => ({ list: query.page === 1 ? [{ hash: "H1", songname: "x" }] : [] }),
+      signProvider: async (ctx) => { signCalls.push(ctx); return "sig"; },
+    });
+    const items = await collect(a.sync({ include: { favorite: false, playlist: false } }));
+    expect(items.length).toBeGreaterThan(0);
+    expect(signCalls[0].cookies).toBe(COOKIES);
+  });
+
+  it("limit + empty/login + default fetch + no input", async () => {
+    const a1 = new KugouMusicAdapter({
+      account: { cookies: COOKIES },
+      fetchFn: async ({ query }) => ({ list: query.page === 1 ? [{ hash: "H1", songname: "a" }, { hash: "H2", songname: "b" }] : [] }),
+    });
+    expect(await collect(a1.sync({ limit: 1 }))).toHaveLength(1);
+
+    const a2 = new KugouMusicAdapter({ account: { cookies: COOKIES }, fetchFn: async () => "<html>login</html>" });
+    expect(await collect(a2.sync({}))).toEqual([]);
+
+    const a3 = new KugouMusicAdapter({ account: { cookies: COOKIES } });
+    await expect(collect(a3.sync({}))).rejects.toThrow(/no fetchFn configured/);
+
+    const a4 = new KugouMusicAdapter();
+    await expect(collect(a4.sync({}))).rejects.toThrow(/needs opts.inputPath/);
+  });
+});

package/__tests__/adapters/recruit-boss.test.js

@@ -0,0 +1,180 @@
+"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 {
+  BossZhipinAdapter,
+  extractData,
+  chatItemToRecord,
+  applicationItemToRecord,
+  NAME,
+  VERSION,
+  SNAPSHOT_SCHEMA_VERSION,
+} = require("../../lib/adapters/recruit-boss");
+
+function writeTmp(content) {
+  const p = path.join(os.tmpdir(), `cc-boss-${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 = "wt2=abc; __zp_stoken__=xyz";
+
+const SNAP = JSON.stringify({
+  schemaVersion: 1,
+  snapshottedAt: 1716383000000,
+  account: { userId: "u1", name: "我" },
+  events: [
+    { kind: "chat", id: "chat-J1", jobId: "J1", jobTitle: "前端工程师", company: "字节跳动", hrName: "李 HR", hrId: "HR9", salary: "25-40K", city: "北京", lastChatTime: 1716300000 },
+    { kind: "application", id: "apply-J2", jobId: "J2", jobTitle: "后端工程师", company: "腾讯", status: "已查看", deliverTime: 1716310000 },
+  ],
+});
+
+describe("constants + item mappers", () => {
+  it("name/version/schema", () => {
+    expect(NAME).toBe("recruit-boss");
+    expect(VERSION).toBe("0.1.0");
+    expect(SNAPSHOT_SCHEMA_VERSION).toBe(1);
+  });
+  it("chatItemToRecord maps BOSS chat fields", () => {
+    const r = chatItemToRecord({ jobId: "J1", jobName: "前端", brandName: "字节", bossName: "王HR", bossId: "B1", salaryDesc: "30K", cityName: "深圳", lastChatTime: 1716300000 });
+    expect(r).toMatchObject({ id: "J1", jobTitle: "前端", company: "字节", hrName: "王HR", hrId: "B1", salary: "30K", city: "深圳" });
+    expect(r.occurredAt).toBe(1716300000000);
+    expect(chatItemToRecord({ jobName: "noid" })).toBe(null);
+  });
+  it("applicationItemToRecord maps delivery fields", () => {
+    const r = applicationItemToRecord({ jobId: "J2", jobName: "后端", brandName: "腾讯", statusDesc: "已查看", deliverTime: 1716310000 });
+    expect(r).toMatchObject({ id: "J2", jobTitle: "后端", company: "腾讯", status: "已查看" });
+    expect(r.occurredAt).toBe(1716310000000);
+  });
+  it("extractData tolerant (data/list/zpData.list)", () => {
+    expect(extractData({ data: [{ jobId: 1 }] })).toHaveLength(1);
+    expect(extractData({ zpData: { list: [{ jobId: 1 }] } })).toHaveLength(1);
+    expect(extractData({})).toEqual([]);
+  });
+});
+
+describe("BossZhipinAdapter snapshot mode", () => {
+  it("authenticate validates inputPath", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new BossZhipinAdapter();
+      expect((await a.authenticate({ inputPath: p })).mode).toBe("snapshot-file");
+      expect((await a.authenticate({ inputPath: path.join(os.tmpdir(), "no-boss.json") })).reason).toBe("INPUT_PATH_UNREADABLE");
+    } finally {
+      fs.unlinkSync(p);
+    }
+  });
+
+  it("sync yields chat+application; normalize → interaction event + HR person", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new BossZhipinAdapter();
+      const items = await collect(a.sync({ inputPath: p }));
+      expect(items.map((x) => x.kind)).toEqual(["chat", "application"]);
+
+      const chat = a.normalize(items[0]);
+      expect(chat.events[0].subtype).toBe("interaction");
+      expect(chat.events[0].content.title).toBe("沟通职位: 前端工程师 @ 字节跳动");
+      expect(chat.persons[0].subtype).toBe("contact");
+      expect(chat.persons[0].names).toEqual(["李 HR"]);
+      expect(chat.persons[0].identifiers["boss-hr-id"]).toEqual(["HR9"]);
+      expect(chat.events[0].participants).toContain(chat.persons[0].id);
+
+      const app = a.normalize(items[1]);
+      expect(app.events[0].content.title).toBe("投递简历: 后端工程师 @ 腾讯");
+      expect(app.events[0].extra.status).toBe("已查看");
+      expect(app.persons).toEqual([]);
+    } finally {
+      fs.unlinkSync(p);
+    }
+  });
+
+  it("include filter + limit + schema mismatch + unknown kind", async () => {
+    const p = writeTmp(SNAP);
+    try {
+      const a = new BossZhipinAdapter();
+      expect((await collect(a.sync({ inputPath: p, include: { chat: false } }))).map((x) => x.kind)).toEqual(["application"]);
+      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 BossZhipinAdapter();
+      await expect(collect(a.sync({ inputPath: bad }))).rejects.toThrow(/schemaVersion mismatch/);
+    } finally {
+      fs.unlinkSync(bad);
+    }
+  });
+});
+
+describe("BossZhipinAdapter cookie-api mode", () => {
+  it("authenticate cookie mode (userId optional)", async () => {
+    const a = new BossZhipinAdapter({ account: { cookies: COOKIES } });
+    expect(await a.authenticate()).toEqual({ ok: true, account: null, mode: "cookie" });
+  });
+
+  it("sync fetches chats + deliveries, normalizes", async () => {
+    const byUrl = (url) => (url.includes("contactList") ? "chats" : "deliveries");
+    const data = {
+      chats: [{ jobId: "C1", jobName: "全栈", brandName: "小米", bossName: "赵HR", bossId: "B2", lastChatTime: 1716300000 }],
+      deliveries: [{ jobId: "D1", jobName: "测试", brandName: "美团", statusDesc: "已投递", deliverTime: 1716310000 }],
+    };
+    const calls = [];
+    const fetchFn = async ({ url, cookies, query, sign }) => {
+      const k = byUrl(url);
+      calls.push({ k, cookies, page: query.page, sign });
+      return { zpData: { list: query.page === 1 ? data[k] : [] } };
+    };
+    const a = new BossZhipinAdapter({ account: { cookies: COOKIES }, fetchFn });
+    const items = await collect(a.sync({}));
+    expect(items.map((x) => x.kind).sort()).toEqual(["application", "chat"]);
+    expect(calls.every((c) => c.cookies === COOKIES && c.sign === null)).toBe(true);
+    const chat = a.normalize(items.find((x) => x.kind === "chat"));
+    expect(chat.events[0].content.title).toBe("沟通职位: 全栈 @ 小米");
+    expect(chat.persons[0].names).toEqual(["赵HR"]);
+    const app = a.normalize(items.find((x) => x.kind === "application"));
+    expect(app.events[0].content.title).toBe("投递简历: 测试 @ 美团");
+  });
+
+  it("invokes signProvider when configured", async () => {
+    const signCalls = [];
+    const a = new BossZhipinAdapter({
+      account: { cookies: COOKIES },
+      fetchFn: async ({ query }) => ({ zpData: { list: query.page === 1 ? [{ jobId: "C1", jobName: "x" }] : [] } }),
+      signProvider: async (ctx) => { signCalls.push(ctx); return "__zp_stoken__sig"; },
+    });
+    const items = await collect(a.sync({ include: { application: false } }));
+    expect(items.length).toBeGreaterThan(0);
+    expect(signCalls.length).toBeGreaterThan(0);
+    expect(signCalls[0].cookies).toBe(COOKIES);
+  });
+
+  it("limit + empty/login response + default fetch + no input", async () => {
+    const a1 = new BossZhipinAdapter({
+      account: { cookies: COOKIES },
+      fetchFn: async ({ query }) => ({ data: query.page === 1 ? [{ jobId: "C1", jobName: "a" }, { jobId: "C2", jobName: "b" }] : [] }),
+    });
+    expect(await collect(a1.sync({ limit: 1 }))).toHaveLength(1);
+
+    const a2 = new BossZhipinAdapter({ account: { cookies: COOKIES }, fetchFn: async () => "<html>login</html>" });
+    expect(await collect(a2.sync({}))).toEqual([]);
+
+    const a3 = new BossZhipinAdapter({ account: { cookies: COOKIES } });
+    await expect(collect(a3.sync({}))).rejects.toThrow(/no fetchFn configured/);
+
+    const a4 = new BossZhipinAdapter();
+    await expect(collect(a4.sync({}))).rejects.toThrow(/needs opts.inputPath/);
+  });
+});