@chainlesschain/personal-data-hub 0.3.8 → 0.4.0

package/lib/adapters/finance-alipay/index.js

@@ -0,0 +1,257 @@
+/**
+ * FAMILY-23 v0.1 — 支付宝 (Alipay) adapter, snapshot mode.
+ *
+ * 家庭守护 telemetry：家长看孩子的消费情况。**高敏感**（涉资金）— 上行受
+ * telemetry level + quiet hours 闸（FAMILY-24/25）。v0.1 cookie-scrape 占位 —
+ * [AlipayApiClient.extractUid] 抽 uid；snapshot 模式消费手机端 collector 快照
+ * (profile + order)。账单 HTTP fetcher（mobilegw + 签名）留 v0.2，故无 inputPath
+ * 时 sync 抛 NO_INPUT。
+ *
+ * Snapshot schema (v1):
+ *   { schemaVersion:1, snapshottedAt, account:{uid,displayName}, events:[
+ *     { kind:"profile", id, capturedAt, uid, nickname },
+ *     { kind:"order", id, capturedAt, merchant, amountFen, direction, startAt } ] }
+ *   direction: "out"(支出) | "in"(收入)。amountFen: 分（整数）。
+ *
+ * Sensitivity: "high"。
+ */
+"use strict";
+
+const fs = require("node:fs");
+const { newId } = require("../../ids");
+const {
+  ENTITY_TYPES,
+  PERSON_SUBTYPES,
+  EVENT_SUBTYPES,
+  CAPTURED_BY,
+} = require("../../constants");
+const { AlipayApiClient } = require("./api-client");
+
+const NAME = "finance-alipay";
+const VERSION = "0.1.0";
+const SNAPSHOT_SCHEMA_VERSION = 1;
+const KIND_PROFILE = "profile";
+const KIND_ORDER = "order";
+const VALID_SNAPSHOT_KINDS = Object.freeze([KIND_PROFILE, KIND_ORDER]);
+
+function stableOriginalId(kind, id) {
+  const safe =
+    (typeof id === "string" && id.length > 0 && id) ||
+    (typeof id === "number" && Number.isFinite(id) && String(id)) ||
+    `unknown-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+  return `alipay:${kind}:${safe}`;
+}
+
+function parseTime(v) {
+  if (Number.isFinite(v)) return v > 1e12 ? v : v * 1000;
+  if (typeof v === "string") {
+    if (/^\d+$/.test(v)) {
+      const n = parseInt(v, 10);
+      return n > 1e12 ? n : n * 1000;
+    }
+    const t = Date.parse(v);
+    return Number.isFinite(t) ? t : null;
+  }
+  return null;
+}
+
+class AlipayAdapter {
+  constructor(opts = {}) {
+    this.account = opts.account || null;
+    this.name = NAME;
+    this.version = VERSION;
+    this.capabilities = [
+      "sync:snapshot",
+      "parse:alipay-profile",
+      "parse:alipay-order",
+    ];
+    this.extractMode = "web-api";
+    this.rateLimits = {};
+    this.dataDisclosure = {
+      fields: [
+        "alipay:profile (uid / nickname)",
+        "alipay:order (merchant / amount / direction / time)",
+      ],
+      sensitivity: "high",
+      legalGate: false,
+      defaultInclude: { profile: true, order: true },
+    };
+    this.apiClient = new AlipayApiClient();
+    this._deps = { fs };
+  }
+
+  async authenticate(ctx = {}) {
+    if (ctx && typeof ctx.inputPath === "string" && ctx.inputPath.length > 0) {
+      try {
+        this._deps.fs.accessSync(ctx.inputPath, this._deps.fs.constants.R_OK);
+      } catch (err) {
+        return {
+          ok: false,
+          reason: "INPUT_PATH_UNREADABLE",
+          message: `snapshot not readable at ${ctx.inputPath}: ${err.message}`,
+        };
+      }
+      return { ok: true, mode: "snapshot-file" };
+    }
+    return {
+      ok: false,
+      reason: "NO_INPUT",
+      message:
+        "finance-alipay.authenticate: v0.1 needs opts.inputPath (snapshot mode); live HTTP fetcher 待 v0.2",
+    };
+  }
+
+  async healthCheck() {
+    return { ok: true, lastChecked: Date.now() };
+  }
+
+  async *sync(opts = {}) {
+    if (typeof opts.inputPath === "string" && opts.inputPath.length > 0) {
+      yield* this._syncViaSnapshot(opts);
+      return;
+    }
+    throw new Error(
+      "finance-alipay.sync: v0.1 needs opts.inputPath (snapshot mode); 账单 HTTP fetcher (mobilegw + 签名) 待 v0.2",
+    );
+  }
+
+  async *_syncViaSnapshot(opts) {
+    const raw = this._deps.fs.readFileSync(opts.inputPath, "utf-8");
+    const snapshot = JSON.parse(raw);
+    if (
+      !snapshot ||
+      typeof snapshot !== "object" ||
+      snapshot.schemaVersion !== SNAPSHOT_SCHEMA_VERSION
+    ) {
+      throw new Error(
+        `finance-alipay.sync: snapshot schemaVersion mismatch (got ${snapshot && snapshot.schemaVersion}, expected ${SNAPSHOT_SCHEMA_VERSION})`,
+      );
+    }
+    const fallbackCapturedAt =
+      Number.isFinite(snapshot.snapshottedAt) && snapshot.snapshottedAt > 0
+        ? Math.floor(snapshot.snapshottedAt)
+        : Date.now();
+    const account =
+      snapshot.account && typeof snapshot.account === "object"
+        ? snapshot.account
+        : null;
+    const include = opts.include || {};
+    const limit =
+      Number.isInteger(opts.limit) && opts.limit > 0 ? opts.limit : Infinity;
+    const events = Array.isArray(snapshot.events) ? snapshot.events : [];
+    let emitted = 0;
+    for (const ev of events) {
+      if (emitted >= limit) return;
+      if (!ev || typeof ev !== "object") continue;
+      const kind = ev.kind;
+      if (!VALID_SNAPSHOT_KINDS.includes(kind)) continue;
+      if (include[kind] === false) continue;
+      const capturedAt = parseTime(ev.capturedAt) || fallbackCapturedAt;
+      const id =
+        (typeof ev.id === "string" && ev.id.length > 0 && ev.id) ||
+        ev.uid ||
+        null;
+      yield {
+        adapter: NAME,
+        kind,
+        originalId: stableOriginalId(kind, id),
+        capturedAt,
+        payload: { ...ev, account },
+      };
+      emitted += 1;
+    }
+  }
+
+  normalize(raw) {
+    if (!raw || !raw.payload) {
+      throw new Error("AlipayAdapter.normalize: payload missing");
+    }
+    const ingestedAt = Date.now();
+    const kind = raw.kind || raw.payload.kind;
+    const p = raw.payload;
+    if (kind === KIND_PROFILE) return normalizeProfile(p, raw, ingestedAt);
+    if (kind === KIND_ORDER) return normalizeOrder(p, raw, ingestedAt);
+    throw new Error(`AlipayAdapter.normalize: unknown kind ${kind}`);
+  }
+}
+
+function buildSource(raw, occurredAt) {
+  return {
+    adapter: NAME,
+    adapterVersion: VERSION,
+    originalId: raw.originalId,
+    capturedAt: raw.capturedAt || occurredAt,
+    capturedBy: CAPTURED_BY.API,
+  };
+}
+
+function normalizeProfile(p, raw, ingestedAt) {
+  const uid = p.uid || (p.account && p.account.uid) || null;
+  const nickname =
+    p.nickname || (p.account && p.account.displayName) || "(unnamed)";
+  const occurredAt = parseTime(p.capturedAt) || raw.capturedAt || ingestedAt;
+  const identifiers = {};
+  if (uid) identifiers["alipay-uid"] = [String(uid)];
+  return {
+    events: [],
+    persons: [
+      {
+        id: uid ? `person-alipay-${uid}` : `person-alipay-self-${newId()}`,
+        type: ENTITY_TYPES.PERSON,
+        subtype: PERSON_SUBTYPES.SELF,
+        names: [nickname],
+        ingestedAt,
+        source: buildSource(raw, occurredAt),
+        identifiers,
+        extra: { platform: "alipay", snapshottedAt: occurredAt },
+      },
+    ],
+    places: [],
+    items: [],
+    topics: [],
+  };
+}
+
+function normalizeOrder(p, raw, ingestedAt) {
+  const occurredAt =
+    parseTime(p.startAt) ||
+    parseTime(p.capturedAt) ||
+    raw.capturedAt ||
+    ingestedAt;
+  const merchant = p.merchant || "(unknown merchant)";
+  return {
+    events: [
+      {
+        id: newId(),
+        type: ENTITY_TYPES.EVENT,
+        subtype: EVENT_SUBTYPES.PAYMENT,
+        occurredAt,
+        actor: "person-self",
+        content: { title: merchant },
+        ingestedAt,
+        source: buildSource(raw, occurredAt),
+        extra: {
+          platform: "alipay",
+          kind: "order",
+          merchant,
+          amountFen: Number.isFinite(p.amountFen) ? p.amountFen : null,
+          direction: p.direction === "in" ? "in" : "out",
+        },
+      },
+    ],
+    persons: [],
+    places: [],
+    items: [],
+    topics: [],
+  };
+}
+
+module.exports = {
+  AlipayAdapter,
+  NAME,
+  VERSION,
+  SNAPSHOT_SCHEMA_VERSION,
+  VALID_SNAPSHOT_KINDS,
+  KIND_PROFILE,
+  KIND_ORDER,
+};

package/lib/adapters/game-genshin/api-client.js

@@ -0,0 +1,59 @@
+/**
+ * GenshinApiClient — FAMILY-23 v0.1 cookie-scrape（无签名）。
+ *
+ * 原神 / 米哈游通行证 (HoYoLAB / 米游社) 走 cookie 鉴权；v0.1 仅从 cookie 抽 uid
+ * (extractUid)，不做 HTTP fetcher（历史战绩 / 游戏时长 走 v0.2 通过 takumi/hk4e
+ * 接口 + DS 签名）。镜像 social-toutiao-adb/api-client.js 的 extractUid 形态。
+ *
+ * Cookie key 优先级 (米游社 2023+ → 旧版):
+ *   account_id_v2 > ltuid_v2 > account_id > ltuid
+ */
+"use strict";
+
+class GenshinApiClient {
+  constructor() {
+    this._lastErrorCode = 0;
+    this._lastErrorMsg = "";
+  }
+
+  _setLastError(code, msg) {
+    this._lastErrorCode = code;
+    this._lastErrorMsg = msg;
+  }
+
+  _clearLastError() {
+    this._lastErrorCode = 0;
+    this._lastErrorMsg = "";
+  }
+
+  get lastError() {
+    return { code: this._lastErrorCode, message: this._lastErrorMsg };
+  }
+
+  /**
+   * 从 cookie 串抽米哈游通行证 uid。失败返 null + 设 lastError。
+   * @param {string} cookie 形如 "account_id_v2=12345; ltoken_v2=...; ..."
+   * @returns {string|null}
+   */
+  extractUid(cookie) {
+    if (typeof cookie !== "string" || cookie.length === 0) {
+      this._setLastError(-1, "cookie 为空");
+      return null;
+    }
+    const keys = ["account_id_v2", "ltuid_v2", "account_id", "ltuid"];
+    for (const key of keys) {
+      const m = new RegExp(`(?:^|; ?)${key}=(\\d+)`).exec(cookie);
+      if (m && m[1] && m[1] !== "0") {
+        this._clearLastError();
+        return m[1];
+      }
+    }
+    this._setLastError(
+      -7,
+      "cookie 缺 account_id_v2 / ltuid_v2 / account_id / ltuid — 米游社未登录或仅游客态",
+    );
+    return null;
+  }
+}
+
+module.exports = { GenshinApiClient };

package/lib/adapters/game-genshin/index.js

@@ -0,0 +1,274 @@
+/**
+ * FAMILY-23 v0.1 — Genshin Impact (原神 / 米哈游) adapter, snapshot mode.
+ *
+ * 家庭守护 telemetry：家长想看孩子玩什么游戏 / 玩多久。v0.1 cookie-scrape 占位 —
+ * [GenshinApiClient.extractUid] 从米游社 cookie 抽 uid；snapshot 模式消费手机端
+ * collector 产的快照 JSON（profile + play-session 事件）。HTTP fetcher（takumi/hk4e
+ * 战绩 + DS 签名）留 v0.2，故无 inputPath 时 sync 抛 NO_INPUT（同 social-kuaishou）。
+ *
+ * Snapshot schema (v1):
+ *   {
+ *     "schemaVersion": 1,
+ *     "snapshottedAt": <epoch-ms>,
+ *     "account": { "uid": "12345", "displayName": "旅行者" },
+ *     "events": [
+ *       { "kind": "profile", "id": "profile-<uid>", "capturedAt": <ms>,
+ *         "uid": "...", "nickname": "...", "level": N, "avatarUrl": "..." },
+ *       { "kind": "play", "id": "play-<sessionId>", "capturedAt": <ms>,
+ *         "durationMs": N, "mode": "...", "startAt": <ms> }
+ *     ]
+ *   }
+ *
+ * Sensitivity: "medium" — 游戏时长 / 等级揭示娱乐偏好与在线时段。
+ */
+"use strict";
+
+const fs = require("node:fs");
+const { newId } = require("../../ids");
+const {
+  ENTITY_TYPES,
+  PERSON_SUBTYPES,
+  EVENT_SUBTYPES,
+  CAPTURED_BY,
+} = require("../../constants");
+const { GenshinApiClient } = require("./api-client");
+
+const NAME = "game-genshin";
+const VERSION = "0.1.0";
+const SNAPSHOT_SCHEMA_VERSION = 1;
+
+const KIND_PROFILE = "profile";
+const KIND_PLAY = "play";
+const VALID_SNAPSHOT_KINDS = Object.freeze([KIND_PROFILE, KIND_PLAY]);
+
+function stableOriginalId(kind, id) {
+  const safe =
+    (typeof id === "string" && id.length > 0 && id) ||
+    (typeof id === "number" && Number.isFinite(id) && String(id)) ||
+    `unknown-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+  return `genshin:${kind}:${safe}`;
+}
+
+function parseTime(v) {
+  if (Number.isFinite(v)) return v > 1e12 ? v : v * 1000;
+  if (typeof v === "string") {
+    if (/^\d+$/.test(v)) {
+      const n = parseInt(v, 10);
+      return n > 1e12 ? n : n * 1000;
+    }
+    const t = Date.parse(v);
+    return Number.isFinite(t) ? t : null;
+  }
+  return null;
+}
+
+class GenshinAdapter {
+  constructor(opts = {}) {
+    this.account = opts.account || null;
+    this.name = NAME;
+    this.version = VERSION;
+    this.capabilities = [
+      "sync:snapshot",
+      "parse:genshin-profile",
+      "parse:genshin-play-session",
+    ];
+    this.extractMode = "web-api";
+    this.rateLimits = {};
+    this.dataDisclosure = {
+      fields: [
+        "genshin:profile (uid / nickname / level / avatar)",
+        "genshin:play_session (start / duration / mode)",
+      ],
+      sensitivity: "medium",
+      legalGate: false,
+      defaultInclude: { profile: true, play: true },
+    };
+    this.apiClient = new GenshinApiClient();
+    this._deps = { fs };
+  }
+
+  async authenticate(ctx = {}) {
+    if (ctx && typeof ctx.inputPath === "string" && ctx.inputPath.length > 0) {
+      try {
+        this._deps.fs.accessSync(ctx.inputPath, this._deps.fs.constants.R_OK);
+      } catch (err) {
+        return {
+          ok: false,
+          reason: "INPUT_PATH_UNREADABLE",
+          message: `snapshot not readable at ${ctx.inputPath}: ${err.message}`,
+        };
+      }
+      return { ok: true, mode: "snapshot-file" };
+    }
+    return {
+      ok: false,
+      reason: "NO_INPUT",
+      message:
+        "game-genshin.authenticate: v0.1 needs opts.inputPath (snapshot mode); live HTTP fetcher 待 v0.2",
+    };
+  }
+
+  async healthCheck() {
+    return { ok: true, lastChecked: Date.now() };
+  }
+
+  async *sync(opts = {}) {
+    if (typeof opts.inputPath === "string" && opts.inputPath.length > 0) {
+      yield* this._syncViaSnapshot(opts);
+      return;
+    }
+    throw new Error(
+      "game-genshin.sync: v0.1 needs opts.inputPath (snapshot mode, Android in-APK cc); live HTTP fetcher (takumi/hk4e + DS 签名) 待 v0.2",
+    );
+  }
+
+  async *_syncViaSnapshot(opts) {
+    const raw = this._deps.fs.readFileSync(opts.inputPath, "utf-8");
+    const snapshot = JSON.parse(raw);
+    if (
+      !snapshot ||
+      typeof snapshot !== "object" ||
+      snapshot.schemaVersion !== SNAPSHOT_SCHEMA_VERSION
+    ) {
+      throw new Error(
+        `game-genshin.sync: snapshot schemaVersion mismatch (got ${snapshot && snapshot.schemaVersion}, expected ${SNAPSHOT_SCHEMA_VERSION})`,
+      );
+    }
+    const fallbackCapturedAt =
+      Number.isFinite(snapshot.snapshottedAt) && snapshot.snapshottedAt > 0
+        ? Math.floor(snapshot.snapshottedAt)
+        : Date.now();
+    const account =
+      snapshot.account && typeof snapshot.account === "object"
+        ? snapshot.account
+        : null;
+    const include = opts.include || {};
+    const limit =
+      Number.isInteger(opts.limit) && opts.limit > 0 ? opts.limit : Infinity;
+
+    const events = Array.isArray(snapshot.events) ? snapshot.events : [];
+    let emitted = 0;
+    for (const ev of events) {
+      if (emitted >= limit) return;
+      if (!ev || typeof ev !== "object") continue;
+      const kind = ev.kind;
+      if (!VALID_SNAPSHOT_KINDS.includes(kind)) continue;
+      if (include[kind] === false) continue;
+
+      const capturedAt = parseTime(ev.capturedAt) || fallbackCapturedAt;
+      const id =
+        (typeof ev.id === "string" && ev.id.length > 0 && ev.id) ||
+        ev.uid ||
+        null;
+      yield {
+        adapter: NAME,
+        kind,
+        originalId: stableOriginalId(kind, id),
+        capturedAt,
+        payload: { ...ev, account },
+      };
+      emitted += 1;
+    }
+  }
+
+  normalize(raw) {
+    if (!raw || !raw.payload) {
+      throw new Error("GenshinAdapter.normalize: payload missing");
+    }
+    const ingestedAt = Date.now();
+    const kind = raw.kind || raw.payload.kind;
+    const p = raw.payload;
+    if (kind === KIND_PROFILE) {
+      return normalizeProfile(p, raw, ingestedAt);
+    }
+    if (kind === KIND_PLAY) {
+      return normalizePlay(p, raw, ingestedAt);
+    }
+    throw new Error(`GenshinAdapter.normalize: unknown kind ${kind}`);
+  }
+}
+
+function buildSource(raw, occurredAt) {
+  return {
+    adapter: NAME,
+    adapterVersion: VERSION,
+    originalId: raw.originalId,
+    capturedAt: raw.capturedAt || occurredAt,
+    capturedBy: CAPTURED_BY.API,
+  };
+}
+
+function normalizeProfile(p, raw, ingestedAt) {
+  const uid = p.uid || (p.account && p.account.uid) || null;
+  const nickname =
+    p.nickname || (p.account && p.account.displayName) || "(unnamed)";
+  const occurredAt = parseTime(p.capturedAt) || raw.capturedAt || ingestedAt;
+  const identifiers = {};
+  if (uid) identifiers["genshin-uid"] = [String(uid)];
+  return {
+    events: [],
+    persons: [
+      {
+        id: uid ? `person-genshin-${uid}` : `person-genshin-self-${newId()}`,
+        type: ENTITY_TYPES.PERSON,
+        subtype: PERSON_SUBTYPES.SELF,
+        names: [nickname],
+        ingestedAt,
+        source: buildSource(raw, occurredAt),
+        identifiers,
+        extra: {
+          platform: "genshin",
+          level: p.level != null ? p.level : null,
+          avatarUrl: p.avatarUrl || null,
+          snapshottedAt: occurredAt,
+        },
+      },
+    ],
+    places: [],
+    items: [],
+    topics: [],
+  };
+}
+
+function normalizePlay(p, raw, ingestedAt) {
+  const occurredAt =
+    parseTime(p.startAt) ||
+    parseTime(p.capturedAt) ||
+    raw.capturedAt ||
+    ingestedAt;
+  const durationMs = Number.isFinite(p.durationMs) ? p.durationMs : 0;
+  return {
+    events: [
+      {
+        id: newId(),
+        type: ENTITY_TYPES.EVENT,
+        subtype: EVENT_SUBTYPES.MEDIA,
+        occurredAt,
+        actor: "person-self",
+        content: { title: "原神 游戏时长" },
+        ingestedAt,
+        source: buildSource(raw, occurredAt),
+        extra: {
+          platform: "genshin",
+          kind: "play",
+          durationMs,
+          mode: p.mode || null,
+        },
+      },
+    ],
+    persons: [],
+    places: [],
+    items: [],
+    topics: [],
+  };
+}
+
+module.exports = {
+  GenshinAdapter,
+  NAME,
+  VERSION,
+  SNAPSHOT_SCHEMA_VERSION,
+  VALID_SNAPSHOT_KINDS,
+  KIND_PROFILE,
+  KIND_PLAY,
+};

package/lib/adapters/game-honor-of-kings/api-client.js

@@ -0,0 +1,54 @@
+/**
+ * HonorOfKingsApiClient — FAMILY-23 v0.1 cookie-scrape（无签名）。
+ *
+ * 王者荣耀走腾讯系登录（微信/QQ openid 或营地 gamehelper cookie）；v0.1 仅从
+ * cookie 抽 uid（extractUid），战绩/对局时长 走 v0.2（营地接口 + 腾讯签名）。
+ * Cookie key 优先级: openid > uin(QQ号) > tencent_uid。
+ */
+"use strict";
+
+class HonorOfKingsApiClient {
+  constructor() {
+    this._lastErrorCode = 0;
+    this._lastErrorMsg = "";
+  }
+  _setLastError(code, msg) {
+    this._lastErrorCode = code;
+    this._lastErrorMsg = msg;
+  }
+  _clearLastError() {
+    this._lastErrorCode = 0;
+    this._lastErrorMsg = "";
+  }
+  get lastError() {
+    return { code: this._lastErrorCode, message: this._lastErrorMsg };
+  }
+
+  /** @param {string} cookie @returns {string|null} */
+  extractUid(cookie) {
+    if (typeof cookie !== "string" || cookie.length === 0) {
+      this._setLastError(-1, "cookie 为空");
+      return null;
+    }
+    // openid 是字母数字混合; uin / tencent_uid 是纯数字。
+    const openid = /(?:^|; ?)openid=([A-Za-z0-9_-]+)/.exec(cookie);
+    if (openid && openid[1] && openid[1].length >= 8) {
+      this._clearLastError();
+      return openid[1];
+    }
+    for (const key of ["uin", "tencent_uid"]) {
+      const m = new RegExp(`(?:^|; ?)${key}=o?0*(\\d+)`).exec(cookie);
+      if (m && m[1] && m[1] !== "0") {
+        this._clearLastError();
+        return m[1];
+      }
+    }
+    this._setLastError(
+      -7,
+      "cookie 缺 openid / uin / tencent_uid — 营地/微信/QQ 未登录",
+    );
+    return null;
+  }
+}
+
+module.exports = { HonorOfKingsApiClient };