@chainlesschain/personal-data-hub 0.4.29 → 0.4.31

package/__tests__/adapters/weread.test.js

@@ -1,123 +0,0 @@
-"use strict";
-
-import { describe, it, expect } from "vitest";
-
-const { WeReadAdapter } = require("../../lib/adapters/weread");
-const { WeReadApiClient } = require("../../lib/adapters/weread/api-client");
-const { partitionBatch } = require("../../lib/batch");
-
-// ── stub fetch returning canned WeRead JSON by URL ──────────────────────
-function makeFetch(routes) {
-  return async (url) => {
-    for (const [pat, body] of routes) {
-      if (url.includes(pat)) {
-        return {
-          ok: true,
-          status: 200,
-          headers: { get: () => null },
-          json: async () => body,
-        };
-      }
-    }
-    return { ok: true, status: 200, headers: { get: () => null }, json: async () => ({}) };
-  };
-}
-
-const ROUTES = [
-  ["/user/notebooks", { books: [{ bookId: "b1", book: { title: "人类简史", author: "赫拉利", cover: "c" }, noteCount: 2, reviewCount: 1 }] }],
-  ["/book/bookmarklist", { updated: [{ bookmarkId: "m1", bookId: "b1", markText: "认知革命", chapterTitle: "第一章", createTime: 1700000000 }] }],
-  ["/review/list", { reviews: [{ review: { reviewId: "r1", bookId: "b1", content: "很有启发", chapterTitle: "第一章", createTime: 1700000100 } }] }],
-];
-
-async function collect(iter) {
-  const out = [];
-  for await (const r of iter) out.push(r);
-  return out;
-}
-
-describe("WeReadApiClient (cookie HTTP, stub fetch)", () => {
-  it("parses notebooks / bookmarks / reviews defensively", async () => {
-    const c = new WeReadApiClient({ cookie: "wr_skey=x", fetch: makeFetch(ROUTES) });
-    const books = await c.getNotebooks();
-    expect(books).toHaveLength(1);
-    expect(books[0].title).toBe("人类简史");
-    const marks = await c.getBookmarks("b1");
-    expect(marks[0].markText).toBe("认知革命");
-    const reviews = await c.getReviews("b1");
-    expect(reviews[0].content).toBe("很有启发");
-  });
-
-  it("requires a cookie", () => {
-    expect(() => new WeReadApiClient({})).toThrow(/cookie/);
-  });
-
-  it("degrades a failing endpoint to empty (no throw)", async () => {
-    const c = new WeReadApiClient({
-      cookie: "x",
-      fetch: async () => { throw new Error("network down"); },
-    });
-    expect(await c.getNotebooks()).toEqual([]);
-    expect(c.lastErrorCode).toBeTruthy();
-  });
-});
-
-describe("WeReadAdapter — cookie mode", () => {
-  it("readinessOnly without cookie → INVALID_COOKIE (credential)", async () => {
-    const r = await new WeReadAdapter().authenticate({ readinessOnly: true });
-    expect(r.reason).toBe("INVALID_COOKIE");
-  });
-
-  it("readinessOnly with cookie → configured", async () => {
-    const r = await new WeReadAdapter({ cookie: "x" }).authenticate({ readinessOnly: true });
-    expect(r.ok).toBe(true);
-    expect(r.mode).toBe("configured");
-  });
-
-  it("fetches book + highlight + review and normalizes to a valid batch", async () => {
-    const a = new WeReadAdapter();
-    const raws = await collect(a.sync({ cookie: "wr_skey=x", fetch: makeFetch(ROUTES) }));
-    expect(raws.map((r) => r.kind)).toEqual(["book", "highlight", "review"]);
-    const merged = { events: [], persons: [], places: [], items: [], topics: [] };
-    for (const r of raws) {
-      const n = a.normalize(r);
-      for (const k of Object.keys(merged)) merged[k].push(...n[k]);
-    }
-    const { valid, invalidReasons } = partitionBatch(merged);
-    expect(invalidReasons).toHaveLength(0);
-    expect(valid.events).toHaveLength(3); // book(browse) + highlight(other) + review(post)
-    expect(valid.items).toHaveLength(1); // the book
-    expect(valid.events.find((e) => e.subtype === "browse").content.title).toContain("人类简史");
-    expect(valid.events.find((e) => e.subtype === "post").content.text).toBe("很有启发");
-  });
-
-  it("includeNotes:false yields only book events", async () => {
-    const a = new WeReadAdapter();
-    const raws = await collect(a.sync({ cookie: "x", fetch: makeFetch(ROUTES), includeNotes: false }));
-    expect(raws.map((r) => r.kind)).toEqual(["book"]);
-  });
-});
-
-describe("WeReadAdapter — snapshot mode", () => {
-  const SNAP = {
-    schemaVersion: 1,
-    snapshottedAt: 1700000000000,
-    events: [
-      { kind: "book", id: "b1", bookId: "b1", title: "三体", author: "刘慈欣" },
-      { kind: "highlight", id: "m1", bookId: "b1", bookTitle: "三体", markText: "不要回答", createTime: 1700000001 },
-    ],
-  };
-  function snapAdapter(snap = SNAP, { exists = true } = {}) {
-    const a = new WeReadAdapter();
-    a._deps.fs = { existsSync: () => exists, readFileSync: () => JSON.stringify(snap), accessSync: () => {}, constants: { R_OK: 4 } };
-    return a;
-  }
-
-  it("ingests snapshot events", async () => {
-    const raws = await collect(snapAdapter().sync({ inputPath: "/x" }));
-    expect(raws.map((r) => r.kind)).toEqual(["book", "highlight"]);
-  });
-
-  it("schemaVersion mismatch throws", async () => {
-    await expect(collect(snapAdapter({ schemaVersion: 9, events: [] }).sync({ inputPath: "/x" }))).rejects.toThrow(/schemaVersion/);
-  });
-});

package/__tests__/adapters/wework-pc.test.js

@@ -1,124 +0,0 @@
-"use strict";
-
-import { describe, it, expect } from "vitest";
-
-const { WeWorkPcAdapter, NAME, VERSION } = require("../../lib/adapters/wework-pc");
-const { partitionBatch } = require("../../lib/batch");
-
-// fake driver answering sqlite_master + table_info + SELECT * by table
-function makeFakeDb(spec) {
-  class FakeStmt {
-    constructor(sql) {
-      this.sql = sql;
-    }
-    all() {
-      const s = this.sql;
-      if (/type='table'/.test(s)) return (spec.tables || []).map((n) => ({ name: n }));
-      const ti = s.match(/table_info\("(\w+)"\)/);
-      if (ti) return spec.cols[ti[1]] || [];
-      const fr = s.match(/FROM "(\w+)"/);
-      if (fr) return spec.rows[fr[1]] || [];
-      return [];
-    }
-    get() {
-      return { n: 1 };
-    }
-  }
-  return class FakeDb {
-    // eslint-disable-next-line no-unused-vars
-    constructor(_p, _o) {}
-    prepare(sql) {
-      return new FakeStmt(sql);
-    }
-    pragma() {}
-    exec() {}
-    close() {}
-  };
-}
-
-// WeChat Work-ish message table: matches pattern + has time/sender/peer/content.
-const SPEC = {
-  tables: ["chat_message", "session_meta", "sqlite_sequence"],
-  cols: {
-    chat_message: [
-      { name: "localId" },
-      { name: "createTime" },
-      { name: "sender" },
-      { name: "conversationId" },
-      { name: "content" },
-    ],
-    session_meta: [{ name: "vid" }, { name: "name" }],
-  },
-  rows: {
-    chat_message: [
-      { localId: "m1", createTime: 1700000000, sender: "u1", conversationId: "c1", content: "项目周会 10 点" },
-      { localId: "m2", createTime: 1700000010, sender: "u2", conversationId: "c1", content: "收到" },
-    ],
-  },
-};
-
-function adapter(spec, { exists = true } = {}) {
-  const a = new WeWorkPcAdapter({ dbPath: "/fake.db" });
-  a._deps.fs = { existsSync: () => exists, accessSync: () => {}, constants: { R_OK: 4 } };
-  a._deps.dbDriverFactory = () => makeFakeDb(spec);
-  return a;
-}
-
-async function collect(iter) {
-  const out = [];
-  for await (const r of iter) out.push(r);
-  return out;
-}
-
-describe("WeWorkPcAdapter (企业微信 honest best-effort)", () => {
-  it("exposes name/version", () => {
-    expect(NAME).toBe("wework-pc");
-    expect(VERSION).toBe("0.1.0");
-    expect(new WeWorkPcAdapter().name).toBe("wework-pc");
-  });
-
-  it("no-arg construct + device-pull + legalGate + APP_NOT_INSTALLED readiness", async () => {
-    const a = new WeWorkPcAdapter();
-    a._deps.discoveryDeps = {
-      fs: { existsSync: () => false, readdirSync: () => [], statSync: () => ({ size: 0 }), constants: { R_OK: 4 } },
-      home: "/no-home",
-      env: {},
-    };
-    expect(a.extractMode).toBe("device-pull");
-    expect(a.dataDisclosure.legalGate).toBe(true);
-    const r = await a.authenticate({ readinessOnly: true });
-    expect(r.reason).toBe("APP_NOT_INSTALLED");
-  });
-
-  it("reads messages → valid events, platform=wework, raw preserved", async () => {
-    const a = adapter(SPEC);
-    const raws = await collect(a.sync({ dbPath: "/fake.db" }));
-    expect(raws).toHaveLength(2);
-    const merged = { events: [], persons: [], places: [], items: [], topics: [] };
-    for (const r of raws) {
-      const n = a.normalize(r);
-      for (const k of Object.keys(merged)) merged[k].push(...n[k]);
-    }
-    const { valid, invalidReasons } = partitionBatch(merged);
-    expect(invalidReasons).toHaveLength(0);
-    expect(valid.events).toHaveLength(2);
-    expect(valid.events[0].extra.platform).toBe("wework");
-    expect(valid.events[0].extra.textResolved).toBe(true);
-    expect(valid.events[0].extra.rawRow).toBeTruthy();
-  });
-
-  it("emits local-im-read progress diagnostic", async () => {
-    const a = adapter(SPEC);
-    const ev = [];
-    await collect(a.sync({ dbPath: "/fake.db", onProgress: (e) => ev.push(e) }));
-    const d = ev.find((e) => e.phase === "local-im-read");
-    expect(d.messageTables).toContain("chat_message");
-    expect(d.messageCount).toBe(2);
-  });
-
-  it("missing db yields nothing; unknown kind throws", async () => {
-    const a = adapter(SPEC, { exists: false });
-    expect(await collect(a.sync({ dbPath: "/no.db" }))).toHaveLength(0);
-    expect(() => new WeWorkPcAdapter().normalize({ kind: "x", payload: { kind: "x" } })).toThrow(/unknown kind/);
-  });
-});

package/__tests__/adapters/win-recent.test.js

@@ -1,192 +0,0 @@
-"use strict";
-
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { mkdtempSync, writeFileSync, rmSync, mkdirSync, utimesSync } from "node:fs";
-import { join } from "node:path";
-import { tmpdir } from "node:os";
-
-const {
-  WinRecentAdapter,
-  WIN_RECENT_NAME,
-  WIN_RECENT_VERSION,
-} = require("../../lib/adapters/win-recent");
-const { assertAdapter } = require("../../lib/adapter-spec");
-const {
-  EVENT_SUBTYPES,
-} = require("../../lib/constants");
-const { validateEvent } = require("../../lib/schemas");
-
-let tmpDir;
-let recentDir;
-
-function makeLnk(name, mtimeMs, body = "lnk-blob") {
-  const p = join(recentDir, name);
-  writeFileSync(p, body, "utf-8");
-  if (mtimeMs != null) {
-    utimesSync(p, mtimeMs / 1000, mtimeMs / 1000);
-  }
-}
-
-beforeEach(() => {
-  tmpDir = mkdtempSync(join(tmpdir(), "win-recent-test-"));
-  recentDir = join(tmpDir, "Recent");
-  mkdirSync(recentDir, { recursive: true });
-});
-
-afterEach(() => {
-  rmSync(tmpDir, { recursive: true, force: true });
-});
-
-describe("WinRecentAdapter — contract + identity", () => {
-  it("conforms to PersonalDataAdapter contract", () => {
-    expect(assertAdapter(new WinRecentAdapter())).toEqual({ ok: true });
-  });
-
-  it("name + version + capabilities stable", () => {
-    const a = new WinRecentAdapter();
-    expect(a.name).toBe(WIN_RECENT_NAME);
-    expect(a.name).toBe("win-recent");
-    expect(a.version).toBe(WIN_RECENT_VERSION);
-    expect(a.extractMode).toBe("file-import");
-    expect(a.capabilities).toContain("sync:win-recent-shortcuts");
-  });
-});
-
-describe("WinRecentAdapter.authenticate", () => {
-  it("PLATFORM_UNSUPPORTED when no recentDir resolved (override null)", async () => {
-    const a = new WinRecentAdapter();
-    a._deps.defaultDir = () => null;
-    const r = await a.authenticate({});
-    expect(r.ok).toBe(false);
-    expect(r.reason).toBe("PLATFORM_UNSUPPORTED");
-  });
-
-  it("RECENT_DIR_NOT_FOUND when dir doesn't exist", async () => {
-    const a = new WinRecentAdapter({ recentDir: join(tmpDir, "bogus") });
-    const r = await a.authenticate({});
-    expect(r.ok).toBe(false);
-    expect(r.reason).toBe("RECENT_DIR_NOT_FOUND");
-  });
-
-  it("succeeds when dir exists", async () => {
-    const a = new WinRecentAdapter({ recentDir });
-    const r = await a.authenticate({});
-    expect(r.ok).toBe(true);
-    expect(r.recentDir).toBe(recentDir);
-  });
-});
-
-describe("WinRecentAdapter.sync", () => {
-  it("yields one raw per .lnk, sorted mtime ascending", async () => {
-    makeLnk("zebra.lnk", 1_700_000_003_000);
-    makeLnk("apple.lnk", 1_700_000_001_000);
-    makeLnk("mango.lnk", 1_700_000_002_000);
-    const a = new WinRecentAdapter({ recentDir });
-    const raws = [];
-    for await (const r of a.sync()) raws.push(r);
-    expect(raws).toHaveLength(3);
-    expect(raws[0].payload.name).toBe("apple");
-    expect(raws[1].payload.name).toBe("mango");
-    expect(raws[2].payload.name).toBe("zebra");
-    expect(raws[0].payload.mtimeMs).toBe(1_700_000_001_000);
-  });
-
-  it("skips non-.lnk files and AutomaticDestinations / CustomDestinations subdirs", async () => {
-    makeLnk("a.lnk", 1_700_000_001_000);
-    makeLnk("readme.txt", 1_700_000_002_000); // non-.lnk
-    mkdirSync(join(recentDir, "AutomaticDestinations"), { recursive: true });
-    writeFileSync(
-      join(recentDir, "AutomaticDestinations", "deep.lnk"),
-      "should-not-be-found",
-    );
-    mkdirSync(join(recentDir, "CustomDestinations"), { recursive: true });
-    const a = new WinRecentAdapter({ recentDir });
-    const raws = [];
-    for await (const r of a.sync()) raws.push(r);
-    expect(raws).toHaveLength(1);
-    expect(raws[0].payload.name).toBe("a");
-  });
-
-  it("respects since filter (epoch ms)", async () => {
-    makeLnk("old.lnk", 1_700_000_001_000);
-    makeLnk("new.lnk", 1_700_000_005_000);
-    const a = new WinRecentAdapter({ recentDir });
-    const raws = [];
-    for await (const r of a.sync({ since: 1_700_000_003_000 })) raws.push(r);
-    expect(raws.map((r) => r.payload.name)).toEqual(["new"]);
-  });
-
-  it("respects limit", async () => {
-    for (let i = 0; i < 10; i++) makeLnk(`f${i}.lnk`, 1_700_000_000_000 + i * 1000);
-    const a = new WinRecentAdapter({ recentDir });
-    const raws = [];
-    for await (const r of a.sync({ limit: 4 })) raws.push(r);
-    expect(raws).toHaveLength(4);
-  });
-
-  it("originalId folds in mtime so same file at new mtime gets a new event", async () => {
-    makeLnk("foo.lnk", 1_700_000_001_000);
-    const a = new WinRecentAdapter({ recentDir });
-    const raws1 = [];
-    for await (const r of a.sync()) raws1.push(r);
-    const id1 = raws1[0].originalId;
-    // Re-touch with a newer mtime
-    makeLnk("foo.lnk", 1_700_000_009_000);
-    const raws2 = [];
-    for await (const r of a.sync()) raws2.push(r);
-    const id2 = raws2[0].originalId;
-    expect(id1).not.toBe(id2);
-    expect(id2).toContain("1700000009000");
-  });
-});
-
-describe("WinRecentAdapter.normalize", () => {
-  it("maps recent-file to Event(OTHER) with '打开了 X' title", () => {
-    const a = new WinRecentAdapter();
-    const { events } = a.normalize({
-      kind: "recent-file",
-      originalId: "win-recent:C:\\Users\\u\\Recent\\foo.lnk:1700000001000",
-      capturedAt: 1_700_000_005_000,
-      payload: {
-        name: "foo",
-        mtimeMs: 1_700_000_001_000,
-        size: 1024,
-        lnkPath: "C:\\Users\\u\\Recent\\foo.lnk",
-      },
-    });
-    expect(events).toHaveLength(1);
-    const e = events[0];
-    expect(e.subtype).toBe(EVENT_SUBTYPES.OTHER);
-    expect(e.content.title).toBe("打开了 foo");
-    expect(e.content.text).toBe("foo");
-    expect(e.actor).toBe("self");
-    expect(e.occurredAt).toBe(1_700_000_001_000);
-    expect(e.extra.kind).toBe("recent-file");
-    expect(e.extra.targetName).toBe("foo");
-    expect(e.extra.source).toBe("win-recent");
-    expect(validateEvent(e).valid).toBe(true);
-  });
-
-  it("truncates long target names in title", () => {
-    const a = new WinRecentAdapter();
-    const longName = "x".repeat(120);
-    const { events } = a.normalize({
-      kind: "recent-file",
-      originalId: "win-recent:long",
-      capturedAt: 1_700_000_000_000,
-      payload: {
-        name: longName,
-        mtimeMs: 1_700_000_000_000,
-      },
-    });
-    // Title is "打开了 " (4 chars) + name; name truncated to 70 + "…"
-    expect(events[0].content.title.endsWith("…")).toBe(true);
-    expect(events[0].content.text).toBe(longName); // full name preserved in text
-  });
-
-  it("throws on unknown raw.kind", () => {
-    expect(() => new WinRecentAdapter().normalize({ kind: "bogus", payload: {} })).toThrow(
-      /unknown raw\.kind=bogus/,
-    );
-  });
-});