@cm-growth-hacking/twitter-client 0.2.0

package/dist/cli/output.d.ts

@@ -0,0 +1,22 @@
+import type { Tweet, User, NewsItem } from '../client/types.js';
+/**
+ * Format a tweet for display
+ */
+export declare function formatTweet(tweet: Tweet, showMetrics?: boolean): string;
+/**
+ * Format a user for display
+ */
+export declare function formatUser(user: User): string;
+/**
+ * Format a news item for display
+ */
+export declare function formatNewsItem(item: NewsItem, index: number): string;
+/**
+ * Format error message
+ */
+export declare function formatError(error: string, code?: string): string;
+/**
+ * Print a separator line
+ */
+export declare function separator(char?: string, length?: number): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/cli/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,GAAE,OAAc,GAAG,MAAM,CAc7E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAe7C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBpE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAMhE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAY,EAAE,MAAM,GAAE,MAAW,GAAG,MAAM,CAEzE"}

package/dist/cli/output.js

@@ -0,0 +1,71 @@
+/**
+ * Format a tweet for display
+ */
+export function formatTweet(tweet, showMetrics = true) {
+    let output = `@${tweet.author.username} (${tweet.author.name})\n`;
+    output += `${tweet.text}\n`;
+    if (showMetrics) {
+        const metrics = [];
+        if (tweet.replyCount > 0)
+            metrics.push(`${tweet.replyCount} replies`);
+        if (tweet.retweetCount > 0)
+            metrics.push(`${tweet.retweetCount} retweets`);
+        if (tweet.likeCount > 0)
+            metrics.push(`${tweet.likeCount} likes`);
+        if (metrics.length > 0)
+            output += `\n${metrics.join(' · ')}`;
+    }
+    output += `\nhttps://x.com/${tweet.author.username}/status/${tweet.id}`;
+    return output;
+}
+/**
+ * Format a user for display
+ */
+export function formatUser(user) {
+    let output = `@${user.username} (${user.name})\n`;
+    if (user.description) {
+        output += `${user.description}\n`;
+    }
+    const metrics = [];
+    if (user.followersCount)
+        metrics.push(`${user.followersCount} followers`);
+    if (user.followingCount)
+        metrics.push(`${user.followingCount} following`);
+    if (metrics.length > 0)
+        output += `\n${metrics.join(' · ')}`;
+    if (user.isBlueVerified)
+        output += '\n✓ Blue Verified';
+    return output;
+}
+/**
+ * Format a news item for display
+ */
+export function formatNewsItem(item, index) {
+    let output = `${index + 1}. ${item.headline}`;
+    if (item.category) {
+        output += ` [${item.category}]`;
+    }
+    if (item.timeAgo) {
+        output += ` · ${item.timeAgo}`;
+    }
+    if (item.postCount) {
+        output += ` · ${item.postCount} posts`;
+    }
+    return output;
+}
+/**
+ * Format error message
+ */
+export function formatError(error, code) {
+    let output = `Error: ${error}`;
+    if (code) {
+        output += ` (${code})`;
+    }
+    return output;
+}
+/**
+ * Print a separator line
+ */
+export function separator(char = '─', length = 40) {
+    return char.repeat(length);
+}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,196 @@
+#!/usr/bin/env bun
+import { TwitterClient } from './index.js';
+const AUTH_TOKEN = process.env.TWITTER_AUTH_TOKEN || '';
+const CT0 = process.env.TWITTER_CT0 || '';
+if (!AUTH_TOKEN || !CT0) {
+    console.error('Error: TWITTER_AUTH_TOKEN and TWITTER_CT0 environment variables must be set');
+    process.exit(1);
+}
+const client = new TwitterClient({
+    authToken: AUTH_TOKEN,
+    ct0: CT0,
+});
+const args = process.argv.slice(2);
+const command = args[0];
+async function main() {
+    switch (command) {
+        case 'whoami': {
+            const result = await client.whoami();
+            if (!result.success) {
+                console.error(`Error: ${result.error}`);
+                // Provide helpful hints
+                if (result.code === 'AUTH_FAILED') {
+                    console.error('\nAuthentication failed. Please set these environment variables:');
+                    console.error('  export TWITTER_AUTH_TOKEN="your_auth_token"');
+                    console.error('  export TWITTER_CT0="your_ct0_token"');
+                    console.error('\nGet credentials from browser DevTools → Application → Cookies → twitter.com');
+                }
+                else if (result.code === 'STALE_QUERY_ID') {
+                    console.error('\nQuery ID may be stale. Try updating:');
+                    console.error('  bird update-query-ids');
+                }
+                process.exit(1);
+            }
+            console.log(`Logged in as: @${result.user.username} (${result.user.name})`);
+            console.log(`User ID: ${result.user.id}`);
+            if (result.user.followersCount !== undefined) {
+                console.log(`Followers: ${result.user.followersCount.toLocaleString()}`);
+            }
+            if (result.user.followingCount !== undefined) {
+                console.log(`Following: ${result.user.followingCount.toLocaleString()}`);
+            }
+            break;
+        }
+        case 'search': {
+            const latestFlag = args.includes('--latest');
+            const filteredArgs = args.filter(arg => arg !== '--latest');
+            const query = filteredArgs[1];
+            if (!query) {
+                console.error('Usage: bun run src/cli.ts search [--latest] <query>');
+                process.exit(1);
+            }
+            const result = await client.search(query, 20, latestFlag ? 'Latest' : 'Top');
+            if (result.success) {
+                result.tweets.forEach((tweet) => {
+                    console.log(`@${tweet.author.username}: ${tweet.text}`);
+                    console.log(`Likes: ${tweet.likeCount} Retweets: ${tweet.retweetCount}\n`);
+                });
+            }
+            else {
+                console.error(`Error: ${result.error}`);
+                process.exit(1);
+            }
+            break;
+        }
+        case 'tweet': {
+            const text = args.slice(1).join(' ');
+            if (!text) {
+                console.error('Usage: bun run src/cli.ts tweet <text>');
+                process.exit(1);
+            }
+            const result = await client.tweet(text);
+            if (result.success) {
+                console.log(`Tweet posted! ID: ${result.tweetId}`);
+                console.log(`https://x.com/user/status/${result.tweetId}`);
+            }
+            else {
+                // Check for error 226 (automated detection)
+                if (result.error?.includes('226') || result.error?.includes('automated')) {
+                    console.error('✗ Tweet rejected by Twitter: "Looks automated"');
+                    console.error('');
+                    console.error('This usually means:');
+                    console.error('  • Account is new or has low activity');
+                    console.error('  • Tweets need more variation/personal touch');
+                    console.error('  • Try posting from the web interface first');
+                }
+                else {
+                    console.error(`✗ Error: ${result.error}`);
+                }
+                process.exit(1);
+            }
+            break;
+        }
+        case 'get': {
+            const tweetId = args[1];
+            if (!tweetId) {
+                console.error('Usage: bun run src/cli.ts get <tweet_id_or_url>');
+                process.exit(1);
+            }
+            const result = await client.getTweet(tweetId);
+            if (result.success) {
+                const tweet = result.tweet;
+                console.log(`@${tweet.author.username} (@${tweet.author.name})`);
+                console.log(`${tweet.text}`);
+                console.log(`\nLikes: ${tweet.likeCount} Retweets: ${tweet.retweetCount} Replies: ${tweet.replyCount}`);
+                console.log(`https://x.com/${tweet.author.username}/status/${tweet.id}`);
+            }
+            else {
+                console.error(`Error: ${result.error}`);
+                process.exit(1);
+            }
+            break;
+        }
+        case 'user': {
+            const username = args[1];
+            if (!username) {
+                console.error('Usage: bun run src/cli.ts user <username>');
+                process.exit(1);
+            }
+            const result = await client.getUserTweets(username);
+            if (result.success) {
+                result.tweets.forEach((tweet) => {
+                    console.log(`@${tweet.author.username}: ${tweet.text}`);
+                    console.log(`Likes: ${tweet.likeCount} Retweets: ${tweet.retweetCount}\n`);
+                });
+            }
+            else {
+                console.error(`Error: ${result.error}`);
+                process.exit(1);
+            }
+            break;
+        }
+        case 'news': {
+            const result = await client.getNews();
+            if (result.success) {
+                result.items.forEach((item, i) => {
+                    console.log(`${i + 1}. ${item.headline}`);
+                    if (item.tweets && item.tweets[0]) {
+                        console.log(`   @${item.tweets[0].author.username}\n`);
+                    }
+                });
+            }
+            else {
+                console.error(`Error: ${result.error}`);
+                process.exit(1);
+            }
+            break;
+        }
+        case 'mentions': {
+            const result = await client.getMentions();
+            if (result.success) {
+                result.tweets.forEach((tweet) => {
+                    console.log(`@${tweet.author.username}: ${tweet.text}`);
+                    console.log(`Likes: ${tweet.likeCount} Retweets: ${tweet.retweetCount}\n`);
+                });
+            }
+            else {
+                console.error(`Error: ${result.error}`);
+                process.exit(1);
+            }
+            break;
+        }
+        case 'update-query-ids': {
+            const { QueryIdManager } = await import('./client/query-ids.js');
+            const manager = new QueryIdManager();
+            const result = await manager.updateQueryIds({ force: args.includes('--fresh') });
+            if (result.updated === 0) {
+                console.log('Query IDs are up to date (cache is fresh).');
+            }
+            else {
+                console.log(`✓ Updated ${result.updated} query ID(s):`);
+                result.changes.forEach(change => {
+                    console.log(`  ${change}`);
+                });
+            }
+            break;
+        }
+        default:
+            console.log('Twitter Client CLI');
+            console.log('\nCommands:');
+            console.log('  whoami                    - Show current user info');
+            console.log('  search [--latest] <query>   - Search for tweets (default: top, use --latest for recent)');
+            console.log('  tweet <text>              - Post a tweet');
+            console.log('  get <tweet_id>            - Get a tweet by ID or URL');
+            console.log('  user <username>           - Get tweets from a user');
+            console.log('  news                      - Get news timeline');
+            console.log('  mentions                  - Get mentions timeline');
+            console.log('  update-query-ids [--fresh] - Update query IDs from Twitter');
+            console.log('\nFlags:');
+            console.log('  --fresh                   - Force refresh even if cache is fresh');
+            break;
+    }
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/dist/client/TwitterClient.d.ts

@@ -0,0 +1,47 @@
+import type { TweetResult, TweetsResult, PostResult, UserResult, SearchResult, NewsResult, ThreadResult } from './types.js';
+export declare class TwitterClient {
+    private graphql;
+    private rest;
+    constructor(options: {
+        authToken: string;
+        ct0: string;
+        timeout?: number;
+    });
+    /**
+     * Verify authentication and get current user info
+     */
+    whoami(): Promise<UserResult>;
+    /**
+     * Search for tweets
+     */
+    search(query: string, count?: number, product?: 'Top' | 'Latest'): Promise<SearchResult>;
+    /**
+     * Get a single tweet by ID or URL
+     */
+    getTweet(tweetIdOrUrl: string): Promise<TweetResult>;
+    /**
+     * Get thread (conversation) for a tweet
+     */
+    getThread(tweetIdOrUrl: string): Promise<ThreadResult>;
+    /**
+     * Get tweets from a user's timeline
+     */
+    getUserTweets(username: string, count?: number, cursor?: string): Promise<TweetsResult>;
+    /**
+     * Post a new tweet
+     */
+    tweet(text: string): Promise<PostResult>;
+    /**
+     * Reply to a tweet
+     */
+    reply(tweetId: string, text: string): Promise<PostResult>;
+    /**
+     * Get news/for you timeline
+     */
+    getNews(count?: number): Promise<NewsResult>;
+    /**
+     * Get mentions timeline
+     */
+    getMentions(count?: number): Promise<TweetsResult>;
+}
+//# sourceMappingURL=TwitterClient.d.ts.map

package/dist/client/TwitterClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TwitterClient.d.ts","sourceRoot":"","sources":["../../src/client/TwitterClient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,IAAI,CAAa;gBAEb,OAAO,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAeD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC;IAyCnC;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,EAClB,OAAO,GAAE,KAAK,GAAG,QAAgB,GAChC,OAAO,CAAC,YAAY,CAAC;IAqFxB;;OAEG;IACG,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAiD1D;;OAEG;IACG,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAe5D;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA4HjG;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA2E9C;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA6D/D;;OAEG;IACG,OAAO,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAmDtD;;OAEG;IACG,WAAW,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CA2C7D"}