x-twitter-scraper 0.6.0 → 0.7.0

data/rbi/x_twitter_scraper/models/x/account_connection_attempt_retrieve_response.rbi

@@ -10,18 +10,18 @@ module XTwitterScraper
         Variants =
           T.type_alias do
             T.any(
-              XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptPending,
-              XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptSuccess,
-              XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptFailed,
-              XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge
+              XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::Pending,
+              XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::Success,
+              XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::Failed,
+              XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::RequiresEmailCode
             )
           end
 
-        class XAccountConnectionAttemptPending < XTwitterScraper::Internal::Type::BaseModel
+        class Pending < XTwitterScraper::Internal::Type::BaseModel
           OrHash =
             T.type_alias do
               T.any(
-                XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptPending,
+                XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::Pending,
                 XTwitterScraper::Internal::AnyHash
               )
             end
@@ -67,13 +67,22 @@ module XTwitterScraper
           end
           def to_hash
           end
+
+          module Object
+            X_ACCOUNT_CONNECTION_ATTEMPT =
+              T.let(:x_account_connection_attempt, Symbol)
+          end
+
+          module Status
+            PENDING = T.let(:pending, Symbol)
+          end
         end
 
-        class XAccountConnectionAttemptSuccess < XTwitterScraper::Internal::Type::BaseModel
+        class Success < XTwitterScraper::Internal::Type::BaseModel
           OrHash =
             T.type_alias do
               T.any(
-                XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptSuccess,
+                XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::Success,
                 XTwitterScraper::Internal::AnyHash
               )
             end
@@ -105,13 +114,22 @@ module XTwitterScraper
           end
           def to_hash
           end
+
+          module Object
+            X_ACCOUNT_CONNECTION_ATTEMPT =
+              T.let(:x_account_connection_attempt, Symbol)
+          end
+
+          module Status
+            SUCCESS = T.let(:success, Symbol)
+          end
         end
 
-        class XAccountConnectionAttemptFailed < XTwitterScraper::Internal::Type::BaseModel
+        class Failed < XTwitterScraper::Internal::Type::BaseModel
           OrHash =
             T.type_alias do
               T.any(
-                XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptFailed,
+                XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::Failed,
                 XTwitterScraper::Internal::AnyHash
               )
             end
@@ -172,13 +190,22 @@ module XTwitterScraper
           end
           def to_hash
           end
+
+          module Object
+            X_ACCOUNT_CONNECTION_ATTEMPT =
+              T.let(:x_account_connection_attempt, Symbol)
+          end
+
+          module Status
+            FAILED = T.let(:failed, Symbol)
+          end
         end
 
-        class XAccountConnectionChallenge < XTwitterScraper::Internal::Type::BaseModel
+        class RequiresEmailCode < XTwitterScraper::Internal::Type::BaseModel
           OrHash =
             T.type_alias do
               T.any(
-                XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge,
+                XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::RequiresEmailCode,
                 XTwitterScraper::Internal::AnyHash
               )
             end
@@ -192,18 +219,10 @@ module XTwitterScraper
           sig { returns(String) }
           attr_accessor :message
 
-          sig do
-            returns(
-              XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Object::TaggedSymbol
-            )
-          end
+          sig { returns(Symbol) }
           attr_accessor :object
 
-          sig do
-            returns(
-              XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Status::TaggedSymbol
-            )
-          end
+          sig { returns(Symbol) }
           attr_accessor :status
 
           sig { returns(String) }
@@ -216,14 +235,19 @@ module XTwitterScraper
               id: String,
               expires_at: Time,
               message: String,
-              object:
-                XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Object::OrSymbol,
-              status:
-                XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Status::OrSymbol,
-              username: String
+              username: String,
+              object: Symbol,
+              status: Symbol
             ).returns(T.attached_class)
           end
-          def self.new(id:, expires_at:, message:, object:, status:, username:)
+          def self.new(
+            id:,
+            expires_at:,
+            message:,
+            username:,
+            object: :x_account_connection_challenge,
+            status: :requires_email_code
+          )
           end
 
           sig do
@@ -232,10 +256,8 @@ module XTwitterScraper
                 id: String,
                 expires_at: Time,
                 message: String,
-                object:
-                  XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Object::TaggedSymbol,
-                status:
-                  XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Status::TaggedSymbol,
+                object: Symbol,
+                status: Symbol,
                 username: String
               }
             )
@@ -244,64 +266,20 @@ module XTwitterScraper
           end
 
           module Object
-            extend XTwitterScraper::Internal::Type::Enum
-
-            TaggedSymbol =
-              T.type_alias do
-                T.all(
-                  Symbol,
-                  XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Object
-                )
-              end
-            OrSymbol = T.type_alias { T.any(Symbol, String) }
-
             X_ACCOUNT_CONNECTION_CHALLENGE =
-              T.let(
-                :x_account_connection_challenge,
-                XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Object::TaggedSymbol
-              )
-
-            sig do
-              override.returns(
-                T::Array[
-                  XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Object::TaggedSymbol
-                ]
-              )
-            end
-            def self.values
-            end
+              T.let(:x_account_connection_challenge, Symbol)
           end
 
           module Status
-            extend XTwitterScraper::Internal::Type::Enum
-
-            TaggedSymbol =
-              T.type_alias do
-                T.all(
-                  Symbol,
-                  XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Status
-                )
-              end
-            OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-            REQUIRES_EMAIL_CODE =
-              T.let(
-                :requires_email_code,
-                XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Status::TaggedSymbol
-              )
-
-            sig do
-              override.returns(
-                T::Array[
-                  XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Status::TaggedSymbol
-                ]
-              )
-            end
-            def self.values
-            end
+            REQUIRES_EMAIL_CODE = T.let(:requires_email_code, Symbol)
           end
         end
 
+        XAccountConnectionAttemptPending = Pending
+        XAccountConnectionAttemptSuccess = Success
+        XAccountConnectionAttemptFailed = Failed
+        XAccountConnectionChallenge = RequiresEmailCode
+
         sig do
           override.returns(
             T::Array[

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

@@ -29,7 +29,7 @@ module XTwitterScraper
         end
         attr_accessor :health
 
-        sig { returns(String) }
+        sig { returns(Symbol) }
         attr_accessor :status
 
         sig { returns(String) }
@@ -45,18 +45,18 @@ module XTwitterScraper
             created_at: Time,
             health:
               XTwitterScraper::Models::X::AccountConnectionChallengeSubmitResponse::Health::OrSymbol,
-            status: String,
             x_user_id: String,
-            x_username: String
+            x_username: String,
+            status: Symbol
           ).returns(T.attached_class)
         end
         def self.new(
           id:,
           created_at:,
           health:,
-          status:,
           x_user_id:,
-          x_username:
+          x_username:,
+          status: :active
         )
         end
 
@@ -67,7 +67,7 @@ module XTwitterScraper
               created_at: Time,
               health:
                 XTwitterScraper::Models::X::AccountConnectionChallengeSubmitResponse::Health::TaggedSymbol,
-              status: String,
+              status: Symbol,
               x_user_id: String,
               x_username: String
             }

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

@@ -7,8 +7,270 @@
 module XTwitterScraper
   module Models
     module X
-      AccountCreateResponse =
-        T.let(T.anything, XTwitterScraper::Internal::Type::Converter)
+      # Sanitized X account summary returned by connect and reauth.
+      module AccountCreateResponse
+        extend XTwitterScraper::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              XTwitterScraper::Models::X::AccountCreateResponse::SanitizedXAccount,
+              XTwitterScraper::Models::X::AccountCreateResponse::XAccountConnectionAttemptPending,
+              XTwitterScraper::Models::X::AccountCreateResponse::XAccountConnectionChallenge
+            )
+          end
+
+        class SanitizedXAccount < XTwitterScraper::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                XTwitterScraper::Models::X::AccountCreateResponse::SanitizedXAccount,
+                XTwitterScraper::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :id
+
+          sig { returns(Time) }
+          attr_accessor :created_at
+
+          sig do
+            returns(
+              XTwitterScraper::Models::X::AccountCreateResponse::SanitizedXAccount::Health::TaggedSymbol
+            )
+          end
+          attr_accessor :health
+
+          sig { returns(Symbol) }
+          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::AccountCreateResponse::SanitizedXAccount::Health::OrSymbol,
+              x_user_id: String,
+              x_username: String,
+              status: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            id:,
+            created_at:,
+            health:,
+            x_user_id:,
+            x_username:,
+            status: :active
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                created_at: Time,
+                health:
+                  XTwitterScraper::Models::X::AccountCreateResponse::SanitizedXAccount::Health::TaggedSymbol,
+                status: Symbol,
+                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::AccountCreateResponse::SanitizedXAccount::Health
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            HEALTHY =
+              T.let(
+                :healthy,
+                XTwitterScraper::Models::X::AccountCreateResponse::SanitizedXAccount::Health::TaggedSymbol
+              )
+            LOCKED =
+              T.let(
+                :locked,
+                XTwitterScraper::Models::X::AccountCreateResponse::SanitizedXAccount::Health::TaggedSymbol
+              )
+            NEEDS_REAUTH =
+              T.let(
+                :needsReauth,
+                XTwitterScraper::Models::X::AccountCreateResponse::SanitizedXAccount::Health::TaggedSymbol
+              )
+            RECOVERING =
+              T.let(
+                :recovering,
+                XTwitterScraper::Models::X::AccountCreateResponse::SanitizedXAccount::Health::TaggedSymbol
+              )
+            SUSPENDED =
+              T.let(
+                :suspended,
+                XTwitterScraper::Models::X::AccountCreateResponse::SanitizedXAccount::Health::TaggedSymbol
+              )
+            TEMPORARY_ISSUE =
+              T.let(
+                :temporaryIssue,
+                XTwitterScraper::Models::X::AccountCreateResponse::SanitizedXAccount::Health::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  XTwitterScraper::Models::X::AccountCreateResponse::SanitizedXAccount::Health::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
+        class XAccountConnectionAttemptPending < XTwitterScraper::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                XTwitterScraper::Models::X::AccountCreateResponse::XAccountConnectionAttemptPending,
+                XTwitterScraper::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :id
+
+          sig { returns(Symbol) }
+          attr_accessor :object
+
+          sig { returns(Integer) }
+          attr_accessor :poll_after_ms
+
+          sig { returns(Symbol) }
+          attr_accessor :status
+
+          # The connection is still in progress.
+          sig do
+            params(
+              id: String,
+              poll_after_ms: Integer,
+              object: Symbol,
+              status: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            id:,
+            poll_after_ms:,
+            object: :x_account_connection_attempt,
+            status: :pending
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                object: Symbol,
+                poll_after_ms: Integer,
+                status: Symbol
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        class XAccountConnectionChallenge < XTwitterScraper::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                XTwitterScraper::Models::X::AccountCreateResponse::XAccountConnectionChallenge,
+                XTwitterScraper::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :id
+
+          sig { returns(Time) }
+          attr_accessor :expires_at
+
+          sig { returns(String) }
+          attr_accessor :message
+
+          sig { returns(Symbol) }
+          attr_accessor :object
+
+          sig { returns(Symbol) }
+          attr_accessor :status
+
+          sig { returns(String) }
+          attr_accessor :username
+
+          # Resumable account connection challenge. Submit the email code to finish the same
+          # connection attempt.
+          sig do
+            params(
+              id: String,
+              expires_at: Time,
+              message: String,
+              username: String,
+              object: Symbol,
+              status: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            id:,
+            expires_at:,
+            message:,
+            username:,
+            object: :x_account_connection_challenge,
+            status: :requires_email_code
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                expires_at: Time,
+                message: String,
+                object: Symbol,
+                status: Symbol,
+                username: String
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        sig do
+          override.returns(
+            T::Array[
+              XTwitterScraper::Models::X::AccountCreateResponse::Variants
+            ]
+          )
+        end
+        def self.variants
+        end
+      end
     end
   end
 end

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

@@ -29,7 +29,7 @@ module XTwitterScraper
         end
         attr_accessor :health
 
-        sig { returns(String) }
+        sig { returns(Symbol) }
         attr_accessor :status
 
         sig { returns(String) }
@@ -45,18 +45,18 @@ module XTwitterScraper
             created_at: Time,
             health:
               XTwitterScraper::Models::X::AccountReauthResponse::Health::OrSymbol,
-            status: String,
             x_user_id: String,
-            x_username: String
+            x_username: String,
+            status: Symbol
           ).returns(T.attached_class)
         end
         def self.new(
           id:,
           created_at:,
           health:,
-          status:,
           x_user_id:,
-          x_username:
+          x_username:,
+          status: :active
         )
         end
 
@@ -67,7 +67,7 @@ module XTwitterScraper
               created_at: Time,
               health:
                 XTwitterScraper::Models::X::AccountReauthResponse::Health::TaggedSymbol,
-              status: String,
+              status: Symbol,
               x_user_id: String,
               x_username: String
             }

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

@@ -30,10 +30,8 @@ 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
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           sig { returns(T.nilable(Integer)) }
           attr_reader :page_size
@@ -53,10 +51,8 @@ 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
+            # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+            # results. Continue while has_next_page is true. Deprecated limit and count
             # aliases remain accepted.
             page_size: nil,
             request_options: {}

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

@@ -35,10 +35,8 @@ 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
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           sig { returns(T.nilable(Integer)) }
           attr_reader :page_size
@@ -82,10 +80,8 @@ module XTwitterScraper
             q:,
             # Pagination cursor for community results
             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
+            # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+            # results. Continue while has_next_page is true. Deprecated limit and count
             # aliases remain accepted.
             page_size: nil,
             # Sort order for community results (Latest or Top)