@zenalexa/unicli 0.207.1

package/dist/adapters/twitter/search.js

@@ -0,0 +1,43 @@
+/**
+ * Twitter search — keyword search using GraphQL SearchTimeline endpoint.
+ */
+import { cli } from "../../registry.js";
+import { Strategy } from "../../types.js";
+import { twitterFetch, FEATURES, extractTweetsFromInstructions, } from "./client.js";
+const QUERY_ID = "nK1dw4oV3k4w5TdtcAdSww";
+const ENDPOINT = "SearchTimeline";
+cli({
+    site: "twitter",
+    name: "search",
+    description: "Search tweets by keyword",
+    domain: "x.com",
+    strategy: Strategy.COOKIE,
+    args: [
+        {
+            name: "query",
+            required: true,
+            positional: true,
+            description: "Search query",
+        },
+    ],
+    columns: ["id", "author", "text", "likes", "retweets", "views", "url"],
+    func: async (_page, kwargs) => {
+        const query = kwargs.query;
+        const count = Math.min(kwargs.limit ?? 20, 50);
+        const variables = {
+            rawQuery: query,
+            count,
+            querySource: "typed_query",
+            product: "Latest",
+        };
+        const data = (await twitterFetch(ENDPOINT, QUERY_ID, variables, FEATURES));
+        // Navigate: data.search_by_raw_query.search_timeline.timeline.instructions
+        const searchByRawQuery = data.data;
+        const searchResult = searchByRawQuery?.search_by_raw_query;
+        const searchTimeline = searchResult?.search_timeline;
+        const timeline = searchTimeline?.timeline;
+        const instructions = timeline?.instructions ?? [];
+        return extractTweetsFromInstructions(instructions);
+    },
+});
+//# sourceMappingURL=search.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/adapters/twitter/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,6BAA6B,GAC9B,MAAM,aAAa,CAAC;AAErB,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAC1C,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAElC,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,0BAA0B;IACvC,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,cAAc;SAC5B;KACF;IACD,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC;IACtE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAe,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAE,MAAM,CAAC,KAAgB,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAE3D,MAAM,SAAS,GAAG;YAChB,QAAQ,EAAE,KAAK;YACf,KAAK;YACL,WAAW,EAAE,aAAa;YAC1B,OAAO,EAAE,QAAQ;SAClB,CAAC;QAEF,MAAM,IAAI,GAAG,CAAC,MAAM,YAAY,CAC9B,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,CACT,CAA4B,CAAC;QAE9B,2EAA2E;QAC3E,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAA2C,CAAC;QAC1E,MAAM,YAAY,GAAG,gBAAgB,EAAE,mBAE1B,CAAC;QACd,MAAM,cAAc,GAAG,YAAY,EAAE,eAExB,CAAC;QACd,MAAM,QAAQ,GAAG,cAAc,EAAE,QAEpB,CAAC;QACd,MAAM,YAAY,GAAI,QAAQ,EAAE,YAA0B,IAAI,EAAE,CAAC;QAEjE,OAAO,6BAA6B,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/twitter/thread.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Twitter thread — fetch a tweet and its conversation thread via GraphQL TweetDetail.
+ */
+export {};
+//# sourceMappingURL=thread.d.ts.map

package/dist/adapters/twitter/thread.d.ts.map

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

package/dist/adapters/twitter/thread.js

@@ -0,0 +1,44 @@
+/**
+ * Twitter thread — fetch a tweet and its conversation thread via GraphQL TweetDetail.
+ */
+import { cli } from "../../registry.js";
+import { Strategy } from "../../types.js";
+import { twitterFetch, FEATURES, extractTweetsFromInstructions, } from "./client.js";
+const QUERY_ID = "B9_KmbkLhXt6jRwGjJrweg";
+const ENDPOINT = "TweetDetail";
+cli({
+    site: "twitter",
+    name: "thread",
+    description: "Get a tweet and its conversation thread",
+    domain: "x.com",
+    strategy: Strategy.COOKIE,
+    args: [
+        {
+            name: "tweet_id",
+            required: true,
+            positional: true,
+            description: "Tweet ID (numeric)",
+        },
+    ],
+    columns: ["id", "author", "text", "likes", "retweets", "views", "url"],
+    func: async (_page, kwargs) => {
+        const tweetId = String(kwargs.tweet_id);
+        const variables = {
+            focalTweetId: tweetId,
+            with_rux_injections: false,
+            includePromotedContent: false,
+            withCommunity: true,
+            withQuickPromoteEligibilityTweetFields: false,
+            withBirdwatchNotes: true,
+            withVoice: true,
+            withV2Timeline: true,
+        };
+        const data = (await twitterFetch(ENDPOINT, QUERY_ID, variables, FEATURES));
+        // Navigate: data.threaded_conversation_with_injections_v2.instructions
+        const root = data.data;
+        const conversation = root?.threaded_conversation_with_injections_v2;
+        const instructions = conversation?.instructions ?? [];
+        return extractTweetsFromInstructions(instructions);
+    },
+});
+//# sourceMappingURL=thread.js.map

package/dist/adapters/twitter/thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.js","sourceRoot":"","sources":["../../../src/adapters/twitter/thread.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,6BAA6B,GAC9B,MAAM,aAAa,CAAC;AAErB,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAC1C,MAAM,QAAQ,GAAG,aAAa,CAAC;AAE/B,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,yCAAyC;IACtD,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,oBAAoB;SAClC;KACF;IACD,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC;IACtE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAExC,MAAM,SAAS,GAAG;YAChB,YAAY,EAAE,OAAO;YACrB,mBAAmB,EAAE,KAAK;YAC1B,sBAAsB,EAAE,KAAK;YAC7B,aAAa,EAAE,IAAI;YACnB,sCAAsC,EAAE,KAAK;YAC7C,kBAAkB,EAAE,IAAI;YACxB,SAAS,EAAE,IAAI;YACf,cAAc,EAAE,IAAI;SACrB,CAAC;QAEF,MAAM,IAAI,GAAG,CAAC,MAAM,YAAY,CAC9B,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,CACT,CAA4B,CAAC;QAE9B,uEAAuE;QACvE,MAAM,IAAI,GAAG,IAAI,CAAC,IAA2C,CAAC;QAC9D,MAAM,YAAY,GAAG,IAAI,EAAE,wCAEd,CAAC;QACd,MAAM,YAAY,GAAI,YAAY,EAAE,YAA0B,IAAI,EAAE,CAAC;QAErE,OAAO,6BAA6B,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/twitter/timeline.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Twitter timeline — home "For You" timeline via GraphQL HomeTimeline endpoint.
+ */
+export {};
+//# sourceMappingURL=timeline.d.ts.map

package/dist/adapters/twitter/timeline.d.ts.map

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

package/dist/adapters/twitter/timeline.js

@@ -0,0 +1,33 @@
+/**
+ * Twitter timeline — home "For You" timeline via GraphQL HomeTimeline endpoint.
+ */
+import { cli } from "../../registry.js";
+import { Strategy } from "../../types.js";
+import { twitterFetch, FEATURES, extractTweetsFromInstructions, } from "./client.js";
+const QUERY_ID = "c-CzHF1LboFilMpsx4ZCrQ";
+const ENDPOINT = "HomeTimeline";
+cli({
+    site: "twitter",
+    name: "timeline",
+    description: "Get home timeline (for-you feed)",
+    domain: "x.com",
+    strategy: Strategy.COOKIE,
+    columns: ["id", "author", "text", "likes", "retweets", "views", "url"],
+    func: async (_page, kwargs) => {
+        const count = Math.min(kwargs.limit ?? 20, 50);
+        const variables = {
+            count,
+            includePromotedContent: false,
+            latestControlAvailable: true,
+            requestContext: "launch",
+        };
+        const data = (await twitterFetch(ENDPOINT, QUERY_ID, variables, FEATURES));
+        // Navigate: data.home.home_timeline_urt.instructions
+        const root = data.data;
+        const home = root?.home;
+        const homeTimelineUrt = home?.home_timeline_urt;
+        const instructions = homeTimelineUrt?.instructions ?? [];
+        return extractTweetsFromInstructions(instructions);
+    },
+});
+//# sourceMappingURL=timeline.js.map

package/dist/adapters/twitter/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../../src/adapters/twitter/timeline.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,6BAA6B,GAC9B,MAAM,aAAa,CAAC;AAErB,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAC1C,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEhC,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,kCAAkC;IAC/C,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC;IACtE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAE,MAAM,CAAC,KAAgB,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAE3D,MAAM,SAAS,GAAG;YAChB,KAAK;YACL,sBAAsB,EAAE,KAAK;YAC7B,sBAAsB,EAAE,IAAI;YAC5B,cAAc,EAAE,QAAQ;SACzB,CAAC;QAEF,MAAM,IAAI,GAAG,CAAC,MAAM,YAAY,CAC9B,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,CACT,CAA4B,CAAC;QAE9B,qDAAqD;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,IAA2C,CAAC;QAC9D,MAAM,IAAI,GAAG,IAAI,EAAE,IAA2C,CAAC;QAC/D,MAAM,eAAe,GAAG,IAAI,EAAE,iBAEjB,CAAC;QACd,MAAM,YAAY,GAAI,eAAe,EAAE,YAA0B,IAAI,EAAE,CAAC;QAExE,OAAO,6BAA6B,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,5 @@
+/**
+ * Twitter trending — fetch trending topics via the v2 guide API.
+ */
+export {};
+//# sourceMappingURL=trending.d.ts.map

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

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

package/dist/adapters/twitter/trending.js

@@ -0,0 +1,75 @@
+/**
+ * Twitter trending — fetch trending topics via the v2 guide API.
+ */
+import { cli } from "../../registry.js";
+import { Strategy } from "../../types.js";
+import { twitterGuideFetch } from "./client.js";
+const GUIDE_URL = "https://x.com/i/api/2/guide.json";
+cli({
+    site: "twitter",
+    name: "trending",
+    description: "Get trending topics",
+    domain: "x.com",
+    strategy: Strategy.COOKIE,
+    columns: ["name", "tweet_count", "description", "url"],
+    func: async (_page, kwargs) => {
+        const count = kwargs.limit ?? 20;
+        const data = (await twitterGuideFetch(GUIDE_URL, {
+            count: String(count),
+            include_page_configuration: "false",
+        }));
+        // Navigate: data.timeline.instructions[0].addEntries.entries
+        const timeline = data.timeline;
+        const instructions = timeline?.instructions ?? [];
+        const trends = [];
+        for (const instruction of instructions) {
+            const inst = instruction;
+            const addEntries = inst.addEntries;
+            if (!addEntries)
+                continue;
+            const entries = addEntries.entries ?? [];
+            for (const entry of entries) {
+                const e = entry;
+                const content = e.content;
+                if (!content)
+                    continue;
+                // Trend items are nested in timelineModule or timelineItem
+                const items = content.items ??
+                    (content.item ? [{ item: content.item }] : []);
+                for (const item of items) {
+                    const i = item;
+                    const itemObj = (i.item ?? i);
+                    const clientEventInfo = itemObj.clientEventInfo;
+                    const details = clientEventInfo?.details;
+                    const guideDetails = details?.guideDetails;
+                    const transparentGuideDetails = guideDetails?.transparentGuideDetails;
+                    const trendMetadata = transparentGuideDetails?.trendMetadata;
+                    // Also try direct content path
+                    const itemContent = itemObj.content;
+                    const trend = itemContent?.trend;
+                    const name = trendMetadata?.trendName ??
+                        trend?.name ??
+                        "";
+                    if (!name)
+                        continue;
+                    const tweetCount = trendMetadata?.metaDescription ??
+                        trend?.tweetCount ??
+                        "";
+                    const desc = trend?.description ??
+                        trendMetadata?.metaDescription ??
+                        "";
+                    const trendUrl = trend?.url;
+                    trends.push({
+                        name,
+                        tweet_count: tweetCount,
+                        description: desc,
+                        url: trendUrl?.url ??
+                            `https://x.com/search?q=${encodeURIComponent(name)}`,
+                    });
+                }
+            }
+        }
+        return trends.slice(0, count);
+    },
+});
+//# sourceMappingURL=trending.js.map

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

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

package/dist/adapters/twitter/unblock.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Twitter unblock — unblock a user via GraphQL mutation.
+ */
+export {};
+//# sourceMappingURL=unblock.d.ts.map

package/dist/adapters/twitter/unblock.d.ts.map

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

package/dist/adapters/twitter/unblock.js

@@ -0,0 +1,33 @@
+/**
+ * Twitter unblock — unblock a user via GraphQL mutation.
+ */
+import { cli } from "../../registry.js";
+import { Strategy } from "../../types.js";
+import { twitterPostFetch, FEATURES } from "./client.js";
+const QUERY_ID = "dUkP9lYtFWvElBkdWJKJCA";
+const ENDPOINT = "UnblockUser";
+cli({
+    site: "twitter",
+    name: "unblock",
+    description: "Unblock a user",
+    domain: "x.com",
+    strategy: Strategy.COOKIE,
+    args: [
+        {
+            name: "user_id",
+            required: true,
+            positional: true,
+            description: "User numeric ID to unblock",
+        },
+    ],
+    columns: ["status", "id"],
+    func: async (_page, kwargs) => {
+        const userId = String(kwargs.user_id);
+        const variables = {
+            user_id: userId,
+        };
+        await twitterPostFetch(ENDPOINT, QUERY_ID, variables, FEATURES);
+        return [{ status: "ok", id: userId }];
+    },
+});
+//# sourceMappingURL=unblock.js.map

package/dist/adapters/twitter/unblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unblock.js","sourceRoot":"","sources":["../../../src/adapters/twitter/unblock.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAC1C,MAAM,QAAQ,GAAG,aAAa,CAAC;AAE/B,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,gBAAgB;IAC7B,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,4BAA4B;SAC1C;KACF;IACD,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;IACzB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEtC,MAAM,SAAS,GAAG;YAChB,OAAO,EAAE,MAAM;SAChB,CAAC;QAEF,MAAM,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEhE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/twitter/unbookmark.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Twitter unbookmark — remove a bookmark via GraphQL mutation.
+ */
+export {};
+//# sourceMappingURL=unbookmark.d.ts.map

package/dist/adapters/twitter/unbookmark.d.ts.map

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

package/dist/adapters/twitter/unbookmark.js

@@ -0,0 +1,33 @@
+/**
+ * Twitter unbookmark — remove a bookmark via GraphQL mutation.
+ */
+import { cli } from "../../registry.js";
+import { Strategy } from "../../types.js";
+import { twitterPostFetch, FEATURES } from "./client.js";
+const QUERY_ID = "Wlmlj2-xISVIqR-TU4LZ0g";
+const ENDPOINT = "DeleteBookmark";
+cli({
+    site: "twitter",
+    name: "unbookmark",
+    description: "Remove a bookmark from a tweet",
+    domain: "x.com",
+    strategy: Strategy.COOKIE,
+    args: [
+        {
+            name: "tweet_id",
+            required: true,
+            positional: true,
+            description: "Tweet ID to unbookmark",
+        },
+    ],
+    columns: ["status", "id"],
+    func: async (_page, kwargs) => {
+        const tweetId = String(kwargs.tweet_id);
+        const variables = {
+            tweet_id: tweetId,
+        };
+        await twitterPostFetch(ENDPOINT, QUERY_ID, variables, FEATURES);
+        return [{ status: "ok", id: tweetId }];
+    },
+});
+//# sourceMappingURL=unbookmark.js.map

package/dist/adapters/twitter/unbookmark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unbookmark.js","sourceRoot":"","sources":["../../../src/adapters/twitter/unbookmark.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAC1C,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAElC,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,gCAAgC;IAC7C,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,wBAAwB;SACtC;KACF;IACD,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;IACzB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAExC,MAAM,SAAS,GAAG;YAChB,QAAQ,EAAE,OAAO;SAClB,CAAC;QAEF,MAAM,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEhE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/twitter/unfollow.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Twitter unfollow — unfollow a user via GraphQL mutation.
+ */
+export {};
+//# sourceMappingURL=unfollow.d.ts.map

package/dist/adapters/twitter/unfollow.d.ts.map

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

package/dist/adapters/twitter/unfollow.js

@@ -0,0 +1,33 @@
+/**
+ * Twitter unfollow — unfollow a user via GraphQL mutation.
+ */
+import { cli } from "../../registry.js";
+import { Strategy } from "../../types.js";
+import { twitterPostFetch, FEATURES } from "./client.js";
+const QUERY_ID = "2VLdHTIKqAR3MsBfq3JnBw";
+const ENDPOINT = "Unfollow";
+cli({
+    site: "twitter",
+    name: "unfollow",
+    description: "Unfollow a user",
+    domain: "x.com",
+    strategy: Strategy.COOKIE,
+    args: [
+        {
+            name: "user_id",
+            required: true,
+            positional: true,
+            description: "User numeric ID to unfollow",
+        },
+    ],
+    columns: ["status", "id"],
+    func: async (_page, kwargs) => {
+        const userId = String(kwargs.user_id);
+        const variables = {
+            user_id: userId,
+        };
+        await twitterPostFetch(ENDPOINT, QUERY_ID, variables, FEATURES);
+        return [{ status: "ok", id: userId }];
+    },
+});
+//# sourceMappingURL=unfollow.js.map

package/dist/adapters/twitter/unfollow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unfollow.js","sourceRoot":"","sources":["../../../src/adapters/twitter/unfollow.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAC1C,MAAM,QAAQ,GAAG,UAAU,CAAC;AAE5B,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,iBAAiB;IAC9B,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,6BAA6B;SAC3C;KACF;IACD,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;IACzB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEtC,MAAM,SAAS,GAAG;YAChB,OAAO,EAAE,MAAM;SAChB,CAAC;QAEF,MAAM,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEhE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Xiaohongshu comments — DOM extraction from note detail page.
+ *
+ * Supports both top-level comments and nested replies via
+ * the --with-replies flag.
+ */
+export {};
+//# sourceMappingURL=comments.d.ts.map

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

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

package/dist/adapters/xiaohongshu/comments.js

@@ -0,0 +1,136 @@
+/**
+ * Xiaohongshu comments — DOM extraction from note detail page.
+ *
+ * Supports both top-level comments and nested replies via
+ * the --with-replies flag.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { buildNoteUrl } from "./note-helpers.js";
+function parseCommentLimit(raw, fallback = 20) {
+    const n = Number(raw);
+    if (!Number.isFinite(n))
+        return fallback;
+    return Math.max(1, Math.min(Math.floor(n), 50));
+}
+cli({
+    site: "xiaohongshu",
+    name: "comments",
+    description: "Get comments on a Xiaohongshu note (supports nested replies)",
+    domain: "www.xiaohongshu.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        {
+            name: "note-id",
+            required: true,
+            positional: true,
+            description: "Note ID or full URL",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 20,
+            description: "Number of top-level comments (max 50)",
+        },
+        {
+            name: "with-replies",
+            type: "bool",
+            default: false,
+            description: "Include nested replies",
+        },
+    ],
+    columns: ["rank", "author", "text", "likes", "time", "is_reply", "reply_to"],
+    func: async (page, kwargs) => {
+        const p = page;
+        const limit = parseCommentLimit(kwargs.limit);
+        const withReplies = Boolean(kwargs["with-replies"]);
+        const raw = String(kwargs["note-id"]);
+        await p.goto(buildNoteUrl(raw));
+        await p.wait(3);
+        const data = (await p.evaluate(`
+      (async () => {
+        const wait = (ms) => new Promise(r => setTimeout(r, ms))
+        const withReplies = ${String(withReplies)}
+        const loginWall = /登录后查看|请登录/.test(document.body.innerText || '')
+        const scroller = document.querySelector('.note-scroller') || document.querySelector('.container')
+        if (scroller) {
+          for (let i = 0; i < 3; i++) {
+            scroller.scrollTo(0, scroller.scrollHeight)
+            await wait(1000)
+          }
+        }
+        const clean = (el) => (el?.textContent || '').replace(/\\s+/g, ' ').trim()
+        const parseLikes = (el) => {
+          const raw = clean(el)
+          return /^\\d+$/.test(raw) ? Number(raw) : 0
+        }
+        const expandReplyThreads = async (root) => {
+          if (!withReplies || !root) return
+          const clickedTexts = new Set()
+          for (let round = 0; round < 3; round++) {
+            const expanders = Array.from(root.querySelectorAll('button, [role="button"], span, div')).filter(el => {
+              if (!(el instanceof HTMLElement)) return false
+              const text = clean(el)
+              if (!text || text.length > 24) return false
+              if (!/(展开|更多回复|全部回复|查看.*回复|共\\d+条回复)/.test(text)) return false
+              if (clickedTexts.has(text)) return false
+              return true
+            })
+            if (!expanders.length) break
+            for (const el of expanders) {
+              const text = clean(el)
+              el.click()
+              clickedTexts.add(text)
+              await wait(300)
+            }
+          }
+        }
+        const results = []
+        const parents = document.querySelectorAll('.parent-comment')
+        for (const p of parents) {
+          const item = p.querySelector('.comment-item')
+          if (!item) continue
+          const author = clean(item.querySelector('.author-wrapper .name, .user-name'))
+          const text = clean(item.querySelector('.content, .note-text'))
+          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: '' })
+          if (withReplies) {
+            await expandReplyThreads(p)
+            p.querySelectorAll('.reply-container .comment-item-sub, .sub-comment-list .comment-item').forEach(sub => {
+              const sAuthor = clean(sub.querySelector('.name, .user-name'))
+              const sText = clean(sub.querySelector('.content, .note-text'))
+              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 })
+            })
+          }
+        }
+        return { loginWall, results }
+      })()
+    `));
+        if (!data || typeof data !== "object") {
+            throw new Error("Unexpected evaluate response");
+        }
+        if (data.loginWall) {
+            throw new Error("Note comments require login to www.xiaohongshu.com");
+        }
+        const all = data.results ?? [];
+        if (withReplies) {
+            const limited = [];
+            let topCount = 0;
+            for (const c of all) {
+                if (!c.is_reply)
+                    topCount++;
+                if (topCount > limit)
+                    break;
+                limited.push(c);
+            }
+            return limited.map((c, i) => ({ rank: i + 1, ...c }));
+        }
+        return all.slice(0, limit).map((c, i) => ({ rank: i + 1, ...c }));
+    },
+});
+//# sourceMappingURL=comments.js.map

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

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

package/dist/adapters/xiaohongshu/creator-note-detail.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Xiaohongshu Creator Note Detail — per-note analytics from the creator detail page.
+ *
+ * Navigates to the note detail page and parses rendered metrics plus
+ * API-sourced trend and audience data.
+ */
+import type { IPage } from "../../types.js";
+export interface CreatorNoteDetailRow {
+    section: string;
+    metric: string;
+    value: string;
+    extra: string;
+}
+export declare function fetchCreatorNoteDetailRows(page: IPage, noteId: string): Promise<CreatorNoteDetailRow[]>;
+//# sourceMappingURL=creator-note-detail.d.ts.map

package/dist/adapters/xiaohongshu/creator-note-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creator-note-detail.d.ts","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/creator-note-detail.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAyQD,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,KAAK,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAiDjC"}