@chainlesschain/personal-data-hub 0.4.29 → 0.4.30

package/__tests__/adapters/edu-huawei-learning-live.test.js

@@ -1,198 +0,0 @@
-/**
- * FAMILY-23 v0.2 — edu-huawei-learning LIVE web fetcher tests.
- * cookie (华为账号会话) → user-info + study-records → snapshot-shaped events +
- * adapter live sync + defensive field extraction + error mapping.
- * All network via injected fetch. Endpoint shapes are best-effort (see
- * api-client header) — these tests pin the REQUEST CONSTRUCTION + PARSING
- * contract, not the live server, which can't be verified here.
- */
-"use strict";
-
-import { describe, it, expect } from "vitest";
-
-const { HuaweiLearningAdapter } = require("../../lib");
-const {
-  HuaweiLearningApiClient,
-} = require("../../lib/adapters/edu-huawei-learning/api-client");
-const { validateBatch } = require("../../lib/batch");
-
-const COOKIE = "accountId=555; CASTGC=tok-xyz";
-
-function makeFetch(routes, calls) {
-  return async (url, init) => {
-    calls.push({ url, headers: (init && init.headers) || {} });
-    const route = routes.find((r) => url.includes(r.match));
-    if (!route) return { ok: false, status: 404, text: async () => "not mapped" };
-    return {
-      ok: route.status ? route.status >= 200 && route.status < 300 : true,
-      status: route.status || 200,
-      text: async () =>
-        typeof route.body === "string" ? route.body : JSON.stringify(route.body),
-    };
-  };
-}
-
-async function collect(iter) {
-  const out = [];
-  for await (const r of iter) out.push(r);
-  return out;
-}
-
-describe("HuaweiLearningApiClient session probe", () => {
-  it("hasSession is lenient: any k=v cookie passes, empty/garbage fails", () => {
-    const c = new HuaweiLearningApiClient();
-    expect(c.hasSession("CASTGC=tok")).toBe(true);
-    expect(c.hasSession(COOKIE)).toBe(true);
-    expect(c.hasSession("")).toBe(false);
-    expect(c.lastError.code).toBe(-7);
-    expect(c.hasSession("garbage")).toBe(false);
-  });
-});
-
-describe("HuaweiLearningApiClient.fetchSnapshot — live (mocked fetch)", () => {
-  it("carries cookie on each GET + parses user/records defensively", async () => {
-    const calls = [];
-    const fetch = makeFetch(
-      [
-        {
-          match: "/edu/api/user/v1/info",
-          body: { code: 0, data: { user: { accountId: 555, nickName: "小华" } } },
-        },
-        {
-          match: "/edu/api/study/v1/records",
-          body: {
-            code: 0,
-            data: {
-              records: [
-                { recordId: "c1", courseName: "物理", studyDuration: 1500, startTime: 1700000000 },
-                { id: "c2", title: "化学", duration: 600000, createTime: "1700003600" },
-              ],
-            },
-          },
-        },
-      ],
-      calls,
-    );
-    const client = new HuaweiLearningApiClient({ fetch });
-    const result = await client.fetchSnapshot(COOKIE);
-    expect(result.account).toEqual({ uid: "555", displayName: "小华" });
-    const profile = result.events.find((e) => e.kind === "profile");
-    expect(profile).toMatchObject({ uid: "555", nickname: "小华" });
-    const studies = result.events.filter((e) => e.kind === "study");
-    expect(studies).toHaveLength(2);
-    expect(studies[0]).toMatchObject({ id: "study-c1", course: "物理", durationMs: 1500000, startAt: 1700000000000 });
-    expect(studies[1]).toMatchObject({ id: "study-c2", course: "化学", durationMs: 600000, startAt: 1700003600000 });
-    for (const c of calls) {
-      expect(c.headers.Cookie).toBe(COOKIE);
-    }
-  });
-
-  it("handles alternate envelope (resultCode + result + list)", async () => {
-    const fetch = makeFetch(
-      [
-        { match: "/edu/api/user/v1/info", body: { resultCode: 0, result: { userId: "999", displayName: "阿福" } } },
-        { match: "/edu/api/study/v1/records", body: { resultCode: 0, result: { list: [{ logId: "z1", name: "数学", learnTime: 300 }] } } },
-      ],
-      [],
-    );
-    const client = new HuaweiLearningApiClient({ fetch });
-    const result = await client.fetchSnapshot(COOKIE);
-    expect(result.account).toEqual({ uid: "999", displayName: "阿福" });
-    const study = result.events.find((e) => e.kind === "study");
-    expect(study).toMatchObject({ id: "study-z1", course: "数学", durationMs: 300000 });
-  });
-
-  it("include.study:false skips records; limit/offset land in the query", async () => {
-    const calls = [];
-    const fetch = makeFetch(
-      [
-        { match: "/edu/api/user/v1/info", body: { code: 0, data: { accountId: 1, nickName: "x" } } },
-        { match: "/edu/api/study/v1/records", body: { code: 0, data: { records: [] } } },
-      ],
-      calls,
-    );
-    const client = new HuaweiLearningApiClient({ fetch });
-    await client.fetchSnapshot(COOKIE, { include: { study: false } });
-    expect(calls.some((c) => c.url.includes("/study/v1/records"))).toBe(false);
-
-    await client.fetchSnapshot(COOKIE, { limit: 7, offset: 3 });
-    const rec = calls.find((c) => c.url.includes("/study/v1/records"));
-    expect(rec.url).toContain("offset=3");
-    expect(rec.url).toContain("limit=7");
-  });
-
-  it("maps non-zero code to null + lastError", async () => {
-    const fetch = makeFetch(
-      [{ match: "/edu/api/user/v1/info", body: { code: 401, message: "会话过期" } }],
-      [],
-    );
-    const client = new HuaweiLearningApiClient({ fetch });
-    expect(await client.fetchSnapshot(COOKIE)).toBeNull();
-    expect(client.lastError.code).toBe(401);
-    expect(client.lastError.message).toContain("会话过期");
-  });
-
-  it("no session cookie → null + lastError -7 (no network)", async () => {
-    const calls = [];
-    const client = new HuaweiLearningApiClient({ fetch: makeFetch([], calls) });
-    expect(await client.fetchSnapshot("")).toBeNull();
-    expect(client.lastError.code).toBe(-7);
-    expect(calls).toHaveLength(0);
-  });
-
-  it("HTTP non-2xx → null + lastError with status", async () => {
-    const fetch = makeFetch([{ match: "/edu/api/user/v1/info", status: 500, body: "err" }], []);
-    const client = new HuaweiLearningApiClient({ fetch });
-    expect(await client.fetchSnapshot(COOKIE)).toBeNull();
-    expect(client.lastError.code).toBe(500);
-  });
-});
-
-describe("HuaweiLearningAdapter — cookie (live) sync mode", () => {
-  it("authenticate accepts a session cookie; rejects empty", async () => {
-    const a = new HuaweiLearningAdapter();
-    expect((await a.authenticate({ cookie: COOKIE })).mode).toBe("cookie");
-    const bad = await a.authenticate({ cookie: "garbage" });
-    expect(bad.ok).toBe(false);
-    expect(bad.reason).toBe("INVALID_COOKIE");
-  });
-
-  it("version/capabilities reflect v0.2 live mode", () => {
-    const a = new HuaweiLearningAdapter();
-    expect(a.version).toBe("0.2.0");
-    expect(a.capabilities).toContain("sync:cookie");
-  });
-
-  it("sync via cookie yields profile+study raws → valid normalized batch", async () => {
-    const fetch = makeFetch(
-      [
-        { match: "/edu/api/user/v1/info", body: { code: 0, data: { accountId: 555, nickName: "小华" } } },
-        { match: "/edu/api/study/v1/records", body: { code: 0, data: { records: [{ recordId: "c1", courseName: "物理", studyDuration: 1500, startTime: 1700000000 }] } } },
-      ],
-      [],
-    );
-    const a = new HuaweiLearningAdapter();
-    const raws = await collect(a.sync({ cookie: COOKIE, fetch }));
-    expect(raws.map((r) => r.kind).sort()).toEqual(["profile", "study"]);
-    const profileRaw = raws.find((r) => r.kind === "profile");
-    expect(profileRaw.originalId).toBe("huaweilearning:profile:profile-555");
-
-    for (const raw of raws) {
-      expect(validateBatch(a.normalize(raw)).valid).toBe(true);
-    }
-    const profileBatch = a.normalize(profileRaw);
-    expect(profileBatch.persons[0].identifiers["huawei-learning-uid"]).toEqual(["555"]);
-    const studyBatch = a.normalize(raws.find((r) => r.kind === "study"));
-    expect(studyBatch.events[0].extra.course).toBe("物理");
-    expect(studyBatch.events[0].extra.durationMs).toBe(1500000);
-  });
-
-  it("sync via cookie throws (mapped lastError) on API error", async () => {
-    const fetch = makeFetch(
-      [{ match: "/edu/api/user/v1/info", body: { code: 401, message: "会话过期" } }],
-      [],
-    );
-    const a = new HuaweiLearningAdapter();
-    await expect(collect(a.sync({ cookie: COOKIE, fetch }))).rejects.toThrow(/会话过期|code 401/);
-  });
-});

package/__tests__/adapters/edu-zuoyebang-live.test.js

@@ -1,226 +0,0 @@
-/**
- * FAMILY-23 v0.2 — edu-zuoyebang LIVE web fetcher tests.
- * cookie (ZYBUSS 会话) → user-info + study-records → snapshot-shaped events +
- * adapter live sync + defensive field extraction + error mapping.
- * All network via injected fetch. Endpoint shapes are best-effort (see
- * api-client header) — these tests pin the REQUEST CONSTRUCTION + PARSING
- * contract, not the live server, which can't be verified here.
- */
-"use strict";
-
-import { describe, it, expect } from "vitest";
-
-const { ZuoyebangAdapter } = require("../../lib");
-const {
-  ZuoyebangApiClient,
-} = require("../../lib/adapters/edu-zuoyebang/api-client");
-const {
-  pick,
-  toDurationMs,
-  toEpochMs,
-} = require("../../lib/adapters/_live-json-helpers");
-const { validateBatch } = require("../../lib/batch");
-
-const COOKIE = "ZYBUSS=opaquetoken123; other=1";
-
-function makeFetch(routes, calls) {
-  return async (url, init) => {
-    calls.push({ url, headers: (init && init.headers) || {} });
-    const route = routes.find((r) => url.includes(r.match));
-    if (!route) return { ok: false, status: 404, text: async () => "not mapped" };
-    return {
-      ok: route.status ? route.status >= 200 && route.status < 300 : true,
-      status: route.status || 200,
-      text: async () =>
-        typeof route.body === "string" ? route.body : JSON.stringify(route.body),
-    };
-  };
-}
-
-async function collect(iter) {
-  const out = [];
-  for await (const r of iter) out.push(r);
-  return out;
-}
-
-describe("_live-json-helpers (shared field-extraction)", () => {
-  it("pick returns first present non-empty value", () => {
-    expect(pick({ a: "", b: "x" }, ["a", "b"])).toBe("x");
-    expect(pick({ a: 0 }, ["a"])).toBe(0); // 0 is present
-    expect(pick({}, ["a"], "fb")).toBe("fb");
-    expect(pick(null, ["a"], "fb")).toBe("fb");
-  });
-
-  it("toDurationMs disambiguates seconds vs ms; coerces numeric strings", () => {
-    expect(toDurationMs(1800)).toBe(1800000);
-    expect(toDurationMs(1800000)).toBe(1800000);
-    expect(toDurationMs("900")).toBe(900000);
-    expect(toDurationMs("nope")).toBe(0);
-  });
-
-  it("toEpochMs coerces seconds/ms/date-string", () => {
-    expect(toEpochMs(1700000000)).toBe(1700000000000);
-    expect(toEpochMs("1700000000000")).toBe(1700000000000);
-    expect(toEpochMs("2023-11-14T22:13:20Z")).toBe(1700000000000);
-    expect(toEpochMs("bogus")).toBeNull();
-  });
-});
-
-describe("ZuoyebangApiClient session probe", () => {
-  it("hasSession accepts ZYBUSS-only cookie (uid comes from the API)", () => {
-    const c = new ZuoyebangApiClient();
-    expect(c.hasSession("ZYBUSS=opaque")).toBe(true);
-    expect(c.hasSession("uid=111")).toBe(true);
-    expect(c.hasSession("foo=bar")).toBe(false);
-    expect(c.lastError.code).toBe(-7);
-    expect(c.hasSession("")).toBe(false);
-  });
-});
-
-describe("ZuoyebangApiClient.fetchSnapshot — live (mocked fetch)", () => {
-  it("carries cookie on each GET + parses user/records defensively", async () => {
-    const calls = [];
-    const fetch = makeFetch(
-      [
-        {
-          match: "/session/pc/getuserinfo",
-          body: { errNo: 0, data: { user: { uid: 12345, uname: "小红", gradeName: "初二" } } },
-        },
-        {
-          match: "/study/pc/record/list",
-          body: {
-            errNo: 0,
-            data: {
-              list: [
-                { recordId: "r1", subjectName: "数学", studyTime: 1200, startTime: 1700000000 },
-                { logId: "r2", subject: "英语", duration: 900000, createTime: "1700003600" },
-              ],
-            },
-          },
-        },
-      ],
-      calls,
-    );
-    const client = new ZuoyebangApiClient({ fetch });
-    const result = await client.fetchSnapshot(COOKIE);
-    expect(result.account).toEqual({ uid: "12345", displayName: "小红" });
-    const profile = result.events.find((e) => e.kind === "profile");
-    expect(profile).toMatchObject({ uid: "12345", nickname: "小红", grade: "初二" });
-    const studies = result.events.filter((e) => e.kind === "study");
-    expect(studies).toHaveLength(2);
-    expect(studies[0]).toMatchObject({ id: "study-r1", subject: "数学", durationMs: 1200000, startAt: 1700000000000 });
-    expect(studies[1]).toMatchObject({ id: "study-r2", subject: "英语", durationMs: 900000, startAt: 1700003600000 });
-    for (const c of calls) {
-      expect(c.headers.Cookie).toBe(COOKIE);
-    }
-  });
-
-  it("handles flat user body + alternate envelope key (errno)", async () => {
-    const calls = [];
-    const fetch = makeFetch(
-      [
-        { match: "/session/pc/getuserinfo", body: { errno: 0, data: { userId: "888", nickName: "阿明" } } },
-        { match: "/study/pc/record/list", body: { errno: 0, data: { records: [] } } },
-      ],
-      calls,
-    );
-    const client = new ZuoyebangApiClient({ fetch });
-    const result = await client.fetchSnapshot(COOKIE);
-    expect(result.account).toEqual({ uid: "888", displayName: "阿明" });
-  });
-
-  it("include.study:false skips the records call; limit/offset map to rn/pn", async () => {
-    const calls = [];
-    const fetch = makeFetch(
-      [
-        { match: "/session/pc/getuserinfo", body: { errNo: 0, data: { uid: 1, uname: "x" } } },
-        { match: "/study/pc/record/list", body: { errNo: 0, data: { list: [] } } },
-      ],
-      calls,
-    );
-    const client = new ZuoyebangApiClient({ fetch });
-    await client.fetchSnapshot(COOKIE, { include: { study: false } });
-    expect(calls.some((c) => c.url.includes("record/list"))).toBe(false);
-
-    await client.fetchSnapshot(COOKIE, { limit: 5, offset: 2 });
-    const rec = calls.find((c) => c.url.includes("record/list"));
-    expect(rec.url).toContain("pn=2");
-    expect(rec.url).toContain("rn=5");
-  });
-
-  it("maps non-zero errNo to null + lastError (e.g. session expired)", async () => {
-    const fetch = makeFetch(
-      [{ match: "/session/pc/getuserinfo", body: { errNo: 3, errstr: "未登录" } }],
-      [],
-    );
-    const client = new ZuoyebangApiClient({ fetch });
-    expect(await client.fetchSnapshot(COOKIE)).toBeNull();
-    expect(client.lastError.code).toBe(3);
-    expect(client.lastError.message).toContain("未登录");
-  });
-
-  it("no session cookie → null + lastError -7 (no network)", async () => {
-    const calls = [];
-    const client = new ZuoyebangApiClient({ fetch: makeFetch([], calls) });
-    expect(await client.fetchSnapshot("foo=bar")).toBeNull();
-    expect(client.lastError.code).toBe(-7);
-    expect(calls).toHaveLength(0);
-  });
-
-  it("HTTP non-2xx → null + lastError with status", async () => {
-    const fetch = makeFetch([{ match: "/session/pc/getuserinfo", status: 503, body: "down" }], []);
-    const client = new ZuoyebangApiClient({ fetch });
-    expect(await client.fetchSnapshot(COOKIE)).toBeNull();
-    expect(client.lastError.code).toBe(503);
-  });
-});
-
-describe("ZuoyebangAdapter — cookie (live) sync mode", () => {
-  it("authenticate accepts ZYBUSS cookie; rejects sessionless", async () => {
-    const a = new ZuoyebangAdapter();
-    expect((await a.authenticate({ cookie: COOKIE })).mode).toBe("cookie");
-    const bad = await a.authenticate({ cookie: "foo=bar" });
-    expect(bad.ok).toBe(false);
-    expect(bad.reason).toBe("INVALID_COOKIE");
-  });
-
-  it("version/capabilities reflect v0.2 live mode", () => {
-    const a = new ZuoyebangAdapter();
-    expect(a.version).toBe("0.2.0");
-    expect(a.capabilities).toContain("sync:cookie");
-  });
-
-  it("sync via cookie yields profile+study raws → valid normalized batch", async () => {
-    const fetch = makeFetch(
-      [
-        { match: "/session/pc/getuserinfo", body: { errNo: 0, data: { user: { uid: 12345, uname: "小红", gradeName: "初二" } } } },
-        { match: "/study/pc/record/list", body: { errNo: 0, data: { list: [{ recordId: "r1", subjectName: "数学", studyTime: 1200, startTime: 1700000000 }] } } },
-      ],
-      [],
-    );
-    const a = new ZuoyebangAdapter();
-    const raws = await collect(a.sync({ cookie: COOKIE, fetch }));
-    expect(raws.map((r) => r.kind).sort()).toEqual(["profile", "study"]);
-    const profileRaw = raws.find((r) => r.kind === "profile");
-    expect(profileRaw.originalId).toBe("zuoyebang:profile:profile-12345");
-
-    for (const raw of raws) {
-      expect(validateBatch(a.normalize(raw)).valid).toBe(true);
-    }
-    const profileBatch = a.normalize(profileRaw);
-    expect(profileBatch.persons[0].identifiers["zuoyebang-uid"]).toEqual(["12345"]);
-    expect(profileBatch.persons[0].extra.grade).toBe("初二");
-    const studyBatch = a.normalize(raws.find((r) => r.kind === "study"));
-    expect(studyBatch.events[0].extra.subject).toBe("数学");
-    expect(studyBatch.events[0].extra.durationMs).toBe(1200000);
-  });
-
-  it("sync via cookie throws (mapped lastError) on API error", async () => {
-    const fetch = makeFetch(
-      [{ match: "/session/pc/getuserinfo", body: { errNo: 3, errstr: "未登录" } }],
-      [],
-    );
-    const a = new ZuoyebangAdapter();
-    await expect(collect(a.sync({ cookie: COOKIE, fetch }))).rejects.toThrow(/未登录|code 3/);
-  });
-});

package/__tests__/adapters/email-adapter-snapshot.test.js

@@ -1,237 +0,0 @@
-"use strict";
-
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-
-const fs = require("node:fs");
-const os = require("node:os");
-const path = require("node:path");
-
-const {
-  EmailAdapter,
-} = require("../../lib/adapters/email-imap/email-adapter");
-const { assertAdapter } = require("../../lib/adapter-spec");
-
-/**
- * Phase 5.8 — snapshot mode for Android EmailLocalCollector ingestion.
- *
- * EmailLocalCollector.kt (android-app) does the IMAP fetch on-device with
- * Jakarta Mail, then writes filesDir/staging/email-<vendor>-<ts>.json with
- * shape `{vendor, user, fetchedAt, records: [{messageNumber, subject, from,
- * to, sentDateMs, bodyPreview, hasAttachments}]}`. The desktop EmailAdapter
- * must consume that JSON via syncAdapter("email-imap", path) — without it
- * the UI shows "v0.2 补齐 (邮件已成功抓 X 封到本机临时区)" misleading hint
- * because the local fetch worked but cc couldn't ingest it.
- *
- * snapshotMode opt:
- *  - Relaxes opts.account.email + authCode constructor validation
- *  - Switches authenticate(ctx.inputPath) to file-readability check
- *  - Switches sync(opts.inputPath) to read JSON + emit raw events
- *  - Classifier + extractor still fire (text-only, no PDF since attachment
- *    buffers never crossed Android → desktop boundary)
- */
-describe("EmailAdapter snapshot mode", () => {
-  let tmpDir;
-  beforeEach(() => {
-    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "email-snap-"));
-  });
-  afterEach(() => {
-    try { fs.rmSync(tmpDir, { recursive: true, force: true }); } catch (_e) {}
-  });
-
-  it("snapshotMode constructor accepts no opts.account", () => {
-    const a = new EmailAdapter({ snapshotMode: true });
-    expect(a.name).toBe("email-imap");
-    expect(a.capabilities).toContain("sync:snapshot");
-    expect(a.capabilities).not.toContain("sync:imap");
-    expect(a.capabilities).not.toContain("auth:authcode");
-    // Classifier + extractor capabilities preserved (snapshot still classifies)
-    expect(a.capabilities).toContain("classify:layer1-rules");
-    expect(a.capabilities).toContain("extract:6-templates");
-  });
-
-  it("snapshotMode adapter passes contract assertion", () => {
-    const a = new EmailAdapter({ snapshotMode: true });
-    const r = assertAdapter(a);
-    if (!r.ok) console.log("assertAdapter errors:", r.errors);
-    expect(r.ok).toBe(true);
-  });
-
-  it("authenticate(ctx.inputPath) returns ok when file readable", async () => {
-    const inputPath = path.join(tmpDir, "snap.json");
-    fs.writeFileSync(inputPath, "{}", "utf-8");
-    const a = new EmailAdapter({ snapshotMode: true });
-    const auth = await a.authenticate({ inputPath });
-    expect(auth.ok).toBe(true);
-    expect(auth.mode).toBe("snapshot-file");
-  });
-
-  it("authenticate without inputPath in snapshotMode returns NO_INPUT", async () => {
-    const a = new EmailAdapter({ snapshotMode: true });
-    const auth = await a.authenticate({});
-    expect(auth.ok).toBe(false);
-    expect(auth.reason).toBe("NO_INPUT");
-  });
-
-  it("authenticate with unreadable inputPath returns INPUT_PATH_UNREADABLE", async () => {
-    const a = new EmailAdapter({ snapshotMode: true });
-    const auth = await a.authenticate({ inputPath: path.join(tmpDir, "nope.json") });
-    expect(auth.ok).toBe(false);
-    expect(auth.reason).toBe("INPUT_PATH_UNREADABLE");
-  });
-
-  it("sync(inputPath) yields one raw event per record", async () => {
-    const inputPath = path.join(tmpDir, "snap.json");
-    fs.writeFileSync(inputPath, JSON.stringify({
-      vendor: "qq",
-      user: "user@qq.com",
-      fetchedAt: 1_700_000_000_000,
-      records: [
-        {
-          messageNumber: 1,
-          subject: "Test subject 1",
-          from: "Alice <alice@x.com>",
-          to: "user@qq.com",
-          sentDateMs: 1_700_000_100_000,
-          bodyPreview: "hello world",
-          hasAttachments: false,
-        },
-        {
-          messageNumber: 2,
-          subject: "Order confirmation",
-          from: "noreply@shop.com",
-          to: "user@qq.com",
-          sentDateMs: 1_700_000_200_000,
-          bodyPreview: "your order ABC123 has shipped",
-          hasAttachments: true,
-        },
-      ],
-    }), "utf-8");
-
-    const a = new EmailAdapter({ snapshotMode: true });
-    const raws = [];
-    for await (const r of a.sync({ inputPath })) raws.push(r);
-    expect(raws).toHaveLength(2);
-
-    expect(raws[0].adapter).toBe("email-imap");
-    expect(raws[0].originalId).toBe("android-snapshot:qq:user@qq.com:1");
-    expect(raws[0].capturedAt).toBe(1_700_000_100_000);
-    expect(raws[0].payload.subject).toBe("Test subject 1");
-    expect(raws[0].payload.from[0].address).toBe("alice@x.com");
-    expect(raws[0].payload.from[0].name).toBe("Alice");
-    expect(raws[0].payload.to[0].address).toBe("user@qq.com");
-    expect(raws[0].payload.folder).toBe("INBOX");
-    // Classification fires even on envelope-only data
-    expect(raws[0].payload.classification).toBeDefined();
-    expect(raws[0].payload.classification.category).toBeDefined();
-
-    expect(raws[1].originalId).toBe("android-snapshot:qq:user@qq.com:2");
-    expect(raws[1].payload.from[0].address).toBe("noreply@shop.com");
-    // hasAttachments=true → parsedBody.attachments has placeholder entry
-    expect(raws[1].payload.parsedBody.attachments).toHaveLength(1);
-  });
-
-  it("sync(inputPath) on empty records emits nothing", async () => {
-    const inputPath = path.join(tmpDir, "empty.json");
-    fs.writeFileSync(inputPath, JSON.stringify({
-      vendor: "163",
-      user: "u@163.com",
-      fetchedAt: Date.now(),
-      records: [],
-    }), "utf-8");
-
-    const a = new EmailAdapter({ snapshotMode: true });
-    const raws = [];
-    for await (const r of a.sync({ inputPath })) raws.push(r);
-    expect(raws).toHaveLength(0);
-  });
-
-  it("sync(inputPath) on malformed JSON throws clear error", async () => {
-    const inputPath = path.join(tmpDir, "bad.json");
-    fs.writeFileSync(inputPath, "{not json", "utf-8");
-
-    const a = new EmailAdapter({ snapshotMode: true });
-    let threw = null;
-    try {
-      for await (const _r of a.sync({ inputPath })) { /* drain */ }
-    } catch (err) {
-      threw = err;
-    }
-    expect(threw).toBeTruthy();
-    expect(threw.message).toMatch(/bad JSON/);
-  });
-
-  it("sync(inputPath) without records[] throws shape error", async () => {
-    const inputPath = path.join(tmpDir, "noshape.json");
-    fs.writeFileSync(inputPath, JSON.stringify({ vendor: "qq" }), "utf-8");
-
-    const a = new EmailAdapter({ snapshotMode: true });
-    let threw = null;
-    try {
-      for await (const _r of a.sync({ inputPath })) { /* drain */ }
-    } catch (err) {
-      threw = err;
-    }
-    expect(threw).toBeTruthy();
-    expect(threw.message).toMatch(/records/);
-  });
-
-  it("sync(opts.limit) respected on snapshot record iteration", async () => {
-    const inputPath = path.join(tmpDir, "many.json");
-    const records = [];
-    for (let i = 1; i <= 10; i += 1) {
-      records.push({
-        messageNumber: i,
-        subject: `msg ${i}`,
-        from: `s${i}@x.com`,
-        to: "u@q.com",
-        sentDateMs: 1_700_000_000_000 + i * 1000,
-        bodyPreview: `body ${i}`,
-        hasAttachments: false,
-      });
-    }
-    fs.writeFileSync(inputPath, JSON.stringify({
-      vendor: "qq",
-      user: "u@q.com",
-      fetchedAt: Date.now(),
-      records,
-    }), "utf-8");
-
-    const a = new EmailAdapter({ snapshotMode: true });
-    const raws = [];
-    for await (const r of a.sync({ inputPath, limit: 3 })) raws.push(r);
-    expect(raws).toHaveLength(3);
-  });
-
-  it("sync(inputPath) handles records with no sentDateMs (falls back to fetchedAt)", async () => {
-    const inputPath = path.join(tmpDir, "nodate.json");
-    fs.writeFileSync(inputPath, JSON.stringify({
-      vendor: "qq",
-      user: "u@q.com",
-      fetchedAt: 1_700_500_000_000,
-      records: [
-        {
-          messageNumber: 1,
-          subject: "no date",
-          from: "x@x.com",
-          to: "u@q.com",
-          // sentDateMs intentionally omitted
-          bodyPreview: "",
-          hasAttachments: false,
-        },
-      ],
-    }), "utf-8");
-
-    const a = new EmailAdapter({ snapshotMode: true });
-    const raws = [];
-    for await (const r of a.sync({ inputPath })) raws.push(r);
-    expect(raws).toHaveLength(1);
-    expect(raws[0].capturedAt).toBe(1_700_500_000_000);
-  });
-
-  it("non-snapshot mode still requires opts.account (preserves Phase 5.1 invariant)", () => {
-    expect(() => new EmailAdapter({})).toThrow(/account/);
-    expect(() => new EmailAdapter({ account: { email: "u@x.com" } })).toThrow(/authCode/);
-    // But snapshot mode bypasses both:
-    expect(() => new EmailAdapter({ snapshotMode: true })).not.toThrow();
-  });
-});