chainlesschain 0.162.20 → 0.162.26

package/src/gateways/ws/personal-data-hub-protocol.js

@@ -392,6 +392,90 @@ export const PERSONAL_DATA_HUB_HANDLERS = {
   "personal-data-hub.list-wechat-accounts": async () =>
     withHub((hub) => hub.listWechatAccounts()),
 
+  // ─── Phase 1c — Bilibili C 路径 one-shot sync ─────────────────────────
+  //
+  // Pulls cookies from the user's Android Bilibili App via ADB, fetches 4
+  // endpoints, ingests as a snapshot. Returns the standard
+  // `{ok, report?, reason?, message?}` shape — see hub.bilibiliAdbSync for
+  // the full reason taxonomy. UI maps reasons to banner strings.
+  "personal-data-hub.bilibili-adb-sync": async (msg) =>
+    withHub((hub) =>
+      hub.bilibiliAdbSync({
+        limits: msg && msg.limits,
+        stagingDir: msg && msg.stagingDir,
+        displayName: msg && msg.displayName,
+      }),
+    ),
+
+  // Phase 1e — dry-run env probe (cookies path only, no API calls / vault writes)
+  "personal-data-hub.bilibili-adb-doctor": async () =>
+    withHub((hub) => hub.bilibiliAdbDoctor()),
+
+  // Phase 2a — Douyin C 路径 one-shot sync (db extraction)
+  "personal-data-hub.douyin-adb-sync": async (msg) =>
+    withHub((hub) =>
+      hub.douyinAdbSync({
+        uid: msg && msg.uid,
+        limits: msg && msg.limits,
+        stagingDir: msg && msg.stagingDir,
+        displayName: msg && msg.displayName,
+      }),
+    ),
+
+  // Phase 3a — Weibo C 路径 one-shot sync (m.weibo.cn cookies + 4 endpoints)
+  "personal-data-hub.weibo-adb-sync": async (msg) =>
+    withHub((hub) =>
+      hub.weiboAdbSync({
+        limits: msg && msg.limits,
+        stagingDir: msg && msg.stagingDir,
+        displayName: msg && msg.displayName,
+      }),
+    ),
+
+  // Phase 3c — Xhs C 路径 one-shot sync (xiaohongshu.com cookies + 4 endpoints X-S signed)
+  "personal-data-hub.xhs-adb-sync": async (msg) =>
+    withHub((hub) =>
+      hub.xhsAdbSync({
+        limits: msg && msg.limits,
+        stagingDir: msg && msg.stagingDir,
+        displayName: msg && msg.displayName,
+      }),
+    ),
+
+  // Phase 6c — Toutiao C 路径 one-shot sync (www.toutiao.com cookies +
+  // passport profile + 3 _signature endpoints). CLI/web context with no
+  // desktop bridge: 3 signed endpoints short-circuit (no HTTP). Desktop
+  // wiring uses ToutiaoSignBridge → ~100% hit.
+  "personal-data-hub.toutiao-adb-sync": async (msg) =>
+    withHub((hub) =>
+      hub.toutiaoAdbSync({
+        limits: msg && msg.limits,
+        stagingDir: msg && msg.stagingDir,
+        displayName: msg && msg.displayName,
+      }),
+    ),
+
+  // Phase 6d — Kuaishou C 路径 one-shot sync (www.kuaishou.com cookies +
+  // profile from api_ph payload + 3 GraphQL endpoints with __NS_sig3 +
+  // kpf/kpn). CLI/web context: signed endpoints short-circuit (no HTTP).
+  // Desktop wiring uses KuaishouSignBridge → ~100% hit.
+  "personal-data-hub.kuaishou-adb-sync": async (msg) =>
+    withHub((hub) =>
+      hub.kuaishouAdbSync({
+        limits: msg && msg.limits,
+        stagingDir: msg && msg.stagingDir,
+        displayName: msg && msg.displayName,
+      }),
+    ),
+
+  // Phase 6e — Bridge dry-run doctor. Spins up Xhs / Toutiao / Kuaishou
+  // sign bridges with empty cookie, probes for candidate signing globals,
+  // times each phase. No phone needed. Detects SDK rotation BEFORE the
+  // user starts a real sync. Desktop-only — CLI/web-shell-no-desktop
+  // returns MODULE_LOAD_FAILED.
+  "personal-data-hub.bridge-doctor": async () =>
+    withHub((hub) => hub.bridgeDoctor()),
+
   // ─── Phase 8 — EntityResolver review / merge / unmerge ───────────────
 
   "personal-data-hub.review-queue-list": async (msg) =>

package/src/lib/host-adb-bridge.js

@@ -381,7 +381,71 @@ async function readSnapshot(params, opts) {
   return stdout;
 }
 
+/**
+ * Phase B0 — plugin point for platform-specific ADB methods.
+ *
+ * `opts.extensions` is an optional `{ [methodName]: handler }` map. Each
+ * handler is called as `handler(params, ctx)` where `ctx` exposes the
+ * shared ADB primitives so platform extensions don't re-implement
+ * device-picking or row-parsing:
+ *
+ *   ctx = {
+ *     adb,                    // (args, opts) => Promise<stdout>
+ *     pickDevice,             // (opts) => Promise<serial>
+ *     parseContentQueryRows,  // (stdout) => Array<{key:value}>
+ *   }
+ *
+ * Resolution order in `invoke(method, params)`:
+ *   1. Built-in method (the switch below)
+ *   2. Extension method from opts.extensions
+ *   3. Throw HostAdbBridgeUnavailableError
+ *
+ * Built-ins always win — extensions cannot shadow them. This guarantees
+ * the multipath plan's Phase 1+ per-platform extensions can't break the
+ * already-shipping system-data-android consumer.
+ *
+ * Example (Phase 1 will land for real):
+ *   const bridge = createHostAdbBridge({
+ *     extensions: {
+ *       "douyin.snapshot": async (params, { adb, pickDevice }) => {
+ *         const serial = await pickDevice();
+ *         const uid = params.uid;
+ *         const out = await adb(
+ *           ["shell", "su", "-c", `base64 /data/data/com.ss.android.ugc.aweme/databases/${uid}_im.db`],
+ *           { serial, timeoutMs: 60_000 },
+ *         );
+ *         return { snapshotBase64: out };
+ *       },
+ *     },
+ *   });
+ *   await bridge.invoke("douyin.snapshot", { uid: "1234567890" });
+ */
+const BUILTIN_METHODS = new Set([
+  "contacts.query",
+  "app.list",
+  "sms.query",
+  "call.query",
+  "media.list",
+  "snapshot.list",
+  "snapshot.read",
+]);
+
 export function createHostAdbBridge(opts = {}) {
+  const extensions = opts.extensions || {};
+  // Defense: warn (but allow) when an extension tries to shadow a
+  // built-in. Built-ins always win in dispatch — Phase B0 keeps this
+  // a soft warning so it surfaces in tests; we can upgrade to a hard
+  // throw in Phase 1 if any extension author actually attempts it.
+  for (const k of Object.keys(extensions)) {
+    if (BUILTIN_METHODS.has(k)) {
+      // eslint-disable-next-line no-console
+      console.warn(
+        `host-adb-bridge: extension "${k}" shadows a built-in method and will be ignored at dispatch`,
+      );
+    }
+  }
+  const ctx = { adb, pickDevice, parseContentQueryRows };
+
   return {
     /**
      * SystemDataAndroidAdapter._bridgeAvailable() reads this; must be
@@ -393,6 +457,13 @@ export function createHostAdbBridge(opts = {}) {
     caps() {
       return { available: true };
     },
+    /**
+     * Diagnostic only — reflects extension method names registered for
+     * this bridge instance. Useful for `cc doctor`-style introspection.
+     */
+    extensionMethods() {
+      return Object.keys(extensions).filter((k) => !BUILTIN_METHODS.has(k));
+    },
     async invoke(method, params = {}) {
       switch (method) {
         case "contacts.query":
@@ -409,10 +480,15 @@ export function createHostAdbBridge(opts = {}) {
           return await listSnapshots(params, opts);
         case "snapshot.read":
           return await readSnapshot(params, opts);
-        default:
+        default: {
+          const ext = extensions[method];
+          if (typeof ext === "function") {
+            return await ext(params, ctx);
+          }
           throw new HostAdbBridgeUnavailableError(
             `method "${method}" not implemented by host-adb-bridge`,
           );
+        }
       }
     },
   };