x-twitter-scraper 0.3.0 → 0.4.0

data/lib/x_twitter_scraper.rb

@@ -74,13 +74,11 @@ require_relative "x_twitter_scraper/models/credit_topup_balance_response"
 require_relative "x_twitter_scraper/models/delivery"
 require_relative "x_twitter_scraper/models/draft"
 require_relative "x_twitter_scraper/models/draft_create_params"
-require_relative "x_twitter_scraper/models/draft_create_response"
 require_relative "x_twitter_scraper/models/draft_delete_params"
 require_relative "x_twitter_scraper/models/draft_detail"
 require_relative "x_twitter_scraper/models/draft_list_params"
 require_relative "x_twitter_scraper/models/draft_list_response"
 require_relative "x_twitter_scraper/models/draft_retrieve_params"
-require_relative "x_twitter_scraper/models/draft_retrieve_response"
 require_relative "x_twitter_scraper/models/draw_detail"
 require_relative "x_twitter_scraper/models/draw_export_params"
 require_relative "x_twitter_scraper/models/draw_list_item"
@@ -96,7 +94,6 @@ require_relative "x_twitter_scraper/models/event_detail"
 require_relative "x_twitter_scraper/models/event_list_params"
 require_relative "x_twitter_scraper/models/event_list_response"
 require_relative "x_twitter_scraper/models/event_retrieve_params"
-require_relative "x_twitter_scraper/models/event_retrieve_response"
 require_relative "x_twitter_scraper/models/event_type"
 require_relative "x_twitter_scraper/models/extraction_estimate_cost_params"
 require_relative "x_twitter_scraper/models/extraction_estimate_cost_response"
@@ -110,7 +107,6 @@ require_relative "x_twitter_scraper/models/extraction_run_params"
 require_relative "x_twitter_scraper/models/extraction_run_response"
 require_relative "x_twitter_scraper/models/integration"
 require_relative "x_twitter_scraper/models/integration_create_params"
-require_relative "x_twitter_scraper/models/integration_create_response"
 require_relative "x_twitter_scraper/models/integration_delete_params"
 require_relative "x_twitter_scraper/models/integration_delete_response"
 require_relative "x_twitter_scraper/models/integration_delivery"
@@ -119,11 +115,9 @@ require_relative "x_twitter_scraper/models/integration_list_deliveries_response"
 require_relative "x_twitter_scraper/models/integration_list_params"
 require_relative "x_twitter_scraper/models/integration_list_response"
 require_relative "x_twitter_scraper/models/integration_retrieve_params"
-require_relative "x_twitter_scraper/models/integration_retrieve_response"
 require_relative "x_twitter_scraper/models/integration_send_test_params"
 require_relative "x_twitter_scraper/models/integration_send_test_response"
 require_relative "x_twitter_scraper/models/integration_update_params"
-require_relative "x_twitter_scraper/models/integration_update_response"
 require_relative "x_twitter_scraper/models/monitor"
 require_relative "x_twitter_scraper/models/monitor_create_params"
 require_relative "x_twitter_scraper/models/monitor_create_response"
@@ -132,16 +126,13 @@ require_relative "x_twitter_scraper/models/monitor_deactivate_response"
 require_relative "x_twitter_scraper/models/monitor_list_params"
 require_relative "x_twitter_scraper/models/monitor_list_response"
 require_relative "x_twitter_scraper/models/monitor_retrieve_params"
-require_relative "x_twitter_scraper/models/monitor_retrieve_response"
 require_relative "x_twitter_scraper/models/monitor_update_params"
-require_relative "x_twitter_scraper/models/monitor_update_response"
 require_relative "x_twitter_scraper/models/paginated_tweets"
 require_relative "x_twitter_scraper/models/paginated_users"
 require_relative "x_twitter_scraper/models/radar_item"
 require_relative "x_twitter_scraper/models/radar_retrieve_trending_topics_params"
 require_relative "x_twitter_scraper/models/radar_retrieve_trending_topics_response"
 require_relative "x_twitter_scraper/models/style_analyze_params"
-require_relative "x_twitter_scraper/models/style_analyze_response"
 require_relative "x_twitter_scraper/models/style_compare_params"
 require_relative "x_twitter_scraper/models/style_compare_response"
 require_relative "x_twitter_scraper/models/style_delete_params"
@@ -152,9 +143,7 @@ require_relative "x_twitter_scraper/models/style_list_response"
 require_relative "x_twitter_scraper/models/style_profile"
 require_relative "x_twitter_scraper/models/style_profile_summary"
 require_relative "x_twitter_scraper/models/style_retrieve_params"
-require_relative "x_twitter_scraper/models/style_retrieve_response"
 require_relative "x_twitter_scraper/models/style_update_params"
-require_relative "x_twitter_scraper/models/style_update_response"
 require_relative "x_twitter_scraper/models/subscribe_create_params"
 require_relative "x_twitter_scraper/models/subscribe_create_response"
 require_relative "x_twitter_scraper/models/support/ticket_create_params"
@@ -181,8 +170,9 @@ require_relative "x_twitter_scraper/models/webhook_list_response"
 require_relative "x_twitter_scraper/models/webhook_test_params"
 require_relative "x_twitter_scraper/models/webhook_test_response"
 require_relative "x_twitter_scraper/models/webhook_update_params"
-require_relative "x_twitter_scraper/models/webhook_update_response"
 require_relative "x_twitter_scraper/models/winner"
+require_relative "x_twitter_scraper/models/x/account_bulk_retry_params"
+require_relative "x_twitter_scraper/models/x/account_bulk_retry_response"
 require_relative "x_twitter_scraper/models/x/account_create_params"
 require_relative "x_twitter_scraper/models/x/account_create_response"
 require_relative "x_twitter_scraper/models/x/account_delete_params"
@@ -192,15 +182,12 @@ require_relative "x_twitter_scraper/models/x/account_list_response"
 require_relative "x_twitter_scraper/models/x/account_reauth_params"
 require_relative "x_twitter_scraper/models/x/account_reauth_response"
 require_relative "x_twitter_scraper/models/x/account_retrieve_params"
-require_relative "x_twitter_scraper/models/x/account_retrieve_response"
 require_relative "x_twitter_scraper/models/x/bookmark_list_params"
-require_relative "x_twitter_scraper/models/x/bookmark_list_response"
 require_relative "x_twitter_scraper/models/x/bookmark_retrieve_folders_params"
 require_relative "x_twitter_scraper/models/x/bookmark_retrieve_folders_response"
 require_relative "x_twitter_scraper/models/x/communities/join_create_params"
-require_relative "x_twitter_scraper/models/x/communities/join_create_response"
 require_relative "x_twitter_scraper/models/x/communities/join_delete_all_params"
-require_relative "x_twitter_scraper/models/x/communities/join_delete_all_response"
+require_relative "x_twitter_scraper/models/x/communities/tweet_list_by_community_params"
 require_relative "x_twitter_scraper/models/x/communities/tweet_list_params"
 require_relative "x_twitter_scraper/models/x/community_action_result"
 require_relative "x_twitter_scraper/models/x/community_create_params"
@@ -239,15 +226,10 @@ require_relative "x_twitter_scraper/models/x/tweet_delete_params"
 require_relative "x_twitter_scraper/models/x/tweet_delete_response"
 require_relative "x_twitter_scraper/models/x/tweet_detail"
 require_relative "x_twitter_scraper/models/x/tweet_get_favoriters_params"
-require_relative "x_twitter_scraper/models/x/tweet_get_favoriters_response"
 require_relative "x_twitter_scraper/models/x/tweet_get_quotes_params"
-require_relative "x_twitter_scraper/models/x/tweet_get_quotes_response"
 require_relative "x_twitter_scraper/models/x/tweet_get_replies_params"
-require_relative "x_twitter_scraper/models/x/tweet_get_replies_response"
 require_relative "x_twitter_scraper/models/x/tweet_get_retweeters_params"
-require_relative "x_twitter_scraper/models/x/tweet_get_retweeters_response"
 require_relative "x_twitter_scraper/models/x/tweet_get_thread_params"
-require_relative "x_twitter_scraper/models/x/tweet_get_thread_response"
 require_relative "x_twitter_scraper/models/x/tweet_list_params"
 require_relative "x_twitter_scraper/models/x/tweet_retrieve_params"
 require_relative "x_twitter_scraper/models/x/tweet_retrieve_response"
@@ -260,23 +242,17 @@ require_relative "x_twitter_scraper/models/x/tweets/retweet_create_response"
 require_relative "x_twitter_scraper/models/x/tweets/retweet_delete_params"
 require_relative "x_twitter_scraper/models/x/tweets/retweet_delete_response"
 require_relative "x_twitter_scraper/models/x/tweet_search_params"
-require_relative "x_twitter_scraper/models/x/tweet_search_response"
 require_relative "x_twitter_scraper/models/x/user_profile"
 require_relative "x_twitter_scraper/models/x/user_retrieve_batch_params"
 require_relative "x_twitter_scraper/models/x/user_retrieve_followers_params"
 require_relative "x_twitter_scraper/models/x/user_retrieve_followers_you_know_params"
-require_relative "x_twitter_scraper/models/x/user_retrieve_followers_you_know_response"
 require_relative "x_twitter_scraper/models/x/user_retrieve_following_params"
 require_relative "x_twitter_scraper/models/x/user_retrieve_likes_params"
-require_relative "x_twitter_scraper/models/x/user_retrieve_likes_response"
 require_relative "x_twitter_scraper/models/x/user_retrieve_media_params"
-require_relative "x_twitter_scraper/models/x/user_retrieve_media_response"
 require_relative "x_twitter_scraper/models/x/user_retrieve_mentions_params"
 require_relative "x_twitter_scraper/models/x/user_retrieve_params"
-require_relative "x_twitter_scraper/models/x/user_retrieve_response"
 require_relative "x_twitter_scraper/models/x/user_retrieve_search_params"
 require_relative "x_twitter_scraper/models/x/user_retrieve_tweets_params"
-require_relative "x_twitter_scraper/models/x/user_retrieve_tweets_response"
 require_relative "x_twitter_scraper/models/x/user_retrieve_verified_followers_params"
 require_relative "x_twitter_scraper/models/x/users/follow_create_params"
 require_relative "x_twitter_scraper/models/x/users/follow_create_response"
@@ -287,10 +263,10 @@ require_relative "x_twitter_scraper/models/x/x_account_detail"
 require_relative "x_twitter_scraper/models/x_get_article_params"
 require_relative "x_twitter_scraper/models/x_get_article_response"
 require_relative "x_twitter_scraper/models/x_get_home_timeline_params"
-require_relative "x_twitter_scraper/models/x_get_home_timeline_response"
 require_relative "x_twitter_scraper/models/x_get_notifications_params"
 require_relative "x_twitter_scraper/models/x_get_notifications_response"
 require_relative "x_twitter_scraper/models/x_get_trends_params"
+require_relative "x_twitter_scraper/models/x_get_trends_response"
 require_relative "x_twitter_scraper/models"
 require_relative "x_twitter_scraper/resources/account"
 require_relative "x_twitter_scraper/resources/api_keys"

data/rbi/x_twitter_scraper/models/api_key.rbi

@@ -29,6 +29,7 @@ module XTwitterScraper
       sig { params(last_used_at: Time).void }
       attr_writer :last_used_at
 
+      # API key metadata returned when listing keys.
       sig do
         params(
           id: String,

data/rbi/x_twitter_scraper/models/api_key_list_response.rbi

@@ -11,93 +11,20 @@ module XTwitterScraper
           )
         end
 
-      sig do
-        returns(T::Array[XTwitterScraper::Models::APIKeyListResponse::Key])
-      end
+      sig { returns(T::Array[XTwitterScraper::APIKey]) }
       attr_accessor :keys
 
       sig do
-        params(
-          keys:
-            T::Array[XTwitterScraper::Models::APIKeyListResponse::Key::OrHash]
-        ).returns(T.attached_class)
+        params(keys: T::Array[XTwitterScraper::APIKey::OrHash]).returns(
+          T.attached_class
+        )
       end
       def self.new(keys:)
       end
 
-      sig do
-        override.returns(
-          { keys: T::Array[XTwitterScraper::Models::APIKeyListResponse::Key] }
-        )
-      end
+      sig { override.returns({ keys: T::Array[XTwitterScraper::APIKey] }) }
       def to_hash
       end
-
-      class Key < XTwitterScraper::Internal::Type::BaseModel
-        OrHash =
-          T.type_alias do
-            T.any(
-              XTwitterScraper::Models::APIKeyListResponse::Key,
-              XTwitterScraper::Internal::AnyHash
-            )
-          end
-
-        sig { returns(String) }
-        attr_accessor :id
-
-        sig { returns(Time) }
-        attr_accessor :created_at
-
-        sig { returns(T::Boolean) }
-        attr_accessor :is_active
-
-        sig { returns(String) }
-        attr_accessor :name
-
-        sig { returns(String) }
-        attr_accessor :prefix
-
-        sig { returns(T.nilable(Time)) }
-        attr_reader :last_used_at
-
-        sig { params(last_used_at: Time).void }
-        attr_writer :last_used_at
-
-        sig do
-          params(
-            id: String,
-            created_at: Time,
-            is_active: T::Boolean,
-            name: String,
-            prefix: String,
-            last_used_at: Time
-          ).returns(T.attached_class)
-        end
-        def self.new(
-          id:,
-          created_at:,
-          is_active:,
-          name:,
-          prefix:,
-          last_used_at: nil
-        )
-        end
-
-        sig do
-          override.returns(
-            {
-              id: String,
-              created_at: Time,
-              is_active: T::Boolean,
-              name: String,
-              prefix: String,
-              last_used_at: Time
-            }
-          )
-        end
-        def to_hash
-        end
-      end
     end
   end
 end

data/rbi/x_twitter_scraper/models/delivery.rbi

@@ -41,6 +41,7 @@ module XTwitterScraper
       sig { params(last_status_code: Integer).void }
       attr_writer :last_status_code
 
+      # Webhook delivery attempt record with status and retry count.
       sig do
         params(
           id: String,

data/rbi/x_twitter_scraper/models/draft.rbi

@@ -29,6 +29,7 @@ module XTwitterScraper
       sig { params(topic: String).void }
       attr_writer :topic
 
+      # Saved tweet draft with optional topic and goal.
       sig do
         params(
           id: String,

data/rbi/x_twitter_scraper/models/draft_detail.rbi

@@ -35,6 +35,7 @@ module XTwitterScraper
       sig { params(topic: String).void }
       attr_writer :topic
 
+      # Full tweet draft including update timestamp.
       sig do
         params(
           id: String,

data/rbi/x_twitter_scraper/models/draft_list_params.rbi

@@ -21,6 +21,7 @@ module XTwitterScraper
       sig { params(after_cursor: String).void }
       attr_writer :after_cursor
 
+      # Maximum number of items to return (1-100, default 50)
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
 
@@ -37,6 +38,7 @@ module XTwitterScraper
       def self.new(
         # Cursor for pagination
         after_cursor: nil,
+        # Maximum number of items to return (1-100, default 50)
         limit: nil,
         request_options: {}
       )

data/rbi/x_twitter_scraper/models/draft_list_response.rbi

@@ -11,9 +11,7 @@ module XTwitterScraper
           )
         end
 
-      sig do
-        returns(T::Array[XTwitterScraper::Models::DraftListResponse::Draft])
-      end
+      sig { returns(T::Array[XTwitterScraper::Draft]) }
       attr_accessor :drafts
 
       sig { returns(T::Boolean) }
@@ -27,8 +25,7 @@ module XTwitterScraper
 
       sig do
         params(
-          drafts:
-            T::Array[XTwitterScraper::Models::DraftListResponse::Draft::OrHash],
+          drafts: T::Array[XTwitterScraper::Draft::OrHash],
           has_more: T::Boolean,
           next_cursor: String
         ).returns(T.attached_class)
@@ -39,7 +36,7 @@ module XTwitterScraper
       sig do
         override.returns(
           {
-            drafts: T::Array[XTwitterScraper::Models::DraftListResponse::Draft],
+            drafts: T::Array[XTwitterScraper::Draft],
             has_more: T::Boolean,
             next_cursor: String
           }
@@ -47,63 +44,6 @@ module XTwitterScraper
       end
       def to_hash
       end
-
-      class Draft < XTwitterScraper::Internal::Type::BaseModel
-        OrHash =
-          T.type_alias do
-            T.any(
-              XTwitterScraper::Models::DraftListResponse::Draft,
-              XTwitterScraper::Internal::AnyHash
-            )
-          end
-
-        sig { returns(String) }
-        attr_accessor :id
-
-        sig { returns(Time) }
-        attr_accessor :created_at
-
-        sig { returns(String) }
-        attr_accessor :text
-
-        sig { returns(T.nilable(String)) }
-        attr_reader :goal
-
-        sig { params(goal: String).void }
-        attr_writer :goal
-
-        sig { returns(T.nilable(String)) }
-        attr_reader :topic
-
-        sig { params(topic: String).void }
-        attr_writer :topic
-
-        sig do
-          params(
-            id: String,
-            created_at: Time,
-            text: String,
-            goal: String,
-            topic: String
-          ).returns(T.attached_class)
-        end
-        def self.new(id:, created_at:, text:, goal: nil, topic: nil)
-        end
-
-        sig do
-          override.returns(
-            {
-              id: String,
-              created_at: Time,
-              text: String,
-              goal: String,
-              topic: String
-            }
-          )
-        end
-        def to_hash
-        end
-      end
     end
   end
 end

data/rbi/x_twitter_scraper/models/draw_detail.rbi

@@ -53,6 +53,7 @@ module XTwitterScraper
       sig { params(drawn_at: Time).void }
       attr_writer :drawn_at
 
+      # Full giveaway draw with tweet metrics, entries, and timing.
       sig do
         params(
           id: String,

data/rbi/x_twitter_scraper/models/draw_export_params.rbi

@@ -17,6 +17,7 @@ module XTwitterScraper
       sig { returns(String) }
       attr_accessor :id
 
+      # Export output format
       sig do
         returns(T.nilable(XTwitterScraper::DrawExportParams::Format::OrSymbol))
       end
@@ -50,6 +51,7 @@ module XTwitterScraper
       end
       def self.new(
         id:,
+        # Export output format
         format_: nil,
         # Export winners or all entries
         type: nil,
@@ -70,6 +72,7 @@ module XTwitterScraper
       def to_hash
       end
 
+      # Export output format
       module Format
         extend XTwitterScraper::Internal::Type::Enum
 

data/rbi/x_twitter_scraper/models/draw_list_item.rbi

@@ -35,6 +35,7 @@ module XTwitterScraper
       sig { params(drawn_at: Time).void }
       attr_writer :drawn_at
 
+      # Giveaway draw summary with entry counts and status.
       sig do
         params(
           id: String,

data/rbi/x_twitter_scraper/models/draw_list_params.rbi

@@ -14,13 +14,14 @@ module XTwitterScraper
           )
         end
 
-      # Cursor for pagination
+      # Cursor for keyset pagination
       sig { returns(T.nilable(String)) }
       attr_reader :after
 
       sig { params(after: String).void }
       attr_writer :after
 
+      # Maximum number of items to return (1-100, default 50)
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
 
@@ -35,8 +36,9 @@ module XTwitterScraper
         ).returns(T.attached_class)
       end
       def self.new(
-        # Cursor for pagination
+        # Cursor for keyset pagination
         after: nil,
+        # Maximum number of items to return (1-100, default 50)
         limit: nil,
         request_options: {}
       )

data/rbi/x_twitter_scraper/models/draw_list_response.rbi

@@ -11,7 +11,7 @@ module XTwitterScraper
           )
         end
 
-      sig { returns(T::Array[XTwitterScraper::Models::DrawListResponse::Draw]) }
+      sig { returns(T::Array[XTwitterScraper::DrawListItem]) }
       attr_accessor :draws
 
       sig { returns(T::Boolean) }
@@ -25,8 +25,7 @@ module XTwitterScraper
 
       sig do
         params(
-          draws:
-            T::Array[XTwitterScraper::Models::DrawListResponse::Draw::OrHash],
+          draws: T::Array[XTwitterScraper::DrawListItem::OrHash],
           has_more: T::Boolean,
           next_cursor: String
         ).returns(T.attached_class)
@@ -37,7 +36,7 @@ module XTwitterScraper
       sig do
         override.returns(
           {
-            draws: T::Array[XTwitterScraper::Models::DrawListResponse::Draw],
+            draws: T::Array[XTwitterScraper::DrawListItem],
             has_more: T::Boolean,
             next_cursor: String
           }
@@ -45,78 +44,6 @@ module XTwitterScraper
       end
       def to_hash
       end
-
-      class Draw < XTwitterScraper::Internal::Type::BaseModel
-        OrHash =
-          T.type_alias do
-            T.any(
-              XTwitterScraper::Models::DrawListResponse::Draw,
-              XTwitterScraper::Internal::AnyHash
-            )
-          end
-
-        sig { returns(String) }
-        attr_accessor :id
-
-        sig { returns(Time) }
-        attr_accessor :created_at
-
-        sig { returns(String) }
-        attr_accessor :status
-
-        sig { returns(Integer) }
-        attr_accessor :total_entries
-
-        sig { returns(String) }
-        attr_accessor :tweet_url
-
-        sig { returns(Integer) }
-        attr_accessor :valid_entries
-
-        sig { returns(T.nilable(Time)) }
-        attr_reader :drawn_at
-
-        sig { params(drawn_at: Time).void }
-        attr_writer :drawn_at
-
-        sig do
-          params(
-            id: String,
-            created_at: Time,
-            status: String,
-            total_entries: Integer,
-            tweet_url: String,
-            valid_entries: Integer,
-            drawn_at: Time
-          ).returns(T.attached_class)
-        end
-        def self.new(
-          id:,
-          created_at:,
-          status:,
-          total_entries:,
-          tweet_url:,
-          valid_entries:,
-          drawn_at: nil
-        )
-        end
-
-        sig do
-          override.returns(
-            {
-              id: String,
-              created_at: Time,
-              status: String,
-              total_entries: Integer,
-              tweet_url: String,
-              valid_entries: Integer,
-              drawn_at: Time
-            }
-          )
-        end
-        def to_hash
-        end
-      end
     end
   end
 end