@chainlesschain/personal-data-hub 0.4.7 → 0.4.23

package/lib/adapters/travel-tongcheng/index.js

@@ -0,0 +1,393 @@
+/**
+ * §9.3d — Tongcheng (同程旅行) order adapter, dual-mode (snapshot + cookie-api).
+ *
+ * 同程 (com.tongcheng.android) is a Phase 9 travel platform (ROI ⭐⭐⭐ in
+ * docs/design/Personal_Data_Hub_Architecture.md §12.1, "与携程互补") that was
+ * skipped when the travel 四件套 (amap/baidu/ctrip/12306) shipped. It is an OTA
+ * like 携程, so this adapter mirrors travel-ctrip: orders span flight / hotel /
+ * train / bus / scenery (门票) / cruise / car, each mapped to the appropriate
+ * `vehicleType` in the vendor-neutral TravelRecord.
+ *
+ *   1. snapshot / file-import mode (opts.inputPath | opts.dataPath): ingest a
+ *      JSON dump from an Android in-APK collector / browser extension / curated
+ *      file. account OPTIONAL (file-import is stateless).
+ *
+ *   2. cookie-api mode (opts.account.cookies, v0.1): fetch the Tongcheng order
+ *      centre directly from the hub. After login on the ly.com domain the order
+ *      list is reachable under the `.ly.com` cookie. As with the other travel /
+ *      shopping adapters the actual HTTP call is delegated to an injected
+ *      `fetchFn` (Android in-APK cc → OkHttp; desktop hub → Electron WebView net
+ *      request) so this module stays a pure-Node parser + orchestrator. account
+ *      OPTIONAL — the cookie carries identity.
+ *
+ *      ── sign seam ──────────────────────────────────────────────────────────
+ *      Tongcheng's H5 / m-API requests carry an anti-bot signature computed by
+ *      client-side JS (analogous to 携程 mtgsig / 拼多多 anti_token). No pure-Node
+ *      implementation survives the rotation, so signing is injected via
+ *      `opts.signProvider` (or constructor `signProvider`). When absent the
+ *      request is still issued unsigned — best-effort, the endpoint may reject
+ *      it, which surfaces as zero events rather than a crash. The endpoint
+ *      constant is best-effort and overridable via `opts.ordersUrl`; Tongcheng
+ *      rotates H5 paths, so adjust / pass opts.ordersUrl if it drifts
+ *      (FAMILY-23 playbook — endpoints are not field-verified here).
+ */
+
+"use strict";
+
+const fs = require("node:fs");
+const { normalizeTravelRecord, parseChineseDateTime } = require("../travel-base");
+const { CookieAuth } = require("../shopping-base");
+
+const NAME = "travel-tongcheng";
+const VERSION = "0.1.0";
+
+// Best-effort Tongcheng order-centre list endpoint. Overridable via
+// opts.ordersUrl (Tongcheng rotates H5 paths; the injected fetchFn host may
+// also point at whichever order API the captured cookie is currently scoped to).
+const TONGCHENG_ORDERS_URL = "https://m.ly.com/order/orderList";
+const DEFAULT_PAGE_SIZE = 20;
+const DEFAULT_MAX_PAGES = 10;
+
+const TYPE_MAP = {
+  flight: "flight",
+  airline: "flight",
+  jipiao: "flight",
+  机票: "flight",
+  hotel: "hotel",
+  jiudian: "hotel",
+  酒店: "hotel",
+  train: "train",
+  huoche: "train",
+  火车: "train",
+  火车票: "train",
+  bus: "bus",
+  qiche: "bus",
+  汽车: "bus",
+  汽车票: "bus",
+  coach: "bus",
+  scenery: "attraction",
+  jingdian: "attraction",
+  景点: "attraction",
+  门票: "attraction",
+  ticket: "attraction",
+  cruise: "cruise",
+  youlun: "cruise",
+  邮轮: "cruise",
+  car: "car",
+  yongche: "car",
+  用车: "car",
+};
+
+class TongchengAdapter {
+  constructor(opts = {}) {
+    this.account = opts.account || null;
+    this._dataPath = opts.dataPath || null;
+
+    // cookie-api mode — activates when account.cookies is supplied.
+    this._cookieAuth =
+      opts.account && opts.account.cookies
+        ? new CookieAuth({ platform: "tongcheng", cookies: opts.account.cookies })
+        : null;
+    this._fetchFn = typeof opts.fetchFn === "function" ? opts.fetchFn : defaultFetch;
+    this._signProvider =
+      typeof opts.signProvider === "function" ? opts.signProvider : null;
+    this._ordersUrl =
+      typeof opts.ordersUrl === "string" && opts.ordersUrl.length > 0
+        ? opts.ordersUrl
+        : TONGCHENG_ORDERS_URL;
+
+    this.name = NAME;
+    this.version = VERSION;
+    this.capabilities = [
+      "import:json",
+      "sync:snapshot",
+      "sync:cookie-api",
+      "parse:tongcheng-orders",
+    ];
+    this.extractMode = "file-import";
+    this.rateLimits = {};
+    this.dataDisclosure = {
+      fields: [
+        "tongcheng:orderId / type / fromCity / toCity / dates / passengerName / price / carrier",
+      ],
+      sensitivity: "medium",
+      legalGate: false,
+    };
+
+    // _deps injection seam — vi.mock fs doesn't intercept inlined CJS require.
+    this._deps = { fs };
+  }
+
+  async authenticate(ctx = {}) {
+    const filePath = (ctx && ctx.inputPath) || ctx.dataPath || this._dataPath;
+    if (filePath) {
+      try {
+        this._deps.fs.accessSync(filePath, this._deps.fs.constants.R_OK);
+      } catch (err) {
+        return {
+          ok: false,
+          reason: "INPUT_PATH_UNREADABLE",
+          message: `not readable at ${filePath}: ${err.message}`,
+        };
+      }
+      return { ok: true, mode: "snapshot-file" };
+    }
+    if (this._cookieAuth) {
+      const ok = await this._cookieAuth.validate();
+      if (!ok) {
+        return { ok: false, reason: "INVALID_COOKIE", error: "cookies missing" };
+      }
+      // account is OPTIONAL in cookie mode — the .ly.com cookie carries identity.
+      return {
+        ok: true,
+        account: (this.account && this.account.email) || null,
+        mode: "cookie",
+      };
+    }
+    return {
+      ok: true,
+      account: this.account ? this.account.email : null,
+      mode: "ready",
+    };
+  }
+
+  async healthCheck() {
+    if (this._cookieAuth) {
+      const r = await this.authenticate();
+      return r.ok
+        ? { ok: true, lastChecked: Date.now() }
+        : { ok: false, reason: r.reason, error: r.error };
+    }
+    return { ok: true, lastChecked: Date.now() };
+  }
+
+  async *sync(opts = {}) {
+    const dataPath = opts.inputPath || opts.dataPath || this._dataPath;
+    if (dataPath) {
+      if (!this._deps.fs.existsSync(dataPath)) return;
+      const text = this._deps.fs.readFileSync(dataPath, "utf-8");
+      let records;
+      try {
+        records = parseRecords(text);
+      } catch (err) {
+        throw new Error(`TongchengAdapter: parse failed: ${err.message}`);
+      }
+      for (const r of records) {
+        yield {
+          adapter: NAME,
+          originalId: r.recordId,
+          capturedAt: r.bookedAt || r.departureMs || Date.now(),
+          payload: { record: r },
+        };
+      }
+      return;
+    }
+    if (this._cookieAuth) {
+      yield* this._syncViaCookie(opts);
+    }
+  }
+
+  /**
+   * §9.3d — cookie-api live fetch. Hits the Tongcheng order-centre list
+   * endpoint via the injected fetchFn, paginates with a pageIndex cursor, stops
+   * at the sinceWatermark / maxPages, maps each order through orderToRecord (so
+   * the existing normalize path applies unchanged) and yields it.
+   */
+  async *_syncViaCookie(opts = {}) {
+    if (!(await this._cookieAuth.validate())) return;
+    const cookies = this._cookieAuth.toHeader();
+    const sinceMs =
+      opts.sinceWatermark != null
+        ? parseInt(String(opts.sinceWatermark), 10) || 0
+        : Date.now() - 365 * 24 * 3600_000; // default last year
+    const pageSize = Number.isFinite(opts.pageSize) ? opts.pageSize : DEFAULT_PAGE_SIZE;
+    const maxPages =
+      Number.isInteger(opts.maxPages) && opts.maxPages > 0
+        ? opts.maxPages
+        : DEFAULT_MAX_PAGES;
+    const limit =
+      Number.isInteger(opts.limit) && opts.limit > 0 ? opts.limit : Infinity;
+
+    let emitted = 0;
+    let pageIndex = 1;
+    while (pageIndex <= maxPages) {
+      const query = { pageIndex, pageSize, ts: Date.now() };
+      // sign seam — best-effort. null when no signProvider.
+      let sign = null;
+      if (this._signProvider) {
+        sign = await this._signProvider({ url: this._ordersUrl, query, cookies });
+      }
+      const resp = await this._fetchFn({ url: this._ordersUrl, cookies, query, sign });
+      const orders = extractOrders(resp);
+      if (!orders.length) break;
+
+      let pageHasNew = false;
+      let reachedWatermark = false;
+      for (const raw of orders) {
+        const rec = orderToRecord(raw, { capturedVia: "cookie-api" });
+        if (!rec) continue;
+        const ts = rec.bookedAt || rec.departureMs || null;
+        if (ts && ts < sinceMs) {
+          reachedWatermark = true; // remaining orders are older
+          break;
+        }
+        pageHasNew = true;
+        if (emitted >= limit) return;
+        yield {
+          adapter: NAME,
+          originalId: rec.recordId,
+          capturedAt: ts || Date.now(),
+          payload: { record: rec },
+        };
+        emitted += 1;
+      }
+      if (reachedWatermark || !pageHasNew || orders.length < pageSize) break;
+      pageIndex += 1;
+    }
+  }
+
+  normalize(raw) {
+    if (!raw || !raw.payload || !raw.payload.record) {
+      throw new Error("TongchengAdapter.normalize: raw.payload.record missing");
+    }
+    return normalizeTravelRecord(raw.payload.record, {
+      adapterName: NAME,
+      adapterVersion: VERSION,
+    });
+  }
+}
+
+function parseRecords(text) {
+  let raw;
+  try {
+    raw = JSON.parse(text);
+  } catch (_e) {
+    // Try JSONL
+    raw = text
+      .split(/\r?\n/)
+      .filter((l) => l.trim().startsWith("{"))
+      .map((l) => JSON.parse(l));
+  }
+  const orders = Array.isArray(raw) ? raw : raw.orders || [];
+  return orders.map((o) => orderToRecord(o)).filter(Boolean);
+}
+
+/**
+ * Map one Tongcheng order object → vendor-neutral TravelRecord. Field names are
+ * best-effort across H5 versions (camelCase + snake_case + Chinese fallbacks).
+ */
+function orderToRecord(o, opts = {}) {
+  if (!o || typeof o !== "object") return null;
+  const recordId =
+    o.orderId || o.orderSerialId || o.serialId || o.id || o.order_no || o.orderNo;
+  if (!recordId) return null;
+  const type = (
+    o.type ||
+    o.orderType ||
+    o.projectType ||
+    o.projectTag ||
+    o.bizType ||
+    o.businessType ||
+    ""
+  )
+    .toString()
+    .toLowerCase();
+  const vehicleType = TYPE_MAP[type] || "trip";
+
+  const priceRaw =
+    o.price != null
+      ? o.price
+      : o.amount != null
+        ? o.amount
+        : o.orderAmount != null
+          ? o.orderAmount
+          : o.totalAmount != null
+            ? o.totalAmount
+            : o.payAmount != null
+              ? o.payAmount
+              : o.totalPrice != null
+                ? o.totalPrice
+                : null;
+
+  return {
+    vendorId: "tongcheng",
+    recordId: String(recordId),
+    vehicleType,
+    from:
+      o.fromCity || o.from_city || o.depCity || o.departureCity
+        ? { city: o.fromCity || o.from_city || o.depCity || o.departureCity }
+        : null,
+    to:
+      o.toCity || o.to_city || o.arrCity || o.arrivalCity || o.hotelCity || o.sceneryName
+        ? { city: o.toCity || o.to_city || o.arrCity || o.arrivalCity || o.hotelCity || o.sceneryName }
+        : null,
+    departureMs: numberOrParse(
+      o.departureTime || o.dep_time || o.departureDate || o.useDate || o.checkIn || o.check_in || o.startDate,
+    ),
+    arrivalMs: numberOrParse(
+      o.arrivalTime || o.arr_time || o.arrivalDate || o.checkOut || o.check_out || o.endDate,
+    ),
+    carrier:
+      o.carrier || o.airline || o.airlineName || o.hotelName || o.hotel_name || o.sceneryName || o.title || "同程",
+    vehicleNumber: o.flightNumber || o.flight_no || o.trainNumber || o.train_no || o.trainNo,
+    totalCost:
+      priceRaw != null
+        ? { value: parseFloat(priceRaw), currency: o.currency || "CNY" }
+        : null,
+    traveler:
+      o.passengerName || o.passenger || o.guestName || o.guest_name || o.linkName || o.contactName,
+    confirmationCode: o.confirmationCode || o.pnr || o.confirmation_no || o.serialId,
+    bookedAt: numberOrParse(o.bookedAt || o.order_time || o.orderDate || o.createDate || o.createTime),
+    extras: {
+      type,
+      ...(o.nights != null ? { nights: o.nights } : {}),
+      ...(opts.capturedVia ? { capturedVia: opts.capturedVia } : {}),
+    },
+  };
+}
+
+/**
+ * Pull the order array out of a Tongcheng order-centre response. Tongcheng
+ * nests the list under different keys across H5 versions; the injected fetchFn
+ * may also pre-flatten to `{ orders }`. Tolerant of all common shapes.
+ */
+function extractOrders(resp) {
+  if (!resp || typeof resp !== "object") return [];
+  if (Array.isArray(resp.orders)) return resp.orders;
+  if (Array.isArray(resp.orderList)) return resp.orderList;
+  if (Array.isArray(resp.list)) return resp.list;
+  const data = resp.data && typeof resp.data === "object" ? resp.data : null;
+  if (data) {
+    if (Array.isArray(data.orders)) return data.orders;
+    if (Array.isArray(data.orderList)) return data.orderList;
+    if (Array.isArray(data.list)) return data.list;
+    if (Array.isArray(data.records)) return data.records;
+  }
+  return [];
+}
+
+function numberOrParse(v) {
+  if (Number.isFinite(v)) return v;
+  if (typeof v === "string") {
+    if (/^\d+$/.test(v) && v.length >= 10) return parseInt(v, 10);
+    return parseChineseDateTime(v);
+  }
+  return null;
+}
+
+async function defaultFetch(_opts) {
+  // Pure-Node has no HTTP layer; the host (Android cc → OkHttp; desktop hub →
+  // Electron WebView net) injects a real fetchFn. A missing fetchFn is a wiring
+  // bug, not a runtime data condition, so it throws loudly (mirrors travel-ctrip).
+  throw new Error("travel-tongcheng: no fetchFn configured for cookie-api mode");
+}
+
+module.exports = {
+  TongchengAdapter,
+  parseRecords,
+  orderToRecord,
+  extractOrders,
+  TYPE_MAP,
+  NAME,
+  VERSION,
+};

package/lib/adapters/video-iqiyi/index.js

@@ -0,0 +1,75 @@
+/**
+ * §13+ — 爱奇艺 (iQiyi, com.qiyi.video) adapter. §12.1 Phase 13+ ROI ⭐⭐
+ * "观看历史". Thin wrapper over _video-base.
+ *
+ * iQiyi exposes the user's watch history + favourites (追剧) via iqiyi.com APIs;
+ * this adapter supplies the endpoints + field mapping, the base handles snapshot
+ * + cookie-api orchestration + normalize (MEDIA / LIKE event + MEDIA item).
+ * Endpoints best-effort + overridable (not field-verified — FAMILY-23 playbook).
+ */
+
+"use strict";
+
+const { createVideoAdapter, parseTime, SNAPSHOT_SCHEMA_VERSION } = require("../_video-base");
+
+const NAME = "video-iqiyi";
+const VERSION = "0.1.0";
+
+const WATCH_URL = "https://l.rcd.iqiyi.com/apis/rcd/myRC";
+const FAVOURITE_URL = "https://collect.if.iqiyi.com/japi/collect/list";
+
+// iQiyi channel/category code → label (best-effort).
+const CHANNEL_MAP = {
+  1: "movie",
+  2: "tv",
+  3: "variety",
+  4: "anime",
+  6: "documentary",
+};
+
+function mapCategory(it) {
+  const c = it.channelId != null ? it.channelId : it.chnId;
+  if (c != null && CHANNEL_MAP[c]) return CHANNEL_MAP[c];
+  return it.channelName || it.categoryName || it.category || null;
+}
+
+function extractItems(resp) {
+  if (!resp || typeof resp !== "object") return [];
+  if (Array.isArray(resp.data)) return resp.data;
+  if (Array.isArray(resp.list)) return resp.list;
+  const d = resp.data;
+  if (d && typeof d === "object") {
+    if (Array.isArray(d.list)) return d.list;
+    if (Array.isArray(d.records)) return d.records;
+    if (Array.isArray(d.rc)) return d.rc;
+  }
+  return [];
+}
+
+function mapItem(it) {
+  if (!it || typeof it !== "object") return null;
+  const videoId = it.tvId || it.tvid || it.albumId || it.qipuId || it.id;
+  if (!videoId) return null;
+  return {
+    videoId: String(videoId),
+    title: it.albumName || it.videoName || it.title || it.name || "(未知视频)",
+    category: mapCategory(it),
+    episode: it.videoName && it.albumName && it.videoName !== it.albumName ? it.videoName : it.order ? `第${it.order}集` : null,
+    channel: it.channelName || null,
+    durationSec: Number.isFinite(it.videoDuration) ? it.videoDuration : Number.isFinite(it.duration) ? it.duration : null,
+    url: it.pageUrl || it.url || (it.tvId ? `https://www.iqiyi.com/v_${it.tvId}.html` : null),
+    occurredAt: parseTime(it.addtime || it.playTime || it.updateTime || it.timestamp),
+  };
+}
+
+const IqiyiVideoAdapter = createVideoAdapter({
+  NAME,
+  VERSION,
+  platform: "iqiyi",
+  watchUrl: WATCH_URL,
+  favouriteUrl: FAVOURITE_URL,
+  extractItems,
+  mapItem,
+});
+
+module.exports = { IqiyiVideoAdapter, extractItems, mapItem, CHANNEL_MAP, NAME, VERSION, SNAPSHOT_SCHEMA_VERSION };

package/lib/adapters/video-tencent/index.js

@@ -0,0 +1,78 @@
+/**
+ * §13+ — 腾讯视频 (Tencent Video, com.tencent.qqlive) adapter. §12.1 Phase 13+
+ * ROI ⭐⭐ "观看历史". Thin wrapper over _video-base.
+ *
+ * Tencent Video exposes the user's watch history + 追剧/收藏 via v.qq.com APIs;
+ * this adapter supplies the endpoints + field mapping, the base handles snapshot
+ * + cookie-api orchestration + normalize. Endpoints best-effort + overridable
+ * (not field-verified — FAMILY-23 playbook).
+ */
+
+"use strict";
+
+const { createVideoAdapter, parseTime, SNAPSHOT_SCHEMA_VERSION } = require("../_video-base");
+
+const NAME = "video-tencent";
+const VERSION = "0.1.0";
+
+const WATCH_URL = "https://pbaccess.video.qq.com/trpc.v...history.HistoryServer/GetHistory";
+const FAVOURITE_URL = "https://pbaccess.video.qq.com/trpc.v...favorite.FavoriteServer/GetFavorite";
+
+const TYPE_MAP = {
+  1: "tv",
+  2: "movie",
+  3: "variety",
+  4: "anime",
+  10: "documentary",
+  movie: "movie",
+  tv: "tv",
+  variety: "variety",
+  anime: "anime",
+};
+
+function mapCategory(it) {
+  const raw = it.cTypeId != null ? it.cTypeId : it.typeId != null ? it.typeId : it.category;
+  const key = String(raw == null ? "" : raw).toLowerCase();
+  return TYPE_MAP[key] || TYPE_MAP[raw] || it.categoryName || null;
+}
+
+function extractItems(resp) {
+  if (!resp || typeof resp !== "object") return [];
+  if (Array.isArray(resp.list)) return resp.list;
+  if (Array.isArray(resp.data)) return resp.data;
+  const d = resp.data;
+  if (d && typeof d === "object") {
+    if (Array.isArray(d.list)) return d.list;
+    if (Array.isArray(d.records)) return d.records;
+    if (Array.isArray(d.videoList)) return d.videoList;
+  }
+  return [];
+}
+
+function mapItem(it) {
+  if (!it || typeof it !== "object") return null;
+  const videoId = it.cid || it.vid || it.lid || it.id;
+  if (!videoId) return null;
+  return {
+    videoId: String(videoId),
+    title: it.cTitle || it.title || it.videoTitle || it.name || "(未知视频)",
+    category: mapCategory(it),
+    episode: it.episode || it.vTitle || (it.episodeNum ? `第${it.episodeNum}集` : null),
+    channel: it.channelName || null,
+    durationSec: Number.isFinite(it.duration) ? it.duration : Number.isFinite(it.totalTime) ? it.totalTime : null,
+    url: it.url || (it.cid ? `https://v.qq.com/x/cover/${it.cid}.html` : null),
+    occurredAt: parseTime(it.viewTime || it.updateTime || it.markTime || it.time),
+  };
+}
+
+const TencentVideoAdapter = createVideoAdapter({
+  NAME,
+  VERSION,
+  platform: "tencent-video",
+  watchUrl: WATCH_URL,
+  favouriteUrl: FAVOURITE_URL,
+  extractItems,
+  mapItem,
+});
+
+module.exports = { TencentVideoAdapter, extractItems, mapItem, TYPE_MAP, NAME, VERSION, SNAPSHOT_SCHEMA_VERSION };

package/lib/adapters/video-xigua/index.js

@@ -0,0 +1,68 @@
+/**
+ * §13+ — 西瓜视频 (Xigua / Ixigua, com.ss.android.article.video) adapter.
+ * §12.1 Phase 13+ ROI ⭐⭐ "观看历史". Thin wrapper over _video-base.
+ *
+ * 西瓜视频 (ByteDance) exposes the user's watch history + favourites via
+ * ixigua.com APIs; this adapter supplies the endpoints + field mapping, the base
+ * handles snapshot + cookie-api orchestration + normalize (MEDIA / LIKE event +
+ * MEDIA item). Endpoints best-effort + overridable (some need a ByteDance signed
+ * token via opts.signProvider — not field-verified, FAMILY-23 playbook).
+ */
+
+"use strict";
+
+const { createVideoAdapter, parseTime, SNAPSHOT_SCHEMA_VERSION } = require("../_video-base");
+
+const NAME = "video-xigua";
+const VERSION = "0.1.0";
+
+const WATCH_URL = "https://api.ixigua.com/api/history/list";
+const FAVOURITE_URL = "https://api.ixigua.com/api/favorite/list";
+
+function extractItems(resp) {
+  if (!resp || typeof resp !== "object") return [];
+  if (Array.isArray(resp.data)) return resp.data;
+  if (Array.isArray(resp.list)) return resp.list;
+  const d = resp.data;
+  if (d && typeof d === "object") {
+    if (Array.isArray(d.list)) return d.list;
+    if (Array.isArray(d.records)) return d.records;
+    if (Array.isArray(d.history)) return d.history;
+    if (Array.isArray(d.favorites)) return d.favorites;
+  }
+  return [];
+}
+
+function mapItem(it) {
+  if (!it || typeof it !== "object") return null;
+  // ByteDance items nest the video under article/item_info on some endpoints.
+  const v = it.article || it.item_info || it.video || it;
+  const videoId = v.group_id || v.groupId || v.item_id || v.gid || v.vid || v.id || it.group_id || it.id;
+  if (!videoId) return null;
+  return {
+    videoId: String(videoId),
+    title: v.title || v.video_title || v.name || it.title || "(未知视频)",
+    category: v.category || v.category_name || v.channel || null,
+    episode: null,
+    channel: v.user_name || v.author_name || v.source || null,
+    durationSec: Number.isFinite(v.video_duration)
+      ? v.video_duration
+      : Number.isFinite(v.duration)
+        ? v.duration
+        : null,
+    url: v.share_url || v.url || (videoId ? `https://www.ixigua.com/${videoId}` : null),
+    occurredAt: parseTime(it.behot_time || it.action_time || it.create_time || v.behot_time || v.publish_time),
+  };
+}
+
+const XiguaVideoAdapter = createVideoAdapter({
+  NAME,
+  VERSION,
+  platform: "xigua",
+  watchUrl: WATCH_URL,
+  favouriteUrl: FAVOURITE_URL,
+  extractItems,
+  mapItem,
+});
+
+module.exports = { XiguaVideoAdapter, extractItems, mapItem, NAME, VERSION, SNAPSHOT_SCHEMA_VERSION };

package/lib/adapters/wework-pc/index.js

@@ -0,0 +1,31 @@
+"use strict";
+
+/**
+ * 企业微信 (WeChat Work / WeCom) 电脑版 — honest best-effort local IM DB reader
+ * (qq-pc / dingtalk-pc / feishu-pc 模式).
+ *
+ * ⚠️ v0.1: 企业微信桌面本地库（C:\\Users\\<user>\\Documents\\WXWork\\...）为私有
+ * 结构、通常加密（同微信 SQLCipher 系）、随版本变化。本 adapter 做到可靠开库 +
+ * 发现消息表 + 防御探测列 + 保留原始行 + 响亮诊断；文本解析尽力而为，真机上按需
+ * 扩展 colCandidates。建议先把库解密为明文（或采集时附带 --key）再指向它。
+ */
+
+const { createLocalImPcAdapter } = require("../_local-im-pc-adapter");
+
+const WeWorkPcAdapter = createLocalImPcAdapter({
+  name: "wework-pc",
+  platform: "wework",
+  version: "0.1.0",
+  tablePattern: /msg|message|chat|conversation|im_|session/i,
+  colCandidates: {
+    // 企业微信常见列猜测（真机微调）
+    time: ["createTime", "create_time", "msgCreateTime", "sendTime", "send_time", "timestamp"],
+    sender: ["sender", "senderId", "fromUser", "from", "talker", "vid"],
+    peer: ["conversationId", "roomId", "chatId", "talker", "toUser", "conversation"],
+    content: ["content", "text", "msgContent", "message", "digest", "summary"],
+  },
+  needHint:
+    "wework-pc: 需提供企业微信桌面本地库路径（WXWork 目录下，私有/通常加密，建议先解密为明文或提供 key）",
+});
+
+module.exports = { WeWorkPcAdapter, NAME: "wework-pc", VERSION: "0.1.0" };