@zenalexa/unicli 0.220.1 → 0.221.1

package/dist/adapters/xiaohongshu/browser-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-state.d.ts","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/browser-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAM5C,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,CAczE;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,YAAY,GAClB,IAAI,CAgBN;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA8BvE"}

package/dist/adapters/xiaohongshu/browser-state.js

@@ -0,0 +1,67 @@
+/**
+ * @owner   Xiaohongshu browser adapters.
+ * @does    Detects login, risk-control, and rendered-feed state in XHS web pages.
+ * @needs   Browser-backed IPage from Uni-CLI runtime.
+ * @feeds   xiaohongshu.search and xiaohongshu.trending.
+ * @breaks  XHS copy or route changes can require updating page-state detection.
+ */
+import { socialAuthError, socialChallengeError, } from "../../social/browser-errors.js";
+export async function readXhsPageState(page) {
+    const raw = await page.evaluate(`
+    (() => ({
+      url: window.location.href,
+      title: document.title || '',
+      text: (document.body?.innerText || '').replace(/\\s+/g, ' ').slice(0, 2000)
+    }))()
+  `);
+    const state = raw;
+    return {
+        url: String(state.url ?? ""),
+        title: String(state.title ?? ""),
+        text: String(state.text ?? ""),
+    };
+}
+export function assertXhsReadableState(command, state) {
+    const haystack = `${state.url}\n${state.title}\n${state.text}`;
+    if (/website-login\/error|安全限制|IP存在风险|风险|风控|安全验证|验证码|人机验证|verify|captcha/i.test(haystack)) {
+        throw socialChallengeError("xiaohongshu", command, `Xiaohongshu is showing a risk-control or verification page: ${state.title || state.url}`);
+    }
+    if (/登录后查看|登录后|请先登录|login/i.test(haystack)) {
+        throw socialAuthError("xiaohongshu", command);
+    }
+}
+export async function assertXhsReadable(page, command) {
+    assertXhsReadableState(command, await readXhsPageState(page));
+}
+export async function fetchXhsFeedItems(page) {
+    const raw = await page.evaluate(`
+    (async () => {
+      const app = document.querySelector('#app')?.__vue_app__;
+      if (!app) throw new Error('Xiaohongshu Vue app not found');
+      const pinia = app.config?.globalProperties?.$pinia;
+      if (!pinia || !pinia._s?.has('feed')) throw new Error('Xiaohongshu feed store not found');
+      const store = pinia._s.get('feed');
+      const captured = [];
+      const originalFetch = window.fetch;
+      window.fetch = async (...args) => {
+        const response = await originalFetch(...args);
+        try {
+          const url = String(args[0]?.url || args[0] || '');
+          if (/homefeed|feed/i.test(url)) {
+            captured.push(await response.clone().json());
+          }
+        } catch {}
+        return response;
+      };
+      try {
+        await store.fetchFeeds();
+      } finally {
+        window.fetch = originalFetch;
+      }
+      const payload = captured.find((item) => item?.data?.items?.length) || captured[0];
+      return payload?.data?.items || [];
+    })()
+  `);
+    return Array.isArray(raw) ? raw : [];
+}
+//# sourceMappingURL=browser-state.js.map

package/dist/adapters/xiaohongshu/browser-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-state.js","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/browser-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,eAAe,EACf,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AAQxC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAW;IAChD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;;;;;;GAM/B,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,GAA4B,CAAC;IAC3C,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;QAC5B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,KAAmB;IAEnB,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;IAC/D,IACE,sEAAsE,CAAC,IAAI,CACzE,QAAQ,CACT,EACD,CAAC;QACD,MAAM,oBAAoB,CACxB,aAAa,EACb,OAAO,EACP,+DAA+D,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,EAAE,CAC1F,CAAC;IACJ,CAAC;IACD,IAAI,uBAAuB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3C,MAAM,eAAe,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAW,EACX,OAAe;IAEf,sBAAsB,CAAC,OAAO,EAAE,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAW;IACjD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2B/B,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACvC,CAAC"}

package/dist/adapters/xiaohongshu/comments.js

@@ -5,6 +5,7 @@
  * the --with-replies flag.
  */
 import { cli, Strategy } from "../../registry.js";
+import { normalizeCommentRows } from "../../social/comments.js";
 import { buildNoteUrl } from "./note-helpers.js";
 function parseCommentLimit(raw, fallback = 20) {
     const n = Number(raw);
@@ -39,7 +40,23 @@ cli({
             description: "Include nested replies",
         },
     ],
-    columns: ["rank", "author", "text", "likes", "time", "is_reply", "reply_to"],
+    columns: [
+        "rank",
+        "platform",
+        "content_id",
+        "comment_id",
+        "parent_id",
+        "depth",
+        "path",
+        "author",
+        "text",
+        "likes",
+        "replies",
+        "created",
+        "time",
+        "is_reply",
+        "reply_to",
+    ],
     func: async (page, kwargs) => {
         const p = page;
         const limit = parseCommentLimit(kwargs.limit);
@@ -95,7 +112,7 @@ cli({
           const likes = parseLikes(item.querySelector('.count'))
           const time = clean(item.querySelector('.date, .time'))
           if (!text) continue
-          results.push({ author, text, likes, time, is_reply: false, reply_to: '' })
+          results.push({ author, text, likes, replies: 0, created: time, time, is_reply: false, reply_to: '' })
           if (withReplies) {
             await expandReplyThreads(p)
             p.querySelectorAll('.reply-container .comment-item-sub, .sub-comment-list .comment-item').forEach(sub => {
@@ -104,7 +121,7 @@ cli({
               const sLikes = parseLikes(sub.querySelector('.count'))
               const sTime = clean(sub.querySelector('.date, .time'))
               if (!sText) return
-              results.push({ author: sAuthor, text: sText, likes: sLikes, time: sTime, is_reply: true, reply_to: author })
+              results.push({ author: sAuthor, text: sText, likes: sLikes, replies: 0, created: sTime, time: sTime, is_reply: true, reply_to: author })
             })
           }
         }
@@ -128,9 +145,15 @@ cli({
                     break;
                 limited.push(c);
             }
-            return limited.map((c, i) => ({ rank: i + 1, ...c }));
+            return normalizeCommentRows(limited, {
+                platform: "xiaohongshu",
+                contentId: raw,
+            }).map((c, i) => ({ rank: i + 1, ...c }));
         }
-        return all.slice(0, limit).map((c, i) => ({ rank: i + 1, ...c }));
+        return normalizeCommentRows(all.slice(0, limit), {
+            platform: "xiaohongshu",
+            contentId: raw,
+        }).map((c, i) => ({ rank: i + 1, ...c }));
     },
 });
 //# sourceMappingURL=comments.js.map

package/dist/adapters/xiaohongshu/comments.js.map

@@ -1 +1 @@
-{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/comments.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,SAAS,iBAAiB,CAAC,GAAY,EAAE,QAAQ,GAAG,EAAE;IACpD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,8DAA8D;IAC3E,MAAM,EAAE,qBAAqB;IAC7B,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,qBAAqB;SACnC;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,uCAAuC;SACrD;QACD;YACE,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,wBAAwB;SACtC;KACF;IACD,OAAO,EAAE;QACP,MAAM;QACN,UAAU;QACV,YAAY;QACZ,YAAY;QACZ,WAAW;QACX,OAAO;QACP,MAAM;QACN,QAAQ;QACR,MAAM;QACN,OAAO;QACP,SAAS;QACT,SAAS;QACT,MAAM;QACN,UAAU;QACV,UAAU;KACX;IACD,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,IAAa,CAAC;QACxB,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAEtC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEhB,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC;;;8BAGL,MAAM,CAAC,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4D5C,CAAC,CAA4B,CAAC;QAE/B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAWD,MAAM,GAAG,GAAkB,IAAI,CAAC,OAAwB,IAAI,EAAE,CAAC;QAE/D,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,OAAO,GAAiB,EAAE,CAAC;YACjC,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;gBACpB,IAAI,CAAC,CAAC,CAAC,QAAQ;oBAAE,QAAQ,EAAE,CAAC;gBAC5B,IAAI,QAAQ,GAAG,KAAK;oBAAE,MAAM;gBAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,OAAO,oBAAoB,CAAC,OAAO,EAAE;gBACnC,QAAQ,EAAE,aAAa;gBACvB,SAAS,EAAE,GAAG;aACf,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE;YAC/C,QAAQ,EAAE,aAAa;YACvB,SAAS,EAAE,GAAG;SACf,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/xiaohongshu/download.js

@@ -5,15 +5,44 @@
  * __INITIAL_STATE__, then downloads them with cookie authentication.
  */
 import { cli, Strategy } from "../../registry.js";
-import { loadCookies, formatCookieHeader } from "../../engine/cookies.js";
+import { loadCookiesWithCDP, formatCookieHeader, } from "../../engine/cookies.js";
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { USER_AGENT } from "../../constants.js";
 import { parseNoteId, buildNoteUrl } from "./note-helpers.js";
 /** Build authenticated headers for Xiaohongshu downloads. */
-function buildCookieHeader() {
-    const cookies = loadCookies("xiaohongshu");
+async function buildCookieHeader() {
+    const cookies = await loadCookiesWithCDP("xiaohongshu", "www.xiaohongshu.com");
     if (cookies)
         return formatCookieHeader(cookies);
     return "";
 }
+function extensionForMedia(type, url) {
+    try {
+        const pathname = new URL(url).pathname;
+        const match = /\.[a-zA-Z0-9]{2,5}$/.exec(pathname);
+        if (match)
+            return match[0].toLowerCase();
+    }
+    catch {
+        return type === "video" ? ".mp4" : ".jpg";
+    }
+    return type === "video" ? ".mp4" : ".jpg";
+}
+async function downloadMedia(url, path, cookieHeader) {
+    const headers = {
+        "User-Agent": USER_AGENT,
+        Referer: "https://www.xiaohongshu.com/",
+    };
+    if (cookieHeader)
+        headers.Cookie = cookieHeader;
+    const response = await fetch(url, { headers });
+    if (!response.ok) {
+        throw new Error(`Xiaohongshu media download failed: HTTP ${response.status}`);
+    }
+    const bytes = Buffer.from(await response.arrayBuffer());
+    await writeFile(path, bytes);
+}
 cli({
     site: "xiaohongshu",
     name: "download",
@@ -34,11 +63,12 @@ cli({
             description: "Output directory",
         },
     ],
-    columns: ["index", "type", "url"],
+    columns: ["index", "type", "path", "url"],
     func: async (page, kwargs) => {
         const p = page;
         const rawInput = String(kwargs["note-id"]);
         const noteId = parseNoteId(rawInput);
+        const outputDir = String(kwargs.output ?? "./xiaohongshu-downloads");
         await p.goto(buildNoteUrl(rawInput));
         await p.wait(3);
         const data = (await p.evaluate(`
@@ -148,13 +178,21 @@ cli({
         if (!data || !data.media || data.media.length === 0) {
             return [{ index: 0, type: "-", url: "No media found" }];
         }
-        // Cookie header available for authenticated downloads when media pipeline is wired
-        void buildCookieHeader();
-        return data.media.map((m, idx) => ({
-            index: idx + 1,
-            type: m.type,
-            url: m.url,
-        }));
+        await mkdir(outputDir, { recursive: true });
+        const cookieHeader = await buildCookieHeader();
+        const rows = [];
+        for (const [idx, media] of data.media.entries()) {
+            const ext = extensionForMedia(media.type, media.url);
+            const path = join(outputDir, `${noteId}-${idx + 1}${ext}`);
+            await downloadMedia(media.url, path, cookieHeader);
+            rows.push({
+                index: idx + 1,
+                type: media.type,
+                path,
+                url: media.url,
+            });
+        }
+        return rows;
     },
 });
 //# sourceMappingURL=download.js.map

package/dist/adapters/xiaohongshu/download.js.map

@@ -1 +1 @@
-{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/download.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE9D,6DAA6D;AAC7D,SAAS,iBAAiB;IACxB,MAAM,OAAO,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IAC3C,IAAI,OAAO;QAAE,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAChD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,oDAAoD;IACjE,MAAM,EAAE,qBAAqB;IAC7B,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,kCAAkC;SAChD;QACD;YACE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,yBAAyB;YAClC,WAAW,EAAE,kBAAkB;SAChC;KACF;IACD,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC;IACjC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,IAAa,CAAC;QACxB,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QAErC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEhB,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC;;;qBAGd,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAoGtB,CAAC,CAGM,CAAC;QAET,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,mFAAmF;QACnF,KAAK,iBAAiB,EAAE,CAAC;QAEzB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAgC,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC;YACxE,KAAK,EAAE,GAAG,GAAG,CAAC;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,EAAE,CAAC,CAAC,GAAG;SACX,CAAC,CAAC,CAAC;IACN,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/download.ts"],"names":[],"mappings":"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"}

package/dist/adapters/xiaohongshu/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0BH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAShD"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+BH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAShD"}

package/dist/adapters/xiaohongshu/search.js

@@ -5,6 +5,8 @@
  * DOM elements.  Uses MutationObserver to wait for content or login wall.
  */
 import { cli, Strategy } from "../../registry.js";
+import { socialAuthError, socialEmptyError, } from "../../social/browser-errors.js";
+import { assertXhsReadable } from "./browser-state.js";
 /**
  * Wait for search results or login wall using MutationObserver (max 5 s).
  */
@@ -47,6 +49,7 @@ cli({
     domain: "www.xiaohongshu.com",
     strategy: Strategy.COOKIE,
     browser: true,
+    browserSession: "user",
     args: [
         {
             name: "query",
@@ -65,12 +68,13 @@ cli({
     func: async (page, kwargs) => {
         const p = page;
         const keyword = encodeURIComponent(String(kwargs.query));
-        await p.goto(`https://www.xiaohongshu.com/search_result?keyword=${keyword}&source=web_search_result_notes`);
+        const limit = Number(kwargs.limit) || 20;
+        await p.goto(`https://www.xiaohongshu.com/search_result?keyword=${keyword}&source=web_search_result_notes`, { settleMs: 2500 });
         const waitResult = await p.evaluate(WAIT_FOR_CONTENT_JS);
+        await assertXhsReadable(p, "search");
         if (waitResult === "login_wall") {
-            throw new Error("Xiaohongshu search results are blocked behind a login wall");
+            throw socialAuthError("xiaohongshu", "search");
         }
-        // Scroll a couple of times to load more results
         await p.autoScroll({ maxScrolls: 2, delay: 1500 });
         const payload = await p.evaluate(`
       (() => {
@@ -107,11 +111,10 @@ cli({
         return results;
       })()
     `);
-        const limit = Number(kwargs.limit) || 20;
         const data = Array.isArray(payload)
             ? payload
             : [];
-        return data
+        const rows = data
             .filter((item) => item.title)
             .slice(0, limit)
             .map((item, i) => ({
@@ -119,6 +122,9 @@ cli({
             ...item,
             published_at: noteIdToDate(String(item.url ?? "")),
         }));
+        if (rows.length > 0)
+            return rows;
+        throw socialEmptyError("xiaohongshu", "search", `Xiaohongshu search loaded no parseable notes for "${String(kwargs.query)}".`);
     },
 });
 //# sourceMappingURL=search.js.map

package/dist/adapters/xiaohongshu/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/search.ts"],"names":[],"mappings":"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"}

package/dist/adapters/xiaohongshu/trending.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   Xiaohongshu trend extraction.
+ * @does    Reads trending searches, falling back to visible hot notes in Chrome.
+ * @needs   A logged-in Xiaohongshu browser session or valid local cookies.
+ * @feeds   Agents needing current XHS trend context without brittle API-only failure.
+ * @breaks  XHS endpoint and DOM drift can reduce rows; command returns only observed public UI data.
+ */
+export {};
+//# sourceMappingURL=trending.d.ts.map

package/dist/adapters/xiaohongshu/trending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trending.d.ts","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/trending.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/adapters/xiaohongshu/trending.js

@@ -0,0 +1,94 @@
+/**
+ * @owner   Xiaohongshu trend extraction.
+ * @does    Reads trending searches, falling back to visible hot notes in Chrome.
+ * @needs   A logged-in Xiaohongshu browser session or valid local cookies.
+ * @feeds   Agents needing current XHS trend context without brittle API-only failure.
+ * @breaks  XHS endpoint and DOM drift can reduce rows; command returns only observed public UI data.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { socialEmptyError } from "../../social/browser-errors.js";
+import { assertXhsReadable, fetchXhsFeedItems } from "./browser-state.js";
+async function fetchHotList(page, limit) {
+    const raw = await page.evaluate(`
+    (async () => {
+      const limit = ${limit};
+      const resp = await fetch('/api/sns/v1/search/hot_list', {
+        credentials: 'include',
+        headers: { 'Content-Type': 'application/json' }
+      });
+      if (!resp.ok) return { ok: false, status: resp.status };
+      const data = await resp.json();
+      const items = data?.data?.items || data?.data || [];
+      return {
+        ok: true,
+        rows: items.slice(0, limit).map((item, i) => {
+          const keyword = item.title || item.name || item.word || '';
+          return {
+            rank: i + 1,
+            keyword,
+            score: String(item.score || item.hot_value || ''),
+            url: 'https://www.xiaohongshu.com/search_result?keyword=' + encodeURIComponent(keyword),
+          };
+        }).filter((item) => item.keyword)
+      };
+    })()
+  `);
+    const result = raw;
+    return result.ok && Array.isArray(result.rows) ? result.rows : [];
+}
+async function fetchHotFeed(page, limit) {
+    const items = await fetchXhsFeedItems(page);
+    const rows = items
+        .map((item) => item)
+        .map((item) => {
+        const note = item.note_card;
+        const interact = note?.interact_info;
+        return {
+            title: String(note?.display_title ?? ""),
+            likes: String(interact?.liked_count ?? ""),
+            id: String(item.id ?? ""),
+        };
+    })
+        .filter((item) => item.title && item.id)
+        .sort((a, b) => Number(b.likes || 0) - Number(a.likes || 0))
+        .slice(0, limit);
+    return rows.map((item, i) => ({
+        rank: i + 1,
+        keyword: item.title,
+        score: item.likes,
+        url: `https://www.xiaohongshu.com/explore/${item.id}`,
+    }));
+}
+cli({
+    site: "xiaohongshu",
+    name: "trending",
+    description: "Xiaohongshu trending searches and visible hot notes",
+    domain: "www.xiaohongshu.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    browserSession: "user",
+    args: [
+        {
+            name: "limit",
+            type: "int",
+            default: 20,
+            description: "Number of trending topics",
+        },
+    ],
+    columns: ["rank", "keyword", "score", "url"],
+    func: async (page, kwargs) => {
+        const p = page;
+        const limit = Number(kwargs.limit) || 20;
+        await p.goto("https://www.xiaohongshu.com/explore", { settleMs: 2500 });
+        await p.wait(2);
+        await assertXhsReadable(p, "trending");
+        const hotList = await fetchHotList(p, limit);
+        if (hotList.length > 0)
+            return hotList;
+        const hotFeed = await fetchHotFeed(p, limit);
+        if (hotFeed.length > 0)
+            return hotFeed;
+        throw socialEmptyError("xiaohongshu", "trending", "Xiaohongshu explore loaded no parseable hot-search or hot-note rows.");
+    },
+});
+//# sourceMappingURL=trending.js.map

package/dist/adapters/xiaohongshu/trending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trending.js","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/trending.ts"],"names":[],"mappings":"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"}

package/dist/adapters/youtube/comments.d.ts

@@ -4,5 +4,85 @@
  * Uses InnerTube "next" endpoint which returns engagement panels
  * including the comment section.
  */
+interface CommentRenderer {
+    commentRenderer?: {
+        commentId?: string;
+        authorText?: {
+            simpleText?: string;
+        };
+        contentText?: {
+            runs?: Array<{
+                text: string;
+            }>;
+        };
+        voteCount?: {
+            simpleText?: string;
+        };
+        replyCount?: number;
+        publishedTimeText?: {
+            runs?: Array<{
+                text: string;
+            }>;
+            simpleText?: string;
+        };
+    };
+}
+interface ReplyContinuationItem {
+    commentRenderer?: CommentRenderer["commentRenderer"];
+    continuationItemRenderer?: {
+        continuationEndpoint?: {
+            continuationCommand?: {
+                token?: string;
+            };
+        };
+    };
+}
+interface CommentSection {
+    itemSectionRenderer?: {
+        contents?: Array<{
+            commentThreadRenderer?: {
+                comment?: CommentRenderer;
+                replies?: {
+                    commentRepliesRenderer?: {
+                        contents?: ReplyContinuationItem[];
+                    };
+                };
+            };
+        }>;
+    };
+}
+interface NextEndpoint {
+    reloadContinuationItemsCommand?: {
+        continuationItems?: CommentSection[];
+    };
+    appendContinuationItemsAction?: {
+        continuationItems?: CommentSection[];
+    };
+}
+interface NextResponse {
+    onResponseReceivedEndpoints?: NextEndpoint[];
+    microformat?: {
+        microformatDataRenderer?: {
+            videoDetails?: {
+                comments?: Array<{
+                    text?: string;
+                    dateCreated?: string;
+                    upvoteCount?: string | number;
+                    author?: {
+                        name?: string;
+                        alternateName?: string;
+                    };
+                }>;
+            };
+        };
+    };
+}
+export declare function extractYouTubeCommentRows(data: NextResponse): {
+    rows: Array<Record<string, unknown>>;
+    replyContinuationTokens: Array<{
+        parentId: string;
+        token: string;
+    }>;
+};
 export {};
 //# sourceMappingURL=comments.d.ts.map

package/dist/adapters/youtube/comments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/adapters/youtube/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/adapters/youtube/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,UAAU,eAAe;IACvB,eAAe,CAAC,EAAE;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACrC,WAAW,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;QACjD,SAAS,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACpC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC7E,CAAC;CACH;AAED,UAAU,qBAAqB;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;IACrD,wBAAwB,CAAC,EAAE;QACzB,oBAAoB,CAAC,EAAE;YACrB,mBAAmB,CAAC,EAAE;gBACpB,KAAK,CAAC,EAAE,MAAM,CAAC;aAChB,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,UAAU,cAAc;IACtB,mBAAmB,CAAC,EAAE;QACpB,QAAQ,CAAC,EAAE,KAAK,CAAC;YACf,qBAAqB,CAAC,EAAE;gBACtB,OAAO,CAAC,EAAE,eAAe,CAAC;gBAC1B,OAAO,CAAC,EAAE;oBACR,sBAAsB,CAAC,EAAE;wBACvB,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;qBACpC,CAAC;iBACH,CAAC;aACH,CAAC;SACH,CAAC,CAAC;KACJ,CAAC;CACH;AAED,UAAU,YAAY;IACpB,8BAA8B,CAAC,EAAE;QAC/B,iBAAiB,CAAC,EAAE,cAAc,EAAE,CAAC;KACtC,CAAC;IACF,6BAA6B,CAAC,EAAE;QAC9B,iBAAiB,CAAC,EAAE,cAAc,EAAE,CAAC;KACtC,CAAC;CACH;AAED,UAAU,YAAY;IACpB,2BAA2B,CAAC,EAAE,YAAY,EAAE,CAAC;IAC7C,WAAW,CAAC,EAAE;QACZ,uBAAuB,CAAC,EAAE;YACxB,YAAY,CAAC,EAAE;gBACb,QAAQ,CAAC,EAAE,KAAK,CAAC;oBACf,IAAI,CAAC,EAAE,MAAM,CAAC;oBACd,WAAW,CAAC,EAAE,MAAM,CAAC;oBACrB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;oBAC9B,MAAM,CAAC,EAAE;wBACP,IAAI,CAAC,EAAE,MAAM,CAAC;wBACd,aAAa,CAAC,EAAE,MAAM,CAAC;qBACxB,CAAC;iBACH,CAAC,CAAC;aACJ,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAyCD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,YAAY,GAAG;IAC7D,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,uBAAuB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE,CAmDA"}