@chainlesschain/personal-data-hub 0.4.3 → 0.4.5

package/__tests__/adapters/finance-alipay-live.test.js

@@ -0,0 +1,258 @@
+/**
+ * FAMILY-23 v0.2 — finance-alipay LIVE mobilegw fetcher tests.
+ * cookie (支付宝会话) → mgw.htm bill-list → snapshot-shaped events + adapter
+ * live sync + signProvider seam + amount/direction derivation + 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 { AlipayAdapter } = require("../../lib");
+const {
+  AlipayApiClient,
+  parseAmountYuan,
+  deriveDirection,
+} = require("../../lib/adapters/finance-alipay/api-client");
+const { validateBatch } = require("../../lib/batch");
+
+const COOKIE = "ALIPAYJSESSIONID=sess-abc; userId=2088123";
+const COOKIE_TOKEN_ONLY = "ALIPAYJSESSIONID=sess-abc";
+
+function makeFetch(routes, calls) {
+  return async (url, init) => {
+    calls.push({
+      url,
+      body: (init && init.body) || null,
+      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("alipay amount/direction derivation", () => {
+  it("parseAmountYuan handles number / signed string / currency noise", () => {
+    expect(parseAmountYuan(12.5)).toEqual({ amountFen: 1250, sign: 1 });
+    expect(parseAmountYuan("-25.00")).toEqual({ amountFen: 2500, sign: -1 });
+    expect(parseAmountYuan("+3.50")).toEqual({ amountFen: 350, sign: 1 });
+    expect(parseAmountYuan("¥ 1,200.00")).toEqual({ amountFen: 120000, sign: 1 });
+    expect(parseAmountYuan("abc")).toBeNull();
+    expect(parseAmountYuan(null)).toBeNull();
+  });
+
+  it("deriveDirection: explicit field wins, then amount sign, default out", () => {
+    expect(deriveDirection("收入", -1)).toBe("in");
+    expect(deriveDirection("支出", 1)).toBe("out");
+    expect(deriveDirection("INCOME", 0)).toBe("in");
+    expect(deriveDirection(null, 1)).toBe("in");
+    expect(deriveDirection(null, -1)).toBe("out");
+    expect(deriveDirection(null, 0)).toBe("out");
+  });
+});
+
+describe("AlipayApiClient session probe", () => {
+  it("hasSession accepts session token or numeric uid; rejects neither", () => {
+    const c = new AlipayApiClient();
+    expect(c.hasSession(COOKIE_TOKEN_ONLY)).toBe(true);
+    expect(c.hasSession("userId=2088123")).toBe(true);
+    expect(c.hasSession("foo=bar")).toBe(false);
+    expect(c.lastError.code).toBe(-7);
+  });
+});
+
+describe("AlipayApiClient.fetchSnapshot — live (mocked fetch)", () => {
+  it("POSTs form-encoded operationType+requestData with cookie; parses bills", async () => {
+    const calls = [];
+    const fetch = makeFetch(
+      [
+        {
+          match: "/mgw.htm",
+          body: {
+            resultStatus: 1000,
+            result: {
+              success: true,
+              billList: [
+                { billId: "b1", displayName: "便利店", amount: "-12.50", gmtCreate: 1700000000 },
+                { tradeNo: "b2", merchantName: "红包", amount: "+5.00", inOut: "收入", createTime: "1700003600" },
+              ],
+            },
+          },
+        },
+      ],
+      calls,
+    );
+    const client = new AlipayApiClient({ fetch });
+    const result = await client.fetchSnapshot(COOKIE);
+    // profile derived from cookie scrape (no extra op)
+    expect(result.account).toEqual({ uid: "2088123", displayName: null });
+    const profile = result.events.find((e) => e.kind === "profile");
+    expect(profile).toMatchObject({ uid: "2088123" });
+    const orders = result.events.filter((e) => e.kind === "order");
+    expect(orders).toHaveLength(2);
+    expect(orders[0]).toMatchObject({
+      id: "order-b1",
+      merchant: "便利店",
+      amountFen: 1250,
+      direction: "out",
+      startAt: 1700000000000,
+    });
+    expect(orders[1]).toMatchObject({
+      id: "order-b2",
+      merchant: "红包",
+      amountFen: 500,
+      direction: "in",
+      startAt: 1700003600000,
+    });
+    const call = calls[0];
+    expect(call.headers.Cookie).toBe(COOKIE);
+    expect(call.headers["Content-Type"]).toContain("application/x-www-form-urlencoded");
+    expect(call.body).toContain("operationType=alipay.mobile.bill.list");
+    expect(call.body).toContain("requestData=");
+  });
+
+  it("parses result-as-JSON-string envelope (mgw double-encoding)", async () => {
+    const fetch = makeFetch(
+      [
+        {
+          match: "/mgw.htm",
+          body: {
+            resultStatus: 1000,
+            result: JSON.stringify({ success: true, list: [{ id: "s1", title: "公交", amount: "-2.00", tradeTime: 1700000000 }] }),
+          },
+        },
+      ],
+      [],
+    );
+    const client = new AlipayApiClient({ fetch });
+    const result = await client.fetchSnapshot(COOKIE_TOKEN_ONLY);
+    // token-only cookie → no profile event, account null, orders still flow
+    expect(result.account).toBeNull();
+    expect(result.events.every((e) => e.kind === "order")).toBe(true);
+    expect(result.events[0]).toMatchObject({ merchant: "公交", amountFen: 200, direction: "out" });
+  });
+
+  it("signProvider headers are merged into the request", async () => {
+    const calls = [];
+    const fetch = makeFetch(
+      [{ match: "/mgw.htm", body: { resultStatus: 1000, result: { success: true, billList: [] } } }],
+      calls,
+    );
+    const signProvider = {
+      buildHeaders: async ({ operationType }) => ({ "X-Sign": `sig-of-${operationType}` }),
+    };
+    const client = new AlipayApiClient({ fetch, signProvider });
+    await client.fetchSnapshot(COOKIE);
+    expect(calls[0].headers["X-Sign"]).toBe("sig-of-alipay.mobile.bill.list");
+  });
+
+  it("maps mgw gateway error (resultStatus != 1000) to null + lastError", async () => {
+    const fetch = makeFetch(
+      [{ match: "/mgw.htm", body: { resultStatus: 2000, memo: "登录超时" } }],
+      [],
+    );
+    const client = new AlipayApiClient({ fetch });
+    expect(await client.fetchSnapshot(COOKIE)).toBeNull();
+    expect(client.lastError.code).toBe(2000);
+    expect(client.lastError.message).toContain("登录超时");
+  });
+
+  it("maps business failure (success:false) to null + lastError -6", async () => {
+    const fetch = makeFetch(
+      [{ match: "/mgw.htm", body: { resultStatus: 1000, result: { success: false, resultMessage: "无权限" } } }],
+      [],
+    );
+    const client = new AlipayApiClient({ fetch });
+    expect(await client.fetchSnapshot(COOKIE)).toBeNull();
+    expect(client.lastError.code).toBe(-6);
+    expect(client.lastError.message).toContain("无权限");
+  });
+
+  it("no session cookie → null + lastError -7 (no network)", async () => {
+    const calls = [];
+    const client = new AlipayApiClient({ fetch: makeFetch([], calls) });
+    expect(await client.fetchSnapshot("foo=bar")).toBeNull();
+    expect(client.lastError.code).toBe(-7);
+    expect(calls).toHaveLength(0);
+  });
+
+  it("sign failure → null + lastError -5 (no network)", async () => {
+    const calls = [];
+    const client = new AlipayApiClient({
+      fetch: makeFetch([], calls),
+      signProvider: { buildHeaders: () => { throw new Error("key missing"); } },
+    });
+    expect(await client.fetchSnapshot(COOKIE)).toBeNull();
+    expect(client.lastError.code).toBe(-5);
+    expect(calls).toHaveLength(0);
+  });
+});
+
+describe("AlipayAdapter — cookie (live) sync mode", () => {
+  it("authenticate accepts session cookie; rejects sessionless", async () => {
+    const a = new AlipayAdapter();
+    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 AlipayAdapter();
+    expect(a.version).toBe("0.2.0");
+    expect(a.capabilities).toContain("sync:cookie");
+  });
+
+  it("sync via cookie yields profile+order raws → valid normalized batch", async () => {
+    const fetch = makeFetch(
+      [
+        {
+          match: "/mgw.htm",
+          body: {
+            resultStatus: 1000,
+            result: { success: true, billList: [{ billId: "b1", displayName: "便利店", amount: "-12.50", gmtCreate: 1700000000 }] },
+          },
+        },
+      ],
+      [],
+    );
+    const a = new AlipayAdapter();
+    const raws = await collect(a.sync({ cookie: COOKIE, fetch }));
+    expect(raws.map((r) => r.kind).sort()).toEqual(["order", "profile"]);
+    const profileRaw = raws.find((r) => r.kind === "profile");
+    expect(profileRaw.originalId).toBe("alipay:profile:profile-2088123");
+
+    for (const raw of raws) {
+      expect(validateBatch(a.normalize(raw)).valid).toBe(true);
+    }
+    const profileBatch = a.normalize(profileRaw);
+    expect(profileBatch.persons[0].identifiers["alipay-uid"]).toEqual(["2088123"]);
+    const orderBatch = a.normalize(raws.find((r) => r.kind === "order"));
+    expect(orderBatch.events[0].subtype).toBe("payment");
+    expect(orderBatch.events[0].extra.amountFen).toBe(1250);
+    expect(orderBatch.events[0].extra.direction).toBe("out");
+  });
+
+  it("sync via cookie throws (mapped lastError) on gateway error", async () => {
+    const fetch = makeFetch(
+      [{ match: "/mgw.htm", body: { resultStatus: 2000, memo: "登录超时" } }],
+      [],
+    );
+    const a = new AlipayAdapter();
+    await expect(collect(a.sync({ cookie: COOKIE, fetch }))).rejects.toThrow(/登录超时|code 2000/);
+  });
+});

package/__tests__/adapters/game-genshin-live.test.js

@@ -0,0 +1,238 @@
+/**
+ * FAMILY-23 v0.2 — game-genshin LIVE HoYoLAB fetcher tests.
+ * DS v1 signing determinism + takumi role fetch + game-record stats fold-in
+ * + adapter cookie-mode sync + error mapping. All network via injected fetch.
+ */
+import { describe, it, expect } from "vitest";
+const { GenshinAdapter } = require("../../lib");
+const {
+  GenshinApiClient,
+  genDs,
+  md5Hex,
+  DEFAULT_DS_SALT,
+} = require("../../lib/adapters/game-genshin/api-client");
+const { validateBatch } = require("../../lib/batch");
+
+// Deterministic clock + RNG seams.
+const FIXED_NOW = () => 1700000000000; // → t = 1700000000
+const FIXED_RAND = () => 0.5; // → r = 100001 + floor(0.5 * 99999) = 150000
+
+/**
+ * Build a fake fetch that maps URL substrings to JSON responses.
+ * Each entry: { match, status?, body }. body is auto-JSON.stringify'd.
+ * Records every requested URL + headers into `calls`.
+ */
+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),
+    };
+  };
+}
+
+const COOKIE = "account_id_v2=809199; cookie_token_v2=abc; ltoken_v2=xyz";
+
+describe("genDs — DS v1 dynamic-secret signing", () => {
+  it("produces `${t},${r},${c}` with c = md5(salt&t&r), deterministic under seams", () => {
+    const ds = genDs(DEFAULT_DS_SALT, FIXED_NOW, FIXED_RAND);
+    const [t, r, c] = ds.split(",");
+    expect(t).toBe("1700000000");
+    expect(r).toBe("150000");
+    expect(c).toBe(md5Hex(`salt=${DEFAULT_DS_SALT}&t=1700000000&r=150000`));
+    expect(c).toMatch(/^[0-9a-f]{32}$/);
+  });
+
+  it("r stays within the 6-digit [100001,200000) window at RNG extremes", () => {
+    const low = genDs("s", FIXED_NOW, () => 0).split(",")[1];
+    const high = genDs("s", FIXED_NOW, () => 0.9999999).split(",")[1];
+    expect(Number(low)).toBe(100001);
+    expect(Number(high)).toBeLessThan(200000);
+    expect(Number(high)).toBeGreaterThanOrEqual(100001);
+  });
+});
+
+describe("GenshinApiClient.fetchProfiles — live (mocked fetch)", () => {
+  it("resolves bound roles + folds in active_day_number; sends DS-signed mihoyo headers", async () => {
+    const calls = [];
+    const fetch = makeFetch(
+      [
+        {
+          match: "getUserGameRolesByCookie",
+          body: {
+            retcode: 0,
+            message: "OK",
+            data: {
+              list: [
+                {
+                  game_uid: "800000001",
+                  nickname: "旅行者",
+                  level: 58,
+                  region: "cn_gf01",
+                  region_name: "天空岛",
+                },
+              ],
+            },
+          },
+        },
+        {
+          match: "game_record/app/genshin/api/index",
+          body: { retcode: 0, message: "OK", data: { stats: { active_day_number: 421 } } },
+        },
+      ],
+      calls,
+    );
+    const client = new GenshinApiClient({ fetch, now: FIXED_NOW, rand: FIXED_RAND });
+    const profiles = await client.fetchProfiles(COOKIE);
+    expect(profiles).toHaveLength(1);
+    expect(profiles[0]).toMatchObject({
+      uid: "800000001",
+      nickname: "旅行者",
+      level: 58,
+      region: "cn_gf01",
+      regionName: "天空岛",
+      activeDayNumber: 421,
+    });
+    // DS header present + well-formed on every call; client_type=5, version set.
+    for (const c of calls) {
+      expect(c.headers.DS).toMatch(/^\d+,\d+,[0-9a-f]{32}$/);
+      expect(c.headers["x-rpc-client_type"]).toBe("5");
+      expect(c.headers["x-rpc-app_version"]).toBeTruthy();
+      expect(c.headers.Cookie).toBe(COOKIE);
+    }
+    // index request carried role_id + server from the role.
+    const idx = calls.find((c) => c.url.includes("/index"));
+    expect(idx.url).toContain("role_id=800000001");
+    expect(idx.url).toContain("server=cn_gf01");
+  });
+
+  it("fetchStats:false skips the game-record index call", async () => {
+    const calls = [];
+    const fetch = makeFetch(
+      [
+        {
+          match: "getUserGameRolesByCookie",
+          body: {
+            retcode: 0,
+            data: { list: [{ game_uid: "1", nickname: "a", level: 1, region: "cn_qd01" }] },
+          },
+        },
+      ],
+      calls,
+    );
+    const client = new GenshinApiClient({ fetch, now: FIXED_NOW, rand: FIXED_RAND });
+    const profiles = await client.fetchProfiles(COOKIE, { fetchStats: false });
+    expect(profiles[0].activeDayNumber).toBeNull();
+    expect(calls.some((c) => c.url.includes("/index"))).toBe(false);
+  });
+
+  it("maps mihoyo retcode != 0 to null + lastError (e.g. 1034 risk-control)", async () => {
+    const calls = [];
+    const fetch = makeFetch(
+      [{ match: "getUserGameRolesByCookie", body: { retcode: 1034, message: "请进行验证" } }],
+      calls,
+    );
+    const client = new GenshinApiClient({ fetch, now: FIXED_NOW, rand: FIXED_RAND });
+    const profiles = await client.fetchProfiles(COOKIE);
+    expect(profiles).toBeNull();
+    expect(client.lastError.code).toBe(1034);
+    expect(client.lastError.message).toContain("验证");
+  });
+
+  it("empty cookie → null + lastError -1 (no network)", async () => {
+    const calls = [];
+    const client = new GenshinApiClient({
+      fetch: makeFetch([], calls),
+      now: FIXED_NOW,
+      rand: FIXED_RAND,
+    });
+    expect(await client.fetchProfiles("")).toBeNull();
+    expect(client.lastError.code).toBe(-1);
+    expect(calls).toHaveLength(0);
+  });
+
+  it("HTTP non-2xx → null + lastError with status code", async () => {
+    const calls = [];
+    const fetch = makeFetch(
+      [{ match: "getUserGameRolesByCookie", status: 503, body: "down" }],
+      calls,
+    );
+    const client = new GenshinApiClient({ fetch, now: FIXED_NOW, rand: FIXED_RAND });
+    expect(await client.fetchProfiles(COOKIE)).toBeNull();
+    expect(client.lastError.code).toBe(503);
+  });
+});
+
+describe("GenshinAdapter — cookie (live) sync mode", () => {
+  it("authenticate accepts a valid cookie (mode: cookie)", async () => {
+    const a = new GenshinAdapter();
+    const r = await a.authenticate({ cookie: COOKIE });
+    expect(r.ok).toBe(true);
+    expect(r.mode).toBe("cookie");
+  });
+
+  it("authenticate rejects guest cookie (no uid)", async () => {
+    const a = new GenshinAdapter();
+    const r = await a.authenticate({ cookie: "foo=bar" });
+    expect(r.ok).toBe(false);
+    expect(r.reason).toBe("INVALID_COOKIE");
+  });
+
+  it("sync via cookie yields profile raws → valid normalized batch with region/activeDays", async () => {
+    const calls = [];
+    const fetch = makeFetch(
+      [
+        {
+          match: "getUserGameRolesByCookie",
+          body: {
+            retcode: 0,
+            data: {
+              list: [
+                { game_uid: "800000001", nickname: "旅行者", level: 58, region: "cn_gf01", region_name: "天空岛" },
+              ],
+            },
+          },
+        },
+        {
+          match: "/index",
+          body: { retcode: 0, data: { stats: { active_day_number: 421 } } },
+        },
+      ],
+      calls,
+    );
+    const a = new GenshinAdapter();
+    const raws = [];
+    for await (const r of a.sync({ cookie: COOKIE, fetch, now: FIXED_NOW, rand: FIXED_RAND })) {
+      raws.push(r);
+    }
+    expect(raws).toHaveLength(1);
+    expect(raws[0].kind).toBe("profile");
+    expect(raws[0].originalId).toBe("genshin:profile:800000001");
+
+    const batch = a.normalize(raws[0]);
+    expect(validateBatch(batch).valid).toBe(true);
+    const person = batch.persons[0];
+    expect(person.identifiers["genshin-uid"]).toEqual(["800000001"]);
+    expect(person.extra.region).toBe("cn_gf01");
+    expect(person.extra.activeDayNumber).toBe(421);
+  });
+
+  it("sync via cookie throws (mapped lastError) on API risk-control", async () => {
+    const calls = [];
+    const fetch = makeFetch(
+      [{ match: "getUserGameRolesByCookie", body: { retcode: 10001, message: "登录失效" } }],
+      calls,
+    );
+    const a = new GenshinAdapter();
+    await expect(async () => {
+      for await (const _ of a.sync({ cookie: COOKIE, fetch, now: FIXED_NOW, rand: FIXED_RAND })) void _;
+    }).rejects.toThrow(/登录失效|code 10001/);
+  });
+});

package/__tests__/adapters/game-genshin-scaffold.test.js

@@ -25,10 +25,11 @@ describe("GenshinAdapter — FAMILY-23 v0.1 cookie-scrape placeholder", () => {
     const a = new GenshinAdapter();
     expect(assertAdapter(a).ok).toBe(true);
     expect(a.name).toBe("game-genshin");
-    expect(a.version).toBe("0.1.0");
+    expect(a.version).toBe("0.2.0");
     expect(a.extractMode).toBe("web-api");
     expect(a.dataDisclosure.sensitivity).toBe("medium");
     expect(a.capabilities).toContain("sync:snapshot");
+    expect(a.capabilities).toContain("sync:cookie");
   });
 
   it("extractUid parses HoYoLAB cookie keys (priority + null)", () => {
@@ -45,11 +46,11 @@ describe("GenshinAdapter — FAMILY-23 v0.1 cookie-scrape placeholder", () => {
     expect(c.lastError.code).toBe(-1);
   });
 
-  it("sync throws NO_INPUT without inputPath (v0.1 no live HTTP)", async () => {
+  it("sync throws without inputPath or cookie", async () => {
     const a = new GenshinAdapter();
     await expect(async () => {
       for await (const _ of a.sync({})) void _;
-    }).rejects.toThrow(/inputPath/);
+    }).rejects.toThrow(/inputPath.*cookie|cookie.*inputPath/);
   });
 
   it("sync via snapshot yields profile + play raws", async () => {