Struct LocalModeXClient 

pub struct LocalModeXClient { /* private fields */ }

X API client for local/scraper mode — no OAuth credentials required.

When a valid scraper_session.json exists in the data directory, operations are dispatched to the cookie-based transport. Otherwise, they return ScraperTransportUnavailable.

All transport calls are wrapped with retry_with_backoff so transient network errors and 5xx responses are retried automatically. Health is tracked in health and exposed via LocalModeXClient::health.

Implementations

impl LocalModeXClient

pub fn new(allow_mutations: bool) -> Self

Create a new local-mode client (no session — stub mode).

allow_mutations controls whether write operations are attempted (when true) or immediately rejected (when false).

pub async fn with_session(allow_mutations: bool, data_dir: &Path) -> Self

Create a local-mode client with cookie-auth from a session file.

If the session file exists and is valid, operations will use the cookie transport. Otherwise, falls back to stub behavior.

Auto-detects GraphQL query IDs from X’s web client JS bundles at startup.

pub async fn with_session_and_health( allow_mutations: bool, data_dir: &Path, health: ScraperHealth, ) -> Self

Create a local-mode client with cookie-auth and a shared health handle.

Use this instead of [with_session] when you want multiple ephemeral clients (e.g. one per HTTP request) to update the same health tracker held in AppState. Enables the /health endpoint to reflect real scraper health across the lifetime of the server process.

pub fn health(&self) -> ScraperHealth

Return a clone of the shared health handle.

Callers (e.g. the health endpoint) can snapshot the current state without coupling to the client implementation.

pub fn session_path(data_dir: &Path) -> PathBuf

Path to the session file in a given data directory.

Trait Implementations

impl XApiClient for LocalModeXClient

fn get_me<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<User, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get the authenticated user’s profile.

fn get_mentions<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, _user_id: &'life1 str, _since_id: Option<&'life2 str>, _pagination_token: Option<&'life3 str>, ) -> Pin<Box<dyn Future<Output = Result<MentionResponse, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Get mentions for the authenticated user.

fn get_home_timeline<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _user_id: &'life1 str, max_results: u32, pagination_token: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<SearchResponse, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Get the authenticated user’s home timeline (reverse chronological).

fn get_bookmarks<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _user_id: &'life1 str, max_results: u32, pagination_token: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<SearchResponse, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Get the authenticated user’s bookmarks.

fn bookmark_tweet<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _user_id: &'life1 str, tweet_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<bool, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Bookmark a tweet.

fn unbookmark_tweet<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _user_id: &'life1 str, tweet_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<bool, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Remove a bookmark.

fn search_tweets<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, query: &'life1 str, max_results: u32, _since_id: Option<&'life2 str>, pagination_token: Option<&'life3 str>, ) -> Pin<Box<dyn Future<Output = Result<SearchResponse, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Search recent tweets matching the given query.

fn get_tweet<'life0, 'life1, 'async_trait>( &'life0 self, tweet_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Tweet, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get a single tweet by ID.

fn get_user_by_username<'life0, 'life1, 'async_trait>( &'life0 self, username: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<User, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Look up a user by their username.

fn get_user_tweets<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, user_id: &'life1 str, max_results: u32, pagination_token: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<SearchResponse, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Get recent tweets from a specific user.

fn get_user_by_id<'life0, 'life1, 'async_trait>( &'life0 self, user_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<User, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get a user by their ID.

fn get_followers<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, user_id: &'life1 str, max_results: u32, pagination_token: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<UsersResponse, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Get followers of a user.

fn get_following<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, user_id: &'life1 str, max_results: u32, pagination_token: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<UsersResponse, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Get accounts a user is following.

fn get_users_by_ids<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _user_ids: &'life1 [&'life2 str], ) -> Pin<Box<dyn Future<Output = Result<UsersResponse, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Get multiple users by their IDs.

fn get_liked_tweets<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, user_id: &'life1 str, max_results: u32, pagination_token: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<SearchResponse, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Get tweets liked by a user.

fn get_tweet_liking_users<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _tweet_id: &'life1 str, _max_results: u32, _pagination_token: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<UsersResponse, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Get users who liked a specific tweet.

fn raw_request<'life0, 'life1, 'life2, 'life3, 'life4, 'life5, 'async_trait>( &'life0 self, _method: &'life1 str, _url: &'life2 str, _query: Option<&'life3 [(String, String)]>, _body: Option<&'life4 str>, _headers: Option<&'life5 [(String, String)]>, ) -> Pin<Box<dyn Future<Output = Result<RawApiResponse, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, 'life4: 'async_trait, 'life5: 'async_trait,

Execute a raw HTTP request against the X API.

fn post_tweet<'life0, 'life1, 'async_trait>( &'life0 self, text: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<PostedTweet, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Post a new tweet.

fn reply_to_tweet<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, text: &'life1 str, in_reply_to_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<PostedTweet, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Reply to an existing tweet.

fn post_tweet_with_media<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, text: &'life1 str, _media_ids: &'life2 [String], ) -> Pin<Box<dyn Future<Output = Result<PostedTweet, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Post a new tweet with media attachments.

fn reply_to_tweet_with_media<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, text: &'life1 str, in_reply_to_id: &'life2 str, _media_ids: &'life3 [String], ) -> Pin<Box<dyn Future<Output = Result<PostedTweet, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Reply to an existing tweet with media attachments.

fn quote_tweet<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _text: &'life1 str, _quoted_tweet_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<PostedTweet, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Post a quote tweet referencing another tweet.

fn like_tweet<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _user_id: &'life1 str, tweet_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<bool, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Like a tweet on behalf of the authenticated user.

fn unlike_tweet<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _user_id: &'life1 str, tweet_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<bool, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Unlike a tweet on behalf of the authenticated user.

fn follow_user<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _user_id: &'life1 str, target_user_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<bool, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Follow a user on behalf of the authenticated user.

fn unfollow_user<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _user_id: &'life1 str, target_user_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<bool, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Unfollow a user on behalf of the authenticated user.

fn retweet<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _user_id: &'life1 str, tweet_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<bool, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Retweet a tweet on behalf of the authenticated user.

fn unretweet<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _user_id: &'life1 str, tweet_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<bool, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Undo a retweet on behalf of the authenticated user.

fn delete_tweet<'life0, 'life1, 'async_trait>( &'life0 self, tweet_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<bool, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Delete a tweet by its ID.

fn upload_media<'life0, 'life1, 'async_trait>( &'life0 self, _data: &'life1 [u8], _media_type: MediaType, ) -> Pin<Box<dyn Future<Output = Result<MediaId, XApiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Upload media to X API for attaching to tweets.