x-reader 0.1.0

package/dist/api/features.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Feature flags for different GraphQL operations.
+ * Extracted from Bird CLI v0.8.0 — X rotates these less frequently than query IDs.
+ */
+/** Features for TweetDetail operation */
+export declare function tweetDetailFeatures(): Record<string, boolean>;
+/** Features for SearchTimeline operation */
+export declare function searchFeatures(): Record<string, boolean>;
+/** Features for UserTweets operation */
+export declare function userTweetsFeatures(): Record<string, boolean>;
+/** Features for Bookmarks operation */
+export declare function bookmarksFeatures(): Record<string, boolean>;
+/** Field toggles for TweetDetail */
+export declare function tweetDetailFieldToggles(): Record<string, boolean>;

package/dist/api/features.js

@@ -0,0 +1,158 @@
+/**
+ * Feature flags for different GraphQL operations.
+ * Extracted from Bird CLI v0.8.0 — X rotates these less frequently than query IDs.
+ */
+/** Features for TweetDetail operation */
+export function tweetDetailFeatures() {
+    return {
+        rweb_video_screen_enabled: true,
+        profile_label_improvements_pcf_label_in_post_enabled: true,
+        responsive_web_profile_redirect_enabled: true,
+        rweb_tipjar_consumption_enabled: true,
+        verified_phone_label_enabled: false,
+        creator_subscriptions_tweet_preview_api_enabled: true,
+        responsive_web_graphql_timeline_navigation_enabled: true,
+        responsive_web_graphql_exclude_directive_enabled: true,
+        responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
+        premium_content_api_read_enabled: false,
+        communities_web_enable_tweet_community_results_fetch: true,
+        c9s_tweet_anatomy_moderator_badge_enabled: true,
+        responsive_web_grok_analyze_button_fetch_trends_enabled: false,
+        responsive_web_grok_analyze_post_followups_enabled: false,
+        responsive_web_grok_annotations_enabled: false,
+        responsive_web_jetfuel_frame: true,
+        post_ctas_fetch_enabled: true,
+        responsive_web_grok_share_attachment_enabled: true,
+        articles_preview_enabled: true,
+        responsive_web_edit_tweet_api_enabled: true,
+        graphql_is_translatable_rweb_tweet_is_translatable_enabled: true,
+        view_counts_everywhere_api_enabled: true,
+        longform_notetweets_consumption_enabled: true,
+        responsive_web_twitter_article_tweet_consumption_enabled: true,
+        tweet_awards_web_tipping_enabled: false,
+        responsive_web_grok_show_grok_translated_post: false,
+        responsive_web_grok_analysis_button_from_backend: true,
+        creator_subscriptions_quote_tweet_preview_enabled: false,
+        freedom_of_speech_not_reach_fetch_enabled: true,
+        standardized_nudges_misinfo: true,
+        tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled: true,
+        longform_notetweets_rich_text_read_enabled: true,
+        longform_notetweets_inline_media_enabled: true,
+        responsive_web_grok_image_annotation_enabled: true,
+        responsive_web_grok_imagine_annotation_enabled: true,
+        responsive_web_grok_community_note_auto_translation_is_enabled: false,
+        responsive_web_enhance_cards_enabled: false,
+        responsive_web_twitter_article_plain_text_enabled: true,
+        responsive_web_twitter_article_seed_tweet_detail_enabled: true,
+        responsive_web_twitter_article_seed_tweet_summary_enabled: true,
+    };
+}
+/** Features for SearchTimeline operation */
+export function searchFeatures() {
+    return {
+        rweb_video_screen_enabled: true,
+        profile_label_improvements_pcf_label_in_post_enabled: true,
+        responsive_web_profile_redirect_enabled: true,
+        rweb_tipjar_consumption_enabled: true,
+        verified_phone_label_enabled: false,
+        creator_subscriptions_tweet_preview_api_enabled: true,
+        responsive_web_graphql_timeline_navigation_enabled: true,
+        responsive_web_graphql_exclude_directive_enabled: true,
+        responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
+        premium_content_api_read_enabled: false,
+        communities_web_enable_tweet_community_results_fetch: true,
+        c9s_tweet_anatomy_moderator_badge_enabled: true,
+        responsive_web_grok_analyze_button_fetch_trends_enabled: false,
+        responsive_web_grok_analyze_post_followups_enabled: false,
+        responsive_web_grok_annotations_enabled: false,
+        responsive_web_jetfuel_frame: true,
+        post_ctas_fetch_enabled: true,
+        responsive_web_grok_share_attachment_enabled: true,
+        responsive_web_edit_tweet_api_enabled: true,
+        graphql_is_translatable_rweb_tweet_is_translatable_enabled: true,
+        view_counts_everywhere_api_enabled: true,
+        longform_notetweets_consumption_enabled: true,
+        responsive_web_twitter_article_tweet_consumption_enabled: true,
+        tweet_awards_web_tipping_enabled: false,
+        responsive_web_grok_show_grok_translated_post: false,
+        responsive_web_grok_analysis_button_from_backend: true,
+        creator_subscriptions_quote_tweet_preview_enabled: false,
+        freedom_of_speech_not_reach_fetch_enabled: true,
+        standardized_nudges_misinfo: true,
+        tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled: true,
+        rweb_video_timestamps_enabled: true,
+        longform_notetweets_rich_text_read_enabled: true,
+        longform_notetweets_inline_media_enabled: true,
+        responsive_web_grok_image_annotation_enabled: true,
+        responsive_web_grok_imagine_annotation_enabled: true,
+        responsive_web_grok_community_note_auto_translation_is_enabled: false,
+        articles_preview_enabled: true,
+        responsive_web_enhance_cards_enabled: false,
+    };
+}
+/** Features for UserTweets operation */
+export function userTweetsFeatures() {
+    return {
+        rweb_video_screen_enabled: false,
+        profile_label_improvements_pcf_label_in_post_enabled: true,
+        responsive_web_profile_redirect_enabled: false,
+        rweb_tipjar_consumption_enabled: true,
+        verified_phone_label_enabled: false,
+        creator_subscriptions_tweet_preview_api_enabled: true,
+        responsive_web_graphql_timeline_navigation_enabled: true,
+        responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
+        premium_content_api_read_enabled: false,
+        communities_web_enable_tweet_community_results_fetch: true,
+        c9s_tweet_anatomy_moderator_badge_enabled: true,
+        responsive_web_grok_analyze_button_fetch_trends_enabled: false,
+        responsive_web_grok_analyze_post_followups_enabled: true,
+        responsive_web_jetfuel_frame: true,
+        post_ctas_fetch_enabled: true,
+        responsive_web_grok_share_attachment_enabled: true,
+        responsive_web_grok_annotations_enabled: false,
+        articles_preview_enabled: true,
+        responsive_web_edit_tweet_api_enabled: true,
+        graphql_is_translatable_rweb_tweet_is_translatable_enabled: true,
+        view_counts_everywhere_api_enabled: true,
+        longform_notetweets_consumption_enabled: true,
+        responsive_web_twitter_article_tweet_consumption_enabled: true,
+        tweet_awards_web_tipping_enabled: false,
+        responsive_web_grok_show_grok_translated_post: true,
+        responsive_web_grok_analysis_button_from_backend: true,
+        creator_subscriptions_quote_tweet_preview_enabled: false,
+        freedom_of_speech_not_reach_fetch_enabled: true,
+        standardized_nudges_misinfo: true,
+        tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled: true,
+        longform_notetweets_rich_text_read_enabled: true,
+        longform_notetweets_inline_media_enabled: true,
+        responsive_web_grok_image_annotation_enabled: true,
+        responsive_web_grok_imagine_annotation_enabled: true,
+        responsive_web_grok_community_note_auto_translation_is_enabled: false,
+        responsive_web_enhance_cards_enabled: false,
+    };
+}
+/** Features for Bookmarks operation */
+export function bookmarksFeatures() {
+    return {
+        ...searchFeatures(),
+        graphql_timeline_v2_bookmark_timeline: true,
+        blue_business_profile_image_shape_enabled: true,
+        responsive_web_text_conversations_enabled: false,
+        tweetypie_unmention_optimization_enabled: true,
+        vibe_api_enabled: true,
+        responsive_web_twitter_blue_verified_badge_is_enabled: true,
+        interactive_text_enabled: true,
+        longform_notetweets_richtext_consumption_enabled: true,
+        responsive_web_media_download_video_enabled: false,
+    };
+}
+/** Field toggles for TweetDetail */
+export function tweetDetailFieldToggles() {
+    return {
+        withArticleRichContentState: true,
+        withArticlePlainText: true,
+        withGrokAnalyze: false,
+        withDisallowedReplyControls: false,
+    };
+}
+//# sourceMappingURL=features.js.map

package/dist/api/features.js.map

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

package/dist/api/parser.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Parse Twitter/X GraphQL API responses into clean Tweet and User objects.
+ * Extracted and cleaned up from Bird CLI v0.8.0.
+ */
+import type { Tweet, User } from './types.js';
+/**
+ * Parse a raw tweet result object into a clean Tweet.
+ */
+export declare function parseTweet(result: any, quoteDepth?: number, includeRaw?: boolean): Tweet | undefined;
+/**
+ * Parse tweets from timeline instructions array.
+ */
+export declare function parseTweetsFromInstructions(instructions: any[] | undefined, quoteDepth?: number, includeRaw?: boolean): Tweet[];
+/**
+ * Extract cursor from timeline instructions.
+ */
+export declare function extractCursor(instructions: any[] | undefined, type?: string): string | undefined;
+/**
+ * Parse users from timeline instructions (for followers/following).
+ */
+export declare function parseUsersFromInstructions(instructions: any[] | undefined): User[];
+/** Find a specific tweet result by ID in instructions */
+export declare function findTweetInInstructions(instructions: any[] | undefined, tweetId: string): any | undefined;

package/dist/api/parser.js

@@ -0,0 +1,236 @@
+/**
+ * Parse Twitter/X GraphQL API responses into clean Tweet and User objects.
+ * Extracted and cleaned up from Bird CLI v0.8.0.
+ */
+// ─── Text extraction ────────────────────────────────────────────
+function firstNonEmpty(...values) {
+    for (const v of values) {
+        if (typeof v === 'string') {
+            const trimmed = v.trim();
+            if (trimmed)
+                return trimmed;
+        }
+    }
+    return undefined;
+}
+/** Extract long-form note tweet text */
+function extractNoteTweetText(result) {
+    const note = result?.note_tweet?.note_tweet_results?.result;
+    if (!note)
+        return undefined;
+    return firstNonEmpty(note.text, note.richtext?.text, note.rich_text?.text, note.content?.text);
+}
+/** Extract article text from tweet */
+function extractArticleText(result) {
+    const article = result?.article;
+    if (!article)
+        return undefined;
+    const inner = article.article_results?.result ?? article;
+    const title = firstNonEmpty(inner.title, article.title);
+    const plainText = firstNonEmpty(inner.plain_text, article.plain_text, inner.body?.text, inner.content?.text, article.body?.text, article.content?.text);
+    if (plainText && title && !plainText.startsWith(title)) {
+        return `${title}\n${plainText}`;
+    }
+    return plainText ?? title;
+}
+/** Get the best text representation of a tweet */
+function extractTweetText(result) {
+    return extractArticleText(result) ?? extractNoteTweetText(result) ?? firstNonEmpty(result?.legacy?.full_text);
+}
+// ─── Media extraction ───────────────────────────────────────────
+function extractMedia(result) {
+    const mediaEntities = result?.legacy?.extended_entities?.media ?? result?.legacy?.entities?.media;
+    if (!mediaEntities?.length)
+        return undefined;
+    const items = [];
+    for (const m of mediaEntities) {
+        if (!m.type || !m.media_url_https)
+            continue;
+        const item = { type: m.type, url: m.media_url_https };
+        const sizes = m.sizes;
+        if (sizes?.large) {
+            item.width = sizes.large.w;
+            item.height = sizes.large.h;
+        }
+        else if (sizes?.medium) {
+            item.width = sizes.medium.w;
+            item.height = sizes.medium.h;
+        }
+        if (sizes?.small) {
+            item.previewUrl = `${m.media_url_https}:small`;
+        }
+        if ((m.type === 'video' || m.type === 'animated_gif') && m.video_info?.variants) {
+            const mp4s = m.video_info.variants.filter((v) => v.content_type === 'video/mp4' && typeof v.url === 'string');
+            const best = mp4s
+                .filter((v) => typeof v.bitrate === 'number')
+                .sort((a, b) => b.bitrate - a.bitrate)[0] ?? mp4s[0];
+            if (best)
+                item.videoUrl = best.url;
+            if (typeof m.video_info.duration_millis === 'number') {
+                item.durationMs = m.video_info.duration_millis;
+            }
+        }
+        items.push(item);
+    }
+    return items.length > 0 ? items : undefined;
+}
+// ─── Article preview ────────────────────────────────────────────
+function extractArticlePreview(result) {
+    const article = result?.article;
+    if (!article)
+        return undefined;
+    const inner = article.article_results?.result ?? article;
+    const title = firstNonEmpty(inner.title, article.title);
+    if (!title)
+        return undefined;
+    const previewText = firstNonEmpty(inner.preview_text, article.preview_text);
+    return { title, previewText };
+}
+// ─── Tweet parsing ──────────────────────────────────────────────
+function unwrapTweet(obj) {
+    if (!obj)
+        return undefined;
+    if (obj.tweet)
+        return obj.tweet;
+    return obj;
+}
+/**
+ * Parse a raw tweet result object into a clean Tweet.
+ */
+export function parseTweet(result, quoteDepth = 1, includeRaw = false) {
+    const userResult = result?.core?.user_results?.result;
+    const legacy = userResult?.legacy;
+    const core = userResult?.core;
+    const username = legacy?.screen_name ?? core?.screen_name;
+    const name = legacy?.name ?? core?.name ?? username;
+    const userId = userResult?.rest_id;
+    if (!result?.rest_id || !username)
+        return undefined;
+    const text = extractTweetText(result);
+    if (!text)
+        return undefined;
+    let quotedTweet;
+    if (quoteDepth > 0) {
+        const quotedRaw = unwrapTweet(result.quoted_status_result?.result);
+        if (quotedRaw) {
+            quotedTweet = parseTweet(quotedRaw, quoteDepth - 1, includeRaw);
+        }
+    }
+    const tweet = {
+        id: result.rest_id,
+        text,
+        createdAt: result.legacy?.created_at,
+        replyCount: result.legacy?.reply_count,
+        retweetCount: result.legacy?.retweet_count,
+        likeCount: result.legacy?.favorite_count,
+        conversationId: result.legacy?.conversation_id_str,
+        inReplyToStatusId: result.legacy?.in_reply_to_status_id_str ?? undefined,
+        author: { username, name: name || username },
+        authorId: userId,
+        quotedTweet,
+        media: extractMedia(result),
+        article: extractArticlePreview(result),
+    };
+    if (includeRaw)
+        tweet._raw = result;
+    return tweet;
+}
+// ─── Timeline instruction parsing ───────────────────────────────
+function extractTweetResultsFromEntry(entry) {
+    const results = [];
+    const push = (r) => { if (r?.rest_id)
+        results.push(r); };
+    const content = entry.content;
+    push(content?.itemContent?.tweet_results?.result);
+    push(content?.item?.itemContent?.tweet_results?.result);
+    for (const item of content?.items ?? []) {
+        push(item?.item?.itemContent?.tweet_results?.result);
+        push(item?.itemContent?.tweet_results?.result);
+        push(item?.content?.itemContent?.tweet_results?.result);
+    }
+    return results;
+}
+/**
+ * Parse tweets from timeline instructions array.
+ */
+export function parseTweetsFromInstructions(instructions, quoteDepth = 1, includeRaw = false) {
+    const tweets = [];
+    const seen = new Set();
+    for (const inst of instructions ?? []) {
+        for (const entry of inst.entries ?? []) {
+            const rawTweets = extractTweetResultsFromEntry(entry);
+            for (const raw of rawTweets) {
+                const tweet = parseTweet(raw, quoteDepth, includeRaw);
+                if (!tweet || seen.has(tweet.id))
+                    continue;
+                seen.add(tweet.id);
+                tweets.push(tweet);
+            }
+        }
+    }
+    return tweets;
+}
+/**
+ * Extract cursor from timeline instructions.
+ */
+export function extractCursor(instructions, type = 'Bottom') {
+    for (const inst of instructions ?? []) {
+        for (const entry of inst.entries ?? []) {
+            const content = entry.content;
+            if (content?.cursorType === type && typeof content.value === 'string' && content.value.length > 0) {
+                return content.value;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Parse users from timeline instructions (for followers/following).
+ */
+export function parseUsersFromInstructions(instructions) {
+    if (!instructions)
+        return [];
+    const users = [];
+    for (const inst of instructions) {
+        if (!inst.entries)
+            continue;
+        for (const entry of inst.entries) {
+            const userResult = entry?.content?.itemContent?.user_results?.result;
+            const resolved = userResult?.__typename === 'UserWithVisibilityResults' && userResult.user
+                ? userResult.user
+                : userResult;
+            if (!resolved || resolved.__typename !== 'User')
+                continue;
+            const { legacy, core } = resolved;
+            const username = legacy?.screen_name ?? core?.screen_name;
+            if (!resolved.rest_id || !username)
+                continue;
+            users.push({
+                id: resolved.rest_id,
+                username,
+                name: legacy?.name ?? core?.name ?? username,
+                description: legacy?.description,
+                followersCount: legacy?.followers_count,
+                followingCount: legacy?.friends_count,
+                isBlueVerified: resolved.is_blue_verified,
+                profileImageUrl: legacy?.profile_image_url_https ?? resolved.avatar?.image_url,
+                createdAt: legacy?.created_at ?? core?.created_at,
+            });
+        }
+    }
+    return users;
+}
+/** Find a specific tweet result by ID in instructions */
+export function findTweetInInstructions(instructions, tweetId) {
+    if (!instructions)
+        return undefined;
+    for (const inst of instructions) {
+        for (const entry of inst.entries ?? []) {
+            const raw = entry.content?.itemContent?.tweet_results?.result;
+            if (raw?.rest_id === tweetId)
+                return raw;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=parser.js.map

package/dist/api/parser.js.map

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

package/dist/api/query-ids.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Auto-discovery of Twitter/X GraphQL query IDs.
+ *
+ * X periodically rotates the query IDs embedded in their JS bundles.
+ * This module scrapes x.com pages to find the current bundle URLs,
+ * then parses those bundles to extract queryId ↔ operationName mappings.
+ *
+ * Falls back to hardcoded defaults if discovery fails.
+ */
+import type { QueryIdCache } from './types.js';
+export interface SnapshotInfo {
+    snapshot: QueryIdCache;
+    cachePath: string;
+    ageMs: number;
+    isFresh: boolean;
+}
+export declare function getSnapshotInfo(): Promise<SnapshotInfo | null>;
+/**
+ * Get a single query ID by operation name.
+ * Returns cached value, or falls back to hardcoded default.
+ */
+export declare function getQueryId(operation: string): Promise<string>;
+/**
+ * Refresh query IDs by scraping x.com JS bundles.
+ * Saves results to disk cache.
+ */
+export declare function refreshQueryIds(options?: {
+    force?: boolean;
+}): Promise<SnapshotInfo | null>;
+/** Clear in-memory cache (for testing) */
+export declare function clearMemory(): void;