@chainlesschain/personal-data-hub 0.2.2 → 0.2.3

package/lib/adapters/shopping-jd/index.js

@@ -1,59 +1,201 @@
 /**
- * Phase 7.3 — JD (京东) adapter.
+ * §2.4b 购物双联 v0.2 — JD (京东) adapter, dual-mode (snapshot + cookie).
  *
- * Parallels Taobao but with JD's order endpoint + JSON shape:
- *   url: https://order.jd.com/center/list.action
- *   fields: orderId, orderTotalPrice, orderStartTime, orderStatusText,
- *           venderName, productList (with name/quantity/price)
+ * Mirror of social-weibo / travel-baidu-map two-mode pattern:
+ *
+ *   1. snapshot mode (opts.inputPath): in-APK Android cc reads a snapshot
+ *      JSON produced by JdLocalCollector (WebView cookie scrape +
+ *      `order.jd.com/center/list.action` OkHttp fetch). Desktop-independent.
+ *      Adapter stateless — account.pin OPTIONAL at construction.
+ *
+ *   2. cookie mode (legacy Phase 7.3): existing web-api path — `cookies` +
+ *      `fetchFn` injection seam fetches `order.jd.com/center/list.action`
+ *      directly. account.pin REQUIRED in this mode (checked at sync, not
+ *      construction).
+ *
+ * Snapshot schema (mirrors JdLocalCollector.SNAPSHOT_SCHEMA_VERSION):
+ *
+ *   {
+ *     "schemaVersion": 1,
+ *     "snapshottedAt": <epoch-ms>,
+ *     "vendor": "jd",
+ *     "account": { "pin": "...", "displayName": "..." },
+ *     "events": [
+ *       { "kind": "order", "id": "order-<jdId>", "capturedAt": <ms>,
+ *         "orderId": "...", "merchantName": "...",
+ *         "items": [{ "name": ..., "quantity": ..., "unitPrice": ..., "sku": ... }],
+ *         "placedAt": ..., "paidAt": ..., "status": "placed|shipped|delivered|cancelled|refunded",
+ *         "totalAmount": { "value": ..., "currency": "CNY" },
+ *         "recipient": "...", "shippingAddress": "...", "trackingNumber": "..." }
+ *     ]
+ *   }
+ *
+ * Future v0.3: SAF-exported HTML parsing (`Save As Webpage` from `order.jd.com`
+ * 端) — currently snapshot mode accepts JSON only; non-JSON inputPath throws.
  */
 
 "use strict";
 
+const fs = require("node:fs");
 const { normalizeOrderRecord, CookieAuth } = require("../shopping-base");
 
 const NAME = "shopping-jd";
-const VERSION = "0.5.0";
+const VERSION = "0.6.0";
+const SNAPSHOT_SCHEMA_VERSION = 1;
+
+const KIND_ORDER = "order";
+const VALID_SNAPSHOT_KINDS = Object.freeze([KIND_ORDER]);
 
 const JD_ORDERS_URL = "https://order.jd.com/center/list.action";
 
 class JdAdapter {
   constructor(opts = {}) {
-    if (!opts.account || !opts.account.pin) {
-      throw new Error("JdAdapter: opts.account.pin required (JD user pin)");
-    }
-    this.account = opts.account;
-    this._cookieAuth = new CookieAuth({
-      platform: "jd",
-      cookies: opts.account.cookies || "",
-    });
+    // §2.4b v0.2: account.pin OPTIONAL — snapshot mode is stateless. Cookie
+    // mode requires it; checked at sync time, not construction.
+    this.account = opts.account || null;
+    this._cookieAuth = opts.account
+      ? new CookieAuth({ platform: "jd", cookies: opts.account.cookies || "" })
+      : null;
     this._fetchFn = typeof opts.fetchFn === "function" ? opts.fetchFn : defaultFetch;
 
     this.name = NAME;
     this.version = VERSION;
-    this.capabilities = ["sync:cookie-api", "parse:jd-orders"];
+    this.capabilities = ["sync:snapshot", "sync:cookie-api", "parse:jd-orders"];
     this.extractMode = "web-api";
     this.rateLimits = { perMinute: 6, perDay: 200 };
     this.dataDisclosure = {
       fields: ["jd:orderId / venderName / productList / orderTotalPrice / address"],
       sensitivity: "high",
       legalGate: false,
+      defaultInclude: { order: true },
     };
+
+    // _deps injection seam — vi.mock fs doesn't intercept inlined CJS require
+    // (see .claude/rules/testing.md).
+    this._deps = { fs };
   }
 
-  async authenticate() {
-    const ok = await this._cookieAuth.validate();
-    if (!ok) return { ok: false, reason: "INVALID_COOKIE", error: "cookies missing" };
-    return { ok: true, account: this.account.pin };
+  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" };
+    }
+    if (this._cookieAuth) {
+      const ok = await this._cookieAuth.validate();
+      if (!ok) return { ok: false, reason: "INVALID_COOKIE", error: "cookies missing" };
+      if (!this.account || !this.account.pin) {
+        return { ok: false, reason: "NO_ACCOUNT_PIN", message: "cookie mode requires account.pin" };
+      }
+      return { ok: true, account: this.account.pin, mode: "cookie" };
+    }
+    return {
+      ok: false,
+      reason: "NO_INPUT",
+      message: "JdAdapter.authenticate: needs opts.inputPath (snapshot mode) OR opts.account.cookies (cookie mode)",
+    };
   }
 
   async healthCheck() {
-    const r = await this.authenticate();
-    return r.ok
-      ? { ok: true, lastChecked: Date.now() }
-      : { ok: false, reason: r.reason, error: r.error };
+    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 = {}) {
+    if (typeof opts.inputPath === "string" && opts.inputPath.length > 0) {
+      yield* this._syncViaSnapshot(opts);
+      return;
+    }
+    if (this._cookieAuth) {
+      yield* this._syncViaCookie(opts);
+      return;
+    }
+    throw new Error(
+      "JdAdapter.sync: needs opts.inputPath (snapshot mode, Android in-APK cc) OR opts.account.cookies (cookie mode)",
+    );
+  }
+
+  async *_syncViaSnapshot(opts) {
+    const raw = this._deps.fs.readFileSync(opts.inputPath, "utf-8");
+    // v0.2 explicit JSON-only. HTML / CSV parsing (SAF-exported webpage from
+    // order.jd.com) is future v0.3 work.
+    let snapshot;
+    try {
+      snapshot = JSON.parse(raw);
+    } catch (err) {
+      throw new Error(
+        `shopping-jd.sync: snapshot must be JSON (v0.3 will add HTML parsing). Got parse error: ${err.message}`,
+      );
+    }
+    if (
+      !snapshot ||
+      typeof snapshot !== "object" ||
+      snapshot.schemaVersion !== SNAPSHOT_SCHEMA_VERSION
+    ) {
+      throw new Error(
+        `shopping-jd.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) ||
+        parseTime(ev.placedAt) ||
+        parseTime(ev.paidAt) ||
+        fallbackCapturedAt;
+      const id =
+        (typeof ev.id === "string" && ev.id.length > 0 && ev.id) ||
+        ev.orderId ||
+        null;
+
+      yield {
+        adapter: NAME,
+        kind,
+        originalId: stableOriginalId(kind, id),
+        capturedAt,
+        payload: { ...ev, account },
+      };
+      emitted += 1;
+    }
+  }
+
+  async *_syncViaCookie(opts = {}) {
+    if (!this.account || !this.account.pin) {
+      throw new Error(
+        "JdAdapter._syncViaCookie: account.pin required (set via new JdAdapter({ account: { pin } }))",
+      );
+    }
     if (!(await this._cookieAuth.validate())) return;
     const sinceMs = opts.sinceWatermark != null
       ? parseInt(String(opts.sinceWatermark), 10) || 0
@@ -85,12 +227,69 @@ class JdAdapter {
   }
 
   normalize(raw) {
-    return normalizeOrderRecord(raw.payload.record, {
+    if (!raw || !raw.payload) {
+      throw new Error("JdAdapter.normalize: payload missing");
+    }
+    // Cookie-mode payload carries `record`; snapshot-mode payload carries fields
+    // directly on the event.
+    if (raw.payload.record) {
+      return normalizeOrderRecord(raw.payload.record, {
+        adapterName: NAME, adapterVersion: VERSION,
+      });
+    }
+    // Snapshot-mode: rebuild OrderRecord from flat snapshot event.
+    const rec = snapshotEventToRecord(raw.payload);
+    return normalizeOrderRecord(rec, {
       adapterName: NAME, adapterVersion: VERSION,
     });
   }
 }
 
+function stableOriginalId(kind, id) {
+  const stringified =
+    (typeof id === "string" && id.length > 0 && id) ||
+    (typeof id === "number" && Number.isFinite(id) && String(id)) ||
+    null;
+  const safe =
+    stringified ||
+    `unknown-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+  return `jd:${kind}:${safe}`;
+}
+
+function snapshotEventToRecord(ev) {
+  const items = [];
+  const rawItems = Array.isArray(ev.items) ? ev.items : [];
+  for (const it of rawItems) {
+    if (!it) continue;
+    items.push({
+      name: it.name || it.productName || it.skuName,
+      quantity: parseInt(it.quantity || 1, 10),
+      unitPrice: parseFloat(it.unitPrice || 0),
+      sku: it.sku || null,
+    });
+  }
+  return {
+    vendorId: "jd",
+    orderId: String(ev.orderId || ev.id || "unknown"),
+    placedAt: parseTime(ev.placedAt),
+    paidAt: parseTime(ev.paidAt),
+    status: ev.status || "placed",
+    merchantName: ev.merchantName || "京东自营",
+    totalAmount:
+      ev.totalAmount && typeof ev.totalAmount === "object"
+        ? {
+            value: parseFloat(ev.totalAmount.value || 0),
+            currency: ev.totalAmount.currency || "CNY",
+          }
+        : { value: 0, currency: "CNY" },
+    items,
+    recipient: ev.recipient || null,
+    shippingAddress: ev.shippingAddress || null,
+    trackingNumber: ev.trackingNumber || null,
+    extras: { capturedBy: "snapshot" },
+  };
+}
+
 function orderToRecord(o) {
   if (!o || typeof o !== "object") return null;
   const orderId = o.orderId || o.id;
@@ -128,6 +327,10 @@ function orderToRecord(o) {
 function parseTime(v) {
   if (Number.isFinite(v)) return v < 1e12 ? v * 1000 : v;
   if (typeof v === "string") {
+    if (/^\d+$/.test(v)) {
+      const n = parseInt(v, 10);
+      return n < 1e12 ? n * 1000 : n;
+    }
     const t = Date.parse(v);
     if (Number.isFinite(t)) return t;
   }
@@ -147,4 +350,4 @@ async function defaultFetch(_opts) {
   throw new Error("JdAdapter: no fetchFn configured");
 }
 
-module.exports = { JdAdapter, orderToRecord, NAME, VERSION };
+module.exports = { JdAdapter, orderToRecord, NAME, VERSION, SNAPSHOT_SCHEMA_VERSION };

package/lib/adapters/shopping-meituan/index.js

@@ -1,65 +1,204 @@
 /**
- * Phase 7.3b — Meituan (美团) adapter.
+ * §2.4b 购物双联 v0.2 — Meituan (美团) adapter, dual-mode (snapshot + cookie).
  *
- * Meituan covers 外卖 (food delivery) + 团购 (group buy) + 酒店 (hotel
- * — though Ctrip is more common). v0 focuses on 外卖 + 团购 since that's
- * where most users have the longest history.
+ * Meituan covers 外卖 (food delivery) + 团购 (group buy) + 酒店 (hotel — though
+ * Ctrip is more common). v0.2 expands the existing cookie-fetch flow with a
+ * snapshot mode for the Android in-APK cc path.
  *
- * Auth: cookie-based, similar to Taobao/JD.
+ *   1. snapshot mode (opts.inputPath): in-APK Android cc reads a snapshot
+ *      JSON produced by MeituanLocalCollector (WebView cookie scrape +
+ *      `h5.meituan.com/order/list` OkHttp fetch — both `waimai` and
+ *      `groupbuy` platforms). Adapter stateless — account.userId OPTIONAL
+ *      at construction.
+ *
+ *   2. cookie mode (legacy Phase 7.3b): existing web-api path — `cookies` +
+ *      `fetchFn` injection seam fetches `h5.meituan.com/order/list` directly.
+ *      account.userId REQUIRED in this mode (checked at sync time).
+ *
+ * Snapshot schema (mirrors MeituanLocalCollector.SNAPSHOT_SCHEMA_VERSION):
+ *
+ *   {
+ *     "schemaVersion": 1,
+ *     "snapshottedAt": <epoch-ms>,
+ *     "vendor": "meituan",
+ *     "account": { "userId": "...", "displayName": "..." },
+ *     "events": [
+ *       { "kind": "order", "id": "order-<mtId>", "capturedAt": <ms>,
+ *         "orderId": "...", "merchantName": "...", "platform": "waimai|groupbuy|hotel",
+ *         "items": [{ "name": ..., "quantity": ..., "unitPrice": ... }],
+ *         "placedAt": ..., "paidAt": ..., "status": "...",
+ *         "totalAmount": { "value": ..., "currency": "CNY" },
+ *         "recipient": "...", "shippingAddress": "..." }
+ *     ]
+ *   }
+ *
+ * Future v0.3: SAF-exported HTML parsing (Save As Webpage from h5.meituan.com)
+ * — currently snapshot mode accepts JSON only; non-JSON inputPath throws.
  */
 
 "use strict";
 
+const fs = require("node:fs");
 const { normalizeOrderRecord, CookieAuth } = require("../shopping-base");
 
 const NAME = "shopping-meituan";
-const VERSION = "0.5.0";
+const VERSION = "0.6.0";
+const SNAPSHOT_SCHEMA_VERSION = 1;
+
+const KIND_ORDER = "order";
+const VALID_SNAPSHOT_KINDS = Object.freeze([KIND_ORDER]);
 
 const MEITUAN_ORDERS_URL = "https://h5.meituan.com/order/list";
 
 class MeituanAdapter {
   constructor(opts = {}) {
-    if (!opts.account || !opts.account.userId) {
-      throw new Error("MeituanAdapter: opts.account.userId required");
-    }
-    this.account = opts.account;
-    this._cookieAuth = new CookieAuth({
-      platform: "meituan",
-      cookies: opts.account.cookies || "",
-    });
+    // §2.4b v0.2: account.userId OPTIONAL — snapshot mode is stateless. Cookie
+    // mode requires it; checked at sync time.
+    this.account = opts.account || null;
+    this._cookieAuth = opts.account
+      ? new CookieAuth({ platform: "meituan", cookies: opts.account.cookies || "" })
+      : null;
     this._fetchFn = typeof opts.fetchFn === "function" ? opts.fetchFn : defaultFetch;
 
     this.name = NAME;
     this.version = VERSION;
-    this.capabilities = ["sync:cookie-api", "parse:meituan-orders"];
+    this.capabilities = ["sync:snapshot", "sync:cookie-api", "parse:meituan-orders"];
     this.extractMode = "web-api";
     this.rateLimits = { perMinute: 8, perDay: 200 };
     this.dataDisclosure = {
       fields: ["meituan:orderId / poiName / dishes / totalPrice / deliveryAddress"],
       sensitivity: "high",
       legalGate: false,
+      defaultInclude: { order: true },
     };
+
+    this._deps = { fs };
   }
 
-  async authenticate() {
-    const ok = await this._cookieAuth.validate();
-    if (!ok) return { ok: false, reason: "INVALID_COOKIE", error: "cookies missing" };
-    return { ok: true, account: this.account.userId };
+  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" };
+    }
+    if (this._cookieAuth) {
+      const ok = await this._cookieAuth.validate();
+      if (!ok) return { ok: false, reason: "INVALID_COOKIE", error: "cookies missing" };
+      if (!this.account || !this.account.userId) {
+        return { ok: false, reason: "NO_ACCOUNT_USER_ID", message: "cookie mode requires account.userId" };
+      }
+      return { ok: true, account: this.account.userId, mode: "cookie" };
+    }
+    return {
+      ok: false,
+      reason: "NO_INPUT",
+      message: "MeituanAdapter.authenticate: needs opts.inputPath (snapshot mode) OR opts.account.cookies (cookie mode)",
+    };
   }
 
   async healthCheck() {
-    const r = await this.authenticate();
-    return r.ok
-      ? { ok: true, lastChecked: Date.now() }
-      : { ok: false, reason: r.reason, error: r.error };
+    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 = {}) {
+    if (typeof opts.inputPath === "string" && opts.inputPath.length > 0) {
+      yield* this._syncViaSnapshot(opts);
+      return;
+    }
+    if (this._cookieAuth) {
+      yield* this._syncViaCookie(opts);
+      return;
+    }
+    throw new Error(
+      "MeituanAdapter.sync: needs opts.inputPath (snapshot mode, Android in-APK cc) OR opts.account.cookies (cookie mode)",
+    );
+  }
+
+  async *_syncViaSnapshot(opts) {
+    const raw = this._deps.fs.readFileSync(opts.inputPath, "utf-8");
+    let snapshot;
+    try {
+      snapshot = JSON.parse(raw);
+    } catch (err) {
+      throw new Error(
+        `shopping-meituan.sync: snapshot must be JSON (v0.3 will add HTML parsing). Got parse error: ${err.message}`,
+      );
+    }
+    if (
+      !snapshot ||
+      typeof snapshot !== "object" ||
+      snapshot.schemaVersion !== SNAPSHOT_SCHEMA_VERSION
+    ) {
+      throw new Error(
+        `shopping-meituan.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) ||
+        parseTime(ev.placedAt) ||
+        parseTime(ev.paidAt) ||
+        fallbackCapturedAt;
+      const id =
+        (typeof ev.id === "string" && ev.id.length > 0 && ev.id) ||
+        ev.orderId ||
+        null;
+
+      yield {
+        adapter: NAME,
+        kind,
+        originalId: stableOriginalId(kind, id),
+        capturedAt,
+        payload: { ...ev, account },
+      };
+      emitted += 1;
+    }
+  }
+
+  async *_syncViaCookie(opts = {}) {
+    if (!this.account || !this.account.userId) {
+      throw new Error(
+        "MeituanAdapter._syncViaCookie: account.userId required (set via new MeituanAdapter({ account: { userId } }))",
+      );
+    }
     if (!(await this._cookieAuth.validate())) return;
     const sinceMs = opts.sinceWatermark != null
       ? parseInt(String(opts.sinceWatermark), 10) || 0
       : (Date.now() - 365 * 24 * 3600_000);
-    const platforms = opts.platforms || ["waimai", "groupbuy"]; // sub-types
+    const platforms = opts.platforms || ["waimai", "groupbuy"];
 
     for (const platform of platforms) {
       let page = 1;
@@ -90,12 +229,65 @@ class MeituanAdapter {
   }
 
   normalize(raw) {
-    return normalizeOrderRecord(raw.payload.record, {
+    if (!raw || !raw.payload) {
+      throw new Error("MeituanAdapter.normalize: payload missing");
+    }
+    if (raw.payload.record) {
+      return normalizeOrderRecord(raw.payload.record, {
+        adapterName: NAME, adapterVersion: VERSION,
+      });
+    }
+    const rec = snapshotEventToRecord(raw.payload);
+    return normalizeOrderRecord(rec, {
       adapterName: NAME, adapterVersion: VERSION,
     });
   }
 }
 
+function stableOriginalId(kind, id) {
+  const stringified =
+    (typeof id === "string" && id.length > 0 && id) ||
+    (typeof id === "number" && Number.isFinite(id) && String(id)) ||
+    null;
+  const safe =
+    stringified ||
+    `unknown-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+  return `meituan:${kind}:${safe}`;
+}
+
+function snapshotEventToRecord(ev) {
+  const items = [];
+  const rawItems = Array.isArray(ev.items) ? ev.items : [];
+  for (const it of rawItems) {
+    if (!it) continue;
+    items.push({
+      name: it.name || it.dishName || it.dealName,
+      quantity: parseInt(it.quantity || 1, 10),
+      unitPrice: parseFloat(it.unitPrice || 0),
+      sku: it.sku || null,
+    });
+  }
+  return {
+    vendorId: "meituan",
+    orderId: String(ev.orderId || ev.id || "unknown"),
+    placedAt: parseTime(ev.placedAt),
+    paidAt: parseTime(ev.paidAt),
+    status: ev.status || "placed",
+    merchantName: ev.merchantName || "美团",
+    totalAmount:
+      ev.totalAmount && typeof ev.totalAmount === "object"
+        ? {
+            value: parseFloat(ev.totalAmount.value || 0),
+            currency: ev.totalAmount.currency || "CNY",
+          }
+        : { value: 0, currency: "CNY" },
+    items,
+    recipient: ev.recipient || null,
+    shippingAddress: ev.shippingAddress || null,
+    extras: { platform: ev.platform || "waimai", capturedBy: "snapshot" },
+  };
+}
+
 function orderToRecord(o, platform = "waimai") {
   if (!o || typeof o !== "object") return null;
   const orderId = o.orderId || o.viewOrderId || o.id;
@@ -132,6 +324,10 @@ function orderToRecord(o, platform = "waimai") {
 function parseTime(v) {
   if (Number.isFinite(v)) return v < 1e12 ? v * 1000 : v;
   if (typeof v === "string") {
+    if (/^\d+$/.test(v)) {
+      const n = parseInt(v, 10);
+      return n < 1e12 ? n * 1000 : n;
+    }
     const t = Date.parse(v);
     if (Number.isFinite(t)) return t;
   }
@@ -151,4 +347,4 @@ async function defaultFetch(_opts) {
   throw new Error("MeituanAdapter: no fetchFn configured");
 }
 
-module.exports = { MeituanAdapter, orderToRecord, NAME, VERSION };
+module.exports = { MeituanAdapter, orderToRecord, NAME, VERSION, SNAPSHOT_SCHEMA_VERSION };