x-twitter-scraper 0.5.5 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 507ab6a6c95d37cb384e2f58798114aa6c6eb9e1b96f9e93b68a1b055505fe45
-  data.tar.gz: df6cd93380b6b3879eab159fe27a9c93df488cf2f1909986d233a84aa5160bdb
+  metadata.gz: f77c7d16b32e28457098d4f022f31953508d3daa2c132fd88351825b689f6741
+  data.tar.gz: 5183d601d54d0a035443e1cafb2dceceb4278130a0a9674b128b39f91f6f6fca
 SHA512:
-  metadata.gz: 9bdbb2173f56c8e71cd9b9706e6f91b56789aa6e51caf2c0ad0a91e67f20425b32c2dae8e2297ea6bf51de7e3f71263fe5c81237caf8477b094df7fc976c4a96
-  data.tar.gz: 17ca5beb6af7e1d70495acd86fd58276ec22148a49afc03e79b6213ac79b73cb15cf7e2484985c58a409777583070e6e93ba3e684ba5133e8fc77b4b5b5b33ff
+  metadata.gz: 660c20843ae2f9af5cc1f8fb4a528949ff568a161b6da850cb0f25f38e12fcdc1c8880dc96b8b3313d9d9149a52fcf3e025bcdfc65b9a2fb252cadfee2acf887
+  data.tar.gz: 02cb56fce3643f7c066f819ce6f7e36c88537d67e7fb2424292af59fb5e0eb75c2536f24b5ec2528c319d5ba8d61ba42b9f6de9b3a553936a31f654207bbe510

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.6.0 (2026-07-29)
+
+Full Changelog: [v0.5.7...v0.6.0](https://github.com/Xquik-dev/x-twitter-scraper-ruby/compare/v0.5.7...v0.6.0)
+
+### Features
+
+* **api:** api update ([d172abc](https://github.com/Xquik-dev/x-twitter-scraper-ruby/commit/d172abc0808630d97fdf92e38903f60519a34ae1))
+* **api:** api update ([7696e0c](https://github.com/Xquik-dev/x-twitter-scraper-ruby/commit/7696e0cb8c594b5c71fe1813dc84012100afb3fc))
+
+## 0.5.7 (2026-07-28)
+
+Full Changelog: [v0.5.6...v0.5.7](https://github.com/Xquik-dev/x-twitter-scraper-ruby/compare/v0.5.6...v0.5.7)
+
+### Chores
+
+* **deps:** bump actions/checkout from 6.0.2 to 7.0.1 ([#22](https://github.com/Xquik-dev/x-twitter-scraper-ruby/issues/22)) ([6dac448](https://github.com/Xquik-dev/x-twitter-scraper-ruby/commit/6dac44882cefffee705e4dbf465f03983ca4cdc4))
+* **deps:** bump ruby/setup-ruby from 1.306.0 to 1.319.0 ([#23](https://github.com/Xquik-dev/x-twitter-scraper-ruby/issues/23)) ([d4137aa](https://github.com/Xquik-dev/x-twitter-scraper-ruby/commit/d4137aadaaa8ac17c3b7bd425106b094951d9870))
+
+## 0.5.6 (2026-07-24)
+
+Full Changelog: [v0.5.5...v0.5.6](https://github.com/Xquik-dev/x-twitter-scraper-ruby/compare/v0.5.5...v0.5.6)
+
 ## 0.5.5 (2026-07-24)
 
 Full Changelog: [v0.5.4...v0.5.5](https://github.com/Xquik-dev/x-twitter-scraper-ruby/compare/v0.5.4...v0.5.5)

data/README.md

@@ -35,7 +35,7 @@ Add the gem to your `Gemfile`:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "x-twitter-scraper", "~> 0.5.5"
+gem "x-twitter-scraper", "~> 0.6.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/x_twitter_scraper/models/compose_create_response.rb

@@ -57,6 +57,14 @@ module XTwitterScraper
         #   @return [String]
         required :next_step, String, api_name: :nextStep
 
+        # @!attribute radar_recommendations
+        #   Sources and guidance for researching a fresh post angle.
+        #
+        #   @return [Array<XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation>]
+        required :radar_recommendations,
+                 -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation] },
+                 api_name: :radarRecommendations
+
         # @!attribute scorer_weights
         #   Published signal names with unpublished weights as null.
         #
@@ -97,7 +105,7 @@ module XTwitterScraper
         #   @return [Array<String>, nil]
         optional :style_tweets, XTwitterScraper::Internal::Type::ArrayOf[String], api_name: :styleTweets
 
-        # @!method initialize(content_rules:, engagement_multipliers:, engagement_velocity:, follow_up_questions:, intent_url:, next_step:, scorer_weights:, source:, top_penalties:, saved_styles: nil, style_note: nil, style_tweets: nil)
+        # @!method initialize(content_rules:, engagement_multipliers:, engagement_velocity:, follow_up_questions:, intent_url:, next_step:, radar_recommendations:, scorer_weights:, source:, top_penalties:, saved_styles: nil, style_note: nil, style_tweets: nil)
         #   Some parameter documentations has been truncated, see
         #   {XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult} for more
         #   details.
@@ -114,6 +122,8 @@ module XTwitterScraper
         #
         #   @param next_step [String]
         #
+        #   @param radar_recommendations [Array<XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation>] Sources and guidance for researching a fresh post angle.
+        #
         #   @param scorer_weights [Array<XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::ScorerWeight>] Published signal names with unpublished weights as null.
         #
         #   @param source [String] Signal source and evidence limits.
@@ -154,6 +164,57 @@ module XTwitterScraper
           #   @param multiplier [Symbol, :"Production weight not published by X"]
         end
 
+        class RadarRecommendation < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute endpoint
+          #   Radar endpoint for this source.
+          #
+          #   @return [String]
+          required :endpoint, String
+
+          # @!attribute guidance
+          #   Source-specific drafting guidance.
+          #
+          #   @return [String]
+          required :guidance, String
+
+          # @!attribute source
+          #
+          #   @return [Symbol, XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source]
+          required :source,
+                   enum: -> { XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source }
+
+          # @!attribute use_for
+          #   Current-topic research this source supports.
+          #
+          #   @return [String]
+          required :use_for, String, api_name: :useFor
+
+          # @!method initialize(endpoint:, guidance:, source:, use_for:)
+          #   @param endpoint [String] Radar endpoint for this source.
+          #
+          #   @param guidance [String] Source-specific drafting guidance.
+          #
+          #   @param source [Symbol, XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source]
+          #
+          #   @param use_for [String] Current-topic research this source supports.
+
+          # @see XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation#source
+          module Source
+            extend XTwitterScraper::Internal::Type::Enum
+
+            REDDIT = :reddit
+            GITHUB = :github
+            TRUSTMRR = :trustmrr
+            HACKER_NEWS = :hacker_news
+            GOOGLE_TRENDS = :google_trends
+            WIKIPEDIA = :wikipedia
+            POLYMARKET = :polymarket
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
         class ScorerWeight < XTwitterScraper::Internal::Type::BaseModel
           # @!attribute context
           #   Signal direction and publication limit.

data/lib/x_twitter_scraper/models/radar_item.rb

@@ -24,6 +24,7 @@ module XTwitterScraper
       required :created_at, Time, api_name: :createdAt
 
       # @!attribute language
+      #   BCP-47 language code. und means the source did not identify a language.
       #
       #   @return [String]
       required :language, String
@@ -31,7 +32,18 @@ module XTwitterScraper
       # @!attribute metadata
       #   Source-specific fields. Shape varies per source:
       #
-      #   - reddit: { subreddit: string, author: string }
+      #   - reddit: { author, authorId?, subreddit, subredditId?, subredditSubscribers?,
+      #     sourceFormat, score?, upvoteRatio?, estimatedUpvotes?, estimatedDownvotes?,
+      #     numberComments?, numberCrossposts?, selftext?, contentUrl?, domain?,
+      #     postHint?, linkFlairText?, distinguished?, totalAwardsReceived?, viewCount?,
+      #     editedAt?, galleryImageUrls?, redditVideo?, archived?, contestMode?,
+      #     isCrosspostable?, isMeta?, isNsfw?, isOriginalContent?, isRobotIndexable?,
+      #     isSelf?, isSpoiler?, isVideo?, locked?, stickied? }. `score` is Reddit's
+      #     public net score. Exact public upvote and downvote counts are not available.
+      #     Estimated counts derive from the public score and upvote ratio, which Reddit
+      #     may fuzz. Comment bodies are not included. Current items combine public
+      #     listing discovery with server-rendered post data and use `sourceFormat: html`;
+      #     `json` and `rss` remain for legacy rows.
       #   - github: { starsToday: number }
       #   - hacker_news: { points: number, numberComments: number }
       #   - google_trends: { approxTraffic: number }
@@ -39,10 +51,15 @@ module XTwitterScraper
       #   - wikipedia: { views: number }
       #   - trustmrr: { mrr, growthPercent, last30Days, total, customers,
       #     activeSubscriptions, onSale, xHandle?, category?, askingPrice?, country?,
-      #     growthMrrPercent?, multiple?, paymentProvider?, rank? }
+      #     foundedDate?, googleSearchImpressionsLast30Days?, growthMrrPercent?,
+      #     multiple?, paymentProvider?, profitMarginLast30Days?, rank?,
+      #     revenuePerVisitor?, targetAudience?, visitorsLast30Days? } For the startup
+      #     growth source, xHandle is the founder's X username without @. The rank field
+      #     is the source's revenue rank. Result order represents reported 30-day
+      #     revenue-growth rank.
       #
-      #   @return [Hash{Symbol=>Object}]
-      required :metadata, XTwitterScraper::Internal::Type::HashOf[XTwitterScraper::Internal::Type::Unknown]
+      #   @return [XTwitterScraper::Models::RadarItem::Metadata]
+      required :metadata, -> { XTwitterScraper::RadarItem::Metadata }
 
       # @!attribute published_at
       #
@@ -81,6 +98,7 @@ module XTwitterScraper
       optional :description, String
 
       # @!attribute image_url
+      #   Source image. Startup growth items return the logo here.
       #
       #   @return [String, nil]
       optional :image_url, String, api_name: :imageUrl
@@ -103,9 +121,9 @@ module XTwitterScraper
       #
       #   @param created_at [Time]
       #
-      #   @param language [String]
+      #   @param language [String] BCP-47 language code. und means the source did not identify a language.
       #
-      #   @param metadata [Hash{Symbol=>Object}] Source-specific fields. Shape varies per source:
+      #   @param metadata [XTwitterScraper::Models::RadarItem::Metadata] Source-specific fields. Shape varies per source:
       #
       #   @param published_at [Time]
       #
@@ -121,7 +139,7 @@ module XTwitterScraper
       #
       #   @param description [String]
       #
-      #   @param image_url [String]
+      #   @param image_url [String] Source image. Startup growth items return the logo here.
       #
       #   @param url [String]
 
@@ -142,6 +160,125 @@ module XTwitterScraper
         #   @return [Array<Symbol>]
       end
 
+      # @see XTwitterScraper::Models::RadarItem#metadata
+      class Metadata < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute author
+        #
+        #   @return [String, nil]
+        optional :author, String
+
+        # @!attribute content_url
+        #
+        #   @return [String, nil]
+        optional :content_url, String, api_name: :contentUrl
+
+        # @!attribute estimated_downvotes
+        #
+        #   @return [Integer, nil]
+        optional :estimated_downvotes, Integer, api_name: :estimatedDownvotes
+
+        # @!attribute estimated_upvotes
+        #
+        #   @return [Integer, nil]
+        optional :estimated_upvotes, Integer, api_name: :estimatedUpvotes
+
+        # @!attribute number_comments
+        #
+        #   @return [Integer, nil]
+        optional :number_comments, Integer, api_name: :numberComments
+
+        # @!attribute score
+        #
+        #   @return [Integer, nil]
+        optional :score, Integer
+
+        # @!attribute selftext
+        #
+        #   @return [String, nil]
+        optional :selftext, String
+
+        # @!attribute source_format
+        #   Current items use html. json and rss are retained for legacy rows.
+        #
+        #   @return [Symbol, XTwitterScraper::Models::RadarItem::Metadata::SourceFormat, nil]
+        optional :source_format,
+                 enum: -> { XTwitterScraper::RadarItem::Metadata::SourceFormat },
+                 api_name: :sourceFormat
+
+        # @!attribute subreddit
+        #
+        #   @return [String, nil]
+        optional :subreddit, String
+
+        # @!attribute upvote_ratio
+        #
+        #   @return [Float, nil]
+        optional :upvote_ratio, Float, api_name: :upvoteRatio
+
+        # @!method initialize(author: nil, content_url: nil, estimated_downvotes: nil, estimated_upvotes: nil, number_comments: nil, score: nil, selftext: nil, source_format: nil, subreddit: nil, upvote_ratio: nil)
+        #   Source-specific fields. Shape varies per source:
+        #
+        #   - reddit: { author, authorId?, subreddit, subredditId?, subredditSubscribers?,
+        #     sourceFormat, score?, upvoteRatio?, estimatedUpvotes?, estimatedDownvotes?,
+        #     numberComments?, numberCrossposts?, selftext?, contentUrl?, domain?,
+        #     postHint?, linkFlairText?, distinguished?, totalAwardsReceived?, viewCount?,
+        #     editedAt?, galleryImageUrls?, redditVideo?, archived?, contestMode?,
+        #     isCrosspostable?, isMeta?, isNsfw?, isOriginalContent?, isRobotIndexable?,
+        #     isSelf?, isSpoiler?, isVideo?, locked?, stickied? }. `score` is Reddit's
+        #     public net score. Exact public upvote and downvote counts are not available.
+        #     Estimated counts derive from the public score and upvote ratio, which Reddit
+        #     may fuzz. Comment bodies are not included. Current items combine public
+        #     listing discovery with server-rendered post data and use `sourceFormat: html`;
+        #     `json` and `rss` remain for legacy rows.
+        #   - github: { starsToday: number }
+        #   - hacker_news: { points: number, numberComments: number }
+        #   - google_trends: { approxTraffic: number }
+        #   - polymarket: { volume24hr: number }
+        #   - wikipedia: { views: number }
+        #   - trustmrr: { mrr, growthPercent, last30Days, total, customers,
+        #     activeSubscriptions, onSale, xHandle?, category?, askingPrice?, country?,
+        #     foundedDate?, googleSearchImpressionsLast30Days?, growthMrrPercent?,
+        #     multiple?, paymentProvider?, profitMarginLast30Days?, rank?,
+        #     revenuePerVisitor?, targetAudience?, visitorsLast30Days? } For the startup
+        #     growth source, xHandle is the founder's X username without @. The rank field
+        #     is the source's revenue rank. Result order represents reported 30-day
+        #     revenue-growth rank.
+        #
+        #   @param author [String]
+        #
+        #   @param content_url [String]
+        #
+        #   @param estimated_downvotes [Integer]
+        #
+        #   @param estimated_upvotes [Integer]
+        #
+        #   @param number_comments [Integer]
+        #
+        #   @param score [Integer]
+        #
+        #   @param selftext [String]
+        #
+        #   @param source_format [Symbol, XTwitterScraper::Models::RadarItem::Metadata::SourceFormat] Current items use html. json and rss are retained for legacy rows.
+        #
+        #   @param subreddit [String]
+        #
+        #   @param upvote_ratio [Float]
+
+        # Current items use html. json and rss are retained for legacy rows.
+        #
+        # @see XTwitterScraper::Models::RadarItem::Metadata#source_format
+        module SourceFormat
+          extend XTwitterScraper::Internal::Type::Enum
+
+          HTML = :html
+          JSON = :json
+          RSS = :rss
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
       # @see XTwitterScraper::Models::RadarItem#source
       module Source
         extend XTwitterScraper::Internal::Type::Enum

data/lib/x_twitter_scraper/models/x/account_connection_attempt_retrieve_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module XTwitterScraper
+  module Models
+    module X
+      # @see XTwitterScraper::Resources::X::AccountConnectionAttempts#retrieve
+      class AccountConnectionAttemptRetrieveParams < XTwitterScraper::Internal::Type::BaseModel
+        extend XTwitterScraper::Internal::Type::RequestParameters::Converter
+        include XTwitterScraper::Internal::Type::RequestParameters
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:, request_options: {})
+        #   @param id [String]
+        #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/x_twitter_scraper/models/x/account_connection_attempt_retrieve_response.rb

@@ -0,0 +1,190 @@
+# frozen_string_literal: true
+
+module XTwitterScraper
+  module Models
+    module X
+      # The connection is still in progress.
+      #
+      # @see XTwitterScraper::Resources::X::AccountConnectionAttempts#retrieve
+      module AccountConnectionAttemptRetrieveResponse
+        extend XTwitterScraper::Internal::Type::Union
+
+        # The connection is still in progress.
+        variant -> { XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptPending }
+
+        # The account connected successfully.
+        variant -> { XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptSuccess }
+
+        # The connection reached a final failure.
+        variant -> { XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptFailed }
+
+        # Resumable account connection challenge. Submit the email code to finish the same connection attempt.
+        variant -> { XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge }
+
+        class XAccountConnectionAttemptPending < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute object
+          #
+          #   @return [Symbol, :x_account_connection_attempt]
+          required :object, const: :x_account_connection_attempt
+
+          # @!attribute poll_after_ms
+          #
+          #   @return [Integer]
+          required :poll_after_ms, Integer, api_name: :pollAfterMs
+
+          # @!attribute status
+          #
+          #   @return [Symbol, :pending]
+          required :status, const: :pending
+
+          # @!method initialize(id:, poll_after_ms:, object: :x_account_connection_attempt, status: :pending)
+          #   The connection is still in progress.
+          #
+          #   @param id [String]
+          #   @param poll_after_ms [Integer]
+          #   @param object [Symbol, :x_account_connection_attempt]
+          #   @param status [Symbol, :pending]
+        end
+
+        class XAccountConnectionAttemptSuccess < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute object
+          #
+          #   @return [Symbol, :x_account_connection_attempt]
+          required :object, const: :x_account_connection_attempt
+
+          # @!attribute status
+          #
+          #   @return [Symbol, :success]
+          required :status, const: :success
+
+          # @!method initialize(id:, object: :x_account_connection_attempt, status: :success)
+          #   The account connected successfully.
+          #
+          #   @param id [String]
+          #   @param object [Symbol, :x_account_connection_attempt]
+          #   @param status [Symbol, :success]
+        end
+
+        class XAccountConnectionAttemptFailed < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute error
+          #
+          #   @return [String]
+          required :error, String
+
+          # @!attribute object
+          #
+          #   @return [Symbol, :x_account_connection_attempt]
+          required :object, const: :x_account_connection_attempt
+
+          # @!attribute retryable
+          #
+          #   @return [Boolean]
+          required :retryable, XTwitterScraper::Internal::Type::Boolean
+
+          # @!attribute status
+          #
+          #   @return [Symbol, :failed]
+          required :status, const: :failed
+
+          # @!attribute reason
+          #
+          #   @return [String, nil]
+          optional :reason, String
+
+          # @!method initialize(id:, error:, retryable:, reason: nil, object: :x_account_connection_attempt, status: :failed)
+          #   The connection reached a final failure.
+          #
+          #   @param id [String]
+          #   @param error [String]
+          #   @param retryable [Boolean]
+          #   @param reason [String]
+          #   @param object [Symbol, :x_account_connection_attempt]
+          #   @param status [Symbol, :failed]
+        end
+
+        class XAccountConnectionChallenge < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute expires_at
+          #
+          #   @return [Time]
+          required :expires_at, Time, api_name: :expiresAt
+
+          # @!attribute message
+          #
+          #   @return [String]
+          required :message, String
+
+          # @!attribute object
+          #
+          #   @return [Symbol, XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Object]
+          required :object,
+                   enum: -> { XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Object }
+
+          # @!attribute status
+          #
+          #   @return [Symbol, XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Status]
+          required :status,
+                   enum: -> { XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Status }
+
+          # @!attribute username
+          #
+          #   @return [String]
+          required :username, String
+
+          # @!method initialize(id:, expires_at:, message:, object:, status:, username:)
+          #   Resumable account connection challenge. Submit the email code to finish the same
+          #   connection attempt.
+          #
+          #   @param id [String]
+          #   @param expires_at [Time]
+          #   @param message [String]
+          #   @param object [Symbol, XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Object]
+          #   @param status [Symbol, XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge::Status]
+          #   @param username [String]
+
+          # @see XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge#object
+          module Object
+            extend XTwitterScraper::Internal::Type::Enum
+
+            X_ACCOUNT_CONNECTION_CHALLENGE = :x_account_connection_challenge
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge#status
+          module Status
+            extend XTwitterScraper::Internal::Type::Enum
+
+            REQUIRES_EMAIL_CODE = :requires_email_code
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # @!method self.variants
+        #   @return [Array(XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptPending, XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptSuccess, XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptFailed, XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge)]
+      end
+    end
+  end
+end

data/lib/x_twitter_scraper/models/x/account_create_params.rb

@@ -24,26 +24,26 @@ module XTwitterScraper
         #   @return [String]
         required :password, String
 
+        # @!attribute totp_secret
+        #   Authenticator App TOTP secret required for durable login
+        #
+        #   @return [String]
+        required :totp_secret, String
+
         # @!attribute username
         #   X username
         #
         #   @return [String]
         required :username, String
 
-        # @!attribute totp_secret
-        #   TOTP secret for 2FA
-        #
-        #   @return [String, nil]
-        optional :totp_secret, String
-
-        # @!method initialize(email:, password:, username:, totp_secret: nil, request_options: {})
+        # @!method initialize(email:, password:, totp_secret:, username:, request_options: {})
         #   @param email [String] Account email
         #
         #   @param password [String] Account password
         #
-        #   @param username [String] X username
+        #   @param totp_secret [String] Authenticator App TOTP secret required for durable login
         #
-        #   @param totp_secret [String] TOTP secret for 2FA
+        #   @param username [String] X username
         #
         #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
       end

data/lib/x_twitter_scraper/models/x/account_create_response.rb

@@ -7,63 +7,8 @@
 module XTwitterScraper
   module Models
     module X
-      # @see XTwitterScraper::Resources::X::Accounts#create
-      class AccountCreateResponse < XTwitterScraper::Internal::Type::BaseModel
-        # @!attribute id
-        #
-        #   @return [String]
-        required :id, String
-
-        # @!attribute created_at
-        #
-        #   @return [Time]
-        required :created_at, Time, api_name: :createdAt
-
-        # @!attribute health
-        #
-        #   @return [Symbol, XTwitterScraper::Models::X::AccountCreateResponse::Health]
-        required :health, enum: -> { XTwitterScraper::Models::X::AccountCreateResponse::Health }
-
-        # @!attribute status
-        #
-        #   @return [String]
-        required :status, String
-
-        # @!attribute x_user_id
-        #
-        #   @return [String]
-        required :x_user_id, String, api_name: :xUserId
-
-        # @!attribute x_username
-        #
-        #   @return [String]
-        required :x_username, String, api_name: :xUsername
-
-        # @!method initialize(id:, created_at:, health:, status:, x_user_id:, x_username:)
-        #   Sanitized X account summary returned by connect and reauth.
-        #
-        #   @param id [String]
-        #   @param created_at [Time]
-        #   @param health [Symbol, XTwitterScraper::Models::X::AccountCreateResponse::Health]
-        #   @param status [String]
-        #   @param x_user_id [String]
-        #   @param x_username [String]
-
-        # @see XTwitterScraper::Models::X::AccountCreateResponse#health
-        module Health
-          extend XTwitterScraper::Internal::Type::Enum
-
-          HEALTHY = :healthy
-          LOCKED = :locked
-          NEEDS_REAUTH = :needsReauth
-          RECOVERING = :recovering
-          SUSPENDED = :suspended
-          TEMPORARY_ISSUE = :temporaryIssue
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-      end
+      # @type [XTwitterScraper::Internal::Type::Converter]
+      AccountCreateResponse = XTwitterScraper::Internal::Type::Unknown
     end
   end
 end

data/lib/x_twitter_scraper/models/x/account_reauth_params.rb

@@ -30,7 +30,7 @@ module XTwitterScraper
         optional :email, String
 
         # @!attribute totp_secret
-        #   TOTP secret for 2FA re-authentication
+        #   Replacement Authenticator App TOTP secret. Omit it to reuse the saved secret.
         #
         #   @return [String, nil]
         optional :totp_secret, String
@@ -42,7 +42,7 @@ module XTwitterScraper
         #
         #   @param email [String] Email for the X account (updates stored email)
         #
-        #   @param totp_secret [String] TOTP secret for 2FA re-authentication
+        #   @param totp_secret [String] Replacement Authenticator App TOTP secret. Omit it to reuse the saved secret.
         #
         #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
       end