x-twitter-scraper 0.4.2 → 0.4.4

data/rbi/x_twitter_scraper/models/x/account_connection_challenge_submit_params.rbi

@@ -0,0 +1,54 @@
+# typed: strong
+
+module XTwitterScraper
+  module Models
+    module X
+      class AccountConnectionChallengeSubmitParams < XTwitterScraper::Internal::Type::BaseModel
+        extend XTwitterScraper::Internal::Type::RequestParameters::Converter
+        include XTwitterScraper::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              XTwitterScraper::X::AccountConnectionChallengeSubmitParams,
+              XTwitterScraper::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Code sent to the account email.
+        sig { returns(String) }
+        attr_accessor :email_code
+
+        sig do
+          params(
+            id: String,
+            email_code: String,
+            request_options: XTwitterScraper::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          id:,
+          # Code sent to the account email.
+          email_code:,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              email_code: String,
+              request_options: XTwitterScraper::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/x_twitter_scraper/models/x/account_connection_challenge_submit_response.rbi

@@ -0,0 +1,131 @@
+# typed: strong
+
+module XTwitterScraper
+  module Models
+    module X
+      class AccountConnectionChallengeSubmitResponse < XTwitterScraper::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              XTwitterScraper::Models::X::AccountConnectionChallengeSubmitResponse,
+              XTwitterScraper::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        sig do
+          returns(
+            XTwitterScraper::Models::X::AccountConnectionChallengeSubmitResponse::Health::TaggedSymbol
+          )
+        end
+        attr_accessor :health
+
+        sig { returns(String) }
+        attr_accessor :status
+
+        sig { returns(String) }
+        attr_accessor :x_user_id
+
+        sig { returns(String) }
+        attr_accessor :x_username
+
+        # Sanitized X account summary returned by connect and reauth.
+        sig do
+          params(
+            id: String,
+            created_at: Time,
+            health:
+              XTwitterScraper::Models::X::AccountConnectionChallengeSubmitResponse::Health::OrSymbol,
+            status: String,
+            x_user_id: String,
+            x_username: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          id:,
+          created_at:,
+          health:,
+          status:,
+          x_user_id:,
+          x_username:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Time,
+              health:
+                XTwitterScraper::Models::X::AccountConnectionChallengeSubmitResponse::Health::TaggedSymbol,
+              status: String,
+              x_user_id: String,
+              x_username: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        module Health
+          extend XTwitterScraper::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                XTwitterScraper::Models::X::AccountConnectionChallengeSubmitResponse::Health
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          HEALTHY =
+            T.let(
+              :healthy,
+              XTwitterScraper::Models::X::AccountConnectionChallengeSubmitResponse::Health::TaggedSymbol
+            )
+          LOCKED =
+            T.let(
+              :locked,
+              XTwitterScraper::Models::X::AccountConnectionChallengeSubmitResponse::Health::TaggedSymbol
+            )
+          NEEDS_REAUTH =
+            T.let(
+              :needsReauth,
+              XTwitterScraper::Models::X::AccountConnectionChallengeSubmitResponse::Health::TaggedSymbol
+            )
+          RECOVERING =
+            T.let(
+              :recovering,
+              XTwitterScraper::Models::X::AccountConnectionChallengeSubmitResponse::Health::TaggedSymbol
+            )
+          SUSPENDED =
+            T.let(
+              :suspended,
+              XTwitterScraper::Models::X::AccountConnectionChallengeSubmitResponse::Health::TaggedSymbol
+            )
+          TEMPORARY_ISSUE =
+            T.let(
+              :temporaryIssue,
+              XTwitterScraper::Models::X::AccountConnectionChallengeSubmitResponse::Health::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                XTwitterScraper::Models::X::AccountConnectionChallengeSubmitResponse::Health::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/x_twitter_scraper/models/x/account_create_params.rbi

@@ -27,13 +27,6 @@ module XTwitterScraper
         sig { returns(String) }
         attr_accessor :username
 
-        # Proxy country code
-        sig { returns(T.nilable(String)) }
-        attr_reader :proxy_country
-
-        sig { params(proxy_country: String).void }
-        attr_writer :proxy_country
-
         # TOTP secret for 2FA
         sig { returns(T.nilable(String)) }
         attr_reader :totp_secret
@@ -46,7 +39,6 @@ module XTwitterScraper
             email: String,
             password: String,
             username: String,
-            proxy_country: String,
             totp_secret: String,
             request_options: XTwitterScraper::RequestOptions::OrHash
           ).returns(T.attached_class)
@@ -58,8 +50,6 @@ module XTwitterScraper
           password:,
           # X username
           username:,
-          # Proxy country code
-          proxy_country: nil,
           # TOTP secret for 2FA
           totp_secret: nil,
           request_options: {}
@@ -72,7 +62,6 @@ module XTwitterScraper
               email: String,
               password: String,
               username: String,
-              proxy_country: String,
               totp_secret: String,
               request_options: XTwitterScraper::RequestOptions
             }

data/rbi/x_twitter_scraper/models/x/account_create_response.rbi

@@ -15,6 +15,16 @@ module XTwitterScraper
         sig { returns(String) }
         attr_accessor :id
 
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        sig do
+          returns(
+            XTwitterScraper::Models::X::AccountCreateResponse::Health::TaggedSymbol
+          )
+        end
+        attr_accessor :health
+
         sig { returns(String) }
         attr_accessor :status
 
@@ -24,21 +34,35 @@ module XTwitterScraper
         sig { returns(String) }
         attr_accessor :x_username
 
+        # Sanitized X account summary returned by connect and reauth.
         sig do
           params(
             id: String,
+            created_at: Time,
+            health:
+              XTwitterScraper::Models::X::AccountCreateResponse::Health::OrSymbol,
             status: String,
             x_user_id: String,
             x_username: String
           ).returns(T.attached_class)
         end
-        def self.new(id:, status:, x_user_id:, x_username:)
+        def self.new(
+          id:,
+          created_at:,
+          health:,
+          status:,
+          x_user_id:,
+          x_username:
+        )
         end
 
         sig do
           override.returns(
             {
               id: String,
+              created_at: Time,
+              health:
+                XTwitterScraper::Models::X::AccountCreateResponse::Health::TaggedSymbol,
               status: String,
               x_user_id: String,
               x_username: String
@@ -47,6 +71,60 @@ module XTwitterScraper
         end
         def to_hash
         end
+
+        module Health
+          extend XTwitterScraper::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                XTwitterScraper::Models::X::AccountCreateResponse::Health
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          HEALTHY =
+            T.let(
+              :healthy,
+              XTwitterScraper::Models::X::AccountCreateResponse::Health::TaggedSymbol
+            )
+          LOCKED =
+            T.let(
+              :locked,
+              XTwitterScraper::Models::X::AccountCreateResponse::Health::TaggedSymbol
+            )
+          NEEDS_REAUTH =
+            T.let(
+              :needsReauth,
+              XTwitterScraper::Models::X::AccountCreateResponse::Health::TaggedSymbol
+            )
+          RECOVERING =
+            T.let(
+              :recovering,
+              XTwitterScraper::Models::X::AccountCreateResponse::Health::TaggedSymbol
+            )
+          SUSPENDED =
+            T.let(
+              :suspended,
+              XTwitterScraper::Models::X::AccountCreateResponse::Health::TaggedSymbol
+            )
+          TEMPORARY_ISSUE =
+            T.let(
+              :temporaryIssue,
+              XTwitterScraper::Models::X::AccountCreateResponse::Health::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                XTwitterScraper::Models::X::AccountCreateResponse::Health::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/x_twitter_scraper/models/x/account_reauth_params.rbi

@@ -22,6 +22,13 @@ module XTwitterScraper
         sig { returns(String) }
         attr_accessor :password
 
+        # Email for the X account (updates stored email)
+        sig { returns(T.nilable(String)) }
+        attr_reader :email
+
+        sig { params(email: String).void }
+        attr_writer :email
+
         # TOTP secret for 2FA re-authentication
         sig { returns(T.nilable(String)) }
         attr_reader :totp_secret
@@ -33,6 +40,7 @@ module XTwitterScraper
           params(
             id: String,
             password: String,
+            email: String,
             totp_secret: String,
             request_options: XTwitterScraper::RequestOptions::OrHash
           ).returns(T.attached_class)
@@ -41,6 +49,8 @@ module XTwitterScraper
           id:,
           # Updated account password
           password:,
+          # Email for the X account (updates stored email)
+          email: nil,
           # TOTP secret for 2FA re-authentication
           totp_secret: nil,
           request_options: {}
@@ -52,6 +62,7 @@ module XTwitterScraper
             {
               id: String,
               password: String,
+              email: String,
               totp_secret: String,
               request_options: XTwitterScraper::RequestOptions
             }

data/rbi/x_twitter_scraper/models/x/account_reauth_response.rbi

@@ -15,25 +15,116 @@ module XTwitterScraper
         sig { returns(String) }
         attr_accessor :id
 
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        sig do
+          returns(
+            XTwitterScraper::Models::X::AccountReauthResponse::Health::TaggedSymbol
+          )
+        end
+        attr_accessor :health
+
         sig { returns(String) }
         attr_accessor :status
 
+        sig { returns(String) }
+        attr_accessor :x_user_id
+
         sig { returns(String) }
         attr_accessor :x_username
 
+        # Sanitized X account summary returned by connect and reauth.
         sig do
-          params(id: String, status: String, x_username: String).returns(
-            T.attached_class
-          )
+          params(
+            id: String,
+            created_at: Time,
+            health:
+              XTwitterScraper::Models::X::AccountReauthResponse::Health::OrSymbol,
+            status: String,
+            x_user_id: String,
+            x_username: String
+          ).returns(T.attached_class)
         end
-        def self.new(id:, status:, x_username:)
+        def self.new(
+          id:,
+          created_at:,
+          health:,
+          status:,
+          x_user_id:,
+          x_username:
+        )
         end
 
         sig do
-          override.returns({ id: String, status: String, x_username: String })
+          override.returns(
+            {
+              id: String,
+              created_at: Time,
+              health:
+                XTwitterScraper::Models::X::AccountReauthResponse::Health::TaggedSymbol,
+              status: String,
+              x_user_id: String,
+              x_username: String
+            }
+          )
         end
         def to_hash
         end
+
+        module Health
+          extend XTwitterScraper::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                XTwitterScraper::Models::X::AccountReauthResponse::Health
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          HEALTHY =
+            T.let(
+              :healthy,
+              XTwitterScraper::Models::X::AccountReauthResponse::Health::TaggedSymbol
+            )
+          LOCKED =
+            T.let(
+              :locked,
+              XTwitterScraper::Models::X::AccountReauthResponse::Health::TaggedSymbol
+            )
+          NEEDS_REAUTH =
+            T.let(
+              :needsReauth,
+              XTwitterScraper::Models::X::AccountReauthResponse::Health::TaggedSymbol
+            )
+          RECOVERING =
+            T.let(
+              :recovering,
+              XTwitterScraper::Models::X::AccountReauthResponse::Health::TaggedSymbol
+            )
+          SUSPENDED =
+            T.let(
+              :suspended,
+              XTwitterScraper::Models::X::AccountReauthResponse::Health::TaggedSymbol
+            )
+          TEMPORARY_ISSUE =
+            T.let(
+              :temporaryIssue,
+              XTwitterScraper::Models::X::AccountReauthResponse::Health::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                XTwitterScraper::Models::X::AccountReauthResponse::Health::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/x_twitter_scraper/models/x/bookmark_retrieve_folders_response.rbi

@@ -21,9 +21,11 @@ module XTwitterScraper
         end
         attr_accessor :folders
 
+        # Always false for the current bookmark folder route
         sig { returns(T::Boolean) }
         attr_accessor :has_next_page
 
+        # Always empty for the current bookmark folder route
         sig { returns(String) }
         attr_accessor :next_cursor
 
@@ -37,7 +39,13 @@ module XTwitterScraper
             next_cursor: String
           ).returns(T.attached_class)
         end
-        def self.new(folders:, has_next_page:, next_cursor:)
+        def self.new(
+          folders:,
+          # Always false for the current bookmark folder route
+          has_next_page:,
+          # Always empty for the current bookmark folder route
+          next_cursor:
+        )
         end
 
         sig do

data/rbi/x_twitter_scraper/models/x/communities/join_create_response.rbi

@@ -0,0 +1,30 @@
+# typed: strong
+
+module XTwitterScraper
+  module Models
+    module X
+      module Communities
+        class JoinCreateResponse < XTwitterScraper::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                XTwitterScraper::Models::X::Communities::JoinCreateResponse,
+                XTwitterScraper::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T::Boolean) }
+          attr_accessor :success
+
+          sig { params(success: T::Boolean).returns(T.attached_class) }
+          def self.new(success: true)
+          end
+
+          sig { override.returns({ success: T::Boolean }) }
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/x_twitter_scraper/models/x/communities/join_delete_all_response.rbi

@@ -0,0 +1,30 @@
+# typed: strong
+
+module XTwitterScraper
+  module Models
+    module X
+      module Communities
+        class JoinDeleteAllResponse < XTwitterScraper::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                XTwitterScraper::Models::X::Communities::JoinDeleteAllResponse,
+                XTwitterScraper::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T::Boolean) }
+          attr_accessor :success
+
+          sig { params(success: T::Boolean).returns(T.attached_class) }
+          def self.new(success: true)
+          end
+
+          sig { override.returns({ success: T::Boolean }) }
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/x_twitter_scraper/models/x/communities/tweet_list_by_community_params.rbi

@@ -26,10 +26,22 @@ module XTwitterScraper
           sig { params(cursor: String).void }
           attr_writer :cursor
 
+          # Maximum items requested from this page (1-100, default 20). The response can
+          # contain fewer items because the source returned fewer, filters removed items, or
+          # remaining credits cover fewer results. Keep requesting next_cursor while
+          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # aliases remain accepted.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :page_size
+
+          sig { params(page_size: Integer).void }
+          attr_writer :page_size
+
           sig do
             params(
               id: String,
               cursor: String,
+              page_size: Integer,
               request_options: XTwitterScraper::RequestOptions::OrHash
             ).returns(T.attached_class)
           end
@@ -37,6 +49,12 @@ module XTwitterScraper
             id:,
             # Pagination cursor for community tweets
             cursor: nil,
+            # Maximum items requested from this page (1-100, default 20). The response can
+            # contain fewer items because the source returned fewer, filters removed items, or
+            # remaining credits cover fewer results. Keep requesting next_cursor while
+            # has_next_page is true, even when a page is empty. The deprecated limit and count
+            # aliases remain accepted.
+            page_size: nil,
             request_options: {}
           )
           end
@@ -46,6 +64,7 @@ module XTwitterScraper
               {
                 id: String,
                 cursor: String,
+                page_size: Integer,
                 request_options: XTwitterScraper::RequestOptions
               }
             )