@zenalexa/unicli 0.220.0 → 0.221.0

package/dist/adapters/threads/post.js

@@ -0,0 +1,287 @@
+/**
+ * @owner   Threads public page metadata adapter.
+ * @does    Register public profile, post, and media readers backed by Threads OG metadata.
+ * @needs   Threads public HTML pages exposing Open Graph metadata.
+ * @feeds   Social research workflows and Threads capability coverage.
+ * @breaks  Threads hiding public metadata or changing canonical post/profile markup.
+ */
+import { USER_AGENT } from "../../constants.js";
+import { cli, Strategy } from "../../registry.js";
+const THREADS_HOST_RE = /(^|\.)threads\.(net|com)$/i;
+function decodeHtml(value) {
+    return value
+        .replace(/&#x([0-9a-f]+);/gi, (_, code) => String.fromCodePoint(Number.parseInt(code, 16)))
+        .replace(/&#(\d+);/g, (_, code) => String.fromCodePoint(Number.parseInt(code, 10)))
+        .replace(/ /g, " ")
+        .replace(/&/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&#039;/g, "'")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function attributesFor(tag) {
+    const attrs = {};
+    const attrRe = /\s([^\s"'=<>`]+)\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/g;
+    for (const match of tag.matchAll(attrRe)) {
+        attrs[match[1].toLowerCase()] = decodeHtml(match[2] ?? match[3] ?? match[4] ?? "");
+    }
+    return attrs;
+}
+function metaContent(html, key) {
+    for (const match of html.matchAll(/<meta\b[^>]*>/gi)) {
+        const attrs = attributesFor(match[0]);
+        if (attrs.property === key || attrs.name === key)
+            return attrs.content ?? "";
+    }
+    return "";
+}
+function linkHref(html, rel, type) {
+    for (const match of html.matchAll(/<link\b[^>]*>/gi)) {
+        const attrs = attributesFor(match[0]);
+        const rels = new Set((attrs.rel ?? "").toLowerCase().split(/\s+/).filter(Boolean));
+        if (rels.has(rel.toLowerCase()) && attrs.type === type)
+            return attrs.href ?? "";
+    }
+    return "";
+}
+function firstNonEmpty(...values) {
+    return values.find((value) => value.trim())?.trim() ?? "";
+}
+function numberFromMeta(value) {
+    const number = Number.parseInt(value, 10);
+    return Number.isFinite(number) ? number : 0;
+}
+function cleanHandle(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        throw new Error("Threads handle cannot be empty");
+    if (/^https?:\/\//i.test(trimmed)) {
+        const url = new URL(trimmed);
+        const handle = url.pathname.split("/").find((part) => part.startsWith("@"));
+        if (!handle)
+            throw new Error(`Threads URL does not contain a handle: ${input}`);
+        return handle.replace(/^@/, "");
+    }
+    return trimmed.replace(/^@/, "").replace(/^\/+/, "").split("/")[0];
+}
+function handleFromUrl(input) {
+    const url = new URL(input);
+    const handle = url.pathname.split("/").find((part) => part.startsWith("@"));
+    return handle ? handle : "";
+}
+function identityFromTitle(title, fallbackHandle) {
+    const match = title.match(/^\s*(.*?)\s+\((@[A-Za-z0-9._]+)\)/);
+    const handle = match?.[2] ?? fallbackHandle;
+    const name = firstNonEmpty(match?.[1] ?? "", handle.replace(/^@/, ""));
+    return { name, handle };
+}
+function ensureThreadsUrl(url) {
+    if (!THREADS_HOST_RE.test(url.hostname)) {
+        throw new Error(`Expected a threads.net or threads.com URL, got ${url.hostname}`);
+    }
+}
+export function normalizeThreadsProfileUrl(input) {
+    const handle = cleanHandle(input);
+    return `https://www.threads.net/@${encodeURIComponent(handle)}`;
+}
+export function normalizeThreadsPostUrl(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        throw new Error("Threads post URL cannot be empty");
+    const raw = trimmed.startsWith("@") || trimmed.startsWith("/@")
+        ? `https://www.threads.net/${trimmed.replace(/^\/+/, "")}`
+        : trimmed;
+    const url = new URL(raw);
+    ensureThreadsUrl(url);
+    if (!/^\/@[^/]+\/post\/[^/?#]+/.test(url.pathname)) {
+        throw new Error(`Expected Threads post URL path /@handle/post/shortcode, got ${url.pathname}`);
+    }
+    return url.toString();
+}
+function shortcodeFromPost(url, iosUrl) {
+    const iosMatch = iosUrl.match(/[?&]shortcode=([^&]+)/);
+    if (iosMatch)
+        return decodeURIComponent(iosMatch[1]);
+    const urlMatch = url.match(/\/post\/([^/?#]+)/);
+    return urlMatch ? decodeURIComponent(urlMatch[1]) : "";
+}
+export function parseThreadsPostHtml(html, fallbackUrl) {
+    const url = firstNonEmpty(metaContent(html, "og:url"), fallbackUrl);
+    const title = metaContent(html, "og:title");
+    const text = firstNonEmpty(metaContent(html, "og:description"), metaContent(html, "twitter:description"));
+    const imageUrl = metaContent(html, "og:image");
+    const fallbackHandle = handleFromUrl(url);
+    const identity = identityFromTitle(title, fallbackHandle);
+    if (!identity.handle || (!text && !imageUrl)) {
+        throw new Error("Threads post page did not expose usable public metadata");
+    }
+    return {
+        activity_json_url: linkHref(html, "alternate", "application/activity+json"),
+        author: identity.name,
+        handle: identity.handle,
+        image_height: numberFromMeta(metaContent(html, "og:image:height")),
+        image_url: imageUrl,
+        image_width: numberFromMeta(metaContent(html, "og:image:width")),
+        shortcode: shortcodeFromPost(url, metaContent(html, "al:ios:url")),
+        text,
+        url,
+    };
+}
+export function parseThreadsProfileHtml(html, handleInput) {
+    const title = metaContent(html, "og:title");
+    const description = metaContent(html, "og:description");
+    const url = firstNonEmpty(metaContent(html, "og:url"), normalizeThreadsProfileUrl(handleInput));
+    const identity = identityFromTitle(title, `@${cleanHandle(handleInput)}`);
+    const parts = description
+        .split("•")
+        .map((part) => part.trim())
+        .filter(Boolean);
+    const followers = parts
+        .find((part) => /\bFollowers\b/i.test(part))
+        ?.replace(/\s*Followers\b/i, "") ?? "";
+    const threads = parts
+        .find((part) => /\bThreads\b/i.test(part))
+        ?.replace(/\s*Threads\b/i, "") ?? "";
+    const bio = firstNonEmpty(...parts.filter((part) => !/\b(Followers|Threads)\b/i.test(part))).replace(/\s*See the latest conversations with @[^.]+\.?$/i, "");
+    if (!identity.handle || !identity.name) {
+        throw new Error("Threads profile page did not expose usable public metadata");
+    }
+    return {
+        avatar_url: metaContent(html, "og:image"),
+        bio,
+        followers,
+        handle: identity.handle,
+        name: identity.name,
+        threads,
+        url,
+    };
+}
+function mediaRowsFromPost(post) {
+    if (!post.image_url)
+        return [];
+    return [
+        {
+            rank: 1,
+            type: "image",
+            url: post.image_url,
+            width: post.image_width,
+            height: post.image_height,
+            post_url: post.url,
+            shortcode: post.shortcode,
+            source: "og:image",
+        },
+    ];
+}
+async function fetchThreadsHtml(url) {
+    const response = await fetch(url, {
+        headers: {
+            Accept: "text/html,application/xhtml+xml",
+            "User-Agent": USER_AGENT,
+        },
+    });
+    if (!response.ok) {
+        const preview = (await response.text()).slice(0, 200);
+        throw new Error(`Threads HTTP ${response.status} from ${url}: ${preview}`);
+    }
+    return response.text();
+}
+cli({
+    site: "threads",
+    name: "profile",
+    description: "Get public Threads profile metadata",
+    domain: "threads.net",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "handle",
+            required: true,
+            positional: true,
+            description: "Threads handle or profile URL, e.g. zuck",
+        },
+    ],
+    columns: [
+        "name",
+        "handle",
+        "followers",
+        "threads",
+        "bio",
+        "url",
+        "avatar_url",
+    ],
+    socialCapabilities: ["read", "author", "relations"],
+    func: async (_page, kwargs) => {
+        const url = normalizeThreadsProfileUrl(String(kwargs.handle ?? ""));
+        const html = await fetchThreadsHtml(url);
+        return [parseThreadsProfileHtml(html, String(kwargs.handle ?? ""))];
+    },
+});
+cli({
+    site: "threads",
+    name: "post",
+    description: "Get a public Threads post from its metadata",
+    domain: "threads.net",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "url",
+            required: true,
+            positional: true,
+            description: "Threads post URL, e.g. https://www.threads.net/@zuck/post/DYSAIo_FL77",
+        },
+    ],
+    columns: [
+        "author",
+        "handle",
+        "text",
+        "url",
+        "image_url",
+        "image_width",
+        "image_height",
+        "shortcode",
+        "activity_json_url",
+    ],
+    socialCapabilities: ["read", "author", "media"],
+    func: async (_page, kwargs) => {
+        const url = normalizeThreadsPostUrl(String(kwargs.url ?? ""));
+        const html = await fetchThreadsHtml(url);
+        return [parseThreadsPostHtml(html, url)];
+    },
+});
+cli({
+    site: "threads",
+    name: "media",
+    description: "List public media exposed by a Threads post",
+    domain: "threads.net",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "url",
+            required: true,
+            positional: true,
+            description: "Threads post URL, e.g. https://www.threads.net/@zuck/post/DYSAIo_FL77",
+        },
+    ],
+    columns: [
+        "rank",
+        "type",
+        "url",
+        "width",
+        "height",
+        "post_url",
+        "shortcode",
+        "source",
+    ],
+    socialCapabilities: ["read", "media"],
+    func: async (_page, kwargs) => {
+        const url = normalizeThreadsPostUrl(String(kwargs.url ?? ""));
+        const html = await fetchThreadsHtml(url);
+        const rows = mediaRowsFromPost(parseThreadsPostHtml(html, url));
+        if (rows.length === 0)
+            throw new Error("Threads post metadata did not include media");
+        return rows;
+    },
+});
+//# sourceMappingURL=post.js.map

package/dist/adapters/threads/post.js.map

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

package/dist/adapters/tiktok/subtitles.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   TikTok subtitle adapter.
+ * @does    Extracts LLM-readable subtitle text from public TikTok video URLs.
+ * @needs   `yt-dlp` on PATH and an accessible video subtitle track.
+ * @feeds   Short-video search-to-transcript agent workflows.
+ * @breaks  TikTok or yt-dlp extractor changes can alter subtitle availability.
+ */
+export {};
+//# sourceMappingURL=subtitles.d.ts.map

package/dist/adapters/tiktok/subtitles.d.ts.map

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

package/dist/adapters/tiktok/subtitles.js

@@ -0,0 +1,42 @@
+/**
+ * @owner   TikTok subtitle adapter.
+ * @does    Extracts LLM-readable subtitle text from public TikTok video URLs.
+ * @needs   `yt-dlp` on PATH and an accessible video subtitle track.
+ * @feeds   Short-video search-to-transcript agent workflows.
+ * @breaks  TikTok or yt-dlp extractor changes can alter subtitle availability.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { runVideoSubtitleExtraction } from "../../social/video-text.js";
+cli({
+    site: "tiktok",
+    name: "subtitles",
+    description: "Extract LLM-readable subtitles from a TikTok video URL with optional browser-cookie reuse",
+    domain: "www.tiktok.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "url",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "TikTok video URL",
+            format: "uri",
+        },
+        {
+            name: "languages",
+            type: "str",
+            default: "zh-Hans,zh,en",
+            description: "Comma-separated subtitle languages",
+        },
+        {
+            name: "cookies-from-browser",
+            type: "str",
+            description: "Browser name for yt-dlp --cookies-from-browser",
+        },
+    ],
+    columns: ["language", "text", "path"],
+    socialCapabilities: ["read", "media", "subtitles"],
+    defaultFormat: "json",
+    func: async (_page, kwargs) => runVideoSubtitleExtraction(kwargs),
+});
+//# sourceMappingURL=subtitles.js.map

package/dist/adapters/tiktok/subtitles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.js","sourceRoot":"","sources":["../../../src/adapters/tiktok/subtitles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,GAAG,CAAC;IACF,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,2FAA2F;IAC7F,MAAM,EAAE,gBAAgB;IACxB,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,kBAAkB;YAC/B,MAAM,EAAE,KAAK;SACd;QACD;YACE,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,eAAe;YACxB,WAAW,EAAE,oCAAoC;SAClD;QACD;YACE,IAAI,EAAE,sBAAsB;YAC5B,IAAI,EAAE,KAAK;YACX,WAAW,EAAE,gDAAgD;SAC9D;KACF;IACD,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC;IACrC,kBAAkB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC;IAClD,aAAa,EAAE,MAAM;IACrB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC;CAClE,CAAC,CAAC"}

package/dist/adapters/twitter/accept.js

@@ -5,7 +5,7 @@
  */
 import { cli } from "../../registry.js";
 import { Strategy } from "../../types.js";
-import { loadCookies, formatCookieHeader } from "../../engine/cookies.js";
+import { loadCookiesWithCDP, formatCookieHeader, } from "../../engine/cookies.js";
 import { USER_AGENT } from "../../constants.js";
 const BEARER_TOKEN = "AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D1Zv7ttfk8LF81IUq16cHjhLTvJu4FA33AGWWjCpTnA";
 cli({
@@ -25,7 +25,7 @@ cli({
     columns: ["status", "id"],
     func: async (_page, kwargs) => {
         const userId = String(kwargs.user_id);
-        const cookies = loadCookies("twitter");
+        const cookies = await loadCookiesWithCDP("twitter", "x.com");
         if (!cookies) {
             throw new Error('No cookies found for "twitter". Run: unicli auth setup twitter');
         }

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

@@ -1 +1 @@
-{"version":3,"file":"accept.js","sourceRoot":"","sources":["../../../src/adapters/twitter/accept.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,YAAY,GAChB,0GAA0G,CAAC;AAE7G,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,iCAAiC;IAC9C,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,gDAAgD;SAC9D;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,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACxB,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,mCAAmC;gBACjC,oEAAoE,CACvE,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,6CAA6C,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QAE7E,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,YAAY,EAAE;gBACvC,cAAc,EAAE,GAAG;gBACnB,qBAAqB,EAAE,eAAe;gBACtC,uBAAuB,EAAE,KAAK;gBAC9B,YAAY,EAAE,UAAU;gBACxB,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC;aACpC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAClD,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,CAAC,MAAM,cAAc;gBAClD,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC7B,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"accept.js","sourceRoot":"","sources":["../../../src/adapters/twitter/accept.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,YAAY,GAChB,0GAA0G,CAAC;AAE7G,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,iCAAiC;IAC9C,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,gDAAgD;SAC9D;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,OAAO,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACxB,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,mCAAmC;gBACjC,oEAAoE,CACvE,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,6CAA6C,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QAE7E,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,YAAY,EAAE;gBACvC,cAAc,EAAE,GAAG;gBACnB,qBAAqB,EAAE,eAAe;gBACtC,uBAAuB,EAAE,KAAK;gBAC9B,YAAY,EAAE,UAAU;gBACxB,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC;aACpC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAClD,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,CAAC,MAAM,cAAc;gBAClD,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC7B,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/twitter/browser-fallback.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @owner   Twitter browser fallback extraction.
+ * @does    Reads X/Twitter search and trend results from the logged-in web UI.
+ * @needs   A user-owned Chrome session reachable by Uni-CLI's browser layer.
+ * @feeds   twitter.search and twitter.trending.
+ * @breaks  X/Twitter DOM changes can reduce parseable rows.
+ */
+import type { IPage } from "../../types.js";
+export interface TwitterTweetRow {
+    id: string;
+    author: string;
+    text: string;
+    likes: string;
+    retweets: string;
+    views: string;
+    url: string;
+}
+export interface TwitterTrendRow {
+    name: string;
+    tweet_count: string;
+    description: string;
+    url: string;
+}
+export declare function browserSearchTweets(page: IPage, query: string, limit: number): Promise<TwitterTweetRow[]>;
+export declare function browserTrendingTopics(page: IPage, limit: number): Promise<TwitterTrendRow[]>;
+//# sourceMappingURL=browser-fallback.d.ts.map

package/dist/adapters/twitter/browser-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-fallback.d.ts","sourceRoot":"","sources":["../../../src/adapters/twitter/browser-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAI5C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,KAAK,EACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,EAAE,CAAC,CAmD5B;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,KAAK,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,EAAE,CAAC,CAgD5B"}

package/dist/adapters/twitter/browser-fallback.js

@@ -0,0 +1,93 @@
+/**
+ * @owner   Twitter browser fallback extraction.
+ * @does    Reads X/Twitter search and trend results from the logged-in web UI.
+ * @needs   A user-owned Chrome session reachable by Uni-CLI's browser layer.
+ * @feeds   twitter.search and twitter.trending.
+ * @breaks  X/Twitter DOM changes can reduce parseable rows.
+ */
+import { socialEmptyError } from "../../social/browser-errors.js";
+import { assertTwitterReadable, gotoTwitterPage } from "./browser-state.js";
+export async function browserSearchTweets(page, query, limit) {
+    await gotoTwitterPage(page, `https://x.com/search?q=${encodeURIComponent(query)}&src=typed_query&f=live`, "search");
+    await page.autoScroll({ maxScrolls: 2, delay: 1000 });
+    await assertTwitterReadable(page, "search");
+    const raw = await page.evaluate(`
+    (() => {
+      const clean = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+      const rows = [];
+      const seen = new Set();
+      for (const article of document.querySelectorAll('article[data-testid="tweet"]')) {
+        const status = article.querySelector('a[href*="/status/"]');
+        const href = status?.getAttribute('href') || '';
+        const id = (href.match(/\\/status\\/(\\d+)/) || [])[1] || '';
+        if (!id || seen.has(id)) continue;
+        seen.add(id);
+        const text = Array.from(article.querySelectorAll('[data-testid="tweetText"]'))
+          .map((el) => clean(el.textContent || ''))
+          .filter(Boolean)
+          .join('\\n');
+        if (!text) continue;
+        const userName = clean(article.querySelector('[data-testid="User-Name"]')?.textContent || '');
+        const author = userName.split('@')[0] || userName;
+        const metric = (name) => clean(article.querySelector('[data-testid="' + name + '"]')?.textContent || '');
+        rows.push({
+          id,
+          author,
+          text,
+          likes: metric('like'),
+          retweets: metric('retweet'),
+          views: clean(article.querySelector('a[href$="/analytics"]')?.textContent || ''),
+          url: 'https://x.com' + href.split('?')[0],
+        });
+      }
+      return rows;
+    })()
+  `);
+    const rows = Array.isArray(raw)
+        ? raw.slice(0, limit)
+        : [];
+    if (rows.length > 0)
+        return rows;
+    throw socialEmptyError("twitter", "search", `Twitter/X search loaded no parseable tweets for "${query}".`);
+}
+export async function browserTrendingTopics(page, limit) {
+    await gotoTwitterPage(page, "https://x.com/explore/tabs/trending", "trending");
+    const raw = await page.evaluate(`
+    (() => {
+      const clean = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+      const rows = [];
+      const seen = new Set();
+      for (const link of document.querySelectorAll('a[href*="/search?q="]')) {
+        const href = link.getAttribute('href') || '';
+        let name = '';
+        try {
+          name = new URL(href, 'https://x.com').searchParams.get('q') || '';
+        } catch {}
+        const lines = clean(link.textContent || '')
+          .split(/(?=Trending|[0-9,.]+\\s+posts)/)
+          .map(clean)
+          .filter(Boolean);
+        if (!name) {
+          name = lines.find((line) => !/^Trending/i.test(line) && !/posts$/i.test(line)) || '';
+        }
+        if (!name || seen.has(name)) continue;
+        seen.add(name);
+        const meta = lines.find((line) => /posts$/i.test(line)) || '';
+        rows.push({
+          name,
+          tweet_count: meta,
+          description: lines.find((line) => /^Trending/i.test(line)) || '',
+          url: 'https://x.com' + href,
+        });
+      }
+      return rows;
+    })()
+  `);
+    const rows = Array.isArray(raw)
+        ? raw.slice(0, limit)
+        : [];
+    if (rows.length > 0)
+        return rows;
+    throw socialEmptyError("twitter", "trending", "Twitter/X explore loaded no parseable trend rows.");
+}
+//# sourceMappingURL=browser-fallback.js.map

package/dist/adapters/twitter/browser-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-fallback.js","sourceRoot":"","sources":["../../../src/adapters/twitter/browser-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAmB5E,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAW,EACX,KAAa,EACb,KAAa;IAEb,MAAM,eAAe,CACnB,IAAI,EACJ,0BAA0B,kBAAkB,CAAC,KAAK,CAAC,yBAAyB,EAC5E,QAAQ,CACT,CAAC;IACF,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,qBAAqB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAE5C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+B/B,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAC7B,CAAC,CAAE,GAAyB,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;QAC5C,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,gBAAgB,CACpB,SAAS,EACT,QAAQ,EACR,oDAAoD,KAAK,IAAI,CAC9D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAW,EACX,KAAa;IAEb,MAAM,eAAe,CACnB,IAAI,EACJ,qCAAqC,EACrC,UAAU,CACX,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8B/B,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAC7B,CAAC,CAAE,GAAyB,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;QAC5C,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,gBAAgB,CACpB,SAAS,EACT,UAAU,EACV,mDAAmD,CACpD,CAAC;AACJ,CAAC"}

package/dist/adapters/twitter/browser-state.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @owner   Twitter browser adapters.
+ * @does    Detects X/Twitter login and challenge pages in browser fallback flows.
+ * @needs   Browser-backed IPage from Uni-CLI runtime.
+ * @feeds   twitter.search and twitter.trending.
+ * @breaks  X/Twitter copy or route changes can require updating page-state detection.
+ */
+import type { IPage } from "../../types.js";
+export declare function gotoTwitterPage(page: IPage, url: string, command: string): Promise<void>;
+export declare function assertTwitterReadable(page: IPage, command: string): Promise<void>;
+//# sourceMappingURL=browser-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-state.d.ts","sourceRoot":"","sources":["../../../src/adapters/twitter/browser-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AA4B5C,wBAAsB,eAAe,CACnC,IAAI,EAAE,KAAK,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAmBf"}

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

@@ -0,0 +1,46 @@
+/**
+ * @owner   Twitter browser adapters.
+ * @does    Detects X/Twitter login and challenge pages in browser fallback flows.
+ * @needs   Browser-backed IPage from Uni-CLI runtime.
+ * @feeds   twitter.search and twitter.trending.
+ * @breaks  X/Twitter copy or route changes can require updating page-state detection.
+ */
+import { socialAuthError, socialChallengeError, } from "../../social/browser-errors.js";
+async function readTwitterPageState(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 async function gotoTwitterPage(page, url, command) {
+    try {
+        await page.goto(url, { settleMs: 2500 });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (!/net::ERR_ABORTED/i.test(message))
+            throw err;
+    }
+    await page.wait(2);
+    await assertTwitterReadable(page, command);
+}
+export async function assertTwitterReadable(page, command) {
+    const state = await readTwitterPageState(page);
+    const haystack = `${state.url}\n${state.title}\n${state.text}`;
+    if (/captcha|cloudflare|challenge|verify you are human|unusual traffic/i.test(haystack)) {
+        throw socialChallengeError("twitter", command, `Twitter/X is showing a challenge page: ${state.title || state.url}`);
+    }
+    if (/\/i\/flow\/login|Sign in to X|Log in to X|登录 X|登录后/i.test(haystack)) {
+        throw socialAuthError("twitter", command);
+    }
+}
+//# sourceMappingURL=browser-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-state.js","sourceRoot":"","sources":["../../../src/adapters/twitter/browser-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,eAAe,EACf,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AAQxC,KAAK,UAAU,oBAAoB,CAAC,IAAW;IAC7C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;;;;;;GAM/B,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,GAAgC,CAAC;IAC/C,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,CAAC,KAAK,UAAU,eAAe,CACnC,IAAW,EACX,GAAW,EACX,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,MAAM,GAAG,CAAC;IACpD,CAAC;IACD,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAW,EACX,OAAe;IAEf,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;IAC/D,IACE,oEAAoE,CAAC,IAAI,CACvE,QAAQ,CACT,EACD,CAAC;QACD,MAAM,oBAAoB,CACxB,SAAS,EACT,OAAO,EACP,0CAA0C,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,EAAE,CACrE,CAAC;IACJ,CAAC;IACD,IACE,qDAAqD,CAAC,IAAI,CAAC,QAAQ,CAAC,EACpE,CAAC;QACD,MAAM,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/adapters/twitter/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,6CAA6C;AAC7C,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAwB5C,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAY,GAC3C,OAAO,CAAC,OAAO,CAAC,CA4ClB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAY,GAC3C,OAAO,CAAC,OAAO,CAAC,CAyClB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,OAAO,CAAC,OAAO,CAAC,CAwClB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,OAAO,CAAC,OAAO,CAAC,CAwClB;AAED,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,SAAS,GAAG,IAAI,CAsClB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,OAAO,EAAE,GACtB,SAAS,EAAE,CAiEb;AAED,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,OAAO,EAAE,GACtB,QAAQ,EAAE,CA8CZ"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/adapters/twitter/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqDH,6CAA6C;AAC7C,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAwB5C,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAY,GAC3C,OAAO,CAAC,OAAO,CAAC,CAyClB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAY,GAC3C,OAAO,CAAC,OAAO,CAAC,CAsClB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,OAAO,CAAC,OAAO,CAAC,CAqClB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,OAAO,CAAC,OAAO,CAAC,CAqClB;AAED,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,SAAS,GAAG,IAAI,CAsClB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,OAAO,EAAE,GACtB,SAAS,EAAE,CAiEb;AAED,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,OAAO,EAAE,GACtB,QAAQ,EAAE,CA8CZ"}