@antcoder/birdxtwittercli 0.8.0

package/dist/lib/twitter-client-types.d.ts

@@ -0,0 +1,407 @@
+import type { TwitterCookies } from './cookies.js';
+export interface GraphqlMediaEntity {
+    id_str?: string;
+    media_url_https?: string;
+    type?: 'photo' | 'video' | 'animated_gif';
+    url?: string;
+    expanded_url?: string;
+    sizes?: {
+        thumb?: {
+            w: number;
+            h: number;
+            resize: string;
+        };
+        small?: {
+            w: number;
+            h: number;
+            resize: string;
+        };
+        medium?: {
+            w: number;
+            h: number;
+            resize: string;
+        };
+        large?: {
+            w: number;
+            h: number;
+            resize: string;
+        };
+    };
+    video_info?: {
+        duration_millis?: number;
+        variants?: Array<{
+            bitrate?: number;
+            content_type?: string;
+            url?: string;
+        }>;
+    };
+}
+export type GraphqlTweetResult = {
+    __typename?: string;
+    rest_id?: string;
+    legacy?: {
+        full_text?: string;
+        created_at?: string;
+        reply_count?: number;
+        retweet_count?: number;
+        favorite_count?: number;
+        conversation_id_str?: string;
+        in_reply_to_status_id_str?: string | null;
+        entities?: {
+            media?: GraphqlMediaEntity[];
+        };
+        extended_entities?: {
+            media?: GraphqlMediaEntity[];
+        };
+    };
+    core?: {
+        user_results?: {
+            result?: {
+                rest_id?: string;
+                id?: string;
+                legacy?: {
+                    screen_name?: string;
+                    name?: string;
+                };
+                core?: {
+                    screen_name?: string;
+                    name?: string;
+                };
+            };
+        };
+    };
+    note_tweet?: {
+        note_tweet_results?: {
+            result?: {
+                text?: string;
+                richtext?: {
+                    text?: string;
+                };
+                rich_text?: {
+                    text?: string;
+                };
+                content?: {
+                    text?: string;
+                    richtext?: {
+                        text?: string;
+                    };
+                    rich_text?: {
+                        text?: string;
+                    };
+                };
+            };
+        };
+    };
+    article?: {
+        title?: string;
+        preview_text?: string;
+        article_results?: {
+            result?: {
+                title?: string;
+                preview_text?: string;
+                plain_text?: string;
+                text?: string;
+                richtext?: {
+                    text?: string;
+                };
+                rich_text?: {
+                    text?: string;
+                };
+                body?: {
+                    text?: string;
+                    richtext?: {
+                        text?: string;
+                    };
+                    rich_text?: {
+                        text?: string;
+                    };
+                };
+                content?: {
+                    text?: string;
+                    richtext?: {
+                        text?: string;
+                    };
+                    rich_text?: {
+                        text?: string;
+                    };
+                    items?: Array<{
+                        text?: string;
+                        content?: {
+                            text?: string;
+                            richtext?: {
+                                text?: string;
+                            };
+                            rich_text?: {
+                                text?: string;
+                            };
+                        };
+                    }>;
+                };
+                sections?: Array<{
+                    items?: Array<{
+                        text?: string;
+                        content?: {
+                            text?: string;
+                            richtext?: {
+                                text?: string;
+                            };
+                            rich_text?: {
+                                text?: string;
+                            };
+                        };
+                    }>;
+                }>;
+                /** Draft.js content state for rich article content */
+                content_state?: {
+                    blocks: Array<{
+                        key: string;
+                        type: string;
+                        text: string;
+                        data?: Record<string, unknown>;
+                        entityRanges?: Array<{
+                            key: number;
+                            offset: number;
+                            length: number;
+                        }>;
+                        inlineStyleRanges?: Array<{
+                            offset: number;
+                            length: number;
+                            style: string;
+                        }>;
+                    }>;
+                    entityMap?: Array<{
+                        key: string;
+                        value: {
+                            type: string;
+                            mutability: string;
+                            data: Record<string, unknown>;
+                        };
+                    }> | Record<string, {
+                        type: string;
+                        mutability: string;
+                        data: Record<string, unknown>;
+                    }>;
+                };
+            };
+        };
+        plain_text?: string;
+        text?: string;
+        richtext?: {
+            text?: string;
+        };
+        rich_text?: {
+            text?: string;
+        };
+        body?: {
+            text?: string;
+            richtext?: {
+                text?: string;
+            };
+            rich_text?: {
+                text?: string;
+            };
+        };
+        content?: {
+            text?: string;
+            richtext?: {
+                text?: string;
+            };
+            rich_text?: {
+                text?: string;
+            };
+            items?: Array<{
+                text?: string;
+                content?: {
+                    text?: string;
+                    richtext?: {
+                        text?: string;
+                    };
+                    rich_text?: {
+                        text?: string;
+                    };
+                };
+            }>;
+        };
+        sections?: Array<{
+            items?: Array<{
+                text?: string;
+                content?: {
+                    text?: string;
+                    richtext?: {
+                        text?: string;
+                    };
+                    rich_text?: {
+                        text?: string;
+                    };
+                };
+            }>;
+        }>;
+    };
+    tweet?: GraphqlTweetResult;
+    quoted_status_result?: {
+        result?: GraphqlTweetResult;
+    };
+};
+export type TweetResult = {
+    success: true;
+    tweetId: string;
+} | {
+    success: false;
+    error: string;
+};
+export type BookmarkMutationResult = {
+    success: true;
+} | {
+    success: false;
+    error: string;
+};
+export type FollowMutationResult = {
+    success: true;
+    userId?: string;
+    username?: string;
+} | {
+    success: false;
+    error: string;
+};
+export interface UploadMediaResult {
+    success: boolean;
+    mediaId?: string;
+    error?: string;
+}
+export interface TweetMedia {
+    type: 'photo' | 'video' | 'animated_gif';
+    url: string;
+    previewUrl?: string;
+    width?: number;
+    height?: number;
+    videoUrl?: string;
+    durationMs?: number;
+}
+export interface TweetData {
+    id: string;
+    text: string;
+    author: {
+        username: string;
+        name: string;
+    };
+    authorId?: string;
+    createdAt?: string;
+    replyCount?: number;
+    retweetCount?: number;
+    likeCount?: number;
+    conversationId?: string;
+    inReplyToStatusId?: string;
+    quotedTweet?: TweetData;
+    media?: TweetMedia[];
+    article?: {
+        title: string;
+        previewText?: string;
+    };
+    _raw?: GraphqlTweetResult;
+}
+export interface TweetWithMeta extends TweetData {
+    isThread: boolean;
+    threadPosition: 'root' | 'middle' | 'end' | 'standalone';
+    hasSelfReplies: boolean;
+    threadRootId: string | null;
+}
+export interface GetTweetResult {
+    success: boolean;
+    tweet?: TweetData;
+    error?: string;
+}
+export type SearchResult = {
+    success: true;
+    tweets: TweetData[];
+    /** Cursor for fetching the next page of results */
+    nextCursor?: string;
+} | {
+    success: false;
+    error: string;
+    tweets?: TweetData[];
+    /** Cursor for fetching the next page of results */
+    nextCursor?: string;
+};
+export interface CurrentUserResult {
+    success: boolean;
+    user?: {
+        id: string;
+        username: string;
+        name: string;
+    };
+    error?: string;
+}
+export interface TwitterUser {
+    id: string;
+    username: string;
+    name: string;
+    description?: string;
+    followersCount?: number;
+    followingCount?: number;
+    isBlueVerified?: boolean;
+    profileImageUrl?: string;
+    createdAt?: string;
+}
+export interface FollowingResult {
+    success: boolean;
+    users?: TwitterUser[];
+    error?: string;
+    /** Cursor for fetching the next page of results */
+    nextCursor?: string;
+}
+export interface AboutAccountProfile {
+    accountBasedIn?: string;
+    source?: string;
+    createdCountryAccurate?: boolean;
+    locationAccurate?: boolean;
+    learnMoreUrl?: string;
+}
+export interface AboutAccountResult {
+    success: boolean;
+    aboutProfile?: AboutAccountProfile;
+    error?: string;
+}
+export interface TwitterClientOptions {
+    cookies: TwitterCookies;
+    userAgent?: string;
+    timeoutMs?: number;
+    quoteDepth?: number;
+}
+export interface TwitterList {
+    id: string;
+    name: string;
+    description?: string;
+    memberCount?: number;
+    subscriberCount?: number;
+    isPrivate?: boolean;
+    createdAt?: string;
+    owner?: {
+        id: string;
+        username: string;
+        name: string;
+    };
+}
+export interface ListsResult {
+    success: boolean;
+    lists?: TwitterList[];
+    error?: string;
+}
+export interface CreateTweetResponse {
+    data?: {
+        create_tweet?: {
+            tweet_results?: {
+                result?: {
+                    rest_id?: string;
+                    legacy?: {
+                        full_text?: string;
+                    };
+                };
+            };
+        };
+    };
+    errors?: Array<{
+        message: string;
+        code?: number;
+    }>;
+}
+//# sourceMappingURL=twitter-client-types.d.ts.map

package/dist/lib/twitter-client-types.d.ts.map

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

package/dist/lib/twitter-client-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=twitter-client-types.js.map

package/dist/lib/twitter-client-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twitter-client-types.js","sourceRoot":"","sources":["../../src/lib/twitter-client-types.ts"],"names":[],"mappings":""}

package/dist/lib/twitter-client-user-lookup.d.ts

@@ -0,0 +1,16 @@
+import type { AbstractConstructor, Mixin, TwitterClientBase } from './twitter-client-base.js';
+import type { AboutAccountResult } from './twitter-client-types.js';
+/** Result of username to userId lookup */
+export interface UserLookupResult {
+    success: boolean;
+    userId?: string;
+    username?: string;
+    name?: string;
+    error?: string;
+}
+export interface TwitterClientUserLookupMethods {
+    getUserIdByUsername(username: string): Promise<UserLookupResult>;
+    getUserAboutAccount(username: string): Promise<AboutAccountResult>;
+}
+export declare function withUserLookup<TBase extends AbstractConstructor<TwitterClientBase>>(Base: TBase): Mixin<TBase, TwitterClientUserLookupMethods>;
+//# sourceMappingURL=twitter-client-user-lookup.d.ts.map

package/dist/lib/twitter-client-user-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twitter-client-user-lookup.d.ts","sourceRoot":"","sources":["../../src/lib/twitter-client-user-lookup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE9F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,8BAA8B;IAC7C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACjE,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACpE;AAED,wBAAgB,cAAc,CAAC,KAAK,SAAS,mBAAmB,CAAC,iBAAiB,CAAC,EACjF,IAAI,EAAE,KAAK,GACV,KAAK,CAAC,KAAK,EAAE,8BAA8B,CAAC,CAyS9C"}

package/dist/lib/twitter-client-user-lookup.js

@@ -0,0 +1,224 @@
+import { normalizeHandle } from './normalize-handle.js';
+import { TWITTER_API_BASE } from './twitter-client-constants.js';
+export function withUserLookup(Base) {
+    class TwitterClientUserLookup extends Base {
+        // biome-ignore lint/complexity/noUselessConstructor lint/suspicious/noExplicitAny: TS mixin constructor requirement.
+        constructor(...args) {
+            super(...args);
+        }
+        async getUserByScreenNameGraphQL(screenName) {
+            // UserByScreenName query IDs observed from web client
+            const queryIds = ['xc8f1g7BYqr6VTzTbvNlGw', 'qW5u-DAuXpMEG0zA1F7UGQ', 'sLVLhk0bGj3MVFEKTdax1w'];
+            const variables = {
+                screen_name: screenName,
+                withSafetyModeUserFields: true,
+            };
+            const features = {
+                hidden_profile_subscriptions_enabled: true,
+                hidden_profile_likes_enabled: true,
+                rweb_tipjar_consumption_enabled: true,
+                responsive_web_graphql_exclude_directive_enabled: true,
+                verified_phone_label_enabled: false,
+                subscriptions_verification_info_is_identity_verified_enabled: true,
+                subscriptions_verification_info_verified_since_enabled: true,
+                highlights_tweets_tab_ui_enabled: true,
+                responsive_web_twitter_article_notes_tab_enabled: true,
+                subscriptions_feature_can_gift_premium: true,
+                creator_subscriptions_tweet_preview_api_enabled: true,
+                responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
+                responsive_web_graphql_timeline_navigation_enabled: true,
+                blue_business_profile_image_shape_enabled: true,
+            };
+            const fieldToggles = {
+                withAuxiliaryUserLabels: false,
+            };
+            const params = new URLSearchParams({
+                variables: JSON.stringify(variables),
+                features: JSON.stringify(features),
+                fieldToggles: JSON.stringify(fieldToggles),
+            });
+            let lastError;
+            for (const queryId of queryIds) {
+                const url = `${TWITTER_API_BASE}/${queryId}/UserByScreenName?${params.toString()}`;
+                try {
+                    const response = await this.fetchWithTimeout(url, {
+                        method: 'GET',
+                        headers: this.getHeaders(),
+                    });
+                    if (!response.ok) {
+                        const text = await response.text();
+                        if (response.status === 404) {
+                            // Try next query ID
+                            lastError = `HTTP ${response.status}`;
+                            continue;
+                        }
+                        lastError = `HTTP ${response.status}: ${text.slice(0, 200)}`;
+                        continue;
+                    }
+                    const data = (await response.json());
+                    // Check for user not found
+                    if (data.data?.user?.result?.__typename === 'UserUnavailable') {
+                        return { success: false, error: `User @${screenName} not found or unavailable` };
+                    }
+                    const userResult = data.data?.user?.result;
+                    const userId = userResult?.rest_id;
+                    const username = userResult?.legacy?.screen_name ?? userResult?.core?.screen_name;
+                    const name = userResult?.legacy?.name ?? userResult?.core?.name;
+                    if (userId && username) {
+                        return {
+                            success: true,
+                            userId,
+                            username,
+                            name,
+                        };
+                    }
+                    if (data.errors && data.errors.length > 0) {
+                        lastError = data.errors.map((e) => e.message).join(', ');
+                        continue;
+                    }
+                    lastError = 'Could not parse user data from response';
+                }
+                catch (error) {
+                    lastError = error instanceof Error ? error.message : String(error);
+                }
+            }
+            return { success: false, error: lastError ?? 'Unknown error looking up user' };
+        }
+        /**
+         * Look up a user's ID by their username/handle.
+         * Uses GraphQL UserByScreenName first, then falls back to REST on transient failures.
+         */
+        async getUserIdByUsername(username) {
+            const cleanUsername = normalizeHandle(username);
+            if (!cleanUsername) {
+                return { success: false, error: `Invalid username: ${username}` };
+            }
+            const graphqlResult = await this.getUserByScreenNameGraphQL(cleanUsername);
+            if (graphqlResult.success) {
+                return graphqlResult;
+            }
+            // If GraphQL definitively says user is unavailable, don't retry with REST
+            if (graphqlResult.error?.includes('not found or unavailable')) {
+                return graphqlResult;
+            }
+            // Fallback to REST API for transient GraphQL errors
+            const urls = [
+                `https://x.com/i/api/1.1/users/show.json?screen_name=${encodeURIComponent(cleanUsername)}`,
+                `https://api.twitter.com/1.1/users/show.json?screen_name=${encodeURIComponent(cleanUsername)}`,
+            ];
+            let lastError = graphqlResult.error;
+            for (const url of urls) {
+                try {
+                    const response = await this.fetchWithTimeout(url, {
+                        method: 'GET',
+                        headers: this.getHeaders(),
+                    });
+                    if (!response.ok) {
+                        const text = await response.text();
+                        if (response.status === 404) {
+                            return { success: false, error: `User @${cleanUsername} not found` };
+                        }
+                        lastError = `HTTP ${response.status}: ${text.slice(0, 200)}`;
+                        continue;
+                    }
+                    const data = (await response.json());
+                    const userId = data.id_str ?? (data.id ? String(data.id) : null);
+                    if (!userId) {
+                        lastError = 'Could not parse user ID from response';
+                        continue;
+                    }
+                    return {
+                        success: true,
+                        userId,
+                        username: data.screen_name ?? cleanUsername,
+                        name: data.name,
+                    };
+                }
+                catch (error) {
+                    lastError = error instanceof Error ? error.message : String(error);
+                }
+            }
+            return { success: false, error: lastError ?? 'Unknown error looking up user' };
+        }
+        async getAboutAccountQueryIds() {
+            const primary = await this.getQueryId('AboutAccountQuery');
+            return Array.from(new Set([primary, 'zs_jFPFT78rBpXv9Z3U2YQ']));
+        }
+        /**
+         * Get account origin and location information for a user.
+         * Returns data from Twitter's "About this account" feature.
+         */
+        async getUserAboutAccount(username) {
+            const cleanUsername = normalizeHandle(username);
+            if (!cleanUsername) {
+                return { success: false, error: `Invalid username: ${username}` };
+            }
+            const variables = {
+                screenName: cleanUsername,
+            };
+            const params = new URLSearchParams({
+                variables: JSON.stringify(variables),
+            });
+            const tryOnce = async () => {
+                let lastError;
+                let had404 = false;
+                const queryIds = await this.getAboutAccountQueryIds();
+                for (const queryId of queryIds) {
+                    const url = `${TWITTER_API_BASE}/${queryId}/AboutAccountQuery?${params.toString()}`;
+                    try {
+                        const response = await this.fetchWithTimeout(url, {
+                            method: 'GET',
+                            headers: this.getHeaders(),
+                        });
+                        if (!response.ok) {
+                            const text = await response.text();
+                            if (response.status === 404) {
+                                had404 = true;
+                                lastError = `HTTP ${response.status}`;
+                                continue;
+                            }
+                            lastError = `HTTP ${response.status}: ${text.slice(0, 200)}`;
+                            continue;
+                        }
+                        const data = (await response.json());
+                        if (data.errors && data.errors.length > 0) {
+                            lastError = data.errors.map((e) => e.message).join(', ');
+                            continue;
+                        }
+                        const aboutProfile = data.data?.user_result_by_screen_name?.result?.about_profile;
+                        if (!aboutProfile) {
+                            lastError = 'Missing about_profile in response';
+                            continue;
+                        }
+                        return {
+                            success: true,
+                            aboutProfile: {
+                                accountBasedIn: aboutProfile.account_based_in,
+                                source: aboutProfile.source,
+                                createdCountryAccurate: aboutProfile.created_country_accurate,
+                                locationAccurate: aboutProfile.location_accurate,
+                                learnMoreUrl: aboutProfile.learn_more_url,
+                            },
+                            had404,
+                        };
+                    }
+                    catch (error) {
+                        lastError = error instanceof Error ? error.message : String(error);
+                    }
+                }
+                return {
+                    success: false,
+                    error: lastError ?? 'Unknown error fetching account details',
+                    had404,
+                };
+            };
+            const { result } = await this.withRefreshedQueryIdsOn404(tryOnce);
+            if (result.success) {
+                return { success: true, aboutProfile: result.aboutProfile };
+            }
+            return { success: false, error: result.error };
+        }
+    }
+    return TwitterClientUserLookup;
+}
+//# sourceMappingURL=twitter-client-user-lookup.js.map